atsfill 0.0.4.dev98__tar.gz → 0.0.4.dev99__tar.gz

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atsfill
-Version: 0.0.4.dev98
+Version: 0.0.4.dev99
 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

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "atsfill"
-version = "0.0.4.dev98"
+version = "0.0.4.dev99"
 description = "Read, dry-run and submit job application forms on hiring systems: Ashby, Greenhouse, Teamtailor, Welcome to the Jungle."
 readme = "README.md"
 license = "MIT"

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "atsfill"
-version = "0.0.4.dev98"
+version = "0.0.4.dev99"
 description = "Read, dry-run and submit job application forms on hiring systems: Ashby, Greenhouse, Teamtailor, Welcome to the Jungle."
 readme = "README.md"
 license = "MIT"

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/ashby.py

@@ -19,7 +19,7 @@ from atsfill.core.results import Answer, Field, FieldType, SideEffect
 
 HOST = "jobs.ashbyhq.com"
 GRAPHQL = f"https://{HOST}/api/non-user-graphql?op=ApiJobPosting"
-# The fields of the page's own ApiJobPosting query that `read_form` uses.
+# The fields of the page's own ApiJobPosting query that `browser_read` uses.
 JOB_POSTING = """query ApiJobPosting($org: String!, $job: String!) {
   jobPosting(organizationHostedJobsPageName: $org, jobPostingId: $job) {
     applicationForm { ...Form }
@@ -78,7 +78,7 @@ class Ashby:
 
     def __init__(self) -> None:
         self._forms: list[dict[str, Any]] = []  # the application form, then each survey
-        self._pending: set[Any] = set()  # GraphQL requests in flight, since `read_form`
+        self._pending: set[Any] = set()  # GraphQL requests in flight, since `browser_read`
         self._last_change = 0.0
         self._hosted: str | None = None  # the jobs.ashbyhq.com posting a custom domain embeds
 
@@ -100,7 +100,7 @@ class Ashby:
     def posting(self, url: str) -> str:
         return _hosted(url) if urlsplit(url).hostname == HOST else self._hosted or url
 
-    def read_api(self, url: str) -> list[Field] | None:
+    def request_read(self, url: str) -> list[Field] | None:
         """The fields from the GraphQL query the job page itself sends, for a hosted URL."""
         if urlsplit(url).hostname != HOST:
             return None
@@ -125,7 +125,7 @@ class Ashby:
         except OSError, ValueError, KeyError, TypeError, Unsupported:
             return None
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         page.on("request", self._on_request)
         page.on("requestfinished", self._on_finished)
         page.on("requestfailed", self._on_finished)

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/bamboohr.py

@@ -1,8 +1,8 @@
 """BambooHR (`<employer>.bamboohr.com/careers/<job>`), as docs/adapters/bamboohr.md observes.
 
 The job page renders its application form, behind Apply for This Job, from a public JSON
-answer that lists every field with its label, requirement and options. `read_api` fetches it
-over HTTP, `read_form` through the page's own browser context, and both list the fields from
+answer that lists every field with its label, requirement and options. `request_read` fetches it
+over HTTP, `browser_read` through the page's own browser context, and both list the fields from
 it. Dropdowns are Fabric menus over a hidden `select`; a file is uploaded once attached.
 """
 
@@ -159,7 +159,7 @@ class BambooHR:
         job = _job(url)
         return f"https://{job[0]}/careers/{job[1]}" if job else url
 
-    def read_api(self, url: str) -> list[Field] | None:
+    def request_read(self, url: str) -> list[Field] | None:
         if (job := _job(url)) is None:
             return None
         try:
@@ -169,7 +169,7 @@ class BambooHR:
         except OSError, ValueError, KeyError, TypeError, Unsupported:
             return None
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         host, job = _job(page.url) or ("", "")
         form = page.locator(FORM)
         try:

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/breezy.py

@@ -2,8 +2,8 @@
 docs/adapters/breezy.md observes.
 
 Two page engines, an AngularJS one and a React one, render the same markup: named controls
-under `h3` headings, the questionnaire's as `section_<section>_question_<n>`. The fields are
-read from the page. Files upload to Breezy when attached; the rest reaches it on submit.
+under `h3` headings, the questionnaire's as `section_<section>_question_<n>`. Only a browser
+read lists the fields. Files upload to Breezy when attached; the rest reaches it on submit.
 """
 
 import re
@@ -236,7 +236,7 @@ class Breezy:
         match = JOB.match(parts.path)
         return f"https://{parts.hostname}/p/{match[1]}" if match else url
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         if not urlsplit(page.url).path.rstrip("/").endswith("/apply"):
             page.goto(f"{self.posting(page.url)}/apply")
         form = page.locator(FORM)

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/dayforce.py

@@ -197,7 +197,7 @@ class Dayforce:
         found = _job(url)
         return f"https://{HOST}/{found[1]}/{found[2]}/jobs/{found[3]}" if found else url
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         found = _job(page.url)
         if found is None:
             raise Unsupported("posting_gone: not a Dayforce job page")
@@ -481,7 +481,7 @@ class Dayforce:
             option = box_id.removeprefix(f"{base}answerFollowup").removeprefix("s_")
             followup = f"{field_id}.followup" + (f".{option}" if option else "")
             if box.is_visible() and followup not in self._fields:
-                self._shown.append(box_id)  # a comment box `read_form` did not list
+                self._shown.append(box_id)  # a comment box `browser_read` did not list
 
     def _set_question(
         self, page: Page, target: Locator, field: Field, question: dict[str, Any], answer: Answer

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/eightfold.py

@@ -3,7 +3,7 @@ the employer's own domain), as docs/adapters/eightfold.md observes.
 
 A posting's apply page (`/careers/apply?pid=<pid>`) renders its form from a questions API:
 sections of questions by id, type, requirement and options, and the questions whose answer
-shows each follow-up. `read_api` fetches it over HTTP, `read_form` through the page's browser
+shows each follow-up. `request_read` fetches it over HTTP, `browser_read` through the page's browser
 context, and both list the fields from it. Each question renders as a control whose element id
 is its section's title and its id, with every other character an underscore.
 """
@@ -162,7 +162,7 @@ class Eightfold:
         parts, pid = urlsplit(url), _pid(url)
         return f"https://{parts.hostname}/careers/job/{pid}" if pid else url
 
-    def read_api(self, url: str) -> list[Field] | None:
+    def request_read(self, url: str) -> list[Field] | None:
         if (pid := _pid(url)) is None:
             return None
         try:
@@ -185,7 +185,7 @@ class Eightfold:
         except OSError, ValueError, KeyError, TypeError, Unsupported, Blocked:
             return None
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         pid = _pid(page.url)
         if pid is None:
             raise Unsupported(f"posting_gone: {page.url} is not a job page")

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/greenhouse.py

@@ -44,7 +44,7 @@ API_TYPES = {
 }
 YES_NO = ["Yes", "No"]
 # Sections the page adds or names its own way, or shows a question of only on another answer
-# (EEOC race after Hispanic/Latino): `read_api` declines a posting with any (ADR 0011).
+# (EEOC race after Hispanic/Latino): `request_read` declines a posting with any (ADR 0011).
 UNMAPPED = ("education", "compliance", "demographic_questions")
 
 # The fields in page order. A select's options are read by opening it, from Python.
@@ -167,7 +167,7 @@ class Greenhouse:
         board, job = _board_job(url) or _board_job(self._embed or "") or ("", url)
         return f"https://job-boards.greenhouse.io/{board}/jobs/{job}"
 
-    def read_api(self, url: str) -> list[Field] | None:
+    def request_read(self, url: str) -> list[Field] | None:
         """The fields from the Job Board API, unless the page holds some the API leaves out."""
         found = _board_job(url)
         if found is None:
@@ -177,7 +177,7 @@ class Greenhouse:
         except OSError, ValueError, KeyError, TypeError:
             return None
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         if self._embed:
             page.goto(self._embed)
         form = page.locator(FORM)

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/hireology.py

@@ -2,7 +2,7 @@
 docs/adapters/hireology.md observes.
 
 The job page renders its application form from a public form API, which lists every field by
-id, type and requirement. `read_api` fetches it over HTTP, `read_form` through the page's own
+id, type and requirement. `request_read` fetches it over HTTP, `browser_read` through the page's own
 browser context, and both list the fields from it. Each field renders as one control whose id is
 `<field id>-<n>`; nothing but the submit reaches Hireology.
 """
@@ -202,7 +202,7 @@ class Hireology:
         job = _job(url)
         return API.format(job=job) if job else url
 
-    def read_api(self, url: str) -> list[Field] | None:
+    def request_read(self, url: str) -> list[Field] | None:
         if (job := _job(url)) is None:
             return None
         request = urllib.request.Request(API.format(job=job), headers={"User-Agent": "atsfill"})
@@ -212,7 +212,7 @@ class Hireology:
         except OSError, ValueError, KeyError, TypeError, Unsupported:
             return None
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         job = _job(page.url)
         try:
             page.locator(SUBMIT).wait_for(state="attached", timeout=FORM_TIMEOUT_MS)

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/hiringthing.py

@@ -4,7 +4,7 @@ observes.
 The job page carries the posting's configuration in a React component's props, and its Apply
 button renders the form from them in the page: MUI inputs named by field id, radios and boxes,
 react-select comboboxes for the country and state, Dropzone areas that upload a file as soon as
-it is attached. `read_form` lists the rendered controls; there is no `read_api`, since which
+it is attached. `browser_read` lists the rendered controls; there is no `request_read`, since which
 controls render is the page's logic over the props, not the props alone.
 """
 
@@ -157,7 +157,7 @@ class HiringThing:
         job = JOB.match(parts.path)
         return f"https://{parts.hostname}/job/{job[1]}" if job else url
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         props = page.locator(PROPS).first
         try:
             props.wait_for(state="attached", timeout=PAGE_TIMEOUT_MS)

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/jazzhr.py

@@ -140,7 +140,7 @@ class JazzHR:
         job = _job(url)
         return f"https://{job[0]}/apply/{job[1]}" if job else url
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         form = page.locator(FORM)
         try:
             form.wait_for(state="attached", timeout=FORM_TIMEOUT_MS)

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/lever.py

@@ -133,7 +133,7 @@ class Lever:
         parts, job = urlsplit(url), _job(url)
         return f"https://{parts.hostname}/{job[0]}/{job[1]}" if job else url
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         if not urlsplit(page.url).path.rstrip("/").endswith("/apply"):
             page.goto(f"{self.posting(page.url)}/apply")
         form = page.locator(FORM)

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/manatal.py

@@ -191,7 +191,7 @@ class Manatal:
     def posting(self, url: str) -> str:
         return _posting(url)
 
-    def read_api(self, url: str) -> list[Field] | None:
+    def request_read(self, url: str) -> list[Field] | None:
         """The fields from the endpoint the apply page fetches, its job id from that page."""
         client = urlsplit(url).path.strip("/").split("/")[0]
         try:
@@ -210,7 +210,7 @@ class Manatal:
         except OSError, ValueError, KeyError, TypeError:
             return None
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         with page.expect_response(
             lambda r: r.request.method == "GET" and "/application-form/" in r.url,
             timeout=LOAD_TIMEOUT_MS,

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/oracle.py

@@ -266,7 +266,7 @@ class Oracle:
         assert match, url
         return f"https://{parts.hostname}/hcmUI/CandidateExperience/job/{match[1]}"
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         parts = urlsplit(page.url)
         match = JOB.search(parts.path)
         assert match, page.url  # detected on a job URL

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/paycor.py

@@ -3,7 +3,7 @@
 The apply page is server-rendered. Before the form it may show pages of their own: the
 federal contractor's self-identification (VEVRAA) and the Yes/No qualifying questions. Each
 posts its answers to the next, which carries them as hidden inputs; the form posts everything
-to `ApplyJob.action` on Submit. `read_form` walks those pages to the form, `fill` walks them
+to `ApplyJob.action` on Submit. `browser_read` walks those pages to the form, `fill` walks them
 again with the answers.
 """
 
@@ -171,7 +171,7 @@ class Paycor:
         job = (query.get("id") or query.get("gni") or [url])[0]
         return f"{CAREER}JobIntroduction.action?id={job}"
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         self._before, self._codes = [], {}
         self._walk(page, None)
         controls = [(_field(c), c["kind"]) for c in page.evaluate(_CONTROLS)]

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/paylocity.py

@@ -2,8 +2,8 @@
 docs/adapters/paylocity.md observes.
 
 The apply page carries the whole form's configuration in `window.pageData`: the sections and
-their fields, the screener questions and the option lists. `read_api` fetches it over HTTP,
-`read_form` takes it from the page, and both list the fields from it. The form is one page or
+their fields, the screener questions and the option lists. `request_read` fetches it over HTTP,
+`browser_read` takes it from the page, and both list the fields from it. The form is one page or
 a wizard of steps that render one at a time, so `fill` keeps each step's read-back before
 moving on; nothing reaches the employer before Submit.
 """
@@ -326,7 +326,7 @@ class Paylocity:
         job = _job(url)
         return f"https://{HOST}/Recruiting/Jobs/Details/{job}" if job else url
 
-    def read_api(self, url: str) -> list[Field] | None:
+    def request_read(self, url: str) -> list[Field] | None:
         if (job := _job(url)) is None:
             return None
         request = urllib.request.Request(APPLY + job, headers={"User-Agent": "atsfill"})
@@ -337,7 +337,7 @@ class Paylocity:
         except OSError, ValueError, KeyError, TypeError, Unsupported:
             return None
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         job = _job(page.url)
         if job and "/apply/" not in page.url.lower():
             page.goto(APPLY + job)

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/personio.py

@@ -2,7 +2,7 @@
 
 The apply page is rendered on the server, its form whole in the HTML: every field is one native
 control named by its id, labelled by a `label[for]` or its group's label, a star marking it
-required. `read_api` fetches that HTML over HTTP, `read_form` takes the page's form, and both
+required. `request_read` fetches that HTML over HTTP, `browser_read` takes the page's form, and both
 list the fields from it with one parser. A document is uploaded to Personio once attached.
 """
 
@@ -72,7 +72,7 @@ class Personio:
         job = _job(url)
         return f"https://{job[0]}.jobs.personio.com/job/{job[1]}" if job else url
 
-    def read_api(self, url: str) -> list[Field] | None:
+    def request_read(self, url: str) -> list[Field] | None:
         if _job(url) is None:
             return None
         request = urllib.request.Request(_apply(url), headers={"User-Agent": "atsfill"})
@@ -84,7 +84,7 @@ class Personio:
         form = next((n for n in _parse(html).walk() if n.tag == "form"), None)
         return [f for f, _ in _form(form)] if form else None
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         if _job(page.url) and not urlsplit(page.url).path.rstrip("/").endswith("/apply"):
             page.goto(_apply(page.url))
         try:

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/phenom.py

@@ -4,7 +4,7 @@ as docs/adapters/phenom.md observes.
 The job page's Apply link leads to Phenom's own wizard (`/apply?jobSeqNo=`) or to another
 system. The wizard renders one step at a time from the employer's configuration, a form schema
 on Phenom's CDN, and the parts its loaders serve (the job's questionnaires, the country's
-fields, dependent lists): reading interprets them, over HTTP or from the page, without passing a
+fields, dependent lists): a request read or a browser read interprets them without passing a
 step. Filling walks the wizard on a fresh session, each step's answers read back before Next.
 """
 
@@ -260,7 +260,7 @@ class Phenom:
         seq = _seq(url)
         return f"https://{parts.hostname}/apply?jobSeqNo={seq}" if seq else url
 
-    def read_api(self, url: str) -> list[Field] | None:
+    def request_read(self, url: str) -> list[Field] | None:
         """The fields from the job's apply page and the configuration it names, over HTTP;
         None for a job applied to on another system, or a page it does not understand."""
         parts = urlsplit(url)
@@ -297,7 +297,7 @@ class Phenom:
         except OSError, ValueError, KeyError, TypeError, RuntimeError, Unsupported:
             return None
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         _check_open(page)
         self._apply = _apply_url(page)
         self._open(page)

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/pinpoint.py

@@ -2,8 +2,8 @@
 docs/adapters/pinpoint.md observes.
 
 The apply page is rendered on the server: the standard fields as native controls, every other
-field as a React component whose props sit in a JSON script next to it. `read_api` fetches that
-HTML over HTTP, `read_form` takes the page's form, and both list the fields from it with one
+field as a React component whose props sit in a JSON script next to it. `request_read` fetches that
+HTML over HTTP, `browser_read` takes the page's form, and both list the fields from it with one
 parser. A document is uploaded to Pinpoint once attached.
 """
 
