atsfill 0.0.4.dev47__tar.gz → 0.0.4.dev48__tar.gz

{atsfill-0.0.4.dev47 → atsfill-0.0.4.dev48}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atsfill
-Version: 0.0.4.dev47
+Version: 0.0.4.dev48
 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
@@ -139,9 +139,9 @@ 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]
+    Core --> SubmitGate{read-back matches,<br>submit enabled,<br>not already sent}
+    SubmitGate -->|yes| Submit[submit]
+    SubmitGate -->|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.

{atsfill-0.0.4.dev47 → atsfill-0.0.4.dev48}/README.md

@@ -114,9 +114,9 @@ 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]
+    Core --> SubmitGate{read-back matches,<br>submit enabled,<br>not already sent}
+    SubmitGate -->|yes| Submit[submit]
+    SubmitGate -->|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.

{atsfill-0.0.4.dev47 → atsfill-0.0.4.dev48}/pyproject.toml

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

@@ -1,6 +1,6 @@
 [project]
 name = "atsfill"
-version = "0.0.4.dev47"
+version = "0.0.4.dev48"
 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.dev47 → atsfill-0.0.4.dev48}/src/atsfill/adapters/ashby.py

@@ -166,7 +166,7 @@ class Ashby:
                     self._saved(page, partial(upload.set_input_files, answer))
                 case kind, _:
                     raise Unsupported(
-                        f"form_shape: cannot fill {field_id}, a {kind}, with {answer!r}"
+                        f"unsupported_rendering: cannot fill {field_id}, a {kind}, with {answer!r}"
                     )
         self._answered = list(answers)
 
@@ -232,7 +232,7 @@ class Ashby:
         f = entry["field"]
         kind = TYPES.get(f["type"])
         if kind is None:
-            raise Unsupported(f"form_shape: {f['path']} is an Ashby {f['type']} field")
+            raise Unsupported(f"unsupported_rendering: {f['path']} is an Ashby {f['type']} field")
         options = [v["label"] for v in f.get("selectableValues") or []] or None
         if f["type"] == "Boolean":
             options = ["Yes", "No"]

{atsfill-0.0.4.dev47 → atsfill-0.0.4.dev48}/src/atsfill/adapters/bamboohr.py

@@ -1,4 +1,4 @@
-"""BambooHR (`<company>.bamboohr.com/careers/<job>`), as docs/adapters/bamboohr.md observes.
+"""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
@@ -198,7 +198,7 @@ class BambooHR:
                 else form.locator(f"[name='{name}']")
             )
             if not present.count():
-                raise Unsupported(f"form_shape: {field.id} is not on the page")
+                raise Unsupported(f"unsupported_flow: {field.id} is not on the page")
         return [f for f, _ in fields]
 
     def fill(self, page: Page, answers: dict[str, Answer]) -> None:
