Subprocess en Python

¿Qué es subprocess? {#qué-es-subprocess}

subprocess (sub-proceso) permite ejecutar programas externos o comandos del sistema operativo desde Python.

🔹 Ejemplo:

import subprocess

subprocess.run(["ls"])

👉 Ejecuta el comando ls (en Linux/Mac) igual que sí lo escribieras en la terminal.

1. Diferencias con os.system() {#diferencias-con-os.system}

2. Ejecutar comandos básicos {#ejecutar-comandos-básicos}

import subprocess

# Forma segura (lista de argumentos)
subprocess.run(["echo", "Hola desde Python!"])

También puedes pasar shell=True (aunque menos seguro):

subprocess.run("echo Hola desde Python!", shell=True)

3. Capturar la salida del comando {#capturar-la-salida-del-comando}

Para guardar el texto que produce el comando, usa capture_output=True:

resultado = subprocess.run(["ls"], capture_output=True, text=True)
print("Salida:", resultado.stdout)

Atributos útiles {#atributos-útiles}

resultado.stdout → salida estándar (lo que imprime el comando)
resultado.stderr → errores (sí los hay)
resultado.returncode → código de salida (0 = correcto)

4. Manejar errores {#manejar-errores}

Sí quieres que el programa lance una excepción cuando el comando falle:

try:
subprocess.run(["ls", "/carpeta_que_no_existe"], check=True)
except subprocess.CalledProcessError as e:
print("Error al ejecutar el comando:", e)

5. Capturar y procesar salida directamente {#capturar-y-procesar-salida-directamente}

Sí solo necesitas la salida (más cómodo que .run()):

salida = subprocess.check_output(["whoami"], text=True)
print("Usuario actual:", salida.strip())

👉 Esto ejecuta el comando y devuelve la salida como string.

6. Enviar entrada al proceso {#enviar-entrada-al-proceso}

Puedes enviar datos al proceso con input=:

resultado = subprocess.run(
["grep", "hola"],
input="hola mundo\nadiós mundo\n",
text=True,
capture_output=True

print(resultado.stdout)

🔹 Resultado:

hola mundo

7. Ejecutar múltiples procesos (encadenados) {#ejecutar-múltiples-procesos-encadenados}

Puedes conectar la salida de un comando a otro como en una tubería (| en la terminal):

p1 = subprocess.Popen(["ls"], stdout=subprocess.PIPE)
p2 = subprocess.Popen(["grep", "py"], stdin=p1.stdout, stdout=subprocess.PIPE, text=True)

salida, _ = p2.communicate()
print("Archivos .py:\n", salida)

👉 Aquí:

Popen() crea procesos manualmente.
stdout=subprocess.PIPE permite conectar procesos.
communicate() espera y obtiene la salida.

8. Popen explicado (modo avanzado) {#popen-explicado-modo-avanzado}

Popen es la clase base de subprocess, te da control total sobre el proceso.

from subprocess import Popen, PIPE

p = Popen(["ping", "-c", "2", "google.com"], stdout=PIPE, stderr=PIPE, text=True)
salida, error = p.communicate()

print("Salida:", salida)
print("Errores:", error)
print("Código de salida:", p.returncode)

9. Ejecutar en segundo plano {#ejecutar-en-segundo-plano}

Sí no quieres que el programa espere:

subprocess.Popen(["vlc", "video.mp4"])

Esto abrirá VLC sin bloquear el resto de tú script.

10. Consejos de seguridad {#consejos-de-seguridad}

✅ Haz esto:

subprocess.run(["ls", "/home"])

🚫 Evita esto (riesgo de inyección):

subprocess.run("ls /home && rm -rf /", shell=True)

Usar shell=True puede ejecutar código malicioso sí la entrada del usuario no está validada.

11. Ejemplo práctico: medir tiempo de ejecución {#ejemplo-práctico-medir-tiempo-de-ejecución}

import subprocess

inicio = time.time()
subprocess.run(["python3", "mi_script.py"])
fin = time.time()

print(f"Tiempo de ejecución: {fin - inicio:.2f} segundos")

12. Ejemplo completo: automatizador de sistema {#ejemplo-completo-automatizador-de-sistema}

import subprocess

comandos = [
["sudo", "apt", "update"],
["sudo", "apt", "upgrade", "-y"],
["sudo", "apt", "autoremove", "-y"]
]

for cmd in comandos:
print("Ejecutando:", " ".join(cmd))
resultado = subprocess.run(cmd, capture_output=True, text=True)
print(resultado.stdout)

🧹 Esto ejecuta varios comandos del sistema uno tras otro y muestra su salida.

Notas de Hacking

Fravelz