Rattlesume

A tool for building resumes by combining markdown snippets into a single document using yaml definitions, then transformed into a PDF pandoc. Allows developers to store their resumes in git, and present them in a common format. Different yaml definitions can be used to craft bespoke resumes from a collection of markdown snippets.

Install

Install via pip (or pipx).

pip install rattlesume

Usage

Snippets

To start, create a content directory with a subdirectory to organize a class of snippets.

 example/content/
├──  experience/
│  └──  FooBar.md
└──  projects/
   └──  Rattlusume.md

Each of these markdown files are called 'snippets'. They are typically a short summary & include relevant information such as dates, job titles, etc.

---
filename: FooBar.md
---
# FooBar Inc.
## Sr. Foobar Enigneer, March 5th, 2015 - Present

Responsible for announcing the zero-modulate of the counting numbers greater than
zero with respect to three and five. Saved FooBar Inc. $15 annually by implementing
an `O(n)` solution.

Snippets can contain an optional slug at the very top, denoted by ---. This slug must be valid yaml. Currently, it is parsed, but not used.

Definitions

Each unique resume has a corresponding definition file. There are currently two required top-level values. header, and resume.

header

A list of raw markdown. Each entry in the list is placed on its own line. The format of this value is still in flux.

resume

The resume section has arbitrary sub-key corresponding to the names of the subdirectories the snippets are located in.

Each of these directories takes two values, header and snippets. snippets is a list of values, which are ether file names or special values. header changes the default header from the sub-key to the given value.

If all other keys are omitted the snippets can be listed directly under the directory name.

For example, the aforementioned 'FooBar.md' could be defined as follows:

header:
  ...

resume:
  experience:
    - "---"
    - "FooBar.md"
# OR
  experience:
    header: "Work Experience"
    snippets:
      - "---"
      - "FooBar.md"

There is currently only one special value, "---", which denotes a horizontal rule.