atsfill 0.0.1__tar.gz

atsfill-0.0.1/LICENSE

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

atsfill-0.0.1/PKG-INFO

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: atsfill
+Version: 0.0.1
+Summary: Read, dry-run and submit job application forms on hiring systems: Ashby, Greenhouse, Teamtailor, Welcome to the Jungle.
+Keywords: job-applications,ats,ashby,greenhouse,teamtailor,ai-agents,cli
+Author: shbernal
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Office/Business
+Classifier: Typing :: Typed
+Requires-Dist: camoufox==0.5.8
+Requires-Python: >=3.14
+Project-URL: Homepage, https://github.com/shbernal/atsfill
+Project-URL: Repository, https://github.com/shbernal/atsfill
+Project-URL: Issues, https://github.com/shbernal/atsfill/issues
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# atsfill
+
+Fill job application forms from the command line: read, dry-run, then submit.
+
+[![PyPI][pypi-badge]][pypi]
+[![Python][python-badge]][pypi]
+[![CI][ci-badge]][ci]
+[![License][license-badge]][license]
+
+---
+
+[Install](#install) • [Quickstart](#quickstart) • [How it works](#how-it-works) • [Docs](docs/adr/README.md)
+
+---
+
+</div>
+
+atsfill reads the application form behind a job posting, fills it with your answers, and checks what the hiring system will receive before anything is sent.
+It is built for agents with a shell: every command prints one JSON document and exits with a code a script can branch on.
+
+- `read` lists a form's fields with their ids, types, options and whether they are required.
+- `fill` is a dry run: it fills the form, reads it back field by field, and never submits.
+- `send` fills again and submits only when every answer reads back as given.
+- Submitting is off until you enable it per hiring system, in a config file the agent does not write.
+- A posting already sent is refused unless you pass `--resend`.
+
+## Supported hiring systems
+
+| System | Account needed | `read` without a browser |
+| --- | --- | --- |
+| Ashby | no | yes |
+| Greenhouse | no | yes |
+| Teamtailor | no | no |
+| Welcome to the Jungle | yes, `atsfill login wttj` | no |
+
+Any other system returns `unsupported`, so the caller can fall back to driving a browser itself.
+
+## Why atsfill?
+
+An agent applying through a generic browser carries each system's quirks as prose, rereads it every run, and checks the form before submitting only because an instruction says so.
+atsfill moves the quirks into one adapter per system and makes the check code: a `send` whose read-back differs from the answers is refused.
+
+| | Generic browser agent | atsfill |
+| --- | --- | --- |
+| System quirks | prose in the prompt | an adapter per system |
+| Check before submit | an instruction | the read-back must match |
+| Permission to submit | whatever the agent decides | a config file, per system |
+| Double send | possible | refused without `--resend` |
+| Output | page snapshots | one JSON result |
+
+## Install
+
+atsfill runs on Linux and macOS with Python 3.14, which `uvx` fetches if needed.
+
+```sh
+uvx atsfill install-browser
+```
+
+This downloads the Camoufox browser build atsfill is pinned to: 1.3 GB, about 2.5 GB once unpacked.
+
+## Quickstart
+
+1. List the form's fields:
+
+   ```sh
+   uvx atsfill read https://job-boards.greenhouse.io/acme/jobs/1234
+   ```
+
+2. Write your answers to `answers.json`, keyed by field id. Files take an absolute path:
+
+   ```json
+   {
+     "first_name": "Ada",
+     "last_name": "Lovelace",
+     "email": "ada@example.com",
+     "resume": "/home/ada/resume.pdf"
+   }
+   ```
+
+3. Dry-run the fill. It ends `ready` when every answer reads back as given:
+
+   ```sh
+   uvx atsfill fill https://job-boards.greenhouse.io/acme/jobs/1234 --answers answers.json
+   ```
+
+4. Allow the system to submit in `~/.config/atsfill/config.toml`:
+
+   ```toml
+   submit = ["greenhouse"]
+   ```
+
+5. Send. A `submitted` result carries the evidence of the send:
+
+   ```sh
+   uvx atsfill send https://job-boards.greenhouse.io/acme/jobs/1234 --answers answers.json
+   ```
+
+A dry run is not invisible: some systems save answers or the resume as they are typed.
+`atsfill status` lists each system's side effects and whether it is allowed to submit.
+
+## How it works
+
+```mermaid
+flowchart LR
+    CLI[atsfill CLI] --> Core
+    Core -->|detect, read, fill, read back, submit| Adapter[adapter for the system]
+    Adapter --> Browser[headless Camoufox]
+    Core --> Gate{read-back matches,<br>submit enabled,<br>not already sent}
+    Gate -->|yes| Submit[submit]
+    Gate -->|no| Refused[refused]
+```
+
+Each command launches its own headless Camoufox, a Firefox build patched to hide automation, with a fresh context and one saved device identity.
+The core owns every rule about when a send is allowed; an adapter only knows its system's page.
+
+Every result has a `status` (`ready`, `refused`, `submitted`, `blocked`, `unknown`, `unsupported`) and, when it is not clean, a `reason` code.
+The exit code is 0 for `ready` and `submitted`, 1 otherwise, 2 for a usage error.
+
+## More
+
+- [Architecture decisions](docs/adr/README.md): the contract, the submit gate, the browser, sessions.
+- [Hiring systems](docs/adapters/): each system's form as observed.
+- `atsfill --help` for every command and option.
+
+[pypi]: https://pypi.org/project/atsfill/
+[pypi-badge]: https://img.shields.io/pypi/v/atsfill?style=for-the-badge&color=7aa2f7&logo=pypi&logoColor=white
+[python-badge]: https://img.shields.io/pypi/pyversions/atsfill?style=for-the-badge&color=9ece6a&logo=python&logoColor=white
+[ci]: https://github.com/shbernal/atsfill/actions/workflows/ci.yml
+[ci-badge]: https://img.shields.io/github/actions/workflow/status/shbernal/atsfill/ci.yml?branch=main&style=for-the-badge&color=bb9af7&logo=githubactions&logoColor=white
+[license]: LICENSE
+[license-badge]: https://img.shields.io/github/license/shbernal/atsfill?style=for-the-badge&color=e0af68

atsfill-0.0.1/README.md

@@ -0,0 +1,133 @@
+<div align="center">
+
+# atsfill
+
+Fill job application forms from the command line: read, dry-run, then submit.
+
+[![PyPI][pypi-badge]][pypi]
+[![Python][python-badge]][pypi]
+[![CI][ci-badge]][ci]
+[![License][license-badge]][license]
+
+---
+
+[Install](#install) • [Quickstart](#quickstart) • [How it works](#how-it-works) • [Docs](docs/adr/README.md)
+
+---
+
+</div>
+
+atsfill reads the application form behind a job posting, fills it with your answers, and checks what the hiring system will receive before anything is sent.
+It is built for agents with a shell: every command prints one JSON document and exits with a code a script can branch on.
+
+- `read` lists a form's fields with their ids, types, options and whether they are required.
+- `fill` is a dry run: it fills the form, reads it back field by field, and never submits.
+- `send` fills again and submits only when every answer reads back as given.
+- Submitting is off until you enable it per hiring system, in a config file the agent does not write.
+- A posting already sent is refused unless you pass `--resend`.
+
+## Supported hiring systems
+
+| System | Account needed | `read` without a browser |
+| --- | --- | --- |
+| Ashby | no | yes |
+| Greenhouse | no | yes |
+| Teamtailor | no | no |
+| Welcome to the Jungle | yes, `atsfill login wttj` | no |
+
+Any other system returns `unsupported`, so the caller can fall back to driving a browser itself.
+
+## Why atsfill?
+
+An agent applying through a generic browser carries each system's quirks as prose, rereads it every run, and checks the form before submitting only because an instruction says so.
+atsfill moves the quirks into one adapter per system and makes the check code: a `send` whose read-back differs from the answers is refused.
+
+| | Generic browser agent | atsfill |
+| --- | --- | --- |
+| System quirks | prose in the prompt | an adapter per system |
+| Check before submit | an instruction | the read-back must match |
+| Permission to submit | whatever the agent decides | a config file, per system |
+| Double send | possible | refused without `--resend` |
+| Output | page snapshots | one JSON result |
+
+## Install
+
+atsfill runs on Linux and macOS with Python 3.14, which `uvx` fetches if needed.
+
+```sh
+uvx atsfill install-browser
+```
+
+This downloads the Camoufox browser build atsfill is pinned to: 1.3 GB, about 2.5 GB once unpacked.
+
+## Quickstart
+
+1. List the form's fields:
+
+   ```sh
+   uvx atsfill read https://job-boards.greenhouse.io/acme/jobs/1234
+   ```
+
+2. Write your answers to `answers.json`, keyed by field id. Files take an absolute path:
+
+   ```json
+   {
+     "first_name": "Ada",
+     "last_name": "Lovelace",
+     "email": "ada@example.com",
+     "resume": "/home/ada/resume.pdf"
+   }
+   ```
+
+3. Dry-run the fill. It ends `ready` when every answer reads back as given:
+
+   ```sh
+   uvx atsfill fill https://job-boards.greenhouse.io/acme/jobs/1234 --answers answers.json
+   ```
+
+4. Allow the system to submit in `~/.config/atsfill/config.toml`:
+
+   ```toml
+   submit = ["greenhouse"]
+   ```
+
+5. Send. A `submitted` result carries the evidence of the send:
+
+   ```sh
+   uvx atsfill send https://job-boards.greenhouse.io/acme/jobs/1234 --answers answers.json
+   ```
+
+A dry run is not invisible: some systems save answers or the resume as they are typed.
+`atsfill status` lists each system's side effects and whether it is allowed to submit.
+
+## How it works
+
+```mermaid
+flowchart LR
+    CLI[atsfill CLI] --> Core
+    Core -->|detect, read, fill, read back, submit| Adapter[adapter for the system]
+    Adapter --> Browser[headless Camoufox]
+    Core --> Gate{read-back matches,<br>submit enabled,<br>not already sent}
+    Gate -->|yes| Submit[submit]
+    Gate -->|no| Refused[refused]
+```
+
+Each command launches its own headless Camoufox, a Firefox build patched to hide automation, with a fresh context and one saved device identity.
+The core owns every rule about when a send is allowed; an adapter only knows its system's page.
+
+Every result has a `status` (`ready`, `refused`, `submitted`, `blocked`, `unknown`, `unsupported`) and, when it is not clean, a `reason` code.
+The exit code is 0 for `ready` and `submitted`, 1 otherwise, 2 for a usage error.
+
+## More
+
+- [Architecture decisions](docs/adr/README.md): the contract, the submit gate, the browser, sessions.
+- [Hiring systems](docs/adapters/): each system's form as observed.
+- `atsfill --help` for every command and option.
+
+[pypi]: https://pypi.org/project/atsfill/
+[pypi-badge]: https://img.shields.io/pypi/v/atsfill?style=for-the-badge&color=7aa2f7&logo=pypi&logoColor=white
+[python-badge]: https://img.shields.io/pypi/pyversions/atsfill?style=for-the-badge&color=9ece6a&logo=python&logoColor=white
+[ci]: https://github.com/shbernal/atsfill/actions/workflows/ci.yml
+[ci-badge]: https://img.shields.io/github/actions/workflow/status/shbernal/atsfill/ci.yml?branch=main&style=for-the-badge&color=bb9af7&logo=githubactions&logoColor=white
+[license]: LICENSE
+[license-badge]: https://img.shields.io/github/license/shbernal/atsfill?style=for-the-badge&color=e0af68

atsfill-0.0.1/pyproject.toml

@@ -0,0 +1,76 @@
+[project]
+name = "atsfill"
+version = "0.0.1"
+description = "Read, dry-run and submit job application forms on hiring systems: Ashby, Greenhouse, Teamtailor, Welcome to the Jungle."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.14"
+keywords = [
+    "job-applications",
+    "ats",
+    "ashby",
+    "greenhouse",
+    "teamtailor",
+    "ai-agents",
+    "cli",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Office/Business",
+    "Typing :: Typed",
+]
+dependencies = ["camoufox==0.5.8"]
+
+[[project.authors]]
+name = "shbernal"
+
+[project.urls]
+Homepage = "https://github.com/shbernal/atsfill"
+Repository = "https://github.com/shbernal/atsfill"
+Issues = "https://github.com/shbernal/atsfill/issues"
+
+[project.scripts]
+atsfill = "atsfill.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.13.0,<0.14.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.1.1",
+    "ruff>=0.17.1",
+    "ty==0.0.89",
+]
+
+[tool.ruff]
+target-version = "py314"
+line-length = 100
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "I",
+    "UP",
+    "B",
+    "SIM",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+markers = ["live: drives a real hiring system page with data from .env and .tmp/; opt-in with -m live"]
+addopts = "-m 'not live'"
+
+[[tool.uv.index]]
+name = "testpypi"
+url = "https://test.pypi.org/simple/"
+publish-url = "https://test.pypi.org/legacy/"
+explicit = true

atsfill-0.0.1/pyproject.toml.orig

@@ -0,0 +1,63 @@
+[project]
+name = "atsfill"
+version = "0.0.1"
+description = "Read, dry-run and submit job application forms on hiring systems: Ashby, Greenhouse, Teamtailor, Welcome to the Jungle."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "shbernal" }]
+requires-python = ">=3.14"
+keywords = ["job-applications", "ats", "ashby", "greenhouse", "teamtailor", "ai-agents", "cli"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: MacOS",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Office/Business",
+    "Typing :: Typed",
+]
+dependencies = [
+    "camoufox==0.5.8",
+]
+
+[project.urls]
+Homepage = "https://github.com/shbernal/atsfill"
+Repository = "https://github.com/shbernal/atsfill"
+Issues = "https://github.com/shbernal/atsfill/issues"
+
+[project.scripts]
+atsfill = "atsfill.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.13.0,<0.14.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.1.1",
+    "ruff>=0.17.1",
+    "ty==0.0.89",
+]
+
+[tool.ruff]
+target-version = "py314"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B", "SIM"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+markers = [
+    "live: drives a real hiring system page with data from .env and .tmp/; opt-in with -m live",
+]
+addopts = "-m 'not live'"
+
+[[tool.uv.index]]
+name = "testpypi"
+url = "https://test.pypi.org/simple/"
+publish-url = "https://test.pypi.org/legacy/"
+explicit = true

atsfill-0.0.1/src/atsfill/adapters/__init__.py

@@ -0,0 +1,7 @@
+from atsfill.adapters.ashby import Ashby
+from atsfill.adapters.greenhouse import Greenhouse
+from atsfill.adapters.teamtailor import Teamtailor
+from atsfill.adapters.wttj import WelcomeToTheJungle
+from atsfill.core.adapter import Adapter
+
+ADAPTERS: list[Adapter] = [Ashby(), Teamtailor(), Greenhouse(), WelcomeToTheJungle()]