slop 3.4.1 → 3.4.2

data/CHANGES.md

@@ -1,3 +1,10 @@
+3.4.2 (2013-01-14)
+------------------
+
+* Expose the Hash commands as public API.
+* Deprecated `Slop.optspec`.
+* Ensure help output prints to stdout, not stderr.
+
 3.4.1 (2013-01-13)
 ------------------
 

data/lib/slop.rb

@@ -4,7 +4,7 @@ require 'slop/commands'
 class Slop
   include Enumerable
 
-  VERSION = '3.4.1'
+  VERSION = '3.4.2'
 
   # The main Error class, all Exception classes inherit from this class.
   class Error < StandardError; end
@@ -91,6 +91,7 @@ class Slop
     #
     # Returns a new instance of Slop.
     def optspec(string, config = {})
+      warn "[DEPRECATED] `Slop.optspec` is deprecated and will be removed in version 4"
       config[:banner], optspec = string.split(/^--+$/, 2) if string[/^--+$/]
       lines = optspec.split("\n").reject(&:empty?)
       opts  = Slop.new(config)
@@ -117,6 +118,9 @@ class Slop
   # The Array of Slop::Option objects tied to this Slop instance.
   attr_reader :options
 
+  # The Hash of sub-commands for this Slop instance.
+  attr_reader :commands
+
   # Create a new instance of Slop and optionally build options via a block.
   #
   # config - A Hash of configuration options.
@@ -139,7 +143,7 @@ class Slop
 
     if config[:help]
       on('-h', '--help', 'Display this help message.', :tail => true) do
-        $stderr.puts help
+        puts help
       end
     end
   end

data/slop.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name        = 'slop'
-  s.version     = '3.4.1'
+  s.version     = '3.4.2'
   s.summary     = 'Option gathering made easy'
   s.description = 'A simple DSL for gathering options and parsing the command line'
   s.author      = 'Lee Jarvis'

data/test/slop_test.rb

@@ -16,11 +16,11 @@ class SlopTest < TestCase
     ARGV.replace old_argv
   end
 
-  def temp_stderr
-    $stderr = StringIO.new
-    yield $stderr.string
+  def temp_stdout
+    $stdout = StringIO.new
+    yield $stdout.string
   ensure
-    $stderr = STDERR
+    $stdout = STDOUT
   end
 
   test "includes Enumerable" do
@@ -330,13 +330,13 @@ class SlopTest < TestCase
   end
 
   test "printing help with :help => true" do
-    temp_stderr do |string|
+    temp_stdout do |string|
       opts = Slop.new(:help => true, :banner => false)
       opts.parse %w( --help )
       assert_equal "    -h, --help      Display this help message.\n", string
     end
 
-    temp_stderr do |string|
+    temp_stdout do |string|
       opts = Slop.new(:help => true)
       opts.parse %w( --help )
       assert_equal "Usage: rake_test_loader [options]\n    -h, --help      Display this help message.\n", string

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: slop
 version: !ruby/object:Gem::Version
-  version: 3.4.1
+  version: 3.4.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-13 00:00:00.000000000 Z
+date: 2013-01-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake