libredte-lib-sdk 0.5.2__tar.gz → 0.5.3__tar.gz

{libredte_lib_sdk-0.5.2 → libredte_lib_sdk-0.5.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: libredte-lib-sdk
-Version: 0.5.2
+Version: 0.5.3
 Summary: SDK Python para la API de LibreDTE Lib (facturacion electronica de Chile).
 Project-URL: Homepage, https://www.libredte.cl
 Project-URL: Source, https://github.com/libredte/libredte-lib-sdk-python
@@ -187,14 +187,26 @@ entorno ``LIBREDTE_LIB_SDK_BASE_URL``:
 ``core.libredte.cl`` y ``pro.libredte.cl`` exponen el mismo contrato con
 límites de solicitudes distintos; ambos aceptan la variante ``LibreDTE
 (base_url=..., ...)`` con el resto de los parámetros de configuración
-(``api_token``, ``timeout``, ``http_client``).
+(``api_token``, ``auth_scheme``, ``timeout``, ``http_client``).
 
 Autenticación
 ~~~~~~~~~~~~~
 
 ``LibreDTE(api_token=...)`` o la variable de entorno
 ``LIBREDTE_LIB_SDK_TOKEN`` — si está presente, se manda como header
-``Authorization: Bearer <token>``.
+``Authorization: <esquema> <token>``. El esquema es ``Bearer`` por
+defecto (lo que espera ``core.libredte.cl``/``pro.libredte.cl``);
+configurable con ``LibreDTE(auth_scheme=...)`` o la variable de entorno
+``LIBREDTE_LIB_SDK_AUTH_SCHEME`` para hablar con otra API que use un
+esquema distinto (ej. ``'Token'``):
+
+.. code-block:: python
+
+    sdk = LibreDTE(
+        base_url='https://app.apigateway.cl/api/v2/libredte',
+        api_token='...',
+        auth_scheme='Token',
+    )
 
 Recursos de ``system``
 -----------------------

{libredte_lib_sdk-0.5.2 → libredte_lib_sdk-0.5.3}/README.rst

@@ -143,14 +143,26 @@ entorno ``LIBREDTE_LIB_SDK_BASE_URL``:
 ``core.libredte.cl`` y ``pro.libredte.cl`` exponen el mismo contrato con
 límites de solicitudes distintos; ambos aceptan la variante ``LibreDTE
 (base_url=..., ...)`` con el resto de los parámetros de configuración
-(``api_token``, ``timeout``, ``http_client``).
+(``api_token``, ``auth_scheme``, ``timeout``, ``http_client``).
 
 Autenticación
 ~~~~~~~~~~~~~
 
 ``LibreDTE(api_token=...)`` o la variable de entorno
 ``LIBREDTE_LIB_SDK_TOKEN`` — si está presente, se manda como header
-``Authorization: Bearer <token>``.
+``Authorization: <esquema> <token>``. El esquema es ``Bearer`` por
+defecto (lo que espera ``core.libredte.cl``/``pro.libredte.cl``);
+configurable con ``LibreDTE(auth_scheme=...)`` o la variable de entorno
+``LIBREDTE_LIB_SDK_AUTH_SCHEME`` para hablar con otra API que use un
+esquema distinto (ej. ``'Token'``):
+
+.. code-block:: python
+
+    sdk = LibreDTE(
+        base_url='https://app.apigateway.cl/api/v2/libredte',
+        api_token='...',
+        auth_scheme='Token',
+    )
 
 Recursos de ``system``
 -----------------------

{libredte_lib_sdk-0.5.2 → libredte_lib_sdk-0.5.3}/libredte_lib_sdk/client.py

@@ -18,6 +18,7 @@ from .exceptions import (
 )
 
 DEFAULT_BASE_URL = 'https://core.libredte.cl/api'
+DEFAULT_AUTH_SCHEME = 'Bearer'
 DEFAULT_TIMEOUT = 30.0
 _HTTP_TOO_MANY_REQUESTS = 429
 _OPERATION_NOT_FOUND_PHP_CLASS = (
@@ -50,6 +51,7 @@ class ApiClient:
         base_url: str | None = None,
         *,
         api_token: str | None = None,
+        auth_scheme: str | None = None,
         timeout: float = DEFAULT_TIMEOUT,
         http_client: httpx.Client | None = None,
     ) -> None:
@@ -62,9 +64,19 @@ class ApiClient:
         self._api_token = api_token or os.environ.get(
             'LIBREDTE_LIB_SDK_TOKEN',
         )
+        self._auth_scheme = (
+            auth_scheme
+            or os.environ.get('LIBREDTE_LIB_SDK_AUTH_SCHEME')
+            or DEFAULT_AUTH_SCHEME
+        )
         self._client = http_client or httpx.Client(timeout=timeout)
         self._owns_client = http_client is None
 
+    @property
+    def base_url(self) -> str:
+        """URL base configurada (`core.libredte.cl`, `pro.libredte.cl`)."""
+        return self._base_url
+
     def close(self) -> None:
         """Cierra la conexión HTTP, si este cliente es dueño de ella."""
         if self._owns_client:
@@ -105,7 +117,7 @@ class ApiClient:
     def _headers(self) -> dict[str, str]:
         headers = {'Accept': 'application/json'}
         if self._api_token:
-            headers['Authorization'] = f'Bearer {self._api_token}'
+            headers['Authorization'] = f'{self._auth_scheme} {self._api_token}'
         return headers
 
     @staticmethod

{libredte_lib_sdk-0.5.2 → libredte_lib_sdk-0.5.3}/libredte_lib_sdk/sdk.py

@@ -60,6 +60,7 @@ class LibreDTE:
         base_url: str | None = None,
         *,
         api_token: str | None = None,
+        auth_scheme: str | None = None,
         timeout: float = DEFAULT_TIMEOUT,
         http_client: httpx.Client | None = None,
     ) -> None:
