23 - Introduccion a Django.ipynb

{
 "nbformat": 4,
 "nbformat_minor": 0,
 "metadata": {
  "colab": {
   "name": "Untitled0.ipynb",
   "provenance": [],
   "toc_visible": true,
   "authorship_tag": "ABX9TyO7tUkY0OsM8ab8mCelTV7d",
   "include_colab_link": true
  },
  "kernelspec": {
   "name": "python3",
   "display_name": "Python 3"
  }
 },
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "view-in-github",
    "colab_type": "text"
   },
   "source": [
    "<a href=\"https://colab.research.google.com/github/arleserp/MinTIC2022/blob/master/23%20-%20Introduccion%20a%20Django.ipynb\" target=\"_parent\"><img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/></a>"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {
    "id": "1OPggay1bvU7"
   },
   "source": [
    "## MinTIC2020 Ciclo 1\n",
    "Bienvenido al repositorio que contiene el ejercicio de cierre del Ciclo 1 de MisiónTIC 2022 del Gobierno de Colombia.\n",
    "En este ejercicio usted realizará un paso a paso en donde usando los conocimientos aprendidos en python, nuevas cosas que va a aprender, y algunos elementos previamente construidos por sus profesores, creara un versión bastante sencilla de una Tienda Virtual.\n",
    "De esta manera, usted podrá ver de una forma directa como utilizar los conceptos que aprendió en este ciclo, además de evidenciar la importancia del trabajo en equipo con otros roles tradicionales (como el caso de los desarrolladores front-end) en la conformación de equipos de desarrollo de software.\n",
    "\n",
    "\n",
    "## Pre-requisitos \n",
    "Para el presente ejercicio usted debe contar con una versión de `Python >= 3.6`. Si no es así, por favor, actualice su versión de Python.\n",
    "\n",
    "Este ejercicio deberá correrse sobre un IDE (el presentado en el curso es VS Code), por lo cual se recomienda no intentar hacer el ejercicio en CoLAB o en Repl.it.\n",
    "\n",
    "Adicionalmente, deben instalarse unos módulos de la galería de Python que son de bastante uso en el desarrollo de aplicaciones web.\n",
    "\n",
    "\n",
    "\n",
    "\n",
    "En primera instancia, usted debe tener un entorno virtual construido, para evitar conflictos versiones de módulos y tecnologías que usted tenga en otros proyectos.\n",
    "Siendo así, vaya a la ventana de comandos (terminal, powershell, o similar), ubíquese en la carpeta en donde desee alojar el proyecto, y ejecute las siguientes instrucciones:.\n",
    "\n",
    "***\n",
    "\n",
    "En ocasiones python no reconoce el ambiente virtual (en inglés virtual environment), se debe  ejecutar el siguiente comando y comprobar si ya se encuentra instalado:\n",
    "\n",
    "*Linux o MAC*:\n",
    "```\n",
    "sudo apt-get install python3-venv\n",
    "```\n",
    "\n",
    "*Windows*:\n",
    "```\n",
    "python -m pip install virtualenv\n",
    "```\n",
    "\n",
    "***\n",
    "\n",
    "## Creación de un ambiente virtual\n",
    "\n",
    "Para la creación de un ambiente virtual, normalmente se ejecuta el comando como ```python -m venv nombre_entorno```. Para este ejercicio, el nombre del entorno será `env` (es común que los desarrolladores usen `env` como nombre del entorno virtual):\n",
    "```\n",
    "python -m venv env\n",
    "```\n",
    "\n",
    "En ocasiones puede que se haya instalado python3 y que python no lo reconozca, por lo que deberá ejecutar el siguiente comando:\n",
    "\n",
    "```\n",
    "python3 -m venv env\n",
    "```\n",
    "## Activación del ambiente virtual\n",
    "\n",
    "Para trabajar dentro del entorno virtual, primero debe activarse el mismo, lo cual puede hacer con la siguiente instrucción:\n",
    "\n",
    "*Linux o MAC:*\n",
    "```\n",
    "source env/bin/activate\n",
    "```\n",
    "\n",
    "*Windows:*\n",
    "```\n",
    "env\\Scripts\\activate\n",
    "```\n",
    "\n",
    "\n",
    "Si usted colocó un nombre distinto para el entorno virtual, deberá ajustar la instrucción anterior.\n",
    "\n",
    "Recuerde que al ejecutar el comando anterior el entorno virtual quedará activo. Esta activación del entorno virtual se perderá cada vez que usted apague su computador. Por lo anterior, le pedimos el favor que cada vez que cierre la terminal y vuelva a tratar de ejecutar los comandos que aparecen a continuación, ejecute nuevamente la instrucción anterior.\n",
    "\n",
    "***\n",
    "\n",
    "En este punto puede verificar la versión de python usada dentro del entorno virtual usando la instrucción:\n",
    "```\n",
    "python --version\n",
    "```\n",
    "\n",
    "Una vez tenga activo su entorno virtual, es momento  de crear un archivo en el cual usted coloque los módulos (y se recomienda también las versiones) que usted necesita para el desarrollo apropiado del proyecto. Estando en la raíz del proyecto, cree un archivo denominado `requirements.txt`, y en él coloque el texto a continuación:\n",
    "```\n",
    "setuptools==50.3.0\n",
    "Django==3.1.2\n",
    "pymongo==3.11.0\n",
    "```\n",
    "\n",
    "En este caso, el archivo `requirements.txt` le explica al interprete de python que instale las siguientes librerias:\n",
    "- Django: Framework ampliamente reconocimiento para el desarrollo de python en web, especialmente por la facilidad que brinda al momento de manejar MVC.\n",
    "- pymongo: módulo que permite la conexión y manipulación de información en el motor de base de datos de MongoDB.\n",
    "- setuptools: librería que ayuda a la gestión de otros módulos con python, mantener actualizaciones, entre otros.\n",
    "\n",
    "Ahora, luego de guardar el archivo con los módulos requeridos, puede colocar la siguiente instrucción para instalar todo lo enlistado en el archivo:\n",
    "\n",
    "*Linux o MAC*:\n",
    "```\n",
    "pip install -r requirements.txt\n",
    "```\n",
    "\n",
    "*Windows*:\n",
    "```\n",
    "python -m pip install -r requirements.txt\n",
    "```\n",
    "\n",
    "Si usted observa, tener un archivo como este es útil, primero porque puede instalar todos los módulos con una sola instrucción; segundo, porque cuando necesite recrear su entorno de desarrollo será mucho más rápido.\n",
    "\n",
    "Para verificar la versión instalada de **Django**, puede usar la siguiente instrucción:\n",
    "```\n",
    "python -m django --version\n",
    "```\n",
    "\n",
    "Al ejecutar la sentencia anterior le debería aparecer lo siguiente:\n",
    "```\n",
    "3.1.2\n",
    "```\n",
    "\n",
    "Ahora, usted tiene su entorno de desarrollo configurado para el ejercicio de la Tienda Virtual. Ahora, es momento de entrar a trabajar con **Django**.\n",
    "\n",
    "## Manejo Básico de **Django**\n",
    "**Django** es un Framework que ayuda a mantener de manera simple y separada las vistas, las URLs, y los controladores de la lógica del negocio. Su manejo es muy sencillo, así que a continuación se hara la secuencia de instrucciones que permiten crear un proyecto en **Django**, y dentro de este proyecto una aplicación web para la creación de la Tienda Virtual.\n",
    "\n",
    "Para crear un proyecto en **Django**, teniendo el entorno virtual activo y en la raíz de la carpeta del ejercicio, ejecute el siguiente comando:\n",
    "```\n",
    "django-admin startproject misiontic2020_ciclo1\n",
    "```\n",
    "\n",
    "Esto creará una carpeta llamada `misiontic2020_ciclo1` puesto que es el nombre que se le dio al proyecto en **Django**. Dentro de esta carpeta se han auto-generado los archivos necesario para la gestión del proyecto: una carpeta con el mismo nombre del proyecto, y el archivo principal `manage.py`.\n",
    "Si usted quiere darle otro nombre a su proyecto, tendrá que cambiar la cadena de caracteres final de la instrucción utilizada. \n",
    "\n",
    "Es momento de utilizar algún IDE y agregar la carpeta del ejercicio, para así poder modificar el código del mismo de una manera más sencilla (no vaya a cerrar la ventana de terminal, la va a utilizar de nuevo más adelante). \n",
    "Estando en el explorador de archivos del IDE, usted deberá ver en la raíz del ejercicio la carpeta `mision2020_ciclo1`; por favor, expanda esa carpeta. Al expandir, verá el archivo `manage.py`, y una carpeta llamada de nuevo `mision2020_ciclo1`.\n",
    "Al expandir esta segunda carpeta, observara varios archivos de python:\n",
    "- _ _init_ _.py: Define el contenido de la carpeta como un módulo de python.\n",
    "- asgi.py: permite asociar el proyecto para ser lanzado en un canal asincrónico.\n",
    "- settings.py: Configuraciones generales del proyecto en **Django**.\n",
    "- urls.py: Listado de urls definidas para ser accedidas por el usuario en el MVC.\n",
    "- wsgi.py: permite asociar la aplicación para ser lanzada automáticamente con el servidor Apache.\n",
    "\n",
    "\n",
    "Por favor, dirígase al archivo de settings.py, en donde deberá realizar los siguientes cambios para ejecutar por primera vez la aplicación:\n",
    "1. Djando define desde que dirección de servidor puede ser ubicado. Como va a correr en la máquina local, le recomendamos que modifique la siguiente línea de código:\n",
    "```\n",
    "ALLOWED_HOSTS = ['localhost', '127.0.0.1']  # linea 28\n",
    "```\n",
    "\n",
    "2. Es bueno configurar la zona del mundo, para un buen manejo de datos que tengan que ver con fecha, hora, e idioma para el usuario. Para ello, modifique las siguientes líneas de código:\n",
    "```\n",
    "LANGUAGE_CODE = 'es-es'  # línea 106\n",
    "TIME_ZONE = 'America/Bogota'   # línea 108\n",
    "```\n",
    "\n",
    "3. Importe el módulo `os` que le da acceso a python a algunas funcionalidades propias del sistema operativo (como la creación y acceso a carpetas dentro del sistema de archivos), esto lo necesitaremos para el punto 4:\n",
    "```\n",
    "import os # línea 14\n",
    "```\n",
    "\n",
    "\n",
    "4. Finalmente, **Django** maneja temas como imágenes o código de JavaScript en la categoría de _static_. Para asegurar que no se tiene problema accediendo a las rutas de estos elementos, agregue al final del archivo la siguiente línea de código.\n",
    "```\n",
    "STATIC_ROOT = os.path.join(BASE_DIR, 'static')\n",
    "```\n",
    "\n",
    "\n",
    "Ahora, es momento de probar que todo anda funcionando correctamente. Claro, no se ha agregado nada del desarrollo web, pero se puede validar que la creación y configuración del proyecto de **Django** es correcta. Para ello, debe regresar a la ventana de comandos ó terminal, y ubicarse en la carpeta raíz del proyecto. Allí, acceda a la carpera del proyecto de **Django** usando el siguiente comando:\n",
    "```\n",
    "cd misiontic2020_ciclo1\n",
    "```\n",
    "\n",
    "estando allí, ejecute la siguiente instrucción que colocará el proyecto disponible para acceder desde cualquier navegador web:\n",
    "```\n",
    "python manage.py runserver\n",
    "```\n",
    "\n",
    "Ahora, usando cualquier navegador coloque la dirección: [http://localhost:8000](http://localhost:8000), y allí vera una ventana con un cohete que le indicará que el proyecto en **Django** está bien construido hasta ahora.\n",
    "\n",
    "![django inicial](https://drive.google.com/uc?export=view&id=1vvchSxOhOCGFWu9sDoKOxrh4HkW-JN0z)\n",
    "\n",
    "Para continuar, por favor regrese a la ventana de comandos o terminal, y haga la siguiente secuencia de teclas: `Ctrl + C`. Esta secuencia de comandos se realiza para detener la ejecución de **Django**.\n",
    "\n",
    "Verifique que su estructura de archivos del proyecto dentro de **Visual Studio Code** se parezca a la siguiente imagen:\n",
    "\n",
    "![arbol-antes](https://drive.google.com/uc?export=view&id=1nHkAjFSDwVGhSfmhlWMH5bAzjhidNVI_)\n",
    "\n",
    "Es momento de crear la aplicación web dentro del proyecto de **Django**. Es importante mencionar que en **Django** se pueden tener varias aplicaciones web, en el caso de que quiera trabajar un proyecto por componentes interconectados. Para nuestro ejercicio, solo se tendrá una aplicación web, la cual será la tienda virtual; para crearla, utilice la siguiente instrucción (debe mantenerse ubicado en la raíz del proyecto de **Django**, donde está el archivo de `manage.py`):\n",
    "```\n",
    "python manage.py startapp tienda_virtual\n",
    "```\n",
    "\n",
    "Una vez ejecute el anterior comando, verifique nuevamente si su estructura de archivos se parece a la siguiente imagen:\n",
    "\n",
    "![arbol-despues](https://drive.google.com/uc?export=view&id=12H1hUOinPBdJc62DzZ4W_-ByWCAOJsuJ)\n",
    "\n",
    "En nuestro proyecto, la app se llama `tienda_virtual`. Si usted quiere darle otro nombre, debe cambiar el final de la instrucción utilizada anteriormente. Una vez se haya ejecturado esta instrucción, se creará una carpeta con el mismo nombre de la app, y tendrá los archivos fundamentales para el manejo del MVC en **Django**.\n",
    "\n",
    "Adicionalmente, debe ir al archivo de \"settings.py\" dentro de la aplicación mision **misiontic2020_ciclo1**, ese mismo que modificó hace un par de pasos atrás, y en la lista de `INSTALLED_APPS` agregue el siguiente elemento:\n",
    "```\n",
    "'tienda_virtual', #~línea 41\n",
    "```\n",
    "\n",
    "El archivo se debe parecer a la siguiente imagen:\n",
    "\n",
    "![settings-tienda-virtual](https://drive.google.com/uc?export=view&id=1Xc8-chbwSC126XR0G8-9h9LbWYyP5PMX)\n",
    "\n",
    "\n",
    "Listo, usted ha creado su primer proyecto de **Django** con una definición inicial de una aplicación web embebida en el mismo.\n",
    "\n",
    "\n",
    "# Errores Detectados\n",
    "### PIP no es reconocido como comando\n",
    "En este caso, solo requiere instalar de manera específica. Para ello, ejecute las siguientes instrucciones:\n",
    "```\n",
    "curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py\n",
    "python get-pip.py\n",
    "```\n",
    "Una vez esto se ejecute por completo, pruebe de nuevo el comando _pip_.\n",
    "\n",
    "\n",
    "### Windows no permite la ejecución de Scripts: \n",
    "En este caso, vaya al buscador en Windows (lupa en la parte inferior izquierda), y escriba _Powershell_, allí verá una opción de `Abrir como Administrador`, de click en ella y coloque la siguiente instrucción:\n",
    "```\n",
    "Set-ExecutionPolicy RemoteSigned\n",
    "```\n",
    "Haga enter, y vuelva y pruebe la activación del entorno virtual, deberá funcionar de manera normal.\n"
   ]
  }
 ]
}