Faragiri

Aprender Automatización con scripts Python

Una carpeta de fotos ordenada en doce líneas, el patrón que ignora mayúsculas, y la bandera que separa un script útil de una mala tarde.

4Secciones
3Minutos
4Profundidad

Un script que renombra archivos debería imprimir lo que va a hacer y no cambiar nada, hasta que uno lea la lista completa. Lucía tiene en Rosario una carpeta de fotos de producto para su tienda, y el plan de python3 ordenar.py fotos, sin otro argumento, se ve así:

  • renombraría 'FOTO_001 copia.JPG' -> 'foto_001.jpg'
  • renombraría 'FOTO_002.jpeg' -> 'foto_002.jpeg'
  • renombraría 'FOTO_003.JPG' -> 'foto_003.jpg'

Tres cosas quedan visibles en esa lista que no se habrían visto después. La extensión se pasa a minúscula pero jpeg no se convierte en jpg, así que sobreviven dos esquemas de nombre. La palabra copia se elimina. Y nada choca, cosa que el script comprobó comparando la cantidad de nombres nuevos únicos contra la cantidad de archivos, antes de tocar el disco.

Encontrar los archivos, y la trampa del patrón

Path("fotos").rglob("*.JPG") encuentra dos de las tres fotos, porque los patrones glob distinguen mayúsculas y un archivo está en .jpeg minúscula. Ese es el error más común en un script de este tipo y es silencioso: la corrida reporta éxito y la mitad de la carpeta queda sin tocar.

Antes del primer renombre

Qué comprobó el script, y qué no

Un patrón glob puede reportar éxito mientras deja archivos sin tocar por diferencias de mayúsculas o extensiones.

  1. SíArchivos con extensión .JPG detectadosEl patrón glob encontró los nombres con terminación en mayúsculaSí
  2. NoArchivos con extensión .jpeg en minúscula incluidosrglob distingue mayúsculas y dejó fuera el archivo con extensión .jpegNo
  3. SíFiltro por extensión con suffix.lower()Normaliza a minúsculas y atrapa tanto .jpg como .jpeg sin fallasSí
  4. SíRecorrido explícito con iterdirPermite inspeccionar cada elemento en lugar de asumir el patrónSí
  5. Sin revisarControl total de los nombres de origenEn carpetas de fotos reales las extensiones suelen venir mezcladasSin revisar

La trampa de rglob es silenciosa porque el script termina sin errores pero omite parte de la carpeta.

La versión confiable prueba la extensión en vez del patrón: if p.suffix.lower() in {".jpg", ".jpeg"}, que atrapó las tres. Conviene usar iterdir y una comparación cuando la exactitud importa, y dejar rglob para los casos donde uno controla los nombres.

Ejecutar un programa externo, y el argumento que la gente se salta

Cuando el trabajo necesita una herramienta real, subprocess.run es el camino, y recibe una lista y no una cadena de texto, que es lo que evita que un nombre de archivo con un espacio se vuelva dos argumentos. subprocess.run([...], capture_output=True, text=True) devuelve un objeto con returncode y stdout como texto, y una llamada correcta sobre una de estas fotos respondió anchoPixeles: 3024 en la última línea.

Llamadas a programas externos

Protecciones al invocar procesos del sistema

El paso de argumentos como lista y la verificación de retornos evitan errores silenciosos al ejecutar herramientas.

  1. Lista de argumentos en vez de cadenaNombres con espacios divididos en múltiples argumentosRutas con espacios procesadas como un único argumento íntegro
  2. Parámetro check=TrueContinuación silenciosa cuando un comando devuelve código 1Lanzamiento inmediato de CalledProcessError ante cualquier falla
  3. Captura con capture_output=TruePérdida de la salida diagnóstica en la terminalAcceso a stdout y returncode dentro del objeto resultante
subprocess.run

Ignorar los códigos de retorno puede provocar que el script borre archivos tras una conversión fallida.

El argumento que hay que agregar es check=True. Sin él, un comando que falla responde 1 y el script sigue tranquilo; subprocess.run(["false"], check=True) lanza CalledProcessError en cambio, que es lo que uno quiere cuando el siguiente paso asume que el anterior funcionó. Un script de orden que ignora los códigos de retorno va a borrar los originales después de una conversión que falló.

Qué configurar en 2026

pathlib es la respuesta de la biblioteca estándar para cualquier cosa que toque el sistema de archivos, gratis, y es la recomendada desde hace años. p.suffix, p.stem, p.with_name y p.rename reemplazaron la cirugía de cadenas con os.path.splitext y uniones armadas a mano, que es donde vivía el error del espacio en el nombre.

Transición a estándares actuales

Reemplazo de herramientas en scripts del sistema

Las bibliotecas modernas sustituyen la manipulación manual de cadenas y los servicios tradicionales de agendamiento.

Prácticas tradicionalesCirugía de cadenas con os.path y tareas en cron
  1. 01Manejo del sistema de archivosp.suffix y p.with_name reemplazan uniones manuales propensas a errores con espacios
  2. 02Agendador del sistema operativolaunchd en Mac reemplaza a cron y reinicia ejecuciones tras un reinicio de la computadora
  3. 03Aislamiento de entornoRutas absolutas hacia el intérprete para compensar un PATH reducido
Configuración recomendada en 2026pathlib para rutas y launchd con rutas absolutas

Las tareas agendadas se ejecutan con un entorno mínimo que exige rutas explícitas a cada binario.

launchd es lo que agenda el script en una Mac, gratis con el sistema, y reemplazó a cron ahí: un plist en ~/Library/LaunchAgents corre en un intervalo o al iniciar sesión y, a diferencia de cron, reinicia el trabajo después de un reinicio. Sea cual sea lo que lo agenda, hay que recordar qué cambia: una corrida agendada tiene una carpeta de trabajo distinta y un PATH mucho más chico que la terminal de uno, así que conviene usar rutas absolutas para todo, incluido el intérprete.

Dónde se traba la gente aquí

El tropiezo es un script que funcionó a mano y no hace nada en la corrida agendada, sin ningún error a la vista. Casi siempre es una de tres cosas: la carpeta de trabajo no era la que uno asumió, así que una ruta relativa no encontró nada; el intérprete en el PATH del agendador no es el que tiene los paquetes instalados; o la salida fue a un registro que nadie configuró y la falla quedó invisible.

Diagnóstico de ejecuciones automáticas

Tres pilares para que una tarea agendada no falle

Un script que funciona manualmente en la terminal necesita referencias absolutas para correr de madrugada.

Corrida agendada confiable
  • Ruta absoluta al intérpreteAsegura la ejecución con el binario exacto que contiene los paquetes instalados
  • Ruta absoluta a la carpetaEvita depender del directorio de trabajo implícito asignado por el agendador
  • Ruta absoluta al archivo de registroCaptura la salida estándar y los errores sin dejarlos invisibles en el sistema

Aislamiento completo del entorno interactivo

Probar el script desde una terminal con el entorno vacío revela discrepancias antes de programar la tarea.

Las tres se arreglan con el mismo hábito: no tomar nada del entorno, ruta absoluta al intérprete, ruta absoluta a la carpeta, ruta absoluta al registro. Después correrlo una vez desde una terminal con el entorno vaciado, antes de confiarle que corra a las tres de la mañana.

Qué intérprete debería apuntar esa ruta absoluta está en paquetes y entornos, qué escribir en ese registro para que la próxima falla sea diagnosticable está en registro de eventos, y qué módulos hacen el trabajo de fondo aquí está en la biblioteca estándar.

Al lado de esto

Arriba de esto