resume-builder

简历生成器

使用结构化数据和多种模板样式，创建专业的 PDF 简历。支持 JSON 输入、自定义板块和适合 ATS 的格式。

快速开始

from scripts.resume_builder import ResumeBuilder

# Build resume programmatically
resume = ResumeBuilder()
resume.set_contact("John Smith", "[email protected]", "555-123-4567", "San Francisco, CA")
resume.set_summary("Experienced software engineer with 5+ years...")
resume.add_experience("Software Engineer", "Tech Corp", "2020-Present", [
    "Led development of microservices architecture",
    "Improved system performance by 40%"
])
resume.add_education("B.S. Computer Science", "State University", "2019")
resume.add_skills(["Python", "JavaScript", "AWS", "Docker"])
resume.generate().save("resume.pdf")

# From JSON
resume = ResumeBuilder.from_json("resume_data.json")
resume.generate().save("resume.pdf")

功能

• 多种模板：现代、经典、简约、高管风格
• 适合 ATS：格式简洁，可通过申请人跟踪系统审核
• 自定义板块：工作经历、教育背景、技能、项目、证书
• 灵活输入：Python API 或 JSON 数据
• 专业输出：排版规范的简洁 PDF
• 链接：作品集、LinkedIn、GitHub 的可点击 URL

API 参考

初始化

resume = ResumeBuilder()
resume = ResumeBuilder(template="modern")
resume = ResumeBuilder.from_json("data.json")
resume = ResumeBuilder.from_dict(data)

联系信息

# Basic contact
resume.set_contact(
    name="John Smith",
    email="[email protected]",
    phone="555-123-4567",
    location="San Francisco, CA"
)

# With links
resume.set_contact(
    name="John Smith",
    email="[email protected]",
    phone="555-123-4567",
    location="San Francisco, CA",
    linkedin="linkedin.com/in/johnsmith",
    github="github.com/johnsmith",
    website="johnsmith.dev"
)

个人简介／求职目标

# Professional summary
resume.set_summary(
    "Experienced software engineer with 5+ years building scalable "
    "web applications. Passionate about clean code and mentoring."
)

# Or objective statement
resume.set_objective(
    "Seeking a senior engineering role where I can leverage my "
    "expertise in distributed systems and cloud architecture."
)

工作经历

# Add experience entry
resume.add_experience(
    title="Senior Software Engineer",
    company="Tech Corporation",
    dates="Jan 2020 - Present",
    bullets=[
        "Led team of 5 engineers in developing microservices architecture",
        "Reduced API response time by 60% through optimization",
        "Implemented CI/CD pipeline reducing deployment time by 80%"
    ],
    location="San Francisco, CA"  # Optional
)

# Multiple entries
resume.add_experience("Software Engineer", "Startup Inc", "2018-2020", [
    "Built real-time notification system serving 1M+ users",
    "Developed RESTful APIs using Python and FastAPI"
])

教育背景

# Add education
resume.add_education(
    degree="Bachelor of Science in Computer Science",
    school="State University",
    year="2018",
    gpa="3.8",  # Optional
    honors="Magna Cum Laude"  # Optional
)

# With coursework
resume.add_education(
    degree="M.S. Data Science",
    school="Tech University",
    year="2020",
    coursework=["Machine Learning", "Statistical Analysis", "Big Data"]
)

技能

# Simple skills list
resume.add_skills(["Python", "JavaScript", "React", "AWS", "Docker"])

# Categorized skills
resume.add_skills({
    "Languages": ["Python", "JavaScript", "Go", "SQL"],
    "Frameworks": ["React", "Django", "FastAPI"],
    "Tools": ["Docker", "Kubernetes", "AWS", "Git"]
})

项目

# Add project
resume.add_project(
    name="Open Source Library",
    description="Data validation library with 1000+ GitHub stars",
    technologies=["Python", "PyPI"],
    url="github.com/user/project"  # Optional
)

证书

resume.add_certification("AWS Solutions Architect", "Amazon", "2023")
resume.add_certification("Professional Scrum Master", "Scrum.org", "2022")

其他板块

# Languages
resume.add_languages(["English (Native)", "Spanish (Fluent)", "French (Basic)"])

# Volunteer experience
resume.add_volunteer(
    role="Tech Mentor",
    organization="Code for Good",
    dates="2021 - Present",
    description="Mentor underrepresented students in programming"
)

# Publications
resume.add_publication(
    title="Scaling Microservices",
    venue="Tech Blog",
    year="2023",
    url="blog.com/article"
)

# Custom section
resume.add_custom_section("Awards", [
    "Employee of the Year 2022",
    "Hackathon Winner - Best Innovation"
])

模板和样式

# Set template
resume.set_template("modern")    # Clean, contemporary
resume.set_template("classic")   # Traditional, formal
resume.set_template("minimal")   # Simple, ATS-optimized
resume.set_template("executive") # Premium, senior roles

# Custom colors
resume.set_colors(
    primary="#2563eb",   # Headers
    text="#333333"       # Body text
)

# Margins
resume.set_margins(top=0.5, bottom=0.5, left=0.6, right=0.6)

生成

# Generate and save
resume.generate().save("resume.pdf")

# Get PDF bytes
pdf_bytes = resume.to_bytes()

数据格式

JSON 格式

{
  "contact": {
    "name": "John Smith",
    "email": "[email protected]",
    "phone": "555-123-4567",
    "location": "San Francisco, CA",
    "linkedin": "linkedin.com/in/johnsmith",
    "github": "github.com/johnsmith"
  },
  "summary": "Experienced software engineer...",
  "experience": [
    {
      "title": "Senior Software Engineer",
      "company": "Tech Corp",
      "dates": "2020 - Present",
      "location": "San Francisco, CA",
      "bullets": [
        "Led development of microservices",
        "Improved performance by 40%"
      ]
    }
  ],
  "education": [
    {
      "degree": "B.S. Computer Science",
      "school": "State University",
      "year": "2018",
      "gpa": "3.8"
    }
  ],
  "skills": {
    "Languages": ["Python", "JavaScript"],
    "Frameworks": ["React", "Django"]
  },
  "projects": [
    {
      "name": "Open Source Tool",
      "description": "Description here",
      "technologies": ["Python"],
      "url": "github.com/project"
    }
  ],
  "certifications": [
    {
      "name": "AWS Certified",
      "issuer": "Amazon",
      "year": "2023"
    }
  ]
}

CLI 用法

# From JSON file
python resume_builder.py --input resume.json --output resume.pdf

# With template
python resume_builder.py --input data.json --template modern --output resume.pdf

# Quick resume (interactive prompts)
python resume_builder.py --quick --output resume.pdf

CLI 参数

参数	描述	默认值
--input	输入 JSON 文件	必填
--output	输出 PDF 路径	resume.pdf
--template	模板样式	modern

模板

现代

• 简洁的无衬线字体
• 蓝色点缀色
• 清晰的板块标题
• 适合技术岗位

经典

• 传统衬线字体
• 黑色和灰色
• 正式的版式
• 适合传统行业

简约

• 最大限度地兼容 ATS
• 简单的格式
• 无颜色或图形
• 最适合在线申请

高管

• 高端外观
• 优雅的排版
• 含蓄的点缀
• 适合高级职位

最佳实践

1. 保持简洁：工作经验少于 10 年时控制在 1 页，最多 2 页
2. 使用行动动词：“领导”“开发”“改进”“达成”
3. 量化成果：“销售额增长 25%”“管理 8 人团队”
4. 针对职位调整：为每次申请自定义技能和个人简介
5. 适合 ATS：使用标准板块标题，避免使用表格和图形

依赖项

reportlab>=4.0.0
Pillow>=10.0.0

限制

• 仅支持 PDF 输出
• 针对英语优化
• 最多 2 页
• 不支持照片（符合 ATS 最佳实践）