@@ -67,6 +68,7 @@ class LibreDTE:
         self._client = ApiClient(
             base_url,
             api_token=api_token,
+            auth_scheme=auth_scheme,
             timeout=timeout,
             http_client=http_client,
         )
@@ -74,6 +76,11 @@ class LibreDTE:
         self.system = SystemPackage(self._client)
         self.human_resources = HumanResourcesPackage(self._client)
 
+    @property
+    def base_url(self) -> str:
+        """URL base configurada del `ApiClient` compartido."""
+        return self._client.base_url
+
     def close(self) -> None:
         """Cierra la conexión HTTP subyacente."""
         self._client.close()

{libredte_lib_sdk-0.5.2 → libredte_lib_sdk-0.5.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "libredte-lib-sdk"
-version = "0.5.2"
+version = "0.5.3"
 description = "SDK Python para la API de LibreDTE Lib (facturacion electronica de Chile)."
 readme = "README.rst"
 license = { file = "LICENSE" }

libredte_lib_sdk-0.5.3/tests/integration/test_certificate_loader.py

@@ -0,0 +1,55 @@
+# Copyright (C) 2026 LibreDTE <https://www.libredte.cl>
+# SPDX-License-Identifier: MIT
+
+"""
+Tests en vivo para `CertificateLoaderService` (`system.certificate.loader`).
+
+Usa un `.p12` fijo (`tests/fixtures/certificate_112223339.p12`,
+contraseña `i_love_libredte`) en vez de generar uno en cada corrida —
+así el test no necesita ninguna librería de certificados: solo lee los
+bytes del archivo y se los pasa tal cual a la API, igual que subiría el
+archivo una persona real.
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import pytest
+
+pytestmark = pytest.mark.live
+
+_FIXTURE_PATH = (
+    Path(__file__).parent.parent / 'fixtures' / 'certificate_112223339.p12'
+)
+_PASSWORD = 'i_love_libredte'
+
+
+@pytest.fixture
+def fake_pkcs12() -> bytes:
+    """Bytes crudos del `.p12` de prueba."""
+    return _FIXTURE_PATH.read_bytes()
+
+
+def test_load_extracts_the_holder_and_a_usable_certificate(
+    fake_pkcs12: bytes,
+    real_sdk,
+):
+    loaded = real_sdk.system.certificate.loader.load(fake_pkcs12, _PASSWORD)
+
+    assert loaded.id == '11222333-9'
+    assert loaded.name == 'Usuario de LibreDTE'
+    assert loaded.email == 'correo@example.com'
+    assert loaded.is_active is True
+    assert loaded.certificate.startswith('-----BEGIN CERTIFICATE-----')
+
+
+def test_create_from_certificate_matches_load(fake_pkcs12: bytes, real_sdk):
+    loaded = real_sdk.system.certificate.loader.load(fake_pkcs12, _PASSWORD)
+
+    mandatario_manager = real_sdk.billing.trading_parties.mandatario_manager
+    mandatario = mandatario_manager.create_from_certificate(loaded)
+
+    assert mandatario.run == loaded.id
+    assert mandatario.nombre == loaded.name
+    assert mandatario.email == loaded.email

{libredte_lib_sdk-0.5.2 → libredte_lib_sdk-0.5.3}/tests/integration/test_operation_not_found.py

@@ -4,16 +4,17 @@
 """
 Test en vivo para `LibreDteOperationNotFoundError`.
 
-Corre contra el ambiente por defecto (Lib Core, ver `real_sdk` en
-`conftest.py`) a propósito: `human_resources.*` no existe ahí — es
-justo el caso real que motivó la excepción, y no necesita apuntar a
-Lib Pro para confirmarlo.
+Pensado para Lib Core: `human_resources.*` no existe ahí — es justo el
+caso real que motivó la excepción. Se salta a sí mismo si `real_sdk`
+apunta a otro ambiente (ej. Lib Pro, vía `LIBREDTE_LIB_SDK_BASE_URL`),
+donde `human_resources.*` sí existe y no aplica.
 """
 
 from __future__ import annotations
 
 import pytest
 
+from libredte_lib_sdk.client import DEFAULT_BASE_URL
 from libredte_lib_sdk.exceptions import LibreDteOperationNotFoundError
 
 pytestmark = pytest.mark.live
@@ -22,6 +23,9 @@ pytestmark = pytest.mark.live
 def test_human_resources_operation_raises_operation_not_found_on_core(
     real_sdk,
 ):
+    if real_sdk.base_url != DEFAULT_BASE_URL:
+        pytest.skip('human_resources.* no existe solo en Lib Core.')
+
     with pytest.raises(LibreDteOperationNotFoundError) as exc_info:
         real_sdk.human_resources.integration.previred_provider.get_indicadores(
             202412,

{libredte_lib_sdk-0.5.2 → libredte_lib_sdk-0.5.3}/tests/test_client.py

@@ -39,6 +39,21 @@ def test_api_token_falls_back_to_the_env_var(monkeypatch):
     assert client._headers()['Authorization'] == 'Bearer secret-token'
 
 
+def test_auth_scheme_param_overrides_the_default():
+    client = ApiClient(api_token='secret-token', auth_scheme='Token')
+
+    assert client._headers()['Authorization'] == 'Token secret-token'
+
+
+def test_auth_scheme_falls_back_to_the_env_var(monkeypatch):
+    monkeypatch.setenv('LIBREDTE_LIB_SDK_TOKEN', 'secret-token')
+    monkeypatch.setenv('LIBREDTE_LIB_SDK_AUTH_SCHEME', 'Token')
+
+    client = ApiClient()
+
+    assert client._headers()['Authorization'] == 'Token secret-token'
+
+
 def test_operation_path_translates_dotted_operation_to_a_rest_path():
     path = ApiClient._operation_path('billing.document.builder::build')
 

libredte_lib_sdk-0.5.2/.claude/scheduled_tasks.lock

@@ -1 +0,0 @@
-{"sessionId":"64edfb1a-a3db-44cc-af25-6c7405269fdf","pid":73057,"procStart":"Mon Sep  7 03:13:55 2026","acquiredAt":1789224889985}

libredte_lib_sdk-0.5.2/tests/integration/test_certificate_loader.py

@@ -1,74 +0,0 @@
-# Copyright (C) 2026 LibreDTE <https://www.libredte.cl>
-# SPDX-License-Identifier: MIT
-
-"""
-Tests en vivo para `CertificateLoaderService` (`system.certificate.loader`).
-
-Arma un PKCS12 en memoria (mismo enfoque que `tests/test_utils.py`, sin
-depender de un archivo `.p12` real) a partir de un certificado ficticio
-ya generado por `create_fake_certificate` — así el certificado sí trae
-RUT/nombre/correo real (el fake de `create_fake_certificate` los
-codifica), que es lo que `system.certificate.loader::load` debe poder
-extraer.
-"""
-
-from __future__ import annotations
-
-import pytest
-from cryptography import x509
-from cryptography.hazmat.primitives import serialization
-from cryptography.hazmat.primitives.serialization import pkcs12
-
-from libredte_lib_sdk.billing.trading_parties import Mandatario
-
-pytestmark = pytest.mark.live
-
-_MANDATARIO = Mandatario(
-    run='76192083-9',
-    nombre='SASCO SpA',
-    email='demo@sasco.example',
-)
-_PASSWORD = 'clave1234'
-
-
-@pytest.fixture
-def fake_pkcs12(real_sdk):
-    """Un `.p12` en memoria, con RUT/nombre/correo reales embebidos."""
-    mandatario_manager = real_sdk.billing.trading_parties.mandatario_manager
-    certificate = mandatario_manager.create_fake_certificate(_MANDATARIO)
-    key = serialization.load_pem_private_key(
-        certificate.private_key.encode(),
-        password=None,
-    )
-    cert = x509.load_pem_x509_certificate(certificate.certificate.encode())
-    return pkcs12.serialize_key_and_certificates(
-        b'demo',
-        key,
-        cert,
-        None,
-        serialization.BestAvailableEncryption(_PASSWORD.encode()),
-    )
-
-
-def test_load_extracts_the_mandatario_and_a_usable_certificate(
-    fake_pkcs12,
-    real_sdk,
-):
-    loaded = real_sdk.system.certificate.loader.load(fake_pkcs12, _PASSWORD)
-
-    assert loaded.id == '76192083-9'
-    assert loaded.name == 'SASCO SpA'
-    assert loaded.email == 'demo@sasco.example'
-    assert loaded.is_active is True
-    assert loaded.certificate.startswith('-----BEGIN CERTIFICATE-----')
-
-
-def test_create_from_certificate_matches_load(fake_pkcs12, real_sdk):
-    loaded = real_sdk.system.certificate.loader.load(fake_pkcs12, _PASSWORD)
-
-    mandatario_manager = real_sdk.billing.trading_parties.mandatario_manager
-    mandatario = mandatario_manager.create_from_certificate(loaded)
-
-    assert mandatario.run == loaded.id
-    assert mandatario.nombre == loaded.name
-    assert mandatario.email == loaded.email