bovem 1.2.6 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (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>