python-getpaid-core 0.1.0__tar.gz → 0.1.1__tar.gz

python_getpaid_core-0.1.1/.pre-commit-config.yaml

@@ -0,0 +1,39 @@
+repos:
+  - repo: local
+    hooks:
+      - id: ruff
+        name: ruff
+        entry: uv run ruff check --fix
+        language: system
+        types: [python]
+      - id: ruff-format
+        name: ruff-format
+        entry: uv run ruff format
+        language: system
+        types: [python]
+      - id: check-toml
+        name: check-toml
+        entry: uv run check-toml
+        language: system
+        types: [toml]
+      - id: check-yaml
+        name: check-yaml
+        entry: uv run check-yaml
+        language: system
+        types: [yaml]
+      - id: end-of-file-fixer
+        name: end-of-file-fixer
+        entry: uv run end-of-file-fixer
+        language: system
+        types: [text]
+      - id: trailing-whitespace
+        name: trailing-whitespace
+        entry: uv run trailing-whitespace-fixer
+        language: system
+        types: [text]
+      - id: ty
+        name: ty
+        entry: uv run ty check
+        language: system
+        types: [python]
+        pass_filenames: false

{python_getpaid_core-0.1.0 → python_getpaid_core-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-getpaid-core
-Version: 0.1.0
+Version: 0.1.1
 Summary: Framework-agnostic payment processing core.
 Project-URL: Homepage, https://github.com/django-getpaid/python-getpaid-core
 Project-URL: Repository, https://github.com/django-getpaid/python-getpaid-core
@@ -12,14 +12,12 @@ License-File: LICENSE
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Office/Business :: Financial
 Classifier: Topic :: Office/Business :: Financial :: Point-Of-Sale
 Classifier: Typing :: Typed
-Requires-Python: >=3.10
+Requires-Python: >=3.12
 Requires-Dist: anyio>=4.0
 Requires-Dist: httpx>=0.27.0
 Requires-Dist: transitions>=0.9.0
@@ -57,6 +55,10 @@ any web framework:
 
 - **[django-getpaid](https://github.com/django-getpaid/django-getpaid)** —
   Django adapter (models, views, forms, admin)
+- **[fastapi-getpaid](https://github.com/django-getpaid/fastapi-getpaid)** —
+  FastAPI adapter (async routes, SQLAlchemy, Pydantic config)
+- **[litestar-getpaid](https://github.com/django-getpaid/litestar-getpaid)** —
+  Litestar adapter (controllers, Provide DI, SQLAlchemy, Pydantic config)
 
 ## Installation
 

{python_getpaid_core-0.1.0 → python_getpaid_core-0.1.1}/README.md

@@ -30,6 +30,10 @@ any web framework:
 
 - **[django-getpaid](https://github.com/django-getpaid/django-getpaid)** —
   Django adapter (models, views, forms, admin)
+- **[fastapi-getpaid](https://github.com/django-getpaid/fastapi-getpaid)** —
+  FastAPI adapter (async routes, SQLAlchemy, Pydantic config)
+- **[litestar-getpaid](https://github.com/django-getpaid/litestar-getpaid)** —
+  Litestar adapter (controllers, Provide DI, SQLAlchemy, Pydantic config)
 
 ## Installation
 

{python_getpaid_core-0.1.0 → python_getpaid_core-0.1.1}/docs/conf.py

@@ -2,7 +2,7 @@
 
 project = "getpaid-core"
 author = "Dominik Kozaczko"
-copyright = "2022-2026, Dominik Kozaczko"
+project_copyright = "2022-2026, Dominik Kozaczko"
 
 extensions = [
     "sphinx.ext.autodoc",

{python_getpaid_core-0.1.0 → python_getpaid_core-0.1.1}/pyproject.toml

@@ -1,19 +1,17 @@
 [project]
 name = 'python-getpaid-core'
-version = '0.1.0'
+version = "0.1.1"
 description = 'Framework-agnostic payment processing core.'
 readme = 'README.md'
 license = {text = 'MIT'}
 authors = [
     {name = 'Dominik Kozaczko', email = 'dominik@kozaczko.info'},
 ]
-requires-python = '>=3.10'
+requires-python = '>=3.12'
 classifiers = [
     'Development Status :: 3 - Alpha',
     'Intended Audience :: Developers',
     'License :: OSI Approved :: MIT License',
-    'Programming Language :: Python :: 3.10',
-    'Programming Language :: Python :: 3.11',
     'Programming Language :: Python :: 3.12',
     'Programming Language :: Python :: 3.13',
     'Topic :: Office/Business :: Financial',
@@ -32,11 +30,13 @@ dev = [
     'pytest-asyncio>=0.24.0',
     'pytest-cov>=5.0',
     'respx>=0.22.0',
-    'ruff>=0.9.0',
-    'pre-commit>=4.0',
+    "ruff>=0.9.0",
+    "pre-commit>=4.0",
     "furo>=2025.12.19",
     "sphinx>=8.1.3",
     "myst-parser>=4.0.1",
+    "pre-commit-hooks>=6.0.0",
+    "ty>=0.0.16",
 ]
 
 [project.urls]
@@ -64,7 +64,7 @@ source = ['getpaid_core']
 show_missing = true
 
 [tool.ruff]
-target-version = 'py310'
+target-version = 'py312'
 line-length = 80
 src = ['src', 'tests']
 
@@ -94,3 +94,17 @@ ignore = [
 force-single-line = true
 lines-after-imports = 2
 known-first-party = ['getpaid_core']
+
+# --- ty type checker ---
+[tool.ty.environment]
+python-version = '3.12'
+
+[tool.ty.terminal]
+error-on-warning = true
+
+# Relax rules for test files: FSM trigger methods are dynamically attached
+[[tool.ty.overrides]]
+include = ['tests/**']
+[tool.ty.overrides.rules]
+unresolved-attribute = 'ignore'
+invalid-argument-type = 'ignore'

{python_getpaid_core-0.1.0 → python_getpaid_core-0.1.1}/src/getpaid_core/flow.py

@@ -58,7 +58,7 @@ class PaymentFlow:
         create_payment_machine(payment)
         processor = self._get_processor(payment)
         result = await processor.prepare_transaction(**kwargs)
-        payment.confirm_prepared()
+        payment.confirm_prepared()  # ty: ignore[unresolved-attribute]  # FSM trigger attached by create_payment_machine
         await self.repository.save(payment)
         return result
 
@@ -91,7 +91,11 @@ class PaymentFlow:
                 )
             trigger = getattr(payment, callback, None)
             if trigger and callable(trigger):
-                trigger()
+                trigger_kwargs = {}
+                amount = response.get("amount")
+                if amount is not None:
+                    trigger_kwargs["amount"] = amount
+                trigger(**trigger_kwargs)
         await self.repository.save(payment)
         return payment
 
@@ -101,7 +105,7 @@ class PaymentFlow:
         create_payment_machine(payment)
         result = await processor.charge(amount=amount, **kwargs)
         if result["success"]:
-            payment.confirm_charge_sent()
+            payment.confirm_charge_sent()  # ty: ignore[unresolved-attribute]  # FSM trigger attached by create_payment_machine
         await self.repository.save(payment)
         return result
 
@@ -110,7 +114,7 @@ class PaymentFlow:
         processor = self._get_processor(payment)
         create_payment_machine(payment)
         amount = await processor.release_lock(**kwargs)
-        payment.release_lock()
+        payment.release_lock()  # ty: ignore[unresolved-attribute]  # FSM trigger attached by create_payment_machine
         await self.repository.save(payment)
         return amount
 
@@ -119,7 +123,7 @@ class PaymentFlow:
         processor = self._get_processor(payment)
         create_payment_machine(payment)
         refund_amount = await processor.start_refund(amount=amount, **kwargs)
-        payment.start_refund()
+        payment.start_refund()  # ty: ignore[unresolved-attribute]  # FSM trigger attached by create_payment_machine
         await self.repository.save(payment)
         return refund_amount
 
@@ -129,7 +133,7 @@ class PaymentFlow:
         create_payment_machine(payment)
         success = await processor.cancel_refund(**kwargs)
         if success:
-            payment.cancel_refund()
+            payment.cancel_refund()  # ty: ignore[unresolved-attribute]  # FSM trigger attached by create_payment_machine
             await self.repository.save(payment)
         return success
 

{python_getpaid_core-0.1.0 → python_getpaid_core-0.1.1}/src/getpaid_core/fsm.py

@@ -49,6 +49,15 @@ def _accumulate_paid_amount(event_data):
     model.amount_paid += amount
 
 
+def _accumulate_refunded_amount(event_data):
+    """After confirm_refund: accumulate refunded amount on the payment."""
+    model = event_data.model
+    amount = event_data.kwargs.get("amount", None)
+    if amount is None:
+        amount = model.amount_paid - model.amount_refunded
+    model.amount_refunded += amount
+
+
 PAYMENT_TRANSITIONS = [
     {
         "trigger": "confirm_prepared",
@@ -105,6 +114,7 @@ PAYMENT_TRANSITIONS = [
         "trigger": "confirm_refund",
         "source": PaymentStatus.REFUND_STARTED,
         "dest": PaymentStatus.PARTIAL,
+        "after": _accumulate_refunded_amount,
     },
     {
         "trigger": "mark_as_refunded",
@@ -174,11 +184,14 @@ def create_payment_machine(payment) -> Machine:
     The transitions library adds trigger methods directly to the
     object (confirm_prepared, confirm_lock, fail, etc.).
     """
+    initial = (
+        PaymentStatus(payment.status) if payment.status else PaymentStatus.NEW
+    )
     return Machine(
         model=payment,
         states=PaymentStatus,
         transitions=PAYMENT_TRANSITIONS,
-        initial=payment.status or PaymentStatus.NEW,
+        initial=initial,
         model_attribute="status",
         auto_transitions=False,
         send_event=True,
@@ -193,11 +206,16 @@ def _store_fraud_message(event):
 
 def create_fraud_machine(payment) -> Machine:
     """Attach fraud status FSM to a payment object."""
+    initial = (
+        FraudStatus(payment.fraud_status)
+        if payment.fraud_status
+        else FraudStatus.UNKNOWN
+    )
     return Machine(
         model=payment,
         states=FraudStatus,
         transitions=FRAUD_TRANSITIONS,
-        initial=payment.fraud_status or FraudStatus.UNKNOWN,
+        initial=initial,
         model_attribute="fraud_status",
         auto_transitions=False,
         send_event=True,

{python_getpaid_core-0.1.0 → python_getpaid_core-0.1.1}/src/getpaid_core/registry.py

@@ -27,12 +27,12 @@ class PluginRegistry:
             if isinstance(processor_class, type) and issubclass(
                 processor_class, BaseProcessor
             ):
-                self._backends[processor_class.slug] = processor_class
+                self._register_backend(processor_class)
         self._discovered = True
 
     def register(self, processor_class: type[BaseProcessor]) -> None:
         """Manual registration for testing or dynamic use."""
-        self._backends[processor_class.slug] = processor_class
+        self._register_backend(processor_class)
 
     def unregister(self, slug: str) -> None:
         """Remove a backend by slug."""
@@ -70,5 +70,16 @@ class PluginRegistry:
         if not self._discovered:
             self.discover()
 
+    def _register_backend(self, processor_class: type[BaseProcessor]) -> None:
+        slug = processor_class.slug
+        existing = self._backends.get(slug)
+        if existing is not None and existing is not processor_class:
+            raise ValueError(
+                f"Duplicate backend slug {slug!r}: "
+                f"{existing.__module__}.{existing.__name__} and "
+                f"{processor_class.__module__}.{processor_class.__name__}"
+            )
+        self._backends[slug] = processor_class
+
 
 registry = PluginRegistry()

{python_getpaid_core-0.1.0 → python_getpaid_core-0.1.1}/tests/test_flow.py

@@ -109,6 +109,21 @@ class TestFetchAndUpdateStatus:
         ):
             await flow.fetch_and_update_status(payment)
 
+    @pytest.mark.asyncio
+    async def test_pull_passes_amount_to_transition(self, flow):
+        payment = MockPayment(backend="mock", status=PaymentStatus.PREPARED)
+        with patch.object(
+            MockProcessor,
+            "fetch_payment_status",
+            new_callable=AsyncMock,
+            return_value={
+                "status": "confirm_payment",
+                "amount": Decimal("40.00"),
+            },
+        ):
+            result = await flow.fetch_and_update_status(payment)
+        assert result.amount_paid == Decimal("40.00")
+
 
 class TestCharge:
     @pytest.mark.asyncio

{python_getpaid_core-0.1.0 → python_getpaid_core-0.1.1}/tests/test_fsm.py

@@ -144,6 +144,22 @@ class TestPaymentRefundFlow:
         p.confirm_refund()
         assert p.status == PaymentStatus.PARTIAL
 
+    def test_confirm_refund_accumulates_amount(self):
+        p = MockPayment(status=PaymentStatus.REFUND_STARTED)
+        p.amount_paid = 100
+        create_payment_machine(p)
+        p.confirm_refund(amount=30)
+        assert p.status == PaymentStatus.PARTIAL
+        assert p.amount_refunded == 30
+
+    def test_confirm_refund_defaults_to_remaining_amount(self):
+        p = MockPayment(status=PaymentStatus.REFUND_STARTED)
+        p.amount_paid = 100
+        p.amount_refunded = 40
+        create_payment_machine(p)
+        p.confirm_refund()
+        assert p.amount_refunded == 100
+
     def test_mark_as_refunded_when_fully_refunded(self):
         p = MockPayment(status=PaymentStatus.PARTIAL)
         p.amount_paid = 100

{python_getpaid_core-0.1.0 → python_getpaid_core-0.1.1}/tests/test_registry.py

@@ -55,6 +55,20 @@ class EURProcessor(BaseProcessor):
         )
 
 
+class DuplicatePLNProcessor(BaseProcessor):
+    slug = "pln-pay"
+    display_name = "Duplicate PLN"
+    accepted_currencies = ["PLN"]
+
+    async def prepare_transaction(self, **kwargs):
+        return TransactionResult(
+            redirect_url=None,
+            form_data=None,
+            method="REST",
+            headers={},
+        )
+
+
 # -- Tests --
 
 
@@ -71,6 +85,12 @@ class TestManualRegistration:
         assert reg.get_by_slug("pln-pay") is PLNProcessor
         assert reg.get_by_slug("eur-pay") is EURProcessor
 
+    def test_register_duplicate_slug_raises(self):
+        reg = PluginRegistry()
+        reg.register(PLNProcessor)
+        with pytest.raises(ValueError, match="Duplicate backend slug"):
+            reg.register(DuplicatePLNProcessor)
+
     def test_unregister(self):
         reg = PluginRegistry()
         reg.register(PLNProcessor)