standup_md 0.3.11 → 0.3.12

Sign up to get free protection for your applications and to get access to all the features.
Files changed (64) hide show
  1. checksums.yaml +4 -4
  2. data/.gitignore +1 -0
  3. data/README.md +2 -4
  4. data/Rakefile +1 -1
  5. data/lib/standup_md/version.rb +1 -1
  6. data/standup_md.gemspec +1 -1
  7. metadata +3 -60
  8. data/doc/README_md.html +0 -393
  9. data/doc/StandupMD.html +0 -238
  10. data/doc/StandupMD/Cli.html +0 -406
  11. data/doc/StandupMD/Cli/Helpers.html +0 -146
  12. data/doc/StandupMD/Config.html +0 -193
  13. data/doc/StandupMD/Config/Cli.html +0 -296
  14. data/doc/StandupMD/Config/Entry.html +0 -240
  15. data/doc/StandupMD/Config/EntryList.html +0 -171
  16. data/doc/StandupMD/Config/File.html +0 -481
  17. data/doc/StandupMD/Entry.html +0 -367
  18. data/doc/StandupMD/EntryList.html +0 -499
  19. data/doc/StandupMD/File.html +0 -483
  20. data/doc/StandupMD/Version.html +0 -199
  21. data/doc/created.rid +0 -15
  22. data/doc/css/fonts.css +0 -167
  23. data/doc/css/rdoc.css +0 -619
  24. data/doc/fonts/Lato-Light.ttf +0 -0
  25. data/doc/fonts/Lato-LightItalic.ttf +0 -0
  26. data/doc/fonts/Lato-Regular.ttf +0 -0
  27. data/doc/fonts/Lato-RegularItalic.ttf +0 -0
  28. data/doc/fonts/SourceCodePro-Bold.ttf +0 -0
  29. data/doc/fonts/SourceCodePro-Regular.ttf +0 -0
  30. data/doc/images/add.png +0 -0
  31. data/doc/images/arrow_up.png +0 -0
  32. data/doc/images/brick.png +0 -0
  33. data/doc/images/brick_link.png +0 -0
  34. data/doc/images/bug.png +0 -0
  35. data/doc/images/bullet_black.png +0 -0
  36. data/doc/images/bullet_toggle_minus.png +0 -0
  37. data/doc/images/bullet_toggle_plus.png +0 -0
  38. data/doc/images/date.png +0 -0
  39. data/doc/images/delete.png +0 -0
  40. data/doc/images/find.png +0 -0
  41. data/doc/images/loadingAnimation.gif +0 -0
  42. data/doc/images/macFFBgHack.png +0 -0
  43. data/doc/images/package.png +0 -0
  44. data/doc/images/page_green.png +0 -0
  45. data/doc/images/page_white_text.png +0 -0
  46. data/doc/images/page_white_width.png +0 -0
  47. data/doc/images/plugin.png +0 -0
  48. data/doc/images/ruby.png +0 -0
  49. data/doc/images/tag_blue.png +0 -0
  50. data/doc/images/tag_green.png +0 -0
  51. data/doc/images/transparent.png +0 -0
  52. data/doc/images/wrench.png +0 -0
  53. data/doc/images/wrench_orange.png +0 -0
  54. data/doc/images/zoom.png +0 -0
  55. data/doc/index.html +0 -382
  56. data/doc/js/darkfish.js +0 -84
  57. data/doc/js/navigation.js +0 -105
  58. data/doc/js/navigation.js.gz +0 -0
  59. data/doc/js/search.js +0 -110
  60. data/doc/js/search_index.js +0 -1
  61. data/doc/js/search_index.js.gz +0 -0
  62. data/doc/js/searcher.js +0 -229
  63. data/doc/js/searcher.js.gz +0 -0
  64. data/doc/table_of_contents.html +0 -411
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 9c3ec97ec3643dc8143bf423de49378c144ef0a3c8ec8ac034ff7dfb88d62b25
4
- data.tar.gz: c81c9b4442a3f5261adbca61ce9cc6e4ce7085ce48cca0913c046f47878ef218
3
+ metadata.gz: 198d3fbe4a4f63217f389986638c5ee260104df0479644d19747b36a735526de
4
+ data.tar.gz: 06c89738efe6263153cac8734d6b4b45318002069f9cb4afd80670e73a735ca5
5
5
  SHA512:
6
- metadata.gz: df9b8279091248fe8e70d3c878b7bbf3de74af5e34e36e2ff0d4de5205d68a2538b3e3039e0b8e72baa8b505f1cfc8b99c47f81524d348debe6eabb2c70bc15a
7
- data.tar.gz: b421353e0f9ef32cc1318f59520f0e90377b98f70576bc392be82716f32b087c8cc1dd75fad38e7f70a89352454457c1468a44d1d850492dae0bd5d141e4ce50
6
+ metadata.gz: 9577cad9b7c93e6d19d4dd0ff2b9b72bb6b75422c9824859d4a96241d44aa198921e0541900f3803d12d4a5c33f6160648da63aaf10984972f8e12319f517ba9
7
+ data.tar.gz: 4b69b25cf4ba19e969ba5290d5f8283c1b09e63517bacee83f4ae9ded3e59cec6a2a517673452b56df3bdc9d75001779b9f20f4b5ffebad82ede780cb8944547
data/.gitignore CHANGED
@@ -1,2 +1,3 @@
1
1
  standup_md-*.gem
2
2
  coverage/*
3
+ docs/*
data/README.md CHANGED
@@ -9,9 +9,7 @@
9
9
  A highly customizable and automated way to keep track of daily standups in
10
10
  markdown files.
11
11
 
12
- View on: [Github](https://github.com/evanthegrayt/standup_md) |
13
- [GitHub Pages](https://evanthegrayt.github.io/standup_md/) |
14
- [RubyGems](https://rubygems.org/gems/standup_md)
12
+ You can view the documentation [here](https://evanthegrayt.github.io/standup_md/).
15
13
 
16
14
  ## About
17
15
  I've now been at two separate companies where we post our daily standups in a
@@ -263,7 +261,7 @@ end
263
261
 
264
262
  ## API
265
263
  The API is fully documented in the
266
- [RDoc Documentation](https://evanthegrayt.github.io/standup_md/doc/index.html).
264
+ [RDoc Documentation](https://evanthegrayt.github.io/standup_md/).
267
265
 
268
266
  This was mainly written as a command line utility, but the API is very robust,
269
267
  and is available for use in your own projects. A quick example of how to write a
data/Rakefile CHANGED
@@ -14,7 +14,7 @@ end
14
14
 
15
15
  RDoc::Task.new do |rdoc|
16
16
  rdoc.main = 'README.md'
17
- rdoc.rdoc_dir = 'doc'
17
+ rdoc.rdoc_dir = 'docs'
18
18
  rdoc.rdoc_files.include('README.md', 'lib/**/*.rb')
19
19
  end
20
20
 
@@ -21,7 +21,7 @@ module StandupMD
21
21
  # Patch version.
22
22
  #
23
23
  # @return [Integer]
24
- PATCH = 11
24
+ PATCH = 12
25
25
 
26
26
  ##
27
27
  # Version as +[MAJOR, MINOR, PATCH]+
data/standup_md.gemspec CHANGED
@@ -22,7 +22,7 @@ Gem::Specification.new do |spec|
22
22
  spec.metadata['source_code_uri'] =
23
23
  'https://github.com/evanthegrayt/standup_md'
24
24
  spec.metadata['documentation_uri'] =
25
- 'https://evanthegrayt.github.io/standup_md/doc/index.html'
25
+ 'https://evanthegrayt.github.io/standup_md/'
26
26
 
27
27
  spec.files = `git ls-files -z`.split("\x0").reject do |f|
