prismcv 0.1.0__py3-none-any.whl

prismcv/__init__.py

@@ -0,0 +1,3 @@
+"""PrismCV: one source, every CV."""
+
+__version__ = "0.1.0"

prismcv/build.py

@@ -0,0 +1,353 @@
+"""Build CV PDFs from a CV folder (cv.yaml, design.yaml, content/, targets/) with RenderCV."""
+
+from __future__ import annotations
+
+import copy
+import functools
+import re
+import shutil
+import subprocess
+import sys
+import tempfile
+from pathlib import Path
+
+import yaml
+from pypdf import PdfReader
+
+ROOT = Path.cwd()
+CV_FILE = ROOT / "cv.yaml"
+CONTENT = ROOT / "content"
+TARGETS = ROOT / "targets"
+OUT = ROOT / "out"
+DESIGN = ROOT / "design.yaml"
+
+
+def use_root(root: Path) -> None:
+    """Point every path at the CV folder to build."""
+    global ROOT, CV_FILE, CONTENT, TARGETS, OUT, DESIGN
+    ROOT = root.resolve()
+    CV_FILE, DESIGN = ROOT / "cv.yaml", ROOT / "design.yaml"
+    CONTENT, TARGETS, OUT = ROOT / "content", ROOT / "targets", ROOT / "out"
+    load_design.cache_clear()
+    if not all(p.is_file() for p in (CV_FILE, DESIGN)) or not all(p.is_dir() for p in (CONTENT, TARGETS)):
+        raise BuildError(f"{ROOT} is not a CV folder: it needs cv.yaml, design.yaml, content/ and targets/ "
+                         "(create one with prismcv init)")
+
+SCHEMA = "https://raw.githubusercontent.com/rendercv/rendercv/refs/tags/v2.8/schema.json"
+
+# Fields a RenderCV entry can have. A one-key item in a target whose key is
+# neither an id nor one of these is reported as an unknown id.
+ENTRY_FIELDS = {
+    "text", "bullet", "label", "details", "number", "reversed_number",
+    "company", "position", "institution", "area", "degree", "name",
+    "title", "authors", "journal", "doi", "url", "summary", "highlights",
+    "date", "start_date", "end_date", "location",
+}
+
+# Marks text explicitly set to null for one language, so it is left out.
+OMIT = object()
+
+
+class BuildError(Exception):
+    pass
+
+
+def load_yaml(path: Path):
+    with open(path, encoding="utf-8") as f:
+        return yaml.safe_load(f)
+
+
+def rel(path: Path) -> str:
+    return str(path.relative_to(ROOT))
+
+
+@functools.cache
+def load_design() -> tuple[dict, dict, dict]:
+    """Read design.yaml: languages, the shared settings, and per-language settings."""
+    data = load_yaml(DESIGN) or {}
+    langs = data.pop("languages", None) or {"en": "english"}
+    if not isinstance(langs, dict) or not all(isinstance(v, str) for v in langs.values()):
+        raise BuildError("design.yaml: languages must map language codes to RenderCV locales, e.g. en: english")
+    per_lang = {code: data.pop(code) or {} for code in list(langs) if code in data}
+    return langs, data, per_lang
+
+
+def languages() -> tuple[str, ...]:
+    return tuple(load_design()[0])
+
+
+def merge(base: dict, extra: dict) -> dict:
+    """Merge extra into base, recursing into nested mappings."""
+    for k, v in extra.items():
+        if isinstance(v, dict) and isinstance(base.get(k), dict):
+            merge(base[k], v)
+        else:
+            base[k] = v
+    return base
+
+
+def design_for(lang: str) -> dict:
+    """RenderCV design, locale and settings for one language."""
+    langs, shared, per_lang = load_design()
+    doc = copy.deepcopy(shared)
+    merge(doc.setdefault("design", {}), copy.deepcopy(per_lang.get(lang, {})))
+    doc.setdefault("locale", {})["language"] = langs[lang]
+    return localize(doc, lang, "design.yaml")
+
+
+def load_pool() -> dict:
+    """Merge every file in content/ into one id -> entry pool."""
+    pool, where = {}, {}
+    for path in sorted(CONTENT.rglob("*.yaml")):
+        data = load_yaml(path) or {}
+        if not isinstance(data, dict):
+            raise BuildError(f"{rel(path)}: top level must map ids to entries")
+        for eid, entry in data.items():
+            if eid in pool:
+                raise BuildError(f"duplicate id '{eid}' in {rel(where[eid])} and {rel(path)}")
+            pool[eid], where[eid] = entry, path
+    return pool
+
+
+def load_cv() -> tuple[dict, dict]:
+    """Read cv.yaml: the header (name and contact details) and the section titles."""
+    data = load_yaml(CV_FILE) or {}
+    if not isinstance(data, dict):
+        raise BuildError("cv.yaml: top level must be a mapping with header and sections")
+    return dict(data.get("header") or {}), dict(data.get("sections") or {})
+
+
+# Languages
+
+def is_localized(value) -> bool:
+    return isinstance(value, dict) and bool(value) and set(value) <= set(languages())
+
+
+def localize(value, lang: str, where: str):
+    """Replace every {en: ..., zh: ...} mapping inside value with the text for lang."""
+    if is_localized(value):
+        if lang not in value:
+            raise BuildError(f"{where}: missing '{lang}' text")
+        if value[lang] is None:
+            return OMIT
+        return localize(value[lang], lang, where)
+    if isinstance(value, dict):
+        if set(value) & set(languages()):
+            extra = sorted(set(value) - set(languages()))
+            raise BuildError(f"{where}: unexpected keys {extra} next to language keys "
+                             "- put text containing commas in quotes, e.g. en: \"London, UK\"")
+        out = {}
+        for k, v in value.items():
+            v = localize(v, lang, f"{where}.{k}")
+            if v is not OMIT:
+                out[k] = v
+        return out
+    if isinstance(value, list):
+        out = []
+        for i, v in enumerate(value):
+            v = localize(v, lang, f"{where}[{i}]")
+            if v is not OMIT:
+                out.append(v)
+        return out
+    return value
+
+
+# Entries
+
+def resolve_id(eid: str, pool: dict, stack: tuple = ()):
+    """Return a copy of an entry with its base entry (for variants) applied."""
+    if eid not in pool:
+        raise BuildError(f"unknown id '{eid}'")
+    if eid in stack:
+        raise BuildError(f"circular base: {' -> '.join(stack + (eid,))}")
+    entry = copy.deepcopy(pool[eid])
+    if not isinstance(entry, dict):
+        return entry
+    base = entry.pop("base", None)
+    if base is None and "@" in eid:
+        base = eid.split("@", 1)[0]
+    if base is None:
+        return entry
+    parent = resolve_id(base, pool, stack + (eid,))
+    if not isinstance(parent, dict):
+        raise BuildError(f"'{eid}': base '{base}' is not a single entry")
+    parent.update(entry)
+    return parent
+
+
+def resolve_item(item, pool: dict) -> list:
+    """Turn one item of a target section into a list of entries.
+
+    An item is an id, an id with fields to override, or an entry written inline.
+    An id may stand for a list of entries, such as a group of skills.
+    """
+    if isinstance(item, str):
+        entry = resolve_id(item, pool)
+    elif isinstance(item, dict) and len(item) == 1 and next(iter(item)) in pool:
+        eid, override = next(iter(item.items()))
+        entry = resolve_id(eid, pool)
+        if override:
+            if not isinstance(entry, dict):
+                raise BuildError(f"'{eid}' is a list and cannot be overridden field by field")
+            entry.update(copy.deepcopy(override))
+    elif isinstance(item, dict):
+        if len(item) == 1 and next(iter(item)) not in ENTRY_FIELDS:
+            raise BuildError(f"unknown id '{next(iter(item))}'")
+        entry = copy.deepcopy(item)
+    else:
+        raise BuildError(f"cannot understand item {item!r}")
+    entries = entry if isinstance(entry, list) else [entry]
+    return [simplify(e) for e in entries]
+
+
+def simplify(entry):
+    """An entry with only a text field becomes a plain paragraph."""
+    if isinstance(entry, dict) and set(entry) == {"text"}:
+        return entry["text"]
+    return entry
+
+
+def entry_kind(entry) -> str:
+    if isinstance(entry, str):
+        return "text"
+    keys = set(entry)
+    for kind, marker in (
+        ("experience", {"company", "position"}), ("education", {"institution"}),
+        ("publication", {"authors"}), ("one-line", {"label"}), ("bullet", {"bullet"}),
+        ("numbered", {"number"}), ("reversed-numbered", {"reversed_number"}),
+        ("normal", {"name"}),
+    ):
+        if marker <= keys:
+            return kind
+    return "unknown"
+
+
+# Assembling
+
+def assemble(target_name: str, target: dict, lang: str, pool: dict) -> dict:
+    """Build the complete RenderCV input for one target in one language."""
+    header, titles = load_cv()
+    header.update(target.get("header") or {})
+
+    cv = localize(header, lang, "header")
+    cv["sections"] = {}
+    for key, spec in (target.get("sections") or {}).items():
+        where = f"targets/{target_name}.yaml: {key}"
+        if isinstance(spec, dict):
+            items, title = spec.get("entries") or [], spec.get("title")
+        else:
+            items, title = spec or [], None
+        title = title or titles.get(key)
+        if title is None:
+            raise BuildError(f"{where}: no title (add '{key}' to sections in cv.yaml)")
+        title = localize(title, lang, f"{where}.title")
+
+        entries = []
+        for i, item in enumerate(items):
+            try:
+                resolved = resolve_item(item, pool)
+            except BuildError as e:
+                raise BuildError(f"{where}[{i}]: {e}") from None
+            for e in resolved:
+                e = localize(e, lang, f"{where}[{i}]")
+                if e is not OMIT:
+                    entries.append(e)
+        if not entries:
+            continue
+        kinds = {entry_kind(e) for e in entries}
+        if len(kinds) > 1:
+            raise BuildError(f"{where}: mixed entry types {sorted(kinds)} in one section")
+        cv["sections"][title] = entries
+
+    doc = {"cv": cv}
+    doc.update(design_for(lang))
+    return doc
+
+
+def write_input(doc: dict, folder: Path, stem: str) -> Path:
+    settings = doc.setdefault("settings", {})
+    settings.setdefault("render_command", {}).update({
+        "output_folder": ".",
+        "pdf_path": f"{stem}.pdf",
+        "typst_path": f"{stem}.typ",
+        "dont_generate_markdown": True,
+        "dont_generate_html": True,
+        "dont_generate_png": True,
+    })
+    path = folder / f"{stem}.yaml"
+    with open(path, "w", encoding="utf-8") as f:
+        f.write(f"# yaml-language-server: $schema={SCHEMA}\n")
+        f.write("# Generated by build.py. Edit content/ and targets/ instead.\n")
+        yaml.safe_dump(doc, f, allow_unicode=True, sort_keys=False, width=1000)
+    return path
+
+
+def render(yaml_path: Path) -> None:
+    exe = shutil.which("rendercv", path=str(Path(sys.executable).parent)) or shutil.which("rendercv")
+    if not exe:
+        raise BuildError("rendercv not found - install the requirements: pip install -r requirements.txt")
+    proc = subprocess.run([exe, "render", yaml_path.name], cwd=yaml_path.parent,
+                          capture_output=True, text=True)
+    if proc.returncode != 0:
+        raise BuildError(f"RenderCV failed (run with --debug to keep its input):\n{proc.stdout}{proc.stderr}")
+
+
+# Targets
+
+def all_targets() -> list[str]:
+    return sorted(str(p.relative_to(TARGETS).with_suffix("")) for p in TARGETS.rglob("*.yaml"))
+
+
+def normalise(name: str) -> str:
+    name = name.removeprefix("targets/").removesuffix(".yaml")
+    if not (TARGETS / f"{name}.yaml").exists():
+        raise BuildError(f"no such target: targets/{name}.yaml")
+    return name
+
+
+def file_stem(lang: str) -> str:
+    """File name for a PDF, from the name in the first configured language."""
+    name = load_cv()[0].get("name", "CV")
+    name = localize(name, languages()[0], "header.name")
+    stem = re.sub(r"\W+", "_", str(name)).strip("_") or "CV"
+    return f"{stem}_CV_{lang}"
+
+
+def build(name: str, pool: dict, only_lang: str | None, debug: bool) -> list[str]:
+    """Build one target and return any warnings."""
+    target = load_yaml(TARGETS / f"{name}.yaml") or {}
+    langs = target.get("langs") or list(languages())
+    limit = target.get("max_pages")
+    if limit is not None and (not isinstance(limit, int) or isinstance(limit, bool) or limit < 1):
+        raise BuildError(f"targets/{name}.yaml: max_pages must be a positive whole number (or left out for no limit)")
+    if only_lang:
+        langs = [l for l in langs if l == only_lang]
+        if not langs:
+            print(f"  - skipped: this target is not built in '{only_lang}'")
+
+    warnings = []
+    for lang in langs:
+        if lang not in languages():
+            raise BuildError(f"targets/{name}.yaml: language '{lang}' is not listed in design.yaml")
+        doc = assemble(name, target, lang, pool)
+        out_folder = OUT / name
+        out_folder.mkdir(parents=True, exist_ok=True)
+        stem = file_stem(lang)
+        pdf = out_folder / f"{stem}.pdf"
+        with tempfile.TemporaryDirectory(prefix="cv-") as tmp:
+            work = Path(tmp)
+            path = write_input(doc, work, stem)
+            try:
+                render(path)
+            finally:
+                if debug:
+                    for suffix in (".yaml", ".typ"):
+                        if (work / f"{stem}{suffix}").exists():
+                            shutil.copy2(work / f"{stem}{suffix}", out_folder / f"{stem}{suffix}")
+            shutil.copy2(work / f"{stem}.pdf", pdf)
+
+        pages = len(PdfReader(pdf).pages)
+        print(f"  ✓ {rel(pdf)}  ({pages} page{'s' if pages != 1 else ''})")
+        if limit and pages > limit:
+            warnings.append(f"{name} ({lang}): {pages} pages, exceeds max_pages: {limit}")
+    return warnings

prismcv/cli.py

@@ -0,0 +1,79 @@
+"""The prismcv command."""
+
+from __future__ import annotations
+
+import argparse
+import sys
+from pathlib import Path
+
+from . import build as b
+from .init import InitError, create
+
+
+def run_build(args: argparse.Namespace, parser: argparse.ArgumentParser) -> int:
+    try:
+        b.use_root(args.root)
+        if not args.targets and not args.all:
+            parser.print_help()
+            print("\navailable targets:\n  " + "\n  ".join(b.all_targets()))
+            return 1
+        if args.lang and args.lang not in b.languages():
+            raise b.BuildError(f"unknown language '{args.lang}' (configured: {', '.join(b.languages())})")
+        pool = b.load_pool()
+        names = b.all_targets() if args.all else [b.normalise(t) for t in args.targets]
+    except b.BuildError as e:
+        print(f"✗ {e}", file=sys.stderr)
+        return 1
+
+    failed, warnings = [], []
+    for name in names:
+        print(name)
+        try:
+            warnings += b.build(name, pool, args.lang, args.debug)
+        except b.BuildError as e:
+            print(f"  ✗ {e}", file=sys.stderr)
+            failed.append(name)
+    for w in warnings:
+        print(f"⚠ {w}")
+    if failed:
+        print(f"✗ failed: {', '.join(failed)}", file=sys.stderr)
+        return 1
+    return 0
+
+
+def run_init(args: argparse.Namespace) -> int:
+    try:
+        created = create(args.path, example=args.example)
+    except InitError as e:
+        print(f"✗ {e}", file=sys.stderr)
+        return 1
+    root = args.path.resolve()
+    for path in created:
+        print(f"  + {path.relative_to(root)}")
+    print(f"Created a CV in {root}. Edit cv.yaml and content/, then run: prismcv build --all")
+    return 0
+
+
+def main() -> int:
+    ap = argparse.ArgumentParser(prog="prismcv", description="One source, every CV.")
+    commands = ap.add_subparsers(dest="command", required=True)
+
+    bp = commands.add_parser("build", help="build CV PDFs with RenderCV")
+    bp.add_argument("targets", nargs="*", help="target names, e.g. industry or jobs/2026-10-15_acme")
+    bp.add_argument("--all", action="store_true", help="build every target")
+    bp.add_argument("--lang", help="only build this language")
+    bp.add_argument("--debug", action="store_true", help="keep the generated RenderCV input next to the PDF")
+    bp.add_argument("--root", type=Path, default=Path.cwd(), help="CV folder to build (default: current folder)")
+
+    ip = commands.add_parser("init", help="create a new CV folder")
+    ip.add_argument("path", nargs="?", type=Path, default=Path.cwd(), help="folder to create it in (default: current folder)")
+    ip.add_argument("--example", action="store_true", help="start from the full bilingual example instead of the minimal template")
+
+    args = ap.parse_args()
+    if args.command == "init":
+        return run_init(args)
+    return run_build(args, bp)
+
+
+if __name__ == "__main__":
+    sys.exit(main())

prismcv/example/content/education.yaml

@@ -0,0 +1,15 @@
+meng:
+  institution: { en: Northfield Institute of Technology, zh: 北原理工学院 }
+  degree: { en: MEng, zh: 硕士 }
+  area: { en: Electrical Engineering, zh: 电气工程 }
+  location: { en: "Toronto, Canada", zh: 加拿大多伦多 }
+  start_date: 2024-09
+  end_date: present
+
+bsc:
+  institution: { en: Lakeside University, zh: 湖畔大学 }
+  degree: { en: BSc, zh: 学士 }
+  area: { en: Physics, zh: 物理学 }
+  location: { en: "Vancouver, Canada", zh: 加拿大温哥华 }
+  start_date: 2020-09
+  end_date: 2024-05

prismcv/example/content/experience.yaml

@@ -0,0 +1,60 @@
+# Work, research and activities. Each target decides which section an entry goes in.
+
+photonics-lab:
+  company: { en: "Applied Photonics Lab, Lakeside University", zh: 湖畔大学应用光子学实验室 }
+  position: { en: Undergraduate Researcher, zh: 本科生研究员 }
+  location: { en: "Vancouver, Canada", zh: 加拿大温哥华 }
+  start_date: 2023-05
+  end_date: 2024-04
+  highlights:
+    - en: Calibrated a LiDAR array and wrote Python tools to clean its output
+      zh: 校准激光雷达阵列，并编写 Python 工具清洗其输出数据
+    - en: Results contributed to a conference paper on sensor fusion
+      zh: 研究结果用于一篇多传感器融合方向的会议论文
+
+brightwave-intern:
+  company: { en: Brightwave Robotics, zh: 明波机器人 }
+  position: { en: Embedded Software Intern, zh: 嵌入式软件实习生 }
+  location: { en: "Montreal, Canada", zh: 加拿大蒙特利尔 }
+  start_date: 2025-05
+  end_date: 2025-08
+  highlights:
+    - en: Wrote C++ drivers for an IMU on a warehouse robot platform
+      zh: 为仓储机器人平台的惯性测量单元编写 C++ 驱动
+    - en: Cut sensor read latency by 30% by moving polling to DMA
+      zh: 将轮询改为 DMA 传输，传感器读取延迟降低 30%
+    - en: Added hardware-in-the-loop tests to the CI pipeline
+      zh: 在持续集成流程中加入硬件在环测试
+
+# A variant: inherits brightwave-intern and replaces the fields written here.
+brightwave-intern@data:
+  highlights:
+    - en: Built a pipeline to collect and visualise sensor logs from test runs
+      zh: 搭建测试运行中传感器日志的采集与可视化流程
+    - en: Analysed failure data to find the root cause of drift in navigation
+      zh: 分析故障数据，定位导航漂移问题的根本原因
+
+greenleaf-analyst:
+  company: { en: Greenleaf Energy, zh: 绿叶能源 }
+  position: { en: Part-time Data Analyst, zh: 兼职数据分析师 }
+  location: { en: "Toronto, Canada", zh: 加拿大多伦多 }
+  start_date: 2025-10
+  end_date: present
+  highlights:
+    - en: Build weekly dashboards on solar panel output for the operations team
+      zh: 为运营团队制作太阳能板发电量的周报看板
+
+robotics-club:
+  company: { en: Lakeside University Robotics Club, zh: 湖畔大学机器人社 }
+  position: { en: Team Captain, zh: 队长 }
+  start_date: 2022-09
+  end_date: 2024-05
+  highlights:
+    - en: Led a 12-person team through two national competitions
+      zh: 带领 12 人团队参加两届全国比赛
+
+hackathon:
+  company: { en: Northfield Hardware Hackathon, zh: 北原硬件黑客松 }
+  position: { en: Co-organiser, zh: 联合组织者 }
+  start_date: 2025-01
+  end_date: 2025-03

