The readers flattened a posting's HTML into one line with strip_html, so sections and bullets ran together. _shared.html_text gives a line per paragraph, '• ' before a list item and '## ' before a heading; every reader's description goes through it, sections read per role get their own headings, and the reader pane draws the lines as h3, ul and p. Excerpts leave the marks out. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
139 lines
5.2 KiB
Python
139 lines
5.2 KiB
Python
"""Personio: `personio:<subdomain>`, the whole board in one XML answer from
|
|
the company's own subdomain of jobs.personio.de.
|
|
|
|
Written from one real board on 2026-09-23; jobhunt-hq did not read
|
|
Personio.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import xml.etree.ElementTree as ET
|
|
from collections.abc import Callable
|
|
|
|
|
|
from ._contract import Ask, Fields, Place, Reads
|
|
from ._shared import Row, add_place, html_text, label_slug_ok, num, only, parse_dt, pay_line, place, yearly_amount
|
|
|
|
NAME = "personio"
|
|
LABEL = "Personio"
|
|
RANK = 70
|
|
PATTERNS = (r"https?://([a-z0-9-]+)\.jobs\.personio\.(?:de|com)",)
|
|
|
|
READS = Reads(
|
|
scope="board", listing="whole", text="listing", complete="whole",
|
|
places="many",
|
|
fields=Fields(pay="figures", posted="trusted", seniority="stated", employment="stated"),
|
|
robots=("read: /xml on <slug>.jobs.personio.de, whose /robots.txt answers 404, so "
|
|
"nothing is disallowed (penneo, checked 2026-09-30)"),
|
|
)
|
|
|
|
#: Personio's `salaryInformation/type` spellings, to the plain period word
|
|
#: `pay_line` wants ("yearly" -> "year"). Anything else is passed through.
|
|
_PERIODS = {"yearly": "year", "monthly": "month", "hourly": "hour",
|
|
"daily": "day", "weekly": "week"}
|
|
|
|
|
|
def slug_ok(slug: str) -> bool:
|
|
return label_slug_ok(slug)
|
|
|
|
|
|
def allowed(slug: str) -> Callable[[str], bool]:
|
|
"""The company's own subdomain, so one company's slug cannot pass for
|
|
another's."""
|
|
return only(f"{slug}.jobs.personio.de")
|
|
|
|
|
|
def careers_url(slug: str) -> str:
|
|
return f"https://{slug}.jobs.personio.de"
|
|
|
|
|
|
def feed_url(slug: str, ask: Ask = Ask()) -> str:
|
|
return f"https://{slug}.jobs.personio.de/xml"
|
|
|
|
|
|
def probe_url(slug: str) -> str:
|
|
return feed_url(slug)
|
|
|
|
|
|
def probe_ok(body: bytes) -> bool:
|
|
return b"<position>" in body
|
|
|
|
|
|
def _salary_text(salary_info: ET.Element) -> str:
|
|
"""One line from a `<salaryInformation>` element, whatever its `type`,
|
|
including an hourly or daily one that `yearly_amount` drops from the
|
|
columns."""
|
|
period_raw = (salary_info.findtext("type") or "").strip().lower()
|
|
period = _PERIODS.get(period_raw, period_raw)
|
|
return pay_line(num(salary_info.findtext("min")), num(salary_info.findtext("max")),
|
|
salary_info.findtext("currencyCode"), period)
|
|
|
|
|
|
def _employment(position: ET.Element) -> str | None:
|
|
"""The host's word for the contract, or, for a `permanent` one (which says
|
|
nothing about the hours), the `schedule`."""
|
|
contract = (position.findtext("employmentType") or "").strip()
|
|
schedule = (position.findtext("schedule") or "").strip()
|
|
if contract.lower() in ("", "permanent") and schedule:
|
|
return schedule
|
|
return contract or None
|
|
|
|
|
|
def _places(position: ET.Element) -> list[Place]:
|
|
"""The `office` and every `additionalOffices/office`, each once. The feed
|
|
has no remote flag; an office named "Remote" or "Berlin (Remote)" is
|
|
remote, any other says nothing."""
|
|
found: list[Place] = []
|
|
names = [position.findtext("office"),
|
|
*(o.text for o in position.findall("additionalOffices/office"))]
|
|
for name in names:
|
|
text = (name or "").strip()
|
|
add_place(found, place(text))
|
|
return found
|
|
|
|
|
|
def parse(body: bytes, slug: str) -> list[Row]:
|
|
"""`{slug}.jobs.personio.de/xml` -> `<workzag-jobs><position>...`. No job
|
|
URL in the feed itself; Personio's own page is `/job/{id}`, confirmed
|
|
live against a real posting (2026-09-23). `additionalOffices` lists the
|
|
other places of a role (116 of 320 at the three boards read); `seniority`
|
|
is one of entry-level, experienced, executive, student, and `schedule` and
|
|
`employmentType` state the hours and the contract."""
|
|
root = ET.fromstring(body)
|
|
rows = []
|
|
for position in root.findall("position"):
|
|
job_id = (position.findtext("id") or "").strip()
|
|
title = (position.findtext("name") or "").strip()
|
|
if not job_id or not title:
|
|
continue
|
|
description = " ".join(
|
|
(value.text or "") for value in position.findall("jobDescriptions/jobDescription/value"))
|
|
salary_info = position.find("salaryInformation")
|
|
salary_min = salary_max = None
|
|
currency = ""
|
|
salary_text = ""
|
|
if salary_info is not None:
|
|
salary_min, salary_max, currency = yearly_amount(
|
|
salary_info.findtext("min"), salary_info.findtext("max"),
|
|
salary_info.findtext("currencyCode"), salary_info.findtext("type"),
|
|
{"yearly": 1, "monthly": 12})
|
|
salary_text = _salary_text(salary_info)
|
|
places = _places(position)
|
|
rows.append({
|
|
"source_id": job_id,
|
|
"title": title,
|
|
"places": places,
|
|
"location": "; ".join(p["text"] for p in places),
|
|
"url": f"https://{slug}.jobs.personio.de/job/{job_id}",
|
|
"posted": parse_dt(position.findtext("createdAt")),
|
|
"department": (position.findtext("department") or "").strip(),
|
|
"description": html_text(description),
|
|
"seniority": (position.findtext("seniority") or "").strip() or None,
|
|
"employment": _employment(position),
|
|
"salary_text": salary_text,
|
|
"salary_min": salary_min,
|
|
"salary_max": salary_max,
|
|
"currency": currency,
|
|
})
|
|
return rows
|