atsfill 0.0.10.dev237__tar.gz → 0.0.10.dev242__tar.gz

{atsfill-0.0.10.dev237 → atsfill-0.0.10.dev242}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atsfill
-Version: 0.0.10.dev237
+Version: 0.0.10.dev242
 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.10.dev237 → atsfill-0.0.10.dev242}/pyproject.toml

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

@@ -1,6 +1,6 @@
 [project]
 name = "atsfill"
-version = "0.0.10.dev237"
+version = "0.0.10.dev242"
 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.10.dev237 → atsfill-0.0.10.dev242}/src/atsfill/adapters/adpmyjobs.py

@@ -26,6 +26,7 @@ from atsfill.core.adapter import (
     SignedOut,
     SignUpDetails,
     Unsupported,
+    before_send,
     known_gap,
 )
 from atsfill.core.browser import Locator, Page, Request, Timeout
@@ -124,58 +125,60 @@ class ADPMyJobs:
 
     def open(self, page: Page) -> str | None:
         """Loads the posting signed in: Apply sends the application. One the account applied
-        to has its unfinished workflow continued, as My Jobs does."""
-        found = _posting(page.url)
-        if found is None:
-            raise RuntimeError(f"{page.url} is not an ADP MyJobs posting")
-        site, req = found
-        # Left before it settles, the first page's loader wedges the tab: no workflow shows in it
-        with suppress(Timeout):
-            page.wait_for_load_state("networkidle", timeout=POSTING_TIMEOUT_MS)
-        settings = _career_site(page, site)
-        self._site_id = str(settings["externalId"])
-        if not (settings.get("enabledFeatures") or {}).get("candidateApplicationWorkflow"):
-            detail = f"{site} continues each application on ADP Recruiting, after Apply"
-            raise Unsupported(known_gap(self, "recruiting_workflow", detail))
-        page.goto(f"https://{HOST}/{site}/cx/job-details?reqId={req}")
-        deadline = time.monotonic() + POSTING_TIMEOUT_MS / 1000
-        while not page.evaluate("() => !!sessionStorage.getItem('myJobsToken')"):
-            if urlsplit(page.url).path.endswith("/auth"):
-                raise SignedOut("login_required: the posting sent to the sign-in")
-            if time.monotonic() > deadline:
-                raise RuntimeError("the posting loaded without a session token")
-            page.wait_for_timeout(SETTLE_MS)
-        with suppress(Timeout):  # left with its requests in flight, the workflow can spin
-            page.wait_for_load_state("networkidle", timeout=POSTING_TIMEOUT_MS)
-        if application := self._application(page, req):
-            if (application.get("applicationStatusCode") or {}).get("label") != "CONTINUE":
-                raise Unsupported(f"already_sent: the account applied ({_status(application)})")
-            assignment = application["assignmentID"]
-            workflow = self._get(
-                page, f"{QUESTIONNAIRES}/WORKFLOW?assignmentID={assignment}&rmapp=forms"
-            )
-            component = next(
-                (
-                    labels["component"]
-                    for raw in workflow.get("questionSections") or []
-                    if raw.get("completionStatusCode") != "completed"
-                    and "component" in (labels := _labels(raw))
-                ),
-                None,
-            )
-            if component is None:
-                raise Unsupported("already_sent: the account completed its application")
-            page.goto(
-                f"https://{HOST}/{site}/cx/app?reqId={req}&assignmentId={assignment}"
-                f"&workflowComponent={component}"
-            )
-            self._wait_for_section(page)
-            return None
-        apply = page.get_by_role("button", name="Apply", exact=True)
-        try:
-            apply.first.wait_for(timeout=max(0, deadline - time.monotonic()) * 1000)
-        except Timeout:
-            raise Unsupported("posting_gone: the posting shows no Apply") from None
+        to has its unfinished workflow continued, as My Jobs does: nothing is sent but by the
+        click on Apply."""
+        with before_send():  # all of it but the click, which sends
+            found = _posting(page.url)
+            if found is None:
+                raise RuntimeError(f"{page.url} is not an ADP MyJobs posting")
+            site, req = found
+            # Left before it settles, the first page's loader wedges the tab: no workflow shows
+            with suppress(Timeout):
+                page.wait_for_load_state("networkidle", timeout=POSTING_TIMEOUT_MS)
+            settings = _career_site(page, site)
+            self._site_id = str(settings["externalId"])
+            if not (settings.get("enabledFeatures") or {}).get("candidateApplicationWorkflow"):
+                detail = f"{site} continues each application on ADP Recruiting, after Apply"
+                raise Unsupported(known_gap(self, "recruiting_workflow", detail))
+            page.goto(f"https://{HOST}/{site}/cx/job-details?reqId={req}")
+            deadline = time.monotonic() + POSTING_TIMEOUT_MS / 1000
+            while not page.evaluate("() => !!sessionStorage.getItem('myJobsToken')"):
+                if urlsplit(page.url).path.endswith("/auth"):
+                    raise SignedOut("login_required: the posting sent to the sign-in")
+                if time.monotonic() > deadline:
+                    raise RuntimeError("the posting loaded without a session token")
+                page.wait_for_timeout(SETTLE_MS)
+            with suppress(Timeout):  # left with its requests in flight, the workflow can spin
+                page.wait_for_load_state("networkidle", timeout=POSTING_TIMEOUT_MS)
+            if application := self._application(page, req):
+                if (application.get("applicationStatusCode") or {}).get("label") != "CONTINUE":
+                    raise Unsupported(f"already_sent: the account applied ({_status(application)})")
+                assignment = application["assignmentID"]
+                workflow = self._get(
+                    page, f"{QUESTIONNAIRES}/WORKFLOW?assignmentID={assignment}&rmapp=forms"
+                )
+                component = next(
+                    (
+                        labels["component"]
+                        for raw in workflow.get("questionSections") or []
+                        if raw.get("completionStatusCode") != "completed"
+                        and "component" in (labels := _labels(raw))
+                    ),
+                    None,
+                )
+                if component is None:
+                    raise Unsupported("already_sent: the account completed its application")
+                page.goto(
+                    f"https://{HOST}/{site}/cx/app?reqId={req}&assignmentId={assignment}"
+                    f"&workflowComponent={component}"
+                )
+                self._wait_for_section(page)
+                return None
+            apply = page.get_by_role("button", name="Apply", exact=True)
+            try:
+                apply.first.wait_for(timeout=max(0, deadline - time.monotonic()) * 1000)
+            except Timeout:
+                raise Unsupported("posting_gone: the posting shows no Apply") from None
         apply.first.click()
         deadline = time.monotonic() + POSTING_TIMEOUT_MS / 1000
         while not (made := self._application(page, req)):

{atsfill-0.0.10.dev237 → atsfill-0.0.10.dev242}/src/atsfill/adapters/join.py

@@ -123,6 +123,18 @@ _CONTINUE = """(button, step) => {
   return true;
 }"""
 
+# Whether the cards shown are the question's: its options (a choice), or under its text (a
+# boolean, whose cards are in the job's language).
+_OWN_CARDS = """([question, options]) => {
+  const cards = [...document.querySelectorAll("[role=radio]")].map(card => {
+    const lines = card.innerText.split("\\n").map(line => line.trim()).filter(Boolean);
+    return lines[1] ?? lines[0] ?? "";
+  });
+  return options
+    ? cards.length === options.length && cards.every((card, i) => card === options[i])
+    : document.body.innerText.includes(question);
+}"""
+
 _CHECKED = """cards => cards.map(card => card.getAttribute("aria-checked") === "true")"""
 
 # The ids of the inputs that are empty, of those given.
@@ -422,6 +434,12 @@ class Join:
         match question["type"]:
             case "BOOLEAN" | "SINGLE_CHOICE":
                 cards.first.wait_for(timeout=STEP_TIMEOUT_MS)
+                with suppress(Timeout):  # the step before's cards stay a moment
+                    page.wait_for_function(
+                        _OWN_CARDS,
+                        arg=[question["question"], question["options"]],
+                        timeout=INPUT_TIMEOUT_MS,
+                    )
                 # the cards are the options in order: a letter, the option, a description
                 texts = [_card(t) for t in cards.all_inner_texts()]
                 options = YES_NO if question["type"] == "BOOLEAN" else question["options"]

{atsfill-0.0.10.dev237 → atsfill-0.0.10.dev242}/src/atsfill/adapters/workatastartup.py

@@ -406,8 +406,10 @@ class Control:
         match self.kind:
             case "phone":
                 return form.locator("input[type=tel]")
-            case "country" | "combo":
+            case "country":
                 return form.locator(f'input[aria-label="{self.where}"]')
+            case "combo":
+                return _in_entry(form, self.entry, f"input[@aria-label = '{self.where}']")
             case "companies":
                 return form.locator('input[aria-label="Company name"]')
             case "multi" | "skills":
@@ -497,8 +499,16 @@ STEPS: dict[str, list[Control]] = {
         ),
     ],
     "experience": [
-        Control("work_employer", "Work History: Employer Name", "combo", T, False, "Employer Name"),
-        Control("work_title", "Work History: Title", "combo", T, False, "Title"),
+        Control(
+            "work_employer",
+            "Work History: Employer Name",
+            "combo",
+            T,
+            False,
+            "Employer Name",
+            "work",
+        ),
+        Control("work_title", "Work History: Title", "combo", T, False, "Title", "work"),
         Control("work_location", "Work History: Location", "input", T, False, "location", "work"),
         Control(
             "work_from", "Work History: From (MM/YYYY)", "month", T, False, "start_date", "work"
@@ -517,7 +527,15 @@ STEPS: dict[str, list[Control]] = {
             Is("work_current", ["No"]),
         ),
         Control("work_summary", "Work History: Summary", "input", T, False, "summary", "work"),
-        Control("education_school", "Education: School Name", "combo", T, False, "School Name"),
+        Control(
+            "education_school",
+            "Education: School Name",
+            "combo",
+            T,
+            False,
+            "School Name",
+            "education",
+        ),
         Control(
             "education_field",
             "Education: Field of Study / Major",
@@ -525,8 +543,17 @@ STEPS: dict[str, list[Control]] = {
             T,
             False,
             "Field of Study / Major",
+            "education",
+        ),
+        Control(
+            "education_degree",
+            "Education: Degree type",
+            "combo",
+            T,
+            False,
+            "Degree type",
+            "education",
         ),
-        Control("education_degree", "Education: Degree type", "combo", T, False, "Degree type"),
         Control(
             "education_from",
             "Education: From (MM/YYYY)",
@@ -719,16 +746,18 @@ def _pick(
     box.press_sequentially(answer, delay=KEY_DELAY_MS)
     options = page.locator("[role=option]:visible, li[id^=downshift-][id*=-item-]:visible")
     field = Field(c.id, c.label, FieldType.TYPEAHEAD, False)
+    seen: list[str] = []
     deadline = time.monotonic() + SUGGEST_TIMEOUT_S
     while time.monotonic() < deadline:
-        for option in options.all():
-            text = option.inner_text().strip()
+        seen = [o.inner_text().strip() for o in options.all()]
+        for i, text in enumerate(seen):
             if text == answer if exact else matching.matches(field, answer, text):
-                option.click()
+                options.nth(i).click()
                 return
         page.wait_for_timeout(SUGGEST_POLL_MS)
     if strict:
-        raise NotTaken(f"no suggestion for {answer!r} in {c.id}")
+        said = ", ".join(repr(t) for t in seen) or "none"
+        raise NotTaken(f"no suggestion for {answer!r} in {c.id}; suggestions: {said}")
     box.press("Escape")
 
 

{atsfill-0.0.10.dev237 → atsfill-0.0.10.dev242}/src/atsfill/core/adapter.py

@@ -1,4 +1,6 @@
 import re
+from collections.abc import Generator
+from contextlib import contextmanager
 from dataclasses import dataclass, fields
 from enum import StrEnum
 from typing import Protocol, Self, runtime_checkable
@@ -38,6 +40,26 @@ class Unsupported(Exception):
     """
 
 
+class NotSent(Exception):
+    """Raised by `SendsToOpen.open` around an error it knows came before anything was sent: the
+    core records no attempt and handles `cause` as it would without a send (ADR 0006)."""
+
+    def __init__(self, cause: Exception) -> None:
+        super().__init__(cause)
+        self.cause = cause
+
+
+@contextmanager
+def before_send() -> Generator[None]:
+    """Wraps what `SendsToOpen.open` does before its click in `NotSent`."""
+    try:
+        yield
+    except SignedOut, Unsupported, Blocked:
+        raise
+    except Exception as e:
+        raise NotSent(e) from e
+
+
 class Gap(StrEnum):
     """The code of a known gap (ADR 0014): wanted, not handled yet."""
 
@@ -284,7 +306,8 @@ class SendsToOpen(Adapter, Protocol):
     def open(self, page: Page) -> str | None:
         """Opens the form from the loaded posting: sends the application where the account has
         none for it, returning the evidence of that send; continues the one it has, returning
-        None. Raises `SignedOut`, `Unsupported` or `Blocked` only before sending."""
+        None. Raises `SignedOut`, `Unsupported` or `Blocked` only before sending, and wraps any
+        other error before it in `NotSent` (`before_send`)."""
         ...
 
 

{atsfill-0.0.10.dev237 → atsfill-0.0.10.dev242}/src/atsfill/core/commands.py

@@ -29,6 +29,7 @@ from atsfill.core.adapter import (
     KeepsProfile,
     ListsShownFields,
     NeedsAccount,
+    NotSent,
     NotTaken,
     OpensForm,
     ProfileIncomplete,
@@ -246,8 +247,8 @@ def _read_signed_in(page: Page, adapter: Adapter, mine: Path, user: str, url: st
 def _open(page: Page, adapter: SendsToOpen, mine: Path, user: str, url: str) -> None:
     """Opens a form whose system sends the application to show it, under a send's rules: the
     adapter in `submit-allowed`, and the send recorded `opened`, which the send of that same
