pipedream 2.1.2__tar.gz → 2.1.3__tar.gz

{pipedream-2.1.2 → pipedream-2.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pipedream
-Version: 2.1.2
+Version: 2.1.3
 Summary: 
 Requires-Python: >=3.10,<4.0
 Classifier: Intended Audience :: Developers

{pipedream-2.1.2 → pipedream-2.1.3}/pyproject.toml

@@ -4,7 +4,7 @@ dynamic = ["version"]
 
 [tool.poetry]
 name = "pipedream"
-version = "2.1.2"
+version = "2.1.3"
 description = ""
 readme = "README.md"
 authors = []

pipedream-2.1.3/src/pipedream/apps/client.py

@@ -0,0 +1,326 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.pagination import AsyncPager, SyncPager
+from ..core.request_options import RequestOptions
+from ..types.app import App
+from ..types.get_app_response import GetAppResponse
+from ..types.list_apps_response import ListAppsResponse
+from .raw_client import AsyncRawAppsClient, RawAppsClient
+from .types.apps_list_request_sort_direction import AppsListRequestSortDirection
+from .types.apps_list_request_sort_key import AppsListRequestSortKey
+
+
+class AppsClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._raw_client = RawAppsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> RawAppsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        RawAppsClient
+        """
+        return self._raw_client
+
+    def list(
+        self,
+        *,
+        after: typing.Optional[str] = None,
+        before: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        q: typing.Optional[str] = None,
+        sort_key: typing.Optional[AppsListRequestSortKey] = None,
+        sort_direction: typing.Optional[AppsListRequestSortDirection] = None,
+        category_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        has_components: typing.Optional[bool] = None,
+        has_actions: typing.Optional[bool] = None,
+        has_triggers: typing.Optional[bool] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> SyncPager[App, ListAppsResponse]:
+        """
+        Retrieve all available apps with optional filtering and sorting
+
+        Parameters
+        ----------
+        after : typing.Optional[str]
+            The cursor to start from for pagination
+
+        before : typing.Optional[str]
+            The cursor to end before for pagination
+
+        limit : typing.Optional[int]
+            The maximum number of results to return
+
+        q : typing.Optional[str]
+            A search query to filter the apps
+
+        sort_key : typing.Optional[AppsListRequestSortKey]
+            The key to sort the apps by
+
+        sort_direction : typing.Optional[AppsListRequestSortDirection]
+            The direction to sort the apps
+
+        category_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Only return apps in these categories
+
+        has_components : typing.Optional[bool]
+            Only return apps that have components (actions or triggers)
+
+        has_actions : typing.Optional[bool]
+            Only return apps that have actions
+
+        has_triggers : typing.Optional[bool]
+            Only return apps that have triggers
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        SyncPager[App, ListAppsResponse]
+            apps listed
+
+        Examples
+        --------
+        from pipedream import Pipedream
+
+        client = Pipedream(
+            project_id="YOUR_PROJECT_ID",
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+        response = client.apps.list(
+            after="after",
+            before="before",
+            limit=1,
+            q="q",
+            sort_key="name",
+            sort_direction="asc",
+            category_ids=["category_ids"],
+            has_components=True,
+            has_actions=True,
+            has_triggers=True,
+        )
+        for item in response:
+            yield item
+        # alternatively, you can paginate page-by-page
+        for page in response.iter_pages():
+            yield page
+        """
+        return self._raw_client.list(
+            after=after,
+            before=before,
+            limit=limit,
+            q=q,
+            sort_key=sort_key,
+            sort_direction=sort_direction,
+            category_ids=category_ids,
+            has_components=has_components,
+            has_actions=has_actions,
+            has_triggers=has_triggers,
+            request_options=request_options,
+        )
+
+    def retrieve(self, app_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> GetAppResponse:
+        """
+        Get detailed information about a specific app by ID or name slug
+
+        Parameters
+        ----------
+        app_id : str
+            The name slug or ID of the app (e.g., 'slack', 'github')
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        GetAppResponse
+            app retrieved
+
+        Examples
+        --------
+        from pipedream import Pipedream
+
+        client = Pipedream(
+            project_id="YOUR_PROJECT_ID",
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+        client.apps.retrieve(
+            app_id="app_id",
+        )
+        """
+        _response = self._raw_client.retrieve(app_id, request_options=request_options)
+        return _response.data
+
+
+class AsyncAppsClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._raw_client = AsyncRawAppsClient(client_wrapper=client_wrapper)
+
+    @property
+    def with_raw_response(self) -> AsyncRawAppsClient:
+        """
+        Retrieves a raw implementation of this client that returns raw responses.
+
+        Returns
+        -------
+        AsyncRawAppsClient
+        """
+        return self._raw_client
+
+    async def list(
+        self,
+        *,
+        after: typing.Optional[str] = None,
+        before: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        q: typing.Optional[str] = None,
+        sort_key: typing.Optional[AppsListRequestSortKey] = None,
+        sort_direction: typing.Optional[AppsListRequestSortDirection] = None,
+        category_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        has_components: typing.Optional[bool] = None,
+        has_actions: typing.Optional[bool] = None,
+        has_triggers: typing.Optional[bool] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncPager[App, ListAppsResponse]:
+        """
+        Retrieve all available apps with optional filtering and sorting
+
+        Parameters
+        ----------
+        after : typing.Optional[str]
+            The cursor to start from for pagination
+
+        before : typing.Optional[str]
+            The cursor to end before for pagination
+
+        limit : typing.Optional[int]
+            The maximum number of results to return
+
+        q : typing.Optional[str]
+            A search query to filter the apps
+
+        sort_key : typing.Optional[AppsListRequestSortKey]
+            The key to sort the apps by
+
+        sort_direction : typing.Optional[AppsListRequestSortDirection]
+            The direction to sort the apps
+
+        category_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Only return apps in these categories
+
+        has_components : typing.Optional[bool]
+            Only return apps that have components (actions or triggers)
+
+        has_actions : typing.Optional[bool]
+            Only return apps that have actions
+
+        has_triggers : typing.Optional[bool]
+            Only return apps that have triggers
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncPager[App, ListAppsResponse]
+            apps listed
+
+        Examples
+        --------
+        import asyncio
+
+        from pipedream import AsyncPipedream
+
+        client = AsyncPipedream(
+            project_id="YOUR_PROJECT_ID",
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+
+
+        async def main() -> None:
+            response = await client.apps.list(
+                after="after",
+                before="before",
+                limit=1,
+                q="q",
+                sort_key="name",
+                sort_direction="asc",
+                category_ids=["category_ids"],
+                has_components=True,
+                has_actions=True,
+                has_triggers=True,
+            )
+            async for item in response:
+                yield item
+
+            # alternatively, you can paginate page-by-page
+            async for page in response.iter_pages():
+                yield page
+
+
+        asyncio.run(main())
+        """
+        return await self._raw_client.list(
+            after=after,
+            before=before,
+            limit=limit,
+            q=q,
+            sort_key=sort_key,
+            sort_direction=sort_direction,
+            category_ids=category_ids,
+            has_components=has_components,
+            has_actions=has_actions,
+            has_triggers=has_triggers,
+            request_options=request_options,
+        )
+
+    async def retrieve(self, app_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> GetAppResponse:
+        """
+        Get detailed information about a specific app by ID or name slug
+
+        Parameters
+        ----------
+        app_id : str
+            The name slug or ID of the app (e.g., 'slack', 'github')
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        GetAppResponse
+            app retrieved
+
+        Examples
+        --------
+        import asyncio
+
+        from pipedream import AsyncPipedream
+
+        client = AsyncPipedream(
+            project_id="YOUR_PROJECT_ID",
+            client_id="YOUR_CLIENT_ID",
+            client_secret="YOUR_CLIENT_SECRET",
+        )
+
+
+        async def main() -> None:
+            await client.apps.retrieve(
+                app_id="app_id",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._raw_client.retrieve(app_id, request_options=request_options)
+        return _response.data

pipedream-2.1.3/src/pipedream/apps/raw_client.py

@@ -0,0 +1,344 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from json.decoder import JSONDecodeError
+
+from ..core.api_error import ApiError
+from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
+from ..core.http_response import AsyncHttpResponse, HttpResponse
+from ..core.jsonable_encoder import encode_path_param
+from ..core.pagination import AsyncPager, SyncPager
+from ..core.parse_error import ParsingError
+from ..core.pydantic_utilities import parse_obj_as
+from ..core.request_options import RequestOptions
+from ..types.app import App
+from ..types.get_app_response import GetAppResponse
+from ..types.list_apps_response import ListAppsResponse
+from .types.apps_list_request_sort_direction import AppsListRequestSortDirection
+from .types.apps_list_request_sort_key import AppsListRequestSortKey
+from pydantic import ValidationError
+
+
+class RawAppsClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def list(
+        self,
+        *,
+        after: typing.Optional[str] = None,
+        before: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        q: typing.Optional[str] = None,
+        sort_key: typing.Optional[AppsListRequestSortKey] = None,
+        sort_direction: typing.Optional[AppsListRequestSortDirection] = None,
+        category_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        has_components: typing.Optional[bool] = None,
+        has_actions: typing.Optional[bool] = None,
+        has_triggers: typing.Optional[bool] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> SyncPager[App, ListAppsResponse]:
+        """
+        Retrieve all available apps with optional filtering and sorting
+
+        Parameters
+        ----------
+        after : typing.Optional[str]
+            The cursor to start from for pagination
+
+        before : typing.Optional[str]
+            The cursor to end before for pagination
+
+        limit : typing.Optional[int]
+            The maximum number of results to return
+
+        q : typing.Optional[str]
+            A search query to filter the apps
+
+        sort_key : typing.Optional[AppsListRequestSortKey]
+            The key to sort the apps by
+
+        sort_direction : typing.Optional[AppsListRequestSortDirection]
+            The direction to sort the apps
+
+        category_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Only return apps in these categories
+
+        has_components : typing.Optional[bool]
+            Only return apps that have components (actions or triggers)
+
+        has_actions : typing.Optional[bool]
+            Only return apps that have actions
+
+        has_triggers : typing.Optional[bool]
+            Only return apps that have triggers
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        SyncPager[App, ListAppsResponse]
+            apps listed
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "v1/connect/apps",
+            method="GET",
+            params={
+                "after": after,
+                "before": before,
+                "limit": limit,
+                "q": q,
+                "sort_key": sort_key,
+                "sort_direction": sort_direction,
+                "category_ids": category_ids,
+                "has_components": has_components,
+                "has_actions": has_actions,
+                "has_triggers": has_triggers,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _parsed_response = typing.cast(
+                    ListAppsResponse,
+                    parse_obj_as(
+                        type_=ListAppsResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                _items = _parsed_response.data
+                _has_next = False
+                _get_next = None
+                if _parsed_response.page_info is not None:
+                    _parsed_next = _parsed_response.page_info.end_cursor
+                    _has_next = _parsed_next is not None and _parsed_next != ""
+                    _get_next = lambda: self.list(
+                        after=_parsed_next,
+                        before=before,
+                        limit=limit,
+                        q=q,
+                        sort_key=sort_key,
+                        sort_direction=sort_direction,
+                        category_ids=category_ids,
+                        has_components=has_components,
+                        has_actions=has_actions,
+                        has_triggers=has_triggers,
+                        request_options=request_options,
+                    )
+                return SyncPager(has_next=_has_next, items=_items, get_next=_get_next, response=_parsed_response)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    def retrieve(
+        self, app_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> HttpResponse[GetAppResponse]:
+        """
+        Get detailed information about a specific app by ID or name slug
+
+        Parameters
+        ----------
+        app_id : str
+            The name slug or ID of the app (e.g., 'slack', 'github')
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        HttpResponse[GetAppResponse]
+            app retrieved
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/connect/apps/{encode_path_param(app_id)}",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    GetAppResponse,
+                    parse_obj_as(
+                        type_=GetAppResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return HttpResponse(response=_response, data=_data)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+
+class AsyncRawAppsClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def list(
+        self,
+        *,
+        after: typing.Optional[str] = None,
+        before: typing.Optional[str] = None,
+        limit: typing.Optional[int] = None,
+        q: typing.Optional[str] = None,
+        sort_key: typing.Optional[AppsListRequestSortKey] = None,
+        sort_direction: typing.Optional[AppsListRequestSortDirection] = None,
+        category_ids: typing.Optional[typing.Union[str, typing.Sequence[str]]] = None,
+        has_components: typing.Optional[bool] = None,
+        has_actions: typing.Optional[bool] = None,
+        has_triggers: typing.Optional[bool] = None,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> AsyncPager[App, ListAppsResponse]:
+        """
+        Retrieve all available apps with optional filtering and sorting
+
+        Parameters
+        ----------
+        after : typing.Optional[str]
+            The cursor to start from for pagination
+
+        before : typing.Optional[str]
+            The cursor to end before for pagination
+
+        limit : typing.Optional[int]
+            The maximum number of results to return
+
+        q : typing.Optional[str]
+            A search query to filter the apps
+
+        sort_key : typing.Optional[AppsListRequestSortKey]
+            The key to sort the apps by
+
+        sort_direction : typing.Optional[AppsListRequestSortDirection]
+            The direction to sort the apps
+
+        category_ids : typing.Optional[typing.Union[str, typing.Sequence[str]]]
+            Only return apps in these categories
+
+        has_components : typing.Optional[bool]
+            Only return apps that have components (actions or triggers)
+
+        has_actions : typing.Optional[bool]
+            Only return apps that have actions
+
+        has_triggers : typing.Optional[bool]
+            Only return apps that have triggers
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncPager[App, ListAppsResponse]
+            apps listed
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "v1/connect/apps",
+            method="GET",
+            params={
+                "after": after,
+                "before": before,
+                "limit": limit,
+                "q": q,
+                "sort_key": sort_key,
+                "sort_direction": sort_direction,
+                "category_ids": category_ids,
+                "has_components": has_components,
+                "has_actions": has_actions,
+                "has_triggers": has_triggers,
+            },
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _parsed_response = typing.cast(
+                    ListAppsResponse,
+                    parse_obj_as(
+                        type_=ListAppsResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                _items = _parsed_response.data
+                _has_next = False
+                _get_next = None
+                if _parsed_response.page_info is not None:
+                    _parsed_next = _parsed_response.page_info.end_cursor
+                    _has_next = _parsed_next is not None and _parsed_next != ""
+
+                    async def _get_next():
+                        return await self.list(
+                            after=_parsed_next,
+                            before=before,
+                            limit=limit,
+                            q=q,
+                            sort_key=sort_key,
+                            sort_direction=sort_direction,
+                            category_ids=category_ids,
+                            has_components=has_components,
+                            has_actions=has_actions,
+                            has_triggers=has_triggers,
+                            request_options=request_options,
+                        )
+
+                return AsyncPager(has_next=_has_next, items=_items, get_next=_get_next, response=_parsed_response)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
+
+    async def retrieve(
+        self, app_id: str, *, request_options: typing.Optional[RequestOptions] = None
+    ) -> AsyncHttpResponse[GetAppResponse]:
+        """
+        Get detailed information about a specific app by ID or name slug
+
+        Parameters
+        ----------
+        app_id : str
+            The name slug or ID of the app (e.g., 'slack', 'github')
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        AsyncHttpResponse[GetAppResponse]
+            app retrieved
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/connect/apps/{encode_path_param(app_id)}",
+            method="GET",
+            request_options=request_options,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                _data = typing.cast(
+                    GetAppResponse,
+                    parse_obj_as(
+                        type_=GetAppResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+                return AsyncHttpResponse(response=_response, data=_data)
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
+        except ValidationError as e:
+            raise ParsingError(
+                status_code=_response.status_code, headers=dict(_response.headers), body=_response.json(), cause=e
+            )
+        raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)

{pipedream-2.1.2 → pipedream-2.1.3}/src/pipedream/core/client_wrapper.py

@@ -34,12 +34,12 @@ class BaseClientWrapper:
         import platform
 
         headers: typing.Dict[str, str] = {
-            "User-Agent": "pipedream/2.1.2",
+            "User-Agent": "pipedream/2.1.3",
             "X-Fern-Language": "Python",
             "X-Fern-Runtime": f"python/{platform.python_version()}",
             "X-Fern-Platform": f"{platform.system().lower()}/{platform.release()}",
             "X-Fern-SDK-Name": "pipedream",
-            "X-Fern-SDK-Version": "2.1.2",
+            "X-Fern-SDK-Version": "2.1.3",
             **(self.get_custom_headers() or {}),
         }
         if self._project_environment is not None: