challah 0.6.0 → 0.6.1

data/vendor/bundle/gems/yard-0.8.2/docs/templates/default/fulldoc/html/full_list_tag.erb

@@ -0,0 +1,7 @@
+<% n = 1 %>
+<% collect_tags.each do |tag| %>
+  <li class="r<%= n %> <%= tag.object.has_tag?(:deprecated) ? 'deprecated' : '' %>">
+    <span class="object_link"><%= tag_link(tag) %></span>
+  </li>
+  <% n = n == 2 ? 1 : 2 %>
+<% end %>

data/vendor/bundle/gems/yard-0.8.2/docs/templates/default/fulldoc/html/setup.rb

@@ -0,0 +1,6 @@
+def generate_tag_list
+  @list_title = "Tag List"
+  @list_type = "tag"
+  asset('tag_list.html', erb(:full_list))
+end
+

data/vendor/bundle/gems/yard-0.8.2/docs/templates/default/layout/html/setup.rb

@@ -0,0 +1,8 @@
+def init
+  super
+  sections.place(:tag_list).after_any(:files)
+end
+
+def menu_lists
+  super + [{:type => 'tag', :title => 'Tags', :search_title => 'Tag List'}]
+end

data/vendor/bundle/gems/yard-0.8.2/docs/templates/default/layout/html/tag_list.erb

@@ -0,0 +1,11 @@
+<h2>Tag Listing</h2>
+<p>The following are a brief list of tags that can be used in YARD formatted
+  documentation. See <%= link_file "docs/Tags.md" %> for information on using tags.</p>
+<ul id="tags" class="index_inline_list">
+<% n = 1 %>
+<% collect_tags.each do |tag| %>
+  <li class="r<%= n %>"><%= tag_link(tag) %></li>
+  <% n = n == 2 ? 1 : 2 %>
+<% end %>
+</ul>
+<div class="clear"></div>

data/vendor/bundle/gems/yard-0.8.2/docs/templates/default/yard_tags/html/list.erb

@@ -0,0 +1,18 @@
+<% [["Tag", all_tags], ["Directive", all_directives]].each do |(name, list)| %>
+<h2><%= name %> List</h2>
+
+<% list.each_with_index do |tag, i| %>
+<div class="method_details <%= i == 0 ? 'first' : '' %>">
+  <h3 class="signature"
+      id="<%= tag.name %>" toc-title="<%= tag_link_name(tag) %>">
+    <%= tag_signature tag %>
+  </h3>
+  <% if name == "Directive" %>
+    <%= yieldall :object => P("YARD::Tags::#{tag.text}") %>
+  <% else %>
+    <%= yieldall :object => tag.object %>
+  <% end %>
+</div>
+<% end %>
+
+<% end%>

data/vendor/bundle/gems/yard-0.8.2/docs/templates/default/yard_tags/html/setup.rb

@@ -0,0 +1,27 @@
+def init
+  sections :list, [T('docstring')]
+end
+
+def tag_signature(tag)
+  types = tag.types || []
+  signature = "<strong>#{tag_link_name(tag)}</strong> "
+  extra = nil
+  if sig_tag = tag.object.tag('yard.signature')
+    extra = sig_tag.text
+  end
+  extra = case types.first
+  when 'with_name'
+    "name description"
+  when 'with_types'
+    "[Types] description"
+  when 'with_types_and_name'
+    "name [Types] description"
+  when 'with_title_and_text'
+    "title\ndescription"
+  when 'with_types_and_title'
+    "[Types] title\ndescription"
+  else
+    "description"
+  end if extra.nil?
+  signature + h(extra).gsub(/\n/, "<br/>&nbsp;&nbsp;&nbsp;")
+end

data/vendor/bundle/gems/yard-0.8.2/docs/templates/plugin.rb