-    application does not count against (ADR 0006). An error past the adapter's own stops may
-    follow the send: it is recorded `unknown`."""
+    application does not count against (ADR 0006). An error the adapter does not say came
+    before the send (`NotSent`) may follow it: it is recorded `unknown`."""
     if not paths.submit_enabled(adapter.name, user):
         raise Refused(f"{_not_enabled(adapter, user)}; opening its form sends the application")
     posting = adapter.posting(page.url)
@@ -255,6 +256,8 @@ def _open(page: Page, adapter: SendsToOpen, mine: Path, user: str, url: str) ->
         evidence = adapter.open(page)
     except SignedOut, Unsupported, Blocked:
         raise
+    except NotSent as e:
+        raise e.cause from None
     except Exception as e:
         reason = f"error_after_click: {type(e).__name__}: {e}"
         attempts.record(mine, posting, Status.UNKNOWN, reason=reason)
@@ -597,7 +600,8 @@ def _read(data: Path, user: str, url: str, sessions: Sessions | None, seen: Seen
             try:
                 _listed(result, fields)
             except ValueError as e:
-                return Result(Status.UNSUPPORTED, url, adapter.name, f"adapter_error: {e}")
+                reason = f"adapter_error: {type(e).__name__}: {e}"
+                return Result(Status.UNSUPPORTED, url, adapter.name, reason)
             _unfillable(result)
             return result
     return _in_budget(url, seen, lambda: _browser_read(data, user, url, sessions, seen))

{atsfill-0.0.10.dev237 → atsfill-0.0.10.dev242}/src/atsfill/core/telemetry.py

@@ -7,6 +7,7 @@ import hashlib
 import json
 import logging
 import os
+import re
 import subprocess
 import sys
 import uuid
@@ -56,6 +57,10 @@ EXCLUDED = (
     "external_step",
 )
 
+# Reason codes whose detail starts with the exception's class: `code: Class: message`.
+ERRORS = ("error_after_click", "adapter_error")
+CLASS = re.compile(r"[A-Z]\w*")
+
 logging.getLogger("posthog").disabled = True
 
 
@@ -63,6 +68,13 @@ def _code(reason: str | None) -> str | None:
     return reason.partition(":")[0] if reason else None
 
 
+def _error(reason: str | None) -> str | None:
+    """The exception's class in an error's reason, never its message."""
+    code, _, detail = (reason or "").partition(": ")
+    name = detail.partition(":")[0]
+    return name if code in ERRORS and CLASS.fullmatch(name) else None
+
+
 def verdict(result: Result) -> str:
     """What the run says about its adapter: `pass`, `fail`, `excluded` or `unsupported`."""
     if result.status in (Status.READY, Status.SUBMITTED):
@@ -135,6 +147,7 @@ def event(command: str, result: Result) -> dict:
         "verdict": verdict(result),
         "status": result.status.value,
         "reason": _code(result.reason),
+        "error": _error(result.reason),
         "refused": result.refused or None,
         "version": version("atsfill"),
         "posting": None if command == "profile" else posting_hash(_posting(result)),