printer-core 0.0.1__tar.gz

printer_core-0.0.1/.gitignore

@@ -0,0 +1,207 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+.idea/
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/

printer_core-0.0.1/PKG-INFO

@@ -0,0 +1,24 @@
+Metadata-Version: 2.4
+Name: printer-core
+Version: 0.0.1
+Summary: Foodeo Printer Core Domain.
+Project-URL: Homepage, https://github.com/Foodeo/printer-core
+Project-URL: Repository, https://github.com/Foodeo/printer-core
+Project-URL: Issues, https://github.com/Foodeo/printer-core/issues
+Author-email: OmarSRolo <chicomtz.sr@gmail.com>, ramsy19980104 <busto0498@gmail.com>, ytapanesm90 <ytapanes90@gmail.com>
+License: MIT
+Keywords: domain,foodeo
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Requires-Dist: pydantic>=2.12.2
+Description-Content-Type: text/markdown
+
+# printer-core
+Foodeo Printer Core

printer_core-0.0.1/README.md

@@ -0,0 +1,2 @@
+# printer-core
+Foodeo Printer Core

printer_core-0.0.1/printer_core/__init__.py

@@ -0,0 +1 @@
+# printer_core package

printer_core-0.0.1/printer_core/algorithms/__init__.py

@@ -0,0 +1,3 @@
+from .products_modifiers_multiprinter import ProductsModifiersMultiPrinter
+from .products_modifiers_multiprinter_family import ProductsModifiersMultiprinterFamily
+from .products_modifiers_unique_ticket import ProductsModifiersUniqueTicket

printer_core-0.0.1/printer_core/algorithms/products_modifiers_multiprinter.py

@@ -0,0 +1,59 @@
+from typing import Any
+
+from printer_core.entities import KitchenProductLine, PrintProductData, PrintRequestData, PrinterData
+from printer_core.formatters.discount_formatter import DiscountFormatter
+
+
+class ProductsModifiersMultiPrinter:
+    def __init__(self, formatter: DiscountFormatter):
+        self._formatter = formatter
+
+    def build(
+        self,
+        request: PrintRequestData,
+        products: list[PrintProductData],
+        kitchen_ticket_settings: Any,
+        main_printer: PrinterData | dict[str, Any],
+    ) -> list[KitchenProductLine]:
+        list_products_own_printer: list[KitchenProductLine] = []
+        fallback_printer = self._resolve_printer(main_printer)
+        for product in products:
+            printers = list(product.printer or [])
+            if not printers:
+                printers = [fallback_printer]
+            for actual_printer in printers:
+                printer_payload = self._resolve_printer(actual_printer)
+                name = product.product_name
+                if kitchen_ticket_settings.show_price_per_unit and not request.all_discounted:
+                    name += self._formatter.format(product, request.currency or "")
+                line = KitchenProductLine(
+                    name=name,
+                    qty=int(product.qty),
+                    option=product.option,
+                    printer_r=printer_payload.name,
+                    printer_w=printer_payload.printer_width,
+                    details=product.details or "",
+                    order=product.order or "",
+                    tpv=printer_payload.tpv,
+                    order_readable=product.order_readable or "",
+                )
+                if kitchen_ticket_settings.show_price_per_unit:
+                    line = line.model_copy(update={
+                        "price": product.total_price,
+                        "unitary_price": product.product_price,
+                    })
+                list_products_own_printer.append(line)
+        return list_products_own_printer
+
+    def _resolve_printer(self, printer: PrinterData | dict[str, Any]) -> PrinterData:
+        if isinstance(printer, PrinterData):
+            return printer
+        if isinstance(printer, dict):
+            return PrinterData(**printer)
+        if hasattr(printer, "model_dump"):
+            return PrinterData(**printer.model_dump(mode="json", exclude_none=True))
+        return PrinterData(
+            name=printer.name,
+            printer_width=printer.printer_width,
+            tpv=getattr(printer, "tpv", None),
+        )

printer_core-0.0.1/printer_core/algorithms/products_modifiers_multiprinter_family.py

