bovem 1.2.6 → 2.0.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (50) hide show
  1. data/.travis.yml +1 -1
  2. data/Gemfile +1 -1
  3. data/README.md +5 -2
  4. data/bovem.gemspec +11 -9
  5. data/doc/Bovem.html +7 -25
  6. data/doc/Bovem/Configuration.html +30 -43
  7. data/doc/Bovem/Console.html +225 -4360
  8. data/doc/Bovem/ConsoleMethods.html +125 -0
  9. data/doc/Bovem/ConsoleMethods/Interactions.html +575 -0
  10. data/doc/Bovem/ConsoleMethods/Interactions/ClassMethods.html +231 -0
  11. data/doc/Bovem/ConsoleMethods/Logging.html +2218 -0
  12. data/doc/Bovem/ConsoleMethods/Logging/ClassMethods.html +212 -0
  13. data/doc/Bovem/ConsoleMethods/Output.html +1213 -0
  14. data/doc/Bovem/ConsoleMethods/StyleHandling.html +274 -0
  15. data/doc/Bovem/ConsoleMethods/StyleHandling/ClassMethods.html +653 -0
  16. data/doc/Bovem/Errors.html +3 -3
  17. data/doc/Bovem/Errors/InvalidConfiguration.html +3 -3
  18. data/doc/Bovem/Errors/InvalidLogger.html +3 -3
  19. data/doc/Bovem/Logger.html +112 -12
  20. data/doc/Bovem/Shell.html +58 -1888
  21. data/doc/Bovem/ShellMethods.html +125 -0
  22. data/doc/Bovem/ShellMethods/Directories.html +484 -0
  23. data/doc/Bovem/ShellMethods/Execute.html +565 -0
  24. data/doc/Bovem/ShellMethods/General.html +450 -0
  25. data/doc/Bovem/ShellMethods/Read.html +451 -0
  26. data/doc/Bovem/ShellMethods/Write.html +676 -0
  27. data/doc/Bovem/Version.html +6 -6
  28. data/doc/_index.html +145 -4
  29. data/doc/class_list.html +1 -1
  30. data/doc/file.README.html +10 -7
  31. data/doc/frames.html +1 -1
  32. data/doc/index.html +10 -7
  33. data/doc/method_list.html +119 -79
  34. data/doc/top-level-namespace.html +3 -3
  35. data/lib/bovem.rb +1 -1
  36. data/lib/bovem/configuration.rb +24 -13
  37. data/lib/bovem/console.rb +566 -497
  38. data/lib/bovem/errors.rb +1 -1
  39. data/lib/bovem/logger.rb +4 -4
  40. data/lib/bovem/shell.rb +482 -305
  41. data/lib/bovem/version.rb +4 -4
  42. data/locales/en.yml +43 -0
  43. data/locales/it.yml +43 -0
  44. data/spec/bovem/configuration_spec.rb +3 -3
  45. data/spec/bovem/console_spec.rb +17 -10
  46. data/spec/bovem/logger_spec.rb +1 -1
  47. data/spec/bovem/shell_spec.rb +9 -5
  48. data/spec/coverage_helper.rb +1 -1
  49. data/spec/spec_helper.rb +1 -1
  50. metadata +32 -22
@@ -6,7 +6,7 @@
6
6
  <title>
7
7
  Module: Bovem::Errors
8
8
 
9
- &mdash; Documentation by YARD 0.8.2.1
9
+ &mdash; Documentation by YARD 0.8.3
10
10
 
11
11
  </title>
12
12
 
@@ -116,9 +116,9 @@
116
116
  </div>
117
117
 
118
118
  <div id="footer">
119
- Generated on Mon Oct 22 09:30:26 2012 by
119
+ Generated on Fri Feb 1 23:40:17 2013 by
120
120
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
121
- 0.8.2.1 (ruby-1.9.2).
121
+ 0.8.3 (ruby-1.9.3).
122
122
  </div>
123
123
 
124
124
  </body>
@@ -6,7 +6,7 @@
6
6
  <title>
7
7
  Exception: Bovem::Errors::InvalidConfiguration
8
8
 
9
- &mdash; Documentation by YARD 0.8.2.1
9
+ &mdash; Documentation by YARD 0.8.3
10
10
 
11
11
  </title>
12
12
 
@@ -124,9 +124,9 @@
124
124
  </div>
125
125
 
126
126
  <div id="footer">
127
- Generated on Mon Oct 22 09:30:27 2012 by
127
+ Generated on Fri Feb 1 23:40:18 2013 by
128
128
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
129
- 0.8.2.1 (ruby-1.9.2).
129
+ 0.8.3 (ruby-1.9.3).
130
130
  </div>
131
131
 
132
132
  </body>
@@ -6,7 +6,7 @@
6
6
  <title>
7
7
  Exception: Bovem::Errors::InvalidLogger
8
8
 
9
- &mdash; Documentation by YARD 0.8.2.1
9
+ &mdash; Documentation by YARD 0.8.3
10
10
 
11
11
  </title>
12
12
 
@@ -124,9 +124,9 @@
124
124
  </div>
125
125
 
126
126
  <div id="footer">
127
- Generated on Mon Oct 22 09:30:27 2012 by
127
+ Generated on Fri Feb 1 23:40:18 2013 by
128
128
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
129
- 0.8.2.1 (ruby-1.9.2).
129
+ 0.8.3 (ruby-1.9.3).
130
130
  </div>
131
131
 
132
132
  </body>
@@ -6,7 +6,7 @@
6
6
  <title>
7
7
  Class: Bovem::Logger
8
8
 
9
- &mdash; Documentation by YARD 0.8.2.1
9
+ &mdash; Documentation by YARD 0.8.3
10
10
 
11
11
  </title>
12
12
 
@@ -121,7 +121,7 @@
121
121
  <li class="public ">
122
122
  <span class="summary_signature">
123
123
 
124
- <a href="#device-instance_method" title="#device (instance method)">- (Object) <strong>device</strong> </a>
124
+ <a href="#device-instance_method" title="#device (instance method)">- (IO|String) <strong>device</strong> </a>
125
125
 
126
126
 
127
127
 
@@ -130,8 +130,6 @@
130
130
 
131
131
 
132
132
 
133
- <span class="note title readonly">readonly</span>
134
-
135
133
 
136
134
 
137
135
 
@@ -143,6 +141,32 @@
143
141
  <span class="summary_desc"><div class='inline'><p>The file or device to log messages to.</p>
144
142
  </div></span>
145
143
 
144
+ </li>
145
+
146
+
147
+ <li class="public ">
148
+ <span class="summary_signature">
149
+
150
+ <a href="#start_time-instance_method" title="#start_time (instance method)">- (Time) <strong>start_time</strong> </a>
151
+
152
+
153
+
154
+ </span>
155
+
156
+
157
+
158
+
159
+
160
+
161
+
162
+
163
+
164
+
165
+
166
+
167
+ <span class="summary_desc"><div class='inline'><p>The start time of first line.</p>
168
+ </div></span>
169
+
146
170
  </li>
147
171
 
148
172
 
@@ -423,11 +447,11 @@
423
447
  <h2>Instance Attribute Details</h2>
424
448
 
425
449
 
426
- <span id=""></span>
450
+ <span id="device=-instance_method"></span>
427
451
  <div class="method_details first">
428
452
  <h3 class="signature first" id="device-instance_method">
429
453
 
430
- - (<tt>Object</tt>) <strong>device</strong> <span class="extras">(readonly)</span>
454
+ - (<tt>IO|String</tt>) <strong>device</strong>
431
455
 
432
456
 
433
457
 
@@ -442,6 +466,23 @@
442
466
  </div>
443
467
  <div class="tags">
444
468
 
469
+ <p class="tag_title">Returns:</p>
470
+ <ul class="return">
471
+
472
+ <li>
473
+
474
+
475
+ <span class='type'>(<tt>IO|String</tt>)</span>
476
+
477
+
478
+
479
+ &mdash;
480
+ <div class='inline'><p>the current value of device</p>
481
+ </div>
482
+
483
+ </li>
484
+
485
+ </ul>
445
486
 
446
487
  </div><table class="source_code">
447
488
  <tr>
@@ -449,12 +490,12 @@
449
490
  <pre class="lines">
450
491
 
451
492
 
452
- 14
453
- 15
454
- 16</pre>
493
+ 12
494
+ 13
495
+ 14</pre>
455
496
  </td>
456
497
  <td>
457
- <pre class="code"><span class="info file"># File 'lib/bovem/logger.rb', line 14</span>
498
+ <pre class="code"><span class="info file"># File 'lib/bovem/logger.rb', line 12</span>
458
499
 
459
500
  <span class='kw'>def</span> <span class='id identifier rubyid_device'>device</span>
460
501
  <span class='ivar'>@device</span>
@@ -464,6 +505,65 @@
464
505
  </table>
465
506
  </div>
466
507
 
508
+
509
+ <span id="start_time=-instance_method"></span>
510
+ <div class="method_details ">
511
+ <h3 class="signature " id="start_time-instance_method">
512
+
513
+ - (<tt>Time</tt>) <strong>start_time</strong>
514
+
515
+
516
+
517
+
518
+
519
+ </h3><div class="docstring">
520
+ <div class="discussion">
521
+ <p>The start time of first line. This allows to show a <code>T+0.1234</code> information into the log.</p>
522
+
523
+
524
+ </div>
525
+ </div>
526
+ <div class="tags">
527
+
528
+ <p class="tag_title">Returns:</p>
529
+ <ul class="return">
530
+
531
+ <li>
532
+
533
+
534
+ <span class='type'>(<tt>Time</tt>)</span>
535
+
536
+
537
+
538
+ &mdash;
539
+ <div class='inline'><p>the current value of start_time</p>
540
+ </div>
541
+
542
+ </li>
543
+
544
+ </ul>
545
+
546
+ </div><table class="source_code">
547
+ <tr>
548
+ <td>
549
+ <pre class="lines">
550
+
551
+
552
+ 12
553
+ 13
554
+ 14</pre>
555
+ </td>
556
+ <td>
557
+ <pre class="code"><span class="info file"># File 'lib/bovem/logger.rb', line 12</span>
558
+
559
+ <span class='kw'>def</span> <span class='id identifier rubyid_start_time'>start_time</span>
560
+ <span class='ivar'>@start_time</span>
561
+ <span class='kw'>end</span></pre>
562
+ </td>
563
+ </tr>
564
+ </table>
565
+ </div>
566
+
467
567
  </div>
468
568
 
469
569
 
@@ -887,9 +987,9 @@
887
987
  </div>
888
988
 
889
989
  <div id="footer">
890
- Generated on Mon Oct 22 09:30:27 2012 by
990
+ Generated on Fri Feb 1 23:40:18 2013 by
891
991
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
892
- 0.8.2.1 (ruby-1.9.2).
992
+ 0.8.3 (ruby-1.9.3).
893
993
  </div>
894
994
 
895
995
  </body>
@@ -6,7 +6,7 @@
6
6
  <title>
7
7
  Class: Bovem::Shell
8
8
 
9
- &mdash; Documentation by YARD 0.8.2.1
9
+ &mdash; Documentation by YARD 0.8.3
10
10
 
11
11
  </title>
12
12
 
@@ -90,11 +90,15 @@
90
90
 
91
91
 
92
92
 
93
+ <dt class="r2">Includes:</dt>
94
+ <dd class="r2"><span class='object_link'><a href="ShellMethods/Directories.html" title="Bovem::ShellMethods::Directories (module)">Bovem::ShellMethods::Directories</a></span>, <span class='object_link'><a href="ShellMethods/Execute.html" title="Bovem::ShellMethods::Execute (module)">Bovem::ShellMethods::Execute</a></span>, <span class='object_link'><a href="ShellMethods/General.html" title="Bovem::ShellMethods::General (module)">Bovem::ShellMethods::General</a></span>, <span class='object_link'><a href="ShellMethods/Read.html" title="Bovem::ShellMethods::Read (module)">Bovem::ShellMethods::Read</a></span>, <span class='object_link'><a href="ShellMethods/Write.html" title="Bovem::ShellMethods::Write (module)">Bovem::ShellMethods::Write</a></span>, Lazier::I18n</dd>
95
+
96
+
93
97
 
94
98
 
95
99
 
96
- <dt class="r2 last">Defined in:</dt>
97
- <dd class="r2 last">lib/bovem/shell.rb</dd>
100
+ <dt class="r1 last">Defined in:</dt>
101
+ <dd class="r1 last">lib/bovem/shell.rb</dd>
98
102
 
99
103
  </dl>
100
104
  <div class="clear"></div>
@@ -119,7 +123,7 @@
119
123
  <li class="public ">
120
124
  <span class="summary_signature">
121
125
 
122
- <a href="#console-instance_method" title="#console (instance method)">- (Object) <strong>console</strong> </a>
126
+ <a href="#console-instance_method" title="#console (instance method)">- (Console) <strong>console</strong> </a>
123
127
 
124
128
 
125
129
 
@@ -136,7 +140,7 @@
136
140
 
137
141
 
138
142
 
139
- <span class="summary_desc"><div class='inline'><p>A <span class='object_link'><a href="Console.html" title="Bovem::Console (class)">Console</a></span> instance.</p>
143
+ <span class="summary_desc"><div class='inline'><h1>A console instance.</h1>
140
144
  </div></span>
141
145
 
142
146
  </li>
@@ -190,81 +194,14 @@
190
194
  <li class="public ">
191
195
  <span class="summary_signature">
192
196
 
193
- <a href="#check-instance_method" title="#check (instance method)">- (Object) <strong>check</strong>(path, tests) </a>
194
-
195
-
196
-
197
- </span>
198
-
199
-
200
-
201
-
202
-
203
-
204
-
205
-
206
-
207
- <span class="summary_desc"><div class='inline'><p>Tests a path against a list of test.</p>
208
- </div></span>
209
-
210
- </li>
211
-
212
-
213
- <li class="public ">
214
- <span class="summary_signature">
215
-
216
- <a href="#copy-instance_method" title="#copy (instance method)">- (Boolean) <strong>copy</strong>(src, dst, run = true, show_errors = false, fatal = true) </a>
217
-
218
-
219
-
220
- </span>
221
-
222
-
223
-
224
-
225
-
226
-
227
-
228
-
229
-
230
- <span class="summary_desc"><div class='inline'><p>Copies a set of files or directory to another location.</p>
231
- </div></span>
232
-
233
- </li>
234
-
235
-
236
- <li class="public ">
237
- <span class="summary_signature">
238
-
239
- <a href="#copy_or_move-instance_method" title="#copy_or_move (instance method)">- (Boolean) <strong>copy_or_move</strong>(src, dst, operation, run = true, show_errors = false, fatal = true) </a>
197
+ <a href="#initialize-instance_method" title="#initialize (instance method)">- (Shell) <strong>initialize</strong> </a>
240
198
 
241
199
 
242
200
 
243
201
  </span>
244
202
 
245
203
 
246
-
247
-
248
-
249
-
250
-
251
-
252
-
253
- <span class="summary_desc"><div class='inline'><p>Copies or moves a set of files or directory to another location.</p>
254
- </div></span>
255
-
256
- </li>
257
-
258
-
259
- <li class="public ">
260
- <span class="summary_signature">
261
-
262
- <a href="#create_directories-instance_method" title="#create_directories (instance method)">- (Boolean) <strong>create_directories</strong>(directories, mode = 0755, run = true, show_errors = false, fatal = true) </a>
263
-
264
-
265
-
266
- </span>
267
-
204
+ <span class="note title constructor">constructor</span>
268
205
 
269
206
 
270
207
 
@@ -273,156 +210,72 @@
273
210
 
274
211
 
275
212
 
276
- <span class="summary_desc"><div class='inline'><p>Creates a list of directories, included missing parent directories.</p>
213
+ <span class="summary_desc"><div class='inline'><p>Initializes a new Shell.</p>
277
214
  </div></span>
278
215
 
279
216
  </li>
280
217
 
281
218
 
282
- <li class="public ">
283
- <span class="summary_signature">
284
-
285
- <a href="#delete-instance_method" title="#delete (instance method)">- (Boolean) <strong>delete</strong>(files, run = true, show_errors = false, fatal = true) </a>
286
-
287
-
288
-
289
- </span>
290
-
291
-
292
-
293
-
294
-
295
-
296
-
297
-
298
-
299
- <span class="summary_desc"><div class='inline'><p>Deletes a list of files.</p>
300
- </div></span>
219
+ </ul>
301
220
 
302
- </li>
303
221
 
304
-
305
- <li class="public ">
306
- <span class="summary_signature">
307
-
308
- <a href="#find-instance_method" title="#find (instance method)">- (Object) <strong>find</strong>(directories, patterns = [], by_extension = false, case_sensitive = false) </a>
309
-
310
222
 
311
-
312
- </span>
313
-
314
223
 
315
224
 
316
225
 
317
226
 
318
227
 
319
228
 
320
-
321
229
 
322
- <span class="summary_desc"><div class='inline'><p>Find a list of files in directories matching given regexps or patterns.</p>
323
- </div></span>
324
230
 
325
- </li>
326
-
327
-
328
- <li class="public ">
329
- <span class="summary_signature">
330
-
331
- <a href="#initialize-instance_method" title="#initialize (instance method)">- (Shell) <strong>initialize</strong> </a>
332
-
231
+ <h3 class="inherited">Methods included from <span class='object_link'><a href="ShellMethods/Directories.html" title="Bovem::ShellMethods::Directories (module)">Bovem::ShellMethods::Directories</a></span></h3>
232
+ <p class="inherited"><span class='object_link'><a href="ShellMethods/Directories.html#create_directories-instance_method" title="Bovem::ShellMethods::Directories#create_directories (method)">#create_directories</a></span>, <span class='object_link'><a href="ShellMethods/Directories.html#within_directory-instance_method" title="Bovem::ShellMethods::Directories#within_directory (method)">#within_directory</a></span></p>
333
233
 
334
-
335
- </span>
336
-
337
-
338
- <span class="note title constructor">constructor</span>
339
234
 
340
235
 
341
236
 
342
237
 
343
238
 
344
239
 
345
-
346
240
 
347
- <span class="summary_desc"><div class='inline'><p>Initializes a new Shell.</p>
348
- </div></span>
349
241
 
350
- </li>
351
-
352
-
353
- <li class="public ">
354
- <span class="summary_signature">
355
-
356
- <a href="#move-instance_method" title="#move (instance method)">- (Boolean) <strong>move</strong>(src, dst, run = true, show_errors = false, fatal = true) </a>
357
-
242
+ <h3 class="inherited">Methods included from <span class='object_link'><a href="ShellMethods/Execute.html" title="Bovem::ShellMethods::Execute (module)">Bovem::ShellMethods::Execute</a></span></h3>
243
+ <p class="inherited"><span class='object_link'><a href="ShellMethods/Execute.html#delete-instance_method" title="Bovem::ShellMethods::Execute#delete (method)">#delete</a></span>, <span class='object_link'><a href="ShellMethods/Execute.html#run-instance_method" title="Bovem::ShellMethods::Execute#run (method)">#run</a></span></p>
358
244
 
359
-
360
- </span>
361
-
362
245
 
363
246
 
364
247
 
365
248
 
366
249
 
367
250
 
368
-
369
251
 
370
- <span class="summary_desc"><div class='inline'><p>Moves a set of files or directory to another location.</p>
371
- </div></span>
372
252
 
373
- </li>
374
-
375
-
376
- <li class="public ">
377
- <span class="summary_signature">
378
-
379
- <a href="#run-instance_method" title="#run (instance method)">- (Hash) <strong>run</strong>(command, message = nil, run = true, show_exit = true, show_output = false, show_command = false, fatal = true) </a>
380
-
253
+ <h3 class="inherited">Methods included from <span class='object_link'><a href="ShellMethods/Write.html" title="Bovem::ShellMethods::Write (module)">Bovem::ShellMethods::Write</a></span></h3>
254
+ <p class="inherited"><span class='object_link'><a href="ShellMethods/Write.html#copy-instance_method" title="Bovem::ShellMethods::Write#copy (method)">#copy</a></span>, <span class='object_link'><a href="ShellMethods/Write.html#copy_or_move-instance_method" title="Bovem::ShellMethods::Write#copy_or_move (method)">#copy_or_move</a></span>, <span class='object_link'><a href="ShellMethods/Write.html#move-instance_method" title="Bovem::ShellMethods::Write#move (method)">#move</a></span></p>
381
255
 
382
-
383
- </span>
384
-
385
256
 
386
257
 
387
258
 
388
259
 
389
260
 
390
261
 
391
-
392
262
 
393
- <span class="summary_desc"><div class='inline'><p>Runs a command into the shell.</p>
394
- </div></span>
395
263
 
396
- </li>
397
-
398
-
399
- <li class="public ">
400
- <span class="summary_signature">
401
-
402
- <a href="#within_directory-instance_method" title="#within_directory (instance method)">- (Boolean) <strong>within_directory</strong>(directory, restore = true, show_messages = false) </a>
403
-
264
+ <h3 class="inherited">Methods included from <span class='object_link'><a href="ShellMethods/Read.html" title="Bovem::ShellMethods::Read (module)">Bovem::ShellMethods::Read</a></span></h3>
265
+ <p class="inherited"><span class='object_link'><a href="ShellMethods/Read.html#check-instance_method" title="Bovem::ShellMethods::Read#check (method)">#check</a></span>, <span class='object_link'><a href="ShellMethods/Read.html#find-instance_method" title="Bovem::ShellMethods::Read#find (method)">#find</a></span></p>
404
266
 
405
-
406
- </span>
407
-
408
267
 
409
268
 
410
269
 
411
270
 
412
271
 
413
272
 
414
-
415
-
416
- <span class="summary_desc"><div class='inline'><p>Executes a block of code in another directory.</p>
417
- </div></span>
418
273
 
419
- </li>
420
-
421
-
422
- </ul>
423
274
 
275
+ <h3 class="inherited">Methods included from <span class='object_link'><a href="ShellMethods/General.html" title="Bovem::ShellMethods::General (module)">Bovem::ShellMethods::General</a></span></h3>
276
+ <p class="inherited"><span class='object_link'><a href="ShellMethods/General.html#handle_failure-instance_method" title="Bovem::ShellMethods::General#handle_failure (method)">#handle_failure</a></span>, <span class='object_link'><a href="ShellMethods/General.html#show_general_failure-instance_method" title="Bovem::ShellMethods::General#show_general_failure (method)">#show_general_failure</a></span></p>
424
277
 
425
- <div id="constructor_details" class="method_details_list">
278
+ <div id="constructor_details" class="method_details_list">
426
279
  <h2>Constructor Details</h2>
427
280
 
428
281
  <div class="method_details first">
@@ -450,15 +303,17 @@
450
303
  <pre class="lines">
451
304
 
452
305
 
453
- 21
454
- 22
455
- 23</pre>
306
+ 559
307
+ 560
308
+ 561
309
+ 562</pre>
456
310
  </td>
457
311
  <td>
458
- <pre class="code"><span class="info file"># File 'lib/bovem/shell.rb', line 21</span>
312
+ <pre class="code"><span class="info file"># File 'lib/bovem/shell.rb', line 559</span>
459
313
 
460
314
  <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span>
461
315
  <span class='ivar'>@console</span> <span class='op'>=</span> <span class='op'>::</span><span class='const'>Bovem</span><span class='op'>::</span><span class='const'>Console</span><span class='period'>.</span><span class='id identifier rubyid_instance'>instance</span>
316
+ <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_i18n_setup'>i18n_setup</span><span class='lparen'>(</span><span class='symbol'>:bovem</span><span class='comma'>,</span> <span class='op'>::</span><span class='const'>File</span><span class='period'>.</span><span class='id identifier rubyid_absolute_path'>absolute_path</span><span class='lparen'>(</span><span class='op'>::</span><span class='const'>Pathname</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='op'>::</span><span class='const'>File</span><span class='period'>.</span><span class='id identifier rubyid_dirname'>dirname</span><span class='lparen'>(</span><span class='kw'>__FILE__</span><span class='rparen'>)</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span> <span class='op'>+</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>/../../locales/</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='rparen'>)</span>
462
317
  <span class='kw'>end</span></pre>
463
318
  </td>
464
319
  </tr>
@@ -475,54 +330,7 @@
475
330
  <div class="method_details first">
476
331
  <h3 class="signature first" id="console-instance_method">
477
332
 
478
- - (<tt>Object</tt>) <strong>console</strong>
479
-
480
-
481
-
482
-
483
-
484
- </h3><div class="docstring">
485
- <div class="discussion">
486
- <p>A <span class='object_link'><a href="Console.html" title="Bovem::Console (class)">Console</a></span> instance.</p>
487
-
488
-
489
- </div>
490
- </div>
491
- <div class="tags">
492
-
493
-
494
- </div><table class="source_code">
495
- <tr>
496
- <td>
497
- <pre class="lines">
498
-
499
-
500
- 11
501
- 12
502
- 13</pre>
503
- </td>
504
- <td>
505
- <pre class="code"><span class="info file"># File 'lib/bovem/shell.rb', line 11</span>
506
-
507
- <span class='kw'>def</span> <span class='id identifier rubyid_console'>console</span>
508
- <span class='ivar'>@console</span>
509
- <span class='kw'>end</span></pre>
510
- </td>
511
- </tr>
512
- </table>
513
- </div>
514
-
515
- </div>
516
-
517
-
518
- <div id="class_method_details" class="method_details_list">
519
- <h2>Class Method Details</h2>
520
-
521
-
522
- <div class="method_details first">
523
- <h3 class="signature first" id="instance-class_method">
524
-
525
- + (<tt><span class='object_link'><a href="" title="Bovem::Shell (class)">Shell</a></span></tt>) <strong>instance</strong>
333
+ - (<tt><span class='object_link'><a href="Console.html" title="Bovem::Console (class)">Console</a></span></tt>) <strong>console</strong>
526
334
 
527
335
 
528
336
 
@@ -530,7 +338,7 @@
530
338
 
531
339
  </h3><div class="docstring">
532
340
  <div class="discussion">
533
- <p>Returns a unique instance for Shell.</p>
341
+ <h1>A console instance.</h1>
534
342
 
535
343
 
536
344
  </div>
@@ -543,12 +351,12 @@
543
351
  <li>
544
352
 
545
353
 
546
- <span class='type'>(<tt><span class='object_link'><a href="" title="Bovem::Shell (class)">Shell</a></span></tt>)</span>
354
+ <span class='type'>(<tt><span class='object_link'><a href="Console.html" title="Bovem::Console (class)">Console</a></span></tt>)</span>
547
355
 
548
356
 
549
357
 
550
358
  &mdash;
551
- <div class='inline'><p>A new instance.</p>
359
+ <div class='inline'><p>the current value of console</p>
552
360
  </div>
553
361
 
554
362
  </li>
@@ -561,15 +369,15 @@
561
369
  <pre class="lines">
562
370
 
563
371
 
564
- 16
565
- 17
566
- 18</pre>
372
+ 541
373
+ 542
374
+ 543</pre>
567
375
  </td>
568
376
  <td>
569
- <pre class="code"><span class="info file"># File 'lib/bovem/shell.rb', line 16</span>
377
+ <pre class="code"><span class="info file"># File 'lib/bovem/shell.rb', line 541</span>
570
378
 
571
- <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_instance'>instance</span>
572
- <span class='ivar'>@instance</span> <span class='op'>||=</span> <span class='op'>::</span><span class='const'>Bovem</span><span class='op'>::</span><span class='const'>Shell</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
379
+ <span class='kw'>def</span> <span class='id identifier rubyid_console'>console</span>
380
+ <span class='ivar'>@console</span>
573
381
  <span class='kw'>end</span></pre>
574
382
  </td>
575
383
  </tr>
@@ -578,14 +386,15 @@
578
386
 
579
387
  </div>
580
388
 
581
- <div id="instance_method_details" class="method_details_list">
582
- <h2>Instance Method Details</h2>
389
+
390
+ <div id="class_method_details" class="method_details_list">
391
+ <h2>Class Method Details</h2>
583
392
 
584
393
 
585
394
  <div class="method_details first">
586
- <h3 class="signature first" id="check-instance_method">
395
+ <h3 class="signature first" id="instance-class_method">
587
396
 
588
- - (<tt>Object</tt>) <strong>check</strong>(path, tests)
397
+ + (<tt><span class='object_link'><a href="" title="Bovem::Shell (class)">Shell</a></span></tt>) <strong>instance</strong>
589
398
 
590
399
 
591
400
 
@@ -593,1685 +402,46 @@
593
402
 
594
403
  </h3><div class="docstring">
595
404
  <div class="discussion">
596
- <p>Tests a path against a list of test.</p>
597
-
598
- <p>Valid tests are every method available in <a href="http://www.ruby-doc.org/core-1.9.3/FileTest.html">http://www.ruby-doc.org/core-1.9.3/FileTest.html</a> (plus <code>read</code>, <code>write</code>, <code>execute</code>, <code>exec</code>, <code>dir</code>). Trailing question mark can be omitted.</p>
405
+ <p>Returns a unique instance for Shell.</p>
599
406
 
600
407
 
601
408
  </div>
602
409
  </div>
603
410
  <div class="tags">
604
- <p class="tag_title">Parameters:</p>
605
- <ul class="param">
606
411
 
607
- <li>
608
-
609
- <span class='name'>path</span>
610
-
611
-
612
- <span class='type'>(<tt>String</tt>)</span>
613
-
614
-
615
-
616
- &mdash;
617
- <div class='inline'><p>The path to test.</p>
618
- </div>
619
-
620
- </li>
412
+ <p class="tag_title">Returns:</p>
413
+ <ul class="return">
621
414
 
622
415
  <li>
623
416
 
624
- <span class='name'>tests</span>
625
417
 
626
-
627
- <span class='type'>(<tt>Array</tt>)</span>
418
+ <span class='type'>(<tt><span class='object_link'><a href="" title="Bovem::Shell (class)">Shell</a></span></tt>)</span>
628
419
 
629
420
 
630
421
 
631
422
  &mdash;
632
- <div class='inline'><p>The list of tests to perform.</p>
423
+ <div class='inline'><p>A new instance.</p>
633
424
  </div>
634
425
 
635
426
  </li>
636
427
 
637
428
  </ul>
638
429
 
639
-
640
430
  </div><table class="source_code">
641
431
  <tr>
642
432
  <td>
643
433
  <pre class="lines">
644
434
 
645
435
 
646
- 73
647
- 74
648
- 75
649
- 76
650
- 77
651
- 78
652
- 79
653
- 80
654
- 81
655
- 82
656
- 83
657
- 84
658
- 85
659
- 86
660
- 87
661
- 88
662
- 89
663
- 90
664
- 91
665
- 92</pre>
436
+ 554
437
+ 555
438
+ 556</pre>
666
439
  </td>
667
440
  <td>
668
- <pre class="code"><span class="info file"># File 'lib/bovem/shell.rb', line 73</span>
669
-
670
- <span class='kw'>def</span> <span class='id identifier rubyid_check'>check</span><span class='lparen'>(</span><span class='id identifier rubyid_path'>path</span><span class='comma'>,</span> <span class='id identifier rubyid_tests'>tests</span><span class='rparen'>)</span>
671
- <span class='id identifier rubyid_path'>path</span> <span class='op'>=</span> <span class='id identifier rubyid_path'>path</span><span class='period'>.</span><span class='id identifier rubyid_ensure_string'>ensure_string</span>
672
-
673
- <span class='id identifier rubyid_tests'>tests</span><span class='period'>.</span><span class='id identifier rubyid_ensure_array'>ensure_array</span><span class='period'>.</span><span class='id identifier rubyid_all?'>all?</span> <span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_test'>test</span><span class='op'>|</span>
674
- <span class='comment'># Adjust test name
675
- </span> <span class='id identifier rubyid_test'>test</span> <span class='op'>=</span> <span class='id identifier rubyid_test'>test</span><span class='period'>.</span><span class='id identifier rubyid_ensure_string'>ensure_string</span><span class='period'>.</span><span class='id identifier rubyid_strip'>strip</span>
676
-
677
- <span class='id identifier rubyid_test'>test</span> <span class='op'>=</span> <span class='kw'>case</span> <span class='id identifier rubyid_test'>test</span>
678
- <span class='kw'>when</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>read</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>then</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>readable</span><span class='tstring_end'>&quot;</span></span>
679
- <span class='kw'>when</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>write</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>then</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>writable</span><span class='tstring_end'>&quot;</span></span>
680
- <span class='kw'>when</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>execute</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>exec</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>then</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>executable</span><span class='tstring_end'>&quot;</span></span>
681
- <span class='kw'>when</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>dir</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>then</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>directory</span><span class='tstring_end'>&quot;</span></span>
682
- <span class='kw'>else</span> <span class='id identifier rubyid_test'>test</span>
683
- <span class='kw'>end</span>
684
-
685
- <span class='comment'># Execute test
686
- </span> <span class='id identifier rubyid_test'>test</span> <span class='op'>+=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>?</span><span class='tstring_end'>&quot;</span></span> <span class='kw'>if</span> <span class='id identifier rubyid_test'>test</span> <span class='op'>!~</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>\?$</span><span class='regexp_end'>/</span></span>
687
- <span class='const'>FileTest</span><span class='period'>.</span><span class='id identifier rubyid_respond_to?'>respond_to?</span><span class='lparen'>(</span><span class='id identifier rubyid_test'>test</span><span class='rparen'>)</span> <span class='op'>?</span> <span class='const'>FileTest</span><span class='period'>.</span><span class='id identifier rubyid_send'>send</span><span class='lparen'>(</span><span class='id identifier rubyid_test'>test</span><span class='comma'>,</span> <span class='id identifier rubyid_path'>path</span><span class='rparen'>)</span> <span class='op'>:</span> <span class='kw'>nil</span>
688
- <span class='rbrace'>}</span>
689
- <span class='kw'>end</span></pre>
690
- </td>
691
- </tr>
692
- </table>
693
- </div>
694
-
695
- <div class="method_details ">
696
- <h3 class="signature " id="copy-instance_method">
697
-
698
- - (<tt>Boolean</tt>) <strong>copy</strong>(src, dst, run = true, show_errors = false, fatal = true)
699
-
700
-
701
-
702
-
703
-
704
- </h3><div class="docstring">
705
- <div class="discussion">
706
- <p>Copies a set of files or directory to another location.</p>
441
+ <pre class="code"><span class="info file"># File 'lib/bovem/shell.rb', line 554</span>
707
442
 
