dodopayments 1.22.0__py3-none-any.whl → 1.27.0__py3-none-any.whl

dodopayments/__init__.py

@@ -1,5 +1,7 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+import typing as _t
+
 from . import types
 from ._types import NOT_GIVEN, Omit, NoneType, NotGiven, Transport, ProxiesTypes
 from ._utils import file_from_path
@@ -80,6 +82,9 @@ __all__ = [
     "DefaultAsyncHttpxClient",
 ]
 
+if not _t.TYPE_CHECKING:
+    from ._utils._resources_proxy import resources as resources
+
 _setup_logging()
 
 # Update the __module__ attribute for exported symbols so that

dodopayments/_client.py

@@ -24,6 +24,7 @@ from ._version import __version__
 from .resources import (
     misc,
     addons,
+    brands,
     payouts,
     refunds,
     disputes,
@@ -80,6 +81,7 @@ class DodoPayments(SyncAPIClient):
     misc: misc.MiscResource
     discounts: discounts.DiscountsResource
     addons: addons.AddonsResource
+    brands: brands.BrandsResource
     with_raw_response: DodoPaymentsWithRawResponse
     with_streaming_response: DodoPaymentsWithStreamedResponse
 
@@ -176,6 +178,7 @@ class DodoPayments(SyncAPIClient):
         self.misc = misc.MiscResource(self)
         self.discounts = discounts.DiscountsResource(self)
         self.addons = addons.AddonsResource(self)
+        self.brands = brands.BrandsResource(self)
         self.with_raw_response = DodoPaymentsWithRawResponse(self)
         self.with_streaming_response = DodoPaymentsWithStreamedResponse(self)
 
@@ -302,6 +305,7 @@ class AsyncDodoPayments(AsyncAPIClient):
     misc: misc.AsyncMiscResource
     discounts: discounts.AsyncDiscountsResource
     addons: addons.AsyncAddonsResource
+    brands: brands.AsyncBrandsResource
     with_raw_response: AsyncDodoPaymentsWithRawResponse
     with_streaming_response: AsyncDodoPaymentsWithStreamedResponse
 
@@ -398,6 +402,7 @@ class AsyncDodoPayments(AsyncAPIClient):
         self.misc = misc.AsyncMiscResource(self)
         self.discounts = discounts.AsyncDiscountsResource(self)
         self.addons = addons.AsyncAddonsResource(self)
+        self.brands = brands.AsyncBrandsResource(self)
         self.with_raw_response = AsyncDodoPaymentsWithRawResponse(self)
         self.with_streaming_response = AsyncDodoPaymentsWithStreamedResponse(self)
 
@@ -527,6 +532,7 @@ class DodoPaymentsWithRawResponse:
         self.misc = misc.MiscResourceWithRawResponse(client.misc)
         self.discounts = discounts.DiscountsResourceWithRawResponse(client.discounts)
         self.addons = addons.AddonsResourceWithRawResponse(client.addons)
+        self.brands = brands.BrandsResourceWithRawResponse(client.brands)
 
 
 class AsyncDodoPaymentsWithRawResponse:
@@ -548,6 +554,7 @@ class AsyncDodoPaymentsWithRawResponse:
         self.misc = misc.AsyncMiscResourceWithRawResponse(client.misc)
         self.discounts = discounts.AsyncDiscountsResourceWithRawResponse(client.discounts)
         self.addons = addons.AsyncAddonsResourceWithRawResponse(client.addons)
+        self.brands = brands.AsyncBrandsResourceWithRawResponse(client.brands)
 
 
 class DodoPaymentsWithStreamedResponse:
@@ -569,6 +576,7 @@ class DodoPaymentsWithStreamedResponse:
         self.misc = misc.MiscResourceWithStreamingResponse(client.misc)
         self.discounts = discounts.DiscountsResourceWithStreamingResponse(client.discounts)
         self.addons = addons.AddonsResourceWithStreamingResponse(client.addons)
+        self.brands = brands.BrandsResourceWithStreamingResponse(client.brands)
 
 
 class AsyncDodoPaymentsWithStreamedResponse:
@@ -590,6 +598,7 @@ class AsyncDodoPaymentsWithStreamedResponse:
         self.misc = misc.AsyncMiscResourceWithStreamingResponse(client.misc)
         self.discounts = discounts.AsyncDiscountsResourceWithStreamingResponse(client.discounts)
         self.addons = addons.AsyncAddonsResourceWithStreamingResponse(client.addons)
+        self.brands = brands.AsyncBrandsResourceWithStreamingResponse(client.brands)
 
 
 Client = DodoPayments

dodopayments/_utils/_resources_proxy.py

@@ -0,0 +1,24 @@
+from __future__ import annotations
+
+from typing import Any
+from typing_extensions import override
+
+from ._proxy import LazyProxy
+
+
+class ResourcesProxy(LazyProxy[Any]):
+    """A proxy for the `dodopayments.resources` module.
+
+    This is used so that we can lazily import `dodopayments.resources` only when
+    needed *and* so that users can just import `dodopayments` and reference `dodopayments.resources`
+    """
+
+    @override
+    def __load__(self) -> Any:
+        import importlib
+
+        mod = importlib.import_module("dodopayments.resources")
+        return mod
+
+
+resources = ResourcesProxy().__as_proxied__()

dodopayments/_version.py

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

dodopayments/resources/__init__.py

@@ -16,6 +16,14 @@ from .addons import (
     AddonsResourceWithStreamingResponse,
     AsyncAddonsResourceWithStreamingResponse,
 )
+from .brands import (
+    BrandsResource,
+    AsyncBrandsResource,
+    BrandsResourceWithRawResponse,
+    AsyncBrandsResourceWithRawResponse,
+    BrandsResourceWithStreamingResponse,
+    AsyncBrandsResourceWithStreamingResponse,
+)
 from .payouts import (
     PayoutsResource,
     AsyncPayoutsResource,
@@ -212,4 +220,10 @@ __all__ = [
     "AsyncAddonsResourceWithRawResponse",
     "AddonsResourceWithStreamingResponse",
     "AsyncAddonsResourceWithStreamingResponse",
+    "BrandsResource",
+    "AsyncBrandsResource",
+    "BrandsResourceWithRawResponse",
+    "AsyncBrandsResourceWithRawResponse",
+    "BrandsResourceWithStreamingResponse",
+    "AsyncBrandsResourceWithStreamingResponse",
 ]

dodopayments/resources/brands.py

@@ -0,0 +1,495 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+
+import httpx
+
+from ..types import brand_create_params, brand_update_params
+from .._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from .._utils import maybe_transform, async_maybe_transform
+from .._compat import cached_property
+from .._resource import SyncAPIResource, AsyncAPIResource
+from .._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from .._base_client import make_request_options
+from ..types.brand_list_response import BrandListResponse
+from ..types.brand_create_response import BrandCreateResponse
+from ..types.brand_update_response import BrandUpdateResponse
+from ..types.brand_retrieve_response import BrandRetrieveResponse
+from ..types.brand_update_images_response import BrandUpdateImagesResponse
+
+__all__ = ["BrandsResource", "AsyncBrandsResource"]
+
+
+class BrandsResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> BrandsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/dodopayments/dodopayments-python#accessing-raw-response-data-eg-headers
+        """
+        return BrandsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> BrandsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/dodopayments/dodopayments-python#with_streaming_response
+        """
+        return BrandsResourceWithStreamingResponse(self)
+
+    def create(
+        self,
+        *,
+        description: Optional[str] | NotGiven = NOT_GIVEN,
+        name: Optional[str] | NotGiven = NOT_GIVEN,
+        statement_descriptor: Optional[str] | NotGiven = NOT_GIVEN,
+        support_email: Optional[str] | NotGiven = NOT_GIVEN,
+        url: Optional[str] | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> BrandCreateResponse:
+        """
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return self._post(
+            "/brands",
+            body=maybe_transform(
+                {
+                    "description": description,
+                    "name": name,
+                    "statement_descriptor": statement_descriptor,
+                    "support_email": support_email,
+                    "url": url,
+                },
+                brand_create_params.BrandCreateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BrandCreateResponse,
+        )
+
+    def retrieve(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> BrandRetrieveResponse:
+        """
+        Thin handler just calls `get_brand` and wraps in `Json(...)`
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._get(
+            f"/brands/{id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BrandRetrieveResponse,
+        )
+
+    def update(
+        self,
+        id: str,
+        *,
+        image_id: Optional[str] | NotGiven = NOT_GIVEN,
+        name: Optional[str] | NotGiven = NOT_GIVEN,
+        statement_descriptor: Optional[str] | NotGiven = NOT_GIVEN,
+        support_email: Optional[str] | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> BrandUpdateResponse:
+        """
+        Args:
+          image_id: The UUID you got back from the presigned‐upload call
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._patch(
+            f"/brands/{id}",
+            body=maybe_transform(
+                {
+                    "image_id": image_id,
+                    "name": name,
+                    "statement_descriptor": statement_descriptor,
+                    "support_email": support_email,
+                },
+                brand_update_params.BrandUpdateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BrandUpdateResponse,
+        )
+
+    def list(
+        self,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> BrandListResponse:
+        return self._get(
+            "/brands",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BrandListResponse,
+        )
+
+    def update_images(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> BrandUpdateImagesResponse:
+        """
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._put(
+            f"/brands/{id}/images",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BrandUpdateImagesResponse,
+        )
+
+
+class AsyncBrandsResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncBrandsResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/dodopayments/dodopayments-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncBrandsResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncBrandsResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/dodopayments/dodopayments-python#with_streaming_response
+        """
+        return AsyncBrandsResourceWithStreamingResponse(self)
+
+    async def create(
+        self,
+        *,
+        description: Optional[str] | NotGiven = NOT_GIVEN,
+        name: Optional[str] | NotGiven = NOT_GIVEN,
+        statement_descriptor: Optional[str] | NotGiven = NOT_GIVEN,
+        support_email: Optional[str] | NotGiven = NOT_GIVEN,
+        url: Optional[str] | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> BrandCreateResponse:
+        """
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        return await self._post(
+            "/brands",
+            body=await async_maybe_transform(
+                {
+                    "description": description,
+                    "name": name,
+                    "statement_descriptor": statement_descriptor,
+                    "support_email": support_email,
+                    "url": url,
+                },
+                brand_create_params.BrandCreateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BrandCreateResponse,
+        )
+
+    async def retrieve(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> BrandRetrieveResponse:
+        """
+        Thin handler just calls `get_brand` and wraps in `Json(...)`
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return await self._get(
+            f"/brands/{id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BrandRetrieveResponse,
+        )
+
+    async def update(
+        self,
+        id: str,
+        *,
+        image_id: Optional[str] | NotGiven = NOT_GIVEN,
+        name: Optional[str] | NotGiven = NOT_GIVEN,
+        statement_descriptor: Optional[str] | NotGiven = NOT_GIVEN,
+        support_email: Optional[str] | NotGiven = NOT_GIVEN,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> BrandUpdateResponse:
+        """
+        Args:
+          image_id: The UUID you got back from the presigned‐upload call
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return await self._patch(
+            f"/brands/{id}",
+            body=await async_maybe_transform(
+                {
+                    "image_id": image_id,
+                    "name": name,
+                    "statement_descriptor": statement_descriptor,
+                    "support_email": support_email,
+                },
+                brand_update_params.BrandUpdateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BrandUpdateResponse,
+        )
+
+    async def list(
+        self,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> BrandListResponse:
+        return await self._get(
+            "/brands",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BrandListResponse,
+        )
+
+    async def update_images(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> BrandUpdateImagesResponse:
+        """
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return await self._put(
+            f"/brands/{id}/images",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=BrandUpdateImagesResponse,
+        )
+
+
+class BrandsResourceWithRawResponse:
+    def __init__(self, brands: BrandsResource) -> None:
+        self._brands = brands
+
+        self.create = to_raw_response_wrapper(
+            brands.create,
+        )
+        self.retrieve = to_raw_response_wrapper(
+            brands.retrieve,
+        )
+        self.update = to_raw_response_wrapper(
+            brands.update,
+        )
+        self.list = to_raw_response_wrapper(
+            brands.list,
+        )
+        self.update_images = to_raw_response_wrapper(
+            brands.update_images,
+        )
+
+
+class AsyncBrandsResourceWithRawResponse:
+    def __init__(self, brands: AsyncBrandsResource) -> None:
+        self._brands = brands
+
+        self.create = async_to_raw_response_wrapper(
+            brands.create,
+        )
+        self.retrieve = async_to_raw_response_wrapper(
+            brands.retrieve,
+        )
+        self.update = async_to_raw_response_wrapper(
+            brands.update,
+        )
+        self.list = async_to_raw_response_wrapper(
+            brands.list,
+        )
+        self.update_images = async_to_raw_response_wrapper(
+            brands.update_images,
+        )
+
+
+class BrandsResourceWithStreamingResponse:
+    def __init__(self, brands: BrandsResource) -> None:
+        self._brands = brands
+
+        self.create = to_streamed_response_wrapper(
+            brands.create,
+        )
+        self.retrieve = to_streamed_response_wrapper(
+            brands.retrieve,
+        )
+        self.update = to_streamed_response_wrapper(
+            brands.update,
+        )
+        self.list = to_streamed_response_wrapper(
+            brands.list,
+        )
+        self.update_images = to_streamed_response_wrapper(
+            brands.update_images,
+        )
+
+
+class AsyncBrandsResourceWithStreamingResponse:
+    def __init__(self, brands: AsyncBrandsResource) -> None:
+        self._brands = brands
+
+        self.create = async_to_streamed_response_wrapper(
+            brands.create,
+        )
+        self.retrieve = async_to_streamed_response_wrapper(
+            brands.retrieve,
+        )
+        self.update = async_to_streamed_response_wrapper(
+            brands.update,
+        )
+        self.list = async_to_streamed_response_wrapper(
+            brands.list,
+        )
+        self.update_images = async_to_streamed_response_wrapper(
+            brands.update_images,
+        )