atsfill 0.0.5.dev182__tar.gz → 0.0.5.dev186__tar.gz

{atsfill-0.0.5.dev182 → atsfill-0.0.5.dev186}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atsfill
-Version: 0.0.5.dev182
+Version: 0.0.5.dev186
 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.5.dev182 → atsfill-0.0.5.dev186}/pyproject.toml

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

@@ -1,6 +1,6 @@
 [project]
 name = "atsfill"
-version = "0.0.5.dev182"
+version = "0.0.5.dev186"
 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.5.dev182 → atsfill-0.0.5.dev186}/src/atsfill/adapters/adpmyjobs.py

@@ -408,15 +408,15 @@ class ADPMyJobs:
                 every = len(chosen) == len(labels)
                 incoming.setdefault(target, []).append(Is(ids[qid], None if every else chosen))
             label = _text(raw.get("questionDescription") or qid)
+            knockouts = [labels[a["answerId"]] for a in answers if a.get("knockoutRule")] or None
             match raw["questionType"]:
                 case "Instructions":
                     continue
-                case "Single choice":
+                case "Single choice" | "Multiple choice" as kind:
                     self._codes[ids[qid]] = labels
-                    f = Field(ids[qid], label, FieldType.CHOICE, True, list(labels.values()))
-                case "Multiple choice":
-                    self._codes[ids[qid]] = labels
-                    f = Field(ids[qid], label, FieldType.MULTI_CHOICE, True, list(labels.values()))
+                    type_ = FieldType.CHOICE if kind == "Single choice" else FieldType.MULTI_CHOICE
+                    options = list(labels.values())
+                    f = Field(ids[qid], label, type_, True, options, knockouts=knockouts)
                 case "Free form":
                     f = Field(ids[qid], label, FieldType.TEXT, True)
                 case "Calendar":

{atsfill-0.0.5.dev182 → atsfill-0.0.5.dev186}/src/atsfill/adapters/jobstreet.py

@@ -34,6 +34,8 @@ APPLY = "[data-automation=job-detail-apply]"
 CONTINUE = "[data-testid=continue-button]"
 SUBMIT = "[data-testid=review-submit-application]"
 SAVE_DETAILS = "[data-automation=personal-details-save-button]"
+RESUME_FILE = "input[type=file][id^=resume]"
+LETTER_FILE = "input[type=file][id^=coverLetter]"
 CHALLENGE = "Just a moment..."  # Cloudflare's interstitial: it passes on its own, or on a reload
 CHALLENGE_TRIES = 2
 SIGN_IN_TIMEOUT_MS = 90_000  # SEEK's sign-in takes up to ~50 s to show its form
@@ -53,6 +55,7 @@ SUGGEST_TIMEOUT_S = 8
 POLL_MS = 250
 KEY_DELAY_MS = 40
 DETAILS = ("firstName", "lastName", "currentLocation", "phone")
