obfusk-util 0.0.1.SNAPSHOT.20130724235009 → 0.0.1.SNAPSHOT.20130725000153

data/.yardopts

@@ -0,0 +1 @@
+--markup markdown

data/Rakefile

@@ -0,0 +1,42 @@
+desc 'Run specs'
+task :spec do
+  sh 'rspec -c'
+end
+
+desc 'Run specs verbosely'
+task 'spec:verbose' do
+  sh 'rspec -cfd'
+end
+
+desc 'Run specs verbosely, view w/ less'
+task 'spec:less' do
+  sh 'rspec -cfd --tty | less -R'
+end
+
+desc 'Generate docs'
+task :docs do
+  sh 'yardoc | cat'
+end
+
+desc 'List undocumented objects'
+task 'docs:undoc' do
+  sh 'yard stats --list-undoc'
+end
+
+desc 'Cleanup'
+task :clean do
+  sh 'rm -rf .yardoc/ doc/ *.gem'
+end
+
+desc 'Build SNAPSHOT gem'
+task :snapshot do
+  v = Time.new.strftime '%Y%m%d%H%M%S'
+  f = 'lib/obfusk/util/version.rb'
+  sh "sed -ri~ 's!(SNAPSHOT)!\\1.#{v}!' #{f}"
+  sh 'gem build obfusk-util.gemspec'
+end
+
+desc 'Undo SNAPSHOT gem'
+task 'snapshot:undo' do
+  sh 'git checkout -- lib/obfusk/util/version.rb'
+end

data/lib/obfusk/util/version.rb

@@ -1,5 +1,5 @@
 # my namespace
 module Obfusk; module Util
-  VERSION = '0.0.1.SNAPSHOT.20130724235009'
+  VERSION = '0.0.1.SNAPSHOT.20130725000153'
   DATE    = '2013-07-24'
 end; end

data/obfusk-util.gemspec

@@ -19,8 +19,9 @@ Gem::Specification.new do |s|
 
   s.license     = 'GPLv2'
 
-  s.files       = %w{ README.md obfusk-util.gemspec }\
-                + Dir['lib/**/*.rb']
+  s.files       = %w{ .yardopts README.md Rakefile } \
+                + %w{ obfusk-util.gemspec } \
+                + Dir['{lib,spec}/**/*.rb']
 
   s.add_development_dependency 'rake'
   s.add_development_dependency 'rspec'

data/spec/obfusk/util/cmd_spec.rb

@@ -0,0 +1,94 @@
+# --                                                            ; {{{1
+#
+# File        : obfusk/util/cmd_spec.rb
+# Maintainer  : Felix C. Stegerman <flx@obfusk.net>
+# Date        : 2013-07-24
+#
+# Copyright   : Copyright (C) 2013  Felix C. Stegerman
+# Licence     : GPLv2
+#
+# --                                                            ; }}}1
+
+require 'obfusk/util/cmd'
+
+ouc = Obfusk::Util::Cmd
+
+describe 'obfusk/util/cmd' do
+
+  context 'killsig' do                                          # {{{1
+    it 'SIGINT' do
+      ouc.killsig('SIGINT foo bar').should == \
+        { command: 'foo bar', signal: 'SIGINT' }
+    end
+    it 'default' do
+      ouc.killsig('foo bar').should == \
+        { command: 'foo bar', signal: 'SIGTERM' }
+    end
+    it 'set default' do
+      ouc.killsig('foo bar', 'SIGINT').should == \
+        { command: 'foo bar', signal: 'SIGINT' }
+    end
+    it 'no match' do
+      ouc.killsig('SIGx foo bar').should == \
+        { command: 'SIGx foo bar', signal: 'SIGTERM' }
+    end
+  end                                                           # }}}1
+
+  context 'shell' do                                            # {{{1
+    it 'sh' do
+      ouc.shell('SHELL=sh foo bar').should == \
+        { command: 'foo bar', shell: 'sh' }
+    end
+    it 'default' do
+      ouc.shell('SHELL echo "$FOO: $BAR"').should == \
+        { command: 'echo "$FOO: $BAR"', shell: 'bash' }
+    end
+    it 'set default' do
+      ouc.shell('SHELL foo bar', 'mysh').should == \
+        { command: 'foo bar', shell: 'mysh' }
+    end
+    it 'no match' do
+      ouc.shell('SHELLx foo bar').should == \
+        { command: 'SHELLx foo bar', shell: nil }
+    end
+  end                                                           # }}}1
+
+  context 'nohup' do                                            # {{{1
+    it 'nohup' do
+      ouc.nohup(*%w{ foo bar baz }).should == \
+        %w{ nohup foo bar baz }
+    end
+  end                                                           # }}}1
+
+  context 'set_vars' do                                         # {{{1
+    it 'replace' do
+      ouc.set_vars('echo ${FOO} ... ${BAR} ...',
+                   'FOO' => 'foo', 'BAR' => 'bar').should == \
+        'echo foo ... bar ...'
+    end
+    it 'multiple' do
+      ouc.set_vars('echo ${FOO} ... ${FOO} ...',
+                   'FOO' => 'foo').should == \
+        'echo foo ... foo ...'
+    end
+    it 'missing' do
+      ouc.set_vars('echo ${FOO} ... ${BAR} ...',
+                   'BAR' => 'bar').should == \
+        'echo  ... bar ...'
+    end
+  end                                                           # }}}1
+
+  context 'env_to_a' do                                         # {{{1
+    it 'simple' do
+      ouc.env_to_a('FOO' => 'bar', 'PORT' => 1234).sort.should == \
+        ['PORT=1234', 'FOO="bar"'].sort
+    end
+    it 'nils' do
+      ouc.env_to_a('FOO' => 'bar', 'PORT' => nil).should == \
+        ['FOO="bar"']
+    end
+  end                                                           # }}}1
+
+end
+
+# vim: set tw=70 sw=2 sts=2 et fdm=marker :