@@ -0,0 +1,53 @@
+from typing import Any
+
+from printer_core.entities import KitchenProductLine, PrintProductData, PrintRequestData, PrinterData
+from printer_core.formatters.discount_formatter import DiscountFormatter
+
+
+class ProductsModifiersMultiprinterFamily:
+    def __init__(self, formatter: DiscountFormatter):
+        self._formatter = formatter
+
+    def append_product(self,
+                       list_products_own_printer: list[KitchenProductLine],
+                       product: PrintProductData,
+                       request: PrintRequestData,
+                       kitchen_ticket_settings: Any,
+                       ) -> None:
+        for actual_printer in product.printer:
+            printer_payload = self._resolve_printer(actual_printer)
+            name_with_discount: str = product.product_name
+            if not request.all_discounted:
+                name_with_discount += self._formatter.format(product, request.currency or "")
+            line = KitchenProductLine(
+                name=name_with_discount,
+                qty=int(product.qty),
+                option=product.option,
+                printer_r=printer_payload.name,
+                printer_w=printer_payload.printer_width,
+                details=product.details or "",
+                order=product.order or "",
+                tpv=printer_payload.tpv,
+                order_readable=product.order_readable or "",
+            )
+
+            if kitchen_ticket_settings.show_price_per_unit:
+                line = line.model_copy(update={
+                    "price": product.total_price,
+                    "unitary_price": product.product_price,
+                })
+
+            list_products_own_printer.append(line)
+
+    def _resolve_printer(self, printer: PrinterData | dict[str, Any]) -> PrinterData:
+        if isinstance(printer, PrinterData):
+            return printer
+        if isinstance(printer, dict):
+            return PrinterData(**printer)
+        if hasattr(printer, "model_dump"):
+            return PrinterData(**printer.model_dump(mode="json", exclude_none=True))
+        return PrinterData(
+            name=printer.name,
+            printer_width=printer.printer_width,
+            tpv=getattr(printer, "tpv", None),
+        )

printer_core-0.0.1/printer_core/algorithms/products_modifiers_unique_ticket.py

@@ -0,0 +1,30 @@
+from printer_core.entities import ClientTicketProduct, PrintProductData, PrintRequestData
+from printer_core.formatters.discount_formatter import DiscountFormatter
+
+
+class ProductsModifiersUniqueTicket:
+    def __init__(self, formatter: DiscountFormatter, domicile_service_label: str = "Domicile Service"):
+        self._formatter = formatter
+        self._domicile_service_label = domicile_service_label
+
+    def build(self, request: PrintRequestData, products: list[PrintProductData]) -> list[ClientTicketProduct]:
+        list_products_in_same_printers: list[ClientTicketProduct] = []
+        for product in products:
+            with_discount = ""
+            if not request.all_discounted:
+                with_discount = self._formatter.format(product, request.currency or "")
+            product_name = product.product_name + with_discount
+            list_products_in_same_printers.append(ClientTicketProduct(
+                name=product_name,
+                qty=int(product.qty),
+                option=product.option,
+                price=str(product.total_price),
+                unitary_price=str(product.product_price),
+            ))
+        if request.price_domicile_service:
+            list_products_in_same_printers.append(ClientTicketProduct(
+                name=self._domicile_service_label,
+                qty=1,
+                price=str(request.price_domicile_service),
+            ))
+        return list_products_in_same_printers

printer_core-0.0.1/printer_core/builders/__init__.py

@@ -0,0 +1,4 @@
+from .kitchen_ticket_payload_builder import KitchenTicketPayloadBuilder
+from .printer_products_grouper import PrinterProductsGrouper
+from .client_ticket_builder import ClientTicketBuilder
+from .header_builder import HeaderBuilder

printer_core-0.0.1/printer_core/builders/client_ticket_builder.py

