Esta página ha sido traducida del inglés por la comunidad. Aprende más y únete a la comunidad de MDN Web Docs.

View in English Always switch to English

Configuración de un entorno de desarrollo Django

Ahora que sabes para qué se utiliza Django, te enseñaremos cómo configurar y probar un entorno de desarrollo Django en Windows, Linux (Ubuntu) y macOS — sea cual sea el sistema operativo habitual que estés utilizando, este artículo te dará lo que necesitas para poder empezar a desarrollar aplicaciones Django.

Prerrequisitos: Conocimientos básicos del uso de una terminal/línea de comandos y de cómo instalar paquetes de software en el sistema operativo de tu computadora de desarrollo.
Objetivo: Tener funcionando en tu computadora un entorno de desarrollo para Django (4.*).

Visión general del entorno de desarrollo Django

Django hace muy fácil configurar tu propia computadora para que puedas empezar a desarrollar aplicaciones web. Esta sección explica qué obtienes con el entorno de desarrollo y ofrece una visión general de algunas de tus opciones de configuración. El resto del artículo explica el método recomendado para instalar el entorno de desarrollo de Django en Ubuntu, macOS y Windows, y cómo puedes probarlo.

¿Qué es el entorno de desarrollo Django?

El entorno de desarrollo es una instalación de Django en tu computadora local que puedes usar para desarrollar y probar aplicaciones Django antes de desplegarlas en un entorno de producción.

Las principales herramientas que el propio Django proporciona son un conjunto de scripts de Python para crear y trabajar con proyectos Django, junto con un simple servidor web de desarrollo que puedes usar para probar localmente (es decir, en tu computadora, no en un servidor web externo) aplicaciones web Django en el navegador de tu computadora.

Hay otras herramientas periféricas, que a menudo forman parte del entorno de desarrollo, que no cubriremos aquí. Estas incluyen cosas como un editor de texto o un IDE para editar código, linters para el formateo automático, etc. Asumimos que ya tienes instalado un editor de texto.

¿Cuáles son las opciones de configuración de Django?

Django es extremadamente flexible en cuanto a cómo y dónde puede instalarse y configurarse. Django puede:

  • Instalarse en diferentes sistemas operativos.
  • Instalarse desde el código fuente, desde el Python Package Index (PyPi) y, en muchos casos, desde la aplicación de gestión de paquetes de la computadora anfitriona.
  • Configurarse para usar una de entre varias bases de datos, que también pueden necesitar instalarse y configurarse por separado.
  • Ejecutarse en el entorno Python principal del sistema o dentro de entornos virtuales de Python independientes.

Cada una de estas opciones requiere una configuración ligeramente distinta. Las siguientes subsecciones explican algunas de tus opciones. En el resto del artículo te mostraremos cómo configurar Django en un pequeño número de sistemas operativos, y esa configuración se dará por supuesta durante el resto del módulo.

Nota: Otras posibles opciones de instalación se cubren en la documentación oficial de Django. Enlazamos a los documentos apropiados más abajo.

¿Qué sistemas operativos son compatibles?

Las aplicaciones web Django pueden ejecutarse en casi cualquier máquina capaz de ejecutar el lenguaje de programación Python 3: Windows, macOS, Linux/Unix, Solaris, por nombrar solo unos pocos. Casi cualquier computadora debería tener el rendimiento necesario para ejecutar Django durante el desarrollo.

En este artículo daremos instrucciones para Windows, macOS y Linux/Unix.

¿Qué versión de Python debería usarse?

Puedes usar cualquier versión de Python compatible con la versión de Django que uses como destino. Para Django 5.0 las versiones permitidas son Python 3.10 a 3.12 (ver FAQ:Installation).

El proyecto Django recomienda (y "soporta oficialmente") usar la versión más reciente disponible de la versión de Django compatible.

¿Dónde podemos descargar Django?

Hay tres lugares desde donde descargar Django:

  • El Python Package Repository (PyPi), usando la herramienta pip. Esta es la mejor forma de obtener la última versión estable de Django.
  • Usar una versión del gestor de paquetes de tu computadora. Las distribuciones de Django empaquetadas con sistemas operativos ofrecen un mecanismo de instalación familiar. Ten en cuenta, sin embargo, que la versión empaquetada puede ser bastante antigua, y solo puede instalarse en el entorno Python del sistema (que puede no ser lo que quieras).
  • Instalar desde el código fuente. Puedes obtener e instalar la versión más reciente de Django directamente desde el código fuente. Esto no se recomienda para principiantes, pero es necesario cuando estés listo para empezar a contribuir de vuelta al propio Django.

Este artículo muestra cómo instalar Django desde PyPi, para obtener la última versión estable.

¿Qué base de datos?

Django soporta oficialmente las bases de datos PostgreSQL, MariaDB, MySQL, Oracle y SQLite, y existen bibliotecas de la comunidad que ofrecen distintos niveles de soporte para otras bases de datos SQL y NoSQL populares. Te recomendamos que elijas la misma base de datos tanto para producción como para desarrollo (aunque Django abstrae muchas de las diferencias entre bases de datos usando su Object-Relational Mapper (ORM), todavía existen problemas potenciales que es mejor evitar).

En este artículo (y en la mayor parte de este módulo) usaremos la base de datos SQLite, que almacena sus datos en un archivo. SQLite está pensada para usarse como base de datos ligera y no puede soportar un alto nivel de concurrencia. Sin embargo, es una excelente elección para aplicaciones que son principalmente de solo lectura.

Nota: Django está configurado para usar SQLite por defecto cuando inicias tu proyecto de sitio web con las herramientas estándar (django-admin). Es una gran elección cuando estás empezando, porque no requiere configuración adicional.

¿Instalar en todo el sistema o en un entorno virtual de Python?

Cuando instalas Python 3 obtienes un único entorno global que es compartido por todo el código Python 3. Aunque puedes instalar los paquetes de Python que quieras en ese entorno, solo puedes tener instalada una versión concreta de cada paquete a la vez.

Nota: Las aplicaciones Python instaladas en el entorno global pueden entrar en conflicto entre sí (por ejemplo, si dependen de versiones diferentes del mismo paquete).

Si instalas Django en el entorno predeterminado/global, solo podrás usar una versión de Django en esa computadora. Esto puede ser un problema si quieres crear nuevos sitios web (usando la última versión de Django) mientras mantienes sitios web que dependen de versiones más antiguas.

Como resultado, los desarrolladores experimentados de Python/Django normalmente ejecutan las aplicaciones Python dentro de entornos virtuales de Python independientes. Esto permite tener múltiples entornos Django diferentes en una misma computadora. ¡El propio equipo de desarrollo de Django recomienda que uses entornos virtuales de Python!

Este módulo asume que has instalado Django en un entorno virtual, y a continuación te mostraremos cómo hacerlo.

Instalación de Python 3

Para poder usar Django necesitas tener Python 3 en tu sistema operativo. También necesitarás la herramienta del Python Package Indexpip3 — que se usa para gestionar (instalar, actualizar y eliminar) los paquetes/bibliotecas de Python que usan Django y tus otras aplicaciones de Python.

Esta sección explica brevemente cómo puedes comprobar qué versiones de Python están presentes, e instalar versiones nuevas cuando lo necesites, en Ubuntu Linux 22.04, macOS y Windows 10.

Nota: Dependiendo de tu plataforma, también podrías instalar Python/pip desde el propio gestor de paquetes de tu sistema operativo o mediante otros mecanismos. Para la mayoría de las plataformas puedes descargar los archivos de instalación necesarios desde https://www.python.org/downloads/ e instalarlos usando el método específico apropiado para tu plataforma.

Ubuntu 22.04

Ubuntu Linux 22.04 LTS incluye Python 3.10.12 por defecto. Puedes confirmarlo ejecutando el siguiente comando en la terminal bash:

bash
python3 -V
# Salida: Python 3.10.12

Sin embargo, la herramienta del Python Package Index (pip3) que necesitarás para instalar paquetes de Python 3 (incluido Django) no está disponible por defecto. Puedes instalar pip3 en la terminal bash usando:

bash
sudo apt install python3-pip

Nota: Python 3.10 es la versión más antigua compatible con Django 5.0. No necesitas usar la última versión de Python para este tutorial, pero si quieres hacerlo hay instrucciones disponibles en internet.

macOS

macOS no incluye Python 3 por defecto (Python 2 sí viene incluido en versiones más antiguas). Puedes confirmarlo ejecutando el siguiente comando en la terminal:

bash
python3 -V

Esto mostrará el número de versión de Python, lo que indica que Python 3 está instalado, o bien python3: command not found, lo que indica que no se encontró Python 3.

Puedes instalar fácilmente Python 3 (junto con la herramienta pip3) desde python.org:

  1. Descarga el instalador necesario:

    1. Ve a https://www.python.org/downloads/macos/
    2. Descarga la versión estable más reciente compatible con Django 5.0. (en el momento de escribir esto, es Python 3.11.8).
  2. Localiza el archivo usando Finder y haz doble clic en el archivo del paquete. Sigue las instrucciones de instalación.

Ahora puedes confirmar que la instalación se realizó correctamente ejecutando python3 -V de nuevo y comprobando el número de versión de Python.

De forma similar, puedes comprobar que pip3 está instalado listando los paquetes disponibles:

bash
pip3 list

Windows 10 u 11

Windows no incluye Python por defecto, pero puedes instalarlo fácilmente (junto con la herramienta pip3) desde python.org:

  1. Descarga el instalador necesario:

    1. Ve a https://www.python.org/downloads/windows/
    2. Descarga la versión estable más reciente compatible con Django 5.0. (en el momento de escribir esto, es Python 3.11.8).
  2. Instala Python haciendo doble clic en el archivo descargado y siguiendo las instrucciones de instalación.

  3. Asegúrate de marcar la casilla llamada "Add Python to PATH".

Después puedes verificar que Python 3 se instaló introduciendo el siguiente texto en la línea de comandos:

bash
py -3 -V

El instalador de Windows incorpora pip3 (el gestor de paquetes de Python) por defecto. Puedes listar los paquetes instalados como se muestra a continuación:

bash
py -3 -m pip list

Nota: El instalador debería configurar todo lo necesario para que el comando anterior funcione. Sin embargo, si obtienes un mensaje indicando que no se puede encontrar Python, es posible que hayas olvidado añadirlo a la ruta (path) de tu sistema. Puedes hacerlo ejecutando el instalador de nuevo, seleccionando "Modify" (Modificar) y marcando la casilla llamada "Add Python to environment variables" en la segunda página.

Invocar Python 3 y pip3

Habrás notado que en las secciones anteriores usamos comandos diferentes para invocar Python 3 y pip en distintos sistemas operativos.

Si solo tienes instalado Python 3 (y no Python 2), normalmente puedes usar los comandos simples python y pip para ejecutar Python y pip en cualquier sistema operativo. Si esto está permitido en tu sistema, obtendrás una cadena de versión "3" al ejecutar -V con los comandos simples, como se muestra a continuación:

bash
python -V
pip -V

Si tienes instalado Python 2, entonces para usar la versión 3 deberías anteponer los comandos con python3 y pip3 en Linux/macOS, y con py -3 y py -3 -m pip en Windows:

bash
# Linux/macOS
python3 -V
pip3 -V

# Windows
py -3 -V
py -3 -m pip list

Las instrucciones a continuación muestran los comandos específicos de cada plataforma, ya que funcionan en más sistemas.

Uso de Django dentro de un entorno virtual de Python

Las bibliotecas que usaremos para crear nuestros entornos virtuales son virtualenvwrapper (Linux y macOS) y virtualenvwrapper-win (Windows), que a su vez usan ambas la herramienta virtualenv. Las herramientas wrapper crean una interfaz coherente para gestionar entornos en todas las plataformas.

Instalación del software del entorno virtual

Configuración del entorno virtual en Ubuntu

Después de instalar Python y pip puedes instalar virtualenvwrapper (que incluye virtualenv). Puedes consultar la guía de instalación oficial o seguir las instrucciones a continuación.

Instala la herramienta usando pip3:

bash
sudo pip3 install virtualenvwrapper

A continuación, añade las siguientes líneas al final del archivo de inicio de tu shell (este es un archivo oculto llamado .bashrc en tu directorio de inicio). Estas líneas establecen la ubicación donde deben vivir los entornos virtuales, la ubicación de los directorios de tus proyectos de desarrollo, y la ubicación del script instalado con este paquete:

bash
export WORKON_HOME=$HOME/.virtualenvs
export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3
export VIRTUALENVWRAPPER_VIRTUALENV_ARGS=' -p /usr/bin/python3 '
export PROJECT_HOME=$HOME/Devel
source /usr/local/bin/virtualenvwrapper.sh

