Guía para Iniciar y Ejecutar el Proyecto Flask

Este archivo contiene los pasos necesarios para configurar, iniciar y ejecutar el proyecto Flask.

---

Configuración Inicial del Proyecto

1. Instalar Python:

   • Asegúrate de tener Python 3.7 o superior instalado.
   • Verifica la versión con:

     python --version

2. Crear un Entorno Virtual:

   • En la terminal, crea el entorno virtual:

     python -m venv venv

3. Activar el Entorno Virtual:

   • En Windows (PowerShell):

     venv\Scripts\activate

   • En Mac/Linux:

     source venv/bin/activate

4. Instalar Dependencias:

   • Instala Flask u otras dependencias necesarias:

     pip install flask

5. Guardar las Dependencias:

   • Una vez instaladas, guarda las dependencias en un archivo requirements.txt:

     pip freeze > requirements.txt

6. Estructura del Proyecto:

   • Asegúrate de que la estructura sea similar a la siguiente:

     my_flask_project/
     │
     ├── app/
     │   ├── __init__.py
     │   ├── routes.py
     │   └── templates/
     │       └── index.html
     │
     ├── venv/
     └── run.py
     

---

Ejecución del Proyecto

1. Activar el Entorno Virtual:

   • Siempre activa el entorno virtual antes de trabajar en el proyecto:
     • En Windows (PowerShell):

       venv\Scripts\activate

     • En Mac/Linux:

       source venv/bin/activate

2. Instalar Dependencias Faltantes:

   • Si otros desarrolladores agregaron dependencias, instálalas con:

     pip install -r requirements.txt

3. Ejecutar la Aplicación:

   • Ejecuta el archivo principal del proyecto:

     python run.py

   • Esto iniciará el servidor en http://127.0.0.1:5000.

---

Solución de Problemas Comunes

1. Error: ModuleNotFoundError: No module named 'flask':

   • Solución: Asegúrate de activar el entorno virtual y que Flask esté instalado:

     pip install flask

2. Error: No pyvenv.cfg file:

   • Solución: Elimina y recrea el entorno virtual:

     Remove-Item -Recurse -Force venv
     python -m venv venv

3. Asegúrate de Activar el Entorno:

   • El entorno virtual debe estar activo antes de cualquier instalación o ejecución.

---

Mantenimiento del Proyecto

1. Actualizar Dependencias:

   • Si es necesario actualizar paquetes:

     pip install --upgrade paquete_nombre

2. Guardar Cambios en el Repositorio:

   • Asegúrate de incluir siempre el archivo requirements.txt y el código actualizado.

3. Copia del Entorno:

   • Para compartir el proyecto, otro desarrollador solo necesita clonar el repositorio y ejecutar:

     python -m venv venv
     source venv/bin/activate  # Activar el entorno
     pip install -r requirements.txt  # Instalar dependencias

---

Indicaciones para Clonar el Proyecto

1. Clonar el Repositorio:

   • Usa el comando:

     git clone <URL_DEL_REPOSITORIO>

2. Navegar al Directorio del Proyecto:

   • Accede a la carpeta del proyecto:

     cd my_flask_project

3. Crear y Activar el Entorno Virtual:

   • Crear:

     python -m venv venv

   • Activar:

     venv\Scripts\activate  # Windows
     source venv/bin/activate  # Mac/Linux

4. Instalar Dependencias:

   • Usa el archivo requirements.txt:

     pip install -r requirements.txt

5. Ejecutar la Aplicación:

   • Inicia el servidor:

     python run.py

---

Con esta guía, tendrás todo listo para iniciar y ejecutar tu proyecto Flask correctamente. ¡Éxito!