moderation_api 1.0.0__py3-none-any.whl

moderation_api/resources/queue/queue.py

@@ -0,0 +1,302 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+import httpx
+
+from .items import (
+    ItemsResource,
+    AsyncItemsResource,
+    ItemsResourceWithRawResponse,
+    AsyncItemsResourceWithRawResponse,
+    ItemsResourceWithStreamingResponse,
+    AsyncItemsResourceWithStreamingResponse,
+)
+from ...types import queue_get_stats_params
+from ..._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
+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.queue_retrieve_response import QueueRetrieveResponse
+from ...types.queue_get_stats_response import QueueGetStatsResponse
+
+__all__ = ["QueueResource", "AsyncQueueResource"]
+
+
+class QueueResource(SyncAPIResource):
+    @cached_property
+    def items(self) -> ItemsResource:
+        return ItemsResource(self._client)
+
+    @cached_property
+    def with_raw_response(self) -> QueueResourceWithRawResponse:
+        """
+        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/moderation-api/sdk-python#accessing-raw-response-data-eg-headers
+        """
+        return QueueResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> QueueResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/moderation-api/sdk-python#with_streaming_response
+        """
+        return QueueResourceWithStreamingResponse(self)
+
+    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,
+    ) -> QueueRetrieveResponse:
+        """
+        Get a queue
+
+        Args:
+          id: The queue ID
+
+          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"/queue/{id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=QueueRetrieveResponse,
+        )
+
+    def get_stats(
+        self,
+        id: str,
+        *,
+        within_days: str | Omit = omit,
+        # 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,
+    ) -> QueueGetStatsResponse:
+        """
+        Get detailed statistics about a moderation queue including review times, action
+        counts, and trends
+
+        Args:
+          id: The queue ID
+
+          within_days: Number of days to analyze statistics for
+
+          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"/queue/{id}/stats",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform({"within_days": within_days}, queue_get_stats_params.QueueGetStatsParams),
+            ),
+            cast_to=QueueGetStatsResponse,
+        )
+
+
+class AsyncQueueResource(AsyncAPIResource):
+    @cached_property
+    def items(self) -> AsyncItemsResource:
+        return AsyncItemsResource(self._client)
+
+    @cached_property
+    def with_raw_response(self) -> AsyncQueueResourceWithRawResponse:
+        """
+        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/moderation-api/sdk-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncQueueResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncQueueResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/moderation-api/sdk-python#with_streaming_response
+        """
+        return AsyncQueueResourceWithStreamingResponse(self)
+
+    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,
+    ) -> QueueRetrieveResponse:
+        """
+        Get a queue
+
+        Args:
+          id: The queue ID
+
+          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"/queue/{id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=QueueRetrieveResponse,
+        )
+
+    async def get_stats(
+        self,
+        id: str,
+        *,
+        within_days: str | Omit = omit,
+        # 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,
+    ) -> QueueGetStatsResponse:
+        """
+        Get detailed statistics about a moderation queue including review times, action
+        counts, and trends
+
+        Args:
+          id: The queue ID
+
+          within_days: Number of days to analyze statistics for
+
+          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"/queue/{id}/stats",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform(
+                    {"within_days": within_days}, queue_get_stats_params.QueueGetStatsParams
+                ),
+            ),
+            cast_to=QueueGetStatsResponse,
+        )
+
+
+class QueueResourceWithRawResponse:
+    def __init__(self, queue: QueueResource) -> None:
+        self._queue = queue
+
+        self.retrieve = to_raw_response_wrapper(
+            queue.retrieve,
+        )
+        self.get_stats = to_raw_response_wrapper(
+            queue.get_stats,
+        )
+
+    @cached_property
+    def items(self) -> ItemsResourceWithRawResponse:
+        return ItemsResourceWithRawResponse(self._queue.items)
+
+
+class AsyncQueueResourceWithRawResponse:
+    def __init__(self, queue: AsyncQueueResource) -> None:
+        self._queue = queue
+
+        self.retrieve = async_to_raw_response_wrapper(
+            queue.retrieve,
+        )
+        self.get_stats = async_to_raw_response_wrapper(
+            queue.get_stats,
+        )
+
+    @cached_property
+    def items(self) -> AsyncItemsResourceWithRawResponse:
+        return AsyncItemsResourceWithRawResponse(self._queue.items)
+
+
+class QueueResourceWithStreamingResponse:
+    def __init__(self, queue: QueueResource) -> None:
+        self._queue = queue
+
+        self.retrieve = to_streamed_response_wrapper(
+            queue.retrieve,
+        )
+        self.get_stats = to_streamed_response_wrapper(
+            queue.get_stats,
+        )
+
+    @cached_property
+    def items(self) -> ItemsResourceWithStreamingResponse:
+        return ItemsResourceWithStreamingResponse(self._queue.items)
+
+
+class AsyncQueueResourceWithStreamingResponse:
+    def __init__(self, queue: AsyncQueueResource) -> None:
+        self._queue = queue
+
+        self.retrieve = async_to_streamed_response_wrapper(
+            queue.retrieve,
+        )
+        self.get_stats = async_to_streamed_response_wrapper(
+            queue.get_stats,
+        )
+
+    @cached_property
+    def items(self) -> AsyncItemsResourceWithStreamingResponse:
+        return AsyncItemsResourceWithStreamingResponse(self._queue.items)

moderation_api/resources/wordlist/__init__.py

@@ -0,0 +1,33 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from .words import (
+    WordsResource,
+    AsyncWordsResource,
+    WordsResourceWithRawResponse,
+    AsyncWordsResourceWithRawResponse,
+    WordsResourceWithStreamingResponse,
+    AsyncWordsResourceWithStreamingResponse,
+)
+from .wordlist import (
+    WordlistResource,
+    AsyncWordlistResource,
+    WordlistResourceWithRawResponse,
+    AsyncWordlistResourceWithRawResponse,
+    WordlistResourceWithStreamingResponse,
+    AsyncWordlistResourceWithStreamingResponse,
+)
+
+__all__ = [
+    "WordsResource",
+    "AsyncWordsResource",
+    "WordsResourceWithRawResponse",
+    "AsyncWordsResourceWithRawResponse",
+    "WordsResourceWithStreamingResponse",
+    "AsyncWordsResourceWithStreamingResponse",
+    "WordlistResource",
+    "AsyncWordlistResource",
+    "WordlistResourceWithRawResponse",
+    "AsyncWordlistResourceWithRawResponse",
+    "WordlistResourceWithStreamingResponse",
+    "AsyncWordlistResourceWithStreamingResponse",
+]