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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: libredte-lib-sdk
-Version: 0.5.0
+Version: 0.5.2
 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

{libredte_lib_sdk-0.5.0 → libredte_lib_sdk-0.5.2}/libredte_lib_sdk/billing/identifier/models.py

@@ -47,6 +47,14 @@ class Caf(XmlPayloadMixin):
     def from_api(cls, data: dict[str, Any]) -> Caf:
         """Construye un `Caf` desde el `data` que devuelve la API."""
         ambiente = data.get('ambiente')
+        if isinstance(ambiente, dict):
+            # La API serializa el enum de PHP (`SiiEnvironment: int`,
+            # caso `STAGING = 1` allá) como `{"name": ..., "value":
+            # ...}` — el nombre no calza con el de acá (`CERTIFICATION`
+            # en vez de `STAGING`, mismo ambiente de certificación del
+            # SII), pero el `value` entero sí es el mismo en ambos
+            # lados, así que se arma el enum desde ahí.
+            ambiente = ambiente.get('value')
         return cls(
             id=data['id'],
             emisor=data['emisor'],

{libredte_lib_sdk-0.5.0 → libredte_lib_sdk-0.5.2}/libredte_lib_sdk/exceptions.py

@@ -60,6 +60,27 @@ class LibreDteApiError(LibreDteSdkError):
             return throwable.get('class')
         return None
 
+    @property
+    def full_message(self) -> str:
+        """
+        `title` + `detail` + dónde ocurrió, listo para loguear o mostrar.
+
+        Agrega el archivo y línea (`extensions.throwable.file`/`.line`)
+        cuando la API los informó, sin necesidad de ir a inspeccionar
+        `extensions` a mano cada vez. Si `detail` está vacío o repite
+        `title`, no lo duplica; si no hay `file`/`line`, los omite.
+        """
+        message = self.title
+        if self.detail and self.detail != self.title:
+            message = f'{message}: {self.detail}'
+        throwable = self.extensions.get('throwable')
+        if isinstance(throwable, dict):
+            file = throwable.get('file')
+            line = throwable.get('line')
+            if file and line:
+                message = f'{message} ({file}:{line})'
+        return message
+
     @classmethod
     def from_problem_details(
         cls,

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

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

libredte_lib_sdk-0.5.2/tests/test_exceptions.py

@@ -0,0 +1,98 @@
+# Copyright (C) 2026 LibreDTE <https://www.libredte.cl>
+# SPDX-License-Identifier: MIT
+
+"""Tests para `libredte_lib_sdk.exceptions`."""
+
+from __future__ import annotations
+
+from libredte_lib_sdk.exceptions import LibreDteApiError
+
+
+def test_full_message_combines_title_and_detail():
+    error = LibreDteApiError(
+        operation_id='billing.document.builder::build',
+        status_code=500,
+        title='Internal Server Error',
+        detail='The package billing.document.builder::build does not exist.',
+    )
+
+    assert error.full_message == (
+        'Internal Server Error: The package billing.document.builder'
+        '::build does not exist.'
+    )
+
+
+def test_full_message_skips_detail_when_empty():
+    error = LibreDteApiError(
+        operation_id='billing.document.builder::build',
+        status_code=500,
+        title='Error desconocido de la API.',
+    )
+
+    assert error.full_message == 'Error desconocido de la API.'
+
+
+def test_full_message_skips_detail_when_it_repeats_the_title():
+    error = LibreDteApiError(
+        operation_id='billing.document.builder::build',
+        status_code=500,
+        title='Mismo texto.',
+        detail='Mismo texto.',
+    )
+
+    assert error.full_message == 'Mismo texto.'
+
+
+def test_full_message_appends_file_and_line_when_the_api_reports_them():
+    """
+    Caso real: `ParserWorker::parse()` envuelve cualquier excepción en
+    una `ParserException` — la API informa `title` como la clase PHP
+    completa, `detail` como el mensaje real, y `extensions.throwable`
+    con dónde se lanzó.
+    """
+    error = LibreDteApiError(
+        operation_id='billing.document.builder::build',
+        status_code=500,
+        title=(
+            'libredte\\lib\\Core\\Package\\Billing\\Component\\Document'
+            '\\Exception\\ParserException'
+        ),
+        detail=(
+            'round(): Argument #1 ($num) must be of type int|float, '
+            'string given'
+        ),
+        extensions={
+            'throwable': {
+                'class': (
+                    'libredte\\lib\\Core\\Package\\Billing\\Component'
+                    '\\Document\\Exception\\ParserException'
+                ),
+                'file': (
+                    'project_dir:vendor/libredte/libredte-lib-core/src/'
+                    'Package/Billing/Component/Document/Worker/'
+                    'ParserWorker.php'
+                ),
+                'line': 75,
+            },
+        },
+    )
+
+    assert error.full_message == (
+        'libredte\\lib\\Core\\Package\\Billing\\Component\\Document'
+        '\\Exception\\ParserException: round(): Argument #1 ($num) '
+        'must be of type int|float, string given (project_dir:vendor/'
+        'libredte/libredte-lib-core/src/Package/Billing/Component/'
+        'Document/Worker/ParserWorker.php:75)'
+    )
+
+
+def test_full_message_omits_location_when_file_or_line_is_missing():
+    error = LibreDteApiError(
+        operation_id='billing.document.builder::build',
+        status_code=500,
+        title='Internal Server Error',
+        detail='Algo falló.',
+        extensions={'throwable': {'class': 'SomeException'}},
+    )
+
+    assert error.full_message == 'Internal Server Error: Algo falló.'

{libredte_lib_sdk-0.5.0 → libredte_lib_sdk-0.5.2}/tests/test_models.py

@@ -282,6 +282,33 @@ def test_caf_from_api_ambiente_is_none_for_a_fake_caf():
     assert caf.certificacion is None
 
 
+def test_caf_from_api_ambiente_as_object_uses_its_value():
+    """La API a veces serializa el enum de PHP como `{name, value}`."""
+    caf = Caf.from_api(
+        {
+            'id': 'CAF33D1H100',
+            'emisor': {'rut': '76192083-9', 'razon_social': 'SASCO SpA'},
+            'tipoDocumento': 33,
+            'folioDesde': 1,
+            'folioHasta': 100,
+            'cantidadFolios': 100,
+            'fechaAutorizacion': '2026-01-01',
+            'fechaVencimiento': '2026-06-30',
+            'mesesAutorizacion': 2.17,
+            'vigente': True,
+            'vence': True,
+            'idk': 100,
+            'ambiente': {'name': 'STAGING', 'value': 1},
+            'certificacion': 1,
+            'publicKey': '-----BEGIN PUBLIC KEY-----',
+            'privateKey': '-----BEGIN PRIVATE KEY-----',
+            'xml': base64.b64encode(b'<AUTORIZACION/>').decode(),
+        },
+    )
+
+    assert caf.ambiente is SiiEnvironment.CERTIFICATION
+
+
 def test_send_result_reads_track_id():
     assert SendXmlDocumentResponse.from_api({'track_id': 456}).track_id == 456
     assert SendXmlDocumentResponse.from_api({}).track_id is None