gramlab 0.1.0a1__tar.gz

gramlab-0.1.0a1/LICENSE

@@ -0,0 +1,24 @@
+Scope: original GramLab work only. Separately licensed components are listed
+in NOTICE and retain their own terms.
+
+MIT License
+
+Copyright (c) 2026 GramLab contributors
+
+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.

gramlab-0.1.0a1/LICENSES/BSL-1.0.txt

@@ -0,0 +1,23 @@
+Boost Software License - Version 1.0 - August 17th, 2003
+
+Permission is hereby granted, free of charge, to any person or organization
+obtaining a copy of the software and accompanying documentation covered by
+this license (the "Software") to use, reproduce, display, distribute,
+execute, and transmit the Software, and to prepare derivative works of the
+Software, and to permit third-parties to whom the Software is furnished to
+do so, all subject to the following:
+
+The copyright notices in the Software and this entire statement, including
+the above license grant, this restriction and the following disclaimer,
+must be included in all copies of the Software, in whole or in part, and
+all derivative works of the Software, unless such copies or derivative
+works are solely in the form of machine-executable object code generated by
+a source language processor.
+
+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, TITLE AND NON-INFRINGEMENT. IN NO EVENT
+SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
+FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.

gramlab-0.1.0a1/NOTICE

@@ -0,0 +1,40 @@
+GramLab source and license notices
+=================================
+
+Original GramLab core, SDK, tools, documentation and original generated media
+fixtures are licensed under MIT (LICENSE), except where a file or directory
+identifies different terms below. The root MIT license does not relicense
+third-party works or the Android-derived components.
+
+Python package: MIT AND BSL-1.0
+-----------------------------
+src/gramlab/_emoji_text.py and src/gramlab/_document_metadata.py adapt TDLib
+code/data under the Boost Software License 1.0. Each module retains the upstream
+copyright and full license. LICENSES/BSL-1.0.txt supplies a separate license copy.
+Document metadata reference fixtures retain their notice in
+ tests/fixtures/document_metadata/LICENSE_1_0.txt.
+Exact upstream revisions, hashes and adaptation scope are recorded in:
+ docs/development/tdlib-emoji-provenance.json
+ docs/development/tdlib-document-metadata-provenance.json
+
+Android-derived source: GPL-2.0-or-later
+--------------------------------------
+clients/android/patches/ contains patches to Telegram Android, including upstream
+context. Android-derived Java/C++ test fixtures under tests/fixtures/ retain their
+per-file GPL-2.0-or-later headers. These are separate from the Python package;
+their license text is clients/android/patches/COPYING. Preserve the original
+copyright notices and source/build information when redistributing them.
+The patch README and docs/development/licensing.md explain this boundary.
+The original renderer screenshot docs/assets/gramlab-preview.png includes upstream
+interface artwork; its attribution and capture record are in the adjacent
+gramlab-preview.md. It is not original MIT fixture artwork.
+
+Acquired dependencies and application binaries
+---------------------------------------------
+External dependency sources and built Android applications are not included in
+this source repository or Python package. They retain their own licenses.
+The upstream lock is a provenance record, not a completed dependency/license
+audit. An Android binary release requires its own corresponding-source,
+dependency, asset and notice review. This repository offers no APK release.
+
+GramLab is unofficial and is not affiliated with or endorsed by Telegram.

gramlab-0.1.0a1/PKG-INFO

