choosy 0.3.0 → 0.3.1

data/Gemfile

@@ -1,7 +1,3 @@
 source "http://rubygems.org"
+gemspec
 
-group :development do
-  gem 'rspec', :require => "spec"
-  gem 'autotest'
-  gem 'autotest-notification'
-end

data/Gemfile.lock

@@ -1,3 +1,8 @@
+PATH
+  remote: .
+  specs:
+    choosy ()
+
 GEM
   remote: http://rubygems.org/
   specs:
@@ -22,4 +27,5 @@ PLATFORMS
 DEPENDENCIES
   autotest
   autotest-notification
-  rspec
+  choosy!
+  rspec (~> 2.5)

data/Rakefile

@@ -1,32 +1,23 @@
-# $LOAD_PATH.unshift File.expand_path("../lib", __FILE__)
-# $LOAD_PATH.unshift File.expand_path("../spec", __FILE__)
+begin
+  require 'choosy/versiontask'
+rescue LoadError => e
+  $LOAD_PATH.unshift File.join(File.dirname(__FILE__), 'lib')
+  require 'choosy/versiontask'
+end
 
 require 'rubygems'
 require 'rake'
-#require 'rake/rdoctask'
 require 'rspec/core/rake_task'
-require './lib/choosy/version'
+require 'bundler'
+Bundler::GemHelper.install_tasks
 
 PACKAGE_NAME = "choosy"
-PACKAGE_VERSION = Choosy::Version.new(File.join(File.dirname(__FILE__), 'lib', 'VERSION.yml'))
 
 desc "Default task"
 task :default => [ :spec ]
 
-namespace :version do
-  desc "Tiny bump"
-  task :tiny do
-    PACKAGE_VERSION.version!(:tiny)
-  end
-  desc "Minor bump"
-  task :minor do
-    PACKAGE_VERSION.version!(:minor)
-  end
-  desc "Major bump"
-  task :major do
-    PACKAGE_VERSION.version!(:major)
-  end
-end
+desc "Run the RSpec tests"
+RSpec::Core::RakeTask.new :spec
 
 desc "Build documentation"
 task :doc => [ :rdoc ] do
@@ -58,27 +49,6 @@ end
 desc "Create RDocs: TODO"
 task :rdoc
 
-desc "Run the RSpec tests"
-RSpec::Core::RakeTask.new :spec
-
-begin
-  require 'jeweler'
-  Jeweler::Tasks.new do |gem|
-    gem.name           = PACKAGE_NAME
-    gem.version        = PACKAGE_VERSION.to_s
-    gem.summary        = 'Yet another option parsing library.'
-    gem.description    = 'This is a DSL for creating more complicated command line tools.'
-    gem.email          = ['madeonamac@gmail.com']
-    gem.authors        = ['Gabe McArthur']
-    gem.homepage       = 'http://github.com/gabemc/choosy'
-    gem.files          = FileList["[A-Z]*", "{bin,lib,spec}/**/*"]
-    
-    gem.add_development_dependency 'rspec', '~> 2.5'
-  end
-rescue LoadError
-  puts "Jeweler or dependencies are not available.  Install it with: gem install jeweler"
-end
-
 desc "Cleans the generated files."
 task :clean do
   rm Dir.glob('*.gemspec')
@@ -87,9 +57,11 @@ task :clean do
 end
 
 desc "Deploys the gem to rubygems.org"
-task :gem => [:doc, :release] do
-  system("gem build #{PACKAGE_NAME}.gemspec")
-  system("gem push #{PACKAGE_NAME}-#{PACKAGE_VERSION}.gem")
+task :gem => [:doc, :version] do
+  sh "gem build #{PACKAGE_NAME}.gemspec"
+  sh "gem push #{PACKAGE_NAME}-#{$version}.gem"
+  sh "git tag -m 'Tagging release #{$version}' v#{$version}"
+  sh "git push origin :refs/tags/#{$version}"
 end
 
 desc "Does the full release cycle."

data/lib/VERSION.yml

@@ -2,5 +2,5 @@
 version: 
   major: 0
   minor: 3
-  tiny: 0
+  tiny: 1
 date: 25/03/2011

data/lib/choosy/printing/manpage.rb

