chore: merge w main

Author: zimeg

.github/CODEOWNERS

@@ -0,0 +1,12 @@
+# Salesforce Open Source project configuration
+# Learn more: https://github.com/salesforce/oss-template
+#ECCN:Open Source
+#GUSINFO:Open Source,Open Source Workflow
+
+# @slackapi/slack-platform-python
+# are code reviewers for all changes in this repo.
+* @slackapi/slack-platform-python
+
+# @slackapi/developer-education
+# are code reviewers for changes in the `/docs` directory.
+/docs/ @slackapi/developer-education

.github/maintainers_guide.md

@@ -175,15 +175,17 @@ Before creating a new release, ensure that everything on a stable branch has
 landed, then [run the tests](#unit-tests).
 
 1. Create the commit for the release
-   1. In `slack_sdk/version.py` bump the version number in adherence to [Semantic Versioning](http://semver.org/) and [Developmental Release](https://peps.python.org/pep-0440/#developmental-releases).
+   1. Use the latest supported Python version. Using a [virtual environment](#python-and-friends) is recommended.
+   2. In `slack_sdk/version.py` bump the version number in adherence to [Semantic Versioning](http://semver.org/) and [Developmental Release](https://peps.python.org/pep-0440/#developmental-releases).
       - Example: if the current version is `1.2.3`, a proper development bump would be `1.2.4.dev0`
       - `.dev` will indicate to pip that this is a [Development Release](https://peps.python.org/pep-0440/#developmental-releases)
       - Note that the `dev` version can be bumped in development releases: `1.2.4.dev0` -> `1.2.4.dev1`
-   2. Build the docs with `./scripts/generate_api_docs.sh`.
-   3. Commit with a message including the new version number. For example `1.2.4.dev0` & push the commit to a branch where the development release will live (create it if it does not exist)
+   3. Build the docs with `./scripts/generate_api_docs.sh`.
+   4. Commit with a message including the new version number. For example `1.2.4.dev0` & push the commit to a branch where the development release will live (create it if it does not exist)
       1. `git checkout -b future-release`
-      2. `git commit -m 'chore(release): version 1.2.4.dev0'`
-      3. `git push -u origin future-release`
+      2. `git add --all` (review files with `git status` before committing)
+      3. `git commit -m 'chore(release): version 1.2.4.dev0'`
+      4. `git push -u origin future-release`
 2. Create a new GitHub Release
    1. Navigate to the [Releases page](https://github.com/slackapi/python-slack-sdk/releases).
    2. Click the "Draft a new release" button.
@@ -207,14 +209,16 @@ Before creating a new release, ensure that everything on the `main` branch since
 the last tag is in a releasable state! At a minimum, [run the tests](#unit-tests).
 
 1. Create the commit for the release
-   1. In `slack_sdk/version.py` bump the version number in adherence to [Semantic Versioning](http://semver.org/) and the [Versioning](#versioning-and-tags) section.
-   2. Build the docs with `./scripts/generate_api_docs.sh`.
-   3. Commit with a message including the new version number. For example `1.2.3` & push the commit to a branch and create a PR to sanity check.
+   1. Use the latest supported Python version. Using a [virtual environment](#python-and-friends) is recommended.
+   2. In `slack_sdk/version.py` bump the version number in adherence to [Semantic Versioning](http://semver.org/) and the [Versioning](#versioning-and-tags) section.
+   3. Build the docs with `./scripts/generate_api_docs.sh`.
+   4. Commit with a message including the new version number. For example `1.2.3` & push the commit to a branch and create a PR to sanity check.
       1. `git checkout -b 1.2.3-release`
-      2. `git commit -m 'chore(release): version 1.2.3'`
-      3. `git push -u origin 1.2.3-release`
-   4. Add relevant labels to the PR and add the PR to a GitHub Milestone.
-   5. Merge in release PR after getting an approval from at least one maintainer.
+      2. `git add --all` (review files with `git status` before committing)
+      3. `git commit -m 'chore(release): version 1.2.3'`
+      4. `git push -u origin 1.2.3-release`
+   5. Add relevant labels to the PR and add the PR to a GitHub Milestone.
+   6. Merge in release PR after getting an approval from at least one maintainer.
 2. Create a new GitHub Release
    1. Navigate to the [Releases page](https://github.com/slackapi/python-slack-sdk/releases).
    2. Click the "Draft a new release" button.

.github/workflows/tests.yml

@@ -80,19 +80,24 @@ jobs:
           PYTHONPATH=$PWD:$PYTHONPATH pytest tests/slack_sdk/oauth/state_store/test_sqlalchemy.py
       - name: Upload test results to Codecov
         if: ${{ !cancelled() }}
-        uses: codecov/test-results-action@47f89e9acb64b76debcd5ea40642d25a4adced9f # v1.1.1
+        uses: codecov/codecov-action@5a1091511ad55cbe89839c7260b706298ca349f7 # v5.5.1
         with:
           directory: ./reports/
+          fail_ci_if_error: true
           flags: ${{ matrix.python-version }}
+          report_type: test_results
           token: ${{ secrets.CODECOV_TOKEN }}
           verbose: true
       - name: Upload test coverage to Codecov (only with latest supported version)
         if: startsWith(matrix.python-version, '3.14')
         uses: codecov/codecov-action@5a1091511ad55cbe89839c7260b706298ca349f7 # v5.5.1
         with:
-          token: ${{ secrets.CODECOV_TOKEN }}
+          fail_ci_if_error: true
           # Run validation generates the coverage file
           files: ./coverage.xml
+          report_type: coverage
+          token: ${{ secrets.CODECOV_TOKEN }}
+          verbose: true
   notifications:
     name: Regression notifications
     runs-on: ubuntu-latest

docs/reference/models/blocks/basic_components.html

@@ -378,6 +378,7 @@ <h3>Inherited members</h3>
     ):
         &#34;&#34;&#34;
         A feedback button element object for either positive or negative feedback.
+        https://docs.slack.dev/reference/block-kit/block-elements/feedback-buttons-element#button-object-fields
 
         Args:
             text (required): An object containing some text. Maximum length for this field is 75 characters.
@@ -410,7 +411,8 @@ <h3>Inherited members</h3>
         return json</code></pre>
 </details>
 <div class="desc"><p>The base class for JSON serializable class objects</p>
-<p>A feedback button element object for either positive or negative feedback.</p>
+<p>A feedback button element object for either positive or negative feedback.
+<a href="https://docs.slack.dev/reference/block-kit/block-elements/feedback-buttons-element#button-object-fields">https://docs.slack.dev/reference/block-kit/block-elements/feedback-buttons-element#button-object-fields</a></p>
 <h2 id="args">Args</h2>
 <dl>
 <dt><strong><code>text</code></strong> :&ensp;<code>required</code></dt>

docs/reference/models/blocks/block_elements.html

@@ -1868,6 +1868,7 @@ <h3>Inherited members</h3>
         **others: dict,
     ):
         &#34;&#34;&#34;Buttons to indicate positive or negative feedback.
+        https://docs.slack.dev/reference/block-kit/block-elements/feedback-buttons-element
 
         Args:
             action_id (required): An identifier for this action.
@@ -1885,7 +1886,8 @@ <h3>Inherited members</h3>
 </details>
 <div class="desc"><p>Block Elements are things that exists inside of your Blocks.
 <a href="https://docs.slack.dev/reference/block-kit/block-elements/">https://docs.slack.dev/reference/block-kit/block-elements/</a></p>
-<p>Buttons to indicate positive or negative feedback.</p>
+<p>Buttons to indicate positive or negative feedback.
+<a href="https://docs.slack.dev/reference/block-kit/block-elements/feedback-buttons-element">https://docs.slack.dev/reference/block-kit/block-elements/feedback-buttons-element</a></p>
 <h2 id="args">Args</h2>
 <dl>
 <dt><strong><code>action_id</code></strong> :&ensp;<code>required</code></dt>
@@ -2074,6 +2076,7 @@ <h3>Inherited members</h3>
         **others: dict,
     ):
         &#34;&#34;&#34;An icon button to perform actions.
+        https://docs.slack.dev/reference/block-kit/block-elements/icon-button-element
 
         Args:
             action_id: An identifier for this action.
@@ -2103,7 +2106,8 @@ <h3>Inherited members</h3>
 </details>
 <div class="desc"><p>Block Elements are things that exists inside of your Blocks.
 <a href="https://docs.slack.dev/reference/block-kit/block-elements/">https://docs.slack.dev/reference/block-kit/block-elements/</a></p>
-<p>An icon button to perform actions.</p>
+<p>An icon button to perform actions.
+<a href="https://docs.slack.dev/reference/block-kit/block-elements/icon-button-element">https://docs.slack.dev/reference/block-kit/block-elements/icon-button-element</a></p>
 <h2 id="args">Args</h2>
 <dl>
 <dt><strong><code>action_id</code></strong></dt>
@@ -3225,18 +3229,21 @@ <h3>Inherited members</h3>
             italic: Optional[bool] = None,
             strike: Optional[bool] = None,
             code: Optional[bool] = None,
+            underline: Optional[bool] = None,
         ):
             self.bold = bold
             self.italic = italic
             self.strike = strike
             self.code = code
+            self.underline = underline
 
         def to_dict(self, *args) -&gt; dict:
             result = {
                 &#34;bold&#34;: self.bold,
                 &#34;italic&#34;: self.italic,
                 &#34;strike&#34;: self.strike,
                 &#34;code&#34;: self.code,
+                &#34;underline&#34;: self.underline,
             }
             return {k: v for k, v in result.items() if v is not None}
 

docs/reference/models/blocks/blocks.html

@@ -433,6 +433,7 @@ <h3>Inherited members</h3>
         **others: dict,
     ):
         &#34;&#34;&#34;Displays actions as contextual info, which can include both feedback buttons and icon buttons.
+        https://docs.slack.dev/reference/block-kit/blocks/context-actions-block
 
         Args:
             elements (required): An array of feedback_buttons or icon_button block elements. Maximum number of items is 5.
@@ -457,7 +458,8 @@ <h3>Inherited members</h3>
 <div class="desc"><p>Blocks are a series of components that can be combined
 to create visually rich and compellingly interactive messages.
 <a href="https://docs.slack.dev/reference/block-kit/blocks">https://docs.slack.dev/reference/block-kit/blocks</a></p>
-<p>Displays actions as contextual info, which can include both feedback buttons and icon buttons.</p>
+<p>Displays actions as contextual info, which can include both feedback buttons and icon buttons.
+<a href="https://docs.slack.dev/reference/block-kit/blocks/context-actions-block">https://docs.slack.dev/reference/block-kit/blocks/context-actions-block</a></p>
 <h2 id="args">Args</h2>
 <dl>
 <dt><strong><code>elements</code></strong> :&ensp;<code>required</code></dt>

docs/reference/models/blocks/index.html

@@ -1369,6 +1369,7 @@ <h3>Inherited members</h3>
         **others: dict,
     ):
         &#34;&#34;&#34;Displays actions as contextual info, which can include both feedback buttons and icon buttons.
+        https://docs.slack.dev/reference/block-kit/blocks/context-actions-block
 
         Args:
             elements (required): An array of feedback_buttons or icon_button block elements. Maximum number of items is 5.
@@ -1393,7 +1394,8 @@ <h3>Inherited members</h3>
 <div class="desc"><p>Blocks are a series of components that can be combined
 to create visually rich and compellingly interactive messages.
 <a href="https://docs.slack.dev/reference/block-kit/blocks">https://docs.slack.dev/reference/block-kit/blocks</a></p>
-<p>Displays actions as contextual info, which can include both feedback buttons and icon buttons.</p>
+<p>Displays actions as contextual info, which can include both feedback buttons and icon buttons.
+<a href="https://docs.slack.dev/reference/block-kit/blocks/context-actions-block">https://docs.slack.dev/reference/block-kit/blocks/context-actions-block</a></p>
 <h2 id="args">Args</h2>
 <dl>
 <dt><strong><code>elements</code></strong> :&ensp;<code>required</code></dt>
@@ -2762,6 +2764,7 @@ <h3>Inherited members</h3>
     ):
         &#34;&#34;&#34;
         A feedback button element object for either positive or negative feedback.
+        https://docs.slack.dev/reference/block-kit/block-elements/feedback-buttons-element#button-object-fields
 
         Args:
             text (required): An object containing some text. Maximum length for this field is 75 characters.
@@ -2794,7 +2797,8 @@ <h3>Inherited members</h3>
         return json</code></pre>
 </details>
 <div class="desc"><p>The base class for JSON serializable class objects</p>
-<p>A feedback button element object for either positive or negative feedback.</p>
+<p>A feedback button element object for either positive or negative feedback.
+<a href="https://docs.slack.dev/reference/block-kit/block-elements/feedback-buttons-element#button-object-fields">https://docs.slack.dev/reference/block-kit/block-elements/feedback-buttons-element#button-object-fields</a></p>
 <h2 id="args">Args</h2>
 <dl>
 <dt><strong><code>text</code></strong> :&ensp;<code>required</code></dt>
@@ -2901,6 +2905,7 @@ <h3>Inherited members</h3>
         **others: dict,
     ):
         &#34;&#34;&#34;Buttons to indicate positive or negative feedback.
+        https://docs.slack.dev/reference/block-kit/block-elements/feedback-buttons-element
 
         Args:
             action_id (required): An identifier for this action.
@@ -2918,7 +2923,8 @@ <h3>Inherited members</h3>
 </details>
 <div class="desc"><p>Block Elements are things that exists inside of your Blocks.
 <a href="https://docs.slack.dev/reference/block-kit/block-elements/">https://docs.slack.dev/reference/block-kit/block-elements/</a></p>
-<p>Buttons to indicate positive or negative feedback.</p>
+<p>Buttons to indicate positive or negative feedback.
+<a href="https://docs.slack.dev/reference/block-kit/block-elements/feedback-buttons-element">https://docs.slack.dev/reference/block-kit/block-elements/feedback-buttons-element</a></p>
 <h2 id="args">Args</h2>
 <dl>
 <dt><strong><code>action_id</code></strong> :&ensp;<code>required</code></dt>
@@ -3196,6 +3202,7 @@ <h3>Inherited members</h3>
         **others: dict,
     ):
         &#34;&#34;&#34;An icon button to perform actions.
+        https://docs.slack.dev/reference/block-kit/block-elements/icon-button-element
 
         Args:
             action_id: An identifier for this action.
@@ -3225,7 +3232,8 @@ <h3>Inherited members</h3>
 </details>
 <div class="desc"><p>Block Elements are things that exists inside of your Blocks.
 <a href="https://docs.slack.dev/reference/block-kit/block-elements/">https://docs.slack.dev/reference/block-kit/block-elements/</a></p>
-<p>An icon button to perform actions.</p>
+<p>An icon button to perform actions.
+<a href="https://docs.slack.dev/reference/block-kit/block-elements/icon-button-element">https://docs.slack.dev/reference/block-kit/block-elements/icon-button-element</a></p>
 <h2 id="args">Args</h2>
 <dl>
 <dt><strong><code>action_id</code></strong></dt>
@@ -5617,18 +5625,21 @@ <h3>Inherited members</h3>
             italic: Optional[bool] = None,
             strike: Optional[bool] = None,
             code: Optional[bool] = None,
+            underline: Optional[bool] = None,
         ):
             self.bold = bold
             self.italic = italic
             self.strike = strike
             self.code = code
+            self.underline = underline
 
         def to_dict(self, *args) -&gt; dict:
             result = {
                 &#34;bold&#34;: self.bold,
                 &#34;italic&#34;: self.italic,
                 &#34;strike&#34;: self.strike,
                 &#34;code&#34;: self.code,
+                &#34;underline&#34;: self.underline,
             }
             return {k: v for k, v in result.items() if v is not None}
 

docs/reference/scim/async_client.html

@@ -163,9 +163,9 @@ <h2 class="section-title" id="header-classes">Classes</h2>
             await self.api_call(
                 http_verb=&#34;PATCH&#34;,
                 path=f&#34;Users/{quote(id)}&#34;,
-                body_params=partial_user.to_dict()
-                if isinstance(partial_user, User)
-                else _to_dict_without_not_given(partial_user),
+                body_params=(
+                    partial_user.to_dict() if isinstance(partial_user, User) else _to_dict_without_not_given(partial_user)
+                ),
             )
         )
 
