offerprinter 0.3.0__tar.gz → 0.4.0__tar.gz

{offerprinter-0.3.0 → offerprinter-0.4.0}/CHANGELOG.md

@@ -7,6 +7,44 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] — 2026-08-25
+
+The "it has to look like something" release. v0.3.0 made the output provable;
+this one makes it presentable, and makes getting your history in a two-minute job
+rather than an afternoon.
+
+### Added
+
+- **Six PDF templates**: `classic`, `compact`, `serif`, `rule`, `accent`, `mono`.
+  Choose with `--template`, list with `offerprinter templates`, and see them with
+  `offerprinter templates --sample ./samples`. Set a default under `[output]` in
+  `config.toml`, or `OFFERPRINTER_TEMPLATE`.
+- **LinkedIn import** (`--linkedin`). Takes either export LinkedIn offers: the PDF
+  from *More → Save to PDF*, or the CSV archive from *Get a copy of your data*.
+  Nothing is scraped and nothing is fetched — you export your own data and this
+  reads the file.
+
+### Notes on the templates
+
+Every template stays inside what an ATS can parse: one of the 14 PDF base fonts,
+no columns, no tables, no images, no text boxes. What varies is typeface, spacing,
+rules, capitalisation and one accent colour. The test suite checks, per template,
+that the PDF embeds no font program, contains no `/Image` or `/XObject`, and that
+a naive text extraction still returns the name, the email and every bullet.
+
+`accent` is labelled *email only*: it extracts cleanly, but carries enough colour
+that a strict parser could lose a heading.
+
+The LinkedIn importer is held to the no-fabrication guarantee too. A test takes
+every word of its output and asserts it appeared in the input, because an importer
+that quietly tidied up your history would break the guarantee before the generator
+ever ran.
+
+### Unchanged
+
+`classic` renders byte-for-byte what v0.3.0 rendered. There is a test for that, so
+upgrading changes nothing unless you ask it to.
+
 ## [0.3.0] — 2026-08-20
 
 The "prove it" release. v0.2.0 made OfferPrinter installable; this one makes its

{offerprinter-0.3.0 → offerprinter-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: offerprinter
-Version: 0.3.0
+Version: 0.4.0
 Summary: Free, local-first AI job application generator: one CV + one job description, and it prints a tailored CV, cover letter, fit memo, ATS keyword report and interview prep pack — without fabricating anything.
 Project-URL: Homepage, https://github.com/mohitagw15856/OfferPrinter
 Project-URL: Repository, https://github.com/mohitagw15856/OfferPrinter
@@ -177,6 +177,76 @@ have hand-edited it, say — and makes no API calls at all, so it is free.
 
 ---
 
+## I have not updated my CV in three years
+
+Neither has anyone. Your LinkedIn is current though, and LinkedIn will give it
+back to you:
+
+```sh
+# More > Save to PDF on your own profile
+offerprinter --linkedin ~/Downloads/Profile.pdf --jd https://…
+
+# or the full archive: Settings > Data privacy > Get a copy of your data
+offerprinter --linkedin ~/Downloads/Basic_LinkedInDataExport.zip --jd https://…
+```
+
+Both shapes are normalised into the Markdown the rest of the pipeline expects.
+Nothing is scraped — you export your own data from your own account and this reads
+the file.
+
+The importer holds to the same rule as the generator: **it invents nothing.** A
+role with no description gets no description; an empty section stays empty. There
+is a test that takes every word of the output and asserts it appeared in the
+input, because an importer that quietly "tidied up" your history would break the
+no-fabrication guarantee before the generator ever ran.
+
+## Can I make it look like something other than every other CV?
+
+Six templates, all of which still parse:
+
+```sh
+offerprinter templates                       # what they are
+offerprinter templates --sample ./samples    # one PDF of each, to look at
+offerprinter --cv cv.pdf --jd URL --template serif
+```
+
+| Template | Typeface | Portal-safe | For |
+|---|---|---|---|
+| `classic` | Helvetica | yes | the default; nothing to go wrong |
+| `compact` | Helvetica | yes | when two pages need to be one |
+| `serif` | Times | yes | law, academia, policy |
+| `rule` | Helvetica | yes | a hairline under each section, for skim-readers |
+| `accent` | Helvetica | email only | one colour, headings only |
+| `mono` | Courier | yes | reads as engineering |
+
+**Why only six, and why so restrained.** A CV is read twice: once by a parser that
+wants plain text in a standard font, and once by a person with forty tabs open. The
+compromise most builders make is to serve the human and quietly fail the machine —
+two columns, an icon font, a text box for the sidebar, and an ATS that returns your
+name and nothing else.
+
+So every template here stays on the safe side of that line. All of them use one of
+the 14 PDF base fonts, so nothing is embedded and the text always extracts; none
+use columns, tables, images or text boxes. What varies is typeface, spacing, rules,
+capitalisation and one accent colour — the parts a human notices and a parser
+ignores.
+
+`accent` is labelled *email only* rather than being left off the list: it extracts
+cleanly, but carries enough colour that a strict parser could lose a heading. Send
+that one to a person, not a portal.
+
+The test suite asserts, for every template, that the rendered PDF contains no
+embedded font program, no `/Image` or `/XObject`, and that the name, email and
+every bullet come back out of a naive text extraction. That is the claim, and it
+is checked rather than asserted.
+
+Set a default in `config.toml`:
+
+```toml
+[output]
+template = "rule"
+```
+
 ## How do I install OfferPrinter?
 
 <!-- AEO Answer Capsule — 57 words -->

{offerprinter-0.3.0 → offerprinter-0.4.0}/README.md

@@ -130,6 +130,76 @@ have hand-edited it, say — and makes no API calls at all, so it is free.
 
 ---
 
+## I have not updated my CV in three years
+
+Neither has anyone. Your LinkedIn is current though, and LinkedIn will give it
+back to you:
+
+```sh
+# More > Save to PDF on your own profile
+offerprinter --linkedin ~/Downloads/Profile.pdf --jd https://…
+
+# or the full archive: Settings > Data privacy > Get a copy of your data
+offerprinter --linkedin ~/Downloads/Basic_LinkedInDataExport.zip --jd https://…
+```
+
+Both shapes are normalised into the Markdown the rest of the pipeline expects.
+Nothing is scraped — you export your own data from your own account and this reads
+the file.
+
+The importer holds to the same rule as the generator: **it invents nothing.** A
+role with no description gets no description; an empty section stays empty. There
+is a test that takes every word of the output and asserts it appeared in the
+input, because an importer that quietly "tidied up" your history would break the
+no-fabrication guarantee before the generator ever ran.
+
+## Can I make it look like something other than every other CV?
+
+Six templates, all of which still parse:
+
+```sh
+offerprinter templates                       # what they are
+offerprinter templates --sample ./samples    # one PDF of each, to look at
+offerprinter --cv cv.pdf --jd URL --template serif
+```
+
+| Template | Typeface | Portal-safe | For |
+|---|---|---|---|
+| `classic` | Helvetica | yes | the default; nothing to go wrong |
+| `compact` | Helvetica | yes | when two pages need to be one |
+| `serif` | Times | yes | law, academia, policy |
+| `rule` | Helvetica | yes | a hairline under each section, for skim-readers |
+| `accent` | Helvetica | email only | one colour, headings only |
+| `mono` | Courier | yes | reads as engineering |
+
+**Why only six, and why so restrained.** A CV is read twice: once by a parser that
+wants plain text in a standard font, and once by a person with forty tabs open. The
+compromise most builders make is to serve the human and quietly fail the machine —
+two columns, an icon font, a text box for the sidebar, and an ATS that returns your
+name and nothing else.
+
+So every template here stays on the safe side of that line. All of them use one of
+the 14 PDF base fonts, so nothing is embedded and the text always extracts; none
+use columns, tables, images or text boxes. What varies is typeface, spacing, rules,
+capitalisation and one accent colour — the parts a human notices and a parser
+ignores.
+
+`accent` is labelled *email only* rather than being left off the list: it extracts
+cleanly, but carries enough colour that a strict parser could lose a heading. Send
+that one to a person, not a portal.
+
+The test suite asserts, for every template, that the rendered PDF contains no
+embedded font program, no `/Image` or `/XObject`, and that the name, email and
+every bullet come back out of a naive text extraction. That is the claim, and it
+is checked rather than asserted.
+
+Set a default in `config.toml`:
+
+```toml
+[output]
+template = "rule"
+```
+
 ## How do I install OfferPrinter?
 
 <!-- AEO Answer Capsule — 57 words -->

{offerprinter-0.3.0 → offerprinter-0.4.0}/offerprinter/cli.py

@@ -30,6 +30,7 @@ from __future__ import annotations
 from pathlib import Path
 
 import typer
+from rich import box
 from rich.console import Console
 from rich.panel import Panel
 from rich.table import Table
@@ -80,7 +81,22 @@ def _version_cb(value: bool) -> None:
         raise typer.Exit()
 
 
-def _load_cv(cv: Path | None, cv_text: str | None) -> ResumeInput:
+def _load_cv(
+    cv: Path | None, cv_text: str | None, linkedin: Path | None = None
+) -> ResumeInput:
+    if linkedin:
+        from offerprinter.services.linkedin import import_profile
+
+        try:
+            markdown = import_profile(linkedin)
+        except Exception as exc:  # noqa: BLE001
+            console.print(f"[red]Could not read that LinkedIn export:[/red] {exc}")
+            raise typer.Exit(code=1) from exc
+        console.print(
+            f"[grey62]Imported {len(markdown):,} characters from {linkedin.name}. "
+            "Nothing was added that was not in the export.[/grey62]"
+        )
+        return cv_from_text(markdown)
     try:
         return cv_from_text(cv_text) if cv_text else extract_cv(cv)  # type: ignore[arg-type]
     except Exception as exc:  # noqa: BLE001
@@ -121,6 +137,7 @@ def _apply_overrides(
     redact: bool = False,
     no_verify: bool = False,
     no_cache: bool = False,
+    template: str | None = None,
 ) -> None:
     if provider:
         config.llm.provider = provider
@@ -135,6 +152,14 @@ def _apply_overrides(
         config.output.formats = [
             f.strip().lower().lstrip(".") for f in formats.split(",") if f.strip()
         ]
+    if template:
+        from offerprinter.services.themes import get_theme
+
+        try:
+            config.output.template = get_theme(template).name
+        except KeyError as exc:
+            console.print(f"[red]{exc.args[0]}[/red]")
+            raise typer.Exit(code=2) from exc
     if no_track:
         config.output.track = False
     if sequential:
@@ -299,6 +324,14 @@ def run(
     cv_text: str | None = typer.Option(
         None, "--cv-text", help="Paste your CV as raw text instead of a file."
     ),
+    linkedin: Path | None = typer.Option(
+        None,
+        "--linkedin",
+        help=(
+            "A LinkedIn export instead of a CV: the .pdf from More > Save to PDF, "
+            "or the .zip from Get a copy of your data."
+        ),
+    ),
     jd: str | None = typer.Option(
         None,
         "--jd",
@@ -327,6 +360,11 @@ def run(
     output_dir: Path | None = typer.Option(
         None, "--output-dir", "-o", help="Where to write the package (default ./output)."
     ),
+    template: str | None = typer.Option(
+        None,
+        "--template",
+        help="PDF template: classic, compact, serif, rule, accent, mono. See `offerprinter templates`.",
+    ),
     formats: str | None = typer.Option(
         None, "--formats", help="Comma-separated output formats: md, docx, pdf."
     ),
@@ -373,17 +411,22 @@ def run(
         return
 
     # ---- resolve inputs ---------------------------------------------------
-    if not cv and not cv_text:
-        console.print("[red]Error:[/red] provide a CV with --cv or --cv-text.")
+    if not cv and not cv_text and not linkedin:
+        console.print(
+            "[red]Error:[/red] provide a CV with --cv or --cv-text, "
+            "or a LinkedIn export with --linkedin."
+        )
         raise typer.Exit(code=2)
     if not jd and not jd_file and not jd_dir:
         console.print("[red]Error:[/red] provide a job with --jd, --jd-file, or --jd-dir.")
         raise typer.Exit(code=2)
 
     config = load_config(config_file)
-    _apply_overrides(config, provider, model, locale, output_dir, formats, no_track, sequential)
+    _apply_overrides(
+        config, provider, model, locale, output_dir, formats, no_track, sequential, template=template
+    )
 
-    resume = _load_cv(cv, cv_text)
+    resume = _load_cv(cv, cv_text, linkedin)
 
     # ---- batch mode -------------------------------------------------------
     if jd_dir:
@@ -899,6 +942,88 @@ def practice_command(
     console.print(f"[grey62]Saved to {path}[/grey62]")
 
 
+@app.command("templates")
+def templates_command(
+    sample: Path | None = typer.Option(
+        None, "--sample", help="Render one PDF per template into this folder."
+    ),
+) -> None:
+    """List the PDF templates, and optionally print a sample of each.
+
+    Every one of them stays inside what an ATS can parse -- base-14 fonts, no
+    columns, no tables, no images. What varies is typeface, spacing, rules and
+    one accent colour, which is the part a human notices and a parser ignores.
+    """
+    from offerprinter.services.pdf_writer import write_pdf
+    from offerprinter.services.themes import THEMES
+
+    table = Table(box=box.SIMPLE, show_header=True, header_style="bold")
+    table.add_column("Template")
+    table.add_column("Typeface")
+    table.add_column("Portal-safe")
+    table.add_column("What it is for")
+    for theme in THEMES.values():
+        table.add_row(
+            theme.name,
+            theme.typeface.regular,
+            "[green]yes[/green]" if theme.ats else "[yellow]email only[/yellow]",
+            theme.description,
+        )
+    console.print()
+    console.print(table)
+    console.print(
+        "[grey62]'email only' still extracts cleanly; it just carries enough colour that a "
+        "strict parser could lose a heading. Send it to a person, not a portal.[/grey62]"
+    )
+
+    if sample:
+        sample.mkdir(parents=True, exist_ok=True)
+        for theme in THEMES.values():
+            write_pdf(_SAMPLE_CV, sample / f"sample-{theme.name}.pdf", theme)
+        console.print(f"\n[green]Wrote {len(THEMES)} samples to[/green] {sample}")
+    else:
+        console.print("[grey62]offerprinter templates --sample ./samples  prints one of each.[/grey62]")
+    console.print()
+
+
+#: Used only by `templates --sample`. Invented person, so nothing real is written.
+_SAMPLE_CV = """# Ada Lovelace
+
+Analytical Engines - London - ada@example.com - linkedin.com/in/example
+
+## Summary
+
+Engineer with ten years turning mechanical specifications into working programs.
+Published the first algorithm intended for a machine.
+
+## Experience
+
+### Principal Engineer - Difference Engine Co
+*Jan 2019 - Present*
+
+- Shipped the **first published algorithm**, six weeks ahead of schedule
+- Cut crank turns per calculation by 40%, which halved operator fatigue
+- Wrote the notes that three generations of engineers learned the machine from
+
+### Analyst - Royal Society
+*2016 - 2019*
+
+- Translated Menabrea's memoir and added notes three times its length
+
+## Education
+
+- University of London, Mathematics
+
+## Skills
+
+Analytical engines, algorithm design, technical writing, translation
+
+---
+
+> Every line above came from a source document. Nothing was invented.
+"""
+
+
 @app.command("verify")
 def verify_command(
     package_dir: Path = typer.Argument(..., help="An output/<company>-<role> folder to check."),

{offerprinter-0.3.0 → offerprinter-0.4.0}/offerprinter/config.py

@@ -162,6 +162,7 @@ def load_config(config_path: str | os.PathLike[str] | None = None) -> Config:
         ),
         track=_env_bool("OFFERPRINTER_TRACK", bool(out_raw.get("track", True))),
         redact=_env_bool("OFFERPRINTER_REDACT", bool(out_raw.get("redact", False))),
+        template=_first_env("OFFERPRINTER_TEMPLATE") or out_raw.get("template", "classic"),
     )
 
     # ---- generation --------------------------------------------------------

{offerprinter-0.3.0 → offerprinter-0.4.0}/offerprinter/controllers/pipeline.py

@@ -115,7 +115,12 @@ class Pipeline:
         package.usage = Usage(**self.provider.usage.model_dump())
 
         # 7. Write to disk.
-        written = write_package(package, self.config.output.dir, self.config.output.formats)
+        written = write_package(
+            package,
+            self.config.output.dir,
+            self.config.output.formats,
+            self.config.output.template,
+        )
         out_dir = Path(self.config.output.dir) / slug
         yield PipelineEvent(
             kind="written",

{offerprinter-0.3.0 → offerprinter-0.4.0}/offerprinter/models/schemas.py

@@ -53,6 +53,8 @@ class OutputConfig(BaseModel):
     track: bool = True
     #: Strip name, email, phone and links before the provider ever sees the CV.
     redact: bool = False
+    #: PDF template name. See `offerprinter templates`.
+    template: str = "classic"
 
 
 class GenerationConfig(BaseModel):