708
-
709
- </div>
710
- </div>
711
- <div class="tags">
712
- <p class="tag_title">Parameters:</p>
713
- <ul class="param">
714
-
715
- <li>
716
-
717
- <span class='name'>src</span>
718
-
719
-
720
- <span class='type'>(<tt>String|Array</tt>)</span>
721
-
722
-
723
-
724
- &mdash;
725
- <div class='inline'><p>The entries to copy. If is an Array, <code>dst</code> is assumed to be a directory.</p>
726
- </div>
727
-
728
- </li>
729
-
730
- <li>
731
-
732
- <span class='name'>dst</span>
733
-
734
-
735
- <span class='type'>(<tt>String</tt>)</span>
736
-
737
-
738
-
739
- &mdash;
740
- <div class='inline'><p>The destination. <strong>Any existing entries will be overwritten.</strong> Any required directory will be created.</p>
741
- </div>
742
-
743
- </li>
744
-
745
- <li>
746
-
747
- <span class='name'>run</span>
748
-
749
-
750
- <span class='type'>(<tt>Boolean</tt>)</span>
751
-
752
-
753
- <em class="default">(defaults to: <tt>true</tt>)</em>
754
-
755
-
756
- &mdash;
757
- <div class='inline'><p>If <code>false</code>, it will just print a list of message that would be copied or moved.</p>
758
- </div>
759
-
760
- </li>
761
-
762
- <li>
763
-
764
- <span class='name'>show_errors</span>
765
-
766
-
767
- <span class='type'>(<tt>Boolean</tt>)</span>
768
-
769
-
770
- <em class="default">(defaults to: <tt>false</tt>)</em>
771
-
772
-
773
- &mdash;
774
- <div class='inline'><p>If show errors.</p>
775
- </div>
776
-
777
- </li>
778
-
779
- <li>
780
-
781
- <span class='name'>fatal</span>
782
-
783
-
784
- <span class='type'>(<tt>Boolean</tt>)</span>
785
-
786
-
787
- <em class="default">(defaults to: <tt>true</tt>)</em>
788
-
789
-
790
- &mdash;
791
- <div class='inline'><p>If quit in case of fatal errors.</p>
792
- </div>
793
-
794
- </li>
795
-
796
- </ul>
797
-
798
- <p class="tag_title">Returns:</p>
799
- <ul class="return">
800
-
801
- <li>
802
-
803
-
804
- <span class='type'>(<tt>Boolean</tt>)</span>
805
-
806
-
807
-
808
- &mdash;
809
- <div class='inline'><p><code>true</code> if operation succeeded, <code>false</code> otherwise.</p>
810
- </div>
811
-
812
- </li>
813
-
814
- </ul>
815
-
816
- </div><table class="source_code">
817
- <tr>
818
- <td>
819
- <pre class="lines">
820
-
821
-
822
- 238
823
- 239
824
- 240</pre>
825
- </td>
826
- <td>
827
- <pre class="code"><span class="info file"># File 'lib/bovem/shell.rb', line 238</span>
828
-
829
- <span class='kw'>def</span> <span class='id identifier rubyid_copy'>copy</span><span class='lparen'>(</span><span class='id identifier rubyid_src'>src</span><span class='comma'>,</span> <span class='id identifier rubyid_dst'>dst</span><span class='comma'>,</span> <span class='id identifier rubyid_run'>run</span> <span class='op'>=</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='id identifier rubyid_show_errors'>show_errors</span> <span class='op'>=</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='id identifier rubyid_fatal'>fatal</span> <span class='op'>=</span> <span class='kw'>true</span><span class='rparen'>)</span>
830
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_copy_or_move'>copy_or_move</span><span class='lparen'>(</span><span class='id identifier rubyid_src'>src</span><span class='comma'>,</span> <span class='id identifier rubyid_dst'>dst</span><span class='comma'>,</span> <span class='symbol'>:copy</span><span class='comma'>,</span> <span class='id identifier rubyid_run'>run</span><span class='comma'>,</span> <span class='id identifier rubyid_show_errors'>show_errors</span><span class='comma'>,</span> <span class='id identifier rubyid_fatal'>fatal</span><span class='rparen'>)</span>
831
- <span class='kw'>end</span></pre>
832
- </td>
833
- </tr>
834
- </table>
835
- </div>
836
-
837
- <div class="method_details ">
838
- <h3 class="signature " id="copy_or_move-instance_method">
839
-
840
- - (<tt>Boolean</tt>) <strong>copy_or_move</strong>(src, dst, operation, run = true, show_errors = false, fatal = true)
841
-
842
-
843
-
844
-
845
-
846
- </h3><div class="docstring">
847
- <div class="discussion">
848
- <p>Copies or moves a set of files or directory to another location.</p>
849
-
850
-
851
- </div>
852
- </div>
853
- <div class="tags">
854
- <p class="tag_title">Parameters:</p>
855
- <ul class="param">
856
-
857
- <li>
858
-
859
- <span class='name'>src</span>
860
-
861
-
862
- <span class='type'>(<tt>String|Array</tt>)</span>
863
-
864
-
865
-
866
- &mdash;
867
- <div class='inline'><p>The entries to copy or move. If is an Array, <code>dst</code> is assumed to be a directory.</p>
868
- </div>
869
-
870
- </li>
871
-
872
- <li>
873
-
874
- <span class='name'>dst</span>
875
-
876
-
877
- <span class='type'>(<tt>String</tt>)</span>
878
-
879
-
880
-
881
- &mdash;
882
- <div class='inline'><p>The destination. <strong>Any existing entries will be overwritten.</strong> Any required directory will be created.</p>
883
- </div>
884
-
885
- </li>
886
-
887
- <li>
888
-
889
- <span class='name'>operation</span>
890
-
891
-
892
- <span class='type'>(<tt>Symbol</tt>)</span>
893
-
894
-
895
-
896
- &mdash;
897
- <div class='inline'><p>The operation to perform. Valid values are <code>:copy</code> or <code>:move</code>.</p>
898
- </div>
899
-
900
- </li>
901
-
902
- <li>
903
-
904
- <span class='name'>run</span>
905
-
906
-
907
- <span class='type'>(<tt>Boolean</tt>)</span>
908
-
909
-
910
- <em class="default">(defaults to: <tt>true</tt>)</em>
911
-
912
-
913
- &mdash;
914
- <div class='inline'><p>If <code>false</code>, it will just print a list of message that would be copied or moved.</p>
915
- </div>
916
-
917
- </li>
918
-
919
- <li>
920
-
921
- <span class='name'>show_errors</span>
922
-
923
-
924
- <span class='type'>(<tt>Boolean</tt>)</span>
925
-
926
-
927
- <em class="default">(defaults to: <tt>false</tt>)</em>
928
-
929
-
930
- &mdash;
931
- <div class='inline'><p>If show errors.</p>
932
- </div>
933
-
934
- </li>
935
-
936
- <li>
937
-
938
- <span class='name'>fatal</span>
939
-
940
-
941
- <span class='type'>(<tt>Boolean</tt>)</span>
942
-
943
-
944
- <em class="default">(defaults to: <tt>true</tt>)</em>
945
-
946
-
947
- &mdash;
948
- <div class='inline'><p>If quit in case of fatal errors.</p>
949
- </div>
950
-
951
- </li>
952
-
953
- </ul>
954
-
955
- <p class="tag_title">Returns:</p>
956
- <ul class="return">
957
-
958
- <li>
959
-
960
-
961
- <span class='type'>(<tt>Boolean</tt>)</span>
962
-
963
-
964
-
965
- &mdash;
966
- <div class='inline'><p><code>true</code> if operation succeeded, <code>false</code> otherwise.</p>
967
- </div>
968
-
969
- </li>
970
-
971
- </ul>
972
-
973
- </div><table class="source_code">
974
- <tr>
975
- <td>
976
- <pre class="lines">
977
-
978
-
979
- 146
980
- 147
981
- 148
982
- 149
983
- 150
984
- 151
985
- 152
986
- 153
987
- 154
988
- 155
989
- 156
990
- 157
991
- 158
992
- 159
993
- 160
994
- 161
995
- 162
996
- 163
997
- 164
998
- 165
999
- 166
1000
- 167
1001
- 168
1002
- 169
1003
- 170
1004
- 171
1005
- 172
1006
- 173
1007
- 174
1008
- 175
1009
- 176
1010
- 177
1011
- 178
1012
- 179
1013
- 180
1014
- 181
1015
- 182
1016
- 183
1017
- 184
1018
- 185
1019
- 186
1020
- 187
1021
- 188
1022
- 189
1023
- 190
1024
- 191
1025
- 192
1026
- 193
1027
- 194
1028
- 195
1029
- 196
1030
- 197
1031
- 198
1032
- 199
1033
- 200
1034
- 201
1035
- 202
1036
- 203
1037
- 204
1038
- 205
1039
- 206
1040
- 207
1041
- 208
1042
- 209
1043
- 210
1044
- 211
1045
- 212
1046
- 213
1047
- 214
1048
- 215
1049
- 216
1050
- 217
1051
- 218
1052
- 219
1053
- 220
1054
- 221
1055
- 222
1056
- 223
1057
- 224
1058
- 225
1059
- 226
1060
- 227
1061
- 228</pre>
1062
- </td>
1063
- <td>
1064
- <pre class="code"><span class="info file"># File 'lib/bovem/shell.rb', line 146</span>
1065
-
1066
- <span class='kw'>def</span> <span class='id identifier rubyid_copy_or_move'>copy_or_move</span><span class='lparen'>(</span><span class='id identifier rubyid_src'>src</span><span class='comma'>,</span> <span class='id identifier rubyid_dst'>dst</span><span class='comma'>,</span> <span class='id identifier rubyid_operation'>operation</span><span class='comma'>,</span> <span class='id identifier rubyid_run'>run</span> <span class='op'>=</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='id identifier rubyid_show_errors'>show_errors</span> <span class='op'>=</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='id identifier rubyid_fatal'>fatal</span> <span class='op'>=</span> <span class='kw'>true</span><span class='rparen'>)</span>
1067
- <span class='id identifier rubyid_rv'>rv</span> <span class='op'>=</span> <span class='kw'>true</span>
1068
- <span class='id identifier rubyid_operation'>operation</span> <span class='op'>=</span> <span class='symbol'>:copy</span> <span class='kw'>if</span> <span class='id identifier rubyid_operation'>operation</span> <span class='op'>!=</span> <span class='symbol'>:move</span>
1069
- <span class='id identifier rubyid_single'>single</span> <span class='op'>=</span> <span class='op'>!</span><span class='id identifier rubyid_src'>src</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span><span class='lparen'>(</span><span class='const'>Array</span><span class='rparen'>)</span>
1070
-
1071
- <span class='kw'>if</span> <span class='id identifier rubyid_single'>single</span> <span class='kw'>then</span>
1072
- <span class='id identifier rubyid_src'>src</span> <span class='op'>=</span> <span class='const'>File</span><span class='period'>.</span><span class='id identifier rubyid_expand_path'>expand_path</span><span class='lparen'>(</span><span class='id identifier rubyid_src'>src</span><span class='rparen'>)</span>
1073
- <span class='kw'>else</span>
1074
- <span class='id identifier rubyid_src'>src</span> <span class='op'>=</span> <span class='id identifier rubyid_src'>src</span><span class='period'>.</span><span class='id identifier rubyid_collect'>collect</span> <span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_s'>s</span><span class='op'>|</span> <span class='const'>File</span><span class='period'>.</span><span class='id identifier rubyid_expand_path'>expand_path</span><span class='lparen'>(</span><span class='id identifier rubyid_s'>s</span><span class='rparen'>)</span> <span class='rbrace'>}</span>
1075
- <span class='kw'>end</span>
1076
-
1077
- <span class='id identifier rubyid_dst'>dst</span> <span class='op'>=</span> <span class='const'>File</span><span class='period'>.</span><span class='id identifier rubyid_expand_path'>expand_path</span><span class='lparen'>(</span><span class='id identifier rubyid_dst'>dst</span><span class='period'>.</span><span class='id identifier rubyid_ensure_string'>ensure_string</span><span class='rparen'>)</span>
1078
-
1079
- <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_run'>run</span> <span class='kw'>then</span>
1080
- <span class='kw'>if</span> <span class='id identifier rubyid_single'>single</span> <span class='kw'>then</span>
1081
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_warn'>warn</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Will </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_operation'>operation</span><span class='rbrace'>}</span><span class='tstring_content'> a file:</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1082
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>From: {mark=bright}</span><span class='embexpr_beg'>#{</span><span class='const'>File</span><span class='period'>.</span><span class='id identifier rubyid_expand_path'>expand_path</span><span class='lparen'>(</span><span class='id identifier rubyid_src'>src</span><span class='period'>.</span><span class='id identifier rubyid_ensure_string'>ensure_string</span><span class='rparen'>)</span><span class='rbrace'>}</span><span class='tstring_content'>{/mark}</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\n</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='int'>11</span><span class='rparen'>)</span>
1083
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>To: {mark=bright}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_dst'>dst</span><span class='rbrace'>}</span><span class='tstring_content'>{/mark}</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\n</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='int'>11</span><span class='rparen'>)</span>
1084
- <span class='kw'>else</span>
1085
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_warn'>warn</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Will </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_operation'>operation</span><span class='rbrace'>}</span><span class='tstring_content'> following entries:</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1086
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_with_indentation'>with_indentation</span><span class='lparen'>(</span><span class='int'>11</span><span class='rparen'>)</span> <span class='kw'>do</span>
1087
- <span class='id identifier rubyid_src'>src</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_s'>s</span><span class='op'>|</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='id identifier rubyid_s'>s</span><span class='rparen'>)</span> <span class='kw'>end</span>
1088
- <span class='kw'>end</span>
1089
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>to directory: {mark=bright}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_dst'>dst</span><span class='rbrace'>}</span><span class='tstring_content'>{/mark}</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\n</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='int'>5</span><span class='rparen'>)</span>
1090
- <span class='kw'>end</span>
1091
- <span class='kw'>else</span>
1092
- <span class='id identifier rubyid_rv'>rv</span> <span class='op'>=</span> <span class='id identifier rubyid_catch'>catch</span><span class='lparen'>(</span><span class='symbol'>:rv</span><span class='rparen'>)</span> <span class='kw'>do</span>
1093
- <span class='id identifier rubyid_dst_dir'>dst_dir</span> <span class='op'>=</span> <span class='id identifier rubyid_single'>single</span> <span class='op'>?</span> <span class='const'>File</span><span class='period'>.</span><span class='id identifier rubyid_dirname'>dirname</span><span class='lparen'>(</span><span class='id identifier rubyid_dst'>dst</span><span class='rparen'>)</span> <span class='op'>:</span> <span class='id identifier rubyid_dst'>dst</span>
1094
- <span class='id identifier rubyid_has_dir'>has_dir</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_check'>check</span><span class='lparen'>(</span><span class='id identifier rubyid_dst_dir'>dst_dir</span><span class='comma'>,</span> <span class='symbol'>:dir</span><span class='rparen'>)</span>
1095
-
1096
- <span class='comment'># Create directory
1097
- </span> <span class='id identifier rubyid_has_dir'>has_dir</span> <span class='op'>=</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_create_directories'>create_directories</span><span class='lparen'>(</span><span class='id identifier rubyid_dst_dir'>dst_dir</span><span class='comma'>,</span> <span class='int'>0755</span><span class='comma'>,</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='id identifier rubyid_show_errors'>show_errors</span><span class='comma'>,</span> <span class='id identifier rubyid_fatal'>fatal</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_has_dir'>has_dir</span>
1098
- <span class='id identifier rubyid_throw'>throw</span><span class='lparen'>(</span><span class='symbol'>:rv</span><span class='comma'>,</span> <span class='kw'>false</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_has_dir'>has_dir</span>
1099
-
1100
- <span class='kw'>if</span> <span class='id identifier rubyid_single'>single</span> <span class='op'>&amp;&amp;</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_check'>check</span><span class='lparen'>(</span><span class='id identifier rubyid_dst'>dst</span><span class='comma'>,</span> <span class='symbol'>:dir</span><span class='rparen'>)</span> <span class='kw'>then</span>
1101
- <span class='ivar'>@console</span><span class='period'>.</span><span class='id identifier rubyid_send'>send</span><span class='lparen'>(</span><span class='id identifier rubyid_fatal'>fatal</span> <span class='op'>?</span> <span class='symbol'>:fatal</span> <span class='op'>:</span> <span class='symbol'>:error</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Cannot </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_operation'>operation</span><span class='rbrace'>}</span><span class='tstring_content'> file {mark=bright}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_src'>src</span><span class='rbrace'>}</span><span class='tstring_content'>{/mark} to {mark=bright}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_dst'>dst</span><span class='rbrace'>}</span><span class='tstring_content'>{/mark} because it is currently a directory.</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1102
- <span class='id identifier rubyid_throw'>throw</span><span class='lparen'>(</span><span class='symbol'>:rv</span><span class='comma'>,</span> <span class='kw'>false</span><span class='rparen'>)</span>
1103
- <span class='kw'>end</span>
1104
-
1105
- <span class='comment'># Check that every file is existing
1106
- </span> <span class='id identifier rubyid_src'>src</span><span class='period'>.</span><span class='id identifier rubyid_ensure_array'>ensure_array</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_s'>s</span><span class='op'>|</span>
1107
- <span class='kw'>if</span> <span class='op'>!</span><span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_check'>check</span><span class='lparen'>(</span><span class='id identifier rubyid_s'>s</span><span class='comma'>,</span> <span class='symbol'>:exists</span><span class='rparen'>)</span> <span class='kw'>then</span>
1108
- <span class='ivar'>@console</span><span class='period'>.</span><span class='id identifier rubyid_send'>send</span><span class='lparen'>(</span><span class='id identifier rubyid_fatal'>fatal</span> <span class='op'>?</span> <span class='symbol'>:fatal</span> <span class='op'>:</span> <span class='symbol'>:error</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Cannot </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_operation'>operation</span><span class='rbrace'>}</span><span class='tstring_content'> non existent file {mark=bright}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_s'>s</span><span class='rbrace'>}</span><span class='tstring_content'>{/mark}.</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1109
- <span class='id identifier rubyid_throw'>throw</span><span class='lparen'>(</span><span class='symbol'>:rv</span><span class='comma'>,</span> <span class='kw'>false</span><span class='rparen'>)</span>
1110
- <span class='kw'>end</span>
1111
- <span class='kw'>end</span>
1112
-
1113
- <span class='comment'># Do operation
1114
- </span> <span class='kw'>begin</span>
1115
- <span class='const'>FileUtils</span><span class='period'>.</span><span class='id identifier rubyid_send'>send</span><span class='lparen'>(</span><span class='id identifier rubyid_operation'>operation</span> <span class='op'>==</span> <span class='symbol'>:move</span> <span class='op'>?</span> <span class='symbol'>:mv</span> <span class='op'>:</span> <span class='symbol'>:cp_r</span><span class='comma'>,</span> <span class='id identifier rubyid_src'>src</span><span class='comma'>,</span> <span class='id identifier rubyid_dst'>dst</span><span class='comma'>,</span> <span class='lbrace'>{</span><span class='symbol'>:noop</span> <span class='op'>=&gt;</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='symbol'>:verbose</span> <span class='op'>=&gt;</span> <span class='kw'>false</span><span class='rbrace'>}</span><span class='rparen'>)</span>
1116
- <span class='kw'>rescue</span> <span class='const'>Errno</span><span class='op'>::</span><span class='const'>EACCES</span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_e'>e</span>
1117
- <span class='kw'>if</span> <span class='id identifier rubyid_single'>single</span> <span class='kw'>then</span>
1118
- <span class='ivar'>@console</span><span class='period'>.</span><span class='id identifier rubyid_send'>send</span><span class='lparen'>(</span><span class='id identifier rubyid_fatal'>fatal</span> <span class='op'>?</span> <span class='symbol'>:fatal</span> <span class='op'>:</span> <span class='symbol'>:error</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Cannot </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_operation'>operation</span><span class='rbrace'>}</span><span class='tstring_content'> file {mark=bright}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_src'>src</span><span class='rbrace'>}</span><span class='tstring_content'>{/mark} to non writable directory {mark=bright}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_dst_dir'>dst_dir</span><span class='rbrace'>}</span><span class='tstring_content'>{/mark}.</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1119
- <span class='kw'>else</span>
1120
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_error'>error</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Cannot </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_operation'>operation</span><span class='rbrace'>}</span><span class='tstring_content'> following file(s) to non writable directory {mark=bright}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_dst'>dst</span><span class='rbrace'>}</span><span class='tstring_content'>{/mark}:</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1121
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_with_indentation'>with_indentation</span><span class='lparen'>(</span><span class='int'>11</span><span class='rparen'>)</span> <span class='kw'>do</span>
1122
- <span class='id identifier rubyid_src'>src</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_s'>s</span><span class='op'>|</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='id identifier rubyid_s'>s</span><span class='rparen'>)</span> <span class='kw'>end</span>
1123
- <span class='kw'>end</span>
1124
- <span class='const'>Kernel</span><span class='period'>.</span><span class='id identifier rubyid_exit'>exit</span><span class='lparen'>(</span><span class='op'>-</span><span class='int'>1</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_fatal'>fatal</span>
1125
- <span class='kw'>end</span>
1126
-
1127
- <span class='id identifier rubyid_throw'>throw</span><span class='lparen'>(</span><span class='symbol'>:rv</span><span class='comma'>,</span> <span class='kw'>false</span><span class='rparen'>)</span>
1128
- <span class='kw'>rescue</span> <span class='const'>Exception</span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_e'>e</span>
1129
- <span class='kw'>if</span> <span class='id identifier rubyid_single'>single</span> <span class='kw'>then</span>
1130
- <span class='ivar'>@console</span><span class='period'>.</span><span class='id identifier rubyid_send'>send</span><span class='lparen'>(</span><span class='id identifier rubyid_fatal'>fatal</span> <span class='op'>?</span> <span class='symbol'>:fatal</span> <span class='op'>:</span> <span class='symbol'>:error</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Cannot </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_operation'>operation</span><span class='rbrace'>}</span><span class='tstring_content'> file {mark=bright}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_src'>src</span><span class='rbrace'>}</span><span class='tstring_content'>{/mark} to directory {mark=bright}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_dst_dir'>dst_dir</span><span class='rbrace'>}</span><span class='tstring_content'>{/mark} due to this error: [</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_e'>e</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='rbrace'>}</span><span class='tstring_content'>] </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_e'>e</span><span class='rbrace'>}</span><span class='tstring_content'>.</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\n</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='int'>5</span><span class='rparen'>)</span>
1131
- <span class='kw'>else</span>
1132
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_error'>error</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Cannot </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_operation'>operation</span><span class='rbrace'>}</span><span class='tstring_content'> following entries to {mark=bright}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_dst'>dst</span><span class='rbrace'>}</span><span class='tstring_content'>{/mark}:</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1133
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_with_indentation'>with_indentation</span><span class='lparen'>(</span><span class='int'>11</span><span class='rparen'>)</span> <span class='kw'>do</span>
1134
- <span class='id identifier rubyid_src'>src</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_s'>s</span><span class='op'>|</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='id identifier rubyid_s'>s</span><span class='rparen'>)</span> <span class='kw'>end</span>
1135
- <span class='kw'>end</span>
1136
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>due to this error: [</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_e'>e</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='rbrace'>}</span><span class='tstring_content'>] </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_e'>e</span><span class='rbrace'>}</span><span class='tstring_content'>.</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\n</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='int'>5</span><span class='rparen'>)</span>
1137
- <span class='const'>Kernel</span><span class='period'>.</span><span class='id identifier rubyid_exit'>exit</span><span class='lparen'>(</span><span class='op'>-</span><span class='int'>1</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_fatal'>fatal</span>
1138
- <span class='kw'>end</span>
1139
-
1140
- <span class='id identifier rubyid_throw'>throw</span><span class='lparen'>(</span><span class='symbol'>:rv</span><span class='comma'>,</span> <span class='kw'>false</span><span class='rparen'>)</span>
1141
- <span class='kw'>end</span>
1142
-
1143
- <span class='kw'>true</span>
1144
- <span class='kw'>end</span>
1145
- <span class='kw'>end</span>
1146
-
1147
- <span class='id identifier rubyid_rv'>rv</span>
1148
- <span class='kw'>end</span></pre>
1149
- </td>
1150
- </tr>
1151
- </table>
1152
- </div>
1153
-
1154
- <div class="method_details ">
1155
- <h3 class="signature " id="create_directories-instance_method">
1156
-
1157
- - (<tt>Boolean</tt>) <strong>create_directories</strong>(directories, mode = 0755, run = true, show_errors = false, fatal = true)
1158
-
1159
-
1160
-
1161
-
1162
-
1163
- </h3><div class="docstring">
1164
- <div class="discussion">
1165
- <p>Creates a list of directories, included missing parent directories.</p>
1166
-
1167
-
1168
- </div>
1169
- </div>
1170
- <div class="tags">
1171
- <p class="tag_title">Parameters:</p>
1172
- <ul class="param">
1173
-
1174
- <li>
1175
-
1176
- <span class='name'>directories</span>
1177
-
1178
-
1179
- <span class='type'>(<tt>Array</tt>)</span>
1180
-
1181
-
1182
-
1183
- &mdash;
1184
- <div class='inline'><p>The list of directories to create.</p>
1185
- </div>
1186
-
1187
- </li>
1188
-
1189
- <li>
1190
-
1191
- <span class='name'>mode</span>
1192
-
1193
-
1194
- <span class='type'>(<tt>Fixnum</tt>)</span>
1195
-
1196
-
1197
- <em class="default">(defaults to: <tt>0755</tt>)</em>
1198
-
1199
-
1200
- &mdash;
1201
- <div class='inline'><p>Initial permissions for the new directories.</p>
1202
- </div>
1203
-
1204
- </li>
1205
-
1206
- <li>
1207
-
1208
- <span class='name'>run</span>
1209
-
1210
-
1211
- <span class='type'>(<tt>Boolean</tt>)</span>
1212
-
1213
-
1214
- <em class="default">(defaults to: <tt>true</tt>)</em>
1215
-
1216
-
1217
- &mdash;
1218
- <div class='inline'><p>If <code>false</code>, it will just print a list of directories that would be created.</p>
1219
- </div>
1220
-
1221
- </li>
1222
-
1223
- <li>
1224
-
1225
- <span class='name'>show_errors</span>
1226
-
1227
-
1228
- <span class='type'>(<tt>Boolean</tt>)</span>
1229
-
1230
-
1231
- <em class="default">(defaults to: <tt>false</tt>)</em>
1232
-
1233
-
1234
- &mdash;
1235
- <div class='inline'><p>If show errors.</p>
1236
- </div>
1237
-
1238
- </li>
1239
-
1240
- <li>
1241
-
1242
- <span class='name'>fatal</span>
1243
-
1244
-
1245
- <span class='type'>(<tt>Boolean</tt>)</span>
1246
-
1247
-
1248
- <em class="default">(defaults to: <tt>true</tt>)</em>
1249
-
1250
-
1251
- &mdash;
1252
- <div class='inline'><p>If quit in case of fatal errors.</p>
1253
- </div>
1254
-
1255
- </li>
1256
-
1257
- </ul>
1258
-
1259
- <p class="tag_title">Returns:</p>
1260
- <ul class="return">
1261
-
1262
- <li>
1263
-
1264
-
1265
- <span class='type'>(<tt>Boolean</tt>)</span>
1266
-
1267
-
1268
-
1269
- &mdash;
1270
- <div class='inline'><p><code>true</code> if operation succeeded, <code>false</code> otherwise.</p>
1271
- </div>
1272
-
1273
- </li>
1274
-
1275
- </ul>
1276
-
1277
- </div><table class="source_code">
1278
- <tr>
1279
- <td>
1280
- <pre class="lines">
1281
-
1282
-
1283
- 296
1284
- 297
1285
- 298
1286
- 299
1287
- 300
1288
- 301
1289
- 302
1290
- 303
1291
- 304
1292
- 305
1293
- 306
1294
- 307
1295
- 308
1296
- 309
1297
- 310
1298
- 311
1299
- 312
1300
- 313
1301
- 314
1302
- 315
1303
- 316
1304
- 317
1305
- 318
1306
- 319
1307
- 320
1308
- 321
1309
- 322
1310
- 323
1311
- 324
1312
- 325
1313
- 326
1314
- 327
1315
- 328
1316
- 329
1317
- 330
1318
- 331
1319
- 332
1320
- 333
1321
- 334
1322
- 335
1323
- 336
1324
- 337
1325
- 338
1326
- 339
1327
- 340
1328
- 341</pre>
1329
- </td>
1330
- <td>
1331
- <pre class="code"><span class="info file"># File 'lib/bovem/shell.rb', line 296</span>
1332
-
1333
- <span class='kw'>def</span> <span class='id identifier rubyid_create_directories'>create_directories</span><span class='lparen'>(</span><span class='id identifier rubyid_directories'>directories</span><span class='comma'>,</span> <span class='id identifier rubyid_mode'>mode</span> <span class='op'>=</span> <span class='int'>0755</span><span class='comma'>,</span> <span class='id identifier rubyid_run'>run</span> <span class='op'>=</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='id identifier rubyid_show_errors'>show_errors</span> <span class='op'>=</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='id identifier rubyid_fatal'>fatal</span> <span class='op'>=</span> <span class='kw'>true</span><span class='rparen'>)</span>
1334
- <span class='id identifier rubyid_rv'>rv</span> <span class='op'>=</span> <span class='kw'>true</span>
1335
-
1336
- <span class='comment'># Adjust directory
1337
- </span> <span class='id identifier rubyid_directories'>directories</span> <span class='op'>=</span> <span class='id identifier rubyid_directories'>directories</span><span class='period'>.</span><span class='id identifier rubyid_ensure_array'>ensure_array</span><span class='period'>.</span><span class='id identifier rubyid_compact'>compact</span> <span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_d'>d</span><span class='op'>|</span> <span class='const'>File</span><span class='period'>.</span><span class='id identifier rubyid_expand_path'>expand_path</span><span class='lparen'>(</span><span class='id identifier rubyid_d'>d</span><span class='period'>.</span><span class='id identifier rubyid_ensure_string'>ensure_string</span><span class='rparen'>)</span> <span class='rbrace'>}</span>
1338
-
1339
- <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_run'>run</span> <span class='kw'>then</span> <span class='comment'># Just print
1340
- </span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_warn'>warn</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Will create directories:</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1341
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_with_indentation'>with_indentation</span><span class='lparen'>(</span><span class='int'>11</span><span class='rparen'>)</span> <span class='kw'>do</span>
1342
- <span class='id identifier rubyid_directories'>directories</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_directory'>directory</span><span class='op'>|</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='id identifier rubyid_directory'>directory</span><span class='rparen'>)</span> <span class='kw'>end</span>
1343
- <span class='kw'>end</span>
1344
- <span class='kw'>else</span>
1345
- <span class='id identifier rubyid_directories'>directories</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_directory'>directory</span><span class='op'>|</span>
1346
- <span class='id identifier rubyid_rv'>rv</span> <span class='op'>=</span> <span class='id identifier rubyid_catch'>catch</span><span class='lparen'>(</span><span class='symbol'>:rv</span><span class='rparen'>)</span> <span class='kw'>do</span>
1347
- <span class='comment'># Perform tests
1348
- </span> <span class='kw'>if</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_check'>check</span><span class='lparen'>(</span><span class='id identifier rubyid_directory'>directory</span><span class='comma'>,</span> <span class='symbol'>:directory</span><span class='rparen'>)</span> <span class='kw'>then</span>
1349
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_send'>send</span><span class='lparen'>(</span><span class='id identifier rubyid_fatal'>fatal</span> <span class='op'>?</span> <span class='symbol'>:fatal</span> <span class='op'>:</span> <span class='symbol'>:error</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>The directory {mark=bright}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_directory'>directory</span><span class='rbrace'>}</span><span class='tstring_content'>{/mark} already exists.</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1350
- <span class='kw'>elsif</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_check'>check</span><span class='lparen'>(</span><span class='id identifier rubyid_directory'>directory</span><span class='comma'>,</span> <span class='symbol'>:exist</span><span class='rparen'>)</span> <span class='kw'>then</span>
1351
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_send'>send</span><span class='lparen'>(</span><span class='id identifier rubyid_fatal'>fatal</span> <span class='op'>?</span> <span class='symbol'>:fatal</span> <span class='op'>:</span> <span class='symbol'>:error</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Path {mark=bright}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_directory'>directory</span><span class='rbrace'>}</span><span class='tstring_content'>{/mark} is currently a file.</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1352
- <span class='kw'>else</span>
1353
- <span class='kw'>begin</span> <span class='comment'># Create directory
1354
- </span> <span class='const'>FileUtils</span><span class='period'>.</span><span class='id identifier rubyid_mkdir_p'>mkdir_p</span><span class='lparen'>(</span><span class='id identifier rubyid_directory'>directory</span><span class='comma'>,</span> <span class='lbrace'>{</span><span class='symbol'>:mode</span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_mode'>mode</span><span class='comma'>,</span> <span class='symbol'>:noop</span> <span class='op'>=&gt;</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='symbol'>:verbose</span> <span class='op'>=&gt;</span> <span class='kw'>false</span><span class='rbrace'>}</span><span class='rparen'>)</span>
1355
- <span class='id identifier rubyid_throw'>throw</span><span class='lparen'>(</span><span class='symbol'>:rv</span><span class='comma'>,</span> <span class='kw'>true</span><span class='rparen'>)</span>
1356
- <span class='kw'>rescue</span> <span class='const'>Errno</span><span class='op'>::</span><span class='const'>EACCES</span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_e'>e</span>
1357
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_send'>send</span><span class='lparen'>(</span><span class='id identifier rubyid_fatal'>fatal</span> <span class='op'>?</span> <span class='symbol'>:fatal</span> <span class='op'>:</span> <span class='symbol'>:error</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Cannot create following directory due to permission denied: {mark=bright}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_e'>e</span><span class='period'>.</span><span class='id identifier rubyid_message'>message</span><span class='period'>.</span><span class='id identifier rubyid_gsub'>gsub</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>.+ - (.+)</span><span class='regexp_end'>/</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\\1</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='rbrace'>}</span><span class='tstring_content'>{/mark}.</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1358
- <span class='kw'>rescue</span> <span class='const'>Exception</span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_e'>e</span>
1359
- <span class='kw'>if</span> <span class='id identifier rubyid_show_errors'>show_errors</span> <span class='kw'>then</span>
1360
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_error'>error</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Cannot create following directories:</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1361
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_with_indentation'>with_indentation</span><span class='lparen'>(</span><span class='int'>11</span><span class='rparen'>)</span> <span class='kw'>do</span>
1362
- <span class='id identifier rubyid_directories'>directories</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_directory'>directory</span><span class='op'>|</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='id identifier rubyid_directory'>directory</span><span class='rparen'>)</span> <span class='kw'>end</span>
1363
- <span class='kw'>end</span>
1364
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>due to this error: [</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_e'>e</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='rbrace'>}</span><span class='tstring_content'>] </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_e'>e</span><span class='rbrace'>}</span><span class='tstring_content'>.</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\n</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='int'>5</span><span class='rparen'>)</span>
1365
- <span class='const'>Kernel</span><span class='period'>.</span><span class='id identifier rubyid_exit'>exit</span><span class='lparen'>(</span><span class='op'>-</span><span class='int'>1</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_fatal'>fatal</span>
1366
- <span class='kw'>end</span>
1367
- <span class='kw'>end</span>
1368
- <span class='kw'>end</span>
1369
-
1370
- <span class='kw'>false</span>
1371
- <span class='kw'>end</span>
1372
-
1373
- <span class='kw'>break</span> <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_rv'>rv</span>
1374
- <span class='kw'>end</span>
1375
- <span class='kw'>end</span>
1376
-
1377
- <span class='id identifier rubyid_rv'>rv</span>
1378
- <span class='kw'>end</span></pre>
1379
- </td>
1380
- </tr>
1381
- </table>
1382
- </div>
1383
-
1384
- <div class="method_details ">
1385
- <h3 class="signature " id="delete-instance_method">
1386
-
1387
- - (<tt>Boolean</tt>) <strong>delete</strong>(files, run = true, show_errors = false, fatal = true)
1388
-
1389
-
1390
-
1391
-
1392
-
1393
- </h3><div class="docstring">
1394
- <div class="discussion">
1395
- <p>Deletes a list of files.</p>
1396
-
1397
-
1398
- </div>
1399
- </div>
1400
- <div class="tags">
1401
- <p class="tag_title">Parameters:</p>
1402
- <ul class="param">
1403
-
1404
- <li>
1405
-
1406
- <span class='name'>files</span>
1407
-
1408
-
1409
- <span class='type'>(<tt>Array</tt>)</span>
1410
-
1411
-
1412
-
1413
- &mdash;
1414
- <div class='inline'><p>The list of files to remove</p>
1415
- </div>
1416
-
1417
- </li>
1418
-
1419
- <li>
1420
-
1421
- <span class='name'>run</span>
1422
-
1423
-
1424
- <span class='type'>(<tt>Boolean</tt>)</span>
1425
-
1426
-
1427
- <em class="default">(defaults to: <tt>true</tt>)</em>
1428
-
1429
-
1430
- &mdash;
1431
- <div class='inline'><p>If <code>false</code>, it will just print a list of message that would be deleted.</p>
1432
- </div>
1433
-
1434
- </li>
1435
-
1436
- <li>
1437
-
1438
- <span class='name'>show_errors</span>
1439
-
1440
-
1441
- <span class='type'>(<tt>Boolean</tt>)</span>
1442
-
1443
-
1444
- <em class="default">(defaults to: <tt>false</tt>)</em>
1445
-
1446
-
1447
- &mdash;
1448
- <div class='inline'><p>If show errors.</p>
1449
- </div>
1450
-
1451
- </li>
1452
-
1453
- <li>
1454
-
1455
- <span class='name'>fatal</span>
1456
-
1457
-
1458
- <span class='type'>(<tt>Boolean</tt>)</span>
1459
-
1460
-
1461
- <em class="default">(defaults to: <tt>true</tt>)</em>
1462
-
1463
-
1464
- &mdash;
1465
- <div class='inline'><p>If quit in case of fatal errors.</p>
1466
- </div>
1467
-
1468
- </li>
1469
-
1470
- </ul>
1471
-
1472
- <p class="tag_title">Returns:</p>
1473
- <ul class="return">
1474
-
1475
- <li>
1476
-
1477
-
1478
- <span class='type'>(<tt>Boolean</tt>)</span>
1479
-
1480
-
1481
-
1482
- &mdash;
1483
- <div class='inline'><p><code>true</code> if operation succeeded, <code>false</code> otherwise.</p>
1484
- </div>
1485
-
1486
- </li>
1487
-
1488
- </ul>
1489
-
1490
- </div><table class="source_code">
1491
- <tr>
1492
- <td>
1493
- <pre class="lines">
1494
-
1495
-
1496
- 101
1497
- 102
1498
- 103
1499
- 104
1500
- 105
1501
- 106
1502
- 107
1503
- 108
1504
- 109
1505
- 110
1506
- 111
1507
- 112
1508
- 113
1509
- 114
1510
- 115
1511
- 116
1512
- 117
1513
- 118
1514
- 119
1515
- 120
1516
- 121
1517
- 122
1518
- 123
1519
- 124
1520
- 125
1521
- 126
1522
- 127
1523
- 128
1524
- 129
1525
- 130
1526
- 131
1527
- 132
1528
- 133
1529
- 134
1530
- 135</pre>
1531
- </td>
1532
- <td>
1533
- <pre class="code"><span class="info file"># File 'lib/bovem/shell.rb', line 101</span>
1534
-
1535
- <span class='kw'>def</span> <span class='id identifier rubyid_delete'>delete</span><span class='lparen'>(</span><span class='id identifier rubyid_files'>files</span><span class='comma'>,</span> <span class='id identifier rubyid_run'>run</span> <span class='op'>=</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='id identifier rubyid_show_errors'>show_errors</span> <span class='op'>=</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='id identifier rubyid_fatal'>fatal</span> <span class='op'>=</span> <span class='kw'>true</span><span class='rparen'>)</span>
1536
- <span class='id identifier rubyid_rv'>rv</span> <span class='op'>=</span> <span class='kw'>true</span>
1537
- <span class='id identifier rubyid_files'>files</span> <span class='op'>=</span> <span class='id identifier rubyid_files'>files</span><span class='period'>.</span><span class='id identifier rubyid_ensure_array'>ensure_array</span><span class='period'>.</span><span class='id identifier rubyid_compact'>compact</span><span class='period'>.</span><span class='id identifier rubyid_collect'>collect</span> <span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_f'>f</span><span class='op'>|</span> <span class='const'>File</span><span class='period'>.</span><span class='id identifier rubyid_expand_path'>expand_path</span><span class='lparen'>(</span><span class='id identifier rubyid_f'>f</span><span class='period'>.</span><span class='id identifier rubyid_ensure_string'>ensure_string</span><span class='rparen'>)</span> <span class='rbrace'>}</span>
1538
-
1539
- <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_run'>run</span> <span class='kw'>then</span>
1540
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_warn'>warn</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Will remove file(s):</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1541
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_with_indentation'>with_indentation</span><span class='lparen'>(</span><span class='int'>11</span><span class='rparen'>)</span> <span class='kw'>do</span>
1542
- <span class='id identifier rubyid_files'>files</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_file'>file</span><span class='op'>|</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='id identifier rubyid_file'>file</span><span class='rparen'>)</span> <span class='kw'>end</span>
1543
- <span class='kw'>end</span>
1544
- <span class='kw'>else</span>
1545
- <span class='id identifier rubyid_rv'>rv</span> <span class='op'>=</span> <span class='id identifier rubyid_catch'>catch</span><span class='lparen'>(</span><span class='symbol'>:rv</span><span class='rparen'>)</span> <span class='kw'>do</span>
1546
- <span class='kw'>begin</span>
1547
- <span class='const'>FileUtils</span><span class='period'>.</span><span class='id identifier rubyid_rm_r'>rm_r</span><span class='lparen'>(</span><span class='id identifier rubyid_files'>files</span><span class='comma'>,</span> <span class='lbrace'>{</span><span class='symbol'>:noop</span> <span class='op'>=&gt;</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='symbol'>:verbose</span> <span class='op'>=&gt;</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='symbol'>:secure</span> <span class='op'>=&gt;</span> <span class='kw'>true</span><span class='rbrace'>}</span><span class='rparen'>)</span>
1548
- <span class='id identifier rubyid_throw'>throw</span><span class='lparen'>(</span><span class='symbol'>:rv</span><span class='comma'>,</span> <span class='kw'>true</span><span class='rparen'>)</span>
1549
- <span class='kw'>rescue</span> <span class='const'>Errno</span><span class='op'>::</span><span class='const'>EACCES</span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_e'>e</span>
1550
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_send'>send</span><span class='lparen'>(</span><span class='id identifier rubyid_fatal'>fatal</span> <span class='op'>?</span> <span class='symbol'>:fatal</span> <span class='op'>:</span> <span class='symbol'>:error</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Cannot remove following non writable file: {mark=bright}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_e'>e</span><span class='period'>.</span><span class='id identifier rubyid_message'>message</span><span class='period'>.</span><span class='id identifier rubyid_gsub'>gsub</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>.+ - (.+)</span><span class='regexp_end'>/</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\\1</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='rbrace'>}</span><span class='tstring_content'>{/mark}</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1551
- <span class='kw'>rescue</span> <span class='const'>Errno</span><span class='op'>::</span><span class='const'>ENOENT</span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_e'>e</span>
1552
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_send'>send</span><span class='lparen'>(</span><span class='id identifier rubyid_fatal'>fatal</span> <span class='op'>?</span> <span class='symbol'>:fatal</span> <span class='op'>:</span> <span class='symbol'>:error</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Cannot remove following non existent file: {mark=bright}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_e'>e</span><span class='period'>.</span><span class='id identifier rubyid_message'>message</span><span class='period'>.</span><span class='id identifier rubyid_gsub'>gsub</span><span class='lparen'>(</span><span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>.+ - (.+)</span><span class='regexp_end'>/</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\\1</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='rbrace'>}</span><span class='tstring_content'>{/mark}</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1553
- <span class='kw'>rescue</span> <span class='const'>Exception</span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_e'>e</span>
1554
- <span class='kw'>if</span> <span class='id identifier rubyid_show_errors'>show_errors</span> <span class='kw'>then</span>
1555
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_error'>error</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Cannot remove following file(s):</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
1556
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_with_indentation'>with_indentation</span><span class='lparen'>(</span><span class='int'>11</span><span class='rparen'>)</span> <span class='kw'>do</span>
1557
- <span class='id identifier rubyid_files'>files</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_file'>file</span><span class='op'>|</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='id identifier rubyid_file'>file</span><span class='rparen'>)</span> <span class='kw'>end</span>
1558
- <span class='kw'>end</span>
1559
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_write'>write</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>due to this error: [</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_e'>e</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span><span class='period'>.</span><span class='id identifier rubyid_to_s'>to_s</span><span class='rbrace'>}</span><span class='tstring_content'>] </span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_e'>e</span><span class='rbrace'>}</span><span class='tstring_content'>.</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\n</span><span class='tstring_end'>&quot;</span></span><span class='comma'>,</span> <span class='int'>5</span><span class='rparen'>)</span>
1560
- <span class='const'>Kernel</span><span class='period'>.</span><span class='id identifier rubyid_exit'>exit</span><span class='lparen'>(</span><span class='op'>-</span><span class='int'>1</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_fatal'>fatal</span>
1561
- <span class='kw'>end</span>
1562
- <span class='kw'>end</span>
1563
-
1564
- <span class='kw'>false</span>
1565
- <span class='kw'>end</span>
1566
- <span class='kw'>end</span>
1567
-
1568
- <span class='id identifier rubyid_rv'>rv</span>
1569
- <span class='kw'>end</span></pre>
1570
- </td>
1571
- </tr>
1572
- </table>
1573
- </div>
1574
-
1575
- <div class="method_details ">
1576
- <h3 class="signature " id="find-instance_method">
1577
-
1578
- - (<tt>Object</tt>) <strong>find</strong>(directories, patterns = [], by_extension = false, case_sensitive = false)
1579
-
1580
-
1581
-
1582
-
1583
-
1584
- </h3><div class="docstring">
1585
- <div class="discussion">
1586
- <p>Find a list of files in directories matching given regexps or patterns.</p>
1587
-
1588
- <p>You can also pass a block to perform matching. The block will receive a single argument and the path will be considered matched if the blocks not evaluates to <code>nil</code> or <code>false</code>.</p>
1589
-
1590
- <p>Inside the block, you can call <code>Find.prune</code> to stop searching in the current directory.</p>
1591
-
1592
-
1593
- </div>
1594
- </div>
1595
- <div class="tags">
1596
- <p class="tag_title">Parameters:</p>
1597
- <ul class="param">
1598
-
1599
- <li>
1600
-
1601
- <span class='name'>directories</span>
1602
-
1603
-
1604
- <span class='type'>(<tt>String</tt>)</span>
1605
-
1606
-
1607
-
1608
- &mdash;
1609
- <div class='inline'><p>A list of directories where to search files.</p>
1610
- </div>
1611
-
1612
- </li>
1613
-
1614
- <li>
1615
-
1616
- <span class='name'>patterns</span>
1617
-
1618
-
1619
- <span class='type'>(<tt>Array</tt>)</span>
1620
-
1621
-
1622
- <em class="default">(defaults to: <tt>[]</tt>)</em>
1623
-
1624
-
1625
- &mdash;
1626
- <div class='inline'><p>A list of regexps or patterns to match files. If empty, every file is returned. Ignored if a block is provided.</p>
1627
- </div>
1628
-
1629
- </li>
1630
-
1631
- <li>
1632
-
1633
- <span class='name'>by_extension</span>
1634
-
1635
-
1636
- <span class='type'>(<tt>Boolean</tt>)</span>
1637
-
1638
-
1639
- <em class="default">(defaults to: <tt>false</tt>)</em>
1640
-
1641
-
1642
- &mdash;
1643
- <div class='inline'><p>If to only search in extensions. Ignored if a block is provided.</p>
1644
- </div>
1645
-
1646
- </li>
1647
-
1648
- <li>
1649
-
1650
- <span class='name'>case_sensitive</span>
1651
-
1652
-
1653
- <span class='type'>(<tt>Boolean</tt>)</span>
1654
-
1655
-
1656
- <em class="default">(defaults to: <tt>false</tt>)</em>
1657
-
1658
-
1659
- &mdash;
1660
- <div class='inline'><p>If the search is case sensitive. Only meaningful for string patterns.</p>
1661
- </div>
1662
-
1663
- </li>
1664
-
1665
- </ul>
1666
-
1667
-
1668
- </div><table class="source_code">
1669
- <tr>
1670
- <td>
1671
- <pre class="lines">
1672
-
1673
-
1674
- 353
1675
- 354
1676
- 355
1677
- 356
1678
- 357
1679
- 358
1680
- 359
1681
- 360
1682
- 361
1683
- 362
1684
- 363
1685
- 364
1686
- 365
1687
- 366
1688
- 367
1689
- 368
1690
- 369
1691
- 370
1692
- 371
1693
- 372
1694
- 373
1695
- 374
1696
- 375
1697
- 376
1698
- 377
1699
- 378
1700
- 379
1701
- 380
1702
- 381
1703
- 382
1704
- 383
1705
- 384
1706
- 385</pre>
1707
- </td>
1708
- <td>
1709
- <pre class="code"><span class="info file"># File 'lib/bovem/shell.rb', line 353</span>
1710
-
1711
- <span class='kw'>def</span> <span class='id identifier rubyid_find'>find</span><span class='lparen'>(</span><span class='id identifier rubyid_directories'>directories</span><span class='comma'>,</span> <span class='id identifier rubyid_patterns'>patterns</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='id identifier rubyid_by_extension'>by_extension</span> <span class='op'>=</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='id identifier rubyid_case_sensitive'>case_sensitive</span> <span class='op'>=</span> <span class='kw'>false</span><span class='rparen'>)</span>
1712
- <span class='id identifier rubyid_rv'>rv</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
1713
-
1714
- <span class='comment'># Adjust directory
1715
- </span> <span class='id identifier rubyid_directories'>directories</span> <span class='op'>=</span> <span class='id identifier rubyid_directories'>directories</span><span class='period'>.</span><span class='id identifier rubyid_ensure_array'>ensure_array</span><span class='period'>.</span><span class='id identifier rubyid_compact'>compact</span> <span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_d'>d</span><span class='op'>|</span> <span class='const'>File</span><span class='period'>.</span><span class='id identifier rubyid_expand_path'>expand_path</span><span class='lparen'>(</span><span class='id identifier rubyid_d'>d</span><span class='period'>.</span><span class='id identifier rubyid_ensure_string'>ensure_string</span><span class='rparen'>)</span> <span class='rbrace'>}</span>
1716
-
1717
- <span class='comment'># Adjust patterns
1718
- </span> <span class='id identifier rubyid_patterns'>patterns</span> <span class='op'>=</span> <span class='id identifier rubyid_patterns'>patterns</span><span class='period'>.</span><span class='id identifier rubyid_ensure_array'>ensure_array</span><span class='period'>.</span><span class='id identifier rubyid_compact'>compact</span><span class='period'>.</span><span class='id identifier rubyid_collect'>collect</span> <span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_p'>p</span><span class='op'>|</span> <span class='id identifier rubyid_p'>p</span><span class='period'>.</span><span class='id identifier rubyid_is_a?'>is_a?</span><span class='lparen'>(</span><span class='op'>::</span><span class='const'>Regexp</span><span class='rparen'>)</span> <span class='op'>?</span> <span class='id identifier rubyid_p'>p</span> <span class='op'>:</span> <span class='const'>Regexp</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='const'>Regexp</span><span class='period'>.</span><span class='id identifier rubyid_quote'>quote</span><span class='lparen'>(</span><span class='id identifier rubyid_p'>p</span><span class='period'>.</span><span class='id identifier rubyid_ensure_string'>ensure_string</span><span class='rparen'>)</span><span class='rparen'>)</span> <span class='rbrace'>}</span>
1719
- <span class='id identifier rubyid_patterns'>patterns</span> <span class='op'>=</span> <span class='id identifier rubyid_patterns'>patterns</span><span class='period'>.</span><span class='id identifier rubyid_collect'>collect</span> <span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_p'>p</span><span class='op'>|</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>(</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_p'>p</span><span class='period'>.</span><span class='id identifier rubyid_source'>source</span><span class='rbrace'>}</span><span class='tstring_content'>)$</span><span class='regexp_end'>/</span></span> <span class='rbrace'>}</span> <span class='kw'>if</span> <span class='id identifier rubyid_by_extension'>by_extension</span>
1720
- <span class='id identifier rubyid_patterns'>patterns</span> <span class='op'>=</span> <span class='id identifier rubyid_patterns'>patterns</span><span class='period'>.</span><span class='id identifier rubyid_collect'>collect</span> <span class='lbrace'>{</span><span class='op'>|</span><span class='id identifier rubyid_p'>p</span><span class='op'>|</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_p'>p</span><span class='period'>.</span><span class='id identifier rubyid_source'>source</span><span class='rbrace'>}</span><span class='regexp_end'>/i</span></span> <span class='rbrace'>}</span> <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_case_sensitive'>case_sensitive</span>
1721
-
1722
- <span class='id identifier rubyid_directories'>directories</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_directory'>directory</span><span class='op'>|</span>
1723
- <span class='kw'>if</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_check'>check</span><span class='lparen'>(</span><span class='id identifier rubyid_directory'>directory</span><span class='comma'>,</span> <span class='lbracket'>[</span><span class='symbol'>:directory</span><span class='comma'>,</span> <span class='symbol'>:readable</span><span class='comma'>,</span> <span class='symbol'>:executable</span><span class='rbracket'>]</span><span class='rparen'>)</span> <span class='kw'>then</span>
1724
- <span class='const'>Find</span><span class='period'>.</span><span class='id identifier rubyid_find'>find</span><span class='lparen'>(</span><span class='id identifier rubyid_directory'>directory</span><span class='rparen'>)</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_entry'>entry</span><span class='op'>|</span>
1725
- <span class='id identifier rubyid_found'>found</span> <span class='op'>=</span> <span class='id identifier rubyid_patterns'>patterns</span><span class='period'>.</span><span class='id identifier rubyid_blank?'>blank?</span> <span class='op'>?</span> <span class='kw'>true</span> <span class='op'>:</span> <span class='id identifier rubyid_catch'>catch</span><span class='lparen'>(</span><span class='symbol'>:found</span><span class='rparen'>)</span> <span class='kw'>do</span>
1726
- <span class='kw'>if</span> <span class='id identifier rubyid_block_given?'>block_given?</span> <span class='kw'>then</span>
1727
- <span class='id identifier rubyid_throw'>throw</span><span class='lparen'>(</span><span class='symbol'>:found</span><span class='comma'>,</span> <span class='kw'>true</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='kw'>yield</span><span class='lparen'>(</span><span class='id identifier rubyid_entry'>entry</span><span class='rparen'>)</span>
1728
- <span class='kw'>else</span>
1729
- <span class='id identifier rubyid_patterns'>patterns</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_pattern'>pattern</span><span class='op'>|</span>
1730
- <span class='id identifier rubyid_throw'>throw</span><span class='lparen'>(</span><span class='symbol'>:found</span><span class='comma'>,</span> <span class='kw'>true</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_pattern'>pattern</span><span class='period'>.</span><span class='id identifier rubyid_match'>match</span><span class='lparen'>(</span><span class='id identifier rubyid_entry'>entry</span><span class='rparen'>)</span> <span class='op'>&amp;&amp;</span> <span class='lparen'>(</span><span class='op'>!</span><span class='id identifier rubyid_by_extension'>by_extension</span> <span class='op'>||</span> <span class='op'>!</span><span class='const'>File</span><span class='period'>.</span><span class='id identifier rubyid_directory?'>directory?</span><span class='lparen'>(</span><span class='id identifier rubyid_entry'>entry</span><span class='rparen'>)</span><span class='rparen'>)</span>
1731
- <span class='kw'>end</span>
1732
- <span class='kw'>end</span>
1733
-
1734
- <span class='kw'>false</span>
1735
- <span class='kw'>end</span>
1736
-
1737
- <span class='id identifier rubyid_rv'>rv</span> <span class='op'>&lt;&lt;</span> <span class='id identifier rubyid_entry'>entry</span> <span class='kw'>if</span> <span class='id identifier rubyid_found'>found</span>
1738
- <span class='kw'>end</span>
1739
- <span class='kw'>end</span>
1740
- <span class='kw'>end</span>
1741
-
1742
- <span class='id identifier rubyid_rv'>rv</span>
1743
- <span class='kw'>end</span></pre>
1744
- </td>
1745
- </tr>
1746
- </table>
1747
- </div>
1748
-
1749
- <div class="method_details ">
1750
- <h3 class="signature " id="move-instance_method">
1751
-
1752
- - (<tt>Boolean</tt>) <strong>move</strong>(src, dst, run = true, show_errors = false, fatal = true)
1753
-
1754
-
1755
-
1756
-
1757
-
1758
- </h3><div class="docstring">
1759
- <div class="discussion">
1760
- <p>Moves a set of files or directory to another location.</p>
1761
-
1762
-
1763
- </div>
1764
- </div>
1765
- <div class="tags">
1766
- <p class="tag_title">Parameters:</p>
1767
- <ul class="param">
1768
-
1769
- <li>
1770
-
1771
- <span class='name'>src</span>
1772
-
1773
-
1774
- <span class='type'>(<tt>String|Array</tt>)</span>
1775
-
1776
-
1777
-
1778
- &mdash;
1779
- <div class='inline'><p>The entries to move. If is an Array, <code>dst</code> is assumed to be a directory.</p>
1780
- </div>
1781
-
1782
- </li>
1783
-
1784
- <li>
1785
-
1786
- <span class='name'>dst</span>
1787
-
1788
-
1789
- <span class='type'>(<tt>String</tt>)</span>
1790
-
1791
-
1792
-
1793
- &mdash;
1794
- <div class='inline'><p>The destination. <strong>Any existing entries will be overwritten.</strong> Any required directory will be created.</p>
1795
- </div>
1796
-
1797
- </li>
1798
-
1799
- <li>
1800
-
1801
- <span class='name'>run</span>
1802
-
1803
-
1804
- <span class='type'>(<tt>Boolean</tt>)</span>
1805
-
1806
-
1807
- <em class="default">(defaults to: <tt>true</tt>)</em>
1808
-
1809
-
1810
- &mdash;
1811
- <div class='inline'><p>If <code>false</code>, it will just print a list of message that would be deleted.</p>
1812
- </div>
1813
-
1814
- </li>
1815
-
1816
- <li>
1817
-
1818
- <span class='name'>show_errors</span>
1819
-
1820
-
1821
- <span class='type'>(<tt>Boolean</tt>)</span>
1822
-
1823
-
1824
- <em class="default">(defaults to: <tt>false</tt>)</em>
1825
-
1826
-
1827
- &mdash;
1828
- <div class='inline'><p>If show errors.</p>
1829
- </div>
1830
-
1831
- </li>
1832
-
1833
- <li>
1834
-
1835
- <span class='name'>fatal</span>
1836
-
1837
-
1838
- <span class='type'>(<tt>Boolean</tt>)</span>
1839
-
1840
-
1841
- <em class="default">(defaults to: <tt>true</tt>)</em>
1842
-
1843
-
1844
- &mdash;
1845
- <div class='inline'><p>If quit in case of fatal errors.</p>
1846
- </div>
1847
-
1848
- </li>
1849
-
1850
- </ul>
1851
-
1852
- <p class="tag_title">Returns:</p>
1853
- <ul class="return">
1854
-
1855
- <li>
1856
-
1857
-
1858
- <span class='type'>(<tt>Boolean</tt>)</span>
1859
-
1860
-
1861
-
1862
- &mdash;
1863
- <div class='inline'><p><code>true</code> if operation succeeded, <code>false</code> otherwise.</p>
1864
- </div>
1865
-
1866
- </li>
1867
-
1868
- </ul>
1869
-
1870
- </div><table class="source_code">
1871
- <tr>
1872
- <td>
1873
- <pre class="lines">
1874
-
1875
-
1876
- 250
1877
- 251
1878
- 252</pre>
1879
- </td>
1880
- <td>
1881
- <pre class="code"><span class="info file"># File 'lib/bovem/shell.rb', line 250</span>
1882
-
1883
- <span class='kw'>def</span> <span class='id identifier rubyid_move'>move</span><span class='lparen'>(</span><span class='id identifier rubyid_src'>src</span><span class='comma'>,</span> <span class='id identifier rubyid_dst'>dst</span><span class='comma'>,</span> <span class='id identifier rubyid_run'>run</span> <span class='op'>=</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='id identifier rubyid_show_errors'>show_errors</span> <span class='op'>=</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='id identifier rubyid_fatal'>fatal</span> <span class='op'>=</span> <span class='kw'>true</span><span class='rparen'>)</span>
1884
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_copy_or_move'>copy_or_move</span><span class='lparen'>(</span><span class='id identifier rubyid_src'>src</span><span class='comma'>,</span> <span class='id identifier rubyid_dst'>dst</span><span class='comma'>,</span> <span class='symbol'>:move</span><span class='comma'>,</span> <span class='id identifier rubyid_run'>run</span><span class='comma'>,</span> <span class='id identifier rubyid_show_errors'>show_errors</span><span class='comma'>,</span> <span class='id identifier rubyid_fatal'>fatal</span><span class='rparen'>)</span>
1885
- <span class='kw'>end</span></pre>
1886
- </td>
1887
- </tr>
1888
- </table>
1889
- </div>
1890
-
1891
- <div class="method_details ">
1892
- <h3 class="signature " id="run-instance_method">
1893
-
1894
- - (<tt>Hash</tt>) <strong>run</strong>(command, message = nil, run = true, show_exit = true, show_output = false, show_command = false, fatal = true)
1895
-
1896
-
1897
-
1898
-
1899
-
1900
- </h3><div class="docstring">
1901
- <div class="discussion">
1902
- <p>Runs a command into the shell.</p>
1903
-
1904
-
1905
- </div>
1906
- </div>
1907
- <div class="tags">
1908
- <p class="tag_title">Parameters:</p>
1909
- <ul class="param">
1910
-
1911
- <li>
1912
-
1913
- <span class='name'>command</span>
1914
-
1915
-
1916
- <span class='type'>(<tt>String</tt>)</span>
1917
-
1918
-
1919
-
1920
- &mdash;
1921
- <div class='inline'><p>The string to run.</p>
1922
- </div>
1923
-
1924
- </li>
1925
-
1926
- <li>
1927
-
1928
- <span class='name'>message</span>
1929
-
1930
-
1931
- <span class='type'>(<tt>String</tt>)</span>
1932
-
1933
-
1934
- <em class="default">(defaults to: <tt>nil</tt>)</em>
1935
-
1936
-
1937
- &mdash;
1938
- <div class='inline'><p>A message to show before running.</p>
1939
- </div>
1940
-
1941
- </li>
1942
-
1943
- <li>
1944
-
1945
- <span class='name'>run</span>
1946
-
1947
-
1948
- <span class='type'>(<tt>Boolean</tt>)</span>
1949
-
1950
-
1951
- <em class="default">(defaults to: <tt>true</tt>)</em>
1952
-
1953
-
1954
- &mdash;
1955
- <div class='inline'><p>If <code>false</code>, it will just print a message with the full command that will be run.</p>
1956
- </div>
1957
-
1958
- </li>
1959
-
1960
- <li>
1961
-
1962
- <span class='name'>show_exit</span>
1963
-
1964
-
1965
- <span class='type'>(<tt>Boolean</tt>)</span>
1966
-
1967
-
1968
- <em class="default">(defaults to: <tt>true</tt>)</em>
1969
-
1970
-
1971
- &mdash;
1972
- <div class='inline'><p>If show the exit status.</p>
1973
- </div>
1974
-
1975
- </li>
1976
-
1977
- <li>
1978
-
1979
- <span class='name'>show_output</span>
1980
-
1981
-
1982
- <span class='type'>(<tt>Boolean</tt>)</span>
1983
-
1984
-
1985
- <em class="default">(defaults to: <tt>false</tt>)</em>
1986
-
1987
-
1988
- &mdash;
1989
- <div class='inline'><p>If show command output.</p>
1990
- </div>
1991
-
1992
- </li>
1993
-
1994
- <li>
1995
-
1996
- <span class='name'>show_command</span>
1997
-
1998
-
1999
- <span class='type'>(<tt>Boolean</tt>)</span>
2000
-
2001
-
2002
- <em class="default">(defaults to: <tt>false</tt>)</em>
2003
-
2004
-
2005
- &mdash;
2006
- <div class='inline'><p>If show the command that will be run.</p>
2007
- </div>
2008
-
2009
- </li>
2010
-
2011
- <li>
2012
-
2013
- <span class='name'>fatal</span>
2014
-
2015
-
2016
- <span class='type'>(<tt>Boolean</tt>)</span>
2017
-
2018
-
2019
- <em class="default">(defaults to: <tt>true</tt>)</em>
2020
-
2021
-
2022
- &mdash;
2023
- <div class='inline'><p>If quit in case of fatal errors.</p>
2024
- </div>
2025
-
2026
- </li>
2027
-
2028
- </ul>
2029
-
2030
- <p class="tag_title">Returns:</p>
2031
- <ul class="return">
2032
-
2033
- <li>
2034
-
2035
-
2036
- <span class='type'>(<tt>Hash</tt>)</span>
2037
-
2038
-
2039
-
2040
- &mdash;
2041
- <div class='inline'><p>An hash with <code>status</code> and <code>output</code> keys.</p>
2042
- </div>
2043
-
2044
- </li>
2045
-
2046
- </ul>
2047
-
2048
- </div><table class="source_code">
2049
- <tr>
2050
- <td>
2051
- <pre class="lines">
2052
-
2053
-
2054
- 35
2055
- 36
2056
- 37
2057
- 38
2058
- 39
2059
- 40
2060
- 41
2061
- 42
2062
- 43
2063
- 44
2064
- 45
2065
- 46
2066
- 47
2067
- 48
2068
- 49
2069
- 50
2070
- 51
2071
- 52
2072
- 53
2073
- 54
2074
- 55
2075
- 56
2076
- 57
2077
- 58
2078
- 59
2079
- 60
2080
- 61
2081
- 62
2082
- 63
2083
- 64</pre>
2084
- </td>
2085
- <td>
2086
- <pre class="code"><span class="info file"># File 'lib/bovem/shell.rb', line 35</span>
2087
-
2088
- <span class='kw'>def</span> <span class='id identifier rubyid_run'>run</span><span class='lparen'>(</span><span class='id identifier rubyid_command'>command</span><span class='comma'>,</span> <span class='id identifier rubyid_message'>message</span> <span class='op'>=</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='id identifier rubyid_run'>run</span> <span class='op'>=</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='id identifier rubyid_show_exit'>show_exit</span> <span class='op'>=</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='id identifier rubyid_show_output'>show_output</span> <span class='op'>=</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='id identifier rubyid_show_command'>show_command</span> <span class='op'>=</span> <span class='kw'>false</span><span class='comma'>,</span> <span class='id identifier rubyid_fatal'>fatal</span> <span class='op'>=</span> <span class='kw'>true</span><span class='rparen'>)</span>
2089
- <span class='id identifier rubyid_rv'>rv</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='symbol'>:status</span> <span class='op'>=&gt;</span> <span class='int'>0</span><span class='comma'>,</span> <span class='symbol'>:output</span> <span class='op'>=&gt;</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span><span class='rbrace'>}</span>
2090
- <span class='id identifier rubyid_command'>command</span> <span class='op'>=</span> <span class='id identifier rubyid_command'>command</span><span class='period'>.</span><span class='id identifier rubyid_ensure_string'>ensure_string</span>
2091
-
2092
- <span class='comment'># Show the command
2093
- </span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_begin'>begin</span><span class='lparen'>(</span><span class='id identifier rubyid_message'>message</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_message'>message</span><span class='period'>.</span><span class='id identifier rubyid_present?'>present?</span>
2094
-
2095
-
2096
- <span class='kw'>if</span> <span class='op'>!</span><span class='id identifier rubyid_run'>run</span> <span class='kw'>then</span> <span class='comment'># Print a message
2097
- </span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_warn'>warn</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Will run command: {mark=bright}\&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_command'>command</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot;{/mark}...</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
2098
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_status'>status</span><span class='lparen'>(</span><span class='symbol'>:ok</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_show_exit'>show_exit</span>
2099
- <span class='kw'>else</span> <span class='comment'># Run
2100
- </span> <span class='id identifier rubyid_output'>output</span> <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_end'>&quot;</span></span>
2101
-
2102
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_info'>info</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Running command: {mark=bright}\&quot;</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_command'>command</span><span class='rbrace'>}</span><span class='tstring_content'>\&quot;{/mark}...</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_show_command'>show_command</span>
2103
- <span class='id identifier rubyid_rv'>rv</span><span class='lbracket'>[</span><span class='symbol'>:status</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='op'>::</span><span class='const'>Open4</span><span class='op'>::</span><span class='id identifier rubyid_popen4'>popen4</span><span class='lparen'>(</span><span class='id identifier rubyid_command'>command</span> <span class='op'>+</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'> 2&gt;&amp;1</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_pid'>pid</span><span class='comma'>,</span> <span class='id identifier rubyid_stdin'>stdin</span><span class='comma'>,</span> <span class='id identifier rubyid_stdout'>stdout</span><span class='comma'>,</span> <span class='id identifier rubyid_stderr'>stderr</span><span class='op'>|</span>
2104
- <span class='id identifier rubyid_stdout'>stdout</span><span class='period'>.</span><span class='id identifier rubyid_each_line'>each_line</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_line'>line</span><span class='op'>|</span>
2105
- <span class='id identifier rubyid_output'>output</span> <span class='op'>&lt;&lt;</span> <span class='id identifier rubyid_line'>line</span>
2106
- <span class='const'>Kernel</span><span class='period'>.</span><span class='id identifier rubyid_print'>print</span> <span class='id identifier rubyid_line'>line</span> <span class='kw'>if</span> <span class='id identifier rubyid_show_output'>show_output</span>
2107
- <span class='kw'>end</span>
2108
- <span class='rbrace'>}</span><span class='period'>.</span><span class='id identifier rubyid_exitstatus'>exitstatus</span>
2109
-
2110
- <span class='id identifier rubyid_rv'>rv</span><span class='lbracket'>[</span><span class='symbol'>:output</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_output'>output</span>
2111
- <span class='kw'>end</span>
2112
-
2113
- <span class='comment'># Return
2114
- </span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_status'>status</span><span class='lparen'>(</span><span class='id identifier rubyid_rv'>rv</span><span class='lbracket'>[</span><span class='symbol'>:status</span><span class='rbracket'>]</span> <span class='op'>==</span> <span class='int'>0</span> <span class='op'>?</span> <span class='symbol'>:ok</span> <span class='op'>:</span> <span class='symbol'>:fail</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_show_exit'>show_exit</span>
2115
- <span class='id identifier rubyid_exit'>exit</span><span class='lparen'>(</span><span class='id identifier rubyid_rv'>rv</span><span class='lbracket'>[</span><span class='symbol'>:status</span><span class='rbracket'>]</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_fatal'>fatal</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_rv'>rv</span><span class='lbracket'>[</span><span class='symbol'>:status</span><span class='rbracket'>]</span> <span class='op'>!=</span> <span class='int'>0</span>
2116
- <span class='id identifier rubyid_rv'>rv</span>
2117
- <span class='kw'>end</span></pre>
2118
- </td>
2119
- </tr>
2120
- </table>
2121
- </div>
2122
-
2123
- <div class="method_details ">
2124
- <h3 class="signature " id="within_directory-instance_method">
2125
-
2126
- - (<tt>Boolean</tt>) <strong>within_directory</strong>(directory, restore = true, show_messages = false)
2127
-
2128
-
2129
-
2130
-
2131
-
2132
- </h3><div class="docstring">
2133
- <div class="discussion">
2134
- <p>Executes a block of code in another directory.</p>
2135
-
2136
-
2137
- </div>
2138
- </div>
2139
- <div class="tags">
2140
- <p class="tag_title">Parameters:</p>
2141
- <ul class="param">
2142
-
2143
- <li>
2144
-
2145
- <span class='name'>directory</span>
2146
-
2147
-
2148
- <span class='type'>(<tt>String</tt>)</span>
2149
-
2150
-
2151
-
2152
- &mdash;
2153
- <div class='inline'><p>The new working directory.</p>
2154
- </div>
2155
-
2156
- </li>
2157
-
2158
- <li>
2159
-
2160
- <span class='name'>restore</span>
2161
-
2162
-
2163
- <span class='type'>(<tt>Boolean</tt>)</span>
2164
-
2165
-
2166
- <em class="default">(defaults to: <tt>true</tt>)</em>
2167
-
2168
-
2169
- &mdash;
2170
- <div class='inline'><p>If to restore the original working directory.</p>
2171
- </div>
2172
-
2173
- </li>
2174
-
2175
- <li>
2176
-
2177
- <span class='name'>show_messages</span>
2178
-
2179
-
2180
- <span class='type'>(<tt>Boolean</tt>)</span>
2181
-
2182
-
2183
- <em class="default">(defaults to: <tt>false</tt>)</em>
2184
-
2185
-
2186
- &mdash;
2187
- <div class='inline'><p>Show informative messages about working directory changes.</p>
2188
- </div>
2189
-
2190
- </li>
2191
-
2192
- </ul>
2193
-
2194
- <p class="tag_title">Returns:</p>
2195
- <ul class="return">
2196
-
2197
- <li>
2198
-
2199
-
2200
- <span class='type'>(<tt>Boolean</tt>)</span>
2201
-
2202
-
2203
-
2204
- &mdash;
2205
- <div class='inline'><p><code>true</code> if the directory was valid and the code executed, <code>false</code> otherwise.</p>
2206
- </div>
2207
-
2208
- </li>
2209
-
2210
- </ul>
2211
-
2212
- </div><table class="source_code">
2213
- <tr>
2214
- <td>
2215
- <pre class="lines">
2216
-
2217
-
2218
- 260
2219
- 261
2220
- 262
2221
- 263
2222
- 264
2223
- 265
2224
- 266
2225
- 267
2226
- 268
2227
- 269
2228
- 270
2229
- 271
2230
- 272
2231
- 273
2232
- 274
2233
- 275
2234
- 276
2235
- 277
2236
- 278
2237
- 279
2238
- 280
2239
- 281
2240
- 282
2241
- 283
2242
- 284
2243
- 285
2244
- 286</pre>
2245
- </td>
2246
- <td>
2247
- <pre class="code"><span class="info file"># File 'lib/bovem/shell.rb', line 260</span>
2248
-
2249
- <span class='kw'>def</span> <span class='id identifier rubyid_within_directory'>within_directory</span><span class='lparen'>(</span><span class='id identifier rubyid_directory'>directory</span><span class='comma'>,</span> <span class='id identifier rubyid_restore'>restore</span> <span class='op'>=</span> <span class='kw'>true</span><span class='comma'>,</span> <span class='id identifier rubyid_show_messages'>show_messages</span> <span class='op'>=</span> <span class='kw'>false</span><span class='rparen'>)</span>
2250
- <span class='id identifier rubyid_rv'>rv</span> <span class='op'>=</span> <span class='kw'>false</span>
2251
- <span class='id identifier rubyid_original'>original</span> <span class='op'>=</span> <span class='const'>Dir</span><span class='period'>.</span><span class='id identifier rubyid_pwd'>pwd</span>
2252
- <span class='id identifier rubyid_directory'>directory</span> <span class='op'>=</span> <span class='const'>File</span><span class='period'>.</span><span class='id identifier rubyid_expand_path'>expand_path</span><span class='lparen'>(</span><span class='id identifier rubyid_directory'>directory</span><span class='period'>.</span><span class='id identifier rubyid_ensure_string'>ensure_string</span><span class='rparen'>)</span>
2253
-
2254
- <span class='kw'>if</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_check'>check</span><span class='lparen'>(</span><span class='id identifier rubyid_directory'>directory</span><span class='comma'>,</span> <span class='lbracket'>[</span><span class='symbol'>:directory</span><span class='comma'>,</span> <span class='symbol'>:executable</span><span class='rbracket'>]</span><span class='rparen'>)</span> <span class='kw'>then</span>
2255
- <span class='kw'>begin</span>
2256
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_info'>info</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Moving into directory {mark=bright}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_directory'>directory</span><span class='rbrace'>}</span><span class='tstring_content'>{/mark}</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_show_messages'>show_messages</span>
2257
- <span class='const'>Dir</span><span class='period'>.</span><span class='id identifier rubyid_chdir'>chdir</span><span class='lparen'>(</span><span class='id identifier rubyid_directory'>directory</span><span class='rparen'>)</span>
2258
- <span class='id identifier rubyid_rv'>rv</span> <span class='op'>=</span> <span class='kw'>true</span>
2259
- <span class='kw'>rescue</span> <span class='const'>Exception</span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_e'>e</span>
2260
- <span class='kw'>end</span>
2261
- <span class='kw'>end</span>
2262
-
2263
- <span class='kw'>yield</span> <span class='kw'>if</span> <span class='id identifier rubyid_rv'>rv</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_block_given?'>block_given?</span>
2264
-
2265
- <span class='kw'>if</span> <span class='id identifier rubyid_rv'>rv</span> <span class='op'>&amp;&amp;</span> <span class='id identifier rubyid_original'>original</span> <span class='kw'>then</span>
2266
- <span class='kw'>begin</span>
2267
- <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_console'>console</span><span class='period'>.</span><span class='id identifier rubyid_info'>info</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Moving back into directory {mark=bright}</span><span class='embexpr_beg'>#{</span><span class='id identifier rubyid_original'>original</span><span class='rbrace'>}</span><span class='tstring_content'>{/mark}</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_show_messages'>show_messages</span>
2268
- <span class='const'>Dir</span><span class='period'>.</span><span class='id identifier rubyid_chdir'>chdir</span><span class='lparen'>(</span><span class='id identifier rubyid_original'>original</span><span class='rparen'>)</span> <span class='kw'>if</span> <span class='id identifier rubyid_restore'>restore</span>
2269
- <span class='kw'>rescue</span> <span class='const'>Exception</span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_e'>e</span>
2270
- <span class='id identifier rubyid_rv'>rv</span> <span class='op'>=</span> <span class='kw'>false</span>
2271
- <span class='kw'>end</span>
2272
- <span class='kw'>end</span>
2273
-
2274
- <span class='id identifier rubyid_rv'>rv</span>
443
+ <span class='kw'>def</span> <span class='kw'>self</span><span class='period'>.</span><span class='id identifier rubyid_instance'>instance</span>
444
+ <span class='ivar'>@instance</span> <span class='op'>||=</span> <span class='op'>::</span><span class='const'>Bovem</span><span class='op'>::</span><span class='const'>Shell</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
2275
445
  <span class='kw'>end</span></pre>
2276
446
  </td>
2277
447
  </tr>
@@ -2283,9 +453,9 @@
2283
453
  </div>
2284
454
 
2285
455
  <div id="footer">
2286
- Generated on Mon Oct 22 09:30:27 2012 by
456
+ Generated on Fri Feb 1 23:40:18 2013 by
2287
457
  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
2288
- 0.8.2.1 (ruby-1.9.2).
458
+ 0.8.3 (ruby-1.9.3).
2289
459
  </div>
2290
460
 
2291
461
  </body>