Nota: Las variables VIRTUALENVWRAPPER_PYTHON y VIRTUALENVWRAPPER_VIRTUALENV_ARGS apuntan a la ubicación normal de instalación de Python 3, y source /usr/local/bin/virtualenvwrapper.sh apunta a la ubicación normal del script virtualenvwrapper.sh. Si virtualenv no funciona cuando lo pruebes, una cosa que puedes comprobar es que Python y el script estén en la ubicación esperada (y luego cambiar el archivo de inicio adecuadamente).

Puedes encontrar las ubicaciones correctas para tu sistema usando los comandos which virtualenvwrapper.sh y which python3.

A continuación, vuelve a cargar el archivo de inicio ejecutando el siguiente comando en la terminal:

bash
source ~/.bashrc

En este punto deberías ver un montón de scripts ejecutándose, como se muestra a continuación:

bash
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/premkproject
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/postmkproject
# …
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/preactivate
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/postactivate
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/get_env_details

Ahora puedes crear un nuevo entorno virtual con el comando mkvirtualenv.

Configuración del entorno virtual en macOS

Configurar virtualenvwrapper en macOS es casi exactamente igual que en Ubuntu (de nuevo, puedes seguir las instrucciones de la guía de instalación oficial o las de abajo).

Instala virtualenvwrapper (que incluye virtualenv) usando pip como se muestra a continuación.

bash
sudo pip3 install virtualenvwrapper

A continuación, añade las siguientes líneas al final del archivo de inicio de tu shell (son las mismas líneas que para Ubuntu). Si usas la shell zsh entonces el archivo de inicio será un archivo oculto llamado .zshrc en tu directorio de inicio. Si usas la shell bash entonces será un archivo oculto llamado .bash_profile. Puede que necesites crear el archivo si todavía no existe.

bash
export WORKON_HOME=$HOME/.virtualenvs
export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3
export PROJECT_HOME=$HOME/Devel
source /usr/local/bin/virtualenvwrapper.sh

Nota: La variable VIRTUALENVWRAPPER_PYTHON apunta a la ubicación normal de instalación de Python 3, y source /usr/local/bin/virtualenvwrapper.sh apunta a la ubicación normal del script virtualenvwrapper.sh. Si virtualenv no funciona cuando lo pruebes, una cosa que puedes comprobar es que Python y el script estén en la ubicación esperada (y luego cambiar el archivo de inicio adecuadamente).

Por ejemplo, una prueba de instalación en macOS terminó necesitando las siguientes líneas en el archivo de inicio:

bash
export WORKON_HOME=$HOME/.virtualenvs
export VIRTUALENVWRAPPER_PYTHON=/Library/Frameworks/Python.framework/Versions/3.7/bin/python3
export PROJECT_HOME=$HOME/Devel
source /Library/Frameworks/Python.framework/Versions/3.7/bin/virtualenvwrapper.sh

Puedes encontrar las ubicaciones correctas para tu sistema usando los comandos which virtualenvwrapper.sh y which python3.

A continuación, vuelve a cargar el archivo de inicio haciendo la siguiente llamada en la terminal:

bash
source ~/.bash_profile

En este punto, puede que veas un montón de scripts ejecutándose (los mismos scripts que en la instalación de Ubuntu). Ahora deberías poder crear un nuevo entorno virtual con el comando mkvirtualenv.

Nota: Si no encuentras el archivo de inicio para editarlo en el finder, también puedes abrirlo en la terminal usando nano.

Suponiendo que uses bash, los comandos se verían algo así:

bash
cd ~  # Ir a mi directorio de inicio
ls -la # Listar el contenido del directorio. Deberías ver .bash_profile
nano .bash_profile # Abrir el archivo en el editor de texto nano, dentro de la terminal
# Ir hasta el final del archivo, y copiar las líneas de arriba
# Usar Ctrl+X para salir de nano, elegir Y para guardar el archivo.

Configuración del entorno virtual en Windows

Instalar virtualenvwrapper-win es incluso más sencillo que configurar virtualenvwrapper, porque no necesitas configurar dónde almacena la herramienta la información del entorno virtual (hay un valor por defecto). Todo lo que necesitas hacer es ejecutar el siguiente comando en la línea de comandos:

bash
py -3 -m pip install virtualenvwrapper-win

Ahora puedes crear un nuevo entorno virtual con el comando mkvirtualenv.

Creación de un entorno virtual

Una vez que hayas instalado virtualenvwrapper o virtualenvwrapper-win, trabajar con entornos virtuales es muy similar en todas las plataformas.

Ahora puedes crear un nuevo entorno virtual con el comando mkvirtualenv. Mientras se ejecuta este comando, verás cómo se va configurando el entorno (lo que veas será ligeramente específico de la plataforma). Cuando el comando termina, el nuevo entorno virtual queda activo — puedes comprobarlo porque el inicio del prompt será el nombre del entorno entre paréntesis (a continuación lo mostramos para Ubuntu, pero la última línea es similar para Windows/macOS).

bash
mkvirtualenv my_django_environment

Deberías ver una salida similar a la siguiente:

Running virtualenv with interpreter /usr/bin/python3
# …
virtualenvwrapper.user_scripts creating /home/ubuntu/.virtualenvs/t_env7/bin/get_env_details
(my_django_environment) ubuntu@ubuntu:~$

Ahora que estás dentro del entorno virtual puedes instalar Django y empezar a desarrollar.

Nota: A partir de ahora en este artículo (y de hecho en todo el módulo), asume que todos los comandos se ejecutan dentro de un entorno virtual de Python como el que configuramos arriba.

Uso de un entorno virtual

Hay solo unos pocos comandos útiles más que deberías conocer (hay más en la documentación de la herramienta, pero estos son los que usarás habitualmente):

  • deactivate — Salir del entorno virtual de Python actual.
  • workon — Listar los entornos virtuales disponibles.
  • workon nombre_del_entorno — Activar el entorno virtual de Python especificado.
  • rmvirtualenv nombre_del_entorno — Eliminar el entorno especificado.

Instalación de Django

Una vez que hayas creado un entorno virtual, y hayas llamado a workon para entrar en él, puedes usar pip3 para instalar Django.

bash
# Linux/macOS
python3 -m pip install django~=4.2

# Windows
py -3 -m pip install django~=4.2

Puedes comprobar que Django está instalado ejecutando el siguiente comando (esto solo comprueba que Python puede encontrar el módulo Django):

bash
# Linux/macOS
python3 -m django --version

# Windows
py -3 -m django --version

Nota: Si el comando anterior de Windows no muestra un módulo django presente, prueba:

bash
py -m django --version

En Windows, los scripts de Python 3 se lanzan anteponiendo el comando con py -3, aunque esto puede variar según tu instalación concreta. Prueba a omitir el modificador -3 si tienes problemas con los comandos. En Linux/macOS, el comando es python3.

Advertencia: El resto de este módulo usa el comando de Linux para invocar Python 3 (python3). Si estás trabajando en Windows, reemplaza este prefijo por: py -3.

Gestión del código fuente con Git y GitHub

Las herramientas de gestión y versionado del código fuente (SCM) te permiten almacenar y recuperar de forma fiable versiones de tu código fuente, probar cambios, y compartir código entre tus experimentos y el "código conocido como bueno" cuando lo necesites.

Existen muchas herramientas SCM distintas, entre ellas git, Mercurial, Perforce, SVN (Subversion), CVS (Concurrent Versions System), etc., y servicios de alojamiento SCM en la nube como Bitbucket, GitHub y GitLab. Para este tutorial alojaremos nuestro código en GitHub, uno de los servicios de alojamiento de código fuente basados en la nube más populares, y usaremos la herramienta git para gestionar nuestro código fuente localmente y enviarlo a GitHub cuando sea necesario.

Nota: ¡Usar herramientas SCM es una buena práctica de desarrollo de software! Estas instrucciones ofrecen una introducción básica a git y GitHub. Para aprender más, consulta Aprender Git.

Conceptos clave

Git (y GitHub) usan repositorios ("repos") como el "contenedor" de nivel superior para almacenar código, donde cada repositorio normalmente contiene el código fuente de una sola aplicación o módulo. Los repositorios pueden ser públicos, en cuyo caso el código es visible para todo el mundo en internet, o privados, en cuyo caso están restringidos a la organización o cuenta de usuario propietaria.

