cliqr 0.0.3 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f3005b3bec4c39c0af0006b3da4be666c2c0f0b2
-  data.tar.gz: 11a692aba415f994a5b3f26857c5d025371a1bd6
+  metadata.gz: 8b1c3a47c4045454a48b832cc443ea735fe538ae
+  data.tar.gz: 4b919b535387086386da176acc4a470b8cf597e6
 SHA512:
-  metadata.gz: b0504ab87aafe19c34dff996cb9eb8b5499b2b242a4f8e2973afb643c32d98aff0959fd85d24dd8dd297bc818a0b27247e576be8d6e0a4a8fa2ddc9ddf6ce902
-  data.tar.gz: 7c61a612684c2a33f3db3cca0525134d0e3cb7621ef43a92c657c51865732b7e716c247f88aecaac94fc3b8c437969ce92b6aff50467d3dda604ceea2c07ecd9
+  metadata.gz: 88d7eeb4ca572c3dfb8715611b2f3c5355ef9a5f5cee2c40497d485bc190c1869e57d8e4780f9507de91ad41fd15cebd44066bb28afd0ff68f6c081d67ecd1df
+  data.tar.gz: bf965708a3fbb48c021875fd87dfb51f417fe3f73c2e85d8053e5ec449942b0ffb62461ede244f2b48297880acc0aa7160bc1c0db23c510f128a3e61a969588b

data/CHANGELOG.md

@@ -1,4 +1,23 @@
 
+0.0.4 / 2015-05-11
+==================
+
+  * bring document coverage to 100%
+  * improve documentation
+  * fix minor style error in rake tasks
+  * don't execute specs twice
+  * add support for command options
+  * improve dsl framework by completely hiding dsl methods
+  * add method_missing to proxy all dsl methods
+  * add example for router in readme
+  * ignore document files
+  * add command router
+  * use a template to build usage
+  * move builder spec in its own folder
+  * add command usage section
+  *  change usage information builder
+  * show total downloads in readme
+
 0.0.3 / 2015-05-08
 ==================
 

data/README.md

@@ -7,7 +7,7 @@
 [![Inline docs](http://inch-ci.org/github/anshulverma/cliqr.svg)](http://inch-ci.org/github/anshulverma/cliqr)
 
 [![Version](http://img.shields.io/gem/v/cliqr.svg?style=flat-square)](https://rubygems.org/gems/cliqr)
-[![Downloads](http://img.shields.io/gem/dtv/cliqr.svg?style=flat-square)](https://rubygems.org/gems/cliqr)
+[![Downloads](http://img.shields.io/gem/dt/cliqr.svg?style=flat-square)](https://rubygems.org/gems/cliqr)
 
 <!-- markdown-toc start - Don't edit this section. Run M-x markdown-toc/generate-toc again -->
 **Table of Contents**
@@ -15,7 +15,7 @@
 - [cliqr](#cliqr)
     - [Summary](#summary)
     - [Examples](#examples)
-        - [Simple CLI app with basename and description](#simple-cli-app-with-basename-and-description)
+        - [Simple CLI app example](#simple-cli-app-example)
     - [Installation](#installation)
     - [Building](#building)
     - [Contributing](#contributing)
@@ -38,15 +38,43 @@ line application. Features include:
 The DSL provides several helper methods to build interfaces of different
 styles. Here are some examples.
 
-### Simple CLI app with basename and description
+### Simple CLI app example
 
 Here is a simple hello-world example for using Cliqr.
 
 ``` ruby
+require 'cliqr'
+
+# a custom command handler
+class MyCommandHandler < Cliqr.command
+  def execute
+    puts 'executing my awesome command'
+  end
+end
+
 cli = Cliqr.interface do
   basename 'my-command'
+  description 'this is an awesome command...try it out'
+  handler MyCommandHandler
+
+  option 'an-option' do
+    short 'a'
+    description 'this is a option'
+  end
 end
+
 puts cli.usage
+#> my-command -- this is an awesome command...try it out
+#>
+#> USAGE:
+#>     my-command
+#>
+#> Available options:
+#>
+#>     --an-option, -a  :  this is a option
+
+cli.execute
+#> executing my awesome command
 ```
 
 This should print

data/Rakefile

@@ -17,7 +17,7 @@ task :coverage do
 end
 
 desc 'default rake task'
-task default: [:clean, :spec, :rubocop, :coverage, :verify_measurements, :yardstick_measure]
+task default: [:clean, :coverage, :rubocop, :verify_measurements, :yardstick_measure]
 
 desc 'run CI tasks'
 task :ci do

data/lib/cliqr.rb

@@ -5,19 +5,44 @@ require 'cliqr/error'
 
 require 'cliqr/cli/config'
 require 'cliqr/cli/builder'
+require 'cliqr/cli/command'
 
 # Top level namespace for the Cliqr gem
+#
+# @api public
 module Cliqr
   class << self
-    # Invokes the CLI::Config builder DSL to prepare config for command line
-    # application. Then uses that config to build a instance of type Cliqr::CLI
+    # Start building a cli interface
+    #
+    # @example
+    #   Cliqr.interface do
+    #     basename 'my-command' # name of the command
+    #     description 'command description in a few words' # long description
+    #     handler MyCommandHandler # command's handler class
+    #
+    #     option
+    #   end
     #
     # @return [Cliqr::CLI]
     #
     # @api public
     def interface(&block)
       config = CLI::Config.build(&block)
-      CLI::Builder.new(config)
+      CLI::Builder.new(config).build
+    end
+
+    # All cliqr commands should extend from this. Here is an example:
+    #
+    # @example
+    #   class MyCommand < Cliqr.command
+    #     def execute
+    #       # execute the command
+    #     end
+    #   end
+    #
+    # @return [CLI::Command]
+    def command
+      CLI::Command
     end
   end
 end

data/lib/cliqr/cli/builder.rb

@@ -1,32 +1,30 @@
 # encoding: utf-8
 
 require 'cliqr/cli/validator'
+require 'cliqr/cli/interface'
 
 module Cliqr
   module CLI
     # Builds usage information from [CLI::Config]
+    #
+    # @api private
     class Builder
       # Start building a command line interface
       #
-      # @param [Hash] config
-      #   the configuration options for the interface (validated using
-      #   CLI::Validator)
+      # @param [Cliqr::CLI::Config] config the configuration options for the
+      # interface (validated using CLI::Validator)
       #
       # @return [Cliqr::CLI::Builder]
       def initialize(config)
-        CLI::Validator.validate config
-        @basename = config[:basename]
+        @config = config
       end
 
-      # Get usage information of this command line interface instance
+      # Validate and build a cli interface based on the configuration options
       #
-      # @return [String]
-      #
-      # @api public
-      def usage
-        <<-EOS
-USAGE: #{@basename}
-EOS
+      # @return [Cliqr::CLI::Interface]
+      def build
+        CLI::Validator.validate @config
+        Interface.new(@config)
       end
     end
   end

data/lib/cliqr/cli/command.rb

@@ -0,0 +1,17 @@
+# encoding: utf-8
+
+module Cliqr
+  module CLI
+    # Base class for all commands to extend from
+    #
+    # @api private
+    class Command
+      # Execute the command
+      #
+      # @return [Integer] Exit status of the command execution
+      def execute
+        0
+      end
+    end
+  end
+end

data/lib/cliqr/cli/command_runner_factory.rb

@@ -0,0 +1,66 @@
+# encoding: utf-8
+
+require 'stringio'
+
+module Cliqr
+  module CLI
+    # Factory class to get instance of CommandRunner based on input options
+    #
+    # @api private
+    class CommandRunnerFactory
+      # Get a instance of command runner based on options
+      #
+      # @param [Hash] options Used to build a command runner instance
+      #
+      # @return [Cliqr::CLI::StandardCommandRunner] If default output is require from command
+      # @return [Cliqr::CLI::BufferedCommandRunner] If command's output needs to be buffered
+      def self.get(**options)
+        case options[:output]
+        when :default
+          StandardCommandRunner.new
+        when :buffer
+          BufferedCommandRunner.new
+        else
+          fail Cliqr::Error::UnknownCommandRunnerException,
+               'cannot find a command runner for the given options'
+        end
+      end
+    end
+
+    # A standard implementation for command runner used for most commands
+    #
+    # @api private
+    class StandardCommandRunner
+      # simply execute the command handler
+      #
+      # @return [Integer] Exit status of the command
+      def run
+        yield
+      end
+    end
+
+    # Used to buffer command output
+    #
+    # @api private
+    class BufferedCommandRunner
+      # Run the command handler but redirect stdout to a buffer
+      #
+      # @return [Hash] The hash contains :stdout, :stderr and :status of the command
+      def run
+        old_stdout = $stdout
+        old_stderr = $stderr
+        $stdout = StringIO.new('', 'w')
+        $stderr = StringIO.new('', 'w')
+        yield
+        {
+            :stdout => $stdout.string,
+            :stderr => $stderr.string,
+            :status => 0
+        }
+      ensure
+        $stdout = old_stdout
+        $stderr = old_stderr
+      end
+    end
+  end
+end

data/lib/cliqr/cli/config.rb

@@ -3,46 +3,166 @@
 require 'cliqr/dsl'
 
 module Cliqr
+  # A extension for CLI module to group all config classes
   module CLI
+    # A value to initialize configuration attributes with
+    UNSET = Object.new
+
     # The configuration setting to build a cli application with its own dsl
+    #
+    # @api private
     class Config
       extend Cliqr::DSL
 
+      # Base name of the command
+      #
+      # @return [String]
+      attr_accessor :basename
+
+      # Description for the base command
+      #
+      # @return [String]
+      attr_accessor :description
+
+      # Command handler for the base command
+      #
+      # @return [Class]
+      attr_accessor :handler
+
+      # Array of options applied to the base command
+      #
+      # @return [Array<OptionConfig>]
+      attr_accessor :options
+
+      # New config instance with all attributes set as UNSET
       def initialize
-        @config = {}
+        @basename = UNSET
+        @description = UNSET
+        @handler = UNSET
+        @options = UNSET
+      end
+
+      # Finalize config by adding default values for unset values
+      #
+      # @return [Cliqr::CLI::Config]
+      def finalize
+        @basename = '' if @basename == UNSET
+        @description = '' if @description == UNSET
+        @handler = nil if @handler == UNSET
+        @options = [] if @options == UNSET
+
+        self
       end
 
       # Set value for a config option
       #
-      # @param name
-      #   name of the config parameter
+      # @param [Symbol] name Name of the config parameter
       #
-      # @param value
-      #   value for the config parameter
+      # @param [Object] value Value for the config parameter
       #
-      # @return [String] value that was set for the parameter
-      def set_config(name, value)
-        @config[name.to_sym] = value
+      # @param [Funciton] block Function which populates configuration for a sub-attribute
+      #
+      # @return [Object] If setting a attribute's value
+      # @return [Cliqr::CLI::OptionConfig] If adding a new option
+      def set_config(name, value, &block)
+        case name
+        when :option
+          handle_option value, &block # value is the long name for the option
+        else
+          handle_config name, value
+        end
+      end
+
+      private
+
+      # Set value for config option without evaluating a block
+      #
+      # @param [Symbol] name Name of the config option
+      # @param [Object] value Value for the config option
+      #
+      # @return [Object] Value that was assigned to attribute
+      def handle_config(name, value)
+        public_send("#{name}=", value)
+        value
+      end
+
+      # Add a new option for the command
+      #
+      # @param [Symbol] name Long name of the option
+      #
+      # @param [Function] block Populate the option's config in this funciton block
+      #
+      # @return [Cliqr::CLI::OptionConfig] Newly created option's config
+      def handle_option(name, &block)
+        option_config = OptionConfig.build(&block)
+        option_config.name = name
+        @options = [] if @options == UNSET
+        @options.push option_config
+        option_config
+      end
+    end
+
+    # Config attributes for a command's option
+    #
+    # @api private
+    class OptionConfig
+      extend Cliqr::DSL
+
+      # Long option name
+      #
+      # @return [String]
+      attr_accessor :name
+
+      # Optional short name for the option
+      #
+      # @return [String]
+      attr_accessor :short
+
+      # A description string for the option
+      #
+      # @return [String]
+      attr_accessor :description
+
+      # Initialize a new config instance for an option with UNSET attribute values
+      def initialize
+        @name = UNSET
+        @short = UNSET
+        @description = UNSET
       end
 
-      # Finalize config by adding default values for unset values.
+      # Finalize option's config by adding default values for unset values
       #
-      # @return [Hash]
+      # @return [Cliqr::CLI::OptionConfig]
       def finalize
-        {
-          basename: ''
-        }.merge(@config)
-      end
-
-      # dsl methods
-      dsl do
-        # Set basename for the command line interface
-        #
-        # @param [String] basename
-        #   name of the top level command
-        def basename(basename)
-          set_config :basename, basename
-        end
+        @name = '' if @name == UNSET
+        @short = '' if @short == UNSET
+        @description = '' if @description == UNSET
+
+        self
+      end
+
+      # Set value for command option's attribute
+      #
+      # @param [Symbol] name Name of the attribute
+      #
+      # @param [Object] value Value for the attribute
+      #
+      # @return [Object] Value that was set for the attribute
+      def set_config(name, value)
+        handle_option_config name, value
+      end
+
+      private
+
+      # Set value for config option without evaluating a block
+      #
+      # @param [Symbol] name Name of the config option
+      # @param [Object] value Value for the config option
+      #
+      # @return [Object]
+      def handle_option_config(name, value)
+        public_send("#{name}=", value)
+        value
       end
     end
   end

data/lib/cliqr/cli/interface.rb

@@ -0,0 +1,51 @@
+# encoding: utf-8
+
+require 'cliqr/error'
+
+require 'cliqr/cli/router'
+require 'cliqr/cli/command_runner_factory'
+
+module Cliqr
+  module CLI
+    # A CLI interface instance which is the entry point for all CLI commands.
+    #
+    # @api private
+    class Interface
+      # Create a new interface instance with a config
+      #
+      # @param [Cliqr::CLI::Config] config Config used to create this interface
+      def initialize(config)
+        @config = config
+      end
+
+      # Get usage information of this command line interface instance
+      #
+      # @return [String] Defines usage of this interface
+      def usage
+        template_file_path = File.expand_path('../../../../templates/usage.erb', __FILE__)
+        template = ERB.new(File.new(template_file_path).read, nil, '%')
+        result = template.result(@config.instance_eval { binding })
+
+        # remove multiple newlines from the end of usage
+        "#{result.strip}\n"
+      end
+
+      # Execute a command
+      #
+      # @param [Symbol] output Either :default or :buffer
+      #
+      # @return [Integer] Exit code of the command execution
+      def execute(output: :default)
+        handler = @config.handler.new
+        begin
+          runner = CommandRunnerFactory.get(output: output)
+          runner.run do
+            handler.execute
+          end
+        rescue StandardError => e
+          raise Cliqr::Error::CommandRuntimeException.new "command '#{@config.basename}' failed", e
+        end
+      end
+    end
+  end
+end

data/lib/cliqr/cli/router.rb

@@ -0,0 +1,11 @@
+# encoding: utf-8
+
+module Cliqr
+  module CLI
+    # Used for routing the command to the appropriate command handler based on the interface config
+    #
+    # @api private
+    class Router
+    end
+  end
+end

data/lib/cliqr/cli/validator.rb

@@ -5,9 +5,26 @@ require 'cliqr/error'
 module Cliqr
   module CLI
     # Validator for the command line interface configuration
+    #
+    # @api private
     class Validator
+      # Validates the config to make sure all the options are correctly set
+      #
+      # @param [Cliqr::CLI::Config] config Settings for building command line interface
+      #
+      # @return [Cliqr::CLI::Config] Validated config object
       def self.validate(config)
         fail Cliqr::Error::ConfigNotFound, 'config is nil' if config.nil?
+        fail Cliqr::Error::BasenameNotDefined, 'basename is not defined' if config.basename.empty?
+
+        fail Cliqr::Error::HandlerNotDefined, 'command handler not defined' if config.handler.nil?
+        fail Cliqr::Error::InvalidCommandHandler,
+             'command handler must extend from Cliqr::CLI::Command' unless config.handler < Command
+
+        fail Cliqr::Error::OptionsNotDefinedException,
+             'options cannot be nil' if config.options.nil?
+
+        config
       end
     end
   end

data/lib/cliqr/dsl.rb

@@ -6,56 +6,54 @@ module Cliqr
   # Used to separate all dsl methods in a separate block, thus allowing
   # separation of concerns between non-dsl methods with dsl methods which
   # improves maintainability.
+  #
+  # @api private
   module DSL
     # Entry point for invoking dsl methods
     #
-    # @param args Arguments to be used to build the DSL instance
+    # @param [Hash] args Arguments to be used to build the DSL instance
     #
-    # @param block The block to evaluate the DSL
+    # @param [Function] block The block to evaluate the DSL
     #
     # @return [Cliqr::DSL]
     def build(*args, &block)
       base = new(*args)
       if block_given?
-        delegator_klass = const_get('DSLDelegator')
-        delegator = delegator_klass.new(base)
+        delegator = DSLDelegator.new(base)
         delegator.instance_eval(&block)
       end
       base.finalize
+      base
     end
 
     # Delegates all DSL methods to the base class. Can be used to keep DSL
-    # methods separate from non-dsl methods.
-    #
-    # @param block Block containing all dsl methods
-    #
-    # Allows separating dsl methods as:
+    # methods separate from non-dsl methods. All implementing subclasses will
+    # have to implement a set_config method as described below
     #
     #     class MyDSLClass
     #       extends Cliqr::DSL
     #
-    #       def set_value(value)
-    #         @value = value
-    #       end
-    #
-    #       # ... other non-dsl methods ...
-    #
-    #       dsl do
-    #         def value(value)
-    #           set_value value
-    #         end
+    #       def set_config(name, value, &block)
+    #         # handle config value for attribute "name"
     #       end
-    #
     #     end
     #
     # This will be invoked as:
     #
-    #    MyDSLClass.build do
-    #      value 'some-value'
-    #    end
-    def dsl(&block)
-      delegator_klass = Class.new(SimpleDelegator, &block)
-      const_set('DSLDelegator', delegator_klass)
+    #     MyDSLClass.build do
+    #       attribute 'some-value'
+    #     end
+    class DSLDelegator < SimpleDelegator
+      # All dsl methods are handled dynamically by proxying through #set_config
+      #
+      # @param [Symbol] name Name of the method
+      # @param [Array] args Method arguments
+      # @param [Function] block A function to evaluate in the context of the method's arguments
+      #
+      # @return [Object] The return value of the proxied method
+      def method_missing(name, *args, &block)
+        __getobj__.set_config name, args[0], &block
+      end
     end
   end
 end

data/lib/cliqr/error.rb

@@ -2,6 +2,41 @@
 
 module Cliqr
   module Error
+    # Base error class that others error types extend from
+    #
+    # @api private
+    class CliqrError < StandardError
+      # Set up the error to wrap another error's trace
+      def initialize(error_message, e = nil)
+        super e
+
+        # Preserve the original exception's data if provided
+        return unless e && e.is_a?(Exception)
+
+        set_backtrace e.backtrace
+        message.prepend "#{error_message}\n\nCause:\n#{e.class}: "
+      end
+    end
+
+    # Raised when the config parameter is nil
     class ConfigNotFound < StandardError; end
+
+    # Raised when basename is not defined
+    class BasenameNotDefined < StandardError; end
+
+    # Raised when a command handler is not defined
+    class HandlerNotDefined < StandardError; end
+
+    # Raised if command handler does not extend from Cliqr::CLI::Command
+    class InvalidCommandHandler < StandardError; end
+
+    # Encapsulates the error that gets thrown during a command execution
+    class CommandRuntimeException < CliqrError; end
+
+    # Error to signify that a command's runner is not available
+    class UnknownCommandRunnerException < CliqrError; end
+
+    # Raised if config's option array is nil
+    class OptionsNotDefinedException < CliqrError; end
   end
 end

data/lib/cliqr/version.rb

@@ -2,5 +2,5 @@
 
 # Versioned gem
 module Cliqr
-  VERSION = '0.0.3'
+  VERSION = '0.0.4'
 end

data/spec/config/config_finalize_spec.rb

@@ -0,0 +1,14 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Cliqr::CLI::Config do
+  it 'sets proper defaults for unset values' do
+    config = Cliqr::CLI::Config.new
+    config.finalize
+    expect(config.basename).to eq('')
+    expect(config.description).to eq('')
+    expect(config.handler).to eq(nil)
+    expect(config.options).to eq([])
+  end
+end

data/spec/config/config_validator_spec.rb

@@ -0,0 +1,40 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Cliqr::CLI::Validator do
+  it 'does not allow empty config' do
+    expect { Cliqr::CLI::Builder.new(nil).build }.to raise_error(Cliqr::Error::ConfigNotFound)
+  end
+
+  it 'does not allow empty basename' do
+    config = Cliqr::CLI::Config.new
+    config.basename = ''
+    config.finalize
+    expect { Cliqr::CLI::Builder.new(config).build }.to raise_error(Cliqr::Error::BasenameNotDefined)
+  end
+
+  it 'does not allow command handler to be null' do
+    config = Cliqr::CLI::Config.new
+    config.basename = 'my-command'
+    config.finalize
+    expect { Cliqr::CLI::Builder.new(config).build }.to raise_error(Cliqr::Error::HandlerNotDefined)
+  end
+
+  it 'only accepts command handler that extend from Cliqr::CLI::Command' do
+    config = Cliqr::CLI::Config.new
+    config.basename = 'my-command'
+    config.handler = Object
+    config.finalize
+    expect { Cliqr::CLI::Builder.new(config).build }.to raise_error(Cliqr::Error::InvalidCommandHandler)
+  end
+
+  it 'expects that config options should not be nil' do
+    config = Cliqr::CLI::Config.new
+    config.basename = 'my-command'
+    config.handler = TestCommand
+    config.options = nil
+    config.finalize
+    expect { Cliqr::CLI::Builder.new(config).build }.to raise_error(Cliqr::Error::OptionsNotDefinedException)
+  end
+end

data/spec/dsl/interface_spec.rb

@@ -2,14 +2,80 @@
 
 require 'spec_helper'
 
-describe Cliqr do
+require 'executor/fixtures/test_command'
+
+describe Cliqr::CLI::Interface do
   it 'builds a base command with name' do
     cli = Cliqr.interface do
-      basename 'tinbox'
+      basename 'my-command'
+      description 'a command used to test cliqr'
+      handler TestCommand
+    end
+
+    expect(cli.usage).to eq <<-EOS
+my-command -- a command used to test cliqr
+
+USAGE:
+    my-command
+EOS
+  end
+
+  it 'only makes basename and handler to be required' do
+    cli = Cliqr.interface do
+      basename 'my-command'
+      handler TestCommand
     end
 
     expect(cli.usage).to eq <<-EOS
-USAGE: tinbox
+my-command
+
+USAGE:
+    my-command
 EOS
   end
+
+  it 'allows options for a command' do
+    cli = Cliqr.interface do
+      basename 'my-command'
+      description 'a command used to test cliqr'
+      handler TestCommand
+
+      option 'option-1' do
+        short 'p'
+        description 'a nice option to have'
+      end
+    end
+
+    expect(cli.usage).to eq <<-EOS
+my-command -- a command used to test cliqr
+
+USAGE:
+    my-command [options]
+
+Available options:
+
+    --option-1, -p  :  a nice option to have
+EOS
+  end
+
+  it 'allows command options to optionally have description and short name' do
+    cli = Cliqr.interface do
+      basename 'my-command'
+      description 'a command used to test cliqr'
+      handler TestCommand
+
+      option 'option-1'
+    end
+
+    expect(cli.usage).to eq <<-EOS
+my-command -- a command used to test cliqr
+
+USAGE:
+    my-command [options]
+
+Available options:
+
+    --option-1
+    EOS
+  end
 end

data/spec/executor/command_runner_spec.rb

@@ -0,0 +1,25 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Cliqr::CLI::CommandRunnerFactory do
+  it 'returns standard runner for default output' do
+    runner = Cliqr::CLI::CommandRunnerFactory.get(output: :default)
+    expect(runner).to be_kind_of(Cliqr::CLI::StandardCommandRunner)
+  end
+
+  it 'returns buffered runner for buffer output' do
+    runner = Cliqr::CLI::CommandRunnerFactory.get(output: :buffer)
+    expect(runner).to be_kind_of(Cliqr::CLI::BufferedCommandRunner)
+  end
+
+  it 'throws error for default output type' do
+    expect { Cliqr::CLI::CommandRunnerFactory.get(output: :unknown) }.to(
+      raise_error(be_kind_of(Cliqr::Error::UnknownCommandRunnerException))
+    )
+  end
+
+  it 'returns code 0 for default command runner' do
+    expect(Cliqr.command.new.execute).to eq(0)
+  end
+end

data/spec/executor/fixtures/always_error_command.rb

@@ -0,0 +1,8 @@
+# encoding: utf-8
+
+# A command that always throws an error
+class AlwaysErrorCommand < Cliqr.command
+  def execute
+    fail StandardError, 'I always throw an error'
+  end
+end

data/spec/executor/fixtures/test_command.rb

@@ -0,0 +1,8 @@
+# encoding: utf-8
+
+# Test command for the router_spec
+class TestCommand < Cliqr.command
+  def execute
+    puts 'test command executed'
+  end
+end

data/spec/executor/router_spec.rb

@@ -0,0 +1,25 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+require 'executor/fixtures/test_command'
+require 'executor/fixtures/always_error_command'
+
+describe Cliqr::CLI::Router do
+  it 'routes base command with no arguments' do
+    cli = Cliqr.interface do
+      basename 'my-command'
+      handler TestCommand
+    end
+    result = cli.execute output: :buffer
+    expect(result[:stdout]).to eq "test command executed\n"
+  end
+
+  it 'handles error appropriately' do
+    cli = Cliqr.interface do
+      basename 'my-command'
+      handler AlwaysErrorCommand
+    end
+    expect { cli.execute }.to raise_error(Cliqr::Error::CommandRuntimeException)
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cliqr
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.4
 platform: ruby
 authors:
 - Anshul Verma
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-05-09 00:00:00.000000000 Z
+date: 2015-05-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: log4r
@@ -56,13 +56,22 @@ files:
 - Rakefile
 - lib/cliqr.rb
 - lib/cliqr/cli/builder.rb
+- lib/cliqr/cli/command.rb
+- lib/cliqr/cli/command_runner_factory.rb
 - lib/cliqr/cli/config.rb
+- lib/cliqr/cli/interface.rb
+- lib/cliqr/cli/router.rb
 - lib/cliqr/cli/validator.rb
 - lib/cliqr/dsl.rb
 - lib/cliqr/error.rb
 - lib/cliqr/version.rb
-- spec/dsl/interface_builder_spec.rb
+- spec/config/config_finalize_spec.rb
+- spec/config/config_validator_spec.rb
 - spec/dsl/interface_spec.rb
+- spec/executor/command_runner_spec.rb
+- spec/executor/fixtures/always_error_command.rb
+- spec/executor/fixtures/test_command.rb
+- spec/executor/router_spec.rb
 - spec/spec_helper.rb
 homepage: https://github.com/anshulverma/cliqr
 licenses:
@@ -89,7 +98,12 @@ signing_key:
 specification_version: 4
 summary: A framework and DSL for defining CLI interface
 test_files:
-- spec/dsl/interface_builder_spec.rb
+- spec/config/config_finalize_spec.rb
+- spec/config/config_validator_spec.rb
 - spec/dsl/interface_spec.rb
+- spec/executor/command_runner_spec.rb
+- spec/executor/fixtures/always_error_command.rb
+- spec/executor/fixtures/test_command.rb
+- spec/executor/router_spec.rb
 - spec/spec_helper.rb
 has_rdoc: 

data/spec/dsl/interface_builder_spec.rb

@@ -1,9 +0,0 @@
-# encoding: utf-8
-
-require 'spec_helper'
-
-describe Cliqr::CLI::Builder do
-  it 'does not allow empty config' do
-    expect { Cliqr::CLI::Builder.new(nil) }.to raise_error(Cliqr::Error::ConfigNotFound)
-  end
-end