cv-renderer 0.1.0__py3-none-any.whl

cv_renderer/__main__.py

@@ -0,0 +1,5 @@
+"""Allow `python -m cv_renderer` — the invocation external callers rely on."""
+
+from cv_renderer.render import main
+
+main()

cv_renderer/examples/data/base_en.yaml

@@ -0,0 +1,98 @@
+meta:
+  name: Your Name
+  title:
+    default: Software Engineer
+    ai: AI Engineer
+    data: Data Engineer
+  location: City, Country
+  email: you@example.com
+  phone: "+1 555 000 0000"
+  links:
+    linkedin: linkedin.com/in/yourprofile
+    github: github.com/yourusername
+    portfolio: yourportfolio.com
+
+about:
+  default: |
+    Brief professional summary describing your background and focus.
+  ai: |
+    AI-focused variant of your summary.
+  data: |
+    Data-focused variant of your summary.
+
+experience:
+  - company: Company Name
+    title:
+      default: Software Engineer
+      ai: AI Engineer
+      data: Data Engineer
+    location: City
+    start: "2024"
+    end: present
+    tags: [ai, data, backend]
+    description: "Short description of the team or product."
+    bullets:
+      - text: "Accomplishment with measurable impact."
+        tags: [ai, backend]
+      - text: "Another accomplishment."
+        tags: [data]
+
+  - company: Previous Company
+    title:
+      default: Intern
+      ai: Intern
+      data: Intern
+    location: City
+    start: 2023-06
+    end: 2023-09
+    tags: [ml]
+    bullets:
+      - text: "What you did and why it mattered."
+        tags: [ml]
+
+education:
+  - institution: University Name
+    degree: "Bachelor's Degree, Computer Science"
+    location: Country
+    start: 2020
+    end: 2024
+    tags: [always]
+
+skills:
+  - category: Backend and API
+    tags: [backend, always]
+    items: "Python, FastAPI, ..."
+  - category: Data Engineering
+    tags: [data]
+    items: "PostgreSQL, dbt Core, ..."
+  - category: AI and LLM Systems
+    tags: [ai, llm]
+    # items can also be a list of {text, tags} to filter within a category,
+    # not just across categories — useful when a category mixes core tools
+    # (keep for every profile) with niche ones (only relevant to some jobs).
+    items:
+      - text: LangChain
+        tags: [ai]
+      - text: LangGraph
+        tags: [ai]
+  - category: ML and Evaluation
+    tags: [ml, ai]
+    items: "PyTorch, scikit-learn, ..."
+  - category: Infra and DevOps
+    tags: [devops, backend]
+    items: "Docker, CI/CD, ..."
+
+projects:
+  - name: Project Name
+    subtitle: Open Source, GitHub
+    year: 2024
+    tags: [ai, backend]
+    bullets:
+      - text: "What you built and why it matters."
+        tags: [ai, backend]
+
+additional:
+  languages:
+    - English (Native)
+  certifications:
+    - "Your Certification, Issuer"

cv_renderer/examples/data/base_tr.yaml

