Cómo crear tu primer comando en Python

Construye una aplicación de línea de comandos en Python paso a paso con Platsy Ventas: desde usar un comando propio y help, hasta crear y listar clientes, con una arquitectura clara de lógica, persistencia e interfaz CLI. Aprenderás el punto de entrada en Python, el manejo de listas y a resolver errores típicos en la terminal.

¿Qué es Platsy Ventas y cómo se usa la CLI?

Platsy Ventas es una app de consola para clientes, ventas, inventarios y reportes. Se estructura como muchas apps profesionales: capa de lógica, capa de persistencia y capa de interacción con usuario mediante interfaz de línea de comandos. La ejecución ideal no es “python archivo.py”, sino un comando propio abreviado, por ejemplo “PB”, porque en CLI se usan abreviaciones para escribir menos.

¿Cómo consultar help y entender opciones, comandos y argumentos?

• Escribe help para ver “cómo utilizarte”.
• Estructura: nombre del comando, luego opciones, luego comandos, luego argumentos.
• Ejemplo conceptual: “platsi ventas” + opciones + comando + argumentos.

¿Qué comandos de clients se demuestran?

• Subcomando: clients con help muestra acciones disponibles.
• Acciones: crear, borrar, ver lista y actualizar.
• Ejecución de listado: “platsi ventas clients list” para ver clientes existentes.
• Campos mostrados: ID, nombre, compañía, email y posición.
• Creación: “platsi ventas clients create” solicita nombre, compañía, email y posición; luego aparece en list.

¿Cómo crear el punto de entrada en Python y gestionar clientes?

En un archivo llamado “main.py” se define el punto de entrada con “if name == 'main':”. Se usa pass como marcador cuando el bloque queda vacío, ya que Python depende de la indentación (a diferencia de lenguajes con llaves curly braces).

¿Cómo iniciar el script con pass y luego manejar la lista?

# main.py
if __name__ == '__main__':
    # punto de entrada
    pass

• “if name == 'main':” indica dónde comienza a ejecutarse el programa.
• pass evita errores de bloque vacío mientras se construye la lógica.

Para manejar clientes, se inicia una lista y se añade un nombre usando concatenación con “+=”.

# main.py
if __name__ == '__main__':
    clientes = ['Pablo', 'Ricardo']
    clientes += ['David']  # se concatena una lista con un nuevo elemento
    print(clientes)  # salida: ['Pablo', 'Ricardo', 'David']

• Lista inicial: “Pablo” y “Ricardo”.
• Añadir con “+=” mantiene la idea de concatenación aprendida.
• Impresión final confirma “Pablo, Ricardo y David”.

¿Qué errores comunes aparecen y cómo resolverlos en la terminal?

Trabajando en CLI, es normal encontrar errores de rutas y archivos. Aquí lo esencial para corregir rápido.

¿Cómo solucionar “no existe el archivo” y organizar el proyecto?

• Si aparece que el archivo no existe, revisa la ruta real del archivo.
• Usa pwd para saber en qué directorio estás.
• Mueve “main.py” al directorio del proyecto correcto y vuelve a ejecutar.
• Para crear archivos desde la terminal: utiliza touch seguido del nombre del archivo.
• Consejo de práctica: sube el tamaño de letra en la terminal para leer cómodamente.

¿Por qué usar abreviaciones en comandos como “PB”?

• En CLI se prioriza la rapidez al escribir.
• Un alias como “PB” para “Platsy Ventas” reduce tecleo en tareas repetitivas.
• Mantén nombres cortos y consistentes en tus comandos.

¿Te gustaría ver más ejemplos de clients create, list o update aplicados a tu propio flujo? Comparte tu caso y lo exploramos juntos.