@@ -0,0 +1,65 @@
+include YARD
+include Templates
+
+module TagTemplateHelper
+  def all_tags
+    Registry.all(:method).map {|m| m.tag('yard.tag') }.compact
+  end
+
+  def all_directives
+    Registry.all(:method).map {|m| m.tag('yard.directive') }.compact
+  end
+
+  def collect_tags
+    (all_tags + all_directives).sort_by {|t| t.name }
+  end
+
+  def tag_link(tag)
+    link_file("docs/Tags.md", tag_link_name(tag), tag.name)
+  end
+
+  def tag_link_name(tag)
+    prefix = tag.tag_name == 'yard.directive' ? '@!' : '@'
+    h(prefix + tag.name)
+  end
+
+  # Wrap url_for and url_for_file to rewrite object when generating docs for
+  # yard.tag/directive objects.
+  %w(url_for, url_for_file).each do |meth|
+    self.class.send(:define_method, meth) do
+      if object.is_a?(CodeObjects::Base) &&
+            (object.tag('yard.tag') || object.tag('yard.directive') ||
+            (object.type == :class && object.superclass.name == :Directive))
+          obj, self.object = object, Registry.root
+          url = super
+          self.object = obj
+          url
+      else
+        super
+      end
+    end
+  end
+
+  def linkify(*args)
+    if args.first.is_a?(String)
+      case args.first
+      when "yard:include_tags"
+        return T('yard_tags').run(options)
+      when /^tag:(\S+)/
+        tag_name, suffix = $1, "tag"
+        if tag_name =~ /^!/
+          tag_name, suffix = tag_name[1..-1], "directive"
+        end
+        if obj = Registry.at("YARD::Tags::Library##{tag_name}_#{suffix}")
+          return tag_link(obj.tag("yard.#{suffix}"))
+        end
+        log.warn "Cannot find tag: #{args.first}"
+        return args.first
+      end
+    end
+    super
+  end
+end
+
+Template.extra_includes << TagTemplateHelper
+Engine.register_template_path(File.dirname(__FILE__))

data/vendor/bundle/gems/yard-0.8.2/lib/rubygems_plugin.rb

@@ -0,0 +1,4 @@
+unless defined?(Gem::DocManager.load_yardoc)
+  require File.expand_path(File.dirname(__FILE__) + '/yard/rubygems/specification')
+  require File.expand_path(File.dirname(__FILE__) + '/yard/rubygems/doc_manager')
+end

data/vendor/bundle/gems/yard-0.8.2/lib/yard/autoload.rb

