RubyGems - mamertes - Versions diffs - 2.4.1 - Mend

mamertes 2.4.1

Files changed (53) hide show

checksums.yaml +15 -0
data/.DS_Store +0 -0
data/.gitignore +6 -0
data/.travis-gemfile +15 -0
data/.travis.yml +10 -0
data/.yardopts +1 -0
data/Gemfile +21 -0
data/README.md +126 -0
data/Rakefile +29 -0
data/doc/Mamertes.html +155 -0
data/doc/Mamertes/Application.html +3057 -0
data/doc/Mamertes/Command.html +7031 -0
data/doc/Mamertes/CommandMethods.html +125 -0
data/doc/Mamertes/CommandMethods/Children.html +1286 -0
data/doc/Mamertes/CommandMethods/Help.html +209 -0
data/doc/Mamertes/Error.html +631 -0
data/doc/Mamertes/Localizer.html +376 -0
data/doc/Mamertes/Option.html +6671 -0
data/doc/Mamertes/Parser.html +276 -0
data/doc/Mamertes/ParserMethods.html +125 -0
data/doc/Mamertes/ParserMethods/General.html +134 -0
data/doc/Mamertes/ParserMethods/General/ClassMethods.html +574 -0
data/doc/Mamertes/Version.html +189 -0
data/doc/_index.html +276 -0
data/doc/class_list.html +54 -0
data/doc/css/common.css +1 -0
data/doc/css/full_list.css +57 -0
data/doc/css/style.css +338 -0
data/doc/file.README.html +198 -0
data/doc/file_list.html +56 -0
data/doc/frames.html +28 -0
data/doc/index.html +198 -0
data/doc/js/app.js +214 -0
data/doc/js/full_list.js +178 -0
data/doc/js/jquery.js +4 -0
data/doc/method_list.html +509 -0
data/doc/top-level-namespace.html +112 -0
data/lib/mamertes.rb +18 -0
data/lib/mamertes/application.rb +206 -0
data/lib/mamertes/command.rb +529 -0
data/lib/mamertes/option.rb +236 -0
data/lib/mamertes/parser.rb +317 -0
data/lib/mamertes/version.rb +24 -0
data/locales/en.yml +40 -0
data/locales/it.yml +40 -0
data/mamertes.gemspec +30 -0
data/spec/coverage_helper.rb +20 -0
data/spec/mamertes/application_spec.rb +181 -0
data/spec/mamertes/command_spec.rb +526 -0
data/spec/mamertes/option_spec.rb +274 -0
data/spec/mamertes/parser_spec.rb +126 -0
data/spec/spec_helper.rb +15 -0
metadata +115 -0

@@ -0,0 +1,112 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<title>
+  Top Level Namespace
+    &mdash; Documentation by YARD 0.8.6.2
+</title>
+  <link rel="stylesheet" href="css/style.css" type="text/css" charset="utf-8" />
+  <link rel="stylesheet" href="css/common.css" type="text/css" charset="utf-8" />
+<script type="text/javascript" charset="utf-8">
+  hasFrames = window.top.frames.main ? true : false;
+  relpath = '';
+  framesUrl = "frames.html#!" + escape(window.location.href);
+</script>
+  <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
+  <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
+  </head>
+  <body>
+    <div id="header">
+      <div id="menu">
+    <a href="_index.html">Index</a> &raquo;
+    <span class="title">Top Level Namespace</span>
+  <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
+</div>
+      <div id="search">
+    <a class="full_list_link" id="class_list_link"
+        href="class_list.html">
+      Class List
+    </a>
+    <a class="full_list_link" id="method_list_link"
+        href="method_list.html">
+      Method List
+    </a>
+    <a class="full_list_link" id="file_list_link"
+        href="file_list.html">
+      File List
+    </a>
+</div>
+      <div class="clear"></div>
+    </div>
+    <iframe id="search_frame"></iframe>
+    <div id="content"><h1>Top Level Namespace
+</h1>
+<dl class="box">
+</dl>
+<div class="clear"></div>
+<h2>Defined Under Namespace</h2>
+<p class="children">
+      <strong class="modules">Modules:</strong> <span class='object_link'><a href="Mamertes.html" title="Mamertes (module)">Mamertes</a></span>
+</p>
+</div>
+    <div id="footer">
+  Generated on Sat Aug 10 16:23:08 2013 by
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.8.6.2 (ruby-1.9.3).
+</div>
+  </body>
+</html>

data/lib/mamertes.rb ADDED

@@ -0,0 +1,18 @@
+# encoding: utf-8
+#
+# This file is part of the mamertes gem. Copyright (C) 2013 and above Shogun <shogun_panda@me.com>.
+# Licensed under the MIT license, which can be found at http://www.opensource.org/licenses/mit-license.php.
+#
+require "rubygems"
+require "optparse"
+require "prettyprint"
+require "bovem"
+Lazier.load!(:object)
+require "mamertes/version" if !defined?(Mamertes::Version)
+require "mamertes/command"
+require "mamertes/option"
+require "mamertes/application"
+require "mamertes/parser"

data/lib/mamertes/application.rb ADDED

@@ -0,0 +1,206 @@
+# encoding: utf-8
+#
+# This file is part of the mamertes gem. Copyright (C) 2013 and above Shogun <shogun_panda@me.com>.
+# Licensed under the MIT license, which can be found at http://www.opensource.org/licenses/mit-license.php.
+#
+# Yet another command line manager.
+module Mamertes
+  # This exception is raised when something goes wrong.
+  #
+  # @attribute [r] target
+  #   @return [Object] The target of this error.
+  # @attribute [r] reason
+  #   @return [Symbol] The reason of failure.
+  # @attribute [r] message
+  #   @return [String] A human readable message.
+  class Error < ArgumentError
+    attr_reader :target
+    attr_reader :reason
+    attr_reader :message
+    # Initializes a new error
+    #
+    # @param target [Object] The target of this error.
+    # @param reason [Symbol] The reason of failure.
+    # @param message [String] A human readable message.
+    def initialize(target, reason, message)
+      super(message)
+      @target = target
+      @reason = reason
+      @message = message
+    end
+  end
+  # This class is used to localize strings inside classes methods.
+  class Localizer < ::Lazier::Localizer
+    # Initialize a new localizer.
+    #
+    # @param locale [String|Symbol] The locale to use for localization.
+    def initialize(locale)
+      super(:mamertes, ::File.absolute_path(::Pathname.new(::File.dirname(__FILE__)).to_s + "/../../locales/"), locale)
+    end
+    # Localize a message in a specified locale.
+    #
+    # @param locale [String|Symbol] The locale to use for localization.
+    # @param message [String|Symbol] The message to localize.
+    # @param args [Array] Optional arguments to localize the message.
+    # @return [String|R18n::Untranslated] The localized message.
+    def self.localize_on_locale(locale, message, *args)
+      new(locale).i18n.send(message, *args)
+    end
+  end
+  # This is the main class for a Mamertes application.
+  #
+  # Basically is the same of a command, but it adds support for application version.
+  #
+  # @attribute version
+  #   @return [String] The version of the application.
+  # @attribute shell
+  #   @return [::Bovem::Shell] A shell helper.
+  # @attribute console
+  #   @return [::Bovem::Console] A console helper.
+  # @attribute skip_commands
+  #   @return [Boolean] If to skip commands run via {#run}.
+  # @attribute show_commands
+  #   @return [Boolean] If to show command lines run via {#run}.
+  # @attribute output_commands
+  #   @return [Boolean] If to show the output of the commands run via {#run}.
+  class Application < ::Mamertes::Command
+    attr_accessor :version
+    attr_accessor :shell
+    attr_accessor :console
+    attr_accessor :skip_commands
+    attr_accessor :show_commands
+    attr_accessor :output_commands
+    # Initializes a new Mamertes application.
+    #
+    # In options, you can override the command line arguments with `:__args__`, and you can skip execution by specifying `run: false`.
+    #
+    # @see Command#setup_with
+    #
+    # @param options [Hash] The settings to initialize the application with.
+    # @return [Application] The created application.
+    def self.create(options = {}, &block)
+      raise Mamertes::Error.new(Mamertes::Application, :missing_block, ::Mamertes::Localizer.localize_on_locale(options[:locale], :missing_app_block)) if !block_given?
+      run, args, options = setup_application_option(options)
+      begin
+        create_application(run, args, options, &block)
+      rescue => e
+        Kernel.puts(e.to_s)
+        Kernel.exit(1)
+      end
+    end
+    # Creates a new application.
+    #
+    # @param options [Hash] The settings to initialize the application with.
+    def initialize(options = {}, &block)
+      super(options, &block)
+      @shell = ::Bovem::Shell.instance
+      @console = @shell.console
+      @skip_commands = false
+      @show_commands = false
+      @output_commands = false
+      help_option
+    end
+    # Reads and optionally sets the version of this application.
+    #
+    # @param value [String|nil] The new version of this application.
+    # @return [String|nil] The version of this application.
+    def version(value = nil)
+      @version = value.ensure_string if !value.nil?
+      @version
+    end
+    # Executes this application.
+    #
+    # @param args [Array] The command line to pass to this application. Defaults to `ARGV`.
+    def execute(args = nil)
+      super(args || ARGV)
+    end
+    # Adds a help command and a help option to this application.
+    def help_option
+      command(:help, description: i18n.help_command_description) do
+        action { |command| application.command_help(command) }
+      end
+      option(:help, [i18n.help_option_short_form, i18n.help_option_long_form], help: i18n.help_message){ |application, _| application.show_help }
+    end
+    # The name of the current executable.
+    #
+    # @return [String] The name of the current executable.
+    def executable_name
+      $0
+    end
+    # Shows a help about a command.
+    #
+    # @param command [Command] The command to show help for.
+    def command_help(command)
+      fetch_commands_for_help(command).each do |arg|
+        # Find the command across
+        next_command = ::Mamertes::Parser.find_command(arg, command, [])
+        if next_command then
+          command = command.commands[next_command[:name]]
+        else
+          break
+        end
+      end
+      command.show_help
+    end
+    # Runs a command into the shell.
+    #
+    # @param command [String] The string to run.
+    # @param message [String] A message to show before running.
+    # @param show_exit [Boolean] If show the exit status.
+    # @param fatal [Boolean] If quit in case of fatal errors.
+    # @return [Hash] An hash with `status` and `output` keys.
+    def run(command, message = nil, show_exit = true, fatal = true)
+      @shell.run(command, message, !@skip_commands, show_exit, @output_commands, @show_commands, fatal)
+    end
+    private
+      # Setup options for application creation.
+      #
+      # @param options [Hash] The options to setups.
+      # @return [Array] If to run the application, the arguments and the specified options.
+      def self.setup_application_option(options)
+        options = {name: ::Mamertes::Localizer.localize_on_locale(options[:locale], :default_application_name), parent: nil, application: nil}.merge(options.ensure_hash)
+        run = options.delete(:run)
+        [(!run.nil? ? run : true).to_boolean, options.delete(:__args__), options]
+      end
+      # Create the application.
+      #
+      # @param run [Boolean ]If to run the application.
+      # @param args [Hash] The arguments to use for running.
+      # @param options [Hash] The options of the application.
+      # @return [Application] The new application.
+      def self.create_application(run, args, options, &block)
+        application = new(options, &block)
+        application.execute(args) if application && run
+        application
+      end
+      # Fetch a command list for showing help.
+      #
+      # @param command [Command] The command to show help for.
+      def fetch_commands_for_help(command)
+        command.arguments.collect {|c| c.split(":") }.flatten.collect(&:strip).select(&:present?)
+      end
+  end
+end

data/lib/mamertes/command.rb ADDED

@@ -0,0 +1,529 @@
+# encoding: utf-8
+#
+# This file is part of the mamertes gem. Copyright (C) 2013 and above Shogun <shogun_panda@me.com>.
+# Licensed under the MIT license, which can be found at http://www.opensource.org/licenses/mit-license.php.
+#
+module Mamertes
+  # Methods for the {Command Command} class.
+  module CommandMethods
+    # Methods for showing help messages.
+    module Help
+      # Shows a help about this command.
+      def show_help
+        console = is_application? ? self.console : application.console
+        is_application? ? show_help_application_summary(console) : show_help_command_summary(console)
+        show_help_banner(console) if has_banner?
+        show_help_options(console) if has_options?
+        show_help_commands(console) if has_commands?
+        Kernel.exit(0)
+      end
+      private
+        # Prints a help summary about the application.
+        #
+        # @param console [Bovem::Console] The console object to use to print.
+        def show_help_application_summary(console)
+          # Application
+          console.write(i18n.help_name)
+          console.write("%s %s%s" % [name, version, has_description? ? " - " + description : ""], "\n", 4, true)
+          show_synopsis(console)
+        end
+        # Prints a synopsis about the application.
+        #
+        # @param console [Bovem::Console] The console object to use to print.
+        def show_synopsis(console)
+          console.write("")
+          console.write(i18n.help_synopsis)
+          console.write(synopsis.present? ? synopsis : i18n.help_application_synopsis % [executable_name, has_commands? ? i18n.help_subcommand_invocation : ""], "\n", 4, true)
+        end
+        # Prints a help summary about the command.
+        #
+        # @param console [Bovem::Console] The console object to use to print.
+        def show_help_command_summary(console)
+          console.write(i18n.help_synopsis)
+          console.write(synopsis.present? ? synopsis : i18n.help_command_synopsis % [application.executable_name, full_name(nil, " "), has_commands? ? i18n.help_subsubcommand_invocation : ""], "\n", 4, true)
+        end
+        # Prints the description of the command.
+        #
+        # @param console [Bovem::Console] The console object to use to print.
+        def show_help_banner(console)
+          console.write("")
+          console.write(i18n.help_description)
+          console.write(banner, "\n", 4, true)
+        end
+        # Prints information about the command's options.
+        #
+        # @param console [Bovem::Console] The console object to use to print.
+        def show_help_options(console)
+          console.write("")
+          console.write(is_application? ? i18n.help_global_options : i18n.help_options)
+          # First of all, grab all options and construct labels
+          lefts = show_help_options_build_labels
+          console.with_indentation(4) do
+            lefts.keys.sort.each do |head|
+              show_help_option(console, lefts, head)
+            end
+          end
+        end
+        # Adjusts options names for printing.
+        #
+        # @return [Hash] The adjusted options for printing.
+        def show_help_options_build_labels
+          options.values.inject({}) do |lefts, option|
+            left = [option.complete_short, option.complete_long]
+            left.collect!{|l| l + " " + option.meta } if option.requires_argument?
+            lefts[left.join(", ")] = option.has_help? ? option.help : i18n.help_no_description
+            lefts
+          end
+        end
+        # Prints information about an option.
+        #
+        # @param console [Bovem::Console] The console object to use to print.
+        # @param lefts [Hash] The list of adjusted options.
+        # @param head [String] The option to print.
+        def show_help_option(console, lefts, head)
+          alignment = lefts.keys.collect(&:length).max
+          help = lefts[head]
+          console.write("%s - %s" % [head.ljust(alignment, " "), help], "\n", true, true)
+        end
+        # Prints information about the command's subcommands.
+        #
+        # @param console [Bovem::Console] The console object to use to print.
+        def show_help_commands(console)
+          alignment = prepare_show_help_commands(console)
+          console.with_indentation(4) do
+            commands.keys.sort.each do |name|
+              show_help_command(console, name, alignment)
+            end
+          end
+        end
+        # Starts printing information about the command's subcommands.
+        #
+        # @param console [Bovem::Console] The console object to use to print.
+        def prepare_show_help_commands(console)
+          console.write("")
+          console.write(is_application? ? i18n.help_commands : i18n.help_subcommands)
+          commands.keys.collect(&:length).max
+        end
+        # Prints information about a command's subcommand.
+        #
+        # @param name [String] The name of command to print.
+        # @param console [Bovem::Console] The console object to use to print.
+        def show_help_command(console, name, alignment)
+          # Find the maximum length of the commands
+          command = commands[name]
+          console.write("%s - %s" % [name.ljust(alignment, " "), command.description.present? ? command.description : i18n.help_no_description], "\n", true, true)
+        end
+    end
+    # Methods to manage options and subcommands.
+    module Children
+      attr_reader :commands
+      attr_reader :options
+      # Adds a new subcommand to this command.
+      #
+      # @param name [String] The name of this command. Must be unique.
+      # @param options [Hash] A set of options for this command.
+      # @return [Command] The newly added command.
+      def command(name, options = {}, &block)
+        @commands ||= HashWithIndifferentAccess.new
+        options = {name: name.to_s, parent: self, application: application}.merge(options.ensure_hash)
+        raise Mamertes::Error.new(self, :duplicate_command, i18n.existing_command(full_name(name))) if @commands[name.to_s]
+        create_command(name, options, &block)
+      end
+      # Adds a new option to this command.
+      #
+      # @see Option#initialize
+      #
+      # @param name [String] The name of the option. Must be unique.
+      # @param forms [Array] An array of short and long forms for this option.
+      # @param options [Hash] The settings for the option.
+      # @param action [Proc] An optional action to pass to the option.
+      # @return [Option] The newly added option.
+      def option(name, forms = [], options = {}, &action)
+        name = name.ensure_string
+        @options ||= HashWithIndifferentAccess.new
+        if @options[name] then
+          if is_application? then
+            raise Mamertes::Error.new(self, :duplicate_option, i18n.existing_option_global(name))
+          else
+            raise Mamertes::Error.new(self, :duplicate_option, i18n.existing_option(name, full_name))
+          end
+        end
+        option = ::Mamertes::Option.new(name, forms, options, &action)
+        option.parent = self
+        @options[name] = option
+        option
+      end
+      # Returns the list of subcommands of this command.
+      #
+      # @return [HashWithIndifferentAccess] The list of subcommands of this command.
+      def commands
+        @commands || HashWithIndifferentAccess.new
+      end
+      # Clear all subcommands of this commands.
+      #
+      # @return [Hash] The new (empty) list of subcommands of this command.
+      def clear_commands
+        @commands = {}
+      end
+      # Check if this command has subcommands.
+      #
+      # @return [Boolean] `true` if this command has subcommands, `false` otherwise.
+      def has_commands?
+        commands.length > 0
+      end
+      # Returns the list of options of this command.
+      #
+      # @return [HashWithIndifferentAccess] The list of options of this command.
+      def options
+        @options || HashWithIndifferentAccess.new
+      end
+      # Clear all the options of this commands.
+      # @return [Hash] The new (empty) list of the options of this command.
+      def clear_options
+        @options = {}
+      end
+      # Check if this command has options.
+      #
+      # @return [Boolean] `true` if this command has options, `false` otherwise.
+      def has_options?
+        options.length > 0
+      end
+      # Adds a new argument to this command.
+      #
+      # @param value [String] The argument to add.
+      def argument(value)
+        @args ||= []
+        @args << value
+      end
+      # Returns the list of arguments of this command.
+      #
+      # @return [Array] The list of arguments of this command.
+      def arguments
+        @args || []
+      end
+      # Get the list of the options of this command as an hash, where the keys are the options and the values are either
+      # the user inputs or the defaults values.
+      #
+      # If the two prefixes collides, the command options take precedence over application options.
+      #
+      # @param unprovided [Boolean] If to include also options that were not provided by the user and that don't have any default value.
+      # @param application [String] The prefix to use for including application's options. If falsy, only current command options will be included.
+      # @param prefix [String] The prefix to add to the option of this command.
+      # @param whitelist [Array] The list of options to include. By default all options are included.
+      # @return [HashWithIndifferentAccess] The requested options.
+      def get_options(unprovided = false, application = "application_", prefix = "", *whitelist)
+        rv = HashWithIndifferentAccess.new
+        rv.merge!(self.application.get_options(unprovided, nil, application, *whitelist)) if application && !is_application?
+        rv.merge!(get_current_options(unprovided, prefix, whitelist))
+        rv
+      end
+      private
+        # Creates a new command.
+        #
+        # @param name [String] The name of this command.
+        # @param options [Hash] The settings for this command.
+        # @return [Command] The new command.
+        def create_command(name, options, &block)
+          command = ::Mamertes::Command.new(options, &block)
+          command.option(:help, [i18n.help_option_short_form, i18n.help_option_long_form], help: i18n.help_message){|c, _| c.show_help }
+          @commands[name.to_s] = command
+          command
+        end
+        # Gets the list of the options of this command.
+        # @param unprovided [Boolean] If to include also options that were not provided by the user and that don't have any default value.
+        # @param prefix [String] The prefix to add to the option of this command.
+        # @param whitelist [Array] The list of options to include. By default all options are included.
+        # @return [HashWithIndifferentAccess] The requested options.
+        def get_current_options(unprovided, prefix, whitelist)
+          rv = HashWithIndifferentAccess.new
+          whitelist = (whitelist.present? ? whitelist : options.keys).collect(&:to_s)
+          options.each do |key, option|
+            rv["#{prefix}#{key}"] = option.value if include_option?(whitelist, unprovided, key, option)
+          end
+          rv
+        end
+        # Checks if a option must be included in a hash.
+        #
+        # @param whitelist [Array] The list of options to include.
+        # @param unprovided [Boolean] If to include also options that were not provided by the user and that don't have any default value.
+        # @param key [String] The option name.
+        # @param option [Option] The option to include.
+        # @return [Boolean] Whether to include the option.
+        def include_option?(whitelist, unprovided, key, option)
+          whitelist.include?(key.to_s) && (option.provided? || option.has_default? || (unprovided && option.action.nil?))
+        end
+    end
+  end
+  # This class represent a command (action) for Mamertes.
+  #
+  # Every command has the execution block and a set of option. Optionally, it also has before and after hooks.
+  #
+  # @attribute name
+  #   @return [String] The name of this command. At runtime you can invoke it using the minimum number of letters to uniquely distinguish it from others.
+  # @attribute description
+  #   @return [String] A very short description of what this command does.
+  # @attribute banner
+  #   @return [String] A long description of this command.
+  # @attribute synopsis
+  #   @return [String] A synopsis of the typical command line usage.
+  # @attribute before
+  #   @return [Proc] A hook to execute before the command's action. It is executed only if no subcommand is executed.
+  # @attribute action
+  #   @return [Proc] The action of this command. It is executed only if no subcommand is executed.
+  # @attribute after
+  #   @return [Proc] A hook to execute after the command's action. It is executed only if no subcommand is executed.
+  # @attribute application
+  #   @return [Application] The application this command belongs to.
+  # @attribute parent
+  #   @return [Command] The parent of this command.
+  # @attribute [r] commands
+  #   @return [Array] The subcommands associated to this command.
+  # @attribute [r] options
+  #   @return [Array] The options available for this command.
+  # @attribute [r] arguments
+  #   @return [Array] The arguments provided to this command.
+  class Command
+    attr_accessor :name
+    attr_accessor :description
+    attr_accessor :banner
+    attr_accessor :synopsis
+    attr_accessor :before
+    attr_accessor :action
+    attr_accessor :after
+    attr_accessor :application
+    attr_accessor :parent
+    include Lazier::I18n
+    include Mamertes::CommandMethods::Help
+    include Mamertes::CommandMethods::Children
+    # Creates a new command.
+    #
+    # @param options [Hash] The settings to initialize the command with.
+    def initialize(options = {}, &block)
+      setup_with(options)
+      instance_eval(&block) if block_given?
+    end
+    # Reads and optionally sets the name of this command.
+    #
+    # @param value [NilClass|Object] The new name of this command.
+    # @return [String] The name of this command.
+    def name(value = nil)
+      @name = value if !value.nil?
+      @name
+    end
+    # Gets a full name, that is the name of this command and its ancestor. Optionally it also appends a suffix
+    #
+    # @param suffix [String] A suffix to append.
+    # @param separator [String] The separator to use for components.
+    # @return [String] The full name.
+    def full_name(suffix = nil, separator = ":")
+      if is_application? then
+        nil
+      else
+        [@parent ? @parent.full_name(nil, separator) : nil, !is_application? ? name : nil, suffix].compact.join(separator)
+      end
+    end
+    # Reads and optionally sets the short description of this command.
+    #
+    # @param value [NilClass|Object] The new short description of this command.
+    # @return [String] The short description of this command.
+    def description(value = nil)
+      @description = value if !value.nil?
+      @description
+    end
+    # Reads and optionally sets the description of this command.
+    #
+    # @param value [NilClass|Object] The new description of this command.
+    # @return [String] The description of this command.
+    def banner(value = nil)
+      @banner = value if !value.nil?
+      @banner
+    end
+    # Reads and optionally sets the synopsis of this command.
+    #
+    # @param value [NilClass|Object] The new synopsis of this command.
+    # @return [String] The synopsis of this command.
+    def synopsis(value = nil)
+      @synopsis = value if !value.nil?
+      @synopsis
+    end
+    # Reads and optionally sets the before hook, that is a block executed before the action of this command.
+    #
+    # This hook is only executed if no subcommand is executed.
+    #
+    # @param method [String|Symbol|NilClass] The method of the application to hookup.
+    # @param hook [Proc] The block to hookup if method is not provided.
+    # @return [Proc|Symbol|NilClass] The before hook of this command.
+    def before(method = nil, &hook)
+      @before = assign_hook(method, &hook) if method || hook
+      @before
+    end
+    # Reads and optionally sets the action of this command.
+    #
+    # A command action is only executed if no subcommand is executed.
+    #
+    # @param method [String|Symbol|NilClass] The method of the application to hookup.
+    # @param hook [Proc] The block to hookup if method is not provided.
+    # @return [Proc|Symbol|NilClass] The action of this command.
+    def action(method = nil, &hook)
+      @action = assign_hook(method, &hook) if method || hook
+      @action
+    end
+    # Sets the after hook, that is a block executed after the action of this command.
+    #
+    # This hook is only executed if no subcommand is executed.
+    #
+    # @param method [String|Symbol|NilClass] The method of the application to hookup.
+    # @param hook [Proc] The block to hookup if method is not provided.
+    # @return [Proc|Symbol|NilClass] The after hook of this command.
+    def after(method = nil, &hook)
+      @after = assign_hook(method, &hook) if method || hook
+      @after
+    end
+    # Returns the application this command belongs to.
+    #
+    # @return [Application] The application this command belongs to or `self`, if the command is an Application.
+    def application
+      is_application? ? self : @application
+    end
+    # Checks if the command is an application.
+    #
+    # @return [Boolean] `true` if command is an application, `false` otherwise.
+    def is_application?
+      is_a?(Mamertes::Application)
+    end
+    # Check if this command has a description.
+    #
+    # @return [Boolean] `true` if this command has a description, `false` otherwise.
+    def has_description?
+      description.present?
+    end
+    # Check if this command has a banner.
+    #
+    # @return [Boolean] `true` if this command has a banner, `false` otherwise.
+    def has_banner?
+      banner.present?
+    end
+    # Setups the command.
+    #
+    # @param options [Hash] The settings for this command.
+    # @return [Command] The command.
+    def setup_with(options = {})
+      options = {} if !options.is_a?(::Hash)
+      setup_i18n(options)
+      options.each_pair do |option, value|
+        method = option.to_s
+        if respond_to?(method) && self.method(method).arity != 0 then
+          send(method, value)
+        elsif respond_to?(method + "=") then
+          send(method + "=", value)
+        end
+      end
+      self
+    end
+    # Executes this command, running its action or a subcommand.
+    #
+    # @param args [Array] The arguments to pass to the command.
+    def execute(args)
+      subcommand = Mamertes::Parser.parse(self, args)
+      if subcommand.present? then # We have a subcommand to call
+        commands[subcommand[:name]].execute(subcommand[:args])
+      elsif action then # Run our action
+        # Run the before hook
+        execute_hook(before)
+        # Run the action
+        execute_hook(action)
+        # Run the after hook
+        execute_hook(after)
+      else # Show the help
+        show_help
+      end
+    end
+    private
+      # Setups the application localization.
+      #
+      # @param options [Hash] The settings for this command.
+      def setup_i18n(options)
+        i18n_setup(:mamertes, ::File.absolute_path(::Pathname.new(::File.dirname(__FILE__)).to_s + "/../../locales/"))
+        self.i18n = (options[:locale]).ensure_string
+      end
+      # Assigns a hook to a command.
+      #
+      # @param method [String|Symbol|NilClass] The method of the application to hookup.
+      # @param block [Proc] The block to hookup if method is not provided.
+      def assign_hook(method, &hook)
+        assigned = nil
+        assigned = method if method.is_a?(::String) || method.is_a?(::Symbol)
+        assigned = hook if !assigned && hook && hook.arity == 1
+        assigned
+      end
+      # Executes a hook.
+      #
+      # @param hook [String|Symbol|Proc|NilClass] The hook to execute.
+      def execute_hook(hook)
+        if hook then
+          hook.is_a?(::String) || hook.is_a?(::Symbol) ? application.send(hook, self) : hook.call(self)
+        end
+      end
+  end
+end