doing 2.1.22 → 2.1.26

data/docs/doc/top-level-namespace.html

@@ -86,7 +86,7 @@
     
   
     
-      <strong class="classes">Classes:</strong> <span class='object_link'><a href="Array.html" title="Array (class)">Array</a></span>, <span class='object_link'><a href="Hash.html" title="Hash (class)">Hash</a></span>, <span class='object_link'><a href="Numeric.html" title="Numeric (class)">Numeric</a></span>, <span class='object_link'><a href="String.html" title="String (class)">String</a></span>, <span class='object_link'><a href="Symbol.html" title="Symbol (class)">Symbol</a></span>, <span class='object_link'><a href="Time.html" title="Time (class)">Time</a></span>
+      <strong class="classes">Classes:</strong> <span class='object_link'><a href="Array.html" title="Array (class)">Array</a></span>, <span class='object_link'><a href="FalseClass.html" title="FalseClass (class)">FalseClass</a></span>, <span class='object_link'><a href="Hash.html" title="Hash (class)">Hash</a></span>, <span class='object_link'><a href="Numeric.html" title="Numeric (class)">Numeric</a></span>, <span class='object_link'><a href="Object.html" title="Object (class)">Object</a></span>, <span class='object_link'><a href="String.html" title="String (class)">String</a></span>, <span class='object_link'><a href="Symbol.html" title="Symbol (class)">Symbol</a></span>, <span class='object_link'><a href="Time.html" title="Time (class)">Time</a></span>, <span class='object_link'><a href="TrueClass.html" title="TrueClass (class)">TrueClass</a></span>
     
   
 </p>
@@ -102,7 +102,7 @@
 </div>
 
       <div id="footer">
-  Generated on Fri Jan 21 14:53:33 2022 by
+  Generated on Sun Jan 23 16:30:43 2022 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.9.27 (ruby-3.0.1).
 </div>

data/docs/index.md

@@ -8,7 +8,7 @@ _If you're one of the rare people like me who find this useful, feel free to
 
 
 
-The current version of `doing` is 2.1.13.
+The current version of `doing` is 2.1.21.
 
 Find all of the documentation in the [doing wiki][wiki].
 

data/doing.rdoc

@@ -5,7 +5,7 @@ record of what you've been doing, complete with tag-based time tracking. The
 command line tool allows you to add entries, annotate with tags and notes, and
 view your entries with myriad options, with a focus on a "natural" language syntax.
 
-v2.1.22
+v2.1.26
 
 === Global Options
 === --config_file arg
@@ -165,7 +165,7 @@ Prompt for note via multi-line input
 
 
 ===== -e|--editor
-Edit duplicated entry with vim before adding
+Edit duplicated entry with /opt/homebrew/bin/vim before adding
 
 
 
@@ -403,18 +403,55 @@ Force exact search string matching (case sensitive)
 
 
 
-==== Command: <tt>changelog|changes </tt>
+==== Command: <tt>changes|changelog </tt>
 List recent changes in Doing
 
-Display a formatted list of changes in recent versions, latest at the top
-==== Command: <tt>choose </tt>
-Select a section to display from a menu
+Display a formatted list of changes in recent versions.
+
+            Without flags, displays only the most recent version.
+            Use --lookup or --all for history.
+===== Options
+===== -l|--lookup VERSION
+
+Look up a specific version. Specify versions as "MAJ.MIN.PATCH", MIN
+           and PATCH are optional. Use > or < to see all changes since or prior
+           to a version.
+
+[Default Value] None
+[Must Match] (?-mix:^(?:(?:(?:[<>=]|p(?:rior)|b(?:efore)|o(?:lder)|s(?:ince)|a(?:fter)|n(?:ewer))? *[\d.*?]+ *)+|(?:[\d.]+ *-+ *[\d.]+))$)
+
+
+===== -s|--search arg
+
+Show changelogs matching search terms (uses pattern-based searching).
+           Add slashes to search with regular expressions, e.g. `--search "/output.*flag/"`
+
+[Default Value] None
+
+
+===== -a|--all
+Display all versions
+
 
 
 ==== Command: <tt>colors </tt>
 List available color variables for configuration templates and views
 
 
+==== Command: <tt>commands </tt>
+Enable and disable Doing commands
+
+
+===== Commands
+====== Command: <tt>add|enable  COMMAND [COMMAND...]</tt>
+Enable Doing commands
+
+Run without arguments to select commands from a list.
+====== Command: <tt>remove|disable </tt>
+Disable Doing commands
+
+
+[Default Command] add
 ==== Command: <tt>completion </tt>
 Generate shell completion scripts
 
@@ -598,7 +635,7 @@ Include date
 
 
 ===== -e|--editor
-Edit entry with vim (with no arguments, edits the last entry)
+Edit entry with /opt/homebrew/bin/vim (with no arguments, edits the last entry)
 
 
 
@@ -763,6 +800,13 @@ Case sensitivity for search string matching [(c)ase-sensitive, (i)gnore, (s)mart
 [Must Match] (?-mix:^[csi])
 
 
+===== --config_template TEMPLATE_KEY
+
+Output using a template from configuration
+
+[Default Value] default
+
+
 ===== --from DATE_OR_RANGE
 
 Date range to show, or a single day to filter date on.
@@ -797,6 +841,13 @@ Sort tags by (name|time)
 [Must Match] (?i-mx:^(?:name|time)$)
 
 
+===== --template TEMPLATE_STRING
+
+Override output format with a template string containing %placeholders
+
+[Default Value] None
+
+
 ===== --val QUERY
 
 Perform a tag value query ("@done > two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool
@@ -816,7 +867,7 @@ Show elapsed time on entries without @done tag
 
 
 ===== -e|--editor
-Edit matching entries with vim
+Edit matching entries with /opt/homebrew/bin/vim
 
 
 
@@ -983,6 +1034,13 @@ Case sensitivity for search string matching [(c)ase-sensitive, (i)gnore, (s)mart
 [Must Match] (?-mix:^[csi])
 
 
+===== --config_template TEMPLATE_KEY
+
+Output using a template from configuration
+
+[Default Value] last
+
+
 ===== -s|--section NAME
 
 Specify a section
@@ -1004,6 +1062,13 @@ Tag filter, combine multiple tags with a comma. Wildcards allowed (*, ?)
 [Default Value] None
 
 
+===== --template TEMPLATE_STRING
+
+Override output format with a template string containing %placeholders
+
+[Default Value] None
+
+
 ===== --val QUERY
 
 Perform a tag value query ("@done > two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool
@@ -1023,7 +1088,7 @@ Show elapsed time if entry is not tagged @done
 
 
 ===== -e|--editor
-Edit entry with vim
+Edit entry with /opt/homebrew/bin/vim
 
 
 
@@ -1067,7 +1132,7 @@ Prompt for note via multi-line input
 
 
 ===== -e|--editor
-Edit entry with vim
+Edit entry with /opt/homebrew/bin/vim
 
 
 
@@ -1205,7 +1270,7 @@ Prompt for note via multi-line input
 
 
 ===== -e|--editor
-Edit entry with vim
+Edit entry with /opt/homebrew/bin/vim
 
 
 
@@ -1269,7 +1334,7 @@ Prompt for note via multi-line input
 
 
 ===== -e|--editor
-Edit entry with vim
+Edit entry with /opt/homebrew/bin/vim
 
 
 
@@ -1302,7 +1367,7 @@ A parenthetical at the end of the entry will be converted to a note.
 
 Run without arguments to create a new entry interactively.
 
-Run with --editor to create a new entry using vim.
+Run with --editor to create a new entry using /opt/homebrew/bin/vim.
 ===== Options
 ===== -b|--back|--started DATE_STRING
 
@@ -1311,6 +1376,14 @@ Backdate start time [4pm|20m|2h|"yesterday noon"]
 [Default Value] None
 
 
+===== --from TIME_RANGE
+
+Set a start and optionally end time as a date range ("from 1pm to 2:30pm").
+        If an end time is provided, a dated @done tag will be added
+
+[Default Value] None
+
+
 ===== -n|--note TEXT
 
 Include a note
@@ -1331,7 +1404,7 @@ Prompt for note via multi-line input
 
 
 ===== -e|--editor
-Edit entry with vim
+Edit entry with /opt/homebrew/bin/vim
 
 
 
@@ -1347,6 +1420,13 @@ Date argument can be natural language. "thursday" would be interpreted as "last
 and "2d" would be interpreted as "two days ago." If you use "to" or "through" between two dates,
 it will create a range.
 ===== Options
+===== --config_template TEMPLATE_KEY
+
+Output using a template from configuration
+
+[Default Value] default
+
+
 ===== -o|--output FORMAT
 
 Output to export format (csv|dayone|dayone-days|dayone-entries|doing|html|json|markdown|say|taskpaper|template|timeline|wiki)
@@ -1369,6 +1449,13 @@ Sort tags by (name|time)
 [Must Match] (?i-mx:^(?:name|time)$)
 
 
+===== --template TEMPLATE_STRING
+
+Override output format with a template string containing %placeholders
+
+[Default Value] None
+
+
 ===== --[no-]duration
 Show elapsed time on entries without @done tag
 
@@ -1388,7 +1475,7 @@ Show time totals at the end of output
 Open the "doing" file in an editor
 
 `doing open` defaults to using the editors->doing_file setting
-in /Users/ttscoff/.config/doing/config.yml (TaskPaper).
+in /Users/ttscoff/.config/doing/config.yml (/opt/homebrew/bin/vim).
 ===== Options
 ===== -a|--app APP_NAME
 
@@ -1438,6 +1525,13 @@ List recent entries
 
 
 ===== Options
+===== --config_template TEMPLATE_KEY
+
+Output using a template from configuration
+
+[Default Value] recent
+
+
 ===== -s|--section NAME
 
 Section
@@ -1453,6 +1547,13 @@ Sort tags by (name|time)
 [Must Match] (?i-mx:^(?:name|time)$)
 
 
+===== --template TEMPLATE_STRING
+
+Override output format with a template string containing %placeholders
+
+[Default Value] None
+
+
 ===== --[no-]duration
 Show elapsed time on entries without @done tag
 
@@ -1861,6 +1962,13 @@ Case sensitivity for search string matching [(c)ase-sensitive, (i)gnore, (s)mart
 [Must Match] (?-mix:^[csi])
 
 
+===== --config_template TEMPLATE_KEY
+
+Output using a template from configuration
+
+[Default Value] default
+
+
 ===== --from DATE_OR_RANGE
 
 Date range to show, or a single day to filter date on.
@@ -1918,6 +2026,13 @@ Sort tags by (name|time)
 [Must Match] (?i-mx:^(?:name|time))
 
 
+===== --template TEMPLATE_STRING
+
+Override output format with a template string containing %placeholders
+
+[Default Value] None
+
+
 ===== --val QUERY
 
 Perform a tag value query ("@done > two hours ago" or "@progress < 50"). May be used multiple times, combined with --bool
@@ -1977,6 +2092,13 @@ List entries since a date
 Date argument can be natural language and are always interpreted as being in the past. "thursday" would be interpreted as "last thursday,"
 and "2d" would be interpreted as "two days ago."
 ===== Options
+===== --config_template TEMPLATE_KEY
+
+Output using a template from configuration
+
+[Default Value] default
+
+
 ===== -o|--output FORMAT
 
 Output to export format (csv|dayone|dayone-days|dayone-entries|doing|html|json|markdown|say|taskpaper|template|timeline|wiki)
@@ -1999,6 +2121,13 @@ Sort tags by (name|time)
 [Must Match] (?i-mx:^(?:name|time)$)
 
 
+===== --template TEMPLATE_STRING
+
+Override output format with a template string containing %placeholders
+
+[Default Value] None
+
+
 ===== --[no-]duration
 Show elapsed time on entries without @done tag
 
@@ -2156,7 +2285,7 @@ Remove all default_tags from the local .doingrc
 
 
 
-==== Command: <tt>tags </tt>
+==== Command: <tt>tags  [MAX_COUNT]</tt>
 List all tags in the current Doing file
 
 
@@ -2233,6 +2362,11 @@ Select items to scan from a menu of matching entries
 
 
 
+===== -l|--[no-]line
+Output in a single line with @ symbols. Ignored if --counts is specified.
+
+
+
 ===== --not
 Get tags from items that *don't* match search/tag filters
 
@@ -2295,6 +2429,13 @@ View entries before specified time (e.g. 8am, 12:30pm, 15:00)
 [Default Value] None
 
 
+===== --config_template TEMPLATE_KEY
+
+Output using a template from configuration
+
+[Default Value] today
+
+
 ===== --from TIME_RANGE
 
 Time range to show `doing today --from "12pm to 4pm"`
@@ -2324,6 +2465,13 @@ Sort tags by (name|time)
 [Must Match] (?i-mx:^(?:name|time)$)
 
 
+===== --template TEMPLATE_STRING
+
+Override output format with a template string containing %placeholders
+
+[Default Value] None
+
+
 ===== --[no-]duration
 Show elapsed time on entries without @done tag
 
@@ -2623,6 +2771,13 @@ View entries before specified time (e.g. 8am, 12:30pm, 15:00)
 [Default Value] None
 
 
+===== --config_template TEMPLATE_KEY
+
+Output using a template from configuration
+
+[Default Value] today
+
+
 ===== --from TIME_RANGE
 
 Time range to show, e.g. `doing yesterday --from "1am to 8am"`
@@ -2661,6 +2816,13 @@ Sort tags by (name|time)
 [Must Match] (?i-mx:^(?:name|time)$)
 
 
+===== --template TEMPLATE_STRING
+
+Override output format with a template string containing %placeholders
+
+[Default Value] None
+
+
 ===== --[no-]duration
 Show elapsed time on entries without @done tag
 

data/example_plugin.rb

@@ -123,7 +123,7 @@ module Doing
     ## @return     [String] Rendered output
     ##
     def self.render(wwid, items, variables: {})
-      return if items.nil? || items.empty?
+      return unless items.good?
 
       # the :options key includes the flags passed to the
       # command that called the plugin use `puts
@@ -164,7 +164,7 @@ module Doing
 
       if wwid.config['export_templates'].key?('say')
         cfg_tpl = wwid.config['export_templates']['say']
-        tpl = cfg_tpl unless cfg_tpl.nil? || cfg_tpl.empty?
+        tpl = cfg_tpl if cfg_tpl.good?
       end
       output = tpl.dup
       output.gsub!(/%date/, date)