From bb5bde0271ef4b2a3d543e943738f46a5572ddcf Mon Sep 17 00:00:00 2001 From: Kazuhiro Sera Date: Tue, 17 Sep 2024 09:50:44 +0900 Subject: [PATCH] version 3.33.0 --- .../slack_sdk/aiohttp_version_checker.html | 75 +- .../slack_sdk/audit_logs/async_client.html | 176 +- .../api-docs/slack_sdk/audit_logs/index.html | 188 +- .../slack_sdk/audit_logs/v1/async_client.html | 531 +- .../slack_sdk/audit_logs/v1/client.html | 537 +- .../slack_sdk/audit_logs/v1/index.html | 37 +- .../audit_logs/v1/internal_utils.html | 73 +- .../slack_sdk/audit_logs/v1/logs.html | 1212 +- .../slack_sdk/audit_logs/v1/response.html | 69 +- .../api-docs/slack_sdk/errors/index.html | 91 +- .../slack_sdk/http_retry/async_handler.html | 157 +- .../http_retry/builtin_async_handlers.html | 224 +- .../http_retry/builtin_handlers.html | 216 +- .../builtin_interval_calculators.html | 77 +- .../slack_sdk/http_retry/handler.html | 151 +- .../api-docs/slack_sdk/http_retry/index.html | 245 +- .../http_retry/interval_calculator.html | 59 +- .../api-docs/slack_sdk/http_retry/jitter.html | 73 +- .../slack_sdk/http_retry/request.html | 82 +- .../slack_sdk/http_retry/response.html | 56 +- .../api-docs/slack_sdk/http_retry/state.html | 62 +- docs/static/api-docs/slack_sdk/index.html | 6712 ++++++++- .../slack_sdk/models/attachments/index.html | 750 +- .../slack_sdk/models/basic_objects.html | 213 +- .../models/blocks/basic_components.html | 865 +- .../models/blocks/block_elements.html | 2254 ++- .../slack_sdk/models/blocks/blocks.html | 750 +- .../slack_sdk/models/blocks/index.html | 521 +- .../api-docs/slack_sdk/models/dialoags.html | 665 +- .../slack_sdk/models/dialogs/index.html | 1557 +- .../api-docs/slack_sdk/models/index.html | 202 +- .../slack_sdk/models/messages/index.html | 118 +- .../slack_sdk/models/messages/message.html | 118 +- .../slack_sdk/models/metadata/index.html | 63 +- .../slack_sdk/models/views/index.html | 268 +- .../oauth/authorize_url_generator/index.html | 140 +- .../api-docs/slack_sdk/oauth/index.html | 296 +- .../installation_store/amazon_s3/index.html | 386 +- .../async_cacheable_installation_store.html | 171 +- .../async_installation_store.html | 215 +- .../cacheable_installation_store.html | 171 +- .../oauth/installation_store/file/index.html | 289 +- .../oauth/installation_store/index.html | 252 +- .../installation_store.html | 219 +- .../oauth/installation_store/internals.html | 80 +- .../oauth/installation_store/models/bot.html | 183 +- .../installation_store/models/index.html | 155 +- .../models/installation.html | 303 +- .../installation_store/sqlalchemy/index.html | 490 +- .../installation_store/sqlite3/index.html | 756 +- .../redirect_uri_page_renderer/index.html | 168 +- .../oauth/state_store/amazon_s3/index.html | 159 +- .../oauth/state_store/async_state_store.html | 62 +- .../oauth/state_store/file/index.html | 155 +- .../slack_sdk/oauth/state_store/index.html | 112 +- .../oauth/state_store/sqlalchemy/index.html | 169 +- .../oauth/state_store/sqlite3/index.html | 226 +- .../oauth/state_store/state_store.html | 62 +- .../slack_sdk/oauth/state_utils/index.html | 109 +- .../oauth/token_rotation/async_rotator.html | 306 +- .../slack_sdk/oauth/token_rotation/index.html | 168 +- .../oauth/token_rotation/rotator.html | 298 +- .../slack_sdk/proxy_env_variable_loader.html | 78 +- docs/static/api-docs/slack_sdk/rtm/index.html | 772 +- .../api-docs/slack_sdk/rtm/v2/index.html | 320 +- .../api-docs/slack_sdk/rtm_v2/index.html | 706 +- .../api-docs/slack_sdk/scim/async_client.html | 236 +- .../static/api-docs/slack_sdk/scim/index.html | 282 +- .../slack_sdk/scim/v1/async_client.html | 633 +- .../api-docs/slack_sdk/scim/v1/client.html | 651 +- .../slack_sdk/scim/v1/default_arg.html | 38 +- .../api-docs/slack_sdk/scim/v1/group.html | 132 +- .../api-docs/slack_sdk/scim/v1/index.html | 39 +- .../slack_sdk/scim/v1/internal_utils.html | 182 +- .../api-docs/slack_sdk/scim/v1/response.html | 517 +- .../api-docs/slack_sdk/scim/v1/types.html | 67 +- .../api-docs/slack_sdk/scim/v1/user.html | 364 +- .../api-docs/slack_sdk/signature/index.html | 171 +- .../slack_sdk/socket_mode/aiohttp/index.html | 859 +- .../slack_sdk/socket_mode/async_client.html | 380 +- .../socket_mode/async_listeners.html | 113 +- .../slack_sdk/socket_mode/builtin/client.html | 433 +- .../socket_mode/builtin/connection.html | 877 +- .../socket_mode/builtin/frame_header.html | 80 +- .../slack_sdk/socket_mode/builtin/index.html | 148 +- .../socket_mode/builtin/internals.html | 441 +- .../slack_sdk/socket_mode/client.html | 351 +- .../api-docs/slack_sdk/socket_mode/index.html | 154 +- .../socket_mode/interval_runner.html | 91 +- .../slack_sdk/socket_mode/listeners.html | 50 +- .../slack_sdk/socket_mode/logger/index.html | 28 +- .../socket_mode/logger/messages.html | 47 +- .../slack_sdk/socket_mode/request.html | 117 +- .../slack_sdk/socket_mode/response.html | 71 +- .../socket_mode/websocket_client/index.html | 411 +- .../socket_mode/websockets/index.html | 479 +- docs/static/api-docs/slack_sdk/version.html | 35 +- .../slack_sdk/web/async_base_client.html | 358 +- .../api-docs/slack_sdk/web/async_client.html | 12440 ++++++++++++++- .../slack_sdk/web/async_internal_utils.html | 252 +- .../slack_sdk/web/async_slack_response.html | 276 +- .../api-docs/slack_sdk/web/base_client.html | 769 +- .../static/api-docs/slack_sdk/web/client.html | 12431 ++++++++++++++- .../api-docs/slack_sdk/web/deprecation.html | 127 +- .../slack_sdk/web/file_upload_v2_result.html | 40 +- docs/static/api-docs/slack_sdk/web/index.html | 6648 ++++++++- .../slack_sdk/web/internal_utils.html | 497 +- .../slack_sdk/web/legacy_base_client.html | 741 +- .../api-docs/slack_sdk/web/legacy_client.html | 12442 +++++++++++++++- .../slack_sdk/web/legacy_slack_response.html | 302 +- .../slack_sdk/web/slack_response.html | 272 +- .../slack_sdk/webhook/async_client.html | 375 +- .../api-docs/slack_sdk/webhook/client.html | 385 +- .../api-docs/slack_sdk/webhook/index.html | 116 +- .../slack_sdk/webhook/internal_utils.html | 78 +- .../slack_sdk/webhook/webhook_response.html | 49 +- slack_sdk/version.py | 2 +- 117 files changed, 81964 insertions(+), 2536 deletions(-) diff --git a/docs/static/api-docs/slack_sdk/aiohttp_version_checker.html b/docs/static/api-docs/slack_sdk/aiohttp_version_checker.html index ab2134685..27747363f 100644 --- a/docs/static/api-docs/slack_sdk/aiohttp_version_checker.html +++ b/docs/static/api-docs/slack_sdk/aiohttp_version_checker.html @@ -2,21 +2,18 @@ - - + + slack_sdk.aiohttp_version_checker API documentation - - - - - - + + + + + + - - + +
@@ -26,6 +23,34 @@

Module slack_sdk.aiohttp_version_checker

Internal module for checking aiohttp compatibility of async modules

+
+ +Expand source code + +
"""Internal module for checking aiohttp compatibility of async modules"""
+import logging
+from typing import Callable
+
+
+def _print_warning_log(message: str) -> None:
+    logging.getLogger(__name__).warning(message)
+
+
+def validate_aiohttp_version(
+    aiohttp_version: str,
+    print_warning: Callable[[str], None] = _print_warning_log,
+):
+    if aiohttp_version is not None:
+        elements = aiohttp_version.split(".")
+        if len(elements) >= 3:
+            # patch version can be a non-numeric value
+            major, minor, patch = int(elements[0]), int(elements[1]), elements[2]
+            if major <= 2 or (major == 3 and (minor == 6 or (minor == 7 and patch == "0"))):
+                print_warning(
+                    "We highly recommend upgrading aiohttp to 3.7.3 or higher versions."
+                    "An older version of the library may not work with the Slack server-side in the future."
+                )
+
@@ -39,6 +64,25 @@

Functions

+
+ +Expand source code + +
def validate_aiohttp_version(
+    aiohttp_version: str,
+    print_warning: Callable[[str], None] = _print_warning_log,
+):
+    if aiohttp_version is not None:
+        elements = aiohttp_version.split(".")
+        if len(elements) >= 3:
+            # patch version can be a non-numeric value
+            major, minor, patch = int(elements[0]), int(elements[1]), elements[2]
+            if major <= 2 or (major == 3 and (minor == 6 or (minor == 7 and patch == "0"))):
+                print_warning(
+                    "We highly recommend upgrading aiohttp to 3.7.3 or higher versions."
+                    "An older version of the library may not work with the Slack server-side in the future."
+                )
+
@@ -46,6 +90,7 @@

Functions

- + \ No newline at end of file diff --git a/docs/static/api-docs/slack_sdk/audit_logs/async_client.html b/docs/static/api-docs/slack_sdk/audit_logs/async_client.html index 52fca94f3..9f86511a0 100644 --- a/docs/static/api-docs/slack_sdk/audit_logs/async_client.html +++ b/docs/static/api-docs/slack_sdk/audit_logs/async_client.html @@ -2,21 +2,18 @@ - - + + slack_sdk.audit_logs.async_client API documentation - - - - - - + + + + + + - - + +
@@ -25,6 +22,16 @@

Module slack_sdk.audit_logs.async_client

+
+ +Expand source code + +
from .v1.async_client import AsyncAuditLogsClient
+
+__all__ = [
+    "AsyncAuditLogsClient",
+]
+
@@ -477,12 +484,65 @@

Args

Returns

API response

+
+ +Expand source code + +
async def actions(
+    self,
+    *,
+    query_params: Optional[Dict[str, Any]] = None,
+    headers: Optional[Dict[str, str]] = None,
+) -> AuditLogsResponse:
+    """Returns information about the kind of actions that the Audit Logs API
+    returns as a list of all actions and a short description of each.
+    Authentication not required.
+
+    Args:
+        query_params: Set any values if you want to add query params
+        headers: Additional request headers
+
+    Returns:
+        API response
+    """
+    return await self.api_call(
+        path="actions",
+        query_params=query_params,
+        headers=headers,
+    )
+
async def api_call(self, *, http_verb: str = 'GET', path: str, query_params: Optional[Dict[str, Any]] = None, body_params: Optional[Dict[str, Any]] = None, headers: Optional[Dict[str, str]] = None) ‑> AuditLogsResponse
+
+ +Expand source code + +
async def api_call(
+    self,
+    *,
+    http_verb: str = "GET",
+    path: str,
+    query_params: Optional[Dict[str, Any]] = None,
+    body_params: Optional[Dict[str, Any]] = None,
+    headers: Optional[Dict[str, str]] = None,
+) -> AuditLogsResponse:
+    url = f"{self.base_url}{path}"
+    return await self._perform_http_request(
+        http_verb=http_verb,
+        url=url,
+        query_params=query_params,
+        body_params=body_params,
+        headers=_build_request_headers(
+            token=self.token,
+            default_headers=self.default_headers,
+            additional_headers=headers,
+        ),
+    )
+
async def logs(self, *, latest: Optional[int] = None, oldest: Optional[int] = None, limit: Optional[int] = None, action: Optional[str] = None, actor: Optional[str] = None, entity: Optional[str] = None, cursor: Optional[str] = None, additional_query_params: Optional[Dict[str, Any]] = None, headers: Optional[Dict[str, str]] = None) ‑> AuditLogsResponse @@ -519,6 +579,65 @@

Args

Returns

API response

+
+ +Expand source code + +
async def logs(
+    self,
+    *,
+    latest: Optional[int] = None,
+    oldest: Optional[int] = None,
+    limit: Optional[int] = None,
+    action: Optional[str] = None,
+    actor: Optional[str] = None,
+    entity: Optional[str] = None,
+    cursor: Optional[str] = None,
+    additional_query_params: Optional[Dict[str, Any]] = None,
+    headers: Optional[Dict[str, str]] = None,
+) -> AuditLogsResponse:
+    """This is the primary endpoint for retrieving actual audit events from your organization.
+    It will return a list of actions that have occurred on the installed workspace or grid organization.
+    Authentication required.
+
+    The following filters can be applied in order to narrow the range of actions returned.
+    Filters are added as query string parameters and can be combined together.
+    Multiple filter parameters are additive (a boolean AND) and are separated
+    with an ampersand (&) in the query string. Filtering is entirely optional.
+
+    Args:
+        latest: Unix timestamp of the most recent audit event to include (inclusive).
+        oldest: Unix timestamp of the least recent audit event to include (inclusive).
+            Data is not available prior to March 2018.
+        limit: Number of results to optimistically return, maximum 9999.
+        action: Name of the action.
+        actor: User ID who initiated the action.
+        entity: ID of the target entity of the action (such as a channel, workspace, organization, file).
+        cursor: The next page cursor of pagination
+        additional_query_params: Add anything else if you need to use the ones this library does not support
+        headers: Additional request headers
+
+    Returns:
+        API response
+    """
+    query_params = {
+        "latest": latest,
+        "oldest": oldest,
+        "limit": limit,
+        "action": action,
+        "actor": actor,
+        "entity": entity,
+        "cursor": cursor,
+    }
+    if additional_query_params is not None:
+        query_params.update(additional_query_params)
+    query_params = {k: v for k, v in query_params.items() if v is not None}
+    return await self.api_call(
+        path="logs",
+        query_params=query_params,
+        headers=headers,
+    )
+
async def schemas(self, *, query_params: Optional[Dict[str, Any]] = None, headers: Optional[Dict[str, str]] = None) ‑> AuditLogsResponse @@ -536,6 +655,32 @@

Args

Returns

API response

+
+ +Expand source code + +
async def schemas(
+    self,
+    *,
+    query_params: Optional[Dict[str, Any]] = None,
+    headers: Optional[Dict[str, str]] = None,
+) -> AuditLogsResponse:
+    """Returns information about the kind of objects which the Audit Logs API
+    returns as a list of all objects and a short description.
+    Authentication not required.
+
+    Args:
+        query_params: Set any values if you want to add query params
+        headers: Additional request headers
+    Returns:
+        API response
+    """
+    return await self.api_call(
+        path="schemas",
+        query_params=query_params,
+        headers=headers,
+    )
+
@@ -543,6 +688,7 @@

Returns

- + \ No newline at end of file diff --git a/docs/static/api-docs/slack_sdk/audit_logs/index.html b/docs/static/api-docs/slack_sdk/audit_logs/index.html index 818bc4a6d..3c1c3aac9 100644 --- a/docs/static/api-docs/slack_sdk/audit_logs/index.html +++ b/docs/static/api-docs/slack_sdk/audit_logs/index.html @@ -2,21 +2,18 @@ - - + + slack_sdk.audit_logs API documentation - - - - - - + + + + + + - - + +
@@ -27,6 +24,22 @@

Module slack_sdk.audit_logs

Audit Logs API is a set of APIs for monitoring what’s happening in your Enterprise Grid organization.

Refer to https://slack.dev/python-slack-sdk/audit-logs/ for details.

+
+ +Expand source code + +
"""Audit Logs API is a set of APIs for monitoring what’s happening in your Enterprise Grid organization.
+
+Refer to https://slack.dev/python-slack-sdk/audit-logs/ for details.
+"""
+from .v1.client import AuditLogsClient
+from .v1.response import AuditLogsResponse
+
+__all__ = [
+    "AuditLogsClient",
+    "AuditLogsResponse",
+]
+

Sub-modules

@@ -473,12 +486,69 @@

Args

Returns

API response

+
+ +Expand source code + +
def actions(
+    self,
+    *,
+    query_params: Optional[Dict[str, Any]] = None,
+    headers: Optional[Dict[str, str]] = None,
+) -> AuditLogsResponse:
+    """Returns information about the kind of actions that the Audit Logs API
+    returns as a list of all actions and a short description of each.
+    Authentication not required.
+
+    Args:
+        query_params: Set any values if you want to add query params
+        headers: Additional request headers
+
+    Returns:
+        API response
+    """
+    return self.api_call(
+        path="actions",
+        query_params=query_params,
+        headers=headers,
+    )
+
def api_call(self, *, http_verb: str = 'GET', path: str, query_params: Optional[Dict[str, Any]] = None, body_params: Optional[Dict[str, Any]] = None, headers: Optional[Dict[str, str]] = None) ‑> AuditLogsResponse

