PyCheval 0.1.0__py3-none-any.whl

pycheval/__init__.py

@@ -0,0 +1,15 @@
+from typing import Final
+
+from .exc import *  # noqa: F403
+from .format import format_invoice_as_text as format_invoice_as_text
+from .generate import (
+    generate as generate,
+    generate_et as generate_et,
+)
+from .model import *  # noqa: F403
+from .money import Money as Money
+from .parse import parse_xml as parse_xml
+from .pdf_parse import parse_pdf as parse_pdf
+
+FACTURX_VERSION: Final = "1.0.07"
+ZUGFERD_VERSION: Final = "2.3"

pycheval/_locale.py

@@ -0,0 +1,20 @@
+import gettext
+from collections.abc import Callable
+from pathlib import Path
+
+LOCALE_PATH = Path(__file__).parent / "locale"
+
+
+def setup_locale() -> Callable[[str], str]:
+    """Setup the gettext translation function in a module.
+
+    Usage:
+
+    from ._locale import setup_locale
+    _ = setup_locale()
+
+    print(_("Hello, World!"))
+    """
+
+    t = gettext.translation("pycheval", localedir=LOCALE_PATH, fallback=True)
+    return t.gettext

pycheval/const.py

@@ -0,0 +1,18 @@
+"""
+XML Utilities for PyCheval
+"""
+
+URN_MINIMUM_PROFILE = "urn:factur-x.eu:1p0:minimum"
+URN_BASIC_WL_PROFILE = "urn:factur-x.eu:1p0:basicwl"
+URN_BASIC_PROFILE = (
+    "urn:cen.eu:en16931:2017#compliant#urn:factur-x.eu:1p0:basic"
+)
+URN_EN16931_PROFILE = "urn:cen.eu:en16931:2017"
+URN_EXTENDED_PROFILE = (
+    "urn:cen.eu:en16931:2017#conformant#urn:factur-x.eu:1p0:extended"
+)
+URN_XRECHNUNG_PROFILE = "urn:cen.eu:en16931:2017#compliant#urn:xoev-de:kosit:standard:xrechnung_2.1"  # noqa: E501
+
+NS_CII = "urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100"
+NS_RAM = "urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100"  # noqa: E501
+NS_UDT = "urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100"

pycheval/countries.py

@@ -0,0 +1,6 @@
+import re
+
+
+def validate_iso_3166_1_alpha_2(code: str) -> bool:
+    """Validate an ISO 3166-1 country code in ALPHA-2 format."""
+    return re.match(r"^[A-Z]{2}$", code) is not None

pycheval/exc.py

@@ -0,0 +1,46 @@
+class FacturXError(Exception):
+    """Base class for Factur-X exceptions."""
+
+
+class PDFError(FacturXError):
+    """Base class for PDF processing exceptions."""
+
+
+class PDFParseError(FacturXError):
+    """Raise when a PDF file cannot be processed."""
+
+
+class NoFacturXError(PDFParseError):
+    """Raised when a PDF file does not contain a Factur-X XML file."""
+
+
+class ModelError(FacturXError):
+    """Raised when a Factur-X model is invalid."""
+
+
+class FacturXParseError(FacturXError):
+    """Base class for Factur-X parsing exceptions."""
+
+
+class XMLParseError(FacturXParseError):
+    """Raised when an XML file cannot be parsed."""
+
+
+class NotFacturXError(FacturXParseError):
+    """Raised when an XML file is not a Factur-X file."""
+
+
+class UnsupportedProfileError(FacturXParseError):
+    """Raised when a Factur-X file uses an unsupported profile."""
+
+
+class InvalidXMLError(FacturXParseError):
+    """Raised when a Factur-X XML file has the wrong structure."""
+
+
+class InvalidProfileError(FacturXParseError):
+    """Raised when a Factur-X file is invalid for the specified profile."""
+
+    def __init__(self, profile_name: str, message: str) -> None:
+        super().__init__(message)
+        self.profile_name = profile_name