slack-api-sdk-apimatic 1.1.1__py3-none-any.whl

slackwebapi/http/auth/oauth_2.py

@@ -0,0 +1,333 @@
+
+"""
+slackwebapi
+
+This file was automatically generated by APIMATIC v3.0 (
+ https://www.apimatic.io ).
+"""
+
+import os
+
+from apimatic_core.authentication.header_auth import (
+    HeaderAuth,
+)
+from apimatic_core.utilities.auth_helper import (
+    AuthHelper,
+)
+
+from slackwebapi.api_helper import APIHelper
+from slackwebapi.configuration import Server
+from slackwebapi.controllers.oauth_authorization_controller import (
+    OauthAuthorizationController,
+)
+from slackwebapi.models.oauth_token import OauthToken
+
+
+class Oauth2(HeaderAuth):
+    """
+    An authentication handler that applies `AuthorizationCodeAuth` to
+    outgoing requests. It constructs the required credential values and integrates
+    with the core authentication framework.
+    """
+
+    @property
+    def error_message(self):
+        """Return reason about the authentication failure."""
+        return "AuthorizationCodeAuth: OAuthToken is undefined or expired."
+
+    def __init__(self, auth_credentials_model, config):
+        """
+        Initialize the authentication handler with credential data.
+
+        Args:
+            auth_credentials_model: The credentials object used to generate
+                the authorization header.
+            config: The configuration instance.
+
+        """
+        self._oauth_client_id = auth_credentials_model.oauth_client_id \
+            if auth_credentials_model is not None else None
+        self._oauth_client_secret = auth_credentials_model.oauth_client_secret \
+            if auth_credentials_model is not None else None
+        self._oauth_redirect_uri = auth_credentials_model.oauth_redirect_uri \
+            if auth_credentials_model is not None else None
+        if auth_credentials_model is not None \
+                and isinstance(auth_credentials_model.oauth_token, OauthToken):
+            self._oauth_token = OauthToken.from_dictionary(
+                APIHelper.to_dictionary(auth_credentials_model.oauth_token))
+        else:
+            self._oauth_token = auth_credentials_model.oauth_token \
+                if auth_credentials_model is not None else None
+        if auth_credentials_model is not None \
+                and isinstance(auth_credentials_model.oauth_scopes, list):
+            self._oauth_scopes = auth_credentials_model.oauth_scopes
+        else:
+            self._oauth_scopes = None
+        self._config = config
+        self._o_auth_api = OauthAuthorizationController(config)
+        auth_params = {}
+        if (isinstance(self._oauth_token, OauthToken)
+                and hasattr(self._oauth_token, "access_token")):
+            auth_params = {"Authorization": f"Bearer {self._oauth_token.access_token}"}
+        super().__init__(auth_params=auth_params)
+
+    def is_valid(self):
+        """
+        Validate credentials for authentication.
+
+        Returns:
+            bool: True if the credentials are valid, False otherwise.
+
+        """
+        return (self._oauth_token and isinstance(self._oauth_token, OauthToken)
+                and not self.is_token_expired(self._oauth_token))
+
+    def get_authorization_url(self, state=None, additional_params=None):
+        """
+        Build and return an authorization URL. The user is expected to
+        obtain an authorization code from this URL and then call the authorize
+        function with that authorization code.
+
+        Args:
+            state (str): An opaque state string.
+            additional_params (dict): Any additional query parameters
+                to be added to the URL.
+
+        Returns:
+            str: The authorization URL.
+
+        """
+        auth_url = self._config.get_base_uri(Server.AUTH_SERVER)
+        auth_url += "/authorize"
+        query_params = {
+            "response_type": "code",
+            "client_id": self._oauth_client_id,
+            "redirect_uri": self._oauth_redirect_uri,
+        }
+        if self._o_auth_scopes:
+            query_params["scope"] = " ".join(self._o_auth_scopes)
+        if state:
+            query_params["state"] = state
+        if additional_params:
+            query_params.update(additional_params)
+        auth_url = APIHelper.append_url_with_query_parameters(auth_url, query_params)
+        return APIHelper.clean_url(auth_url)
+
+    def build_basic_auth_header(self):
+        """
+        Build the basic auth header for endpoints in the
+        OAuth Authorization Controller.
+
+        Returns:
+            str: The value of the Authentication header.
+
+        """
+        encoded = AuthHelper.get_base64_encoded_value(
+            self._oauth_client_id,
+            self._oauth_client_secret,
+        )
+        return f"Basic {encoded}"
+
+    def fetch_token(self, auth_code, additional_params=None):
+        """
+        Execute call to fetch the OAuth token.
+
+        Args:
+            auth_code (str): The authentication code.
+            additional_params (dict):  Any additional form parameters.
+
+        Returns:
+            OAuthToken: The OAuth token.
+
+        """
+        token = self._o_auth_api.request_token(
+            self.build_basic_auth_header(),
+            auth_code,
+            self._oauth_redirect_uri,
+            _optional_form_parameters=additional_params,
+        ).body
+        if hasattr(token, "expires_in"):
+            current_utc_timestamp = AuthHelper.get_current_utc_timestamp()
+            token.expiry = AuthHelper.get_token_expiry(
+                current_utc_timestamp,
+                token.expires_in,
+            )
+        return token
+
+    def is_token_expired(self, oauth_token=None):
+        """
+        Check if OAuth token has expired.
+
+        Args:
+            oauth_token (OauthToken): The OAuth token whose expiry is to be checked.
+
+        Returns:
+            bool: True if OAuth token has expired, False otherwise.
+
+        """
+        if oauth_token is None:
+            return (hasattr(self._oauth_token, "expiry")
+                    and AuthHelper.is_token_expired(
+                        self._oauth_token.expiry))
+
+        return (hasattr(oauth_token, "expiry")
+                and AuthHelper.is_token_expired(
+                    oauth_token.expiry))
+
+    def refresh_token(self, additional_params=None):
+        """
+        Execute call to refresh the OAuth token.
+
+        Args:
+            additional_params (dict):  Any additional form parameters.
+
+        Returns:
+            OAuthToken: The refreshed OAuth token.
+
+        """
+        token = self._o_auth_api.refresh_token(
+            self.build_basic_auth_header(),
+            self._oauth_token.refresh_token,
+            " ".join(self._oauth_scopes) if self._oauth_scopes else None,
+            _optional_form_parameters=additional_params,
+        ).body
+        if hasattr(token, "expires_in"):
+            current_utc_timestamp = AuthHelper.get_current_utc_timestamp()
+            token.expiry = AuthHelper.get_token_expiry(
+                current_utc_timestamp,
+                token.expires_in,
+            )
+        return token
+
+
+class AuthorizationCodeAuthCredentials:
+    """
+    A model for authentication credentials. Provides simple validation,
+    cloning support, and optional construction from environment variables.
+    Suitable as a pattern for other auth models.
+    """
+
+    @property
+    def oauth_client_id(self):
+        """
+        OAuth 2 Client ID.
+        """
+        return self._oauth_client_id
+
+    @property
+    def oauth_client_secret(self):
+        """
+        OAuth 2 Client Secret.
+        """
+        return self._oauth_client_secret
+
+    @property
+    def oauth_redirect_uri(self):
+        """
+        OAuth 2 Redirection endpoint or Callback Uri.
+        """
+        return self._oauth_redirect_uri
+
+    @property
+    def oauth_token(self):
+        """
+        Object for storing information about the OAuth token.
+        """
+        return self._oauth_token
+
+    @property
+    def oauth_scopes(self):
+        """
+        List of scopes that apply to the OAuth token.
+        """
+        return self._oauth_scopes
+
+    def __init__(self, oauth_client_id, oauth_client_secret, oauth_redirect_uri,
+                 oauth_token=None, oauth_scopes=None):
+        """
+        Initialize the credentials.
+
+        Args:
+            oauth_client_id: The oauth_client_id property value to set.
+            oauth_client_secret: The oauth_client_secret property value to set.
+            oauth_redirect_uri: The oauth_redirect_uri property value to set.
+            oauth_token: The oauth_token property value to set.
+            oauth_scopes: The oauth_scopes property value to set.
+
+        Raises:
+            ValueError: If any required value is missing.
+
+        """
+        if oauth_client_id is None:
+            raise ValueError("oauth_client_id cannot be None")
+        if oauth_client_secret is None:
+            raise ValueError("oauth_client_secret cannot be None")
+        if oauth_redirect_uri is None:
+            raise ValueError("oauth_redirect_uri cannot be None")
+        self._oauth_client_id = oauth_client_id
+        self._oauth_client_secret = oauth_client_secret
+        self._oauth_redirect_uri = oauth_redirect_uri
+        self._oauth_token = oauth_token
+        self._oauth_scopes = oauth_scopes
+
+    def clone_with(self, oauth_client_id=None, oauth_client_secret=None,
+                   oauth_redirect_uri=None, oauth_token=None,
+                   oauth_scopes=None):
+        """
+        Return a new instance with optional value overrides.
+
+        Args:
+            oauth_client_id: The oauth_client_id property value to set.
+            oauth_client_secret: The oauth_client_secret property value to set.
+            oauth_redirect_uri: The oauth_redirect_uri property value to set.
+            oauth_token: The oauth_token property value to set.
+            oauth_scopes: The oauth_scopes property value to set.
+
+        """
+        return AuthorizationCodeAuthCredentials(
+            oauth_client_id or self.oauth_client_id,
+            oauth_client_secret or self.oauth_client_secret,
+            oauth_redirect_uri or self.oauth_redirect_uri,
+            oauth_token or self.oauth_token, oauth_scopes or self.oauth_scopes)
+
+    @classmethod
+    def from_environment(cls):
+        """
+        Create credentials from environment variables, if available.
+
+        Returns:
+            A credentials instance or ``None`` if values are missing.
+
+        """
+        oauth_client_id = os.getenv(
+            "OAUTH_CLIENT_ID",
+            None,
+        )
+        oauth_client_secret = os.getenv(
+            "OAUTH_CLIENT_SECRET",
+            None,
+        )
+        oauth_redirect_uri = os.getenv(
+            "OAUTH_REDIRECT_URI",
+            None,
+        )
+        oauth_scopes = os.getenv(
+            "OAUTH_SCOPES",
+            None,
+        )
+
+        if (oauth_client_id is None
+                or oauth_client_secret is None
+                or oauth_redirect_uri is None):
+            return None
+
+        oauth_scopes = [
+            v.strip() for v in oauth_scopes.split(",") if v.strip()
+        ] if oauth_scopes else None
+
+        return cls(
+            oauth_client_id=oauth_client_id,
+            oauth_client_secret=oauth_client_secret,
+            oauth_redirect_uri=oauth_redirect_uri,
+            oauth_scopes=oauth_scopes,
+        )

