Seed 186 companies, add roledesk companies, and pull and close every board
seed/companies.json: 179 companies from jobhunt-hq's seed.json (MIT), reduced to key/name/board/careers_url, plus a hand-added DACH set. `roledesk companies seed|add|check` import it, add one company from its board with a live check first, and report dead boards. roledesk/jobs/pull.py is now a pipeline task: ten boards per pull_batch job on the http resource, upserting every role the ats plugin yields. Its final job's settle closes every board this run answered in full and no longer lists a role from, reading the plugin's own self.state stamps rather than each batch job's return value, so one bad board in a batch does not cost the other nine their closure. `roledesk job pull` runs it, and it registers itself in pipeline.TASKS so <desk-jobs> can start it too. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
1 parent
21ed472a87
commit
0f59452b2a
5 files changed
+1684
-10
No files matched your search
+101
-6
@@ -1,18 +1,113 @@
|
||||
"""`pull`: read every configured plugin. A no-op until the first plugin lands."""
|
||||
"""`pull`: fetch every active `ats` board and store the roles it lists.
|
||||
|
||||
A task, not a single job: ten boards per `pull_batch` job on the `http`
|
||||
resource pool, because a board is one HTTP round trip and that pool is sized
|
||||
for exactly this. The final job's `settle` then closes every board a
|
||||
complete fetch of it did not list again — see `close_boards`.
|
||||
|
||||
Closure is read from `self.state`, which the `ats` plugin itself stamps per
|
||||
board on a successful parse (`ats:ok:<target>`, `ats:ids:<target>`), rather
|
||||
than from what each `pull_batch` job happens to return. A batch job that
|
||||
raises partway through still leaves the boards it had already finished
|
||||
stamped, so one bad board in a batch of ten does not cost the other nine
|
||||
their closure.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
import logging
|
||||
from datetime import UTC, datetime
|
||||
from typing import Any
|
||||
|
||||
from pipeline import NULL, RunContext, job
|
||||
from pipeline import NULL, RunContext, TASKS, Tally, Task, job
|
||||
|
||||
from roledesk.config import Config
|
||||
from roledesk.storage import Store
|
||||
|
||||
log = logging.getLogger(__name__)
|
||||
|
||||
#: As many boards in the air per job as there are `http` workers by default
|
||||
#: (see `roles.yaml`), so one pull keeps the pool busy without one job
|
||||
#: holding all 190-odd boards' worth of retries against a single attempt.
|
||||
BATCH_SIZE = 10
|
||||
|
||||
@job("pull", "Reading every board", resource="http", solo=True)
|
||||
def run(config: Config, store: Store, *, context: RunContext = NULL) -> dict[str, Any]:
|
||||
log.info("pull: no plugin is installed yet")
|
||||
return {"sources": 0, "seen": 0, "new": 0}
|
||||
SETTLE = "roledesk.jobs.pull:close_boards"
|
||||
|
||||
|
||||
def _now() -> str:
|
||||
return datetime.now(UTC).isoformat(timespec="seconds")
|
||||
|
||||
|
||||
def _boards(config: Config, store: Store) -> list[dict[str, Any]]:
|
||||
"""Every fetchable `ats` subscription, ten to a batch. Stamps the run
|
||||
marker `close_boards` will look for, before any batch runs — finders run
|
||||
synchronously, in whoever starts the task, ahead of every job it queues."""
|
||||
subs = store.subscriptions(source="ats", fetchable=True)
|
||||
if not subs:
|
||||
return []
|
||||
store.state["ats:run"] = _now()
|
||||
return [{"targets": [s.target for s in subs[i:i + BATCH_SIZE]]}
|
||||
for i in range(0, len(subs), BATCH_SIZE)]
|
||||
|
||||
|
||||
@job("pull_batch", "Reading boards", resource="http")
|
||||
def run_batch(config: Config, store: Store, targets: list[str], *,
|
||||
context: RunContext = NULL) -> dict[str, Any]:
|
||||
"""Fetch this batch's boards and `upsert_role` every item they list.
|
||||
|
||||
Builds the `ats` plugin scoped to just these targets — `Source.targets()`
|
||||
reads `options[subscription_field]`, so handing it only this batch's
|
||||
entries is what keeps one job from re-fetching every other job's boards.
|
||||
"""
|
||||
from plugins.ats import ATSSource
|
||||
|
||||
subs = {s.target: s for s in store.subscriptions(source="ats") if s.target in targets}
|
||||
options = dict(config.sources.get("ats") or {})
|
||||
options["boards"] = [{"url": target, "label": subs[target].company or subs[target].label}
|
||||
for target in targets if target in subs]
|
||||
source = ATSSource(options)
|
||||
source.state = store.state
|
||||
|
||||
stored = 0
|
||||
for item in source.fetch():
|
||||
item.source = "ats"
|
||||
target = f"{item.raw.get('board', '')}:{item.raw.get('slug', '')}"
|
||||
store.upsert_role(item, subs.get(target))
|
||||
stored += 1
|
||||
return {"roles": stored}
|
||||
|
||||
|
||||
def close_boards(config: Config, store: Store, tally: Tally, *,
|
||||
context: RunContext = NULL) -> dict[str, Any]:
|
||||
"""The run's settle: close every board this run answered in full and
|
||||
stopped listing a role from, and tally what happened.
|
||||
|
||||
Reads `self.state` rather than the batch jobs' own results, because a
|
||||
`pull_batch` job that raised partway through still leaves the boards it
|
||||
had already parsed stamped — see the module docstring. A board whose
|
||||
`ats:ok:<target>` was not written during *this* run — it failed, or its
|
||||
whole batch job never got to it — is never closed.
|
||||
"""
|
||||
run_marker = store.state.get("ats:run", "")
|
||||
answered = failed = closed = 0
|
||||
for sub in store.subscriptions(source="ats", fetchable=True):
|
||||
stamp = store.state.get(f"ats:ok:{sub.target}", "")
|
||||
if stamp and stamp == run_marker:
|
||||
answered += 1
|
||||
seen_ids = json.loads(store.state.get(f"ats:ids:{sub.target}", "[]"))
|
||||
closed += store.mark_closed("ats", seen_ids, sub.id)
|
||||
else:
|
||||
failed += 1
|
||||
roles = sum(int(result.get("roles", 0)) for result in tally.results)
|
||||
return {"boards": answered, "failed": failed, "roles": roles, "closed": closed}
|
||||
|
||||
|
||||
def _pull_task() -> Task:
|
||||
return Task(kind="pull_batch", finder=_boards, name="pull",
|
||||
label="Reading every board", settle=SETTLE)
|
||||
|
||||
|
||||
#: Offered as `roledesk job pull` and to `<desk-jobs>`'s Pull button, the same
|
||||
#: way newsdesk's cascade stages register themselves in `TASKS`.
|
||||
TASKS["pull"] = _pull_task
|
||||
Reference in new issue
Block a user