DEV Community

Cover image for ¿Cómo crear un comando en django?
Eduardo Zepeda
Eduardo Zepeda

Posted on • Originally published at coffeebytes.dev

¿Cómo crear un comando en django?

Has usado Django antes ¿no? Entonces, ya usaste algún comando de Django, pudo haber sido makemigrations, migrate, startproject, startapp algún otro. Pero, ¿alguna vez has creado alguno? Quizás no. Sigue leyendo para aprender como.

Si nunca has usado django visita mi lista de reseñas de libros, donde opino sobre varios libros de django.

Crear un comando en django

Para crear un comando de django basta con crear una carpeta llamada management en el mismo nivel que tu archivo manage.py

mkdir management
Enter fullscreen mode Exit fullscreen mode

Posteriormente, hay que crear una carpeta llamada commands dentro de esa carpeta

cd management/
mkdir commands
Enter fullscreen mode Exit fullscreen mode

Ahora nos posicionamos dentro de esa carpeta y creamos un archivo con el nombre de nuestro comando

cd commands/
touch tucomando.py
Enter fullscreen mode Exit fullscreen mode

Dentro de esta archivo crearemos una clase llamada Command que herede de BaseCommand, con un método llamado handle.

# management/command/tucomando.py
from django.core.management.base import BaseCommand, CommandError

class Command(BaseCommand):
    help = 'help text'

    def handle(self, *args, **options):
         pass
Enter fullscreen mode Exit fullscreen mode

Dentro del método handle colocaremos el código que se ejecutará cuando usemos nuestro comando.

from django.core.management.base import BaseCommand, CommandError

class Command(BaseCommand):
    help = 'help text'

    def handle(self, *args, **options):
         self.stdout.write(self.style.ERROR("Texto de error"))
         self.stdout.write(self.style.WARNING("Texto de advertencia"))
Enter fullscreen mode Exit fullscreen mode

Para mostrar texto en la terminal usaremos self.stdout.write para imprimir texto en la salida estándar. Podemos seleccionar entre varios estilos de acuerdo a lo que queramos mostrar.

Añadir argumentos al comando

Django usa la famosa librería argparse de Python para manejar los argumentos en sus comandos

Argumentos posicionales

Podemos añadir argumentos posicionales al comando usando el método add_argument de parser.

from django.core.management.base import BaseCommand, CommandError

class Command(BaseCommand):
    help = 'help text'

    def add_arguments(self, parser):
        parser.add_argument('email', nargs='+', type=str)
Enter fullscreen mode Exit fullscreen mode

Especificamos el nombre del argumento posicional como primer argumento, luego la cantidad de argumentos que recibirá. El símbolo '+' establece que esos argumentos serán colocados en una lista, mientras que type es el tipo de valores que recibirá el argumento.

Seguramente ya habrás notado que la función handle recibe *args y **options como argumento. Bien, pues podemos acceder a los valores a través del diccionario options.

from django.core.management.base import BaseCommand, CommandError

class Command(BaseCommand):
    help = 'help text'

    def add_arguments(self, parser):
        parser.add_argument('email', nargs='+', type=str)

    def handle(self, *args, **options):
        # options['email'] es una lista
        send_emails(options['email'])
Enter fullscreen mode Exit fullscreen mode

Argumentos opcionales

¿Y si yo quiero argumentos opcionales? Pues sí, también es posible.

La clase Command, a través de su parser, también nos permite usar argumentos opcionales.

from django.core.management.base import BaseCommand, CommandError

class Command(BaseCommand):
    help = 'help text'

    def add_arguments(self, parser):

        # Named (optional) arguments
        parser.add_argument(
            '--file',
            nargs='?',
            const='logo.svg',
            type=str,
            help='texto de ayuda',
        )

    def handle(self, *args, **options):
        if options['file'].endswith('.svg'):
            process_svg()
Enter fullscreen mode Exit fullscreen mode

Ahora seguramente te estarás preguntando que significan todos esos argumentos que le pasamos a add_argument.

Ahora mismo te lo digo:

  • Prefijo '--': le dice a Argparse que es un argumento opcional
  • nargs: indica la cantidad de valores que puede recibir nuestro argumento, el simbolo '+' en este caso es para uno o ninguno.
  • const: es el valor a usar si no especificamos ningún valor para el argumento.
  • type: nos dice el tipo de dato que espera nuestro argumento.
  • help: es el texto de ayuda a mostrar.

Ejecutar el comando

¿Y para ejecutarlo? Fácil; justo como lo harías con cualquier otro comando de django.

python manage.py tucomando
# con un argumento posicional
python managa.py tucomando email admin@example.org
# o con un argumento opcional
python manage.py tuotrocomando --file=tuarchivo.svg
Enter fullscreen mode Exit fullscreen mode

Listo, si te leiste esto completo, ahora conoces lo básico de la creación de comandos de django. Pero no te quedes solo con esto, visita la documentación oficial para profundizar más.

Top comments (0)