@@ -0,0 +1,92 @@
+meta:
+  name: Adınız Soyadınız
+  title:
+    default: Yazılım Mühendisi
+    ai: Yapay Zeka Mühendisi
+    data: Veri Mühendisi
+  location: Şehir, Türkiye
+  email: siz@ornek.com
+  phone: "+90 5XX XXX XX XX"
+  links:
+    linkedin: linkedin.com/in/profiliniz
+    github: github.com/kullaniciadi
+    portfolio: portfolyonuz.com
+
+about:
+  default: |
+    Genel profesyonel özetiniz.
+  ai: |
+    Yapay zeka odaklı özetiniz.
+  data: |
+    Veri odaklı özetiniz.
+
+experience:
+  - company: Şirket Adı
+    title:
+      default: Yazılım Mühendisi
+      ai: Yapay Zeka Mühendisi
+      data: Veri Mühendisi
+    location: Şehir
+    start: "2024"
+    end: present
+    tags: [ai, data, backend]
+    description: "Ekip veya ürün kısa açıklaması."
+    bullets:
+      - text: "Ölçülebilir etkiyle bir başarı."
+        tags: [ai, backend]
+      - text: "Başka bir başarı."
+        tags: [data]
+
+  - company: Önceki Şirket
+    title:
+      default: Stajyer
+      ai: Stajyer
+      data: Stajyer
+    location: Şehir
+    start: 2023-06
+    end: 2023-09
+    tags: [ml]
+    bullets:
+      - text: "Ne yaptınız ve neden önemliydi."
+        tags: [ml]
+
+education:
+  - institution: Üniversite Adı
+    degree: "Lisans, Bilgisayar Mühendisliği"
+    location: Türkiye
+    start: 2020
+    end: 2024
+    tags: [always]
+
+skills:
+  - category: Backend ve API
+    tags: [backend, always]
+    items: "Python, FastAPI, ..."
+  - category: Veri Mühendisliği
+    tags: [data]
+    items: "PostgreSQL, dbt Core, ..."
+  - category: AI ve LLM Sistemleri
+    tags: [ai, llm]
+    items: "LangChain, LangGraph, ..."
+  - category: ML ve Değerlendirme
+    tags: [ml, ai]
+    items: "PyTorch, scikit-learn, ..."
+  - category: Altyapı ve DevOps
+    tags: [devops, backend]
+    items: "Docker, CI/CD, ..."
+
+projects:
+  - name: Proje Adı
+    subtitle: Açık Kaynak, GitHub
+    year: 2024
+    tags: [ai, backend]
+    bullets:
+      - text: "Ne inşa ettiniz ve neden önemli."
+        tags: [ai, backend]
+
+additional:
+  languages:
+    - Türkçe (Anadil)
+    - İngilizce (İş Düzeyi)
+  certifications:
+    - "Sertifikanız, Kurum"

cv_renderer/examples/data/labels/en.yaml

@@ -0,0 +1,12 @@
+months: [Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec]
+
+about: About Me
+experience: Professional Experience
+education: Education
+skills: Skills
+projects: Projects
+additional: Additional Information
+languages: Languages
+certifications: Certificates
+present: Present
+to: "to"

cv_renderer/examples/data/labels/tr.yaml

@@ -0,0 +1,12 @@
+months: [Oca, Şub, Mar, Nis, May, Haz, Tem, Ağu, Eyl, Eki, Kas, Ara]
+
+about: Hakkımda
+experience: Profesyonel Deneyim
+education: Eğitim
+skills: Yetenekler
+projects: Projeler
+additional: Ek Bilgiler
+languages: Diller
+certifications: Sertifikalar
+present: Günümüz
+to: "-"

cv_renderer/examples/profiles/ai-engineer.yaml

@@ -0,0 +1,13 @@
+name: AI Engineer
+description: Foregrounds LLM systems, agentic AI, and evaluation work
+variant: ai
+lang: en
+focus_tags: [ai, llm, ml]
+deprioritize_tags: [data]
+max_bullets_per_job: 4
+sections: [experience, skills, education, projects, additional]
+skill_categories:
+  - AI and LLM Systems
+  - ML and Evaluation
+  - Backend and API
+  - Infra and DevOps

cv_renderer/examples/profiles/companies/spotify.yaml

