etsy-python 1.1.14__tar.gz → 1.2.1__tar.gz

{etsy_python-1.1.14/etsy_python.egg-info → etsy_python-1.2.1}/PKG-INFO

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

{etsy_python-1.1.14 → etsy_python-1.2.1}/etsy_python/_version.py

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

{etsy_python-1.1.14 → etsy_python-1.2.1}/etsy_python/v3/enums/Listing.py

@@ -58,7 +58,7 @@ class State(Enum):
     SOLD_OUT = "sold_out"
     DRAFT = "draft"
     EXPIRED = "expired"
-    REMOVED = "removed"  # Not in OAS spec; kept for backward compatibility, may be removed in next major version
+    REMOVED = "removed"
 
 
 class VideoState(Enum):

{etsy_python-1.1.14 → etsy_python-1.2.1}/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,127 @@ def _warn_if_personalization_used(
         warnings.warn(
             _PERSONALIZATION_DEPRECATION_MSG,
             DeprecationWarning,
-            stacklevel=3,
+            stacklevel=stacklevel,
+        )
+
+
+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(Request):
+#: EU commercial guarantee / GPSR fields (ECGT), shared by createDraftListing
+#: and updateListing. All are optional and nullable. Etsy silently ignores them
+#: for sellers who are not eligible EU traders. ``ecgt_software_update_details``
+#: is ignored for physical listings; the other six are ignored for digital ones.
+#: ``ecgt_garan_brand``, ``ecgt_garan_model``, ``ecgt_garan_years`` and
+#: ``ecgt_garan_guarantee_details`` are required *together* -- Etsy enforces
+#: that server-side and rejects a partial set.
+ECGT_FIELDS = (
+    "ecgt_garan_brand",
+    "ecgt_garan_model",
+    "ecgt_garan_years",
+    "ecgt_garan_guarantee_details",
+    "ecgt_other_commercial_guarantee_details",
+    "ecgt_after_sales_service_info",
+    "ecgt_software_update_details",
+)
+
+
+class _ECGTFieldsMixin:
+    """Storage for the EU commercial guarantee (ECGT) listing fields.
+
+    Both listing request models accept the same seven fields, so the
+    assignment lives here instead of being duplicated. See ``ECGT_FIELDS``.
+    """
+
+    def _store_ecgt(
+        self,
+        ecgt_garan_brand: Optional[str],
+        ecgt_garan_model: Optional[str],
+        ecgt_garan_years: Optional[int],
+        ecgt_garan_guarantee_details: Optional[str],
+        ecgt_other_commercial_guarantee_details: Optional[str],
+        ecgt_after_sales_service_info: Optional[str],
+        ecgt_software_update_details: Optional[str],
+    ) -> None:
+        self.ecgt_garan_brand = ecgt_garan_brand
+        self.ecgt_garan_model = ecgt_garan_model
+        self.ecgt_garan_years = ecgt_garan_years
+        self.ecgt_garan_guarantee_details = ecgt_garan_guarantee_details
+        self.ecgt_other_commercial_guarantee_details = (
+            ecgt_other_commercial_guarantee_details
+        )
+        self.ecgt_after_sales_service_info = ecgt_after_sales_service_info
+        self.ecgt_software_update_details = ecgt_software_update_details
+
+
+class CreateDraftListingRequest(_PersonalizationFieldsMixin, _ECGTFieldsMixin, Request):
     nullable = [
         "shipping_profile_id",
         "return_policy_id",
@@ -69,6 +192,7 @@ class CreateDraftListingRequest(Request):
         "production_partner_ids",
         "image_ids",
         "readiness_state_id",
+        *ECGT_FIELDS,
     ]
     mandatory = [
         "quantity",
@@ -115,6 +239,13 @@ class CreateDraftListingRequest(Request):
         is_taxable: Optional[bool] = None,
         listing_type: Optional[Type] = None,
         readiness_state_id: Optional[int] = None,
+        ecgt_garan_brand: Optional[str] = None,
+        ecgt_garan_model: Optional[str] = None,
+        ecgt_garan_years: Optional[int] = None,
+        ecgt_garan_guarantee_details: Optional[str] = None,
+        ecgt_other_commercial_guarantee_details: Optional[str] = None,
+        ecgt_after_sales_service_info: Optional[str] = None,
+        ecgt_software_update_details: Optional[str] = None,
     ):
         self.quantity = quantity
         self.title = title
@@ -137,11 +268,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,
@@ -155,13 +282,22 @@ class CreateDraftListingRequest(Request):
         self.is_taxable = is_taxable
         self._type = listing_type
         self.readiness_state_id = readiness_state_id
+        self._store_ecgt(
+            ecgt_garan_brand,
+            ecgt_garan_model,
+            ecgt_garan_years,
+            ecgt_garan_guarantee_details,
+            ecgt_other_commercial_guarantee_details,
+            ecgt_after_sales_service_info,
+            ecgt_software_update_details,
+        )
         super().__init__(
             nullable=CreateDraftListingRequest.nullable,
             mandatory=CreateDraftListingRequest.mandatory,
         )
 
 
-class UpdateListingRequest(Request):
+class UpdateListingRequest(_PersonalizationFieldsMixin, _ECGTFieldsMixin, Request):
     nullable: List[str] = [
         "materials",
         "shipping_profile_id",
@@ -177,6 +313,7 @@ class UpdateListingRequest(Request):
         "featured_rank",
         "production_partner_ids",
         "_type",
+        *ECGT_FIELDS,
     ]
 
     mandatory: List[str] = []
@@ -211,6 +348,13 @@ class UpdateListingRequest(Request):
         is_supply: Optional[bool] = None,
         production_partner_ids: Optional[List[int]] = None,
         listing_type: Optional[Type] = None,
+        ecgt_garan_brand: Optional[str] = None,
+        ecgt_garan_model: Optional[str] = None,
+        ecgt_garan_years: Optional[int] = None,
+        ecgt_garan_guarantee_details: Optional[str] = None,
+        ecgt_other_commercial_guarantee_details: Optional[str] = None,
+        ecgt_after_sales_service_info: Optional[str] = None,
+        ecgt_software_update_details: Optional[str] = None,
     ):
         self.image_ids = image_ids
         self.title = title
@@ -232,11 +376,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,
@@ -246,6 +386,15 @@ class UpdateListingRequest(Request):
         self.is_supply = is_supply
         self.production_partner_ids = production_partner_ids
         self._type = listing_type
+        self._store_ecgt(
+            ecgt_garan_brand,
+            ecgt_garan_model,
+            ecgt_garan_years,
+            ecgt_garan_guarantee_details,
+            ecgt_other_commercial_guarantee_details,
+            ecgt_after_sales_service_info,
+            ecgt_software_update_details,
+        )
         super().__init__(
             nullable=UpdateListingRequest.nullable,
             mandatory=UpdateListingRequest.mandatory,

{etsy_python-1.1.14 → etsy_python-1.2.1}/etsy_python/v3/resources/ListingVideo.py

@@ -1,5 +1,5 @@
 from dataclasses import dataclass
-from typing import Union
+from typing import Optional, Union
 
 from etsy_python.v3.exceptions.RequestException import RequestException
 from etsy_python.v3.models.Listing import UpdateListingVideoRequest
@@ -29,9 +29,22 @@ class ListingVideoResource:
         return self.session.make_request(endpoint)
 
     def upload_listing_video(
-        self, shop_id: int, listing_id: int, listing_video: UpdateListingVideoRequest
+        self,
+        shop_id: int,
+        listing_id: int,
+        listing_video: UpdateListingVideoRequest,
+        is_multi_video: Optional[bool] = None,
     ) -> Union[Response, RequestException]:
+        """Upload a video to a listing.
+
+        Pass ``is_multi_video=True`` to keep existing videos on the listing.
+        Omitting it preserves the former single-video behaviour, where the
+        upload replaces any video already attached.
+        """
         endpoint = f"/shops/{shop_id}/listings/{listing_id}/videos"
         return self.session.make_request(
-            endpoint, method=Method.POST, payload=listing_video
+            endpoint,
+            method=Method.POST,
+            payload=listing_video,
+            query_params={"is_multi_video": is_multi_video},
         )

{etsy_python-1.1.14 → etsy_python-1.2.1/etsy_python.egg-info}/PKG-INFO

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