cmdparse 1.0.0 → 1.0.1

data/ChangeLog

@@ -1,80 +1,185 @@
 ------------------------------------------------------------------------
-r10 | thomas | 2004-09-27 18:46:38 +0200 (Mon, 27 Sep 2004) | 1 line
+r242 | thomas | 2005-04-13 13:42:24 +0200 (Wed, 13 Apr 2005) | 1 line
 Changed paths:
-   M /trunk/Rakefile
-   M /trunk/doc/src/download.fragment
+   M /trunk/cmdparse/README
+
+
+------------------------------------------------------------------------
+r241 | thomas | 2005-04-13 13:41:16 +0200 (Wed, 13 Apr 2005) | 3 lines
+Changed paths:
+   M /trunk/cmdparse/README
+   M /trunk/cmdparse/Rakefile
+   M /trunk/cmdparse/TODO
+   A /trunk/cmdparse/logo.svg
+   M /trunk/cmdparse/test.rb
+
+* added logo.svg
+* adapted test.rb
+* minor modifcation in Rakefile
+------------------------------------------------------------------------
+r240 | thomas | 2005-04-13 13:40:39 +0200 (Wed, 13 Apr 2005) | 4 lines
+Changed paths:
+   M /trunk/cmdparse/lib/cmdparse.rb
+
+* added NoCommandGivenError class
+* renamed class InvalidCommand to InvalidCommandError
+* added option for specifying default command
+* bumped version number to 1.0.1
+------------------------------------------------------------------------
+r239 | thomas | 2005-04-13 13:38:04 +0200 (Wed, 13 Apr 2005) | 3 lines
+Changed paths:
+   M /trunk/cmdparse/doc/src/default.css
+   M /trunk/cmdparse/doc/src/default.template
+   M /trunk/cmdparse/doc/src/download.page
+   M /trunk/cmdparse/doc/src/features.page
+   M /trunk/cmdparse/doc/src/index.page
+   A /trunk/cmdparse/doc/src/logo.png
+   M /trunk/cmdparse/doc/src/meta.info
+
+* added logo
+* converted pages to use textile markup
+* added news section on homepage
+------------------------------------------------------------------------
+r238 | thomas | 2005-04-13 12:06:31 +0200 (Wed, 13 Apr 2005) | 2 lines
+Changed paths:
+   M /trunk/cmdparse/doc/src/default.css
+   M /trunk/cmdparse/doc/src/default.template
+   D /trunk/cmdparse/doc/src/download.fragment
+   A /trunk/cmdparse/doc/src/download.page (from /trunk/cmdparse/doc/src/download.fragment:235)
+   D /trunk/cmdparse/doc/src/features.fragment
+   A /trunk/cmdparse/doc/src/features.page (from /trunk/cmdparse/doc/src/features.fragment:235)
+   D /trunk/cmdparse/doc/src/index.fragment
+   A /trunk/cmdparse/doc/src/index.page (from /trunk/cmdparse/doc/src/index.fragment:235)
+   A /trunk/cmdparse/doc/src/meta.info (from /trunk/cmdparse/doc/src/metainfo.backing:235)
+   D /trunk/cmdparse/doc/src/metainfo.backing
+
+* updated documentation pages to webgen 0.3.1
+* added new default.template and css file
+------------------------------------------------------------------------
+r235 | thomas | 2005-04-13 11:17:35 +0200 (Wed, 13 Apr 2005) | 1 line
+Changed paths:
+   A /trunk/cmdparse (from /trunk/commandparser:165)
+
+* renamed commandparser dir to cmdparse
+------------------------------------------------------------------------
+r165 | thomas | 2005-01-13 17:33:02 +0100 (Thu, 13 Jan 2005) | 1 line
+Changed paths:
+   D /temp
+   A /trunk (from /temp:163)
+
+add finally arrived at the destination
+------------------------------------------------------------------------
+r163 | thomas | 2005-01-13 17:31:39 +0100 (Thu, 13 Jan 2005) | 1 line
+Changed paths:
+   A /temp
+   A /temp/commandparser (from /trunk/commandparser/trunk:162)
+   A /temp/programs (from /trunk/miscprograms/trunk:162)
+   A /temp/rubyquiz (from /trunk/rubyquiz:162)
+   A /temp/webgen (from /trunk/webgen/trunk:162)
+   A /temp/xmlresume2x (from /trunk/xmlresume2x/trunk:162)
+   D /trunk/commandparser/trunk
+   D /trunk/miscprograms/trunk
+   D /trunk/rubyquiz
+   D /trunk/webgen/trunk
+   D /trunk/webgen/versions/webgen-0.1.0
+   D /trunk/webgen/versions/webgen-0.2.0
+   D /trunk/xmlresume2x/trunk
+   D /trunk/xmlresume2x/versions/xmlresume2x-0.1.0
+   D /trunk/xmlresume2x/versions/xmlresume2x-0.2.0
+   D /trunk/xmlresume2x/versions/xmlresume2x-0.2.1
+   A /versions
+   A /versions/webgen-0.1.0 (from /trunk/webgen/versions/webgen-0.1.0:162)
+   A /versions/webgen-0.2.0 (from /trunk/webgen/versions/webgen-0.2.0:162)
+   A /versions/xmlresume2x-0.1.0 (from /trunk/xmlresume2x/versions/xmlresume2x-0.1.0:162)
+   A /versions/xmlresume2x-0.2.0 (from /trunk/xmlresume2x/versions/xmlresume2x-0.2.0:162)
+   A /versions/xmlresume2x-0.2.1 (from /trunk/xmlresume2x/versions/xmlresume2x-0.2.1:162)
+
+moved stuff around and around
+------------------------------------------------------------------------
+r14 | thomas | 2004-09-30 17:54:54 +0200 (Thu, 30 Sep 2004) | 2 lines
+Changed paths:
+   M /trunk/commandparser/trunk/lib/cmdparse.rb
+   M /trunk/commandparser/trunk/test.rb
+
+* added the directory lib to the loadpath of test.rb
+* the "--help" and "-h" global options now take a command as optional argument
+------------------------------------------------------------------------
+r12 | thomas | 2004-09-27 18:46:38 +0200 (Mon, 27 Sep 2004) | 1 line
+Changed paths:
+   M /trunk/commandparser/trunk/Rakefile
+   M /trunk/commandparser/trunk/doc/src/download.fragment
 
 * corrected an error in the <Download> page and in the Rakefile
 ------------------------------------------------------------------------
