etsy-python 1.1.9__tar.gz → 1.1.11__tar.gz

{etsy_python-1.1.9/etsy_python.egg-info → etsy_python-1.1.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: etsy-python
-Version: 1.1.9
+Version: 1.1.11
 Summary: Etsy API Client Library for Python
 Author: Amit Ray
 Author-email: mail@amitray.dev

{etsy_python-1.1.9 → etsy_python-1.1.11}/etsy_python/_version.py

@@ -1,3 +1,3 @@
 """Version information for etsy-python package."""
 
-__version__ = "1.1.9"
+__version__ = "1.1.11"

{etsy_python-1.1.9 → etsy_python-1.1.11}/etsy_python/v3/common/Utils.py

@@ -1,7 +1,30 @@
+import warnings
 from enum import Enum
 from typing import Any, Dict, List, Optional
 
 
+def warn_removed_legacy_param(operation_id: str) -> None:
+    """Warn that `legacy` was removed from an operation and is no longer sent.
+
+    Etsy dropped the `legacy` query parameter from the listing endpoints without
+    a deprecation period. The keyword argument is kept so existing callers don't
+    break, but the value is not forwarded. Note `legacy` is still valid on other
+    operations (receipts, transactions, getListingsByListingIds), which keep it.
+
+    Called whenever ``legacy`` is passed explicitly — including ``legacy=False``.
+    That is deliberate: ``legacy=False`` previously sent ``?legacy=false`` on the
+    wire, so silently dropping it is a request-shape change the caller should
+    know about, not just a no-op.
+    """
+    warnings.warn(
+        f"'legacy' was removed from {operation_id} by Etsy and is no longer "
+        "sent (any explicit value, including False, is discarded); it will be "
+        "dropped from this method in a future major version.",
+        DeprecationWarning,
+        stacklevel=3,
+    )
+
+
 def generate_get_uri(uri: str, params: Optional[Dict[str, Any]] = None) -> str:
     if not params:
         return uri

{etsy_python-1.1.9 → etsy_python-1.1.11}/etsy_python/v3/enums/Listing.py

@@ -85,6 +85,10 @@ class SortOrder(Enum):
 
 
 class Includes(Enum):
+    # SHIPPING and INVENTORY were removed from the includes enum on getListing
+    # and getListingsByListingIds, but remain valid on getListingsByShop, which
+    # shares this enum. They are kept for backward compatibility; removing them
+    # would break callers. May be revisited in the next major version.
     SHIPPING = "Shipping"
     IMAGES = "Images"
     SHOP = "Shop"

{etsy_python-1.1.9 → etsy_python-1.1.11}/etsy_python/v3/resources/Listing.py

@@ -2,6 +2,7 @@ import warnings
 from dataclasses import dataclass
 from typing import Optional, List, Dict, Any, Union
 
+from etsy_python.v3.common.Utils import warn_removed_legacy_param
 from etsy_python.v3.enums.Listing import Includes, State, SortOn, SortOrder
 from etsy_python.v3.exceptions.RequestException import RequestException
 from etsy_python.v3.models.Listing import (
@@ -25,10 +26,11 @@ class ListingResource:
         listing: CreateDraftListingRequest,
         legacy: Optional[bool] = None,
     ) -> Union[Response, RequestException]:
+        if legacy is not None:
+            warn_removed_legacy_param("createDraftListing")
         endpoint = f"/shops/{shop_id}/listings"
         return self.session.make_request(
-            endpoint, method=Method.POST, payload=listing,
-            query_params={"legacy": legacy},
+            endpoint, method=Method.POST, payload=listing
         )
 
     def get_listings_by_shop(
@@ -42,6 +44,8 @@ class ListingResource:
         includes: Optional[List[Includes]] = None,
         legacy: Optional[bool] = None,
     ) -> Union[Response, RequestException]:
+        if legacy is not None:
+            warn_removed_legacy_param("getListingsByShop")
         endpoint = f"/shops/{shop_id}/listings"
         query_params: Dict[str, Any] = {
             "state": state.value,
@@ -52,7 +56,6 @@ class ListingResource:
             "includes": ",".join(list(map(lambda inc: inc.value, includes)))
             if includes is not None
             else None,
-            "legacy": legacy,
         }
         return self.session.make_request(endpoint, query_params=query_params)
 
@@ -68,13 +71,14 @@ class ListingResource:
         legacy: Optional[bool] = None,
         allow_suggested_title: Optional[bool] = None,
     ) -> Union[Response, RequestException]:
+        if legacy is not None:
+            warn_removed_legacy_param("getListing")
         endpoint = f"/listings/{listing_id}"
         query_params: Dict[str, Any] = {
             "includes": ",".join(list(map(lambda inc: inc.value, includes)))
             if includes is not None
             else None,
             "language": language,
-            "legacy": legacy,
             "allow_suggested_title": allow_suggested_title,
         }
         return self.session.make_request(endpoint, query_params=query_params)
