etsy-python 1.1.0__tar.gz → 1.1.2__tar.gz

{etsy_python-1.1.0/etsy_python.egg-info → etsy_python-1.1.2}/PKG-INFO

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

{etsy_python-1.1.0 → etsy_python-1.1.2}/etsy_python/_version.py

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

{etsy_python-1.1.0 → etsy_python-1.1.2}/etsy_python/v3/enums/HolidayPreferences.py

@@ -15,6 +15,7 @@ class HOLIDAYS(Enum):
     pass
 
 class US_HOLIDAYS(Enum):
+    """US holidays (IDs 1-11)."""
     NEW_YEARS_DAY = 1
     MARTIN_LUTHER_KING_JR_DAY = 2
     PRESIDENTS_DAY = 3
@@ -28,6 +29,8 @@ class US_HOLIDAYS(Enum):
     CHRISTMAS_DAY = 11
 
 class CA_HOLIDAYS(Enum):
+    """Canadian holidays (IDs 12-23). For other regions (IDs 24-105),
+    pass the integer ID directly to update_holiday_preferences()."""
     GOOD_FRIDAY = 12
     EASTER = 13
     VICTORIA_DAY = 14

{etsy_python-1.1.0 → etsy_python-1.1.2}/etsy_python/v3/enums/Listing.py

@@ -58,7 +58,7 @@ class State(Enum):
     SOLD_OUT = "sold_out"
     DRAFT = "draft"
     EXPIRED = "expired"
-    REMOVED = "removed"
+    REMOVED = "removed"  # Not in OAS spec; kept for backward compatibility, may be removed in next major version
 
 
 class VideoState(Enum):
@@ -92,6 +92,7 @@ class Includes(Enum):
     TRANSLATIONS = "Translations"
     INVENTORY = "Inventory"
     VIDEOS = "Videos"
+    PERSONALIZATION = "Personalization"
 
 
 class InventoryIncludes(Enum):

{etsy_python-1.1.0 → etsy_python-1.1.2}/etsy_python/v3/models/Listing.py

@@ -1,3 +1,4 @@
+import warnings
 from typing import List, Optional, Dict, Any
 
 from etsy_python.v3.enums.Listing import (
@@ -104,6 +105,18 @@ 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,
+            personalization_instructions,
+        ]):
+            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.",
+                DeprecationWarning,
+                stacklevel=2,
+            )
         self.production_partner_ids = production_partner_ids
         self.image_ids = image_ids
         self.is_supply = is_supply
@@ -133,7 +146,7 @@ class UpdateListingRequest(Request):
         "tags",
         "featured_rank",
         "production_partner_ids",
-        "type",
+        "_type",
     ]
 
     mandatory: List[str] = []
@@ -193,6 +206,18 @@ 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,
+            personalization_instructions,
+        ]):
+            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.",
+                DeprecationWarning,
+                stacklevel=2,
+            )
         self.state = state
         self.is_supply = is_supply
         self.production_partner_ids = production_partner_ids

{etsy_python-1.1.0 → etsy_python-1.1.2}/etsy_python/v3/resources/Listing.py

@@ -129,7 +129,10 @@ class ListingResource:
         return self.session.make_request(endpoint, query_params=query_params)
 
     def get_listings_by_listing_ids(
-        self, listing_ids: List[int], includes: Optional[List[Includes]] = None
+        self,
+        listing_ids: List[int],
+        includes: Optional[List[Includes]] = None,
+        legacy: Optional[bool] = None,
     ) -> Union[Response, RequestException]:
         endpoint = "/listings/batch"
         query_params: Dict[str, Any] = {
@@ -137,11 +140,15 @@ class ListingResource:
             "includes": ",".join(list(map(lambda inc: inc.value, includes)))
             if includes is not None
             else None,
+            "legacy": legacy,
         }
         return self.session.make_request(endpoint, query_params=query_params)
 
     def get_listings_by_listings_ids(
-        self, listing_ids: List[int], includes: Optional[List[Includes]] = None
+        self,
+        listing_ids: List[int],
+        includes: Optional[List[Includes]] = None,
+        legacy: Optional[bool] = None,
     ) -> Union[Response, RequestException]:
         """Deprecated: use get_listings_by_listing_ids instead."""
         warnings.warn(
@@ -149,7 +156,7 @@ class ListingResource:
             DeprecationWarning,
             stacklevel=2,
         )
-        return self.get_listings_by_listing_ids(listing_ids, includes)
+        return self.get_listings_by_listing_ids(listing_ids, includes, legacy)
 
     def get_featured_listings_by_shop(
         self, shop_id: int, limit: int = 25, offset: int = 0,

{etsy_python-1.1.0 → etsy_python-1.1.2}/etsy_python/v3/resources/ReceiptTransactions.py

@@ -34,14 +34,16 @@ class ReceiptTransactionsResource:
         return self.session.make_request(endpoint)
 
     def get_shop_receipt_transactions_by_shop(
-        self, shop_id: int, limit: int = 25, offset: int = 0
+        self, shop_id: int, limit: int = 25, offset: int = 0,
+        legacy: Optional[bool] = None,
     ) -> Union[Response, RequestException]:
         endpoint = f"/shops/{shop_id}/transactions"
-        query_params: Dict[str, Any] = {"limit": limit, "offset": offset}
+        query_params: Dict[str, Any] = {"limit": limit, "offset": offset, "legacy": legacy}
         return self.session.make_request(endpoint, query_params=query_params)
 
     def get_shop_receipt_transaction_by_shop(
-        self, shop_id: int, limit: int = 25, offset: int = 0
+        self, shop_id: int, limit: int = 25, offset: int = 0,
+        legacy: Optional[bool] = None,
     ) -> Union[Response, RequestException]:
         """Deprecated: use get_shop_receipt_transactions_by_shop instead."""
         warnings.warn(
@@ -49,4 +51,4 @@ class ReceiptTransactionsResource:
             DeprecationWarning,
             stacklevel=2,
         )
-        return self.get_shop_receipt_transactions_by_shop(shop_id, limit, offset)
+        return self.get_shop_receipt_transactions_by_shop(shop_id, limit, offset, legacy)

{etsy_python-1.1.0 → etsy_python-1.1.2/etsy_python.egg-info}/PKG-INFO

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