vacancies-parser-kit 0.1.0__py3-none-any.whl

vacancies_parser_kit-0.1.0.dist-info/METADATA

@@ -0,0 +1,28 @@
+Metadata-Version: 2.4
+Name: vacancies-parser-kit
+Version: 0.1.0
+Summary: Multi-source vacancy parser with pluggable storage backends
+License: MIT
+Requires-Python: >=3.11
+Requires-Dist: click>=8.1
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: jinja2>=3.1
+Requires-Dist: rich>=13.0
+Provides-Extra: hh
+Requires-Dist: httpx>=0.27; extra == "hh"
+Provides-Extra: telegram
+Requires-Dist: telethon>=1.36; extra == "telegram"
+Provides-Extra: linkedin
+Requires-Dist: httpx>=0.27; extra == "linkedin"
+Provides-Extra: clickhouse
+Requires-Dist: clickhouse-connect>=0.7; extra == "clickhouse"
+Provides-Extra: postgres
+Requires-Dist: asyncpg>=0.29; extra == "postgres"
+Requires-Dist: psycopg[binary]>=3.1; extra == "postgres"
+Provides-Extra: all
+Requires-Dist: vpr[clickhouse,hh,linkedin,postgres,telegram]; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"

vacancies_parser_kit-0.1.0.dist-info/RECORD

@@ -0,0 +1,36 @@
+vpr/__init__.py,sha256=-8BZGB5_iPPXXECpGVGmU9uYVVlft3YVyeULLyn_gbQ,66
+vpr/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+vpr/cli/main.py,sha256=Oxruo2Lgez8aL8phbiqSK9u7-mxbTYW_0Puu0fMcwX8,438
+vpr/cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+vpr/cli/commands/init.py,sha256=df2mxEm7DvQVj95gVTH8r94gaXc9lmqNq2AxTMhMMnM,898
+vpr/cli/commands/list.py,sha256=rNgp6r0Y89FzBX14dM7FH2Oqv4-YvntrbknqXPn80oU,1648
+vpr/cli/commands/run.py,sha256=6axJ2LkOpsqSAylCn4OV4qvf8xy-0shLJ7cAt_vm0kw,3424
+vpr/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+vpr/config/profile.py,sha256=YdTQ7-oSX_zaA6M-FvrFY_YkXA_qLUKUTUeE_3FxTyg,1299
+vpr/config/project.py,sha256=zaNcWI8IQun1SDEpbsICSFcTLIo3WkNUHmgwsw-vze0,1130
+vpr/config/source_config.py,sha256=yh2kxSXLKRB6hPlrWe9mKRncsq5D3HKhBsvtWm-iDdg,1278
+vpr/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+vpr/core/models.py,sha256=g8y32wqDOwDM9VEKEKs4cgUzFFie_MYB0MavM7kHmd0,1663
+vpr/core/pipeline.py,sha256=Kfb6ruXIGCpb-75kyUrqXjqMx8ow8CuDspz_8Uf5Gz8,1990
+vpr/core/selector.py,sha256=qeH45-y08eR2q0aoDSUeAF2A-j9GksScxnKYAczL5xc,1068
+vpr/sources/__init__.py,sha256=JIbkAFKHpwgVTiTgN8uC7JPAUUilVDNSkl952Kf4UEg,119
+vpr/sources/base.py,sha256=A7gqRKYTBoMgFvVBqRqpWRKVN1zM2rAsSO_A7N-nGAU,802
+vpr/sources/headhunter.py,sha256=cRip32dXf3qVKe3aqbG1kFj9CqWiQL5LovjzMMnTguA,9606
+vpr/sources/hh_dictionaries.py,sha256=wrCPGM8aA9IpOtjCTV1u9PHSKjDRRhciiVzHp3qvHdM,2405
+vpr/sources/registry.py,sha256=oKusJkHrSlgT5aym9eDcbHv9W9q65HcR55ZWuljxZE0,757
+vpr/templates/__init__.py,sha256=HoBzfwDVFdQ3x3cBTBsWjmC3-vfV2aN92rAGklgICnU,98
+vpr/templates/scaffold.py,sha256=Z2vyN9s5Nv0NaIHxj9sRIQpwnySYww7jEB7r7hNfyHA,2856
+vpr/transforms/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+vpr/transforms/normalize.py,sha256=licHq8Hb74Pyt0Je2HAg4qnM_4yw2b59jFr0zyC5rts,519
+vpr/writers/__init__.py,sha256=GxHSSrh1OUAJ5NMpSCOTWC-ldSHAYv0LWvlUy42xFXA,398
+vpr/writers/base.py,sha256=PtdQzlYvOc49NoiGPUP8jecvcYit_zUR9wQQRgGtOCs,743
+vpr/writers/clickhouse.py,sha256=E8gJhC7OiSvUcs40XuOyDSN-g5krhoeqRj6PCGG89Rc,3471
+vpr/writers/jsonl.py,sha256=F6G3Lb94juXXqOOenxoxYLX7EohNiIoqTn_-7noAjQ4,821
+vpr/writers/postgres.py,sha256=WscPr5d4uINUVvfAxfxETfpVcB3iO1Ymxbb3GHBLRgk,4132
+vpr/writers/registry.py,sha256=T0MtCNvgsyxryIiIqFbcfOLskM_hoiIseD2l1jGWAS4,757
+vpr/writers/sqlite.py,sha256=rwxVvAX6iF75v3L7XadrPaYvHCFboiENJD23JE6VmfE,3673
+vacancies_parser_kit-0.1.0.dist-info/METADATA,sha256=WtYAcSdMfbYnNDHBhzcIPelW_WZ7-REYk9ilcjKs7i8,989
+vacancies_parser_kit-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+vacancies_parser_kit-0.1.0.dist-info/entry_points.txt,sha256=egwVIIn97VkYCJ9ZgKTyk_8nIeuTCQe-tSEIKywo1Y8,41
+vacancies_parser_kit-0.1.0.dist-info/top_level.txt,sha256=YtP4jygNOfY9lRC2fgxBLU-n1WVbODLp75tLRznx_0M,4
+vacancies_parser_kit-0.1.0.dist-info/RECORD,,