@@ -228,9 +228,11 @@ <h2 class="section-title" id="header-classes">Classes</h2>
             await self.api_call(
                 http_verb=&#34;PATCH&#34;,
                 path=f&#34;Groups/{quote(id)}&#34;,
-                body_params=partial_group.to_dict()
-                if isinstance(partial_group, Group)
-                else _to_dict_without_not_given(partial_group),
+                body_params=(
+                    partial_group.to_dict()
+                    if isinstance(partial_group, Group)
+                    else _to_dict_without_not_given(partial_group)
+                ),
             )
         )
 
@@ -620,9 +622,11 @@ <h3>Methods</h3>
         await self.api_call(
             http_verb=&#34;PATCH&#34;,
             path=f&#34;Groups/{quote(id)}&#34;,
-            body_params=partial_group.to_dict()
-            if isinstance(partial_group, Group)
-            else _to_dict_without_not_given(partial_group),
+            body_params=(
+                partial_group.to_dict()
+                if isinstance(partial_group, Group)
+                else _to_dict_without_not_given(partial_group)
+            ),
         )
     )</code></pre>
 </details>
@@ -641,9 +645,9 @@ <h3>Methods</h3>
         await self.api_call(
             http_verb=&#34;PATCH&#34;,
             path=f&#34;Users/{quote(id)}&#34;,
-            body_params=partial_user.to_dict()
-            if isinstance(partial_user, User)
-            else _to_dict_without_not_given(partial_user),
+            body_params=(
+                partial_user.to_dict() if isinstance(partial_user, User) else _to_dict_without_not_given(partial_user)
+            ),
         )
     )</code></pre>
 </details>

