waapi 0.1.0__tar.gz

waapi-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,40 @@
+name: Publish to PyPI
+
+# Publishes on a v* tag using PyPI Trusted Publishing (OIDC) — no API token is
+# stored in the repository. Configure the publisher once at
+# https://pypi.org/manage/project/waapi/settings/publishing/
+#   owner: WaAPIapp   repository: waapi-python-sdk
+#   workflow: publish.yml   environment: pypi
+
+on:
+  push:
+    tags: ['v*']
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - run: pip install build twine
+      - run: python -m build
+      - run: twine check dist/*
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

waapi-0.1.0/.github/workflows/tests.yml

@@ -0,0 +1,32 @@
+name: Tests
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e ".[dev]"
+      - run: pytest -q
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - run: pip install -e ".[dev]"
+      - run: ruff check .
+      - run: mypy src/waapi

waapi-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.venv/
+venv/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+.DS_Store
+dist_test/

waapi-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,53 @@
+# Contributing
+
+## The method surface is generated, not hand-written
+
+The API exposes 122 client actions across 130 paths. The n8n node and the MCP
+tools are generated from `storage/swagger.json`, which is why both stay
+current, while a hand-maintained SDK falls behind — the Laravel SDK named 25 of
+122 actions before its methods were generated.
+
+`GenerateSdkMethods` in the proxy repository emits them, with a `python` and a
+`python-async` flavour:
+
+```bash
+python3 scripts/sync_actions.py ../eazewhatsapp-proxy
+# wrote 122 sync and 122 async methods, and 122 tests
+```
+
+That overwrites two files whole, and nothing hand-written lives in either:
+
+- `src/waapi/_generated.py` — `GeneratedActions` and `GeneratedAsyncActions`
+- `tests/test_generated_actions.py` — one payload test per action
+
+The script refuses to write if the two surfaces come out at different sizes or
+if the generator emitted nothing, and it runs `ruff` over its own output, so a
+file marked DO NOT EDIT never needs a human to fix its formatting.
+
+Hand-written methods live in `src/waapi/_actions.py`, which composes the
+generated classes in. Add one there only if it cannot come from the spec — the
+instance endpoints are the current example, because they are ordinary REST
+routes rather than client actions. Anything added by hand is one more place a
+future API change has to reach.
+
+If you do add one, mirror it in **both** `ActionsMixin` and
+`AsyncActionsMixin` — `test_sync_and_async_expose_the_same_methods` fails
+otherwise, on purpose.
+
+## Conventions
+
+- Public arguments are `snake_case`; the JSON keys they map to stay
+  `camelCase` as the API defines them.
+- Optional arguments default to `None` and are dropped from the payload by
+  `prune()`. Do not send explicit nulls.
+- Anything that can be checked without a request (a missing instance id, a
+  media call with no source) raises `ValueError` before the call goes out.
+
+## Tests
+
+```bash
+pip install -e ".[dev]"
+pytest
+```
+
+No test may touch the network. Use `httpx.MockTransport`.

waapi-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) WaAPI <info@waapi.app>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

waapi-0.1.0/PKG-INFO

@@ -0,0 +1,185 @@
+Metadata-Version: 2.5
+Name: waapi
+Version: 0.1.0
+Summary: Official Python SDK for the WaAPI REST API
+Project-URL: Homepage, https://waapi.app
+Project-URL: Documentation, https://waapi.app/docs
+Project-URL: Source, https://github.com/WaAPIapp/waapi-python-sdk
+Project-URL: Issues, https://github.com/WaAPIapp/waapi-python-sdk/issues
+Author-email: WaAPI <info@waapi.app>
+License: The MIT License (MIT)
+        
+        Copyright (c) WaAPI <info@waapi.app>
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: api,automation,chatbot,messaging,sdk,waapi
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: httpx<1.0,>=0.24
+Provides-Extra: dev
+Requires-Dist: mypy>=1.8; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=7; extra == 'dev'
+Requires-Dist: respx>=0.20; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# WaAPI Python SDK
+
+Official Python client for the [WaAPI](https://waapi.app) REST API — send and
+receive WhatsApp messages, manage chats, groups and channels from Python.
+
+[![PyPI](https://img.shields.io/pypi/v/waapi?style=for-the-badge)](https://pypi.org/project/waapi/)
+[![Python](https://img.shields.io/pypi/pyversions/waapi?style=for-the-badge)](https://pypi.org/project/waapi/)
+[![License](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](LICENSE)
+
+```bash
+pip install waapi
+```
+
+## Quick start
+
+```python
+from waapi import WaAPI
+
+client = WaAPI(token="YOUR_API_TOKEN", instance_id=123)
+
+client.send_message(
+    chat_id="4915112345678@c.us",
+    message="Deployment finished.",
+)
+```
+
+Get a token at [waapi.app/user/api-tokens](https://waapi.app/user/api-tokens)
+and create an instance connected to your number.
+
+### The chat ID is the one thing to get right
+
+Its suffix decides where the message lands, and a wrong suffix is accepted and
+delivers nothing:
+
+| Target | Format |
+|---|---|
+| One person | `4915112345678@c.us` |
+| Group | `123456789-123456789@g.us` |
+| Channel | `123456789@newsletter` |
+
+## Async
+
+Same method names, awaited:
+
+```python
+from waapi import AsyncWaAPI
+
+async with AsyncWaAPI(token="YOUR_API_TOKEN", instance_id=123) as client:
+    await client.send_message(chat_id="4915112345678@c.us", message="Hi")
+```
+
+## Errors
+
+A successful HTTP exchange is not proof the message was sent. The API answers
+`200` with `{"status": "error"}` when, for example, the instance is not
+connected — so the SDK raises on that too, rather than handing back a body that
+looks like success.
+
+```python
+from waapi import WaAPI, FailedActionError, AuthenticationError, RateLimitError
+
+try:
+    client.send_message(chat_id="4915112345678@c.us", message="Hi")
+except AuthenticationError:
+    ...                      # token wrong, expired, or missing scopes
+except RateLimitError as e:
+    time.sleep(e.retry_after or 5)
+except FailedActionError as e:
+    ...                      # accepted but not carried out — e.response has the detail
+```
+
+| Exception | Raised on |
+|---|---|
+| `AuthenticationError` | HTTP 401, 403 |
+| `NotFoundError` | HTTP 404 |
+| `ValidationError` | HTTP 422 — `.errors` holds the field errors |
+| `RateLimitError` | HTTP 429 — `.retry_after` in seconds when the API sends it |
+| `FailedActionError` | HTTP 400, **and HTTP 200 with `status: error`** |
+| `ServerError` | HTTP 5xx |
+
+All inherit from `WaAPIError`.
+
+## Coverage
+
+All **122 client actions** are wrapped, typed, and available on both clients:
+
+```python
+client.create_group(group_name="Ops", group_participants=["4915112345678@c.us"])
+client.send_media(chat_id="4915112345678@c.us", media_url="https://example.com/report.pdf")
+client.get_contacts()
+```
+
+They are generated from the same OpenAPI specification the n8n node and the MCP
+tools come from, so they track the API instead of drifting behind it — see
+[CONTRIBUTING.md](CONTRIBUTING.md).
+
+An action added to the API since the last release is still reachable by name:
+
+```python
+client.action("some-new-action", {"chatId": "4915112345678@c.us"})
+```
+
+## Configuration
+
+```python
+WaAPI(
+    token="...",              # required
+    instance_id=123,          # optional; per-call instance_id overrides it
+    base_url="https://waapi.app/api/v1",
+    timeout=30.0,
+)
+```
+
+Passing `instance_id` to the client keeps single-instance code short. Any call
+can still override it, and a call with neither raises before a request is sent.
+
+## Development
+
+```bash
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+pytest
+```
+
+The suite runs entirely against `httpx.MockTransport` — no network, no token,
+no connected account.
+
+## License
+
+MIT. Not affiliated with, endorsed or sponsored by WhatsApp LLC or Meta.
+WhatsApp is a trademark of WhatsApp LLC.

waapi-0.1.0/README.md

@@ -0,0 +1,131 @@
+# WaAPI Python SDK
+
+Official Python client for the [WaAPI](https://waapi.app) REST API — send and
+receive WhatsApp messages, manage chats, groups and channels from Python.
+
+[![PyPI](https://img.shields.io/pypi/v/waapi?style=for-the-badge)](https://pypi.org/project/waapi/)
+[![Python](https://img.shields.io/pypi/pyversions/waapi?style=for-the-badge)](https://pypi.org/project/waapi/)
+[![License](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](LICENSE)
+
+```bash
+pip install waapi
+```
+
+## Quick start
+
+```python
+from waapi import WaAPI
+
+client = WaAPI(token="YOUR_API_TOKEN", instance_id=123)
+
+client.send_message(
+    chat_id="4915112345678@c.us",
+    message="Deployment finished.",
+)
+```
+
+Get a token at [waapi.app/user/api-tokens](https://waapi.app/user/api-tokens)
+and create an instance connected to your number.
+
+### The chat ID is the one thing to get right
+
+Its suffix decides where the message lands, and a wrong suffix is accepted and
+delivers nothing:
+
+| Target | Format |
+|---|---|
+| One person | `4915112345678@c.us` |
+| Group | `123456789-123456789@g.us` |
+| Channel | `123456789@newsletter` |
+
+## Async
+
+Same method names, awaited:
+
+```python
+from waapi import AsyncWaAPI
+
+async with AsyncWaAPI(token="YOUR_API_TOKEN", instance_id=123) as client:
+    await client.send_message(chat_id="4915112345678@c.us", message="Hi")
+```
+
+## Errors
+
+A successful HTTP exchange is not proof the message was sent. The API answers
+`200` with `{"status": "error"}` when, for example, the instance is not
+connected — so the SDK raises on that too, rather than handing back a body that
+looks like success.
+
+```python
+from waapi import WaAPI, FailedActionError, AuthenticationError, RateLimitError
+
+try:
+    client.send_message(chat_id="4915112345678@c.us", message="Hi")
+except AuthenticationError:
+    ...                      # token wrong, expired, or missing scopes
+except RateLimitError as e:
+    time.sleep(e.retry_after or 5)
+except FailedActionError as e:
+    ...                      # accepted but not carried out — e.response has the detail
+```
+
+| Exception | Raised on |
+|---|---|
+| `AuthenticationError` | HTTP 401, 403 |
+| `NotFoundError` | HTTP 404 |
+| `ValidationError` | HTTP 422 — `.errors` holds the field errors |
+| `RateLimitError` | HTTP 429 — `.retry_after` in seconds when the API sends it |
+| `FailedActionError` | HTTP 400, **and HTTP 200 with `status: error`** |
+| `ServerError` | HTTP 5xx |
+
+All inherit from `WaAPIError`.
+
+## Coverage
+
+All **122 client actions** are wrapped, typed, and available on both clients:
+
+```python
+client.create_group(group_name="Ops", group_participants=["4915112345678@c.us"])
+client.send_media(chat_id="4915112345678@c.us", media_url="https://example.com/report.pdf")
+client.get_contacts()
+```
+
+They are generated from the same OpenAPI specification the n8n node and the MCP
+tools come from, so they track the API instead of drifting behind it — see
+[CONTRIBUTING.md](CONTRIBUTING.md).
+
+An action added to the API since the last release is still reachable by name:
+
+```python
+client.action("some-new-action", {"chatId": "4915112345678@c.us"})
+```
+
+## Configuration
+
+```python
+WaAPI(
+    token="...",              # required
+    instance_id=123,          # optional; per-call instance_id overrides it
+    base_url="https://waapi.app/api/v1",
+    timeout=30.0,
+)
+```
+
+Passing `instance_id` to the client keeps single-instance code short. Any call
+can still override it, and a call with neither raises before a request is sent.
+
+## Development
+
+```bash
+python -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+pytest
+```
+
+The suite runs entirely against `httpx.MockTransport` — no network, no token,
+no connected account.
+
+## License
+
+MIT. Not affiliated with, endorsed or sponsored by WhatsApp LLC or Meta.
+WhatsApp is a trademark of WhatsApp LLC.

waapi-0.1.0/pyproject.toml

@@ -0,0 +1,54 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "waapi"
+version = "0.1.0"
+description = "Official Python SDK for the WaAPI REST API"
+readme = "README.md"
+license = { file = "LICENSE" }
+requires-python = ">=3.9"
+authors = [{ name = "WaAPI", email = "info@waapi.app" }]
+keywords = ["waapi", "messaging", "api", "sdk", "automation", "chatbot"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Communications :: Chat",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = ["httpx>=0.24,<1.0"]
+
+[project.urls]
+Homepage = "https://waapi.app"
+Documentation = "https://waapi.app/docs"
+Source = "https://github.com/WaAPIapp/waapi-python-sdk"
+Issues = "https://github.com/WaAPIapp/waapi-python-sdk/issues"
+
+[project.optional-dependencies]
+dev = ["pytest>=7", "pytest-asyncio>=0.23", "respx>=0.20", "ruff>=0.4", "mypy>=1.8"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/waapi"]
+
+[tool.ruff]
+line-length = 100
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+# PYI034 wants __enter__/__aenter__ to return typing.Self, which landed in
+# 3.11. requires-python is 3.9, and pulling in typing_extensions as a runtime
+# dependency for one annotation is a worse trade than the lint.
+ignore = ["PYI034"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"

waapi-0.1.0/scripts/sync_actions.py

@@ -0,0 +1,156 @@
+#!/usr/bin/env python3
+"""Regenerate src/waapi/_generated.py and tests/test_generated_actions.py.
+
+The API has 122 client actions. Writing them by hand would put every future
+API change in four places -- the n8n node, the MCP tools, the PHP SDKs and
+here -- so they are generated from the same OpenAPI specification the others
+use, by `sdk:generate-methods` in the proxy repository.
+
+Everything generated lands in its own module, which this script overwrites
+whole. Nothing hand-written lives there, so a regeneration can never lose
+someone's edit; the hand-written core stays in _actions.py and composes the
+generated classes in.
+
+    python3 scripts/sync_actions.py ../eazewhatsapp-proxy
+"""
+
+from __future__ import annotations
+
+import argparse
+import re
+import subprocess
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent.parent
+
+HEADER = '''"""Client actions generated from the WaAPI OpenAPI specification.
+
+DO NOT EDIT. Regenerate with:
+
+    python3 scripts/sync_actions.py ../eazewhatsapp-proxy
+
+Hand-written methods belong in _actions.py, which composes these classes in.
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+
+class _Calls:
+    """The contract the mixins rely on, declared for the type checker only."""
+
+    if TYPE_CHECKING:
+
+        def action(
+            self,
+            name: str,
+            payload: dict[str, Any] | None = None,
+            *,
+            instance_id: int | str | None = None,
+        ) -> Any: ...
+'''
+
+TEST_HEADER = '''"""Generated payload tests -- one per client action.
+
+DO NOT EDIT. Regenerate with:
+
+    python3 scripts/sync_actions.py ../eazewhatsapp-proxy
+
+These methods hold no logic: they name an action and forward named arguments.
+So their real failure modes are a wrong action string and a parameter that is
+dropped or swapped with its neighbour, and both are visible in the request
+that leaves the SDK. Sample values carry the parameter's own name for exactly
+that reason -- identical values could not tell a swap from a correct call.
+"""
+
+from __future__ import annotations
+'''
+
+
+def generate(proxy: Path, *args: str) -> str:
+    """Run the generator and return only the emitted code.
+
+    The command reports how many methods it wrote on stdout as well, which is
+    useful in a terminal and a syntax error in a Python file.
+    """
+    result = subprocess.run(
+        [sys.executable and "php", "artisan", "sdk:generate-methods", *args],
+        cwd=proxy,
+        capture_output=True,
+        text=True,
+        check=True,
+    )
+    body = re.sub(r"^\s*INFO\s+\d+ methods generated\.\s*$", "", result.stdout, flags=re.MULTILINE)
+    return body.rstrip() + "\n"
+
+
+def count_methods(source: str) -> int:
+    return len(re.findall(r"^\s+(?:async )?def \w+\(", source, flags=re.MULTILINE))
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("proxy", type=Path, help="path to the eazewhatsapp-proxy checkout")
+    args = parser.parse_args()
+
+    proxy = args.proxy.expanduser().resolve()
+    if not (proxy / "artisan").is_file():
+        raise SystemExit(f"not a Laravel checkout: {proxy}")
+
+    sync = generate(proxy, "--flavour=python")
+    asyncronous = generate(proxy, "--flavour=python-async")
+    tests = generate(proxy, "--flavour=python", "--tests")
+
+    n_sync, n_async = count_methods(sync), count_methods(asyncronous)
+    if n_sync != n_async:
+        raise SystemExit(f"sync/async surfaces differ: {n_sync} vs {n_async}")
+    if n_sync == 0:
+        raise SystemExit("the generator emitted nothing -- check the spec path")
+
+    module = (
+        HEADER
+        + "\n\nclass GeneratedActions(_Calls):\n"
+        + '    """Every client action, blocking."""\n'
+        + sync
+        + "\n\nclass GeneratedAsyncActions(_Calls):\n"
+        + '    """Every client action, awaited."""\n'
+        + asyncronous
+    )
+    (ROOT / "src" / "waapi" / "_generated.py").write_text(module)
+
+    (ROOT / "tests" / "test_generated_actions.py").write_text(TEST_HEADER + tests)
+
+    written = [
+        ROOT / "src" / "waapi" / "_generated.py",
+        ROOT / "tests" / "test_generated_actions.py",
+    ]
+    tidy(written)
+
+    print(f"wrote {n_sync} sync and {n_async} async methods, and {count_tests(tests)} tests")
+    return 0
+
+
+def tidy(paths: list[Path]) -> None:
+    """Bring the generated files up to the project's lint rules.
+
+    Emitting blank lines to PEP 8's satisfaction from a PHP string builder is
+    possible and pointless: the formatter already knows the rules, and letting
+    it run means a lint failure can never be something a human has to fix by
+    hand in a file marked DO NOT EDIT.
+    """
+    for command in (["ruff", "check", "--fix", "--quiet"], ["ruff", "format", "--quiet"]):
+        try:
+            subprocess.run([*command, *map(str, paths)], cwd=ROOT, check=True)
+        except FileNotFoundError:
+            print("ruff not on PATH -- generated files left unformatted", file=sys.stderr)
+            return
+
+
+def count_tests(source: str) -> int:
+    return len(re.findall(r"^def test_", source, flags=re.MULTILINE))
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())