@@ -0,0 +1,284 @@
+# @private
+def __p(path) File.join(YARD::ROOT, 'yard', *path.split('/')); end
+
+module YARD
+  module CLI # Namespace for command-line interface components
+    autoload :Command,        __p('cli/command')
+    autoload :CommandParser,  __p('cli/command_parser')
+    autoload :Config,         __p('cli/config')
+    autoload :Diff,           __p('cli/diff')
+    autoload :Gems,           __p('cli/gems')
+    autoload :Graph,          __p('cli/graph')
+    autoload :Help,           __p('cli/help')
+    autoload :List,           __p('cli/list')
+    autoload :Server,         __p('cli/server')
+    autoload :Stats,          __p('cli/stats')
+    autoload :Yardoc,         __p('cli/yardoc')
+    autoload :YRI,            __p('cli/yri')
+    autoload :I18n,           __p('cli/i18n')
+  end
+
+  # A "code object" is defined as any entity in the Ruby language.
+  # Classes, modules, methods, class variables and constants are the
+  # major objects, but DSL languages can create their own by inheriting
+  # from {CodeObjects::Base}.
+  module CodeObjects
+    autoload :Base,                 __p('code_objects/base')
+    autoload :CodeObjectList,       __p('code_objects/base')
+    autoload :ClassObject,          __p('code_objects/class_object')
+    autoload :ClassVariableObject,  __p('code_objects/class_variable_object')
+    autoload :ConstantObject,       __p('code_objects/constant_object')
+    autoload :ExtendedMethodObject, __p('code_objects/extended_method_object')
+    autoload :ExtraFileObject,      __p('code_objects/extra_file_object')
+    autoload :MacroObject,          __p('code_objects/macro_object')
+    autoload :MethodObject,         __p('code_objects/method_object')
+    autoload :ModuleObject,         __p('code_objects/module_object')
+    autoload :NamespaceObject,      __p('code_objects/namespace_object')
+    autoload :Proxy,                __p('code_objects/proxy')
+    autoload :ProxyMethodError,     __p('code_objects/proxy')
+    autoload :RootObject,           __p('code_objects/root_object')
+
+    autoload :BUILTIN_ALL,          __p('code_objects/base')
+    autoload :BUILTIN_CLASSES,      __p('code_objects/base')
+    autoload :BUILTIN_MODULES,      __p('code_objects/base')
+    autoload :BUILTIN_EXCEPTIONS,   __p('code_objects/base')
+    autoload :CONSTANTMATCH,        __p('code_objects/base')
+    autoload :METHODMATCH,          __p('code_objects/base')
+    autoload :METHODNAMEMATCH,      __p('code_objects/base')
+    autoload :NAMESPACEMATCH,       __p('code_objects/base')
+    autoload :NSEP,                 __p('code_objects/base')
+    autoload :NSEPQ,                __p('code_objects/base')
+    autoload :ISEP,                 __p('code_objects/base')
+    autoload :ISEPQ,                __p('code_objects/base')
+    autoload :CSEP,                 __p('code_objects/base')
+    autoload :CSEPQ,                __p('code_objects/base')
+  end
+
+  # Handlers are called during the data processing part of YARD's
+  # parsing phase. This allows YARD as well as any custom extension to
+  # analyze source and generate {CodeObjects} to be stored for later use.
+  module Handlers
+    # CRuby Handlers
+    # @since 0.8.0
+    module C
+      autoload :Base,                     __p('handlers/c/base')
+
+      autoload :AliasHandler,             __p('handlers/c/alias_handler')
+      autoload :AttributeHandler,         __p('handlers/c/attribute_handler')
+      autoload :ClassHandler,             __p('handlers/c/class_handler')
+      autoload :ConstantHandler,          __p('handlers/c/constant_handler')
+      autoload :HandlerMethods,           __p('handlers/c/handler_methods')
+      autoload :InitHandler,              __p('handlers/c/init_handler')
+      autoload :MethodHandler,            __p('handlers/c/method_handler')
+      autoload :MixinHandler,             __p('handlers/c/mixin_handler')
+      autoload :ModuleHandler,            __p('handlers/c/module_handler')
+      autoload :OverrideCommentHandler,   __p('handlers/c/override_comment_handler')
+      autoload :PathHandler,              __p('handlers/c/path_handler')
+      autoload :StructHandler,            __p('handlers/c/struct_handler')
+      autoload :SymbolHandler,            __p('handlers/c/symbol_handler')
+    end
+
+    module Ruby # All Ruby handlers
+      module Legacy # Handlers for old Ruby 1.8 parser
+        autoload :Base,                   __p('handlers/ruby/legacy/base')
+
+        autoload :AliasHandler,           __p('handlers/ruby/legacy/alias_handler')
+        autoload :AttributeHandler,       __p('handlers/ruby/legacy/attribute_handler')
+        autoload :ClassHandler,           __p('handlers/ruby/legacy/class_handler')
+        autoload :ClassConditionHandler,  __p('handlers/ruby/legacy/class_condition_handler')
+        autoload :ClassVariableHandler,   __p('handlers/ruby/legacy/class_variable_handler')
+        autoload :CommentHandler,         __p('handlers/ruby/legacy/comment_handler')
+        autoload :ConstantHandler,        __p('handlers/ruby/legacy/constant_handler')
+        autoload :DSLHandler,             __p('handlers/ruby/legacy/dsl_handler')
+        autoload :ExceptionHandler,       __p('handlers/ruby/legacy/exception_handler')
+        autoload :ExtendHandler,          __p('handlers/ruby/legacy/extend_handler')
+        autoload :MethodHandler,          __p('handlers/ruby/legacy/method_handler')
+        autoload :MixinHandler,           __p('handlers/ruby/legacy/mixin_handler')
+        autoload :ModuleHandler,          __p('handlers/ruby/legacy/module_handler')
+        autoload :ModuleFunctionHandler,  __p('handlers/ruby/legacy/module_function_handler')
+        autoload :PrivateConstantHandler, __p('handlers/ruby/legacy/private_constant_handler')
+        autoload :VisibilityHandler,      __p('handlers/ruby/legacy/visibility_handler')
+        autoload :YieldHandler,           __p('handlers/ruby/legacy/yield_handler')
+      end
+
+      autoload :Base,                     __p('handlers/ruby/base')
+
+      autoload :AliasHandler,             __p('handlers/ruby/alias_handler')
+      autoload :AttributeHandler,         __p('handlers/ruby/attribute_handler')
+      autoload :ClassHandler,             __p('handlers/ruby/class_handler')
+      autoload :ClassConditionHandler,    __p('handlers/ruby/class_condition_handler')
+      autoload :ClassVariableHandler,     __p('handlers/ruby/class_variable_handler')
+      autoload :CommentHandler,           __p('handlers/ruby/comment_handler')
+      autoload :ConstantHandler,          __p('handlers/ruby/constant_handler')
+      autoload :DSLHandler,               __p('handlers/ruby/dsl_handler')
+      autoload :DSLHandlerMethods,        __p('handlers/ruby/dsl_handler_methods')
+      autoload :ExceptionHandler,         __p('handlers/ruby/exception_handler')
+      autoload :ExtendHandler,            __p('handlers/ruby/extend_handler')
+      autoload :MethodHandler,            __p('handlers/ruby/method_handler')
+      autoload :MethodConditionHandler,   __p('handlers/ruby/method_condition_handler')
+      autoload :MixinHandler,             __p('handlers/ruby/mixin_handler')
+      autoload :ModuleHandler,            __p('handlers/ruby/module_handler')
+      autoload :ModuleFunctionHandler,    __p('handlers/ruby/module_function_handler')
+      autoload :PrivateConstantHandler,   __p('handlers/ruby/private_constant_handler')
+      autoload :StructHandlerMethods,     __p('handlers/ruby/struct_handler_methods')
+      autoload :VisibilityHandler,        __p('handlers/ruby/visibility_handler')
+      autoload :YieldHandler,             __p('handlers/ruby/yield_handler')
+    end
+
+    autoload :Base,                       __p('handlers/base')
+    autoload :NamespaceMissingError,      __p('handlers/base')
+    autoload :Processor,                  __p('handlers/processor')
+  end
+
+  # Namespace for internationalization (i18n)
+  # @since 0.8.0
+  module I18n
+    autoload :Locale,          __p('i18n/locale')
+    autoload :Message,         __p('i18n/message')
+    autoload :Messages,        __p('i18n/messages')
+    autoload :PotGenerator,    __p('i18n/pot_generator')
+    autoload :Text,            __p('i18n/text')
+  end
+
+  # The parser namespace holds all parsing engines used by YARD.
+  # Currently only Ruby and C (Ruby) parsers are implemented.
+  module Parser
+    module C # CRuby Parsing components
+      autoload :BodyStatement,     __p('parser/c/statement')
+      autoload :Comment,           __p('parser/c/statement')
+      autoload :CommentParser,     __p('parser/c/comment_parser')
+      autoload :CParser,           __p('parser/c/c_parser')
+      autoload :Statement,         __p('parser/c/statement')
+      autoload :ToplevelStatement, __p('parser/c/statement')
+    end
+
+    module Ruby # Ruby parsing components.
+      module Legacy # Handles Ruby parsing in Ruby 1.8.
+        autoload :RipperParser,   __p('parser/ruby/legacy/ruby_parser')
+        autoload :RubyParser,     __p('parser/ruby/legacy/ruby_parser')
+        autoload :RubyToken,      __p('parser/ruby/legacy/ruby_lex')
+        autoload :Statement,      __p('parser/ruby/legacy/statement')
+        autoload :StatementList,  __p('parser/ruby/legacy/statement_list')
+        autoload :TokenList,      __p('parser/ruby/legacy/token_list')
+      end
+
+      autoload :AstNode,           __p('parser/ruby/ast_node')
+      autoload :RubyParser,        __p('parser/ruby/ruby_parser')
+    end
+
+    autoload :Base,                __p('parser/base')
+    autoload :ParserSyntaxError,   __p('parser/source_parser')
+    autoload :SourceParser,        __p('parser/source_parser')
+    autoload :UndocumentableError, __p('parser/source_parser')
+  end
+
+  module Rake # Holds Rake tasks used by YARD
+    autoload :YardocTask, __p('rake/yardoc_task')
+  end
+
+  module Serializers # Namespace for components that serialize to various endpoints
+    autoload :Base,                 __p('serializers/base')
+    autoload :FileSystemSerializer, __p('serializers/file_system_serializer')
+    autoload :ProcessSerializer,    __p('serializers/process_serializer')
+    autoload :StdoutSerializer,     __p('serializers/stdout_serializer')
+    autoload :YardocSerializer,     __p('serializers/yardoc_serializer')
+  end
+
+  # Namespace for classes and modules that handle serving documentation over HTTP
+  #
+  # == Implementing a Custom Server
+  # To customize the YARD server, see the {Adapter} and {Router} classes.
+  #
+  # == Rack Middleware
+  # If you want to use the YARD server as a Rack middleware, see the documentation
+  # in {RackMiddleware}.
+  #
+  # @since 0.6.0
+  module Server
+    require __p('server')
+
+    # Commands implement specific kinds of server responses which are routed
+    # to by the {Router} class. To implement a custom command, subclass {Commands::Base}.
+    module Commands
+      autoload :Base,                 __p('server/commands/base')
+      autoload :DisplayFileCommand,   __p('server/commands/display_file_command')
+      autoload :DisplayObjectCommand, __p('server/commands/display_object_command')
+      autoload :FramesCommand,        __p('server/commands/frames_command')
+      autoload :ListCommand,          __p('server/commands/list_command')
+      autoload :LibraryCommand,       __p('server/commands/library_command')
+      autoload :LibraryIndexCommand,  __p('server/commands/library_index_command')
+      autoload :SearchCommand,        __p('server/commands/search_command')
+      autoload :StaticFileCommand,    __p('server/commands/static_file_command')
+    end
+
+    autoload :Adapter,                __p('server/adapter')
+    autoload :DocServerSerializer,    __p('server/doc_server_serializer')
+    autoload :DocServerHelper,        __p('server/doc_server_helper')
+    autoload :FinishRequest,          __p('server/adapter')
+    autoload :LibraryVersion,         __p('server/library_version')
+    autoload :NotFoundError,          __p('server/adapter')
+    autoload :RackAdapter,            __p('server/rack_adapter')
+    autoload :RackMiddleware,         __p('server/rack_adapter')
+    autoload :Router,                 __p('server/router')
+    autoload :StaticCaching,          __p('server/static_caching')
+    autoload :WebrickAdapter,         __p('server/webrick_adapter')
+    autoload :WebrickServlet,         __p('server/webrick_adapter')
+  end
+
+  module Tags # Namespace for Tag components
+    autoload :AttributeDirective,  __p('tags/directives')
+    autoload :DefaultFactory,      __p('tags/default_factory')
+    autoload :DefaultTag,          __p('tags/default_tag')
+    autoload :EndGroupDirective,   __p('tags/directives')
+    autoload :GroupDirective,      __p('tags/directives')
+    autoload :Library,             __p('tags/library')
+    autoload :MacroDirective,      __p('tags/directives')
+    autoload :MethodDirective,     __p('tags/directives')
+    autoload :OptionTag,           __p('tags/option_tag')
+    autoload :OverloadTag,         __p('tags/overload_tag')
+    autoload :ParseDirective,      __p('tags/directives')
+    autoload :RefTag,              __p('tags/ref_tag')
+    autoload :RefTagList,          __p('tags/ref_tag_list')
+    autoload :ScopeDirective,      __p('tags/directives')
+    autoload :Tag,                 __p('tags/tag')
+    autoload :TagFormatError,      __p('tags/tag_format_error')
+    autoload :VisibilityDirective, __p('tags/directives')
+  end
+
+  # Namespace for templating system
+  module Templates
+    module Helpers # Namespace for template helpers
+      module Markup # Namespace for markup providers
+        autoload :RDocMarkup,               __p('templates/helpers/markup/rdoc_markup')
+      end
+
+      autoload :BaseHelper,                 __p('templates/helpers/base_helper')
+      autoload :FilterHelper,               __p('templates/helpers/filter_helper')
+      autoload :HtmlHelper,                 __p('templates/helpers/html_helper')
+      autoload :HtmlSyntaxHighlightHelper,  __p('templates/helpers/html_syntax_highlight_helper')
+      autoload :MarkupHelper,               __p('templates/helpers/markup_helper')
+      autoload :MethodHelper,               __p('templates/helpers/method_helper')
+      autoload :ModuleHelper,               __p('templates/helpers/module_helper')
+      autoload :TextHelper,                 __p('templates/helpers/text_helper')
+      autoload :UMLHelper,                  __p('templates/helpers/uml_helper')
+    end
+
+    autoload :Engine,          __p('templates/engine')
+    autoload :ErbCache,        __p('templates/erb_cache')
+    autoload :Section,         __p('templates/section')
+    autoload :Template,        __p('templates/template')
+    autoload :TemplateOptions, __p('templates/template_options')
+  end
+
+  autoload :Config,          __p('config')
+  autoload :Docstring,       __p('docstring')
+  autoload :DocstringParser, __p('docstring_parser')
+  autoload :Logger,          __p('logging')
+  autoload :Options,         __p('options')
+  autoload :Registry,        __p('registry')
+  autoload :RegistryStore,   __p('registry_store')
+  autoload :StubProxy,       __p('serializers/yardoc_serializer')
+  autoload :Verifier,        __p('verifier')
+end
+
+undef __p