slackwebapi/http/http_call_back.py

@@ -0,0 +1,20 @@
+
+"""
+slackwebapi
+
+This file was automatically generated by APIMATIC v3.0 (
+ https://www.apimatic.io ).
+"""
+
+from apimatic_core.http.http_callback import HttpCallBack as CoreHttpCallback
+
+
+class HttpCallBack(CoreHttpCallback):
+    """
+    An interface for the callback to be called before and after the
+    HTTP call for an endpoint is made.
+
+    This class should not be instantiated but should be used as a base class
+    for HttpCallBack classes.
+
+    """

slackwebapi/http/http_client_provider.py

@@ -0,0 +1,23 @@
+"""
+ slackwebapi
+
+ This file was automatically generated by APIMATIC v3.0 ( https://www.apimatic.io ).
+"""
+from abc import ABC
+
+from apimatic_core_interfaces.client.http_client_provider import (
+    HttpClientProvider as CoreHttpClientProvider,
+)
+
+
+class HttpClientProvider(CoreHttpClientProvider, ABC):
+    """
+     Defines a contract for providing HTTP client configuration.
+
+     Classes implementing this interface are expected to supply a configured
+     HTTP session and timeout value that will be used by the SDK's internal
+     HTTP layer when making network requests.
+
+     This allows developers to inject their own custom HTTP clients while
+     maintaining compatibility with the SDK's request/response handling.
+    """

