steero 0.0.1__tar.gz

steero-0.0.1/.gitignore

@@ -0,0 +1,58 @@
+# Environment
+env/
+venv/
+ENV/
+VENV/
+.venv/
+
+# Python cache
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+
+# Build and distribution
+build/
+dist/
+*.egg-info/
+.eggs/
+*.egg
+*.whl
+*.tar.gz
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Testing / typing / linting
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+.ruff_cache/
+.tox/
+
+# Data and downloads
+dl/
+downloads/
+data/
+
+# Databases
+*.db
+*.sqlite
+*.sqlite3
+
+# Secrets / local config
+.env
+*.local
+
+# Local working notes (per-chat session summaries; never committed)
+SCRATCHPAD.md
+scratchpad/
+
+# IDE and OS
+.DS_Store
+.vscode/
+.idea/
+*.swp
+*.swo
+*~

steero-0.0.1/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+<!--
+Author: Pandiyaraj Karuppasamy
+Date: Oct-17-2026
+-->
+
+All notable changes are listed here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project uses
+[Semantic Versioning](https://semver.org/). Before 1.0, a minor version may
+change the API.
+
+## [Unreleased]
+
+### Added
+- Contributor guide, code of conduct, security policy, governance, issue forms
+  and the first architecture decision record (BiDi first).
+- Local release gate, `tools/release_gate.ps1`.
+
+## [0.0.1]
+
+### Added
+- Name reservation release: package metadata, MIT licence and disclaimer. No
+  driver code yet.

steero-0.0.1/DISCLAIMER.md

@@ -0,0 +1,34 @@
+# Disclaimer
+
+<!--
+Author: Pandiyaraj Karuppasamy
+Date: Oct-17-2026
+-->
+
+steero 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 non-infringement.
+
+**You use steero entirely at your own risk.** steero launches web browsers and
+automates them: it can click, type, submit forms, download files and send network
+requests against any site it is pointed at. An automation script can therefore
+change or delete data, place orders, send messages or trigger other actions on
+real systems.
+
+To the maximum extent permitted by law, the authors and contributors accept no
+liability for any loss or damage arising from its use, including data loss or
+corruption, damage to hardware, systems that will not start, business
+interruption, account suspension, or any indirect or consequential damages.
+
+You are responsible for:
+
+- verifying which sites, accounts and environments your scripts act on;
+- keeping tested backups of anything that matters;
+- being authorised to automate the sites and accounts you drive, and following
+  their terms of service.
+
+steero is not certified for regulated, forensic, safety-critical or other
+high-assurance use.
+
+The [LICENSE](LICENSE) file (MIT) is the governing text. Where this summary and
+the LICENSE differ, the LICENSE prevails.

steero-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pandiyaraj Karuppasamy
+
+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.

steero-0.0.1/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: steero
+Version: 0.0.1
+Summary: Typed, async-first Python driver for stock Chrome and Firefox over W3C WebDriver BiDi, with auto-waiting and self-healing locators
+Project-URL: Repository, https://github.com/Pandiyarajk/steero
+Project-URL: Issues, https://github.com/Pandiyarajk/steero/issues
+Author-email: Pandiyaraj Karuppasamy <pandiyarajk@live.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: auto-wait,bidi,browser-automation,chrome,firefox,pytest,testing,ui-testing,webdriver,webdriver-bidi
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == 'dev'
+Requires-Dist: mypy>=1.11; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Requires-Dist: twine>=4.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# steero
+
+> **Disclaimer.** steero is provided **AS IS**, without warranty of any kind,
+> express or implied. **Use it entirely at your own risk.** It launches and
+> controls web browsers and can act on any site you point it at. The authors
+> accept no liability for data loss or corruption, damage to hardware, systems
+> that will not start, business interruption, or any consequential damages.
+> You are responsible for checking what you automate, keeping tested backups,
+> and being authorised to act on the sites and accounts you drive. steero is not
+> certified for regulated, forensic, safety-critical or high-assurance use.
+> See [DISCLAIMER.md](DISCLAIMER.md). The [LICENSE](LICENSE) (MIT) is the
+> governing text and prevails wherever it and this summary differ.
+
+Typed, async-first Python driver for **stock** Chrome and Firefox over the W3C
+**WebDriver BiDi** standard, with auto-waiting and self-healing locators.
+
+## Status
+
+**Pre-alpha. This 0.0.1 release reserves the name and contains no driver yet.**
+Follow the repository for progress.
+
+## Goals
+
+- Drives the Chrome and Firefox you already have, with no patched browser builds.
+  CDP is an opt-in extra for Chromium only.
+- Auto-waiting and actionability checks before every action, in pure Python.
+- Fully typed protocol models, generated from the BiDi specification.
+- Async core with a sync API on top.
+- A pytest plugin that captures console errors, failed requests and a screenshot
+  on failure, plus deterministic self-healing locators.
+- Leaves nothing behind: no orphaned browser processes, no leaked temp profiles.
+
+## Install
+
+```bash
+pip install steero
+```
+
+Or from a checkout:
+
+```bash
+pip install -e .
+```
+
+## Usage
+
+Planned API (not implemented yet):
+
+```python
+from steero.sync_api import launch
+
+with launch("firefox", headless=True) as browser:
+    page = browser.new_page()
+    page.goto("https://example.com")
+    page.get_by_role("link", name="More information").click()  # waits until actionable
+    page.screenshot(path="out.png")
+```
+
+## Contributing
+
+Contributions are welcome: see [CONTRIBUTING.md](CONTRIBUTING.md), the
+[Code of Conduct](CODE_OF_CONDUCT.md) and [GOVERNANCE.md](GOVERNANCE.md). Report
+security problems privately, as described in [SECURITY.md](SECURITY.md).
+Design decisions are recorded in [docs/adr/](docs/adr/).
+
+## License
+
+MIT - see [LICENSE](LICENSE).

steero-0.0.1/README.md

@@ -0,0 +1,68 @@
+# steero
+
+> **Disclaimer.** steero is provided **AS IS**, without warranty of any kind,
+> express or implied. **Use it entirely at your own risk.** It launches and
+> controls web browsers and can act on any site you point it at. The authors
+> accept no liability for data loss or corruption, damage to hardware, systems
+> that will not start, business interruption, or any consequential damages.
+> You are responsible for checking what you automate, keeping tested backups,
+> and being authorised to act on the sites and accounts you drive. steero is not
+> certified for regulated, forensic, safety-critical or high-assurance use.
+> See [DISCLAIMER.md](DISCLAIMER.md). The [LICENSE](LICENSE) (MIT) is the
+> governing text and prevails wherever it and this summary differ.
+
+Typed, async-first Python driver for **stock** Chrome and Firefox over the W3C
+**WebDriver BiDi** standard, with auto-waiting and self-healing locators.
+
+## Status
+
+**Pre-alpha. This 0.0.1 release reserves the name and contains no driver yet.**
+Follow the repository for progress.
+
+## Goals
+
+- Drives the Chrome and Firefox you already have, with no patched browser builds.
+  CDP is an opt-in extra for Chromium only.
+- Auto-waiting and actionability checks before every action, in pure Python.
+- Fully typed protocol models, generated from the BiDi specification.
+- Async core with a sync API on top.
+- A pytest plugin that captures console errors, failed requests and a screenshot
+  on failure, plus deterministic self-healing locators.
+- Leaves nothing behind: no orphaned browser processes, no leaked temp profiles.
+
+## Install
+
+```bash
+pip install steero
+```
+
+Or from a checkout:
+
+```bash
+pip install -e .
+```
+
+## Usage
+
+Planned API (not implemented yet):
+
+```python
+from steero.sync_api import launch
+
+with launch("firefox", headless=True) as browser:
+    page = browser.new_page()
+    page.goto("https://example.com")
+    page.get_by_role("link", name="More information").click()  # waits until actionable
+    page.screenshot(path="out.png")
+```
+
+## Contributing
+
+Contributions are welcome: see [CONTRIBUTING.md](CONTRIBUTING.md), the
+[Code of Conduct](CODE_OF_CONDUCT.md) and [GOVERNANCE.md](GOVERNANCE.md). Report
+security problems privately, as described in [SECURITY.md](SECURITY.md).
+Design decisions are recorded in [docs/adr/](docs/adr/).
+
+## License
+
+MIT - see [LICENSE](LICENSE).

steero-0.0.1/pyproject.toml

@@ -0,0 +1,90 @@
+[build-system]
+# Upper bound is deliberate: hatchling 1.28 emits Metadata-Version 2.5, which
+# PyPI does not yet accept and `twine check` rejects. Lift it once both support
+# 2.5 - verify with `python -m twine check dist/*`.
+requires = ["hatchling>=1.21,<1.28"]
+build-backend = "hatchling.build"
+
+[project]
+name = "steero"
+version = "0.0.1"
+description = "Typed, async-first Python driver for stock Chrome and Firefox over W3C WebDriver BiDi, with auto-waiting and self-healing locators"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
+authors = [
+    { name = "Pandiyaraj Karuppasamy", email = "pandiyarajk@live.com" },
+]
+keywords = [
+    "browser-automation",
+    "webdriver",
+    "webdriver-bidi",
+    "bidi",
+    "chrome",
+    "firefox",
+    "testing",
+    "ui-testing",
+    "pytest",
+    "auto-wait",
+]
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Framework :: AsyncIO",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Internet :: WWW/HTTP :: Browsers",
+    "Topic :: Software Development :: Quality Assurance",
+    "Topic :: Software Development :: Testing",
+    "Typing :: Typed",
+]
+# Runtime dependencies (websockets, msgspec) arrive with the transport in Phase 1.
+dependencies = []
+
+[project.urls]
+Repository = "https://github.com/Pandiyarajk/steero"
+Issues = "https://github.com/Pandiyarajk/steero/issues"
+
+[project.optional-dependencies]
+dev = [
+    "build>=1.0",
+    "twine>=4.0",
+    "pytest>=7.0",
+    "mypy>=1.11",
+    "ruff>=0.6",
+]
+
+# Uncomment to install a console command, and add a main() to steero/__main__.py:
+# [project.scripts]
+# steero = "steero.__main__:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["steero"]
+artifacts = ["steero/py.typed"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/steero",
+    "/README.md",
+    "/LICENSE",
+    "/DISCLAIMER.md",
+    "/CHANGELOG.md",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "B", "UP"]

steero-0.0.1/steero/__init__.py

@@ -0,0 +1,10 @@
+"""steero: a typed, async-first Python driver for stock Chrome and Firefox.
+
+Drives browsers over W3C WebDriver BiDi, with auto-waiting and self-healing
+locators.
+
+Author: Pandiyaraj Karuppasamy
+Date: Oct-17-2026
+"""
+
+__version__ = "0.0.1"