etsy-python 1.1.13__tar.gz → 1.2.0__tar.gz

{etsy_python-1.1.13/etsy_python.egg-info → etsy_python-1.2.0}/PKG-INFO

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

{etsy_python-1.1.13 → etsy_python-1.2.0}/etsy_python/_version.py

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

{etsy_python-1.1.13 → etsy_python-1.2.0}/etsy_python/v3/enums/ListingInventory.py

@@ -1,10 +1,6 @@
 from enum import Enum
 
 
-class Includes(Enum):
-    LISTING = "listing"
-
-
 class MaxVariationsSupported(Enum):
     TWO = "2"
     THREE = "3"

{etsy_python-1.1.13 → etsy_python-1.2.0}/etsy_python/v3/models/Listing.py

@@ -17,7 +17,8 @@ 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. "
+    "were removed from createDraftListing and updateListing by the Etsy API "
+    "and are no longer sent. "
     "Use the personalization endpoint (update_listing_personalization) "
     "instead. See "
     "https://developers.etsy.com/documentation/tutorials/personalization-migration "
@@ -30,12 +31,18 @@ def _warn_if_personalization_used(
     personalization_is_required: Optional[bool],
     personalization_char_count_max: Optional[int],
     personalization_instructions: Optional[str],
+    stacklevel: int = 4,
 ) -> None:
-    """Emit DeprecationWarning when a deprecated personalization field is actively set.
+    """Emit DeprecationWarning when a removed 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.
+    defaults and were no-ops even before the fields were removed, so they do
+    not trigger the warning.
+
+    ``stacklevel`` counts the frames back to the caller. It defaults to the
+    constructor path (this function <- ``_store_personalization`` <- model
+    ``__init__`` <- caller); the property setters pass 3, being one frame
+    shallower.
     """
     if any([
         is_personalizable,
@@ -46,11 +53,81 @@ def _warn_if_personalization_used(
         warnings.warn(
             _PERSONALIZATION_DEPRECATION_MSG,
             DeprecationWarning,
-            stacklevel=3,
+            stacklevel=stacklevel,
         )
 
 
-class CreateDraftListingRequest(Request):
+class _PersonalizationFieldsMixin:
+    """Accessors for the personalization fields Etsy removed from listings.
+
+    Etsy dropped these four fields from the createDraftListing and
+    updateListing request bodies (2026-09 spec). The constructor keyword
+    arguments are kept so existing callers don't break, but the values are
+    stored under underscore-prefixed names, which ``todict`` excludes from
+    serialization -- so they are never sent on the wire.
+
+    The properties below keep both attribute reads and writes working. A write
+    stores the value and warns, exactly like passing the keyword argument: it
+    never reaches the API either way. Remove the keyword arguments and this
+    mixin in the next major version.
+    """
+
+    @property
+    def is_personalizable(self) -> Optional[bool]:
+        return self._is_personalizable
+
+    @is_personalizable.setter
+    def is_personalizable(self, value: Optional[bool]) -> None:
+        self._is_personalizable = value
+        _warn_if_personalization_used(value, None, None, None, stacklevel=3)
+
+    @property
+    def personalization_is_required(self) -> Optional[bool]:
+        return self._personalization_is_required
+
+    @personalization_is_required.setter
+    def personalization_is_required(self, value: Optional[bool]) -> None:
+        self._personalization_is_required = value
+        _warn_if_personalization_used(None, value, None, None, stacklevel=3)
+
+    @property
+    def personalization_char_count_max(self) -> Optional[int]:
+        return self._personalization_char_count_max
+
+    @personalization_char_count_max.setter
+    def personalization_char_count_max(self, value: Optional[int]) -> None:
+        self._personalization_char_count_max = value
+        _warn_if_personalization_used(None, None, value, None, stacklevel=3)
+
+    @property
+    def personalization_instructions(self) -> Optional[str]:
+        return self._personalization_instructions
+
+    @personalization_instructions.setter
+    def personalization_instructions(self, value: Optional[str]) -> None:
+        self._personalization_instructions = value
+        _warn_if_personalization_used(None, None, None, value, stacklevel=3)
+
+    def _store_personalization(
+        self,
+        is_personalizable: Optional[bool],
+        personalization_is_required: Optional[bool],
+        personalization_char_count_max: Optional[int],
+        personalization_instructions: Optional[str],
+    ) -> None:
+        self._is_personalizable = is_personalizable
+        self._personalization_is_required = personalization_is_required
+        self._personalization_char_count_max = personalization_char_count_max
+        self._personalization_instructions = personalization_instructions
+        _warn_if_personalization_used(
+            is_personalizable,
+            personalization_is_required,
+            personalization_char_count_max,
+            personalization_instructions,
+        )
+
+
+class CreateDraftListingRequest(_PersonalizationFieldsMixin, Request):
     nullable = [
         "shipping_profile_id",
         "return_policy_id",
@@ -137,11 +214,7 @@ class CreateDraftListingRequest(Request):
         self.item_height = item_height
         self.item_weight_unit = item_weight_unit
         self.item_dimensions_unit = item_dimensions_unit
-        self.is_personalizable = is_personalizable
-        self.personalization_is_required = personalization_is_required
-        self.personalization_char_count_max = personalization_char_count_max
-        self.personalization_instructions = personalization_instructions
-        _warn_if_personalization_used(
+        self._store_personalization(
             is_personalizable,
             personalization_is_required,
             personalization_char_count_max,
@@ -161,7 +234,7 @@ class CreateDraftListingRequest(Request):
         )
 
 
-class UpdateListingRequest(Request):
+class UpdateListingRequest(_PersonalizationFieldsMixin, Request):
     nullable: List[str] = [
         "materials",
         "shipping_profile_id",
@@ -232,11 +305,7 @@ class UpdateListingRequest(Request):
         self.who_made = who_made
         self.when_made = when_made
         self.featured_rank = featured_rank
-        self.is_personalizable = is_personalizable
-        self.personalization_is_required = personalization_is_required
-        self.personalization_char_count_max = personalization_char_count_max
-        self.personalization_instructions = personalization_instructions
-        _warn_if_personalization_used(
+        self._store_personalization(
             is_personalizable,
             personalization_is_required,
             personalization_char_count_max,

{etsy_python-1.1.13 → etsy_python-1.2.0/etsy_python.egg-info}/PKG-INFO

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