atsfill 0.0.4.dev98__tar.gz → 0.0.4.dev100__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atsfill
-Version: 0.0.4.dev98
+Version: 0.0.4.dev100
 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.dev100}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "atsfill"
-version = "0.0.4.dev98"
+version = "0.0.4.dev100"
 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.dev100}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "atsfill"
-version = "0.0.4.dev98"
+version = "0.0.4.dev100"
 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.dev100}/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.dev100}/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.
 """
 
@@ -17,7 +17,7 @@ from urllib.parse import urlsplit
 from atsfill.core import browser
 from atsfill.core.adapter import Blocked, Gap, Unsupported
 from atsfill.core.browser import HTTP_TIMEOUT_S, Locator, Page, Timeout
-from atsfill.core.results import Answer, Field, FieldType, Is, SideEffect
+from atsfill.core.results import Answer, Field, FieldType, Is, OptionSet, SideEffect
 
 HOST = re.compile(r"^[\w-]+\.bamboohr\.com$")
 JOB = re.compile(r"^/careers/(\d+)(?:/|$)")
@@ -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:
@@ -411,25 +411,41 @@ def _form(
         if key == "countryId" and country:
             by_id = {str(o["id"]): o["text"] for o in entry.get("options") or []}
             shown = by_id.get(str(country), country if country in by_id.values() else None)
+        option_sets = None
         if key == "state" and options:
-            options = _states(states, country)
-        if key == "state" and not options:
+            countries = result["formFields"].get("countryId") or {}
+            options, option_sets = None, _states(states, countries.get("options") or [])
+        if key == "state" and not option_sets:
             kind = "text"
         if kind == "veteran":
             extra = {o["id"]: o["text"] for o in entry["options"] if int(o["id"]) > 0}
             options = list(VETERAN) + list(extra.values())
         accept = FILE_TYPES if kind == "file" else None
-        field = Field(key, label, TYPES[kind], required, options, None, accept, default=shown)
+        field = Field(
+            key,
+            label,
+            TYPES[kind],
+            required,
+            options,
+            None,
+            accept,
+            default=shown,
+            option_sets=option_sets,
+        )
         out.append((field, (kind, name, extra)))
     return out
 
 
-def _states(states: dict[str, Any], default: str | None) -> list[str]:
-    """The state lists of every country that has one, the default country's (an id) first:
-    the list the page shows follows the country answered."""
-    order = sorted(STATE_LISTS, key=lambda c: c != default)
-    names = [s["full_name"] for c in order for s in (states.get(c) or {}).get("data") or []]
-    return list(dict.fromkeys(names))
+def _states(states: dict[str, Any], countries: list[dict[str, Any]]) -> list[OptionSet]:
+    """The state list of each country that has one, under that country as the form lists it;
+    any other country's state is typed."""
+    by_id = {str(o["id"]): o["text"] for o in countries}
+    return [
+        OptionSet(Is("countryId", [by_id[c]]), names)
+        for c in STATE_LISTS
+        if c in by_id
+        and (names := [s["full_name"] for s in (states.get(c) or {}).get("data") or []])
+    ]
 
 
 def _custom(question: dict[str, Any]) -> list[tuple[Field, tuple[str, str | None, Any]]]:

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev100}/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.dev100}/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.dev100}/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.dev100}/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.dev100}/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.dev100}/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.dev100}/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.dev100}/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.dev100}/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.dev100}/src/atsfill/adapters/oracle.py

@@ -18,7 +18,7 @@ from urllib.parse import urlsplit
 from atsfill.core import browser, matching
 from atsfill.core.adapter import Blocked, Gap, NotTaken, Unsupported, known_gap
 from atsfill.core.browser import Locator, Page
-from atsfill.core.results import Answer, Field, FieldType, SideEffect
+from atsfill.core.results import Answer, Field, FieldType, Is, OptionSet, SideEffect
 
 JOB = re.compile(r"/hcmUI/CandidateExperience/[\w-]+/sites/[^/]+/job/(\d+)")
 EMAIL = "email"
