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

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

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

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

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

{etsy_python-1.1.6 → etsy_python-1.1.8}/etsy_python/v3/enums/ListingInventory.py

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

{etsy_python-1.1.6 → etsy_python-1.1.8}/etsy_python/v3/models/Listing.py

@@ -111,9 +111,11 @@ class CreateDraftListingRequest(Request):
         ]):
             warnings.warn(
                 "personalization_is_required, personalization_char_count_max, and "
-                "personalization_instructions are deprecated and will be removed "
-                "from the Etsy API on April 9, 2026. Use the personalization "
-                "endpoint (update_listing_personalization) instead.",
+                "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,
             )
@@ -212,9 +214,11 @@ class UpdateListingRequest(Request):
         ]):
             warnings.warn(
                 "personalization_is_required, personalization_char_count_max, and "
-                "personalization_instructions are deprecated and will be removed "
-                "from the Etsy API on April 9, 2026. Use the personalization "
-                "endpoint (update_listing_personalization) instead.",
+                "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,
             )

etsy_python-1.1.8/etsy_python/v3/models/Receipt.py

@@ -0,0 +1,102 @@
+from typing import List, Optional, TypedDict
+
+from etsy_python.v3.models.Request import Request
+
+
+class CustomsItem(TypedDict):
+    # HS_code preserves Etsy's spec casing (Harmonized System code); do not snake_case.
+    country_of_origin: Optional[str]
+    declared_value: Optional[float]
+    HS_code: Optional[str]
+
+
+class CreateReceiptShipmentRequest(Request):
+    # Spec marks these fields nullable: true. Strings + array are added so callers
+    # can pass empty values to clear them; floats are intentionally excluded so
+    # legitimate zero values (free label, zero duty) serialize as 0, not null.
+    nullable: List[str] = [
+        "mail_class",
+        "weight_units",
+        "dimension_units",
+        "shipping_label_currency",
+        "revenue_eligibility",
+        "ship_from_country",
+        "ship_to_country",
+        "incoterm",
+        "customs_data",
+        "duty_currency",
+        "ship_date",
+    ]
+    mandatory: List[str] = []
+
+    def __init__(
+        self,
+        tracking_code: Optional[str] = None,
+        carrier_name: Optional[str] = None,
+        send_bcc: Optional[bool] = None,
+        note_to_buyer: Optional[str] = None,
+        mail_class: Optional[str] = None,
+        weight: Optional[float] = None,
+        weight_units: Optional[str] = None,
+        length: Optional[float] = None,
+        width: Optional[float] = None,
+        height: Optional[float] = None,
+        dimension_units: Optional[str] = None,
+        shipping_label_cost: Optional[float] = None,
+        shipping_label_currency: Optional[str] = None,
+        revenue_eligibility: Optional[str] = None,
+        ship_from_country: Optional[str] = None,
+        ship_to_country: Optional[str] = None,
+        incoterm: Optional[str] = None,
+        customs_data: Optional[List[CustomsItem]] = None,
+        duty_amount: Optional[float] = None,
+        duty_currency: Optional[str] = None,
+        ship_date: Optional[str] = None,
+    ):
+        self.tracking_code = tracking_code
+        self.carrier_name = carrier_name
+        self.send_bcc = send_bcc
+        self.note_to_buyer = note_to_buyer
+        self.mail_class = mail_class
+        self.weight = weight
+        self.weight_units = weight_units
+        self.length = length
+        self.width = width
+        self.height = height
+        self.dimension_units = dimension_units
+        self.shipping_label_cost = shipping_label_cost
+        self.shipping_label_currency = shipping_label_currency
+        self.revenue_eligibility = revenue_eligibility
+        self.ship_from_country = ship_from_country
+        self.ship_to_country = ship_to_country
+        self.incoterm = incoterm
+        self.customs_data = customs_data
+        self.duty_amount = duty_amount
+        self.duty_currency = duty_currency
+        self.ship_date = ship_date
+
+        super().__init__(
+            nullable=CreateReceiptShipmentRequest.nullable,
+            mandatory=CreateReceiptShipmentRequest.mandatory,
+        )
+
+
+class UpdateShopReceiptRequest(Request):
+    nullable: List[str] = [
+        "was_shipped",
+        "was_paid",
+    ]
+    mandatory: List[str] = []
+
+    def __init__(
+        self,
+        was_shipped: Optional[bool] = None,
+        was_paid: Optional[bool] = None,
+    ):
+        self.was_shipped = was_shipped
+        self.was_paid = was_paid
+
+        super().__init__(
+            nullable=UpdateShopReceiptRequest.nullable,
+            mandatory=UpdateShopReceiptRequest.mandatory,
+        )

{etsy_python-1.1.6 → etsy_python-1.1.8}/etsy_python/v3/resources/ListingInventory.py

@@ -3,6 +3,7 @@ from typing import Optional, Dict, Any, Union
 
 from etsy_python.v3.exceptions.RequestException import RequestException
 from etsy_python.v3.enums.Listing import InventoryIncludes
+from etsy_python.v3.enums.ListingInventory import MaxVariationsSupported
 from etsy_python.v3.models.Listing import UpdateListingInventoryRequest
 from etsy_python.v3.resources.Session import EtsyClient
 from etsy_python.v3.resources.enums.Request import Method
@@ -31,9 +32,16 @@ class ListingInventoryResource:
     def update_listing_inventory(
         self, listing_id: int, listing_inventory: UpdateListingInventoryRequest,
         legacy: Optional[bool] = None,
+        max_variations_supported: Optional[MaxVariationsSupported] = None,
     ) -> Union[Response, RequestException]:
         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,
+        }
         return self.session.make_request(
             endpoint, method=Method.PUT, payload=listing_inventory,
-            query_params={"legacy": legacy},
+            query_params=query_params,
         )

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

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

etsy_python-1.1.6/etsy_python/v3/models/Receipt.py

@@ -1,46 +0,0 @@
-from typing import List, Optional
-
-from etsy_python.v3.models.Request import Request
-
-
-class CreateReceiptShipmentRequest(Request):
-    nullable: List[str] = []
-    mandatory: List[str] = []
-
-    def __init__(
-        self,
-        tracking_code: Optional[str] = None,
-        carrier_name: Optional[str] = None,
-        send_bcc: Optional[bool] = None,
-        note_to_buyer: Optional[str] = None,
-    ):
-        self.tracking_code = tracking_code
-        self.carrier_name = carrier_name
-        self.send_bcc = send_bcc
-        self.note_to_buyer = note_to_buyer
-
-        super().__init__(
-            nullable=CreateReceiptShipmentRequest.nullable,
-            mandatory=CreateReceiptShipmentRequest.mandatory,
-        )
-
-
-class UpdateShopReceiptRequest(Request):
-    nullable: List[str] = [
-        "was_shipped",
-        "was_paid",
-    ]
-    mandatory: List[str] = []
-
-    def __init__(
-        self,
-        was_shipped: Optional[bool] = None,
-        was_paid: Optional[bool] = None,
-    ):
-        self.was_shipped = was_shipped
-        self.was_paid = was_paid
-
-        super().__init__(
-            nullable=UpdateShopReceiptRequest.nullable,
-            mandatory=UpdateShopReceiptRequest.mandatory,
-        )