atsfill 0.0.5.dev169__tar.gz → 0.0.5.dev177__tar.gz

{atsfill-0.0.5.dev169 → atsfill-0.0.5.dev177}/PKG-INFO

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

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

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

@@ -119,10 +119,12 @@ class Jobstreet:
     def login_url(self, scope: str | None) -> str:
         return f"https://{scope}/oauth/login?returnUrl=%2F"
 
-    def signed_in(self, request: Request, scope: str | None) -> bool:
+    def signed_in(self, request: Request, scope: str | None) -> bool | None:
         """The site's `/profile` redirects an account to `/profile/me` and shows a visitor its
-        page. Cloudflare answers 403 outside the browser, so a session there reads signed out."""
+        page. Cloudflare can answer 403 outside the browser, which tells neither."""
         response = request.get(f"https://{scope}/profile", max_redirects=0)
+        if response.status == 403 or response.headers.get("cf-mitigated") == "challenge":
+            return None
         return response.status in (302, 307) and response.headers.get("location", "").endswith(
             "/profile/me"
         )

{atsfill-0.0.5.dev169 → atsfill-0.0.5.dev177}/src/atsfill/adapters/join.py

@@ -58,8 +58,10 @@ QUESTIONS = """query JobScreeningQuestions($input: JobScreeningQuestionsInput!)
   }
 }"""
 YES_NO = ["Yes", "No"]  # a boolean's cards, in this order, in the job's language
-FILES = {"cv": "cv"}  # a file field, by its step
-# A question of a class has a step of its own; the others are `question-<n>`, in order.
+FILES = {"cv": "cv", "coverLetter": "coverLetter"}  # a file field, by its step
+# The documents a job asks, by their type in the wizard's `documentsConfig`
+DOCUMENTS = {"CV": ("cv", "CV"), "COVER_LETTER": ("coverLetter", "Cover letter")}
+# A question of a class has a step of its own; the others are `question-<position>`.
 CLASS_STEPS = {
     "workAuthorization": "WORK_AUTHORIZATION",
     "salaryExpectation": "SALARY_EXPECTATION",
@@ -200,11 +202,6 @@ class Join:
         answered = page.evaluate(_FETCH, [f"{GRAPHQL}?operationName=JobScreeningQuestions", body])
         questions = answered["data"]["jobScreeningQuestions"]["questions"]
         self._questions = sorted(questions, key=lambda q: q.get("position") or 0)
-        fields = [
-            Field("cv", "CV", FieldType.FILE, True, accept=PDF),
-            *(_question(q) for q in self._questions),
-        ]
-        self._fields = {f.id: f for f in fields if not f.unfillable}
         browser.click(page.locator("[data-testid=ApplyButton]").locator("visible=true").first)
         page.wait_for_url("**/apply/**", timeout=STEP_TIMEOUT_MS)
         # the wizard opens on `authentication`, and leaves it once it knows the account
@@ -216,6 +213,16 @@ class Join:
             page.wait_for_timeout(POLL_MS)
         if _step(page) == "authentication":
             raise Blocked("login_required: run `atsfill login join`")
+        # the wizard's page names the documents the job asks, each required or optional
+        raw = page.locator("script#__NEXT_DATA__").text_content() or "{}"
+        state = json.loads(raw)["props"]["pageProps"].get("initialState") or {}
+        documents = (state.get("job") or {}).get("documentsConfig") or [{"type": "CV"}]
+        fields = [
+            *(Field(*DOCUMENTS[d["type"]], FieldType.FILE, d.get("constraint") != "OPTIONAL",
+                    accept=PDF) for d in documents if d["type"] in DOCUMENTS),
+            *(_question(q) for q in self._questions),
+        ]  # fmt: skip
+        self._fields = {f.id: f for f in fields if not f.unfillable}
         return fields
 
     def fill(self, page: Page, answers: dict[str, Answer]) -> None:
@@ -232,8 +239,6 @@ class Join:
                 field_id = f"question.{question['id']}"
                 if field_id in self._fields:
                     self._question(page, question, answers.get(field_id))
-            elif step == "coverLetter":  # asked by some jobs only: left without one
-                pass
             elif step in PROFILE_STEPS:
                 try:  # shown when the job requires what the account profile lacks
                     _next(page, step)
@@ -252,10 +257,11 @@ class Join:
         if kind := CLASS_STEPS.get(step):
             return next((q for q in self._questions if q.get("questionClass") == kind), None)
         if match := re.fullmatch(r"question-(\d+)", step):
-            plain = [q for q in self._questions if not q.get("questionClass")]
-            if int(match[1]) > len(plain):
-                raise Unsupported(f"unhandled_rendering: a question step {step} not listed")
-            return plain[int(match[1]) - 1]
+            position = int(match[1])
+            plain = (q for q in self._questions if not q.get("questionClass"))
+            if question := next((q for q in plain if q.get("position") == position), None):
+                return question
+            raise Unsupported(f"unhandled_rendering: a question step {step} not listed")
         return None
 
     def read_back(self, page: Page) -> dict[str, Answer]:

{atsfill-0.0.5.dev169 → atsfill-0.0.5.dev177}/src/atsfill/adapters/lever.py

@@ -19,6 +19,7 @@ from atsfill.core.results import Answer, Field, FieldType, SideEffect
 HOSTS = re.compile(r"^jobs\.(eu\.)?lever\.co$")
 JOB = re.compile(r"^/([^/]+)/([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})\b")
 FORM = "form#application-form"
+CAPTCHA = "iframe[src*='hcaptcha.com']"  # hidden until hCaptcha asks the visitor a challenge
 FORM_TIMEOUT_MS = 30_000
 UPLOAD_TIMEOUT_MS = 30_000
 SUGGEST_TIMEOUT_MS = 10_000
@@ -188,7 +189,7 @@ class Lever:
         try:
             page.wait_for_url(re.compile(r"/thanks\b"), timeout=SUBMIT_TIMEOUT_MS)
         except Timeout:
-            if page.locator("iframe[src*='hcaptcha'][title*='challenge']").is_visible():
+            if page.locator(CAPTCHA).locator("visible=true").count():
                 raise Blocked("captcha: hCaptcha asked for a challenge") from None
             raise
         return page.url

{atsfill-0.0.5.dev169 → atsfill-0.0.5.dev177}/src/atsfill/adapters/successfactors.py

@@ -173,6 +173,10 @@ class SuccessFactors:
 
     def sign_in(self, page: Page, email: str, password: str) -> None:
         self._candidate(page)
+        if page.locator(QUICK_APPLY).count():  # its sign-in is a dialog, beside its sign-up
+            raise Unsupported(
+                known_gap(self, "quick_apply_sign_up", "the application is a Quick Apply page")
+            )
         if not page.locator(SIGN_IN).count():
             page.locator(SIGN_IN_LINK).first.click()
             page.locator(SIGN_IN).wait_for(timeout=LANDING_TIMEOUT_MS)

{atsfill-0.0.5.dev169 → atsfill-0.0.5.dev177}/src/atsfill/core/accounts.py

@@ -111,11 +111,13 @@ def redacted(error: Exception, password: str) -> Exception:
 
 
 def state(adapter: NeedsAccount, session: Path, scope: str | None) -> str:
-    """`signed_in` or `signed_out` from the system itself, `missing` with no session stored."""
+    """`signed_in` or `signed_out` from the system itself, `unknown` when its answer cannot
+    tell, `missing` with no session stored."""
     if not session.exists():
         return "missing"
     with browser.session_request(session) as request:
-        return "signed_in" if adapter.signed_in(request, scope) else "signed_out"
+        signed_in = adapter.signed_in(request, scope)
+    return {True: "signed_in", False: "signed_out", None: "unknown"}[signed_in]
 
 
 def wait_for_person(

{atsfill-0.0.5.dev169 → atsfill-0.0.5.dev177}/src/atsfill/core/adapter.py

@@ -122,8 +122,9 @@ class NeedsAccount(Protocol):
 
     def login_url(self, scope: str | None) -> str: ...
 
-    def signed_in(self, request: Request, scope: str | None) -> bool:
-        """Whether the cookies `request` carries are signed in, from one request to the system."""
+    def signed_in(self, request: Request, scope: str | None) -> bool | None:
+        """Whether the cookies `request` carries are signed in, from one request to the system;
+        None when its answer cannot tell, such as a bot protection's challenge."""
         ...
 
 

{atsfill-0.0.5.dev169 → atsfill-0.0.5.dev177}/src/atsfill/core/commands.py

@@ -98,6 +98,9 @@ def _login_required(url: str, adapter: NeedsAccount, user: str) -> Result:
 type Credentials = tuple[str, str | None]  # email, password: None for an account without one
 # Refusals the page states before any account exists: the generated password goes.
 NO_ACCOUNT = {"email_in_use", "email_domain_rejected", "password_rule", "sign_up_details"}
+# A sign-in's refusals that find no account with the password: a stored one may be from a
+# sign-up blocked before the account existed.
+NOT_SIGNED_UP = {"wrong_password", "no_account"}
 
 
 def _next_step(
@@ -750,10 +753,11 @@ def login(
     if password and by_otp:
         raise ValueError(f"{adapter} signs in with an emailed OTP, not a password")
     try:
-        kept = create and not by_otp and passwords.stored(mine, adapter, scope) is not None
+        stored = passwords.stored(mine, adapter, scope) if create and not by_otp else None
     except passwords.PasswordError as e:
         report.status, report.reason = Status.BLOCKED, f"password_source: {e}"
         return report
+    kept = stored is not None
     if email and not kept:
         accounts.remember(mine, adapter, scope, email)
     if create and not kept:
@@ -784,6 +788,23 @@ def login(
         )
     else:
         result = _headless(data, user, account, scope, credentials, session, details)
+        if (
+            kept
+            and isinstance(account, CreatesAccount)
+            and (result.reason or "").split(":")[0] in NOT_SIGNED_UP
+            and credentials[1] == stored
+        ):
+            # a sign-up blocked before the account existed: sign up again, same password
+            return _create(
+                report,
+                account,
+                url,
+                mine,
+                credentials[0],
+                details or SignUpDetails(),
+                data,
+                kept=credentials[1],
+            )
         report.status = result.status
         report.reason = _next_step(result.reason, credentials[0], adapter, user, url)
     if report.reason is None:
@@ -799,10 +820,12 @@ def _create(
     email: str,
     details: SignUpDetails,
     data: Path,
+    kept: str | None = None,
 ) -> SessionReport:
     """Creates the account: refused before the browser opens when `details` lack one the
     sign-up asks; the generated password is stored before the click, and deleted only on a
-    refusal the page states before any account exists. An account without a password gets
+    refusal the page states before any account exists. A `kept` password, stored by an
+    earlier sign-up, is used again and never deleted. An account without a password gets
     none."""
     if not isinstance(account, (CreatesAccount, CreatesAccountByOtp)):
         report.status = Status.UNSUPPORTED
@@ -812,9 +835,9 @@ def _create(
         report.status = Status.REFUSED
         report.reason = f"sign_up_details: no {', '.join(missing)}"
         return report
-    password = None if isinstance(account, CreatesAccountByOtp) else passwords.generate()
+    password = kept or (None if isinstance(account, CreatesAccountByOtp) else passwords.generate())
     try:
-        if password:
+        if password and not kept:
             passwords.store(mine, account.name, report.scope, password)
     except passwords.PasswordError as e:
         report.status, report.reason = Status.BLOCKED, f"password_source: {e}"
@@ -825,9 +848,10 @@ def _create(
     )
     report.status = result.status
     report.reason = _next_step(result.reason, email, account.name, report.user, url)
-    report.password = "stored" if password else "none"
+    report.password = "kept" if kept else "stored" if password else "none"
     if (
         password
+        and not kept
         and result.status is Status.REFUSED
         and (result.reason or "").split(":")[0] in NO_ACCOUNT
     ):

{atsfill-0.0.5.dev169 → atsfill-0.0.5.dev177}/src/atsfill/core/results.py

@@ -120,7 +120,7 @@ class SessionReport:
     user: str
     adapter: str
     scope: str | None  # the account scope, None for an account that covers the whole system
-    session: str  # signed_in | signed_out | missing
+    session: str  # signed_in | signed_out | unknown | missing
     path: Path
     status: str | None = None  # a login's outcome: signed_in | refused | blocked | unsupported
     reason: str | None = None  # why a login stored nothing, `code` or `code: detail`