@@ -95,6 +99,8 @@ class ListingResource:
         buyer_country: Optional[str] = None,
         currency: Optional[str] = None,
     ) -> Union[Response, RequestException]:
+        if legacy is not None:
+            warn_removed_legacy_param("findAllListingsActive")
         endpoint = "/listings/active"
         query_params: Dict[str, Any] = {
             "limit": limit,
@@ -107,7 +113,6 @@ class ListingResource:
             "taxonomy_id": taxonomy_id,
             "shop_location": shop_location,
             "is_safe": is_safe,
-            "legacy": legacy,
             "buyer_country": buyer_country,
             "currency": currency,
         }
@@ -123,6 +128,8 @@ class ListingResource:
         keywords: Optional[str] = None,
         legacy: Optional[bool] = None,
     ) -> Union[Response, RequestException]:
+        if legacy is not None:
+            warn_removed_legacy_param("findAllActiveListingsByShop")
         endpoint = f"/shops/{shop_id}/listings/active"
         query_params: Dict[str, Any] = {
             "limit": limit,
@@ -130,7 +137,6 @@ class ListingResource:
             "sort_order": sort_order.value,
             "offset": offset,
             "keywords": keywords,
-            "legacy": legacy,
         }
         return self.session.make_request(endpoint, query_params=query_params)
 
@@ -168,6 +174,24 @@ class ListingResource:
         )
         return self.get_listings_by_listing_ids(listing_ids, includes, legacy)
 
+    def get_listings_inventory_by_listing_ids(
+        self, listing_ids: List[int]
+    ) -> Union[Response, RequestException]:
+        endpoint = "/listings/batch/inventory"
+        query_params: Dict[str, Any] = {
+            "listing_ids": ",".join(list(map(str, listing_ids))),
+        }
+        return self.session.make_request(endpoint, query_params=query_params)
+
+    def get_listings_shipping_by_listing_ids(
+        self, listing_ids: List[int]
+    ) -> Union[Response, RequestException]:
+        endpoint = "/listings/batch/shipping"
+        query_params: Dict[str, Any] = {
+            "listing_ids": ",".join(list(map(str, listing_ids))),
+        }
+        return self.session.make_request(endpoint, query_params=query_params)
+
     def get_featured_listings_by_shop(
         self, shop_id: int, limit: int = 25, offset: int = 0,
         legacy: Optional[bool] = None,
@@ -210,10 +234,11 @@ class ListingResource:
         self, shop_id: int, listing_id: int, listing: UpdateListingRequest,
         legacy: Optional[bool] = None,
     ) -> Union[Response, RequestException]:
+        if legacy is not None:
+            warn_removed_legacy_param("updateListing")
         endpoint = f"/shops/{shop_id}/listings/{listing_id}"
         return self.session.make_request(
-            endpoint, method=Method.PATCH, payload=listing,
-            query_params={"legacy": legacy},
+            endpoint, method=Method.PATCH, payload=listing
         )
 
     def get_listings_by_shop_receipt(

{etsy_python-1.1.9 → etsy_python-1.1.11}/etsy_python/v3/resources/ListingInventory.py

@@ -1,6 +1,7 @@
 from dataclasses import dataclass
 from typing import Optional, Dict, Any, Union
 
+from etsy_python.v3.common.Utils import warn_removed_legacy_param
 from etsy_python.v3.exceptions.RequestException import RequestException
 from etsy_python.v3.enums.Listing import InventoryIncludes
 from etsy_python.v3.enums.ListingInventory import MaxVariationsSupported
@@ -21,11 +22,12 @@ class ListingInventoryResource:
         includes: Optional[InventoryIncludes] = None,
         legacy: Optional[bool] = None,
     ) -> Union[Response, RequestException]:
+        if legacy is not None:
+            warn_removed_legacy_param("getListingInventory")
         endpoint = f"/listings/{listing_id}/inventory"
         query_params: Dict[str, Any] = {
             "show_deleted": show_deleted,
             "includes": includes.value if includes is not None else None,
-            "legacy": legacy,
         }
         return self.session.make_request(endpoint, query_params=query_params)
 
@@ -34,9 +36,10 @@ class ListingInventoryResource:
         legacy: Optional[bool] = None,
         max_variations_supported: Optional[MaxVariationsSupported] = None,
     ) -> Union[Response, RequestException]:
+        if legacy is not None:
+            warn_removed_legacy_param("updateListingInventory")
         endpoint = f"/listings/{listing_id}/inventory"
         query_params: Dict[str, Any] = {
-            "legacy": legacy,
             "max_variations_supported": max_variations_supported.value
             if max_variations_supported is not None
             else None,

{etsy_python-1.1.9 → etsy_python-1.1.11/etsy_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: etsy-python
-Version: 1.1.9
+Version: 1.1.11
 Summary: Etsy API Client Library for Python
 Author: Amit Ray
 Author-email: mail@amitray.dev