data/spec/obfusk/util/data_spec.rb

@@ -0,0 +1,77 @@
+# --                                                            ; {{{1
+#
+# File        : obfusk/util/data_spec.rb
+# Maintainer  : Felix C. Stegerman <flx@obfusk.net>
+# Date        : 2013-07-24
+#
+# Copyright   : Copyright (C) 2013  Felix C. Stegerman
+# Licence     : GPLv2
+#
+# --                                                            ; }}}1
+
+require 'obfusk/util/data'
+
+module Obfusk::Util::Data__Spec
+  S = Struct.new :x, :y
+end
+
+ou = Obfusk::Util
+ds = ou::Data__Spec
+
+describe 'obfusk/util/data' do
+
+  context 'assoc' do                                            # {{{1
+    it 'assoc' do
+      x = { x: { y: 0 }, z: [1,2,3] }
+      ou.assoc(x, [:x,:y] => 1, [:z,1] => 99)
+      x[:x][:y].should == 1
+      x[:z].should == [1,99,3]
+    end
+  end                                                           # }}}1
+
+  context 'deepdup' do                                          # {{{1
+    it 'equal' do
+      x = { x: { y: 0 }, z: [1,2,3], s: ds::S.new(1,2) }
+      y = Obfusk::Util.deepdup x
+      x.should == y
+    end
+    it 'different objects' do
+      x = { x: { y: 0 }, z: [1,2,3], s: ds::S.new(1,2) }
+      y = Obfusk::Util.deepdup x
+      y[:x][:y] = 1 ; x[:x][:y].should == 0
+      y[:z][1]  = 99; x[:z][1].should == 2
+      y[:s].y   = 37; x[:s].y.should == 2
+    end
+  end                                                           # }}}1
+
+  context 'empty_as_nil' do                                     # {{{1
+    it 'nil' do
+      ou.empty_as_nil(nil).should == nil
+    end
+    it 'empty string' do
+      ou.empty_as_nil('').should == nil
+    end
+    it 'empty array' do
+      ou.empty_as_nil([]).should == nil
+    end
+    it 'not empty or nil' do
+      ou.empty_as_nil('foo').should == 'foo'
+    end
+    it 'real world example' do
+      env = { 'PORT' => '' }
+      (ou.empty_as_nil(env['PORT']) || 1234).should == 1234
+    end
+  end                                                           # }}}1
+
+  context 'h_to_struct' do                                      # {{{1
+    it 'h_to_struct' do
+      s = ou.h_to_struct({x:1,y:2})
+      s.members.sort.should == [:x,:y].sort
+      s.x.should == 1
+      s.y.should == 2
+    end
+  end                                                           # }}}1
+
+end
+
+# vim: set tw=70 sw=2 sts=2 et fdm=marker :

data/spec/obfusk/util/die_spec.rb

@@ -0,0 +1,73 @@
+# --                                                            ; {{{1
+#
+# File        : obfusk/util/die_spec.rb
+# Maintainer  : Felix C. Stegerman <flx@obfusk.net>
+# Date        : 2013-07-24
+#
+# Copyright   : Copyright (C) 2013  Felix C. Stegerman
+# Licence     : GPLv2
+#
+# --                                                            ; }}}1
+
+require 'obfusk/util/die'
+require 'obfusk/util/message'
+require 'obfusk/util/spec'
+
+ou = Obfusk::Util
+
+describe 'obfusk/util/die' do
+
+  context 'die!' do                                             # {{{1
+    it 'exit + messages' do
+      ou.capture_stderr do
+        expect { ou.die!(*%w{ foo bar baz }) } \
+          .to raise_error(SystemExit)
+      end .should == "Error: foo\nError: bar\nError: baz\n"
+    end
+    it 'default value' do
+      begin ou.capture_stderr { ou.die!('foo') }
+      rescue SystemExit => e; e; end .status .should == 1
+    end
+    it 'default value' do
+      begin ou.capture_stderr { ou.die!('foo', status: 42) }
+      rescue SystemExit => e; e; end .status .should == 42
+    end
+  end                                                           # }}}1
+
+  context 'udie!' do                                            # {{{1
+    usage = 'prog [<opt(s)>]'
+    it 'exit + messages' do
+      ou.capture_stderr do
+        expect { ou.udie!(usage, *%w{ foo bar }) } \
+          .to raise_error(SystemExit)
+      end .should == "Error: foo\nError: bar\nUsage: #{usage}\n"
+    end
+    it 'default value' do
+      begin ou.capture_stderr { ou.udie!(usage) }
+      rescue SystemExit => e; e; end .status .should == 1
+    end
+    it 'default value' do
+      begin ou.capture_stderr { ou.udie!(usage, status: 42) }
+      rescue SystemExit => e; e; end .status .should == 42
+    end
+  end                                                           # }}}1
+
+  context 'odie!' do                                            # {{{1
+    it 'exit + message' do
+      ou.capture_stderr do
+        expect { ou.odie!('foo!') } .to raise_error(SystemExit)
+      end .should == "Error: foo!\n"
+    end
+    it 'default value' do
+      begin ou.capture_stderr { ou.odie!('foo!') }
+      rescue SystemExit => e; e; end .status .should == 1
+    end
+    it 'default value' do
+      begin ou.capture_stderr { ou.odie!('foo!', status: 42) }
+      rescue SystemExit => e; e; end .status .should == 42
+    end
+  end                                                           # }}}1
+
+end
+
+# vim: set tw=70 sw=2 sts=2 et fdm=marker :

