Dependencias del Sistema¶

Dependencias de Producción¶

Dependencias Críticas¶

xlwings==0.28.5¶

pip install xlwings==0.28.5

Propósito: Automatización COM de Microsoft Excel
Criticidad: 🔴 CRÍTICA - Sin esta dependencia la aplicación no funciona
Uso: Generación de índices Excel, aplicación de fórmulas, apertura automática de archivos

Configuración específica:

import xlwings as xw

# Configuración típica
app = xw.App(visible=False)  # Excel oculto durante procesamiento
wb = app.books.open(template_path)

Requisitos adicionales: - Microsoft Excel debe estar instalado - Compatible con Excel 2016, 2019, 365 - Requiere pywin32 para funcionamiento COM

pandas==1.5.2¶

pip install pandas==1.5.2

Propósito: Manipulación y análisis de datos estructurados
Criticidad: 🟡 IMPORTANTE - Usado para procesamiento de metadatos
Uso: Creación de DataFrames, manipulación de datos CSV, exportación a Excel

Casos de uso principales:

import pandas as pd

# Lectura de datos de referencia
juzgados_df = pd.read_csv('JUZGADOS.csv')

# Creación de DataFrame para índice
index_data = pd.DataFrame({
    'Nombre_Documento': file_names,
    'Numero_Paginas': page_counts,
    'Fecha_Creacion': creation_dates
})

PyPDF2==2.11.2¶

pip install PyPDF2==2.11.2

Propósito: Procesamiento de archivos PDF
Criticidad: 🟡 IMPORTANTE - Esencial para extracción de metadatos PDF
Uso: Conteo de páginas, extracción de metadatos, manejo de archivos protegidos

Funcionalidades utilizadas:

from PyPDF2 import PdfReader

def get_pdf_pages(file_path):
    try:
        reader = PdfReader(file_path)
        return len(reader.pages)
    except Exception as e:
        # Manejo de PDFs protegidos/corruptos
        return 0

pywin32==306¶

pip install pywin32==306

Propósito: Integración COM con Windows y Excel
Criticidad: 🔴 CRÍTICA - Requerida para xlwings y automatización Windows
Uso: Interfaz COM, servicios Windows, acceso a APIs nativas

Componentes utilizados: - win32com.client: Cliente COM para Excel - pythoncom: Inicialización COM - pywintypes: Tipos de datos Windows

Dependencias Importantes¶

Pillow>=8.3.2¶

pip install Pillow>=8.3.2

Propósito: Procesamiento de imágenes
Uso: Manejo de iconos, imágenes en tooltips, recursos gráficos de la GUI
Casos de uso: Carga de PNG/ICO para interfaz gráfica

send2trash>=1.8.0¶

pip install send2trash>=1.8.0

Propósito: Eliminación segura de archivos
Uso: Envío de índices existentes a la papelera en lugar de eliminación permanente
Ventaja: Permite recuperación de archivos eliminados por error

from send2trash import send2trash

# Eliminación segura de índice existente
if existing_index.exists():
    send2trash(str(existing_index))

Dependencias del Sistema Base¶

tkinter (incluido en Python)¶

Propósito: Framework GUI nativo de Python
Uso: Interfaz gráfica principal, diálogos, widgets
Ventaja: No requiere instalación adicional en instalaciones estándar de Python

Componentes utilizados:

import tkinter as tk
from tkinter import ttk, filedialog, messagebox

# GUI principal
root = tk.Tk()
style = ttk.Style()
progress_bar = ttk.Progressbar(root)

Dependencias de Desarrollo¶

Testing y Quality Assurance¶

pytest>=6.0.0¶

pip install pytest>=6.0.0

Propósito: Framework de testing
Uso: Ejecución de tests unitarios e integración
Configuración: Ver pytest.ini para configuración específica

pytest-cov>=2.0.0¶

pip install pytest-cov>=2.0.0

Propósito: Análisis de cobertura de código
Uso: Generación de reportes HTML de cobertura

black>=22.0.0¶

pip install black>=22.0.0

Propósito: Formateo automático de código
Configuración: Línea máxima 88 caracteres

black --line-length=88 src/

flake8>=4.0.0¶

pip install flake8>=4.0.0

Propósito: Análisis estático de código (linting)
Configuración: Compatible con formato Black

flake8 --max-line-length=88 --extend-ignore=E203 src/

isort>=5.0.0¶

pip install isort>=5.0.0

Propósito: Organización automática de imports
Configuración: Perfil compatible con Black

isort --profile=black src/

Build y Distribución¶

PyInstaller==5.13.0¶

pip install PyInstaller==5.13.0

Propósito: Creación de ejecutables standalone
Uso: Empaquetado de la aplicación para distribución
Configuración: Ver config/main.spec

pre-commit>=2.0.0¶

pip install pre-commit>=2.0.0

Propósito: Hooks de Git para calidad de código
Configuración: Ver .pre-commit-config.yaml

Documentación¶

mkdocs-material>=8.0.0¶

pip install mkdocs-material>=8.0.0

Propósito: Generación de documentación estática
Uso: Esta documentación que estás leyendo

mkdocstrings[python]>=0.19.0¶

pip install mkdocstrings[python]>=0.19.0

Propósito: Generación automática de documentación API desde docstrings

Análisis de Dependencias¶

Mapa de Dependencias Críticas¶

graph TD
    A[GestionExpedienteElectronico] --> B[xlwings]
    A --> C[pandas]
    A --> D[PyPDF2]
    A --> E[tkinter]

    B --> F[pywin32]
    B --> G[Microsoft Excel]

    F --> H[Windows COM]

    C --> I[numpy]
    C --> J[openpyxl]

    D --> K[PDF Processing]

    E --> L[GUI Components]

    style A fill:#e1f5fe
    style B fill:#ffebee
    style F fill:#ffebee
    style G fill:#ffcdd2

Compatibilidad de Versiones¶

Python¶

Mínimo: 3.9.6
Recomendado: 3.9.x o 3.10.x
Máximo probado: 3.11.x

Sistema Operativo¶

Principal: Windows 10/11
Compatible: Windows ⅞.1 (con limitaciones)
Experimental: Linux (sin soporte Excel completo)
No soportado: macOS (limitaciones COM)

Microsoft Excel¶

Mínimo: Excel 2016
Recomendado: Excel 2019 o Microsoft 365
Arquitectura: Preferiblemente 64-bit

Resolución de Conflictos¶

Problema: Versiones incompatibles de pywin32¶

# Solución: Reinstalación limpia
pip uninstall pywin32 -y
pip install pywin32==306
python -m pywin32_postinstall -install

Problema: xlwings no detecta Excel¶

# Verificar instalación de Excel
python -c "import xlwings as xw; app = xw.App(); print('Excel detectado'); app.quit()"

# Si falla, reinstalar xlwings
pip uninstall xlwings -y
pip install xlwings==0.28.5

Problema: Dependencias circulares en pandas¶

# Actualizar numpy primero
pip install --upgrade numpy
pip install --upgrade pandas==1.5.2

Seguridad de Dependencias¶

Vulnerabilidades Conocidas¶

PyPDF2 - Advertencia de Seguridad¶

Versión actual: 2.11.2 (última con compatibilidad probada)
Recomendación: No procesar PDFs de fuentes no confiables
Mitigación: Validación de archivos antes del procesamiento

Pillow - Updates de Seguridad¶

# Mantener actualizado para patches de seguridad
pip install --upgrade "Pillow>=8.3.2"

Mantenimiento de Dependencias

Revisa regularmente las actualizaciones de dependencias, especialmente las relacionadas con seguridad. Usa pip-audit para verificar vulnerabilidades conocidas.