mergepythonclient 0.0.1__py3-none-any.whl

merge/_base_exceptions.py

@@ -0,0 +1,117 @@
+from typing_extensions import Literal
+
+from httpx import Request, Response
+
+
+class APIError(Exception):
+    message: str
+    request: Request
+
+    def __init__(self, message: str, request: Request) -> None:
+        super().__init__(message)
+        self.request = request
+        self.message = message
+
+
+class APIResponseValidationError(APIError):
+    response: Response
+    status_code: int
+
+    def __init__(self, request: Request, response: Response) -> None:
+        super().__init__("Data returned by API invalid for expected schema.", request)
+        self.response = response
+        self.status_code = response.status_code
+
+
+class APIStatusError(APIError):
+    """Raised when an API response has a status code of 4xx or 5xx."""
+
+    response: Response
+    status_code: int
+
+    body: object
+    """The API response body.
+
+    If the API responded with a valid JSON structure then this property will be the decoded result.
+    If it isn't a valid JSON structure then this will be the raw response.
+    """
+
+    def __init__(self, message: str, *, request: Request, response: Response, body: object) -> None:
+        super().__init__(message, request)
+        self.response = response
+        self.status_code = response.status_code
+        self.body = body
+
+
+class BadRequestError(APIStatusError):
+    status_code: Literal[400]
+
+    def __init__(self, message: str, *, request: Request, response: Response, body: object) -> None:
+        super().__init__(message, request=request, response=response, body=body)
+        self.status_code = 400
+
+
+class AuthenticationError(APIStatusError):
+    status_code: Literal[401]
+
+    def __init__(self, message: str, *, request: Request, response: Response, body: object) -> None:
+        super().__init__(message, request=request, response=response, body=body)
+        self.status_code = 401
+
+
+class PermissionDeniedError(APIStatusError):
+    status_code: Literal[403]
+
+    def __init__(self, message: str, *, request: Request, response: Response, body: object) -> None:
+        super().__init__(message, request=request, response=response, body=body)
+        self.status_code = 403
+
+
+class NotFoundError(APIStatusError):
+    status_code: Literal[404]
+
+    def __init__(self, message: str, *, request: Request, response: Response, body: object) -> None:
+        super().__init__(message, request=request, response=response, body=body)
+        self.status_code = 404
+
+
+class ConflictError(APIStatusError):
+    status_code: Literal[409]
+
+    def __init__(self, message: str, *, request: Request, response: Response, body: object) -> None:
+        super().__init__(message, request=request, response=response, body=body)
+        self.status_code = 409
+
+
+class UnprocessableEntityError(APIStatusError):
+    status_code: Literal[422]
+
+    def __init__(self, message: str, *, request: Request, response: Response, body: object) -> None:
+        super().__init__(message, request=request, response=response, body=body)
+        self.status_code = 422
+
+
+class RateLimitError(APIStatusError):
+    status_code: Literal[429]
+
+    def __init__(self, message: str, *, request: Request, response: Response, body: object) -> None:
+        super().__init__(message, request=request, response=response, body=body)
+        self.status_code = 429
+
+
+class InternalServerError(APIStatusError):
+    status_code: int
+
+    def __init__(self, message: str, *, request: Request, response: Response, body: object) -> None:
+        super().__init__(message, request=request, response=response, body=body)
+        self.status_code = response.status_code
+
+
+class APIConnectionError(APIError):
+    def __init__(self, request: Request, message: str = "Connection error.") -> None:
+        super().__init__(message, request)
+
+
+class APITimeoutError(APIConnectionError):
+    def __init__(self, request: Request) -> None:
+        super().__init__(request, "Request timed out.")

merge/_client.py

