atsfill 0.0.4.dev94__tar.gz → 0.0.4.dev96__tar.gz

{atsfill-0.0.4.dev94 → atsfill-0.0.4.dev96}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atsfill
-Version: 0.0.4.dev94
+Version: 0.0.4.dev96
 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
@@ -16,6 +16,7 @@ Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Office/Business
 Classifier: Typing :: Typed
 Requires-Dist: camoufox==0.5.8
+Requires-Dist: filelock==4.1.1
 Requires-Dist: keyring==25.7.0
 Requires-Dist: packaging==26.3
 Requires-Python: >=3.14

{atsfill-0.0.4.dev94 → atsfill-0.0.4.dev96}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "atsfill"
-version = "0.0.4.dev94"
+version = "0.0.4.dev96"
 description = "Read, dry-run and submit job application forms on hiring systems: Ashby, Greenhouse, Teamtailor, Welcome to the Jungle."
 readme = "README.md"
 license = "MIT"
@@ -28,6 +28,7 @@ classifiers = [
 ]
 dependencies = [
     "camoufox==0.5.8",
+    "filelock==4.1.1",
     "keyring==25.7.0",
     "packaging==26.3",
 ]

{atsfill-0.0.4.dev94 → atsfill-0.0.4.dev96}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "atsfill"
-version = "0.0.4.dev94"
+version = "0.0.4.dev96"
 description = "Read, dry-run and submit job application forms on hiring systems: Ashby, Greenhouse, Teamtailor, Welcome to the Jungle."
 readme = "README.md"
 license = "MIT"
@@ -21,6 +21,7 @@ classifiers = [
 ]
 dependencies = [
     "camoufox==0.5.8",
+    "filelock==4.1.1",
     "keyring==25.7.0",
     "packaging==26.3",
 ]

{atsfill-0.0.4.dev94 → atsfill-0.0.4.dev96}/src/atsfill/adapters/greenhouse.py

