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

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

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

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

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

{etsy_python-1.2.0 → etsy_python-1.2.2}/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.2.0 → etsy_python-1.2.2}/etsy_python/v3/models/Listing.py

@@ -127,7 +127,53 @@ class _PersonalizationFieldsMixin:
         )
 
 
-class CreateDraftListingRequest(_PersonalizationFieldsMixin, 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",
@@ -146,6 +192,7 @@ class CreateDraftListingRequest(_PersonalizationFieldsMixin, Request):
         "production_partner_ids",
         "image_ids",
         "readiness_state_id",
+        *ECGT_FIELDS,
     ]
     mandatory = [
         "quantity",
@@ -192,6 +239,13 @@ class CreateDraftListingRequest(_PersonalizationFieldsMixin, 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
@@ -228,13 +282,22 @@ class CreateDraftListingRequest(_PersonalizationFieldsMixin, 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(_PersonalizationFieldsMixin, Request):
+class UpdateListingRequest(_PersonalizationFieldsMixin, _ECGTFieldsMixin, Request):
     nullable: List[str] = [
         "materials",
         "shipping_profile_id",
@@ -250,6 +313,7 @@ class UpdateListingRequest(_PersonalizationFieldsMixin, Request):
         "featured_rank",
         "production_partner_ids",
         "_type",
+        *ECGT_FIELDS,
     ]
 
     mandatory: List[str] = []
@@ -284,6 +348,13 @@ class UpdateListingRequest(_PersonalizationFieldsMixin, 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
@@ -315,6 +386,15 @@ class UpdateListingRequest(_PersonalizationFieldsMixin, 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.2.0 → etsy_python-1.2.2}/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.2.0 → etsy_python-1.2.2}/etsy_python/v3/resources/Taxonomy.py

@@ -1,5 +1,5 @@
 from dataclasses import dataclass
-from typing import Union
+from typing import Any, Dict, Optional, Union
 
 from etsy_python.v3.exceptions.RequestException import RequestException
 from etsy_python.v3.resources.Response import Response
@@ -30,7 +30,14 @@ class SellerTaxonomyResource:
         return self.session.make_request(endpoint)
 
     def get_properties_by_taxonomy_id(
-        self, taxonomy_id: int
+        self,
+        taxonomy_id: int,
+        supports_variations: Optional[bool] = None,
+        supports_attributes: Optional[bool] = None,
     ) -> Union[Response, RequestException]:
         endpoint = f"/seller-taxonomy/nodes/{taxonomy_id}/properties"
-        return self.session.make_request(endpoint)
+        query_params: Dict[str, Any] = {
+            "supports_variations": supports_variations,
+            "supports_attributes": supports_attributes,
+        }
+        return self.session.make_request(endpoint, query_params=query_params)

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

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