@@ -0,0 +1,49 @@
+name: Spotify - Backend Engineer
+description: Tailored for a specific job posting — demonstrates every override field a company-specific profile can use
+variant: data
+lang: en
+
+# Overrides the headline and summary shown in the base data's `variant` lookup.
+# Write these directly for this application; don't translate from the other
+# language file, and don't invent facts — same rules as any other CV content.
+# The summary follows the title -> skills & accomplishments -> career goals
+# structure in docs/references/about-me-section.md.
+# Never name the target company here (or anywhere else in the CV content) —
+# that belongs in a cover letter, not a resume that might get reused or shared.
+title_override: Backend Engineer
+about_override: |
+  Backend Engineer with production experience building FastAPI services on top of governed data layers. Shipped a 109-model dbt warehouse layer, added automated data-correctness tests that catch reporting errors at the source, and supported BI reporting through Apache Superset. Looking to bring that same reliability focus to a data platform team.
+
+# Replaces an entry's tag-filtered bullets outright — use when a real
+# accomplishment needs reframing around a different angle than its default
+# bullets take (see filter.py::apply_profile). Keyed by ExperienceEntry.company.
+# An override also forces the entry into the CV even if its own tags would
+# otherwise exclude it entirely — only do this when something in it is
+# genuinely relevant; if nothing is, leave it out and let tag filtering drop it.
+experience_overrides:
+  Company Name:
+    - "Rewritten bullet #1 for this application, angled at what this employer cares about."
+    - "Rewritten bullet #2, still real, still XYZ-formatted, still no invented numbers."
+
+# Same idea as experience_overrides, but keyed by Project.name.
+project_overrides:
+  Project Name:
+    - "Rewritten project bullet emphasizing the angle relevant to this posting."
+
+# Reorders rendered projects by name — the most relevant project for this
+# application isn't always the first one in the base data. Same mechanism as
+# skill_categories below, just for projects instead of skill categories.
+project_order: [Project Name]
+
+focus_tags: [data, backend]
+deprioritize_tags: [ai, llm, ml]
+max_bullets_per_job: 4
+sections: [experience, education, skills, projects, additional]
+
+# Filters and orders which skill categories render. Skill items can also carry
+# their own tags (see base_en.yaml's "AI and LLM Systems" category) so a single
+# category can show a different subset of items per profile.
+skill_categories:
+  - Data Engineering
+  - Backend and API
+  - Infra and DevOps

cv_renderer/examples/profiles/general.yaml

@@ -0,0 +1,9 @@
+name: General
+description: Full CV, no tag filtering
+variant: default
+lang: en
+focus_tags: []
+deprioritize_tags: []
+max_bullets_per_job: 10
+sections: [experience, education, skills, projects, additional]
+skill_categories: ~

cv_renderer/examples/tags.yaml

@@ -0,0 +1,7 @@
+ai: LLM systems, agentic workflows, evaluation, RAG
+llm: Model-specific work — prompt engineering, tool use, evals
+ml: Training, distillation, PyTorch, model deployment
+data: dbt, SQL, warehouse, BI dashboards, ETL/ELT
+backend: FastAPI, API design, auth, logging, Redis
+devops: Docker, CI/CD, OTEL, pipeline infrastructure
+always: Items that appear in every profile (education, contact)

cv_renderer/exports.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+
+def export_pdf(html_path: Path) -> Path:
+    try:
+        from playwright.sync_api import sync_playwright
+    except ImportError as exc:
+        raise SystemExit(
+            "PDF export needs the 'pdf' extra: pip install 'cv-renderer[pdf]' "
+            "then run: playwright install chromium"
+        ) from exc
+
+    pdf_path = html_path.with_suffix(".pdf")
+
+    with sync_playwright() as pw:
+        browser = pw.chromium.launch()
+        page = browser.new_page()
+        page.goto(html_path.as_uri())
+        page.emulate_media(media="print")
+        page.pdf(
+            path=str(pdf_path),
+            format="A4",
+            print_background=True,
+        )
+        browser.close()
+
+    return pdf_path

cv_renderer/filter.py

@@ -0,0 +1,160 @@
+from typing import Any
+
+from cv_renderer.models import Bullet, CVData, Profile
+
+
+def _resolve(variants: dict[str, str], variant: str) -> str:
+    return variants.get(variant) or variants.get("default", "")
+
+
+def _filter_bullets(
+    bullets: list[Bullet],
+    focus: set[str],
+    deprio: set[str],
+    max_n: int,
+) -> list[str]:
+    focused: list[str] = []
+    neutral: list[str] = []
+    for b in bullets:
+        btags = set(b.tags)
+        if btags & focus:
+            focused.append(b.text)
+        elif not btags.issubset(deprio):
+            neutral.append(b.text)
+    return (focused + neutral)[:max_n]
+
+
+def _resolve_bullets(
+    override: list[str] | None,
+    bullets: list[Bullet],
+    focus: set[str],
+    deprio: set[str],
+    max_n: int,
+) -> list[str]:
+    if override is not None:
+        return override
+    return _filter_bullets(bullets, focus, deprio, max_n)
+
+
+def _filter_skill_items(items: list[Bullet], focus: set[str], deprio: set[str]) -> list[str]:
+    # Unlike job/project bullets, skill items are short and untagged-by-default:
+    # an item with no tags is generic and always kept, not dropped as "empty subset of deprio".
+    focused: list[str] = []
+    neutral: list[str] = []
+    for item in items:
+        tags = set(item.tags)
+        if tags & focus:
+            focused.append(item.text)
+        elif tags and tags.issubset(deprio):
+            continue
+        else:
+            neutral.append(item.text)
+    return focused + neutral
+
+
+def apply_profile(cv: CVData, profile: Profile, labels: dict[str, str]) -> dict[str, Any]:
+    variant = profile.variant
+    focus = set(profile.focus_tags)
+    deprio = set(profile.deprioritize_tags)
+    max_b = profile.max_bullets_per_job
+    include_all = not focus
+
+    meta: dict[str, Any] = {
+        "name": cv.meta.name,
+        "title": profile.title_override or _resolve(cv.meta.title, variant),
+        "location": cv.meta.location,
+        "email": cv.meta.email,
+        "phone": cv.meta.phone,
+        "links": cv.meta.links.model_dump(),
+    }
+
+    experience: list[dict[str, Any]] = []
+    for job in cv.experience:
+        override = profile.experience_overrides.get(job.company)
+        bullets = _resolve_bullets(override, job.bullets, focus, deprio, max_b)
+        if not bullets:
+            continue
+        experience.append(
+            {
+                "company": job.company,
+                "title": _resolve(job.title, variant),
+                "location": job.location,
+                "start": job.start,
+                "end": job.end,
+                "description": job.description,
+                "bullets": bullets,
+            }
+        )
+
+    skills: list[dict[str, Any]]
+    if profile.skill_overrides is not None:
+        skills = [
+            {"category": category, "entries": entries}
+            for category, entries in profile.skill_overrides.items()
+        ]
+    else:
+        include_tags = focus | {"always"}
+        skills = []
+        for cat in cv.skills:
+            if profile.skill_categories is not None:
+                if cat.category not in profile.skill_categories:
+                    continue
+            elif not include_all and not (set(cat.tags) & include_tags):
+                continue
+            entries = _filter_skill_items(cat.items, focus, deprio)
+            if not entries:
+                continue
+            skills.append({"category": cat.category, "entries": entries})
+
+        if profile.skill_categories is not None:
+            order = {name: i for i, name in enumerate(profile.skill_categories)}
+            skills.sort(key=lambda s: order.get(s["category"], 999))
+
+    projects: list[dict[str, Any]] = []
+    for proj in cv.projects:
+        override = profile.project_overrides.get(proj.name)
+        if override is None and not include_all and not (set(proj.tags) & focus):
+            continue
+        bullets = _resolve_bullets(override, proj.bullets, focus, deprio, max_b)
+        if not bullets:
+            continue
+        projects.append(
+            {
+                "name": proj.name,
+                "subtitle": proj.subtitle,
+                "year": proj.year,
+                "start": proj.start,
+                "end": proj.end,
+                "bullets": bullets,
+            }
+        )
+
+    if profile.project_order is not None:
+        order = {name: i for i, name in enumerate(profile.project_order)}
+        projects.sort(key=lambda p: order.get(p["name"], 999))
+
+    education: list[dict[str, Any]] = [
+        {
+            "institution": e.institution,
+            "degree": e.degree,
+            "location": e.location,
+            "start": e.start,
+            "end": e.end,
+        }
+        for e in cv.education
+    ]
+
+    return {
+        "meta": meta,
+        "about": profile.about_override or _resolve(cv.about, variant),
+        "experience": experience,
+        "skills": skills,
+        "projects": projects,
+        "education": education,
+        "additional": cv.additional.model_dump(),
+        "sections": profile.sections,
+        "lang": profile.lang,
+        "labels": labels,
+        "font_family": profile.font_family,
+        "font_sizes": profile.font_sizes.model_dump(),
+    }