isapilib

Framework de herramientas para las APIs de Django y Django REST Framework sobre el ERP Intelisis: ruteo a la base de datos de cada agencia, modelos del ERP, ejecución de SQL y stored procedures, creación de movimientos de venta, bitácora, utilidades de prueba y comandos de administración.

📖 Documentación completa: BookStack → isapilib · Versión actual: 3.7.0 (cambios entre versiones)

Instalación

pip install isapilib

Python ≥ 3.12 · Django 5.x · DRF 3.x · SQL Server. mssql-django se instala como dependencia. En los proyectos, fija la versión exacta (isapilib==X.Y.Z).

Configuración mínima

INSTALLED_APPS = [..., 'rest_framework', 'isapilib']
MIDDLEWARE = ['isapilib.middlewares.LoggerMiddleware']
DATABASE_ROUTERS = ['isapilib.core.router.DealerRouter']
AUTH_USER_MODEL = 'isapilib.UserAPI'

REST_FRAMEWORK = {
    'DEFAULT_PERMISSION_CLASSES': (
        'rest_framework.permissions.IsAuthenticated',
        'isapilib.auth.permissions.IsapilibPermission',   # obligatorio para el router
    ),
}

INTERFAZ_NAME = 'MI_API'
DEALER_FIELD = 'dealerID'
FIELD_ENCRYPTION_KEY = os.getenv('FIELD_ENCRYPTION_KEY')

python manage.py migrate

Ejemplo

from isapilib.models import Agente
from rest_framework.generics import ListAPIView


class AdvisorListView(ListAPIView):
    serializer_class = AdvisorSerializer

    def get_queryset(self):
        # Consulta la base de la agencia del header dealerID
        return Agente.objects.filter(tipo='Asesor', estatus='ALTA')

Desarrollo

Ramas permanentes: main (última versión publicada) y dev (integra el desarrollo; al publicar queda como copia de main).
Cada versión se trabaja en una rama fix/X.Y.Z desde dev, con un commit por corrección, y se integra por MR. Las ramas temporales se borran al integrar.
Cada versión sale primero como beta (X.Y.Zb1) y se prueba en una API con versión fija antes de la final.
La versión se define en pyproject.toml. La versión de referencia es la última publicada en PyPI (pip index versions isapilib --pre).

Publicar

Remove-Item -Recurse -Force .\dist\
python setup.py sdist
twine upload dist/*

Twine toma el token del llavero de Windows (keyring set https://upload.pypi.org/legacy/ __token__) o de ~/.pypirc. Nunca lo pongas en el repo.

Documentación

La fuente del libro de BookStack, las herramientas (referencia de modelos, uso en producción) y las verificaciones de cada versión están en el repo de estándares: estandar-sql/isapilib.

Metadata

Release files for isapilib 3.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for isapilib 3.7.0
File	Size	Uploaded
isapilib-3.7.0.tar.gz	46.9 kB	Oct 1, 2026	Details

Release files / isapilib-3.7.0.tar.gz

Download URL	isapilib-3.7.0.tar.gz
Size	46.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`afe73a5839272092f93af7629ed9ef5aac2be5c90bd808c1988644bb7fdc916c`
BLAKE2b-256 checksum How to use checksums	`8fd3b3c1f853d84e4d27f03fbf221f38c269f38c1083f30f6aef49f86d7a7595`
Upload date	Oct 1, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.0`