Diane
A Ruby CL documentation utility for recording and playing back your thoughts/intel/motivations, without bloating the Git logs. ☕️
I have been assigned a secretary. Her name is Diane.
She seems an interesting cross between a saint and a cabaret singer.
Installation
Add this line to your application's Gemfile:
gem 'diane'
And then execute:
$ bundle
Or install it yourself as:
$ gem install diane
Usage
Diane has two subcommands: record
and playback
:
Record
Usage:
diane record MESSAGE
Example:
diane record "I'm in the middle of adding git-lfs. Remind me to return + test."
Options:
-
--user USER
: By default, Diane records the message and attributes it to the git user currently logged in. To override this, use the--user
option:diane record "the owls are not what they seem" --user "the_giant"
Playback
Usage:
diane playback NUMBER
Example:
diane playback 3
Options:
-
--all
: By default, Diane plays back 1 recording or theNUMBER
specified. To override this, use the--all
option to return every recording that matches the query.diane playback --all
-
--user USER
: By default, Diane plays back the recording(s) attributed to the git user currently logged in. To override this, use the--user
option:diane playback 3 --user "bob"
-
--everyone
: If you want to return aNUMBER
of recordings irrespective of user, use the--everyone
option.diane playback --all --everyone
-
--inorder
: By default, diane plays back the most recent recordings first. You can override this and reverse them with the option--inorder
.diane playback 5 --inorder
Note: By default,
diane playback
with no number or options returns the single most recent result by the logged in user.
For more, see Diane's Yardoc.
The gem is available as open source under the terms of the MIT License.