version 3.20.0

slackapi · Feb 17, 2023 · 84e1169 · 84e1169
1 parent cecec9b
commit 84e1169
Show file tree

Hide file tree

Showing 11 changed files with 81 additions and 67 deletions.
diff --git a/docs/api-docs/slack_sdk/index.html b/docs/api-docs/slack_sdk/index.html
@@ -2310,7 +2310,6 @@ <h2 id="note">Note</h2>
         unfurl_links: Optional[bool] = None,
         unfurl_media: Optional[bool] = None,
         container_id: Optional[str] = None,
-        file_annotation: Optional[str] = None,
         icon_emoji: Optional[str] = None,
         icon_url: Optional[str] = None,
         mrkdwn: Optional[bool] = None,
@@ -2335,7 +2334,6 @@ <h2 id="note">Note</h2>
                 &#34;unfurl_links&#34;: unfurl_links,
                 &#34;unfurl_media&#34;: unfurl_media,
                 &#34;container_id&#34;: container_id,
-                &#34;file_annotation&#34;: file_annotation,
                 &#34;icon_emoji&#34;: icon_emoji,
                 &#34;icon_url&#34;: icon_url,
                 &#34;mrkdwn&#34;: mrkdwn,
@@ -8125,7 +8123,7 @@ <h3>Methods</h3>
 </details>
 </dd>
 <dt id="slack_sdk.WebClient.chat_postMessage"><code class="name flex">
-<span>def <span class="ident">chat_postMessage</span></span>(<span>self, *, channel: str, text: Optional[str] = None, as_user: Optional[bool] = None, attachments: Union[str, Sequence[Union[Dict, <a title="slack_sdk.models.attachments.Attachment" href="models/attachments/index.html#slack_sdk.models.attachments.Attachment">Attachment</a>]], ForwardRef(None)] = None, blocks: Union[str, Sequence[Union[Dict, <a title="slack_sdk.models.blocks.blocks.Block" href="models/blocks/blocks.html#slack_sdk.models.blocks.blocks.Block">Block</a>]], ForwardRef(None)] = None, thread_ts: Optional[str] = None, reply_broadcast: Optional[bool] = None, unfurl_links: Optional[bool] = None, unfurl_media: Optional[bool] = None, container_id: Optional[str] = None, file_annotation: Optional[str] = None, icon_emoji: Optional[str] = None, icon_url: Optional[str] = None, mrkdwn: Optional[bool] = None, link_names: Optional[bool] = None, username: Optional[str] = None, parse: Optional[str] = None, metadata: Union[Dict, <a title="slack_sdk.models.metadata.Metadata" href="models/metadata/index.html#slack_sdk.models.metadata.Metadata">Metadata</a>, ForwardRef(None)] = None, **kwargs) ‑> <a title="slack_sdk.web.slack_response.SlackResponse" href="web/slack_response.html#slack_sdk.web.slack_response.SlackResponse">SlackResponse</a></span>
+<span>def <span class="ident">chat_postMessage</span></span>(<span>self, *, channel: str, text: Optional[str] = None, as_user: Optional[bool] = None, attachments: Union[str, Sequence[Union[Dict, <a title="slack_sdk.models.attachments.Attachment" href="models/attachments/index.html#slack_sdk.models.attachments.Attachment">Attachment</a>]], ForwardRef(None)] = None, blocks: Union[str, Sequence[Union[Dict, <a title="slack_sdk.models.blocks.blocks.Block" href="models/blocks/blocks.html#slack_sdk.models.blocks.blocks.Block">Block</a>]], ForwardRef(None)] = None, thread_ts: Optional[str] = None, reply_broadcast: Optional[bool] = None, unfurl_links: Optional[bool] = None, unfurl_media: Optional[bool] = None, container_id: Optional[str] = None, icon_emoji: Optional[str] = None, icon_url: Optional[str] = None, mrkdwn: Optional[bool] = None, link_names: Optional[bool] = None, username: Optional[str] = None, parse: Optional[str] = None, metadata: Union[Dict, <a title="slack_sdk.models.metadata.Metadata" href="models/metadata/index.html#slack_sdk.models.metadata.Metadata">Metadata</a>, ForwardRef(None)] = None, **kwargs) ‑> <a title="slack_sdk.web.slack_response.SlackResponse" href="web/slack_response.html#slack_sdk.web.slack_response.SlackResponse">SlackResponse</a></span>
 </code></dt>
 <dd>
 <div class="desc"><p>Sends a message to a channel.
