Metadata-Version: 2.4
Name: moldpy
Version: 0.2.1
Summary: Generador de plantillas y estructuras de proyectos en Python
License: MIT
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.9.0
Requires-Dist: rich>=13.0.0
Requires-Dist: inquirer>=3.1.0
Dynamic: license-file

# 🧱 MoldPy

> Scaffolder e inicializador interactivo de proyectos en Python.

**MoldPy** es una herramienta de línea de comandos (CLI) diseñada para maquetar la estructura inicial de proyectos en Python (APIs en FastAPI, Dashboards en Streamlit, Data Science y Scripts de automatización) con configuración automática de entornos virtuales (`venv`), `.gitignore` y dependencias.

---

## 🎨 Características

- 🚀 **Plantillas Listas:** Genera proyectos completos para **FastAPI**, **Streamlit**, **Data Science** o **Scripts**.
- 🛠️ **Entornos Virtuales:** Crea el `venv` e instala las dependencias de `requirements.txt` automáticamente en segundo plano.
- 📋 **Previsualización Clara:** Tabla interactiva con el resumen de la configuración antes de escribir en disco.
- 💅 **Interfaz Moderna:** Diseñada con banderas y colores tipo terminal *cyberpunk*.

---

## 📦 Instalación

Instala **MoldPy** directamente desde PyPI usando `pip`:

```bash
pip install moldpy
```

### Para verificar que se instaló correctamente

```bash
moldpy --version
```

## 🚀 Guía de Uso Paso a Paso

- **Iniciar el Creador de Proyectos**
  Abre la terminal en la carpeta donde quieras crear tu nuevo proyecto y ejecuta:

```bash
moldpy create
```

- **Responder a las Preguntas del Asistente**
MoldPy te guiará con un menú interactivo:
    1. Tipo de proyecto: Elige entre:
        ⚡ API REST en FastAPI (Estructura de API con servidor Uvicorn).
        📊 Dashboard con Streamlit (Interfaz web interactiva para datos).
        📈 Data Science (Pandas & Jupyter) (Estructura para datos con notebooks y carpetas de datos).
        🛠️ Script de Automatización (Base limpia para automatización con .env).
    2. Nombre de la carpeta: El nombre del directorio donde se creará el código.
    3. Autor: Tu nombre o marca personal.
    4. Git: Opción para incluir un .gitignore preconfigurado.
    5. Entorno Virtual (venv): Opción para crear el entorno e instalar dependencias automáticamente.

## 🛠️ Comandos Disponibles

| Comando | Descripción |
| :--- | :--- |
| `moldpy create` | Inicia el asistente interactivo de creación. |
| `moldpy --version` o `moldpy -v` | Muestra la versión actual instalada de MoldPy. |
| `moldpy --help` | Muestra la ayuda general y opciones disponibles. |

## 💻 Guía Rápida: Cómo Ejecutar el Proyecto Creado

**Una vez que MoldPy termine de crear tu proyecto, sigue estos pasos para empezar a trabajar:**

- **Entra a la carpeta generada**:

```bash
cd nombre-de-tu-proyecto
```

- **Activa el Entorno Virtual (venv):**

Windows (PowerShell):
    PowerShell

```bash
.\venv\Scripts\activate
```

Linux / macOS:

```bash
source venv/bin/activate
```

1. **Ejecutar según el tipo de proyecto:**

   ```text
    FastAPI: uvicorn app.main:app --reload
    Streamlit: streamlit run app.py
    Data Science: jupyter lab
    Script: python src/main.py
    
    ```