data/spec/obfusk/util/fs_spec.rb

@@ -0,0 +1,95 @@
+# --                                                            ; {{{1
+#
+# File        : obfusk/util/fs_spec.rb
+# Maintainer  : Felix C. Stegerman <flx@obfusk.net>
+# Date        : 2013-07-24
+#
+# Copyright   : Copyright (C) 2013  Felix C. Stegerman
+# Licence     : GPLv2
+#
+# --                                                            ; }}}1
+
+require 'obfusk/util/fs'
+require 'obfusk/util/message'
+
+require 'fileutils'
+require 'tmpdir'
+
+ou = Obfusk::Util
+fs = Obfusk::Util::FS
+
+describe 'obfusk/util/fs' do
+
+  context 'append' do                                           # {{{1
+    it 'new file' do
+      Dir.mktmpdir do |dir|
+        fs.append "#{dir}/testfile", %w{ foo bar baz }
+        File.read("#{dir}/testfile").should == "foo\nbar\nbaz\n"
+      end
+    end
+    it 'existing file' do
+      Dir.mktmpdir do |dir|
+        File.write "#{dir}/testfile", "some data\n"
+        fs.append "#{dir}/testfile", %w{ foo bar baz }
+        File.read("#{dir}/testfile").should == \
+          "some data\nfoo\nbar\nbaz\n"
+      end
+    end
+  end                                                           # }}}1
+
+  context 'exists?' do                                          # {{{1
+    it 'existing file' do
+      Dir.mktmpdir do |dir|
+        FileUtils.touch "#{dir}/testfile"
+        fs.exists?("#{dir}/testfile").should be_true
+      end
+    end
+    it 'existing link' do
+      Dir.mktmpdir do |dir|
+        FileUtils.touch "#{dir}/target"
+        File.symlink "#{dir}/target", "#{dir}/symlink"
+        fs.exists?("#{dir}/symlink").should be_true
+      end
+    end
+    it 'existing dir' do
+      Dir.mktmpdir do |dir|
+        fs.exists?(dir).should be_true
+      end
+    end
+    it 'non-existing file' do
+      Dir.mktmpdir do |dir|
+        fs.exists?("#{dir}/testfile").should be_false
+      end
+    end
+    it 'non-existing link' do
+      Dir.mktmpdir do |dir|
+        fs.exists?("#{dir}/symlink").should be_false
+      end
+    end
+    it 'non-existing dir' do
+      Dir.mktmpdir do |dir|
+        fs.exists?("#{dir}/nonexistent").should be_false
+      end
+    end
+    it 'broken link' do
+      Dir.mktmpdir do |dir|
+        File.symlink "#{dir}/target", "#{dir}/symlink"
+        fs.exists?("#{dir}/symlink").should be_true
+      end
+    end
+  end                                                           # }}}1
+
+  context 'omkdir_p' do                                         # {{{1
+    it 'exists + message' do
+      Dir.mktmpdir do |dir|
+        dirs = %w{ foo bar baz }.map { |x| "#{dir}/#{x}" }
+        ou.capture_stdout { fs.omkdir_p(*dirs) } \
+          .should == "==> mkdir -p #{dirs*' '}\n"
+        dirs.each { |d| Dir.exists?(d).should be_true }
+      end
+    end
+  end                                                           # }}}1
+
+end
+
+# vim: set tw=70 sw=2 sts=2 et fdm=marker :

data/spec/obfusk/util/message_spec.rb

@@ -0,0 +1,67 @@
+# --                                                            ; {{{1
+#
+# File        : obfusk/util/message_spec.rb
+# Maintainer  : Felix C. Stegerman <flx@obfusk.net>
+# Date        : 2013-07-24
+#
+# Copyright   : Copyright (C) 2013  Felix C. Stegerman
+# Licence     : GPLv2
+#
+# --                                                            ; }}}1
+
+require 'obfusk/util/message'
+require 'obfusk/util/spec'
+
+ou = Obfusk::Util
+
+describe 'obfusk/util/message' do
+
+  context 'ohai' do                                             # {{{1
+    it 'no colours' do
+      ou.capture_stdout { ou.ohai 'hi there!' } .should == \
+        "==> hi there!\n"
+    end
+    it 'colours' do
+      ou.capture_stdout(:tty) { ou.ohai 'hi there!' } \
+        .should == "\e[1;34m==> \e[1;37mhi there!\e[0m\n"
+    end
+  end                                                           # }}}1
+
+  context 'onow' do                                             # {{{1
+    it 'no colours' do
+      ou.capture_stdout { ou.onow 'Do', *%w{ foo bar } } .should == \
+        "==> Do: foo, bar\n"
+    end
+    it 'colours' do
+      ou.capture_stdout(:tty) { ou.onow 'Do', *%w{ foo bar } } \
+        .should == "\e[1;32m==> \e[1;37mDo\e[0m: " +
+                   "\e[1;32mfoo\e[0m, \e[1;32mbar\e[0m\n"
+    end
+  end                                                           # }}}1
+
+  context 'onoe' do                                             # {{{1
+    it 'no colours' do
+      ou.capture_stderr { ou.onoe 'oops!' } .should == \
+        "Error: oops!\n"
+    end
+    it 'colours' do
+      ou.capture_stderr(:tty) { ou.onoe 'oops!' } \
+        .should == "\e[1;31mError\e[0m: oops!\n"
+    end
+    it 'logger' do
+      log = []; l = ->(msg) { log << msg }
+      ou.capture_stderr { ou.onoe 'oops!', log: l }
+      log.should == ['Error: oops!']
+    end
+  end                                                           # }}}1
+
+  context 'opoo' do                                             # {{{1
+    it 'label' do
+      ou.capture_stderr { ou.opoo 'oops!' } .should == \
+        "Warning: oops!\n"
+    end
+  end                                                           # }}}1
+
+end
+
+# vim: set tw=70 sw=2 sts=2 et fdm=marker :

data/spec/obfusk/util/misc_spec.rb

@@ -0,0 +1 @@
+# nothing to test yet

data/spec/obfusk/util/module_spec.rb

@@ -0,0 +1,56 @@
+# --                                                            ; {{{1
+#
+# File        : obfusk/util/module_spec.rb
+# Maintainer  : Felix C. Stegerman <flx@obfusk.net>
+# Date        : 2013-07-24
+#
+# Copyright   : Copyright (C) 2013  Felix C. Stegerman
+# Licence     : GPLv2
+#
+# --                                                            ; }}}1
+
+require 'obfusk/util/module'
+
+require 'fileutils'
+require 'tmpdir'
+
+module Obfusk::Util::Module__Spec
+  module Foo; end; module Bar; end
+end
+
+ou = Obfusk::Util
+ms = ou::Module__Spec
+
+describe 'obfusk/util/module' do
+
+  context 'require_all' do                                      # {{{1
+    it 'require_all' do
+      Dir.mktmpdir do |dir|
+        d = "#{dir}/obfusk/util/spec__"
+        FileUtils.mkdir_p d
+        %w{ foo bar }.each do |x|
+          File.write "#{d}/#{x}.rb",
+            "module #{ms}::#{x.capitalize}; VALUE = '#{x}'; end"
+        end
+        $:.unshift dir
+        begin
+          ou.require_all 'obfusk/util/spec__'
+          ms::Foo::VALUE.should == 'foo'
+          ms::Bar::VALUE.should == 'bar'
+        ensure
+          $:.shift
+        end
+      end
+    end
+  end                                                           # }}}1
+
+  context 'submodules' do                                       # {{{1
+    it 'submodules' do
+      ou.submodules(ms).should == \
+        { 'foo' => ms::Foo, 'bar' => ms::Bar }
+    end
+  end                                                           # }}}1
+
+end
+
+# vim: set tw=70 sw=2 sts=2 et fdm=marker :

data/spec/obfusk/util/opt_spec.rb

@@ -0,0 +1,48 @@
+# --                                                            ; {{{1
+#
+# File        : obfusk/util/opt_spec.rb
+# Maintainer  : Felix C. Stegerman <flx@obfusk.net>
+# Date        : 2013-07-24
+#
+# Copyright   : Copyright (C) 2013  Felix C. Stegerman
+# Licence     : GPLv2
+#
+# --                                                            ; }}}1
+
+require 'obfusk/util/opt'
+
+op = Obfusk::Util::Opt
+
+describe 'obfusk/util/opt' do
+
+  context 'Parser' do                                           # {{{1
+    it 'parse_r' do
+      x = nil
+      p = op::Parser.new do |o|
+        o.on('--help', 'Show help') { x = 'HELP' }
+      end
+      args1 = %w{ foo --help bar }; args2 = p.parse_r args1
+      x.should == 'HELP'
+      args1.should == %w{ foo --help bar }
+      args2.should == %w{ foo bar }
+    end
+    it 'no officious' do
+      expect { op::Parser.new.parse_r %w{ --help } } .to \
+        raise_error(OptionParser::InvalidOption, /--help/)
+    end
+  end                                                           # }}}1
+
+  context 'parse' do                                            # {{{1
+    it 'parse' do
+      p = op::Parser.new do |o|
+        o.on('--help', 'Show help') {}
+      end
+      args1 = %w{ foo --help bar }; args2 = op.parse p, args1
+      args1.should == %w{ foo --help bar }
+      args2.should == %w{ foo bar }
+    end
+  end                                                           # }}}1
+
+end
+
+# vim: set tw=70 sw=2 sts=2 et fdm=marker :

data/spec/obfusk/util/os_spec.rb

@@ -0,0 +1,41 @@
+# --                                                            ; {{{1
+#
+# File        : obfusk/util/os_spec.rb
+# Maintainer  : Felix C. Stegerman <flx@obfusk.net>
+# Date        : 2013-07-24
+#
+# Copyright   : Copyright (C) 2013  Felix C. Stegerman
+# Licence     : GPLv2
+#
+# --                                                            ; }}}1
+
+require 'obfusk/util/os'
+
+os = Obfusk::Util::OS
+
+describe 'obfusk/util/os' do
+
+  context 'home' do                                             # {{{1
+    it 'my home' do
+      os.home.should == ENV['HOME']                             # ????
+    end
+    it 'root' do
+      os.home('root').should == '/root'                         # ????
+    end
+  end                                                           # }}}1
+
+  context 'user' do                                             # {{{1
+    it 'user' do
+      os.user.should == ENV['USER']                             # ????
+    end
+  end                                                           # }}}1
+
+  context 'now' do                                              # {{{1
+    it 'now' do
+      os.now.should match /^\d\d\d\d-\d\d-\d\d \d\d:\d\d:\d\d$/
+    end
+  end                                                           # }}}1
+
+end
+
+# vim: set tw=70 sw=2 sts=2 et fdm=marker :

data/spec/obfusk/util/process_spec.rb

@@ -0,0 +1,60 @@
+# --                                                            ; {{{1
+#
+# File        : obfusk/util/process_spec.rb
+# Maintainer  : Felix C. Stegerman <flx@obfusk.net>
+# Date        : 2013-07-24
+#
+# Copyright   : Copyright (C) 2013  Felix C. Stegerman
+# Licence     : GPLv2
+#
+# --                                                            ; }}}1
+
+require 'obfusk/util/process'
+
+pr = Obfusk::Util::Process
+
+describe 'obfusk/util/process' do
+
+  context 'age' do                                              # {{{1
+    it 'age' do
+      pid = spawn 'sleep 100'
+      begin
+        pr.age(pid).should match /^00:0\d$/                     # ????
+      ensure
+        Process.kill 'TERM', pid; Process.wait pid
+      end
+    end
+  end                                                           # }}}1
+
+  context 'alive' do                                            # {{{1
+    it 'alive' do
+      pid = spawn 'sleep 100'
+      begin
+        pr.alive?(pid).should == true
+      ensure
+        Process.kill 'TERM', pid; Process.wait pid
+      end
+    end
+    it 'not alive' do
+      pid = spawn 'sleep 100'
+      Process.kill 'TERM', pid; Process.wait pid
+      pr.alive?(pid).should == false
+    end
+    it 'not mine' do
+      pr.alive?(1).should == :not_mine  # init should be alive  # ????
+    end
+  end                                                           # }}}1
+
+  context 'ispid!' do                                           # {{{1
+    it 'pid' do
+      pr.ispid!(12345).should be_true
+    end
+    it 'not a pid' do
+      expect { pr.ispid!('12345') } .to \
+        raise_error(ArgumentError, 'invalid PID')
+    end
+  end                                                           # }}}1
+
+end
+
+# vim: set tw=70 sw=2 sts=2 et fdm=marker :

data/spec/obfusk/util/run_spec.rb

