atsfill 0.0.4.dev126__tar.gz → 0.0.4.dev127__tar.gz

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev127}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atsfill
-Version: 0.0.4.dev126
+Version: 0.0.4.dev127
 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
@@ -137,7 +137,7 @@ A dry run or a `send` through an adapter no send was verified on carries a `warn
 
 One home can send for more than one user: `--user <name>` gives each their own sessions, double-send guard and `[users.<name>]` section in the config file ([ADR 0015](docs/adr/0015-users-and-accounts.md)).
 Given an account's email (`atsfill login <adapter> --email`) and a password source (a `[password-commands]` entry such as `rbw get example.com {email}`, or `--password -` on stdin), atsfill signs in by itself, and again whenever a form command finds the session signed out.
-Where a system's sign-up allows it, `atsfill login <adapter> --create --email <address>` (with `--name` where the sign-up asks the user's name) creates the account with a password atsfill generates and keeps in the system's secret store, never printed; creating an account is a side effect, never part of `fill` or `send`.
+Where a system's sign-up allows it, `atsfill login <adapter> --create --email <address>` (with `--details <file.json>` where the sign-up asks the user's name, phone or address) creates the account with a password atsfill generates and keeps in the system's secret store, never printed; creating an account is a side effect, never part of `fill` or `send`.
 
 ## How it works
 

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev127}/README.md

@@ -109,7 +109,7 @@ A dry run or a `send` through an adapter no send was verified on carries a `warn
 
 One home can send for more than one user: `--user <name>` gives each their own sessions, double-send guard and `[users.<name>]` section in the config file ([ADR 0015](docs/adr/0015-users-and-accounts.md)).
 Given an account's email (`atsfill login <adapter> --email`) and a password source (a `[password-commands]` entry such as `rbw get example.com {email}`, or `--password -` on stdin), atsfill signs in by itself, and again whenever a form command finds the session signed out.
-Where a system's sign-up allows it, `atsfill login <adapter> --create --email <address>` (with `--name` where the sign-up asks the user's name) creates the account with a password atsfill generates and keeps in the system's secret store, never printed; creating an account is a side effect, never part of `fill` or `send`.
+Where a system's sign-up allows it, `atsfill login <adapter> --create --email <address>` (with `--details <file.json>` where the sign-up asks the user's name, phone or address) creates the account with a password atsfill generates and keeps in the system's secret store, never printed; creating an account is a side effect, never part of `fill` or `send`.
 
 ## How it works
 

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev127}/pyproject.toml

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

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

@@ -13,7 +13,15 @@ import urllib.parse
 from typing import Any
 from urllib.parse import parse_qs, urlsplit
 
-from atsfill.core.adapter import Blocked, Gap, NotTaken, Refused, Unsupported, known_gap
+from atsfill.core.adapter import (
+    Blocked,
+    Gap,
+    NotTaken,
+    Refused,
+    SignUpDetails,
+    Unsupported,
+    known_gap,
+)
 from atsfill.core.browser import Locator, Page, Request, Timeout
 from atsfill.core.results import Answer, Field, FieldType, SideEffect
 
@@ -88,7 +96,7 @@ _FIELDS = """form => [...form.querySelectorAll('.form-field')].flatMap(f => {
 class HRMDirect:
     name = "hrmdirect"
     per_employer = True
-    asks_name = True
+    asks = {"name"}
     known_gaps = {"screening_first": Gap.FLOW, "sign_up_phone": Gap.FLOW}
     side_effects = [
         SideEffect(
@@ -174,7 +182,7 @@ class HRMDirect:
         except Timeout:
             raise Refused("wrong_password") from None
 
-    def sign_up(self, page: Page, email: str, password: str, name: str | None) -> None:
+    def sign_up(self, page: Page, email: str, password: str, details: SignUpDetails) -> None:
         """Fills the apply page's first step, which creates the account signed in and sets no
         password: the email that follows holds a link to set one, `blocked: email_link`."""
         _to_apply(page)
@@ -189,7 +197,7 @@ class HRMDirect:
             )
         if page.locator(RECAPTCHA).count():
             raise Blocked("captcha: a reCAPTCHA box keeps the sign-up's Continue disabled")
-        first, _, last = (name or "").strip().partition(" ")
+        first, _, last = (details.name or "").strip().partition(" ")
         form = page.locator(IDENTITY)
         form.locator("input.first-name").fill(first)
         form.locator("input.last-name").fill(last or first)

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev127}/src/atsfill/adapters/join.py

@@ -13,7 +13,15 @@ from typing import Any
 from urllib.parse import urlsplit
 
 from atsfill.core import browser
-from atsfill.core.adapter import Blocked, Gap, NotTaken, Refused, Unsupported, known_gap
+from atsfill.core.adapter import (
+    Blocked,
+    Gap,
+    NotTaken,
+    Refused,
+    SignUpDetails,
+    Unsupported,
+    known_gap,
+)
 from atsfill.core.browser import Locator, Page, Request, Response, Timeout
 from atsfill.core.results import Answer, Field, FieldType, SideEffect
 
@@ -66,7 +74,7 @@ _REVIEW = """() => [...document.querySelectorAll("a > div")].map(div => {
 class Join:
     name = "join"
     per_employer = False
-    asks_name = True  # the account's first and last name
+    asks = {"name"}  # the account's first and last name
     known_gaps = {"profile_incomplete": Gap.FLOW}
     side_effects = [
         SideEffect("sign_up", "hiring_system", "login --create creates the candidate account"),
@@ -110,10 +118,10 @@ class Join:
         if urlsplit(page.url).path == UNVERIFIED:
             raise Blocked("email_link: the account is not confirmed")
 
-    def sign_up(self, page: Page, email: str, password: str, name: str | None) -> None:
+    def sign_up(self, page: Page, email: str, password: str, details: SignUpDetails) -> None:
         """Creates the account, signed in, then waits for its confirmation link: until it is
         clicked the wizard does not open."""
-        first, _, last = (name or "").strip().rpartition(" ")
+        first, _, last = (details.name or "").strip().rpartition(" ")
         if not first or not last:
             raise Unsupported("unhandled_rendering: the sign-up asks a first and a last name")
         if _email_step(page, email):

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev127}/src/atsfill/adapters/successfactors.py

@@ -13,7 +13,15 @@ from pathlib import Path
 from typing import Any
 from urllib.parse import urlsplit
 
-from atsfill.core.adapter import Blocked, Gap, NotTaken, Refused, Unsupported, known_gap
+from atsfill.core.adapter import (
+    Blocked,
+    Gap,
+    NotTaken,
+    Refused,
+    SignUpDetails,
+    Unsupported,
+    known_gap,
+)
 from atsfill.core.browser import Locator, Page, Request, Timeout
 from atsfill.core.results import Answer, Field, FieldType, SideEffect
 
@@ -81,7 +89,7 @@ def _company(request: Request) -> list[tuple[str, str]]:
 class SuccessFactors:
     name = "successfactors"
     per_employer = True
-    asks_name = True
+    asks = {"name"}
     known_gaps = {"quick_apply_sign_up": Gap.FLOW, "sign_up_fields": Gap.FLOW}
     side_effects = [
         SideEffect("sign_up", "employer", "the account is created in the employer's tenant"),
@@ -137,7 +145,7 @@ class SuccessFactors:
                 raise Blocked(f"email_link: {message}") from None
             raise Refused(f"wrong_password: {message}") from None
 
-    def sign_up(self, page: Page, email: str, password: str, name: str | None) -> None:
+    def sign_up(self, page: Page, email: str, password: str, details: SignUpDetails) -> None:
         self._candidate(page)
         if page.locator(SIGN_IN).count():
             page.locator(REGISTER).first.click()
@@ -152,7 +160,7 @@ class SuccessFactors:
                 ) from None
             register.first.click()
         page.locator(SIGN_UP).wait_for(timeout=LANDING_TIMEOUT_MS)
-        first, _, last = (name or "").strip().partition(" ")
+        first, _, last = (details.name or "").strip().partition(" ")
         for selector, value in [
             (SIGN_UP, email),
             ("#fbclc_emailConf", email),

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev127}/src/atsfill/adapters/taleo.py

@@ -15,7 +15,7 @@ from dataclasses import dataclass
 from typing import Any
 from urllib.parse import parse_qs, quote, urlsplit
 
-from atsfill.core.adapter import Blocked, Gap, NotTaken, Refused, Unsupported
+from atsfill.core.adapter import Blocked, Gap, NotTaken, Refused, SignUpDetails, Unsupported
 from atsfill.core.browser import Page, Request, Timeout
 from atsfill.core.results import Answer, AnyOf, Field, FieldType, Is, OptionSet, SideEffect
 
@@ -209,7 +209,7 @@ def posting(url: str) -> Posting | None:
 class Taleo:
     name = "taleo"
     per_employer = True
-    asks_name = False
+    asks: set[str] = set()
     known_gaps = {LOCATION_GAP: Gap.RENDERING, DATE_PICKER_GAP: Gap.RENDERING}
     side_effects = [
         SideEffect("sign_up", "employer", "the account is created in the employer's zone"),
@@ -264,7 +264,7 @@ class Taleo:
         page.locator(f"#{FORM_ID}-login-defaultCmd").click()
         _left_sign_in(page)
 
-    def sign_up(self, page: Page, email: str, password: str, name: str | None) -> None:
+    def sign_up(self, page: Page, email: str, password: str, details: SignUpDetails) -> None:
         page.locator(f"#{FORM_ID}-login-register").click()
         page.wait_for_load_state()
         accept = page.locator(f"#{FORM_ID}-StatementBeforeAuthentificationContent-ContinueButton")

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev127}/src/atsfill/adapters/ukg.py

@@ -13,7 +13,7 @@ from dataclasses import dataclass
 from typing import Any
 from urllib.parse import parse_qs, quote, urlsplit
 
-from atsfill.core.adapter import Blocked, Gap, NotTaken, Refused, Unsupported
+from atsfill.core.adapter import Blocked, Gap, NotTaken, Refused, SignUpDetails, Unsupported
 from atsfill.core.browser import Locator, Page, Request, Timeout
 from atsfill.core.results import Answer, Field, FieldType, Is, OptionSet, SideEffect
 
@@ -218,7 +218,7 @@ def board(url: str) -> Board | None:
 class UKG:
     name = "ukg"
     per_employer = True
-    asks_name = True
+    asks = {"name"}
     known_gaps = {PHONE_GAP: Gap.FLOW}
     side_effects = [
         SideEffect("sign_up", "employer", "the account is created in the employer's tenant"),
@@ -275,7 +275,7 @@ class UKG:
         if "/AuthCode/Register" in page.url:
             raise Unsupported("unhandled_rendering: the tenant asks the account's name")
 
-    def sign_up(self, page: Page, email: str, password: str, name: str | None) -> None:
+    def sign_up(self, page: Page, email: str, password: str, details: SignUpDetails) -> None:
         page.locator("a[href*='/u/signup']").first.click()
         page.locator("input#email").wait_for(timeout=FORM_TIMEOUT_MS)
         page.locator("input#email").fill(email)
@@ -284,7 +284,7 @@ class UKG:
         _left_sign_in(page)
         if "/AuthCode/Register" not in page.url:
             return
-        _register(page, name or "")
+        _register(page, details.name or "")
 
     def browser_read(self, page: Page) -> list[Field]:
         found = board(page.url)

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev127}/src/atsfill/adapters/workday.py

@@ -17,7 +17,15 @@ from typing import Any
 from urllib.parse import urlsplit
 
 from atsfill.core import matching
-from atsfill.core.adapter import Blocked, Gap, NotTaken, Refused, Unsupported, known_gap
+from atsfill.core.adapter import (
+    Blocked,
+    Gap,
+    NotTaken,
+    Refused,
+    SignUpDetails,
+    Unsupported,
+    known_gap,
+)
 from atsfill.core.browser import Locator, Page, PageRequest, Request, Response, Timeout
 from atsfill.core.results import Answer, AnyOf, Condition, Field, FieldType, Is, SideEffect
 
@@ -187,7 +195,7 @@ def _profile_hosts(request: Request, scope: str | None) -> list[str]:
 class Workday:
     name = "workday"
     per_employer = True
-    asks_name = False
+    asks: set[str] = set()
     known_gaps = {
         "experience_entries": Gap.FLOW,
         "long_wizard": Gap.FLOW,
@@ -244,7 +252,7 @@ class Workday:
         _email_form(page)
         _submit(page, "signInSubmitButton", email, password)
 
-    def sign_up(self, page: Page, email: str, password: str, name: str | None) -> None:
+    def sign_up(self, page: Page, email: str, password: str, details: SignUpDetails) -> None:
         _email_form(page)
         page.locator("[data-automation-id=createAccountLink]").click()
         page.locator("[data-automation-id=verifyPassword]").fill(password)

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev127}/src/atsfill/adapters/wttj.py

@@ -12,7 +12,7 @@ from typing import Any
 from urllib.parse import urlsplit
 
 from atsfill.core import browser, matching
-from atsfill.core.adapter import Blocked, Gap, NotTaken, Refused, Unsupported
+from atsfill.core.adapter import Blocked, Gap, NotTaken, Refused, SignUpDetails, Unsupported
 from atsfill.core.browser import Locator, Page, PageRequest, Request, Response, Timeout
 from atsfill.core.results import Answer, Field, FieldType, SideEffect
 
@@ -64,7 +64,7 @@ _READ_BACK = """(form, ids) => Object.fromEntries(ids.map(id => {
 class WelcomeToTheJungle:
     name = "wttj"
     per_employer = False
-    asks_name = True  # the profile's first name
+    asks = {"name"}  # the profile's first name
     known_gaps: dict[str, Gap] = {}
     side_effects = [
         SideEffect("sign_up", "hiring_system", "login --create creates the account"),
@@ -98,11 +98,11 @@ class WelcomeToTheJungle:
     def sign_in(self, page: Page, email: str, password: str) -> None:
         _account_form(page, "sign-in-form", {"email": email, "password": password}, "/sessions")
 
-    def sign_up(self, page: Page, email: str, password: str, name: str | None) -> None:
+    def sign_up(self, page: Page, email: str, password: str, details: SignUpDetails) -> None:
         """Creates the account, signed in, then waits for its confirmation link: clicking it
         signs every session out."""
         page.goto(SIGN_UP)
-        values = {"firstname": name or "", "email": email, "password": password}
+        values = {"firstname": details.name or "", "email": email, "password": password}
         _account_form(page, "sign-up-form", values, "/registrations")
         raise Blocked("email_link: the sign-up sent a confirmation link")
 

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev127}/src/atsfill/cli.py

@@ -7,7 +7,7 @@ from pathlib import Path
 from atsfill import core
 from atsfill.adapters import adapters
 from atsfill.core import browser, paths
-from atsfill.core.adapter import NeedsAccount
+from atsfill.core.adapter import NeedsAccount, SignUpDetails
 from atsfill.core.results import Result, SessionReport, Status, StatusReport
 
 OK = {Status.READY, Status.SUBMITTED}
@@ -105,7 +105,11 @@ def parser() -> argparse.ArgumentParser:
         action="store_true",
         help="create the account with --email and a password atsfill generates and stores",
     )
-    login.add_argument("--name", help="the user's name, for a sign-up that asks it")
+    login.add_argument(
+        "--details",
+        type=details_file,
+        help="a JSON file of the user's sign-up details (name, phone, address), for --create",
+    )
     for name in ("read", "fill", "send", "status", "login", "logout"):
         sub.choices[name].add_argument(
             "-v", "--verbose", action="store_true", help="the whole result, every key, indented"
@@ -123,6 +127,13 @@ def answers_file(path: str) -> dict:
     return answers
 
 
+def details_file(path: str) -> SignUpDetails:
+    try:
+        return SignUpDetails.parse(json.loads(Path(path).read_text()))
+    except (OSError, ValueError) as e:
+        raise argparse.ArgumentTypeError(str(e)) from e
+
+
 def run(args: argparse.Namespace) -> int:
     try:
         paths.config(getattr(args, "user", paths.DEFAULT_USER))
@@ -171,7 +182,7 @@ def run(args: argparse.Namespace) -> int:
                         password=password,
                         window=args.window,
                         create=args.create,
-                        name=args.name,
+                        details=args.details,
                         **where,
                     )
             except ValueError as e:

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev127}/src/atsfill/core/accounts.py

@@ -6,7 +6,13 @@ import time
 from pathlib import Path
 
 from atsfill.core import browser
-from atsfill.core.adapter import CreatesAccount, NeedsAccount, SignsIn, Unsupported
+from atsfill.core.adapter import (
+    CreatesAccount,
+    NeedsAccount,
+    SignsIn,
+    SignUpDetails,
+    Unsupported,
+)
 from atsfill.core.browser import Page
 from atsfill.core.passwords import account_key
 
@@ -53,17 +59,16 @@ def sign_in(
     address: str,
     password: str,
     session: Path,
-    create: bool = False,
-    name: str | None = None,
+    details: SignUpDetails | None = None,
 ) -> None:
-    """Signs in, or creates the account (with the user's `name` where it asks one), from the
+    """Signs in, or creates the account from the user's sign-up `details` when given, from the
     system's login page and stores the session.
     Raises what the adapter raises, without the password in it."""
     page.goto(adapter.login_url(scope))
     try:
-        if create:
+        if details is not None:
             assert isinstance(adapter, CreatesAccount)
-            adapter.sign_up(page, address, password, name)
+            adapter.sign_up(page, address, password, details)
         else:
             adapter.sign_in(page, address, password)
     except Exception as e:

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev127}/src/atsfill/core/adapter.py

@@ -1,5 +1,7 @@
+import re
+from dataclasses import dataclass, fields
 from enum import StrEnum
-from typing import Protocol, runtime_checkable
+from typing import Protocol, Self, runtime_checkable
 
 from atsfill.core.browser import Page, Request
 from atsfill.core.results import Answer, Field, SideEffect
@@ -123,16 +125,61 @@ class SignsIn(NeedsAccount, Protocol):
         ...
 
 
+ADDRESS = ("street", "city", "state", "zip", "country")
+PHONE = re.compile(r"\+[1-9][0-9]{6,14}")  # E.164
+COUNTRY = re.compile(r"[A-Z]{2}")  # ISO 3166 alpha-2
+
+
+@dataclass(frozen=True)
+class SignUpDetails:
+    """What a sign-up asks of the user besides the email and the password, from the file
+    `login --create --details` takes (ADR 0015). atsfill stores none of it."""
+
+    name: str | None = None
+    phone: str | None = None
+    street: str | None = None
+    city: str | None = None
+    state: str | None = None
+    zip: str | None = None
+    country: str | None = None
+
+    @classmethod
+    def parse(cls, data: object) -> Self:
+        """From `{"name", "phone", "address": {"street", "city", "state", "zip", "country"}}`,
+        every key optional. Raises `ValueError` naming what is wrong."""
+        if not isinstance(data, dict):
+            raise ValueError("sign-up details: expected a JSON object")
+        address = data.get("address", {})
+        if not isinstance(address, dict):
+            raise ValueError("sign-up details: address: expected a JSON object")
+        if unknown := (data.keys() - {"name", "phone", "address"}) | (address.keys() - {*ADDRESS}):
+            raise ValueError(f"sign-up details: unknown keys {', '.join(sorted(unknown))}")
+        flat = {k: v for k, v in data.items() if k != "address"} | address
+        for key, value in flat.items():
+            if not isinstance(value, str) or not value.strip():
+                raise ValueError(f"sign-up details: {key}: expected a non-empty string")
+        if "phone" in flat and not PHONE.fullmatch(flat["phone"]):
+            raise ValueError("sign-up details: phone: expected E.164, as +15551234567")
+        if "country" in flat and not COUNTRY.fullmatch(flat["country"]):
+            raise ValueError("sign-up details: country: expected ISO 3166 alpha-2, as US")
+        return cls(**flat)
+
+    def missing(self, asks: set[str]) -> list[str]:
+        """The details `asks` names that these lack, in the file's order."""
+        return [f.name for f in fields(self) if f.name in asks and getattr(self, f.name) is None]
+
+
 @runtime_checkable
 class CreatesAccount(SignsIn, Protocol):
     """An adapter atsfill can create an account through, where the system's sign-up allows it.
     Account creation is a side effect it declares (ADR 0008)."""
 
-    asks_name: bool  # the sign-up asks the user's name
+    asks: set[str]  # the `SignUpDetails` fields its sign-up requires
 
-    def sign_up(self, page: Page, email: str, password: str, name: str | None) -> None:
+    def sign_up(self, page: Page, email: str, password: str, details: SignUpDetails) -> None:
         """Creates the account from the page `login_url` loaded, signed in once it returns.
-        Raises as `sign_in` does; `Refused` names the rule a `password_rule` page showed."""
+        Raises as `sign_in` does; `Refused` names the rule a `password_rule` page showed. The
+        details in `asks` are given; optional consents the sign-up offers stay declined."""
         ...
 
 

{atsfill-0.0.4.dev126 → atsfill-0.0.4.dev127}/src/atsfill/core/commands.py

@@ -25,6 +25,7 @@ from atsfill.core.adapter import (
     ReadsByRequest,
     Refused,
     SignsIn,
+    SignUpDetails,
     Unsupported,
 )
 from atsfill.core.browser import OutOfTime, Overlaid, Page, open_page
@@ -481,7 +482,7 @@ def login(
     password: str | None = None,
     window: bool = False,
     create: bool = False,
-    name: str | None = None,
+    details: SignUpDetails | None = None,
     data_dir: Path | None = None,
 ) -> SessionReport:
     """Signs in with the account's password source, headless, and stores the session; without
@@ -489,7 +490,7 @@ def login(
 
     `email` is remembered for the account; `password` is used for this sign-in only. `create`
     creates the account with a password atsfill generates and stores first (a side effect),
-    giving `name` where the sign-up asks it; with a password already stored, the account may
+    giving the sign-up the user's `details`; with a password already stored, the account may
     exist, so it signs in with that password and keeps the account's email instead."""
     account, data = _account(adapter), paths.data_dir(data_dir)
     scope = _scope(account, url)
@@ -498,6 +499,8 @@ def login(
     report = SessionReport(user, adapter, scope, "missing", session)
     if create and not email:
         raise ValueError("creating an account needs --email")
+    if details and not create:
+        raise ValueError("--details goes with --create")
     try:
         kept = create and passwords.stored(mine, adapter, scope) is not None
     except passwords.PasswordError as e:
@@ -507,7 +510,7 @@ def login(
         accounts.remember(mine, adapter, scope, email)
     if create and not kept:
         assert email
-        return _create(report, account, url, mine, (email, name), data)
+        return _create(report, account, url, mine, email, details or SignUpDetails(), data)
     if kept:
         report.password = "kept"
     if password and not (isinstance(account, SignsIn) and accounts.email(mine, adapter, scope)):
@@ -539,25 +542,28 @@ def _create(
     account: NeedsAccount,
     url: str | None,
     mine: Path,
-    who: tuple[str, str | None],
+    email: str,
+    details: SignUpDetails,
     data: Path,
 ) -> SessionReport:
-    """Creates the account: the generated password is stored before the click, and deleted
-    only on a refusal the page states before any account exists."""
+    """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."""
     if not isinstance(account, CreatesAccount):
         report.status = Status.UNSUPPORTED
         report.reason = f"no_sign_up: atsfill cannot create a {account.name} account"
         return report
-    email, name = who
-    if account.asks_name and not name:
-        raise ValueError(f"creating a {account.name} account needs --name")
+    if missing := details.missing(account.asks):
+        report.status = Status.REFUSED
+        report.reason = f"sign_up_details: no {', '.join(missing)}"
+        return report
     password = passwords.generate()
     try:
         passwords.store(mine, account.name, report.scope, password)
     except passwords.PasswordError as e:
         report.status, report.reason = Status.BLOCKED, f"password_source: {e}"
         return report
-    result = _headless(data, account, report.scope, (email, password), report.path, True, name)
+    result = _headless(data, account, report.scope, (email, password), report.path, details)
     command = login_command(account.name, report.user, url)
     report.status, report.reason = result.status, _email_link(result.reason, email, command)
     report.password = "stored"
@@ -575,8 +581,7 @@ def _headless(
     scope: str | None,
     credentials: Credentials,
     session: Path,
-    create: bool = False,
-    name: str | None = None,
+    details: SignUpDetails | None = None,
 ) -> Result:
     """Signs in, or creates the account, through the adapter: `ready` once the session is
     stored."""
@@ -586,7 +591,7 @@ def _headless(
     def run(_: list[str]) -> Result:
         result = Result(Status.READY, url, account.name)
         with open_page(data, None) as page, _stops(result):
-            accounts.sign_in(page, account, scope, *credentials, session, create, name)
+            accounts.sign_in(page, account, scope, *credentials, session, details)
         return result
 
     return _in_budget(url, run)