@@ -0,0 +1,344 @@
+# File generated from our OpenAPI spec by Stainless.
+
+from __future__ import annotations
+
+import os
+from typing import Union, Mapping, Optional
+
+import httpx
+
+from . import resources
+from ._qs import Querystring
+from ._types import (
+    NOT_GIVEN,
+    Omit,
+    Timeout,
+    NotGiven,
+    Transport,
+    ProxiesTypes,
+    RequestOptions,
+)
+from ._version import __version__
+from ._base_client import DEFAULT_LIMITS, DEFAULT_TIMEOUT, DEFAULT_MAX_RETRIES
+from ._base_client import Stream as Stream
+from ._base_client import AsyncStream as AsyncStream
+from ._base_client import SyncAPIClient, AsyncAPIClient
+
+__all__ = [
+    "Timeout",
+    "Transport",
+    "ProxiesTypes",
+    "RequestOptions",
+    "resources",
+    "Merge",
+    "AsyncMerge",
+    "Client",
+    "AsyncClient",
+]
+
+
+class Merge(SyncAPIClient):
+    hris: resources.HRIS
+    ats: resources.ATS
+    accounting: resources.Accounting
+    ticketing: resources.Ticketing
+    crm: resources.CRM
+    marketing: resources.Marketing
+    file_storage: resources.FileStorage
+
+    # client options
+    api_key: str
+    account_token: str | None
+
+    def __init__(
+        self,
+        *,
+        account_token: str | None = None,
+        base_url: Optional[str] = None,
+        api_key: Optional[str] = None,
+        timeout: Union[float, Timeout, None] = DEFAULT_TIMEOUT,
+        max_retries: int = DEFAULT_MAX_RETRIES,
+        default_headers: Mapping[str, str] | None = None,
+        default_query: Mapping[str, object] | None = None,
+        # See httpx documentation for [custom transports](https://www.python-httpx.org/advanced/#custom-transports)
+        transport: Optional[Transport] = None,
+        # See httpx documentation for [proxies](https://www.python-httpx.org/advanced/#http-proxying)
+        proxies: Optional[ProxiesTypes] = None,
+        # See httpx documentation for [limits](https://www.python-httpx.org/advanced/#pool-limit-configuration)
+        connection_pool_limits: httpx.Limits | None = DEFAULT_LIMITS,
+        # Enable or disable schema validation for data returned by the API.
+        # When enabled an error APIResponseValidationError is raised
+        # if the API responds with invalid data for the expected schema.
+        #
+        # This parameter may be removed or changed in the future.
+        # If you rely on this feature, please open a GitHub issue
+        # outlining your use-case to help us decide if it should be
+        # part of our public interface in the future.
+        _strict_response_validation: bool = False,
+    ) -> None:
+        """Construct a new synchronous merge client instance.
+
+        This automatically infers the `api_key` argument from the `MERGE_API_KEY` environment variable if it is not provided.
+        """
+        api_key = api_key or os.environ.get("MERGE_API_KEY", "")
+        if not api_key:
+            raise Exception(
+                "The api_key client option must be set either by passing api_key to the client or by setting the MERGE_API_KEY environment variable"
+            )
+
+        if base_url is None:
+            base_url = "https://api.merge.dev/api"
+
+        super().__init__(
+            version=__version__,
+            base_url=base_url,
+            max_retries=max_retries,
+            timeout=timeout,
+            transport=transport,
+            proxies=proxies,
+            limits=connection_pool_limits,
+            custom_headers=default_headers,
+            custom_query=default_query,
+            _strict_response_validation=_strict_response_validation,
+        )
+
+        self.api_key = api_key
+
+        self.account_token = account_token or None
+
+        self.hris = resources.HRIS(self)
+        self.ats = resources.ATS(self)
+        self.accounting = resources.Accounting(self)
+        self.ticketing = resources.Ticketing(self)
+        self.crm = resources.CRM(self)
+        self.marketing = resources.Marketing(self)
+        self.file_storage = resources.FileStorage(self)
+
+    @property
+    def qs(self) -> Querystring:
+        return Querystring(array_format="comma")
+
+    @property
+    def auth_headers(self) -> dict[str, str]:
+        api_key = self.api_key
+        return {"Authorization": f"Bearer {api_key}"}
+
+    @property
+    def default_headers(self) -> dict[str, str | Omit]:
+        return {
+            **super().default_headers,
+            "X-Account-Token": self.account_token if self.account_token is not None else Omit(),
+            **self._custom_headers,
+        }
+
+    def copy(
+        self,
+        *,
+        account_token: str | None = None,
+        api_key: str | None = None,
+        base_url: str | None = None,
+        timeout: float | Timeout | None | NotGiven = NOT_GIVEN,
+        connection_pool_limits: httpx.Limits | NotGiven = NOT_GIVEN,
+        max_retries: int | NotGiven = NOT_GIVEN,
+        default_headers: Mapping[str, str] | None = None,
+        set_default_headers: Mapping[str, str] | None = None,
+        default_query: Mapping[str, object] | None = None,
+        set_default_query: Mapping[str, object] | None = None,
+    ) -> Merge:
+        """
+        Create a new client instance re-using the same options given to the current client with optional overriding.
+
+        It should be noted that this does not share the underlying httpx client class which may lead
+        to performance issues.
+        """
+        if default_headers is not None and set_default_headers is not None:
+            raise ValueError("The `default_headers` and `set_default_headers` arguments are mutually exclusive")
+
+        if default_query is not None and set_default_query is not None:
+            raise ValueError("The `default_query` and `set_default_query` arguments are mutually exclusive")
+
+        headers = self._custom_headers
+        if default_headers is not None:
+            headers = {**headers, **default_headers}
+        elif set_default_headers is not None:
+            headers = set_default_headers
+
+        params = self._custom_query
+        if default_query is not None:
+            params = {**params, **default_query}
+        elif set_default_query is not None:
+            params = set_default_query
+
+        # TODO: share the same httpx client between instances
+        return self.__class__(
+            account_token=account_token or self.account_token,
+            base_url=base_url or str(self.base_url),
+            api_key=api_key or self.api_key,
+            timeout=self.timeout if isinstance(timeout, NotGiven) else timeout,
+            connection_pool_limits=self._limits
+            if isinstance(connection_pool_limits, NotGiven)
+            else connection_pool_limits,
+            max_retries=self.max_retries if isinstance(max_retries, NotGiven) else max_retries,
+            default_headers=headers,
+            default_query=params,
+        )
+
+    # Alias for `copy` for nicer inline usage, e.g.
+    # client.with_options(timeout=10).foo.create(...)
+    with_options = copy
+
+
+class AsyncMerge(AsyncAPIClient):
+    hris: resources.AsyncHRIS
+    ats: resources.AsyncATS
+    accounting: resources.AsyncAccounting
+    ticketing: resources.AsyncTicketing
+    crm: resources.AsyncCRM
+    marketing: resources.AsyncMarketing
+    file_storage: resources.AsyncFileStorage
+
+    # client options
+    api_key: str
+    account_token: str | None
+
+    def __init__(
+        self,
+        *,
+        account_token: str | None = None,
+        base_url: Optional[str] = None,
+        api_key: Optional[str] = None,
+        timeout: Union[float, Timeout, None] = DEFAULT_TIMEOUT,
+        max_retries: int = DEFAULT_MAX_RETRIES,
+        default_headers: Mapping[str, str] | None = None,
+        default_query: Mapping[str, object] | None = None,
+        # See httpx documentation for [custom transports](https://www.python-httpx.org/advanced/#custom-transports)
+        transport: Optional[Transport] = None,
+        # See httpx documentation for [proxies](https://www.python-httpx.org/advanced/#http-proxying)
+        proxies: Optional[ProxiesTypes] = None,
+        # See httpx documentation for [limits](https://www.python-httpx.org/advanced/#pool-limit-configuration)
+        connection_pool_limits: httpx.Limits | None = DEFAULT_LIMITS,
+        # Enable or disable schema validation for data returned by the API.
+        # When enabled an error APIResponseValidationError is raised
+        # if the API responds with invalid data for the expected schema.
+        #
+        # This parameter may be removed or changed in the future.
+        # If you rely on this feature, please open a GitHub issue
+        # outlining your use-case to help us decide if it should be
+        # part of our public interface in the future.
+        _strict_response_validation: bool = False,
+    ) -> None:
+        """Construct a new async merge client instance.
+
+        This automatically infers the `api_key` argument from the `MERGE_API_KEY` environment variable if it is not provided.
+        """
+        api_key = api_key or os.environ.get("MERGE_API_KEY", "")
+        if not api_key:
+            raise Exception(
+                "The api_key client option must be set either by passing api_key to the client or by setting the MERGE_API_KEY environment variable"
+            )
+
+        if base_url is None:
+            base_url = "https://api.merge.dev/api"
+
+        super().__init__(
+            version=__version__,
+            base_url=base_url,
+            max_retries=max_retries,
+            timeout=timeout,
+            transport=transport,
+            proxies=proxies,
+            limits=connection_pool_limits,
+            custom_headers=default_headers,
+            custom_query=default_query,
+            _strict_response_validation=_strict_response_validation,
+        )
+
+        self.api_key = api_key
+
+        self.account_token = account_token or None
+
+        self.hris = resources.AsyncHRIS(self)
+        self.ats = resources.AsyncATS(self)
+        self.accounting = resources.AsyncAccounting(self)
+        self.ticketing = resources.AsyncTicketing(self)
+        self.crm = resources.AsyncCRM(self)
+        self.marketing = resources.AsyncMarketing(self)
+        self.file_storage = resources.AsyncFileStorage(self)
+
+    @property
+    def qs(self) -> Querystring:
+        return Querystring(array_format="comma")
+
+    @property
+    def auth_headers(self) -> dict[str, str]:
+        api_key = self.api_key
+        return {"Authorization": f"Bearer {api_key}"}
+
+    @property
+    def default_headers(self) -> dict[str, str | Omit]:
+        return {
+            **super().default_headers,
+            "X-Account-Token": self.account_token if self.account_token is not None else Omit(),
+            **self._custom_headers,
+        }
+
+    def copy(
+        self,
+        *,
+        account_token: str | None = None,
+        api_key: str | None = None,
+        base_url: str | None = None,
+        timeout: float | Timeout | None | NotGiven = NOT_GIVEN,
+        connection_pool_limits: httpx.Limits | NotGiven = NOT_GIVEN,
+        max_retries: int | NotGiven = NOT_GIVEN,
+        default_headers: Mapping[str, str] | None = None,
+        set_default_headers: Mapping[str, str] | None = None,
+        default_query: Mapping[str, object] | None = None,
+        set_default_query: Mapping[str, object] | None = None,
+    ) -> AsyncMerge:
+        """
+        Create a new client instance re-using the same options given to the current client with optional overriding.
+
+        It should be noted that this does not share the underlying httpx client class which may lead
+        to performance issues.
+        """
+        if default_headers is not None and set_default_headers is not None:
+            raise ValueError("The `default_headers` and `set_default_headers` arguments are mutually exclusive")
+
+        if default_query is not None and set_default_query is not None:
+            raise ValueError("The `default_query` and `set_default_query` arguments are mutually exclusive")
+
+        headers = self._custom_headers
+        if default_headers is not None:
+            headers = {**headers, **default_headers}
+        elif set_default_headers is not None:
+            headers = set_default_headers
+
+        params = self._custom_query
+        if default_query is not None:
+            params = {**params, **default_query}
+        elif set_default_query is not None:
+            params = set_default_query
+
+        # TODO: share the same httpx client between instances
+        return self.__class__(
+            account_token=account_token or self.account_token,
+            base_url=base_url or str(self.base_url),
+            api_key=api_key or self.api_key,
+            timeout=self.timeout if isinstance(timeout, NotGiven) else timeout,
+            connection_pool_limits=self._limits
+            if isinstance(connection_pool_limits, NotGiven)
+            else connection_pool_limits,
+            max_retries=self.max_retries if isinstance(max_retries, NotGiven) else max_retries,
+            default_headers=headers,
+            default_query=params,
+        )
+
+    # Alias for `copy` for nicer inline usage, e.g.
+    # client.with_options(timeout=10).foo.create(...)
+    with_options = copy
+
+
+Client = Merge
+
+AsyncClient = AsyncMerge

