saamfi-sdk 0.1.0__tar.gz

saamfi_sdk-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Universidad ICESI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

saamfi_sdk-0.1.0/MANIFEST.in

@@ -0,0 +1,10 @@
+include README.md
+include LICENSE
+include requirements.txt
+include requirements-dev.txt
+recursive-include saamfi_sdk *.py
+recursive-include saamfi_sdk py.typed
+recursive-exclude tests *
+recursive-exclude docs *
+global-exclude __pycache__
+global-exclude *.py[co]

saamfi_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,257 @@
+Metadata-Version: 2.4
+Name: saamfi-sdk
+Version: 0.1.0
+Summary: SDK de Python para conectarse a los servicios SAAMFI - Autenticacion y Autorizacion
+Author-email: Universidad ICESI <dev@icesi.edu.co>
+License: MIT
+Project-URL: Homepage, https://github.com/icesi-dev/saamfi-sdk-python
+Project-URL: Documentation, https://saamfi-sdk-python.readthedocs.io
+Project-URL: Repository, https://github.com/icesi-dev/saamfi-sdk-python.git
+Project-URL: Issues, https://github.com/icesi-dev/saamfi-sdk-python/issues
+Keywords: saamfi,authentication,authorization,jwt,security,sdk
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Security
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31.0
+Requires-Dist: PyJWT>=2.8.0
+Requires-Dist: cryptography>=41.0.0
+Requires-Dist: pydantic>=2.5.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: mypy>=1.5.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Provides-Extra: fastapi
+Requires-Dist: fastapi>=0.104.0; extra == "fastapi"
+Dynamic: license-file
+
+## Saamfi SDK para Python
+
+Cliente oficial en Python para integrar sistemas con los servicios de autenticacion y autorizacion de Saamfi. Este SDK expone las mismas operaciones disponibles en la libreria Java (`SaamfiDelegate`) y simplifica la validacion de tokens JWT, la autenticacion de usuarios y la consulta de informacion institucional.
+
+---
+
+## Instalacion
+
+- **Desde PyPI**
+  ```bash
+  pip install saamfi-sdk
+  ```
+- **Desde el codigo fuente**
+  ```bash
+  git clone https://github.com/saamfi/saamfi-sdk-python.git
+  cd saamfi-sdk-python
+  pip install -e .
+  ```
+
+Configura las siguientes variables de entorno antes de usar el cliente (por ejemplo en un archivo `.env`):
+
+- `SAAMFI_BASE_URL`: URL base del servicio Saamfi (`https://api.saamfi.com`).
+- `SAAMFI_SYS_ID`: Identificador del sistema o tenant asignado por Saamfi.
+- `SAAMFI_TENANT_ID` *(opcional)*: Identificador de institución (para endpoints como `/institutions/{instid}/params`).
+- `SAAMFI_CLIENT_ID` y `SAAMFI_CLIENT_SECRET` *(opcionales)*: Credenciales del sistema si tu integración las requiere.
+- `SAAMFI_TEST_USERNAME` y `SAAMFI_TEST_PASSWORD` *(solo para pruebas locales)*: Usuario demo del sandbox.
+
+> El cliente mantiene compatibilidad con las variables antiguas `SAAMFI_URL`, `SAAMFI_SYSTEM_ID` y `SAAMFI_INST_ID`.
+
+---
+
+## Quickstart
+
+```python
+from saamfi_sdk import SaamfiClient
+
+client = SaamfiClient()  # Usa SAAMFI_BASE_URL y SAAMFI_SYS_ID desde el entorno
+
+response = client.login("usuario@example.com", "clave-segura")
+if response:
+    print(f"Token: {response.access_token}")
+    token_info = client.validate_token(response.access_token)
+    print(f"Roles: {token_info.roles}")
+else:
+    print("Credenciales invalidas")
+```
+
+---
+
+## Sandbox local con docker compose
+
+1. Levanta el entorno local de Saamfi con `docker compose` (puerto `9091` según la configuración compartida).
+2. Crea un archivo `.env` junto al proyecto del SDK con las variables:
+   ```
+   SAAMFI_BASE_URL=http://localhost:9091/iaslab/saamfiapi
+   SAAMFI_SYS_ID=8
+   SAAMFI_CLIENT_ID=8
+   SAAMFI_CLIENT_SECRET=qYr6-CxZP9t4vN2eFM1sR4gL
+   SAAMFI_TENANT_ID=1
+   SAAMFI_TEST_USERNAME=testuser
+   SAAMFI_TEST_PASSWORD=password123
+   ```
+3. Ejecuta el script de ejemplo:
+   ```bash
+   python examples/sandbox_demo.py
+   ```
+   Verás el flujo completo: descarga de clave pública, descubrimiento de sistemas/instituciones, autenticación del usuario demo, validación del JWT y consultas protegidas.
+
+> Consulta los logs del backend en `saamfi-rest/logs/saamfi.log` o mediante `GET /logs/` (requiere rol `Query-server-logs`) para corroborar las operaciones.
+
+---
+
+## Ejemplos por funcionalidad
+
+Cada metodo del cliente refleja una operacion del servicio Saamfi. Los siguientes fragmentos muestran el flujo completo con un token valido (`token`):
+
+- **Obtener llave publica**
+  ```python
+  public_key = client.get_public_key()
+  ```
+
+- **Autenticar usuario**
+  ```python
+  login = client.login("usuario@example.com", "clave")
+  ```
+
+- **Validar token y extraer datos**
+  ```python
+  token_info = client.validate_token(token)
+  print(token_info.username, token_info.roles)
+  ```
+
+- **Roles desde un JWT**
+  ```python
+  roles = client.get_roles_from_jwt(token)
+  ```
+
+- **Informacion detallada de usuario**
+  ```python
+  user = client.get_user_info(token, user_id=12345)
+  ```
+
+- **Buscar usuario por username**
+  ```python
+  user = client.get_user_by_username(token, "john.doe")
+  ```
+
+- **Buscar usuarios por documentos**
+  ```python
+  users = client.get_users_by_document(token, ["100200300", "999888777"])
+  ```
+
+- **Obtener usuarios por lista de IDs**
+  ```python
+  users_json = client.get_users_from_list(token, [1, 2, 3])
+  ```
+
+- **Busqueda generica por parametro y valor**
+  ```python
+  result_json = client.get_users_by_param_and_value(token, "email", "example.com")
+  ```
+
+- **Consultar institucion por NIT**
+  ```python
+  institution_json = client.get_institution_by_nit(token, "900123456-7")
+  ```
+
+- **Consultar instituciones por IDs**
+  ```python
+  institutions_json = client.get_institutions_by_ids(token, [10, 20, 30])
+  ```
+
+- **Listado público de sistemas e instituciones**
+  ```python
+  systems = client.list_public_systems()
+  institutions = client.list_public_institutions()
+  ```
+
+- **Parámetros de institución**
+  ```python
+  params = client.get_institution_params(token)  # Usa SAAMFI_TENANT_ID por defecto
+  ```
+
+- **Roles configurados para un sistema**
+  ```python
+  roles = client.get_system_roles(token)  # Usa SAAMFI_SYS_ID por defecto
+  ```
+
+---
+
+## Referencia de API
+
+### Clases principales
+
+| Clase | Descripcion |
+| ----- | ----------- |
+| `SaamfiClient` | Cliente principal; gestiona autenticacion, validacion y consultas. |
+| `LoginBody` | Modelo para solicitudes de login. |
+| `LoginResponse` | Respuesta de autenticacion exitosa. |
+| `UserInfo` | Informacion detallada de usuario. |
+| `UserDetailToken` | Datos extraidos de un JWT validado. |
+
+### Metodos clave de `SaamfiClient`
+
+| Metodo | Entrada | Salida | Nota |
+| ------ | ------- | ------ | ---- |
+| `get_public_key()` | - | `RSAPublicKey` | Obtiene y cachea la llave publica. |
+| `login(username, password)` | `str`, `str` | `LoginResponse | None` | Autentica usuario. |
+| `get_roles_from_jwt(auth_token)` | `str` | `List[str]` | Extrae claim `role`. |
+| `validate_token(auth_token)` | `str` | `UserDetailToken` | Valida firma y claims. |
+| `get_user_info(auth_token, user_id)` | `str`, `int` | `UserInfo | None` | Consulta usuario por ID. |
+| `get_user_by_username(auth_token, username)` | `str`, `str` | `dict | None` | Consulta POST por username. |
+| `get_users_by_document(auth_token, user_documents)` | `str`, `List[str]` | `List[dict]` | Busca por multiples documentos. |
+| `get_users_from_list(auth_token, user_ids)` | `str`, `List[int]` | `str | None` | JSON con usuarios por ID. |
+| `get_users_by_param_and_value(auth_token, param, value)` | `str`, `str`, `str` | `str | None` | Filtro generico usando query string. |
+| `get_institution_by_nit(auth_token, nit)` | `str`, `str` | `str | None` | Consulta institucion por NIT. |
+| `get_institutions_by_ids(auth_token, institution_ids)` | `str`, `List[int]` | `str | None` | Consulta masiva por IDs. |
+| `list_public_institutions()` | - | `List[dict] | None` | Descubrimiento de instituciones disponibles. |
+| `get_institution_params(auth_token, institution_id=None)` | `str`, `Optional[int]` | `dict | None` | Obtiene parámetros de configuración institucional. |
+| `list_public_systems()` | - | `List[dict] | None` | Descubrimiento de sistemas publicados. |
+| `get_system_roles(auth_token, system_id=None)` | `str`, `Optional[int]` | `List[dict] | None` | Roles disponibles para un sistema. |
+
+> Consulta los docstrings en `saamfi_sdk/client.py` para conocer detalles, equivalencias con la version Java y ejemplos adicionales.
+
+---
+
+## Manejo de errores
+
+Todas las excepciones del SDK heredan de `SaamfiException`:
+
+| Excepcion | Cuándo ocurre |
+| --------- | ------------- |
+| `SaamfiAuthenticationError` | Credenciales invalidas o token sin permisos. |
+| `SaamfiTokenValidationError` | Token expirado, mal formado o con claims faltantes. |
+| `SaamfiConnectionError` | Problemas de red o respuestas no exitosas del backend. |
+| `SaamfiInvalidSystemError` | El token pertenece a otro `system_id`. |
+| `SaamfiUnauthorizedError` | El usuario autenticado no tiene permisos para la operacion. |
+| `SaamfiNotFoundError` | El recurso solicitado no existe. |
+
+```python
+from saamfi_sdk import SaamfiClient
+from saamfi_sdk.exceptions import SaamfiConnectionError, SaamfiAuthenticationError
+
+client = SaamfiClient()
+
+try:
+    login = client.login("usuario@example.com", "clave")
+except SaamfiConnectionError as exc:
+    print(f"No es posible comunicar con Saamfi: {exc}")
+except SaamfiAuthenticationError:
+    print("Credenciales invalidas")
+```
+
+---
+