@@ -125,7 +125,7 @@ class Pinpoint:
         job = _job(url)
         return f"https://{urlsplit(url).hostname}/en/postings/{job[1]}" if job else url
 
-    def read_api(self, url: str) -> list[Field] | None:
+    def request_read(self, url: str) -> list[Field] | None:
         if _job(url) is None:
             return None
         request = urllib.request.Request(_apply(url), headers={"User-Agent": "atsfill"})
@@ -139,7 +139,7 @@ class Pinpoint:
         )
         return [f for f, _ in _form(form, self)] if form else None
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         if _job(page.url) and not urlsplit(page.url).path.rstrip("/").endswith("/new"):
             page.goto(_apply(page.url))
         try:

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/recruitee.py

@@ -143,7 +143,7 @@ class Recruitee:
         match = JOB.match(parts.path)
         return f"https://{parts.hostname}/o/{match[1]}" if match else url
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         if not urlsplit(page.url).path.rstrip("/").endswith("/c/new"):
             page.goto(f"{self.posting(page.url)}/c/new")
         form = page.locator(FORM)

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/rippling.py

@@ -3,7 +3,7 @@ observes.
 
 The job's apply page (`…/apply`) carries its form in the page data: the standard questions by
 id and type, the employer's question groups, and whether the EEO questionnaire is asked.
