Instalar y configurar Django en Visual Studio Code

Como Instalar y configurar el framework Django de python, en Visual Studio Code

Hola! En este Post vamos aprender como instalar y configurar Django en Visual Studio Code en Windows (También aplica en sistemas operativos libres con algunas diferencias). Además, aprenderemos como crear y usar de manera básica entornes virtuales de desarrollo.

Portada De visual Studio con Django

Portada De visual Studio con Django

Antes de empezar…

Necesitaremos algunas herramientas y/o programas instaladas en nuestro PC.

Nota* Este tutorial se realizó en Windows

A continuación les dejo una lista de los requerimientos que vamos a necesitar, presiona clic en los nombres para dirigirte a la página oficial y descargarlos.

Requerimientos

Si no tienen instalado Python o Pip en sus computadores les recomiendo presionar clic en «Instalar Python» o «Instalar Pip». Son tutoriales creados previamente para esta guía.

Instalar y configurar Django en Visual Studio Code

Una vez descargas e instaladas todas las herramientas estamos listos para comenzar el propósito de esta entrada. Primero lo primero, la seguridad. Vamos a instalar una herramienta que nos va ayudar a crear ambientes para expermientar sin miedos de ir a dañar algo en nuestra querida carpeta de Python27 (En windows) y así no tener que reinstalar Python o algo sino solamente eliminar ese ambiente y crear uno nuevo. A continuación cómo instalar virtualenv.

Instalar virtualenv

ArchWiki en su artículo Python/Virtual environment define virtualenv como: «una herramienta de desarrollo en Python escrita por Ian Bicking y usada para crear entornos aislados para Python, en los que es posible instalar paquetes sin interferir con otros virtualenvs ni con los paquetes de Python del sistema.» (ArchLinux, 11 enero 2017). En otras palabras, con esta herramienta podremos crear un entorno ideal para desarrollo y pruebas sin comprometer el entorno original de Python.

 

Nota* Verifica que tengas instalado Python y Pip en tu PC, además, que estén en el PATH de Windows.

Instalación

Presionamos tecla-windows + r y escribimos cmd para abrir el prompt. Seguido ejecutamos el siguiente comando:

  • pip install virtualenv (Comando para instalar virtualenv en nuestra PC).

Si has realizado todos pasos correctamente debería aparecer algo así, Ver figura 1. Observemos el error que aparece en el primer comando, no es necesario escribir Python xD. 

Captura de pantalla del prompt mostrando la instalación de virtualenv con el comando pip. Instalar y Configurar Django en Visual Studio Code.

Figura 1. Captura de pantalla instalando virtualenv por medio de Pip

 

Creación de entorno virtual

Ahora vamos a ejecutar el siguiente comando para crear nuestro entorno virtual

  • virtualenv [nombre_entorno] 

virtualenv tiene muchisimos comandos y/o parametros, sin embargo, en esta guía no vamos a profundizar sobre ello. Solo nos limitaremos a ejecutar el comando para crear un entorno virtual básico. Ver figura 2. El nombre de nuestro entorno puede ser cualquiera solo debes recordarlo.

Nota* Observemos que ahora me encuentro en una carpeta llamada environments. Es importante recordar la ruta donde hemos creado nuestro entorno virtual.

Captura de pantalla creando entorno virtual llamado XeeDBeam. Instalar y Configurar Django en Visual Studio Code

Figura 2. Captura de pantalla creando entorno virtual.

Activación del entorno

¿Recuerdas que te mencione recordar el nombre del entorno y el lugar donde lo has creado? Pues bien, eso se necesita para activarlo. Es muy sencillo, en mi caso sería el siguiente comando:

Nota* Este comando puede variar debido a la ubicación del entorno o del sistema operativo. Sin embargo, no te preocupes que voy explicarte la estructura.

  • XeeDBeam\Scripts\activate

Aunque tenga en cuenta par de cosas. Primero en donde me encuentro ubicado en el figura 2. Así es, estoy en la carpeta environments. Por esta razón, el comando esta conformado por el nombre del entorno, seguido de la carpeta llamada Scripts y finalmente el archivo activate.

Tengan en cuenta que así se activaría en sistemas operativos tipo Windows, en sistemas libres sería algo como:

  • source XeeDBeam/bin/activate

Si hemos realizado la activación correctamente debería salir algo como esto. Ver figura 3.

Captura de pantalla activación de entorno virtual en Windows. Instalar y Configurar Django en Visual Studio Code

Figura 3. Captura de pantalla activando el entorno virtual.

Observen que sale (XeeDBeam) en el cmd, esto es porque hemos activado nuestro entorno virtual. Por cierto, dependiendo el nombre que hubiesen elegido así saldrá entre paréntesis.

Desactivar entorno

El comando para desactivar el entorno virtual es:

  • deactivate

Listo ya estamos más cerca de Instalar y Configurar Django en Visual Studio Code. Ahora vamos a Instalar Django en nuestro PC.

Instalar Django

Con nuestro entorno virtual activado (Preferiblemente) vamos a ejecutar el siguiente comando

  • pip install django

Nota* Recuerden activar el entorno virtual siempre que deseen usar django desde el prompt. Además, véase que se usó Pip para la Instalar Django.

Para verificar si Django ha sido instalado correctamente debemos hacer lo siguiente.

  1. Ejecutar Python en el prompt
  2. Importar Django
  3. Ejecutar comando django.get_version()

Si todo sale bien debería aparecer algo como esto, Ver figura 4.

Captura de pantalla Instalando Django con Pip. Instalar y Configurar Django en Visual Studio Code