@@ -61,6 +61,7 @@ _READ = """form => {
   const found = [];
   for (const el of form.querySelectorAll("input, textarea")) {
     if (!el.id || ["hidden", "search", "file", "checkbox"].includes(el.type)) continue;
+    if (el.closest(".file-upload")) continue;  // a file's paste-in textarea, listed with the file
     const combo = el.getAttribute("role") === "combobox";
     if (combo && el.closest(".phone-input")) continue;  // the phone's country, set by its number
     const shell = el.closest(".select");
@@ -84,10 +85,14 @@ _READ = """form => {
   }
   for (const group of form.querySelectorAll(".file-upload")) {
     const input = group.querySelector("input[type=file]");
-    found.push([group, {id: group.getAttribute("aria-labelledby").replace(/^upload-label-/, ""),
-      kind: "file", label: text(group.querySelector(".upload-label")),
-      required: group.getAttribute("aria-required") === "true",
+    const id = group.getAttribute("aria-labelledby").replace(/^upload-label-/, "");
+    const label = text(group.querySelector(".upload-label"));
+    const required = group.getAttribute("aria-required") === "true";
+    const manual = group.querySelector(`button[data-testid="${id}-text"]`);
+    found.push([group, {id, kind: "file", label, required, oneOf: manual ? id : null,
       accept: input?.accept ? input.accept.split(",") : null}]);
+    const pasted = {id: `${id}_text`, kind: "pasted", label, required, oneOf: id};
+    if (manual) found.push([manual, pasted]);
   }
   const before = (a, b) => a.compareDocumentPosition(b) & Node.DOCUMENT_POSITION_FOLLOWING;
   found.sort(([a], [b]) => before(a, b) ? -1 : 1);
@@ -196,6 +201,15 @@ class Greenhouse:
                     upload.locator("input[type=file]").set_input_files(values[0])
                     with suppress(Timeout):
                         upload.locator(".file-upload__filename").wait_for(timeout=ANSWER_TIMEOUT_MS)
+                case "pasted":  # "Enter manually" adds the textarea beside the file input
+                    text = page.locator(_by_id(field_id))
+                    if not text.count():
+                        browser.click(
+                            page.locator(
+                                f"button[data-testid='{field_id.removesuffix('_text')}-text']"
+                            )
+                        )
+                    text.fill(values[0])
                 case "consent":
                     box = page.locator(f"{FORM} input[type=checkbox][name='{field_id}']").first
                     if box.is_checked() != (answer == "Yes"):
@@ -227,7 +241,7 @@ class Greenhouse:
     def _field(self, page: Page, raw: dict[str, Any]) -> Field:
         kind, options = raw["kind"], raw.get("options")
         match kind:
-            case "text" | "number":
+            case "text" | "number" | "pasted":
                 field_type = FieldType.TEXT
             case "tel":
                 field_type = FieldType.PHONE
@@ -256,6 +270,7 @@ class Greenhouse:
             options,
             raw.get("maxLength"),
             raw.get("accept"),
+            one_of=raw.get("oneOf"),
         )
 
     def _education(self, page: Page, field_id: str) -> list[str] | None:
@@ -343,15 +358,26 @@ def _api_fields(job: dict[str, Any]) -> list[Field] | None:
         return None
     fields = []
     for question in job["questions"] + (job.get("location_questions") or []):
-        entry = question["fields"][0]  # a file's paste-in textarea comes second
-        if entry["type"] == "input_hidden":  # a location's latitude and longitude
-            continue
-        name = entry["name"]
-        field_type = FieldType.PHONE if name == "phone" else API_TYPES[entry["type"]]
-        if name == "location":
-            name, field_type = "candidate-location", FieldType.TYPEAHEAD
-        options = [v["label"] for v in entry.get("values") or []] or None
-        fields.append(Field(name, question["label"], field_type, question["required"], options))
+        entries = question["fields"]  # a file's paste-in textarea comes second, its alternative
+        one_of = entries[0]["name"] if len(entries) > 1 else None
+        for entry in entries:
+            if entry["type"] == "input_hidden":  # a location's latitude and longitude
+                continue
+            name = entry["name"]
+            field_type = FieldType.PHONE if name == "phone" else API_TYPES[entry["type"]]
+            if name == "location":
+                name, field_type = "candidate-location", FieldType.TYPEAHEAD
+            options = [v["label"] for v in entry.get("values") or []] or None
+            fields.append(
+                Field(
+                    name,
+                    question["label"],
+                    field_type,
+                    question["required"],
+                    options,
+                    one_of=one_of,
+                )
+            )
     return fields
 
 

{atsfill-0.0.4.dev94 → atsfill-0.0.4.dev96}/src/atsfill/adapters/jazzhr.py

@@ -47,13 +47,15 @@ _READ = """form => {
   const shown = el => el.offsetParent !== null;
   const disability = "#resumator-new-disability-message";
   const found = [], radios = new Set();
+  const pasted = "resumator-resumetext-value";  // "Paste resume", the file's alternative
+  const pasteable = !!form.querySelector(`#${pasted}`);
   const controls = form.querySelectorAll(
     "input:not([type=hidden]), select, textarea, input.resumator-questionnaire-checkbox-answer");
   for (const el of controls) {
-    if (["resumator-resumetext-value", "resumator-xml-value", "g-recaptcha-response"]
-        .includes(el.id) || el.classList.contains("resumator-questionnaire-checkbox")) continue;
+    if (["resumator-xml-value", "g-recaptcha-response"].includes(el.id)
+        || el.classList.contains("resumator-questionnaire-checkbox")) continue;
     const hidden = el.type === "file" ? el.id !== "resumator-resume-value"
-      : !shown(el) && el.type !== "hidden";
+      : !shown(el) && el.type !== "hidden" && el.id !== pasted;
     if (hidden) continue;
     const group = el.closest(".form-group, .resumator-field-wrapper");
     const groupLabel = group?.querySelector(".control-label, .resumator-label");
@@ -79,10 +81,11 @@ _READ = """form => {
       field.kind = "select";
       field.options = [...el.options].filter(o => !o.value.startsWith("resumator_no_selection")
         && !/^no answer$/i.test(o.text.trim())).map(o => o.text.trim());
-    } else if (el.type === "file") {
-      field.kind = "file";
+    } else if (el.type === "file" || el.id === pasted) {
+      field.kind = el.type === "file" ? "file" : "pasted";
       field.label = text(groupLabel);
       field.required = starred(groupLabel);
+      if (pasteable) field.oneOf = "resume";
     } else {
       field.kind = el.classList.contains("resumator-datepicker") ? "date"
         : el.type === "tel" ? "tel" : "text";
@@ -162,6 +165,12 @@ class JazzHR:
                         if attach.is_visible():
                             attach.click()
                     field.set_input_files(values[0])
+                case "pasted":  # behind "Paste resume", from the choice or the file's own link
+                    for link in ("#resumator-choose-paste", "#resumator-resume-switch-paste"):
+                        if page.locator(link).is_visible():
+                            page.locator(link).click()
+                            break
+                    field.fill(values[0])
                 case "select":
                     field.select_option(label=values[0])
                 case "radio":
@@ -235,7 +244,7 @@ def _signed_on_disability(fields: list[Field]) -> list[Field]:
 def _field(raw: dict[str, Any]) -> Field:
     kind, options = raw["kind"], raw.get("options")
     match kind:
-        case "text":
+        case "text" | "pasted":
             field_type = FieldType.TEXT
         case "date":
             field_type = FieldType.DATE
@@ -256,5 +265,12 @@ def _field(raw: dict[str, Any]) -> Field:
             )
     accept = RESUME_TYPES if kind == "file" else None
     return Field(
-        raw["id"], raw["label"], field_type, raw["required"], options, raw.get("maxLength"), accept
+        raw["id"],
+        raw["label"],
+        field_type,
+        raw["required"],
+        options,
+        raw.get("maxLength"),
+        accept,
+        one_of=raw.get("oneOf"),
     )

{atsfill-0.0.4.dev94 → atsfill-0.0.4.dev96}/src/atsfill/adapters/recruitee.py

@@ -22,6 +22,8 @@ FORM_TIMEOUT_MS = 30_000
 SUBMIT_TIMEOUT_MS = 90_000
 KEY_DELAY_MS = 20
 YES_NO = ["Yes", "No"]
+LETTER_FILE, LETTER = "candidate.coverLetterFile", "candidate.coverLetter"
+LETTER_SWITCH = "[data-cy=cover-letter-switch-button]"
 EXTENSIONS = {"image/png": [".png"], "image/jpeg": [".jpg", ".jpeg"], "application/pdf": [".pdf"]}
 KINDS = {
     "text": FieldType.TEXT,
@@ -29,6 +31,7 @@ KINDS = {
     "phone": FieldType.PHONE,
     "date": FieldType.DATE,
     "file": FieldType.FILE,
+    "letter": FieldType.TEXT,
     "radio": FieldType.CHOICE,
     "legal": FieldType.CHOICE,
     "checkboxes": FieldType.MULTI_CHOICE,
@@ -36,8 +39,9 @@ KINDS = {
 
 # The fields in page order, one per control name: its question's label, and how it renders. A
 # labelled question without a named control (a video recorder, drawn late) comes as kind
-# `video`; one without a label is text only.
-_READ = """form => {
+# `video`; one without a label is text only. A cover letter upload the switch turns into a
+# textarea is followed by that textarea, its alternative.
+_READ = """(form, [letterFile, letter, letterSwitch]) => {
   const text = el => {
     if (!el) return "";
     const copy = el.cloneNode(true);
@@ -84,7 +88,16 @@ _READ = """form => {
     if (el.type === "radio" || el.type === "checkbox" && field.kind === "checkboxes")
       field.options.push(text(form.querySelector(`label[for="${el.id}"]`)) || el.value);
   }
-  return [...found.values()];
+  const out = [];
+  for (const field of found.values()) {
+    out.push(field);
+    if (field.id === letterFile && form.querySelector(letterSwitch)) {
+      field.oneOf = letterFile;
+      out.push({id: letter, kind: "letter", label: field.label, required: field.required,
+                options: [], accept: null, maxLength: null, oneOf: letterFile});
+    }
+  }
+  return out;
 }"""
 
 # What each field shows: a choice its checked option's text, a file its attached name.
@@ -139,7 +152,7 @@ class Recruitee:
         except Timeout:
             raise Unsupported("posting_gone: no application form on the page") from None
         fields, self._kinds = [], {}
-        for raw in form.evaluate(_READ):
+        for raw in form.evaluate(_READ, [LETTER_FILE, LETTER, LETTER_SWITCH]):
             fields.append(_field(raw))
             if raw["kind"] != "video":
                 self._kinds[raw["id"]] = raw["kind"]
@@ -158,6 +171,10 @@ class Recruitee:
                             _set(option, True)
                 case "legal":
                     _set(controls.first, answer == "Yes")
+                case "letter":  # the switch swaps the upload for the textarea
+                    if not controls.count():
+                        browser.click(page.locator(f"{FORM} {LETTER_SWITCH}"))
+                    controls.first.fill(values[0])
                 case "phone":  # the country picker follows the number's own prefix
                     controls.first.fill("")
                     controls.first.press_sequentially(values[0], delay=KEY_DELAY_MS)
@@ -196,7 +213,14 @@ def _field(raw: dict[str, Any]) -> Field:
     if raw["accept"]:
         accept = [e for a in raw["accept"] for e in EXTENSIONS.get(a, [])] or None
     return Field(
-        raw["id"], label, KINDS[kind], raw["required"], options, raw.get("maxLength"), accept
+        raw["id"],
+        label,
+        KINDS[kind],
+        raw["required"],
+        options,
+        raw.get("maxLength"),
+        accept,
+        one_of=raw.get("oneOf"),
     )
 
 

{atsfill-0.0.4.dev94 → atsfill-0.0.4.dev96}/src/atsfill/core/browser.py

@@ -1,7 +1,6 @@
 """The browser launcher, the only module that imports camoufox and playwright (ADR 0002)."""
 
 import asyncio
-import fcntl
 import json
 import locale
 import platform
@@ -24,6 +23,8 @@ from camoufox.exceptions import CamoufoxNotInstalled
 from camoufox.fingerprints import Screen, generate_fingerprint
 from camoufox.pkgman import installed_verstr
 from camoufox.sync_api import Camoufox
+from filelock import FileLock
+from filelock import Timeout as LockTimeout
 from playwright.sync_api import APIRequestContext as Request
 from playwright.sync_api import Browser, Locator, Page, Response, sync_playwright
 from playwright.sync_api import Error as BrowserError
@@ -107,8 +108,7 @@ def _build_blocker() -> None:
     from disk: fetched by each launch, they would hold its first page for seconds, and each
     list on is compiled by each launch before the blocker starts."""
     ADDONS_DIR.mkdir(parents=True, exist_ok=True)
-    with (ADDONS_DIR / f"{BLOCKER.name}.lock").open("w") as f:
-        fcntl.flock(f, fcntl.LOCK_EX)
+    with FileLock(ADDONS_DIR / f"{BLOCKER.name}.lock"):
         build = BLOCKER.with_name(f"{BLOCKER.name}.build")
         shutil.rmtree(build, ignore_errors=True)
         shutil.copytree(get_addon_path(DefaultAddons.UBO.name), build)
@@ -171,19 +171,15 @@ def machine_locale() -> str | None:
 @contextmanager
 def lock(data_dir: Path, deadline: float) -> Generator[None]:
     """Holds the data directory; a second command waits here until its deadline."""
-    with (data_dir / "lock").open("w") as f:
-        while True:
-            try:
-                fcntl.flock(f, fcntl.LOCK_EX | fcntl.LOCK_NB)
-                break
-            except BlockingIOError:
-                if time.monotonic() > deadline:
-                    raise OutOfTime("time budget ran out waiting for another command") from None
-                time.sleep(LOCK_POLL_S)
-        try:
-            yield
-        finally:
-            fcntl.flock(f, fcntl.LOCK_UN)
+    held = FileLock(data_dir / "lock", poll_interval=LOCK_POLL_S)
+    try:
+        held.acquire(timeout=max(0.0, deadline - time.monotonic()))
+    except LockTimeout:
+        raise OutOfTime("time budget ran out waiting for another command") from None
+    try:
+        yield
+    finally:
+        held.release()
 
 
 @contextmanager

{atsfill-0.0.4.dev94 → atsfill-0.0.4.dev96}/src/atsfill/core/commands.py

@@ -172,17 +172,21 @@ def _result(adapter: Adapter, url: str, user: str) -> Result:
 
 
 def _unfillable(result: Result, answers: dict[str, Answer] | None = None) -> bool:
-    """Stops the form on a required field atsfill cannot fill; an optional one stays listed,
-    left empty (ADR 0014). A follow-up counts once the answers show it and require it, and
-    without answers never."""
+    """Stops the form on a required field atsfill cannot fill, or a required group none of whose
+    alternatives it can; an optional one stays listed, left empty (ADR 0014). A follow-up counts
+    once the answers show it and require it, and without answers never."""
     form = conditions.Form(result.fields, answers or {})
+
+    def stuck(f: Field) -> bool:
+        return f.unfillable is not None and f.prefilled is None
+
     field = next(
         (
             f
             for f in result.fields
-            if f.unfillable
-            and f.prefilled is None
-            and (form.required(f) if answers is not None else f.required and not f.shown_when)
+            if stuck(f)
+            and (form.asked(f) if answers is not None else f.required and not f.shown_when)
+            and all(stuck(m) for m in form.groups.get(f.one_of or "", [f]))
         ),
         None,
     )

{atsfill-0.0.4.dev94 → atsfill-0.0.4.dev96}/src/atsfill/core/conditions.py

@@ -13,9 +13,19 @@ def _parents(condition: Condition) -> list[str]:
             return [p for c in condition.all_of for p in _parents(c)]
 
 
+def alternatives(fields: list[Field]) -> dict[str, list[Field]]:
+    """The fields of each `one_of` group, by its key."""
+    out: dict[str, list[Field]] = {}
+    for f in fields:
+        if f.one_of:
+            out.setdefault(f.one_of, []).append(f)
+    return out
+
+
 def faults(fields: list[Field]) -> list[str]:
-    """What makes the fields' conditions unusable: a field they name that is not listed, or a
-    field shown by its own answer, through any chain."""
+    """What makes the fields' conditions unusable: a field they name that is not listed, a
+    field shown by its own answer through any chain, a group of alternatives with one member or
+    members disagreeing on `required`."""
     by_id = {f.id: f for f in fields}
     out = [
         f"{f.id}: its condition names no field {p}"
@@ -34,6 +44,11 @@ def faults(fields: list[Field]) -> list[str]:
         return any(loops(p, (*seen, field_id)) for p in parents)
 
     out += [f"{f.id}: shown by its own answer" for f in fields if loops(f.id, ())]
+    for key, members in alternatives(fields).items():
+        if len(members) == 1:
+            out.append(f"{key}: one alternative, {members[0].id}")
+        elif len({m.required for m in members}) > 1:
+            out.append(f"{key}: alternatives disagree on required")
     return out
 
 
@@ -43,6 +58,7 @@ class Form:
 
     def __init__(self, fields: list[Field], answers: dict[str, Answer]) -> None:
         self.by_id = {f.id: f for f in fields}
+        self.groups = alternatives(fields)
         self.answers = answers
 
     def holds(self, condition: Condition) -> bool:
@@ -64,7 +80,15 @@ class Form:
         return field.shown_when is None or self.holds(field.shown_when)
 
     def required(self, field: Field) -> bool:
-        """Required as the form asks it: shown, and always required or required by an answer."""
+        """Required as the form asks it: shown, and always required or required by an answer.
+        An alternative never is on its own: its group is (`group_required`)."""
+        return field.one_of is None and self.asked(field)
+
+    def group_required(self, key: str) -> bool:
+        return any(self.asked(m) for m in self.groups[key])
+
+    def asked(self, field: Field) -> bool:
+        """The field's own flag and conditions, whatever its group."""
         if not self.shown(field):
             return False
         when = field.required_when

{atsfill-0.0.4.dev94 → atsfill-0.0.4.dev96}/src/atsfill/core/matching.py

@@ -108,8 +108,8 @@ def _answer_problem(field: Field, answer: object) -> str | None:
 
 
 def problems(fields: list[Field], answers: dict[str, Answer]) -> list[str]:
-    """What refuses a fill before typing: unknown ids, missing required answers, answers to
-    follow-ups the answers keep hidden, bad values."""
+    """What refuses a fill before typing: unknown ids, missing required answers, more than one
+    alternative answered, answers to follow-ups the answers keep hidden, bad values."""
     by_id = {f.id: f for f in fields}
     out = [f"no field {i}" for i in answers if i not in by_id]
     form = Form(fields, {i: a for i, a in answers.items() if i in by_id})
@@ -118,6 +118,13 @@ def problems(fields: list[Field], answers: dict[str, Answer]) -> list[str]:
         for f in fields
         if form.required(f) and f.prefilled is None and not f.unfillable and f.id not in answers
     ]
+    for key, members in form.groups.items():
+        given = [m.id for m in members if m.id in answers]
+        if len(given) > 1:
+            out.append(f"{key}: one of {', '.join(given)}, not both")
+        elif form.group_required(key) and not given and all(m.prefilled is None for m in members):
+            labels = " or ".join(dict.fromkeys(m.label for m in members))
+            out.append(f"no answer for required {key} ({labels})")
     out += [
         f"{i}: not asked, it shows when {describe(f.shown_when, by_id)}"
         for i in answers

{atsfill-0.0.4.dev94 → atsfill-0.0.4.dev96}/src/atsfill/core/paths.py

@@ -1,10 +1,11 @@
-import fcntl
 import os
 import platform
 import re
 import tomllib
 from pathlib import Path
 
+from filelock import FileLock
+
 LINUX = platform.system() == "Linux"
 DEFAULT_USER = "default"
 TEST_USER = "test"
@@ -50,8 +51,7 @@ def _move_to_default(data: Path) -> None:
     user, once, under the lock."""
     if not any((data / name).exists() for name in MOVED):
         return
-    with (data / "lock").open("w") as lock:
-        fcntl.flock(lock, fcntl.LOCK_EX)
+    with FileLock(data / "lock"):
         default = data / "users" / DEFAULT_USER
         default.mkdir(mode=0o700, parents=True, exist_ok=True)
         for name in MOVED:

{atsfill-0.0.4.dev94 → atsfill-0.0.4.dev96}/src/atsfill/core/results.py

@@ -64,6 +64,7 @@ class Field:
     unfillable: str | None = None  # why atsfill cannot fill it, a reason (ADR 0014)
     shown_when: Condition | None = None  # a follow-up: shown only when it holds (ADR 0005)
     required_when: Condition | None = None  # required once shown when it holds, if not always
+    one_of: str | None = None  # an alternative: one of the fields with this key answers (ADR 0005)
 
 
 @dataclass(frozen=True)