docs/reference/scim/v1/async_client.html

@@ -163,9 +163,9 @@ <h2 class="section-title" id="header-classes">Classes</h2>
             await self.api_call(
                 http_verb=&#34;PATCH&#34;,
                 path=f&#34;Users/{quote(id)}&#34;,
-                body_params=partial_user.to_dict()
-                if isinstance(partial_user, User)
-                else _to_dict_without_not_given(partial_user),
+                body_params=(
+                    partial_user.to_dict() if isinstance(partial_user, User) else _to_dict_without_not_given(partial_user)
+                ),
             )
         )
 
@@ -228,9 +228,11 @@ <h2 class="section-title" id="header-classes">Classes</h2>
             await self.api_call(
                 http_verb=&#34;PATCH&#34;,
                 path=f&#34;Groups/{quote(id)}&#34;,
-                body_params=partial_group.to_dict()
-                if isinstance(partial_group, Group)
-                else _to_dict_without_not_given(partial_group),
+                body_params=(
+                    partial_group.to_dict()
+                    if isinstance(partial_group, Group)
+                    else _to_dict_without_not_given(partial_group)
+                ),
             )
         )
 
@@ -620,9 +622,11 @@ <h3>Methods</h3>
         await self.api_call(
             http_verb=&#34;PATCH&#34;,
             path=f&#34;Groups/{quote(id)}&#34;,
-            body_params=partial_group.to_dict()
-            if isinstance(partial_group, Group)
-            else _to_dict_without_not_given(partial_group),
+            body_params=(
+                partial_group.to_dict()
+                if isinstance(partial_group, Group)
+                else _to_dict_without_not_given(partial_group)
+            ),
         )
     )</code></pre>
 </details>
@@ -641,9 +645,9 @@ <h3>Methods</h3>
         await self.api_call(
             http_verb=&#34;PATCH&#34;,
             path=f&#34;Users/{quote(id)}&#34;,
-            body_params=partial_user.to_dict()
-            if isinstance(partial_user, User)
-            else _to_dict_without_not_given(partial_user),
+            body_params=(
+                partial_user.to_dict() if isinstance(partial_user, User) else _to_dict_without_not_given(partial_user)
+            ),
         )
     )</code></pre>
 </details>