saamfi_sdk-0.1.0/README.md

@@ -0,0 +1,215 @@
+## Saamfi SDK para Python
+
+Cliente oficial en Python para integrar sistemas con los servicios de autenticacion y autorizacion de Saamfi. Este SDK expone las mismas operaciones disponibles en la libreria Java (`SaamfiDelegate`) y simplifica la validacion de tokens JWT, la autenticacion de usuarios y la consulta de informacion institucional.
+
+---
+
+## Instalacion
+
+- **Desde PyPI**
+  ```bash
+  pip install saamfi-sdk
+  ```
+- **Desde el codigo fuente**
+  ```bash
+  git clone https://github.com/saamfi/saamfi-sdk-python.git
+  cd saamfi-sdk-python
+  pip install -e .
+  ```
+
+Configura las siguientes variables de entorno antes de usar el cliente (por ejemplo en un archivo `.env`):
+
+- `SAAMFI_BASE_URL`: URL base del servicio Saamfi (`https://api.saamfi.com`).
+- `SAAMFI_SYS_ID`: Identificador del sistema o tenant asignado por Saamfi.
+- `SAAMFI_TENANT_ID` *(opcional)*: Identificador de institución (para endpoints como `/institutions/{instid}/params`).
+- `SAAMFI_CLIENT_ID` y `SAAMFI_CLIENT_SECRET` *(opcionales)*: Credenciales del sistema si tu integración las requiere.
+- `SAAMFI_TEST_USERNAME` y `SAAMFI_TEST_PASSWORD` *(solo para pruebas locales)*: Usuario demo del sandbox.
+
+> El cliente mantiene compatibilidad con las variables antiguas `SAAMFI_URL`, `SAAMFI_SYSTEM_ID` y `SAAMFI_INST_ID`.
+
+---
+
+## Quickstart
+
+```python
+from saamfi_sdk import SaamfiClient
+
+client = SaamfiClient()  # Usa SAAMFI_BASE_URL y SAAMFI_SYS_ID desde el entorno
+
+response = client.login("usuario@example.com", "clave-segura")
+if response:
+    print(f"Token: {response.access_token}")
+    token_info = client.validate_token(response.access_token)
+    print(f"Roles: {token_info.roles}")
+else:
+    print("Credenciales invalidas")
+```
+
+---
+
+## Sandbox local con docker compose
+
+1. Levanta el entorno local de Saamfi con `docker compose` (puerto `9091` según la configuración compartida).
+2. Crea un archivo `.env` junto al proyecto del SDK con las variables:
+   ```
+   SAAMFI_BASE_URL=http://localhost:9091/iaslab/saamfiapi
+   SAAMFI_SYS_ID=8
+   SAAMFI_CLIENT_ID=8
+   SAAMFI_CLIENT_SECRET=qYr6-CxZP9t4vN2eFM1sR4gL
+   SAAMFI_TENANT_ID=1
+   SAAMFI_TEST_USERNAME=testuser
+   SAAMFI_TEST_PASSWORD=password123
+   ```
+3. Ejecuta el script de ejemplo:
+   ```bash
+   python examples/sandbox_demo.py
+   ```
+   Verás el flujo completo: descarga de clave pública, descubrimiento de sistemas/instituciones, autenticación del usuario demo, validación del JWT y consultas protegidas.
+
+> Consulta los logs del backend en `saamfi-rest/logs/saamfi.log` o mediante `GET /logs/` (requiere rol `Query-server-logs`) para corroborar las operaciones.
+
+---
+
+## Ejemplos por funcionalidad
+
+Cada metodo del cliente refleja una operacion del servicio Saamfi. Los siguientes fragmentos muestran el flujo completo con un token valido (`token`):
+
+- **Obtener llave publica**
+  ```python
+  public_key = client.get_public_key()
+  ```
+
+- **Autenticar usuario**
+  ```python
+  login = client.login("usuario@example.com", "clave")
+  ```
+
+- **Validar token y extraer datos**
+  ```python
+  token_info = client.validate_token(token)
+  print(token_info.username, token_info.roles)
+  ```
+
+- **Roles desde un JWT**
+  ```python
+  roles = client.get_roles_from_jwt(token)
+  ```
+
+- **Informacion detallada de usuario**
+  ```python
+  user = client.get_user_info(token, user_id=12345)
+  ```
+
+- **Buscar usuario por username**
+  ```python
+  user = client.get_user_by_username(token, "john.doe")
+  ```
+
+- **Buscar usuarios por documentos**
+  ```python
+  users = client.get_users_by_document(token, ["100200300", "999888777"])
+  ```
+
+- **Obtener usuarios por lista de IDs**
+  ```python
+  users_json = client.get_users_from_list(token, [1, 2, 3])
+  ```
+
+- **Busqueda generica por parametro y valor**
+  ```python
+  result_json = client.get_users_by_param_and_value(token, "email", "example.com")
+  ```
+
+- **Consultar institucion por NIT**
+  ```python
+  institution_json = client.get_institution_by_nit(token, "900123456-7")
+  ```
+
+- **Consultar instituciones por IDs**
+  ```python
+  institutions_json = client.get_institutions_by_ids(token, [10, 20, 30])
+  ```
+
+- **Listado público de sistemas e instituciones**
+  ```python
+  systems = client.list_public_systems()
+  institutions = client.list_public_institutions()
+  ```
+
+- **Parámetros de institución**
+  ```python
+  params = client.get_institution_params(token)  # Usa SAAMFI_TENANT_ID por defecto
+  ```
+
+- **Roles configurados para un sistema**
+  ```python
+  roles = client.get_system_roles(token)  # Usa SAAMFI_SYS_ID por defecto
+  ```
+
+---
+
+## Referencia de API
+
+### Clases principales
+
+| Clase | Descripcion |
+| ----- | ----------- |
+| `SaamfiClient` | Cliente principal; gestiona autenticacion, validacion y consultas. |
+| `LoginBody` | Modelo para solicitudes de login. |
+| `LoginResponse` | Respuesta de autenticacion exitosa. |
+| `UserInfo` | Informacion detallada de usuario. |
+| `UserDetailToken` | Datos extraidos de un JWT validado. |
+
+### Metodos clave de `SaamfiClient`
+
+| Metodo | Entrada | Salida | Nota |
+| ------ | ------- | ------ | ---- |
+| `get_public_key()` | - | `RSAPublicKey` | Obtiene y cachea la llave publica. |
+| `login(username, password)` | `str`, `str` | `LoginResponse | None` | Autentica usuario. |
+| `get_roles_from_jwt(auth_token)` | `str` | `List[str]` | Extrae claim `role`. |
+| `validate_token(auth_token)` | `str` | `UserDetailToken` | Valida firma y claims. |
+| `get_user_info(auth_token, user_id)` | `str`, `int` | `UserInfo | None` | Consulta usuario por ID. |
+| `get_user_by_username(auth_token, username)` | `str`, `str` | `dict | None` | Consulta POST por username. |
+| `get_users_by_document(auth_token, user_documents)` | `str`, `List[str]` | `List[dict]` | Busca por multiples documentos. |
+| `get_users_from_list(auth_token, user_ids)` | `str`, `List[int]` | `str | None` | JSON con usuarios por ID. |
+| `get_users_by_param_and_value(auth_token, param, value)` | `str`, `str`, `str` | `str | None` | Filtro generico usando query string. |
+| `get_institution_by_nit(auth_token, nit)` | `str`, `str` | `str | None` | Consulta institucion por NIT. |
+| `get_institutions_by_ids(auth_token, institution_ids)` | `str`, `List[int]` | `str | None` | Consulta masiva por IDs. |
+| `list_public_institutions()` | - | `List[dict] | None` | Descubrimiento de instituciones disponibles. |
+| `get_institution_params(auth_token, institution_id=None)` | `str`, `Optional[int]` | `dict | None` | Obtiene parámetros de configuración institucional. |
+| `list_public_systems()` | - | `List[dict] | None` | Descubrimiento de sistemas publicados. |
+| `get_system_roles(auth_token, system_id=None)` | `str`, `Optional[int]` | `List[dict] | None` | Roles disponibles para un sistema. |
+
+> Consulta los docstrings en `saamfi_sdk/client.py` para conocer detalles, equivalencias con la version Java y ejemplos adicionales.
+
+---
+
+## Manejo de errores
+
+Todas las excepciones del SDK heredan de `SaamfiException`:
+
+| Excepcion | Cuándo ocurre |
+| --------- | ------------- |
+| `SaamfiAuthenticationError` | Credenciales invalidas o token sin permisos. |
+| `SaamfiTokenValidationError` | Token expirado, mal formado o con claims faltantes. |
+| `SaamfiConnectionError` | Problemas de red o respuestas no exitosas del backend. |
+| `SaamfiInvalidSystemError` | El token pertenece a otro `system_id`. |
+| `SaamfiUnauthorizedError` | El usuario autenticado no tiene permisos para la operacion. |
+| `SaamfiNotFoundError` | El recurso solicitado no existe. |
+
+```python
+from saamfi_sdk import SaamfiClient
+from saamfi_sdk.exceptions import SaamfiConnectionError, SaamfiAuthenticationError
+
+client = SaamfiClient()
+
+try:
+    login = client.login("usuario@example.com", "clave")
+except SaamfiConnectionError as exc:
+    print(f"No es posible comunicar con Saamfi: {exc}")
+except SaamfiAuthenticationError:
+    print("Credenciales invalidas")
+```
+
+---
+

saamfi_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,89 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "saamfi-sdk"
+version = "0.1.0"
+description = "SDK de Python para conectarse a los servicios SAAMFI - Autenticacion y Autorizacion"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [
+    {name = "Universidad ICESI", email = "dev@icesi.edu.co"}
+]
+keywords = ["saamfi", "authentication", "authorization", "jwt", "security", "sdk"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Security",
+]
+dependencies = [
+    "requests>=2.31.0",
+    "PyJWT>=2.8.0",
+    "cryptography>=41.0.0",
+    "pydantic>=2.5.0",
+    "python-dotenv>=1.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.4.0",
+    "pytest-cov>=4.1.0",
+    "pytest-asyncio>=0.21.0",
+    "black>=23.0.0",
+    "flake8>=6.0.0",
+    "mypy>=1.5.0",
+    "isort>=5.12.0",
+]
+fastapi = [
+    "fastapi>=0.104.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/icesi-dev/saamfi-sdk-python"
+Documentation = "https://saamfi-sdk-python.readthedocs.io"
+Repository = "https://github.com/icesi-dev/saamfi-sdk-python.git"
+Issues = "https://github.com/icesi-dev/saamfi-sdk-python/issues"
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.packages.find]
+include = ["saamfi_sdk*"]
+
+[tool.setuptools.package-data]
+saamfi_sdk = ["py.typed"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = "test_*.py"
+python_classes = "Test*"
+python_functions = "test_*"
+addopts = "-v --cov=saamfi_sdk --cov-report=term-missing"
+markers = [
+    "integration: Tests that hit the local Saamfi sandbox (requires RUN_SAAMFI_SANDBOX_TESTS=1)",
+]
+
+[tool.black]
+line-length = 100
+target-version = ['py38', 'py39', 'py310', 'py311']
+include = '\.pyi?$'
+
+[tool.isort]
+profile = "black"
+line_length = 100
+
+[tool.mypy]
+python_version = "3.8"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true

saamfi_sdk-0.1.0/requirements-dev.txt

@@ -0,0 +1,22 @@
+# Include production dependencies
+-r requirements.txt
+
+# Testing
+pytest>=7.4.0
+pytest-cov>=4.1.0
+pytest-mock>=3.12.0
+pytest-asyncio>=0.21.0
+
+# Code Quality
+black>=23.11.0
+flake8>=6.1.0
+mypy>=1.7.0
+isort>=5.12.0
+
+# Documentation
+mkdocs>=1.5.0
+mkdocs-material>=9.4.0
+
+# Development utilities
+python-dotenv>=1.0.0
+ipython>=8.17.0

saamfi_sdk-0.1.0/requirements.txt

@@ -0,0 +1,17 @@
+# HTTP Client
+requests>=2.31.0
+
+# JWT Handling
+PyJWT>=2.8.0
+
+# Cryptography for RSA keys
+cryptography>=41.0.0
+
+# Data Validation
+pydantic>=2.5.0
+
+# Environment Variables
+python-dotenv>=1.0.0
+
+# Optional: FastAPI integration (peer dependency)
+# fastapi>=0.104.0  # Users install this themselves

saamfi_sdk-0.1.0/saamfi_sdk/__init__.py

@@ -0,0 +1,49 @@
+"""
+Saamfi SDK for Python
+
+Python SDK to connect to SAAMFI services - Authentication and Authorization.
+
+This SDK is equivalent to saamfi-security (Java SDK) and provides the same
+functionality for systems that require integration with the Saamfi service.
+
+Basic usage:
+    >>> from saamfi_sdk import SaamfiClient
+    >>> client = SaamfiClient("https://saamfi.example.com", system_id=123)
+    >>> # Client is ready for authentication and token validation
+
+Equivalent to: co.edu.icesi.dev.saamfi.saamfisecurity (Java package)
+"""
+
+__version__ = "0.1.0"
+
+from .client import SaamfiClient
+from .exceptions import (
+    SaamfiAuthenticationError,
+    SaamfiConnectionError,
+    SaamfiException,
+    SaamfiInvalidSystemError,
+    SaamfiNotFoundError,
+    SaamfiTokenValidationError,
+    SaamfiUnauthorizedError,
+)
+from .models import LoginBody, LoginResponse, UserDetailToken, UserInfo
+
+__all__ = [
+    # Main client
+    "SaamfiClient",
+    # Models
+    "LoginBody",
+    "LoginResponse",
+    "UserInfo",
+    "UserDetailToken",
+    # Exceptions
+    "SaamfiException",
+    "SaamfiAuthenticationError",
+    "SaamfiTokenValidationError",
+    "SaamfiConnectionError",
+    "SaamfiInvalidSystemError",
+    "SaamfiUnauthorizedError",
+    "SaamfiNotFoundError",
+    # Metadata
+    "__version__",
+]