etsy-python 1.1.8__tar.gz → 1.1.10__tar.gz

{etsy_python-1.1.8/etsy_python.egg-info → etsy_python-1.1.10}/PKG-INFO

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

{etsy_python-1.1.8 → etsy_python-1.1.10}/etsy_python/_version.py

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

{etsy_python-1.1.8 → etsy_python-1.1.10}/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.8 → etsy_python-1.1.10}/etsy_python/v3/models/Listing.py

@@ -14,6 +14,42 @@ from etsy_python.v3.models.Request import Request
 from etsy_python.v3.models.FileRequest import FileRequest
 
 
+_PERSONALIZATION_DEPRECATION_MSG = (
+    "is_personalizable, personalization_is_required, "
+    "personalization_char_count_max, and personalization_instructions "
+    "are deprecated by the Etsy API and scheduled for removal. "
+    "Use the personalization endpoint (update_listing_personalization) "
+    "instead. See "
+    "https://developers.etsy.com/documentation/tutorials/personalization-migration "
+    "for migration details."
+)
+
+
+def _warn_if_personalization_used(
+    is_personalizable: Optional[bool],
+    personalization_is_required: Optional[bool],
+    personalization_char_count_max: Optional[int],
+    personalization_instructions: Optional[str],
+) -> None:
+    """Emit DeprecationWarning when a deprecated personalization field is actively set.
+
+    Falsy values (False, 0, empty string, None) match the API's documented
+    defaults and remain no-ops after the fields are removed, so they do not
+    trigger the warning.
+    """
+    if any([
+        is_personalizable,
+        personalization_is_required,
+        personalization_char_count_max,
+        personalization_instructions,
+    ]):
+        warnings.warn(
+            _PERSONALIZATION_DEPRECATION_MSG,
+            DeprecationWarning,
+            stacklevel=3,
+        )
+
+
 class CreateDraftListingRequest(Request):
     nullable = [
         "shipping_profile_id",
@@ -105,20 +141,12 @@ class CreateDraftListingRequest(Request):
         self.personalization_is_required = personalization_is_required
         self.personalization_char_count_max = personalization_char_count_max
         self.personalization_instructions = personalization_instructions
-        if any(v is not None for v in [
-            personalization_is_required, personalization_char_count_max,
+        _warn_if_personalization_used(
+            is_personalizable,
+            personalization_is_required,
+            personalization_char_count_max,
             personalization_instructions,
-        ]):
-            warnings.warn(
-                "personalization_is_required, personalization_char_count_max, and "
-                "personalization_instructions are deprecated by the Etsy API and "
-                "scheduled for removal. Use the personalization endpoint "
-                "(update_listing_personalization) instead. See "
-                "https://developers.etsy.com/documentation/tutorials/personalization-migration "
-                "for migration details.",
-                DeprecationWarning,
-                stacklevel=2,
-            )
+        )
         self.production_partner_ids = production_partner_ids
         self.image_ids = image_ids
         self.is_supply = is_supply
@@ -208,20 +236,12 @@ class UpdateListingRequest(Request):
         self.personalization_is_required = personalization_is_required
         self.personalization_char_count_max = personalization_char_count_max
         self.personalization_instructions = personalization_instructions
-        if any(v is not None for v in [
-            personalization_is_required, personalization_char_count_max,
+        _warn_if_personalization_used(
+            is_personalizable,
+            personalization_is_required,
+            personalization_char_count_max,
             personalization_instructions,
-        ]):
-            warnings.warn(
-                "personalization_is_required, personalization_char_count_max, and "
-                "personalization_instructions are deprecated by the Etsy API and "
-                "scheduled for removal. Use the personalization endpoint "
-                "(update_listing_personalization) instead. See "
-                "https://developers.etsy.com/documentation/tutorials/personalization-migration "
-                "for migration details.",
-                DeprecationWarning,
-                stacklevel=2,
-            )
+        )
         self.state = state
         self.is_supply = is_supply
         self.production_partner_ids = production_partner_ids

{etsy_python-1.1.8 → etsy_python-1.1.10}/etsy_python/v3/resources/Listing.py

@@ -168,6 +168,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,

{etsy_python-1.1.8 → etsy_python-1.1.10/etsy_python.egg-info}/PKG-INFO

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