28
28
  f.match(%r{^(test|spec|features)/})
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: standup_md
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.3.11
4
+ version: 0.3.12
5
5
  platform: ruby
6
6
  authors:
7
7
  - Evan Gray
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2021-05-18 00:00:00.000000000 Z
11
+ date: 2021-05-22 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: rake
@@ -80,63 +80,6 @@ files:
80
80
  - Rakefile
81
81
  - _config.yml
82
82
  - bin/standup
83
- - doc/README_md.html
84
- - doc/StandupMD.html
85
- - doc/StandupMD/Cli.html
86
- - doc/StandupMD/Cli/Helpers.html
87
- - doc/StandupMD/Config.html
88
- - doc/StandupMD/Config/Cli.html
89
- - doc/StandupMD/Config/Entry.html
90
- - doc/StandupMD/Config/EntryList.html
91
- - doc/StandupMD/Config/File.html
92
- - doc/StandupMD/Entry.html
93
- - doc/StandupMD/EntryList.html
94
- - doc/StandupMD/File.html
95
- - doc/StandupMD/Version.html
96
- - doc/created.rid
97
- - doc/css/fonts.css
98
- - doc/css/rdoc.css
99
- - doc/fonts/Lato-Light.ttf
100
- - doc/fonts/Lato-LightItalic.ttf
101
- - doc/fonts/Lato-Regular.ttf
102
- - doc/fonts/Lato-RegularItalic.ttf
103
- - doc/fonts/SourceCodePro-Bold.ttf
104
- - doc/fonts/SourceCodePro-Regular.ttf
105
- - doc/images/add.png
106
- - doc/images/arrow_up.png
107
- - doc/images/brick.png
108
- - doc/images/brick_link.png
109
- - doc/images/bug.png
110
- - doc/images/bullet_black.png
111
- - doc/images/bullet_toggle_minus.png
112
- - doc/images/bullet_toggle_plus.png
113
- - doc/images/date.png
114
- - doc/images/delete.png
115
- - doc/images/find.png
116
- - doc/images/loadingAnimation.gif
117
- - doc/images/macFFBgHack.png
118
- - doc/images/package.png
119
- - doc/images/page_green.png
120
- - doc/images/page_white_text.png
121
- - doc/images/page_white_width.png
122
- - doc/images/plugin.png
123
- - doc/images/ruby.png
124
- - doc/images/tag_blue.png
125
- - doc/images/tag_green.png
126
- - doc/images/transparent.png
127
- - doc/images/wrench.png
128
- - doc/images/wrench_orange.png
129
- - doc/images/zoom.png
130
- - doc/index.html
131
- - doc/js/darkfish.js
132
- - doc/js/navigation.js
133
- - doc/js/navigation.js.gz
134
- - doc/js/search.js
135
- - doc/js/search_index.js
136
- - doc/js/search_index.js.gz
137
- - doc/js/searcher.js
138
- - doc/js/searcher.js.gz
139
- - doc/table_of_contents.html
140
83
  - lib/standup_md.rb
141
84
  - lib/standup_md/cli.rb
142
85
  - lib/standup_md/cli/helpers.rb
@@ -158,7 +101,7 @@ metadata:
158
101
  allowed_push_host: https://rubygems.org
159
102
  homepage_uri: https://evanthegrayt.github.io/standup_md/
160
103
  source_code_uri: https://github.com/evanthegrayt/standup_md
161
- documentation_uri: https://evanthegrayt.github.io/standup_md/doc/index.html
104
+ documentation_uri: https://evanthegrayt.github.io/standup_md/
162
105
  post_install_message:
163
106
  rdoc_options: []
164
107
  require_paths:
