simple-resume 0.1.9__py3-none-any.whl

simple_resume/shell/assets/static/css/preview.css

@@ -0,0 +1,82 @@
+/**
+ * Web Preview Styles for Simple Resume
+ *
+ * Enhancements for web browser preview mode.
+ * These styles make the resume look better in a browser context.
+ */
+
+/* ========================================================================
+   PREVIEW FRAME
+   ======================================================================== */
+
+/* The frame wraps the page when in preview mode */
+.frame {
+  /* Add subtle shadow for depth */
+  box-shadow: 0 4px 20px rgba(0, 0, 0, 0.15);
+
+  /* Center the preview */
+  margin: 20px auto;
+
+  /* Ensure it doesn't stretch too wide */
+  max-width: fit-content;
+}
+
+/* ========================================================================
+   BROWSER-SPECIFIC ENHANCEMENTS
+   ======================================================================== */
+
+/* Smooth font rendering in browsers */
+body {
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+/* Interactive elements */
+a:hover {
+  opacity: 0.8;
+}
+
+/* ========================================================================
+   SCROLLING & VIEWPORT
+   ======================================================================== */
+
+/* Ensure smooth scrolling */
+html {
+  scroll-behavior: smooth;
+}
+
+/* Add some breathing room */
+body {
+  padding: 20px 0;
+  min-height: 100vh;
+}
+
+/* ========================================================================
+   RESPONSIVE PREVIEW
+   ======================================================================== */
+
+@media screen and (max-width: 250mm) {
+  .frame {
+    /* Scale down for smaller screens */
+    transform-origin: top center;
+    margin: 10px auto;
+  }
+
+  body {
+    padding: 10px;
+    overflow-x: auto;
+  }
+}
+
+/* ========================================================================
+   DEBUG HELPERS (development only)
+   ======================================================================== */
+
+/*
+ * Uncomment these for debugging layout issues:
+ *
+ * .sidebar { outline: 1px solid red; }
+ * .body { outline: 1px solid blue; }
+ * .content { outline: 1px solid green; }
+ * .description-container { outline: 1px solid orange; }
+ */

simple_resume/shell/assets/static/css/print.css

@@ -0,0 +1,99 @@
+/**
+ * Print/PDF Styles for Simple Resume
+ *
+ * PDF-specific styles and WeasyPrint workarounds.
+ * Used for PDF generation via WeasyPrint.
+ *
+ * Note: @page size is dynamically set via inline CSS for each resume
+ * based on resume_config values. This file contains base print rules.
+ */
+
+/* ========================================================================
+   PAGE RULES
+   ======================================================================== */
+
+@page {
+  /* Base page rule - actual size is set dynamically via inline CSS */
+  margin: 0;
+}
+
+@page resume {
+  /* Named page for resume content flow */
+  margin: 0;
+}
+
+/* ========================================================================
+   PRINT-SPECIFIC LAYOUT
+   ======================================================================== */
+
+@media print {
+  html, body {
+    margin: 0 !important;
+    padding: 0 !important;
+  }
+
+  .page {
+    page-break-after: always;
+    page-break-inside: avoid;
+  }
+
+  /* Ensure sidebar flows across pages properly */
+  .sidebar-container {
+    page-break-inside: auto;
+    break-inside: auto;
+  }
+
+  /* Prevent orphan headings */
+  h2, h3 {
+    page-break-after: avoid;
+  }
+
+  /* Keep content blocks together when possible */
+  .content {
+    page-break-inside: auto;
+  }
+
+  .description-container {
+    page-break-inside: auto;
+  }
+
+  /* Section headings should not be separated from content */
+  .section-heading {
+    page-break-after: avoid;
+  }
+}
+
+/* ========================================================================
+   WEASYPRINT WORKAROUNDS
+   ======================================================================== */
+
+/*
+ * WeasyPrint has some CSS limitations. Document known issues here.
+ *
+ * Known issues:
+ * - calc() with CSS variables can be unreliable in some contexts
+ * - Some flexbox edge cases may render differently than browsers
+ * - @font-face src: format() hint is optional but recommended
+ *
+ * Workarounds applied:
+ * - Use explicit dimensions where possible instead of calc()
+ * - Test all flexbox layouts thoroughly
+ * - Font paths use relative URLs from template location
+ */
+
+/* Ensure proper box-sizing for WeasyPrint */
+*, *::before, *::after {
+  box-sizing: border-box;
+}
+
+/* WeasyPrint handles background gradients well, but explicit sizing helps */
+.page {
+  -webkit-print-color-adjust: exact;
+  print-color-adjust: exact;
+}
+
+/* Ensure SVG icons render properly in PDF */
+.icon svg,
+.icon-inline svg {
+  overflow: visible;
+}

simple_resume/shell/assets/static/schema.json

@@ -0,0 +1,236 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://athola.github.io/simple-resume/schema.json",
+  "title": "simple-resume YAML schema",
+  "description": "JSON Schema for simple-resume YAML/JSON inputs. Use this schema in YAML editors (e.g., VS Code YAML extension) for autocomplete and validation.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["full_name", "email", "config"],
+  "properties": {
+    "template": {
+      "description": "Template to render with. Known templates are provided, but custom templates are allowed.",
+      "anyOf": [
+        {"enum": ["resume_no_bars", "resume_with_bars", "demo"]},
+        {"type": "string", "pattern": "^[A-Za-z0-9_-]+$"}
+      ],
+      "default": "resume_no_bars"
+    },
+    "theme": {
+      "description": "Optional named theme. Theme config is merged into config as defaults.",
+      "type": "string",
+      "enum": ["classic", "bold", "minimal", "modern", "executive"]
+    },
+    "full_name": {"type": "string"},
+    "email": {"type": "string", "format": "email"},
+    "job_title": {"type": "string"},
+    "phone": {"type": "string"},
+    "web": {"type": "string"},
+    "linkedin": {"type": "string"},
+    "github": {"type": "string"},
+    "image_uri": {"type": "string"},
+    "image_link": {"type": "string"},
+    "headline": {"type": "string"},
+    "description": {"type": "string", "description": "Markdown-supported pitch/summary."},
+    "address": {"type": "array", "items": {"type": "string"}},
+
+    "titles": {
+      "type": "object",
+      "description": "Optional label overrides used by templates.",
+      "additionalProperties": {"type": "string"}
+    },
+
+    "expertise": {"type": "array", "items": {"type": "string"}},
+    "certification": {"type": "array", "items": {"type": "string"}},
+    "keyskills": {"type": "array", "items": {"type": "string"}},
+
+    "skills": {
+      "description": "Sidebar skills with proficiency values (0-100).",
+      "type": "object",
+      "additionalProperties": {"type": "number"}
+    },
+
+    "languages": {
+      "description": "Sidebar languages with proficiency values (0-100).",
+      "type": "object",
+      "additionalProperties": {"type": "number"}
+    },
+
+    "body": {
+      "description": "Main resume sections. Each key is a section heading, mapped to a list of entries.",
+      "type": "object",
+      "additionalProperties": {
+        "type": "array",
+        "items": {"$ref": "#/$defs/bodyEntry"}
+      }
+    },
+
+    "config": {"$ref": "#/$defs/config"},
+
+    "meta": {
+      "type": "object",
+      "description": "Internal metadata (e.g., palette metadata).",
+      "additionalProperties": true
+    }
+  },
+
+  "$defs": {
+    "hexColor": {
+      "type": "string",
+      "pattern": "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$",
+      "examples": ["#0395DE", "#FFF"]
+    },
+
+    "dimension": {
+      "description": "A numeric value (number/int) or a string with optional units (e.g., '8.6mm').",
+      "anyOf": [
+        {"type": "number"},
+        {"type": "integer"},
+        {"type": "string", "pattern": "^-?\\d+(?:\\.\\d+)?(?:mm|pt|px)?$"}
+      ]
+    },
+
+    "bodyEntry": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "start": {"type": ["string", "number"]},
+        "end": {"type": ["string", "number"]},
+        "title": {"type": "string"},
+        "title_link": {"type": "string"},
+        "company": {"type": "string"},
+        "company_link": {"type": "string"},
+        "description": {"type": "string"},
+        "tech_stack": {
+          "description": "Optional list of technologies.",
+          "type": "array",
+          "items": {"type": "string"}
+        }
+      }
+    },
+
+    "palette": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "source": {"type": "string", "description": "Palette source (e.g., 'registry', 'generator', 'remote', or direct colors)."},
+        "name": {"type": "string"},
+        "type": {"type": "string", "description": "Generator type (e.g., 'hcl')."},
+        "colors": {"type": "array", "items": {"$ref": "#/$defs/hexColor"}},
+        "size": {"type": "integer", "minimum": 1},
+        "seed": {"type": "integer"},
+        "hue_range": {
+          "type": "array",
+          "items": {"type": "number"},
+          "minItems": 2,
+          "maxItems": 2
+        },
+        "luminance_range": {
+          "type": "array",
+          "items": {"type": "number"},
+          "minItems": 2,
+          "maxItems": 2
+        },
+        "chroma": {"type": "number"},
+        "keywords": {"type": "array", "items": {"type": "string"}},
+        "num_results": {"type": "integer", "minimum": 1},
+        "order_by": {"type": "string"}
+      }
+    },
+
+    "config": {
+      "type": "object",
+      "description": "Rendering configuration. Most fields are optional; defaults are applied by simple-resume.",
+      "additionalProperties": true,
+      "properties": {
+        "template": {
+          "description": "Template override (used by core planning); usually matches top-level template.",
+          "anyOf": [
+            {"enum": ["resume_no_bars", "resume_with_bars", "demo"]},
+            {"type": "string", "pattern": "^[A-Za-z0-9_-]+$"}
+          ],
+          "default": "resume_no_bars"
+        },
+        "output_mode": {
+          "type": "string",
+          "enum": ["markdown", "latex"],
+          "default": "markdown"
+        },
+        "color_scheme": {
+          "type": "string",
+          "description": "Palette name (e.g., 'Professional Blue') or 'generator ...' shorthand.",
+          "default": "default"
+        },
+        "theme": {
+          "description": "Theme name (alternative location to top-level theme).",
+          "type": "string",
+          "enum": ["classic", "bold", "minimal", "modern", "executive"]
+        },
+
+        "palette": {"$ref": "#/$defs/palette"},
+
+        "page_width": {"$ref": "#/$defs/dimension", "default": 210},
+        "page_height": {"$ref": "#/$defs/dimension", "default": 297},
+        "sidebar_width": {"$ref": "#/$defs/dimension", "default": 65},
+
+        "padding": {"$ref": "#/$defs/dimension", "default": 12},
+        "sidebar_padding_left": {"$ref": "#/$defs/dimension", "default": 10},
+        "sidebar_padding_right": {"$ref": "#/$defs/dimension", "default": 10},
+        "sidebar_padding_top": {"$ref": "#/$defs/dimension", "default": 0},
+        "sidebar_padding_bottom": {"$ref": "#/$defs/dimension", "default": 12},
+
+        "pitch_padding_top": {"$ref": "#/$defs/dimension", "default": 10},
+        "pitch_padding_bottom": {"$ref": "#/$defs/dimension", "default": 8},
+        "pitch_padding_left": {"$ref": "#/$defs/dimension", "default": 6},
+
+        "h2_padding_left": {"$ref": "#/$defs/dimension", "default": 6},
+        "h2_padding_top": {"$ref": "#/$defs/dimension", "default": 8},
+        "h3_padding_top": {"$ref": "#/$defs/dimension", "default": 7},
+
+        "section_heading_margin_top": {"$ref": "#/$defs/dimension", "default": 7},
+        "section_heading_margin_bottom": {"$ref": "#/$defs/dimension", "default": 1},
+        "section_heading_text_margin": {"$ref": "#/$defs/dimension", "default": -6},
+        "section_icon_design_scale": {"$ref": "#/$defs/dimension", "default": 1},
+        "entry_margin_bottom": {"$ref": "#/$defs/dimension", "default": 4},
+        "tech_stack_margin_bottom": {"$ref": "#/$defs/dimension", "default": 2},
+
+        "section_icon_circle_size": {"$ref": "#/$defs/dimension", "default": 7.8},
+        "section_icon_circle_x_offset": {"$ref": "#/$defs/dimension", "default": 0},
+        "section_icon_design_size": {"$ref": "#/$defs/dimension", "default": 3.5},
+        "section_icon_design_x_offset": {"$ref": "#/$defs/dimension", "default": 0},
+        "section_icon_design_y_offset": {"$ref": "#/$defs/dimension", "default": 0},
+
+        "date_container_width": {"$ref": "#/$defs/dimension", "default": 15},
+        "date_container_padding_left": {"$ref": "#/$defs/dimension"},
+        "description_container_padding_left": {"$ref": "#/$defs/dimension", "default": 4},
+        "skill_container_padding_top": {"$ref": "#/$defs/dimension", "default": 3},
+        "skill_spacer_padding_top": {"$ref": "#/$defs/dimension", "default": 3},
+        "profile_image_padding_bottom": {"$ref": "#/$defs/dimension", "default": 8},
+
+        "frame_padding": {"$ref": "#/$defs/dimension", "default": 15},
+
+        "cover_padding_top": {"$ref": "#/$defs/dimension", "default": 15},
+        "cover_padding_bottom": {"$ref": "#/$defs/dimension", "default": 15},
+        "cover_padding_h": {"$ref": "#/$defs/dimension", "default": 20},
+
+        "contact_icon_size": {"$ref": "#/$defs/dimension", "default": 5},
+        "contact_icon_margin_top": {"$ref": "#/$defs/dimension", "default": 0.5},
+        "contact_text_padding_left": {"$ref": "#/$defs/dimension", "default": 2},
+
+        "bold_font_weight": {"type": "integer", "default": 600},
+        "description_font_size": {"$ref": "#/$defs/dimension", "default": 8.5},
+        "date_font_size": {"$ref": "#/$defs/dimension", "default": 9},
+        "sidebar_font_size": {"$ref": "#/$defs/dimension", "default": 8.5},
+
+        "theme_color": {"$ref": "#/$defs/hexColor", "default": "#0395DE"},
+        "sidebar_color": {"$ref": "#/$defs/hexColor", "default": "#F6F6F6"},
+        "sidebar_text_color": {"$ref": "#/$defs/hexColor", "default": "#000000"},
+        "bar_background_color": {"$ref": "#/$defs/hexColor", "default": "#DFDFDF"},
+        "date2_color": {"$ref": "#/$defs/hexColor", "default": "#616161"},
+        "frame_color": {"$ref": "#/$defs/hexColor", "default": "#757575"},
+        "heading_icon_color": {"$ref": "#/$defs/hexColor", "default": "#0395DE"},
+        "bold_color": {"$ref": "#/$defs/hexColor", "default": "#585858"},
+        "sidebar_bold_color": {"$ref": "#/$defs/hexColor"}
+      }
+    }
+  }
+}