Performs a Slack API request and returns the result.

+
+ +Expand source code + +
def api_call(
+    self,
+    *,
+    http_verb: str = "GET",
+    path: str,
+    query_params: Optional[Dict[str, Any]] = None,
+    body_params: Optional[Dict[str, Any]] = None,
+    headers: Optional[Dict[str, str]] = None,
+) -> AuditLogsResponse:
+    """Performs a Slack API request and returns the result."""
+    url = f"{self.base_url}{path}"
+    query = _build_query(query_params)
+    if len(query) > 0:
+        url += f"?{query}"
+
+    return self._perform_http_request(
+        http_verb=http_verb,
+        url=url,
+        body=body_params,
+        headers=_build_request_headers(
+            token=self.token,
+            default_headers=self.default_headers,
+            additional_headers=headers,
+        ),
+    )
+
def logs(self, *, latest: Optional[int] = None, oldest: Optional[int] = None, limit: Optional[int] = None, action: Optional[str] = None, actor: Optional[str] = None, entity: Optional[str] = None, cursor: Optional[str] = None, additional_query_params: Optional[Dict[str, Any]] = None, headers: Optional[Dict[str, str]] = None) ‑> AuditLogsResponse @@ -515,6 +585,65 @@

Args

Returns

API response

+
+ +Expand source code + +
def logs(
+    self,
+    *,
+    latest: Optional[int] = None,
+    oldest: Optional[int] = None,
+    limit: Optional[int] = None,
+    action: Optional[str] = None,
+    actor: Optional[str] = None,
+    entity: Optional[str] = None,
+    cursor: Optional[str] = None,
+    additional_query_params: Optional[Dict[str, Any]] = None,
+    headers: Optional[Dict[str, str]] = None,
+) -> AuditLogsResponse:
+    """This is the primary endpoint for retrieving actual audit events from your organization.
+    It will return a list of actions that have occurred on the installed workspace or grid organization.
+    Authentication required.
+
+    The following filters can be applied in order to narrow the range of actions returned.
+    Filters are added as query string parameters and can be combined together.
+    Multiple filter parameters are additive (a boolean AND) and are separated
+    with an ampersand (&) in the query string. Filtering is entirely optional.
+
+    Args:
+        latest: Unix timestamp of the most recent audit event to include (inclusive).
+        oldest: Unix timestamp of the least recent audit event to include (inclusive).
+            Data is not available prior to March 2018.
+        limit: Number of results to optimistically return, maximum 9999.
+        action: Name of the action.
+        actor: User ID who initiated the action.
+        entity: ID of the target entity of the action (such as a channel, workspace, organization, file).
+        cursor: The next page cursor of pagination
+        additional_query_params: Add anything else if you need to use the ones this library does not support
+        headers: Additional request headers
+
+    Returns:
+        API response
+    """
+    query_params = {
+        "latest": latest,
+        "oldest": oldest,
+        "limit": limit,
+        "action": action,
+        "actor": actor,
+        "entity": entity,
+        "cursor": cursor,
+    }
+    if additional_query_params is not None:
+        query_params.update(additional_query_params)
+    query_params = {k: v for k, v in query_params.items() if v is not None}
+    return self.api_call(
+        path="logs",
+        query_params=query_params,
+        headers=headers,
+    )
+
def schemas(self, *, query_params: Optional[Dict[str, Any]] = None, headers: Optional[Dict[str, str]] = None) ‑> AuditLogsResponse @@ -532,6 +661,32 @@

Args

Returns

API response

+
+ +Expand source code + +
def schemas(
+    self,
+    *,
+    query_params: Optional[Dict[str, Any]] = None,
+    headers: Optional[Dict[str, str]] = None,
+) -> AuditLogsResponse:
+    """Returns information about the kind of objects which the Audit Logs API
+    returns as a list of all objects and a short description.
+    Authentication not required.
+
+    Args:
+        query_params: Set any values if you want to add query params
+        headers: Additional request headers
+    Returns:
+        API response
+    """
+    return self.api_call(
+        path="schemas",
+        query_params=query_params,
+        headers=headers,
+    )
+
@@ -598,7 +753,7 @@

Class variables

Instance variables

-
prop typed_body : Optional[LogsResponse]
+
var typed_body : Optional[LogsResponse]
@@ -618,6 +773,7 @@

Instance variables