claide 0.1.1 → 0.2.0

data/README.markdown

@@ -4,6 +4,8 @@ I was born out of a need for a _simple_ option and command parser, while still
 providing an API that allows you to quickly create a full featured command-line
 interface.
 
+[![Build Status][travis-status]][travis]
+
 
 ## Install
 
@@ -108,6 +110,8 @@ should not be a need to validate the parameters.
 See the [example][example] for a illustration of how to define commands.
 
 
-[docs]: http://rubydoc.info/github/CocoaPods/CLAide/0.1.0/frames
-[example]: https://github.com/alloy/CLAide/blob/master/examples/make.rb
+[travis]: https://secure.travis-ci.org/CocoaPods/CLAide
+[travis-status]: https://secure.travis-ci.org/CocoaPods/CLAide.png
+[docs]: http://rubydoc.info/github/CocoaPods/CLAide/0.2.0/frames
+[example]: https://github.com/CocoaPods/CLAide/blob/master/examples/make.rb
 [report-error]: https://github.com/CocoaPods/CocoaPods/blob/054fe5c861d932219ec40a91c0439a7cfc3a420c/lib/cocoapods/command.rb#L36

data/lib/claide.rb

@@ -8,7 +8,7 @@ module CLAide
   #
   #   CLAide’s version, following [semver](http://semver.org).
   #
-  VERSION = '0.1.1'
+  VERSION = '0.2.0'
 
   # This class is responsible for parsing the parameters specified by the user,
   # accessing individual parameters, and keep state by removing handled
@@ -25,6 +25,14 @@ module CLAide
       @entries = self.class.parse(argv)
     end
 
+    # @return [Boolean]
+    #
+    #   Returns wether or not there are any remaining unhandled parameters.
+    #
+    def empty?
+      @entries.empty?
+    end
+
     # @return [Array<String>]
     #
     #   A list of the remaining unhandled parameters, in the same format a user
@@ -586,18 +594,25 @@ module CLAide
     attr_accessor :colorize_output
     alias_method :colorize_output?, :colorize_output
 
-    # Sets the `verbose` attribute based on wether or not the `--verbose`
-    # option is specified.
-    #
     # Subclasses should override this method to remove the arguments/options
-    # they support from argv _before_ calling `super`.
+    # they support from `argv` _before_ calling `super`.
+    #
+    # The `super` implementation sets the {#verbose} attribute based on wether
+    # or not the `--verbose` option is specified; and the {#colorize_output}
+    # attribute to `false` if {Command.colorize_output} returns `true`, but the
+    # user specified the `--no-color` option.
+    #
+    # @param [ARGV] argv
+    #
+    #   A list of (user-supplied) params that should be handled.
+    #
     def initialize(argv)
       @verbose = argv.flag?('verbose')
       @colorize_output = argv.flag?('color', Command.colorize_output?)
       @argv = argv
     end
 
-    # Raises a Help exception if the `--help` option is specified, if argv
+    # Raises a Help exception if the `--help` option is specified, if `argv`
     # still contains remaining arguments/options by the time it reaches this
     # implementation, or when called on an ‘abstract command’.
     #
@@ -611,8 +626,7 @@ module CLAide
     #
     def validate!
       help! if @argv.flag?('help')
-      remainder = @argv.remainder
-      help! "Unknown arguments: #{remainder.join(' ')}" unless remainder.empty?
+      help! "Unknown arguments: #{@argv.remainder.join(' ')}" if !@argv.empty?
       help! if self.class.abstract_command?
     end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: claide
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-10-27 00:00:00.000000000 Z
+date: 2012-10-30 00:00:00.000000000 Z
 dependencies: []
 description: 
 email: