Instalacion de Django

Nota Si usas un Chromebook, omite este capítulo y asegúrate de seguir las instrucciones de Chromebook Setup.

Nota Si ya has realizado los pasos de instalación, esto ya lo has hecho. ¡Puedes avanzar directamente al siguiente capítulo!

Parte de esta sección está basada en tutoriales por Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).

Parte de este capítulo está basada en el django-marcador tutorial bajo la licencia Creative Commons Attribution-ShareAlike 4.0 internacional. El tutorial de django-marcador tiene derechos de autor de Markus Zapke-Gündemann et al.

Entorno virtual

Antes de instalar Django, instalaremos una herramienta extremadamente útil que ayudará a mantener tu entorno de desarrollo ordenado en tu computadora. Es posible saltarse este paso, pero es altamente recomendable. ¡Empezar con la mejor configuración posible te ahorrará muchos problemas en el futuro!

Así que, vamos a crear un entorno virtual (también llamado un virtualenv). Virtualenv aísla tu configuración de Python/Django para cada proyecto. Esto quiere decir que cualquier cambio que hagas en un sitio web no afectará a ningún otro que estés desarrollando. Genial, ¿no?

Todo lo que necesitas hacer es encontrar un directorio en el que quieras crear el virtualenv; tu directorio home, por ejemplo. En Windows, puede verse como C:\Users\Name (donde Name es el nombre de tu usuario).

NOTA: En Windows, asegúrate de que este directorio no contiene caracteres especiales o acentuados; si tu nombre de usuario contiene caracteres acentuados, usa un directorio distinto, por ejemplo C:\djangogirls.

Para este tutorial usaremos un nuevo directorio djangogirls en tu directorio home:

command-line

$ mkdir djangogirls
$ cd djangogirls

Haremos un virtualenv llamado myvenv. El comando general estará en el formato:

command-line

$ python3 -m venv myvenv
Virtual environment: Windows

Para crear un nuevo virtualenv, necesitas abrir una terminal "command prompt" y ejecutar python -m venv myvenv. Se verá así:

command-line

C:\Users\Name\djangogirls> python -m venv myvenv

Donde myvenv es el nombre de tu virtualenv. Puedes utilizar cualquier otro nombre, pero asegúrate de usar minúsculas y no usar espacios, acentos o caracteres especiales. También es una buena idea mantener el nombre corto. ¡Vas utilizarlo muchas vecesl!
Virtual environment: Linux and macOS

Podemos crear un virtualenv en Linux y macOS, es tan sencillo como ejecutar python3 -m venv myvenv. Se verá así:

command-line

$ python3 -m venv myvenv

myvenv es el nombre de tu virtualenv. Puedes usar cualquier otro nombre, pero sólo utiliza minúsculas y no incluyas espacios. También es una buena idea mantener el nombre corto. ¡Vas a referirte muchas veces a él!

NOTA: En algunas versiones de Debian/Ubuntu, puede que obtengas el siguiente error:

command-line

The virtual environment was not created successfully because ensurepip is not available.  En sistemas Debian/Ubuntu, tendrás que instalar el paquete python3-venv usando el siguiente comando.
   apt-get install python3-venv
Puede que tengas que usar sudo con este comando.  Después de instalar el paquete python3-venv, vuelve a crear tu entorno virtual.

En este caso, sigue las instrucciones anteriores e instala el paquete python3-venv:

command-line

$ sudo apt install python3-venv

NOTA: En algunas versiones de Debian/Ubuntu inicializar el entorno virtual de esta manera da el siguiente error:

command-line

Error: Command '['/home/eddie/Slask/tmp/venv/bin/python3', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1

Para evitar esto, utiliza directamente el comando virtualenv.

command-line

$ sudo apt-get install python-virtualenv
$ virtualenv --python=python3.6 myvenv

NOTA: Si obtienes un error como

command-line

E: Unable to locate package python3-venv

entonces ejecuta:

command-line

sudo apt install python3.6-venv

Trabajar con virtualenv

El comando anterior creará un directorio llamado myvenv (o cualquier nombre que hayas elegido) que contiene nuestro entorno virtual (básicamente un montón de archivos y carpetas).

Working with virtualenv: Windows

Inicia el entorno virtual ejecutando:

command-line

C:\Users\Name\djangogirls> myvenv\Scripts\activate

Nota: en 10 de Windows puedes obtener un error en Windows PowerShell que dice execution of scripts is disabled on this system. En este caso, abre otro Windows PowerShell con la opción "Ejecutar como administrador". Luego intenta escribir el siguiente comando antes de inicializar tu entorno virtual:

command-line

C:\WINDOWS\system32 > Set-ExecutionPolicy -ExecutionPolicy RemoteSigned
   Execution Policy Change
   The execution policy helps protect you from scripts that you do not trust. Changing the execution policy might expose you to the security risks described in the about_Execution_Policies help topic at http://go.microsoft.com/fwlink/?LinkID=135170. Do you want to change the execution policy? [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): A

NOTA: Para usuarios del popular editor VS Code, el cual viene con una terminal integrada basada en el poweshell de windows; si deseas añadir la terminal integrada, puedes arrancar el siguiente comando para activar tu entorno virtual:

$ . myvenv\Scripts\activate.ps1

La ventaja es que no tienes que cambiar las ventanas entre el editor de código y la línea de comandos.
Working with virtualenv: Linux and macOS

Inicia el entorno virtual ejecutando:

command-line

$ source myvenv/bin/activate

¡Recuerda reemplazar myvenv con tu nombre de virtualenv que hayas elegido!

NOTA: a veces source podría no estar disponible. En ese caso trata hacerlo de esta forma:

command-line

$ . myvenv/bin/activate

Sabrás que tienes virtualenv iniciado cuando veas que la línea de comando en tu consola tiene el prefijo (myvenv).

Cuando trabajes en un entorno virtual, python automáticamente se referirá a la versión correcta, de modo que puedes utilizar python en vez de python3.

Ok, tenemos todas las dependencias importantes en su lugar. ¡Finalmente podemos instalar Django!

Instalar Django

Ahora que tienes tu virtualenv iniciado, puedes instalar Django.

Antes de hacer eso, debemos asegurarnos que tenemos la última versión de pip, el software que utilizamos para instalar Django:

command-line

(myvenv) ~$ python -m pip install --upgrade pip

Instalar paquetes con un fichero de requisitos (requirements)

Un fichero de requisitos (requirements) tiene una lista de dependencias que se deben instalar mediante pip install:

Primero crea un archivo requirements.txt dentro de tu directorio djangogirls, usando el editor de código que instalaste previamente. Lo puedes hacer mediante abriendo un nuevo archivo en el editor de código y guardándolo como requirements.txt en el directorio djangogirls. Tu directorio se verá así:

djangogirls
└───requirements.txt

Dentro del fichero djangogirls/requirements.txt deberías tener el siguiente texto:

djangogirls/requirements.txt

Django~=5.1.2

Ahora, ejecuta pip install -r requirements.txt para instalar Django.

command-line

(myvenv) ~$ pip install -r requirements.txt
Collecting Django~=5.1.2 (from -r requirements.txt (line 1))
  Downloading Django-5.1.2-py3-none-any.whl (7.1MB)
Installing collected packages: Django
Successfully installed Django-5.1.2
Installing Django: Windows

Si obtienes un error cuando llamas al pip en la plataforma de Windows, por favor verifica si el nombre de ruta de tu proyecto contiene espacios, acentos o caracteres especiales (por ejemplo, C:\Usuarios\NombreUsuario\djangogirls). Si los tiene, utiliza otro en su lugar sin espacios, acentos o caracteres especiales (sugerencia: C:\djangogirls). Crea un nuevo virtualenv en el nuevo directorio, luego borra el viejo y trata de escribir el comando anterior otra vez. (Moviendo el directorio virtualenv no funcionará debido a que usa rutas absolutas.)
Installing Django: Windows 8 and Windows 10

Tu línea de comando puede congelarse luego de intentar instalar Django. Si esto sucede, usa el siguiente comando:

command-line

C:\Users\Name\djangogirls> python -m pip install -r requirements.txt
Installing Django: Linux

Si obtienes un error cuando llamas pip en Ubuntu 12.04, por favor corre python -m pip install -U --force-reinstall pip para reparar la instalación de pip en el virtualenv.

¡Eso es todo! Ahora estás lista (por fin) para crear una aplicación Django!

results matching ""

    No results matching ""