Cómo convertir un script de Python en un “comando”

#!/usr/bin/env python3

Todos sabemos que al escribir un script de Python en Linux, podemos incluir un shebang como el de arriba en la primera línea, ¿verdad?
Sin embargo, mucha gente parece no molestarse en añadir el shebang. Probablemente piensen: "¿No es solo para ahorrarse la molestia de teclear el comando python3? Es algo que se puede teclear sin más".

Si lo llamamos simplemente una "función para teclear menos", la verdad es que no entusiasma mucho.
Pero la cosa cambia si lo decimos así:

"La técnica para disfrazar tu código Python como un comando nativo de Linux"

Esto suena un poco… atractivo, ¿verdad?

Proceso pipi con script de Python en Linux

El momento en que un script de Python se convierte en una ‘herramienta’

Esta única línea:

#!/usr/bin/env python3

Si la entiendes simplemente como “indicar la ruta de Python”
hasta ahora solo has ejecutado código,

pero desde el momento en que la usas correctamente,
👉 has añadido una herramienta al sistema.

La diferencia es mayor de lo que parece.

1. Rompiendo las cadenas de .py

Por costumbre, escribimos así:

python3 crawler.py

En realidad, esto se siente como:

“Este es un archivo Python… por favor, ejecútalo con Python…”

Es bastante pasivo.

Sin embargo, si le añades el shebang y le das permisos de ejecución con chmod +x, a partir de ese momento la extensión deja de ser necesaria.

./crawler

El tono cambia por completo.

Concentrándose en la función, no en el lenguaje

crawler
backup
log-cleaner
notify

Ahora, si estos archivos son:

  • Python

  • C

  • Go

deja de importar.

Es decir, nos concentramos en la función del script en sí, más que en la herramienta de implementación. Esta diferencia psicológica se siente bastante al probarlo.

Mi código ya no es,

  • script.py, sino

  • un comando de Linux.

Una sensación de que mi código se sitúa junto a ls, grep, awk.

Este es el primer placer.

2. Se integra de forma natural en el pipeline

Personalmente, creo que el verdadero poder de Linux reside en el pipe |. Entre sus innumerables ventajas, la existencia de este pipe es realmente suprema.

Conectar comandos 👉 para crear un único flujo.

Si configuramos este hermoso pipe con scripts sin shebang, se vería así. 

cat access.log | python3 parser.py | python3 filter.py

Algo… el flujo se interrumpe.

  • “Ah, esto es Python”
  • “Ah, otro intérprete”

Se nota constantemente.

Sin embargo, un script equipado con un shebang tendrá este aspecto:

cat access.log | parser | filter | notifier

O

ps aux | my-filter | sort | uniq

¿No cambia la sensación?

El flujo no se interrumpe.

  • Recibe entrada

  • Procesa

  • Pasa

Se siente como si todo fluyera de forma natural.

Exagerando un poco, da la sensación de que no es un “script de Python”, sino un filtro que sigue la filosofía de Unix. Y mi código parece haberse desplazado del mundo de Python al mundo de Linux.

3. Crea fácilmente tus propios comandos de Linux con Python

Por supuesto, para una automatización sencilla en Linux, lo primero que nos viene a la mente es un script de Bash. Puedes manejar los comandos del sistema como si fueran parte de ti, sin necesidad de instalar paquetes adicionales (importaciones).

Pero seamos sinceros. Cuando las condiciones se complican y empezamos a manejar estructuras de datos, el código Bash a menudo se convierte en un 'cifrado ilegible' para el futuro. ¿No te has sentido frustrado al abrir un código meses después para mantenerlo, aunque lo entendieras fácilmente cuando lo escribiste?

Aquí es donde el verdadero valor de Python se manifiesta.

  • La victoria de la legibilidad: Esa sensación de alivio al abrir un archivo para mantenimiento meses después. Python te explica amablemente lo que pensabas en el pasado.

  • Potente ecosistema de paquetes: Las llamadas API complejas o el procesamiento de datos se resuelven en pocas líneas con los paquetes avanzados de Python. Mientras que en Bash estarías lidiando, con Python ya habrías terminado la implementación y estarías disfrutando de un café.

En definitiva, la estrategia es: "La lógica se construye con la productividad de Python, y la ejecución se realiza con la simplicidad de un comando nativo de Linux".

Elimina el .py, concédele chmod +x, y luego desliza ese archivo en algún lugar de tu ruta PATH. Observa cómo tu código se ejecuta cuando, por ejemplo, escribes solo una palabra como deploy en la terminal.

Una extraña satisfacción te invadirá. Sentirás que no solo has escrito código, sino que has creado un 'nuevo comando propio' que reside permanentemente en tu sistema.

Conclusión

El shebang no es una sintaxis trivial. 

#!/usr/bin/env python3

Me gustaría decir que esto no es solo una ruta de ejecución, sino una declaración que cambia el rol de un script simple a un comando.

Queridos lectores, ahora prueben a añadir un shebang a su código Python y escriban el nombre de su código directamente en la terminal. Esa sensación que experimenten en la punta de los dedos es la esencia de esta técnica.

Lecturas relacionadas