-r8 | thomas | 2004-09-27 18:22:39 +0200 (Mon, 27 Sep 2004) | 3 lines
+r10 | thomas | 2004-09-27 18:22:39 +0200 (Mon, 27 Sep 2004) | 3 lines
 Changed paths:
-   M /trunk/Rakefile
-   M /trunk/doc/src/default.template
-   M /trunk/lib/cmdparse.rb
+   M /trunk/commandparser/trunk/Rakefile
+   M /trunk/commandparser/trunk/doc/src/default.template
+   M /trunk/commandparser/trunk/lib/cmdparse.rb
 
 * changed version to 1.0.0
 * updated Rakefile
 * minor change in documentation template
 ------------------------------------------------------------------------
-r7 | thomas | 2004-09-27 18:11:36 +0200 (Mon, 27 Sep 2004) | 1 line
+r9 | thomas | 2004-09-27 18:11:36 +0200 (Mon, 27 Sep 2004) | 1 line
 Changed paths:
-   M /trunk/README
-   M /trunk/Rakefile
-   A /trunk/doc/src/default.css
-   A /trunk/doc/src/default.template
-   A /trunk/doc/src/download.fragment
-   A /trunk/doc/src/features.fragment
-   A /trunk/doc/src/index.fragment
-   A /trunk/doc/src/metainfo.backing
-   M /trunk/lib/cmdparse.rb
+   M /trunk/commandparser/trunk/README
+   M /trunk/commandparser/trunk/Rakefile
+   A /trunk/commandparser/trunk/doc/src/default.css
+   A /trunk/commandparser/trunk/doc/src/default.template
+   A /trunk/commandparser/trunk/doc/src/download.fragment
+   A /trunk/commandparser/trunk/doc/src/features.fragment
+   A /trunk/commandparser/trunk/doc/src/index.fragment
+   A /trunk/commandparser/trunk/doc/src/metainfo.backing
+   M /trunk/commandparser/trunk/lib/cmdparse.rb
 
 * added some documentation to the doc folder
 ------------------------------------------------------------------------
-r6 | thomas | 2004-09-27 17:45:02 +0200 (Mon, 27 Sep 2004) | 2 lines
+r8 | thomas | 2004-09-27 17:45:02 +0200 (Mon, 27 Sep 2004) | 2 lines
 Changed paths:
-   A /trunk/doc/src
-   M /trunk/lib/cmdparse.rb
-   M /trunk/test.rb
+   A /trunk/commandparser/trunk/doc/src
+   M /trunk/commandparser/trunk/lib/cmdparse.rb
+   M /trunk/commandparser/trunk/test.rb
 
 * added VersionCommand class
 * added example to rdoc documentation
 ------------------------------------------------------------------------
-r5 | thomas | 2004-09-26 18:27:54 +0200 (Sun, 26 Sep 2004) | 3 lines
+r7 | thomas | 2004-09-26 18:27:54 +0200 (Sun, 26 Sep 2004) | 3 lines
 Changed paths:
-   A /trunk/COPYING
-   A /trunk/README
-   A /trunk/Rakefile
-   D /trunk/cmdparse.rb
-   A /trunk/doc
-   A /trunk/lib
-   A /trunk/lib/cmdparse.rb (from /trunk/cmdparse.rb:4)
-   A /trunk/setup.rb
+   A /trunk/commandparser/trunk/COPYING
+   A /trunk/commandparser/trunk/README
+   A /trunk/commandparser/trunk/Rakefile
+   D /trunk/commandparser/trunk/cmdparse.rb
+   A /trunk/commandparser/trunk/doc
+   A /trunk/commandparser/trunk/lib
+   A /trunk/commandparser/trunk/lib/cmdparse.rb (from /trunk/commandparser/trunk/cmdparse.rb:6)
+   A /trunk/commandparser/trunk/setup.rb
 
 * added standard files: COPYING, README, Rakefile, setup.rb
 * moved cmdparse.rb into lib directory
 * added documentation
 ------------------------------------------------------------------------
-r4 | thomas | 2004-09-23 17:19:11 +0200 (Thu, 23 Sep 2004) | 3 lines
+r6 | thomas | 2004-09-23 17:19:11 +0200 (Thu, 23 Sep 2004) | 3 lines
 Changed paths:
-   M /trunk/TODO
-   M /trunk/cmdparse.rb
-   M /trunk/test.rb
+   M /trunk/commandparser/trunk/TODO
+   M /trunk/commandparser/trunk/cmdparse.rb
+   M /trunk/commandparser/trunk/test.rb
 
 * remove error checking in main part so that error fall threw
 * added new commands to OptionParser class to get unchanged values
 * added <good> behaviour for usage and banner lines
 ------------------------------------------------------------------------
-r3 | thomas | 2004-09-22 20:16:29 +0200 (Wed, 22 Sep 2004) | 1 line
+r5 | thomas | 2004-09-22 20:16:29 +0200 (Wed, 22 Sep 2004) | 1 line
 Changed paths:
-   A /trunk/TODO
-   A /trunk/cmdparse.rb
-   A /trunk/test.rb
+   A /trunk/commandparser/trunk/TODO
+   A /trunk/commandparser/trunk/cmdparse.rb
+   A /trunk/commandparser/trunk/test.rb
 
 * initial import
 ------------------------------------------------------------------------