simple_resume/shell/assets/static/themes/README.md

@@ -0,0 +1,208 @@
+# Theme Gallery for Simple Resume
+
+This directory contains pre-built theme presets that you can use as-is or customize to create your own unique resume style.
+
+## Available Themes
+
+| Theme | Description | Best For |
+|-------|-------------|----------|
+| **modern** | Clean, contemporary design with soft blue-gray tones | Tech, startups, creative roles |
+| **classic** | Traditional professional design with navy/burgundy | Finance, law, consulting |
+| **bold** | High-contrast with vibrant accents | Design, marketing, standout applications |
+| **minimal** | Light and airy with maximum whitespace | Academic, research, writing |
+| **executive** | Sophisticated dark with gold accents | C-suite, senior leadership |
+
+## Quick Start
+
+### Option 1: Copy and Customize
+
+1. Copy a theme file (e.g., `modern.yaml`) to your project
+2. Rename it (e.g., `my-theme.yaml`)
+3. Modify the values you want to change
+4. Reference it in your resume YAML:
+
+```yaml
+# In your resume.yaml, copy the config section from the theme
+config:
+  palette:
+    source: generator
+    type: hcl
+    size: 5
+    seed: 2024
+    hue_range: [200, 220]
+    luminance_range: [0.35, 0.75]
+    chroma: 0.12
+  # ... rest of config
+```
+
+### Option 2: Use Theme Values Directly
+
+Copy just the `config:` block from any theme into your resume YAML:
+
+```yaml
+# my_resume.yaml
+template: resume_with_bars
+full_name: Jane Developer
+job_title: Software Engineer
+
+# Paste the config block from modern.yaml, classic.yaml, etc.
+config:
+  palette:
+    source: generator
+    type: hcl
+    size: 5
+    seed: 2024
+    hue_range: [200, 220]
+    luminance_range: [0.35, 0.75]
+    chroma: 0.12
+
+  page_width: 210
+  page_height: 297
+  # ... etc
+```
+
+## Customization Guide
+
+### Color Palette
+
+The palette generator creates harmonious colors automatically:
+
+```yaml
+config:
+  palette:
+    source: generator
+    type: hcl                    # HCL color space (perceptually uniform)
+    size: 5                      # Number of colors to generate
+    seed: 2024                   # Change this for different colors!
+    hue_range: [200, 220]        # Color hue range (0-360)
+    luminance_range: [0.35, 0.75]  # Light to dark range (0-1)
+    chroma: 0.12                 # Color saturation (0-1)
+```
+
+**Quick color adjustments:**
+
+- Want different colors? → Change `seed` to any number
+- Want warmer colors? → Use `hue_range: [0, 60]` (red-yellow)
+- Want cooler colors? → Use `hue_range: [180, 270]` (cyan-purple)
+- Want darker sidebar? → Lower `luminance_range` (e.g., `[0.10, 0.30]`)
+- Want more vibrant? → Increase `chroma` (e.g., `0.25`)
+
+### Hue Reference Chart
+
+| Hue Range | Colors |
+|-----------|--------|
+| 0-30 | Red, Orange |
+| 30-60 | Orange, Yellow |
+| 60-120 | Yellow, Green |
+| 120-180 | Green, Cyan |
+| 180-240 | Cyan, Blue |
+| 240-300 | Blue, Purple |
+| 300-360 | Purple, Red |
+
+### Layout Dimensions
+
+All dimensions are in millimeters (mm) for print accuracy:
+
+```yaml
+config:
+  # Page size (A4 default)
+  page_width: 210
+  page_height: 297
+  padding: 12                    # Overall page padding
+
+  # Sidebar
+  sidebar_width: 60              # Width of left sidebar
+  sidebar_padding_top: 5
+  sidebar_padding_bottom: 5
+  sidebar_padding_left: 5
+  sidebar_padding_right: 5
+
+  # Profile image
+  profile_width: 50              # Profile photo width
+  profile_image_padding_bottom: 6
+
+  # Main content
+  pitch_padding_top: 10          # Space above summary
+  pitch_padding_bottom: 5
+  pitch_padding_left: 5
+  h2_padding_left: 5             # Section header indent
+  h2_width: 140                  # Section header width
+
+  # Experience entries
+  h3_padding_top: 3              # Space above job titles
+  date_container_width: 25       # Date column width
+  description_container_padding_left: 5
+  skill_container_padding_top: 2
+```
+
+### Section Icons
+
+Customize the circular icons next to section headings:
+
+```yaml
+config:
+  section_icon_circle_size: "10mm"       # Circle diameter
+  section_icon_circle_x_offset: "0mm"    # Horizontal adjustment
+  section_icon_design_size: "5mm"        # Icon size inside circle
+  section_icon_design_x_offset: "0mm"    # Icon horizontal position
+  section_icon_design_y_offset: "0mm"    # Icon vertical position
+  section_heading_text_margin: "-5mm"    # Text margin from icon
+  section_heading_marker_margin_left: "-10mm"
+  section_heading_marker_line_height: "15mm"
+```
+
+## Creating Your Own Theme
+
+1. **Start from an existing theme** - Copy the one closest to your vision
+2. **Change the seed** - Get new colors instantly with a different `seed` value
+3. **Adjust hue_range** - Pick your brand colors
+4. **Fine-tune luminance** - Control light/dark balance
+5. **Test with preview** - Use `--preview` flag to see changes in browser
+
+### Example: Creating a "Tech Startup" Theme
+
+```yaml
+config:
+  # Vibrant purple-pink tech colors
+  palette:
+    source: generator
+    type: hcl
+    size: 5
+    seed: 42
+    hue_range: [280, 330]        # Purple to pink
+    luminance_range: [0.30, 0.70]
+    chroma: 0.20                 # Vibrant but professional
+
+  # Compact modern layout
+  sidebar_width: 55
+  padding: 10
+  h3_padding_top: 3
+  date_container_width: 12
+
+  # Smaller, subtle icons
+  section_icon_circle_size: "7mm"
+  section_icon_design_size: "3.5mm"
+```
+
+## Tips for Great Themes
+
+1. **Contrast matters** - Verify text readability on sidebar backgrounds
+2. **Consistency** - Keep padding values proportional (e.g., all multiples of 5)
+3. **Test with real content** - Long names and descriptions reveal layout issues
+4. **Print preview** - Colors look different on screen vs paper
+5. **PDF check** - Always generate a PDF to verify final output
+
+## Sharing Your Theme
+
+Created a great theme? Consider contributing it back!
+
+1. Add your theme YAML to this directory
+2. Include a descriptive header comment
+3. Test with multiple sample resumes
+4. Submit a pull request
+
+## See Also
+
+- [CSS Architecture](../css/README.md) - How CSS styling works
+- [Palette Generator](../../../../wiki/Palette-Generator.md) - Deep dive on color generation
+- [Sample Resumes](../../../../../../sample/input/) - Example resumes using different themes