wavix-python-sdk 1.0.0__py3-none-any.whl

wavix/cart/client.py

@@ -0,0 +1,327 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.request_options import RequestOptions
+from .raw_client import AsyncRawCartClient, RawCartClient
+from .types.checkout_cart_response import CheckoutCartResponse
+from .types.get_cart_response import GetCartResponse
+from .types.remove_cart_response import RemoveCartResponse
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class CartClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._raw_client = RawCartClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawCartClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawCartClient
+        """
+        return self._raw_client
+
+    def get(self, *, request_options: typing.Optional[RequestOptions] = None) -> GetCartResponse:
+        """
+        Returns the current purchase cart, including the phone numbers it contains and the documents each requires.
+
+        Parameters
+        ----------
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        GetCartResponse
+            Returns the cart.
+
+        Examples
+        --------
+        from wavix import Wavix
+
+        client = Wavix(
+            token="YOUR_TOKEN",
+        )
+        client.cart.get()
+        """
+        _response = self._raw_client.get(request_options=request_options)
+        return _response.data
+
+    def add(
+        self, *, ids: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.List[typing.Any]:
+        """
+        Adds the listed phone numbers to the purchase cart.
+
+        Parameters
+        ----------
+        ids : typing.Sequence[str]
+            Phone numbers to add to the cart.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[typing.Any]
+            Returns the phone numbers now in the cart.
+
+        Examples
+        --------
+        from wavix import Wavix
+
+        client = Wavix(
+            token="YOUR_TOKEN",
+        )
+        client.cart.add(
+            ids=["541139862174", "541139862175"],
+        )
+        """
+        _response = self._raw_client.add(ids=ids, request_options=request_options)
+        return _response.data
+
+    def remove(
+        self, *, ids: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None
+    ) -> RemoveCartResponse:
+        """
+        Removes the listed phone numbers from the purchase cart.
+
+        Parameters
+        ----------
+        ids : typing.Sequence[str]
+            Phone numbers to remove from the cart.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        RemoveCartResponse
+            Returns a success confirmation. The numbers are removed from the cart.
+
+        Examples
+        --------
+        from wavix import Wavix
+
+        client = Wavix(
+            token="YOUR_TOKEN",
+        )
+        client.cart.remove(
+            ids=["541139862174", "541139862175"],
+        )
+        """
+        _response = self._raw_client.remove(ids=ids, request_options=request_options)
+        return _response.data
+
+    def checkout(
+        self, *, ids: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None
+    ) -> CheckoutCartResponse:
+        """
+        Purchases the listed phone numbers from the cart. Activation and monthly fees are deducted from the account balance.
+
+        Parameters
+        ----------
+        ids : typing.Sequence[str]
+            Phone numbers from the cart to purchase.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        CheckoutCartResponse
+            Returns a success confirmation. The phone numbers are purchased.
+
+        Examples
+        --------
+        from wavix import Wavix
+
+        client = Wavix(
+            token="YOUR_TOKEN",
+        )
+        client.cart.checkout(
+            ids=["541139862174", "541139862175"],
+        )
+        """
+        _response = self._raw_client.checkout(ids=ids, request_options=request_options)
+        return _response.data
+
+
+class AsyncCartClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._raw_client = AsyncRawCartClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawCartClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawCartClient
+        """
+        return self._raw_client
+
+    async def get(self, *, request_options: typing.Optional[RequestOptions] = None) -> GetCartResponse:
+        """
+        Returns the current purchase cart, including the phone numbers it contains and the documents each requires.
+
+        Parameters
+        ----------
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        GetCartResponse
+            Returns the cart.
+
+        Examples
+        --------
+        import asyncio
+
+        from wavix import AsyncWavix
+
+        client = AsyncWavix(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.cart.get()
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.get(request_options=request_options)
+        return _response.data
+
+    async def add(
+        self, *, ids: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None
+    ) -> typing.List[typing.Any]:
+        """
+        Adds the listed phone numbers to the purchase cart.
+
+        Parameters
+        ----------
+        ids : typing.Sequence[str]
+            Phone numbers to add to the cart.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        typing.List[typing.Any]
+            Returns the phone numbers now in the cart.
+
+        Examples
+        --------
+        import asyncio
+
+        from wavix import AsyncWavix
+
+        client = AsyncWavix(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.cart.add(
+                ids=["541139862174", "541139862175"],
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.add(ids=ids, request_options=request_options)
+        return _response.data
+
+    async def remove(
+        self, *, ids: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None
+    ) -> RemoveCartResponse:
+        """
+        Removes the listed phone numbers from the purchase cart.
+
+        Parameters
+        ----------
+        ids : typing.Sequence[str]
+            Phone numbers to remove from the cart.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        RemoveCartResponse
+            Returns a success confirmation. The numbers are removed from the cart.
+
+        Examples
+        --------
+        import asyncio
+
+        from wavix import AsyncWavix
+
+        client = AsyncWavix(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.cart.remove(
+                ids=["541139862174", "541139862175"],
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.remove(ids=ids, request_options=request_options)
+        return _response.data
+
+    async def checkout(
+        self, *, ids: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None
+    ) -> CheckoutCartResponse:
+        """
+        Purchases the listed phone numbers from the cart. Activation and monthly fees are deducted from the account balance.
+
+        Parameters
+        ----------
+        ids : typing.Sequence[str]
+            Phone numbers from the cart to purchase.
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        CheckoutCartResponse
+            Returns a success confirmation. The phone numbers are purchased.
+
+        Examples
+        --------
+        import asyncio
+
+        from wavix import AsyncWavix
+
+        client = AsyncWavix(
+            token="YOUR_TOKEN",
+        )
+
+
+        async def main() -> None:
+            await client.cart.checkout(
+                ids=["541139862174", "541139862175"],
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.checkout(ids=ids, request_options=request_options)
+        return _response.data