standup_md 0.3.14 → 0.3.16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e9e2449a7136b2b9b9633db530b2304ddc986050bb404c951cb0da1cb299330b
-  data.tar.gz: 52106b7870dee25cf07070fd6e6ff689c84e3142bdb1249077f8ea757d56eac1
+  metadata.gz: 171d0b1fdd697049f52d50db4d1b0ccb95db648dc70b67957c612ebdf74c57b2
+  data.tar.gz: 1c2347af65439e1d8263715eeb3d9b45b4cbc020793ddb1a51dbbd71ee71159b
 SHA512:
-  metadata.gz: 27248294c5f4d85bb5b1c4ae5df44d4133bfbe968acc30aba3917df29424f00b56c56bb12ea1219fe0b0c2ce311699f912957f616526db5ee43939c11abf7def
-  data.tar.gz: dfc856d09518702f57bc7fdb2a1610ce5143c165340709e067a4509ca7fc7789bd247422f6ac3952a678006789dc939a8f8e12b7f318b3e63cec140dab5c82b3
+  metadata.gz: faca92ff7d839b8fb83c579bc203ba3477e975d225f2fd7ef5c3c8b37625a674ed6a7e89e7f9033c2169f5cc6f52c0e7ae9a046fb29880bd95f1ac7a56bc400c
+  data.tar.gz: f365e31e43288e039e9c35b887f905a5def1233200d34fead1a250df79215f107cc5ff16534e503d074f1e2b29620fad64b285f94ce68042226cc3a6a1e04fcf

data/.github/workflows/ruby.yml

@@ -1,4 +1,5 @@
-name: Ruby
+# .github/workflows/ruby.yml
+name: Ruby CI
 
 on:
   push:
@@ -8,17 +9,31 @@ on:
 
 jobs:
   test:
+    runs-on: ubuntu-22.04
 
-    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby-version: ['3.2', '3.3', '4.0']
 
     steps:
-    - uses: actions/checkout@v2
-    - name: Set up Ruby 2.6
-      uses: actions/setup-ruby@v1
-      with:
-        ruby-version: 2.6.x
-    - name: Build and test with Rake
-      run: |
-        gem install bundler
-        bundle install
-        bundle exec rake test
+      - uses: actions/checkout@v3
+
+      # Set up Ruby and Bundler
+      - name: Set up Ruby ${{ matrix.ruby-version }}
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby-version }}
+          bundler: ${{ matrix.ruby-version == '4.0' && '4.0.9' || '2.4.13' }}
+          bundler-cache: true
+
+      - name: Print Ruby and Bundler versions
+        run: |
+          ruby -v
+          bundle -v
+
+      - name: Install dependencies
+        run: bundle install --jobs 4 --retry 3
+
+      - name: Run tests
+        run: bundle exec rake

data/Gemfile.lock

@@ -1,31 +1,126 @@
 PATH
   remote: .
   specs:
-    standup_md (0.3.13)
+    standup_md (0.3.16)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    docile (1.3.5)
-    power_assert (2.0.0)
-    rake (13.0.3)
-    simplecov (0.21.2)
+    ast (2.4.3)
+    date (3.5.1)
+    docile (1.4.1)
+    erb (6.0.4)
+    json (2.19.9)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    parallel (1.28.0)
+    parser (3.3.11.1)
+      ast (~> 2.4.1)
+      racc
+    power_assert (3.0.1)
+    prism (1.9.0)
+    psych (5.4.0)
+      date
+      stringio
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.4.2)
+    rdoc (7.2.0)
+      erb
+      psych (>= 4.0.0)
+      tsort
+    regexp_parser (2.12.0)
+    rubocop (1.84.2)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.49.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    rubocop-performance (1.26.1)
+      lint_roller (~> 1.1)
+      rubocop (>= 1.75.0, < 2.0)
+      rubocop-ast (>= 1.47.1, < 2.0)
+    ruby-progressbar (1.13.0)
+    simplecov (0.22.0)
       docile (~> 1.1)
       simplecov-html (~> 0.11)
       simplecov_json_formatter (~> 0.1)
