blackbox 3.1.4 → 3.2.0

data/doc/_index.html

@@ -167,6 +167,21 @@
           </ul>
         </ul>
       
+        
+        <ul id="alpha_U" class="alpha">
+          <li class="letter">U</li>
+          <ul>
+            
+              <li>
+                <span class='object_link'><a href="BB/Unix.html" title="BB::Unix (module)">Unix</a></span>
+                
+                  <small>(BB)</small>
+                
+              </li>
+            
+          </ul>
+        </ul>
+      
     </td>
   </tr>
 </table>
@@ -176,7 +191,7 @@
 </div>
 
     <div id="footer">
-  Generated on Sat May 14 23:58:48 2016 by
+  Generated on Mon Jun 13 02:13:49 2016 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.3.1).
 </div>

data/doc/class_list.html

@@ -50,7 +50,7 @@
 
       <ul id="full_list" class="class">
         <li><span class='object_link'><a href="top-level-namespace.html" title="Top Level Namespace (root)">Top Level Namespace</a></span></li>
-<li><a class='toggle'></a> <span class='object_link'><a href="BB.html" title="BB (module)">BB</a></span><small class='search_info'>Top Level Namespace</small></li><ul><li><span class='object_link'><a href="BB/Crypto.html" title="BB::Crypto (module)">Crypto</a></span><small class='search_info'>BB</small></li><li><span class='object_link'><a href="BB/Gem.html" title="BB::Gem (module)">Gem</a></span><small class='search_info'>BB</small></li><li><span class='object_link'><a href="BB/Hash.html" title="BB::Hash (module)">Hash</a></span><small class='search_info'>BB</small></li><li><span class='object_link'><a href="BB/Number.html" title="BB::Number (module)">Number</a></span><small class='search_info'>BB</small></li><li><span class='object_link'><a href="BB/String.html" title="BB::String (module)">String</a></span><small class='search_info'>BB</small></li></ul>
+<li><a class='toggle'></a> <span class='object_link'><a href="BB.html" title="BB (module)">BB</a></span><small class='search_info'>Top Level Namespace</small></li><ul><li><span class='object_link'><a href="BB/Crypto.html" title="BB::Crypto (module)">Crypto</a></span><small class='search_info'>BB</small></li><li><span class='object_link'><a href="BB/Gem.html" title="BB::Gem (module)">Gem</a></span><small class='search_info'>BB</small></li><li><span class='object_link'><a href="BB/Hash.html" title="BB::Hash (module)">Hash</a></span><small class='search_info'>BB</small></li><li><span class='object_link'><a href="BB/Number.html" title="BB::Number (module)">Number</a></span><small class='search_info'>BB</small></li><li><span class='object_link'><a href="BB/String.html" title="BB::String (module)">String</a></span><small class='search_info'>BB</small></li><li><span class='object_link'><a href="BB/Unix.html" title="BB::Unix (module)">Unix</a></span><small class='search_info'>BB</small></li></ul>
 
       </ul>
     </div>

data/doc/file.README.html

@@ -61,7 +61,7 @@
 
     <iframe id="search_frame"></iframe>
 
-    <div id="content"><div id='filecontents'><h1>Blackbox <a href="https://travis-ci.org/busyloop/blackbox"><img src="https://travis-ci.org/busyloop/blackbox.png?branch=master" alt="Build Status"></a> <a href="https://gemnasium.com/github.com/busyloop/blackbox"><img src="https://gemnasium.com/badges/github.com/busyloop/blackbox.svg" alt="Dependency Status"></a></h1>
+    <div id="content"><div id='filecontents'><h1>Blackbox <a href="https://travis-ci.org/busyloop/blackbox"><img src="https://travis-ci.org/busyloop/blackbox.png?branch=master" alt="Build Status"></a> <a href="https://gemnasium.com/github.com/busyloop/blackbox"><img src="https://gemnasium.com/badges/github.com/busyloop/blackbox.svg" alt="Dependency Status"></a> <a href="https://badge.fury.io/rb/blackbox"><img src="https://badge.fury.io/rb/blackbox.svg" alt="Gem Version"></a></h1>
 
 <p>Various little helpers.</p>
 
@@ -95,7 +95,7 @@ BB::String.strip_ansi( ... )
 </div></div>
 
     <div id="footer">
-  Generated on Sat May 14 23:58:48 2016 by
+  Generated on Mon Jun 13 02:13:49 2016 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.3.1).
 </div>

data/doc/index.html

@@ -61,7 +61,7 @@
 
     <iframe id="search_frame"></iframe>
 