vacancies_parser_kit-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

vacancies_parser_kit-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+vpr = vpr.cli.main:cli

vacancies_parser_kit-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+vpr

vpr/__init__.py

@@ -0,0 +1,3 @@
+"""vpr — multi-source vacancy parser."""
+
+__version__ = "0.1.0"

vpr/cli/commands/init.py

@@ -0,0 +1,29 @@
+"""vpr init — scaffold a new project."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import click
+from rich.console import Console
+
+from vpr.templates import render_project_scaffold
+
+console = Console()
+
+
+@click.command("init")
+@click.argument("project_name")
+def init_cmd(project_name: str) -> None:
+    """Create a new vpr project."""
+    target = Path.cwd() / project_name
+    if target.exists():
+        raise click.ClickException(f"Directory '{project_name}' already exists")
+
+    render_project_scaffold(target, project_name)
+    console.print(f"[green]Project '{project_name}' created at {target}[/green]")
+    console.print("Next steps:")
+    console.print(f"  cd {project_name}")
+    console.print("  # edit profiles.yml with your database credentials")
+    console.print("  # add source definitions to sources/")
+    console.print("  vpr run --select <source_name>")

vpr/cli/commands/list.py

@@ -0,0 +1,59 @@
+"""vpr list — show all configured sources."""
+
+from __future__ import annotations
+
+import click
+from rich.console import Console
+from rich.table import Table
+
+from vpr.config.project import find_project_root, load_project_config
+from vpr.config.source_config import load_source_configs
+
+console = Console()
+
+
+@click.command("list")
+@click.option("--tags", is_flag=True, help="Group sources by tag")
+def list_cmd(tags: bool) -> None:
+    """List all configured sources."""
+    project_root = find_project_root()
+    project_cfg = load_project_config(project_root)
+    sources = load_source_configs(project_root / project_cfg.paths.sources)
+
+    if not sources:
+        console.print("[yellow]No sources found.[/yellow]")
+        return
+
+    if tags:
+        _print_by_tags(sources)
+    else:
+        _print_table(sources)
+
+
+def _print_table(sources) -> None:
+    table = Table(title="Sources")
+    table.add_column("Name", style="cyan")
+    table.add_column("Type", style="green")
+    table.add_column("Tags")
+    table.add_column("Targets")
+
+    for src in sorted(sources, key=lambda s: s.name):
+        table.add_row(
+            src.name,
+            src.type,
+            ", ".join(src.tags),
+            ", ".join(src.targets) if src.targets else "—",
+        )
+    console.print(table)
+
+
+def _print_by_tags(sources) -> None:
+    tag_map: dict[str, list[str]] = {}
+    for src in sources:
+        for tag in src.tags:
+            tag_map.setdefault(tag, []).append(src.name)
+
+    for tag in sorted(tag_map):
+        console.print(f"[bold]tag:{tag}[/bold]")
+        for name in sorted(tag_map[tag]):
+            console.print(f"  - {name}")

vpr/cli/commands/run.py

@@ -0,0 +1,92 @@
+"""vpr run — fetch, transform, and write vacancies."""
+
+from __future__ import annotations
+
+import asyncio
+from typing import TYPE_CHECKING
+
+import click
+from rich.console import Console
+
+from vpr.config.project import find_project_root, load_project_config
+from vpr.config.profile import load_profiles
+from vpr.config.source_config import load_source_configs
+from vpr.core.selector import select_sources
+
+if TYPE_CHECKING:
+    pass
+
+console = Console()
+
+VALID_STEPS = ("fetch", "transform", "write")
+
+
+@click.command("run")
+@click.option("--select", "selector", required=True, help="Source selector: name, glob pattern, or tag:<tag>")
+@click.option("--exclude", "excludes", multiple=True, help="Exclude sources by name")
+@click.option("--steps", default=None, help=f"Comma-separated pipeline steps: {', '.join(VALID_STEPS)}")
+@click.option("--profile", default=None, help="Override default profile from vpr_project.yml")
+@click.option("--full-refresh", is_flag=True, help="Drop existing data and re-fetch from scratch")
+def run_cmd(
+    selector: str,
+    excludes: tuple[str, ...],
+    steps: str | None,
+    profile: str | None,
+    full_refresh: bool,
+) -> None:
+    """Run the vacancy pipeline for selected sources."""
+    active_steps = _parse_steps(steps)
+
+    project_root = find_project_root()
+    project_cfg = load_project_config(project_root)
+    profiles_cfg = load_profiles(project_root)
+    all_sources = load_source_configs(project_root / project_cfg.paths.sources)
+
+    if not all_sources:
+        raise click.ClickException(f"No source configs found in {project_cfg.paths.sources}/")
+
+    matched = select_sources(all_sources, selector, excludes=set(excludes))
+    if not matched:
+        raise click.ClickException(f"No sources matched selector '{selector}'")
+
+    profile_name = profile or project_cfg.default_profile
+    if profile_name not in profiles_cfg.profiles:
+        raise click.ClickException(f"Profile '{profile_name}' not found in profiles.yml")
+
+    console.print(f"[bold]Profile:[/bold] {profile_name}")
+    console.print(f"[bold]Steps:[/bold]  {', '.join(active_steps)}")
+    console.print(f"[bold]Sources ({len(matched)}):[/bold]")
+    for src in matched:
+        console.print(f"  - {src.name} [dim]({src.type})[/dim]")
+    console.print()
+
+    asyncio.run(_run_pipeline(matched, profiles_cfg, profile_name, active_steps, full_refresh))
+
+
+async def _run_pipeline(sources, profiles_cfg, profile_name, steps, full_refresh):
+    """Execute the pipeline for each matched source."""
+    from vpr.core.pipeline import run_source_pipeline
+
+    profile = profiles_cfg.profiles[profile_name]
+    for src_cfg in sources:
+        console.print(f"[bold cyan]>>> {src_cfg.name}[/bold cyan]")
+        try:
+            await run_source_pipeline(
+                source_config=src_cfg,
+                profile=profile,
+                steps=steps,
+                full_refresh=full_refresh,
+            )
+            console.print(f"[green]  ✓ {src_cfg.name} done[/green]")
+        except Exception as exc:
+            console.print(f"[red]  ✗ {src_cfg.name} failed: {exc}[/red]")
+
+
+def _parse_steps(raw: str | None) -> list[str]:
+    if raw is None:
+        return list(VALID_STEPS)
+    parts = [s.strip() for s in raw.split(",")]
+    for s in parts:
+        if s not in VALID_STEPS:
+            raise click.ClickException(f"Unknown step '{s}'. Valid: {', '.join(VALID_STEPS)}")
+    return parts

vpr/cli/main.py

@@ -0,0 +1,19 @@
+"""CLI entry point for vpr."""
+
+import click
+
+from vpr import __version__
+from vpr.cli.commands.init import init_cmd
+from vpr.cli.commands.list import list_cmd
+from vpr.cli.commands.run import run_cmd
+
+
+@click.group()
+@click.version_option(version=__version__, prog_name="vpr")
+def cli():
+    """vpr — multi-source vacancy parser."""
+
+
+cli.add_command(init_cmd, "init")
+cli.add_command(run_cmd, "run")
+cli.add_command(list_cmd, "list")

vpr/config/profile.py

@@ -0,0 +1,50 @@
+"""Profiles configuration (profiles.yml)."""
+
+from __future__ import annotations
+
+import os
+import re
+from pathlib import Path
+from typing import Any
+
+import yaml
+from pydantic import BaseModel
+
+_ENV_VAR_RE = re.compile(r"\{\{\s*env_var\(['\"](\w+)['\"]\)\s*\}\}")
+
+
+class TargetConfig(BaseModel):
+    type: str
+    params: dict[str, Any] = {}
+
+    model_config = {"extra": "allow"}
+
+
+class ProfileConfig(BaseModel):
+    targets: dict[str, TargetConfig]
+
+
+class ProfilesConfig(BaseModel):
+    default_profile: str = "dev"
+    profiles: dict[str, ProfileConfig]
+
+
+def _resolve_env_vars(obj: Any) -> Any:
+    """Recursively resolve {{ env_var('NAME') }} placeholders."""
+    if isinstance(obj, str):
+        return _ENV_VAR_RE.sub(lambda m: os.environ.get(m.group(1), ""), obj)
+    if isinstance(obj, dict):
+        return {k: _resolve_env_vars(v) for k, v in obj.items()}
+    if isinstance(obj, list):
+        return [_resolve_env_vars(v) for v in obj]
+    return obj
+
+
+def load_profiles(project_root: Path) -> ProfilesConfig:
+    path = project_root / "profiles.yml"
+    if not path.is_file():
+        raise FileNotFoundError(f"profiles.yml not found in {project_root}")
+    with open(path) as f:
+        data = yaml.safe_load(f)
+    data = _resolve_env_vars(data)
+    return ProfilesConfig(**data)

vpr/config/project.py

@@ -0,0 +1,41 @@
+"""Project-level configuration (vpr_project.yml)."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import yaml
+from pydantic import BaseModel, Field
+
+PROJECT_FILE = "vpr_project.yml"
+
+
+class ProjectPaths(BaseModel):
+    sources: str = "sources"
+    dictionaries: str = "dictionaries"
+
+
+class ProjectConfig(BaseModel):
+    name: str
+    version: str = "1.0"
+    default_profile: str = "dev"
+    paths: ProjectPaths = Field(default_factory=ProjectPaths)
+
+
+def find_project_root(start: Path | None = None) -> Path:
+    """Walk up from *start* (default cwd) until vpr_project.yml is found."""
+    current = (start or Path.cwd()).resolve()
+    for directory in (current, *current.parents):
+        if (directory / PROJECT_FILE).is_file():
+            return directory
+    raise FileNotFoundError(
+        f"Could not find {PROJECT_FILE}. "
+        "Are you inside a vpr project? Run 'vpr init <name>' to create one."
+    )
+
+
+def load_project_config(project_root: Path) -> ProjectConfig:
+    path = project_root / PROJECT_FILE
+    with open(path) as f:
+        data = yaml.safe_load(f)
+    return ProjectConfig(**data)