@@ -8147,7 +8145,6 @@ <h3>Methods</h3>
     unfurl_links: Optional[bool] = None,
     unfurl_media: Optional[bool] = None,
     container_id: Optional[str] = None,
-    file_annotation: Optional[str] = None,
     icon_emoji: Optional[str] = None,
     icon_url: Optional[str] = None,
     mrkdwn: Optional[bool] = None,
@@ -8172,7 +8169,6 @@ <h3>Methods</h3>
             &#34;unfurl_links&#34;: unfurl_links,
             &#34;unfurl_media&#34;: unfurl_media,
             &#34;container_id&#34;: container_id,
-            &#34;file_annotation&#34;: file_annotation,
             &#34;icon_emoji&#34;: icon_emoji,
             &#34;icon_url&#34;: icon_url,
             &#34;mrkdwn&#34;: mrkdwn,

diff --git a/docs/api-docs/slack_sdk/oauth/installation_store/sqlalchemy/index.html b/docs/api-docs/slack_sdk/oauth/installation_store/sqlalchemy/index.html
@@ -168,7 +168,7 @@ <h1 class="title">Module <code>slack_sdk.oauth.installation_store.sqlalchemy</co
 
             i_column = self.installations.c
             installations_rows = conn.execute(
-                sqlalchemy.select([i_column.id])
+                sqlalchemy.select(i_column.id)
                 .where(
                     and_(
                         i_column.client_id == self.client_id,
@@ -180,7 +180,7 @@ <h1 class="title">Module <code>slack_sdk.oauth.installation_store.sqlalchemy</co
                 .limit(1)
             )
             installations_row_id: Optional[str] = None
-            for row in installations_rows:
+            for row in installations_rows.mappings():
                 installations_row_id = row[&#34;id&#34;]
             if installations_row_id is None:
                 conn.execute(self.installations.insert(), i)
@@ -199,7 +199,7 @@ <h1 class="title">Module <code>slack_sdk.oauth.installation_store.sqlalchemy</co
 
             b_column = self.bots.c
             bots_rows = conn.execute(
-                sqlalchemy.select([b_column.id])
+                sqlalchemy.select(b_column.id)
                 .where(
                     and_(
                         b_column.client_id == self.client_id,
@@ -211,7 +211,7 @@ <h1 class="title">Module <code>slack_sdk.oauth.installation_store.sqlalchemy</co
                 .limit(1)
             )
             bots_row_id: Optional[str] = None
-            for row in bots_rows:
+            for row in bots_rows.mappings():
                 bots_row_id = row[&#34;id&#34;]
             if bots_row_id is None:
                 conn.execute(self.bots.insert(), b)
@@ -245,7 +245,7 @@ <h1 class="title">Module <code>slack_sdk.oauth.installation_store.sqlalchemy</co
 
         with self.engine.connect() as conn:
             result: object = conn.execute(query)
-            for row in result:  # type: ignore
+            for row in result.mappings():  # type: ignore
                 return Bot(
                     app_id=row[&#34;app_id&#34;],
                     enterprise_id=row[&#34;enterprise_id&#34;],
@@ -289,7 +289,7 @@ <h1 class="title">Module <code>slack_sdk.oauth.installation_store.sqlalchemy</co
         installation: Optional[Installation] = None
         with self.engine.connect() as conn:
             result: object = conn.execute(query)
-            for row in result:  # type: ignore
+            for row in result.mappings():  # type: ignore
                 installation = Installation(
                     app_id=row[&#34;app_id&#34;],
                     enterprise_id=row[&#34;enterprise_id&#34;],
@@ -330,7 +330,7 @@ <h1 class="title">Module <code>slack_sdk.oauth.installation_store.sqlalchemy</co
             query = self.installations.select().where(where_clause).order_by(desc(c.installed_at)).limit(1)
             with self.engine.connect() as conn:
                 result: object = conn.execute(query)
-                for row in result:  # type: ignore
+                for row in result.mappings():  # type: ignore
                     installation.bot_token = row[&#34;bot_token&#34;]
                     installation.bot_id = row[&#34;bot_id&#34;]
                     installation.bot_user_id = row[&#34;bot_user_id&#34;]
@@ -539,7 +539,7 @@ <h2 class="section-title" id="header-classes">Classes</h2>
 
             i_column = self.installations.c
             installations_rows = conn.execute(
-                sqlalchemy.select([i_column.id])
+                sqlalchemy.select(i_column.id)
                 .where(
                     and_(
                         i_column.client_id == self.client_id,
@@ -551,7 +551,7 @@ <h2 class="section-title" id="header-classes">Classes</h2>
                 .limit(1)
             )
             installations_row_id: Optional[str] = None
-            for row in installations_rows:
+            for row in installations_rows.mappings():
                 installations_row_id = row[&#34;id&#34;]
             if installations_row_id is None:
                 conn.execute(self.installations.insert(), i)
@@ -570,7 +570,7 @@ <h2 class="section-title" id="header-classes">Classes</h2>
 
             b_column = self.bots.c
             bots_rows = conn.execute(
-                sqlalchemy.select([b_column.id])
+                sqlalchemy.select(b_column.id)
                 .where(
                     and_(
                         b_column.client_id == self.client_id,
@@ -582,7 +582,7 @@ <h2 class="section-title" id="header-classes">Classes</h2>
                 .limit(1)
             )
             bots_row_id: Optional[str] = None
-            for row in bots_rows:
+            for row in bots_rows.mappings():
                 bots_row_id = row[&#34;id&#34;]
             if bots_row_id is None:
                 conn.execute(self.bots.insert(), b)
@@ -616,7 +616,7 @@ <h2 class="section-title" id="header-classes">Classes</h2>
 
         with self.engine.connect() as conn:
             result: object = conn.execute(query)
-            for row in result:  # type: ignore
+            for row in result.mappings():  # type: ignore
                 return Bot(
                     app_id=row[&#34;app_id&#34;],
                     enterprise_id=row[&#34;enterprise_id&#34;],
@@ -660,7 +660,7 @@ <h2 class="section-title" id="header-classes">Classes</h2>
         installation: Optional[Installation] = None
         with self.engine.connect() as conn:
             result: object = conn.execute(query)
-            for row in result:  # type: ignore
+            for row in result.mappings():  # type: ignore
                 installation = Installation(
                     app_id=row[&#34;app_id&#34;],
                     enterprise_id=row[&#34;enterprise_id&#34;],
@@ -701,7 +701,7 @@ <h2 class="section-title" id="header-classes">Classes</h2>
             query = self.installations.select().where(where_clause).order_by(desc(c.installed_at)).limit(1)
             with self.engine.connect() as conn:
                 result: object = conn.execute(query)
-                for row in result:  # type: ignore
+                for row in result.mappings():  # type: ignore
                     installation.bot_token = row[&#34;bot_token&#34;]
                     installation.bot_id = row[&#34;bot_id&#34;]
                     installation.bot_user_id = row[&#34;bot_user_id&#34;]

diff --git a/docs/api-docs/slack_sdk/oauth/state_store/sqlalchemy/index.html b/docs/api-docs/slack_sdk/oauth/state_store/sqlalchemy/index.html
@@ -92,7 +92,7 @@ <h1 class="title">Module <code>slack_sdk.oauth.state_store.sqlalchemy</code></h1
                 c = self.oauth_states.c
                 query = self.oauth_states.select().where(and_(c.state == state, c.expire_at &gt; datetime.utcnow()))
                 result = conn.execute(query)
-                for row in result:
+                for row in result.mappings():
                     self.logger.debug(f&#34;consume&#39;s query result: {row}&#34;)
                     conn.execute(self.oauth_states.delete().where(c.id == row[&#34;id&#34;]))
                     return True
@@ -176,7 +176,7 @@ <h2 class="section-title" id="header-classes">Classes</h2>
                 c = self.oauth_states.c
                 query = self.oauth_states.select().where(and_(c.state == state, c.expire_at &gt; datetime.utcnow()))
                 result = conn.execute(query)
-                for row in result:
+                for row in result.mappings():
                     self.logger.debug(f&#34;consume&#39;s query result: {row}&#34;)
                     conn.execute(self.oauth_states.delete().where(c.id == row[&#34;id&#34;]))
                     return True
@@ -271,7 +271,7 @@ <h3>Methods</h3>
             c = self.oauth_states.c
             query = self.oauth_states.select().where(and_(c.state == state, c.expire_at &gt; datetime.utcnow()))
             result = conn.execute(query)
-            for row in result:
+            for row in result.mappings():
                 self.logger.debug(f&#34;consume&#39;s query result: {row}&#34;)
                 conn.execute(self.oauth_states.delete().where(c.id == row[&#34;id&#34;]))
                 return True

diff --git a/docs/api-docs/slack_sdk/version.html b/docs/api-docs/slack_sdk/version.html
@@ -28,7 +28,7 @@ <h1 class="title">Module <code>slack_sdk.version</code></h1>
 <span>Expand source code</span>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;Check the latest version at https://pypi.org/project/slack-sdk/&#34;&#34;&#34;
-__version__ = &#34;3.19.5&#34;</code></pre>
+__version__ = &#34;3.20.0&#34;</code></pre>
 </details>
 </section>
 <section>

diff --git a/docs/api-docs/slack_sdk/web/async_client.html b/docs/api-docs/slack_sdk/web/async_client.html
@@ -2110,7 +2110,6 @@ <h1 class="title">Module <code>slack_sdk.web.async_client</code></h1>
         unfurl_links: Optional[bool] = None,
         unfurl_media: Optional[bool] = None,
         container_id: Optional[str] = None,
-        file_annotation: Optional[str] = None,
         icon_emoji: Optional[str] = None,
         icon_url: Optional[str] = None,
         mrkdwn: Optional[bool] = None,
@@ -2135,7 +2134,6 @@ <h1 class="title">Module <code>slack_sdk.web.async_client</code></h1>
                 &#34;unfurl_links&#34;: unfurl_links,
                 &#34;unfurl_media&#34;: unfurl_media,
                 &#34;container_id&#34;: container_id,
-                &#34;file_annotation&#34;: file_annotation,
                 &#34;icon_emoji&#34;: icon_emoji,
                 &#34;icon_url&#34;: icon_url,
                 &#34;mrkdwn&#34;: mrkdwn,
@@ -6795,7 +6793,6 @@ <h2 id="note">Note</h2>
         unfurl_links: Optional[bool] = None,
         unfurl_media: Optional[bool] = None,
         container_id: Optional[str] = None,
-        file_annotation: Optional[str] = None,
         icon_emoji: Optional[str] = None,
         icon_url: Optional[str] = None,
         mrkdwn: Optional[bool] = None,
@@ -6820,7 +6817,6 @@ <h2 id="note">Note</h2>
                 &#34;unfurl_links&#34;: unfurl_links,
                 &#34;unfurl_media&#34;: unfurl_media,
                 &#34;container_id&#34;: container_id,
-                &#34;file_annotation&#34;: file_annotation,
                 &#34;icon_emoji&#34;: icon_emoji,
                 &#34;icon_url&#34;: icon_url,
                 &#34;mrkdwn&#34;: mrkdwn,
@@ -12610,7 +12606,7 @@ <h3>Methods</h3>
 </details>
 </dd>
 <dt id="slack_sdk.web.async_client.AsyncWebClient.chat_postMessage"><code class="name flex">
-<span>async def <span class="ident">chat_postMessage</span></span>(<span>self, *, channel: str, text: Optional[str] = None, as_user: Optional[bool] = None, attachments: Union[str, Sequence[Union[Dict, <a title="slack_sdk.models.attachments.Attachment" href="../models/attachments/index.html#slack_sdk.models.attachments.Attachment">Attachment</a>]], ForwardRef(None)] = None, blocks: Union[str, Sequence[Union[Dict, <a title="slack_sdk.models.blocks.blocks.Block" href="../models/blocks/blocks.html#slack_sdk.models.blocks.blocks.Block">Block</a>]], ForwardRef(None)] = None, thread_ts: Optional[str] = None, reply_broadcast: Optional[bool] = None, unfurl_links: Optional[bool] = None, unfurl_media: Optional[bool] = None, container_id: Optional[str] = None, file_annotation: Optional[str] = None, icon_emoji: Optional[str] = None, icon_url: Optional[str] = None, mrkdwn: Optional[bool] = None, link_names: Optional[bool] = None, username: Optional[str] = None, parse: Optional[str] = None, metadata: Union[Dict, <a title="slack_sdk.models.metadata.Metadata" href="../models/metadata/index.html#slack_sdk.models.metadata.Metadata">Metadata</a>, ForwardRef(None)] = None, **kwargs) ‑> <a title="slack_sdk.web.async_slack_response.AsyncSlackResponse" href="async_slack_response.html#slack_sdk.web.async_slack_response.AsyncSlackResponse">AsyncSlackResponse</a></span>
+<span>async def <span class="ident">chat_postMessage</span></span>(<span>self, *, channel: str, text: Optional[str] = None, as_user: Optional[bool] = None, attachments: Union[str, Sequence[Union[Dict, <a title="slack_sdk.models.attachments.Attachment" href="../models/attachments/index.html#slack_sdk.models.attachments.Attachment">Attachment</a>]], ForwardRef(None)] = None, blocks: Union[str, Sequence[Union[Dict, <a title="slack_sdk.models.blocks.blocks.Block" href="../models/blocks/blocks.html#slack_sdk.models.blocks.blocks.Block">Block</a>]], ForwardRef(None)] = None, thread_ts: Optional[str] = None, reply_broadcast: Optional[bool] = None, unfurl_links: Optional[bool] = None, unfurl_media: Optional[bool] = None, container_id: Optional[str] = None, icon_emoji: Optional[str] = None, icon_url: Optional[str] = None, mrkdwn: Optional[bool] = None, link_names: Optional[bool] = None, username: Optional[str] = None, parse: Optional[str] = None, metadata: Union[Dict, <a title="slack_sdk.models.metadata.Metadata" href="../models/metadata/index.html#slack_sdk.models.metadata.Metadata">Metadata</a>, ForwardRef(None)] = None, **kwargs) ‑> <a title="slack_sdk.web.async_slack_response.AsyncSlackResponse" href="async_slack_response.html#slack_sdk.web.async_slack_response.AsyncSlackResponse">AsyncSlackResponse</a></span>
 </code></dt>
 <dd>
 <div class="desc"><p>Sends a message to a channel.
@@ -12632,7 +12628,6 @@ <h3>Methods</h3>
     unfurl_links: Optional[bool] = None,
     unfurl_media: Optional[bool] = None,
     container_id: Optional[str] = None,
-    file_annotation: Optional[str] = None,
     icon_emoji: Optional[str] = None,
     icon_url: Optional[str] = None,
     mrkdwn: Optional[bool] = None,
@@ -12657,7 +12652,6 @@ <h3>Methods</h3>
             &#34;unfurl_links&#34;: unfurl_links,
             &#34;unfurl_media&#34;: unfurl_media,
             &#34;container_id&#34;: container_id,
-            &#34;file_annotation&#34;: file_annotation,
             &#34;icon_emoji&#34;: icon_emoji,
             &#34;icon_url&#34;: icon_url,
             &#34;mrkdwn&#34;: mrkdwn,

diff --git a/docs/api-docs/slack_sdk/web/async_internal_utils.html b/docs/api-docs/slack_sdk/web/async_internal_utils.html
@@ -175,24 +175,20 @@ <h1 class="title">Module <code>slack_sdk.web.async_internal_utils</code></h1>
                             f&#34;body: {body}&#34;
                         )
 
-                    if res.status == 429:
-                        for handler in retry_handlers:
-                            if await handler.can_retry_async(
+                    for handler in retry_handlers:
+                        if await handler.can_retry_async(
+                            state=retry_state,
+                            request=retry_request,
+                            response=retry_response,
+                        ):
+                            if logger.level &lt;= logging.DEBUG:
+                                logger.info(f&#34;A retry handler found: {type(handler).__name__} &#34; f&#34;for {http_verb} {api_url}&#34;)
+                            await handler.prepare_for_next_attempt_async(
                                 state=retry_state,
                                 request=retry_request,
                                 response=retry_response,
-                            ):
-                                if logger.level &lt;= logging.DEBUG:
-                                    logger.info(
-                                        f&#34;A retry handler found: {type(handler).__name__} &#34;
-                                        f&#34;for {http_verb} {api_url} - rate_limited&#34;
-                                    )
-                                await handler.prepare_for_next_attempt_async(
-                                    state=retry_state,
-                                    request=retry_request,
-                                    response=retry_response,
-                                )
-                                break
+                            )
+                            break
 
                     if retry_state.next_attempt_requested is False:
                         response = {