finanzas-personales 0.1.2

Una aplicación de consola para gestionar finanzas personales

Finanzas Personales

Una aplicación de consola para gestionar finanzas personales, incluyendo ingresos, egresos, resúmenes y gráficos.

Características

• Registro de ingresos y egresos con categorías predefinidas.
• Visualización de resúmenes financieros totales y mensuales.
• Gráficos en consola y generados como imágenes PNG.
• Interfaz interactiva con navegación por teclado.

Requisitos

• Python 3.8+
• Dependencias: rich, prompt_toolkit, matplotlib

Instalación

Opción 1: Desde PyPI

1. Instala el paquete directamente desde PyPI:

   pip install finanzas_personales
   

2. Ejecuta la aplicación:

   finanzas_personales
   

Opción 2: Clonar Repo

1. Clona el repositorio:

   git clone https://github.com/ErickCosta98/finanzas_personales.git
   cd finanzas_personales
   

2. Crear un entorno virtual (opcional, ver instrucciones por sistema operativo abajo).

3. Instala las dependencias:

   pip install -r requirements.txt
   

4. Ejecuta la aplicación:

   python3 -m finanzas_personales.main
   

Uso con Entorno Virtual

A continuación, se detallan los comandos para crear y activar un entorno virtual según el sistema operativo y la terminal utilizada.

Linux / macOS

Bash

# Crear entorno virtual
python3 -m venv venv

# Activar entorno virtual
source venv/bin/activate

# Desactivar (cuando termines)
deactivate

Zsh

# Crear entorno virtual
python3 -m venv venv

# Activar entorno virtual
source venv/bin/activate

# Desactivar
deactivate

Fish

# Crear entorno virtual
python3 -m venv venv

# Activar entorno virtual
source venv/bin/activate.fish

# Desactivar
deactivate

Windows

CMD

# Crear entorno virtual
python -m venv venv

# Activar entorno virtual
venv\Scripts\activate.bat

# Desactivar
deactivate

PowerShell

# Crear entorno virtual
python -m venv venv

# Activar entorno virtual
.\venv\Scripts\Activate.ps1

# Desactivar
deactivate

Git Bash

# Crear entorno virtual
python -m venv venv

# Activar entorno virtual
source venv/Scripts/activate

# Desactivar
deactivate

Uso General

• Usa las flechas ↑/↓ para navegar por los menús.
• Presiona Enter para seleccionar una opción.
• Ingresa datos como cantidad y descripción cuando se solicite.
• Usa Escape para salir de submenús o cerrar el programa.

Captura de Pantalla

Estructura del Proyecto

• database.py: Manejo de la base de datos SQLite.
• graphics.py: Generación de gráficos en consola y PNG.
• interface.py: Lógica de la interfaz de usuario.
• models.py: Definición de categorías y estructuras de datos.
• main.py: Punto de entrada principal.

Contribuir

¡Las contribuciones son bienvenidas! Por favor, abre un issue o un pull request.

Licencia

MIT