slackwebapi/http/http_method_enum.py

@@ -0,0 +1,25 @@
+
+"""
+slackwebapi
+
+This file was automatically generated by APIMATIC v3.0 (
+ https://www.apimatic.io ).
+"""
+
+from apimatic_core_interfaces.types.http_method_enum import (
+    HttpMethodEnum as CoreHttpMethodEnum,
+)
+
+
+class HttpMethodEnum(CoreHttpMethodEnum):
+    """
+    Enumeration of an HTTP Method
+
+    Attributes:
+        GET: A GET Request
+        POST: A POST Request
+        PUT: A PUT Request
+        PATCH: A PATCH Request
+        DELETE: A DELETE Request
+
+    """

slackwebapi/http/http_request.py

@@ -0,0 +1,55 @@
+
+"""
+slackwebapi
+
+This file was automatically generated by APIMATIC v3.0 (
+ https://www.apimatic.io ).
+"""
+
+from apimatic_core.http.request.http_request import HttpRequest as CoreHttpRequest
+
+
+class HttpRequest(CoreHttpRequest):
+    """
+    Represent an HTTP request to be sent to the server.
+
+    Encapsulates request details such as the HTTP method, target URL, headers,
+     query parameters, body parameters, and any files included with the request.
+
+    Attributes:
+        http_method: The HTTP method to use for the request.
+        query_url (str): The URL to which the request will be sent.
+        headers (dict[str, str] | None): Headers to include with the request.
+        query_parameters (dict[str, str] | None): Query parameters appended
+            to the request URL.
+        parameters (dict[str, str] | None): Form or body parameters sent
+            with the request.
+        files (dict | None): Files to be sent with the request.
+
+    """
+
+    def __init__(self,
+                 http_method,
+                 query_url,
+                 headers=None,
+                 query_parameters=None,
+                 parameters=None,
+                 files=None):
+        """
+        Initialize an HttpRequest instance.
+
+        Args:
+            http_method: The HTTP method to use for the request.
+            query_url: The URL to which the request will be sent.
+            headers: Headers to include with the request.
+            query_parameters: Query parameters appended to the request URL.
+            parameters: Form or body parameters sent with the request.
+            files: Files to be sent with the request.
+
+        """
+        super().__init__(http_method,
+                         query_url,
+                         headers,
+                         query_parameters,
+                         parameters,
+                         files)

