dodopayments 1.19.0__tar.gz → 1.20.0__tar.gz

dodopayments-1.20.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.20.0"
+}

{dodopayments-1.19.0 → dodopayments-1.20.0}/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 1.20.0 (2025-05-01)
+
+Full Changelog: [v1.19.0...v1.20.0](https://github.com/dodopayments/dodopayments-python/compare/v1.19.0...v1.20.0)
+
+### Features
+
+* **api:** added addons ([645d6cc](https://github.com/dodopayments/dodopayments-python/commit/645d6cc31af0553aa94b936b9eee9a27681a378c))
+* **api:** updated readme example ([ad59e88](https://github.com/dodopayments/dodopayments-python/commit/ad59e886826fb0366a20d99a6689ca93d93cc5b0))
+* **api:** updated readme example ([bf3b943](https://github.com/dodopayments/dodopayments-python/commit/bf3b9434427b21cb8b3bd6214068ca6dccd18387))
+
 ## 1.19.0 (2025-04-30)
 
 Full Changelog: [v1.18.3...v1.19.0](https://github.com/dodopayments/dodopayments-python/compare/v1.18.3...v1.19.0)

{dodopayments-1.19.0 → dodopayments-1.20.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: dodopayments
-Version: 1.19.0
+Version: 1.20.0
 Summary: The official Python library for the Dodo Payments API
 Project-URL: Homepage, https://github.com/dodopayments/dodopayments-python
 Project-URL: Repository, https://github.com/dodopayments/dodopayments-python
@@ -59,7 +59,7 @@ import os
 from dodopayments import DodoPayments
 
 client = DodoPayments(
-    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),  # This is the default and can be omitted
+    api_key=os.environ.get("DODO_PAYMENTS_API_KEY"),  # This is the default and can be omitted
     # defaults to "live_mode".
     environment="test_mode",
 )
@@ -83,10 +83,10 @@ payment = client.payments.create(
 print(payment.payment_id)
 ```
 
-While you can provide a `bearer_token` keyword argument,
+While you can provide an `api_key` keyword argument,
 we recommend using [python-dotenv](https://pypi.org/project/python-dotenv/)
-to add `DODO_PAYMENTS_API_KEY="My Bearer Token"` to your `.env` file
-so that your Bearer Token is not stored in source control.
+to add `DODO_PAYMENTS_API_KEY="My API Key"` to your `.env` file
+so that your API Key is not stored in source control.
 
 ## Async usage
 
@@ -98,7 +98,7 @@ import asyncio
 from dodopayments import AsyncDodoPayments
 
 client = AsyncDodoPayments(
-    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),  # This is the default and can be omitted
+    api_key=os.environ.get("DODO_PAYMENTS_API_KEY"),  # This is the default and can be omitted
     # defaults to "live_mode".
     environment="test_mode",
 )

{dodopayments-1.19.0 → dodopayments-1.20.0}/README.md

@@ -28,7 +28,7 @@ import os
 from dodopayments import DodoPayments
 
 client = DodoPayments(
-    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),  # This is the default and can be omitted
+    api_key=os.environ.get("DODO_PAYMENTS_API_KEY"),  # This is the default and can be omitted
     # defaults to "live_mode".
     environment="test_mode",
 )
@@ -52,10 +52,10 @@ payment = client.payments.create(
 print(payment.payment_id)
 ```
 
-While you can provide a `bearer_token` keyword argument,
+While you can provide an `api_key` keyword argument,
 we recommend using [python-dotenv](https://pypi.org/project/python-dotenv/)
-to add `DODO_PAYMENTS_API_KEY="My Bearer Token"` to your `.env` file
-so that your Bearer Token is not stored in source control.
+to add `DODO_PAYMENTS_API_KEY="My API Key"` to your `.env` file
+so that your API Key is not stored in source control.
 
 ## Async usage
 
@@ -67,7 +67,7 @@ import asyncio
 from dodopayments import AsyncDodoPayments
 
 client = AsyncDodoPayments(
-    bearer_token=os.environ.get("DODO_PAYMENTS_API_KEY"),  # This is the default and can be omitted
+    api_key=os.environ.get("DODO_PAYMENTS_API_KEY"),  # This is the default and can be omitted
     # defaults to "live_mode".
     environment="test_mode",
 )

{dodopayments-1.19.0 → dodopayments-1.20.0}/api.md

@@ -29,10 +29,12 @@ Types:
 
 ```python
 from dodopayments.types import (
+    AddonCartResponseItem,
     Subscription,
     SubscriptionStatus,
     TimeInterval,
     SubscriptionCreateResponse,
+    SubscriptionListResponse,
     SubscriptionChargeResponse,
 )
 ```
@@ -42,7 +44,7 @@ Methods:
 - <code title="post /subscriptions">client.subscriptions.<a href="./src/dodopayments/resources/subscriptions.py">create</a>(\*\*<a href="src/dodopayments/types/subscription_create_params.py">params</a>) -> <a href="./src/dodopayments/types/subscription_create_response.py">SubscriptionCreateResponse</a></code>
 - <code title="get /subscriptions/{subscription_id}">client.subscriptions.<a href="./src/dodopayments/resources/subscriptions.py">retrieve</a>(subscription_id) -> <a href="./src/dodopayments/types/subscription.py">Subscription</a></code>
 - <code title="patch /subscriptions/{subscription_id}">client.subscriptions.<a href="./src/dodopayments/resources/subscriptions.py">update</a>(subscription_id, \*\*<a href="src/dodopayments/types/subscription_update_params.py">params</a>) -> <a href="./src/dodopayments/types/subscription.py">Subscription</a></code>
-- <code title="get /subscriptions">client.subscriptions.<a href="./src/dodopayments/resources/subscriptions.py">list</a>(\*\*<a href="src/dodopayments/types/subscription_list_params.py">params</a>) -> <a href="./src/dodopayments/types/subscription.py">SyncDefaultPageNumberPagination[Subscription]</a></code>
+- <code title="get /subscriptions">client.subscriptions.<a href="./src/dodopayments/resources/subscriptions.py">list</a>(\*\*<a href="src/dodopayments/types/subscription_list_params.py">params</a>) -> <a href="./src/dodopayments/types/subscription_list_response.py">SyncDefaultPageNumberPagination[SubscriptionListResponse]</a></code>
 - <code title="post /subscriptions/{subscription_id}/change-plan">client.subscriptions.<a href="./src/dodopayments/resources/subscriptions.py">change_plan</a>(subscription_id, \*\*<a href="src/dodopayments/types/subscription_change_plan_params.py">params</a>) -> None</code>
 - <code title="post /subscriptions/{subscription_id}/charge">client.subscriptions.<a href="./src/dodopayments/resources/subscriptions.py">charge</a>(subscription_id, \*\*<a href="src/dodopayments/types/subscription_charge_params.py">params</a>) -> <a href="./src/dodopayments/types/subscription_charge_response.py">SubscriptionChargeResponse</a></code>
 
@@ -203,7 +205,12 @@ Methods:
 Types:
 
 ```python
-from dodopayments.types import CountryCode, MiscListSupportedCountriesResponse
+from dodopayments.types import (
+    CountryCode,
+    Currency,
+    TaxCategory,
+    MiscListSupportedCountriesResponse,
+)
 ```
 
 Methods:
@@ -225,3 +232,19 @@ Methods:
 - <code title="patch /discounts/{discount_id}">client.discounts.<a href="./src/dodopayments/resources/discounts.py">update</a>(discount_id, \*\*<a href="src/dodopayments/types/discount_update_params.py">params</a>) -> <a href="./src/dodopayments/types/discount.py">Discount</a></code>
 - <code title="get /discounts">client.discounts.<a href="./src/dodopayments/resources/discounts.py">list</a>(\*\*<a href="src/dodopayments/types/discount_list_params.py">params</a>) -> <a href="./src/dodopayments/types/discount.py">SyncDefaultPageNumberPagination[Discount]</a></code>
 - <code title="delete /discounts/{discount_id}">client.discounts.<a href="./src/dodopayments/resources/discounts.py">delete</a>(discount_id) -> None</code>
+
+# Addons
+
+Types:
+
+```python
+from dodopayments.types import AddonResponse, AddonUpdateImagesResponse
+```
+
+Methods:
+
+- <code title="post /addons">client.addons.<a href="./src/dodopayments/resources/addons.py">create</a>(\*\*<a href="src/dodopayments/types/addon_create_params.py">params</a>) -> <a href="./src/dodopayments/types/addon_response.py">AddonResponse</a></code>
+- <code title="get /addons/{id}">client.addons.<a href="./src/dodopayments/resources/addons.py">retrieve</a>(id) -> <a href="./src/dodopayments/types/addon_response.py">AddonResponse</a></code>
+- <code title="patch /addons/{id}">client.addons.<a href="./src/dodopayments/resources/addons.py">update</a>(id, \*\*<a href="src/dodopayments/types/addon_update_params.py">params</a>) -> <a href="./src/dodopayments/types/addon_response.py">AddonResponse</a></code>
+- <code title="get /addons">client.addons.<a href="./src/dodopayments/resources/addons.py">list</a>(\*\*<a href="src/dodopayments/types/addon_list_params.py">params</a>) -> <a href="./src/dodopayments/types/addon_response.py">SyncDefaultPageNumberPagination[AddonResponse]</a></code>
+- <code title="put /addons/{id}/images">client.addons.<a href="./src/dodopayments/resources/addons.py">update_images</a>(id) -> <a href="./src/dodopayments/types/addon_update_images_response.py">AddonUpdateImagesResponse</a></code>

{dodopayments-1.19.0 → dodopayments-1.20.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dodopayments"
-version = "1.19.0"
+version = "1.20.0"
 description = "The official Python library for the Dodo Payments API"
 dynamic = ["readme"]
 license = "Apache-2.0"

{dodopayments-1.19.0 → dodopayments-1.20.0}/src/dodopayments/_client.py

@@ -23,6 +23,7 @@ from ._utils import is_given, get_async_library
 from ._version import __version__
 from .resources import (
     misc,
+    addons,
     payouts,
     refunds,
     disputes,
@@ -78,18 +79,19 @@ class DodoPayments(SyncAPIClient):
     products: products.ProductsResource
     misc: misc.MiscResource
     discounts: discounts.DiscountsResource
+    addons: addons.AddonsResource
     with_raw_response: DodoPaymentsWithRawResponse
     with_streaming_response: DodoPaymentsWithStreamedResponse
 
     # client options
-    bearer_token: str
+    api_key: str
 
     _environment: Literal["live_mode", "test_mode"] | NotGiven
 
     def __init__(
         self,
         *,
-        bearer_token: str | None = None,
+        api_key: str | None = None,
         environment: Literal["live_mode", "test_mode"] | NotGiven = NOT_GIVEN,
         base_url: str | httpx.URL | None | NotGiven = NOT_GIVEN,
         timeout: Union[float, Timeout, None, NotGiven] = NOT_GIVEN,
@@ -112,15 +114,15 @@ class DodoPayments(SyncAPIClient):
     ) -> None:
         """Construct a new synchronous DodoPayments client instance.
 
-        This automatically infers the `bearer_token` argument from the `DODO_PAYMENTS_API_KEY` environment variable if it is not provided.
+        This automatically infers the `api_key` argument from the `DODO_PAYMENTS_API_KEY` environment variable if it is not provided.
         """
-        if bearer_token is None:
-            bearer_token = os.environ.get("DODO_PAYMENTS_API_KEY")
-        if bearer_token is None:
+        if api_key is None:
+            api_key = os.environ.get("DODO_PAYMENTS_API_KEY")
+        if api_key is None:
             raise DodoPaymentsError(
-                "The bearer_token client option must be set either by passing bearer_token to the client or by setting the DODO_PAYMENTS_API_KEY environment variable"
+                "The api_key client option must be set either by passing api_key to the client or by setting the DODO_PAYMENTS_API_KEY environment variable"
             )
-        self.bearer_token = bearer_token
+        self.api_key = api_key
 
         self._environment = environment
 
@@ -173,6 +175,7 @@ class DodoPayments(SyncAPIClient):
         self.products = products.ProductsResource(self)
         self.misc = misc.MiscResource(self)
         self.discounts = discounts.DiscountsResource(self)
+        self.addons = addons.AddonsResource(self)
         self.with_raw_response = DodoPaymentsWithRawResponse(self)
         self.with_streaming_response = DodoPaymentsWithStreamedResponse(self)
 
@@ -184,8 +187,8 @@ class DodoPayments(SyncAPIClient):
     @property
     @override
     def auth_headers(self) -> dict[str, str]:
-        bearer_token = self.bearer_token
-        return {"Authorization": f"Bearer {bearer_token}"}
+        api_key = self.api_key
+        return {"Authorization": f"Bearer {api_key}"}
 
     @property
     @override
@@ -199,7 +202,7 @@ class DodoPayments(SyncAPIClient):
     def copy(
         self,
         *,
-        bearer_token: str | None = None,
+        api_key: str | None = None,
         environment: Literal["live_mode", "test_mode"] | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: float | Timeout | None | NotGiven = NOT_GIVEN,
@@ -234,7 +237,7 @@ class DodoPayments(SyncAPIClient):
 
         http_client = http_client or self._client
         return self.__class__(
-            bearer_token=bearer_token or self.bearer_token,
+            api_key=api_key or self.api_key,
             base_url=base_url or self.base_url,
             environment=environment or self._environment,
             timeout=self.timeout if isinstance(timeout, NotGiven) else timeout,
@@ -298,18 +301,19 @@ class AsyncDodoPayments(AsyncAPIClient):
     products: products.AsyncProductsResource
     misc: misc.AsyncMiscResource
     discounts: discounts.AsyncDiscountsResource
+    addons: addons.AsyncAddonsResource
     with_raw_response: AsyncDodoPaymentsWithRawResponse
     with_streaming_response: AsyncDodoPaymentsWithStreamedResponse
 
     # client options
-    bearer_token: str
+    api_key: str
 
     _environment: Literal["live_mode", "test_mode"] | NotGiven
 
     def __init__(
         self,
         *,
-        bearer_token: str | None = None,
+        api_key: str | None = None,
         environment: Literal["live_mode", "test_mode"] | NotGiven = NOT_GIVEN,
         base_url: str | httpx.URL | None | NotGiven = NOT_GIVEN,
         timeout: Union[float, Timeout, None, NotGiven] = NOT_GIVEN,
@@ -332,15 +336,15 @@ class AsyncDodoPayments(AsyncAPIClient):
     ) -> None:
         """Construct a new async AsyncDodoPayments client instance.
 
-        This automatically infers the `bearer_token` argument from the `DODO_PAYMENTS_API_KEY` environment variable if it is not provided.
+        This automatically infers the `api_key` argument from the `DODO_PAYMENTS_API_KEY` environment variable if it is not provided.
         """
-        if bearer_token is None:
-            bearer_token = os.environ.get("DODO_PAYMENTS_API_KEY")
-        if bearer_token is None:
+        if api_key is None:
+            api_key = os.environ.get("DODO_PAYMENTS_API_KEY")
+        if api_key is None:
             raise DodoPaymentsError(
-                "The bearer_token client option must be set either by passing bearer_token to the client or by setting the DODO_PAYMENTS_API_KEY environment variable"
+                "The api_key client option must be set either by passing api_key to the client or by setting the DODO_PAYMENTS_API_KEY environment variable"
             )
-        self.bearer_token = bearer_token
+        self.api_key = api_key
 
         self._environment = environment
 
@@ -393,6 +397,7 @@ class AsyncDodoPayments(AsyncAPIClient):
         self.products = products.AsyncProductsResource(self)
         self.misc = misc.AsyncMiscResource(self)
         self.discounts = discounts.AsyncDiscountsResource(self)
+        self.addons = addons.AsyncAddonsResource(self)
         self.with_raw_response = AsyncDodoPaymentsWithRawResponse(self)
         self.with_streaming_response = AsyncDodoPaymentsWithStreamedResponse(self)
 
@@ -404,8 +409,8 @@ class AsyncDodoPayments(AsyncAPIClient):
     @property
     @override
     def auth_headers(self) -> dict[str, str]:
-        bearer_token = self.bearer_token
-        return {"Authorization": f"Bearer {bearer_token}"}
+        api_key = self.api_key
+        return {"Authorization": f"Bearer {api_key}"}
 
     @property
     @override
@@ -419,7 +424,7 @@ class AsyncDodoPayments(AsyncAPIClient):
     def copy(
         self,
         *,
-        bearer_token: str | None = None,
+        api_key: str | None = None,
         environment: Literal["live_mode", "test_mode"] | None = None,
         base_url: str | httpx.URL | None = None,
         timeout: float | Timeout | None | NotGiven = NOT_GIVEN,
@@ -454,7 +459,7 @@ class AsyncDodoPayments(AsyncAPIClient):
 
         http_client = http_client or self._client
         return self.__class__(
-            bearer_token=bearer_token or self.bearer_token,
+            api_key=api_key or self.api_key,
             base_url=base_url or self.base_url,
             environment=environment or self._environment,
             timeout=self.timeout if isinstance(timeout, NotGiven) else timeout,
@@ -521,6 +526,7 @@ class DodoPaymentsWithRawResponse:
         self.products = products.ProductsResourceWithRawResponse(client.products)
         self.misc = misc.MiscResourceWithRawResponse(client.misc)
         self.discounts = discounts.DiscountsResourceWithRawResponse(client.discounts)
+        self.addons = addons.AddonsResourceWithRawResponse(client.addons)
 
 
 class AsyncDodoPaymentsWithRawResponse:
@@ -541,6 +547,7 @@ class AsyncDodoPaymentsWithRawResponse:
         self.products = products.AsyncProductsResourceWithRawResponse(client.products)
         self.misc = misc.AsyncMiscResourceWithRawResponse(client.misc)
         self.discounts = discounts.AsyncDiscountsResourceWithRawResponse(client.discounts)
+        self.addons = addons.AsyncAddonsResourceWithRawResponse(client.addons)
 
 
 class DodoPaymentsWithStreamedResponse:
@@ -561,6 +568,7 @@ class DodoPaymentsWithStreamedResponse:
         self.products = products.ProductsResourceWithStreamingResponse(client.products)
         self.misc = misc.MiscResourceWithStreamingResponse(client.misc)
         self.discounts = discounts.DiscountsResourceWithStreamingResponse(client.discounts)
+        self.addons = addons.AddonsResourceWithStreamingResponse(client.addons)
 
 
 class AsyncDodoPaymentsWithStreamedResponse:
@@ -581,6 +589,7 @@ class AsyncDodoPaymentsWithStreamedResponse:
         self.products = products.AsyncProductsResourceWithStreamingResponse(client.products)
         self.misc = misc.AsyncMiscResourceWithStreamingResponse(client.misc)
         self.discounts = discounts.AsyncDiscountsResourceWithStreamingResponse(client.discounts)
+        self.addons = addons.AsyncAddonsResourceWithStreamingResponse(client.addons)
 
 
 Client = DodoPayments

{dodopayments-1.19.0 → dodopayments-1.20.0}/src/dodopayments/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "dodopayments"
-__version__ = "1.19.0"  # x-release-please-version
+__version__ = "1.20.0"  # x-release-please-version

{dodopayments-1.19.0 → dodopayments-1.20.0}/src/dodopayments/resources/__init__.py

@@ -8,6 +8,14 @@ from .misc import (
     MiscResourceWithStreamingResponse,
     AsyncMiscResourceWithStreamingResponse,
 )
+from .addons import (
+    AddonsResource,
+    AsyncAddonsResource,
+    AddonsResourceWithRawResponse,
+    AsyncAddonsResourceWithRawResponse,
+    AddonsResourceWithStreamingResponse,
+    AsyncAddonsResourceWithStreamingResponse,
+)
 from .payouts import (
     PayoutsResource,
     AsyncPayoutsResource,
@@ -198,4 +206,10 @@ __all__ = [
     "AsyncDiscountsResourceWithRawResponse",
     "DiscountsResourceWithStreamingResponse",
     "AsyncDiscountsResourceWithStreamingResponse",
+    "AddonsResource",
+    "AsyncAddonsResource",
+    "AddonsResourceWithRawResponse",
+    "AsyncAddonsResourceWithRawResponse",
+    "AddonsResourceWithStreamingResponse",
+    "AsyncAddonsResourceWithStreamingResponse",
 ]