Todo el trabajo se realiza en una "rama" concreta del código de tu repositorio. Cuando quieres respaldar algunos cambios en una rama, puedes crear una "confirmación" (commit), que almacena todos los cambios desde tu última confirmación en la rama actual.

El repositorio se crea con una rama predeterminada llamada "main". Puedes crear otras ramas a partir de esta usando git, las cuales inicialmente tienen todas las confirmaciones de la rama original. Puedes evolucionar las ramas por separado añadiendo confirmaciones, y después usar una "solicitud de extracción" (Pull Request, PR) en GitHub para fusionar cambios de una rama a otra. También puedes usar git para cambiar entre ramas en tu computadora local, por ejemplo, para probar cosas distintas.

Además de las ramas, es posible crear tags (etiquetas) en cualquier rama y recuperar esa rama más tarde en ese punto concreto.

Crear una cuenta y un repositorio en GitHub

Primero crearemos una cuenta en GitHub (esto es gratis). Luego crearemos y configuraremos un repositorio llamado "django_local_library" para almacenar el sitio web de la biblioteca local a medida que lo desarrollamos en el resto de este tutorial.

Los pasos son:

  1. Visita https://github.com/ y crea una cuenta.

  2. Una vez que hayas iniciado sesión, haz clic en el enlace + en la barra de herramientas superior y selecciona New repository.

  3. Completa todos los campos de este formulario. Aunque no son obligatorios, se recomiendan encarecidamente.

    • Introduce un nombre de repositorio: "django_local_library".

    • Introduce una nueva descripción de repositorio: "Local Library website written in Django".

    • Selecciona "Public" para el repositorio (la opción predeterminada).

      Advertencia: Esto hará que todo el código fuente sea visible. Recuerda no almacenar credenciales u otro material sensible en tu repositorio a menos que sea privado.

    • Elige Python en la lista de selección Add .gitignore.

    • Elige la licencia que prefieras en la lista de selección Add license. MDN usa "Creative Commons Zero v1.0 Universal" para este ejemplo.

    • Marca Initialize this repository with a README.

  4. Pulsa Create repository.

    El repositorio se creará, conteniendo solo los archivos README.txt y .gitignore.

Clonar el repositorio en tu computadora local

Ahora que el repositorio ("repo") se creó en GitHub, vamos a clonarlo (copiarlo) a nuestra computadora local:

  1. En GitHub, haz clic en el botón verde Code. En la sección "Clone", selecciona la pestaña "HTTPS" y copia la URL. Si usaste el nombre de repositorio "django_local_library", la URL debería ser algo como: https://github.com/<tu_id_de_usuario_git>/django_local_library.git.

  2. Instala git en tu computadora local (guía oficial de descarga de Git).

  3. Abre una línea de comandos/terminal y clona tu repositorio usando la URL que copiaste antes:

    bash
    git clone https://github.com/<tu_id_de_usuario_git>/django_local_library.git
    

    Esto creará el repositorio dentro del directorio actual.

  4. Navega hasta la carpeta del repositorio.

    bash
    cd django_local_library
    

Modificar y sincronizar cambios