+DOCUMENTS = ("resume", "coverLetter", "coverLetterFile")
 VISIBILITY = ["Public", "Standard", "Limited", "Hidden"]
 
 _STEP_ONE = """() => {
@@ -62,7 +65,7 @@ _STEP_ONE = """() => {
     .find(e => e.checked);
   const label = e => e && document.querySelector(`label[for="${e.id}"]`)?.innerText.trim();
   const resume = picked('document-select');
-  const letter = document.querySelector('[data-testid=coverLetter-method-change]');
+  const method = picked('coverLetter-method');
   const phone = value('#phoneNumber');
   return {
     firstName: value('#firstName'), lastName: value('#lastName'),
@@ -70,7 +73,8 @@ _STEP_ONE = """() => {
     phone: phone && code?.value
       ? `${code.options[code.selectedIndex].text.match(/\\+\\d+/)?.[0] ?? ''}${phone}` : null,
     resume: resume && resume.value !== 'dont-include' ? label(resume) : null,
-    coverLetter: letter?.checked ? value('[data-testid=coverLetterTextInput]') : null,
+    coverLetter: method?.value === 'change' ? value('[data-testid=coverLetterTextInput]') : null,
+    coverLetterFile: method?.value === 'upload' ? label(method) : null,
   };
 }"""
 
@@ -198,7 +202,7 @@ class Jobstreet:
         self._read |= _personal_details(page, self._fields, answers)
         _documents_fill(page, answers)
         documents = page.evaluate(_STEP_ONE)
-        self._read |= {k: documents[k] for k in ("resume", "coverLetter") if documents[k]}
+        self._read |= {k: documents[k] for k in DOCUMENTS if documents[k]}
         _continue(page)
         if page.url.split("?")[0].endswith("/role-requirements"):
             for field_id, answer in answers.items():
@@ -316,14 +320,12 @@ def _operations(response: Response) -> dict[str, Any]:
 
 def _documents(page: Page, viewer: dict[str, Any]) -> list[Field]:
     """The first step: the profile's personal details, then the resume and the cover letter,
-    optional where the page offers to leave them out."""
+    optional where the page offers to leave them out. The cover letter is written or uploaded,
+    two alternatives."""
     details = viewer["personalDetails"]
     code = (details.get("countryCallingCode") or {}).get("countryCallingCode", "")
     location = (viewer.get("currentLocation2") or {}).get("description")
-    resume = page.locator("input[type=file][id^=resume]")
-    accept: list[str] | None = None
-    if resume.count():
-        accept = [str(a) for a in (resume.get_attribute("accept") or "").split(",")]
+    letter = not page.locator("[data-testid=coverLetter-method-none]").count()
     return [
         Field("firstName", "First name", FieldType.TEXT, True,
               prefilled=details.get("firstName") or None),
@@ -333,12 +335,21 @@ def _documents(page: Page, viewer: dict[str, Any]) -> list[Field]:
         Field("phone", "Phone number", FieldType.PHONE, False,
               prefilled=f"{code}{details['phoneNumber']}" if details.get("phoneNumber") else None),
         Field("resume", "Resumé", FieldType.FILE,
-              not page.locator("input[type=radio][value=dont-include]").count(), accept=accept),
-        Field("coverLetter", "Cover letter", FieldType.TEXT,
-              not page.locator("[data-testid=coverLetter-method-none]").count()),
+              not page.locator("input[type=radio][value=dont-include]").count(),
+              accept=_accept(page, RESUME_FILE)),
+        Field("coverLetter", "Cover letter", FieldType.TEXT, letter, one_of="coverLetter"),
+        Field("coverLetterFile", "Cover letter", FieldType.FILE, letter,
+              accept=_accept(page, LETTER_FILE), one_of="coverLetter"),
     ]  # fmt: skip
 
 
+def _accept(page: Page, selector: str) -> list[str] | None:
+    upload = page.locator(selector)
+    if not upload.count():
+        return None
+    return [str(a) for a in (upload.get_attribute("accept") or "").split(",")]
+
+
 def _question(raw: dict[str, Any]) -> Field | None:
     field_id, label = f"question.{raw['id']}", raw["text"]
     options = [o["text"] for o in raw.get("options") or []]
@@ -404,20 +415,27 @@ def _phone(page: Page, answer: str) -> None:
 
 def _documents_fill(page: Page, answers: dict[str, Answer]) -> None:
     """Uploads the resume, which the page then picks, or leaves it out; the same for the cover
-    letter, written in its box."""
+    letter, uploaded or written in its box."""
     if (resume := answers.get("resume")) is not None:
-        page.locator("input[type=file][id^=resume]").set_input_files(str(resume))
-        name = str(resume).rsplit("/", 1)[-1]
-        page.locator("label", has_text=name).first.wait_for(timeout=SAVE_TIMEOUT_MS)
+        _upload(page, RESUME_FILE, str(resume))
     elif (none := page.locator("input[type=radio][value=dont-include]")).count():
         none.check(force=True)
-    if (letter := answers.get("coverLetter")) is not None:
-        page.locator("[data-testid=coverLetter-method-change]").check(force=True)
+    if (letter := answers.get("coverLetterFile")) is not None:
+        _upload(page, LETTER_FILE, str(letter))
+    elif (letter := answers.get("coverLetter")) is not None:
+        page.locator("input[type=radio][data-testid=coverLetter-method-change]").check(force=True)
         page.locator("[data-testid=coverLetterTextInput]").fill(str(letter))
     elif (none := page.locator("[data-testid=coverLetter-method-none]")).count():
         none.check(force=True)
 
 
+def _upload(page: Page, selector: str, path: str) -> None:
+    """Sets the file, then waits for the radio the page adds and picks, labelled with its name."""
+    page.locator(selector).set_input_files(path)
+    name = path.rsplit("/", 1)[-1]
+    page.locator("label", has_text=name).first.wait_for(timeout=SAVE_TIMEOUT_MS)
+
+
 def _answer(page: Page, field: Field, answer: Answer) -> None:
     name = f"questionnaire.{field.id.removeprefix('question.')}"
     select = page.locator(f'select[name="{name}"]')

{atsfill-0.0.5.dev182 → atsfill-0.0.5.dev186}/src/atsfill/adapters/phenom.py

@@ -44,6 +44,7 @@ SEQ = re.compile(r"^/[a-z]{2,8}/[a-z]{2}/job/([A-Za-z0-9]+)")
 CDN = "https://cdn-prod-static.phenompeople.com/CareerConnectResources"
 FORM = "form.rjsf"
 NEXT = "button#next"
+TERMS = "terms"  # a notice some sites' wizard opens on, its one button accepting it
 SUBMIT = "button#submit, button.btn-submit, button[type=submit].btn-navigate:not(#next)"
 RESUME = ".resume-upload-wrapper input[type=file]"
 RESUME_ID = "resume"
@@ -264,6 +265,11 @@ class Phenom:
         SideEffect(
             "upload", "hiring_system", "the resume is uploaded to Phenom and parsed at once"
         ),
+        SideEffect(
+            "fill",
+            "hiring_system",
+            "an employer notice the wizard opens on (`page=terms`) is accepted to reach the form",
+        ),
         SideEffect(
             "fill",
             "hiring_system",
@@ -355,6 +361,7 @@ class Phenom:
     def fill(self, page: Page, answers: dict[str, Answer]) -> None:
         page.context.clear_cookies()
         self._open(page, fresh=True)
+        self._accept_terms(page)
         self._kept, self._shown = {}, {}
         if RESUME_ID in answers and page.locator(RESUME).count():
             _upload(page, _one(answers[RESUME_ID]))
@@ -414,17 +421,31 @@ class Phenom:
         if fresh or not page.url.startswith(self._apply):
             page.goto(self._apply, wait_until="domcontentloaded")
         _check_open(page)
+        self._wait_for_step(page)
+
+    def _wait_for_step(self, page: Page) -> None:
         try:
             page.locator(f"{FORM} {NEXT}, {FORM} button[type=submit]").first.wait_for(
                 state="attached", timeout=FORM_TIMEOUT_MS
             )
         except Timeout:
-            query = parse_qs(urlsplit(page.url).query)
-            if step := (query.get("stepname") or query.get("page") or [None])[0]:
+            if step := _step_name(page.url):
                 gap = known_gap(self, "first_step", f"the wizard opens on {step!r}")
                 raise Unsupported(gap) from None
             raise RuntimeError("no application step on the page") from None
 
+    def _accept_terms(self, page: Page) -> None:
+        """Accepts the terms some sites' wizard opens on, a step with no field before the form."""
+        if _step_name(page.url) != TERMS:
+            return
+        _click(page, page.locator(FORM).locator(SUBMIT).first)
+        try:
+            page.wait_for_url(lambda url: _step_name(url) != TERMS, timeout=STEP_TIMEOUT_MS)
+        except Timeout:
+            gap = known_gap(self, "first_step", "the wizard stays on its terms once accepted")
+            raise Unsupported(gap) from None
+        self._wait_for_step(page)
+
     def _step(self, page: Page, answers: dict[str, Answer]) -> list[dict[str, Any]]:
         """The answered fields the current step shows, in the configuration's order."""
         shown = {r["id"]: r for r in page.locator(FORM).evaluate(_SCAN)}
@@ -1237,6 +1258,12 @@ def _seq(url: str) -> str | None:
     return parse_qs(parts.query).get("jobSeqNo", [None])[0]
 
 
+def _step_name(url: str) -> str | None:
+    """The wizard's step as its URL names it (`stepname=`, `page=`), if it does."""
+    query = parse_qs(urlsplit(url).query)
+    return (query.get("stepname") or query.get("page") or [None])[0]
+
+
 def _apply_url(page: Page) -> str:
     """The wizard's URL: the page's, or where the job page's Apply link leads; the wizard's
     own when no link shows, which `_open` then finds or not."""

{atsfill-0.0.5.dev182 → atsfill-0.0.5.dev186}/src/atsfill/adapters/workatastartup.py

@@ -390,6 +390,8 @@ class Control:
                 return form.locator("input[type=tel]")
             case "country" | "combo":
                 return form.locator(f'input[aria-label="{self.where}"]')
+            case "companies":
+                return form.locator('input[aria-label="Company name"]')
             case "multi" | "skills":
                 return form.get_by_label(self.where, exact=False)
             case "month":  # the selects' names carry the entry's id: <id>_start_date_month
@@ -429,15 +431,7 @@ STEPS: dict[str, list[Control]] = {
         Control("phone_number", "Phone Number", "phone", FieldType.PHONE, False),
         Control("share", "What is your job search status?", "radio", C, True),
         Control("yc_affiliation", "Have you worked at a YC company?", "radio", C, True),
-        Control(
-            "hidden_companies",
-            "YC companies to be hidden from",
-            "combo",
-            T,
-            False,
-            "Company name",
-            unfillable="unhandled_rendering: a list of YC companies to be hidden from",
-        ),
+        Control("hidden_companies", "YC companies to be hidden from", "companies", M, False),
     ],
     "location": [
         Control("city_current", "What city do you live in?", "place", TA, True),
@@ -625,6 +619,8 @@ def _value(form: Locator, c: Control) -> Answer | None:
             return target.evaluate(_SINGLE_VALUE) or None
         case "multi":
             return target.evaluate(_CHIPS)
+        case "companies":
+            return target.evaluate(_COMPANIES)
         case "skills":
             return form.evaluate(_SKILLS)
     return target.input_value()
@@ -640,6 +636,8 @@ _CHIPS = """e => {
   const box = e.closest("[id$=__select]") ?? e.parentElement.parentElement.parentElement;
   return [...box.querySelectorAll("[aria-label^='Remove ']")].map(c => c.ariaLabel.slice(7));
 }"""
+_COMPANIES = """e => [...e.parentElement.previousElementSibling.querySelectorAll(
+  "span[role=button] + span")].map(s => s.textContent.trim())"""
 _SKILLS = """form => {
   const groups = {};
   for (const r of form.querySelectorAll("input[type=radio][name^=top_skills_]")) {
@@ -684,6 +682,8 @@ def _profile_fill(page: Page, form: Locator, c: Control, answer: Answer) -> None
                 form.locator(f'[aria-label="Remove {chip}"]').click()
             for item in [a for a in answer if a not in have]:
                 _pick(page, c, target, item, strict=True, exact=True)
+        case "companies", list():
+            _companies(page, target, c, answer)
         case "skills", list():
             _skills(page, form, target, c, answer)
         case kind, _:
@@ -715,6 +715,17 @@ def _pick(
     box.press("Escape")
 
 
+def _companies(page: Page, box: Locator, c: Control, answer: list[str]) -> None:
+    """Removes the companies the answer leaves out, then searches each other one and picks the
+    result named exactly as it: a nearest name would hide the profile from another company."""
+    chips = box.locator("xpath=../preceding-sibling::div[1]//div[span[@role='button']]")
+    while extra := [i for i, h in enumerate(box.evaluate(_COMPANIES)) if h not in answer]:
+        chips.nth(extra[0]).locator("span[role=button]").click()
+    have = box.evaluate(_COMPANIES)
+    for company in [a for a in answer if a not in have]:
+        _pick(page, c, box, company, strict=True, exact=True)
+
+
 def _skills(page: Page, form: Locator, box: Locator, c: Control, answer: list[str]) -> None:
     """Removes the skills the answer leaves out, adds the others, then picks each level."""
     wanted: dict[str, str] = {}

{atsfill-0.0.5.dev182 → atsfill-0.0.5.dev186}/src/atsfill/core/commands.py

@@ -424,6 +424,7 @@ def _fill(
         if problems := matching.problems(result.fields, answers):
             result.status, result.reason = Status.REFUSED, "invalid_answers: " + "; ".join(problems)
             return result
+        result.warnings = matching.knockouts(result.fields, answers)
         adapter.fill(page, answers)
         _shown_as_listed(page, adapter, result, answers)
         if result.status is not Status.READY:

{atsfill-0.0.5.dev182 → atsfill-0.0.5.dev186}/src/atsfill/core/matching.py

@@ -159,3 +159,15 @@ def problems(fields: list[Field], answers: dict[str, Answer]) -> list[str]:
         and (problem := _answer_problem(by_id[i], a, form))
     ]
     return out
+
+
+def knockouts(fields: list[Field], answers: dict[str, Answer]) -> list[str]:
+    """The answers that end the application: never refused, as one can be the truthful one."""
+    by_id = {f.id: f for f in fields}
+    return [
+        f"{i}: {', '.join(map(repr, chosen))} ends the application ({f.label})"
+        for i, a in answers.items()
+        if (f := by_id.get(i))
+        and f.knockouts
+        and (chosen := [v for v in ([a] if isinstance(a, str) else a) if v in f.knockouts])
+    ]

{atsfill-0.0.5.dev182 → atsfill-0.0.5.dev186}/src/atsfill/core/results.py

@@ -75,6 +75,7 @@ class Field:
     one_of: str | None = None  # an alternative: one of the fields with this key answers (ADR 0005)
     option_sets: list[OptionSet] | None = None  # a dependent list's; `options` where none holds
     min_length: int | None = None  # a text the system refuses shorter
+    knockouts: list[str] | None = None  # the options whose choice ends the application (ADR 0005)
 
 
 @dataclass(frozen=True)
@@ -106,6 +107,7 @@ class Result:
     unloaded: list[str] = field(default_factory=list)  # steps a profile read could not load yet
     notice: str | None = None  # telemetry's, the first time it is on (ADR 0016)
     report: str | None = None  # how to send a failed run's report, when it was not sent
+    warnings: list[str] = field(default_factory=list)  # the knockout answers a fill gave
 
 
 @dataclass