-`read_api` fetches the page over HTTP, `read_form` reads the data of the page it opened, and
+`request_read` fetches the page over HTTP, `browser_read` reads the data of the page it opened, and
 both list the fields from it. Each field renders in an element whose `data-testid` is the
 field's id; the résumé is uploaded and parsed as soon as it is attached.
 """
@@ -175,7 +175,7 @@ class Rippling:
         job = _job(url)
         return POSTING.format(board=job[0], job=job[1]) if job else url
 
-    def read_api(self, url: str) -> list[Field] | None:
+    def request_read(self, url: str) -> list[Field] | None:
         if (job := _job(url)) is None:
             return None
         request = urllib.request.Request(
@@ -189,7 +189,7 @@ class Rippling:
         except OSError, ValueError, KeyError, TypeError, Unsupported:
             return None
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         job = _job(page.url)
         assert job is not None
         apply = APPLY.format(board=job[0], job=job[1])

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/smartrecruiters.py

@@ -2,7 +2,7 @@
 docs/adapters/smartrecruiters.md observes.
 
 The form is two pages: the profile, then the screening questions and consents. The second
-page's questions come from the page's own `__OC_CONTEXT__`, so `read_form` lists them without
+page's questions come from the page's own `__OC_CONTEXT__`, so `browser_read` lists them without
 leaving the first page. Nothing but the resume reaches SmartRecruiters before submit, so the
 read-back is the page: the profile as it stood when `fill` left it, then the second page.
 """
