Резюме из JSON
Собирает аккуратное HTML-резюме из структурированного JSON-файла.
Что делает скрипт
Скрипт принимает данные об опыте, навыках и образовании и создаёт автономную HTML-страницу для печати или отправки. Команда init записывает пример структуры в новый файл. Существующий результат не перезаписывается без флага force.
- Проверьте, что в JSON нет лишних персональных данных перед публикацией.
Быстрый старт
python resume.py --data resume.json --output resume.html
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
python resume.py --init --output resume.example.jsonpython resume.py --data resume.json --output resume.htmlpython resume.py --data resume.json --output resume.html --force
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
resume.py
#!/usr/bin/env python3
"""HTML-резюме из JSON."""
from __future__ import annotations
import argparse
import html
import json
from pathlib import Path
SAMPLE = {
"name": "Имя Фамилия",
"title": "Специалист по данным",
"email": "user@example.com",
"phone": "+1 555 0100",
"site": "https://example.com",
"summary": "Короткий абзац о профессиональном опыте и интересах.",
"skills": ["Python", "SQL", "Визуализация данных"],
"experience": [
{
"company": "Example Company",
"role": "Аналитик",
"start": "2023-01",
"end": "настоящее время",
"bullets": ["Собирал отчёты", "Автоматизировал рутину"],
}
],
"education": [
{"school": "Example University", "degree": "Прикладная информатика", "year": "2022"}
],
}
def esc(value) -> str:
return html.escape(str(value))
def render(data: dict) -> str:
skills = "".join(f"<li>{esc(item)}</li>" for item in data.get("skills", []))
experience = []
for job in data.get("experience", []):
bullets = "".join(f"<li>{esc(item)}</li>" for item in job.get("bullets", []))
experience.append(
"<article class='job'>"
f"<h3>{esc(job.get('role', ''))}</h3>"
f"<div class='muted'>{esc(job.get('company', ''))} · {esc(job.get('start', ''))} - {esc(job.get('end', ''))}</div>"
f"<ul>{bullets}</ul>"
"</article>"
)
education = "".join(
f"<li><strong>{esc(item.get('school', ''))}</strong>, {esc(item.get('degree', ''))}, {esc(item.get('year', ''))}</li>"
for item in data.get("education", [])
)
return f"""<!doctype html>
<html lang="ru">
<head>
<meta charset="utf-8">
<title>{esc(data.get('name', 'Резюме'))}</title>
<style>
body {{ font-family: system-ui, sans-serif; color: #111827; max-width: 800px; margin: 40px auto; padding: 0 20px; line-height: 1.55; }}
h1 {{ margin-bottom: 2px; }}
h2 {{ border-bottom: 2px solid #c2410c; padding-bottom: 4px; margin-top: 30px; }}
.muted {{ color: #6b7280; }}
.contacts {{ color: #374151; }}
.job {{ margin-bottom: 18px; }}
.job h3 {{ margin-bottom: 2px; }}
ul {{ margin-top: 6px; }}
</style>
</head>
<body>
<h1>{esc(data.get('name', ''))}</h1>
<div class="muted">{esc(data.get('title', ''))}</div>
<div class="contacts">{esc(data.get('email', ''))} · {esc(data.get('phone', ''))} · {esc(data.get('site', ''))}</div>
<h2>О себе</h2>
<p>{esc(data.get('summary', ''))}</p>
<h2>Навыки</h2>
<ul>{skills}</ul>
<h2>Опыт</h2>
{''.join(experience)}
<h2>Образование</h2>
<ul>{education}</ul>
</body>
</html>
"""
def main() -> int:
parser = argparse.ArgumentParser(description="Резюме из JSON")
parser.add_argument("--data", type=Path)
parser.add_argument("--output", type=Path, default=Path("resume.html"))
parser.add_argument("--init", action="store_true")
parser.add_argument("--force", action="store_true")
args = parser.parse_args()
if args.init:
output = args.output.expanduser()
if output.exists() and not args.force:
parser.error(f"Файл уже существует: {output}")
output.parent.mkdir(parents=True, exist_ok=True)
output.write_text(json.dumps(SAMPLE, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
print(f"Пример резюме сохранён: {output}")
return 0
if not args.data:
parser.error("Укажите --data или --init")
source = args.data.expanduser()
if not source.is_file():
parser.error(f"Файл не найден: {source}")
try:
data = json.loads(source.read_text(encoding="utf-8"))
except json.JSONDecodeError as error:
parser.error(f"Ошибка JSON: {error}")
if not isinstance(data, dict):
parser.error("Корень JSON должен быть объектом")
output = args.output.expanduser()
if output.suffix.lower() != ".html":
parser.error("Поддерживается только расширение .html")
if output.exists() and not args.force:
parser.error(f"Файл уже существует: {output}. Добавьте --force.")
output.parent.mkdir(parents=True, exist_ok=True)
output.write_text(render(data), encoding="utf-8")
print(f"Резюме сохранено: {output}")
return 0
if __name__ == "__main__":
raise SystemExit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.