shenanigans 1.0.8 → 1.0.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (28) hide show
  1. checksums.yaml +4 -4
  2. data/doc/Array.html +20 -6
  3. data/doc/Fixnum.html +11 -3
  4. data/doc/Hash.html +26 -11
  5. data/doc/Kernel.html +75 -13
  6. data/doc/Module.html +208 -0
  7. data/doc/Object.html +20 -7
  8. data/doc/README_rdoc.html +31 -12
  9. data/doc/String.html +12 -4
  10. data/doc/created.rid +25 -22
  11. data/doc/images/add.png +0 -0
  12. data/doc/images/arrow_up.png +0 -0
  13. data/doc/images/delete.png +0 -0
  14. data/doc/images/tag_blue.png +0 -0
  15. data/doc/index.html +15 -14
  16. data/doc/js/darkfish.js +9 -7
  17. data/doc/js/search_index.js +1 -1
  18. data/doc/rdoc.css +52 -0
  19. data/doc/table_of_contents.html +8 -1
  20. data/lib/shenanigans/kernel.rb +1 -0
  21. data/lib/shenanigans/kernel/fn.rb +2 -0
  22. data/lib/shenanigans/kernel/prompt.rb +1 -0
  23. data/lib/shenanigans/kernel/require_optional.rb +19 -0
  24. data/lib/shenanigans/kernel/with.rb +2 -0
  25. data/lib/shenanigans/module/private_accessor.rb +4 -2
  26. data/test/kernel/test_require_optional.rb +17 -0
  27. metadata +7 -3
  28. data/lib/shenanigans/README.mdown +0 -57
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: e639585c0a10a2b2821715d281053674c79ea3ad
4
- data.tar.gz: 54aba9ba5e55964094affdbc1c40ca48c8387907
3
+ metadata.gz: 9c51ac956ec8c326d6f7bbb962d1c226df339a93
4
+ data.tar.gz: d1300bab95b3c6f7d103f384968459cbd8675aa9
5
5
  SHA512:
6
- metadata.gz: 21d0fc654a799f2f3ae8e1d20307344639946a4102ebcbe7968a75cae06e2e1da5c58fd3df5bcf7bc184d9b1a104694604ce347e1e27b0f0900ef137c4b42080
7
- data.tar.gz: e2148cfd423f6cad95c5c313299d4b40975858a4d4f0128de648197463d3370e9ecd091577393e43a57bb2dc4706f28b74ec7177e14d1069e06da360a4ebc30b
6
+ metadata.gz: 1662c5ccfbe51264f092d8aa104ff1db3a2085ab7724d750cc92a3e42c39d404c95d344f064f80afc7c1daba80d4ba81d6d582d6b654ae0fa5f1ffbea9c0a9df
7
+ data.tar.gz: 3ddb1d799672c6a8e08b70a2cbbc2bc612969dc5f954fd6686986e75e5cc2bcaa8ba330489f168e09ceb453bb24268d592f5d0b28480c5c92e9a97e18e2e8099
data/doc/Array.html CHANGED
@@ -43,6 +43,8 @@
43
43
  </nav>
44
44
 
45
45
 
46
+
47
+
46
48
  <div id="file-metadata">
47
49
  <nav id="file-list-section" class="section">
48
50
  <h3 class="section-header">Defined In</h3>
@@ -66,17 +68,18 @@
66
68
  </nav>
67
69
 
68
70
 
71
+
69
72
  <!-- Method Quickref -->
70
73
  <nav id="method-list-section" class="section">
71
74
  <h3 class="section-header">Methods</h3>
72
75
 
73
76
  <ul class="link-list">
74
77
 
75
- <li><a href="#method-i-5E">#^</a>
78
+ <li ><a href="#method-i-5E">#^</a>
76
79
 
77
- <li><a href="#method-i-random_subarray">#random_subarray</a>
80
+ <li ><a href="#method-i-random_subarray">#random_subarray</a>
78
81
 
79
- <li><a href="#method-i-zip_with">#zip_with</a>
82
+ <li ><a href="#method-i-zip_with">#zip_with</a>
80
83
 
81
84
  </ul>
82
85
  </nav>
@@ -107,6 +110,8 @@
107
110
 
108
111
  <li><a href="./Kernel.html">Kernel</a>
109
112
 
113
+ <li><a href="./Module.html">Module</a>
114
+
110
115
  <li><a href="./Object.html">Object</a>
111
116
 
112
117
  <li><a href="./String.html">String</a>
@@ -147,7 +152,9 @@
147
152
  <div class="method-heading">
148
153
  <span class="method-name">^</span><span
149
154
  class="method-args">(other)</span>
155
+
150
156
  <span class="method-click-advice">click to toggle source</span>
157
+
151
158
  </div>
152
159
 
153
160
 
@@ -159,6 +166,7 @@
159
166
  <span class="ruby-comment">#=&gt; [3, 4]</span>
160
167
  </pre>
161
168
 
169
+
162
170
 
163
171
 
164
172
  <div class="method-source-code" id="5E-source">
@@ -181,7 +189,9 @@
181
189
  <div class="method-heading">
182
190
  <span class="method-name">random_subarray</span><span
183
191
  class="method-args">(n=1)</span>
192
+
184
193
  <span class="method-click-advice">click to toggle source</span>
194
+
185
195
  </div>
186
196
 
187
197
 
@@ -190,11 +200,12 @@
190
200
  <p>Generates random subarrays. Uses random numbers and bit-fiddling to assure
191
201
  performant uniform distributions even for large arrays.</p>
192
202
 
193
- <pre class="ruby"><span class="ruby-identifier">a</span> = *<span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-value">5</span>
203
+ <pre class="ruby"><span class="ruby-identifier">a</span> = <span class="ruby-operator">*</span><span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-value">5</span>
194
204
  <span class="ruby-identifier">a</span>.<span class="ruby-identifier">random_subarray</span>(<span class="ruby-value">3</span>)
195
205
  <span class="ruby-comment">#=&gt; [[1, 3, 5], [2, 4], [1, 3, 4, 5]]</span>
196
206
  </pre>
197
207
 
208
+
198
209
 
199
210
 
200
211
  <div class="method-source-code" id="random_subarray-source">
@@ -221,7 +232,9 @@ performant uniform distributions even for large arrays.</p>
221
232
  <div class="method-heading">
222
233
  <span class="method-name">zip_with</span><span
223
234
  class="method-args">(other, op=nil) { |a, b| ... }</span>
235
+
224
236
  <span class="method-click-advice">click to toggle source</span>
237
+
225
238
  </div>
226
239
 
227
240
 
@@ -239,10 +252,11 @@ shorter of the two arrays.</p>
239
252
 
240
253
  <p>For more complex combinations, a block can be provided:</p>
241
254
 
242
- <pre class="ruby">[<span class="ruby-value">1</span>,<span class="ruby-value">2</span>,<span class="ruby-value">3</span>].<span class="ruby-identifier">zip_with</span>([<span class="ruby-value">6</span>,<span class="ruby-value">5</span>,<span class="ruby-value">4</span>]) { <span class="ruby-operator">|</span><span class="ruby-identifier">a</span>,<span class="ruby-identifier">b</span><span class="ruby-operator">|</span> <span class="ruby-value">3</span>*<span class="ruby-identifier">a</span><span class="ruby-operator">+</span><span class="ruby-value">2</span>*<span class="ruby-identifier">b</span> }
255
+ <pre class="ruby">[<span class="ruby-value">1</span>,<span class="ruby-value">2</span>,<span class="ruby-value">3</span>].<span class="ruby-identifier">zip_with</span>([<span class="ruby-value">6</span>,<span class="ruby-value">5</span>,<span class="ruby-value">4</span>]) { <span class="ruby-operator">|</span><span class="ruby-identifier">a</span>,<span class="ruby-identifier">b</span><span class="ruby-operator">|</span> <span class="ruby-value">3</span><span class="ruby-operator">*</span><span class="ruby-identifier">a</span><span class="ruby-operator">+</span><span class="ruby-value">2</span><span class="ruby-operator">*</span><span class="ruby-identifier">b</span> }
243
256
  <span class="ruby-comment">#=&gt; [15, 16, 17]</span>
