Продуктивность

Резюме из JSON

Собирает аккуратное HTML-резюме из структурированного JSON-файла.

Python Windows macOS Linux Средний
Скачать resume.py
Описание

Что делает скрипт

Скрипт принимает данные об опыте, навыках и образовании и создаёт автономную 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.json
  • python resume.py --data resume.json --output resume.html
  • python resume.py --data resume.json --output resume.html --force
Зависимости

Что понадобится

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux 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())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get productivity-resume
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Продуктивность

Заметки, время, задачи, напоминания и автоматизация рутины.