slackwebapi/http/http_response.py

@@ -0,0 +1,45 @@
+
+"""
+slackwebapi
+
+This file was automatically generated by APIMATIC v3.0 (
+ https://www.apimatic.io ).
+"""
+
+from apimatic_core.http.response.http_response import HttpResponse as CoreHttpResponse
+
+
+class HttpResponse(CoreHttpResponse):
+    """
+    Represent an HTTP response returned by the server.
+
+    Stores response metadata such as status code, reason phrase, headers, and
+     the raw response body, along with the originating request.
+
+    Attributes:
+        status_code (int): The HTTP status code returned by the server.
+        reason_phrase (str): The reason phrase associated with the status code.
+        headers (dict[str, str]): Response headers as key-value pairs.
+        text (str): The raw response body as a string.
+        request: The request object that resulted in this response.
+
+    """
+
+    def __init__(self,
+                 status_code,
+                 reason_phrase,
+                 headers,
+                 text,
+                 request):
+        """
+        Initialize an HttpResponse instance.
+
+        Args:
+            status_code: The HTTP status code returned by the server.
+            reason_phrase: The reason phrase associated with the status code.
+            headers: Response headers as key-value pairs.
+            text: The raw response body as a string.
+            request: The request object that resulted in this response.
+
+        """
+        super().__init__(status_code, reason_phrase, headers, text, request)

slackwebapi/http/proxy_settings.py

@@ -0,0 +1,50 @@
+"""
+slackwebapi
+
+This file was automatically generated by APIMATIC v3.0 (
+ https://www.apimatic.io ).
+"""
+
+import os
+from typing import Optional
+
+from apimatic_core.http.configurations.proxy_settings import (
+    ProxySettings as CoreProxySettings,
+)
+
+
+class ProxySettings(CoreProxySettings):
+    """A simple data model for configuring HTTP(S) proxy settings."""
+
+    @classmethod
+    def from_environment(cls) -> Optional["ProxySettings"]:
+        """
+        Create an instance of this class using environment-based configuration.
+
+        This method attempts to construct and return an instance using relevant
+        environment variables, if available. If the required configuration is
+        not present, it may return `None` to indicate that no valid instance
+        could be created.
+
+        Returns:
+            Optional[cls]: A configured instance of this class, or `None` if
+            configuration data is missing or invalid.
+
+        """
+        address = os.getenv("PROXY_ADDRESS", None)
+        if not address:
+            return None
+
+        port = os.getenv("PROXY_PORT", None)
+        if port is not None:
+            try:
+                port = int(port)
+            except (TypeError, ValueError):
+                port = None
+
+        return cls(
+            address=address,
+            port=port,
+            username=os.getenv("PROXY_USERNAME", None),
+            password=os.getenv("PROXY_PASSWORD", None),
+        )

slackwebapi/logging/__init__.py

@@ -0,0 +1,6 @@
+# ruff: noqa: D104 | Missing docstring in public package
+# ruff: noqa: RUF022 | `__all__` is not sorted
+__all__ = [
+    "configuration",
+    "sdk_logger",
+]

slackwebapi/logging/configuration/__init__.py

@@ -0,0 +1,5 @@
+# ruff: noqa: D104 | Missing docstring in public package
+# ruff: noqa: RUF022 | `__all__` is not sorted
+__all__ = [
+    "api_logging_configuration",
+]