TaskFlow CLI 🚀

TaskFlow CLI es un gestor de tareas moderno ejecutado directamente desde la terminal. Desarrollado en Python 3.12+, el proyecto implementa una arquitectura limpia, persistencia de datos y una interfaz visual atractiva, todo bajo un flujo de trabajo de desarrollo asistido por IA.

🛠️ Características Principales

• Interfaz Vibrante: Uso de la librería rich para tablas y mensajes con colores y formato avanzado.

• Comandos Intuitivos: Construido con typer para una experiencia de usuario fluida en la CLI.

• Persistencia Robusta: Almacenamiento local mediante archivos JSON para no perder nunca tus tareas.

• Gestión Inteligente: Sistema de prioridades y estados de tarea (Pendiente/Completada).

• Calidad de Código: Batería de tests unitarios con pytest y uso de dataclasses para un tipado fuerte.

🏗️ Requisitos Técnicos

Lenguaje: Python 3.12 o superior.

Dependencias principales:

• typer: Para la creación de la interfaz de comandos.

• rich: Para el renderizado de tablas y estilos en consola.

• pytest: Para la ejecución de tests.

• customtkinter: Para la interfaz grafica.

• pydantic / dataclasses: Para el modelado y validación de datos.

🚀 Instalación y Configuración

Clona el repositorio:

git clone https://github.com/zombiradiactivo/TaskFlow-CLI.git
cd TaskFlow-CLI

Crea y activa un entorno virtual(Opcional):

python -m venv venv
source venv/bin/activate  # En Windows: venv\Scripts\activate

Instala las dependencias:

pip install -r requirements.txt

💻 Uso de la Aplicación via CLI

A continuación, algunos comandos básicos para interactuar con TaskFlow:

Añadir una tarea(1 Prioridad baja - 5 Prioridad Alta):

python -m taskflow.cli add "Nombre de la tarea" [1-5] 

Listar tareas:

Ordena las tareas por múltiples criterios:

• 1. fecha (más reciente o más antigua según prioridad).
• 2. prioridad (de mayor a menor por defecto).
• 3. abc (alfabeticamente).

[--type "OPCIONES" es opcional]

[Opciones posibles "fecha", "prioridad", "abc"]

python -m taskflow.cli list --type "OPCIONES"

Completar una tarea:

python -m taskflow.cli done [id]

Mostrar estadisticas:

python -m taskflow.cli stats

Eliminar una tarea:

python -m taskflow.cli delete [id]

💻 Uso de la Aplicación via GUI

Iniciar la interfaz grafica:

python -m taskflow.gui

🗄️ Patrón Repository

Hemos implementado el Patrón Repository para gestionar la capa de datos de forma desacoplada. ¿Por qué lo usamos?

• Abstracción: El resto de la aplicación no sabe que los datos se guardan en un archivo .json. Si mañana decidimos usar una base de datos SQL, solo tendríamos que crear un nuevo repositorio que herede de la misma interfaz.

• Centralización: Toda la lógica de lectura, escritura y transformación de datos (como el formateo de datetime a ISO string) reside en un solo lugar.

• Testeabilidad: Facilita la creación de "Mocks" o repositorios en memoria para pruebas unitarias sin tocar el disco duro.

🧠 Metodología: Colaboración Humano-IA

Este proyecto es un caso de estudio sobre el desarrollo de software moderno. Se han aplicado los siguientes pilares:

• Generación Asistida: Uso de prompts estratégicos para el andamiaje inicial del código.

• Refactorización Iterativa: Mejora constante de la estructura del código para garantizar mantenibilidad.

• Algoritmos y Lógica: Implementación manual y asistida de sistemas de filtrado y ordenación.

• IA Responsable: Validación crítica de cada línea generada, asegurando que el código cumple con los estándares de seguridad y eficiencia.

🧪 Testing

Para asegurar la estabilidad del proyecto, ejecuta la suite de pruebas con el siguiente comando:

pytest