chore: rename requirements files to improve Dependabot dependency scoping (#1510)

Author: WilliamBergamin

.github/maintainers_guide.md

@@ -71,8 +71,8 @@ If you make changes to `slack_bolt/adapter/*`, please verify if it surely works
 
 ```sh
 # Install all optional dependencies
-$ pip install -r requirements/adapter.txt
-$ pip install -r requirements/adapter_testing.txt
+$ pip install -r requirements/adapter_dev.txt
+$ pip install -r requirements/test_adapter.txt
 
 # Set required env variables
 $ export SLACK_SIGNING_SECRET=***

.github/workflows/ci-build.yml

@@ -48,13 +48,13 @@ jobs:
         run: |
           pip install -U pip
           pip install -U .
-          pip install -r requirements/tools.txt
+          pip install -r requirements/dev_tools.txt
       - name: Type check synchronous modules
         run: mypy --config-file pyproject.toml --exclude "async_|/adapter/"
       - name: Install async and adapter dependencies
         run: |
-          pip install -r requirements/async.txt
-          pip install -r requirements/adapter.txt
+          pip install -r requirements/async_dev.txt
+          pip install -r requirements/adapter_dev.txt
       - name: Type check all modules
         run: mypy --config-file pyproject.toml
 
@@ -88,15 +88,15 @@ jobs:
         run: |
           pip install -U pip
           pip install .
-          pip install -r requirements/testing_without_asyncio.txt
+          pip install -r requirements/test.txt
       - name: Run tests without aiohttp
         run: |
           pytest tests/slack_bolt/ --junitxml=reports/test_slack_bolt.xml
           pytest tests/scenario_tests/ --junitxml=reports/test_scenario.xml
       - name: Install adapter dependencies
         run: |
-          pip install -r requirements/adapter.txt
-          pip install -r requirements/adapter_testing.txt
+          pip install -r requirements/adapter_dev.txt
+          pip install -r requirements/test_adapter.txt
       - name: Run tests for HTTP Mode adapters
         run: |
           pytest tests/adapter_tests/ \
@@ -105,14 +105,14 @@ jobs:
           --junitxml=reports/test_adapter.xml
       - name: Install async dependencies
         run: |
-          pip install -r requirements/async.txt
+          pip install -r requirements/async_dev.txt
       - name: Run tests for Socket Mode adapters
         run: |
           # Requires async test dependencies
           pytest tests/adapter_tests/socket_mode/ --junitxml=reports/test_adapter_socket_mode.xml
       - name: Install all dependencies
         run: |
-          pip install -r requirements/testing.txt
+          pip install -r requirements/test_async.txt
       - name: Run tests for HTTP Mode adapters (ASGI)
         run: |
           # Requires async test dependencies
@@ -155,9 +155,9 @@ jobs:
         run: |
           pip install -U pip
           pip install .
-          pip install -r requirements/adapter.txt
-          pip install -r requirements/testing.txt
-          pip install -r requirements/adapter_testing.txt
+          pip install -r requirements/adapter_dev.txt
+          pip install -r requirements/test_async.txt
+          pip install -r requirements/test_adapter.txt
       - name: Run all tests for codecov
         run: |
           pytest --cov=./slack_bolt/ --cov-report=xml

AGENTS.md

@@ -183,7 +183,7 @@ Then wire it into `BoltContext` (`slack_bolt/context/context.py`) and `AsyncBolt
 1. Create `slack_bolt/adapter/<framework>/`
 2. Add `__init__.py` and `handler.py` (or `async_handler.py` for async frameworks)
 3. The handler converts the framework's request to `BoltRequest`, calls `app.dispatch()`, and converts `BoltResponse` back
-4. Add the framework to `requirements/adapter.txt` with version constraints
+4. Add the framework to `requirements/adapter_dev.txt` with version constraints
 5. Add adapter tests in `tests/adapter_tests/` (sync) or `tests/adapter_tests_async/` (async)
 
 ### Adding a Kwargs-Injectable Argument
@@ -205,12 +205,12 @@ The core package has a **single required runtime dependency**: `slack_sdk` (defi
 
 **`requirements/` directory structure:**
 
-- `async.txt` -- async runtime deps (`aiohttp`, `websockets`)
-- `adapter.txt` -- all framework adapter deps (Flask, Django, FastAPI, etc.)
-- `testing.txt` -- test runner deps (`pytest`, `pytest-asyncio`, includes `async.txt`)
-- `testing_without_asyncio.txt` -- test deps without async (`pytest`, `pytest-cov`)
-- `adapter_testing.txt` -- adapter-specific test deps (`moto`, `boddle`, `sanic-testing`)
-- `tools.txt` -- dev tools (`mypy`, `flake8`, `black`)
+- `async_dev.txt` -- async runtime deps (`aiohttp`, `websockets`)
+- `adapter_dev.txt` -- all framework adapter deps (Flask, Django, FastAPI, etc.)
+- `test_async.txt` -- test runner deps (`pytest`, `pytest-asyncio`, includes `async_dev.txt`)
+- `test.txt` -- test deps without async (`pytest`, `pytest-cov`)
+- `test_adapter.txt` -- adapter-specific test deps (`moto`, `boddle`, `sanic-testing`)
+- `dev_tools.txt` -- dev tools (`mypy`, `flake8`, `black`)
 
 When adding a new dependency: add it to the appropriate `requirements/*.txt` file with version constraints, never to `pyproject.toml` `dependencies` (unless it's a core runtime dep, which is very rare).
 

requirements/adapter.txt requirements/adapter_dev.txtrequirements/adapter.txt renamed to requirements/adapter_dev.txt

@@ -1,5 +1,5 @@
-# pip install -r requirements/adapter.txt
-# NOTE: any of async ones requires pip install -r requirements/async.txt too
+# pip install -r requirements/adapter_dev.txt
+# NOTE: any of async ones requires pip install -r requirements/async_dev.txt too
 # used only under slack_bolt/adapter
 boto3<=2
 bottle>=0.12,<1

requirements/async.txt

@@ -0,0 +1,3 @@
+# pip install -r requirements/async_dev.txt
+aiohttp>=3,<4
+websockets<16

requirements/async_dev.txt

@@ -1,3 +1,3 @@
-# pip install -r requirements/testing_without_asyncio.txt
+# pip install -r requirements/test.txt
 pytest<8.5
 pytest-cov>=7.1.0,<8; python_version>="3.14"  # only needed to evaluate coverage on the latest supported python version

requirements/tools.txt requirements/dev_tools.txtrequirements/tools.txt renamed to requirements/dev_tools.txt

@@ -1,4 +1,4 @@
-# pip install -r requirements/adapter_testing.txt
+# pip install -r requirements/test_adapter.txt
 moto>=3,<6                               # For AWS tests
 docker>=5,<8                             # Used by moto
 boddle>=0.2.9,<0.3                         # For Bottle app tests

requirements/testing_without_asyncio.txt requirements/test.txtrequirements/testing_without_asyncio.txt renamed to requirements/test.txt

@@ -0,0 +1,4 @@
+# pip install -r requirements/test_async.txt
+-r test.txt
+-r async_dev.txt
+pytest-asyncio<2;