@@ -136,7 +136,7 @@ class SmartRecruiters:
     def posting(self, url: str) -> str:
         return _key(url) or url
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         if not ONECLICK.match(urlsplit(page.url).path):
             link = page.locator(APPLY_LINK).first
             try:
@@ -252,7 +252,7 @@ class SmartRecruiters:
         return fields
 
     def _question_answers(self, question_id: str) -> list[tuple[str, dict[str, Any]]]:
-        """(field id, the question's field) for each field `read_form` listed."""
+        """(field id, the question's field) for each field `browser_read` listed."""
         entries = self._questions[question_id]["fields"]
         ids = [f"{question_id}.{e['id']}" if len(entries) > 1 else question_id for e in entries]
         return [

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/teamtailor.py

@@ -198,7 +198,7 @@ class Teamtailor:
         assert match, url
         return f"https://{parts.hostname}/jobs/{match[1]}"
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         """Opens the form's own page, never the overlay nor "Apply with LinkedIn"."""
         parts = urlsplit(page.url)
         job = JOB.search(parts.path)

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/workable.py

@@ -2,7 +2,7 @@
 docs/adapters/workable.md observes.
 
 Every field sits under an element whose `data-ui` is its id in Workable's form API, which
-`read_api` reads. Nothing but an attached file reaches Workable before submit, so the
+`request_read` reads. Nothing but an attached file reaches Workable before submit, so the
 read-back is the page.
 """
 
@@ -159,7 +159,7 @@ class Workable:
     def posting(self, url: str) -> str:
         return f"https://apply.workable.com/j/{_code(url) or url}"
 
-    def read_api(self, url: str) -> list[Field] | None:
+    def request_read(self, url: str) -> list[Field] | None:
         """The fields from the form API the page itself loads, unless it has a type it does not
         know."""
         code = _code(url)
@@ -174,7 +174,7 @@ class Workable:
         except OSError, ValueError, KeyError, TypeError:
             return None
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         if "/apply" not in urlsplit(page.url).path:
             page.goto(f"{self.posting(page.url)}/apply/")
         form = page.locator(FORM)

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/workday.py

@@ -253,7 +253,7 @@ class Workday:
             consent.check()
         _submit(page, "createAccountSubmitButton", email, password)
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         """Walks the wizard as far as its pages save with what they hold, reading each page
         it reaches: from the page, else My Experience from the apply flow's sections and the
         questions from the questionnaires, which also stand for those pages when they are not

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/wttj.py

@@ -106,7 +106,7 @@ class WelcomeToTheJungle:
         _account_form(page, "sign-up-form", values, "/registrations")
         raise Blocked("email_link: the sign-up sent a confirmation link")
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         """Opens the apply modal; a job that applies on another site has no form here."""
         if not JOB.match(urlsplit(page.url).path):
             raise RuntimeError(f"{page.url} is not a Welcome to the Jungle job")

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/adapters/zohorecruit.py

@@ -3,7 +3,7 @@ docs/adapters/zohorecruit.md observes.
 
 The job page names its application form, which "I'm interested" renders from a public form
 API: sections of fields by id, type and requirement, and the pre-screening questions a form
-may ask with them. `read_api` fetches it over HTTP, `read_form` through the page's browser
+may ask with them. `request_read` fetches it over HTTP, `browser_read` through the page's browser
 context, and both list the fields from it. Each field renders as a Lyte component whose id
 derives from the field's; nothing but the submit reaches Zoho.
 """
@@ -143,7 +143,7 @@ class ZohoRecruit:
         parts, job = urlsplit(url), _job(url)
         return POSTING.format(host=parts.hostname, job=job[2]) if job else url
 
-    def read_api(self, url: str) -> list[Field] | None:
+    def request_read(self, url: str) -> list[Field] | None:
         if _job(url) is None:
             return None
         try:
@@ -155,7 +155,7 @@ class ZohoRecruit:
         except OSError, ValueError, KeyError, TypeError, Unsupported:
             return None
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         job = _job(page.url)
         if job is None:
             raise Unsupported(f"posting_gone: {page.url} is not a job page")

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/core/adapter.py

@@ -17,7 +17,7 @@ class Unsupported(Exception):
     """What stops the form before any fill: a flow the adapter does not handle, or a fact about
     the posting (`posting_gone`, `external_step`). The message is `code: detail`.
 
-    A field atsfill cannot fill is not raised: `read_form` returns it with `unfillable` set.
+    A field atsfill cannot fill is not raised: `browser_read` returns it with `unfillable` set.
     """
 
 
@@ -68,7 +68,7 @@ class Adapter(Protocol):
         """The posting's key for the double-send guard: every URL of one posting gives the same."""
         ...
 
-    def read_form(self, page: Page) -> list[Field]:
+    def browser_read(self, page: Page) -> list[Field]:
         """Every field, one atsfill cannot fill included with its reason in `unfillable`."""
         ...
 
@@ -137,19 +137,19 @@ class CreatesAccount(SignsIn, Protocol):
 
 
 @runtime_checkable
-class ReadsOverHttp(Adapter, Protocol):
-    """An adapter that can list a form's fields over HTTP, without a browser (ADR 0011)."""
+class ReadsByRequest(Adapter, Protocol):
+    """An adapter with a request read: a form's fields listed without a browser (ADR 0011)."""
 
-    def read_api(self, url: str) -> list[Field] | None:
-        """The same fields as `read_form`; None when it cannot for this URL."""
+    def request_read(self, url: str) -> list[Field] | None:
+        """The same fields as `browser_read`; None when it cannot for this URL."""
         ...
 
 
 @runtime_checkable
 class ListsShownFields(Adapter, Protocol):
     """An adapter whose form can show fields after an answer: once filled, it says which the
-    page shows, so that one `read_form` did not list stops the fill (ADR 0005)."""
+    page shows, so that one `browser_read` did not list stops the fill (ADR 0005)."""
 
     def shown_fields(self, page: Page) -> list[str]:
-        """The ids of the fields the filled page shows, each as `read_form` would name it."""
+        """The ids of the fields the filled page shows, each as `browser_read` would name it."""
         ...

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev99}/src/atsfill/core/commands.py

@@ -22,7 +22,7 @@ from atsfill.core.adapter import (
     ListsShownFields,
     NeedsAccount,
     NotTaken,
-    ReadsOverHttp,
+    ReadsByRequest,
     Refused,
     SignsIn,
     Unsupported,
@@ -196,7 +196,7 @@ def _unfillable(result: Result, answers: dict[str, Answer] | None = None) -> boo
 
 
 def _listed(result: Result, fields: list[Field]) -> None:
-    """Sets the fields `read_form` or `read_api` listed; their conditions must name listed
+    """Sets the fields `browser_read` or `request_read` listed; their conditions must name listed
     fields, never a loop."""
     if faults := conditions.faults(fields):
         raise ValueError("; ".join(faults))
@@ -206,7 +206,7 @@ def _listed(result: Result, fields: list[Field]) -> None:
 def _shown_as_listed(
     page: Page, adapter: Adapter, result: Result, answers: dict[str, Answer]
 ) -> None:
-    """Stops a fill that showed a field `read_form` did not list, or a follow-up whose
+    """Stops a fill that showed a field `browser_read` did not list, or a follow-up whose
     condition the answers leave unmet: that condition was read wrong (ADR 0005)."""
     if not isinstance(adapter, ListsShownFields):
         return
@@ -259,7 +259,7 @@ def _fill(page: Page, adapter: Adapter, url: str, answers: dict[str, Answer], us
     """Fills and reads back; `ready` when every answer reads back as given."""
     result = _result(adapter, url, user)
     with _stops(result):
-        _listed(result, adapter.read_form(page))
+        _listed(result, adapter.browser_read(page))
         if _unfillable(result, answers):
             return result
         if problems := matching.problems(result.fields, answers):
@@ -275,7 +275,7 @@ def _fill(page: Page, adapter: Adapter, url: str, answers: dict[str, Answer], us
     return result
 
 
-def _read_page(
+def _browser_read(
     data: Path, user: str, url: str, sessions: Sessions | None, detected: list[str]
 ) -> Result:
     with _opened(data, user, url, sessions, detected) as opened:
@@ -284,7 +284,7 @@ def _read_page(
         page, adapter = opened
         result = _result(adapter, url, user)
         with _stops(result):
-            _listed(result, adapter.read_form(page))
+            _listed(result, adapter.browser_read(page))
             _unfillable(result)
         return result
 
@@ -347,11 +347,12 @@ def read(
     data_dir: Path | None = None,
     sessions: Sessions | None = None,
 ) -> Result:
-    """Lists the form's fields, over HTTP when an adapter can (ADR 0011), else from the page."""
+    """Lists the form's fields by a request read when an adapter has one (ADR 0011), else by a
+    browser read."""
     for adapter in adapters():
-        if not isinstance(adapter, ReadsOverHttp):
+        if not isinstance(adapter, ReadsByRequest):
             continue
-        if (fields := adapter.read_api(url)) is not None:
+        if (fields := adapter.request_read(url)) is not None:
             result = _result(adapter, url, user)
             try:
                 _listed(result, fields)
@@ -360,7 +361,7 @@ def read(
             _unfillable(result)
             return result
     data = paths.data_dir(data_dir)
-    return _in_budget(url, lambda seen: _read_page(data, user, url, sessions, seen))
+    return _in_budget(url, lambda seen: _browser_read(data, user, url, sessions, seen))
 
 
 def fill(