@@ -388,7 +388,7 @@ def _form(
         if not entry:  # a demographic question the employer does not ask
             continue
         if key not in STANDARD:
-            raise Unsupported(f"form_shape: {key} is a field it does not know")
+            raise Unsupported(f"unsupported_rendering: {key} is a field it does not know")
         kind, name = STANDARD[key]
         label, required = entry["label"].strip(), entry["isRequired"]
         options = [o["text"] for o in entry.get("options") or []] or None
@@ -418,7 +418,7 @@ def _states(states: dict[str, Any], default: str | None) -> list[str]:
 def _custom(question: dict[str, Any]) -> list[tuple[Field, tuple[str, str | None, Any]]]:
     qid, kind_api = question["id"], question["type"]
     if kind_api not in CUSTOM:
-        raise Unsupported(f"form_shape: question {qid} is a {kind_api}")
+        raise Unsupported(f"unsupported_rendering: question {qid} is a {kind_api}")
     kind = CUSTOM[kind_api]
     name = f"customQuestionAnswers.{kind_api}_{qid}"
     label, required = question["question"].strip(), question["isRequired"]

{atsfill-0.0.4.dev47 → atsfill-0.0.4.dev48}/src/atsfill/adapters/breezy.py

@@ -1,4 +1,4 @@
-"""Breezy HR (`<company>.breezy.hr/p/<position>`, or a company's own domain), as
+"""Breezy HR (`<employer>.breezy.hr/p/<position>`, or an employer's own domain), as
 docs/adapters/breezy.md observes.
 
 Two page engines, an AngularJS one and a React one, render the same markup: named controls
@@ -219,7 +219,7 @@ class Breezy:
         self._kinds: dict[str, str] = {}  # how the page renders each field
 
     def detect(self, url: str, page: Page | None) -> bool:
-        """A `*.breezy.hr` position, or one on a company's domain that serves Breezy's portal."""
+        """A `*.breezy.hr` position, or one on an employer's domain that serves Breezy's portal."""
         parts = urlsplit(url)
         if not JOB.match(parts.path):
             return False
@@ -346,7 +346,7 @@ def _field(raw: dict[str, Any]) -> Field | None:
     kind = raw["kind"]
     if kind == "video":
         if raw["required"]:
-            raise Unsupported(f"form_shape: {raw['label']!r} asks for a recorded video")
+            raise Unsupported(f"unsupported_rendering: {raw['label']!r} asks for a recorded video")
         return None
     label = LABELS.get(raw["id"]) or raw.get("label", "")
     if "part" in raw:

{atsfill-0.0.4.dev47 → atsfill-0.0.4.dev48}/src/atsfill/adapters/dayforce.py

@@ -281,7 +281,7 @@ class Dayforce:
             key, kind = PERSONAL_FIELDS.get(f["fieldName"], (None, None))
             if key is None or kind is None:
                 if f["isRequired"]:
-                    raise Unsupported(f"form_shape: personal field {f['fieldName']!r}")
+                    raise Unsupported(f"unsupported_rendering: personal field {f['fieldName']!r}")
                 continue
             options = {
                 "candidateSource": sources,
@@ -321,7 +321,9 @@ class Dayforce:
                 and ref not in CANDIDATE_INFO
                 and section.get("isRequired")
             ):
-                raise Unsupported(f"form_shape: {section['displayName']!r} section is required")
+                raise Unsupported(
+                    f"unsupported_rendering: {section['displayName']!r} section is required"
+                )
         self._sections = [
             s for s in sections if s.get("questionnaire") and s.get("xRefCode") != "SUBMIT"
         ]
@@ -549,7 +551,7 @@ def _entry_fields(
         key, kind = keys.get(re.sub(r"\s", "", f["fieldName"]).upper(), (None, None))
         if key is None or kind is None:
             if f["isRequired"] and section["isRequired"]:
-                raise Unsupported(f"form_shape: {prefix} field {f['fieldName']!r}")
+                raise Unsupported(f"unsupported_rendering: {prefix} field {f['fieldName']!r}")
             continue
         required = bool(f["isRequired"] and section["isRequired"])
         options = NO_YES if kind == "boolean" else None
@@ -594,7 +596,9 @@ def _question_fields(section: dict[str, Any], question: dict[str, Any]) -> list[
         label = _plain(question["displayName"])
     if kind is None:
         if question["isRequired"]:
-            raise Unsupported(f"form_shape: {label!r} has answer type {question['answerType']}")
+            raise Unsupported(
+                f"unsupported_rendering: {label!r} has answer type {question['answerType']}"
+            )
         return []
     field_id = f"q{question['questionId']}"
     options = None

{atsfill-0.0.4.dev47 → atsfill-0.0.4.dev48}/src/atsfill/adapters/greenhouse.py

@@ -1,4 +1,4 @@
-"""Greenhouse (`job-boards.greenhouse.io`, `boards.greenhouse.io`, their EU hosts, and company
+"""Greenhouse (`job-boards.greenhouse.io`, `boards.greenhouse.io`, their EU hosts, and employer
 pages embedding them), as docs/adapters/greenhouse.md observes.
 
 Nothing but an attached file reaches Greenhouse before submit, so the read-back is the page:
@@ -128,11 +128,11 @@ class Greenhouse:
     def __init__(self) -> None:
         self._fields: dict[str, Field] = {}
         self._kinds: dict[str, str] = {}  # how the page renders each field
-        self._embed: str | None = None  # the job_app URL a company page embeds
+        self._embed: str | None = None  # the job_app URL an employer page embeds
 
     def detect(self, url: str, page: Page | None) -> bool:
-        """A board URL, or a company page whose `#grnhse_iframe` embeds a job application."""
-        self._embed = None  # one process detects many postings: a survey, the gate
+        """A board URL, or an employer page whose `#grnhse_iframe` embeds a job application."""
+        self._embed = None  # one process detects many postings: a survey, the adapter gate
         if _board_job(url):
             return True
         if page is None:
@@ -242,7 +242,7 @@ class Greenhouse:
                 else:
                     field_type = FieldType.MULTI_CHOICE if kind == "multi" else FieldType.CHOICE
             case _:  # a radio input, not seen on a posting yet
-                raise Unsupported(f"form_shape: {raw['id']} is a {kind}")
+                raise Unsupported(f"unsupported_rendering: {raw['id']} is a {kind}")
         return Field(
             raw["id"],
             raw["label"],

{atsfill-0.0.4.dev47 → atsfill-0.0.4.dev48}/src/atsfill/adapters/hireology.py

@@ -223,7 +223,7 @@ class Hireology:
         form_el = page.locator(FORM)
         for field, _ in form:
             if field.id not in SHOWN_BY and form_el.evaluate(_CONTROL, field.id) is None:
-                raise Unsupported(f"form_shape: {field.id} is not on the page")
+                raise Unsupported(f"unsupported_flow: {field.id} is not on the page")
         return [f for f, _ in form]
 
     def fill(self, page: Page, answers: dict[str, Answer]) -> None:
@@ -304,7 +304,7 @@ def _field(entry: dict[str, Any], section: str) -> Field:
     field_id, attributes = entry["id"], entry["attributes"]
     kind = attributes["type"]
     if kind not in TYPES:
-        raise Unsupported(f"form_shape: {field_id} is a {kind}")
+        raise Unsupported(f"unsupported_rendering: {field_id} is a {kind}")
     label = (
         section
         + (

{atsfill-0.0.4.dev47 → atsfill-0.0.4.dev48}/src/atsfill/adapters/jazzhr.py

@@ -238,7 +238,7 @@ def _field(raw: dict[str, Any]) -> Field:
         case "consent":
             field_type, options = FieldType.CHOICE, YES_NO
         case _:
-            raise Unsupported(f"form_shape: {raw['id']} is a {kind}")
+            raise Unsupported(f"unsupported_rendering: {raw['id']} is a {kind}")
     accept = RESUME_TYPES if kind == "file" else None
     return Field(
         raw["id"], raw["label"], field_type, raw["required"], options, raw.get("maxLength"), accept

{atsfill-0.0.4.dev47 → atsfill-0.0.4.dev48}/src/atsfill/adapters/lever.py

@@ -205,7 +205,7 @@ def _job(url: str) -> tuple[str, str] | None:
 def _field(raw: dict[str, Any]) -> Field:
     kind = raw["kind"]
     if kind not in KINDS:
-        raise Unsupported(f"form_shape: {raw['id']} is a {kind}")
+        raise Unsupported(f"unsupported_rendering: {raw['id']} is a {kind}")
     options = {"consent": YES_NO, "select": raw["options"]}.get(kind)
     if kind in ("radio", "checkboxes"):
         options = raw["options"]

{atsfill-0.0.4.dev47 → atsfill-0.0.4.dev48}/src/atsfill/adapters/manatal.py

@@ -112,7 +112,7 @@ def _field(entry: dict[str, Any], options: list[str] | None) -> Field | None:
     fid, label, required = str(entry["id"]), entry["label"], bool(entry["is_required"])
     match kind:
         case "entries" if required:
-            raise Unsupported(f"form_shape: {entry['field_type']} entries are required")
+            raise Unsupported(f"unsupported_rendering: {entry['field_type']} entries are required")
         case "entries":
             return None
         case "file":
@@ -245,7 +245,7 @@ class Manatal:
                     named.evaluate(_CHECK, answer == "Yes")
                 case kind, _:
                     raise Unsupported(
-                        f"form_shape: cannot fill {field_id}, a {kind}, with {answer!r}"
+                        f"unsupported_rendering: cannot fill {field_id}, a {kind}, with {answer!r}"
                     )
 
     def read_back(self, page: Page) -> dict[str, Answer]:

{atsfill-0.0.4.dev47 → atsfill-0.0.4.dev48}/src/atsfill/adapters/oracle.py

@@ -16,7 +16,7 @@ from typing import Any
 from urllib.parse import urlsplit
 
 from atsfill.core import browser, matching
-from atsfill.core.adapter import Blocked, Unsupported
+from atsfill.core.adapter import Blocked, NotTaken, Unsupported
 from atsfill.core.browser import Locator, Page
 from atsfill.core.results import Answer, Field, FieldType, SideEffect
 
@@ -358,7 +358,7 @@ class Oracle:
         except browser.Timeout:
             if page.locator(CAPTCHA).count():
                 raise Blocked("captcha: the email step asks for an hCaptcha") from None
-            raise Unsupported("form_shape: the email step did not open the form") from None
+            raise Unsupported("unsupported_flow: the email step did not open the form") from None
         if page.locator(CODE_PAGE).count():
             raise Blocked(
                 f"emailed_code: {email} is known to this employer's Oracle, which emails it a"
@@ -371,7 +371,7 @@ class Oracle:
         """The field a raw description is, None for one atsfill leaves out."""
         if raw["kind"] == "tiles":
             if raw["required"]:
-                raise Unsupported(f"form_shape: {raw['label']!r} needs entries added")
+                raise Unsupported(f"unsupported_rendering: {raw['label']!r} needs entries added")
             return None
         if raw["kind"] == "email":
             self._kinds[EMAIL] = "email"
@@ -388,7 +388,7 @@ class Oracle:
         """The innermost row holding the field."""
         selector = page.evaluate(_ROW, field_id)
         if selector is None:
-            raise Unsupported(f"form_shape: {field_id} left the form while it was filled")
+            raise Unsupported(f"unsupported_flow: {field_id} left the form while it was filled")
         return page.locator(".input-row").filter(has=page.locator(selector)).last
 
     def _options(self, page: Page, field_id: str) -> list[str]:
@@ -454,7 +454,9 @@ class Oracle:
                 _choose(page, boxes.nth(1), str(int(day)), exact=True)
                 _choose(page, boxes.nth(2), year, exact=True)
             case _:
-                raise Unsupported(f"form_shape: cannot fill {field_id}, a {kind}, with {answer!r}")
+                raise Unsupported(
+                    f"unsupported_rendering: cannot fill {field_id}, a {kind}, with {answer!r}"
+                )
 
     def _phone(self, page: Page, row: Locator, answer: str) -> None:
         """Picks the country code the number starts with, the longest that fits, then types
@@ -468,7 +470,7 @@ class Oracle:
         )
         prefix = next((c for c in codes if digits.startswith(c)), None)
         if prefix is None:
-            raise Unsupported(f"form_shape: no country code for {answer!r}")
+            raise NotTaken(f"no country code for {answer!r}")
         _choose(page, code, f"+{prefix}", code=True)
         number = row.locator("input[type=tel]")
         number.fill(digits[len(prefix) :])
@@ -541,7 +543,7 @@ def _go_to(page: Page, number: int) -> None:
             )
             _settle(page)
             return
-    raise Unsupported(f"form_shape: page {number} of the form did not open")
+    raise Unsupported(f"unsupported_flow: page {number} of the form did not open")
 
 
 def _upload(field_id: str) -> str:
@@ -611,7 +613,7 @@ def _choose(
         box.press("Escape")
         if field is not None:
             break  # a search lists nothing untyped
-    raise Unsupported(f"form_shape: no item for {answer!r} in a dropdown")
+    raise NotTaken(f"no item for {answer!r} in a dropdown")
 
 
 def _field(raw: dict[str, Any]) -> Field:

{atsfill-0.0.4.dev47 → atsfill-0.0.4.dev48}/src/atsfill/adapters/paycor.py

@@ -11,7 +11,7 @@ import re
 from typing import Any
 from urllib.parse import parse_qs, urlencode, urlsplit
 
-from atsfill.core.adapter import Blocked, Unsupported
+from atsfill.core.adapter import Blocked, NotTaken, Unsupported
 from atsfill.core.browser import Page
 from atsfill.core.results import Answer, Field, FieldType, SideEffect
 
@@ -142,7 +142,7 @@ class Paycor:
 
     def detect(self, url: str, page: Page | None) -> bool:
         """A `recruitingbypaycor.com/career` job URL, or an employer page that embeds one."""
-        self._start = None  # one process detects many postings: a survey, the gate
+        self._start = None  # one process detects many postings: a survey, the adapter gate
         parts = urlsplit(url)
         if parts.hostname == HOST and (ids := _ids(url)):
             self._start = self._apply(*ids)
@@ -207,7 +207,7 @@ class Paycor:
                     named.fill(answer)
                     named.dispatch_event("change")
                 case "select", str() if named.is_disabled():
-                    raise Unsupported(f"form_shape: {field.id} has no options for that country")
+                    raise NotTaken(f"{field.id} has no options for that country")
                 case "select", str():
                     named.select_option(label=answer)
                 case "radio", str():
@@ -221,7 +221,7 @@ class Paycor:
                     self._pick(named, field, answer)
                 case _:
                     raise Unsupported(
-                        f"form_shape: cannot fill {field.id}, a {kind}, with {answer!r}"
+                        f"unsupported_rendering: cannot fill {field.id}, a {kind}, with {answer!r}"
                     )
 
     def read_back(self, page: Page) -> dict[str, Answer]:
@@ -265,7 +265,7 @@ class Paycor:
         """Opens the apply page and answers the pages before the form: the persona's picks
         when filling, the last option and Yes when only reading, which list the fields."""
         if self._start is None:
-            raise Unsupported("form_shape: no Paycor job in the page")
+            raise Unsupported("unsupported_flow: no Paycor job in the page")
         page.goto(self._start, wait_until="domcontentloaded")
         for _ in range(STEPS):
             page.wait_for_load_state("domcontentloaded")
@@ -286,11 +286,11 @@ class Paycor:
             elif "no longer active" in (page.text_content("body") or ""):
                 raise Unsupported("posting_gone: this job is no longer active")
             else:
-                raise Unsupported(f"form_shape: an unknown page before the form ({page.url})")
+                raise Unsupported(f"unsupported_flow: an unknown page before the form ({page.url})")
             # The form's third-party scripts (Dropbox, Google) can hold its `load` back.
             with page.expect_navigation(wait_until="domcontentloaded", timeout=PAGE_TIMEOUT_MS):
                 button.click(no_wait_after=True)
-        raise Unsupported("form_shape: no form after the pages before it")
+        raise Unsupported("unsupported_flow: no form after the pages before it")
 
     def _eeo(self, page: Page, answers: dict[str, Answer] | None) -> None:
         for name in page.locator(f"{EEO_FORM} input[type=radio]").evaluate_all(

{atsfill-0.0.4.dev47 → atsfill-0.0.4.dev48}/src/atsfill/adapters/paylocity.py

@@ -405,7 +405,7 @@ def _form(data: dict[str, Any]) -> list[tuple[Field, Control]]:
             count = custom.get("referencesRequiredCount") or 1
         vocabulary = SECTIONS.get(name)
         if vocabulary is None:
-            raise Unsupported(f"form_shape: unknown section {name!r}")
+            raise Unsupported(f"unsupported_rendering: unknown section {name!r}")
         included = {f["name"] for f in section["fields"] if f["isIncluded"]}
         for n in range(count):
             prefix = f"Reference {n + 1}: " if name == "references" else ""
@@ -418,8 +418,8 @@ def _form(data: dict[str, Any]) -> list[tuple[Field, Control]]:
                 if specs is None:
                     if entries and field["isRequired"] and field["name"] not in OPTIONAL_ONLY:
                         raise Unsupported(
-                            f"form_shape: {_plain(field['displayName'])!r} ({field['name']}) "
-                            "is not handled"
+                            "unsupported_rendering: "
+                            f"{_plain(field['displayName'])!r} ({field['name']}) is not handled"
                         )
                     continue
                 if SHOWN_WITH.get(field["name"], field["name"]) not in included:
@@ -437,7 +437,7 @@ def _form(data: dict[str, Any]) -> list[tuple[Field, Control]]:
         elif kind == "text":
             kind, answers, dom = "screener_text", None, f"screener-question-{i}-textarea"
         else:
-            raise Unsupported(f"form_shape: a {kind} screener question")
+            raise Unsupported(f"unsupported_rendering: a {kind} screener question")
         field_id = f"screener.{question['screenerQuestionId']}"
         out.append((Field(field_id, _plain(question["title"]), TYPES[kind],
                           bool(question.get("isRequired")), answers),

{atsfill-0.0.4.dev47 → atsfill-0.0.4.dev48}/src/atsfill/adapters/phenom.py

@@ -22,7 +22,7 @@ from typing import Any
 from urllib.parse import parse_qs, urlsplit
 
 from atsfill.core import browser, matching
-from atsfill.core.adapter import Unsupported
+from atsfill.core.adapter import NotTaken, Unsupported
 from atsfill.core.browser import HTTP_TIMEOUT_S, BrowserError, Covered, Locator, Page, Timeout
 from atsfill.core.results import Answer, Field, FieldType, SideEffect
 
@@ -311,7 +311,7 @@ class Phenom:
         try:
             ph = _phapp_of(page.content())  # the page's scripts' own world is out of reach
         except ValueError as e:
-            raise Unsupported(f"form_shape: {e}") from None
+            raise Unsupported(f"unsupported_flow: {e}") from None
         token = get(ph, "sessionParams.csrfToken") or ""
         try:
             fields, raws = _read(
@@ -320,7 +320,7 @@ class Phenom:
                 lambda body: page.evaluate(_FETCH, ["/applySubmit", body, token]),
             )
         except (BrowserError, ValueError, KeyError) as e:
-            raise Unsupported(f"form_shape: no configuration for the wizard ({e})") from None
+            raise Unsupported(f"unsupported_flow: no configuration for the wizard ({e})") from None
         self._raws = {raw["id"]: raw for raw in raws}
         return fields
 
@@ -348,7 +348,7 @@ class Phenom:
             if not _has_next(page):
                 return
             _next(page, number)
-        raise Unsupported(f"form_shape: the wizard has more than {MAX_STEPS} steps")
+        raise Unsupported(f"unsupported_flow: the wizard has more than {MAX_STEPS} steps")
 
     def read_back(self, page: Page) -> dict[str, Answer]:
         return self._kept
@@ -381,7 +381,7 @@ class Phenom:
         except Timeout:
             step = parse_qs(urlsplit(page.url).query).get("stepname", ["none"])[0]
             raise Unsupported(
-                f"form_shape: no application step on the page (step {step})"
+                f"unsupported_flow: no application step on the page (step {step})"
             ) from None
 
     def _step(self, page: Page, answers: dict[str, Answer]) -> list[dict[str, Any]]:
@@ -442,7 +442,7 @@ def _read(
     reader = _Config(ph, config, texts, post)
     raws = [raw for step in reader.steps() for raw in step]
     if not raws:
-        raise Unsupported("form_shape: the wizard shows no fields")
+        raise Unsupported("unsupported_flow: the wizard shows no fields")
     resume = reader.resume()
     return ([resume] if resume else []) + [_field(raw) for raw in raws], raws
 
@@ -816,7 +816,7 @@ class _Config:
             }
         response = get(self.call(payload, **extra), "applyGetReferences")
         if not isinstance(response, dict):
-            raise Unsupported("form_shape: the job's questionnaire did not load")
+            raise Unsupported("unsupported_flow: the job's questionnaire did not load")
         part = response.get("data") if isinstance(get(response, "data.schema"), dict) else response
         if not isinstance(get(part, "schema"), dict):
             return []
@@ -1063,9 +1063,9 @@ def _apply_url(page: Page) -> str:
         time.sleep(SETTLE_S)
     target = urlsplit(href or "")
     if target.hostname and target.hostname != parts.hostname:
-        raise Unsupported(f"other_system: the application is on {target.hostname}")
+        raise Unsupported(f"external_step: the application is on {target.hostname}")
     if href and not APPLY.match(target.path):
-        raise Unsupported(f"form_shape: the Apply link leads to {target.path}")
+        raise Unsupported(f"unsupported_flow: the Apply link leads to {target.path}")
     if href:
         return f"{parts.scheme}://{parts.netloc}{target.path}?jobSeqNo={seq}"
     return f"{parts.scheme}://{parts.netloc}{prefix[1]}/apply?jobSeqNo={_seq(page.url)}"
@@ -1107,8 +1107,8 @@ def _next(page: Page, number: int) -> None:
                 return
         if errors := page.locator(FORM).evaluate(_ERRORS) if page.locator(FORM).count() else []:
             shown = "; ".join(f"{dom}: {message}" for dom, message in errors)
-            raise Unsupported(f"form_shape: step {number} did not pass: {shown}")
-    raise Unsupported(f"form_shape: step {number} did not pass in time")
+            raise Unsupported(f"unsupported_flow: step {number} did not pass: {shown}")
+    raise Unsupported(f"unsupported_flow: step {number} did not pass in time")
 
 
 def _click(page: Page, target: Locator) -> None:
@@ -1159,11 +1159,11 @@ def _pick_day(page: Page, dom: str, iso: str) -> None:
         by_year = [s for s in lists if any(o.isdigit() for o in s.evaluate(OPTIONS))]
         by_month = [s for s in lists if s not in by_year]
         if not by_year or not by_month or not by_year[0].evaluate(_SELECT, str(year)):
-            raise Unsupported(f"form_shape: {dom} does not list the year {year}")
+            raise NotTaken(f"{dom} does not list the year {year}")
         names = by_month[0].evaluate(OPTIONS)
         by_month[0].evaluate(_SELECT, names[month - 1 + len(names) - 12])
     elif not picker.locator(".react-datepicker__current-month").count():
-        raise Unsupported(f"form_shape: {dom} has a calendar without its month")
+        raise Unsupported(f"unsupported_rendering: {dom} has a calendar without its month")
     else:
         for _ in range(MAX_MONTH_STEPS):
             shown = picker.locator(".react-datepicker__current-month").inner_text().split()
@@ -1173,12 +1173,12 @@ def _pick_day(page: Page, dom: str, iso: str) -> None:
             step = "next" if at < (year, month) else "previous"
             _click(page, picker.locator(f".react-datepicker__navigation--{step}"))
         else:
-            raise Unsupported(f"form_shape: {dom} does not reach {iso}")
+            raise NotTaken(f"{dom} does not reach {iso}")
     cell = picker.locator(
         f".react-datepicker__day--{day:03d}:not(.react-datepicker__day--outside-month)"
     ).first
     if "--disabled" in (cell.get_attribute("class") or ""):
-        raise Unsupported(f"form_shape: {dom} does not take {iso}")
+        raise NotTaken(f"{dom} does not take {iso}")
     _click(page, cell)
 
 
@@ -1190,7 +1190,7 @@ def _page_to(page: Page, picker: Locator, header: str, year: int, dom: str) -> N
             return
         step = "next" if year > shown else "previous"
         _click(page, picker.locator(f".react-datepicker__navigation--{step}"))
-    raise Unsupported(f"form_shape: {dom} does not reach the year {year}")
+    raise NotTaken(f"{dom} does not reach the year {year}")
 
 
 def _date_tokens(form: str) -> list[str]:
@@ -1236,7 +1236,7 @@ def _upload(page: Page, path: str) -> None:
         deadline = time.monotonic() + UPLOAD_TIMEOUT_MS / 1000
         while not uploaded and not page.evaluate(_SHOWS, name):
             if time.monotonic() > deadline:
-                raise Unsupported("form_shape: the resume upload did not show the file")
+                raise Unsupported("unsupported_rendering: the resume upload did not show the file")
             time.sleep(UPLOAD_POLL_S)
         deadline, quiet_since = time.monotonic() + UPLOAD_TIMEOUT_MS / 1000, time.monotonic()
         while time.monotonic() < deadline and time.monotonic() - quiet_since < QUIET_S:
@@ -1270,7 +1270,7 @@ def _fill(page: Page, raw: dict[str, Any], answer: Answer) -> None:
                     break
                 parent = raw.get("parent")
                 if attempt or not parent or not (held := form.locator(f"[id='{parent}']")).count():
-                    raise Unsupported(f"form_shape: {raw['id']} has no option {_one(answer)!r}")
+                    raise NotTaken(f"{raw['id']} has no option {_one(answer)!r}")
                 held.evaluate(_SELECT, held.evaluate("el => el.selectedOptions[0]?.text.trim()"))
         case "typeahead":  # a list, or suggestions for what is typed
             _click(page, control)
@@ -1297,7 +1297,7 @@ def _fill(page: Page, raw: dict[str, Any], answer: Answer) -> None:
         case "radio":  # its label wraps it or names it by `for`
             page.evaluate(_COOKIES)
             if not form.evaluate(_RADIO, [raw["id"], _one(answer)]):
-                raise Unsupported(f"form_shape: {raw['id']} has no option {_one(answer)!r}")
+                raise NotTaken(f"{raw['id']} has no option {_one(answer)!r}")
         case "checkbox":
             if control.is_checked() != (_one(answer) == "Yes"):
                 control.evaluate("el => el.click()")  # the box is drawn over; React sees a click
@@ -1321,7 +1321,7 @@ def _fill(page: Page, raw: dict[str, Any], answer: Answer) -> None:
             picker = page.locator(PICKER).last
             if picker.locator("select.range-select").count():
                 if not picker.locator("select.range-select").evaluate(_SELECT, str(int(year))):
-                    raise Unsupported(f"form_shape: {dom} does not list the year {year}")
+                    raise NotTaken(f"{dom} does not list the year {year}")
             else:
                 _page_to(page, picker, ".react-datepicker-year-header", int(year), dom)
             _click(page, picker.locator(".react-datepicker__month-text").nth(int(month) - 1))
@@ -1340,7 +1340,7 @@ def _fill(page: Page, raw: dict[str, Any], answer: Answer) -> None:
                 step = "next" if year > first else "previous"
                 _click(page, picker.locator(f".react-datepicker__navigation--{step}"))
             else:
-                raise Unsupported(f"form_shape: {dom} does not list the year {year}")
+                raise NotTaken(f"{dom} does not list the year {year}")
         case "phone":  # a national number goes without the code the form asks on its own
             digits = re.sub(r"\D", "", _one(answer))
             dial = form.evaluate(_DIAL) if raw.get("national") else None

{atsfill-0.0.4.dev47 → atsfill-0.0.4.dev48}/src/atsfill/adapters/recruitee.py

@@ -141,7 +141,9 @@ class Recruitee:
         for raw in form.evaluate(_READ):
             if raw["kind"] == "video":  # recorded in the page, or uploaded to a video service
                 if raw["required"]:
-                    raise Unsupported(f"form_shape: {raw['label']!r} is a video question")
+                    raise Unsupported(
+                        f"unsupported_rendering: {raw['label']!r} is a video question"
+                    )
                 continue
             fields.append(_field(raw))
             self._kinds[raw["id"]] = raw["kind"]

{atsfill-0.0.4.dev47 → atsfill-0.0.4.dev48}/src/atsfill/adapters/smartrecruiters.py

@@ -136,7 +136,9 @@ class SmartRecruiters:
         _decline_cookies(page)
         for section in ENTRIES:
             if page.locator(f"{section} [data-test=section-required-mark]").count():
-                raise Unsupported(f"form_shape: {section.removeprefix('oc-')} entries are required")
+                raise Unsupported(
+                    f"unsupported_rendering: {section.removeprefix('oc-')} entries are required"
+                )
         context = page.evaluate(_CONTEXT) or {}
         screening = context.get("screeningConfiguration") or {}
         self._questions = {q["id"]: q for q in screening.get("questions") or []}
@@ -208,7 +210,7 @@ class SmartRecruiters:
             if kind == "currency":
                 field_type = FieldType.TEXT
             if field_type is None or kind in OPTIONAL_ONLY:
-                raise Unsupported(f"form_shape: {label!r} is a {kind} question")
+                raise Unsupported(f"unsupported_rendering: {label!r} is a {kind} question")
             options = [v["label"] for v in entry["values"]] or None
             if kind == "checkbox":
                 options = YES_NO
@@ -254,7 +256,7 @@ class SmartRecruiters:
 
 
 def _key(url: str) -> str | None:
-    """`https://jobs.smartrecruiters.com/<company>/<job id>`, or the One Click form's URL."""
+    """`https://jobs.smartrecruiters.com/<employer>/<job id>`, or the One Click form's URL."""
     parts = urlsplit(url)
     if parts.hostname not in HOSTS:
         return None