Files
jobboard/plugins/readers/teamtailor.py
T
WolfandClaude Opus 5.5 c497fe965d Keep a description's headings, bullets and paragraphs, and draw them in the reader
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>
2026-09-30 21:40:12 +02:00

142 lines
5.8 KiB
Python

"""Teamtailor: `teamtailor:<subdomain>` for acme.teamtailor.com, or, for a
career site on the company's own domain, that whole host name:
`teamtailor:careers.acme.com`. An RSS feed paged by offset that states no
total.
Written from live feeds on 2026-09-29; jobhunt-hq did not read Teamtailor.
"""
from __future__ import annotations
import re
import xml.etree.ElementTree as ET
from collections.abc import Callable
from typing import Any
from ._contract import Ask, Fields, Place, Reads
from ._shared import Get, Page, Row, add_place, html_text, is_web_url, only, parse_dt
NAME = "teamtailor"
LABEL = "Teamtailor"
RANK = 80
PATTERNS = (
r"https?://([a-z0-9-]+)\.teamtailor\.com",
# No slug: a career site on the company's own domain, which only loads
# Teamtailor's CDN. Discovery reads its board off the page's host.
r"cdn\.teamtailor\.com|teamtailor-cdn|teamtailor\.com/assets",
)
READS = Reads(
scope="board", listing="paged", page_size=50, text="listing", complete="end",
places="many", fields=Fields(posted="trusted", remote="stated"),
robots=("read: a career site's robots.txt disallows /app/, /messages/, /messenger/, "
"/facebook/tab/ and /jobs/internal/, so /jobs.rss is allowed (lunar, which "
"redirects to jobs.lunar.app, and careers.trackunit.com, checked 2026-09-30)"),
)
#: The page size, asked for as `per_page`. A feed with neither parameter
#: answers with every role (73 of 73 at Shine, 2026-09-29), but says nowhere
#: that it is the whole list, so this reads by page to an empty one;
#: `per_page=200` was answered in full too, and the cursor advances by what a
#: page returned, so a smaller cap on the host's side would not skip a role.
PAGE_SIZE = 50
#: Only a DNS name with a letter in its last label is a site, so an address
#: (`127.0.0.1`, `[::1]`) or a single word never names a host the fetch could
#: be pointed at; `ats._get` still refuses every host but this one, redirects
#: included.
_HOST = re.compile(r"[a-z0-9-]+(\.[a-z0-9-]+)*")
#: Teamtailor's own namespace in the feed, the `tt:` of `tt:locations`.
_TT = "{https://teamtailor.com/locations}"
def site(slug: str) -> str:
"""The host a career site is served from: `acme` is acme.teamtailor.com,
and a slug with a dot is a site on the company's own domain,
`careers.acme.com`, taken whole (the feed path is the same on both)."""
slug = slug.strip().lower()
return slug if "." in slug else f"{slug}.teamtailor.com"
def slug_ok(slug: str) -> bool:
host = site(slug)
return bool(slug) and slug == slug.strip() and bool(_HOST.fullmatch(host)) \
and not host.rsplit(".", 1)[-1].isdigit()
def allowed(slug: str) -> Callable[[str], bool]:
return only(site(slug))
def careers_url(slug: str) -> str:
return f"https://{site(slug)}/jobs"
def probe_url(slug: str) -> str:
return f"https://{site(slug)}/jobs.rss"
def probe_ok(body: bytes) -> bool:
return b"<item>" in body
def page(get: Get, slug: str, cursor: Any, ask: Ask = Ask()) -> Page:
offset = int(cursor or 0)
items = _items(get(f"https://{site(slug)}/jobs.rss?per_page={PAGE_SIZE}&offset={offset}"))
results = [{"id": item.findtext("guid") or item.findtext("link") or ""} for item in items]
return items, results, None, offset + len(items) if items else None
def parse(body: bytes, slug: str) -> list[Row]:
return rows(_items(body), slug)
def _items(body: bytes) -> list[ET.Element]:
"""`{site}/jobs.rss` -> `<rss><channel><item>...`, the feed every Teamtailor
career site serves (checked live on a dozen sites, 2026-09-29). A missing
`channel` is a page that is not a feed, and raises."""
channel = ET.fromstring(body).find("channel")
if channel is None:
raise ValueError("not a Teamtailor feed: no channel")
return channel.findall("item")
def rows(items: list[ET.Element], slug: str) -> list[Row]:
"""One page of items. The item has the title, the job URL (on the site's
own domain), a `guid` uuid, `pubDate`, the HTML `description` in full,
`remoteStatus` (fully, hybrid, onsite, none or temporary), and, in the
`tt:` namespace, `locations` (a list: `city` and `country` each, `name` free
text), `department` and `role`, either of which may be empty. `places` keeps
the distinct locations, and `location` joins them with "; ". A place is
remote or an office as far as the role's `remoteStatus` says. No pay is
stated anywhere in the feed."""
out = []
for item in items:
title = (item.findtext("title") or "").strip()
url = (item.findtext("link") or "").strip()
if not title or not is_web_url(url):
continue
status = (item.findtext("remoteStatus") or "").strip()
remote = {"fully": True, "hybrid": False, "onsite": False}.get(status)
places: list[Place] = []
for loc in item.findall(f"{_TT}locations/{_TT}location"):
city = (loc.findtext(f"{_TT}city") or loc.findtext(f"{_TT}name") or "").strip()
country = (loc.findtext(f"{_TT}country") or "").strip()
text = city if country == city else ", ".join(p for p in (city, country) if p)
add_place(places, {"text": text, "remote": remote})
out.append({
"source_id": (item.findtext("guid") or url).strip(),
"title": title,
"places": places,
"location": "; ".join(p["text"] for p in places),
"url": url,
"posted": parse_dt(item.findtext("pubDate")),
"department": ((item.findtext(f"{_TT}department") or "").strip()
or (item.findtext(f"{_TT}role") or "").strip()),
"description": html_text(item.findtext("description")),
"remote": status or None,
"salary_text": "", # Teamtailor's feed states no pay at all
})
return out