@@ -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
@@ -517,15 +517,24 @@ def _click(page: Page, target: Locator) -> None:
 def _geography(described: list[tuple[dict, Field]]) -> list[tuple[dict, Field]]:
     """Leaves one field of the address's geography (state, city, postal code), the most
     specific: its items name the levels above (`0200, Acton, ACT`), and picking one fills
-    them. It is required when any level is."""
+    them. It is required when any level is, and a dependent list of the country."""
     levels = [(r, f) for r, f in described if r.get("geo") and f.id != COUNTRY]
     if len(levels) < 2 or not any(f.options for _, f in levels):
         return described
     parts = lambda f: max(len(o.split(",")) for o in f.options or [""])  # noqa: E731
     kept = max(levels, key=lambda rf: parts(rf[1]))
     required = any(f.required for _, f in levels)
+    asked = replace(kept[1], required=required)
+    country = next((f.default for _, f in described if f.id == COUNTRY), None)
+    if isinstance(country, str):
+        # its items are the country's the page shows; another's cost a request
+        asked = replace(
+            asked,
+            options=None,
+            option_sets=[OptionSet(Is(COUNTRY, [country]), asked.options or [])],
+        )
     return [
-        (r, replace(f, required=required) if (r, f) == kept else f)
+        (r, asked if (r, f) == kept else f)
         for r, f in described
         if (r, f) == kept or (r, f) not in levels
     ]

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

@@ -3,17 +3,19 @@
 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.
 """
 
+import json
 import re
+from dataclasses import replace
 from typing import Any
 from urllib.parse import parse_qs, urlencode, urlsplit
 
 from atsfill.core.adapter import Blocked, Gap, NotTaken, Unsupported
 from atsfill.core.browser import Page
-from atsfill.core.results import Answer, Field, FieldType, SideEffect
+from atsfill.core.results import Answer, Field, FieldType, Is, OptionSet, SideEffect
 
 HOST = "recruitingbypaycor.com"
 CAREER = f"https://{HOST}/career/"
@@ -120,6 +122,20 @@ _HIDDEN = """name => {
 }"""
 
 
+# Each country select with its state select, and the page scripts' text, which holds every
+# country's state list (`var ca_country_states = [...]`).
+_COUNTRIES = """() => ({
+  countries: [...document.querySelectorAll('#gnewtonForm select[data-state-id]')].map(c => ({
+    name: c.name,
+    state: document.getElementById(c.dataset.stateId)?.name,
+    options: [...c.options].filter(o => o.value)
+      .map(o => [o.value, o.textContent.replace(/\\s+/g, ' ').trim()]),
+  })),
+  scripts: [...document.scripts].map(s => s.textContent).join('\\n'),
+})"""
+STATE_LIST = re.compile(r"var (\w+)_country_states\s*=\s*(\[[^\]]*\])")
+
+
 def _ids(url: str) -> tuple[str, str] | None:
     """The client and job ids of a Paycor career URL, or of an employer page opening it."""
     query = parse_qs(urlsplit(url).query)
@@ -138,6 +154,36 @@ def _field(control: dict[str, Any]) -> Field:
     return Field(fid, label, KINDS[kind], control["required"], control["options"], control["max"])
 
 
+def _dependent(controls: list[tuple[Field, str]], page: dict[str, Any]) -> list[tuple[Field, str]]:
+    """A state select under its country: the page's list for each country that has one, none
+    for any other, where the page disables the state and drops its `required`. Unanswered, the
+    country leaves the list the page starts with."""
+    lists = {
+        code: [s if isinstance(s, str) else s.get("value", "") for s in json.loads(names)]
+        for code, names in STATE_LIST.findall(page["scripts"])
+    }
+    under = {c["state"]: c for c in page["countries"] if c["state"]}
+    out = []
+    for field, kind in controls:
+        if (country := under.get(field.id)) and kind == "select":
+            sets = [OptionSet(Is(country["name"], negated=True), field.options or [])]
+            sets += [
+                OptionSet(Is(country["name"], [text]), lists[code.lower()])
+                for code, text in country["options"]
+                if code.lower() in lists
+            ]
+            having = [text for code, text in country["options"] if code.lower() in lists]
+            field = replace(
+                field,
+                required=False,
+                required_when=Is(country["name"], having) if field.required else None,
+                options=[],
+                option_sets=sets,
+            )
+        out.append((field, kind))
+    return out
+
+
 class Paycor:
     name = "paycor"
     known_gaps: dict[str, Gap] = {}
@@ -171,10 +217,11 @@ 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)]
+        controls = _dependent(controls, page.evaluate(_COUNTRIES))
         self._controls = [(f, kind) for f, kind in controls if not f.unfillable]
         return [f for f, _ in self._before] + [f for f, _ in controls]
 

{atsfill-0.0.4.dev98 → atsfill-0.0.4.dev100}/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.dev100}/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: