simple-resume 0.1.9__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (116) hide show
  1. simple_resume/__init__.py +132 -0
  2. simple_resume/core/__init__.py +47 -0
  3. simple_resume/core/colors.py +215 -0
  4. simple_resume/core/config.py +672 -0
  5. simple_resume/core/constants/__init__.py +207 -0
  6. simple_resume/core/constants/colors.py +98 -0
  7. simple_resume/core/constants/files.py +28 -0
  8. simple_resume/core/constants/layout.py +58 -0
  9. simple_resume/core/dependencies.py +258 -0
  10. simple_resume/core/effects.py +154 -0
  11. simple_resume/core/exceptions.py +261 -0
  12. simple_resume/core/file_operations.py +68 -0
  13. simple_resume/core/generate/__init__.py +21 -0
  14. simple_resume/core/generate/exceptions.py +69 -0
  15. simple_resume/core/generate/html.py +233 -0
  16. simple_resume/core/generate/pdf.py +659 -0
  17. simple_resume/core/generate/plan.py +131 -0
  18. simple_resume/core/hydration.py +55 -0
  19. simple_resume/core/importers/__init__.py +3 -0
  20. simple_resume/core/importers/json_resume.py +284 -0
  21. simple_resume/core/latex/__init__.py +60 -0
  22. simple_resume/core/latex/context.py +56 -0
  23. simple_resume/core/latex/conversion.py +227 -0
  24. simple_resume/core/latex/escaping.py +68 -0
  25. simple_resume/core/latex/fonts.py +93 -0
  26. simple_resume/core/latex/formatting.py +81 -0
  27. simple_resume/core/latex/sections.py +218 -0
  28. simple_resume/core/latex/types.py +84 -0
  29. simple_resume/core/markdown.py +127 -0
  30. simple_resume/core/models.py +102 -0
  31. simple_resume/core/palettes/__init__.py +38 -0
  32. simple_resume/core/palettes/common.py +73 -0
  33. simple_resume/core/palettes/data/default_palettes.json +58 -0
  34. simple_resume/core/palettes/exceptions.py +33 -0
  35. simple_resume/core/palettes/fetch_types.py +52 -0
  36. simple_resume/core/palettes/generators.py +137 -0
  37. simple_resume/core/palettes/registry.py +76 -0
  38. simple_resume/core/palettes/resolution.py +123 -0
  39. simple_resume/core/palettes/sources.py +162 -0
  40. simple_resume/core/paths.py +21 -0
  41. simple_resume/core/protocols.py +134 -0
  42. simple_resume/core/py.typed +0 -0
  43. simple_resume/core/render/__init__.py +37 -0
  44. simple_resume/core/render/manage.py +199 -0
  45. simple_resume/core/render/plan.py +405 -0
  46. simple_resume/core/result.py +226 -0
  47. simple_resume/core/resume.py +609 -0
  48. simple_resume/core/skills.py +60 -0
  49. simple_resume/core/validation.py +321 -0
  50. simple_resume/py.typed +0 -0
  51. simple_resume/shell/__init__.py +3 -0
  52. simple_resume/shell/assets/static/css/README.md +213 -0
  53. simple_resume/shell/assets/static/css/common.css +641 -0
  54. simple_resume/shell/assets/static/css/fonts.css +42 -0
  55. simple_resume/shell/assets/static/css/preview.css +82 -0
  56. simple_resume/shell/assets/static/css/print.css +99 -0
  57. simple_resume/shell/assets/static/fonts/AvenirLTStd-Book.otf +0 -0
  58. simple_resume/shell/assets/static/fonts/AvenirLTStd-Light.otf +0 -0
  59. simple_resume/shell/assets/static/fonts/AvenirLTStd-Medium.otf +0 -0
  60. simple_resume/shell/assets/static/fonts/AvenirLTStd-Oblique.otf +0 -0
  61. simple_resume/shell/assets/static/fonts/AvenirLTStd-Roman.otf +0 -0
  62. simple_resume/shell/assets/static/fonts/fontawesome/Font Awesome 6 Brands-Regular-400.otf +0 -0
  63. simple_resume/shell/assets/static/fonts/fontawesome/Font Awesome 6 Free-Solid-900.otf +0 -0
  64. simple_resume/shell/assets/static/images/default_profile_1.jpg +0 -0
  65. simple_resume/shell/assets/static/images/default_profile_2.png +0 -0
  66. simple_resume/shell/assets/static/schema.json +236 -0
  67. simple_resume/shell/assets/static/themes/README.md +208 -0
  68. simple_resume/shell/assets/static/themes/bold.yaml +64 -0
  69. simple_resume/shell/assets/static/themes/classic.yaml +64 -0
  70. simple_resume/shell/assets/static/themes/executive.yaml +64 -0
  71. simple_resume/shell/assets/static/themes/minimal.yaml +64 -0
  72. simple_resume/shell/assets/static/themes/modern.yaml +64 -0
  73. simple_resume/shell/assets/templates/html/cover.html +129 -0
  74. simple_resume/shell/assets/templates/html/demo.html +13 -0
  75. simple_resume/shell/assets/templates/html/resume_base.html +453 -0
  76. simple_resume/shell/assets/templates/html/resume_no_bars.html +316 -0
  77. simple_resume/shell/assets/templates/html/resume_with_bars.html +362 -0
  78. simple_resume/shell/cli/__init__.py +35 -0
  79. simple_resume/shell/cli/main.py +975 -0
  80. simple_resume/shell/cli/palette.py +75 -0
  81. simple_resume/shell/cli/random_palette_demo.py +407 -0
  82. simple_resume/shell/config.py +96 -0
  83. simple_resume/shell/effect_executor.py +211 -0
  84. simple_resume/shell/file_opener.py +308 -0
  85. simple_resume/shell/generate/__init__.py +37 -0
  86. simple_resume/shell/generate/core.py +650 -0
  87. simple_resume/shell/generate/lazy.py +284 -0
  88. simple_resume/shell/io_utils.py +199 -0
  89. simple_resume/shell/palettes/__init__.py +1 -0
  90. simple_resume/shell/palettes/fetch.py +63 -0
  91. simple_resume/shell/palettes/loader.py +321 -0
  92. simple_resume/shell/palettes/remote.py +179 -0
  93. simple_resume/shell/pdf_executor.py +52 -0
  94. simple_resume/shell/py.typed +0 -0
  95. simple_resume/shell/render/__init__.py +1 -0
  96. simple_resume/shell/render/latex.py +308 -0
  97. simple_resume/shell/render/operations.py +240 -0
  98. simple_resume/shell/resume_extensions.py +737 -0
  99. simple_resume/shell/runtime/__init__.py +7 -0
  100. simple_resume/shell/runtime/content.py +190 -0
  101. simple_resume/shell/runtime/generate.py +497 -0
  102. simple_resume/shell/runtime/lazy.py +138 -0
  103. simple_resume/shell/runtime/lazy_import.py +173 -0
  104. simple_resume/shell/service_locator.py +80 -0
  105. simple_resume/shell/services.py +256 -0
  106. simple_resume/shell/session/__init__.py +6 -0
  107. simple_resume/shell/session/config.py +35 -0
  108. simple_resume/shell/session/manage.py +386 -0
  109. simple_resume/shell/strategies.py +181 -0
  110. simple_resume/shell/themes/__init__.py +35 -0
  111. simple_resume/shell/themes/loader.py +230 -0
  112. simple_resume-0.1.9.dist-info/METADATA +201 -0
  113. simple_resume-0.1.9.dist-info/RECORD +116 -0
  114. simple_resume-0.1.9.dist-info/WHEEL +4 -0
  115. simple_resume-0.1.9.dist-info/entry_points.txt +5 -0
  116. simple_resume-0.1.9.dist-info/licenses/LICENSE +21 -0
@@ -0,0 +1,230 @@
1
+ """Theme loading operations (shell layer with I/O).
2
+
3
+ This module handles loading theme presets from the themes directory
4
+ and merging them with user configuration.
5
+ """
6
+
7
+ from __future__ import annotations
8
+
9
+ import logging
10
+ from functools import lru_cache
11
+ from pathlib import Path
12
+ from typing import Any
13
+
14
+ import yaml
15
+
16
+ logger = logging.getLogger(__name__)
17
+
18
+ # Theme directory relative to assets
19
+ THEME_DIR_NAME = "themes"
20
+
21
+
22
+ def get_themes_directory() -> Path:
23
+ """Get the path to the bundled themes directory."""
24
+ # Late import to avoid circular dependency
25
+ from simple_resume.shell.config import ASSETS_ROOT # noqa: PLC0415
26
+
27
+ return ASSETS_ROOT / "static" / THEME_DIR_NAME
28
+
29
+
30
+ def list_available_themes() -> list[str]:
31
+ """List all available theme names.
32
+
33
+ Returns:
34
+ List of theme names (without .yaml extension).
35
+
36
+ """
37
+ themes_dir = get_themes_directory()
38
+ if not themes_dir.exists():
39
+ return []
40
+
41
+ return sorted(p.stem for p in themes_dir.glob("*.yaml") if p.stem != "README")
42
+
43
+
44
+ @lru_cache(maxsize=32)
45
+ def _load_theme_file(theme_path: Path) -> dict[str, Any]:
46
+ """Load and cache a theme file.
47
+
48
+ Args:
49
+ theme_path: Path to the theme YAML file.
50
+
51
+ Returns:
52
+ Theme configuration dictionary.
53
+
54
+ Raises:
55
+ FileNotFoundError: If theme file doesn't exist.
56
+ ValueError: If theme file is invalid YAML.
57
+
58
+ """
59
+ if not theme_path.exists():
60
+ raise FileNotFoundError(f"Theme file not found: {theme_path}")
61
+
62
+ try:
63
+ with theme_path.open("r", encoding="utf-8") as f:
64
+ data = yaml.safe_load(f)
65
+ except yaml.YAMLError as exc:
66
+ raise ValueError(f"Invalid theme YAML: {theme_path}: {exc}") from exc
67
+
68
+ if not isinstance(data, dict):
69
+ raise ValueError(f"Theme file must contain a dictionary: {theme_path}")
70
+
71
+ return data
72
+
73
+
74
+ def load_theme(theme_name: str) -> dict[str, Any]:
75
+ """Load a theme by name.
76
+
77
+ Args:
78
+ theme_name: Name of the theme (without .yaml extension).
79
+
80
+ Returns:
81
+ Theme configuration dictionary (the 'config' block).
82
+
83
+ Raises:
84
+ FileNotFoundError: If theme doesn't exist.
85
+ ValueError: If theme file is invalid or theme name contains path traversal.
86
+
87
+ """
88
+ themes_dir = get_themes_directory()
89
+ theme_path = (themes_dir / f"{theme_name}.yaml").resolve()
90
+
91
+ # Validate path stays within themes directory (prevent path traversal)
92
+ if not theme_path.is_relative_to(themes_dir.resolve()):
93
+ raise ValueError(f"Invalid theme name: {theme_name}")
94
+
95
+ theme_data = _load_theme_file(theme_path)
96
+
97
+ # Return just the config block if present, otherwise return the whole dict
98
+ if "config" in theme_data:
99
+ return dict(theme_data["config"])
100
+
101
+ return dict(theme_data)
102
+
103
+
104
+ class ThemeLoadError(Exception):
105
+ """Raised when theme loading fails in strict mode."""
106
+
107
+
108
+ def apply_theme_to_config(
109
+ user_config: dict[str, Any],
110
+ theme_name: str,
111
+ *,
112
+ strict: bool = False,
113
+ ) -> dict[str, Any]:
114
+ """Apply a theme to user configuration.
115
+
116
+ Theme values are used as defaults - user values take precedence.
117
+
118
+ Args:
119
+ user_config: User's configuration dictionary.
120
+ theme_name: Name of the theme to apply.
121
+ strict: If True, raise ThemeLoadError on failure instead of falling back.
122
+
123
+ Returns:
124
+ Merged configuration with theme defaults and user overrides.
125
+
126
+ Raises:
127
+ ThemeLoadError: If strict=True and theme loading fails.
128
+
129
+ """
130
+ try:
131
+ theme_config = load_theme(theme_name)
132
+ except (FileNotFoundError, ValueError) as exc:
133
+ if strict:
134
+ raise ThemeLoadError(f"Failed to load theme '{theme_name}': {exc}") from exc
135
+ logger.warning("Failed to load theme '%s': %s", theme_name, exc)
136
+ return user_config
137
+
138
+ # Deep merge: theme provides defaults, user overrides
139
+ merged = _deep_merge(theme_config, user_config)
140
+
141
+ logger.debug("Applied theme '%s' to configuration", theme_name)
142
+ return merged
143
+
144
+
145
+ def _deep_merge(base: dict[str, Any], override: dict[str, Any]) -> dict[str, Any]:
146
+ """Deep merge two dictionaries.
147
+
148
+ Values from override take precedence. Nested dicts are merged recursively.
149
+
150
+ Args:
151
+ base: Base dictionary (theme defaults).
152
+ override: Override dictionary (user config).
153
+
154
+ Returns:
155
+ Merged dictionary.
156
+
157
+ """
158
+ result = base.copy()
159
+
160
+ for key, value in override.items():
161
+ if key in result and isinstance(result[key], dict) and isinstance(value, dict):
162
+ result[key] = _deep_merge(result[key], value)
163
+ else:
164
+ result[key] = value
165
+
166
+ return result
167
+
168
+
169
+ def resolve_theme_in_data(data: dict[str, Any]) -> dict[str, Any]:
170
+ """Resolve theme reference in resume data.
171
+
172
+ If the data contains a 'theme' key at the top level or in 'config',
173
+ loads the theme and merges it with existing config.
174
+
175
+ Args:
176
+ data: Resume data dictionary.
177
+
178
+ Returns:
179
+ Data with theme applied to config.
180
+
181
+ """
182
+ # Check for theme at top level
183
+ theme_name = data.get("theme")
184
+
185
+ # Also check inside config block
186
+ config = data.get("config", {})
187
+ if isinstance(config, dict) and "theme" in config:
188
+ theme_name = config.get("theme")
189
+
190
+ if not theme_name:
191
+ return data
192
+
193
+ if not isinstance(theme_name, str):
194
+ logger.warning("Invalid theme value: %s (expected string)", theme_name)
195
+ return data
196
+
197
+ # Load theme and merge with config
198
+ result = data.copy()
199
+ existing_config = result.get("config", {})
200
+ if not isinstance(existing_config, dict):
201
+ existing_config = {}
202
+
203
+ # Remove theme key from config (it's been processed)
204
+ existing_config = {k: v for k, v in existing_config.items() if k != "theme"}
205
+
206
+ # Apply theme (theme provides defaults, user config overrides)
207
+ merged_config = apply_theme_to_config(existing_config, theme_name)
208
+
209
+ result["config"] = merged_config
210
+
211
+ # Remove top-level theme key if present
212
+ result.pop("theme", None)
213
+
214
+ return result
215
+
216
+
217
+ def clear_theme_cache() -> None:
218
+ """Clear the theme file cache (for testing)."""
219
+ _load_theme_file.cache_clear()
220
+
221
+
222
+ __all__ = [
223
+ "ThemeLoadError",
224
+ "apply_theme_to_config",
225
+ "clear_theme_cache",
226
+ "get_themes_directory",
227
+ "list_available_themes",
228
+ "load_theme",
229
+ "resolve_theme_in_data",
230
+ ]
@@ -0,0 +1,201 @@
1
+ Metadata-Version: 2.4
2
+ Name: simple-resume
3
+ Version: 0.1.9
4
+ Summary: Generate PDF resumes from YAML data using HTML templates
5
+ Author-email: Alex Thola <alexthola@gmail.com>
6
+ Maintainer-email: Alex Thola <alexthola@gmail.com>
7
+ License: MIT
8
+ License-File: LICENSE
9
+ Requires-Python: >=3.10
10
+ Requires-Dist: jinja2<4.0,>=3.0
11
+ Requires-Dist: markdown<4.0,>=3.7
12
+ Requires-Dist: oyaml<2.0,>=1.0
13
+ Requires-Dist: palettable<4.0,>=3.3.3
14
+ Requires-Dist: weasyprint<63.0,>=62.1
15
+ Provides-Extra: utils
16
+ Requires-Dist: mypy<2.0,>=1.11.0; extra == 'utils'
17
+ Requires-Dist: pytest-cov<6.0,>=5.0.0; extra == 'utils'
18
+ Requires-Dist: pytest-mock<4.0,>=3.14.0; extra == 'utils'
19
+ Requires-Dist: pytest<9.0,>=8.3.3; extra == 'utils'
20
+ Requires-Dist: pytype>=2024.10.11; (python_version >= '3.10') and extra == 'utils'
21
+ Requires-Dist: ruff<1.0,>=0.7.0; extra == 'utils'
22
+ Requires-Dist: ty>=0.0.1a23; extra == 'utils'
23
+ Requires-Dist: types-markdown<4.0,>=3.7.2; extra == 'utils'
24
+ Description-Content-Type: text/markdown
25
+
26
+ ![Simple-Resume preview screenshot](assets/preview.png)
27
+
28
+ _Generate polished PDF and HTML resumes from a single YAML file._
29
+
30
+ [![PyPI Downloads](https://img.shields.io/pypi/dm/simple-resume?style=flat-square)](https://pypi.org/project/simple-resume/)
31
+ [![MIT License](https://img.shields.io/github/license/athola/simple-resume?style=flat-square)](https://github.com/athola/simple-resume/blob/main/LICENSE)
32
+ [![Code Quality](https://github.com/athola/simple-resume/workflows/Code%20Quality/badge.svg)](https://github.com/athola/simple-resume/actions/workflows/code-quality.yml)
33
+ [![Linting](https://github.com/athola/simple-resume/workflows/Linting/badge.svg)](https://github.com/athola/simple-resume/actions/workflows/lint.yml)
34
+ [![Test Suite](https://github.com/athola/simple-resume/workflows/Test%20Suite/badge.svg)](https://github.com/athola/simple-resume/actions/workflows/test.yml)
35
+ [![Code Coverage](https://codecov.io/gh/athola/simple-resume/branch/main/graph/badge.svg)](https://codecov.io/gh/athola/simple-resume)
36
+ [![PyPI Version](https://img.shields.io/pypi/v/simple-resume.svg)](https://pypi.org/project/simple-resume/)
37
+
38
+ # simple-resume
39
+
40
+ `simple-resume` is a Python 3.10+ CLI and library for converting structured YAML (or JSON Resume) into production-ready resumes (PDF, HTML, or LaTeX). Templates and static assets ship with the package such that users can render without needing to create additional content.
41
+
42
+ ## Supported platforms
43
+
44
+ - Python: 3.10+ (tested in CI)
45
+ - OS: Linux, macOS, Windows. PDF output uses WeasyPrint; ensure Cairo/Pango/GTK are available on your platform (see [Usage Guide](wiki/Usage-Guide.md#system-dependencies)).
46
+
47
+ ## Installation
48
+
49
+ ```bash
50
+ # With uv (recommended)
51
+ uv add simple-resume
52
+
53
+ # With pip
54
+ pip install simple-resume
55
+ ```
56
+
57
+ ## Why Simple-Resume
58
+
59
+ - Keep your resume version-controlled as plain YAML.
60
+ - Swap templates, palettes, and formats without rewriting content.
61
+ - Pure-Python core with shell adapters; effects are testable and side-effect aware.
62
+ - Bundled HTML templates and static assets prevent "TemplateNotFound" errors in wheels/editable installs.
63
+
64
+ ## Feature Comparison
65
+
66
+ | Feature | simple-resume | JSON Resume | HackMyResume | Resume.io |
67
+ |---------|---------------|-------------|---------------|-----------|
68
+ | **Open Source** | Yes | Yes | Yes | No |
69
+ | **Data Format** | YAML + JSON Resume | JSON | JSON/FRESH | Proprietary |
70
+ | **Version Control** | Yes (Git-friendly) | Yes (Git-friendly) | Yes (Git-friendly) | No (Cloud-only) |
71
+ | **Local Processing** | Yes (100% private) | Yes (100% private) | Yes (100% private) | No (Cloud storage) |
72
+ | **Template System** | HTML + Jinja2 | JSON themes | Multiple formats | Web builder |
73
+ | **LaTeX Support** | Yes (Professional) | No | No | No |
74
+ | **Python API** | Yes (Native) | No | No | No |
75
+ | **CLI Tools** | Yes | Yes | Yes | No |
76
+ | **Real-time Preview** | Yes (HTML + auto-reload) | No | No | Yes |
77
+ | **Custom Themes** | Yes (Unlimited) | Limited | Limited | Limited (Paid only) |
78
+ | **Color Palettes** | Yes (Professional) | No | Limited (Basic) | Limited |
79
+ | **Privacy** | Yes | Yes | Yes | No (Data stored on servers) |
80
+ | **Setup Time** | 5 min | 10 min | 15 min | 2 min |
81
+ | **Learning Curve** | Moderate | Easy | Easy | Easiest |
82
+
83
+ ### Key Advantages
84
+
85
+ **Best for Developers**: Version control, automation, Python integration, privacy
86
+ **Best for Privacy**: 100% local processing with no data exposure
87
+ **Most Flexible**: HTML templates + unlimited customization
88
+ **Professional Output**: LaTeX typesetting for academic/technical resumes
89
+
90
+ *See [Detailed Comparison](wiki/Comparison.md) for full analysis and use case recommendations.*
91
+
92
+ ### Development setup
93
+
94
+ ```bash
95
+ git clone https://github.com/athola/simple-resume.git
96
+ cd simple-resume
97
+ uv sync --dev --extra utils # or: pip install -e .[dev,utils]
98
+ ```
99
+
100
+ ## Quick start (CLI)
101
+
102
+ Create a minimal YAML in `resume_private/input/my_resume.yaml`:
103
+
104
+ > Note: JSON Resume (`*.json` from https://jsonresume.org) is also supported —
105
+ > drop it into your `input/` folder and `simple-resume` will auto-convert it at load time.
106
+ >
107
+ > Tip: Editor autocomplete is available via JSON Schema at
108
+ > `src/simple_resume/shell/assets/static/schema.json` (VS Code YAML extension supports schema association).
109
+
110
+ ```yaml
111
+ template: resume_no_bars
112
+ full_name: Jane Doe
113
+ email: jane.doe@example.com
114
+ body:
115
+ Experience:
116
+ - title: Senior Engineer
117
+ company: TechCorp
118
+ start: 2022
119
+ end: Present
120
+ description: |
121
+ - Lead microservices migration
122
+ - Improved latency by 40%
123
+ ```
124
+
125
+ Generate output:
126
+
127
+ ```bash
128
+ uv run simple-resume generate --format pdf # PDF
129
+ uv run simple-resume generate --format html --open # HTML + open in browser
130
+ ```
131
+
132
+ Built-in templates: `resume_no_bars`, `resume_with_bars`, `demo` (see `src/simple_resume/shell/assets/templates/html/`). Static assets are stored in `.../assets/static/`.
133
+
134
+ ## Python API
135
+
136
+ ```python
137
+ from simple_resume import generate, preview
138
+
139
+ # Generate with format overrides
140
+ results = generate("resume_private/input/my_resume.yaml", formats=["pdf", "html"])
141
+ print(results["pdf"].output_path)
142
+
143
+ # Browser preview with live reload
144
+ preview("resume_private/input/my_resume.yaml")
145
+ ```
146
+
147
+ For batch operations:
148
+
149
+ ```python
150
+ from simple_resume import ResumeSession
151
+
152
+ with ResumeSession(data_dir="resume_private") as session:
153
+ session.generate_all(format="pdf")
154
+ ```
155
+
156
+ ## Customization
157
+
158
+ - **Palettes**: `--palette "Professional Blue"` or `--palette path/to/palette.yaml`.
159
+ - **Custom templates**: `--template custom.html` with `--templates-dir /path/to/templates`.
160
+ - **LaTeX**: set `config.output_mode: latex` and compile with your TeX toolchain (see [Usage Guide](wiki/Usage-Guide.md#latex-output)).
161
+ - **Color utilities**: `simple_resume.core.colors.get_contrasting_text_color` for accessibility checks.
162
+
163
+ ## Release workflow
164
+
165
+ Releases are automated via GitHub Actions. To create a new release:
166
+
167
+ ```bash
168
+ # Tag the version (must start with 'v')
169
+ git tag v0.1.2
170
+ git push origin v0.1.2
171
+ ```
172
+
173
+ The workflow builds the package, generates a changelog from commit history, and publishes a GitHub release with distribution artifacts.
174
+
175
+ ## Workflows & docs
176
+
177
+ - **Guides**: [Getting Started](wiki/Getting-Started.md), [Usage](wiki/Usage-Guide.md), [Workflows](wiki/Workflows.md), [Path Handling](wiki/Path-Handling-Guide.md).
178
+ - **API Docs**: [API Reference](wiki/API-Reference.md), [API Stability Policy](wiki/API-Stability-Policy.md), [Shell Layer APIs](wiki/Shell-Layer-APIs.md).
179
+ - **Architecture**: [Architecture Guide](wiki/Architecture-Guide.md) and `wiki/architecture/`.
180
+ - **Migration**: [Migration Guide](wiki/Migration-Guide.md) plus [Generate module migration](wiki/Migration-Guide-Generate-Module.md).
181
+ - **Development**: [Development Guide](wiki/Development-Guide.md), [Contributing](wiki/Contributing.md), [PDF renderer evaluation](wiki/PDF-Renderer-Evaluation.md).
182
+ - **Samples**: `sample/` directory; `sample_dark_sidebar.html` preview.
183
+
184
+ ## Troubleshooting
185
+
186
+ - `TemplateNotFound`: confirm installation includes packaged assets (bundled in wheels/editable installs); custom templates require `--templates-dir`.
187
+ - PDF on Linux: install system libs `cairo`, `pango`, `gdk-pixbuf` (WeasyPrint requirement).
188
+
189
+ ## Contributing
190
+
191
+ 1. Follow the [Development Guide](wiki/Development-Guide.md) to set up tools.
192
+ 2. Run `make lint` and `make test` (or `make check-all validate`) before opening a PR.
193
+ 3. Submit issues or ideas in [GitHub Issues](https://github.com/athola/simple-resume/issues) or discussions.
194
+
195
+ ## License
196
+
197
+ MIT License. See [LICENSE](LICENSE).
198
+
199
+ ## Star history
200
+
201
+ [![Star History Chart](https://api.star-history.com/svg?repos=athola/simple-resume&type=date&legend=top-left)](https://www.star-history.com/#athola/simple-resume&type=date&legend=top-left)
@@ -0,0 +1,116 @@
1
+ simple_resume/__init__.py,sha256=Ogi1p7cGeuHX2bxqgYj8-_uxMK7pcwH84pExt6S8d4I,3746
2
+ simple_resume/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
3
+ simple_resume/core/__init__.py,sha256=45eyLIMl4xBIjxnM5_P9LLdvix_W-thQgsFrqEqb74g,1209
4
+ simple_resume/core/colors.py,sha256=2DJLkVrQi4c6NoKhjyN-UXWGZjMYqcfIU8N8CiAdUSw,7386
5
+ simple_resume/core/config.py,sha256=pmqTCIFFugU1oNU8A_Db5U3m78xzpBNfADp8Atr-418,24181
6
+ simple_resume/core/dependencies.py,sha256=a8bzSNfQO9EbOny3meO9LOCdQyplmn5NOw2pUkFBsWM,7593
7
+ simple_resume/core/effects.py,sha256=mZtUJ1UEMyBszD5BJa0WCHoOB5yHPNCehlVNBZOC-T8,3652
8
+ simple_resume/core/exceptions.py,sha256=bFzO5_5u9imA7ZGXWPgEZt9Cvy4HNddHgH2TSlfi98k,8079
9
+ simple_resume/core/file_operations.py,sha256=m87SKcC7IWWXbVX0VDB-aksOFAyJHvMJVn8NZJ0O0C8,1584
10
+ simple_resume/core/hydration.py,sha256=3K_8Yf3qFxPAVNyd47UGn6dHn9eTuyjikIpNfPHs1HM,1932
11
+ simple_resume/core/markdown.py,sha256=pfWxCxM4xdLrHrOOQvj5_whjjfhGZVOKO_wJmhJ1Eu8,4242
12
+ simple_resume/core/models.py,sha256=tJjenO0z_SRoY2oeycGsPLCF4X_KxEk-sxeNxIRLkjg,2780
13
+ simple_resume/core/paths.py,sha256=in5j6EK5UCbTVEuzN_NyAvQAzIRbfOMY2c7EHNegu8w,393
14
+ simple_resume/core/protocols.py,sha256=HyXKwvZZF5mCLaqFvPG6byZn08CfO_hOOCD2qaVua-4,3133
15
+ simple_resume/core/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
16
+ simple_resume/core/result.py,sha256=nFEtGV87NQMCoEWv3YxBxu-M63K290aQ9CIGLio37sA,7797
17
+ simple_resume/core/resume.py,sha256=xZeVAKd-6TlaC2M7xAaa88OEqM1m1u9oAvNJQ2xIYxM,20830
18
+ simple_resume/core/skills.py,sha256=pU3MUso1wTCKedQmrsm3UW1nXaiWschN9toPveffmvY,1968
19
+ simple_resume/core/validation.py,sha256=dvUw7bHOA_C8LZpc2Wh0zhcQ4mEvyryFbU3NMV1bpZg,9167
20
+ simple_resume/core/constants/__init__.py,sha256=JJ0gVmtEn3Rbgp2jZbCerEI0SBrFKRphr8u_SfPXv-I,6496
21
+ simple_resume/core/constants/colors.py,sha256=TzPtLDLyqUJ0qEVgvvy54lwUp86S_j-CF2u5nR7wQ7U,2752
22
+ simple_resume/core/constants/files.py,sha256=rOeTP3ORHeZgK-4zY8zGgWQYOATMt9OeH6s-PvDJN98,726
23
+ simple_resume/core/constants/layout.py,sha256=wGeZSlpDiTDyI6HzddeKf_0cg3tjvhgjOivy0KDw0pE,1621
24
+ simple_resume/core/generate/__init__.py,sha256=U7jP_YzPTfUQeXDKCHptrVES_B4N0NnNnxGBPBVLx5M,608
25
+ simple_resume/core/generate/exceptions.py,sha256=DAtDSrsneVqtNUciISGR7vQHphzx0PVSNanf-_Iq35U,2306
26
+ simple_resume/core/generate/html.py,sha256=Jfo4L1GsfSTz90-nRSIrRSqoAk3eeenEtCGB3PaMPiI,7936
27
+ simple_resume/core/generate/pdf.py,sha256=y1svPYzXmL7tWfmWAFPfuOqJyEQAeLZmmNsmTj_DRNo,23451
28
+ simple_resume/core/generate/plan.py,sha256=NnLCvVPdtBKkdKqlz0udiZu-kQ7q0ZXCZE84aiLPpIE,3974
29
+ simple_resume/core/importers/__init__.py,sha256=lviIF4l0gosz7eFmDA_hDXTD4Ts2zLOqZETwKWW1I0E,59
30
+ simple_resume/core/importers/json_resume.py,sha256=w9N5NF_8TfK7leIhe-z18ZriOPnhEBYqxo03CrU_x7c,9171
31
+ simple_resume/core/latex/__init__.py,sha256=YT8Od1dC7j7Wjq8H3-QhiXFRe-8OkUe5UW52dMIYYrE,1593
32
+ simple_resume/core/latex/context.py,sha256=YnbkZDz2pAiOHqOwiGLDXHsQTvyZVnsAOigkaz8GgGs,1807
33
+ simple_resume/core/latex/conversion.py,sha256=CBSNIX41o4XB0t4vt6_-cVCRhVpM8lpmCb7EJhxPnH8,6887
34
+ simple_resume/core/latex/escaping.py,sha256=uVFYflM2zvp2Dc7_UUz17wzLIG6qve8WXWXwQYL1mho,1692
35
+ simple_resume/core/latex/fonts.py,sha256=StoChIpsCCaWLLvYVekYz8hOiuAJxNwVxJUC5f0Rll0,2763
36
+ simple_resume/core/latex/formatting.py,sha256=BPLuo6UdcB14LOQE5BQzio64dNkvEXlH8Afub3utxfE,2315
37
+ simple_resume/core/latex/sections.py,sha256=5LU84_hOOT12TpG-J1G-MVZesC1ogkM4A5U2BUtaZF8,6746
38
+ simple_resume/core/latex/types.py,sha256=9f5NUyD3ax4mWWzM60zcTHHgafoo3rijQjWMiFPyWa4,1857
39
+ simple_resume/core/palettes/__init__.py,sha256=MYWaDvXTlIlckpRR9hk8KzgF1DU1UlTRCnrk3Bg-3iQ,987
40
+ simple_resume/core/palettes/common.py,sha256=WvXuFhUFFLvacmphgnNu29XgF6-5EBuN5I6s5KcVa6w,2178
41
+ simple_resume/core/palettes/exceptions.py,sha256=6e--Jq0Wyp59LyFpxnFTuweyWP4gAogWGULC63xlECc,791
42
+ simple_resume/core/palettes/fetch_types.py,sha256=J-l1sWRA7-LuvFED_6P5dhJ_1UEiisBQwajIHmC_tiU,1538
43
+ simple_resume/core/palettes/generators.py,sha256=ShZVTCtRoVSWs04yNuA7oVZQbpS31QLeah71p5zBGr0,4145
44
+ simple_resume/core/palettes/registry.py,sha256=RrWXe0IJyqku6Ce4ziH-sCtvri0wco6Frid_n5uFMPc,2080
45
+ simple_resume/core/palettes/resolution.py,sha256=t_RoNGkBKW5qUk2wSb8VEPUPCvlcIlg6J81KkukgJgg,4163
46
+ simple_resume/core/palettes/sources.py,sha256=4IH0nFbbL2qRld5AEGXDvQgM3MjRMEHfSUJJD9KZi5w,4844
47
+ simple_resume/core/palettes/data/default_palettes.json,sha256=JGvdaIksqbOzPRHuvm3irm5j_1FfQQ_adx0FXU4iK8s,989
48
+ simple_resume/core/render/__init__.py,sha256=IaD8zOeUwuXREqVRHYvyCk9QXQV_U9OQtjJPHxsBe2g,1013
49
+ simple_resume/core/render/manage.py,sha256=YlWCIjFaylkLCsIJLDMi8S-35nOQcwYlYiWIXYtSu_M,5692
50
+ simple_resume/core/render/plan.py,sha256=EiQwZxktShHRvXA46YEjKUT0An-WOUDlKsQTPpWEunU,13810
51
+ simple_resume/shell/__init__.py,sha256=uonUD7C4L5kJAf5nqo_G_tbwfcJQXcLicO02Gq-Cedk,111
52
+ simple_resume/shell/config.py,sha256=QaOsFopFrVsIkO3Et-yM0aI6eAY9NkfTlRKYT_8aPyU,2820
53
+ simple_resume/shell/effect_executor.py,sha256=3Q29kk3m5aTWqCMebRPeAsy1C5QCP56xQ9fr6EVuAyY,6621
54
+ simple_resume/shell/file_opener.py,sha256=6Sf5ZLZl4WJ4sT8rEA4OO_R1mQTUV9CzK4aZBQV7-Ks,9535
55
+ simple_resume/shell/io_utils.py,sha256=CGl0GeYLztQYTz_Yl239rExsVF-TgeQoWKqzUTz1Y3o,5573
56
+ simple_resume/shell/pdf_executor.py,sha256=T0-UMAs7OwUELCrGVjLsalkUFpnBP_3SsHyQgZrIVQ8,1492
57
+ simple_resume/shell/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
58
+ simple_resume/shell/resume_extensions.py,sha256=WYr3-R_3jP9zsfNViLgg2Th6YzuzUHDcSuMnKFMl_HE,23922
59
+ simple_resume/shell/service_locator.py,sha256=zOkTvSfNrznlBMLXMi_jFcDNqPNWxszfnlzlVUfgsdU,2635
60
+ simple_resume/shell/services.py,sha256=gNZJh_Pzf8O53R5kpTO6pSBgAozglmAoyg4CZb6s2_A,8466
61
+ simple_resume/shell/strategies.py,sha256=nvDHhgA2LWOVJgAMhnOYbBIn_Wu9opd0mVdV0KoD3yg,6847
62
+ simple_resume/shell/assets/static/schema.json,sha256=ovWXOIirzHPSlfYdyj5JgruxGuhlm2mhMqVk4hRYNz8,9854
63
+ simple_resume/shell/assets/static/css/README.md,sha256=tDepzjfA2Mpb0rmyD2vsk8D4b1M_iRWM8t5I0ZwhvcQ,6116
64
+ simple_resume/shell/assets/static/css/common.css,sha256=NSXzO-LWHww819O1PD_sc3sylO0tv4k4mhU1HUUfqtA,14034
65
+ simple_resume/shell/assets/static/css/fonts.css,sha256=UYiMxgJUKdo5mxyP8bXqvITC5I6c8WfYFX3D-0J9rTw,881
66
+ simple_resume/shell/assets/static/css/preview.css,sha256=iICByqyYWQUf2Ur8Rz-dx-FFtsbUv-lVMeS048blOV8,2116
67
+ simple_resume/shell/assets/static/css/print.css,sha256=5U1TR_NA7cDf354p9LyPOyzPJdq88YULEo7uIJUF_h8,2472
68
+ simple_resume/shell/assets/static/fonts/AvenirLTStd-Book.otf,sha256=T7mOd47PjBXZLmh39qz_9trHTN7Sk87OHMo-JBk-D2o,27444
69
+ simple_resume/shell/assets/static/fonts/AvenirLTStd-Light.otf,sha256=qLKNMWDX1jWUrTfZXCbRLpP0ODVkfVWLaYnRsK6uua0,27240
70
+ simple_resume/shell/assets/static/fonts/AvenirLTStd-Medium.otf,sha256=xB_qH8JvKgER0gduR4ExAgUNuiEgvB49lF9QxaHZaYA,27264
71
+ simple_resume/shell/assets/static/fonts/AvenirLTStd-Oblique.otf,sha256=BP210fMHXZOb5IciPDSGLjhGIGSjghbzvQt60oU2vX0,28724
72
+ simple_resume/shell/assets/static/fonts/AvenirLTStd-Roman.otf,sha256=ecSmdjzTegjAfAYUlOuJDWcDGXeW8STtZoQsxz3tte0,27176
73
+ simple_resume/shell/assets/static/fonts/fontawesome/Font Awesome 6 Brands-Regular-400.otf,sha256=kLfwVF3vnRA-oBSDJDBfBHNR-vEaRwOhonY-2_NRkAw,558780
74
+ simple_resume/shell/assets/static/fonts/fontawesome/Font Awesome 6 Free-Solid-900.otf,sha256=hczBCMn_wivZ14b0npMCVjIZmS157Y7Tc7Z-C1PZy-8,1043244
75
+ simple_resume/shell/assets/static/images/default_profile_1.jpg,sha256=K_m0XAEj5-YIB_8aLN_RrMZuPdu-HMQx7EwPLAkYOmE,4403
76
+ simple_resume/shell/assets/static/images/default_profile_2.png,sha256=pQ9UTAF2YRAD0DwXbILnVYU02IoT5NdTcnviUfYvCZ4,2391
77
+ simple_resume/shell/assets/static/themes/README.md,sha256=y_WWjHvDyhGwPSG9ycOKtlRLYCT3vS_QD2Jf6pltWzs,6134
78
+ simple_resume/shell/assets/static/themes/bold.yaml,sha256=gtV2FkfxByQ9yw7B5UXTBzLm2wgsuiEZKHruiPXH_Cg,1731
79
+ simple_resume/shell/assets/static/themes/classic.yaml,sha256=LsF6Plimxnl7RPdX3PzPBOt9pbcHmqlHI-EAEqDk0PY,1728
80
+ simple_resume/shell/assets/static/themes/executive.yaml,sha256=AUvi-TMIdeU7ai13yZpJoe1_NEYyWAMVm20LpTjD8l0,1652
81
+ simple_resume/shell/assets/static/themes/minimal.yaml,sha256=Mp4AaISJ1edSCDAIqogXE4I3VdKmzMRCrRbPIoP21jM,1739
82
+ simple_resume/shell/assets/static/themes/modern.yaml,sha256=eKeQiojZNSj6moKmvOtFsvMSQByoB7RBUY37EUFM6T8,1601
83
+ simple_resume/shell/assets/templates/html/cover.html,sha256=He5fmVyqzU2DDfxvVgLKjRI-b2KoVbJ7XMwUgxeHmOY,3511
84
+ simple_resume/shell/assets/templates/html/demo.html,sha256=_vHUZpcojbr5nNcPFJdeTC9ofDNrb-fC4IOKBlPG5G4,212
85
+ simple_resume/shell/assets/templates/html/resume_base.html,sha256=FN6qYO_9LFFO3zsgGzCcmBdo8GKn4dmvscb9II1sASs,29618
86
+ simple_resume/shell/assets/templates/html/resume_no_bars.html,sha256=GQIVXzDcVCfTJ7Wf-Pqohl7Ocd0FTBmYM2gldTEFz7k,12999
87
+ simple_resume/shell/assets/templates/html/resume_with_bars.html,sha256=5PMH5hA2QP3w_WkDbOWD6RR0qGr0ieWp2-dL7wPK9f0,14954
88
+ simple_resume/shell/cli/__init__.py,sha256=ufp9Ua9xRlpmLFQ-NzTLCFPDvI4w7NZstX06JAjbcWk,932
89
+ simple_resume/shell/cli/main.py,sha256=nyBSCU9_yQGr_I2ZOmY2_6khD91yXIIIibCq2IVNkIc,32915
90
+ simple_resume/shell/cli/palette.py,sha256=szHCME-nfCjIGK8ObOELWx55qMj8T-GEPxwYuCWy5b8,2036
91
+ simple_resume/shell/cli/random_palette_demo.py,sha256=g6fcJbwHMRtNmP_kchQLfuhrBhlM_QdjYpo2V39af58,12188
92
+ simple_resume/shell/generate/__init__.py,sha256=MAXmwaMJF9nF3SOIGAlgL2hKEE0V1SnRmxVYt4mBk94,856
93
+ simple_resume/shell/generate/core.py,sha256=Ec5enc7_OKRFF5_yJIw6OlEDD_kDgUBjm2VglEQOUi8,21366
94
+ simple_resume/shell/generate/lazy.py,sha256=u_Eh_HiGSazSWv8KQorsn7liIfUkU149I0sFIgV5tU8,8584
95
+ simple_resume/shell/palettes/__init__.py,sha256=NMjrTmFC4CovLyUBVrER9UiK-FIniH57AxJxxSZkhrY,57
96
+ simple_resume/shell/palettes/fetch.py,sha256=uqN7_vcIfFXcvNalGIdeHbTOqL9dxg8Ij25c5zL_7v0,1840
97
+ simple_resume/shell/palettes/loader.py,sha256=8mfc4i7T82GhfSDnC44c02Z6k2N_QLlR_YJ89JlDHZs,9641
98
+ simple_resume/shell/palettes/remote.py,sha256=qStg4ZZ1q4uA2ho-YODTL4hs5k5lRlpy6HOLWe1ru7Y,6081
99
+ simple_resume/shell/render/__init__.py,sha256=EaxPZjU8oAQWXdpk6Utlf8Z0pktdzSXDODcqNZQT5sY,51
100
+ simple_resume/shell/render/latex.py,sha256=-uHLpDFZlGKo8JZB1VIzMiw3OTbbncaJt048bi9CCBA,8731
101
+ simple_resume/shell/render/operations.py,sha256=MhKx3GGb3gdpf4-Oqv0GO6qO6FMfVWInXDswskX31a4,8125
102
+ simple_resume/shell/runtime/__init__.py,sha256=TkV0ftdtNQ0kOPTrF_6a-9ZcnJksHL2vBiakEd63I_M,135
103
+ simple_resume/shell/runtime/content.py,sha256=Ov-DnzMJMwAdrFd2vsgkx1FO56KvF7P8sCwZ-IybGq8,6269
104
+ simple_resume/shell/runtime/generate.py,sha256=FebEZjaFtNj6HyUkRtynFaPC60-VqYp2irbodLskqOM,16282
105
+ simple_resume/shell/runtime/lazy.py,sha256=4mgWXDF_oYPcuN2y0H4CypZGXS6_BK_SY0ElHAKahHk,3861
106
+ simple_resume/shell/runtime/lazy_import.py,sha256=dLxBMu4e6ekYWdrGS_sa6N7vba-dW3r9tXot2KBPcbk,5257
107
+ simple_resume/shell/session/__init__.py,sha256=BQFIznmw0yIOZtGmFDUcih4U714bZ0B-UTkInl83lH8,258
108
+ simple_resume/shell/session/config.py,sha256=igsD8X1f-G3QIG_GPSBQrO3lsQWh-1R8hYICIdd6Y1Q,1139
109
+ simple_resume/shell/session/manage.py,sha256=0dRQJEXa9ys4CzzjuLCONsuuz_9QBBzveHmdQBnkJSc,12283
110
+ simple_resume/shell/themes/__init__.py,sha256=wdxTH8vU6JMf560ZqWFcuNz6woMkStXY_KVa-CTMiro,795
111
+ simple_resume/shell/themes/loader.py,sha256=sADasXN1zb-fi0OVR0dzfZhk88aoAH6G0NWzllt97fU,6309
112
+ simple_resume-0.1.9.dist-info/METADATA,sha256=Fa6PH8hVR0a9VNH6dL4CGqa1AWydNi4Q63mREhJNjlg,8685
113
+ simple_resume-0.1.9.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
114
+ simple_resume-0.1.9.dist-info/entry_points.txt,sha256=_PUlEIdeoCdtPipEbv_rlflxr8M7Wrpi2eXeFThqoA8,269
115
+ simple_resume-0.1.9.dist-info/licenses/LICENSE,sha256=anMUBKaKdRmMX9aAzlUPVvIW8YwTYkLvTDGekSLLTr8,1063
116
+ simple_resume-0.1.9.dist-info/RECORD,,
@@ -0,0 +1,4 @@
1
+ Wheel-Version: 1.0
2
+ Generator: hatchling 1.28.0
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
@@ -0,0 +1,5 @@
1
+ [console_scripts]
2
+ generate-random-palette-demo = simple_resume.shell.cli.random_palette_demo:main
3
+ palette-list = simple_resume.shell.cli.palette:palette_list
4
+ palette-snapshot = simple_resume.shell.cli.palette:snapshot
5
+ simple-resume = simple_resume.shell.cli:main_entry
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 athola
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.