data/vendor/bundle/gems/yard-0.8.2/lib/yard/cli/command.rb

@@ -0,0 +1,76 @@
+require 'optparse'
+
+module YARD
+  module CLI
+    # Abstract base class for CLI utilities. Provides some helper methods for
+    # the option parser
+    #
+    # @abstract
+    # @since 0.6.0
+    class Command
+      # Helper method to run the utility on an instance.
+      # @see #run
+      def self.run(*args) new.run(*args) end
+
+      def description; '' end
+
+      protected
+
+      # Adds a set of common options to the tail of the OptionParser
+      #
+      # @param [OptionParser] opts the option parser object
+      # @return [void]
+      def common_options(opts)
+        opts.separator ""
+        opts.separator "Other options:"
+        opts.on('-e', '--load FILE', 'A Ruby script to load before running command.') do |file|
+          load_script(file)
+        end
+        opts.on('--plugin PLUGIN', 'Load a YARD plugin (gem with `yard-\' prefix)') do |name|
+          # Not actually necessary to load here, this is done at boot in YARD::Config.load_plugins
+          # YARD::Config.load_plugin(name)
+        end
+        opts.on('--legacy', 'Use old style Ruby parser and handlers. ',
+                            '  Always on in 1.8.x.') do
+          YARD::Parser::SourceParser.parser_type = :ruby18
+        end
+        opts.on('--safe', 'Enable safe mode for this instance') do
+          # Parsed in YARD::Config.load
+        end
+        opts.on_tail('-q', '--quiet', 'Show no warnings.') { log.level = Logger::ERROR }
+        opts.on_tail('--verbose', 'Show more information.') { log.level = Logger::INFO }
+        opts.on_tail('--debug', 'Show debugging information.') { log.level = Logger::DEBUG }
+        opts.on_tail('--backtrace', 'Show stack traces') { log.show_backtraces = true }
+        opts.on_tail('-v', '--version', 'Show version.') { puts "yard #{YARD::VERSION}"; exit }
+        opts.on_tail('-h', '--help', 'Show this help.')  { puts opts; exit }
+      end
+
+      # Parses the option and gracefully handles invalid switches
+      #
+      # @param [OptionParser] opts the option parser object
+      # @param [Array<String>] args the arguments passed from input. This
+      #   array will be modified.
+      # @return [void]
+      def parse_options(opts, args)
+        opts.parse!(args)
+      rescue OptionParser::ParseError => err
+        log.warn "Unrecognized/#{err.message}"
+        args.shift if args.first && args.first[0,1] != '-'
+        retry
+      end
+
+      # Loads a Ruby script. If <tt>Config.options[:safe_mode]</tt> is enabled,
+      # this method will do nothing.
+      #
+      # @param [String] file the path to the script to load
+      # @since 0.6.2
+      def load_script(file)
+        return if YARD::Config.options[:safe_mode]
+        load(file)
+      rescue LoadError => load_exception
+        log.error "The file `#{file}' could not be loaded:\n#{load_exception}"
+        exit
+      end
+    end
+  end
+end