-r1 | thomas | 2004-09-22 20:15:42 +0200 (Wed, 22 Sep 2004) | 1 line
+r3 | thomas | 2004-09-22 20:15:42 +0200 (Wed, 22 Sep 2004) | 1 line
 Changed paths:
-   A /trunk
+   A /trunk/commandparser/trunk
 
 
 ------------------------------------------------------------------------

data/README

@@ -36,12 +36,12 @@ You can build the documentation by invoking
  $ rake doc
 
 This builds the API and the additional documentation. The additional documentation needs webgen
-(webgen.rubyforge.org) for building.
+>=0.3.2 (webgen.rubyforge.org) for building.
 
 
 = Example
 
-There is an example of how to use cmdparse in the +test+ directory.
+There is an example of how to use cmdparse in the +test.rb+ file.
 
 
 = Contact

data/Rakefile

@@ -71,7 +71,7 @@ CLOBBER << "doc/output"
 desc "Builds the documentation"
 task :doc => [:rdoc] do
   Dir.chdir("doc")
-  sh "webgen -V 4"
+  sh "webgen -V 3"
   Dir.chdir("..")
 end
 
@@ -154,14 +154,6 @@ else
 
 end
 
-
-desc "Creates a tag in the repository"
-task :tag do
-  repositoryPath = File.dirname( $1 ) if `svn info` =~ /^URL: (.*)$/
-  fail "Tag already created in repository " if /#{PKG_FULLNAME}/ =~ `svn ls #{repositoryPath}/versions`
-  sh "svn cp -m 'Created version #{PKG_FULLNAME}' #{repositoryPath}/trunk #{repositoryPath}/versions/#{PKG_FULLNAME}"
-end
-
 desc "Upload documentation to homepage"
 task :uploaddoc => [:doc] do
   Dir.chdir('doc/output')

data/TODO

@@ -1,5 +1,7 @@
 
-
 ---- DONE ----
 
 * define banner in a common way (like option parser), maybe use the one from option parser
+* raise NoCommandGivenError when no command was given
+* ability to specify default command (used when no command was given)
+* add order,order!,... methods to mimic optparse

data/VERSION

@@ -1 +1 @@
-1.0.0
+1.0.1

data/doc/src/default.css

@@ -1,85 +1,84 @@
-  html {
-	margin: 0px 5%;
-	background-color: #eee;
-  }
+/*
+#5CB85C -> background
+#408040 -> headings
+#CFE6CF -> code
+#30BF30 -> other
+ */
 
   body {
-	margin: 0px;
-	padding: 0px;
-	background-color: #fff;
+	margin: 0px 2em;
 	font-size: 12px;
 	font-family: Verdana, Arial, Helvetica;
+    border: 1px solid black;
+    color: black;
   }
 
-  /* General layout of the page */
+  h1, h2, h3, h4, h5 { color: #408040}
+
+  a:visited { color: #408040; }
+  a { color: #5CB85C; }
+  .bar a { color: white }
+  .bar a:visited { color: white }
 
-  #header, #footer {
-	width: 100%;
-	background-color: #58b;
-	color: #fff;
+  #all { background-color: #CFE6CF; }
+
+  #header {
+    border-bottom: 1px solid black;
+    padding: 1ex;
+    background-color: #5CB85C;
+  }
+  #header img {
+    padding-right: 5em;
+  }
+  #header h1 {
+    margin: 0ex;
+	font-size: 300%;
+	font-style: italic;
+	font-weight: normal;
+    color: white;
+  }
+
+, #headerbar { border-bottom: 1px solid black; }
+  #footer { border-top: 1px solid black; }
+
+  #body {
+    margin-left: 250px;
+    margin-right: 20px;
+    padding: 10px;
   }
 
   #menu {
 	float: left;
 	width: 230px;
-    padding: 20px 0px 0px 20px;
-	border: 3px solid #58b;
+    padding: 20px 0px 0px 2px;
   }
 
-  #body {
-	margin-left: 250px;
-	padding: 20px;
-  }
-
-  #footer {
+  .bar {
 	clear: both;
-	padding: 5px 0px;
+	padding: 3px;
 	text-align: center;
-  }
-
-
-  /* styling the header */
-
-  #headerbar {
-	width: 100%;
 	font-size: 90%;
+    background-color: #30BF30;
   }
 
-  span#navbar, span#languages {
-	padding: 3px;
-	width: 45%;
+  .left, .right {
+    padding: 0px 1em;
   }
 
-  span#navbar {
+  .left {
 	float: left;
 	text-align: left;
   }
 
-  span#languages {
+  .right {
 	float: right;
 	text-align: right;
   }
 
-  div#header h1, h2 {
-	margin: 0px;
-	padding: 15px 50px 0px;
-
-    font-size: 300%;
-	font-style: italic;
-	font-weight: normal;
-  }
-
-  div#header h2 {
-    padding-top: 0px;
-    padding-bottom: 15px;
-    font-size: 100%;
-  }
-
   /* styling the menu */
 
   #menu a {
 	text-decoration: none;
-	color: #b55;
 	font-weight: bold;
 	font-size: 130%;
   }
@@ -89,10 +88,7 @@
   }
 
   #menu .webgen-menuitem-selected {
-	border-left: 3px solid #58b;
-  }
-
-  #menu .webgen-submenu {
+	border-left: 3px solid #408040;
   }
 
   #menu ul {
@@ -114,24 +110,37 @@
 
   /* styling the content */
 
