Merge pull request #1975 from saleweaver/improve_versions

Improve versions, add all clients, automate client creation.

Author: saleweaver

.gitignore

@@ -141,3 +141,5 @@ dmypy.json
 cython_debug/
 
 env.env
+AGENTS.md
+models

README.md

@@ -70,7 +70,7 @@ from sp_api.api import DataKiosk
 from sp_api.api import Feeds
 from sp_api.base import SellingApiException
 from sp_api.base.reportTypes import ReportType
-from datetime import datetime, timedelta
+from datetime import datetime, timedelta, timezone
 
 # DATA KIOSK API
 client = DataKiosk()
@@ -80,7 +80,7 @@ print(res)
 
 # orders API
 try:
-    res = Orders().get_orders(CreatedAfter=(datetime.utcnow() - timedelta(days=7)).isoformat())
+    res = Orders().get_orders(CreatedAfter=(datetime.now(timezone.utc) - timedelta(days=7)).isoformat())
     print(res.payload)  # json data
 except SellingApiException as ex:
     print(ex)
@@ -96,11 +96,11 @@ Feeds().submit_feed(<feed_type>, <file_or_bytes_io>, content_type='text/tsv', **
 
 # PII Data
 
-Orders(restricted_data_token='<token>').get_orders(CreatedAfter=(datetime.utcnow() - timedelta(days=7)).isoformat())
+Orders(restricted_data_token='<token>').get_orders(CreatedAfter=(datetime.now(timezone.utc) - timedelta(days=7)).isoformat())
 
 # or use the shortcut
 orders = Orders().get_orders(
-    LastUpdatedAfter=(datetime.utcnow() - timedelta(days=1)).isoformat()
+    LastUpdatedAfter=(datetime.now(timezone.utc) - timedelta(days=1)).isoformat()
 )
 ```
 
@@ -110,7 +110,7 @@ orders = Orders().get_orders(
 
 ```python
 import asyncio
-from datetime import datetime, timedelta
+from datetime import datetime, timedelta, timezone
 
 from sp_api.asyncio.api import Orders, Reports
 from sp_api.base.reportTypes import ReportType
@@ -119,7 +119,7 @@ from sp_api.base.reportTypes import ReportType
 async def main():
     async with Orders() as orders_client:
         res = await orders_client.get_orders(
-            LastUpdatedAfter=(datetime.utcnow() - timedelta(days=1)).isoformat()
+            LastUpdatedAfter=(datetime.now(timezone.utc) - timedelta(days=1)).isoformat()
         )
         print(res.payload)
 

docs/async.rst

@@ -21,7 +21,7 @@ Basic usage
 .. code-block:: python
 
    import asyncio
-   from datetime import datetime, timedelta
+   from datetime import datetime, timedelta, timezone
 
    from sp_api.asyncio.api import Orders, Reports
    from sp_api.base.reportTypes import ReportType
@@ -30,7 +30,7 @@ Basic usage
    async def main():
        async with Orders() as orders_client:
            res = await orders_client.get_orders(
-               LastUpdatedAfter=(datetime.utcnow() - timedelta(days=1)).isoformat()
+               LastUpdatedAfter=(datetime.now(timezone.utc) - timedelta(days=1)).isoformat()
            )
            print(res.payload)
 

docs/config_file.rst

@@ -51,7 +51,8 @@ Usage with default account
 
 ..  code-block:: python
 
-    Orders().get_orders(CreatedAfter=(datetime.utcnow() - timedelta(days=7)).isoformat())
+    from datetime import datetime, timedelta, timezone
+    Orders().get_orders(CreatedAfter=(datetime.now(timezone.utc) - timedelta(days=7)).isoformat())
 
 
 **************************
@@ -62,15 +63,15 @@ You can use every account's name from the config file for account
 
 ..  code-block:: python
 
-    Orders(account=another_account).get_orders(CreatedAfter=(datetime.utcnow() - timedelta(days=7)).isoformat())
+    Orders(account=another_account).get_orders(CreatedAfter=(datetime.now(timezone.utc) - timedelta(days=7)).isoformat())
 
 .. note::
 
     The refresh token can be passed directly to the client, too. You don't need to pass the whole credentials if all that changes is the refresh token.
 
     ..  code-block:: python
 
-        Orders(account='another_account', refresh_token='<refresh_token_for_this_request>').get_orders(CreatedAfter=(datetime.utcnow() - timedelta(days=7)).isoformat())
+        Orders(account='another_account', refresh_token='<refresh_token_for_this_request>').get_orders(CreatedAfter=(datetime.now(timezone.utc) - timedelta(days=7)).isoformat())
 
 
 **********
@@ -81,5 +82,3 @@ References
 
 .. _`credentials.yml`: https://github.com/saleweaver/python-amazon-sp-api/blob/master/credentials.yml
 .. _`confused`: https://confuse.readthedocs.io/en/latest/usage.html#search-paths
-
-

docs/endpoints.rst

@@ -16,14 +16,19 @@ You can use the playground to test endpoints:
     endpoints/catalog
     endpoints/catalog_items
     endpoints/data_kiosk
+    endpoints/delivery_by_amazon
     endpoints/easy_ship
+    endpoints/external_fulfillment_inventory
+    endpoints/external_fulfillment_returns
+    endpoints/external_fulfillment_shipping
     endpoints/fba_inbound_eligibility
     endpoints/fba_small_and_light
     endpoints/feeds
     endpoints/finances
     endpoints/fulfillment_inbound
     endpoints/fulfillment_outbound
     endpoints/inventories
+    endpoints/invoices
     endpoints/listings_items
     endpoints/listings_restrictions
     endpoints/merchant_fulfillment
@@ -36,9 +41,11 @@ You can use the playground to test endpoints:
     endpoints/replenishment
     endpoints/reports
     endpoints/sales
+    endpoints/seller_wallet
     endpoints/sellers
     endpoints/services
     endpoints/shipping
+    endpoints/shipment_invoicing
     endpoints/solicitations
     endpoints/supply_sources
     endpoints/tokens
@@ -47,10 +54,10 @@ You can use the playground to test endpoints:
     endpoints/vendor_direct_fulfillment_orders
     endpoints/vendor_direct_fulfillment_payments
     endpoints/vendor_direct_fulfillment_shipping
+    endpoints/vendor_direct_fulfillment_sandbox_test_data
     endpoints/vendor_direct_fulfillment_transactions
     endpoints/vendor_invoices
     endpoints/vendor_orders
     endpoints/vendor_shipments
     endpoints/vendor_transaction_status
-
-
+    endpoints/vehicles

docs/endpoints/awd.rst

@@ -2,7 +2,7 @@ AmazonWarehousingAndDistribution
 ================================
 
 
+..  toctree::
+    :maxdepth: 1
 
-.. autoclass:: sp_api.api.AmazonWarehousingAndDistribution
-    :members:
-    :inherited-members:
+    awd_v2024_05_09

docs/endpoints/awd_v2024_05_09.rst

@@ -0,0 +1,7 @@
+AmazonWarehousingAndDistribution V2024_05_09
+============================================
+
+
+..  autoclass:: sp_api.api.AmazonWarehousingAndDistributionV20240509
+    :members:
+    :inherited-members:

docs/endpoints/catalog_items.rst

@@ -2,5 +2,8 @@ CatalogItems
 ============
 
 
-    
-.. autoclass:: sp_api.api.CatalogItems
+..  toctree::
+    :maxdepth: 1
+
+    catalog_items_v2020_12_01
+    catalog_items_v2022_04_01

docs/endpoints/catalog_items_v2020_12_01.rst

@@ -0,0 +1,5 @@
+CatalogItems V2020_12_01
+========================
+
+
+..  autoclass:: sp_api.api.CatalogItemsV20201201

docs/endpoints/catalog_items_v2022_04_01.rst

@@ -0,0 +1,5 @@
+CatalogItems V2022_04_01
+========================
+
+
+..  autoclass:: sp_api.api.CatalogItemsV20220401