Ahora vamos a modificar el archivo .gitignore en la computadora local, confirmar el cambio, y actualizar el repositorio en GitHub. Este es un cambio útil de hacer, pero sobre todo lo hacemos para mostrarte cómo obtener cambios desde GitHub, hacer cambios localmente, y luego enviarlos a GitHub.

  1. En la línea de comandos/terminal, primero hacemos "fetch" (obtenemos) y luego "pull" (obtenemos y fusionamos en la rama actual) la última versión del código fuente desde GitHub:

    Nota: Este paso no es estrictamente necesario ya que acabamos de clonar el código fuente y sabemos que está actualizado. Sin embargo, en general deberías actualizar tus fuentes desde GitHub antes de hacer cambios.

    bash
    git fetch origin main
    git pull origin main
    

    El "origin" es un remoto, que representa la ubicación del repositorio donde está el código fuente, y "main" es la rama. Puedes verificar que origin es nuestro repositorio en GitHub usando el comando: git remote -v.

  2. A continuación, creamos una nueva rama para guardar nuestros cambios:

    bash
    git checkout -b update_gitignore
    

    El comando checkout se usa para cambiar alguna rama a ser la rama actual con la que estás trabajando. El indicador -b indica que queremos crear una nueva rama llamada "update_gitignore" en lugar de seleccionar una rama existente con ese nombre.

  3. Abre el archivo .gitignore, copia las siguientes líneas al final, y guarda:

    # Text backup files
    *.bak
    
    # Database
    *.sqlite3
    

    Ten en cuenta que .gitignore se usa para indicar archivos que no deben respaldarse automáticamente con git, como archivos temporales y otros artefactos de compilación.

  4. Usa el comando add para añadir todos los archivos modificados (que no estén ignorados por el archivo .gitignore) al "área de preparación" de la rama actual.

    bash
    git add -A
    
  5. Usa el comando status para comprobar que todos los archivos que vas a confirmar (commit) son correctos (quieres incluir archivos fuente, no binarios, archivos temporales, etc.). Debería verse algo parecido al siguiente listado.

    bash
    git status
    
    On branch update_gitignore
    Changes to be committed:
      (use "git restore --staged <file>..." to unstage)
    
            modified:   .gitignore
    
  6. Cuando estés satisfecho, confirma (commit) los archivos a tu repositorio local, usando el indicador -m para especificar un mensaje de confirmación conciso pero claro. Esto equivale a dar tu visto bueno a los cambios y convertirlos en parte oficial del repositorio local.

    bash
    git commit -m ".gitignore: add .bak and .sqlite3"
    
  7. En este punto, el repositorio remoto no se ha modificado. Podemos enviar (push) la rama update_gitignore al repositorio "origin" (GitHub) usando el siguiente comando:

    bash
    git push origin update_gitignore
    
  8. Vuelve a la página de GitHub donde creaste tu repositorio y actualiza la página.

    Debería aparecer un banner con un botón para pulsar si quieres "Compare and pull request" la rama que acabas de subir. Selecciona el botón y luego sigue las instrucciones para crear y después fusionar una solicitud de extracción (pull request).

    Banner que pregunta al usuario si quiere comparar y fusionar actualizaciones recientes de la rama

    Después de la fusión, la rama "main" del repositorio en GitHub contendrá tus cambios en .gitignore.

  9. Puedes seguir actualizando tu repositorio local a medida que cambien los archivos, usando este ciclo de agregar/confirmar/enviar (add/commit/push).

En el siguiente tema usaremos este repositorio para almacenar el código fuente de nuestro sitio web de la biblioteca local.

Otras herramientas de Python

Los desarrolladores de Python experimentados pueden instalar herramientas adicionales, como linters (que ayudan a detectar errores comunes en el código).

Ten en cuenta que deberías usar un linter compatible con Django, como pylint-django, ya que algunos linters de Python comunes (como pylint) informan incorrectamente de errores en los archivos estándar generados por Django.

Comprobación de tu instalación

La prueba anterior funciona, pero no es muy divertida. Una prueba más interesante es crear un proyecto esqueleto y ver que funciona. Para hacerlo, primero navega en tu línea de comandos/terminal hasta donde quieras almacenar tus aplicaciones Django. Crea una carpeta para tu sitio de prueba y navega hasta ella.

bash
mkdir django_test
cd django_test

Después puedes crear un nuevo sitio esqueleto llamado "mytestsite" usando la herramienta django-admin, como se muestra a continuación. Después de crear el sitio puedes navegar a la carpeta donde encontrarás el script principal para gestionar proyectos, llamado manage.py.

bash
django-admin startproject mytestsite
cd mytestsite

Podemos ejecutar el servidor web de desarrollo desde esta carpeta usando manage.py y el comando runserver, como se muestra a continuación.

bash
# Linux/macOS
python3 manage.py runserver

# Windows
py -3 manage.py runserver

Nota: Puedes ignorar las advertencias sobre "unapplied migration(s)" en este punto.

Una vez que el servidor esté en ejecución puedes ver el sitio navegando a la siguiente URL en tu navegador web local: http://127.0.0.1:8000/. Deberías ver un sitio parecido a este:

La página de inicio de la aplicación Django esqueleto

Resumen

Ahora tienes un entorno de desarrollo Django funcionando en tu computadora.

En la sección de comprobación también viste brevemente cómo podemos crear un nuevo sitio web Django usando django-admin startproject, y ejecutarlo en tu navegador usando el servidor web de desarrollo (python3 manage.py runserver). En el siguiente artículo, ampliamos este proceso, construyendo una aplicación web simple pero completa.

Ver también