Figura 4. Captura de pantalla instalar Django con Pip.

Configurar Django en Visual Studio Code

Primero debemos asegurarnos de tener instaladas las siguientes extensiones en Visual Studio Code

Extensiones

  • Python
  • Python for VSCode
  • Django

Consideraciones

A partir de este punto supondremos que hemos configurado Django, es decir, creado un proyecto, una app etc. Eso se explicará a detalle en otra entrada.

Ahora vamos a decirle a Visual Studio Code que vamos a usar nuestro entorno virtual para ejecutar Python y sus respectivos paquetes. Entonces, ve a  Archivo > Preferencias > Configuración. Ahí en el apartado de configuración del usuario vamos agregar la siguiente sintaxis.

  • “python.pythonPath”: “C:/Users/marcelaW40k/environments/XeeDBeam/Scripts/python.exe”

Esto es para indicarle a Visual Studio Code el interprete de Python (Cuando se use el debug / Depurar).

Así debería quedar, Ver figura 5.

Captura de pantalla de la configuración del interprete de Python. Instalar y Configurar Django Visual Studio Code

Figura 5. Captura de pantalla configuración interprete de Python en Visual Studio Code

Uso de Django en Visual Studio Code

Como lo podrán imaginar, Visual Studio Code es una IDE de Desarrollo que nos permite trabajan con muchos lenguajes de programación y varios plugins. Sin embargo, su característica (En mi opinión) es lo sencilla y rápida que puede ser. Entonces, la pregunta es. ¿Cómo usamos Django en Visual Studio Code?

Hay dos formas de hacer esto.

  1. Mediante la opción Depurar de Visual Studio Code.
  2. Ejecutando una terminal integrada en Visual Studio Code, activar el entorno virtual y arrancar el servidor de desarrollo de Django.

Opción 1

Una vez hemos configurado el intérprete de Python en los settings.json de Visual Studio Code. Vamos a ejecutar el depurador. Observemos los pasos de a  figura 6 enumerados del 1 al 4.

Configuración depurador Django en Visual Studio Code. Instalar y Configurar Django en Visual Studio Code.

Figura 6. Captura de pantalla configuración depuración Django en Visual Studio Code

  1. Debemos presionar clic en el icono depuración (Qué parece insecto).
  2. El icono de la tuerca es para mostrar el contenido del número 4, es decir, la configuración de argumentos para Django.
  3. El icono de play o «Iniciar» para comenzar la depuración con Django. Nota* Debemos seleccionar django en las opciones tal como se muestra en la figura.
  4. A veces es necesario especificar algunos argumentos a la hora de iniciar el servidor. Por ejemplo, una ip diferente y/o puerto diferente.

Resultado cuando ya se esta ejecutando el depurar Ver figura 7.

Captura de pantalla Iniciando Depuración Django. Instalar y Configurar Django en Visual Studio Code

Figura 7. Captura de pantalla iniciando depuración Django en Visual Studio Code

  1. Panel de opciones depurador Django. Podemos ver icono de pausar (aunque normalmente cuando se ejecuta es el icono play, además, en algunas ocasiones se debe presionar nuevamente play en ese panel para iniciar el servidor).
  2. En la consola de depuración podremos observar que efectivamente se ha iniciado de manera local.

Opción 2

Ahora vamos a ver como sería iniciar Django desde el terminal integrado de Visual Studio Code. Entonces, vamos a seleccionar en la barra de herramientas Ver > Terminal Integrado                                  (o Presionar Ctrl + ñ aunque funciona cuando esta en español, en ingles es Ctrl + ` ).

A continuación en la figura 8. Podremos observar el procedimiento.

Captura de pantalla iniciando Django desde la terminal integrado. Instalar y Configurar Django en Visual Studio Code.

Figura 8. Captura de pantalla iniciando Django desde el terminal integrado en Visual Studio Code

  1. Este comando es para activar el entorno virtual que hemos creado previamente.
  2. Como podemos observar el entorno virtual esta activado, y hemos ejecutado el comando para iniciar el servidor local.
Beneficios de la opción 1
  • No se necesita abrir la terminal, ni activar el entorno y tampoco ejecutar el servidor de desarrollo (Comando runserver).
  • Se puede usar depuración de código con una alta gama de opciones y verificación de variables, etc.
Desventajas de la opción 1
  • A veces suele tardarse un poco al iniciarse el proceso depuración.
  • A veces el contenido queda cacheado. Lo cual incurre a reiniciar la depuración y/o eliminación del cache para ver cambios.
Beneficios de la opción 2
  • Es mucho más rápida la ejecución.
  • Los cambios se ven reflejados constantemente, es decir, no queda tanto cache.
Desventajas de la opción 2
  • Se debe activar el terminal integrado manualmente.
  • Se debe activar el entorno virtual manualmente.

Conclusiones

El propósito de esta entrada es Instalar y Configurar Django en Visual Studio Code. Por esa razón, no sé profundiza como crear aplicaciones o proyectos en Django. Tampoco, como se usa el depurador de Django en Visual Studio Code. Estos temas podrían ser tomados en entradas futuras.

Referencias

Resumen
Instalar y configurar Django en Visual Studio Code
Nombre del Articulo
Instalar y configurar Django en Visual Studio Code
Descripcion
Aprenderemos a instalar y configurar el framework Django de python en Visual Studio Code. tambien vamos crear entornos virtuales con "virtualenv"
Autor
Nombre del Editor
XeeDBeam
Logo del Editor

Leave a Reply

Se el primero en comentar

Notify of
avatar
wpDiscuz