taxteclib 0.2.3

Libreria estandar para DeloitteAR BPS Tax Tech

taxteclib

taxteclib es una librería Python que centraliza módulos y utilidades comunes para los proyectos de BPS Tax Tec (Argentina). Está pensada para contener funciones, clases y helpers reutilizables que faciliten la construcción de servicios y herramientas internas.

Características

• Paquete ligero, compatible con Python 3.12
• Estructura lista para pruebas y CI
• Contiene utilidades comunes para la organización BPS Tax Tec ARG

Clases disponibles

En el paquete taxteclib actualmente están disponibles las siguientes clases principales:

• SqlServerClient: Cliente para insertar registros de monitoreo en SQL Server.
• GithubRepoUpdater: Clase para actualizar desde un repositorio de GitHub y aplicar SQLs de un ZIP.

Puedes consultar la documentación de cada clase en los archivos fuente dentro de src/taxteclib/.

Ejemplo de uso: SqlServerClient

from taxteclib.database_logger import SqlServerClient, EstadoMonitoreo
from datetime import datetime

cliente_db = SqlServerClient()
registro = cliente_db.insertar_monitoreo(
	username="usuario",
	proceso="Proceso de ejemplo",
	estado=EstadoMonitoreo.CORRECTO,
	iniciado=datetime(2025, 9, 25, 10, 0),
	finalizado=datetime(2025, 9, 25, 10, 15),
	cliente="Cliente",
	items_count=42,
)
print(f"Registro insertado con ID: {registro.id}")

Ejemplo de uso: GithubRepoUpdater

from taxteclib.github_updater import GithubRepoUpdater

updater = GithubRepoUpdater(owner="mi_owner", repo="mi_repo")
updater.update(extract_zip=True)

Instalación (desarrollo)

Recomendado: crear un entorno virtual y usar las utilidades del proyecto.

Con venv:

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -U pip
pip install -e .

Si usas uv (opcional) y el Makefile del repo:

make local-setup
make install

Uso básico

Ejemplo mínimo usando la clase de ejemplo incluida:

from taxteclib.dummy_class import Dummy

dummy = Dummy()
assert dummy.add(2, 3) == 5
print('2 + 3 =', dummy.add(2, 3))

Ejecutar pruebas

La suite de tests usa pytest. Para correrlas localmente:

# dentro del entorno virtual
make test
# o
pytest -q

Contribuir

1. Crea una rama con un nombre descriptivo
2. Asegúrate de pasar los hooks y tests locales (make local-setup)
3. Envía un Pull Request contra main

Para estilos y checks el repo incluye ruff y hooks de pre-commit.

Licencia

Consulta el archivo LICENSE del repositorio para detalles.