@@ -0,0 +1,134 @@
+# --                                                            ; {{{1
+#
+# File        : obfusk/util/run_spec.rb
+# Maintainer  : Felix C. Stegerman <flx@obfusk.net>
+# Date        : 2013-07-24
+#
+# Copyright   : Copyright (C) 2013  Felix C. Stegerman
+# Licence     : GPLv2
+#
+# --                                                            ; }}}1
+
+require 'obfusk/util/message'
+require 'obfusk/util/run'
+
+ou = Obfusk::Util
+
+describe 'obfusk/util/run' do
+
+  context 'exec' do                                             # {{{1
+    it 'succeed' do
+      r, w = IO.pipe
+      pid = fork do
+        r.close; ou.exec 'bash', '-c', 'echo $FOO',
+          env: { 'FOO' => 'foo' }, out: w
+      end
+      w.close; Process.wait pid; x = r.read; r.close
+      x.should == "foo\n"
+      $?.exitstatus.should == 0
+    end
+    it 'fail (no shell)' do
+      expect { ou.exec 'echo THIS IS NOT A COMMAND' } .to \
+        raise_error(ou::RunError, /No such file or directory/)  # ????
+    end
+  end                                                           # }}}1
+
+  context 'spawn' do                                            # {{{1
+    it 'succeed' do
+      r, w = IO.pipe
+      pid = ou.spawn 'bash', '-c', 'echo $FOO; pwd',
+        env: { 'FOO' => 'foo' }, out: w, chdir: '/'
+      w.close; Process.wait pid; x = r.read; r.close
+      x.should == "foo\n/\n"
+      $?.exitstatus.should == 0
+    end
+    it 'fail (no shell)' do
+      expect { ou.spawn 'echo THIS IS NOT A COMMAND' } .to \
+        raise_error(ou::RunError, /No such file or directory/)  # ????
+    end
+  end                                                           # }}}1
+
+  context 'spawn_w' do                                          # {{{1
+    it 'succeed' do
+      r, w = IO.pipe
+      res = ou.spawn_w 'bash', '-c', 'echo $FOO; pwd',
+        env: { 'FOO' => 'foo' }, out: w, chdir: '/'
+      w.close; x = r.read; r.close
+      x.should == "foo\n/\n"
+      res.exitstatus.should == 0
+    end
+    it 'fail (no shell)' do
+      expect { ou.spawn_w 'echo THIS IS NOT A COMMAND' } .to \
+        raise_error(ou::RunError, /No such file or directory/)  # ????
+    end
+  end                                                           # }}}1
+
+  context 'system' do                                           # {{{1
+    it 'succeed' do
+      r, w = IO.pipe
+      res = ou.system 'bash', '-c', 'echo $FOO; pwd',
+        env: { 'FOO' => 'foo' }, out: w, chdir: '/'
+      w.close; x = r.read; r.close
+      x.should == "foo\n/\n"
+      res.should == true
+    end
+    it 'fail (no shell)' do
+      expect { ou.system 'echo THIS IS NOT A COMMAND' } .to \
+        raise_error(ou::RunError, /failed to run command/)
+    end
+  end                                                           # }}}1
+
+  context 'popen3' do                                           # {{{1
+    it 'succeed' do
+      ou.popen3 'bash', '-c', 'echo $FOO >&2; pwd',
+                env: { 'FOO' => 'foo' }, chdir: '/' do |i,o,e,t|
+        i.close
+        t.value.exitstatus.should == 0
+        o.read.should == "/\n"
+        e.read.should == "foo\n"
+      end
+    end
+    it 'fail (no shell)' do
+      expect { ou.popen3 'echo THIS IS NOT A COMMAND' } .to \
+        raise_error(ou::RunError, /No such file or directory/)  # ????
+    end
+  end                                                           # }}}1
+
+  context 'ospawn' do                                            # {{{1
+    it 'colour' do
+      r, w = IO.pipe
+      ou.capture_stdout(:tty) do
+        pid = ou.ospawn *%w{ echo FOO }, out: w
+        w.close; Process.wait pid; x = r.read; r.close
+        x.should == "FOO\n"
+        $?.exitstatus.should == 0
+      end .should == "\e[1;34m==> \e[1;37mecho FOO\e[0m\n"
+    end
+  end                                                           # }}}1
+
+  context 'ospawn_w' do                                          # {{{1
+    it 'colour' do
+      r, w = IO.pipe
+      ou.capture_stdout(:tty) do
+        res = ou.ospawn_w *%w{ echo FOO }, out: w
+        w.close; x = r.read; r.close
+        x.should == "FOO\n"
+        res.exitstatus.should == 0
+      end .should == "\e[1;34m==> \e[1;37mecho FOO\e[0m\n"
+    end
+  end                                                           # }}}1
+
+  context 'chk_exit' do                                          # {{{1
+    it 'zero' do
+      expect { ou.chk_exit(%w{ true }) { |a| ou.spawn_w *a } } \
+        .to_not raise_error
+    end
+    it 'non-zero' do
+      expect { ou.chk_exit(%w{ false }) { |a| ou.spawn_w *a } } \
+        .to raise_error(ou::RunError, /command returned non-zero/)
+    end
+  end                                                           # }}}1
+
+end
+
+# vim: set tw=70 sw=2 sts=2 et fdm=marker :

data/spec/obfusk/util/spec_spec.rb

@@ -0,0 +1,66 @@
+# --                                                            ; {{{1
+#
+# File        : obfusk/util/spec_spec.rb
+# Maintainer  : Felix C. Stegerman <flx@obfusk.net>
+# Date        : 2013-07-24
+#
+# Copyright   : Copyright (C) 2013  Felix C. Stegerman
+# Licence     : GPLv2
+#
+# --                                                            ; }}}1
+
+require 'obfusk/util/spec'
+
+ou = Obfusk::Util
+
+describe 'obfusk/util/spec' do
+
+  context 'provide_stdin' do                                    # {{{1
+    it 'stdin + reset' do
+      old = $stdin
+      ou.provide_stdin("foo\nbar\nbaz\n") do
+        $stdin.readlines.map(&:chomp)
+      end .should == %w{ foo bar baz }
+      $stdin.should == old
+    end
+    it 'reset on error' do
+      err = Class.new RuntimeError; old = $stdin
+      begin ou.provide_stdin('') { raise err, 'OOPS' }
+      rescue err; end
+      $stdin.should == old
+    end
+  end                                                           # }}}1
+
+  context 'capture_stdout' do                                   # {{{1
+    it 'stdout + reset' do
+      old = $stdout
+      ou.capture_stdout { puts %w{ foo bar baz } } \
+        .should == "foo\nbar\nbaz\n"
+      $stdout.should == old
+    end
+    it 'reset on error' do
+      err = Class.new RuntimeError; old = $stdout
+      begin ou.capture_stdout { raise err, 'OOPS' }
+      rescue err; end
+      $stdout.should == old
+    end
+  end                                                           # }}}1
+
+  context 'capture_stderr' do                                   # {{{1
+    it 'stderr + reset' do
+      old = $stderr
+      ou.capture_stderr { $stderr.puts %w{ foo bar baz } } \
+        .should == "foo\nbar\nbaz\n"
+      $stderr.should == old
+    end
+    it 'reset on error' do
+      err = Class.new RuntimeError; old = $stderr
+      begin ou.capture_stderr { raise err, 'OOPS' }
+      rescue err; end
+      $stderr.should == old
+    end
+  end                                                           # }}}1
+
+end
+
+# vim: set tw=70 sw=2 sts=2 et fdm=marker :

data/spec/obfusk/util/struct_spec.rb