-    simplecov-html (0.12.3)
-    simplecov_json_formatter (0.1.2)
-    test-unit (3.4.1)
+    simplecov-html (0.13.2)
+    simplecov_json_formatter (0.1.4)
+    standard (1.54.0)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.84.0)
+      standard-custom (~> 1.0.0)
+      standard-performance (~> 1.8)
+    standard-custom (1.0.2)
+      lint_roller (~> 1.0)
+      rubocop (~> 1.50)
+    standard-performance (1.9.0)
+      lint_roller (~> 1.1)
+      rubocop-performance (~> 1.26.0)
+    stringio (3.2.0)
+    test-unit (3.7.8)
       power_assert
+    tsort (0.2.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
 
 PLATFORMS
-  x86_64-darwin-20
+  arm64-darwin-25
+  ruby
 
 DEPENDENCIES
   rake (~> 13.0, >= 13.0.1)
+  rdoc
   simplecov
+  standard (~> 1.54.0)
   standup_md!
   test-unit (~> 3.3, >= 3.3.5)
 
+CHECKSUMS
+  ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
+  date (3.5.1) sha256=750d06384d7b9c15d562c76291407d89e368dda4d4fff957eb94962d325a0dc0
+  docile (1.4.1) sha256=96159be799bfa73cdb721b840e9802126e4e03dfc26863db73647204c727f21e
+  erb (6.0.4) sha256=38e3803694be357fe2bfe312487c74beaf9fb4e5beb3e22498952fe1645b95d9
+  json (2.19.9) sha256=9b9025b7cdddafa38d316eca0b2358488e42d417045c1b90d216a9fefe46b79a
+  language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
+  lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87
+  parallel (1.28.0) sha256=33e6de1484baf2524792d178b0913fc8eb94c628d6cfe45599ad4458c638c970
+  parser (3.3.11.1) sha256=d17ace7aabe3e72c3cc94043714be27cc6f852f104d81aa284c2281aecc65d54
+  power_assert (3.0.1) sha256=8ce9876716cc74e863fcd4cdcdc52d792bd983598d1af3447083a3a9a4d34103
+  prism (1.9.0) sha256=7b530c6a9f92c24300014919c9dcbc055bf4cdf51ec30aed099b06cd6674ef85
+  psych (5.4.0) sha256=14f72d69a611af663d7d70e4a7b67d9eb1f3ae9f8d916b478961d5a0075ba5b7
+  racc (1.8.1) sha256=4a7f6929691dbec8b5209a0b373bc2614882b55fc5d2e447a21aaa691303d62f
+  rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
+  rake (13.4.2) sha256=cb825b2bd5f1f8e91ca37bddb4b9aaf345551b4731da62949be002fa89283701
+  rdoc (7.2.0) sha256=8650f76cd4009c3b54955eb5d7e3a075c60a57276766ebf36f9085e8c9f23192
+  regexp_parser (2.12.0) sha256=35a916a1d63190ab5c9009457136ae5f3c0c7512d60291d0d1378ba18ce08ebb
+  rubocop (1.84.2) sha256=5692cea54168f3dc8cb79a6fe95c5424b7ea893c707ad7a4307b0585e88dbf5f
+  rubocop-ast (1.49.1) sha256=4412f3ee70f6fe4546cc489548e0f6fcf76cafcfa80fa03af67098ffed755035
+  rubocop-performance (1.26.1) sha256=cd19b936ff196df85829d264b522fd4f98b6c89ad271fa52744a8c11b8f71834
+  ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
+  simplecov (0.22.0) sha256=fe2622c7834ff23b98066bb0a854284b2729a569ac659f82621fc22ef36213a5
+  simplecov-html (0.13.2) sha256=bd0b8e54e7c2d7685927e8d6286466359b6f16b18cb0df47b508e8d73c777246
+  simplecov_json_formatter (0.1.4) sha256=529418fbe8de1713ac2b2d612aa3daa56d316975d307244399fa4838c601b428
+  standard (1.54.0) sha256=7a4b08f83d9893083c8f03bc486f0feeb6a84d48233b40829c03ef4767ea0100
+  standard-custom (1.0.2) sha256=424adc84179a074f1a2a309bb9cf7cd6bfdb2b6541f20c6bf9436c0ba22a652b
+  standard-performance (1.9.0) sha256=49483d31be448292951d80e5e67cdcb576c2502103c7b40aec6f1b6e9c88e3f2
+  standup_md (0.3.16)
+  stringio (3.2.0) sha256=c37cb2e58b4ffbd33fe5cd948c05934af997b36e0b6ca6fdf43afa234cf222e1
+  test-unit (3.7.8) sha256=689d1ca53f4d46f678b4e5d68d8e4294f87fc5e8b9238cc4de7c5727e8d65943
+  tsort (0.2.0) sha256=9650a793f6859a43b6641671278f79cfead60ac714148aabe4e3f0060480089f
+  unicode-display_width (3.2.0) sha256=0cdd96b5681a5949cdbc2c55e7b420facae74c4aaf9a9815eee1087cb1853c42
+  unicode-emoji (4.2.0) sha256=519e69150f75652e40bf736106cfbc8f0f73aa3fb6a65afe62fefa7f80b0f80f
+
 BUNDLED WITH
-   2.2.16
+  4.0.10

data/README.md

@@ -6,10 +6,11 @@
 
 > The cure for all your standup woes.
 
-A highly customizable and automated way to keep track of daily standups in
-markdown files.
+An automated, customizable way to keep track of daily standups in markdown
+files.
 
-You can view the documentation [here](https://evanthegrayt.github.io/standup_md/).
+You can view the documentation
+[here](https://evanthegrayt.github.io/standup_md/).
 
 ## About
 I've now been at two separate companies where we post our daily standups in a
@@ -43,7 +44,7 @@ gem install standup_md
 To include in your project, add the following to your `Gemfile`.
 
 ```ruby
-gem 'standup_md'
+gem "standup_md"
 ```
 
 ### Manual Installation
@@ -73,6 +74,14 @@ 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).
 
+To open a previous month's standup file, pass the date as an argument. Both
+`YYYY-MM` and `YYYY-MM-DD` are accepted, and both open the file for that month.
+
+```sh
+standup 2026-06
+standup 2026-06-18
+```
+
 ### CLI Examples
 #### Adding an entry for today via editor
 For example, if the standup entry from yesterday reads as follows:
@@ -150,36 +159,36 @@ rails project, create an initializer (`config/initializers/standup_md.rb`).
 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_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.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.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
+  # 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.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.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'))
+  c.cli.preference_file    = ::File.expand_path(::File.join(ENV["HOME"], ".standuprc"))
 end
 ```
 
@@ -250,11 +259,11 @@ Your `~/.standuprc` should contain:
 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.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
 ```
@@ -270,14 +279,14 @@ new entry via code could look like the following:
 ### API Examples
 #### Adding an entry for today
 ```ruby
-require 'standup_md'
+require "standup_md"
 
 StandupMD.configure do |c|
-  c.file.current_header = 'Today',
+  c.file.current_header = "Today",
 end
 
 file = StandupMD::File.find_by_date(Date.today)
-entry = StandupMD::Entry.create { |e| e.current = ['Stuff I will do today'] }
+entry = StandupMD::Entry.create { |e| e.current = ["Stuff I will do today"] }
 file.entries << entry
 file.write
 ```
@@ -286,11 +295,11 @@ 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 "standup_md"
 
 StandupMD.configure do |c|
-  c.file.current_header = 'Today',
-  c.entry.current = ['Stuff I will do today']
+  c.file.current_header = "Today",
+  c.entry.current = ["Stuff I will do today"]
 end
 
 StandupMD::File.find_by_date(Date.today).load.write
@@ -298,7 +307,7 @@ StandupMD::File.find_by_date(Date.today).load.write
 
 #### Finding a past entry
 ```ruby
-require 'standup_md'
+require "standup_md"
 
 date = Date.new(2020, 04, 15)
 file = StandupMD::File.find_by_date(date).load

data/Rakefile

@@ -1,21 +1,86 @@
 # frozen_string_literal: true
 
-require_relative 'lib/standup_md'
-require 'bundler/gem_tasks'
-require 'rdoc/task'
-require 'rake/testtask'
+$LOAD_PATH.unshift(File.expand_path("lib", __dir__))
+
+require "standup_md"
+require "bundler/gem_tasks"
+require "rdoc/task"
+require "rake/testtask"
+
+STANDARD_FILES = ["lib", "test"].freeze
 
 Rake::TestTask.new do |t|
-  t.libs = ['lib']
+  t.libs = ["lib"]
   t.warning = true
   t.verbose = true
-  t.test_files = FileList['test/**/*_test.rb']
+  t.test_files = FileList["test/**/*_test.rb"]
 end
 
 RDoc::Task.new do |rdoc|
-  rdoc.main = 'README.md'
-  rdoc.rdoc_dir = 'docs'
-  rdoc.rdoc_files.include('README.md', 'lib/**/*.rb')
+  rdoc.main = "README.md"
+  rdoc.rdoc_dir = "docs"
+  rdoc.rdoc_files.include("README.md", "lib/**/*.rb")
+end
+
+desc "Lint with the Standard Ruby style guide"
+task :standard do
+  require "standard"
+
+  exit_code = Standard::Cli.new(STANDARD_FILES).run
+  fail unless exit_code.zero?
+end
+
+desc "Lint and automatically make safe fixes with the Standard Ruby style guide"
+task :"standard:fix" do
+  require "standard"
+
+  exit_code = Standard::Cli.new(STANDARD_FILES + ["--fix"]).run
+  fail unless exit_code.zero?
 end
 
 task default: :test
+
+namespace :version do
+  desc "Print the current version from the version.rb file"
+  task :current do
+    puts StandupMD::VERSION
+  end
+
+  namespace :increment do
+    desc "Increment the version's PATCH level"
+    task :patch do
+      File.join(__dir__, "lib", "standup_md", "version.rb").then do |version_file|
+        File.write(
+          version_file,
+          File.read(version_file).sub(/(PATCH\s=\s)(\d+)/) { "#{$1}#{$2.next}" }
+        )
+      end
+      system("bundle lock")
+    end
+    desc "Increment the version's MINOR level"
+    task :minor do
+      File.join(__dir__, "lib", "standup_md", "version.rb").then do |version_file|
+        File.write(
+          version_file,
+          File.read(version_file)
+            .sub(/(PATCH\s=\s)(\d+)/) { "#{$1}0" }
+            .sub(/(MINOR\s=\s)(\d+)/) { "#{$1}#{$2.next}" }
+        )
+      end
+      system("bundle lock")
+    end
+    desc "Increment the version's MAJOR level"
+    task :major do
+      File.join(__dir__, "lib", "standup_md", "version.rb").then do |version_file|
+        File.write(
+          version_file,
+          File.read(version_file)
+            .sub(/(PATCH\s=\s)(\d+)/) { "#{$1}0" }
+            .sub(/(MINOR\s=\s)(\d+)/) { "#{$1}0" }
+            .sub(/(MAJOR\s=\s)(\d+)/) { "#{$1}#{$2.next}" }
+        )
+      end
+      system("bundle lock")
+    end
+  end
+end

data/bin/standup

@@ -1,5 +1,7 @@
 #!/usr/bin/env ruby
 
-require_relative '../lib/standup_md'
+$LOAD_PATH.unshift(File.expand_path("../lib", __dir__))
+
+require "standup_md"
 
 StandupMD::Cli.execute(ARGV)

data/lib/standup_md/cli/helpers.rb

@@ -20,7 +20,7 @@ module StandupMD
           next if !tasks || tasks.empty?
 
           puts sub_header(header_type)
-          tasks.each { |task| puts config.file.bullet_character + ' ' + task }
+          tasks.each { |task| puts "#{config.file.bullet_character} #{task}" }
         end
         puts
       end
@@ -42,79 +42,84 @@ module StandupMD
       # @return [Hash]
       def load_runtime_preferences(options)
         OptionParser.new do |opts|
-          opts.banner = 'The Standup Doctor'
+          opts.banner = "The Standup Doctor"
           opts.version = "[StandupMD] #{::StandupMD::Version}"
           opts.on(
-            '--current ARRAY', Array,
+            "--current ARRAY", Array,
             "List of current entry's tasks"
           ) { |v| config.entry.current = v }
 
           opts.on(
-            '--previous ARRAY', Array,
+            "--previous ARRAY", Array,
             "List of precious entry's tasks"
           ) { |v| config.entry.previous = v }
 
           opts.on(
-            '--impediments ARRAY', Array,
-            'List of impediments for current entry'
+            "--impediments ARRAY", Array,
+            "List of impediments for current entry"
           ) { |v| config.entry.impediments = v }
 
           opts.on(
-            '--notes ARRAY', Array,
-            'List of notes for current entry'
+            "--notes ARRAY", Array,
+            "List of notes for current entry"
           ) { |v| config.entry.notes = v }
 
           opts.on(
-            '--sub-header-order ARRAY', Array,
-            'The order of the sub-headers when writing the file'
+            "--sub-header-order ARRAY", Array,
+            "The order of the sub-headers when writing the file"
           ) { |v| config.file.sub_header_order = v }
 
           opts.on(
-            '-f', '--file-name-format STRING',
-            'Date-formattable string to use for standup file name'
+            "-f", "--file-name-format STRING",
+            "Date-formattable string to use for standup file name"
           ) { |v| config.file.name_format = v }
 
           opts.on(
-            '-E', '--editor EDITOR',
-            'Editor to use for opening standup files'
+            "-E", "--editor EDITOR",
+            "Editor to use for opening standup files"
           ) { |v| config.cli.editor = v }
 
           opts.on(
-            '-d', '--directory DIRECTORY',
-            'The directories where standup files are located'
+            "-d", "--directory DIRECTORY",
+            "The directories where standup files are located"
           ) { |v| config.file.directory = v }
 
           opts.on(
-            '-w', '--[no-]write',
+            "-w", "--[no-]write",
             "Write current entry if it doesn't exist. Default is true"
           ) { |v| config.cli.write = v }
 
           opts.on(
-            '-a', '--[no-]auto-fill-previous',
+            "-a", "--[no-]auto-fill-previous",
             "Auto-generate 'previous' tasks for new entries. Default is true"
           ) { |v| config.cli.auto_fill_previous = v }
 
           opts.on(
-            '-e', '--[no-]edit',
-            'Open the file in the editor. Default is true'
+            "-e", "--[no-]edit",
+            "Open the file in the editor. Default is true"
           ) { |v| config.cli.edit = v }
 
           opts.on(
-            '-v', '--[no-]verbose',
-            'Verbose output. Default is false.'
+            "-v", "--[no-]verbose",
+            "Verbose output. Default is false."
           ) { |v| config.cli.verbose = v }
 
           opts.on(
-            '-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'
+            "-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"
           ) do |v|
             config.cli.print = true
             config.cli.date =
               v.nil? ? Date.today : Date.strptime(v, config.file.header_date_format)
           end
         end.parse!(options)
+        unless options.empty?
+          @file_date_argument = true
+          config.cli.date = parse_file_date(options.shift)
+        end
+        raise OptionParser::InvalidArgument, options.join(" ") unless options.empty?
       end
 
       ##
@@ -123,7 +128,7 @@ module StandupMD
       # @return [StandupMD::Entry]
       def new_entry(file)
         entry = file.entries.find(config.cli.date)
-        return entry unless entry.nil? && config.cli.date == Date.today
+        return entry if read_only? || entry || config.cli.date != Date.today
 
         StandupMD::Entry.new(
           config.cli.date,
@@ -131,7 +136,7 @@ module StandupMD
           previous_entry(file),
           config.entry.impediments,
           config.entry.notes
-        ).tap { |entry| file.entries << entry }
+        ).tap { |e| file.entries << e }
       end
 
       ##
@@ -145,6 +150,25 @@ module StandupMD
         prev_entry(file.entries)
       end
 
+      ##
+      # Parses the optional file date argument.
+      #
+      # @param [String] value
+      #
+      # @return [Date]
+      def parse_file_date(value)
+        case value
+        when /\A\d{4}-\d{2}-\d{2}\z/
+          Date.strptime(value, "%Y-%m-%d")
+        when /\A\d{4}-\d{2}\z/
+          Date.strptime(value, "%Y-%m")
+        else
+          raise OptionParser::InvalidArgument, value
+        end
+      rescue ArgumentError
+        raise OptionParser::InvalidArgument, value
+      end
+
       ##
       # The previous entry.
       #
@@ -170,7 +194,7 @@ module StandupMD
       #
       # @return [String]
       def header(entry)
-        '#' * config.file.header_depth + ' ' +
+        "#" * config.file.header_depth + " " +
           entry.date.strftime(config.file.header_date_format)
       end
 
@@ -181,7 +205,7 @@ module StandupMD
       #
       # @return [String]
       def sub_header(header_type)
-        '#' * config.file.sub_header_depth + ' ' +
+        "#" * config.file.sub_header_depth + " " +
           config.file.public_send("#{header_type}_header").capitalize
       end
     end