-  div.section {
-	margin-bottom: 30px;
-  }
-
-  h2.section_header {
+  h2 {
 	padding: 0px;
-	border-bottom: 3px double #8b5;
-
 	letter-spacing: 0.2em;
 	font-size: 150%;
 	font-weight: bold;
-	color: #8b5;
+    border-bottom: 1px solid #408040;
   }
 
-  pre.webgen-file {
+  .webgen-file {
     padding-left: 10px;
     margin: 0px 10px;
-    border-left: 3px solid #8b5;
+    border-left: 3px solid #5CB85C;
+  }
+
+  .webgen-picture {
+    text-align: center;
+  }
+
+  .webgen-picture img {
+    border: 1px solid black;
+  }
+
+  .webgen-gallery {
+    text-align: center;
+  }
+
+  .webgen-gallery table {
+    width: 100%;
   }
 
-}
+  .webgen-gallery table td{
+    text-align: center;
+    border: 1px solid black;
+  }

data/doc/src/default.template

@@ -1,32 +1,41 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="{lang:}">
   <head>
-    <title>CommandParser: {title: }</title>
+    <title>CommandParser: {title:}</title>
     <link href="{relocatable: default.css}" rel="stylesheet" />
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
   </head>
   <body>
-    <div id="header">
-      <h1>{title: }</h1>
-      <h2>cmdparse: an advanced command line parser using optparse which supports commands</h2>
-      <div id="headerbar">
-        <span id="navbar">{navbar: }</span>
-        <span id="languages">{lang: }</span>
-        <div style="clear: both; border-top: 1px solid #58b"></div>
+    <div id="all">
+
+      <div id="header">
+        <table>
+          <tr>
+            <td><img src="{relocatable: logo.png}" alt="Logo" title="Logo" /></td>
+            <td><h1>CommandParser<span style="font-size: 60%"> - advanced command line parser which supports commands</span></h1>
+            </td>
+          </tr>
+        </table>
       </div>
-    </div>
 
-    <div id="menu">
-      {menu: }
-    </div>
+      <div id="headerbar" class="bar">
+        <span class="left">Navbar: {navbar: }</span>
+        <span class="right">Language: {langbar: }</span>
+        <div style="clear:both"></div>
+      </div>
 
-    <div id="body">
-      {content: }
-    </div>
+      <div id="menu">
+        {menu:}
+      </div>
 
-    <div id="footer">
-        generated with <em><b><a href="http://webgen.rubyforge.org">webgen</a></b></em> on <b>{date: }</b>
-    </div>
+      <div id="body">
+        {content:}
+      </div>
 
+      <div id="footer" class="bar">
+        generated with <em><b><a href="http://webgen.rubyforge.org"><em><b>webgen</b></em></a></b></em> on <b>{date: }</b>
+      </div>
+    </div>
   </body>
 </html>

data/doc/src/download.page

@@ -0,0 +1,34 @@
+---
+title: Download & Installation
+inMenu: true
+menuOrder: 3
+---
+h2. Download
+
+The newest version of cmdparse can be downloaded from Rubyforge.
+
+Homepage: <a href="http://cmdparse.rubyforge.org">cmdparse.rubyforge.org</a><br />
+Download: <a href="http://rubyforge.org/frs/?group_id=396">http://rubyforge.org/frs/?group_id=396</a>
+
+h2. Dependencies
+
+optparse - part of the standard ruby distribution, so nothing to do here
+
+h2. Installation
+
+You can use the standard way to install cmdparse:
+<pre>
+ $ ruby setup.rb config
+ $ ruby setup.rb setup
+ $ ruby setup.rb install
+</pre>
+
+Or you could use Rake and substitute the above commands with this:
+<pre>
+ $ rake install
+</pre>
+
+Or you could install cmdparse the "GEM way":
+<pre>
+ $ gem install cmdparse
+</pre>

data/doc/src/features.page

@@ -0,0 +1,11 @@
+---
+title: Features
+inMenu: true
+menuOrder: 5
+---
+h2. Feature list
+
+* Based upon the standard library @optparse@
+* Default help and version commands
+* Each command is implemented via a class
+* As easy to use as @optparse@ itself!

data/doc/src/index.page

@@ -0,0 +1,34 @@
+---
+title: HomePage
+inMenu: true
+directoryName: CommandParser
+menuOrder: 1
+---
+h2. Welcome
+
+... to the homepage of _*CommandParser*_, an advanced command line parser.
+
+Have a look around the site!
+
+h2. News
+
+*cmdparse 1.0.1 released!!!*
+
+Changes:
+
+* Improved HelpCommand: the global options -h and --help take an optional command name now
+* Possibility to define a default command which is used when no command was specified
+* A @NoCommandGivenError@ is thrown when no command on the CLI and no default command was specified
+
+h2. Description
+
+Some new programs use a "command style" command line. Examples for such programs are the "svn"
+program from Subversion and the "gem" program from Rubygems. The standard Ruby distribution has no
+library to create programs that use such a command line interface.
+
+This library, cmdparse, can be used to create such a command line interface. Internally it uses
+optparse to parse options and it provides a nice API for specifying commands.
+
+h2. And so
+
+... have fun!

data/doc/src/meta.info

@@ -0,0 +1,6 @@
+api.html:
+  en:
+    dest: rdoc/index.html
+    title: API Reference
+    menuOrder: 7
+    inMenu: true

data/lib/cmdparse.rb

@@ -1,7 +1,7 @@
 #
 #--
 #
-# $Id: cmdparse.rb 8 2004-09-27 16:22:39Z thomas $
+# $Id: cmdparse.rb 240 2005-04-13 11:40:39Z thomas $
 #
 # cmdparse: an advanced command line parser using optparse which supports commands
 # Copyright (C) 2004 Thomas Leitner
@@ -91,7 +91,7 @@ end
 #     opt.on("-r", "--require TEST",  "Require the TEST")
 #     opt.on("--delay N", Integer, "Delay test for N seconds before executing")
 #   end
-#   cmd.add_command TestCommand.new
+#   cmd.add_command TestCommand.new, true # sets this command as default command
 #   cmd.add_command CommandParser::HelpCommand.new
 #   cmd.add_command CommandParser::VersionCommand.new
 #   cmd.parse!( ARGV )
@@ -99,11 +99,16 @@ end
 class CommandParser
 
   # The version of the command parser
-  VERSION = [1, 0, 0]
+  VERSION = [1, 0, 1]
 
   # This error is thrown when an invalid command is encountered.
-  class InvalidCommand < OptionParser::ParseError
-    const_set(:Reason, 'invalid command'.freeze)
+  class InvalidCommandError < OptionParser::ParseError
+    const_set( :Reason, 'invalid command'.freeze )
+  end
+
+  # This error is thrown when no command was given and no default command was specified.
+  class NoCommandGivenError < OptionParser::ParseError
+    const_set( :Reason, 'no command given'.freeze )
   end
 
   # Base class for the commands. This class implements all needed methods so that it can be used by
@@ -171,8 +176,8 @@ class CommandParser
 
     def init( commandParser )
       commandParser.options do |opt|
-        opt.on_tail( "-h", "--help", "Show help" ) do
-          execute( commandParser, [] )
+        opt.on_tail( "-h", "--help [command]", "Show help" ) do |cmd|
+          execute( commandParser, cmd.nil? ? [] : [cmd] )
         end
       end
     end
@@ -262,11 +267,12 @@ class CommandParser
   end
 
   # Holds the registered commands
-  attr_reader   :commands
+  attr_reader :commands
 
   def initialize
     @options = OptionParser.new
     @commands = {}
+    @default = nil
   end
 
   # If called with a block, this method yields the global options of the +CommandParser+. If no
@@ -279,24 +285,41 @@ class CommandParser
     end
   end
 
-  # Adds a command to the command list.
-  def add_command( command )
+  # Adds a command to the command list. If the optional parameter +default+ is true, then this
+  # command is used when no command is specified on the command line.
+  def add_command( command, default = false )
     @commands[command.name] = command
+    @default = command.name if default
     command.init( self )
   end
 
+  # Calls +parse+ - implemented to mimic OptionParser
+  def permute( args ); parse( args ); end
+  # Calls +parse!+ - implemented to mimic OptionParser
+  def permute!( args ); parse!( args ); end
+  # Calls +parse+ - implemented to mimic OptionParser
+  def order( args ); parse( args ); end
+  # Calls +parse!+ - implemented to mimic OptionParser
+  def order!( args ); parse!( args ); end
+
   # see CommandParser#parse!
-  def parse( args )
-    parse!( args.dup )
-  end
+  def parse( args ); parse!( args.dup ); end
 
   # Parses the given argument. First it tries to parse global arguments if given. After that the
   # command name is analyzied and the options for the specific commands parsed. After that the
   # command is executed by invoking its +execute+ method.
   def parse!( args )
     @options.order!( args )
-    command = args.shift || 'no command given'
-    raise InvalidCommand.new( command ) unless commands.include?( command )
+    command = args.shift
+    if command.nil?
+      if @default.nil?
+        raise NoCommandGivenError
+      else
+        command = @default
+      end
+    else
+      raise InvalidCommandError.new( command ) unless commands.include?( command )
+    end
     commands[command].options.permute!( args ) unless commands[command].options.nil?
     commands[command].execute( self, args )
   end

metadata

@@ -1,18 +1,19 @@
 --- !ruby/object:Gem::Specification 
-rubygems_version: 0.8.1
+rubygems_version: 0.8.4
 specification_version: 1
 name: cmdparse
 version: !ruby/object:Gem::Version 
-  version: 1.0.0
-date: 2004-09-27
+  version: 1.0.1
+date: 2005-04-13
 summary: An advanced command line parser using optparse which supports commands
 require_paths: 
   - lib
-author: Thomas Leitner
 email: t_leitner@gmx.at
 homepage: cmdparse.rubyforge.org
 rubyforge_project: cmdparse
-description: "cmdparse extends the default option parser 'optparse' by adding support for commands. Programs that use such command line interfaces are, for example, subversion's 'svn' or Rubygem's 'gem' program."
+description: "cmdparse extends the default option parser 'optparse' by adding support for
+  commands. Programs that use such command line interfaces are, for example,
+  subversion's 'svn' or Rubygem's 'gem' program."
 autorequire: 
 default_executable: 
 bindir: bin
@@ -25,6 +26,8 @@ required_ruby_version: !ruby/object:Gem::Version::Requirement
         version: 0.0.0
   version: 
 platform: ruby
+authors: 
+  - Thomas Leitner
 files: 
   - setup.rb
   - TODO
@@ -35,12 +38,13 @@ files:
   - VERSION
   - lib/cmdparse.rb
   - doc/src
-  - doc/src/metainfo.backing
   - doc/src/default.css
-  - doc/src/index.fragment
+  - doc/src/features.page
+  - doc/src/index.page
+  - doc/src/download.page
   - doc/src/default.template
-  - doc/src/features.fragment
-  - doc/src/download.fragment
+  - doc/src/meta.info
+  - doc/src/logo.png
 test_files: []
 rdoc_options: 
   - "--line-numbers"

data/doc/src/download.fragment

@@ -1,32 +0,0 @@
-<div class="section">
-<h2 class="section_header">Download</h2>
-<p>The newest version of cmdparse can be downloaded from Rubyforge.</p>
-<p>Homepage: <a href="http://cmdparse.rubyforge.org">cmdparse.rubyforge.org</a><br />
-Download: <a href="http://rubyforge.org/frs/?group_id=396">http://rubyforge.org/frs/?group_id=396</a>
-</p>
-</div>
-
-<div class="section">
-<h2 class="section_header">Dependencies</h2>
-<p>optparse - part of the standard ruby distribution, so nothing to do here</p>
-</div>
-
-<div class="section">
-<h2 class="section_header">Installation</h2>
-You can use the standard way to install cmdparse:
-<pre>
- $ ruby setup.rb config
- $ ruby setup.rb setup
- $ ruby setup.rb install
-</pre>
-
-Or you could use Rake and substitute the above commands with this:
-<pre>
- $ rake install
-</pre>
-
-Or you could install cmdparse the "GEM way":
-<pre>
- $ gem install cmdparse
-</pre>
-</div>

data/doc/src/features.fragment

@@ -1,8 +0,0 @@
-<div class="section">
-<h2 class="section_header">Feature list</h2>
-<ul>
-  <li>Based upon the standard library <code>optparse</code></li>
-  <li>Each command is implemented via a class</li>
-  <li>As easy to use as <code>optparse</code> itself</li>
-</ul>
-</div>

data/doc/src/index.fragment

@@ -1,21 +0,0 @@
-<div class="section">
-<h2 class="section_header">Welcome</h2>
-<p>... to the homepage of <i><b>cmdparse</b></i>, an advanced command line parser.</p>
-<p>Have a look around the site!</p>
-</div>
-
-<div class="section">
-<h2 class="section_header">Description</h2>
-<p>Some new programs use a "command style" command line. Examples for such programs are the "svn"
-program from Subversion and the "gem" program from Rubygems. The standard Ruby distribution has no
-library to create programs that use such a command line interface.</p>
-
-<p>This library, cmdparse, can be used to create such a command line interface. Internally it uses
-optparse to parse options and it provides a nice API for specifying commands.</p>
-
-</div>
-
-<div class="section">
-<h2 class="section_header">And so ...</h2>
-<p>... have fun!</p>
-</div>

data/doc/src/metainfo.backing

@@ -1,25 +0,0 @@
-index.html:
-  en:
-    title: Home
-    inMenu: true
-    directoryName: CommandParser
-    menuOrder: 1
-
-download.html:
-  en:
-    title: Download & Installation
-    inMenu: true
-    menuOrder: 3
-
-features.html:
-  en:
-    title: Features
-    inMenu: true
-    menuOrder: 5
-
-api.html:
-  en:
-    dest: rdoc/index.html
-    title: API Reference
-    menuOrder: 7
-    inMenu: true