merge/_exceptions.py

@@ -0,0 +1,31 @@
+# File generated from our OpenAPI spec by Stainless.
+
+from ._base_exceptions import APIError as APIError
+from ._base_exceptions import ConflictError as ConflictError
+from ._base_exceptions import NotFoundError as NotFoundError
+from ._base_exceptions import APIStatusError as APIStatusError
+from ._base_exceptions import RateLimitError as RateLimitError
+from ._base_exceptions import APITimeoutError as APITimeoutError
+from ._base_exceptions import BadRequestError as BadRequestError
+from ._base_exceptions import APIConnectionError as APIConnectionError
+from ._base_exceptions import AuthenticationError as AuthenticationError
+from ._base_exceptions import InternalServerError as InternalServerError
+from ._base_exceptions import PermissionDeniedError as PermissionDeniedError
+from ._base_exceptions import UnprocessableEntityError as UnprocessableEntityError
+from ._base_exceptions import APIResponseValidationError as APIResponseValidationError
+
+__all__ = [
+    "APIError",
+    "APIConnectionError",
+    "APIResponseValidationError",
+    "APIStatusError",
+    "APITimeoutError",
+    "AuthenticationError",
+    "BadRequestError",
+    "ConflictError",
+    "InternalServerError",
+    "NotFoundError",
+    "PermissionDeniedError",
+    "RateLimitError",
+    "UnprocessableEntityError",
+]