standup_md 0.3.0 → 0.3.5
- checksums.yaml +4 -4
- data/Gemfile.lock +2 -2
- data/README.md +37 -19
- data/doc/README_md.html +35 -30
- data/doc/StandupMD.html +3 -7
- data/doc/StandupMD/Cli/Helpers.html +4 -4
- data/doc/StandupMD/Config.html +1 -1
- data/doc/StandupMD/Config/Cli.html +29 -20
- data/doc/StandupMD/Config/Entry.html +26 -14
- data/doc/StandupMD/Config/EntryList.html +26 -11
- data/doc/StandupMD/Config/File.html +30 -26
- data/doc/StandupMD/Entry.html +7 -7
- data/doc/StandupMD/EntryList.html +116 -194
- data/doc/StandupMD/File.html +51 -11
- data/doc/created.rid +15 -15
- data/doc/index.html +33 -30
- data/doc/js/search_index.js +1 -1
- data/doc/js/search_index.js.gz +0 -0
- data/doc/table_of_contents.html +41 -44
- data/lib/standup_md.rb +2 -2
- data/lib/standup_md/cli/helpers.rb +29 -5
- data/lib/standup_md/config.rb +2 -0
- data/lib/standup_md/config/cli.rb +25 -22
- data/lib/standup_md/config/entry.rb +15 -8
- data/lib/standup_md/config/entry_list.rb +10 -5
- data/lib/standup_md/config/file.rb +26 -16
- data/lib/standup_md/entry.rb +2 -1
- data/lib/standup_md/entry_list.rb +23 -40
- data/lib/standup_md/file.rb +14 -3
- data/lib/standup_md/version.rb +2 -4
- metadata +2 -2
@@ -81,6 +81,8 @@
|
|
81
81
|
|
82
82
|
<li ><a href="#method-c-find_by_date">::find_by_date</a>
|
83
83
|
|
84
|
+
<li ><a href="#method-c-load">::load</a>
|
85
|
+
|
84
86
|
<li ><a href="#method-c-new">::new</a>
|
85
87
|
|
86
88
|
<li ><a href="#method-i-exist-3F">#exist?</a>
|
@@ -221,7 +223,7 @@
|
|
221
223
|
|
222
224
|
|
223
225
|
<div class="method-source-code" id="find-source">
|
224
|
-
<pre><span class="ruby-comment"># File lib/standup_md/file.rb, line
|
226
|
+
<pre><span class="ruby-comment"># File lib/standup_md/file.rb, line 36</span>
|
225
227
|
<span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier ruby-title">find</span>(<span class="ruby-identifier">file_name</span>)
|
226
228
|
<span class="ruby-identifier">file</span> = <span class="ruby-constant">Dir</span>.<span class="ruby-identifier">entries</span>(<span class="ruby-identifier">config</span>.<span class="ruby-identifier">directory</span>).<span class="ruby-identifier">bsearch</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span> <span class="ruby-identifier">f</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">file_name</span> }
|
227
229
|
<span class="ruby-keyword">if</span> <span class="ruby-identifier">file</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-operator">&&</span> <span class="ruby-operator">!</span><span class="ruby-identifier">config</span>.<span class="ruby-identifier">create</span>
|
@@ -260,7 +262,7 @@
|
|
260
262
|
|
261
263
|
|
262
264
|
<div class="method-source-code" id="find_by_date-source">
|
263
|
-
<pre><span class="ruby-comment"># File lib/standup_md/file.rb, line
|
265
|
+
<pre><span class="ruby-comment"># File lib/standup_md/file.rb, line 48</span>
|
264
266
|
<span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier ruby-title">find_by_date</span>(<span class="ruby-identifier">date</span>)
|
265
267
|
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">date</span>.<span class="ruby-identifier">is_a?</span>(<span class="ruby-constant">Date</span>)
|
266
268
|
<span class="ruby-identifier">raise</span> <span class="ruby-constant">ArgumentError</span>, <span class="ruby-string">"Argument must be a Date object"</span>
|
@@ -274,6 +276,43 @@
|
|
274
276
|
|
275
277
|
|
276
278
|
|
279
|
+
</div>
|
280
|
+
|
281
|
+
|
282
|
+
<div id="method-c-load" class="method-detail ">
|
283
|
+
|
284
|
+
<div class="method-heading">
|
285
|
+
<span class="method-name">load</span><span
|
286
|
+
class="method-args">(file_name)</span>
|
287
|
+
|
288
|
+
<span class="method-click-advice">click to toggle source</span>
|
289
|
+
|
290
|
+
</div>
|
291
|
+
|
292
|
+
|
293
|
+
<div class="method-description">
|
294
|
+
|
295
|
+
<p>Convenience method for calling <a href="File.html#method-c-find"><code>File.find(file_name)</code></a>.load</p>
|
296
|
+
|
297
|
+
<p>@param [String] file_name</p>
|
298
|
+
|
299
|
+
<p>@return [StandupMD::File]</p>
|
300
|
+
|
301
|
+
|
302
|
+
|
303
|
+
|
304
|
+
<div class="method-source-code" id="load-source">
|
305
|
+
<pre><span class="ruby-comment"># File lib/standup_md/file.rb, line 28</span>
|
306
|
+
<span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier ruby-title">load</span>(<span class="ruby-identifier">file_name</span>)
|
307
|
+
<span class="ruby-identifier">new</span>(<span class="ruby-identifier">file_name</span>).<span class="ruby-identifier">load</span>
|
308
|
+
<span class="ruby-keyword">end</span></pre>
|
309
|
+
</div>
|
310
|
+
|
311
|
+
</div>
|
312
|
+
|
313
|
+
|
314
|
+
|
315
|
+
|
277
316
|
</div>
|
278
317
|
|
279
318
|
|
@@ -300,7 +339,7 @@
|
|
300
339
|
|
301
340
|
|
302
341
|
<div class="method-source-code" id="new-source">
|
303
|
-
<pre><span class="ruby-comment"># File lib/standup_md/file.rb, line
|
342
|
+
<pre><span class="ruby-comment"># File lib/standup_md/file.rb, line 73</span>
|
304
343
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">initialize</span>(<span class="ruby-identifier">file_name</span>)
|
305
344
|
<span class="ruby-ivar">@config</span> = <span class="ruby-keyword">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">config</span>
|
306
345
|
<span class="ruby-keyword">if</span> <span class="ruby-identifier">file_name</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-operator">::</span><span class="ruby-constant">File</span><span class="ruby-operator">::</span><span class="ruby-constant">SEPARATOR</span>)
|
@@ -362,7 +401,7 @@
|
|
362
401
|
|
363
402
|
|
364
403
|
<div class="method-source-code" id="exist-3F-source">
|
365
|
-
<pre><span class="ruby-comment"># File lib/standup_md/file.rb, line
|
404
|
+
<pre><span class="ruby-comment"># File lib/standup_md/file.rb, line 116</span>
|
366
405
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">exist?</span>
|
367
406
|
<span class="ruby-operator">::</span><span class="ruby-constant">File</span>.<span class="ruby-identifier">exist?</span>(<span class="ruby-identifier">name</span>)
|
368
407
|
<span class="ruby-keyword">end</span></pre>
|
@@ -397,7 +436,7 @@
|
|
397
436
|
|
398
437
|
|
399
438
|
<div class="method-source-code" id="load-source">
|
400
|
-
<pre><span class="ruby-comment"># File lib/standup_md/file.rb, line
|
439
|
+
<pre><span class="ruby-comment"># File lib/standup_md/file.rb, line 125</span>
|
401
440
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">load</span>
|
402
441
|
<span class="ruby-identifier">raise</span> <span class="ruby-node">"File #{name} does not exist."</span> <span class="ruby-keyword">unless</span> <span class="ruby-operator">::</span><span class="ruby-constant">File</span>.<span class="ruby-identifier">file?</span>(<span class="ruby-identifier">name</span>)
|
403
442
|
<span class="ruby-identifier">entry_list</span> = <span class="ruby-constant">EntryList</span>.<span class="ruby-identifier">new</span>
|
@@ -424,6 +463,7 @@
|
|
424
463
|
<span class="ruby-identifier">entry_list</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">new_entry</span>(<span class="ruby-identifier">record</span>) <span class="ruby-keyword">unless</span> <span class="ruby-identifier">record</span>.<span class="ruby-identifier">empty?</span>
|
425
464
|
<span class="ruby-ivar">@loaded</span> = <span class="ruby-keyword">true</span>
|
426
465
|
<span class="ruby-ivar">@entries</span> = <span class="ruby-identifier">entry_list</span>.<span class="ruby-identifier">sort</span>
|
466
|
+
<span class="ruby-keyword">self</span>
|
427
467
|
<span class="ruby-keyword">rescue</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">e</span>
|
428
468
|
<span class="ruby-identifier">raise</span> <span class="ruby-node">"File malformation: #{e}"</span>
|
429
469
|
<span class="ruby-keyword">end</span></pre>
|
@@ -458,7 +498,7 @@
|
|
458
498
|
|
459
499
|
|
460
500
|
<div class="method-source-code" id="loaded-3F-source">
|
461
|
-
<pre><span class="ruby-comment"># File lib/standup_md/file.rb, line
|
501
|
+
<pre><span class="ruby-comment"># File lib/standup_md/file.rb, line 108</span>
|
462
502
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">loaded?</span>
|
463
503
|
<span class="ruby-ivar">@loaded</span>
|
464
504
|
<span class="ruby-keyword">end</span></pre>
|
@@ -493,7 +533,7 @@
|
|
493
533
|
|
494
534
|
|
495
535
|
<div class="method-source-code" id="new-3F-source">
|
496
|
-
<pre><span class="ruby-comment"># File lib/standup_md/file.rb, line
|
536
|
+
<pre><span class="ruby-comment"># File lib/standup_md/file.rb, line 100</span>
|
497
537
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">new?</span>
|
498
538
|
<span class="ruby-ivar">@new</span>
|
499
539
|
<span class="ruby-keyword">end</span></pre>
|
@@ -522,7 +562,7 @@
|
|
522
562
|
|
523
563
|
<p>Writes a new entry to the file if the first entry in the file isn't today. This method is destructive; if a file for entries in the date range already exists, it will be clobbered with the entries in the range.</p>
|
524
564
|
|
525
|
-
<p>@param [Hash]
|
565
|
+
<p>@param [Hash] {start_date: Date, end_date: Date}</p>
|
526
566
|
|
527
567
|
<p>@return [Boolean] true if successful</p>
|
528
568
|
|
@@ -530,7 +570,7 @@
|
|
530
570
|
|
531
571
|
|
532
572
|
<div class="method-source-code" id="write-source">
|
533
|
-
<pre><span class="ruby-comment"># File lib/standup_md/file.rb, line
|
573
|
+
<pre><span class="ruby-comment"># File lib/standup_md/file.rb, line 164</span>
|
534
574
|
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">write</span>(<span class="ruby-identifier">dates</span> = {})
|
535
575
|
<span class="ruby-identifier">sorted_entries</span> = <span class="ruby-identifier">entries</span>.<span class="ruby-identifier">sort</span>
|
536
576
|
<span class="ruby-identifier">start_date</span> = <span class="ruby-identifier">dates</span>.<span class="ruby-identifier">fetch</span>(<span class="ruby-value">:start_date</span>, <span class="ruby-identifier">sorted_entries</span>.<span class="ruby-identifier">first</span>.<span class="ruby-identifier">date</span>)
|
@@ -539,9 +579,9 @@
|
|
539
579
|
<span class="ruby-identifier">sorted_entries</span>.<span class="ruby-identifier">filter</span>(<span class="ruby-identifier">start_date</span>, <span class="ruby-identifier">end_date</span>).<span class="ruby-identifier">sort_reverse</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">entry</span><span class="ruby-operator">|</span>
|
540
580
|
<span class="ruby-identifier">f</span>.<span class="ruby-identifier">puts</span> <span class="ruby-identifier">header</span>(<span class="ruby-identifier">entry</span>.<span class="ruby-identifier">date</span>)
|
541
581
|
<span class="ruby-ivar">@config</span>.<span class="ruby-identifier">sub_header_order</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">attr</span><span class="ruby-operator">|</span>
|
542
|
-
<span class="ruby-identifier">tasks</span> = <span class="ruby-identifier">entry</span>.<span class="ruby-identifier">
|
582
|
+
<span class="ruby-identifier">tasks</span> = <span class="ruby-identifier">entry</span>.<span class="ruby-identifier">public_send</span>(<span class="ruby-identifier">attr</span>)
|
543
583
|
<span class="ruby-keyword">next</span> <span class="ruby-keyword">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">tasks</span> <span class="ruby-operator">||</span> <span class="ruby-identifier">tasks</span>.<span class="ruby-identifier">empty?</span>
|
544
|
-
<span class="ruby-identifier">f</span>.<span class="ruby-identifier">puts</span> <span class="ruby-identifier">sub_header</span>(<span class="ruby-ivar">@config</span>.<span class="ruby-identifier">
|
584
|
+
<span class="ruby-identifier">f</span>.<span class="ruby-identifier">puts</span> <span class="ruby-identifier">sub_header</span>(<span class="ruby-ivar">@config</span>.<span class="ruby-identifier">public_send</span>(<span class="ruby-node">"#{attr}_header"</span>).<span class="ruby-identifier">capitalize</span>)
|
545
585
|
<span class="ruby-identifier">tasks</span>.<span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">task</span><span class="ruby-operator">|</span> <span class="ruby-identifier">f</span>.<span class="ruby-identifier">puts</span> <span class="ruby-ivar">@config</span>.<span class="ruby-identifier">bullet_character</span> <span class="ruby-operator">+</span> <span class="ruby-string">' '</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">task</span> }
|
546
586
|
<span class="ruby-keyword">end</span>
|
547
587
|
<span class="ruby-identifier">f</span>.<span class="ruby-identifier">puts</span>
|
@@ -1,15 +1,15 @@
|
|
1
|
-
|
2
|
-
README.md Wed,
|
3
|
-
lib/standup_md.rb Wed,
|
4
|
-
lib/standup_md/cli.rb
|
5
|
-
lib/standup_md/cli/helpers.rb
|
6
|
-
lib/standup_md/config.rb Wed,
|
7
|
-
lib/standup_md/config/cli.rb Wed,
|
8
|
-
lib/standup_md/config/entry.rb Wed,
|
9
|
-
lib/standup_md/config/entry_list.rb Wed,
|
10
|
-
lib/standup_md/config/file.rb Wed,
|
11
|
-
lib/standup_md/entry.rb
|
12
|
-
lib/standup_md/entry_list.rb
|
13
|
-
lib/standup_md/file.rb
|
14
|
-
lib/standup_md/file/helpers.rb
|
15
|
-
lib/standup_md/version.rb
|
1
|
+
Tue, 23 Jun 2020 14:45:39 -0500
|
2
|
+
README.md Wed, 17 Jun 2020 21:10:35 -0500
|
3
|
+
lib/standup_md.rb Wed, 17 Jun 2020 08:47:50 -0500
|
4
|
+
lib/standup_md/cli.rb Sun, 14 Jun 2020 22:01:32 -0500
|
5
|
+
lib/standup_md/cli/helpers.rb Tue, 23 Jun 2020 14:44:38 -0500
|
6
|
+
lib/standup_md/config.rb Wed, 17 Jun 2020 08:47:50 -0500
|
7
|
+
lib/standup_md/config/cli.rb Wed, 17 Jun 2020 08:47:50 -0500
|
8
|
+
lib/standup_md/config/entry.rb Wed, 17 Jun 2020 08:47:50 -0500
|
9
|
+
lib/standup_md/config/entry_list.rb Wed, 17 Jun 2020 08:47:50 -0500
|
10
|
+
lib/standup_md/config/file.rb Wed, 17 Jun 2020 08:47:50 -0500
|
11
|
+
lib/standup_md/entry.rb Tue, 23 Jun 2020 14:28:00 -0500
|
12
|
+
lib/standup_md/entry_list.rb Thu, 18 Jun 2020 23:08:53 -0500
|
13
|
+
lib/standup_md/file.rb Thu, 18 Jun 2020 23:09:53 -0500
|
14
|
+
lib/standup_md/file/helpers.rb Sun, 14 Jun 2020 22:06:09 -0500
|
15
|
+
lib/standup_md/version.rb Tue, 23 Jun 2020 14:45:34 -0500
|
@@ -148,6 +148,10 @@
|
|
148
148
|
<ul><li>
|
149
149
|
<p><a href="#api-examples">API Examples</a></p>
|
150
150
|
</li><li>
|
151
|
+
<p><a href="#adding-an-entry-for-today">Adding an entry for today</a></p>
|
152
|
+
</li><li>
|
153
|
+
<p><a href="#finding-a-past-entry">Finding a past entry</a></p>
|
154
|
+
</li><li>
|
151
155
|
<p><a href="https://evanthegrayt.github.io/standup_md/doc/index.html">Documentation</a></p>
|
152
156
|
</li></ul>
|
153
157
|
</li><li>
|
@@ -164,6 +168,8 @@
|
|
164
168
|
|
165
169
|
<h2 id="label-Installation">Installation<span><a href="#label-Installation">¶</a> <a href="#top">↑</a></span></h2>
|
166
170
|
|
171
|
+
<p>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 <a href="https://github.com/rbenv/rbenv#installation">rbenv</a>, and then installing an up-to-date version of ruby.</p>
|
172
|
+
|
167
173
|
<h3 id="label-Via+RubyGems">Via RubyGems<span><a href="#label-Via+RubyGems">¶</a> <a href="#top">↑</a></span></h3>
|
168
174
|
|
169
175
|
<p>Just install the gem!</p>
|
@@ -190,7 +196,7 @@ rake install
|
|
190
196
|
|
191
197
|
<h3 id="label-Command+Line">Command Line<span><a href="#label-Command+Line">¶</a> <a href="#top">↑</a></span></h3>
|
192
198
|
|
193
|
-
<p>For the most basic usage,
|
199
|
+
<p>For the most basic usage, simply call the executable.</p>
|
194
200
|
|
195
201
|
<pre class="ruby"><span class="ruby-identifier">standup</span>
|
196
202
|
</pre>
|
@@ -234,7 +240,7 @@ rake install
|
|
234
240
|
|
235
241
|
<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">¶</a> <a href="#top">↑</a></span></h4>
|
236
242
|
|
237
|
-
<pre>standup --no-edit --current "Work on this thing","And another thing"
|
243
|
+
<pre>standup --no-edit --current "Work on this thing","And another thing"</pre>
|
238
244
|
|
239
245
|
<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.">¶</a> <a href="#top">↑</a></span></h4>
|
240
246
|
|
@@ -252,6 +258,8 @@ rake install
|
|
252
258
|
|
253
259
|
<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">¶</a> <a href="#top">↑</a></span></h4>
|
254
260
|
|
261
|
+
<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>
|
262
|
+
|
255
263
|
<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>
|
256
264
|
<span class="ruby-comment"># Defaults for how the file is formatted.</span>
|
257
265
|
<span class="ruby-comment"># See https://evanthegrayt.github.io/standup_md/doc/StandupMD/Config/Cli.html</span>
|
@@ -288,25 +296,11 @@ rake install
|
|
288
296
|
<span class="ruby-keyword">end</span>
|
289
297
|
</pre>
|
290
298
|
|
291
|
-
<
|
299
|
+
<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'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>
|
292
300
|
|
293
|
-
<
|
294
|
-
--previous ARRAY List of precious entry's tasks
|
295
|
-
--impediments ARRAY List of impediments for current entry
|
296
|
-
--notes ARRAY List of notes for current entry
|
297
|
-
--sub-header-order ARRAY The order of the sub-headers when writing the file
|
298
|
-
-f, --file-name-format STRING Date-formattable string to use for standup file name
|
299
|
-
-E, --editor EDITOR Editor to use for opening standup files
|
300
|
-
-d, --directory DIRECTORY The directories where standup files are located
|
301
|
-
-w --[no-]write Write current entry if it doesn't exist. Default is true
|
302
|
-
-a --[no-]auto-fill-previous Auto-generate 'previous' tasks for new entries
|
303
|
-
-e --[no-]edit Open the file in the editor. Default is true
|
304
|
-
-v, --[no-]verbose Verbose output. Default is false.
|
305
|
-
-p, --print [DATE] Print current entry.
|
306
|
-
If DATE is passed, will print entry for DATE, if it exists.
|
307
|
-
DATE must be in the same format as file-name-format</pre>
|
301
|
+
<h4 id="label-Executable+Flags">Executable Flags<span><a href="#label-Executable+Flags">¶</a> <a href="#top">↑</a></span></h4>
|
308
302
|
|
309
|
-
<p>
|
303
|
+
<p>Some of these options can be changed at runtime. They are as follows. <code> --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 </code></p>
|
310
304
|
|
311
305
|
<h4 id="label-Using+Existing+Standup+Files">Using Existing Standup Files<span><a href="#label-Using+Existing+Standup+Files">¶</a> <a href="#top">↑</a></span></h4>
|
312
306
|
|
@@ -339,27 +333,28 @@ rake install
|
|
339
333
|
<p>Your <code>~/.standuprc</code> should contain:</p>
|
340
334
|
|
341
335
|
<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>
|
342
|
-
<span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">header_depth</span>
|
343
|
-
<span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">sub_header_depth</span>
|
344
|
-
<span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">current_header</span>
|
345
|
-
<span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">previous_header</span>
|
346
|
-
<span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">impediments_header</span>
|
347
|
-
<span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">bullet_character</span>
|
348
|
-
<span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">header_date_format</span>
|
349
|
-
<span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">sub_header_order</span>
|
336
|
+
<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>
|
337
|
+
<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>
|
338
|
+
<span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">current_header</span> = <span class="ruby-string">'Today'</span>
|
339
|
+
<span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">previous_header</span> = <span class="ruby-string">'Yesterday'</span>
|
340
|
+
<span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">impediments_header</span> = <span class="ruby-string">'Hold-ups'</span>
|
341
|
+
<span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">bullet_character</span> = <span class="ruby-string">'*'</span>
|
342
|
+
<span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">header_date_format</span> = <span class="ruby-string">'%m/%d/%Y'</span>
|
343
|
+
<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>
|
350
344
|
<span class="ruby-keyword">end</span>
|
351
345
|
</pre>
|
352
346
|
|
353
347
|
<h2 id="label-API">API<span><a href="#label-API">¶</a> <a href="#top">↑</a></span></h2>
|
354
348
|
|
355
|
-
<p>The API is fully documented in the <a href="https://evanthegrayt.github.io/standup_md/doc/index.html">
|
349
|
+
<p>The API is fully documented in the <a href="https://evanthegrayt.github.io/standup_md/doc/index.html">RDoc Documentation</a>.</p>
|
356
350
|
|
357
351
|
<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>
|
358
352
|
|
359
353
|
<h3 id="label-API+Examples">API Examples<span><a href="#label-API+Examples">¶</a> <a href="#top">↑</a></span></h3>
|
360
354
|
|
355
|
+
<h4 id="label-Adding+an+entry+for+today">Adding an entry for today<span><a href="#label-Adding+an+entry+for+today">¶</a> <a href="#top">↑</a></span></h4>
|
356
|
+
|
361
357
|
<pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">'standup_md'</span>
|
362
|
-
<span class="ruby-identifier">require</span> <span class="ruby-string">'date'</span>
|
363
358
|
|
364
359
|
<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>
|
365
360
|
<span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">current_header</span> = <span class="ruby-string">'Today'</span>,
|
@@ -374,7 +369,6 @@ rake install
|
|
374
369
|
<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>
|
375
370
|
|
376
371
|
<pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">'standup_md'</span>
|
377
|
-
<span class="ruby-identifier">require</span> <span class="ruby-string">'date'</span>
|
378
372
|
|
379
373
|
<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>
|
380
374
|
<span class="ruby-identifier">c</span>.<span class="ruby-identifier">file</span>.<span class="ruby-identifier">current_header</span> = <span class="ruby-string">'Today'</span>,
|
@@ -384,6 +378,15 @@ rake install
|
|
384
378
|
<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>
|
385
379
|
</pre>
|
386
380
|
|
381
|
+
<h4 id="label-Finding+a+past+entry">Finding a past entry<span><a href="#label-Finding+a+past+entry">¶</a> <a href="#top">↑</a></span></h4>
|
382
|
+
|
383
|
+
<pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">'standup_md'</span>
|
384
|
+
|
385
|
+
<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>)
|
386
|
+
<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>
|
387
|
+
<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>)
|
388
|
+
</pre>
|
389
|
+
|
387
390
|
<h2 id="label-Reporting+Bugs+and+Requesting+Features">Reporting Bugs and Requesting Features<span><a href="#label-Reporting+Bugs+and+Requesting+Features">¶</a> <a href="#top">↑</a></span></h2>
|
388
391
|
|
389
392
|
<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't already exist. Better yet, you can always submit a Pull Request.</p>
|
@@ -1 +1 @@
|
|
1
|
-
var search_data = {"index":{"searchIndex":["standupmd","cli","helpers","config","cli","entry","entrylist","file","entry","entrylist","file","<<()","<=>()","bullet_character=()","config()","config()","config()","config()","config()","config_file_loaded?()","configure()","create()","directory=()","each()","echo()","echo()","edit()","empty?()","execute()","exist?()","filter()","filter!()","find()","find()","find_by_date()","first()","header_depth=()","initalize()","last()","load()","load_config_file()","load_preferences()","loaded?()","new()","new()","new()","new()","new()","new()","new()","new()","new?()","preference_file_loaded?()","print()","reset_config()","reset_values()","reset_values()","reset_values()","reset_values()","size()","sort()","sort!()","sort_reverse()","sub_header_depth=()","to_h()","to_h()","to_json()","to_json()","write()","write_file()","readme"],"longSearchIndex":["standupmd","standupmd::cli","standupmd::cli::helpers","standupmd::config","standupmd::config::cli","standupmd::config::entry","standupmd::config::entrylist","standupmd::config::file","standupmd::entry","standupmd::entrylist","standupmd::file","standupmd::entrylist#<<()","standupmd::entry#<=>()","standupmd::config::file#bullet_character=()","standupmd::config()","standupmd::cli::config()","standupmd::entry::config()","standupmd::entrylist::config()","standupmd::file::config()","standupmd::config_file_loaded?()","standupmd::configure()","standupmd::entry::create()","standupmd::config::file#directory=()","standupmd::entrylist#each()","standupmd::cli#echo()","standupmd::cli::echo()","standupmd::cli#edit()","standupmd::entrylist#empty?()","standupmd::cli::execute()","standupmd::file#exist?()","standupmd::entrylist#filter()","standupmd::entrylist#filter!()","standupmd::entrylist#find()","standupmd::file::find()","standupmd::file::find_by_date()","standupmd::entrylist#first()","standupmd::config::file#header_depth=()","standupmd::config::entrylist#initalize()","standupmd::entrylist#last()","standupmd::file#load()","standupmd::load_config_file()","standupmd::cli#load_preferences()","standupmd::file#loaded?()","standupmd::cli::new()","standupmd::config::new()","standupmd::config::cli::new()","standupmd::config::entry::new()","standupmd::config::file::new()","standupmd::entry::new()","standupmd::entrylist::new()","standupmd::file::new()","standupmd::file#new?()","standupmd::cli#preference_file_loaded?()","standupmd::cli::helpers#print()","standupmd::reset_config()","standupmd::config::cli#reset_values()","standupmd::config::entry#reset_values()","standupmd::config::entrylist#reset_values()","standupmd::config::file#reset_values()","standupmd::entrylist#size()","standupmd::entrylist#sort()","standupmd::entrylist#sort!()","standupmd::entrylist#sort_reverse()","standupmd::config::file#sub_header_depth=()","standupmd::entry#to_h()","standupmd::entrylist#to_h()","standupmd::entry#to_json()","standupmd::entrylist#to_json()","standupmd::file#write()","standupmd::cli#write_file()",""],"info":[["StandupMD","","StandupMD.html","","
The class for handing reading/writing of entries.\n"],["StandupMD::Cli","","StandupMD/Cli.html",""," Class for handing the command-line interface.\n"],["StandupMD::Cli::Helpers","","StandupMD/Cli/Helpers.html",""," Module responsible for reading and writing standup files.\n"],["StandupMD::Config","","StandupMD/Config.html",""," This class provides a connector from StandupMD to the configuration classes.\n"],["StandupMD::Config::Cli","","StandupMD/Config/Cli.html",""," The configuration class for StandupMD::Cli\n"],["StandupMD::Config::Entry","","StandupMD/Config/Entry.html",""," The configuration class for StandupMD::Entry\n"],["StandupMD::Config::EntryList","","StandupMD/Config/EntryList.html",""," The configuration class for StandupMD::EntryList\n"],["StandupMD::Config::File","","StandupMD/Config/File.html",""," The configuration class for StandupMD::File\n"],["StandupMD::Entry","","StandupMD/Entry.html",""," Class for handling single entries. Includes the comparable module, and compares by date.\n"],["StandupMD::EntryList","","StandupMD/EntryList.html",""," Enumerable list of entries.\n"],["StandupMD::File","","StandupMD/File.html",""," Class for handling reading and writing standup files.\n"],["<<","StandupMD::EntryList","StandupMD/EntryList.html#method-i-3C-3C","(entry)"," Appends entries to list.\n @param [StandupMD::Entry] entry\n @return [Array]\n"],["<=>","StandupMD::Entry","StandupMD/Entry.html#method-i-3C-3D-3E","(other)"," Sorting method for Comparable. Entries are compared by date.\n"],["bullet_character=","StandupMD::Config::File","StandupMD/Config/File.html#method-i-bullet_character-3D","(char)"," Setter for bullet_character. Must be * (asterisk) or - (dash).\n @param [String] character\n @return [String] …\n"],["config","StandupMD","StandupMD.html#method-c-config","()"," Shorthand for @return [StanupMD::Cli]\n"],["config","StandupMD::Cli","StandupMD/Cli.html#method-c-config","()"," Access to the class's configuration.\n @return [StandupMD::Config::Cli]\n"],["config","StandupMD::Entry","StandupMD/Entry.html#method-c-config","()"," Access to the class's configuration.\n @return [StandupMD::Config::Entry]\n"],["config","StandupMD::EntryList","StandupMD/EntryList.html#method-c-config","()"," Access to the class's configuration.\n @return [StandupMD::Config::EntryList]\n"],["config","StandupMD::File","StandupMD/File.html#method-c-config","()"," Access to the class's configuration.\n @return [StandupMD::Config::EntryList]\n"],["config_file_loaded?","StandupMD","StandupMD.html#method-c-config_file_loaded-3F","()"," Has a config file been loaded?\n @return [Boolean]\n"],["configure","StandupMD","StandupMD.html#method-c-configure","()"," Allows for configuration via a block. Useful when making config files.\n @example\n\n StandupMD.configure { |s| ...\n"],["create","StandupMD::Entry","StandupMD/Entry.html#method-c-create","()"," Creates a generic entry. Default values can be set via configuration. Yields the entry if a block is …\n"],["directory=","StandupMD::Config::File","StandupMD/Config/File.html#method-i-directory-3D","(directory)"," Setter for directory. Must be expanded in case the user uses `~` for home. If the directory doesn't …\n"],["each","StandupMD::EntryList","StandupMD/EntryList.html#method-i-each","(&block)"," Iterate over the list and yield each entry.\n"],["echo","StandupMD::Cli","StandupMD/Cli.html#method-i-echo","(msg)"," Quick access to Cli.echo.\n @return [nil]\n"],["echo","StandupMD::Cli","StandupMD/Cli.html#method-c-echo","(msg)"," Prints output if @return [nil]\n"],["edit","StandupMD::Cli","StandupMD/Cli.html#method-i-edit","()"," Opens the file in an editor. Abandons the script.\n @return [nil]\n"],["empty?","StandupMD::EntryList","StandupMD/EntryList.html#method-i-empty-3F","()"," Is the list empty?\n @return [Boolean] true if empty\n"],["execute","StandupMD::Cli","StandupMD/Cli.html#method-c-execute","(options = [])"," Creates an instance of Does the file exist?\n @return [Boolean] true if exists\n"],["filter","StandupMD::EntryList","StandupMD/EntryList.html#method-i-filter","(start_date, end_date)"," Returns entries that are between the start and end date. This method assumes the list has already been …\n"],["filter!","StandupMD::EntryList","StandupMD/EntryList.html#method-i-filter-21","(start_date, end_date)"," Replaces entries with results of filter.\n @param [Date] start_date\n @param [Date] end_date\n"],["find","StandupMD::EntryList","StandupMD/EntryList.html#method-i-find","(key)"," Finds an entry based on date. This method assumes the list has already been sorted.\n"],["find","StandupMD::File","StandupMD/File.html#method-c-find","(file_name)"," Find standup file in directory by file name.\n @param [String] File_naem\n"],["find_by_date","StandupMD::File","StandupMD/File.html#method-c-find_by_date","(date)"," Find standup file in directory by Date object.\n @param [Date] date\n"],["first","StandupMD::EntryList","StandupMD/EntryList.html#method-i-first","()"," The first entry in the list. This method assumes the list has already been sorted.\n @return [StandupMD::Entry] …\n"],["header_depth=","StandupMD::Config::File","StandupMD/Config/File.html#method-i-header_depth-3D","(depth)"," Number of octothorps (#) to use before the main header.\n @param [Integer] depth\n @return [Integer]\n"],["initalize","StandupMD::Config::EntryList","StandupMD/Config/EntryList.html#method-i-initalize","()"," Initializes the config with default values.\n"],["last","StandupMD::EntryList","StandupMD/EntryList.html#method-i-last","()"," The last entry in the list. This method assumes the list has already been sorted.\n @return [StandupMD::Entry] …\n"],["load","StandupMD::File","StandupMD/File.html#method-i-load","()"," Loads the file's contents. TODO clean up this method.\n @return [StandupMD::FileList]\n"],["load_config_file","StandupMD","StandupMD.html#method-c-load_config_file","(file)"," Loads a config file.\n @param [String] file\n"],["load_preferences","StandupMD::Cli","StandupMD/Cli.html#method-i-load_preferences","()"," Load the preference file.\n @return [nil]\n"],["loaded?","StandupMD::File","StandupMD/File.html#method-i-loaded-3F","()"," Has the file been loaded?\n @return [Boolean] true if loaded\n"],["new","StandupMD::Cli","StandupMD/Cli.html#method-c-new","(options = [], load_config = true)"," Constructor. Sets defaults.\n @param [Array] options\n"],["new","StandupMD::Config","StandupMD/Config.html#method-c-new","()"," Builds the links to the configuration classes.\n"],["new","StandupMD::Config::Cli","StandupMD/Config/Cli.html#method-c-new","()"," Initializes the config with default values.\n"],["new","StandupMD::Config::Entry","StandupMD/Config/Entry.html#method-c-new","()"," Initializes the config with default values.\n"],["new","StandupMD::Config::File","StandupMD/Config/File.html#method-c-new","()"," Initializes the config with default values.\n"],["new","StandupMD::Entry","StandupMD/Entry.html#method-c-new","(date, current, previous, impediments, notes = [])"," Constructs instance of @param [Date] date\n @param [Array] current\n"],["new","StandupMD::EntryList","StandupMD/EntryList.html#method-c-new","(*entries)"," Contruct a list. Can pass any amount of @param [Entry] entries\n @return [StandupMD::EntryList] …\n"],["new","StandupMD::File","StandupMD/File.html#method-c-new","(file_name)"," Constructs the instance.\n @param [String] file_name\n @return [StandupMP::File]\n"],["new?","StandupMD::File","StandupMD/File.html#method-i-new-3F","()"," Was the file just now created?\n @return [Boolean] true if new\n"],["preference_file_loaded?","StandupMD::Cli","StandupMD/Cli.html#method-i-preference_file_loaded-3F","()"," Has the preference file been loaded?\n @return boolean\n"],["print","StandupMD::Cli::Helpers","StandupMD/Cli/Helpers.html#method-i-print","(entry)"," Print an entry to the command line.\n @param [StandupMD::Entry] entry\n @return [nil]\n"],["reset_config","StandupMD","StandupMD.html#method-c-reset_config","()"," Reset all configuration values to their defaults.\n @return [StandupMD::Config]\n"],["reset_values","StandupMD::Config::Cli","StandupMD/Config/Cli.html#method-i-reset_values","()"," Sets all config values back to their defaults.\n @return [Boolean] true if successful\n"],["reset_values","StandupMD::Config::Entry","StandupMD/Config/Entry.html#method-i-reset_values","()"," Sets all config values back to their defaults.\n @return [Boolean] true if successful\n"],["reset_values","StandupMD::Config::EntryList","StandupMD/Config/EntryList.html#method-i-reset_values","()"," Sets all config values back to their defaults.\n @return [Boolean] true if successful\n"],["reset_values","StandupMD::Config::File","StandupMD/Config/File.html#method-i-reset_values","()"," Sets all config values back to their defaults.\n @return [Boolean] true if successful\n"],["size","StandupMD::EntryList","StandupMD/EntryList.html#method-i-size","()"," How many entries are in the list.\n @return [Integer]\n"],["sort","StandupMD::EntryList","StandupMD/EntryList.html#method-i-sort","()"," Returns a copy of self sorted by date.\n @return [StandupMD::EntryList]\n"],["sort!","StandupMD::EntryList","StandupMD/EntryList.html#method-i-sort-21","()"," Replace entries with sorted entries by date.\n @return [StandupMD::EntryList]\n"],["sort_reverse","StandupMD::EntryList","StandupMD/EntryList.html#method-i-sort_reverse","()"," Returns a copy of self sorted by date.\n @return [StandupMD::EntryList]\n"],["sub_header_depth=","StandupMD::Config::File","StandupMD/Config/File.html#method-i-sub_header_depth-3D","(depth)"," Number of octothorps (#) to use before sub headers (Current, Previous, etc).\n @param [Integer] depth\n @return …\n"],["to_h","StandupMD::Entry","StandupMD/Entry.html#method-i-to_h","()"," Entry as a hash .\n @return [Hash]\n"],["to_h","StandupMD::EntryList","StandupMD/EntryList.html#method-i-to_h","()"," The list as a hash, with the dates as keys.\n @return [Hash]\n"],["to_json","StandupMD::Entry","StandupMD/Entry.html#method-i-to_json","()"," Entry as a json object.\n @return [String]\n"],["to_json","StandupMD::EntryList","StandupMD/EntryList.html#method-i-to_json","()"," The entry list as a json object.\n @return [String]\n"],["write","StandupMD::File","StandupMD/File.html#method-i-write","(dates = {})"," Writes a new entry to the file if the first entry in the file isn't today. This method is destructive; …\n"],["write_file","StandupMD::Cli","StandupMD/Cli.html#method-i-write_file","()"," Writes entries to the file.\n @return [Boolean] true if file was written\n"],["README","","README_md.html",""," The Standup Doctor\n …\n\n "]]}} |
1
|
+
var search_data = {"index":{"searchIndex":["standupmd","cli","helpers","config","cli","entry","entrylist","file","entry","entrylist","file","<<()","<=>()","@entries()","bullet_character=()","config()","config()","config()","config()","config()","config_file_loaded?()","configure()","create()","directory=()","echo()","echo()","edit()","execute()","exist?()","filter()","filter!()","find()","find()","find_by_date()","header_depth=()","initalize()","load()","load()","load_config_file()","load_preferences()","loaded?()","new()","new()","new()","new()","new()","new()","new()","new()","new?()","preference_file_loaded?()","print()","reset()","reset()","reset()","reset()","reset_config()","sort()","sort!()","sort_reverse()","sub_header_depth=()","to_h()","to_h()","to_json()","to_json()","write()","write_file()","readme"],"longSearchIndex":["standupmd","standupmd::cli","standupmd::cli::helpers","standupmd::config","standupmd::config::cli","standupmd::config::entry","standupmd::config::entrylist","standupmd::config::file","standupmd::entry","standupmd::entrylist","standupmd::file","standupmd::entrylist#<<()","standupmd::entry#<=>()","standupmd::entrylist#@entries()","standupmd::config::file#bullet_character=()","standupmd::config()","standupmd::cli::config()","standupmd::entry::config()","standupmd::entrylist::config()","standupmd::file::config()","standupmd::config_file_loaded?()","standupmd::configure()","standupmd::entry::create()","standupmd::config::file#directory=()","standupmd::cli#echo()","standupmd::cli::echo()","standupmd::cli#edit()","standupmd::cli::execute()","standupmd::file#exist?()","standupmd::entrylist#filter()","standupmd::entrylist#filter!()","standupmd::entrylist#find()","standupmd::file::find()","standupmd::file::find_by_date()","standupmd::config::file#header_depth=()","standupmd::config::entrylist#initalize()","standupmd::file::load()","standupmd::file#load()","standupmd::load_config_file()","standupmd::cli#load_preferences()","standupmd::file#loaded?()","standupmd::cli::new()","standupmd::config::new()","standupmd::config::cli::new()","standupmd::config::entry::new()","standupmd::config::file::new()","standupmd::entry::new()","standupmd::entrylist::new()","standupmd::file::new()","standupmd::file#new?()","standupmd::cli#preference_file_loaded?()","standupmd::cli::helpers#print()","standupmd::config::cli#reset()","standupmd::config::entry#reset()","standupmd::config::entrylist#reset()","standupmd::config::file#reset()","standupmd::reset_config()","standupmd::entrylist#sort()","standupmd::entrylist#sort!()","standupmd::entrylist#sort_reverse()","standupmd::config::file#sub_header_depth=()","standupmd::entry#to_h()","standupmd::entrylist#to_h()","standupmd::entry#to_json()","standupmd::entrylist#to_json()","standupmd::file#write()","standupmd::cli#write_file()",""],"info":[["StandupMD","","StandupMD.html","","
The main module for the gem. Provides access to configuration classes.\n"],["StandupMD::Cli","","StandupMD/Cli.html",""," Class for handing the command-line interface.\n"],["StandupMD::Cli::Helpers","","StandupMD/Cli/Helpers.html",""," Module responsible for reading and writing standup files.\n"],["StandupMD::Config","","StandupMD/Config.html",""," This class provides a connector from StandupMD to the configuration classes.\n"],["StandupMD::Config::Cli","","StandupMD/Config/Cli.html",""," The configuration class for StandupMD::Cli\n"],["StandupMD::Config::Entry","","StandupMD/Config/Entry.html",""," The configuration class for StandupMD::Entry\n"],["StandupMD::Config::EntryList","","StandupMD/Config/EntryList.html",""," The configuration class for StandupMD::EntryList\n"],["StandupMD::Config::File","","StandupMD/Config/File.html",""," The configuration class for StandupMD::File\n"],["StandupMD::Entry","","StandupMD/Entry.html",""," Class for handling single entries. Includes the comparable module, and compares by date.\n"],["StandupMD::EntryList","","StandupMD/EntryList.html",""," Enumerable list of entries.\n"],["StandupMD::File","","StandupMD/File.html",""," Class for handling reading and writing standup files.\n"],["<<","StandupMD::EntryList","StandupMD/EntryList.html#method-i-3C-3C","(entry)"," Appends entries to list.\n @param [StandupMD::Entry] entry\n @return [Array]\n"],["<=>","StandupMD::Entry","StandupMD/Entry.html#method-i-3C-3D-3E","(other)"," Sorting method for Comparable. Entries are compared by date.\n"],["@entries","StandupMD::EntryList","StandupMD/EntryList.html#method-i-40entries",""," The following are forwarded to @entries, which is the underly array of entries.\n
Setter for bullet_character. Must be * (asterisk) or - (dash).\n @param [String] character\n @return [String] …\n"],["config","StandupMD","StandupMD.html#method-c-config","()"," Method for accessing the configuration.\n @return [StanupMD::Cli]\n"],["config","StandupMD::Cli","StandupMD/Cli.html#method-c-config","()"," Access to the class's configuration.\n @return [StandupMD::Config::Cli]\n"],["config","StandupMD::Entry","StandupMD/Entry.html#method-c-config","()"," Access to the class's configuration.\n @return [StandupMD::Config::Entry]\n"],["config","StandupMD::EntryList","StandupMD/EntryList.html#method-c-config","()"," Access to the class's configuration.\n @return [StandupMD::Config::EntryList]\n"],["config","StandupMD::File","StandupMD/File.html#method-c-config","()"," Access to the class's configuration.\n @return [StandupMD::Config::EntryList]\n"],["config_file_loaded?","StandupMD","StandupMD.html#method-c-config_file_loaded-3F","()"," Has a config file been loaded?\n @return [Boolean]\n"],["configure","StandupMD","StandupMD.html#method-c-configure","()"," Allows for configuration via a block. Useful when making config files.\n @example\n\n StandupMD.configure { |s| ...\n"],["create","StandupMD::Entry","StandupMD/Entry.html#method-c-create","()"," Creates a generic entry. Default values can be set via configuration. Yields the entry if a block is …\n"],["directory=","StandupMD::Config::File","StandupMD/Config/File.html#method-i-directory-3D","(directory)"," Setter for directory. Must be expanded in case the user uses `~` for home. If the directory doesn't …\n"],["echo","StandupMD::Cli","StandupMD/Cli.html#method-i-echo","(msg)"," Quick access to Cli.echo.\n @return [nil]\n"],["echo","StandupMD::Cli","StandupMD/Cli.html#method-c-echo","(msg)"," Prints output if @return [nil]\n"],["edit","StandupMD::Cli","StandupMD/Cli.html#method-i-edit","()"," Opens the file in an editor. Abandons the script.\n @return [nil]\n"],["execute","StandupMD::Cli","StandupMD/Cli.html#method-c-execute","(options = [])"," Creates an instance of Does the file exist?\n @return [Boolean] true if exists\n"],["filter","StandupMD::EntryList","StandupMD/EntryList.html#method-i-filter","(start_date, end_date)"," Returns entries that are between the start and end date. This method assumes the list has already been …\n"],["filter!","StandupMD::EntryList","StandupMD/EntryList.html#method-i-filter-21","(start_date, end_date)"," Replaces entries with results of filter.\n @param [Date] start_date\n @param [Date] end_date\n"],["find","StandupMD::EntryList","StandupMD/EntryList.html#method-i-find","(date)"," Finds an entry based on date. This method assumes the list has already been sorted.\n @param [Date] date …\n"],["find","StandupMD::File","StandupMD/File.html#method-c-find","(file_name)"," Find standup file in directory by file name.\n @param [String] File_naem\n"],["find_by_date","StandupMD::File","StandupMD/File.html#method-c-find_by_date","(date)"," Find standup file in directory by Date object.\n @param [Date] date\n"],["header_depth=","StandupMD::Config::File","StandupMD/Config/File.html#method-i-header_depth-3D","(depth)"," Number of octothorps (#) to use before the main header.\n @param [Integer] depth\n @return [Integer]\n"],["initalize","StandupMD::Config::EntryList","StandupMD/Config/EntryList.html#method-i-initalize","()"," Initializes the config with default values.\n"],["load","StandupMD::File","StandupMD/File.html#method-c-load","(file_name)"," Convenience method for calling File.find(file_name).load\n @param [String] file_name\n @return [StandupMD::File] …\n"],["load","StandupMD::File","StandupMD/File.html#method-i-load","()"," Loads the file's contents. TODO clean up this method.\n @return [StandupMD::FileList]\n"],["load_config_file","StandupMD","StandupMD.html#method-c-load_config_file","(file)"," Loads a config file.\n @param [String] file\n"],["load_preferences","StandupMD::Cli","StandupMD/Cli.html#method-i-load_preferences","()"," Load the preference file.\n @return [nil]\n"],["loaded?","StandupMD::File","StandupMD/File.html#method-i-loaded-3F","()"," Has the file been loaded?\n @return [Boolean] true if loaded\n"],["new","StandupMD::Cli","StandupMD/Cli.html#method-c-new","(options = [], load_config = true)"," Constructor. Sets defaults.\n @param [Array] options\n"],["new","StandupMD::Config","StandupMD/Config.html#method-c-new","()"," Builds the links to the configuration classes.\n"],["new","StandupMD::Config::Cli","StandupMD/Config/Cli.html#method-c-new","()"," Initializes the config with default values.\n"],["new","StandupMD::Config::Entry","StandupMD/Config/Entry.html#method-c-new","()"," Initializes the config with default values.\n"],["new","StandupMD::Config::File","StandupMD/Config/File.html#method-c-new","()"," Initializes the config with default values.\n"],["new","StandupMD::Entry","StandupMD/Entry.html#method-c-new","(date, current, previous, impediments, notes = [])"," Constructs instance of @param [Date] date\n @param [Array] current\n"],["new","StandupMD::EntryList","StandupMD/EntryList.html#method-c-new","(*entries)"," Contruct a list. Can pass any amount of @param [Entry] entries\n @return [StandupMD::EntryList] …\n"],["new","StandupMD::File","StandupMD/File.html#method-c-new","(file_name)"," Constructs the instance.\n @param [String] file_name\n @return [StandupMP::File]\n"],["new?","StandupMD::File","StandupMD/File.html#method-i-new-3F","()"," Was the file just now created?\n @return [Boolean] true if new\n"],["preference_file_loaded?","StandupMD::Cli","StandupMD/Cli.html#method-i-preference_file_loaded-3F","()"," Has the preference file been loaded?\n @return boolean\n"],["print","StandupMD::Cli::Helpers","StandupMD/Cli/Helpers.html#method-i-print","(entry)"," Print an entry to the command line.\n @param [StandupMD::Entry] entry\n @return [nil]\n"],["reset","StandupMD::Config::Cli","StandupMD/Config/Cli.html#method-i-reset","()"," Sets all config values back to their defaults.\n @return [Hash]\n"],["reset","StandupMD::Config::Entry","StandupMD/Config/Entry.html#method-i-reset","()"," Sets all config values back to their defaults.\n @return [Hash]\n"],["reset","StandupMD::Config::EntryList","StandupMD/Config/EntryList.html#method-i-reset","()"," Sets all config values back to their defaults.\n @return [Hash]\n"],["reset","StandupMD::Config::File","StandupMD/Config/File.html#method-i-reset","()"," Sets all config values back to their defaults.\n @return [Hash]\n"],["reset_config","StandupMD","StandupMD.html#method-c-reset_config","()"," Reset all configuration values to their defaults.\n @return [StandupMD::Config]\n"],["sort","StandupMD::EntryList","StandupMD/EntryList.html#method-i-sort","()"," Returns a copy of self sorted by date.\n @return [StandupMD::EntryList]\n"],["sort!","StandupMD::EntryList","StandupMD/EntryList.html#method-i-sort-21","()"," Replace entries with sorted entries by date.\n @return [StandupMD::EntryList]\n"],["sort_reverse","StandupMD::EntryList","StandupMD/EntryList.html#method-i-sort_reverse","()"," Returns a copy of self sorted by date.\n @return [StandupMD::EntryList]\n"],["sub_header_depth=","StandupMD::Config::File","StandupMD/Config/File.html#method-i-sub_header_depth-3D","(depth)"," Number of octothorps (#) to use before sub headers (Current, Previous, etc).\n @param [Integer] depth\n @return …\n"],["to_h","StandupMD::Entry","StandupMD/Entry.html#method-i-to_h","()"," Entry as a hash .\n @return [Hash]\n"],["to_h","StandupMD::EntryList","StandupMD/EntryList.html#method-i-to_h","()"," The list as a hash, with the dates as keys.\n @return [Hash]\n"],["to_json","StandupMD::Entry","StandupMD/Entry.html#method-i-to_json","()"," Entry as a json object.\n @return [String]\n"],["to_json","StandupMD::EntryList","StandupMD/EntryList.html#method-i-to_json","()"," The entry list as a json object.\n @return [String]\n"],["write","StandupMD::File","StandupMD/File.html#method-i-write","(dates = {})"," Writes a new entry to the file if the first entry in the file isn't today. This method is destructive; …\n"],["write_file","StandupMD::Cli","StandupMD/Cli.html#method-i-write_file","()"," Writes entries to the file.\n @return [Boolean] true if file was written\n"],["README","","README_md.html",""," The Standup Doctor\n …\n\n "]]}} |
Binary file
|
@@ -75,6 +75,10 @@
|
|
75
75
|
|
76
76
|
<li><a href="README_md.html#label-API+Examples">API Examples</a>
|
77
77
|
|
78
|
+
<li><a href="README_md.html#label-Adding+an+entry+for+today">Adding an entry for today</a>
|
79
|
+
|
80
|
+
<li><a href="README_md.html#label-Finding+a+past+entry">Finding a past entry</a>
|
81
|
+
|
78
82
|
<li><a href="README_md.html#label-Reporting+Bugs+and+Requesting+Features">Reporting Bugs and Requesting Features</a>
|
79
83
|
|
80
84
|
<li><a href="README_md.html#label-Self-Promotion">Self-Promotion</a>
|
@@ -137,6 +141,14 @@
|
|
137
141
|
<li class="class">
|
138
142
|
<a href="StandupMD/EntryList.html">StandupMD::EntryList</a>
|
139
143
|
|
144
|
+
<ul>
|
145
|
+
|
146
|
+
<li><a href="StandupMD/EntryList.html#5Buntitled-5D">Top Section</a>
|
147
|
+
|
148
|
+
<li><a href="StandupMD/EntryList.html#Delegators">Delegators</a>
|
149
|
+
|
150
|
+
</ul>
|
151
|
+
|
140
152
|
</li>
|
141
153
|
|
142
154
|
<li class="class">
|
@@ -155,9 +167,9 @@
|
|
155
167
|
<span class="container">StandupMD::Entry</span>
|
156
168
|
|
157
169
|
<li class="method">
|
158
|
-
<a href="StandupMD/
|
170
|
+
<a href="StandupMD/EntryList.html#method-c-config">::config</a>
|
159
171
|
—
|
160
|
-
<span class="container">StandupMD::
|
172
|
+
<span class="container">StandupMD::EntryList</span>
|
161
173
|
|
162
174
|
<li class="method">
|
163
175
|
<a href="StandupMD/Cli.html#method-c-config">::config</a>
|
@@ -170,9 +182,9 @@
|
|
170
182
|
<span class="container">StandupMD</span>
|
171
183
|
|
172
184
|
<li class="method">
|
173
|
-
<a href="StandupMD/
|
185
|
+
<a href="StandupMD/File.html#method-c-config">::config</a>
|
174
186
|
—
|
175
|
-
<span class="container">StandupMD::
|
187
|
+
<span class="container">StandupMD::File</span>
|
176
188
|
|
177
189
|
<li class="method">
|
178
190
|
<a href="StandupMD.html#method-c-config_file_loaded-3F">::config_file_loaded?</a>
|
@@ -210,14 +222,14 @@
|
|
210
222
|
<span class="container">StandupMD::File</span>
|
211
223
|
|
212
224
|
<li class="method">
|
213
|
-
<a href="StandupMD.html#method-c-
|
225
|
+
<a href="StandupMD/File.html#method-c-load">::load</a>
|
214
226
|
—
|
215
|
-
<span class="container">StandupMD</span>
|
227
|
+
<span class="container">StandupMD::File</span>
|
216
228
|
|
217
229
|
<li class="method">
|
218
|
-
<a href="StandupMD
|
230
|
+
<a href="StandupMD.html#method-c-load_config_file">::load_config_file</a>
|
219
231
|
—
|
220
|
-
<span class="container">StandupMD
|
232
|
+
<span class="container">StandupMD</span>
|
221
233
|
|
222
234
|
<li class="method">
|
223
235
|
<a href="StandupMD/Config/File.html#method-c-new">::new</a>
|
@@ -244,6 +256,11 @@
|
|
244
256
|
—
|
245
257
|
<span class="container">StandupMD::Cli</span>
|
246
258
|
|
259
|
+
<li class="method">
|
260
|
+
<a href="StandupMD/EntryList.html#method-c-new">::new</a>
|
261
|
+
—
|
262
|
+
<span class="container">StandupMD::EntryList</span>
|
263
|
+
|
247
264
|
<li class="method">
|
248
265
|
<a href="StandupMD/Config/Cli.html#method-c-new">::new</a>
|
249
266
|
—
|
@@ -270,19 +287,19 @@
|
|
270
287
|
<span class="container">StandupMD::Entry</span>
|
271
288
|
|
272
289
|
<li class="method">
|
273
|
-
<a href="StandupMD/
|
290
|
+
<a href="StandupMD/EntryList.html#method-i-40entries">#@entries</a>
|
274
291
|
—
|
275
|
-
<span class="container">StandupMD::
|
292
|
+
<span class="container">StandupMD::EntryList</span>
|
276
293
|
|
277
294
|
<li class="method">
|
278
|
-
<a href="StandupMD/Config/File.html#method-i-
|
295
|
+
<a href="StandupMD/Config/File.html#method-i-bullet_character-3D">#bullet_character=</a>
|
279
296
|
—
|
280
297
|
<span class="container">StandupMD::Config::File</span>
|
281
298
|
|
282
299
|
<li class="method">
|
283
|
-
<a href="StandupMD/
|
300
|
+
<a href="StandupMD/Config/File.html#method-i-directory-3D">#directory=</a>
|
284
301
|
—
|
285
|
-
<span class="container">StandupMD::
|
302
|
+
<span class="container">StandupMD::Config::File</span>
|
286
303
|
|
287
304
|
<li class="method">
|
288
305
|
<a href="StandupMD/Cli.html#method-i-echo">#echo</a>
|
@@ -294,11 +311,6 @@
|
|
294
311
|
—
|
295
312
|
<span class="container">StandupMD::Cli</span>
|
296
313
|
|
297
|
-
<li class="method">
|
298
|
-
<a href="StandupMD/EntryList.html#method-i-empty-3F">#empty?</a>
|
299
|
-
—
|
300
|
-
<span class="container">StandupMD::EntryList</span>
|
301
|
-
|
302
314
|
<li class="method">
|
303
315
|
<a href="StandupMD/File.html#method-i-exist-3F">#exist?</a>
|
304
316
|
—
|
@@ -319,11 +331,6 @@
|
|
319
331
|
—
|
320
332
|
<span class="container">StandupMD::EntryList</span>
|
321
333
|
|
322
|
-
<li class="method">
|
323
|
-
<a href="StandupMD/EntryList.html#method-i-first">#first</a>
|
324
|
-
—
|
325
|
-
<span class="container">StandupMD::EntryList</span>
|
326
|
-
|
327
334
|
<li class="method">
|
328
335
|
<a href="StandupMD/Config/File.html#method-i-header_depth-3D">#header_depth=</a>
|
329
336
|
—
|
@@ -334,11 +341,6 @@
|
|
334
341
|
—
|
335
342
|
<span class="container">StandupMD::Config::EntryList</span>
|
336
343
|
|
337
|
-
<li class="method">
|
338
|
-
<a href="StandupMD/EntryList.html#method-i-last">#last</a>
|
339
|
-
—
|
340
|
-
<span class="container">StandupMD::EntryList</span>
|
341
|
-
|
342
344
|
<li class="method">
|
343
345
|
<a href="StandupMD/File.html#method-i-load">#load</a>
|
344
346
|
—
|
@@ -370,29 +372,24 @@
|
|
370
372
|
<span class="container">StandupMD::Cli::Helpers</span>
|
371
373
|
|
372
374
|
<li class="method">
|
373
|
-
<a href="StandupMD/Config/
|
375
|
+
<a href="StandupMD/Config/Entry.html#method-i-reset">#reset</a>
|
374
376
|
—
|
375
|
-
<span class="container">StandupMD::Config::
|
376
|
-
|
377
|
-
<li class="method">
|
378
|
-
<a href="StandupMD/Config/Cli.html#method-i-reset_values">#reset_values</a>
|
379
|
-
—
|
380
|
-
<span class="container">StandupMD::Config::Cli</span>
|
377
|
+
<span class="container">StandupMD::Config::Entry</span>
|
381
378
|
|
382
379
|
<li class="method">
|
383
|
-
<a href="StandupMD/Config/
|
380
|
+
<a href="StandupMD/Config/File.html#method-i-reset">#reset</a>
|
384
381
|
—
|
385
|
-
<span class="container">StandupMD::Config::
|
382
|
+
<span class="container">StandupMD::Config::File</span>
|
386
383
|
|
387
384
|
<li class="method">
|
388
|
-
<a href="StandupMD/Config/EntryList.html#method-i-
|
385
|
+
<a href="StandupMD/Config/EntryList.html#method-i-reset">#reset</a>
|
389
386
|
—
|
390
387
|
<span class="container">StandupMD::Config::EntryList</span>
|
391
388
|
|
392
389
|
<li class="method">
|
393
|
-
<a href="StandupMD/
|
390
|
+
<a href="StandupMD/Config/Cli.html#method-i-reset">#reset</a>
|
394
391
|
—
|
395
|
-
<span class="container">StandupMD::
|
392
|
+
<span class="container">StandupMD::Config::Cli</span>
|
396
393
|
|
397
394
|
<li class="method">
|
398
395
|
<a href="StandupMD/EntryList.html#method-i-sort">#sort</a>
|
@@ -415,14 +412,14 @@
|
|
415
412
|
<span class="container">StandupMD::Config::File</span>
|
416
413
|
|
417
414
|
<li class="method">
|
418
|
-
<a href="StandupMD/
|
415
|
+
<a href="StandupMD/Entry.html#method-i-to_h">#to_h</a>
|
419
416
|
—
|
420
|
-
<span class="container">StandupMD::
|
417
|
+
<span class="container">StandupMD::Entry</span>
|
421
418
|
|
422
419
|
<li class="method">
|
423
|
-
<a href="StandupMD/
|
420
|
+
<a href="StandupMD/EntryList.html#method-i-to_h">#to_h</a>
|
424
421
|
—
|
425
|
-
<span class="container">StandupMD::
|
422
|
+
<span class="container">StandupMD::EntryList</span>
|
426
423
|
|
427
424
|
<li class="method">
|
428
425
|
<a href="StandupMD/EntryList.html#method-i-to_json">#to_json</a>
|