vpr/config/source_config.py

@@ -0,0 +1,46 @@
+"""Source instance configuration (sources/*.yml)."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any
+
+import yaml
+from pydantic import BaseModel, Field
+
+
+class SourceConfig(BaseModel):
+    """A single source instance loaded from YAML."""
+
+    name: str
+    type: str
+    tags: list[str] = Field(default_factory=list)
+    profile: str | None = None
+    params: dict[str, Any] = Field(default_factory=dict)
+    targets: list[str] = Field(default_factory=list)
+    enabled: bool = True
+
+    # metadata — filled at load time
+    config_path: Path | None = Field(default=None, exclude=True)
+
+
+def load_source_config(path: Path) -> SourceConfig:
+    with open(path) as f:
+        data = yaml.safe_load(f)
+    if not data:
+        raise ValueError(f"Empty source config: {path}")
+    cfg = SourceConfig(**data)
+    cfg.config_path = path
+    return cfg
+
+
+def load_source_configs(sources_dir: Path) -> list[SourceConfig]:
+    """Load all *.yml files from *sources_dir* recursively."""
+    if not sources_dir.is_dir():
+        return []
+    configs: list[SourceConfig] = []
+    for yml_path in sorted(sources_dir.rglob("*.yml")):
+        cfg = load_source_config(yml_path)
+        if cfg.enabled:
+            configs.append(cfg)
+    return configs

vpr/core/models.py

@@ -0,0 +1,66 @@
+"""Canonical vacancy model — unified schema all sources map into."""
+
+from __future__ import annotations
+
+from datetime import UTC, datetime
+from enum import Enum
+from typing import Any
+
+from pydantic import BaseModel, Field
+
+
+class VacancyStatus(str, Enum):
+    CREATED = "created"
+    UPDATED = "updated"
+    DELETED = "deleted"
+
+
+class Salary(BaseModel):
+    min: float | None = None
+    max: float | None = None
+    currency: str | None = None
+    gross: bool | None = None
+
+
+class Vacancy(BaseModel):
+    """Canonical vacancy record.
+
+    Composite identity: (source, source_id).
+    All fields except source/source_id are nullable — sources may provide
+    incomplete data and that's OK.
+    """
+
+    # --- identity ---
+    source: str
+    source_id: str
+
+    # --- core ---
+    title: str | None = None
+    company: str | None = None
+    description: str | None = None
+    url: str | None = None
+
+    # --- location ---
+    city: str | None = None
+    region: str | None = None
+    country: str | None = None
+    is_remote: bool | None = None
+
+    # --- compensation ---
+    salary: Salary | None = None
+
+    # --- classification ---
+    experience: str | None = None
+    employment_type: str | None = None  # full-time, part-time, contract …
+    schedule: str | None = None  # remote, office, hybrid …
+    skills: list[str] = Field(default_factory=list)
+
+    # --- timestamps ---
+    published_at: datetime | None = None
+    fetched_at: datetime = Field(default_factory=lambda: datetime.now(UTC))
+
+    # --- lifecycle ---
+    status: VacancyStatus = VacancyStatus.CREATED
+
+    # --- extra ---
+    raw: dict[str, Any] = Field(default_factory=dict)

vpr/core/pipeline.py

@@ -0,0 +1,59 @@
+"""Pipeline: fetch → transform → write."""
+
+from __future__ import annotations
+
+from rich.console import Console
+
+from vpr.config.profile import ProfileConfig
+from vpr.config.source_config import SourceConfig
+from vpr.core.models import Vacancy
+from vpr.sources.registry import get_source_class
+from vpr.writers.registry import get_writer_class
+
+console = Console()
+
+
+async def run_source_pipeline(
+    *,
+    source_config: SourceConfig,
+    profile: ProfileConfig,
+    steps: list[str],
+    full_refresh: bool = False,
+) -> None:
+    """Execute fetch → transform → write for a single source."""
+    vacancies: list[Vacancy] = []
+
+    # --- FETCH ---
+    if "fetch" in steps:
+        console.print("  [dim]fetching…[/dim]")
+        source_cls = get_source_class(source_config.type)
+        source = source_cls(source_config)
+        async for vacancy in source.fetch():
+            vacancies.append(vacancy)
+        console.print(f"  [dim]fetched {len(vacancies)} vacancies[/dim]")
+
+    # --- TRANSFORM ---
+    if "transform" in steps and vacancies:
+        console.print("  [dim]transforming…[/dim]")
+        from vpr.transforms.normalize import normalize
+
+        vacancies = [normalize(v) for v in vacancies]
+
+    # --- WRITE ---
+    if "write" in steps and vacancies:
+        targets = source_config.targets
+        if not targets:
+            targets = list(profile.targets.keys())
+
+        for target_name in targets:
+            if target_name not in profile.targets:
+                console.print(f"  [yellow]target '{target_name}' not found in profile, skipping[/yellow]")
+                continue
+            target_cfg = profile.targets[target_name]
+            writer_cls = get_writer_class(target_cfg.type)
+            writer = writer_cls(target_cfg)
+            try:
+                count = await writer.write(vacancies)
+                console.print(f"  [dim]wrote {count} rows → {target_name}[/dim]")
+            finally:
+                await writer.close()

vpr/core/selector.py

@@ -0,0 +1,35 @@
+"""Source selector: resolve --select / --exclude to a list of SourceConfig."""
+
+from __future__ import annotations
+
+from fnmatch import fnmatch
+
+from vpr.config.source_config import SourceConfig
+
+TAG_PREFIX = "tag:"
+
+
+def select_sources(
+    all_sources: list[SourceConfig],
+    selector: str,
+    *,
+    excludes: set[str] | None = None,
+) -> list[SourceConfig]:
+    """Return sources matching *selector*, minus *excludes*.
+
+    Selector forms:
+      - ``tag:<tag>``       — all sources with given tag
+      - ``name_with_*``     — glob match on source name
+      - ``exact_name``      — exact match on source name
+    """
+    excludes = excludes or set()
+
+    if selector.startswith(TAG_PREFIX):
+        tag = selector[len(TAG_PREFIX) :]
+        matched = [s for s in all_sources if tag in s.tags]
+    elif any(ch in selector for ch in ("*", "?", "[")):
+        matched = [s for s in all_sources if fnmatch(s.name, selector)]
+    else:
+        matched = [s for s in all_sources if s.name == selector]
+
+    return [s for s in matched if s.name not in excludes]

vpr/sources/__init__.py

@@ -0,0 +1,3 @@
+"""Source plugins — import here so @register_source decorators fire."""
+
+import vpr.sources.headhunter  # noqa: F401

vpr/sources/base.py

@@ -0,0 +1,28 @@
+"""Base class for vacancy sources."""
+
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+from typing import AsyncIterator
+
+from vpr.config.source_config import SourceConfig
+from vpr.core.models import Vacancy
+
+
+class BaseSource(ABC):
+    """Every source plugin extends this class.
+
+    A source receives its YAML-defined ``params`` and yields raw Vacancy
+    objects (with at least ``source`` and ``source_id`` filled).
+    """
+
+    source_type: str  # must match the ``type`` field in source YAML
+
+    def __init__(self, config: SourceConfig) -> None:
+        self.config = config
+        self.params = config.params
+
+    @abstractmethod
+    async def fetch(self) -> AsyncIterator[Vacancy]:
+        """Yield vacancies from the external source."""
+        ...  # pragma: no cover