bosonson 0.304.1

data/CHANGELOG.rdoc

@@ -0,0 +1,108 @@
+== 0.3.4
+* Handle rubygems deprecation (#28)
+* 1.9 Fixes
+
+== 0.3.3
+* Fix install command for https (#22)
+
+== 0.3.2
+* Add commandline backtrace option (#18)
+
+== 0.3.1
+* Fixed MethodInspector handling anonymous classes on 1.9.2 (#16)
+* Fixed get and install commands on 1.9.2 (#17)
+* Fixed failed loading of Bosonfile
+* Fixed RequireLibrary indicating correct load status
+
+== 0.3.0
+* Added --debug to executable with multiple debug hooks
+* Added --ruby_debug and -I to executable to change $LOAD_PATH and $DEBUG
+* Added @option method attribute as a more readable complement to @options
+* Added proper exit code for failed commands (#12)
+* Added friendlier errors for libraries with SyntaxError or LoaderError
+* Added validation to method attributes
+* Improved RequireLibrary to more robustly handle gems like httparty
+* Fixed 1.9.2-rc2 bugs including #14
+* Fixed finding commands with same names
+* Fixed --console for ruby >= 1.8.7
+* Fixed --help for namespaced commands
+
+== 0.2.5
+* Fixed critical gemspec error
+
+== 0.2.4
+* Tests use bacon and pass on all major ruby versions
+* Fixed bug for 1.8.7 and super (#10)
+* Added commandline pipes with '+'
+* Fixed bug when requiring rubygems in a library
+* Fixed bug in sort pipe for 1.9.2
+* Got rid of jeweler in Rakefile and $LOAD_PATH meddling
+* Refactored BinRunner's error handling
+
+== 0.2.3
+* Added improved support and additional attributes for user pipe options
+* Added :pipes global command option
+* Added json + yaml parsing to get()
+* Added underscore searching to option values
+* Added build_install() command
+* Added :usage_options commandline option
+
+== 0.2.2
+* Renamed Boson::Command#description to #desc. Delete your index at ~/.boson/config/index.marshal.
+* Renamed Boson::Command#global_options to #option_command. Update your configs.
+* Bug fix for Windows and indexing (#4)
+* Added system wide Boson commands at /etc/boson (#2)
+* Added Boson::Command#config for plugins to set/get via @config
+* Added option_command and unload options to BinRunner
+* Added special option parsing characters: - and --
+* Added special :output_class key for global render_options
+* Added :delete_options global option
+* Fixed --no variant for single letter booleans
+* Fixed MethodInspector parsing arguments with special characters
+* Allow global -p to work even in failures
+* Allow -hv to default to verbose help
+* Boson::OptionParser tweaks
+
+== 0.2.1
+* Added local libraries: Bosonfile and under local repositories
+* Added config method attribute.
+* Added default_option and global_options command attributes.
+* Added OptionParser.parse and OptionParser.usage for scripting use.
+* Improved auto-rendering from commandline.
+* Removed library reload.
+* Better docs.
+
+== 0.2.0
+* Command options
+** Added custom global and render options for commands.
+** Added pipe and filter option commands.
+** Add global query option.
+* Options
+** Users can define custom option types.
+** Added hash option type.
+** Any option can be a boolean with :bool_default attribute.
+** Adding * aliasing to relevant options.
+* Made Boson::Scientist.commandify for use outside Boson.
+* Any command can have a default option.
+* Directories are namespaced automatically.
+* Solidified library module callback methods.
+* Added support for Windows home.
+* Improved ModuleLibrary to handle class or module class methods.
+* Better search and sort integration with Hirb.
+* Better docs.
+* Fixed number of bugs.
+* query_fields option for searching libraries and commands is deprecated. Specifying query
+  fields is now done by prefixing a query with ':'. For example:
+  bash> boson commands library_type:gem
+  # instead of
+  bash> boson commands gem --query_fields=library_type
+
+== 0.1.0
+* First real release
+* Plenty of fixes to make it ruby 1.9 ready.
+* Added more documentation
+* BinRunner tweaks and bug fixes
+* Other miscellaneous bug fixes
+
+== 0.0.1
+* An initial release for others to play with.

data/LICENSE.txt

@@ -0,0 +1,22 @@
+The MIT LICENSE
+
+Copyright (c) 2010 Gabriel Horner
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,181 @@
+To read a linkable version of this README, {see here}[http://tagaholic.me/boson/doc/].
+
+== Description
+Boson is a command/task framework with the power to turn any ruby method into a full-fledged
+executable with options.  Some unique features that differentiate it from rake and thor include
+being usable from irb and the commandline, optional automated views generated by hirb and allowing
+libraries to be written as plain ruby. For my libraries that use this, see
+{irbfiles}[http://github.com/cldwalker/irbfiles].  Works with all major ruby versions.
+
+== UPDATE
+Boson 0.4.x will be the last 1.8 compatible version.
+Boson 0.5 will be a rewrite compatible with only 1.9. Work is going on in {boson2
+branch}[https://github.com/cldwalker/boson/tree/boson2]. The goal of boson2 is to have a slimmer
+core, move everything else {to plugins}[https://github.com/cldwalker/boson-all]
+and to allow gems to use boson to make executables like thor.
+
+== Features
+* Simple organization: Commands are just methods on an object (default is main) and command libraries are just modules.
+* Commands are accessible from the commandline (Boson::BinRunner) or irb (Boson::ConsoleRunner).
+* Libraries
+  * can be written in plain ruby which allows for easy testing and use independent of boson (Boson::FileLibrary).
+  * can exist locally as a Bosonfile (Boson::LocalFileLibrary) and under lib/boson/commands or .boson/commands.
+  * can be made from gems (Boson::GemLibrary) or any require-able file (Boson::RequireLibrary).
+  * are encouraged to be shared. Libraries can be installed with a given url. Users can customize any aspect of a third-party
+    library without modifying it (Boson::Library).
+* Commands
+  * can have any number of local and global options (Boson::OptionCommand). Options are defined with Boson::OptionParser.
+  * can have any view associated to it (via Hirb) without adding view code to the command's method.
+    These views can be toggled on and manipulated via global render options (Boson::View and Boson::OptionCommand).
+  * can pipe their return value into custom pipe options (Boson::Pipe).
+  * has default pipe options to search and sort an array of any objects (Boson::Pipes).
+* Option parser (Boson::OptionParser)
+  * provides option types that map to objects i.e. :array type creates Array objects.
+  * come with 5 default option types: boolean, array, string, hash and numeric.
+  * can have have custom option types defined by users (Boson::Options).
+* Comes with default commands to load, search, list and install commands and libraries (Boson::Commands::Core).
+* Namespaces are optional and when used are methods which allow for method_missing magic.
+
+== Creating Command Libraries
+See Boson::FileLibrary or here[http://tagaholic.me/boson/doc/classes/Boson/FileLibrary.html].
+
+== Irb Example
+
+To use in irb, drop this in your ~/.irbrc:
+    require 'boson'
+    Boson.start
+
+Having done that, let's start up irb:
+
+  bash> irb
+  Loaded library core
+  Loaded library web_core
+
+  # List default libraries
+  >> libraries
+  +----------+----------+------+--------------+
+  | name     | commands | gems | library_type |
+  +----------+----------+------+--------------+
+  | core     | 6        |      | module       |
+  | web_core | 3        |      | module       |
+  +----------+----------+------+--------------+
+  2 rows in set
+
+  # List default commands
+  >> commands
+  +--------------+----------+-------+--------------------------------------------+-----------------------------------------------------------------------------+
+  | full_name    | lib      | alias | usage                                      | description                                                                 |
+  +--------------+----------+-------+--------------------------------------------+-----------------------------------------------------------------------------+
+  | usage        | core     |       | [name][--verbose]                          | Print a command's usage                                                     |
+  | libraries    | core     |       | [query=''][--index] [--query_fields=A,B,C] | List or search libraries                                                    |
+  | render       | core     |       | [object] [options={}]                      | Render any object using Hirb                                                |
+  | load_library | core     |       | [library][--verbose] [--reload]            | Load/reload a library                                                       |
+  | commands     | core     |       | [query=''][--index] [--query_fields=A,B,C] | List or search commands                                                     |
+  | menu         | core     |       | [output] [options={}] [&block]             | Provide a menu to multi-select elements from a given array                  |
+  | get          | web_core |       | [url]                                      | Gets the body of a url                                                      |
+  | install      | web_core |       | [url][--force] [--name=NAME]               | Installs a library by url. Library should then be loaded with load_library. |
+  | browser      | web_core |       | [*urls]                                    | Opens urls in a browser                                                     |
+  +--------------+----------+-------+--------------------------------------------+-----------------------------------------------------------------------------+
+  9 rows in set
+
+  # Boson commands can behave like shell commands:
+
+  # Basic help
+  >> commands '-h'
+  commands [query=''][--index] [--query_fields=A,B,C]
+
+  # Search the lib column for web
+  >> commands 'web -q=lib' # or 'web --query_fields=lib'
+  +-----------+----------+-------+------------------------------+-----------------------------------------------------------------------------+
+  | full_name | lib      | alias | usage                        | description                                                                 |
+  +-----------+----------+-------+------------------------------+-----------------------------------------------------------------------------+
+  | get       | web_core |       | [url]                        | Gets the body of a url                                                      |
+  | install   | web_core |       | [url][--force] [--name=NAME] | Installs a library by url. Library should then be loaded with load_library. |
+  | browser   | web_core |       | [*urls]                      | Opens urls in a browser                                                     |
+  +-----------+----------+-------+------------------------------+-----------------------------------------------------------------------------+
+  3 rows in set
+
+== Commandline Example
+
+   # Just like in irb
+    bash> boson libraries
+    +----------+----------+------+--------------+
+    | name     | commands | gems | library_type |
+    +----------+----------+------+--------------+
+    | core     | 6        |      | module       |
+    | web_core | 3        |      | module       |
+    +----------+----------+------+--------------+
+    2 rows in set
+
+    # Let's install another library
+    bash> boson install https://github.com/cldwalker/irbfiles/raw/master/boson/commands/public/irb_core.rb
+    Saved to /Users/bozo/.boson/commands/irb_core.rb
+
+    # Let's start irb ...
+    bash> irb
+
+    >> commands
+    +-------------------------------+----------+------------+--------------------------------------------+-----------------------------------------------------------------------------+
+    | full_name                     | lib      | alias      | usage                                      | description                                                                 |
+    +-------------------------------+----------+------------+--------------------------------------------+-----------------------------------------------------------------------------+
+    | usage                         | core     |            | [name][--verbose]                          | Print a command's usage                                                     |
+    | libraries                     | core     |            | [query=''][--index] [--query_fields=name]  | List or search libraries                                                    |
+    | render                        | core     |            | [object] [options={}]                      | Render any object using Hirb                                                |
+    | load_library                  | core     |            | [library][--verbose] [--reload]            | Load/reload a library                                                       |
+    | commands                      | core     |            | [query=''][--index] [--query_fields=A,B,C] | List or search commands                                                     |
+    | menu                          | core     |            | [output] [options={}] [&block]             | Provide a menu to multi-select elements from a given array                  |
+    | get                           | web_core |            | [url]                                      | Gets the body of a url                                                      |
+    | install                       | web_core |            | [url][--force] [--name=NAME]               | Installs a library by url. Library should then be loaded with load_library. |
+    | browser                       | web_core |            | [*urls]                                    | Opens urls in a browser                                                     |
+    | irb_pop_workspace             | irb_core | popws      |                                            | Pops current workspace and changes to next workspace in context             |
+    | irb_require                   | irb_core |            |                                            | Evals file like require line by line                                        |
+    | public                        | irb_core |            |                                            | Works same as module#public                                                 |
+    | private                       | irb_core |            |                                            | Works same as module#private                                                |
+    | irb                           | irb_core |            |                                            | Starts a new workspace/subsession                                           |
+    | irb_push_workspace            | irb_core | pushws     |                                            | Creates a workspace for given object and pushes it into the current context |
+    | irb_load                      | irb_core |            |                                            | Evals file like load line by line                                           |
+    | irb_change_workspace          | irb_core | cws        |                                            | Changes current workspace to given object                                   |
+    | irb_source                    | irb_core | source     |                                            | Evals full path file line by line                                           |
+    | irb_jobs                      | irb_core | jobs       |                                            | List workspaces/subsessions                                                 |
+    | irb_fg                        | irb_core | fg         |                                            | Switch to a workspace/subsession                                            |
+    | irb_help                      | irb_core | help       |                                            | Ri based help                                                               |
+    | irb_kill                      | irb_core | kill       |                                            | Kills a given workspace/subsession                                          |
+    | include                       | irb_core |            |                                            | Works same as module#include                                                |
+    | irb_exit                      | irb_core | exit       |                                            | Kills the current workspace/subsession                                      |
+    | irb_workspaces                | irb_core | workspaces |                                            | Array of workspaces for current context                                     |
+    | irb_context                   | irb_core | conf       |                                            | Displays configuration for current workspace/subsession                     |
+    | install_alias_method          | irb_core |            |                                            | Aliases given method, allows lazy loading of dependent file                 |
+    | irb_current_working_workspace | irb_core | cwws       |                                            | Prints current workspace                                                    |
+    +-------------------------------+----------+------------+--------------------------------------------+-----------------------------------------------------------------------------+
+    28 rows in set
+
+    # Sweet! Now we have a list and description of commands that come with irb.
+
+== Todo
+* More tests
+* Making commands out of existing gems easier and more powerful
+* Features based on commands and their argument types i.e. completing and piping
+* Consider dropping alias gem dependency if not using its full potential
+
+== Bugs/Issues
+Please report them {on github}[http://github.com/cldwalker/boson/issues].
+
+== Contributing
+{See here}[http://tagaholic.me/contributing.html]
+
+== Motivation
+My {tagging obsession}[http://github.com/cldwalker/tag-tree] from the ruby console.
+
+== Links
+* http://tagaholic.me/2009/10/14/boson-command-your-ruby-universe.html
+* http://tagaholic.me/2009/10/15/boson-and-hirb-interactions.html
+* http://tagaholic.me/2009/10/19/how-boson-enhances-your-irb-experience.html
+
+== Credits
+Boson stands on the shoulders of these people and their ideas:
+* Yehuda Katz for inspiring me with Thor and its awesome option parser (Boson::OptionParser).
+* Daniel Berger for his original work on thor's awesome option parser.
+* Dave Thomas for scraping a method's comments (Boson::CommentInspector)
+* Mauricio Fernandez for scraping a method's arguments (Boson::ArgumentInspector)
+* Chris Wanstrath for inspiring Boson's libraries with Rip's packages.
+* And its contributors: @mirell

data/bin/bss

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+require File.expand_path(File.join(File.dirname(__FILE__), "..","lib","boson"))
+require 'boson/runners/bin_runner'
+
+Boson::BinRunner.start

data/bosonson.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+require 'rubygems' unless Object.const_defined?(:Gem)
+require File.dirname(__FILE__) + "/lib/boson/version"
+ 
+Gem::Specification.new do |s|
+  s.name        = "bosonson"
+  s.version     = Boson::VERSION
+  s.authors     = ["Tom Bombadil", "Gabriel Horner"]
+  s.email       = "amanibhavam@destructuring.org"
+  s.homepage    = "https://HeSYINUvSBZfxqA.github.com/bosonson"
+  s.summary = "A command/task framework similar to rake and thor that opens your ruby universe to the commandline and irb, forked from boson"
+  s.description =  "bosonson is a command/task framework with the power to turn any ruby method into a full-fledged executable with options.  Some unique features that differentiate it from rake and thor include being usable from irb and the commandline, optional automated views generated by hirb and allowing libraries to be written as plain ruby. For my libraries that use this, see irbfiles.  Works with all major ruby versions.  Forked from boson"
+  s.required_rubygems_version = ">= 1.3.6"
+  s.executables = ['bss']
+  s.add_dependency 'hirb', '>= 0.5.0'
+  s.add_dependency 'alias', '>= 0.2.2'
+  s.add_development_dependency 'mocha'
+  s.add_development_dependency 'bacon', '>= 1.1.0'
+  s.add_development_dependency 'mocha-on-bacon'
+  s.add_development_dependency 'bacon-bits'
+  s.files = Dir.glob(%w[{lib,test}/**/*.rb bin/* [A-Z]*.{txt,rdoc} ext/**/*.{rb,c} **/deps.rip]) + %w{bosonson.gemspec}
+  s.extra_rdoc_files = ["README.rdoc", "LICENSE.txt"]
+  s.license = 'MIT'
+end

data/deps.rip

@@ -0,0 +1,2 @@
+hirb >=0.5.0
+alias >=0.2.2

data/lib/boson.rb

@@ -0,0 +1,96 @@
+%w{hirb alias}.each {|e| require e }
+%w{runner runners/console_runner repo manager loader inspector library}.each {|e| require "boson/#{e}" }
+%w{argument method comment}.each {|e| require "boson/inspectors/#{e}_inspector" }
+# order of library subclasses matters
+%w{module file gem require local_file}.each {|e| require "boson/libraries/#{e}_library" }
+(%w{namespace view command util commands option_parser options} +
+  %w{index repo_index scientist option_command pipe pipes version}).each {|e| require "boson/#{e}" }
+
+# This module stores the libraries, commands, repos and main object used throughout Boson.
+#
+# Useful documentation links:
+# * Boson::BinRunner - Runs the boson executable
+# * Boson::ConsoleRunner - Runs Boson from the ruby console
+# * Boson::Repo.config - Explains main config file
+# * Boson::Library - All about libraries
+# * Boson::FileLibrary - Explains creating libraries as files
+# * Boson::Loader - Explains library module callbacks
+# * Boson::OptionParser - All about options
+module Boson
+  # Module which is extended by Boson.main_object to give it command functionality.
+  module Universe; include Commands::Namespace; end
+  NAMESPACE = '.' # Delimits namespace from command
+  extend self
+  # The object which holds and executes all command functionality
+  attr_accessor :main_object
+  attr_accessor :commands, :libraries
+  alias_method :higgs, :main_object
+
+  # Array of loaded Boson::Library objects.
+  def libraries
+    @libraries ||= Array.new
+  end
+
+  # Array of loaded Boson::Command objects.
+  def commands
+    @commands ||= Array.new
+  end
+
+  # The main required repository which defaults to ~/.boson.
+  def repo
+    @repo ||= Repo.new("#{Util.find_home}/.boson")
+  end
+
+  # An optional local repository which defaults to ./lib/boson or ./.boson.
+  def local_repo
+    @local_repo ||= begin
+      ignored_dirs = (repo.config[:ignore_directories] || []).map {|e| File.expand_path(e) }
+      dir = ["lib/boson", ".boson"].find {|e| File.directory?(e) &&
+          File.expand_path(e) != repo.dir && !ignored_dirs.include?(File.expand_path('.')) }
+      Repo.new(dir) if dir
+    end
+  end
+
+  # The array of loaded repositories containing the main repo and possible local and global repos
+  def repos
+    @repos ||= [repo, local_repo, global_repo].compact
+  end
+
+  # Optional global repository at /etc/boson
+  def global_repo
+    File.exists?('/etc/boson') ? Repo.new('/etc/boson') : nil
+  end
+
+  def main_object=(value) #:nodoc:
+    @main_object = value.extend(Universe)
+  end
+
+  def library(query, attribute='name') #:nodoc:
+    libraries.find {|e| e.send(attribute) == query }
+  end
+
+  # Start Boson by loading repositories and their configured libraries.
+  # See ConsoleRunner.start for its options.
+  def start(options={})
+    ConsoleRunner.start(options)
+  end
+
+  # Invoke an action on the main object.
+  def invoke(*args, &block)
+    main_object.send(*args, &block)
+  end
+
+  # Invoke command string even with namespaces
+  def full_invoke(cmd, args) #:nodoc:
+    command, subcommand = cmd.include?(NAMESPACE) ? cmd.split(NAMESPACE, 2) : [cmd, nil]
+    dispatcher = subcommand ? Boson.invoke(command) : Boson.main_object
+    dispatcher.send(subcommand || command, *args)
+  end
+
+  # Boolean indicating if the main object can invoke the given method/command.
+  def can_invoke?(meth, priv=true)
+    Boson.main_object.respond_to? meth, priv
+  end
+end
+
+Boson.main_object = self

data/lib/boson/command.rb

@@ -0,0 +1,196 @@
+module Boson
+  # A command starts with the functionality of a ruby method and adds benefits with options, render_options, etc.
+  class Command
+    class <<self; attr_accessor :all_option_commands ; end
+
+    # Creates a command given its name and a library.
+    def self.create(name, library)
+      obj = new(new_attributes(name, library))
+      if @all_option_commands && !%w{get method_missing}.include?(name)
+        obj.make_option_command(library)
+      end
+      obj
+    end
+
+    # Used to generate a command's initial attributes when creating a command object
+    def self.new_attributes(name, library)
+      (library.commands_hash[name] || {}).merge({:name=>name, :lib=>library.name, :namespace=>library.namespace})
+    end
+
+    # Finds a command, namespaced or not and aliased or not. If found returns the
+    # command object, otherwise returns nil.
+    def self.find(command, commands=Boson.commands)
+      if command.to_s.include?(NAMESPACE)
+        command, subcommand = command.to_s.split(NAMESPACE, 2)
+        commands.find {|current_command|
+          [current_command.name, current_command.alias].include?(subcommand) &&
+          current_command.library && (current_command.library.namespace == command)
+        }
+      else
+        commands.find {|e| [e.name, e.alias].include?(command) && !e.namespace}
+      end
+    end
+
+    # One line usage for a command if it exists
+    def self.usage(command)
+      (cmd = find(command)) ? "#{command} #{cmd.usage}" : "Command '#{command}' not found"
+    end
+
+    ATTRIBUTES = [:name, :lib, :alias, :desc, :options, :args, :config]
+    attr_accessor *(ATTRIBUTES + [:render_options, :namespace, :default_option])
+    # A hash of attributes which map to instance variables and values. :name
+    # and :lib are required keys.
+    #
+    # Attributes that can be configured:
+    # [*:desc*] Description that shows up in command listings
+    # [*:alias*] Alternative name for command
+    # [*:options*] Hash of options passed to OptionParser
+    # [*:render_options*] Hash of rendering options to pass to OptionParser. If the key :output_class is passed,
+    #                     that class's Hirb config will serve as defaults for this rendering hash.
+    # [*:option_command*] Boolean to wrap a command with an OptionCommand object i.e. allow commands to have options.
+    # [*:args*] Should only be set if not automatically set. This attribute is only
+    #           important for commands that have options/render_options. Its value can be an array
+    #           (as ArgumentInspector.scrape_with_eval produces), a number representing
+    #           the number of arguments or '*' if the command has a variable number of arguments.
+    # [*:default_option*] Only for an option command that has one or zero arguments. This treats the given
+    #                     option as an optional first argument. Example:
+    #                       # For a command with default option 'query' and options --query and -v
+    #                       'some -v'   -> '--query=some -v'
+    #                       '-v'        -> '-v'
+    # [*:config*] A hash for third party libraries to get and set custom command attributes.
+    def initialize(attributes)
+      hash = attributes.dup
+      @name = hash.delete(:name) or raise ArgumentError
+      @lib = hash.delete(:lib) or raise ArgumentError
+      [:alias, :desc, :options, :namespace, :default_option, :option_command].each do |e|
+          instance_variable_set("@#{e}", hash.delete(e)) if hash.key?(e)
+      end
+
+      if hash[:render_options] && (@render_options = hash.delete(:render_options))[:output_class]
+        @render_options = Util.recursive_hash_merge View.class_config(@render_options[:output_class]), @render_options
+      end
+
+      if (args = hash.delete(:args))
+        if args.is_a?(Array)
+          @args = args
+        elsif args.to_s[/^\d+/]
+          @arg_size = args.to_i
+        elsif args == '*'
+          @args = [['*args']]
+        end
+      end
+      @config = Util.recursive_hash_merge hash, hash.delete(:config) || {}
+    end
+
+    # Library object a command belongs to.
+    def library
+      @library ||= Boson.library(@lib)
+    end
+
+    # Array of array args with optional defaults. Scraped with ArgumentInspector.
+    def args(lib=library)
+      @args = !@args.nil? ? @args : begin
+        if lib
+          file_string, meth = file_string_and_method_for_args(lib)
+          (file_string && meth && (@file_parsed_args = true) &&
+            ArgumentInspector.scrape_with_text(file_string, meth))
+        end || false
+      end
+    end
+
+    # Option parser for command as defined by @options.
+    def option_parser
+      @option_parser ||= OptionParser.new(@options || {})
+    end
+
+    # Option parser for command as defined by @render_options.
+    def render_option_parser
+      option_command? ? Boson::Scientist.option_command(self).option_parser : nil
+    end
+
+    # Help string for options if a command has it.
+    def option_help
+      @options ? option_parser.to_s : ''
+    end
+
+    # Usage string for command, created from options and args.
+    def usage
+      return '' if options.nil? && args.nil?
+      usage_args = args && @options && !has_splat_args? ?
+        (@default_option ? [[@default_option.to_s, @file_parsed_args ? ''.inspect : '']] + args[0..-2] :
+        args[0..-2]) : args
+      str = args ? usage_args.map {|e|
+        (e.size < 2) ? "[#{e[0]}]" : "[#{e[0]}=#{@file_parsed_args ? e[1] : e[1].inspect}]"
+      }.join(' ') : '[*unknown]'
+      str + option_help
+    end
+
+    # Full name is only different than name if a command has a namespace.
+    # The full name should be what you would type to execute the command.
+    def full_name
+      @namespace ? "#{@namespace}.#{@name}" : @name
+    end
+
+    #:stopdoc:
+    # until @config is consistent in index + actual loading
+    def config
+      @config ||= {}
+    end
+
+    def file_string_and_method_for_args(lib)
+      if !lib.is_a?(ModuleLibrary) && (klass_method = (lib.class_commands || {})[@name])
+        if RUBY_VERSION >= '1.9'
+          klass, meth = klass_method.split(NAMESPACE, 2)
+          if (meth_locations = MethodInspector.find_method_locations_for_19(klass, meth))
+            file_string = File.read meth_locations[0]
+          end
+        end
+      elsif File.exists?(lib.library_file || '')
+        file_string, meth = FileLibrary.read_library_file(lib.library_file), @name
+      end
+      [file_string, meth]
+    end
+
+    def has_splat_args?
+      !!(args && @args[-1] && @args[-1][0][/^\*/])
+    end
+
+    def make_option_command(lib=library)
+      @option_command = true
+      @args = [['*args']] unless args(lib) || arg_size
+    end
+
+    def option_command?
+      options || render_options || @option_command
+    end
+
+    def arg_size
+      @arg_size = args ? args.size : nil unless instance_variable_defined?("@arg_size")
+      @arg_size
+    end
+
+    def file_parsed_args?
+      @file_parsed_args
+    end
+
+    # Deprecated method
+    def description
+      puts "@command.description has been changed to @command.desc. Delete your old " +
+        "Boson index at ~/.boson/command/index.marshal for Boson to work from the commandline."
+      Kernel.exit
+    end
+
+    def marshal_dump
+      if @args && @args.any? {|e| e[1].is_a?(Module) }
+        @args.map! {|e| e.size == 2 ? [e[0], e[1].inspect] : e }
+        @file_parsed_args = true
+      end
+      [@name, @alias, @lib, @desc, @options, @render_options, @args, @default_option]
+    end
+
+    def marshal_load(ary)
+      @name, @alias, @lib, @desc, @options, @render_options, @args, @default_option = ary
+    end
+    #:startdoc:
+  end
+end