244
257
  </pre>
245
258
 
259
+
246
260
 
247
261
 
248
262
  <div class="method-source-code" id="zip_with-source">
@@ -277,7 +291,7 @@ shorter of the two arrays.</p>
277
291
 
278
292
  <footer id="validator-badges">
279
293
  <p><a href="http://validator.w3.org/check/referer">[Validate]</a>
280
- <p>Generated by <a href="https://github.com/rdoc/rdoc">RDoc</a> 3.12.
294
+ <p>Generated by <a href="https://github.com/rdoc/rdoc">RDoc</a> 4.0.0.
281
295
  <p>Generated with the <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish Rdoc Generator</a> 3.
282
296
  </footer>
283
297
 
data/doc/Fixnum.html CHANGED
@@ -43,6 +43,8 @@
43
43
  </nav>
44
44
 
45
45
 
46
+
47
+
46
48
  <div id="file-metadata">
47
49
  <nav id="file-list-section" class="section">
48
50
  <h3 class="section-header">Defined In</h3>
@@ -64,13 +66,14 @@
64
66
  </nav>
65
67
 
66
68
 
69
+
67
70
  <!-- Method Quickref -->
68
71
  <nav id="method-list-section" class="section">
69
72
  <h3 class="section-header">Methods</h3>
70
73
 
71
74
  <ul class="link-list">
72
75
 
73
- <li><a href="#method-i-string_length">#string_length</a>
76
+ <li ><a href="#method-i-string_length">#string_length</a>
74
77
 
75
78
  </ul>
76
79
  </nav>
@@ -101,6 +104,8 @@
101
104
 
102
105
  <li><a href="./Kernel.html">Kernel</a>
103
106
 
107
+ <li><a href="./Module.html">Module</a>
108
+
104
109
  <li><a href="./Object.html">Object</a>
105
110
 
106
111
  <li><a href="./String.html">String</a>
@@ -141,13 +146,15 @@
141
146
  <div class="method-heading">
142
147
  <span class="method-name">string_length</span><span
143
148
  class="method-args">()</span>
149
+
144
150
  <span class="method-click-advice">click to toggle source</span>
151
+
145
152
  </div>
146
153
 
147
154
 
148
155
  <div class="method-description">
149
156
 
150
- <p>Returns the length of the number’s string representation.</p>
157
+ <p>Returns the length of the number&#39;s string representation.</p>
151
158
 
152
159
  <pre class="ruby"><span class="ruby-value">0</span>.<span class="ruby-identifier">string_length</span>
153
160
  <span class="ruby-comment">#=&gt; 1</span>
@@ -157,6 +164,7 @@
157
164
  <span class="ruby-comment">#=&gt; 2</span>
158
165
  </pre>
159
166
 
167
+
160
168
 
161
169
 
162
170
  <div class="method-source-code" id="string_length-source">
@@ -185,7 +193,7 @@
185
193
 
186
194
  <footer id="validator-badges">
187
195
  <p><a href="http://validator.w3.org/check/referer">[Validate]</a>
188
- <p>Generated by <a href="https://github.com/rdoc/rdoc">RDoc</a> 3.12.
196
+ <p>Generated by <a href="https://github.com/rdoc/rdoc">RDoc</a> 4.0.0.
189
197
  <p>Generated with the <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish Rdoc Generator</a> 3.
190
198
  </footer>
191
199
 
data/doc/Hash.html CHANGED
@@ -43,6 +43,8 @@
43
43
  </nav>
44
44
 
45
45
 
46
+
47
+
46
48
  <div id="file-metadata">
47
49
  <nav id="file-list-section" class="section">
48
50
  <h3 class="section-header">Defined In</h3>
@@ -66,17 +68,18 @@
66
68
  </nav>
67
69
 
68
70
 
71
+
69
72
  <!-- Method Quickref -->
70
73
  <nav id="method-list-section" class="section">
71
74
  <h3 class="section-header">Methods</h3>
72
75
 
73
76
  <ul class="link-list">
74
77
 
75
- <li><a href="#method-i-extract">#extract</a>
78
+ <li ><a href="#method-i-extract">#extract</a>
76
79
 