@@ -0,0 +1,97 @@
+from decimal import Decimal
+from typing import Any, Callable
+
+from printer_core.entities import (
+    ClientTicketData,
+    ClientTicketPayload,
+    ClientTicketProduct,
+    PrintProductData,
+    PrintRequestData,
+    PrinterData,
+)
+
+
+class ClientTicketBuilder:
+    def __init__(self,
+                 currency_symbol_resolver: Callable[[str], str] | None = None,
+                 domicile_service_label: str = "Domicile Service",
+                 ):
+        self._currency_symbol_resolver = currency_symbol_resolver or (lambda _: "")
+        self._domicile_service_label = domicile_service_label
+
+    def build(self,
+              request: PrintRequestData,
+              products: list[PrintProductData],
+              printer: PrinterData | dict[str, Any],
+              ticket_settings: Any,
+              tpv_key: str,
+              ) -> list[ClientTicketPayload]:
+        ticket_text = self._get_attr(ticket_settings, "ticket_text", "")
+        qty_client_ticket = self._get_attr(ticket_settings, "qty_client_ticket", 1)
+        client_request = ClientTicketData(
+            **request.model_dump(exclude={"products", "ticket_text"}),
+            ticket_text=ticket_text,
+            products=self._build_products(request, products),
+        )
+
+        if client_request.type in ["domicilio", "recoger"]:
+            client_request = client_request.model_copy(update={"details": client_request.details or ""})
+        elif client_request.details:
+            client_request = client_request.model_copy(update={"details": None})
+
+        printer_name, printer_width = self._resolve_printer(printer)
+        payload = ClientTicketPayload(
+            data=client_request,
+            currency=client_request.currency or "",
+            model=2,
+            company_key=tpv_key,
+            printer=printer_name,
+            printer_qty=qty_client_ticket,
+            printer_width=printer_width,
+        )
+        return [payload]
+
+    def _build_products(
+        self,
+        request: PrintRequestData,
+        products: list[PrintProductData],
+    ) -> list[ClientTicketProduct]:
+        list_products: list[ClientTicketProduct] = []
+        currency_symbol = self._currency_symbol_resolver(request.currency or "")
+        for product in products:
+            with_discount = ""
+            if not request.all_discounted:
+                with_discount = self._format_discount(product, currency_symbol)
+            product_name = product.product_name + with_discount
+            list_products.append(ClientTicketProduct(
+                name=product_name,
+                qty=int(product.qty),
+                option=product.option,
+                price=str(product.total_price),
+                unitary_price=str(product.product_price),
+            ))
+        if request.price_domicile_service:
+            list_products.append(ClientTicketProduct(
+                name=self._domicile_service_label,
+                qty=1,
+                price=str(request.price_domicile_service),
+            ))
+        return list_products
+
+    def _format_discount(self, product: PrintProductData, currency_symbol: str) -> str:
+        if product.discount_type == "number":
+            return f" (Dto {product.total_price}{currency_symbol})"
+        if product.discount_type == "percent" and product.discount:
+            total = Decimal(str(product.importe)) - Decimal(str(product.total_price))
+            return f" (Dto {product.discount.value}% {total}{currency_symbol})"
+        return ""
+
+    def _get_attr(self, obj: Any, attr: str, default: Any) -> Any:
+        if isinstance(obj, dict):
+            return obj.get(attr, default)
+        return getattr(obj, attr, default)
+
+    def _resolve_printer(self, printer: PrinterData | dict[str, Any]) -> tuple[str, Any]:
+        if isinstance(printer, dict):
+            return printer["name"], printer["printer_width"]
+        return printer.name, printer.printer_width

printer_core-0.0.1/printer_core/builders/header_builder.py

@@ -0,0 +1,26 @@
+from typing import Any
+
+from printer_core.entities import HeaderData, PrintRequestData
+from printer_core.ports import HeaderDataProvider
+
+
+class HeaderBuilder:
+    def __init__(self, provider: HeaderDataProvider, show_person_name: bool):
+        self._provider = provider
+        self._show_person_name = show_person_name
+
+    def build_header(self, request: PrintRequestData, worker: Any | None = None) -> HeaderData:
+        header_data: dict[str, str] = self._provider.get_company_header()
+        if self._show_person_name and worker:
+            header_data.update(self._provider.get_worker_header(worker))
+        header_data.update(self._client_header(request))
+        return HeaderData(**header_data)
+
+    def _client_header(self, request: PrintRequestData) -> dict[str, str]:
+        request_type = request.type
+        from_client = request.from_client
+        if request_type == "recoger":
+            return self._provider.get_pickup_client_header(request.client, from_client)
+        if request_type == "domicilio":
+            return self._provider.get_domicile_client_header(request.address, from_client)
+        return {}

printer_core-0.0.1/printer_core/builders/kitchen_ticket_payload_builder.py

@@ -0,0 +1,99 @@
+from datetime import datetime
+from typing import Any, Callable
+
+from printer_core.clock import SystemClock
+from printer_core.entities import (
+    KitchenProductLine,
+    KitchenTicketData,
+    KitchenTicketPayload,
+    PrintRequestData,
+    PrintSettingsData,
+    ProductsGroup,
+)
+from printer_core.ports import Clock
+
+
+class KitchenTicketPayloadBuilder:
+    def __init__(self, clock: Clock | None = None):
+        self._clock = clock or SystemClock()
+
+    def build(self,
+              request: PrintRequestData,
+              printer_name: str,
+              tpv_key: str,
+              printer_width: str,
+              products: list[KitchenProductLine],
+              ticket_settings: Any,
+              kitchen_ticket_settings: Any,
+              group_products_func: Callable[[list[KitchenProductLine]], list[ProductsGroup]],
+              ) -> KitchenTicketPayload:
+        data = KitchenTicketData(
+            id=request.id,
+            table_name=request.table_name,
+            credit_card=request.credit_card,
+            serial=request.serial,
+            details=request.details or "",
+            type=request.type,
+            discount=request.discount,
+        )
+
+        data = data.model_copy(update={"created_at": self._resolve_created_at(request)})
+
+        if kitchen_ticket_settings.show_total_price:
+            data = data.model_copy(update={
+                "total": str(request.total),
+                "request_price": request.request_price,
+            })
+
+        if request.type == "local" and kitchen_ticket_settings.show_command_guests:
+            data = data.model_copy(update={"command_guests": request.command_guests})
+
+        if request.headerData:
+            data = data.model_copy(update={"headerData": request.headerData})
+
+        model = 1
+        if request.type != "local":
+            model = 2
+
+        data = self._set_products(data, request, products, group_products_func)
+        print_settings = self._set_print_settings(request)
+
+        return KitchenTicketPayload(
+            data=data,
+            model=model,
+            printer_qty=ticket_settings.qty_kitchen_ticket,
+            printer=printer_name,
+            company_key=tpv_key,
+            printer_width=printer_width,
+            currency=request.currency or "",
+            PrintSettings=print_settings,
+        )
+
+    def _resolve_created_at(self, request: PrintRequestData) -> str:
+        if request.type in ["domicilio", "recoger"] and request.shift_time and request.delivery_date:
+            shift_time = datetime.strptime(request.shift_time, "%H:%M").time()
+            delivery_date = datetime.strptime(request.delivery_date, "%Y-%m-%d").date()
+            return datetime.combine(delivery_date, shift_time).strftime("%Y-%m-%d %H:%M")
+        return self._clock.now_iso()
+
+    def _set_products(self,
+                      data: KitchenTicketData,
+                      request: PrintRequestData,
+                      products: list[KitchenProductLine],
+                      group_products_func: Callable[[list[KitchenProductLine]], list[ProductsGroup]],
+                      ) -> KitchenTicketData:
+        group_by_orders = request.group_by_orders
+        if group_by_orders and request.type == "local":
+            grouped = group_products_func(products)
+            if grouped and not isinstance(grouped[0], ProductsGroup):
+                grouped = [ProductsGroup(group="Sin orden", products=grouped)]
+            return data.model_copy(update={"products_groups": grouped})
+        return data.model_copy(update={"products": products})
+
+    def _set_print_settings(self, request: PrintRequestData) -> PrintSettingsData | None:
+        print_settings = request.PrintSettings
+        if not print_settings:
+            return None
+        if request.type == "local" and print_settings.show_local_header is not None:
+            return print_settings.model_copy(update={"show_header": print_settings.show_local_header})
+        return print_settings

printer_core-0.0.1/printer_core/builders/printer_products_grouper.py

@@ -0,0 +1,19 @@
+from printer_core.entities import KitchenProductLine, PrinterProductGroup
+
+
+class PrinterProductsGrouper:
+    @staticmethod
+    def group_by_printer_key(products: list[KitchenProductLine]) -> list[PrinterProductGroup]:
+        grouped: dict[str, PrinterProductGroup] = {}
+        for item in products:
+            key = f"{item.printer_r}%%{item.tpv or ''}%%{item.printer_w}"
+            if key not in grouped:
+                grouped[key] = PrinterProductGroup(
+                    printer_name=item.printer_r,
+                    tpv_key=item.tpv or "",
+                    printer_width=item.printer_w,
+                    products=[item],
+                )
+            else:
+                grouped[key].products.append(item)
+        return list(grouped.values())

printer_core-0.0.1/printer_core/clock.py

@@ -0,0 +1,6 @@
+from datetime import datetime, timezone
+
+
+class SystemClock:
+    def now_iso(self) -> str:
+        return datetime.now(timezone.utc).isoformat()

printer_core-0.0.1/printer_core/context/__init__.py

@@ -0,0 +1 @@
+from .ticket_context_builder import TicketContextBuilder