prismcv/example/content/profile.yaml

@@ -0,0 +1,9 @@
+# A target can also write its own paragraph instead.
+profile-industry:
+  text:
+    en: Electrical engineer with hands-on experience in embedded software and sensor data pipelines.
+    zh: 电气工程背景，有嵌入式软件与传感器数据处理的实践经验。
+profile-academic:
+  text:
+    en: Electrical engineering graduate researching sensor fusion for low-cost robotics.
+    zh: 电气工程硕士，研究方向为低成本机器人的多传感器融合。

prismcv/example/content/projects.yaml

@@ -0,0 +1,15 @@
+weather-station:
+  name: { en: Solar Weather Station, zh: 太阳能气象站 }
+  start_date: 2024-01
+  end_date: 2024-04
+  highlights:
+    - en: Off-grid weather station on an ESP32, reporting over LoRa
+      zh: 基于 ESP32 的离网气象站，通过 LoRa 上报数据
+
+line-follower:
+  name: { en: Line-following Robot, zh: 循迹机器人 }
+  start_date: 2023-02
+  end_date: 2023-03
+  highlights:
+    - en: PID-controlled robot that placed 2nd in a regional competition
+      zh: 采用 PID 控制，在地区比赛中获得第二名

prismcv/example/content/publications.yaml

