Skip to content

CHANGELOG.md

Latest commit

 

History

History
358 lines (276 loc) · 13.1 KB

CHANGELOG.md

File metadata and controls

358 lines (276 loc) · 13.1 KB
Raw

Changelog

Todos los cambios notables en este proyecto serán documentados en este archivo.

El formato está basado en Keep a Changelog, y este proyecto se adhiere a Semantic Versioning.

[2.1.0] - 2025-12-03

🎉 Minor Release - Operaciones con Paréntesis + Reorganización de Proyecto

Este release introduce soporte completo para expresiones matemáticas con paréntesis, reorganiza la estructura del proyecto siguiendo mejores prácticas de Python, y corrige bugs importantes relacionados con números complejos y decimales negativos.

Agregado

Operaciones con Paréntesis (#44, #56)

  • Soporte completo de paréntesis en la calculadora GUI
    • Evaluación de expresiones matemáticas complejas: (2+3)*4, 2*(3+4), ((2+3)*4)/5
    • Botones funcionales ( y ) en la interfaz
    • Entrada de paréntesis desde teclado
    • Validación de paréntesis balanceados
    • Validación de caracteres seguros con regex
    • Modo de expresión automático al usar paréntesis
    • Compatibilidad con modo normal (sin paréntesis)
    • Soporte para decimales y números negativos en expresiones
    • Paréntesis anidados soportados

Testing de Paréntesis

  • 13 tests unitarios nuevos para funcionalidad de paréntesis (#56)
    • Tests de operaciones básicas con paréntesis
    • Tests de paréntesis anidados
    • Tests con decimales y números negativos
    • Tests con potencias
    • Tests de validación de paréntesis desbalanceados
    • Tests de modo de expresión
    • Tests de compatibilidad entre modos
    • Tests de división por cero en expresiones
    • Tests de actualización del display

Reorganización del Proyecto (#53, #54)

  • Nueva estructura de carpetas profesional
    • Carpeta src/ para código fuente
      • src/calculator.py - Lógica matemática
      • src/cli.py - Interfaz de línea de comandos (renombrado desde main.py)
      • src/gui.py - Interfaz gráfica
      • src/__init__.py - Paquete Python
    • Carpeta tests/ para tests
      • tests/test_calculator.py
      • tests/test_gui.py (renombrado desde test_gui_calculator.py)
      • tests/conftest.py
      • tests/__init__.py
    • Archivo requirements.txt para gestión de dependencias
  • Mejor escalabilidad y organización del código
  • Imports mejorados con estructura de paquetes
  • Comandos actualizados: python src/gui.py, python src/cli.py

Corregido

Raíces Pares de Números Negativos (#50, #57)

  • Fix: Evitar resultados complejos en raíces pares negativas
    • Validación en calculator.py para detectar raíces pares de negativos
    • Lanza ValueError con mensaje "Raíz negativa"
    • Captura del error en GUI con mensaje claro "⚠️ Raíz negativa"
    • Tests unitarios para verificar el comportamiento
    • Ejemplo: -2 ^ 0.5 ahora muestra error en lugar de 1.414j
    • Algoritmo: valida si 1/exponent es par para detectar raíces pares

Manejo de Decimales Negativos (#49, #55)

  • Mejora de UX en entrada de decimales negativos
    • Autocompletado de -0. al presionar . después de -
    • Validación mejorada para evitar números incompletos como -.
    • Comportamiento consistente: "-" + "." → "-0."
    • Ejemplo: -.3 ahora se autocompleta a -0.3
    • Mejor experiencia de usuario y consistencia

Mejorado

  • Evaluación de expresiones con validación de seguridad usando regex
  • Manejo de errores más robusto con mensajes específicos
  • Display de GUI actualizado correctamente en modo expresión
  • Backspace funciona en ambos modos (normal y expresión)
  • Clear resetea correctamente el modo de expresión
  • Estructura del proyecto más profesional y escalable
  • Imports más claros y mantenibles

Técnico

Paréntesis:

  • Implementación de open_parenthesis_click() y close_parenthesis_click()
  • Variable expression para construir expresiones completas
  • Variable use_expression_mode para detectar uso de paréntesis
  • Validación con regex ^[\d\s\+\-\*\/\^\(\)\.]+$
  • Conversión de ^ a ** para evaluación de potencias
  • Evaluación segura con eval() después de validaciones
  • Manejo de excepciones: SyntaxError, ZeroDivisionError

Reorganización:

  • Migración de archivos a src/ y tests/
  • Actualización de imports relativos
  • Creación de __init__.py en paquetes
  • requirements.txt con pytest>=7.0.0

Validaciones:

  • Detección de raíces pares con algoritmo de inversión de exponente
  • Validación de decimales negativos en decimal_click()

Issues y PRs Incluidas

Issues Completadas:

  • #44 - Soporte de operaciones con paréntesis en la calculadora GUI
  • #50 - Error: Raíces pares de números negativos generan resultados complejos
  • #49 - Error: Manejo confuso de números decimales negativos
  • #53 - Mejora: reorganizar estructura del proyecto

Pull Requests Mergeados:

  • #57 - fix: evitar resultados complejos para raíces pares negativas (2025-12-03)
  • #56 - feat: implementar soporte de paréntesis en calculadora (2025-12-02)
  • #55 - Fix: Corrección del comportamiento del decimal después del signo menos (2025-12-01)
  • #54 - refactor: reorganizar estructura del proyecto (src/, tests/, requirements.txt) (2025-11-30)

Agradecimientos

Este release fue posible gracias a las contribuciones de:

  • @Jandres25 (Jose Andres Meneces Lopez)

    • Implementación de soporte de paréntesis (#56)
    • 13 tests unitarios para paréntesis
    • Reorganización de estructura del proyecto (#54)
    • Coordinación del release v2.1.0

  • @Jhos3ph

    • Fix de raíces pares negativas (#57)
    • Validación de números complejos
    • Tests unitarios para validación

  • @alexricardotapiacarita-ai

    • Fix de manejo de decimales negativos (#55)
    • Mejoras de UX en entrada de números

[2.0.0] - 2025-11-28

🎉 Major Release - Interfaz Gráfica + Testing Automatizado

Este release marca una evolución significativa del proyecto, introduciendo una interfaz gráfica completa, testing automatizado robusto, soporte de teclado y múltiples mejoras de usabilidad.

Agregado

Interfaz Gráfica de Usuario (GUI)

  • Calculadora visual con tkinter (#15, #16, #17)
    • Ventana principal con diseño moderno
    • Display interactivo de alta resolución para números y resultados
    • Grid de botones organizados por función
    • Tema oscuro profesional con paleta de colores elegante (#18, #19, #20, #21)
    • Diseño responsive con grid layout adaptable

Funcionalidades de GUI

  • Entrada numérica por clicks en botones (#22, #31)
  • Botón decimal (.) con validación para evitar múltiples puntos (#25, #32)
  • Lógica de operadores matemáticos: +, -, *, /, ^ (#26, #33)
  • Botones de control:
    • Clear (C): Limpia display y resetea estado (#28, #34)
    • Backspace (⌫): Elimina último carácter (#28, #34)
  • Funciones científicas integradas en GUI (#30, #35):
    • Valor absoluto (abs)
    • Máximo (max)
    • Mínimo (min)
  • Soporte para números negativos (#41, #45)
    • Ingreso de números negativos en la GUI
    • Manejo correcto de operaciones con negativos
  • Mejoras en manejo de múltiples números negativos (#43)
  • Soporte completo de teclado (#37, #47)
    • Atajos para todos los números (0-9)
    • Atajos para operadores (+, -, *, /, ^)
    • Enter o = para calcular resultado
    • Escape para limpiar display
    • Backspace para borrar último carácter
    • Control completo mediante teclado o mouse

Testing Automatizado

  • Archivo test_gui_calculator.py con suite completa de tests para GUI (#23, #48)
    • Tests de clicks en botones numéricos
    • Tests de botón Clear y Backspace
    • Tests de operaciones básicas
    • Tests de manejo de errores
  • Archivo conftest.py con fixtures y mocks de Tkinter (#48)
    • Clases dummy: DummyRoot, DummyEntry, DummyButton, DummyLabel
    • Fixture autouse para sustituir componentes gráficos
    • Tests ejecutables sin display gráfico (ideal para CI/CD)
    • Compatibilidad con entornos headless

CI/CD con GitHub Actions

  • Pipeline automático de integración continua (#36, #42)
    • Workflow configurado para ramas main y dev
    • Ejecución automática de tests en cada PR
    • Validación continua de calidad de código
    • Tests en ambiente headless sin Tcl/Tk
    • Archivo .github/workflows/ci.yml configurado

Documentación

  • Guía de usuario para la interfaz gráfica (#24, #40)
    • Instrucciones de uso de la GUI
    • Ejemplos de operaciones
    • Atajos de teclado documentados
  • Mejoras en documentación de funciones y manejo de errores (#29, #39)

Mejorado

  • Experiencia de usuario con dos interfaces disponibles:
    • CLI (main.py): Interfaz de línea de comandos original
    • GUI (gui.py): Interfaz gráfica moderna
  • Refactoring de lógica redundante en manejo de operadores (#46)
  • Manejo visual de errores en la GUI
    • División por cero detectada y manejada
    • Mensajes de error claros en el display
    • Validación de entrada de decimales y negativos
  • Organización del proyecto con separación clara CLI/GUI/tests
  • Calidad de código con validación continua

Técnico

  • Implementación de clase CalculatorGUI con tkinter
  • Sistema de grid layout responsivo para botones
  • Binding de eventos de teclado en tkinter
  • Fixtures de pytest con autouse=True
  • Mocks de componentes Tkinter para testing sin GUI
  • Workflow de GitHub Actions para CI/CD
  • Integración completa entre GUI y módulo calculator.py

Mantenido

  • Interfaz de línea de comandos (CLI) en main.py
  • Todas las funciones matemáticas originales
  • Compatibilidad con Python 3.12+
  • Suite de tests unitarios (test_calculator.py)
  • Templates de Issues y Pull Requests

Issues y PRs Incluidas

Issues Completadas:

  • #15 - Implementar: Prototipo inicial de GUI
  • #18 - Mejorar diseño: Ajustes y refinamientos de la GUI
  • #20 - Mejora: Estilos visuales de la GUI
  • #22 - Agregar función: Clicks de botones numéricos en GUI
  • #23 - Pruebas: Testing manual completo de GUI
  • #24 - Documentación: Guía de usuario para GUI
  • #25 - Agregar función: Botón punto decimal en GUI
  • #26 - Agregar función: Lógica de operadores en GUI
  • #28 - Agregar funcionalidad: Botones Clear y Backspace
  • #29 - Mejora: Manejo de errores y validaciones en GUI
  • #30 - Agregar función: Funciones científicas en GUI
  • #36 - Configurar CI/CD con GitHub Actions
  • #37 - Agregar soporte de teclado para calculadora GUI
  • #41 - Mejora: Números negativos sin operación de resta
  • #43 - Error: Difícil ingresar múltiples números negativos

Pull Requests Mergeados:

  • #48 - test: agregar tests de GUI con mocks de tkinter
  • #47 - feat: agregar soporte de teclado para calculadora GUI
  • #46 - refactor(gui): eliminar lógica redundante en el manejo de operadores
  • #45 - feat(gui): soporte para números negativos y actualización de documentación
  • #42 - feat: Configurar CI/CD con GitHub Actions
  • #40 - docs: Añadir guía de usuario para la GUI
  • #39 - refactor(gui): mejorar funciones unarias y manejo de errores
  • #35 - feat: Agregar funciones científicas (abs, max, min) con integración en GUI
  • #34 - feat: implementar botones C y ⌫ con su funcionalidad correspondiente
  • #33 - feat(core): añadir lógica de operaciones (+, -, *, /, ^) y soporte para botón "="
  • #32 - feat: implementar botón decimal con validación en la calculadora Tkinter
  • #31 - feat: Implementar lógica de clic para entrada numérica
  • #21 - feat: actualizar colores en gui.py
  • #19 - feat: ajustar diseño según selección del equipo
  • #17 - feat: Merge prototype calculator design from dev to main
  • #16 - feat: agregar prototipo de GUI con diseño base

Agradecimientos

Este release fue posible gracias a las contribuciones de:

  • @Jandres25 (Jose Andres Meneces Lopez)

    • Coordinador del release
    • Prototipo de GUI (#15, #16)
    • CI/CD con GitHub Actions (#42)
    • Testing automatizado de GUI (#23, #48)
    • Soporte de teclado (#47)

  • @Jhos3ph

    • Funciones científicas en GUI (#35)
    • Lógica de operaciones (#26, #33)
    • Entrada numérica (#22, #31)
    • Refactoring y optimizaciones (#39, #46)
    • Soporte de números negativos (#45)

  • @alexricardotapiacarita-ai

    • Diseño y estilos visuales (#18, #19, #20, #21)
    • Botón decimal con validación (#25, #32)
    • Botones Clear y Backspace (#28, #34)
    • Documentación y guía de usuario (#24, #40)

[1.0.0] - 2025-11-04

Agregado

  • Operaciones matemáticas básicas (suma, resta, multiplicación, división)
  • Funciones adicionales:
    • Potenciación
    • Valor máximo entre dos números
    • Valor mínimo entre dos números
    • Valor absoluto
  • Interfaz de línea de comandos interactiva
  • Manejo de errores y excepciones
  • Pruebas unitarias con pytest
  • Templates para Issues y Pull Requests en GitHub
    • Plantilla para reporte de errores
    • Plantilla para solicitud de funcionalidades

Técnico

  • Implementación base en Python 3.12
  • Estructura del proyecto organizada
  • Sistema de pruebas configurado con pytest

[Próximamente] - v3.0.0

Planeado

  • Historial de operaciones
  • Más funciones matemáticas (raíz cuadrada, logaritmos, trigonometría)
  • Temas personalizables (claro/oscuro)
  • Exportar historial de cálculos
  • Modo científico avanzado