subprocess.md

Subprocess en Python

---

Temario

• Subprocess en Python
  • Temario
  • ¿Qué es subprocess?
  • 1. Diferencias con os.system()
  • 2. Ejecutar comandos básicos
  • 3. Capturar la salida del comando
    • Atributos útiles
  • 4. Manejar errores
  • 5. Capturar y procesar salida directamente
  • 6. Enviar entrada al proceso
  • 7. Ejecutar múltiples procesos (encadenados)
  • 8. Popen explicado (modo avanzado)
  • 9. Ejecutar en segundo plano
  • 10. Consejos de seguridad
  • 11. Ejemplo práctico: medir tiempo de ejecución
  • 12. Ejemplo completo: automatizador de sistema
  • 13. Resumen general

Regresar a la Guía Principal

---

¿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 si lo escribieras en la terminal.

---

1. Diferencias con os.system()

Característica	os.system()	subprocess
Devuelve la salida	❌ No	✅ Sí
Control de errores	❌ Limitado	✅ Avanzado
Interactuar con el proceso	❌ No	✅ Sí
Seguridad	🚫 Inseguro (interpreta shell)	✅ Seguro (argumentos separados)

---

2. 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

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

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

---

4. Manejar errores

Si 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

Si 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

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)

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 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

Si no quieres que el programa espere:

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

Esto abrirá VLC sin bloquear el resto de tu script.

---

10. 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 si la entrada del usuario no está validada.

---

11. Ejemplo práctico: medir tiempo de ejecución

import subprocess
import time

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

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.

---

13. Resumen general

Función	Qué hace
subprocess.run()	Ejecuta un comando y espera que termine
subprocess.check_output()	Devuelve solo la salida
subprocess.Popen()	Crea un proceso controlado manualmente
stdout=PIPE	Captura la salida estándar
stderr=PIPE	Captura los errores
input=	Envía datos al proceso
shell=True	Ejecuta dentro de un shell (⚠️ inseguro)
check=True	Lanza excepción si falla

---

Regresar a la Guía Principal

Autor: Fravelz