Merge pull request #54 from WorkTeam01/refactor/project-structure

refactor: reorganizar estructura del proyecto (src/, tests/, requirements.txt)

Author: jandrescodes

.github/workflows/ci.yml

@@ -24,7 +24,7 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install pytest
+          pip install -r requirements.txt
 
       - name: Run tests
-        run: pytest -v
+        run: pytest tests/ -v

requirements.txt

@@ -0,0 +1,2 @@
+# Dependencias para desarrollo y testing
+pytest>=7.0.0

src/__init__.py

@@ -0,0 +1,7 @@
+"""Paquete calculadora con GUI y CLI.
+
+Módulos:
+    calculator: Funciones matemáticas básicas
+    gui: Interfaz gráfica con tkinter
+    cli: Interfaz de línea de comandos
+"""

calculator.py src/calculator.pycalculator.py renamed to src/calculator.py

@@ -1,11 +1,10 @@
-#!/usr/bin/env python3
 """Archivo principal de ejemplo para el proyecto Team Practice.
 
 Demuestra cómo usar los módulos del proyecto y cómo estructurar
 un punto de entrada principal.
 """
 
-from calculator import add, subtract, multiply, divide, power, valor_maximo, valor_minimo, abs_value
+from .calculator import add, subtract, multiply, divide, power, valor_maximo, valor_minimo, abs_value
 
 def main():
     """Función principal del programa."""

main.py src/cli.pymain.py renamed to src/cli.py

@@ -1,5 +1,13 @@
+"""Interfaz gráfica de usuario (GUI) para la calculadora.
+
+Este módulo implementa una calculadora con interfaz tkinter que incluye:
+- Operaciones básicas: suma, resta, multiplicación, división, potencia
+- Funciones científicas: valor absoluto, máximo, mínimo
+- Soporte para teclado y números negativos
+- Manejo de errores con mensajes visuales
+"""
 import tkinter as tk
-from calculator import (add, subtract, multiply, divide, power, valor_maximo, valor_minimo, abs_value)
+from .calculator import (add, subtract, multiply, divide, power, valor_maximo, valor_minimo, abs_value)
 
 class CalculatorGUI:
     def __init__(self, root):

gui.py src/gui.pygui.py renamed to src/gui.py

@@ -0,0 +1,4 @@
+"""Suite de tests para Team Practice Calculator.
+
+Tests unitarios para los módulos calculator y gui.
+"""

tests/__init__.py

@@ -1,3 +1,8 @@
+"""Configuración de pytest y fixtures para tests.
+
+Este módulo contiene fixtures y configuración compartida para todos los tests.
+Incluye mocks de componentes tkinter para ejecutar tests sin interfaz gráfica.
+"""
 import pytest
 import tkinter as tk
 

conftest.py tests/conftest.pyconftest.py renamed to tests/conftest.py

@@ -6,7 +6,7 @@
 
 import pytest
 
-from calculator import add, subtract, multiply, divide, power, valor_maximo, valor_minimo, abs_value
+from src.calculator import add, subtract, multiply, divide, power, valor_maximo, valor_minimo, abs_value
 
 
 def test_add():

test_calculator.py tests/test_calculator.pytest_calculator.py renamed to tests/test_calculator.py

@@ -4,7 +4,7 @@
 Para correr los tests: pytest test_gui_calculator.py -v
 """
 import tkinter as tk
-from gui import CalculatorGUI
+from src.gui import CalculatorGUI
 
 
 # ============================================================================