md_resume 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5e17377e32b45ab6b2127c36392a12d26ee7b0b3b0b6f078b3fdf07e4f9b2663
+  data.tar.gz: 946d865aae51c40a864f70112be7d04797b40292fd35c2f2deaf01c672d3b30d
+SHA512:
+  metadata.gz: d7abc200a53f58087cdcb9bebc2a4f08ac9a6890a78f4c87b0ee132d4f6f354350bbb0e16c183f7db71d55aef067cc09d89465e12aaed8a25eb9a2e600c08543
+  data.tar.gz: c13a6605ec135d342b46bdf91eba7c8307be5e1f2c60cb32cabab4740a23f578dae9406534f7280647044f07262abf874c1ecec727c305d086ef84219b7b904a

data/.standard.yml

@@ -0,0 +1,3 @@
+# For available configuration options, see:
+#   https://github.com/testdouble/standard
+ruby_version: 2.6

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2024-01-02
+
+- Initial release

data/Gemfile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in md_resume.gemspec
+gemspec
+
+gem 'minitest', '~> 5.0'
+gem 'rake', '~> 13.0'
+gem 'standard', '~> 1.3'

data/Gemfile.lock

@@ -0,0 +1,124 @@
+PATH
+  remote: .
+  specs:
+    md_resume (0.1.0)
+      foreman (~> 0.87)
+      guard (~> 2.18)
+      guard-livereload (~> 2.5)
+      guard-process (~> 1.0)
+      guard-shell (~> 0.7)
+      kramdown (~> 2.4)
+      webrick (~> 1.8)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ast (2.4.2)
+    coderay (1.1.3)
+    em-websocket (0.5.3)
+      eventmachine (>= 0.12.9)
+      http_parser.rb (~> 0)
+    eventmachine (1.2.7)
+    ffi (1.16.3)
+    foreman (0.87.2)
+    formatador (1.1.0)
+    guard (2.18.1)
+      formatador (>= 0.2.4)
+      listen (>= 2.7, < 4.0)
+      lumberjack (>= 1.0.12, < 2.0)
+      nenv (~> 0.1)
+      notiffany (~> 0.0)
+      pry (>= 0.13.0)
+      shellany (~> 0.0)
+      thor (>= 0.18.1)
+    guard-compat (1.2.1)
+    guard-livereload (2.5.2)
+      em-websocket (~> 0.5)
+      guard (~> 2.8)
+      guard-compat (~> 1.0)
+      multi_json (~> 1.8)
+    guard-process (1.2.1)
+      guard-compat (~> 1.2, >= 1.2.1)
+      spoon (~> 0.0.1)
+    guard-shell (0.7.2)
+      guard (>= 2.0.0)
+      guard-compat (~> 1.0)
+    http_parser.rb (0.8.0)
+    json (2.7.1)
+    kramdown (2.4.0)
+      rexml
+    language_server-protocol (3.17.0.3)
+    lint_roller (1.1.0)
+    listen (3.8.0)
+      rb-fsevent (~> 0.10, >= 0.10.3)
+      rb-inotify (~> 0.9, >= 0.9.10)
+    lumberjack (1.2.10)
+    method_source (1.0.0)
+    minitest (5.20.0)
+    multi_json (1.15.0)
+    nenv (0.3.0)
+    notiffany (0.1.3)
+      nenv (~> 0.1)
+      shellany (~> 0.0)
+    parallel (1.24.0)
+    parser (3.2.2.4)
+      ast (~> 2.4.1)
+      racc
+    pry (0.14.2)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    racc (1.7.3)
+    rainbow (3.1.1)
+    rake (13.1.0)
+    rb-fsevent (0.11.2)
+    rb-inotify (0.10.1)
+      ffi (~> 1.0)
+    regexp_parser (2.8.3)
+    rexml (3.2.6)
+    rubocop (1.59.0)
+      json (~> 2.3)
+      language_server-protocol (>= 3.17.0)
+      parallel (~> 1.10)
+      parser (>= 3.2.2.4)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.30.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 3.0)
+    rubocop-ast (1.30.0)
+      parser (>= 3.2.1.0)
+    rubocop-performance (1.20.1)
+      rubocop (>= 1.48.1, < 2.0)
+      rubocop-ast (>= 1.30.0, < 2.0)
+    ruby-progressbar (1.13.0)
+    shellany (0.0.1)
+    spoon (0.0.6)
+      ffi
+    standard (1.33.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.59.0)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.3)
+    standard-custom (1.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.50)
+    standard-performance (1.3.0)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.20.1)
+    thor (1.3.0)
+    unicode-display_width (2.5.0)
+    webrick (1.8.1)
+
+PLATFORMS
+  x86_64-linux
+
+DEPENDENCIES
+  md_resume!
+  minitest (~> 5.0)
+  rake (~> 13.0)
+  standard (~> 1.3)
+
+BUNDLED WITH
+   2.4.22

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 YuriBocharov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,67 @@
+# md_resume
+
+https://github.com/elasticspoon/md_resume/assets/14540596/d5034437-2842-4974-bffb-dbeacc742030
+
+Write your resume in [Markdown](https://raw.githubusercontent.com/mikepqr/resume.md/main/resume.md), style it with [CSS](resume.css), output to [HTML](resume.html) and [PDF](resume.pdf). Open a your resume in the browser and watch it update live with changes made to the markdown.
+
+## Prerequisites
+
+- Ruby ≥ 3.0
+- Optional, required for PDF output: Google Chrome or Chromium
+
+## Installation
+
+```bash
+gem install md_resume
+```
+
+## Usage
+
+```
+Usage: md_resume command filename [options…]
+
+Commands:
+serve         Start a local server to preview your resume
+build         Build your resume in html and pdf formats.
+generate      Generate a template with given name (defaults to markdown)
+
+Specific options:
+        --chrome-path=PATH      Path to Chrome executable
+        --no-pdf                Do not write pdf output
+        --no-html               Do not write html output
+    -p, --pdf-path=PATH         Path of pdf output
+    -h, --html-path=PATH        Path of html output
+        --css-path=PATH         Path of css inputs.
+        --server-port=PORT      Specify the localhost port number for the server
+        --serve-only
+    -v, --[no-]verbose          Run verbosely
+
+Common options:
+        --help Show this message
+```
+
+## Customization
+
+You can generate the default style sheet with `md_resume generate-css FILENAME`. The default style is extremely generic, which is perhaps what you want in a resume,
+but CSS gives you a lot of flexibility. See, e.g. [The Tech Resume Inside-Out](https://www.thetechinterview.com/) for good advice about what a resume should look like (and what it should say).
+
+Change the appearance of the PDF version (without affecting the HTML version) by adding rules under the `@media print` CSS selector.
+Change the margins and paper size of the PDF version by editing the [`@page` CSS rule](https://developer.mozilla.org/en-US/docs/Web/CSS/%40page/size).
+
+## Note
+
+The idea for the project is based off of https://github.com/mikepqr/resume.md. I could not get python to play nice so I rewrote it in Ruby and added features.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/elasticspoon/md_resume.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/test_*.rb"]
+end
+
+require "standard/rake"
+
+task default: %i[test standard]

data/assets/defaults.css

@@ -0,0 +1,167 @@
+body {
+  color: #000000;
+  background: #eeeeee;
+  font-size: 1.1em;
+  font-family: "Roboto", "Segoe UI", Tahoma, Geneva, Verdana, sans-serif;
+  line-height: 1.2;
+  margin: 40px 0;
+}
+#resume {
+  margin: 0 auto;
+  max-width: 800px;
+  padding: 40px 60px;
+  background: #ffffff;
+  border: 1px solid #cccccc;
+  box-shadow: 2px 2px 4px #aaaaaa;
+  -webkit-box-shadow: 2px 2px 4px #aaaaaa;
+}
+h1,
+h2 {
+  font-family: "Archivo Black", sans-serif;
+  line-height: 1;
+}
+h1 {
+  text-transform: uppercase;
+  margin-top: 0;
+  margin-bottom: 0;
+  margin-left: auto;
+  margin-right: auto;
+  width: fit-content;
+  padding: 0;
+  color: #090079;
+}
+h2 {
+  border-bottom: 1px solid;
+  border-color: linear-gradient(to right, #fc5c7d, #6a82fb);
+  text-transform: uppercase;
+  font-size: 130%;
+  margin: 1em 0 0 0;
+  padding: 0 0 1px 0;
+  color: #015aa8;
+}
+h3 {
+  font-size: 100%;
+  margin: 0.8em 0 0.3em 0;
+  padding: 0;
+  display: flex;
+  justify-content: space-between;
+}
+p {
+  margin: 0 0 0.5em 0;
+  padding: 0;
+}
+ul {
+  padding: 0;
+  margin: 0 1.5em;
+}
+/* ul immediately after h1 = contact list */
+h1 + ul {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  margin: 0;
+  padding: 0;
+}
+h1 + ul > li {
+  display: inline-flex;
+  white-space: pre;
+  list-style-type: none;
+  & span {
+    margin-block: auto;
+  }
+}
+h1 + ul > li:after {
+  content: "  \2022  ";
+  margin-block: auto;
+}
+h1 + ul > li:last-child:after {
+  content: "";
+}
+/* p immediately after contact list = summary */
+h1 + ul + p {
+  margin: 1em 0;
+}
+img {
+  height: 20px;
+}
+.img_link {
+  display: inline-flex;
+}
+#skills {
+  margin-bottom: 8px;
+}
+
+@media print {
+  body {
+    font-size: 10pt;
+    margin: 0;
+    padding: 0;
+    background: none;
+  }
+  #resume {
+    margin: 0;
+    padding: 0;
+    border: 0px;
+    background: none;
+    box-shadow: none;
+    -webkit-box-shadow: none;
+  }
+  /* Do not underline abbr tags in PDF */
+  abbr {
+    text-decoration: none;
+    font-variant: none;
+  }
+  /* Make links black in PDF */
+  /* Move this outside the print block to apply this in HTML too */
+  a,
+  a:link,
+  a:visited,
+  a:hover {
+    color: #000000;
+    text-decoration: underline;
+  }
+}
+@page {
+  /* Change margins and paper size of PDF */
+  /* https://developer.mozilla.org/en-US/docs/Web/CSS/@page */
+  size: letter;
+  margin: 0.5in 0.8in;
+}
+@media screen and (max-width: 800px) {
+  body {
+    font-size: 16pt;
+    margin: 0;
+    padding: 0;
+    background: #ffffff !important;
+  }
+  #resume {
+    margin: 0;
+    padding: 1em;
+    border: 0px;
+    background: none;
+    box-shadow: none;
+    -webkit-box-shadow: none;
+  }
+}
+
+@media screen {
+  h1 {
+    background-color: #fc5c7d;
+    background-image: linear-gradient(to right, #fc5c7d, #6a82fb);
+    background-size: 100%;
+    -webkit-background-clip: text;
+    -webkit-text-fill-color: transparent;
+    -moz-background-clip: text;
+    -moz-text-fill-color: transparent;
+  }
+
+  h2 {
+    background-color: #314755;
+    background-image: linear-gradient(45deg, #003850, #154bdf 20%);
+    background-size: 100%;
+    -webkit-background-clip: text;
+    -webkit-text-fill-color: transparent;
+    -moz-background-clip: text;
+    -moz-text-fill-color: transparent;
+  }
+}

data/assets/reload.js

@@ -0,0 +1,24 @@
+function reload() {
+  fetch("/")
+    .then((response) => {
+      return response.text();
+    })
+    .then((html) => {
+      document.body.innerHTML = html;
+      console.log("Reloaded");
+    });
+}
+
+function pollServer() {
+  fetch("http://localhost:12345/")
+    .then(() => {
+      reload();
+      pollServer();
+    })
+    .catch((err) => {
+      console.log(err);
+      console.log("Server not ready. Reload the page with the server running.");
+    });
+}
+
+pollServer();

data/assets/sample-resume.md

@@ -0,0 +1,64 @@
+<!-- The (first) h1 will be used as the <title> of the HTML page -->
+
+# Richard Hendricks
+
+<!-- The unordered list immediately after the h1 will be formatted on a single
+line. It is intended to be used for contact details -->
+
+- <richard.hendriks@mail.com>
+- (912) 555-4321
+- [richardhendricks.example.com](http://richardhendricks.example.com)
+- San Francisco, CA
+
+<!-- The paragraph after the h1 and ul and before the first h2 is optional. It
+is intended to be used for a short summary. -->
+
+CEO and Software Engineer with knowledge of applied information theory,
+including optimizing lossless compression schema of both the length-limited and
+adaptive variants.
+
+## Experience
+
+<!-- You have to wrap the "left" and "right" half of these headings in spans by
+hand -->
+
+### <span>CEO/President, Pied Piper</span> <span>Dec 2013 -- Dec 2014</span>
+
+Pied Piper is a multi-platform technology based on a proprietary universal
+compression algorithm that has consistently fielded high Weisman Scores™ that
+are not merely competitive, but approach the theoretical limit of lossless
+compression.
+
+- Build an algorithm for artist to detect if their music was violating
+  copyright infringement laws
+- Successfully won Techcrunch Disrupt
+- Optimized an algorithm that holds the current world record for Weisman Scores
+
+### <span>Teacher, CoderDojo</span> <span>July 2013 -- Dec 2013</span>
+
+Global movement of free coding clubs for young people.
+
+- Awarded 'Teacher of the Month'
+
+## Projects
+
+### <span>Miss Direction</span> <span>Aug 2016</span>
+
+A mapping engine that misguides you:
+
+- Won award at AIHacks 2016
+- Built by all women team of newbie programmers
+- Using modern technologies such as GoogleMaps, Chrome Extension and Javascript
+
+## Education
+
+### <span>University of Oklahoma, BA Information Technology</span> <span>2011 -- 2014</span>
+
+- GPA 4.0
+- DB1101 - Basic SQL
+- CS2011 - Java Introduction
+
+## Skills
+
+- Web development: HTML, CSS, JavaScript
+- Compression: Mpeg, MP4, GIF

data/exe/md_resume

@@ -0,0 +1,34 @@
+#!/usr/bin/env ruby
+
+require 'resume_generator'
+require 'parser'
+require 'local-server'
+
+command = ARGV.shift
+resume = ARGV.shift
+
+parser = Parser.new
+opts = parser.parse(command, ARGV)
+
+if resume.nil?
+  puts parser.args
+  exit
+end
+
+resume = File.expand_path(resume)
+opts.input = resume
+
+case command
+when 'serve'
+  generator = ResumeGenerator.new(opts)
+  server = Server.new(generator, opts)
+  server.start
+when 'build'
+  generator = ResumeGenerator.new(opts)
+  generator.write
+when 'generate'
+  generator = ResumeGenerator.new(opts)
+  generator.generate_template
+else
+  puts parser.args
+end

data/lib/local-server.rb

@@ -0,0 +1,97 @@
+require 'webrick'
+require 'socket'
+require 'filewatcher'
+
+class Server
+  attr_reader :opts, :generator
+
+  def initialize(generator, opts)
+    @opts = opts
+    @generator = generator
+    @needs_reload = false
+  end
+
+  def start
+    start_file_watcher
+    start_reload_server
+    open_browser
+    start_local_server
+  ensure
+    clean_build_dir
+  end
+
+  private
+
+  def filewatcher
+    puts "watching #{opts.input} and #{opts.css_path}" if opts.verbose
+    @filewatcher ||= Filewatcher.new([opts.input, opts.css_path])
+  end
+
+  def open_browser
+    link = "http://localhost:#{opts.port}"
+    if RbConfig::CONFIG['host_os'] =~ /mswin|mingw|cygwin/
+      system "start #{link}"
+    elsif RbConfig::CONFIG['host_os'] =~ /darwin/
+      system "open #{link}"
+    elsif RbConfig::CONFIG['host_os'] =~ /linux|bsd/
+      system "xdg-open #{link}"
+    end
+  end
+
+  def start_file_watcher
+    generator.write
+    @thread = Thread.new(filewatcher) do |fw|
+      fw.watch do |change|
+        puts "Change detected: #{change}" if opts.verbose
+        generator.write
+        @needs_reload = true
+      end
+    end
+  end
+
+  def start_reload_server
+    puts 'Starting reload server on port 12345'
+    @reload_thread = Thread.new do
+      reload_server
+    end
+  end
+
+  def reload_server
+    server = TCPServer.new('localhost', 12_345)
+
+    loop do
+      socket = server.accept
+      request = socket.gets
+      warn request
+      sleep 0.5 until @needs_reload
+      @needs_reload = false
+      socket.print(headers)
+      socket.close
+    end
+  end
+
+  def start_local_server
+    puts "Starting local server on port #{opts.port}"
+    root = opts.html_path
+    server = WEBrick::HTTPServer.new(Port: opts.port, DocumentRoot: root)
+
+    trap 'INT' do server.shutdown end
+
+    server.start
+  end
+
+  def headers
+    headers = [
+      'HTTP/1.1 200 OK',
+      'Content-Type: text/html',
+      "Access-Control-Allow-Origin: http://localhost:#{opts.port}"
+    ]
+    @headers ||= "#{headers.join("\r\n")}\r\n\r\n"
+  end
+
+  def clean_build_dir
+    tmp_dir = opts.html_path.dirname
+    FileUtils.rm_rf(tmp_dir)
+    puts "Could not delete #{tmp_dir}" if File.directory?(tmp_dir)
+  end
+end

data/lib/md_resume/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module MdResume
+  VERSION = "0.1.0"
+end

data/lib/parser.rb

@@ -0,0 +1,198 @@
+require 'optparse'
+require 'pathname'
+
+class Parser
+  class ScriptOptions
+    attr_accessor :chrome_path, :html, :pdf, :css_path, :pdf_path, :html_path, :verbose, :input,
+                  :serve_only, :port, :open_browser, :generate_md, :generate_css
+
+    def initialize
+      self.chrome_path = nil
+      self.html = true
+      self.pdf = true
+      self.open_browser = true
+      self.css_path = default_css_path
+      self.pdf_path = Pathname.new('resume.pdf').expand_path
+      self.html_path = Pathname.new('resume.html').expand_path
+      self.verbose = false
+      self.serve_only = false
+      self.input = nil
+      self.port = 3000
+      self.generate_md = true
+      self.generate_css = false
+    end
+
+    def define_options(parser)
+      parser.banner = 'Usage: md_resume command filename [options...]'
+      parser.separator ''
+      parser.separator 'Commands:'
+      parser.separator "serve\t\t\tStart a local server to preview your resume"
+      parser.separator "build\t\t\tBuild your resume in html and pdf formats."
+      parser.separator "generate\t\tGenerate a resume template with the given filename"
+      parser.separator ''
+      parser.separator 'Specific options:'
+
+      # add additional options
+      specify_chrome_path_option(parser)
+      boolean_pdf_option(parser)
+      boolean_html_option(parser)
+      specify_output_pdf_option(parser)
+      specify_output_html_option(parser)
+      specify_input_css_option(parser)
+      specify_server_port_option(parser)
+      # TODO: remove this?
+      boolean_serve_only_option(parser)
+      boolean_open_browser_option(parser)
+      boolean_verbosity_option(parser)
+      boolean_generate_md_option(parser)
+      boolean_generate_css_option(parser)
+      parser.separator ''
+      parser.separator 'Common options:'
+      # No argument, shows at tail.  This will print an options summary.
+      # Try it and see!
+      parser.on_tail('-h', '--help', 'Show this message') do
+        puts parser
+        exit
+      end
+    end
+
+    def specify_chrome_path_option(parser)
+      # Specifies an optional option argument
+      parser.on('--chrome-path=PATH', 'Path to Chrome executable') do |path|
+        full_path = Pathname.new(path).expand_path
+        self.chrome_path = full_path
+      end
+    end
+
+    def specify_output_html_option(parser)
+      parser.on('-h PATH', '--html-path=PATH', 'Path of html output') do |path|
+        input_dir = Pathname.new(path).expand_path
+        self.html_path = input_dir
+      end
+    end
+
+    def specify_output_pdf_option(parser)
+      parser.on('-p PATH', '--pdf-path=PATH', 'Path of pdf output') do |path|
+        input_dir = Pathname.new(path).expand_path
+        self.pdf_path = input_dir
+      end
+    end
+
+    def specify_input_css_option(parser)
+      parser.on('--css-path=PATH', 'Path of css inputs.') do |path|
+        input_dir = Pathname.new(path).expand_path
+        self.css_path = input_dir
+      end
+    end
+
+    def specify_server_port_option(parser)
+      parser.on('--server-port=PORT', 'Specify the localhost port number for the server') do |port|
+        port = port.to_i
+        raise OptionParser::InvalidArgument unless (1..65_535).cover?(port)
+
+        self.port = port
+      end
+    end
+
+    def boolean_verbosity_option(parser)
+      parser.on('-v', '--[no-]verbose', 'Run verbosely') do |v|
+        self.verbose = v
+      end
+    end
+
+    def boolean_pdf_option(parser)
+      # Boolean switch.
+      parser.on('--no-pdf', 'Do [not] write pdf output') do |v|
+        self.pdf = v
+      end
+    end
+
+    def boolean_html_option(parser)
+      # Boolean switch.
+      parser.on('--[no-]html', 'Do [not] write html output') do |v|
+        self.html = v
+      end
+    end
+
+    def boolean_serve_only_option(parser)
+      # Boolean switch.
+      parser.on('--serve-only') do |v|
+        self.serve_only = v
+      end
+    end
+
+    def boolean_open_browser_option(parser)
+      # Boolean switch.
+      parser.on('--no-open', 'Do not automatically open browser when starting server') do |v|
+        self.open_browser = v
+      end
+    end
+
+    def boolean_generate_md_option(parser)
+      parser.on('--no-generate-md', 'Do not generate markdown template.') do |v|
+        self.generate_md = v
+      end
+    end
+
+    def boolean_generate_css_option(parser)
+      parser.on('--[no-]generate-css', 'Generate CSS template.') do |v|
+        self.generate_css = v
+      end
+    end
+
+    private
+
+    def default_css_path
+      curr = Pathname.new(__FILE__).dirname
+      relative = Pathname.new('../assets/defaults.css')
+      File.expand_path(relative, curr)
+    end
+  end
+
+  #
+  # Return a structure describing the options.
+  #
+  def parse(command, args)
+    @options = ScriptOptions.new
+    @args = OptionParser.new do |parser|
+      @options.define_options(parser)
+      parser.parse!(args)
+      set_command_defaults(command)
+    rescue OptionParser::InvalidOption, OptionParser::MissingArgument => e
+      puts e
+      puts
+      puts parser
+      exit
+    end
+    @options
+  end
+
+  def set_command_defaults(command)
+    case command
+    when 'serve'
+      serve_defaults
+    when 'build'
+      build_defaults
+    when 'generate'
+      generate_defaults
+    end
+  end
+
+  def serve_defaults
+    options.pdf = false
+    options.html = true
+    options.html_path = internal_tmp_dir.join('resume.html')
+  end
+
+  def build_defaults(parser); end
+
+  def generate_defaults(parser); end
+
+  attr_reader :parser, :options, :args
+
+  private
+
+  def internal_tmp_dir
+    Pathname.new('../../tmp').expand_path(__FILE__)
+  end
+end

data/lib/resume_generator.rb

@@ -0,0 +1,233 @@
+require 'kramdown'
+require 'base64'
+require 'open3'
+require 'fileutils'
+require 'pathname'
+
+class ResumeGenerator
+  attr_reader :opts
+
+  ValueError = Class.new(StandardError)
+
+  POSTAMBLE = <<~POSTAMBLE.freeze
+      </div>
+      </body>
+      <script>
+    #{File.read(File.expand_path('../assets/reload.js', __dir__))}
+      </script>
+      </html>
+  POSTAMBLE
+
+  CHROME_GUESSES_MACOS = [
+    '/Applications/Chromium.app/Contents/MacOS/Chromium',
+    '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',
+    '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome'
+  ].freeze
+
+  LINUX_CHROME_DIRS = [
+    '/usr/local/sbin',
+    '/usr/local/bin',
+    '/usr/sbin',
+    '/usr/bin',
+    '/sbin',
+    '/bin',
+    '/opt/google/chrome',
+    "/etc/profiles/per-user/#{ENV['USER']}/bin" # NixOS
+  ].freeze
+
+  LINUX_CHROME_EXECUTABLES = %w[google-chrome chrome chromium chromium-browser].freeze
+
+  def initialize(opts)
+    @opts = opts
+    @opts.chrome_path = guess_chrome_path if @opts.pdf && @opts.chrome_path.nil?
+  end
+
+  def write
+    valid_input?
+    write_html
+    write_pdf
+  end
+
+  def valid_input?
+    puts "Input file: #{@opts.input}"
+    return if File.exist?(@opts.input)
+
+    puts "Resume not found at #{@opts.input}"
+    exit
+  end
+
+  def generate_template
+    curr = Pathname.new(__FILE__).dirname
+    if @opts.generate_md
+      relative = Pathname.new('../assets/sample-resume.md')
+      template = File.expand_path(relative, curr)
+      FileUtils.copy_file(template, "#{@opts.input}.md")
+    end
+
+    return unless @opts.generate_css
+
+    relative = Pathname.new('../assets/defaults.css')
+    template = File.expand_path(relative, curr)
+    FileUtils.copy_file(template, "#{@opts.input}.css")
+  end
+
+  private
+
+  def chrome_guesses_linux
+    LINUX_CHROME_DIRS.product(LINUX_CHROME_EXECUTABLES).map do |dir, exe|
+      "#{dir}/#{exe}"
+    end
+  end
+
+  def chrome_guesses_windows
+    [
+      # Windows 10
+      File.expand_path('Google/Chrome/Application/chrome.exe', ENV.fetch('ProgramFiles(x86)', nil)),
+      File.expand_path('Google/Chrome/Application/chrome.exe', ENV.fetch('ProgramFiles(x86)', nil)),
+      File.expand_path('Google/Chrome/Application/chrome.exe', ENV.fetch('ProgramFiles(x86)', nil)),
+      # Windows 7
+      'C:/Program Files (x86)/Google/Chrome/Application/chrome.exe',
+      'C:/Program Files/Google/Chrome/Application/chrome.exe',
+      # Vista
+      'C:/Users/UserName/AppData/Local/Google/Chrome',
+      # XP
+      'C:/Documents and Settings/UserName/Local Settings/Application Data/Google/Chrome'
+    ]
+  end
+
+  def guess_chrome_path
+    guesses = case RUBY_PLATFORM
+              when /darwin/
+                CHROME_GUESSES_MACOS
+              when /cygwin|mswin|mingw|bccwin|wince|emx/
+                chrome_guesses_windows
+              else
+                chrome_guesses_linux
+              end
+    guesses.each do |path|
+      if File.exist?(path)
+        puts "Guessed Chrome path: #{path}" if opts.verbose
+        return path
+      end
+    end
+
+    raise ValueError,
+          "Cannot guess Chrome path on platform #{RUBY_PLATFORM}.
+           Please set --chrome_path= manually."
+  end
+
+  def to_html
+    markdown = File.read(opts.input)
+    make_html(markdown, css_file: opts.css_path)
+  end
+
+  def to_pdf
+    make_pdf(to_html)
+  end
+
+  def make_pdf(html)
+    html64 = Base64.encode64(html.encode('utf-8')).chomp
+    prefix = opts.pdf_path.basename
+    tmp_dir = Pathname.new('../tmp').expand_path(__FILE__)
+    FileUtils.mkdir(tmp_dir) unless File.directory?(tmp_dir)
+    options = pdf_opts_string(tmp_dir)
+    create_output_dir(opts.pdf_path)
+
+    begin
+      cmd = "#{opts.chrome_path} #{options} --print-to-pdf=#{opts.pdf_path} 'data:text/html;base64,#{html64}'"
+      _stdout, stderr, status = Open3.capture3(cmd)
+      raise stderr unless status.success?
+
+      puts "Wrote #{prefix}" if opts.verbose
+    rescue StandardError => e
+      puts e.message
+    ensure
+      FileUtils.rm_rf(tmp_dir)
+      puts "Could not delete #{tmp_dir}" if File.directory?(tmp_dir)
+    end
+  end
+
+  def pdf_opts_string(tmp_dir)
+    options = [
+      '--no-sandbox',
+      '--headless',
+      '--no-pdf-header-footer',
+      '--enable-logging=stderr',
+      '--log-level=2',
+      '--in-process-gpu',
+      '--disable-gpu'
+    ]
+    options.push("--crash-dumps-dir=#{tmp_dir}")
+    options.push("--user-data-dir=#{tmp_dir}")
+    options.join(' ')
+  end
+
+  def preamable(title, css)
+    <<~PREAMBLE
+      <html lang="en">
+      <head>
+      <meta charset="UTF-8">
+      <meta property="time_built" content="#{Time.now.iso8601}">
+      <title>#{title}</title>
+      <style>
+      #{css}
+      </style>
+      </head>
+      <body>
+      <div id="resume">
+    PREAMBLE
+  end
+
+  def title(markdown)
+    # Return the contents of the first markdown heading in md, which we
+    #   assume to be the title of the document.
+    markdown.each_line do |line|
+      return Regexp.last_match(1) if line =~ /^#([^#]*)$/
+    end
+
+    raise ValueError,
+          'Cannot find any lines that look like markdown h1 headings to use as the title'
+  end
+
+  def reload_script
+    File.read(File.expand_path('assets/reload.js', __dir__))
+  end
+
+  def make_html(markdown, css_file: nil)
+    title = title(markdown)
+    html = Kramdown::Document.new(markdown).to_html
+    begin
+      css = File.read(css_file.to_s)
+    rescue Errno::ENOENT
+      warn "Cannot find CSS file #{css_file}"
+      warn 'Output will not be styled'
+      css = ''
+    end
+    preamable(title, css) + html + POSTAMBLE
+  end
+
+  def write_html
+    puts "Writing HTML to #{opts.html_path}"
+    File.write(opts.html_path, to_html, mode: 'w') if opts.html
+  rescue Errno::ENOENT => e
+    raise e unless e.message =~ /No such file or directory/
+
+    create_output_dir(opts.html_path)
+    retry
+  end
+
+  def write_pdf
+    to_pdf if opts.pdf
+  end
+
+  def create_output_dir(path)
+    FileUtils.mkdir_p(File.dirname(path))
+  end
+
+  def set_server_opts
+    opts.html_path = Pathname.new(Dir.pwd).join('tmp/resume.html')
+    opts.html = true
+    opts.pdf = false
+    opts.verbose = true
+  end
+end

data/md_resume.gemspec

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require_relative 'lib/md_resume/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'md_resume'
+  spec.version = MdResume::VERSION
+  spec.authors = ['YuriBocharov']
+  spec.email = ['quesadillaman@gmail.com']
+
+  spec.summary = 'Ruby gem for creating resume from markdown file.'
+  spec.description = 'Write a resume in markdown, style it with CSS, distribute it as either HTML or PDF. Now with even faster feedback cycles, make changes and preview them immediately!</br></br><code>md-resume</code> is a resume generator written in Ruby styled with CSS. Instead of stopping at exclusively generation of a resume in HTML or PDF format, the project goes further in letting you perfect your resume. Running <code>resume.rb</code> in development mode will spin up a local server that will watch your changes to the resume styles and content. The server will live update an HTML preview of your resume letting you move quickly with changes and updates. The project uses <code>kramdown</code> to translate markdown to HTML, bringing with it additional inline markdown customization options.'
+  spec.homepage = 'https://github.com/elasticspoon/markdown-resume'
+  spec.license = 'MIT'
+  spec.required_ruby_version = '>= 2.6.0'
+
+  # spec.metadata["allowed_push_host"] = "TODO: Set to your gem server 'https://example.com'"
+
+  spec.metadata['homepage_uri'] = spec.homepage
+  spec.metadata['source_code_uri'] = 'https://github.com/elasticspoon/markdown-resume'
+  # spec.metadata["changelog_uri"] = "TODO: Put your gem's CHANGELOG.md URL here."
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) || f.start_with?(*%w[bin/ test/ spec/ features/ .git .circleci appveyor])
+    end
+  end
+  spec.bindir = 'exe'
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  # Uncomment to register a new dependency of your gem
+  # spec.add_dependency "example-gem", "~> 1.0"
+  spec.add_dependency 'filewatcher', '~> 2.1'
+  spec.add_dependency 'kramdown', '~> 2.4'
+  spec.add_dependency 'webrick', '~> 1.8'
+
+  # For more information and examples about making a new gem, check out our
+  # guide at: https://bundler.io/guides/creating_gem.html
+end

data/sig/md_resume.rbs

@@ -0,0 +1,4 @@
+module MdResume
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,115 @@
+--- !ruby/object:Gem::Specification
+name: md_resume
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- YuriBocharov
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2024-01-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: filewatcher
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: kramdown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.4'
+- !ruby/object:Gem::Dependency
+  name: webrick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.8'
+description: Write a resume in markdown, style it with CSS, distribute it as either
+  HTML or PDF. Now with even faster feedback cycles, make changes and preview them
+  immediately!</br></br><code>md-resume</code> is a resume generator written in Ruby
+  styled with CSS. Instead of stopping at exclusively generation of a resume in HTML
+  or PDF format, the project goes further in letting you perfect your resume. Running
+  <code>resume.rb</code> in development mode will spin up a local server that will
+  watch your changes to the resume styles and content. The server will live update
+  an HTML preview of your resume letting you move quickly with changes and updates.
+  The project uses <code>kramdown</code> to translate markdown to HTML, bringing with
+  it additional inline markdown customization options.
+email:
+- quesadillaman@gmail.com
+executables:
+- md_resume
+extensions: []
+extra_rdoc_files: []
+files:
+- ".standard.yml"
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- assets/defaults.css
+- assets/reload.js
+- assets/sample-resume.md
+- exe/md_resume
+- lib/local-server.rb
+- lib/md_resume/version.rb
+- lib/parser.rb
+- lib/resume_generator.rb
+- md_resume.gemspec
+- resume.png
+- sig/md_resume.rbs
+homepage: https://github.com/elasticspoon/markdown-resume
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/elasticspoon/markdown-resume
+  source_code_uri: https://github.com/elasticspoon/markdown-resume
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.4.10
+signing_key:
+specification_version: 4
+summary: Ruby gem for creating resume from markdown file.
+test_files: []