@@ -0,0 +1,124 @@
+Metadata-Version: 2.4
+Name: gramlab
+Version: 0.1.0a1
+Summary: Offline Telegram bot laboratory — experimental runtime foundation
+Keywords: telegram,bot,testing,offline,android
+Author: Ali Mohammadzadeh
+License-Expression: MIT AND BSL-1.0
+License-File: LICENSE
+License-File: LICENSES/BSL-1.0.txt
+License-File: NOTICE
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Testing
+Classifier: Typing :: Typed
+Requires-Dist: pillow==12.3.0
+Requires-Python: >=3.13, <3.14
+Project-URL: Homepage, https://github.com/tholoo/GramLab
+Project-URL: Documentation, https://github.com/tholoo/GramLab/tree/main/docs
+Project-URL: Repository, https://github.com/tholoo/GramLab
+Project-URL: Issues, https://github.com/tholoo/GramLab/issues
+Project-URL: Changelog, https://github.com/tholoo/GramLab/blob/main/CHANGELOG.md
+Description-Content-Type: text/markdown
+
+# GramLab
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/tholoo/GramLab/main/docs/assets/gramlab-preview.png" width="320" alt="An English GramLab conversation in the Telegram Android renderer, with rich text, buttons and glass effects." />
+</p>
+
+[Original Android capture](https://github.com/tholoo/GramLab/blob/main/docs/assets/gramlab-preview.md), with glass effects enabled.
+
+Test Telegram bots locally and inspect their messages in the actual Telegram Android client.
+No Telegram account or production token is needed.
+
+**Experimental.** Text, callbacks, rich messages, photos, documents, albums and custom emoji have
+tested original-Android workflows. Mini Apps, HTML parse modes, grouped-media edits, external
+Telegram conformance and interactive Android mode remain unfinished.
+See the
+[compatibility matrix](https://github.com/tholoo/GramLab/blob/main/docs/compatibility/matrix.md)
+for the supported scope.
+
+## Install
+
+GramLab currently requires Python 3.13 on a supported Linux host. Install the experimental
+prerelease explicitly:
+
+```sh
+uv add "gramlab==0.1.0a1"
+```
+
+The package includes the `gramlab` command and typed Python scenario interface. Android captures
+require separately prepared local tooling and are not distributed in the Python package.
+
+## Write a scenario
+
+Create a user, talk to a real local bot, check its reply and capture the conversation:
+
+```python
+from gramlab import Scenario
+
+lab = Scenario.from_environment()
+chat = lab.conversation(user=lab.user("Alex", language_code="en"), bot="echo")
+chat.send("Hello!")
+history = chat.wait_for_messages(2, timeout=5)
+
+if history[1].text != "Echo: Hello!":
+    raise AssertionError("Unexpected bot reply")
+chat.capture("hello", contains=["Echo: Hello!"])
+```
+
+This runs inside a scenario process. The
+[English echo example](https://github.com/tholoo/GramLab/blob/main/examples/echo/hello.toml) uses
+this exact [scenario](https://github.com/tholoo/GramLab/blob/main/examples/echo/hello.py),
+with the bundled bot and manifest, and the runner supplies the environment. Simulation records the conversation state;
+headless Android also captures the original client. Both modes produce a local HTML report.
+The typed handles are additive: advanced scenarios can still use the raw JSON-shaped operations
+on `Scenario`. The Python interface is still experimental.
+
+## Try it
+
+Start with the
+[development environment](https://github.com/tholoo/GramLab/blob/main/docs/development/environment.md).
+On a supported Linux
+host with Nix and user namespaces:
+
+```sh
+nix develop
+uv sync --locked
+mkdir -p artifacts
+uv run --locked --offline gramlab run examples/echo/hello.toml --output artifacts/echo-demo
+```
+
+Open `artifacts/echo-demo/report.html`. Use a new output directory for each run.
+The runner isolates bot and scenario processes; dependency setup happens before execution.
+Android captures require the separate
+[Android setup](https://github.com/tholoo/GramLab/blob/main/docs/development/android-build.md).
+
+More examples: [button presses](https://github.com/tholoo/GramLab/tree/main/examples/inline),
+[rich messages](https://github.com/tholoo/GramLab/tree/main/examples/rich),
+[rich buttons](https://github.com/tholoo/GramLab/tree/main/examples/rich_inline), and
+[bot restart](https://github.com/tholoo/GramLab/tree/main/examples/recovery).
+
+## Work on GramLab
+
+- [Contributor setup and checks](https://github.com/tholoo/GramLab/blob/main/CONTRIBUTING.md)
+- [Current handoff and remaining work](https://github.com/tholoo/GramLab/blob/main/docs/development/handoff.md)
+- [Architecture](https://github.com/tholoo/GramLab/blob/main/docs/architecture/overview.md) and [product scope](https://github.com/tholoo/GramLab/blob/main/docs/product/requirements.md)
+- [Offline execution rules](https://github.com/tholoo/GramLab/blob/main/docs/development/offline-safety.md)
+- [Working in parallel](https://github.com/tholoo/GramLab/blob/main/docs/development/parallel-work.md)
+- [Release history](https://github.com/tholoo/GramLab/blob/main/CHANGELOG.md)
+
+Original core and SDK code uses [MIT](https://github.com/tholoo/GramLab/blob/main/LICENSE). Two
+TDLib-derived Python modules retain
+[BSL-1.0](https://github.com/tholoo/GramLab/blob/main/LICENSES/BSL-1.0.txt). Android-derived patches
+and fixtures retain GPL-2.0-or-later. See the
+[license map](https://github.com/tholoo/GramLab/blob/main/NOTICE) and
+[licensing boundaries](https://github.com/tholoo/GramLab/blob/main/docs/development/licensing.md).
+This is a source repository. No Android APK release or completed dependency license audit is offered.
+
+GramLab is unofficial and is not affiliated with or endorsed by Telegram.

gramlab-0.1.0a1/README.md

@@ -0,0 +1,97 @@
+# GramLab
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/tholoo/GramLab/main/docs/assets/gramlab-preview.png" width="320" alt="An English GramLab conversation in the Telegram Android renderer, with rich text, buttons and glass effects." />
+</p>
+
+[Original Android capture](https://github.com/tholoo/GramLab/blob/main/docs/assets/gramlab-preview.md), with glass effects enabled.
+
+Test Telegram bots locally and inspect their messages in the actual Telegram Android client.
+No Telegram account or production token is needed.
+
+**Experimental.** Text, callbacks, rich messages, photos, documents, albums and custom emoji have
+tested original-Android workflows. Mini Apps, HTML parse modes, grouped-media edits, external
+Telegram conformance and interactive Android mode remain unfinished.
+See the
+[compatibility matrix](https://github.com/tholoo/GramLab/blob/main/docs/compatibility/matrix.md)
+for the supported scope.
+
+## Install
+
+GramLab currently requires Python 3.13 on a supported Linux host. Install the experimental
+prerelease explicitly:
+
+```sh
+uv add "gramlab==0.1.0a1"
+```
+
+The package includes the `gramlab` command and typed Python scenario interface. Android captures
+require separately prepared local tooling and are not distributed in the Python package.
+
+## Write a scenario
+
+Create a user, talk to a real local bot, check its reply and capture the conversation:
+
+```python
+from gramlab import Scenario
+
+lab = Scenario.from_environment()
+chat = lab.conversation(user=lab.user("Alex", language_code="en"), bot="echo")
+chat.send("Hello!")
+history = chat.wait_for_messages(2, timeout=5)
+
+if history[1].text != "Echo: Hello!":
+    raise AssertionError("Unexpected bot reply")
+chat.capture("hello", contains=["Echo: Hello!"])
+```
+
+This runs inside a scenario process. The
+[English echo example](https://github.com/tholoo/GramLab/blob/main/examples/echo/hello.toml) uses
+this exact [scenario](https://github.com/tholoo/GramLab/blob/main/examples/echo/hello.py),
+with the bundled bot and manifest, and the runner supplies the environment. Simulation records the conversation state;
+headless Android also captures the original client. Both modes produce a local HTML report.
+The typed handles are additive: advanced scenarios can still use the raw JSON-shaped operations
+on `Scenario`. The Python interface is still experimental.
+
+## Try it
+
+Start with the
+[development environment](https://github.com/tholoo/GramLab/blob/main/docs/development/environment.md).
+On a supported Linux
+host with Nix and user namespaces:
+
+```sh
+nix develop
+uv sync --locked
+mkdir -p artifacts
+uv run --locked --offline gramlab run examples/echo/hello.toml --output artifacts/echo-demo
+```
+
+Open `artifacts/echo-demo/report.html`. Use a new output directory for each run.
+The runner isolates bot and scenario processes; dependency setup happens before execution.
+Android captures require the separate
+[Android setup](https://github.com/tholoo/GramLab/blob/main/docs/development/android-build.md).
+
+More examples: [button presses](https://github.com/tholoo/GramLab/tree/main/examples/inline),
+[rich messages](https://github.com/tholoo/GramLab/tree/main/examples/rich),
+[rich buttons](https://github.com/tholoo/GramLab/tree/main/examples/rich_inline), and
+[bot restart](https://github.com/tholoo/GramLab/tree/main/examples/recovery).
+
+## Work on GramLab
+
+- [Contributor setup and checks](https://github.com/tholoo/GramLab/blob/main/CONTRIBUTING.md)
+- [Current handoff and remaining work](https://github.com/tholoo/GramLab/blob/main/docs/development/handoff.md)
+- [Architecture](https://github.com/tholoo/GramLab/blob/main/docs/architecture/overview.md) and [product scope](https://github.com/tholoo/GramLab/blob/main/docs/product/requirements.md)
+- [Offline execution rules](https://github.com/tholoo/GramLab/blob/main/docs/development/offline-safety.md)
+- [Working in parallel](https://github.com/tholoo/GramLab/blob/main/docs/development/parallel-work.md)
+- [Release history](https://github.com/tholoo/GramLab/blob/main/CHANGELOG.md)
+
+Original core and SDK code uses [MIT](https://github.com/tholoo/GramLab/blob/main/LICENSE). Two
+TDLib-derived Python modules retain
+[BSL-1.0](https://github.com/tholoo/GramLab/blob/main/LICENSES/BSL-1.0.txt). Android-derived patches
+and fixtures retain GPL-2.0-or-later. See the
+[license map](https://github.com/tholoo/GramLab/blob/main/NOTICE) and
+[licensing boundaries](https://github.com/tholoo/GramLab/blob/main/docs/development/licensing.md).
+This is a source repository. No Android APK release or completed dependency license audit is offered.
+
+GramLab is unofficial and is not affiliated with or endorsed by Telegram.

gramlab-0.1.0a1/pyproject.toml

@@ -0,0 +1,98 @@
+[project]
+name = "gramlab"
+version = "0.1.0a1"
+description = "Offline Telegram bot laboratory — experimental runtime foundation"
+readme = "README.md"
+requires-python = ">=3.13,<3.14"
+license = "MIT AND BSL-1.0"
+license-files = [
+    "LICENSE",
+    "LICENSES/BSL-1.0.txt",
+    "NOTICE",
+]
+keywords = [
+    "telegram",
+    "bot",
+    "testing",
+    "offline",
+    "android",
+]
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Testing",
+    "Typing :: Typed",
+]
+dependencies = ["pillow==12.3.0"]
+
+[[project.authors]]
+name = "Ali Mohammadzadeh"
+
+[project.urls]
+Homepage = "https://github.com/tholoo/GramLab"
+Documentation = "https://github.com/tholoo/GramLab/tree/main/docs"
+Repository = "https://github.com/tholoo/GramLab"
+Issues = "https://github.com/tholoo/GramLab/issues"
+Changelog = "https://github.com/tholoo/GramLab/blob/main/CHANGELOG.md"
+
+[project.scripts]
+gramlab = "gramlab.__main__:main"
+
+[dependency-groups]
+dev = [
+    "coverage==7.16.0",
+    "hypothesis==6.167.1",
+    "mypy==1.20.2",
+    "pytest==8.4.2",
+    "pytest-asyncio==1.4.0",
+    "pytest-cov==6.3.0",
+    "pytest-xdist==3.8.0",
+    "ruff==0.16.5",
+]
+
+[build-system]
+requires = ["uv_build==0.12.5"]
+build-backend = "uv_build"
+
+[tool.ruff]
+line-length = 100
+target-version = "py313"
+extend-exclude = ["clients/android/upstream"]
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "I",
+    "UP",
+    "B",
+    "ASYNC",
+    "S",
+    "RUF",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = [
+    "S101",
+    "S106",
+    "S311",
+]
+
+[tool.mypy]
+python_version = "3.13"
+strict = true
+warn_unreachable = true
+
+[tool.pytest.ini_options]
+addopts = "--strict-markers --strict-config -q"
+testpaths = ["tests"]
+asyncio_mode = "strict"
+markers = [
+    "android: requires the isolated Android runtime",
+    "stress: explicitly selected randomized or load tests",
+    "conformance: requires separately reviewed external compatibility evidence",
+]

gramlab-0.1.0a1/pyproject.toml.orig

@@ -0,0 +1,77 @@
+[project]
+name = "gramlab"
+version = "0.1.0a1"
+description = "Offline Telegram bot laboratory — experimental runtime foundation"
+readme = "README.md"
+requires-python = ">=3.13,<3.14"
+license = "MIT AND BSL-1.0"
+license-files = ["LICENSE", "LICENSES/BSL-1.0.txt", "NOTICE"]
+authors = [
+    { name = "Ali Mohammadzadeh" },
+]
+keywords = ["telegram", "bot", "testing", "offline", "android"]
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Testing",
+    "Typing :: Typed",
+]
+dependencies = [
+    "pillow==12.3.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/tholoo/GramLab"
+Documentation = "https://github.com/tholoo/GramLab/tree/main/docs"
+Repository = "https://github.com/tholoo/GramLab"
+Issues = "https://github.com/tholoo/GramLab/issues"
+Changelog = "https://github.com/tholoo/GramLab/blob/main/CHANGELOG.md"
+
+[project.scripts]
+gramlab = "gramlab.__main__:main"
+
+[dependency-groups]
+dev = [
+  "coverage==7.16.0",
+  "hypothesis==6.167.1",
+  "mypy==1.20.2",
+  "pytest==8.4.2",
+  "pytest-asyncio==1.4.0",
+  "pytest-cov==6.3.0",
+  "pytest-xdist==3.8.0",
+  "ruff==0.16.5",
+]
+
+[build-system]
+requires = ["uv_build==0.12.5"]
+build-backend = "uv_build"
+
+[tool.ruff]
+line-length = 100
+target-version = "py313"
+extend-exclude = ["clients/android/upstream"]
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "ASYNC", "S", "RUF"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["S101", "S106", "S311"]
+
+[tool.mypy]
+python_version = "3.13"
+strict = true
+warn_unreachable = true
+
+[tool.pytest.ini_options]
+addopts = "--strict-markers --strict-config -q"
+testpaths = ["tests"]
+asyncio_mode = "strict"
+markers = [
+  "android: requires the isolated Android runtime",
+  "stress: explicitly selected randomized or load tests",
+  "conformance: requires separately reviewed external compatibility evidence",
+]

gramlab-0.1.0a1/src/gramlab/README.md

@@ -0,0 +1,6 @@
+# Python core and SDK
+
+Reserved for independently written MIT-licensed simulation, Bot API transport, scenario control
+and reporting code. The package exports the experimental typed scenario-authoring interface;
+`runtime.py` implements its Linux process boundary. No stable simulator interface exists yet. Keep Android-derived
+classes and generated client-derived code outside this boundary.

gramlab-0.1.0a1/src/gramlab/__init__.py

@@ -0,0 +1,36 @@
+"""GramLab's experimental scenario-authoring interface."""
+
+from gramlab.scenario import Scenario, ScenarioError
+from gramlab.scenario_flow import (
+    Bot,
+    BotState,
+    BotStatus,
+    Callback,
+    Capture,
+    Conversation,
+    InlineAction,
+    InlineButton,
+    InteractionReceipt,
+    Message,
+    ScenarioFlowError,
+    ScenarioWaitTimeout,
+    User,
+)
+
+__all__ = [
+    "Bot",
+    "BotState",
+    "BotStatus",
+    "Callback",
+    "Capture",
+    "Conversation",
+    "InlineAction",
+    "InlineButton",
+    "InteractionReceipt",
+    "Message",
+    "Scenario",
+    "ScenarioError",
+    "ScenarioFlowError",
+    "ScenarioWaitTimeout",
+    "User",
+]

gramlab-0.1.0a1/src/gramlab/__main__.py

@@ -0,0 +1,46 @@
+"""Public command entry point; consumer code is only executed inside the runtime."""
+
+import argparse
+import os
+import sys
+from pathlib import Path
+
+from gramlab.runner import run
+from gramlab.runtime import RuntimeProfile
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(prog="gramlab")
+    commands = parser.add_subparsers(dest="command", required=True)
+    execute = commands.add_parser("run", help="Run a declared scenario and bots offline")
+    execute.add_argument("manifest", type=Path)
+    execute.add_argument("--output", type=Path, required=True, help="Fresh run directory")
+    execute.add_argument("--profile", type=Path, default=os.environ.get("GRAMLAB_RUNTIME_PROFILE"))
+    execute.add_argument(
+        "--android-profile", type=Path, default=os.environ.get("GRAMLAB_ANDROID_RUNTIME_PROFILE")
+    )
+    execute.add_argument("--android-apk", type=Path, default=os.environ.get("GRAMLAB_ANDROID_APK"))
+    execute.add_argument("--bridge-version", type=int, choices=(3, 4, 5, 6), default=3)
+    args = parser.parse_args()
+    if args.profile is None:
+        parser.error("Enter the provisioned Nix shell or supply --profile")
+    try:
+        outcome = run(
+            args.manifest,
+            args.output,
+            profile=RuntimeProfile.load(args.profile),
+            android_profile=RuntimeProfile.load(args.android_profile)
+            if args.android_profile
+            else None,
+            android_apk=args.android_apk,
+            bridge_version=args.bridge_version,
+        )
+    except (OSError, ValueError, KeyError, TypeError) as error:
+        print(f"gramlab: cannot prepare run ({type(error).__name__}): {error}", file=sys.stderr)
+        return 2
+    print(f"{outcome}: {args.output / 'report.html'}")
+    return 0 if outcome == "passed" else 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())