standup_md 0.2.1 → 0.3.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 47e0efce596a788d69ac8f7faeadc54532bb1ff1995b52c56ad2e0dc707c5472
-  data.tar.gz: b3cdb0c4cef322a5b1020ce073bd325a046abee1a7926b73200f0b302ffe8703
+  metadata.gz: 71a7fb49df17324d09d35de586a54edb308f684cad586fefc5a0da8feeb1f6c1
+  data.tar.gz: 592f369262e459631dacae459836e804c9fe9777932f9b9e1f6ee9201a6d8e99
 SHA512:
-  metadata.gz: dab3f3fa03a6c1635274dd7545bfb959ea961d9c8868f6062af0a4a7d2d00d760c0ccec4cc65d30bb8ca24702ed2773741da91254f3a0bdc6a57717d63ccfa05
-  data.tar.gz: a00498bcc03da2e7867c7c0bcdf1b53791f37f5f8d5707624ebd433ae3e30e8e4bc600f3593a32d9814b9e9f47229a3322aac6f854cf40abe46f969060137a57
+  metadata.gz: e02396bf9be1f7087122f2f52d5cd7b038716be203ff7303ff99c4335eae2e82a1114d13a782523df4647477865d9972ba257eed2d31ae253992ea98a985d675
+  data.tar.gz: ef19c102c52fe69cc767ced8523a841cbea1714e6a9d4cd05f2c45e4c07d4721e33b0abf7fbc84354498bfc02e2cb09168b1ee667c4022b0edb9805a202a6dd6

data/.gitignore

@@ -1 +1,2 @@
 standup_md-*.gem
