python-sendparcel 0.3.1__py3-none-any.whl → 0.3.2__py3-none-any.whl

{python_sendparcel-0.3.1.dist-info → python_sendparcel-0.3.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-sendparcel
-Version: 0.3.1
+Version: 0.3.2
 Summary: Framework-agnostic parcel shipping core for Python.
 Project-URL: Homepage, https://github.com/python-sendparcel/python-sendparcel
 Project-URL: Repository, https://github.com/python-sendparcel/python-sendparcel

{python_sendparcel-0.3.1.dist-info → python_sendparcel-0.3.2.dist-info}/RECORD

@@ -4,7 +4,7 @@ sendparcel/concurrent.py,sha256=RFkuIjL9XehDqBc2cHXivbzYlJtR_9ZxjAqO5_hxJzY,2082
 sendparcel/enums.py,sha256=e1UM9ka5zWJg4naMCoVeUrIy_PVPPEYHOBh6XiXaW4Q,687
 sendparcel/exceptions.py,sha256=zC5_o9oQfNuOBKaiw5csaHAJmhYsZc3WVbOaoq7s1W0,1437
 sendparcel/factory.py,sha256=VVB8Kz3J-7QI-VjrJsMwKso5SVZf97yZBX5nMbnCMM4,1045
-sendparcel/flow.py,sha256=ur-GNH9UinrQy2ttErFXzRB4TTh4jdbBP8BlokIKA4A,13328
+sendparcel/flow.py,sha256=4ANkO2G0QSFoXl6oZ6DYQfrTato-oR-cZ9lKJfGkuE4,13490
 sendparcel/fsm.py,sha256=bRkt8tj_mg71Wq8obhhKK6nrQuN2a4Y_YXiL7kYxPDU,3134
 sendparcel/logging.py,sha256=TOetzdKJtl6YIY9Dpq-uxWB-jituOEKx0DpWmGrrBMU,4256
 sendparcel/protocols.py,sha256=7YX2KTOEG5Nje6bzibmIODFiTX7tgqb6I3WYgx9uVS4,2344
@@ -13,8 +13,8 @@ sendparcel/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 sendparcel/registry.py,sha256=CCaU7Esd6vS5eVvvv_oLuWEhd9j17Zk3-hEOZl-_7Vk,3790
 sendparcel/types.py,sha256=E96qcbQ6qfpvtA-LRdIzQounYXDWnfMNZJypzJ3dI1g,4855
 sendparcel/providers/__init__.py,sha256=ff82dvrWuPS-UIGF5AoX_fgpcYZaGu2k6q2yrxMZacI,192
-sendparcel/providers/dummy.py,sha256=J_FOzy0NsgKeI3Zxe0vTfPBdVeVSXKGd_zyMWfBL58Q,2836
-python_sendparcel-0.3.1.dist-info/METADATA,sha256=vdcN_KGTpb5PjfoxvcSZXHerCcomZE7WDfS9dMdPXhk,7175
-python_sendparcel-0.3.1.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-python_sendparcel-0.3.1.dist-info/licenses/LICENSE,sha256=IZXSBOjgGvChgayLmtTnU40iE7hsrrU3WVEYKx0sywY,1075
-python_sendparcel-0.3.1.dist-info/RECORD,,
+sendparcel/providers/dummy.py,sha256=NHQIdeKEPzZeLEMKxT82Jzj7KvBat_gvpQeJ6KBTvI4,3557
+python_sendparcel-0.3.2.dist-info/METADATA,sha256=-R_wb54oqM5qNoFRtyEFsWWLH2xMzZ12GW27XpKnm_4,7175
+python_sendparcel-0.3.2.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+python_sendparcel-0.3.2.dist-info/licenses/LICENSE,sha256=IZXSBOjgGvChgayLmtTnU40iE7hsrrU3WVEYKx0sywY,1075
+python_sendparcel-0.3.2.dist-info/RECORD,,

{python_sendparcel-0.3.1.dist-info → python_sendparcel-0.3.2.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.30.1
+Generator: hatchling 1.31.0
 Root-Is-Purelib: true
 Tag: py3-none-any

sendparcel/flow.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from dataclasses import dataclass
-from typing import Any
+from typing import Any, cast
 
 import httpx
 
@@ -227,7 +227,10 @@ class ShipmentFlow:
         - ``AUTH_ERROR`` → re-raises provider auth error.
         """
         provider = self._get_provider(shipment)
-        outcome = await self._call_provider(provider.cancel_shipment(**kwargs))
+        outcome = cast(
+            "CancelOutcome",
+            await self._call_provider(provider.cancel_shipment(**kwargs)),
+        )
         if outcome.get("reason") == CancelReason.TRANSIENT_ERROR:
             raise CommunicationError(
                 outcome.get("detail") or "Cancel failed with transient error",
@@ -281,15 +284,18 @@ class ShipmentFlow:
             provider_class,
             provider_config,
         )
-        return await self._call_provider(
-            provider.search_points(
-                query=query,
-                near=near,
-                radius_m=radius_m,
-                point_type=point_type,
-                limit=limit,
-                **kwargs,
-            )
+        return cast(
+            "list[PickupPoint]",
+            await self._call_provider(
+                provider.search_points(
+                    query=query,
+                    near=near,
+                    radius_m=radius_m,
+                    point_type=point_type,
+                    limit=limit,
+                    **kwargs,
+                )
+            ),
         )
 
     def _get_provider(self, shipment: Shipment) -> BaseProvider:

sendparcel/providers/dummy.py

@@ -12,6 +12,8 @@ from sendparcel.provider import BaseProvider
 from sendparcel.types import (
     AddressInfo,
     CallbackContext,
+    CancelOutcome,
+    CancelReason,
     LabelInfo,
     ParcelInfo,
     ShipmentCreateResult,
@@ -78,6 +80,23 @@ class DummyProvider(BaseProvider):
             status=self.get_setting("status_override", self.shipment.status)
         )
 
-    async def cancel_shipment(self, **kwargs: Any) -> bool:
+    async def cancel_shipment(self, **kwargs: Any) -> CancelOutcome:
+        """Cancel with a configurable structured outcome.
+
+        Settings: ``cancel_success`` (bool, default True) and
+        ``cancel_reason`` (a :class:`CancelReason` value used when the
+        cancel is configured to fail; defaults to ``not_cancellable``).
+        """
         await self._simulate_latency()
-        return bool(self.get_setting("cancel_success", True))
+        if bool(self.get_setting("cancel_success", True)):
+            return CancelOutcome(
+                cancelled=True, reason=CancelReason.CANCELLED, retryable=False
+            )
+        reason = CancelReason(
+            self.get_setting("cancel_reason", CancelReason.NOT_CANCELLABLE)
+        )
+        return CancelOutcome(
+            cancelled=False,
+            reason=reason,
+            retryable=reason == CancelReason.TRANSIENT_ERROR,
+        )