@@ -0,0 +1,6 @@
+# Mark yourself in the author list with *italics*.
+paper-fusion:
+  title: Low-cost LiDAR and IMU Fusion for Indoor Mapping
+  authors: [Maria Santos, "*Nathan Lee*", Wei Chen]
+  journal: Example Robotics Conference 2024
+  date: 2024-06

prismcv/example/content/skills.yaml

@@ -0,0 +1,6 @@
+# An id can hold a list of entries; a target that uses it gets them all.
+skills-general:
+  - label: { en: Languages, zh: 编程语言 }
+    details: C++, Python, MATLAB
+  - label: { en: Tools, zh: 工具 }
+    details: ROS 2, Git, KiCad, Docker

prismcv/example/cv.yaml

@@ -0,0 +1,19 @@
+# Plain text is shared by all languages; {en: ..., zh: ...} gives one text per language.
+header:
+  name: { en: Nathan Lee, zh: 李南森 }
+  location: { en: "Toronto, Canada", zh: 加拿大多伦多 }
+  email: nathan.lee@example.com
+  phone: { en: "+1 416 555 0123", zh: "+86 138 0013 8000" }
+  social_networks:
+    - network: GitHub
+      username: example
+
+sections:
+  profile:      { en: Profile, zh: 个人简介 }
+  education:    { en: Education, zh: 教育背景 }
+  work:         { en: Work Experience, zh: 工作经历 }
+  research:     { en: Research Experience, zh: 科研经历 }
+  projects:     { en: Projects, zh: 项目经历 }
+  publications: { en: Publications, zh: 发表论文 }
+  activities:   { en: Leadership & Activities, zh: 校园活动 }
+  skills:       { en: Skills, zh: 技能 }

prismcv/example/design.yaml

@@ -0,0 +1,25 @@
+# Language codes and their RenderCV locales. The first names the PDF files.
+languages:
+  en: english
+  zh: mandarin_chinese
+
+# RenderCV design shared by every language. Options: https://docs.rendercv.com
+design:
+  theme: classic
+  page:
+    size: a4
+    show_footer: false
+    show_top_note: false
+  sections:
+    show_time_spans_in: []
+
+# Settings for one language, added on top of the shared design.
+zh:
+  typography:
+    font_family: Noto Sans SC
+  templates:
+    single_date: YEAR年MONTH月
+    experience_entry:
+      main_column: "**COMPANY**，POSITION\nSUMMARY\nHIGHLIGHTS"
+    education_entry:
+      main_column: "**INSTITUTION**，AREA\nSUMMARY\nHIGHLIGHTS"

prismcv/example/targets/academic.yaml

@@ -0,0 +1,11 @@
+# Academic: research and publications first.
+langs: [en, zh]
+max_pages: 2
+sections:
+  profile: [profile-academic]
+  education: [meng, bsc]
+  research: [photonics-lab]
+  publications: [paper-fusion]
+  work: [brightwave-intern]
+  activities: [robotics-club, hackathon]
+  skills: [skills-general]

prismcv/example/targets/full.yaml

@@ -0,0 +1,11 @@
+# Full: everything, no page limit.
+langs: [en, zh]
+sections:
+  profile: [profile-industry]
+  education: [meng, bsc]
+  work: [brightwave-intern, greenleaf-analyst]
+  research: [photonics-lab]
+  projects: [weather-station, line-follower]
+  publications: [paper-fusion]
+  activities: [robotics-club, hackathon]
+  skills: [skills-general]

prismcv/example/targets/industry.yaml

@@ -0,0 +1,9 @@
+# Industry: work and projects first, no publications.
+langs: [en, zh]
+max_pages: 1
+sections:
+  profile: [profile-industry]
+  education: [meng, bsc]
+  work: [brightwave-intern, greenleaf-analyst]
+  projects: [weather-station, line-follower]
+  skills: [skills-general]

prismcv/example/targets/jobs/2026-10-15_example-data-engineer.yaml

@@ -0,0 +1,20 @@
+# A target tailored to one job application, named date_company_role.yaml.
+langs: [en]
+max_pages: 1
+sections:
+  # A paragraph written just for this job
+  profile:
+    - text: Engineer who enjoys turning messy sensor data into reliable pipelines.
+  education: [meng, bsc]
+  work:
+    # A different title for this target only
+    title: Experience
+    entries:
+      # A variant defined in content/
+      - brightwave-intern@data
+      # Override some fields; the rest come from content/
+      - greenleaf-analyst:
+          highlights:
+            - Rewritten bullet for this role only
+  projects: [weather-station]
+  skills: [skills-general]

prismcv/init.py

@@ -0,0 +1,36 @@
+"""Create a new CV folder from the template or the example."""
+
+from __future__ import annotations
+
+import shutil
+from pathlib import Path
+
+HERE = Path(__file__).resolve().parent
+TEMPLATE = HERE / "template"
+EXAMPLE = HERE / "example"
+CV_PARTS = ("cv.yaml", "design.yaml", "content", "targets")
+GITIGNORE = "# Generated PDFs\nout/\n"
+
+
+class InitError(Exception):
+    pass
+
+
+def create(root: Path, example: bool = False) -> list[Path]:
+    """Copy the template (or the example) into root without overwriting a CV. Returns the files created."""
+    root = root.resolve()
+    existing = [name for name in CV_PARTS if (root / name).exists()]
+    if existing:
+        raise InitError(f"{root} already contains {', '.join(existing)}")
+    source = EXAMPLE if example else TEMPLATE
+    created = []
+    for src in sorted(source.rglob("*.yaml")):
+        dest = root / src.relative_to(source)
+        dest.parent.mkdir(parents=True, exist_ok=True)
+        shutil.copyfile(src, dest)
+        created.append(dest)
+    gitignore = root / ".gitignore"
+    if not gitignore.exists():
+        gitignore.write_text(GITIGNORE, encoding="utf-8")
+        created.append(gitignore)
+    return created

prismcv/template/content/education.yaml

@@ -0,0 +1,6 @@
+university:
+  institution: Example University
+  degree: BSc
+  area: Computer Science
+  start_date: 2022-09
+  end_date: 2026-06

prismcv/template/content/experience.yaml

@@ -0,0 +1,10 @@
+# Work, research and activities. Each target decides which section an entry goes in.
+example-job:
+  company: Example Company
+  position: Software Engineer Intern
+  location: City, Country
+  start_date: 2025-06
+  end_date: 2025-09
+  highlights:
+    - What you did and what came of it.
+    - Another achievement, with a number if you have one.

prismcv/template/content/profile.yaml

@@ -0,0 +1,2 @@
+profile:
+  text: A sentence or two about who you are and what you are looking for.

prismcv/template/content/projects.yaml

@@ -0,0 +1,6 @@
+example-project:
+  name: Example Project
+  start_date: 2024-01
+  end_date: present
+  highlights:
+    - What it does and how you built it.

prismcv/template/content/skills.yaml

@@ -0,0 +1,6 @@
+# An id can hold a list of entries; a target that uses it gets them all.
+skills:
+  - label: Languages
+    details: Python, Java
+  - label: Tools
+    details: Git, Docker

prismcv/template/cv.yaml

@@ -0,0 +1,14 @@
+header:
+  name: Your Name
+  location: City, Country
+  email: you@example.com
+  social_networks:
+    - network: GitHub
+      username: your-username
+
+sections:
+  profile: Profile
+  education: Education
+  experience: Experience
+  projects: Projects
+  skills: Skills

prismcv/template/design.yaml

@@ -0,0 +1,13 @@
+# Language codes and their RenderCV locales. The first names the PDF files.
+languages:
+  en: english
+
+# RenderCV design shared by every language. Options: https://docs.rendercv.com
+design:
+  theme: classic
+  page:
+    size: a4
+    show_footer: false
+    show_top_note: false
+  sections:
+    show_time_spans_in: []

prismcv/template/targets/main.yaml

@@ -0,0 +1,7 @@
+# One version of the CV: which entries go in which section, in order.
+sections:
+  profile: [profile]
+  education: [university]
+  experience: [example-job]
+  projects: [example-project]
+  skills: [skills]

prismcv-0.1.0.dist-info/METADATA

@@ -0,0 +1,140 @@
+Metadata-Version: 2.5
+Name: prismcv
+Version: 0.1.0
+Summary: One source, every CV: build multilingual, tailored CVs with RenderCV.
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: pypdf
+Requires-Dist: pyyaml
+Requires-Dist: rendercv[full]==2.8
+Description-Content-Type: text/markdown
+
+<!-- markdownlint-disable MD033 MD041 -->
+
+<div align="center">
+
+<h1>Prism CV</h1>
+
+<p><strong>One source, every CV.</strong></p>
+
+<p>
+  <a href="LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-blue.svg"></a>
+  <img alt="Python 3.12+" src="https://img.shields.io/badge/python-3.12%2B-3776AB?logo=python&logoColor=white">
+  <a href="https://github.com/rendercv/rendercv"><img alt="RenderCV 2.8" src="https://img.shields.io/badge/RenderCV-2.8-blue"></a>
+  <a href="README.zh-CN.md"><img alt="中文" src="https://img.shields.io/badge/README-%E4%B8%AD%E6%96%87-blue"></a>
+</p>
+
+</div>
+
+Keep your whole career in one place and build every version of your CV from it: each language, academic and industry, and one tailored to each job. Edit an entry once and every version picks it up.
+
+## How it works
+
+```mermaid
+flowchart LR
+    C["content/<br/>every entry, written once,<br/>languages side by side"]
+    T["targets/x.yaml<br/>which entries, in what order,<br/>what is reworded"]
+    B["PrismCV<br/>assembles one YAML per language"]
+    R["RenderCV<br/>typesets it into PDF"]
+    P["out/x/*.pdf"]
+
+    C --> B
+    T --> B
+    B --> R --> P
+```
+
+[RenderCV](https://github.com/rendercv/rendercv) typesets one YAML file into a PDF. PrismCV assembles that file from your content and a target; all layout is RenderCV's.
+
+## Quick start
+
+Requires Python 3.12+.
+
+```sh
+pip install -e .
+prismcv init my-cv                  # create a CV folder from a minimal template
+cd my-cv
+prismcv build --all                 # every target
+prismcv build main --lang en        # one target, one language
+prismcv build main --debug          # keep the generated RenderCV input
+```
+
+A CV folder holds `cv.yaml`, `design.yaml`, `content/` and `targets/`. Run `prismcv build` inside one, or point to one with `--root`. PDFs go to `out/<target>/`.
+
+`prismcv init --example` creates a full bilingual example instead, using every feature below. Its Chinese version needs the [Noto Sans SC](https://fonts.google.com/noto/specimen/Noto+Sans+SC) font.
+
+## Themes
+
+Set `theme` in `design.yaml`.
+
+![The example CV in nine themes: classic, engineeringresumes, sb2nov, moderncv, engineeringclassic, harvard, ink, opal and ember](docs/themes.en.jpg)
+
+## Content
+
+`cv.yaml` holds your name and contact details and the section titles. Every file in `content/` holds entries keyed by an id; how you split them into files is up to you. Fields use [RenderCV's names](https://docs.rendercv.com).
+
+Text that differs between languages maps language codes to text; anything else is written once. An excerpt from the example's [`content/experience.yaml`](src/prismcv/example/content/experience.yaml):
+
+```yaml
+brightwave-intern:
+  company: { en: Brightwave Robotics, zh: 明波机器人 }
+  location: { en: "Montreal, Canada", zh: 蒙特利尔 }
+  start_date: 2025-05
+  end_date: present
+  highlights:
+    - en: Wrote C++ drivers for an IMU
+      zh: 编写惯性测量单元的 C++ 驱动
+```
+
+Use `zh: null` to leave a bullet out of one language. An id can also hold a list of entries (a group of skills), and an entry with only `text` is a paragraph (a profile).
+
+## Targets
+
+Each file in `targets/` is one version of the CV. `langs` defaults to every language, and `max_pages` warns when a PDF is longer. An excerpt from the example's [target tailored to one job](src/prismcv/example/targets/jobs/2026-10-15_example-data-engineer.yaml):
+
+```yaml
+langs: [en]
+max_pages: 1
+sections:
+  profile:
+    - text: Engineer who enjoys turning messy sensor data into reliable pipelines.
+  work:
+    title: Experience
+    entries:
+      - brightwave-intern@data
+      - greenleaf-analyst:
+          highlights:
+            - Rewritten bullet for this role only
+```
+
+An item is an id, an id with fields to override, or an entry written inline. A variant such as `brightwave-intern@data` lives in `content/` and changes only the fields it lists, so it suits rewording you will reuse. `title` renames a section for this target.
+
+## Languages
+
+`languages` in `design.yaml` maps each code to a [RenderCV locale](https://docs.rendercv.com). To add one, add it there, put any settings it needs under its code (a font, a date format), and add its text to the content you use; the build lists anything missing.
+
+## License
+
+```text
+MIT License
+
+Copyright (c) 2026 Andy Zhang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```

prismcv-0.1.0.dist-info/RECORD

@@ -0,0 +1,29 @@
+prismcv/__init__.py,sha256=meSwNrmhCDATJGcOMAIJ68J4Y8MqaULKC1lhPG8i7FQ,60
+prismcv/build.py,sha256=gryCuth2Tf4ftFINCbCyfHCdA2YdLUrgGjMkg4bV3SE,13118
+prismcv/cli.py,sha256=1h4tr4vI3gLtQJsbyG0mo-pEMMVpuNIpFEdqgsBL61w,2901
+prismcv/init.py,sha256=vQcDb2kw24tHXv2Fv4RWTg9LyilNB5GFKzGcKG8xuf8,1183
+prismcv/example/cv.yaml,sha256=PV--bNGjc66EHslZ_l3kLVAy-d0ps6_AQHROv7vMZvA,806
+prismcv/example/design.yaml,sha256=Y5f1chbYvSoqqiIkhSeLivBKyOaHHOKdktFB9Khk2lc,669
+prismcv/example/content/education.yaml,sha256=yFkCf6F9An30MXicOhySXuROf7mUOVrM4MLxsQXjsVI,530
+prismcv/example/content/experience.yaml,sha256=NpsJ3XU_wfWmSlPBPkS7nz7_C0ucXDZUe5Alc5qAzkQ,2708
+prismcv/example/content/profile.yaml,sha256=JRIUTdpCSiAa30SYN-aNqfpXalqHUHGys7FRD-lO-50,472
+prismcv/example/content/projects.yaml,sha256=kPT8FwolEvf-5gatXNHfGntlVh_0pgfdB6lF5opI6eE,539
+prismcv/example/content/publications.yaml,sha256=mS7XJlSu9LrS_Waly2eZNONImhna2cfpFYfQ6TMoc7E,235
+prismcv/example/content/skills.yaml,sha256=unFfXgTLB7bB8tLPNjC2TgGe0-7JhJZFU51kSjSPwY0,245
+prismcv/example/targets/academic.yaml,sha256=_z8Z9UJpAqJRzINE3trZdvXf6KAvbA2IsuNA700zx6A,294
+prismcv/example/targets/full.yaml,sha256=D6JQzkMhnboLbLxCI0bO_vwGboNc28I11wE17TOuq00,335
+prismcv/example/targets/industry.yaml,sha256=tL_7eUXhCepno5oz_PpJshrq7i-I08ozQ6ktNe7WbqE,267
+prismcv/example/targets/jobs/2026-10-15_example-data-engineer.yaml,sha256=dfdB1cw7FrxcyU2-WJ_e1HYtwRv3BPx9BcxWp4aUiYo,641
+prismcv/template/cv.yaml,sha256=ufX_CVlEMHm0uc7n3xjIKxoe6CGwxH-haGSXrH65W8c,264
+prismcv/template/design.yaml,sha256=8mbXKcdEgpdxWXgyyFODjSdD9veEMCbruTj_S65T0zE,314
+prismcv/template/content/education.yaml,sha256=Xx8UaDv58Dv-jR9ybs8TIjAjwvfEmTFtKtnfLDBQA9A,127
+prismcv/template/content/experience.yaml,sha256=XWT8eGIMW5ZSXwsCMEM-NYrhAsK0hWaUT8XODMlIL8E,342
+prismcv/template/content/profile.yaml,sha256=dBU8fJVaBkNzKuKm8WYpPySg_skx8EoI_stPGHYSnWA,83
+prismcv/template/content/projects.yaml,sha256=ZrzEj8lx8ehj0HCYMfoXjd3n816JURKg7UMtmEIAgVE,138
+prismcv/template/content/skills.yaml,sha256=3j-npp1o-mXSTzj7kAMBbFEYUExwByDrKrFxNgMmR18,170
+prismcv/template/targets/main.yaml,sha256=jVmXuH6isNnWwtuElhb9J4gQhFKOh9p1owTFyz3s7Qo,204
+prismcv-0.1.0.dist-info/METADATA,sha256=4CSh-BqUDcK3jAz6e_uRwcgJn6vYWqM6q2M6hGM22MA,5687
+prismcv-0.1.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+prismcv-0.1.0.dist-info/entry_points.txt,sha256=YhlKJnCiJn3hDTXA0BsAEF-YlX6FAgl9BBqMl8XsC1I,45
+prismcv-0.1.0.dist-info/licenses/LICENSE,sha256=QMZbwDYC9eAxAa5Q8szAVK9bdeHBs1FJm4xEY5B2vi8,1067
+prismcv-0.1.0.dist-info/RECORD,,

prismcv-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

prismcv-0.1.0.dist-info/entry_points.txt

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

prismcv-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andy Zhang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.