data/doc/README_md.html DELETED
@@ -1,393 +0,0 @@
1
- <!DOCTYPE html>
2
-
3
- <html>
4
- <head>
5
- <meta charset="UTF-8">
6
-
7
- <title>README - RDoc Documentation</title>
8
-
9
- <script type="text/javascript">
10
- var rdoc_rel_prefix = "./";
11
- var index_rel_prefix = "./";
12
- </script>
13
-
14
- <script src="./js/navigation.js" defer></script>
15
- <script src="./js/search.js" defer></script>
16
- <script src="./js/search_index.js" defer></script>
17
- <script src="./js/searcher.js" defer></script>
18
- <script src="./js/darkfish.js" defer></script>
19
-
20
- <link href="./css/fonts.css" rel="stylesheet">
21
- <link href="./css/rdoc.css" rel="stylesheet">
22
-
23
-
24
- <body id="top" role="document" class="file">
25
- <nav role="navigation">
26
- <div id="project-navigation">
27
- <div id="home-section" role="region" title="Quick navigation" class="nav-section">
28
- <h2>
29
- <a href="./index.html" rel="home">Home</a>
30
- </h2>
31
-
32
- <div id="table-of-contents-navigation">
33
- <a href="./table_of_contents.html#pages">Pages</a>
34
- <a href="./table_of_contents.html#classes">Classes</a>
35
- <a href="./table_of_contents.html#methods">Methods</a>
36
- </div>
37
- </div>
38
-
39
- <div id="search-section" role="search" class="project-section initially-hidden">
40
- <form action="#" method="get" accept-charset="utf-8">
41
- <div id="search-field-wrapper">
42
- <input id="search-field" role="combobox" aria-label="Search"
43
- aria-autocomplete="list" aria-controls="search-results"
44
- type="text" name="search" placeholder="Search" spellcheck="false"
45
- title="Type to search, Up and Down to navigate, Enter to load">
46
- </div>
47
-
48
- <ul id="search-results" aria-label="Search Results"
49
- aria-busy="false" aria-expanded="false"
50
- aria-atomic="false" class="initially-hidden"></ul>
51
- </form>
52
- </div>
53
-
54
- </div>
55
-
56
-
57
- <div class="nav-section">
58
- <h3>Table of Contents</h3>
59
-
60
- <ul class="link-list" role="directory">
61
- <li><a href="#label-The+Standup+Doctor">The Standup Doctor</a>
62
- <li><a href="#label-About">About</a>
63
- <li><a href="#label-Installation">Installation</a>
64
- <li><a href="#label-Via+RubyGems">Via RubyGems</a>
65
- <li><a href="#label-Manual+Installation">Manual Installation</a>
66
- <li><a href="#label-Usage">Usage</a>
67
- <li><a href="#label-Command+Line">Command Line</a>
68
- <li><a href="#label-CLI+Examples">CLI Examples</a>
69
- <li><a href="#label-Adding+an+entry+for+today+via+editor">Adding an entry for today via editor</a>
70
- <li><a href="#label-Copy+the+entry+for+today+to+clipboard">Copy the entry for today to clipboard</a>
71
- <li><a href="#label-Add+entry+to+file+without+opening+it">Add entry to file without opening it</a>
72
- <li><a href="#label-Customization+and+Runtime+Options">Customization and Runtime Options</a>
73
- <li><a href="#label-Available+Config+File+Options+and+Defaults">Available Config File Options and Defaults</a>
74
- <li><a href="#label-Executable+Flags">Executable Flags</a>
75
- <li><a href="#label-Using+Existing+Standup+Files">Using Existing Standup Files</a>
76
- <li><a href="#label-API">API</a>
77
- <li><a href="#label-API+Examples">API Examples</a>
78
- <li><a href="#label-Adding+an+entry+for+today">Adding an entry for today</a>
79
- <li><a href="#label-Finding+a+past+entry">Finding a past entry</a>
80
- <li><a href="#label-Vim">Vim</a>
81
- <li><a href="#label-Reporting+Bugs+and+Requesting+Features">Reporting Bugs and Requesting Features</a>
82
- <li><a href="#label-Self-Promotion">Self-Promotion</a>
83
- </ul>
84
- </div>
85
-
86
-
87
- <div id="project-metadata">
88
-
89
- <div id="fileindex-section" class="nav-section">
90
- <h3>Pages</h3>
91
-
92
- <ul class="link-list">
93
- <li><a href="./README_md.html">README</a>
94
- </ul>
95
- </div>
96
-
97
- </div>
98
- </nav>
99
-
100
- <main role="main" aria-label="Page README.md">
101
-
102
- <h1 id="label-The+Standup+Doctor">The Standup Doctor<span><a href="#label-The+Standup+Doctor">&para;</a> <a href="#top">&uarr;</a></span></h1>
103
- <!-- vi: set ts=4 sw=4 : -->
104
- <p><a href="https://actions-badge.atrox.dev/evanthegrayt/standup_md/goto?ref=master"><img src="https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Fevanthegrayt%2Fstandup_md%2Fbadge%3Fref%3Dmaster&style=flat"></a> <a href="https://badge.fury.io/rb/standup_md"><img src="https://badge.fury.io/rb/standup_md.svg"></a> <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg"></a></p>
105
-
106
- <blockquote>
107
- <p>The cure for all your standup woes.</p>
108
- </blockquote>
109
-
110
- <p>A highly customizable and automated way to keep track of daily standups in markdown files.</p>
111
-
112
- <p>View on: <a href="https://github.com/evanthegrayt/standup_md">Github</a> | <a href="https://evanthegrayt.github.io/standup_md/">GitHub Pages</a> | <a href="https://rubygems.org/gems/standup_md">RubyGems</a></p>
113
-
114
- <h2 id="label-About">About<span><a href="#label-About">&para;</a> <a href="#top">&uarr;</a></span></h2>
115
-
116
- <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>
117
-
118
- <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="#cli-examples">example</a>. There&#39;s also a very robust API if you&#39;d like to use this in your own code somehow.</p>
119
-
120
- <h2 id="label-Installation">Installation<span><a href="#label-Installation">&para;</a> <a href="#top">&uarr;</a></span></h2>
121
-
122
- <p>If you don&#39;t have the permissions to install system-wide gems, you&#39;re probabaly also running an older version of ruby. I recommend installing <a href="https://github.com/rbenv/rbenv#installation">rbenv</a>, and then installing an up-to-date version of ruby.</p>
123
-
124
- <h3 id="label-Via+RubyGems">Via RubyGems<span><a href="#label-Via+RubyGems">&para;</a> <a href="#top">&uarr;</a></span></h3>
125
-
126
- <p>Just install the gem!</p>
127
-
128
- <pre class="ruby"><span class="ruby-identifier">gem</span> <span class="ruby-identifier">install</span> <span class="ruby-identifier">standup_md</span>
129
- </pre>
130
-
131
- <p>To include in your project, add the following to your <code>Gemfile</code>.</p>
132
-
133
- <pre class="ruby"><span class="ruby-identifier">gem</span> <span class="ruby-string">&#39;standup_md&#39;</span>
134
- </pre>
135
-
136
- <h3 id="label-Manual+Installation">Manual Installation<span><a href="#label-Manual+Installation">&para;</a> <a href="#top">&uarr;</a></span></h3>
137
-
138
- <p>From your terminal, clone the repository where you want it, and use <code>rake</code> to install the gem.</p>
139
-
140
- <pre>git clone https://github.com/evanthegrayt/standup_md.git
141
- cd standup_md
142
-
143
- # Use rake to build and install the gem.
144
- rake install</pre>
145
-
146
- <h2 id="label-Usage">Usage<span><a href="#label-Usage">&para;</a> <a href="#top">&uarr;</a></span></h2>
147
-
148
- <h3 id="label-Command+Line">Command Line<span><a href="#label-Command+Line">&para;</a> <a href="#top">&uarr;</a></span></h3>
149
-
150
- <p>For the most basic usage, simply call the executable.</p>
151
-
152
- <pre class="ruby"><span class="ruby-identifier">standup</span>
153
- </pre>
154
-
155
- <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>
156
-
157
- <h3 id="label-CLI+Examples">CLI Examples<span><a href="#label-CLI+Examples">&para;</a> <a href="#top">&uarr;</a></span></h3>
158
-
159
- <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>
160
-
161
- <p>For example, if the standup entry from yesterday reads as follows:</p>
162
-
163
- <pre># 2020-04-13
164
- ## Previous
165
- - Did something else.
166
- ## Current
167
- - Write new feature for `standup_md`
168
- - Fix bug in `standup_md`
169
- ## Impediments
170
- - None</pre>
171
-
172
- <p>The following scaffolding will be added for current entry at the top of the file:</p>
173
-
174
- <pre># 2020-04-14
175
- ## Previous
176
- - Write new feature for `standup_md`
177
- - Fix bug in `standup_md`
178
- ## Current
179
- - &lt;!-- ADD TODAY&#39;S WORK HERE --&gt;
180
- ## Impediments
181
- - None</pre>
182
-
183
- <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>
184
-
185
- <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>
186
-
187
- <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>
188
- </pre>
189
-
190
- <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>
191
-
192
- <p>You can add an entry for today without even opening your editor. Note that, if you have multiple entries, you must separate them with a comma and <em>no spaces</em>.</p>
193
-
194
- <pre>standup --no-edit --current &quot;Work on this thing&quot;,&quot;And another thing&quot;</pre>
195
-
196
- <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>
197
-
198
- <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>
199
-
200
- <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>
201
-
202
- <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>
203
-
204
- <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>
205
-
206
- <p>For command-line usage, this file needs to be named <code>~/.standuprc</code>. To use in a rails project, create an initializer (<code>config/initializers/standup_md.rb</code>).</p>
207
-
208
- <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>
209
- <span class="ruby-comment"># Defaults for how the file is formatted.</span>
210
- <span class="ruby-comment"># See https://evanthegrayt.github.io/standup_md/doc/StandupMD/Config/Cli.html</span>
211
- <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>
212
- <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>
213
- <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>
214
- <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>
215
- <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>
216
- <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>
217
- <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>
218
- <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>
219
- <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>)
220
- <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>
221
- <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>
222
- <span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">create</span> = <span class="ruby-keyword">true</span>
223
-
224
- <span class="ruby-comment"># Defaults for entries</span>
225
- <span class="ruby-comment"># See https://evanthegrayt.github.io/standup_md/doc/StandupMD/Config/Entry.html</span>
226
- <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>]
227
- <span class="ruby-identifier">c</span>.<span class="ruby-identifier">entry</span>.<span class="ruby-identifier">previous</span> = []
228
- <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>]
229
- <span class="ruby-identifier">c</span>.<span class="ruby-identifier">entry</span>.<span class="ruby-identifier">notes</span> = []
230
-
231
- <span class="ruby-comment"># Defaults for executable runtime behavior.</span>
232
- <span class="ruby-comment"># See https://evanthegrayt.github.io/standup_md/doc/StandupMD/Config/Cli.html</span>
233
- <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>
234
- <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>
235
- <span class="ruby-identifier">c</span>.<span class="ruby-identifier">cli</span>.<span class="ruby-identifier">verbose</span> = <span class="ruby-keyword">false</span>
236
- <span class="ruby-identifier">c</span>.<span class="ruby-identifier">cli</span>.<span class="ruby-identifier">edit</span> = <span class="ruby-keyword">true</span>
237
- <span class="ruby-identifier">c</span>.<span class="ruby-identifier">cli</span>.<span class="ruby-identifier">write</span> = <span class="ruby-keyword">true</span>
238
- <span class="ruby-identifier">c</span>.<span class="ruby-identifier">cli</span>.<span class="ruby-identifier">print</span> = <span class="ruby-keyword">false</span>
239
- <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>
240
- <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>))
241
- <span class="ruby-keyword">end</span>
242
- </pre>
243
-
244
- <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>
245
-
246
- <h4 id="label-Executable+Flags">Executable Flags<span><a href="#label-Executable+Flags">&para;</a> <a href="#top">&uarr;</a></span></h4>
247
-
248
- <p>Some of these options can be changed at runtime. They are as follows.</p>
249
-
250
- <pre>--current ARRAY List of current entry&#39;s tasks
251
- --previous ARRAY List of precious entry&#39;s tasks
252
- --impediments ARRAY List of impediments for current entry
253
- --notes ARRAY List of notes for current entry
254
- --sub-header-order ARRAY The order of the sub-headers when writing the file
255
- -f, --file-name-format STRING Date-formattable string to use for standup file name
256
- -E, --editor EDITOR Editor to use for opening standup files
257
- -d, --directory DIRECTORY The directories where standup files are located
258
- -w --[no-]write Write current entry if it doesn&#39;t exist. Default is true
259
- -a --[no-]auto-fill-previous Auto-generate &#39;previous&#39; tasks for new entries
260
- -e --[no-]edit Open the file in the editor. Default is true
261
- -v, --[no-]verbose Verbose output. Default is false.
262
- -p, --print [DATE] Print current entry.
263
- If DATE is passed, will print entry for DATE, if it exists.
264
- DATE must be in the same format as file-name-format</pre>
265
-
266
- <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>
267
-
268
- <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>
269
-
270
- <pre># 2020-05-01
271
- ## Previous
272
- - task
273
- ## Current
274
- - task
275
- ## Impediments
276
- - impediment
277
- ## Notes
278
- - notes, if any are present</pre>
279
-
280
- <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>
281
-
282
- <p>For example, if you wanted the format to be as follows:</p>
283
-
284
- <pre>## 05/01/2020
285
- ### Today
286
- * task
287
- ### Yesterday
288
- * task
289
- ### Hold-ups
290
- * impediment
291
- ### Notes
292
- * notes, if any are present</pre>
293
-
294
- <p>Your <code>~/.standuprc</code> should contain:</p>
295
-
296
- <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>
297
- <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>
298
- <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>
299
- <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>
300
- <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>
301
- <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>
302
- <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>
303
- <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>
304
- <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>
305
- <span class="ruby-keyword">end</span>
306
- </pre>
307
-
308
- <h2 id="label-API">API<span><a href="#label-API">&para;</a> <a href="#top">&uarr;</a></span></h2>
309
-
310
- <p>The API is fully documented in the <a href="https://evanthegrayt.github.io/standup_md/doc/index.html">RDoc Documentation</a>.</p>
311
-
312
- <p>This was mainly written as a command line utility, but the API is very 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>
313
-
314
- <h3 id="label-API+Examples">API Examples<span><a href="#label-API+Examples">&para;</a> <a href="#top">&uarr;</a></span></h3>
315
-
316
- <h4 id="label-Adding+an+entry+for+today">Adding an entry for today<span><a href="#label-Adding+an+entry+for+today">&para;</a> <a href="#top">&uarr;</a></span></h4>
317
-
318
- <pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">&#39;standup_md&#39;</span>
319
-
320
- <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>
321
- <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>,
322
- <span class="ruby-keyword">end</span>
323
-
324
- <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>)
325
- <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>] }
326
- <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>
327
- <span class="ruby-identifier">file</span>.<span class="ruby-identifier">write</span>
328
- </pre>
329
-
330
- <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>
331
-
332
- <pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">&#39;standup_md&#39;</span>
333
-
334
- <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>
335
- <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>,
336
- <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>]
337
- <span class="ruby-keyword">end</span>
338
-
339
- <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>
340
- </pre>
341
-
342
- <h4 id="label-Finding+a+past+entry">Finding a past entry<span><a href="#label-Finding+a+past+entry">&para;</a> <a href="#top">&uarr;</a></span></h4>
343
-
344
- <pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">&#39;standup_md&#39;</span>
345
-
346
- <span class="ruby-identifier">date</span> = <span class="ruby-constant">Date</span>.<span class="ruby-identifier">new</span>(<span class="ruby-value">2020</span>, <span class="ruby-value">04</span>, <span class="ruby-value">15</span>)
347
- <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-identifier">date</span>).<span class="ruby-identifier">load</span>
348
- <span class="ruby-identifier">entry</span> = <span class="ruby-identifier">file</span>.<span class="ruby-identifier">entries</span>.<span class="ruby-identifier">find</span>(<span class="ruby-identifier">date</span>)
349
- </pre>
350
-
351
- <h2 id="label-Vim">Vim<span><a href="#label-Vim">&para;</a> <a href="#top">&uarr;</a></span></h2>
352
-
353
- <p>While there&#39;s no official support for vim, you can add this to your <code>vimrc</code> file, or something like <code>~/.vim/plugin/standup.vim</code>.</p>
354
-
355
- <pre>command! -complete=custom,&lt;SID&gt;StandupCompletion -nargs=? -bang Standup
356
- \ call &lt;SID&gt;OpenStandupFile(&lt;bang&gt;0, &lt;f-args&gt;)
357
-
358
- function! s:StandupCompletion(...) abort
359
- let l:dir = get(g:, &#39;standup_dir&#39;, $HOME . &#39;/.cache/standup_md&#39;) . &#39;/&#39;
360
- if !isdirectory(l:dir) | return &#39;&#39; | endif
361
- return join(map(glob(l:dir . &#39;*.md&#39;, 0, 1), &quot;fnamemodify(v:val, &#39;:t&#39;)&quot;), &quot;\n&quot;)
362
- endfunction
363
-
364
- function! s:OpenStandupFile(split, ...)
365
- let l:dir = get(g:, &#39;standup_dir&#39;, $HOME . &#39;/.cache/standup_md&#39;) . &#39;/&#39;
366
- let l:file = a:0 ? a:1 : get(g:, &#39;standup_file&#39;, strftime(&#39;%Y_%m.md&#39;))
367
- call system(&#39;standup --no-edit&#39;)
368
- execute a:split ? &#39;vsplit&#39; : &#39;split&#39; l:dir . l:file
369
- endfunction</pre>
370
-
371
- <p>This makes the <code>:Standup</code> command, which opens the standup file in a split, while <code>:Standup!</code> opens it in a vertical split. If a file is passed to the command, that file will be opened. There&#39;s tab completion for this. Lastly, it allows for a few variables to be set for customization.</p>
372
-
373
- <pre>g:standup_dir = $HOME . &#39;/.cache/standup_md&#39; &quot; the directory where your file are
374
- g:standup_file = strftime(&#39;%Y_%m.md&#39;) &quot; the file format to use</pre>
375
-
376
- <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>
377
-
378
- <p>If you have an idea or find a bug, please <a href="https://github.com/evanthegrayt/standup_md/issues/new">create an issue</a>. Just make sure the topic doesn&#39;t already exist. Better yet, you can always submit a Pull Request.</p>
379
-
380
- <h2 id="label-Self-Promotion">Self-Promotion<span><a href="#label-Self-Promotion">&para;</a> <a href="#top">&uarr;</a></span></h2>
381
-
382
- <p>I do these projects for fun, and I enjoy knowing that they&#39;re helpful to people. Consider starring <a href="https://github.com/evanthegrayt/standup_md">the repository</a> if you like it! If you love it, follow me <a href="https://github.com/evanthegrayt">on Github</a>!</p>
383
-
384
- </main>
385
-
386
-
387
-
388
- <footer id="validator-badges" role="contentinfo">
389
- <p><a href="https://validator.w3.org/check/referer">Validate</a>
390
- <p>Generated by <a href="https://ruby.github.io/rdoc/">RDoc</a> 6.3.0.
391
- <p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
392
- </footer>
393
-