-    <div id="content"><div id='filecontents'><h1>Blackbox <a href="https://travis-ci.org/busyloop/blackbox"><img src="https://travis-ci.org/busyloop/blackbox.png?branch=master" alt="Build Status"></a> <a href="https://gemnasium.com/github.com/busyloop/blackbox"><img src="https://gemnasium.com/badges/github.com/busyloop/blackbox.svg" alt="Dependency Status"></a></h1>
+    <div id="content"><div id='filecontents'><h1>Blackbox <a href="https://travis-ci.org/busyloop/blackbox"><img src="https://travis-ci.org/busyloop/blackbox.png?branch=master" alt="Build Status"></a> <a href="https://gemnasium.com/github.com/busyloop/blackbox"><img src="https://gemnasium.com/badges/github.com/busyloop/blackbox.svg" alt="Dependency Status"></a> <a href="https://badge.fury.io/rb/blackbox"><img src="https://badge.fury.io/rb/blackbox.svg" alt="Gem Version"></a></h1>
 
 <p>Various little helpers.</p>
 
@@ -95,7 +95,7 @@ BB::String.strip_ansi( ... )
 </div></div>
 
     <div id="footer">
-  Generated on Sat May 14 23:58:48 2016 by
+  Generated on Mon Jun 13 02:13:49 2016 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.3.1).
 </div>

data/doc/method_list.html

@@ -94,36 +94,42 @@
   
 
   <li class="r2 ">
+    <span class='object_link'><a href="BB/Unix.html#run_each-class_method" title="BB::Unix.run_each (method)">run_each</a></span>
+    <small>BB::Unix</small>
+  </li>
+  
+
+  <li class="r1 ">
     <span class='object_link'><a href="BB/String.html#strip_ansi-class_method" title="BB::String.strip_ansi (method)">strip_ansi</a></span>
     <small>BB::String</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="BB/Hash.html#symbolize_keys-class_method" title="BB::Hash.symbolize_keys (method)">symbolize_keys</a></span>
     <small>BB::Hash</small>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="BB/Number.html#to_human_size-class_method" title="BB::Number.to_human_size (method)">to_human_size</a></span>
     <small>BB::Number</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="BB/Gem.html#version_info-class_method" title="BB::Gem.version_info (method)">version_info</a></span>
     <small>BB::Gem</small>
   </li>
   
 
-  <li class="r2 ">
+  <li class="r1 ">
     <span class='object_link'><a href="BB/Number.html#with_delimiter-class_method" title="BB::Number.with_delimiter (method)">with_delimiter</a></span>
     <small>BB::Number</small>
   </li>
   
 
-  <li class="r1 ">
+  <li class="r2 ">
     <span class='object_link'><a href="BB/Number.html#with_precision-class_method" title="BB::Number.with_precision (method)">with_precision</a></span>
     <small>BB::Number</small>
   </li>

data/doc/top-level-namespace.html

@@ -103,7 +103,7 @@
 </div>
 
     <div id="footer">
-  Generated on Sat May 14 23:58:48 2016 by
+  Generated on Mon Jun 13 02:13:49 2016 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.3.1).
 </div>

data/lib/blackbox/unix.rb

@@ -0,0 +1,113 @@
+# frozen_string_literal: true
+require 'lolcat/lol'
+require 'thread'
+require 'open3'
+require 'pty'
+require 'rainbow/ext/string'
+
+module BB
+  # Unix utilities.
+  module Unix
+    class << self
+      # Run each line of a script in a shell.
+      #
+      # @param [Hash] script Script
+      # @return [Hash] Exit status (depends on mode)
+      def run_each(script, opts = {})
+        opts = {
+          quiet: false,
+          failfast: true,
+          spinner: nil,
+          stream: false
+        }.merge(opts)
+
+        @minispinlock ||= Mutex.new
+        script.lines.each_with_index do |line, i|
+          line.chomp!
+          case line[0]
+          when '#'
+            puts "\n" + line.bright unless opts[:quiet]
+          when ':'
+            opts[:quiet] = true if line == ':quiet'
+            opts[:failfast] = false if line == ':return'
+            opts[:spinner]  = nil   if line == ':nospinner'
+            if line == ':stream'
+              opts[:stream] = true
+              opts[:quiet] = false
+            end
+          end
+          next if line.empty? || ['#', ':'].include?(line[0])
+
+          status = nil
+          if opts[:stream]
+            puts "\n> ".color(:green) + line.color(:black).bright
+            rows, cols = STDIN.winsize
+            @minispin_disable = false
+            @minispin_last_char_at = Time.now
+            @tspin ||= Thread.new do
+              i = 0
+              loop do
+                break if @minispin_last_char_at == :end
+                if 0.23 > Time.now - @minispin_last_char_at || @minispin_disable
+                  sleep 0.1
+                  next
+                end
+                @minispinlock.synchronize do
+                  next if @minispin_disable
+                  print "\e[?25l"
+                  print Paint[' ', '#000', Lol.rainbow(1, i / 3.0)]
+                  sleep 0.12
+                  print 8.chr
+                  print ' '
+                  print 8.chr
+                  i += 1
+                  print "\e[?25h"
+                end
+              end
+            end
+
+            PTY.spawn("stty rows #{rows} cols #{cols}; " + line) do |r, _w, pid|
+              begin
+                until r.eof?
+                  c = r.getc
+                  @minispinlock.synchronize do
+                    print c
+                    @minispin_last_char_at = Time.now
+                    c = c.encode('UTF-8', 'binary', invalid: :replace, undef: :replace, replace: "\e") # barf.
+                    # hold on when we are (likely) inside an escape sequence
+                    @minispin_disable = true  if c.ord == 27 || c.ord < 9
+                    @minispin_disable = false if c =~ /[A-Za-z]/ || [13, 10].include?(c.ord)
+                  end
+                end
+              rescue Errno::EIO
+                # Linux raises EIO on EOF, cf.
+                # https://github.com/ruby/ruby/blob/57fb2199059cb55b632d093c2e64c8a3c60acfbb/ext/pty/pty.c#L519
+                nil
+              end
+
+              _pid, status = Process.wait2(pid)
+              @minispin_last_char_at = :end
+              @tspin.join
+              @tspin = nil
+            end
+          else
+            opts[:spinner].call(true) if opts[:spinner]
+            output, status = Open3.capture2e(line)
+            opts[:spinner].call(false) if opts[:spinner]
+            color = (status.exitstatus == 0) ? :green : :red
+            if status.exitstatus != 0 || !opts[:quiet]
+              puts "\n> ".color(color) + line.color(:black).bright
+              puts output
+            end
+          end
+          next unless status.exitstatus != 0
+          puts "Error, exit #{status.exitstatus}: #{line} (L#{i})".color(:red).bright
+
+          exit status.exitstatus if opts[:failfast]
+          return status.exitstatus
+        end
+        0
+      end
+    end
+  end
+end

data/lib/blackbox/version.rb

@@ -1,4 +1,4 @@
 # frozen_string_literal: true
 module BB
-  VERSION = '3.1.4'
+  VERSION = '3.2.0'
 end

data/spec/unix_spec.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+require 'spec_helper'
+require 'blackbox/unix'
+
+describe BB::Unix do
+  describe '.run_each' do
+    it 'exits on failure by default' do
+      expect do
+        expect do
+          BB::Unix.run_each('false')
+        end.to output.to_stdout
+      end.to raise_error(SystemExit)
+    end
+
+    it 'echos to stdout by default' do
+      expect do
+        BB::Unix.run_each('true')
+      end.to output(/true/).to_stdout
+    end
+
+    it 'quiet success in quiet mode' do
+      expect do
+        BB::Unix.run_each(":return\n:quiet\ntrue")
+      end.to output('').to_stdout
+    end
+
+    it 'loud failure in quiet mode' do
+      expect do
+        BB::Unix.run_each(":return\n:quiet\nfalse")
+      end.to output(/exit 1: false/).to_stdout
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: blackbox
 version: !ruby/object:Gem::Version
-  version: 3.1.4
+  version: 3.2.0
 platform: ruby
 authors:
 - Moe
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-05-14 00:00:00.000000000 Z
+date: 2016-06-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -178,6 +178,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: lolcat
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rainbow
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Various little helpers
 email:
 - moe@busyloop.net
@@ -272,6 +300,7 @@ files:
 - doc/BB/Hash.html
 - doc/BB/Number.html
 - doc/BB/String.html
+- doc/BB/Unix.html
 - doc/_index.html
 - doc/class_list.html
 - doc/css/common.css
@@ -292,6 +321,7 @@ files:
 - lib/blackbox/hash.rb
 - lib/blackbox/number.rb
 - lib/blackbox/string.rb
+- lib/blackbox/unix.rb
 - lib/blackbox/version.rb
 - spec/blackbox_spec.rb
 - spec/crypto_spec.rb
@@ -300,6 +330,7 @@ files:
 - spec/number_spec.rb
 - spec/spec_helper.rb
 - spec/string_spec.rb
+- spec/unix_spec.rb
 homepage: https://github.com/busyloop/blackbox
 licenses:
 - MPL 2.0
@@ -332,4 +363,5 @@ test_files:
 - spec/number_spec.rb
 - spec/spec_helper.rb
 - spec/string_spec.rb
+- spec/unix_spec.rb
 has_rdoc: