python-amazon-sp-api 2.0.10__tar.gz → 2.0.12__tar.gz

{python_amazon_sp_api-2.0.10/python_amazon_sp_api.egg-info → python_amazon_sp_api-2.0.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-sp-api
-Version: 2.0.10
+Version: 2.0.12
 Summary: Python wrapper for the Amazon Selling-Partner API
 Home-page: https://github.com/saleweaver/python-amazon-sp-api
 Author: Michael Primke

{python_amazon_sp_api-2.0.10 → python_amazon_sp_api-2.0.12/python_amazon_sp_api.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-amazon-sp-api
-Version: 2.0.10
+Version: 2.0.12
 Summary: Python wrapper for the Amazon Selling-Partner API
 Home-page: https://github.com/saleweaver/python-amazon-sp-api
 Author: Michael Primke

{python_amazon_sp_api-2.0.10 → python_amazon_sp_api-2.0.12}/python_amazon_sp_api.egg-info/SOURCES.txt

@@ -60,6 +60,7 @@ sp_api/api/notifications/notifications.py
 sp_api/api/orders/__init__.py
 sp_api/api/orders/orders.py
 sp_api/api/orders/orders_2026_01_01.py
+sp_api/api/orders/orders_v0.py
 sp_api/api/product_fees/__init__.py
 sp_api/api/product_fees/product_fees.py
 sp_api/api/product_type_definitions/__init__.py
@@ -159,6 +160,7 @@ sp_api/asyncio/api/notifications/notifications.py
 sp_api/asyncio/api/orders/__init__.py
 sp_api/asyncio/api/orders/orders.py
 sp_api/asyncio/api/orders/orders_2026_01_01.py
+sp_api/asyncio/api/orders/orders_v0.py
 sp_api/asyncio/api/overrides/__init__.py
 sp_api/asyncio/api/product_fees/__init__.py
 sp_api/asyncio/api/product_fees/product_fees.py

python_amazon_sp_api-2.0.12/sp_api/__version__.py

@@ -0,0 +1 @@
+__version__ = '2.0.12'

{python_amazon_sp_api-2.0.10/sp_api/asyncio → python_amazon_sp_api-2.0.12/sp_api}/api/__init__.py

@@ -2,6 +2,7 @@ from .finances.finances import Finances, FinancesVersion
 from .notifications.notifications import Notifications
 from .orders.orders import Orders, OrdersVersion
 from .orders.orders_2026_01_01 import OrdersV20260101
+from .orders.orders_v0 import OrdersV0
 from .product_fees.product_fees import ProductFees
 from .sellers.sellers import Sellers
 from .reports.reports import Reports
@@ -106,6 +107,7 @@ __all__ = [
     "Reports",
     "Orders",
     "OrdersVersion",
+    "OrdersV0",
     "OrdersV20260101",
     "Sellers",
     "Notifications",

python_amazon_sp_api-2.0.12/sp_api/api/orders/orders.py

@@ -0,0 +1,150 @@
+from __future__ import annotations
+
+import enum
+from typing import Any, Literal, TYPE_CHECKING, overload
+
+from sp_api.base import ApiResponse, Client, Marketplaces, deprecated, fill_query_params, sp_endpoint
+from sp_api.util import normalize_csv_param
+
+from .orders_2026_01_01 import OrdersV20260101
+from .orders_v0 import OrdersV0
+
+class OrdersVersion(str, enum.Enum):
+    V0 = "v0"  # legacy
+    V_2026_01_01 = "2026-01-01"
+    LATEST = "2026-01-01"
+
+
+class _VersionedClientMeta(type):
+    """Metaclass that dispatches construction to a version-specific implementation.
+
+    This keeps the call-site ergonomic (`Orders(version=...)`) while allowing a single
+    place to implement the dispatch logic.
+
+    Subclasses should define:
+      - `_VERSION_MAP`: mapping of normalized version strings to implementation classes
+      - `_VERSION_ALIASES` (optional): mapping of alias strings to normalized versions
+
+    If no version is provided, the default version is used.
+    """
+
+    def __call__(cls, *args: Any, **kwargs: Any):
+        version = kwargs.pop("version", None)
+
+        # Only dispatch for the public front class itself.
+        if cls is Orders:
+            # Backwards-compatible default: if no version is provided, return the
+            # oldest supported implementation.
+            v_raw = version if version is not None else getattr(cls, "_DEFAULT_VERSION", None)
+            if v_raw is None:
+                return super().__call__(*args, **kwargs)
+
+            v_raw = getattr(v_raw, "value", v_raw)
+            v = str(v_raw)
+            aliases: dict[str, str] = getattr(cls, "_VERSION_ALIASES", {})
+            v_norm = aliases.get(v, v)
+
+            impl_map: dict[str, type] = getattr(cls, "_VERSION_MAP", {})
+            impl = impl_map.get(v_norm)
+            if impl is not None:
+                return impl(*args, **kwargs)
+
+            supported = ", ".join(sorted(impl_map.keys()))
+            raise ValueError(f"Unsupported version {v!r}. Supported: {supported}")
+
+        return super().__call__(*args, **kwargs)
+
+
+if TYPE_CHECKING:
+
+    class _OrdersMeta(_VersionedClientMeta):
+        @overload
+        def __call__(
+            self,
+            *args: Any,
+            version: Literal[OrdersVersion.V_2026_01_01, OrdersVersion.LATEST, "2026-01-01"],
+            **kwargs: Any,
+        ) -> OrdersV20260101: ...
+
+        @overload
+        def __call__(
+            self,
+            *args: Any,
+            version: Literal[OrdersVersion.V0, "v0"],
+            **kwargs: Any,
+        ) -> OrdersV0: ...
+
+        @overload
+        def __call__(
+            self,
+            *args: Any,
+            version: None = None,
+            **kwargs: Any,
+        ) -> OrdersV0: ...
+
+        @overload
+        def __call__(
+            self,
+            *args: Any,
+            version: str | OrdersVersion,
+            **kwargs: Any,
+        ) -> Client: ...
+
+
+else:
+    _OrdersMeta = _VersionedClientMeta
+
+class Orders(Client, metaclass=_OrdersMeta):
+    """Orders API client.
+
+    This class dispatches to a versioned Orders API client.
+
+    If you do not pass a version, the constructor returns the oldest supported implementation ("v0").
+
+    :link: https://github.com/amzn/selling-partner-api-docs/tree/main/references/orders-api
+    """
+
+    if TYPE_CHECKING:
+        @overload
+        def __new__(
+            cls,
+            *args: Any,
+            version: Literal[OrdersVersion.V_2026_01_01, OrdersVersion.LATEST, "2026-01-01"],
+            **kwargs: Any,
+        ) -> OrdersV20260101: ...
+
+        @overload
+        def __new__(
+            cls,
+            *args: Any,
+            version: Literal[OrdersVersion.V0, "v0"],
+            **kwargs: Any,
+        ) -> OrdersV0: ...
+
+        @overload
+        def __new__(
+            cls,
+            *args: Any,
+            version: None = None,
+            **kwargs: Any,
+        ) -> OrdersV0: ...
+
+        @overload
+        def __new__(
+            cls,
+            *args: Any,
+            version: str | OrdersVersion,
+            **kwargs: Any,
+        ) -> Client: ...
+
+    _DEFAULT_VERSION = "v0"
+
+    _VERSION_MAP = {
+        "v0": OrdersV0,
+        "2026-01-01": OrdersV20260101,
+    }
+
+    _VERSION_ALIASES = {
+        "v0": "v0",
+        "2026-01-01": "2026-01-01",
+    }

{python_amazon_sp_api-2.0.10 → python_amazon_sp_api-2.0.12}/sp_api/api/orders/orders_2026_01_01.py

@@ -32,7 +32,7 @@ class OrdersV20260101(Client):
         normalize_csv_param(kwargs, "marketplaceIds")
         normalize_csv_param(kwargs, "fulfilledBy")
         normalize_csv_param(kwargs, "includedData")
-
+        print(kwargs)
         return self._request(kwargs.pop("path"), params={**kwargs})
 
     @sp_endpoint("/orders/2026-01-01/orders/{}")

python_amazon_sp_api-2.0.10/sp_api/api/orders/orders.py → python_amazon_sp_api-2.0.12/sp_api/api/orders/orders_v0.py

@@ -1,60 +1,8 @@
-from __future__ import annotations
-
-import enum
-from typing import Any, Literal, overload
-
-from sp_api.base import ApiResponse, Client, Marketplaces, deprecated, fill_query_params, sp_endpoint
+from sp_api.base import Client, sp_endpoint, fill_query_params, ApiResponse
 from sp_api.util import normalize_csv_param
 
-from .orders_2026_01_01 import OrdersV20260101
-
-
-class OrdersVersion(str, enum.Enum):
-    V0 = "v0"  # legacy
-    V_2026_01_01 = "2026-01-01"
-    LATEST = "2026-01-01"
-
-
-class Orders(Client):
-    """Orders API client.
-
-    This class implements the legacy Orders API **v0**.
-
-    If you pass version "2026-01-01" (or :class:`OrdersVersion.V_2026_01_01`)
-    to the constructor, :meth:`__new__` returns an instance of
-    :class:`~sp_api.api.orders.orders_2026_01_01.OrdersV20260101` instead.
-
-    :link: https://github.com/amzn/selling-partner-api-docs/tree/main/references/orders-api
-    """
-
-    @overload
-    def __new__(
-        cls,
-        *args: Any,
-        version: Literal[OrdersVersion.V_2026_01_01, "2026-01-01"],
-        **kwargs: Any,
-    ) -> OrdersV20260101: ...
-
-    @overload
-    def __new__(
-        cls,
-        *args: Any,
-        version: str | OrdersVersion | None = None,
-        **kwargs: Any,
-    ) -> "Orders": ...
-
-    def __new__(
-        cls,
-        *args: Any,
-        version: str | OrdersVersion | None = None,
-        **kwargs: Any,
-    ):
-        if cls is Orders:
-            v = version if version is not None else kwargs.get("version")
-            if v in (OrdersVersion.V_2026_01_01, OrdersVersion.LATEST, "2026-01-01"):
-                kwargs.pop("version", None)
-                return OrdersV20260101(*args, **kwargs)
-        return super().__new__(cls)
+
+class OrdersV0(Client):
 
     @sp_endpoint("/orders/v0/orders")
     def get_orders(self, **kwargs) -> ApiResponse:

{python_amazon_sp_api-2.0.10/sp_api → python_amazon_sp_api-2.0.12/sp_api/asyncio}/api/__init__.py

@@ -2,6 +2,7 @@ from .finances.finances import Finances, FinancesVersion
 from .notifications.notifications import Notifications
 from .orders.orders import Orders, OrdersVersion
 from .orders.orders_2026_01_01 import OrdersV20260101
+from .orders.orders_v0 import OrdersV0
 from .product_fees.product_fees import ProductFees
 from .sellers.sellers import Sellers
 from .reports.reports import Reports
@@ -106,6 +107,7 @@ __all__ = [
     "Reports",
     "Orders",
     "OrdersVersion",
+    "OrdersV0",
     "OrdersV20260101",
     "Sellers",
     "Notifications",

python_amazon_sp_api-2.0.12/sp_api/asyncio/api/orders/orders.py

@@ -0,0 +1,152 @@
+from __future__ import annotations
+
+import enum
+from typing import Any, Literal, TYPE_CHECKING, overload
+
+from sp_api.asyncio.base import AsyncBaseClient
+from sp_api.base import ApiResponse, Marketplaces, deprecated, fill_query_params, sp_endpoint
+from sp_api.util import normalize_csv_param
+
+from .orders_2026_01_01 import OrdersV20260101
+from .orders_v0 import OrdersV0
+
+
+class OrdersVersion(str, enum.Enum):
+    V0 = "v0"  # legacy
+    V_2026_01_01 = "2026-01-01"
+    LATEST = "2026-01-01"
+
+
+class _VersionedClientMeta(type):
+    """Metaclass that dispatches construction to a version-specific implementation.
+
+    This keeps the call-site ergonomic (`Orders(version=...)`) while allowing a single
+    place to implement the dispatch logic.
+
+    Subclasses should define:
+      - `_VERSION_MAP`: mapping of normalized version strings to implementation classes
+      - `_VERSION_ALIASES` (optional): mapping of alias strings to normalized versions
+
+    If no version is provided, the default version is used.
+    """
+
+    def __call__(cls, *args: Any, **kwargs: Any):
+        version = kwargs.pop("version", None)
+
+        # Only dispatch for the public front class itself.
+        if cls is Orders:
+            # Backwards-compatible default: if no version is provided, return the
+            # oldest supported implementation.
+            v_raw = version if version is not None else getattr(cls, "_DEFAULT_VERSION", None)
+            if v_raw is None:
+                return super().__call__(*args, **kwargs)
+
+            v_raw = getattr(v_raw, "value", v_raw)
+            v = str(v_raw)
+            aliases: dict[str, str] = getattr(cls, "_VERSION_ALIASES", {})
+            v_norm = aliases.get(v, v)
+
+            impl_map: dict[str, type] = getattr(cls, "_VERSION_MAP", {})
+            impl = impl_map.get(v_norm)
+            if impl is not None:
+                return impl(*args, **kwargs)
+
+            supported = ", ".join(sorted(impl_map.keys()))
+            raise ValueError(f"Unsupported version {v!r}. Supported: {supported}")
+
+        return super().__call__(*args, **kwargs)
+
+
+if TYPE_CHECKING:
+
+    class _OrdersMeta(_VersionedClientMeta):
+        @overload
+        def __call__(
+            self,
+            *args: Any,
+            version: Literal[OrdersVersion.V_2026_01_01, OrdersVersion.LATEST, "2026-01-01"],
+            **kwargs: Any,
+        ) -> OrdersV20260101: ...
+
+        @overload
+        def __call__(
+            self,
+            *args: Any,
+            version: Literal[OrdersVersion.V0, "v0"],
+            **kwargs: Any,
+        ) -> OrdersV0: ...
+
+        @overload
+        def __call__(
+            self,
+            *args: Any,
+            version: None = None,
+            **kwargs: Any,
+        ) -> OrdersV0: ...
+
+        @overload
+        def __call__(
+            self,
+            *args: Any,
+            version: str | OrdersVersion,
+            **kwargs: Any,
+        ) -> AsyncBaseClient: ...
+
+
+else:
+    _OrdersMeta = _VersionedClientMeta
+
+class Orders(AsyncBaseClient, metaclass=_OrdersMeta):
+    """Orders API client.
+
+    This class dispatches to a versioned Orders API client.
+
+    If you do not pass a version, the constructor returns the oldest supported implementation ("v0").
+
+    :link: https://github.com/amzn/selling-partner-api-docs/tree/main/references/orders-api
+    """
+
+    if TYPE_CHECKING:
+        @overload
+        def __new__(
+            cls,
+            *args: Any,
+            version: Literal[OrdersVersion.V_2026_01_01, OrdersVersion.LATEST, "2026-01-01"],
+            **kwargs: Any,
+        ) -> OrdersV20260101: ...
+
+        @overload
+        def __new__(
+            cls,
+            *args: Any,
+            version: Literal[OrdersVersion.V0, "v0"],
+            **kwargs: Any,
+        ) -> OrdersV0: ...
+
+        @overload
+        def __new__(
+            cls,
+            *args: Any,
+            version: None = None,
+            **kwargs: Any,
+        ) -> OrdersV0: ...
+
+        @overload
+        def __new__(
+            cls,
+            *args: Any,
+            version: str | OrdersVersion,
+            **kwargs: Any,
+        ) -> AsyncBaseClient: ...
+
+    _DEFAULT_VERSION = "v0"
+
+    _VERSION_MAP = {
+        "v0": OrdersV0,
+        "2026-01-01": OrdersV20260101,
+    }
+
+    _VERSION_ALIASES = {
+        "v0": "v0",
+        "2026-01-01": "2026-01-01",
+    }

python_amazon_sp_api-2.0.12/sp_api/asyncio/api/orders/orders_2026_01_01.py

@@ -0,0 +1,116 @@
+from __future__ import annotations
+
+from typing import Any
+
+from sp_api.asyncio.base import AsyncBaseClient
+from sp_api.base import ApiResponse, fill_query_params, sp_endpoint
+from sp_api.util import normalize_csv_param
+
+
+class OrdersV20260101(AsyncBaseClient):
+    """Orders API (version 2026-01-01) - async client.
+
+    This is a newer Orders API version that uses different endpoints/parameters
+    than the legacy v0 Orders API implemented by :class:`sp_api.asyncio.api.orders.orders.Orders`.
+
+    Model source:
+    https://github.com/amzn/selling-partner-api-models/blob/main/models/orders-api-model/orders_2026-01-01.json
+    """
+
+    @sp_endpoint("/orders/2026-01-01/orders")
+    async def search_orders(self, **kwargs: Any) -> ApiResponse:
+        """
+        search_orders(self, **kwargs) -> ApiResponse
+        Returns orders that are created or updated during the time period that you specify.
+        You can filter the response for specific types of orders.
+
+        **Usage Plan:**
+
+        ======================================  =====================
+        Rate (requests per second)               Burst
+        ======================================  =====================
+        See x-amzn-ratelimit-limit response      See Amazon docs
+        ======================================  =====================
+
+        Note:
+            The SP-API returns an `x-amzn-ratelimit-limit` (or similar) response header indicating the rate limit
+            applied to the request. Rate and burst can vary by seller/account and by any Amazon-granted overrides.
+
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+
+        Examples:
+            literal blocks::
+
+                OrdersV20260101().search_orders(
+                    createdAfter="2026-01-01T00:00:00Z",
+                    marketplaceIds=["A1PA6795UKMFR9"]
+                )
+
+        Args:
+            key createdAfter: str
+            key createdBefore: str
+            key lastUpdatedAfter: str
+            key lastUpdatedBefore: str
+            key fulfillmentStatuses: [str] | str
+            key marketplaceIds: [str] | str
+            key fulfilledBy: [str] | str
+            key includedData: [str] | str
+            key paginationToken: str
+            key maxResultsPerPage: int
+
+        Returns:
+            ApiResponse:
+
+
+        """
+
+        normalize_csv_param(kwargs, "fulfillmentStatuses")
+        normalize_csv_param(kwargs, "marketplaceIds")
+        normalize_csv_param(kwargs, "fulfilledBy")
+
+        return await self._request(kwargs.pop("path"), params={**kwargs})
+
+    @sp_endpoint("/orders/2026-01-01/orders/{}")
+    async def get_order(self, order_id: str, **kwargs: Any) -> ApiResponse:
+        """
+        get_order(self, order_id: str, **kwargs) -> ApiResponse
+        Returns the order that you specify.
+
+        **Usage Plan:**
+
+        ======================================  =====================
+        Rate (requests per second)               Burst
+        ======================================  =====================
+        See x-amzn-ratelimit-limit response      See Amazon docs
+        ======================================  =====================
+
+        Note:
+            The SP-API returns an `x-amzn-ratelimit-limit` (or similar) response header indicating the rate limit
+            applied to the request. Rate and burst can vary by seller/account and by any Amazon-granted overrides.
+
+        For more information, see "Usage Plans and Rate Limits" in the Selling Partner API documentation.
+
+        Examples:
+            literal blocks::
+
+                OrdersV20260101().get_order(
+                    "306-9860906-6213927",
+                    includedData=["orderItems"]
+                )
+
+        Args:
+            order_id: str
+            key includedData: [str] | str
+
+        Returns:
+            ApiResponse:
+
+
+        """
+
+        normalize_csv_param(kwargs, "includedData")
+        return await self._request(
+            fill_query_params(kwargs.pop("path"), order_id),
+            params={**kwargs},
+            add_marketplace=False,
+        )

python_amazon_sp_api-2.0.10/sp_api/asyncio/api/orders/orders.py → python_amazon_sp_api-2.0.12/sp_api/asyncio/api/orders/orders_v0.py

@@ -1,61 +1,10 @@
-from __future__ import annotations
-
-import enum
-from typing import Any, Literal, overload
-
 from sp_api.asyncio.base import AsyncBaseClient
-from sp_api.base import ApiResponse, deprecated, fill_query_params, sp_endpoint
+from sp_api.base import sp_endpoint, fill_query_params, ApiResponse
 from sp_api.util import normalize_csv_param
 
-from .orders_2026_01_01 import OrdersV20260101
-
-
-class OrdersVersion(str, enum.Enum):
-    V0 = "v0"  # legacy
-    V_2026_01_01 = "2026-01-01"
-    LATEST = "2026-01-01"
-
-
-class Orders(AsyncBaseClient):
-    """Orders API client (async).
-
-    This class implements the legacy Orders API **v0**.
-
-    If you pass version "2026-01-01" (or :class:`OrdersVersion.V_2026_01_01`)
-    to the constructor, :meth:`__new__` returns an instance of
-    :class:`~sp_api.asyncio.api.orders.orders_2026_01_01.OrdersV20260101` instead.
-
-    :link: https://github.com/amzn/selling-partner-api-docs/tree/main/references/orders-api
-    """
-
-    @overload
-    def __new__(
-        cls,
-        *args: Any,
-        version: Literal[OrdersVersion.V_2026_01_01, "2026-01-01"],
-        **kwargs: Any,
-    ) -> OrdersV20260101: ...
-
-    @overload
-    def __new__(
-        cls,
-        *args: Any,
-        version: str | OrdersVersion | None = None,
-        **kwargs: Any,
-    ) -> "Orders": ...
-
-    def __new__(
-        cls,
-        *args: Any,
-        version: str | OrdersVersion | None = None,
-        **kwargs: Any,
-    ):
-        if cls is Orders:
-            v = version if version is not None else kwargs.get("version")
-            if v in (OrdersVersion.V_2026_01_01, OrdersVersion.LATEST, "2026-01-01"):
-                kwargs.pop("version", None)
-                return OrdersV20260101(*args, **kwargs)
-        return super().__new__(cls)
+
+
+class OrdersV0(AsyncBaseClient):
 
     @sp_endpoint("/orders/v0/orders")
     async def get_orders(self, **kwargs) -> ApiResponse:

python_amazon_sp_api-2.0.10/sp_api/__version__.py

@@ -1 +0,0 @@
-__version__ = '2.0.10'

python_amazon_sp_api-2.0.10/sp_api/asyncio/api/orders/orders_2026_01_01.py

@@ -1,40 +0,0 @@
-from __future__ import annotations
-
-from typing import Any
-
-from sp_api.asyncio.base import AsyncBaseClient
-from sp_api.base import ApiResponse, fill_query_params, sp_endpoint
-from sp_api.util import normalize_csv_param
-
-
-class OrdersV20260101(AsyncBaseClient):
-    """Orders API (version 2026-01-01) - async client.
-
-    This is a newer Orders API version that uses different endpoints/parameters
-    than the legacy v0 Orders API implemented by :class:`sp_api.asyncio.api.orders.orders.Orders`.
-
-    Model source:
-    https://github.com/amzn/selling-partner-api-models/blob/main/models/orders-api-model/orders_2026-01-01.json
-    """
-
-    @sp_endpoint("/orders/2026-01-01/orders")
-    async def search_orders(self, **kwargs: Any) -> ApiResponse:
-        """Search orders (async)."""
-
-        normalize_csv_param(kwargs, "fulfillmentStatuses")
-        normalize_csv_param(kwargs, "marketplaceIds")
-        normalize_csv_param(kwargs, "fulfilledBy")
-        normalize_csv_param(kwargs, "includedData")
-
-        return await self._request(kwargs.pop("path"), params={**kwargs})
-
-    @sp_endpoint("/orders/2026-01-01/orders/{}")
-    async def get_order(self, order_id: str, **kwargs: Any) -> ApiResponse:
-        """Get order by orderId (async)."""
-
-        normalize_csv_param(kwargs, "includedData")
-        return await self._request(
-            fill_query_params(kwargs.pop("path"), order_id),
-            params={**kwargs},
-            add_marketplace=False,
-        )