77
- <li><a href="#method-i-has_shape-3F">#has_shape?</a>
80
+ <li ><a href="#method-i-has_shape-3F">#has_shape?</a>
78
81
 
79
- <li><a href="#method-i-to_ostruct">#to_ostruct</a>
82
+ <li ><a href="#method-i-to_ostruct">#to_ostruct</a>
80
83
 
81
84
  </ul>
82
85
  </nav>
@@ -107,6 +110,8 @@
107
110
 
108
111
  <li><a href="./Kernel.html">Kernel</a>
109
112
 
113
+ <li><a href="./Module.html">Module</a>
114
+
110
115
  <li><a href="./Object.html">Object</a>
111
116
 
112
117
  <li><a href="./String.html">String</a>
@@ -147,7 +152,9 @@
147
152
  <div class="method-heading">
148
153
  <span class="method-name">extract</span><span
149
154
  class="method-args">(*ks)</span>
155
+
150
156
  <span class="method-click-advice">click to toggle source</span>
157
+
151
158
  </div>
152
159
 
153
160
 
@@ -162,13 +169,14 @@
162
169
  <span class="ruby-comment">#=&gt; { a: 1}</span>
163
170
  </pre>
164
171
 
172
+
165
173
 
166
174
 
167
175
  <div class="method-source-code" id="extract-source">
168
176
  <pre><span class="ruby-comment"># File lib/shenanigans/hash/extract.rb, line 8</span>
169
- <span class="ruby-keyword">def</span> <span class="ruby-identifier">extract</span>(*<span class="ruby-identifier">ks</span>)
170
- <span class="ruby-identifier">existing</span> = <span class="ruby-identifier">keys</span> &amp; <span class="ruby-identifier">ks</span>
171
- <span class="ruby-constant">Hash</span>[<span class="ruby-identifier">existing</span>.<span class="ruby-identifier">zip</span>(<span class="ruby-identifier">values_at</span>(*<span class="ruby-identifier">existing</span>))]
177
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">extract</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">ks</span>)
178
+ <span class="ruby-identifier">existing</span> = <span class="ruby-identifier">keys</span> <span class="ruby-operator">&amp;</span> <span class="ruby-identifier">ks</span>
179
+ <span class="ruby-constant">Hash</span>[<span class="ruby-identifier">existing</span>.<span class="ruby-identifier">zip</span>(<span class="ruby-identifier">values_at</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">existing</span>))]
172
180
  <span class="ruby-keyword">end</span></pre>
173
181
  </div><!-- extract-source -->
174
182
 
@@ -185,7 +193,9 @@
185
193
  <div class="method-heading">
186
194
  <span class="method-name">has_shape?</span><span
187
195
  class="method-args">(shape)</span>
196
+
188
197
  <span class="method-click-advice">click to toggle source</span>
198
+
189
199
  </div>
190
200
 
191
201
 
@@ -208,6 +218,7 @@
208
218
  <span class="ruby-comment">#=&gt; true</span>
209
219
  </pre>
210
220
 
221
+
211
222
 
212
223
 
213
224
  <div class="method-source-code" id="has_shape-3F-source">
@@ -232,7 +243,9 @@
232
243
  <div class="method-heading">
233
244
  <span class="method-name">to_ostruct</span><span
234
245
  class="method-args">()</span>
246
+
235
247
  <span class="method-click-advice">click to toggle source</span>
248
+
236
249
  </div>
237
250
 
238
251
 
@@ -241,7 +254,8 @@
241
254
  <p>Recursively converts a <code>Hash</code> and all nested <code>Hash</code>es
242
255
  to <code>OpenStruct</code>s. Especially useful for parsing YAML.</p>
243
256
 
244
- <pre class="ruby"><span class="ruby-identifier">yaml</span>=<span class="ruby-string">&quot;subject: Programming Languages
257
+ <pre class="ruby"><span class="ruby-identifier">yaml</span>=<span class="ruby-value">&lt;&lt;EOY
258
+ subject: Programming Languages
245
259
  languages:
246
260
  - name : Ruby
247
261
  creator : Matz
@@ -249,7 +263,7 @@ languages:
249
263
  creator : Guido van Rossum
250
264
  - name : Perl
251
265
  creator : Larry Wall
252
- &quot;</span>
266
+ EOY</span>
253
267
  <span class="ruby-identifier">struct</span> = <span class="ruby-constant">YAML</span>.<span class="ruby-identifier">load</span>(<span class="ruby-identifier">yaml</span>).<span class="ruby-identifier">to_ostruct</span>
254
268
  <span class="ruby-identifier">struct</span>.<span class="ruby-identifier">subject</span>
255
269
  <span class="ruby-comment">#=&gt; &quot;Programming Languages&quot;</span>
@@ -259,6 +273,7 @@ languages:
259
273
  <span class="ruby-comment">#=&gt; &quot;Matz&quot;</span>
260
274
  </pre>
261
275
 
276
+
262
277
 
263
278
 
264
279
  <div class="method-source-code" id="to_ostruct-source">
@@ -269,12 +284,12 @@ languages:
269
284
  <span class="ruby-keyword">when</span> <span class="ruby-constant">Hash</span>
270
285
  [<span class="ruby-identifier">k</span>, <span class="ruby-identifier">v</span>.<span class="ruby-identifier">to_ostruct</span>]
271
286
  <span class="ruby-keyword">when</span> <span class="ruby-constant">Array</span>
272
- [<span class="ruby-identifier">k</span>, <span class="ruby-identifier">v</span>.<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">el</span><span class="ruby-operator">|</span> <span class="ruby-constant">Hash</span> <span class="ruby-operator">===</span> <span class="ruby-identifier">el</span> <span class="ruby-operator">?</span> <span class="ruby-identifier">el</span>.<span class="ruby-identifier">to_ostruct</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">el</span> }]
287
+ [<span class="ruby-identifier">k</span>, <span class="ruby-identifier">v</span>.<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">el</span><span class="ruby-operator">|</span> <span class="ruby-identifier">el</span>.<span class="ruby-identifier">respond_to?</span>(<span class="ruby-value">:to_ostruct</span>) <span class="ruby-operator">?</span> <span class="ruby-identifier">el</span>.<span class="ruby-identifier">to_ostruct</span> <span class="ruby-operator">:</span> <span class="ruby-identifier">el</span> }]
273
288
  <span class="ruby-keyword">else</span>
274
289
  [<span class="ruby-identifier">k</span>, <span class="ruby-identifier">v</span>]
275
290
  <span class="ruby-keyword">end</span>
276
291
  <span class="ruby-keyword">end</span>
277
- <span class="ruby-constant">OpenStruct</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">arr</span>)
292
+ <span class="ruby-constant">OpenStruct</span>.<span class="ruby-identifier">new</span>(<span class="ruby-constant">Hash</span>[<span class="ruby-identifier">arr</span>])
278
293
  <span class="ruby-keyword">end</span></pre>
279
294
  </div><!-- to_ostruct-source -->
280
295
 
@@ -295,7 +310,7 @@ languages:
295
310
 
296
311
  <footer id="validator-badges">
297
312
  <p><a href="http://validator.w3.org/check/referer">[Validate]</a>
298
- <p>Generated by <a href="https://github.com/rdoc/rdoc">RDoc</a> 3.12.
313
+ <p>Generated by <a href="https://github.com/rdoc/rdoc">RDoc</a> 4.0.0.
299
314
  <p>Generated with the <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish Rdoc Generator</a> 3.
300
315
  </footer>
301
316
 
data/doc/Kernel.html CHANGED
@@ -43,12 +43,15 @@
43
43
  </nav>
44
44
 
45
45
 
46
+
47
+
46
48
  <div id="file-metadata">
47
49
  <nav id="file-list-section" class="section">
48
50
  <h3 class="section-header">Defined In</h3>
49
51
  <ul>
50
52
  <li>lib/shenanigans/kernel/fn.rb
51
53
  <li>lib/shenanigans/kernel/prompt.rb
54
+ <li>lib/shenanigans/kernel/require_optional.rb
52
55
  <li>lib/shenanigans/kernel/with.rb
53
56
  </ul>
54
57
  </nav>
@@ -60,17 +63,20 @@
60
63
 
61
64
 
62
65
 
66
+
63
67
  <!-- Method Quickref -->
64
68
  <nav id="method-list-section" class="section">
65
69
  <h3 class="section-header">Methods</h3>
66
70
 
67
71
  <ul class="link-list">
68
72
 
69
- <li><a href="#method-i-fn">#fn</a>
73
+ <li ><a href="#method-i-fn">#fn</a>
70
74
 
71
- <li><a href="#method-i-prompt">#prompt</a>
75
+ <li ><a href="#method-i-prompt">#prompt</a>
72
76
 
73
- <li><a href="#method-i-with">#with</a>
77
+ <li ><a href="#method-i-require_optional">#require_optional</a>
78
+
79
+ <li ><a href="#method-i-with">#with</a>
74
80
 
75
81
  </ul>
76
82
  </nav>
@@ -101,6 +107,8 @@
101
107
 
102
108
  <li><a href="./Kernel.html">Kernel</a>
103
109
 
110
+ <li><a href="./Module.html">Module</a>
111
+
104
112
  <li><a href="./Object.html">Object</a>
105
113
 
106
114
  <li><a href="./String.html">String</a>
@@ -147,8 +155,8 @@
147
155
 
148
156
  <!-- Methods -->
149
157
 
150
- <section id="public-instance-5Buntitled-5D-method-details" class="method-section section">
151
- <h3 class="section-header">Public Instance Methods</h3>
158
+ <section id="private-instance-5Buntitled-5D-method-details" class="method-section section">
159
+ <h3 class="section-header">Private Instance Methods</h3>
152
160
 
153
161
 
154
162
  <div id="method-i-fn" class="method-detail ">
@@ -156,7 +164,9 @@
156
164
  <div class="method-heading">
157
165
  <span class="method-name">fn</span><span
158
166
  class="method-args">(*funs)</span>
167
+
159
168
  <span class="method-click-advice">click to toggle source</span>
169
+
160
170
  </div>
161
171
 
162
172
 
@@ -165,18 +175,19 @@
165
175
  <p>Composes a list of functions. Functions can be specified as symbols or
166
176
  lambdas.</p>
167
177
 
168
- <pre class="ruby">[<span class="ruby-string">&quot;foo bar&quot;</span>, <span class="ruby-string">&quot;baz qux&quot;</span>].<span class="ruby-identifier">map</span> &amp;<span class="ruby-identifier">fn</span>(:<span class="ruby-identifier">split</span>, :<span class="ruby-identifier">last</span>)
178
+ <pre class="ruby">[<span class="ruby-string">&quot;foo bar&quot;</span>, <span class="ruby-string">&quot;baz qux&quot;</span>].<span class="ruby-identifier">map</span> <span class="ruby-operator">&amp;</span><span class="ruby-identifier">fn</span>(:<span class="ruby-identifier">split</span>, :<span class="ruby-identifier">last</span>)
169
179
  <span class="ruby-comment">#=&gt; [&quot;bar&quot;, &quot;qux&quot;]</span>
170
180
 
171
- (<span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-value">3</span>).<span class="ruby-identifier">map</span> &amp;<span class="ruby-identifier">fn</span>(:<span class="ruby-keyword">next</span>, <span class="ruby-operator">-</span><span class="ruby-operator">&gt;</span> <span class="ruby-identifier">x</span> { <span class="ruby-identifier">x</span> * <span class="ruby-identifier">x</span> }, <span class="ruby-operator">-</span><span class="ruby-operator">&gt;</span> <span class="ruby-identifier">x</span> { <span class="ruby-identifier">x</span>.<span class="ruby-identifier">to_f</span> <span class="ruby-operator">/</span> <span class="ruby-value">2</span> } )
181
+ (<span class="ruby-value">1</span><span class="ruby-operator">..</span><span class="ruby-value">3</span>).<span class="ruby-identifier">map</span> <span class="ruby-operator">&amp;</span><span class="ruby-identifier">fn</span>(:<span class="ruby-keyword">next</span>, <span class="ruby-operator">-</span><span class="ruby-operator">&gt;</span> <span class="ruby-identifier">x</span> { <span class="ruby-identifier">x</span> <span class="ruby-operator">*</span> <span class="ruby-identifier">x</span> }, <span class="ruby-operator">-</span><span class="ruby-operator">&gt;</span> <span class="ruby-identifier">x</span> { <span class="ruby-identifier">x</span>.<span class="ruby-identifier">to_f</span> <span class="ruby-operator">/</span> <span class="ruby-value">2</span> } )
172
182
  <span class="ruby-comment">#=&gt; [2.0, 4.5, 8.0]</span>
173
183
  </pre>
174
184
 
185
+
175
186
 
176
187
 
177
188
  <div class="method-source-code" id="fn-source">
178
189
  <pre><span class="ruby-comment"># File lib/shenanigans/kernel/fn.rb, line 9</span>
179
- <span class="ruby-keyword">def</span> <span class="ruby-identifier">fn</span>(*<span class="ruby-identifier">funs</span>)
190
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">fn</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">funs</span>)
180
191
  <span class="ruby-operator">-</span><span class="ruby-operator">&gt;</span> <span class="ruby-identifier">x</span> <span class="ruby-keyword">do</span>
181
192
  <span class="ruby-identifier">funs</span>.<span class="ruby-identifier">inject</span>(<span class="ruby-identifier">x</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">v</span>,<span class="ruby-identifier">f</span><span class="ruby-operator">|</span>
182
193
  <span class="ruby-constant">Proc</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-identifier">call</span>(<span class="ruby-identifier">v</span>) <span class="ruby-operator">:</span> <span class="ruby-identifier">v</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">f</span>)
@@ -198,7 +209,9 @@ lambdas.</p>
198
209
  <div class="method-heading">
199
210
  <span class="method-name">prompt</span><span
200
211
  class="method-args">(text='', conversion=nil)</span>
212
+
201
213
  <span class="method-click-advice">click to toggle source</span>
214
+
202
215
  </div>
203
216
 
204
217
 
@@ -217,11 +230,12 @@ conversion method.</p>
217
230
  <span class="ruby-comment">#=&gt; 12.0</span>
218
231
  </pre>
219
232
 
233
+
220
234
 
221
235
 
222
236
  <div class="method-source-code" id="prompt-source">
223
237
  <pre><span class="ruby-comment"># File lib/shenanigans/kernel/prompt.rb, line 17</span>
224
- <span class="ruby-keyword">def</span> <span class="ruby-identifier">prompt</span>(<span class="ruby-identifier">text</span>=<span class="ruby-string">''</span>, <span class="ruby-identifier">conversion</span>=<span class="ruby-keyword">nil</span>)
238
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">prompt</span>(<span class="ruby-identifier">text</span>=<span class="ruby-string">&#39;&#39;</span>, <span class="ruby-identifier">conversion</span>=<span class="ruby-keyword">nil</span>)
225
239
  <span class="ruby-identifier">print</span> <span class="ruby-identifier">text</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">text</span>.<span class="ruby-identifier">empty?</span>
226
240
  <span class="ruby-identifier">input</span> = <span class="ruby-identifier">gets</span>.<span class="ruby-identifier">chomp</span>
227
241
  <span class="ruby-constant">CONVERSIONS</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">conversion</span>) <span class="ruby-operator">?</span> <span class="ruby-identifier">input</span>.<span class="ruby-identifier">send</span>(<span class="ruby-identifier">conversion</span>) <span class="ruby-operator">:</span> <span class="ruby-identifier">input</span>
@@ -236,12 +250,59 @@ conversion method.</p>
236
250
  </div><!-- prompt-method -->
237
251
 
238
252
 
253
+ <div id="method-i-require_optional" class="method-detail ">
254
+
255
+ <div class="method-heading">
256
+ <span class="method-name">require_optional</span><span
257
+ class="method-args">(gem, &block)</span>
258
+
259
+ <span class="method-click-advice">click to toggle source</span>
260
+
261
+ </div>
262
+
263
+
264
+ <div class="method-description">
265
+
266
+ <p>Optionally require a gem. If it is not available, <code>nil</code> will be
267
+ returned. Alternatively, a block can be provided with code to run.</p>
268
+
269
+ <pre class="ruby"><span class="ruby-identifier">require</span> <span class="ruby-string">&#39;non_existent&#39;</span>
270
+ <span class="ruby-comment">#=&gt; nil</span>
271
+
272
+ <span class="ruby-identifier">require</span> <span class="ruby-string">&#39;non_existent&#39;</span> <span class="ruby-keyword">do</span>
273
+ <span class="ruby-identifier">puts</span> <span class="ruby-string">&#39;Something went wrong&#39;</span>
274
+ <span class="ruby-keyword">end</span>
275
+ <span class="ruby-comment">#=&gt; Outputs &#39;Something went wrong&#39;</span>
276
+ </pre>
277
+
278
+
279
+
280
+
281
+ <div class="method-source-code" id="require_optional-source">
282
+ <pre><span class="ruby-comment"># File lib/shenanigans/kernel/require_optional.rb, line 12</span>
283
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">require_optional</span>(<span class="ruby-identifier">gem</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
284
+ <span class="ruby-identifier">require</span> <span class="ruby-identifier">gem</span>
285
+ <span class="ruby-keyword">rescue</span> <span class="ruby-constant">LoadError</span>
286
+ <span class="ruby-identifier">block</span>.<span class="ruby-identifier">call</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">block</span>
287
+ <span class="ruby-keyword">end</span></pre>
288
+ </div><!-- require_optional-source -->
289
+
290
+ </div>
291
+
292
+
293
+
294
+
295
+ </div><!-- require_optional-method -->
296
+
297
+
239
298
  <div id="method-i-with" class="method-detail ">
240
299
 
241
300
  <div class="method-heading">
242
301
  <span class="method-name">with</span><span
243
302
  class="method-args">(o, &blk)</span>
303
+
244
304
  <span class="method-click-advice">click to toggle source</span>
305
+
245
306
  </div>
246
307
 
247
308
 
@@ -257,12 +318,13 @@ the provided block and then returns it.</p>
257
318
  <span class="ruby-comment">#=&gt; [&quot;a&quot;, &quot;b&quot;]</span>
258
319
  </pre>
259
320
 
321
+
260
322
 
261
323
 
262
324
  <div class="method-source-code" id="with-source">
263
325
  <pre><span class="ruby-comment"># File lib/shenanigans/kernel/with.rb, line 9</span>
264
- <span class="ruby-keyword">def</span> <span class="ruby-identifier">with</span>(<span class="ruby-identifier">o</span>, &amp;<span class="ruby-identifier">blk</span>)
265
- <span class="ruby-identifier">o</span>.<span class="ruby-identifier">tap</span>(&amp;<span class="ruby-identifier">blk</span>)
326
+ <span class="ruby-keyword">def</span> <span class="ruby-identifier">with</span>(<span class="ruby-identifier">o</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">blk</span>)
327
+ <span class="ruby-identifier">o</span>.<span class="ruby-identifier">tap</span>(<span class="ruby-operator">&amp;</span><span class="ruby-identifier">blk</span>)
266
328
  <span class="ruby-keyword">end</span></pre>
267
329
  </div><!-- with-source -->
268
330
 
@@ -274,7 +336,7 @@ the provided block and then returns it.</p>
274
336
  </div><!-- with-method -->
275
337
 
276
338
 
277
- </section><!-- public-instance-method-details -->
339
+ </section><!-- private-instance-method-details -->
278
340
 
279
341
  </section><!-- 5Buntitled-5D -->
280
342
 
@@ -283,7 +345,7 @@ the provided block and then returns it.</p>
283
345
 
284
346
  <footer id="validator-badges">
285
347
  <p><a href="http://validator.w3.org/check/referer">[Validate]</a>
286
- <p>Generated by <a href="https://github.com/rdoc/rdoc">RDoc</a> 3.12.
348
+ <p>Generated by <a href="https://github.com/rdoc/rdoc">RDoc</a> 4.0.0.
287
349
  <p>Generated with the <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish Rdoc Generator</a> 3.
288
350
  </footer>
289
351