@@ -0,0 +1,71 @@
+# --                                                            ; {{{1
+#
+# File        : obfusk/util/struct_spec.rb
+# Maintainer  : Felix C. Stegerman <flx@obfusk.net>
+# Date        : 2013-07-24
+#
+# Copyright   : Copyright (C) 2013  Felix C. Stegerman
+# Licence     : GPLv2
+#
+# --                                                            ; }}}1
+
+require 'obfusk/util/struct'
+
+ou = Obfusk::Util
+
+struct = ->() {
+  ou.struct(*%w{ f1 f2 f3 }) do
+    def some_method; f1 + f2; end
+  end
+}
+
+describe 'obfusk/util/struct' do
+
+  context 'struct' do                                           # {{{1
+    it 'new' do
+      s = struct[]; foo = s.new f1: 37, f2: 5
+      foo.some_method.should == 42
+      foo.f1.should == 37
+      foo.f2.should == 5
+      foo.f3.should == nil
+    end
+    it 'build' do
+      s = struct[]; bar = s.build(f1: 99) { |x| x.f2 = 1 }
+      bar.some_method.should == 100
+      bar.f1.should == 99
+      bar.f2.should == 1
+      bar.f3.should == nil
+    end
+    it 'no other fields to get' do
+      s = struct[]; bar = s.new
+      expect { bar.oops } .to \
+        raise_error(NoMethodError, /undefined method.*`oops'/)
+    end
+    it 'no other fields to set' do
+      s = struct[]; bar = s.new
+      expect { bar.oops = 99 } .to \
+        raise_error(NoMethodError, /undefined method.*`oops='/)
+    end
+    it 'frozen' do
+      s = struct[]; bar = s.build { |x| x.f2 = 1 }
+      expect { bar.f1 = 99 } .to \
+        raise_error(RuntimeError, /can't modify frozen/)
+    end
+    it 'check!' do
+      s = struct[]; bar = s.build { |x| x.f2 = 1 }
+      expect { bar.check! } .to \
+        raise_error(ou::BetterStruct::IncompleteError, /empty field/)
+    end
+    it 'to_h' do
+      s = struct[]; bar = s.new(f1: 'hi!')
+      bar.to_h.should == { f1: 'hi!', f2: nil, f3: nil }
+    end
+    it 'to_str_h' do
+      s = struct[]; bar = s.new(f1: 'hi!')
+      bar.to_str_h.should == { 'f1'=>'hi!', 'f2'=>nil, 'f3'=>nil }
+    end
+  end                                                           # }}}1
+
+end
+
+# vim: set tw=70 sw=2 sts=2 et fdm=marker :

data/spec/obfusk/util/term_spec.rb

@@ -0,0 +1,104 @@
+# --                                                            ; {{{1
+#
+# File        : obfusk/util/term_spec.rb
+# Maintainer  : Felix C. Stegerman <flx@obfusk.net>
+# Date        : 2013-07-24
+#
+# Copyright   : Copyright (C) 2013  Felix C. Stegerman
+# Licence     : GPLv2
+#
+# --                                                            ; }}}1
+
+require 'obfusk/util/term'
+
+ou = Obfusk::Util
+te = Obfusk::Util::Term
+
+describe 'obfusk/util/term' do
+
+  context 'colour' do                                           # {{{1
+    it 'no tty' do
+      ou.capture_stdout { te.colour(:red) } .should == ''
+    end
+    it 'no such colour' do
+      expect { te.colour(:octarine) } .to \
+        raise_error(ArgumentError, /No such colour/)
+    end
+    it 'red, blue, green' do
+      ou.capture_stdout(:tty) do
+        te.colour(:red)   .should == "\e[0;31m"
+        te.colour(:blue)  .should == "\e[0;34m"
+        te.colour(:green) .should == "\e[0;32m"
+      end
+    end
+    it 'red, blue, green (stderr)' do
+      ou.capture_stderr(:tty) do
+        te.colour_e(:red)   .should == "\e[0;31m"
+        te.colour_e(:blue)  .should == "\e[0;34m"
+        te.colour_e(:green) .should == "\e[0;32m"
+      end
+    end
+  end                                                           # }}}1
+
+  context 'columns' do                                          # {{{1
+    it 'columns' do
+      old = ENV['COLUMNS']; ENV['COLUMNS'] = '17'
+      begin te.columns.should == 17
+      ensure ENV['COLUMNS'] = old end
+    end
+  end                                                           # }}}1
+
+  context 'lines' do                                            # {{{1
+    it 'lines' do
+      old = ENV['LINES']; ENV['LINES'] = '71'
+      begin te.lines.should == 71
+      ensure ENV['LINES'] = old end
+    end
+  end                                                           # }}}1
+
+  context 'tty?' do                                             # {{{1
+    it 'stdout tty' do
+      ou.capture_stdout(:tty) { te.tty?.should be_true }
+    end
+    it 'stderr tty' do
+      ou.capture_stderr(:tty) { te.tty?(:err).should be_true }
+    end
+    it 'stdout no tty' do
+      ou.capture_stdout { te.tty?.should be_false }
+    end
+    it 'stderr no tty' do
+      ou.capture_stderr { te.tty?(:err).should be_false }
+    end
+  end                                                           # }}}1
+
+  context 'prompt' do                                           # {{{1
+    it 'normal' do
+      ou.provide_stdin("foo!\n") do
+        ou.capture_stdout do
+          name = te.prompt 'name? '
+          name.should == 'foo!'
+        end .should == 'name? '
+      end
+    end
+    it 'no newline' do
+      ou.provide_stdin('foo!') do
+        ou.capture_stdout do
+          name = te.prompt 'name? '
+          name.should == 'foo!'
+        end .should == 'name? '
+      end
+    end
+    it 'hide' do
+      ou.provide_stdin('foo!') do
+        def $stdin.noecho(&b) b[self] end    # mock!
+        ou.capture_stdout do
+          name = te.prompt 'name? ', :hide
+          name.should == 'foo!'
+        end .should == "name? \n"
+      end
+    end
+  end                                                           # }}}1
+
+end
+
+# vim: set tw=70 sw=2 sts=2 et fdm=marker :

data/spec/obfusk/util/valid_spec.rb

@@ -0,0 +1,65 @@
+# --                                                            ; {{{1
+#
+# File        : obfusk/util/valid_spec.rb
+# Maintainer  : Felix C. Stegerman <flx@obfusk.net>
+# Date        : 2013-07-24
+#
+# Copyright   : Copyright (C) 2013  Felix C. Stegerman
+# Licence     : GPLv2
+#
+# --                                                            ; }}}1
+
+require 'obfusk/util/valid'
+
+va = Obfusk::Util::Valid
+
+describe 'obfusk/util/valid' do
+
+  context 'args' do                                             # {{{1
+    it 'max = min' do
+      expect { va.args 'foo', %w{ a b c }, 3 } .to_not raise_error
+    end
+    it 'max + min' do
+      expect { va.args 'foo', %w{ a b c }, 1, 4 } .to_not raise_error
+      expect { va.args 'foo', %w{ a b c }, 2, 3 } .to_not raise_error
+      expect { va.args 'foo', %w{ a b c }, 3, 4 } .to_not raise_error
+      expect { va.args 'foo', %w{ a b c }, 3, 3 } .to_not raise_error
+    end
+    it 'no max' do
+      expect { va.args 'foo', %w{ a b }, 1, nil } .to_not raise_error
+      expect { va.args 'foo', %w{ a b }, 2, nil } .to_not raise_error
+    end
+    it 'max = min (invalid)' do
+      expect { va.args 'foo', %w{ a b c }, 2 } .to \
+        raise_error(va::ArgumentError)
+      expect { va.args 'foo', %w{ a b c }, 4 } .to \
+        raise_error(va::ArgumentError)
+    end
+    it 'max + min (invalid)' do
+      expect { va.args 'foo', %w{ a b c }, 1, 2 } .to \
+        raise_error(va::ArgumentError)
+      expect { va.args 'foo', %w{ a b c }, 4, 5 } .to \
+        raise_error(va::ArgumentError)
+    end
+    it 'no max (invalid)' do
+      expect { va.args 'foo', %w{ a b }, 3, nil } .to \
+        raise_error(va::ArgumentError)
+    end
+  end                                                           # }}}1
+
+  context 'validate!' do                                        # {{{1
+    it 'nil' do
+      expect { va.validate! nil, /.*/, '...' } .to_not raise_error
+    end
+    it 'valid' do
+      expect { va.validate! 'foo', /fo+/, '...' } .to_not raise_error
+    end
+    it 'invalid' do
+      expect { va.validate! 'f', /fo+/, 'oops' } .to \
+        raise_error(va::ValidationError, 'invalid oops')
+    end
+  end                                                           # }}}1
+
+end
+
+# vim: set tw=70 sw=2 sts=2 et fdm=marker :

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: obfusk-util
 version: !ruby/object:Gem::Version
-  version: 0.0.1.SNAPSHOT.20130724235009
+  version: 0.0.1.SNAPSHOT.20130725000153
   prerelease: 6
 platform: ruby
 authors:
@@ -13,7 +13,7 @@ date: 2013-07-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &7444640 !ruby/object:Gem::Requirement
+  requirement: &14769780 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *7444640
+  version_requirements: *14769780
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &7443620 !ruby/object:Gem::Requirement
+  requirement: &14764420 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,7 +32,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *7443620
+  version_requirements: *14764420
 description: ! 'miscellaneous utility library for ruby
 
 
@@ -45,7 +45,9 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- .yardopts
 - README.md
+- Rakefile
 - obfusk-util.gemspec
 - lib/obfusk/util/message.rb
 - lib/obfusk/util/struct.rb
@@ -64,6 +66,21 @@ files:
 - lib/obfusk/util/die.rb
 - lib/obfusk/util/module.rb
 - lib/obfusk/util/cmd.rb
+- spec/obfusk/util/misc_spec.rb
+- spec/obfusk/util/fs_spec.rb
+- spec/obfusk/util/opt_spec.rb
+- spec/obfusk/util/message_spec.rb
+- spec/obfusk/util/os_spec.rb
+- spec/obfusk/util/module_spec.rb
+- spec/obfusk/util/data_spec.rb
+- spec/obfusk/util/struct_spec.rb
+- spec/obfusk/util/valid_spec.rb
+- spec/obfusk/util/cmd_spec.rb
+- spec/obfusk/util/die_spec.rb
+- spec/obfusk/util/term_spec.rb
+- spec/obfusk/util/process_spec.rb
+- spec/obfusk/util/spec_spec.rb
+- spec/obfusk/util/run_spec.rb
 homepage: https://github.com/obfusk/rb-obfusk-util
 licenses:
 - GPLv2