feat: showcase the 'actions' block matching examples in documentation

Author: zimeg

.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "daily"
+  - package-ecosystem: "pip"
+    directory: "block-kit"
+    schedule:
+      interval: "daily"

.github/workflows/test.yml

@@ -0,0 +1,29 @@
+name: Test
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+jobs:
+  test:
+    name: "pytest@python3.13"
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        showcase:
+          - "block-kit"
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+      - name: Install Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - name: Run tests
+        run: |
+          cd "${{ matrix.showcase }}"
+          pip install -r requirements.txt
+          ruff check
+          ruff format --diff --check
+          mypy ./**/*.py
+          pytest -v

README.md

@@ -0,0 +1,7 @@
+# Bolt for Python Showcase
+
+This collections of examples highlights features of a Slack app in the language of Bolt for Python.
+
+## Available demonstration
+
+- **[Block Kit](./block-kit)**: The framework of visual components arranged to create app layouts.

block-kit/.gitignore

@@ -0,0 +1,5 @@
+__pycache__
+.mypy_cache
+.pytest_cache
+.ruff_cache
+.venv

block-kit/README.md

@@ -0,0 +1,11 @@
+# Block Kit
+
+The framework of visual components arranged to create app layouts.
+
+Read the [docs](https://docs.slack.dev/block-kit/) to learn concepts behind these constructions, or explore [reference](https://docs.slack.dev/reference/block-kit) pages for attribute details.
+
+## What's on display
+
+### Blocks
+
+- **[Actions](https://docs.slack.dev/reference/block-kit/blocks/actions-block)**: Holds multiple interactive elements. [Implementation](./src/blocks/actions.py).

block-kit/requirements.txt

@@ -0,0 +1,4 @@
+mypy==1.18.2
+pytest==8.3.3
+ruff==0.14.3
+slack_sdk==3.37.0

block-kit/src/__init__.py

@@ -0,0 +1,88 @@
+from slack_sdk.models.blocks import ActionsBlock
+from slack_sdk.models.blocks.basic_components import Option, PlainTextObject
+from slack_sdk.models.blocks.block_elements import (
+    ButtonElement,
+    DatePickerElement,
+    OverflowMenuElement,
+    StaticSelectElement,
+)
+
+
+def example01() -> ActionsBlock:
+    """
+    Holds multiple interactive elements.
+    https://docs.slack.dev/reference/block-kit/blocks/actions-block/
+
+    An actions block with a select menu and a button.
+    """
+    block = ActionsBlock(
+        block_id="actions1",
+        elements=[
+            StaticSelectElement(
+                action_id="select_2",
+                placeholder=PlainTextObject(text="Which witch is the witchiest witch?"),
+                options=[
+                    Option(text=PlainTextObject(text="Matilda"), value="matilda"),
+                    Option(text=PlainTextObject(text="Glinda"), value="glinda"),
+                    Option(
+                        text=PlainTextObject(text="Granny Weatherwax"),
+                        value="grannyWeatherwax",
+                    ),
+                    Option(text=PlainTextObject(text="Hermione"), value="hermione"),
+                ],
+            ),
+            ButtonElement(
+                text=PlainTextObject(text="Cancel"),
+                value="cancel",
+                action_id="button_1",
+            ),
+        ],
+    )
+    return block
+
+
+def example02() -> ActionsBlock:
+    """
+    An actions block with a datepicker, an overflow, and a button.
+    """
+    block = ActionsBlock(
+        block_id="actionblock789",
+        elements=[
+            DatePickerElement(
+                action_id="datepicker123",
+                initial_date="1990-04-28",
+                placeholder=PlainTextObject(text="Select a date"),
+            ),
+            OverflowMenuElement(
+                action_id="overflow",
+                options=[
+                    Option(
+                        text=PlainTextObject(text="*this is plain_text text*"),
+                        value="value-0",
+                    ),
+                    Option(
+                        text=PlainTextObject(text="*this is plain_text text*"),
+                        value="value-1",
+                    ),
+                    Option(
+                        text=PlainTextObject(text="*this is plain_text text*"),
+                        value="value-2",
+                    ),
+                    Option(
+                        text=PlainTextObject(text="*this is plain_text text*"),
+                        value="value-3",
+                    ),
+                    Option(
+                        text=PlainTextObject(text="*this is plain_text text*"),
+                        value="value-4",
+                    ),
+                ],
+            ),
+            ButtonElement(
+                text=PlainTextObject(text="Click Me"),
+                value="click_me_123",
+                action_id="button",
+            ),
+        ],
+    )
+    return block