@@ -146,7 +146,7 @@ module Choosy::Printing
     end
 
     def comment(line)
-      append('./" ' << line)
+      append('.\\" ' << line)
     end
 
     def line_break
@@ -173,6 +173,7 @@ module Choosy::Printing
 
     def to_s(io=nil)
       io ||= ""
+      io << "'\\\" t\n"
       io << frame_outline << NEWLINE
       io << PREFACE
       @buffer.each do |line|

data/lib/choosy/printing/manpage_printer.rb

@@ -22,9 +22,9 @@ module Choosy::Printing
     end
     
     def print!(command)
-      if pager?
+      if command_exists?('groff') && pager?
         fix_termcap
-        page format!(command), 'groff -Tutf8 -mandoc'
+        page format!(command), 'groff -t -e -W all -Tutf8 -mandoc'
       else
         # Fall back to a help printer if there is no pager
         help = HelpPrinter.new(formatting_options)

data/lib/choosy/version.rb

@@ -60,6 +60,28 @@ module Choosy
       "#{major}.#{minor}.#{tiny}"
     end
 
+    def self.load(options)
+      basepath = if options[:file] && options[:relpath]
+                   File.join(File.dirname(options[:file]), options[:relpath])
+                 elsif options[:dir]
+                   if options[:relpath]
+                     File.join(options[:dir], options[:relpath])
+                   else
+                     options[:dir]
+                   end
+                 else
+                   Choosy::ConfigurationError.new("No file given.")
+                 end
+
+      [File.join(basepath, 'VERSION.yml'), File.join(basepath, 'version.yml')].each do |path|
+        if File.exist?(path)
+          return Version.new(path)
+        end
+      end
+
+      raise Choosy::ConfigurationError.new("No version file given from: #{basepath}")
+    end
+
     private
     VERSION = 'version'
     TINY = 'tiny'

data/lib/choosy/versiontask.rb

@@ -0,0 +1,30 @@
+
+# This is a library task that others can use to expose functionality in their rake files
+# It defines the '$version' global variable to let users pull this information out
+# into their own scripts.
+
+require 'choosy/version'
+
+desc "Shows the current version number."
+task :version => ['version:load'] do
+  puts "Current version: #{$version.to_s}"
+end
+
+namespace :version do
+  task :load do
+    puts Dir.pwd
+    if ENV['VERSION_FILE']
+      $version = Choosy::Version.new(ENV['VERSION_FILE'])
+    else
+      $version = Choosy::Version.load(:dir => Dir.pwd, :relpath => 'lib')
+    end
+  end
+
+  [:tiny, :minor, :major].each do |type|
+    desc "Bumps the #{type} revision number."
+    task type => :load do
+      $version.version!(type)
+      puts "New version: #{$version.to_s}"
+    end
+  end
+end

data/spec/choosy/printing/manpage_spec.rb

@@ -147,7 +147,7 @@ module Choosy::Printing
     end
 
     it "should allow for comments" do
-      @man.comment("here").should eql('./" here')
+      @man.comment("here").should eql('.\\" here')
     end
 
     it "should allow for line breaks" do
@@ -188,6 +188,7 @@ module Choosy::Printing
         @man.paragraph('this is a line of text')
 
         @man.to_s.should eql(<<EOF
+'\\" t
 .TH "blah" "1" "today" " " " "
 .ie \\n(.g .ds Aq \\(aq
 .el       .ds Aq '

metadata

@@ -1,194 +1,172 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: choosy
-version: !ruby/object:Gem::Version
-  version: 0.3.0
-  prerelease: 
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 3
+  - 1
+  version: 0.3.1
 platform: ruby
-authors:
+authors: 
 - Gabe McArthur
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-03-25 00:00:00.000000000 -07:00
+
+date: 2011-03-25 00:00:00 -07:00
 default_executable: 
-dependencies:
-- !ruby/object:Gem::Dependency
+dependencies: 
+- !ruby/object:Gem::Dependency 
   name: rspec
-  requirement: &81909430 !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
   prerelease: false
-  version_requirements: *81909430
-- !ruby/object:Gem::Dependency
-  name: autotest
-  requirement: &81909190 !ruby/object:Gem::Requirement
+  requirement: &id001 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 5
+        version: "2.5"
   type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: autotest
   prerelease: false
-  version_requirements: *81909190
-- !ruby/object:Gem::Dependency
-  name: autotest-notification
-  requirement: &81908950 !ruby/object:Gem::Requirement
+  requirement: &id002 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
   type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: autotest-notification
   prerelease: false
-  version_requirements: *81908950
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: &81908710 !ruby/object:Gem::Requirement
+  requirement: &id003 !ruby/object:Gem::Requirement 
     none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: '2.5'
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
   type: :development
-  prerelease: false
-  version_requirements: *81908710
+  version_requirements: *id003
 description: This is a DSL for creating more complicated command line tools.
-email:
+email: 
 - madeonamac@gmail.com
 executables: []
+
 extensions: []
-extra_rdoc_files:
-- LICENSE
-- README.markdown
-files:
-- CHANGELOG.md
+
+extra_rdoc_files: []
+
+files: 
+- TODO.md
 - Gemfile
+- README.markdown
 - Gemfile.lock
+- CHANGELOG.md
 - LICENSE
-- README.markdown
 - Rakefile
-- TODO.md
-- lib/VERSION.yml
 - lib/choosy.rb
+- lib/VERSION.yml
+- lib/choosy/errors.rb
+- lib/choosy/printing.rb
+- lib/choosy/converter.rb
+- lib/choosy/parse_result.rb
+- lib/choosy/verifier.rb
 - lib/choosy/argument.rb
-- lib/choosy/base_command.rb
+- lib/choosy/version.rb
+- lib/choosy/option.rb
 - lib/choosy/command.rb
-- lib/choosy/converter.rb
+- lib/choosy/super_command.rb
 - lib/choosy/dsl/argument_builder.rb
+- lib/choosy/dsl/super_command_builder.rb
 - lib/choosy/dsl/base_builder.rb
-- lib/choosy/dsl/base_command_builder.rb
 - lib/choosy/dsl/command_builder.rb
 - lib/choosy/dsl/option_builder.rb
-- lib/choosy/dsl/super_command_builder.rb
-- lib/choosy/errors.rb
-- lib/choosy/option.rb
-- lib/choosy/parse_result.rb
+- lib/choosy/dsl/base_command_builder.rb
+- lib/choosy/versiontask.rb
 - lib/choosy/parser.rb
-- lib/choosy/printing.rb
+- lib/choosy/base_command.rb
+- lib/choosy/printing/manpage_printer.rb
 - lib/choosy/printing/base_printer.rb
-- lib/choosy/printing/color.rb
-- lib/choosy/printing/erb_printer.rb
 - lib/choosy/printing/formatting_element.rb
-- lib/choosy/printing/help_printer.rb
 - lib/choosy/printing/manpage.rb
-- lib/choosy/printing/manpage_printer.rb
 - lib/choosy/printing/terminal.rb
-- lib/choosy/super_command.rb
+- lib/choosy/printing/color.rb
+- lib/choosy/printing/erb_printer.rb
+- lib/choosy/printing/help_printer.rb
 - lib/choosy/super_parser.rb
-- lib/choosy/verifier.rb
-- lib/choosy/version.rb
+- spec/integration/command-A_spec.rb
+- spec/integration/supercommand-C_spec.rb
+- spec/integration/command-B_spec.rb
+- spec/integration/supercommand-B_spec.rb
+- spec/integration/supercommand-A_spec.rb
+- spec/integration/command-C_spec.rb
+- spec/choosy/converter_spec.rb
+- spec/choosy/option_spec.rb
+- spec/choosy/version_spec.rb
 - spec/choosy/argument_spec.rb
 - spec/choosy/base_command_spec.rb
+- spec/choosy/version.yml
 - spec/choosy/command_spec.rb
-- spec/choosy/converter_spec.rb
-- spec/choosy/dsl/argument_builder_spec.rb
+- spec/choosy/dsl/super_command_builder_spec.rb
+- spec/choosy/dsl/option_builder_spec.rb
 - spec/choosy/dsl/base_builder_spec.rb
-- spec/choosy/dsl/base_command_builder_spec.rb
+- spec/choosy/dsl/argument_builder_spec.rb
 - spec/choosy/dsl/commmand_builder_spec.rb
-- spec/choosy/dsl/option_builder_spec.rb
-- spec/choosy/dsl/super_command_builder_spec.rb
-- spec/choosy/option_spec.rb
-- spec/choosy/parser_spec.rb
-- spec/choosy/printing/base_printer_spec.rb
-- spec/choosy/printing/color_spec.rb
-- spec/choosy/printing/help_printer_spec.rb
-- spec/choosy/printing/manpage_printer_spec.rb
-- spec/choosy/printing/manpage_spec.rb
-- spec/choosy/printing/terminal_spec.rb
+- spec/choosy/dsl/base_command_builder_spec.rb
 - spec/choosy/super_command_spec.rb
 - spec/choosy/super_parser_spec.rb
 - spec/choosy/verifier_spec.rb
-- spec/choosy/version.yml
-- spec/choosy/version_spec.rb
-- spec/integration/command-A_spec.rb
-- spec/integration/command-B_spec.rb
-- spec/integration/command-C_spec.rb
-- spec/integration/supercommand-A_spec.rb
-- spec/integration/supercommand-B_spec.rb
-- spec/integration/supercommand-C_spec.rb
+- spec/choosy/printing/help_printer_spec.rb
+- spec/choosy/printing/terminal_spec.rb
+- spec/choosy/printing/base_printer_spec.rb
+- spec/choosy/printing/manpage_printer_spec.rb
+- spec/choosy/printing/color_spec.rb
+- spec/choosy/printing/manpage_spec.rb
+- spec/choosy/parser_spec.rb
 - spec/spec_helpers.rb
-- examples/bar.rb
-- examples/foo.rb
-- examples/superfoo.rb
 has_rdoc: true
 homepage: http://github.com/gabemc/choosy
 licenses: []
+
 post_install_message: 
 rdoc_options: []
-require_paths:
+
+require_paths: 
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement
+required_ruby_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
-required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
 requirements: []
+
 rubyforge_project: 
-rubygems_version: 1.6.1
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
 summary: Yet another option parsing library.
-test_files:
-- examples/bar.rb
-- examples/foo.rb
-- examples/superfoo.rb
-- spec/choosy/argument_spec.rb
-- spec/choosy/base_command_spec.rb
-- spec/choosy/command_spec.rb
-- spec/choosy/converter_spec.rb
-- spec/choosy/dsl/argument_builder_spec.rb
-- spec/choosy/dsl/base_builder_spec.rb
-- spec/choosy/dsl/base_command_builder_spec.rb
-- spec/choosy/dsl/commmand_builder_spec.rb
-- spec/choosy/dsl/option_builder_spec.rb
-- spec/choosy/dsl/super_command_builder_spec.rb
-- spec/choosy/option_spec.rb
-- spec/choosy/parser_spec.rb
-- spec/choosy/printing/base_printer_spec.rb
-- spec/choosy/printing/color_spec.rb
-- spec/choosy/printing/help_printer_spec.rb
-- spec/choosy/printing/manpage_printer_spec.rb
-- spec/choosy/printing/manpage_spec.rb
-- spec/choosy/printing/terminal_spec.rb
-- spec/choosy/super_command_spec.rb
-- spec/choosy/super_parser_spec.rb
-- spec/choosy/verifier_spec.rb
-- spec/choosy/version_spec.rb
-- spec/integration/command-A_spec.rb
-- spec/integration/command-B_spec.rb
-- spec/integration/command-C_spec.rb
-- spec/integration/supercommand-A_spec.rb
-- spec/integration/supercommand-B_spec.rb
-- spec/integration/supercommand-C_spec.rb
-- spec/spec_helpers.rb
+test_files: []
+

data/examples/bar.rb

@@ -1,46 +0,0 @@
-#!/usr/bin/env ruby
-##-
-BEGIN {$VERBOSE = true}
-$LOAD_PATH.unshift File.join(File.dirname(__FILE__), '..', 'lib')
-##+
-# bar.rb
-require 'choosy'
-
-# Create a new command
-$bar_cmd = Choosy::Command.new :bar do
-  executor do |args, options|
-    if options[:bold]
-      puts "BOLD!!!"
-    else
-      puts "plain"
-    end
-  end
-
-  summary "Displays when this is a subcommand"
-  para "Just prints 'bar'"
-  para "A truly unremarkable command"
-
-  header 'Option:'
-  boolean :bold, "Bolds something" do
-    negate 'un'
-  end
-
-  # Because there is no bar.arguments call,
-  # it is now an error if there are extra
-  # command line arguments to this command.
-end
-
-if __FILE__ == $0
-  args = ['--un-bold']
-  
-  result = $bar_cmd.parse!(args)
-  
-  require 'pp'
-  pp result.options[:bold]           # => false
-  pp result.args                     # => []
-  
-  $bar_cmd.execute!(args)             # => 'plain'
-
-  args << 'should-throw-error'
-  $bar_cmd.execute!(args)
-end

data/examples/foo.rb

@@ -1,200 +0,0 @@
-#!/usr/bin/env ruby
-##-
-BEGIN {$VERBOSE = true}
-$LOAD_PATH.unshift File.join(File.dirname(__FILE__), '..', 'lib')
-##+
-# foo.rb
-require 'choosy'
-
-FOO_VERSION = '1.0.1'
-
-class FooExecutor
-  def execute!(args, options)
-    puts "BOLDED!!" if options[:bold]
-    options[:count].times do
-      puts "#{options[:prefix]}#{options[:words].push('foo').join(',')}#{options[:suffix]}"
-    end
-    puts "and #{args.join ' '}"
-  end
-end
-
-$foo_cmd = Choosy::Command.new :foo do |foo|
-  # Add a class to do the execution when you call foo_cmd.execute!
-  # You can also use a proc that takes the options and the args, like:
-  #    executor { |args, options| puts 'Hi!' }
-  executor FooExecutor.new
-
-  # When used as a subcommand, you need a summary for the help screen
-  summary "This is a nice command named 'foo'"
-
-  # You can add your custom printer by giving the
-  # full path to an ERB template file here.  
-  # The default printer is :standard, but you can 
-  # also use the builtin printer :erb, with the :tempates
-  # parameter to set the erb template you wish to use. The 
-  # output can be colored or uncolored, though the
-  # default is colored.
-  printer :standard, :color => true, :header_styles => [:bold, :green]
-
-  para 'Prints out "foo" to the console'
-  para 'This is a long description of what foo is an how it works. This line will assuredly wrap the console at least once, since it it such a long line, but it will be wrapped automatically by the printer, above. If you want to, you can add write "printer :standard, :max_width => 80" to set the maximum column width that the printer will allow (not respected by ERB templates).'
-  
-  header 'Required Options:' # Formatted according to the header_styles for the printer
-
-  # A shorthand for a common option type.
-  # It adds the '-p/--prefix PREFIX' infomation for you.
-  single :prefix, "A prefix for 'foo'" do
-    default '<'
-    required
-  end
-
-  # The long way to do the same thing as above, except with
-  # explicitly named dependencies
-  option :suffix => [:prefix] do
-    short '-s'
-    long  '--suffix', 'SUFFIX'
-    desc  'A suffix for "foo"'
-    required
-
-    validate do |suffix, options|
-      if suffix == options[:prefix]      
-        die "You can't matching prefixes and suffixes, you heathen!"
-      end
-    end
-  end
-
-  # Just like the 'single' method above, except now it automatically
-  # requires/casts the argument to this flag into an integer.  These commands
-  # also take an optional hash as the last argument, which can be used instead
-  # of a block.
-  integer :count, 'The number of times to repeat "foo"', :required => true
-
-  header 'Options:', :bold, :blue # Format this header differently, overrides 'header_styles'
-
-  option :words do
-    short '-w'
-    long  '--words', 'WORDS+' # By default, the '+' at the end
-                                # means that this takes multiple
-                                # arguments.  You put a '-' at
-                                # the end of the argument list
-                                # to stop parsing this option
-                                # and allow for regular args.
-    desc  "Other fun words to put in quotes"
-    
-    # Sets the exact count of the number of arguments it accepts.
-    # also allowable are the single selectors :zero and :one.
-    # By default, the option 'WORDS+' sets the range to be
-    # {:at_least => 1, :at_most => 1000 }
-    count :at_least => 2, :at_most => 10
-
-    validate do |words, options|
-      words.each do |word|
-        if word !~ /\w+/
-          die "I can't print that: #{word}"
-        end
-      end
-    end
-  end
-
-  # Alternatively, we could have done the following:
-  strings :words, "Other fun words to put in quotes" do
-    count 2..10
-    default []
-    validate do |words, options|
-      words.each do |word|
-        if word !~ /\w+/
-          die "I can't print that: #{word}"
-        end
-      end
-    end
-  end
-
-  # Yet another shorthand notation for options, since they
-  # are boolean by default. Here, we add a negation to the
-  # long flag of the option, creating [-b|--bold|--un-bold] flags.
-  # By default, calling 'negate' in a block without an argument
-  # uses the '--no-' prefix instead.
-  boolean :bold, "Bold this option", :default => false, :negate => 'un'
-
-  # Tail options
-
-  # When any of the simpler notations are suffixed with a '_' 
-  # character, the short option is always suppressed.
-  boolean_ :debug, "Prints out extra debugging output."
-
-  # The '_' characters are replaced with '-' in flags, so the 
-  # following creates a '--[no-]color' flag.
-  boolean_ :color, "Turns on/off coloring in the output. Defalt is on." do
-    negate
-    default true
-    validate do
-      foo.entity.alter do
-        printer :standard, :colored => false
-      end
-    end
-  end
-
-  # Adds the standard -h/--help option.
-  # Should skip the '-h' flag if already set.
-  help  # Automatically adds the description if not passed an argument. You can supply your own
-
-  # Adds the --version option.
-  version "Foo: #{FOO_VERSION}"
-
-  # Now, add some validation for any addtional arguments
-  # that are left over after the parsing the options.
-  arguments do
-    metaname 'ARGS'
-    count 1..10
-    validate do |args, options|
-      if args.empty?
-        die "You have to pass in empty arguments that do nothing!"
-      end
-      if args.count == 10
-        die "Whoa there!  You're going argument crazy!"
-      end
-    end
-  end
-end
-
-if __FILE__ == $0
-  # Parses and validates the options.
-  args =  ['--prefix', '{', 
-           '--suffix', '}',
-           '--words', 'high', 'there', 'you', '-', 
-           # The '-' stops parsing this option, so that:
-           'handsom', 'devil',
-           'http://not.posting.here', # will be regular arguments
-           '-c', '3', # Count
-           '--', # Stops parsing all arguments
-           '-h', '--help', '-v', '--version' # Ignored
-          ]
-  result = $foo_cmd.parse!(args)
-  
-  require 'pp'
-  pp result[:prefix]        # => '{'
-  pp result[:suffix]        # => '}'
-  pp result[:count]         # => 3
-  pp result[:bold]          # => false
-  pp result[:words]         # => ['high', 'there', 'you']
-  pp result.args            # => ['handsom', 'devil',
-                            #     'http://not.posting.here',
-                            #     '-h', '--help', '-v', '--version']
-  pp result.options         # => {:prefix => '{', :suffix => '}'
-                            #     :count => 3, :bold => false,
-                            #     :words => ['high', 'there', 'you'],
-                            #     :debug => false, :color => true}
-  
-  # Now, call the command that does the actual work.
-  # This passes the foo_cmd.options and the foo_cmd.args
-  # as arguments to the executors 'execute!' method.
-  #
-  # This allows you to easily associate command classes with
-  # commands, without resorting to a hash or combining
-  # execution logic with command parsing logic.
-  $foo_cmd.execute!(args)    # {high,there,you,foo}
-                            # {high,there,you,foo}
-                            # {high,there,you,foo}
-                            # and handsom devil http://not.posting.here -h --help -v --verbose
-  
-end

data/examples/superfoo.rb

@@ -1,137 +0,0 @@
-#!/usr/bin/env ruby
-##-
-BEGIN {$VERBOSE = true}
-$LOAD_PATH.unshift File.join(File.dirname(__FILE__), '..', 'lib')
-$LOAD_PATH.unshift File.dirname(__FILE__)
-##+
-
-# superfoo.rb
-require 'choosy'
-require 'foo'
-require 'bar'
-
-SUPERFOO_VERSION = "1.0.1"
-
-superfoo = Choosy::SuperCommand.new :superfoo do
-  summary "This is a superfoo command"
-  para "Say something, dammit!"
-
-  # You can also add commands after instantiation.
-  # Note that, when added, these commands have their
-  # -h/--help/--version flags suppressed, so you'll
-  # need to add those flags here.
-  command $bar_cmd
-  command $foo_cmd
-
-  # Creates a 'help' command, message optional
-  help "Prints this help message"
-
-  # Create some global options that are parsed
-  # defore result options
-
-  # Here, check that a YAML file exists, and attempt
-  # to load it's parsed contents into this option.
-  # There is also a 'file' type that checks to see
-  # if the file exists. With both 'file' and 'yaml',
-  # if the file is missing, the option fails with an
-  # error.
-  yaml :Config, "Configure your superfoo with a YAML configuration file." do
-    default File.join(ENV['HOME'], '.superfoo.yml')
-  end
-
-  # Adds a global --version flag.
-  version "#{SUPERFOO_VERSION}"
-end
-
-if __FILE__ == $0
-  args = ['foo',
-          '-c', '5',
-          '--config', 'superfoo.yaml',
-          '--prefix', '{',
-          '--suffix', '}',
-          'cruft',
-          'bar',
-          '--bold']
-
-  result = superfoo.parse!(args)
-
-  require 'pp'
-  pp result[:Config]        # => {:here => 'text'} # Pulled the config!
-
-  foores = result.subresults[0]
-  
-  pp foores[:Config]        # => {:here => 'text'} # Passed along!
-  pp foores[:prefix]        # => '{'
-  pp foores[:suffix]        # => '}'
-  pp foores[:count]         # => 5
-  pp foores[:bold]          # => true
-  pp foores.options         # => {:prefix => '{', :suffix => '}'
-                            #     :count => 5,
-                            #     :bold => true, 
-                            #     :words => [],
-                            #     :config => '~/.superfoo' }
-  pp foores.args            # => ['cruft', 'bar']
-  
-  # Now, we can call the result
-  superfoo.execute!(args)   ## Calls superfoo.result.execute!
-                            ## Prints:
-                            # BOLDED!!
-                            # {foo}
-                            # {foo,foo}
-                            # {foo,foo,foo}
-                            # {foo,foo,foo,foo}
-                            # {foo,foo,foo,foo,foo}
-                            # and cruft bar
-  
-  # Instead of parsing the 'bar' parameter as an argument to
-  # the foo command, so that when the first argument that matches
-  # another command name is encountered, it stops parsing the
-  # current command and passes the rest of the arguments to the
-  # next command.
-  #
-  # In this case, we call the 'alter' method to use the DSL
-  # syntax again to alter this command.
-  #
-  # You can also set this inside a SuperChoosy.new {...}
-  # block.
-  superfoo.alter do
-    parsimonious
-  end
-  
-  result = superfoo.parse!(args)
-
-  foores = result.subresults[0]
-  pp foores[:Config]                # => {:here => 'text'} # Passed along!
-  pp foores.command.name            # => :foo
-  pp foores[:prefix]                # => '{'
-  pp foores[:suffix]                # => '}'
-  pp foores[:count]                 # => 5
-  pp foores[:bold]                  # => true
-  pp foores.options                 # => {:prefix => '{', :suffix => '}'
-                                    #     :count => 5,
-                                    #     :bold => false, 
-                                    #     :words => [],
-                                    #     :config => {:here => 'text'}
-                                    #    }
-  pp foores.args                    # => ['cruft']
-  
-  barres = result.subresults[1]
-  pp barres.command.name            # => :bar
-  pp barres[:bold]                  # => true
-  pp barres.options                 # => {:bold => true,
-                                    #     :config => {:here => 'text'}
-                                    #    }
-  pp barres.args                    # => []
-  
-  # Now, execute the results in order
-  superfoo.execute!(args)       ## Same as:
-                                #  results.each do |subcommand|
-                                #    command.execute!
-                                #  end
-                                ## Prints:
-                                # {foo}
-                                # {foo}
-                                # and cruft
-                                # BOLDED BAR
-end
-