codeurcv 0.5.0

A Python library to generate LaTeX resumes from YAML configuration files using Jinja2 templates.

📄 codeurcv

Turn a simple YAML or JSON file into a professional resume — instantly.

Whether you're a student, working professional, or researcher — write your details once, get a polished PDF resume every time.

---

✨ Features

• Simple input format — describe your resume in a human-readable .yml or .json file. No LaTeX knowledge required.
• Premium templates for free — choose from a curated set of professionally designed resume templates.
• GitHub Action — automate resume generation on every push. Always have an up-to-date PDF in your repo.
• Supports all profiles — students, working professionals, and researchers are all first-class citizens.

---

🚀 Quickstart

# config.yml
basic_details:
  name: Jane Doe
  email: [e-mail]
  phone: "[phone]"
  location: San Francisco, CA
  linkedin: linkedin.com/in/janedoe
  github: github.com/janedoe

summary: >
  Full-stack engineer with 5 years of experience building scalable web applications.

education:
  - institution: University of California, Berkeley
    degree: B.S. Computer Science
    year: 2019

work:
  - company: Acme Corp
    role: Senior Engineer
    start: Jan 2021
    end: Present
    highlights:
      - Led migration to microservices, reducing latency by 40%
      - Mentored a team of 4 junior engineers

skills:
  - category: Languages
    featured: 
        - Python
        - TypeScript
        - Go
  - category: Tools
    featured: 
        - Docker
        - Kubernetes
        - PostgreSQL

codeurcv generate example/config.yml
# → resume.pdf

---

📦 Installation

pip install codeurcv

Dependencies

codeurcv requires two external tools to generate PDFs:

Pandoc

Pandoc is a universal document converter used to process templates.

Platform	Command
Windows	winget install --id JohnMacFarlane.Pandoc or choco install pandoc
macOS	brew install pandoc
Debian/Ubuntu	sudo apt install pandoc
Fedora/RHEL	sudo dnf install pandoc
Arch/Manjaro	sudo pacman -S pandoc

→ Full Pandoc installation guide

pdflatex (TeX Live / MiKTeX)

pdflatex is the LaTeX engine used to render the final PDF.

Platform	Command
Windows	winget install --id MiKTeX.MiKTeX or choco install miktex
macOS	brew install --cask mactex
Debian/Ubuntu	sudo apt install texlive-latex-base
Fedora/RHEL	sudo dnf install texlive-latex
Arch/Manjaro	sudo pacman -S texlive-basic
openSUSE	sudo zypper install texlive-latex

→ TeX Live installation guide · MiKTeX for Windows

---

🖼️ Templates

Name	Best For
classic	All-purpose, clean single column
modern	Tech roles, sidebar layout
academic	Researchers, publications-focused
minimalist	Design roles, typography-forward

codeurcv generate config.yml --template minimalist

---

📖 Local Setup

See SETUP.md for full developer setup instructions.

---

⚡ GitHub Action

Automate resume generation on every push using the official GitHub Action.

- uses: crackedngineer/codeurcv-action@v1
  with:
    config-path: config.yml
    out-dir: output
    template: minimalist
    filename: john-doe-resume

→ codeurcv-action on GitHub · View on Marketplace

---

🤝 Contributing

See CONTRIBUTING.md — contributions are welcome!

---

📜 License

MIT © codeurcv contributors