+coverage/*

data/Gemfile.lock

@@ -1,14 +1,19 @@
 PATH
   remote: .
   specs:
-    standup_md (0.1.3)
+    standup_md (0.3.3)
 
 GEM
   remote: https://rubygems.org/
   specs:
+    docile (1.3.2)
     power_assert (1.2.0)
     rake (13.0.1)
-    test-unit (3.3.5)
+    simplecov (0.18.5)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+    simplecov-html (0.12.2)
+    test-unit (3.3.6)
       power_assert
 
 PLATFORMS
@@ -16,6 +21,7 @@ PLATFORMS
 
 DEPENDENCIES
   rake (~> 13.0, >= 13.0.1)
+  simplecov
   standup_md!
   test-unit (~> 3.3, >= 3.3.5)
 

data/README.md

@@ -18,11 +18,18 @@ View on: [Github](https://github.com/evanthegrayt/standup_md) |
   - [Via RubyGems](#via-rubygems)
   - [Manual Installation](#manual-installation)
 - [Usage](#usage)
-  - [Example](#example)
-  - [Customization and Runtime Options](#customization-and-runtime-options)
-  - [Using existing standup files](#using-existing-standup-files)
-- [API](#api)
-  - [Documentation](https://evanthegrayt.github.io/standup_md/doc/index.html)
+  - [Command Line](#command-line)
+    - [CLI Examples](#cli-examples)
+      - [Adding an entry for today via editor](#adding-an-entry-for-today-via-editor)
+      - [Copy the entry for today to clipboard](#copy-the-entry-for-today-to-clipboard)
+      - [Add entry to file without opening it](#add-entry-to-file-without-opening-it)
+      - [Find an entry by date and print it](#find-an-entry-by-date-and-print-it)
+    - [Customization and Runtime Options](#customization-and-runtime-options)
+    - [Using existing standup files](#using-existing-standup-files)
+  - [API](#api)
+    - [API Examples](#api-examples)
+      - [Adding an entry for today](#adding-an-entry-for-today)
+    - [Documentation](https://evanthegrayt.github.io/standup_md/doc/index.html)
 - [Reporting Bugs and Requesting Features](#reporting-bugs-and-requesting-features)
 - [Self-Promotion](#self-promotion)
 
@@ -32,19 +39,22 @@ chat client, such as Slack, Mattermost, or Riot. Typing out my standup every day
 became tedious, as I'd have to look up what I did the day before, copy and paste
 yesterday's work into a new entry, and add today's tasks. This gem automates
 most of this process, along with providing means of opening the file in your
-editor, and displaying entries from the command line.
-
-I wasn't sure that others would find this useful, but then the pandemic
-happened, which I assume made doing standups via chat much more common.
+editor, and finding and displaying entries from the command line.
 
 In a nutshell, calling `standup` from the command line will open a standup file
 for the current month in your preferred editor. If an entry for today is already
 present, no text will be generated. If an entry for today doesn't exist, one
-will be generated, and if a previous entry exists, it will be added to today's
-entry as your previous day's work. See [example](#example). There's also an API
-if you'd like to use this in your own code somehow.
+will be generated with your preferred values. When generating, if a previous
+entry exists, it will be added to today's entry as your previous day's work. See
+[example](#example). There's also a very robust API if you'd like to use this
+in your own code somehow.
 
 ## Installation
+If you don't have the permissions to install system-wide gems, you're probabaly
+also running an older version of ruby. I recommend installing
+[rbenv](https://github.com/rbenv/rbenv#installation), and then installing an
+up-to-date version of ruby.
+
 ### Via RubyGems
 Just install the gem!
 
@@ -52,15 +62,15 @@ Just install the gem!
 gem install standup_md
 ```
 
-If you don't have permission on your system to install ruby or gems, I recommend
-using
-[rbenv](http://www.rubyinside.com/rbenv-a-simple-new-ruby-version-management-tool-5302.html),
-or you can try the manual methods below.
+To include in your project, add the following to your `Gemfile`.
 
+```ruby
+gem 'standup_md'
+```
 
 ### Manual Installation
-From your terminal, clone the repository where you want it. From there, you have
-a couple of installation options.
+From your terminal, clone the repository where you want it, and use `rake` to
+install the gem.
 
 ```sh
 git clone https://github.com/evanthegrayt/standup_md.git
@@ -68,14 +78,11 @@ cd standup_md
 
 # Use rake to build and install the gem.
 rake install
-
-# OR manually link the executable somewhere. If you use this method, you cannot
-# move the repository after you link it!
-ln -s $PWD/bin/standup /usr/local/bin/standup
 ```
 
 ## Usage
-Call the executable.
+### Command Line
+For the most basic usage, simply call the executable.
 
 ```sh
 standup
@@ -83,10 +90,13 @@ standup
 
 This opens the current month's standup file. If an entry already exists for
 today, nothing is added. If no entry exists for today, the previous "Current" is
-placed in the "Previous" section of a new entry.  The format of this file is
-very important; do not change anything, except for adding entries for today.
+placed in the "Previous" section of a new entry. The format of this file is very
+important; you may add new entries, but don't change any of the headers. Doing
+so will cause the parser to break. If you want to customize the headers, you can
+do so in the [configuration file](#available-config-file-options-and-defaults).
 
-### Example
+### CLI Examples
+#### Adding an entry for today via editor
 For example, if the standup entry from yesterday reads as follows:
 
 ```markdown
@@ -114,19 +124,36 @@ file:
 - None
 ```
 
+#### Copy the entry for today to clipboard
 There are also flags that will print entries to the command line. There's a full
 list of features below, but as a quick example, you can copy today's entry to
 your clipboard without even opening your editor.
 
 ```sh
-standup -c | pbcopy
+standup -p | pbcopy
+```
+
+If you wanted to add today's entry without opening your editor, and print the
+result to the command line, you could use the following.
+
+#### Add entry to file without opening it
+```sh
+standup --no-edit --current "Work on this thing","And another thing"
+```
+
+#### Find an entry by date and print it.
+If you wanted to find and print the entry for March 2nd, 2020, you could use the
+following.
+
+```sh
+standup -p 2020-03-02
 ```
 
-## Customization and Runtime Options
-You can create a file in your home directory called `~/.standup_md.yml`.
-Settings located in this file will override default behavior. This file can also
-have settings overwritten at runtime by the use of options. You can view [my config
-file](https://github.com/evanthegrayt/dotfiles/blob/master/dotfiles/standup_md.yml)
+### Customization and Runtime Options
+You can create a file in your home directory called `~/.standuprc`. Settings
+located in this file will override default behavior. This file can also have
+settings overwritten at runtime by the use of options. You can view [my config
+file](https://github.com/evanthegrayt/dotfiles/blob/master/dotfiles/standuprc)
 as an example. Any setting in this file can still be overridden at runtime by
 passing flags to the executable.
 
@@ -145,51 +172,64 @@ them in your configuration file after installation, and then try to not change
 them again.
 
 
-### Available Config File Keys and Defaults
-
-```yaml
-# Key:                 Default
-header_depth:          1
-header_date_format:    '%Y-%m-%d'
-sub_header_depth:      2
-current_header:        'Current'
-previous_header:       'Previous'
-impediments_header:    'Impediments'
-file_name_format:      '%Y_%m.md'
-bullet_character:      '-'        # (dash)
-directory:             '~/.cache/standup_md'
-editor:                # $VISUAL, $EDITOR or vim, in that order
-current_entry_tasks:
-  - "<!-- ADD TODAY'S WORK HERE -->"
-previous_entry_tasks:  # An array of the tasks from the previous entry
-impediments:
-  - 'None'
-notes:                 null # If not null, must be array
-sub_header_order:
-  - 'previous'
-  - 'current'
-  - 'impediments'
-  - 'notes'
+#### Available Config File Options and Defaults
+For command-line usage, this file needs to be named `~/.standuprc`. To use in a
+rails project, create an initializer (`config/initializers/standup_md.rb`).
+
+```ruby
+StandupMD.configure do |c|
+  # Defaults for how the file is formatted.
+  # See https://evanthegrayt.github.io/standup_md/doc/StandupMD/Config/Cli.html
+  c.file.header_date_format = '%Y-%m-%d'
+  c.file.header_depth       = 1
+  c.file.sub_header_depth   = 2
+  c.file.current_header     = 'Current'
+  c.file.previous_header    = 'Previous'
+  c.file.impediments_header = 'Impediments'
+  c.file.notes_header       = 'Notes'
+  c.file.sub_header_order   = %w[previous current impediments notes]
+  c.file.directory          = ::File.join(ENV['HOME'], '.cache', 'standup_md')
+  c.file.bullet_character   = '-'
+  c.file.name_format        = '%Y_%m.md'
+  c.file.create             = true
+
+  # Defaults for entries
+  # See https://evanthegrayt.github.io/standup_md/doc/StandupMD/Config/Entry.html
+  c.entry.current          = ["<!-- ADD TODAY'S WORK HERE -->"]
+  c.entry.previous         = []
+  c.entry.impediments      = ['None']
+  c.entry.notes            = []
+
+  # Defaults for executable runtime behavior.
+  # See https://evanthegrayt.github.io/standup_md/doc/StandupMD/Config/Cli.html
+  c.cli.date               = Date.today
+  c.cli.editor             = 'vim' # Checks $VISUAL and $EDITOR first, in that order
+  c.cli.verbose            = false
+  c.cli.edit               = true
+  c.cli.write              = true
+  c.cli.print              = false
+  c.cli.auto_fill_previous = true
+  c.cli.preference_file    = ::File.expand_path(::File.join(ENV['HOME'], '.standuprc'))
+end
 ```
 
-### Executable Flags
+#### Executable Flags
 ```
-The Standup Doctor
-        --current-entry-tasks=ARRAY  List of current entry's tasks
-        --previous-entry-tasks=ARRAY List of yesterday's tasks
-        --impediments=ARRAY          List of impediments for current entry
-        --notes=ARRAY                List of notes for current entry
-        --sub-header-order=ARRAY     The order of the sub-headers when writing the file
-        --[no-]append-previous       Append previous tasks? Default is true
-    -f, --file-name-format=STRING    Date-formattable string to use for standup file name
-    -e, --editor=EDITOR              Editor to use for opening standup files
-    -d, --directory=DIRECTORY        The directories where standup files are located
-        --[no-]write                 Write current entry if it doesn't exist. Default is true
-        --[no-]edit                  Open the file in the editor. Default is true
-    -j, --[no-]json                  Print output as formatted json. Default is false.
-    -v, --[no-]verbose               Verbose output. Default is false.
-    -c, --current                    Print current entry. Disables editing
-    -a, --all                        Print all previous entries. Disables editing
+    --current ARRAY            List of current entry's tasks
+    --previous ARRAY           List of precious entry's tasks
+    --impediments ARRAY        List of impediments for current entry
+    --notes ARRAY              List of notes for current entry
+    --sub-header-order ARRAY   The order of the sub-headers when writing the file
+-f, --file-name-format STRING  Date-formattable string to use for standup file name
+-E, --editor EDITOR            Editor to use for opening standup files
+-d, --directory DIRECTORY      The directories where standup files are located
+-w  --[no-]write               Write current entry if it doesn't exist. Default is true
+-a  --[no-]auto-fill-previous  Auto-generate 'previous' tasks for new entries
+-e  --[no-]edit                Open the file in the editor. Default is true
+-v, --[no-]verbose             Verbose output. Default is false.
+-p, --print [DATE]             Print current entry.
+                               If DATE is passed, will print entry for DATE, if it exists.
+                               DATE must be in the same format as file-name-format
 ```
 
 Any options not set in this file will retain their default values. Note that if
@@ -197,14 +237,7 @@ you change `file_name_format`, and don't use a month or year, there will only
 ever be one standup file. This could cause issues long-term, as the files will
 get large over time and possibly cause performance issues.
 
-If you wanted to add some tasks at runtime, and without opening the file in an
-editor, you could use the following:
-
-```bash
-standup --no-edit --current-entry-tasks="Work on this thing","And another thing!"
-```
-
-### Using Existing Standup Files
+#### Using Existing Standup Files
 If you already have a directory of existing standup files, you can use them, but
 they must be in a format that the parser can understand. The default is:
 
@@ -222,7 +255,7 @@ they must be in a format that the parser can understand. The default is:
 
 The order, words, date format, and header level are all customizable, but the
 overall format must be the same. If customization is necessary, this must be
-done in `~/.standup_md.yml` before execution, or else the parser will error.
+done in `~/.standuprc` before execution, or else the parser will error.
 
 For example, if you wanted the format to be as follows:
 
@@ -238,57 +271,56 @@ For example, if you wanted the format to be as follows:
 * notes, if any are present
 ```
 
-Your `~/.standup_md.yml` should contain:
-
-```yaml
-header_depth:        2
-sub_header_depth:    3
-current_header:      Today
-previous_header:     Yesterday
-impediments_header:  Hold-ups
-bullet_character:    '*'
-header_date_format:  '%m/%d/%Y'
-sub_header_order:
-  - current
-  - previous
-  - impediments
-  - notes
+Your `~/.standuprc` should contain:
+
+```ruby
+StandupMD.configure do |c|
+  c.file.header_depth       = 2
+  c.file.sub_header_depth   = 3
+  c.file.current_header     = 'Today'
+  c.file.previous_header    = 'Yesterday'
+  c.file.impediments_header = 'Hold-ups'
+  c.file.bullet_character   = '*'
+  c.file.header_date_format = '%m/%d/%Y'
+  c.file.sub_header_order   = %w[current previous impediments notes]
+end
 ```
 
 ## API
-Below are some quick examples, but the API is fully documented in the
-[documentation](https://evanthegrayt.github.io/standup_md/doc/index.html).
+The API is fully documented in the
+[RDoc Documentation](https://evanthegrayt.github.io/standup_md/doc/index.html).
 
-This was mainly written as a command line utility, but I made the API available
-for scripting. There are attribute accessors for most of the settings in the
-[customization table](#customization-and-runtime-options) above. A
-quick example of how to write a new entry via code could look like the
-following:
+This was mainly written as a command line utility, but the API is ridiculously
+robust, and is available for use in your own projects. A quick example of how
+to write a new entry via code could look like the following:
 
+### API Examples
+#### Adding an entry for today
 ```ruby
 require 'standup_md'
 
-standup = StandupMD.load do |s|
-  s.current_header = 'Today',
-  s.current_entry_tasks = ['Thing to do today', 'Another thing to do today'],
-  s.impediments = ['Not enough time in the day']
+StandupMD.configure do |c|
+  c.file.current_header = 'Today',
 end
 
-standup.write
+file = StandupMD::File.find_by_date(Date.today)
+entry = StandupMD::Entry.create { |e| e.current = ['Stuff I will do today'] }
+file.entries << entry
+file.write
 ```
 
-Note: `StandupMD.load { ... }` just is a quick way to call `StandupMD.new {
-... }.load`
-
-Entries are just hashes, so you can easily transform them to `json` objects.
+The above example was written as such to show how the different pieces of the
+API fit together. The code can actually be simplified to the following.
 
 ```ruby
 require 'standup_md'
-require 'json'
 
-standup = StandupMD.load
+StandupMD.configure do |c|
+  c.file.current_header = 'Today',
+  c.entry.current = ['Stuff I will do today']
+end
 
-standup_json = standup.all_entries.to_json
+StandupMD::File.find_by_date(Date.today).load.write
 ```
 
 ## Reporting Bugs and Requesting Features

data/bin/standup

@@ -1,5 +1,5 @@
 #!/usr/bin/env ruby
 
-require_relative '../lib/standup_md/cli'
+require_relative '../lib/standup_md'
 
 StandupMD::Cli.execute(ARGV)

data/doc/README_md.html

@@ -67,12 +67,18 @@
     <li><a href="#label-Via+RubyGems">Via RubyGems</a>
     <li><a href="#label-Manual+Installation">Manual Installation</a>
     <li><a href="#label-Usage">Usage</a>
-    <li><a href="#label-Example">Example</a>
+    <li><a href="#label-Command+Line">Command Line</a>
+    <li><a href="#label-CLI+Examples">CLI Examples</a>
+    <li><a href="#label-Adding+an+entry+for+today+via+editor">Adding an entry for today via editor</a>
+    <li><a href="#label-Copy+the+entry+for+today+to+clipboard">Copy the entry for today to clipboard</a>
+    <li><a href="#label-Add+entry+to+file+without+opening+it">Add entry to file without opening it</a>
+    <li><a href="#label-Find+an+entry+by+date+and+print+it.">Find an entry by date and print it.</a>
     <li><a href="#label-Customization+and+Runtime+Options">Customization and Runtime Options</a>
-    <li><a href="#label-Available+Config+File+Keys+and+Defaults">Available Config File Keys and Defaults</a>
+    <li><a href="#label-Available+Config+File+Options+and+Defaults">Available Config File Options and Defaults</a>
     <li><a href="#label-Executable+Flags">Executable Flags</a>
     <li><a href="#label-Using+Existing+Standup+Files">Using Existing Standup Files</a>
     <li><a href="#label-API">API</a>
+    <li><a href="#label-API+Examples">API Examples</a>
     <li><a href="#label-Reporting+Bugs+and+Requesting+Features">Reporting Bugs and Requesting Features</a>
     <li><a href="#label-Self-Promotion">Self-Promotion</a>
   </ul>
@@ -119,15 +125,29 @@
 </li><li>
 <p><a href="#usage">Usage</a></p>
 </li><li>
-<p><a href="#example">Example</a></p>
+<p><a href="#command-line">Command Line</a></p>
+<ul><li>
+<p><a href="#cli-examples">CLI Examples</a></p>
+</li><li>
+<p><a href="#adding-an-entry-for-today-via-editor">Adding an entry for today via editor</a></p>
+</li><li>
+<p><a href="#copy-the-entry-for-today-to-clipboard">Copy the entry for today to clipboard</a></p>
+</li><li>
+<p><a href="#add-entry-to-file-without-opening-it">Add entry to file without opening it</a></p>
+</li><li>
+<p><a href="#find-an-entry-by-date-and-print-it">Find an entry by date and print it</a></p>
 </li><li>
 <p><a href="#customization-and-runtime-options">Customization and Runtime Options</a></p>
 </li><li>
 <p><a href="#using-existing-standup-files">Using existing standup files</a></p>
+</li></ul>
 </li><li>
 <p><a href="#api">API</a></p>
+<ul><li>
+<p><a href="#api-examples">API Examples</a></p>
 </li><li>
 <p><a href="https://evanthegrayt.github.io/standup_md/doc/index.html">Documentation</a></p>
+</li></ul>
 </li><li>
 <p><a href="#reporting-bugs-and-requesting-features">Reporting Bugs and Requesting Features</a></p>
 </li><li>
@@ -136,11 +156,9 @@
 
 <h2 id="label-About">About<span><a href="#label-About">&para;</a> <a href="#top">&uarr;</a></span></h2>
 
-<p>I&#39;ve now been at two separate companies where we post our daily standups in a chat client, such as Slack, Mattermost, or Riot. Typing out my standup every day became tedious, as I&#39;d have to look up what I did the day before, copy and paste yesterday&#39;s work into a new entry, and add today&#39;s tasks. This gem automates most of this process, along with providing means of opening the file in your editor, and displaying entries from the command line.</p>
+<p>I&#39;ve now been at two separate companies where we post our daily standups in a chat client, such as Slack, Mattermost, or Riot. Typing out my standup every day became tedious, as I&#39;d have to look up what I did the day before, copy and paste yesterday&#39;s work into a new entry, and add today&#39;s tasks. This gem automates most of this process, along with providing means of opening the file in your editor, and finding and displaying entries from the command line.</p>
 
-<p>I wasn&#39;t sure that others would find this useful, but then the pandemic happened, which I assume made doing standups via chat much more common.</p>
-
-<p>In a nutshell, calling <code>standup</code> from the command line will open a standup file for the current month in your preferred editor. If an entry for today is already present, no text will be generated. If an entry for today doesn&#39;t exist, one will be generated, and if a previous entry exists, it will be added to today&#39;s entry as your previous day&#39;s work. See <a href="#example">example</a>. There&#39;s also an API if you&#39;d like to use this in your own code somehow.</p>
+<p>In a nutshell, calling <code>standup</code> from the command line will open a standup file for the current month in your preferred editor. If an entry for today is already present, no text will be generated. If an entry for today doesn&#39;t exist, one will be generated with your preferred values. When generating, if a previous entry exists, it will be added to today&#39;s entry as your previous day&#39;s work. See <a href="#example">example</a>. There&#39;s also a very robust API if you&#39;d like to use this in your own code somehow.</p>
 
 <h2 id="label-Installation">Installation<span><a href="#label-Installation">&para;</a> <a href="#top">&uarr;</a></span></h2>
 
@@ -151,32 +169,35 @@
 <pre class="ruby"><span class="ruby-identifier">gem</span> <span class="ruby-identifier">install</span> <span class="ruby-identifier">standup_md</span>
 </pre>
 
-<p>If you don&#39;t have permission on your system to install ruby or gems, I recommend using <a href="http://www.rubyinside.com/rbenv-a-simple-new-ruby-version-management-tool-5302.html">rbenv</a>, or you can try the manual methods below.</p>
+<p>To include in your project, add the following to your <code>Gemfile</code>.</p>
+
+<pre class="ruby"><span class="ruby-identifier">gem</span> <span class="ruby-string">&#39;standup_md&#39;</span>
+</pre>
 
 <h3 id="label-Manual+Installation">Manual Installation<span><a href="#label-Manual+Installation">&para;</a> <a href="#top">&uarr;</a></span></h3>
 
-<p>From your terminal, clone the repository where you want it. From there, you have a couple of installation options.</p>
+<p>From your terminal, clone the repository where you want it, and use <code>rake</code> to install the gem.</p>
 
 <pre>git clone https://github.com/evanthegrayt/standup_md.git
 cd standup_md
 
 # Use rake to build and install the gem.
-rake install
-
-# OR manually link the executable somewhere. If you use this method, you cannot
-# move the repository after you link it!
-ln -s $PWD/bin/standup /usr/local/bin/standup</pre>
+rake install</pre>
 
 <h2 id="label-Usage">Usage<span><a href="#label-Usage">&para;</a> <a href="#top">&uarr;</a></span></h2>
 
-<p>Call the executable.</p>
+<h3 id="label-Command+Line">Command Line<span><a href="#label-Command+Line">&para;</a> <a href="#top">&uarr;</a></span></h3>
+
+<p>For the most basic usage, simply call the executable.</p>
 
 <pre class="ruby"><span class="ruby-identifier">standup</span>
 </pre>
 
-<p>This opens the current month&#39;s standup file. If an entry already exists for today, nothing is added. If no entry exists for today, the previous “Current” is placed in the “Previous” section of a new entry. The format of this file is very important; do not change anything, except for adding entries for today.</p>
+<p>This opens the current month&#39;s standup file. If an entry already exists for today, nothing is added. If no entry exists for today, the previous “Current” is placed in the “Previous” section of a new entry. The format of this file is very important; you may add new entries, but don&#39;t change any of the headers. Doing so will cause the parser to break. If you want to customize the headers, you can do so in the <a href="#available-config-file-options-and-defaults">configuration file</a>.</p>
+
+<h3 id="label-CLI+Examples">CLI Examples<span><a href="#label-CLI+Examples">&para;</a> <a href="#top">&uarr;</a></span></h3>
 
-<h3 id="label-Example">Example<span><a href="#label-Example">&para;</a> <a href="#top">&uarr;</a></span></h3>
+<h4 id="label-Adding+an+entry+for+today+via+editor">Adding an entry for today via editor<span><a href="#label-Adding+an+entry+for+today+via+editor">&para;</a> <a href="#top">&uarr;</a></span></h4>
 
 <p>For example, if the standup entry from yesterday reads as follows:</p>
 
@@ -200,70 +221,92 @@ ln -s $PWD/bin/standup /usr/local/bin/standup
 ## Impediments
 - None</pre>
 
+<h4 id="label-Copy+the+entry+for+today+to+clipboard">Copy the entry for today to clipboard<span><a href="#label-Copy+the+entry+for+today+to+clipboard">&para;</a> <a href="#top">&uarr;</a></span></h4>
+
 <p>There are also flags that will print entries to the command line. There&#39;s a full list of features below, but as a quick example, you can copy today&#39;s entry to your clipboard without even opening your editor.</p>
 
-<pre class="ruby"><span class="ruby-identifier">standup</span> <span class="ruby-operator">-</span><span class="ruby-identifier">c</span> <span class="ruby-operator">|</span> <span class="ruby-identifier">pbcopy</span>
+<pre class="ruby"><span class="ruby-identifier">standup</span> <span class="ruby-operator">-</span><span class="ruby-identifier">p</span> <span class="ruby-operator">|</span> <span class="ruby-identifier">pbcopy</span>
 </pre>
 
-<h2 id="label-Customization+and+Runtime+Options">Customization and Runtime Options<span><a href="#label-Customization+and+Runtime+Options">&para;</a> <a href="#top">&uarr;</a></span></h2>
+<p>If you wanted to add today&#39;s entry without opening your editor, and print the result to the command line, you could use the following.</p>
+
+<h4 id="label-Add+entry+to+file+without+opening+it">Add entry to file without opening it<span><a href="#label-Add+entry+to+file+without+opening+it">&para;</a> <a href="#top">&uarr;</a></span></h4>
 
-<p>You can create a file in your home directory called <code>~/.standup_md.yml</code>. Settings located in this file will override default behavior. This file can also have settings overwritten at runtime by the use of options. You can view <a href="https://github.com/evanthegrayt/dotfiles/blob/master/dotfiles/standup_md.yml">my config file</a> as an example. Any setting in this file can still be overridden at runtime by passing flags to the executable.</p>
+<pre>standup --no-edit --current &quot;Work on this thing&quot;,&quot;And another thing&quot;</pre>
+
+<h4 id="label-Find+an+entry+by+date+and+print+it.">Find an entry by date and print it.<span><a href="#label-Find+an+entry+by+date+and+print+it.">&para;</a> <a href="#top">&uarr;</a></span></h4>
+
+<p>If you wanted to find and print the entry for March 2nd, 2020, you could use the following.</p>
+
+<pre>standup -p 2020-03-02</pre>
+
+<h3 id="label-Customization+and+Runtime+Options">Customization and Runtime Options<span><a href="#label-Customization+and+Runtime+Options">&para;</a> <a href="#top">&uarr;</a></span></h3>
+
+<p>You can create a file in your home directory called <code>~/.standuprc</code>. Settings located in this file will override default behavior. This file can also have settings overwritten at runtime by the use of options. You can view <a href="https://github.com/evanthegrayt/dotfiles/blob/master/dotfiles/standuprc">my config file</a> as an example. Any setting in this file can still be overridden at runtime by passing flags to the executable.</p>
 
 <p>You&#39;ll notice, a lot of settings don&#39;t have the ability to be changed at runtime when calling the executable. This is because the file structure is very important, and changing values that affect formatting will cause problems with the file parser. If you don&#39;t want to use a default, make the change in your config file before you start editing standups. There is an <a href="https://github.com/evanthegrayt/standup_md/issues/16">open issue</a> for handling this for the user, but they&#39;re not available yet.</p>
 
 <p>There are no options to change the headers at runtime because it uses the headers to detect tasks from previous entries. If changed at runtime, this would cause errors. For this reason, if you don&#39;t like the default headers, change them in your configuration file after installation, and then try to not change them again.</p>
 
-<h3 id="label-Available+Config+File+Keys+and+Defaults">Available Config File Keys and Defaults<span><a href="#label-Available+Config+File+Keys+and+Defaults">&para;</a> <a href="#top">&uarr;</a></span></h3>
-
-<pre># Key:                 Default
-header_depth:          1
-header_date_format:    &#39;%Y-%m-%d&#39;
-sub_header_depth:      2
-current_header:        &#39;Current&#39;
-previous_header:       &#39;Previous&#39;
-impediments_header:    &#39;Impediments&#39;
-file_name_format:      &#39;%Y_%m.md&#39;
-bullet_character:      &#39;-&#39;        # (dash)
-directory:             &#39;~/.cache/standup_md&#39;
-editor:                # $VISUAL, $EDITOR or vim, in that order
-current_entry_tasks:
-  - &quot;&lt;!-- ADD TODAY&#39;S WORK HERE --&gt;&quot;
-previous_entry_tasks:  # An array of the tasks from the previous entry
-impediments:
-  - &#39;None&#39;
-notes:                 null # If not null, must be array
-sub_header_order:
-  - &#39;previous&#39;
-  - &#39;current&#39;
-  - &#39;impediments&#39;
-  - &#39;notes&#39;</pre>
-
-<h3 id="label-Executable+Flags">Executable Flags<span><a href="#label-Executable+Flags">&para;</a> <a href="#top">&uarr;</a></span></h3>
-
-<pre>The Standup Doctor
-        --current-entry-tasks=ARRAY  List of current entry&#39;s tasks
-        --previous-entry-tasks=ARRAY List of yesterday&#39;s tasks
-        --impediments=ARRAY          List of impediments for current entry
-        --notes=ARRAY                List of notes for current entry
-        --sub-header-order=ARRAY     The order of the sub-headers when writing the file
-        --[no-]append-previous       Append previous tasks? Default is true
-    -f, --file-name-format=STRING    Date-formattable string to use for standup file name
-    -e, --editor=EDITOR              Editor to use for opening standup files
-    -d, --directory=DIRECTORY        The directories where standup files are located
-        --[no-]write                 Write current entry if it doesn&#39;t exist. Default is true
-        --[no-]edit                  Open the file in the editor. Default is true
-    -j, --[no-]json                  Print output as formatted json. Default is false.
-    -v, --[no-]verbose               Verbose output. Default is false.
-    -c, --current                    Print current entry. Disables editing
-    -a, --all                        Print all previous entries. Disables editing</pre>
-
-<p>Any options not set in this file will retain their default values. Note that if you change <code>file_name_format</code>, and don&#39;t use a month or year, there will only ever be one standup file. This could cause issues long-term, as the files will get large over time and possibly cause performance issues.</p>
+<h4 id="label-Available+Config+File+Options+and+Defaults">Available Config File Options and Defaults<span><a href="#label-Available+Config+File+Options+and+Defaults">&para;</a> <a href="#top">&uarr;</a></span></h4>
+
+<pre class="ruby"><span class="ruby-constant">StandupMD</span>.<span class="ruby-identifier">configure</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">c</span><span class="ruby-operator">|</span>
+  <span class="ruby-comment"># Defaults for how the file is formatted.</span>
+  <span class="ruby-comment"># See https://evanthegrayt.github.io/standup_md/doc/StandupMD/Config/Cli.html</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">header_date_format</span> = <span class="ruby-string">&#39;%Y-%m-%d&#39;</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">header_depth</span>       = <span class="ruby-value">1</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">sub_header_depth</span>   = <span class="ruby-value">2</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">current_header</span>     = <span class="ruby-string">&#39;Current&#39;</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">previous_header</span>    = <span class="ruby-string">&#39;Previous&#39;</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">impediments_header</span> = <span class="ruby-string">&#39;Impediments&#39;</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">notes_header</span>       = <span class="ruby-string">&#39;Notes&#39;</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">sub_header_order</span>   = <span class="ruby-node">%w[previous current impediments notes]</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">directory</span>          = <span class="ruby-operator">::</span><span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-constant">ENV</span>[<span class="ruby-string">&#39;HOME&#39;</span>], <span class="ruby-string">&#39;.cache&#39;</span>, <span class="ruby-string">&#39;standup_md&#39;</span>)
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">bullet_character</span>   = <span class="ruby-string">&#39;-&#39;</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">name_format</span>        = <span class="ruby-string">&#39;%Y_%m.md&#39;</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">create</span>             = <span class="ruby-keyword">true</span>
+
+  <span class="ruby-comment"># Defaults for entries</span>
+  <span class="ruby-comment"># See https://evanthegrayt.github.io/standup_md/doc/StandupMD/Config/Entry.html</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">entry</span>.<span class="ruby-identifier">current</span>          = [<span class="ruby-string">&quot;&lt;!-- ADD TODAY&#39;S WORK HERE --&gt;&quot;</span>]
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">entry</span>.<span class="ruby-identifier">previous</span>         = []
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">entry</span>.<span class="ruby-identifier">impediments</span>      = [<span class="ruby-string">&#39;None&#39;</span>]
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">entry</span>.<span class="ruby-identifier">notes</span>            = []
+
+  <span class="ruby-comment"># Defaults for executable runtime behavior.</span>
+  <span class="ruby-comment"># See https://evanthegrayt.github.io/standup_md/doc/StandupMD/Config/Cli.html</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">cli</span>.<span class="ruby-identifier">date</span>               = <span class="ruby-constant">Date</span>.<span class="ruby-identifier">today</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">cli</span>.<span class="ruby-identifier">editor</span>             = <span class="ruby-string">&#39;vim&#39;</span> <span class="ruby-comment"># Checks $VISUAL and $EDITOR first, in that order</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">cli</span>.<span class="ruby-identifier">verbose</span>            = <span class="ruby-keyword">false</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">cli</span>.<span class="ruby-identifier">edit</span>               = <span class="ruby-keyword">true</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">cli</span>.<span class="ruby-identifier">write</span>              = <span class="ruby-keyword">true</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">cli</span>.<span class="ruby-identifier">print</span>              = <span class="ruby-keyword">false</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">cli</span>.<span class="ruby-identifier">auto_fill_previous</span> = <span class="ruby-keyword">true</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">cli</span>.<span class="ruby-identifier">preference_file</span>    = <span class="ruby-operator">::</span><span class="ruby-constant">File</span>.<span class="ruby-identifier">expand_path</span>(<span class="ruby-operator">::</span><span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span>(<span class="ruby-constant">ENV</span>[<span class="ruby-string">&#39;HOME&#39;</span>], <span class="ruby-string">&#39;.standuprc&#39;</span>))
+<span class="ruby-keyword">end</span>
+</pre>
 
-<p>If you wanted to add some tasks at runtime, and without opening the file in an editor, you could use the following:</p>
+<h4 id="label-Executable+Flags">Executable Flags<span><a href="#label-Executable+Flags">&para;</a> <a href="#top">&uarr;</a></span></h4>
+
+<pre>--current ARRAY            List of current entry&#39;s tasks
+    --previous ARRAY           List of precious entry&#39;s tasks
+    --impediments ARRAY        List of impediments for current entry
+    --notes ARRAY              List of notes for current entry
+    --sub-header-order ARRAY   The order of the sub-headers when writing the file
+-f, --file-name-format STRING  Date-formattable string to use for standup file name
+-E, --editor EDITOR            Editor to use for opening standup files
+-d, --directory DIRECTORY      The directories where standup files are located
+-w  --[no-]write               Write current entry if it doesn&#39;t exist. Default is true
+-a  --[no-]auto-fill-previous  Auto-generate &#39;previous&#39; tasks for new entries
+-e  --[no-]edit                Open the file in the editor. Default is true
+-v, --[no-]verbose             Verbose output. Default is false.
+-p, --print [DATE]             Print current entry.
+                               If DATE is passed, will print entry for DATE, if it exists.
+                               DATE must be in the same format as file-name-format</pre>
 
-<pre>standup --no-edit --current-entry-tasks=&quot;Work on this thing&quot;,&quot;And another thing!&quot;</pre>
+<p>Any options not set in this file will retain their default values. Note that if you change <code>file_name_format</code>, and don&#39;t use a month or year, there will only ever be one standup file. This could cause issues long-term, as the files will get large over time and possibly cause performance issues.</p>
 
-<h3 id="label-Using+Existing+Standup+Files">Using Existing Standup Files<span><a href="#label-Using+Existing+Standup+Files">&para;</a> <a href="#top">&uarr;</a></span></h3>
+<h4 id="label-Using+Existing+Standup+Files">Using Existing Standup Files<span><a href="#label-Using+Existing+Standup+Files">&para;</a> <a href="#top">&uarr;</a></span></h4>
 
 <p>If you already have a directory of existing standup files, you can use them, but they must be in a format that the parser can understand. The default is:</p>
 
@@ -277,7 +320,7 @@ sub_header_order:
 ## Notes
 - notes, if any are present</pre>
 
-<p>The order, words, date format, and header level are all customizable, but the overall format must be the same. If customization is necessary, this must be done in <code>~/.standup_md.yml</code> before execution, or else the parser will error.</p>
+<p>The order, words, date format, and header level are all customizable, but the overall format must be the same. If customization is necessary, this must be done in <code>~/.standuprc</code> before execution, or else the parser will error.</p>
 
 <p>For example, if you wanted the format to be as follows:</p>
 
@@ -291,48 +334,50 @@ sub_header_order:
 ### Notes
 * notes, if any are present</pre>
 
-<p>Your <code>~/.standup_md.yml</code> should contain:</p>
-
-<pre>header_depth:        2
-sub_header_depth:    3
-current_header:      Today
-previous_header:     Yesterday
-impediments_header:  Hold-ups
-bullet_character:    &#39;*&#39;
-header_date_format:  &#39;%m/%d/%Y&#39;
-sub_header_order:
-  - current
-  - previous
-  - impediments
-  - notes</pre>
+<p>Your <code>~/.standuprc</code> should contain:</p>
+
+<pre class="ruby"><span class="ruby-constant">StandupMD</span>.<span class="ruby-identifier">configure</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">c</span><span class="ruby-operator">|</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">header_depth</span>       = <span class="ruby-value">2</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">sub_header_depth</span>   = <span class="ruby-value">3</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">current_header</span>     = <span class="ruby-string">&#39;Today&#39;</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">previous_header</span>    = <span class="ruby-string">&#39;Yesterday&#39;</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">impediments_header</span> = <span class="ruby-string">&#39;Hold-ups&#39;</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">bullet_character</span>   = <span class="ruby-string">&#39;*&#39;</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">header_date_format</span> = <span class="ruby-string">&#39;%m/%d/%Y&#39;</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">sub_header_order</span>   = <span class="ruby-node">%w[current previous impediments notes]</span>
+<span class="ruby-keyword">end</span>
+</pre>
 
 <h2 id="label-API">API<span><a href="#label-API">&para;</a> <a href="#top">&uarr;</a></span></h2>
 
-<p>Below are some quick examples, but the API is fully documented in the <a href="https://evanthegrayt.github.io/standup_md/doc/index.html">documentation</a>.</p>
+<p>The API is fully documented in the <a href="https://evanthegrayt.github.io/standup_md/doc/index.html">RDoc Documentation</a>.</p>
 
-<p>This was mainly written as a command line utility, but I made the API available for scripting. There are attribute accessors for most of the settings in the <a href="#customization-and-runtime-options">customization table</a> above. A quick example of how to write a new entry via code could look like the following:</p>
+<p>This was mainly written as a command line utility, but the API is ridiculously robust, and is available for use in your own projects. A quick example of how to write a new entry via code could look like the following:</p>
+
+<h3 id="label-API+Examples">API Examples<span><a href="#label-API+Examples">&para;</a> <a href="#top">&uarr;</a></span></h3>
 
 <pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">&#39;standup_md&#39;</span>
 
-<span class="ruby-identifier">standup</span> = <span class="ruby-constant">StandupMD</span>.<span class="ruby-identifier">load</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">s</span><span class="ruby-operator">|</span>
-  <span class="ruby-identifier">s</span>.<span class="ruby-identifier">current_header</span> = <span class="ruby-string">&#39;Today&#39;</span>,
-  <span class="ruby-identifier">s</span>.<span class="ruby-identifier">current_entry_tasks</span> = [<span class="ruby-string">&#39;Thing to do today&#39;</span>, <span class="ruby-string">&#39;Another thing to do today&#39;</span>],
-  <span class="ruby-identifier">s</span>.<span class="ruby-identifier">impediments</span> = [<span class="ruby-string">&#39;Not enough time in the day&#39;</span>]
+<span class="ruby-constant">StandupMD</span>.<span class="ruby-identifier">configure</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">c</span><span class="ruby-operator">|</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">current_header</span> = <span class="ruby-string">&#39;Today&#39;</span>,
 <span class="ruby-keyword">end</span>
 
-<span class="ruby-identifier">standup</span>.<span class="ruby-identifier">write</span>
+<span class="ruby-identifier">file</span> = <span class="ruby-constant">StandupMD</span><span class="ruby-operator">::</span><span class="ruby-constant">File</span>.<span class="ruby-identifier">find_by_date</span>(<span class="ruby-constant">Date</span>.<span class="ruby-identifier">today</span>)
+<span class="ruby-identifier">entry</span> = <span class="ruby-constant">StandupMD</span><span class="ruby-operator">::</span><span class="ruby-constant">Entry</span>.<span class="ruby-identifier">create</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">e</span><span class="ruby-operator">|</span> <span class="ruby-identifier">e</span>.<span class="ruby-identifier">current</span> = [<span class="ruby-string">&#39;Stuff I will do today&#39;</span>] }
+<span class="ruby-identifier">file</span>.<span class="ruby-identifier">entries</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">entry</span>
+<span class="ruby-identifier">file</span>.<span class="ruby-identifier">write</span>
 </pre>
 
-<p>Note: <code>StandupMD.load { ... }</code> just is a quick way to call <code>StandupMD.new { ... }.load</code></p>
-
-<p>Entries are just hashes, so you can easily transform them to <code>json</code> objects.</p>
+<p>The above example was written as such to show how the different pieces of the API fit together. The code can actually be simplified to the following.</p>
 
 <pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">&#39;standup_md&#39;</span>
-<span class="ruby-identifier">require</span> <span class="ruby-string">&#39;json&#39;</span>
 
-<span class="ruby-identifier">standup</span> = <span class="ruby-constant">StandupMD</span>.<span class="ruby-identifier">load</span>
+<span class="ruby-constant">StandupMD</span>.<span class="ruby-identifier">configure</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">c</span><span class="ruby-operator">|</span>
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">current_header</span> = <span class="ruby-string">&#39;Today&#39;</span>,
+  <span class="ruby-identifier">c</span>.<span class="ruby-identifier">entry</span>.<span class="ruby-identifier">current</span> = [<span class="ruby-string">&#39;Stuff I will do today&#39;</span>]
+<span class="ruby-keyword">end</span>
 
-<span class="ruby-identifier">standup_json</span> = <span class="ruby-identifier">standup</span>.<span class="ruby-identifier">all_entries</span>.<span class="ruby-identifier">to_json</span>
+<span class="ruby-constant">StandupMD</span><span class="ruby-operator">::</span><span class="ruby-constant">File</span>.<span class="ruby-identifier">find_by_date</span>(<span class="ruby-constant">Date</span>.<span class="ruby-identifier">today</span>).<span class="ruby-identifier">load</span>.<span class="ruby-identifier">write</span>
 </pre>
 
 <h2 id="label-Reporting+Bugs+and+Requesting+Features">Reporting Bugs and Requesting Features<span><a href="#label-Reporting+Bugs+and+Requesting+Features">&para;</a> <a href="#top">&uarr;</a></span></h2>