data/vendor/bundle/gems/yard-0.8.2/lib/yard/cli/command_parser.rb

@@ -0,0 +1,90 @@
+module YARD
+  module CLI
+    # This class parses a command name out of the +yard+ CLI command and calls
+    # that command in the form:
+    #
+    #   $ yard command_name [options]
+    #
+    # If no command or arguments are specified, or if the arguments immediately
+    # begin with a +--opt+ (not +--help+), the {default_command} will be used
+    # (which itself defaults to +:doc+).
+    #
+    # == Adding a Command
+    #
+    # To add a custom command via plugin, create a mapping in {commands} from
+    # the Symbolic command name to the {Command} class that implements the
+    # command. To implement a command, see the documentation for the {Command}
+    # class.
+    #
+    # @see Command
+    # @see commands
+    # @see default_command
+    class CommandParser
+      class << self
+        # @return [Hash{Symbol => Command}] the mapping of command names to
+        #   command classes to parse the user command.
+        attr_accessor :commands
+
+        # @return [Symbol] the default command name to use when no options
+        #   are specified or
+        attr_accessor :default_command
+      end
+
+      self.commands = SymbolHash[
+        :config => Config,
+        :diff   => Diff,
+        :doc    => Yardoc,
+        :gems   => Gems,
+        :graph  => Graph,
+        :help   => Help,
+        :list   => List,
+        :ri     => YRI,
+        :server => Server,
+        :stats  => Stats,
+        :i18n   => I18n
+      ]
+
+      self.default_command = :doc
+
+      # Convenience method to create a new CommandParser and call {#run}
+      # @return (see #run)
+      def self.run(*args) new.run(*args) end
+
+      def initialize
+        log.show_backtraces = false
+      end
+
+      # Runs the {Command} object matching the command name of the first
+      # argument.
+      # @return [void]
+      def run(*args)
+        unless args == ['--help']
+          if args.size == 0 || args.first =~ /^-/
+            command_name = self.class.default_command
+          else
+            command_name = args.first.to_sym
+            args.shift
+          end
+          if commands.has_key?(command_name)
+            return commands[command_name].run(*args)
+          end
+        end
+        list_commands
+      end
+
+      private
+
+      def commands; self.class.commands end
+
+      def list_commands
+        puts "Usage: yard <command> [options]"
+        puts
+        puts "Commands:"
+        commands.keys.sort_by {|k| k.to_s }.each do |command_name|
+          command = commands[command_name].new
+          puts "%-8s %s" % [command_name, command.description]
+        end
+      end
+    end
+  end
+end