hammer_cli 0.0.8 → 0.0.9

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f94cb081ad874612f32639ed07cdf5626fb69ba4
+  data.tar.gz: 479cf176ac7bb522702489eb0205286ea0a98bf4
+SHA512:
+  metadata.gz: 5a52be94f2ad2519e8eff5737b4f1fafbefb247db4fc49a6be931f0129f4a12fae8641e086ab4f0b9cca8bef691db8a5a6035c43e94afb7cb1c6ef0da7504403
+  data.tar.gz: b97b952d02e88eb7541ea041d61b32cfe5374200a1d59ba6d24a38f8f3e58289b598606a075863ba58501f038c61547ce0b669e42befa81ea1b074d914c2ceec

data/doc/developer_docs.md

@@ -1,5 +1,5 @@
-Hammer Developer Docs
-=====================
+Hammer Development Docs
+=======================
 
 Hammer is a generic clamp-based CLI framework. It uses existing clamp features and adds some extra utilities.
 We recommend to get familiar with the [Clamp documentation](https://github.com/mdub/clamp/#quick-start)
@@ -253,29 +253,50 @@ end
 
 ```
 
-#### Option formatters
-Another option-related feature is a set of formatters for specific option types:
+#### Option normalizers
+Another option-related feature is a set of normalizers for specific option types. They validate and preprocess
+option values. Each normalizer has a description of the format it accepts. This description is printed
+in commands' help.
 
-* _HammerCLI::OptionFormatters.list_
+##### _List_
 
 Parses comma separated strings to a list of values.
 
-Usage:
 ```ruby
-option "--users", "USER_NAMES", "List of user names", &HammerCLI::OptionFormatters.method(:list)
+option "--users", "USER_NAMES", "List of user names",
+  :format => HammerCLI::Options::Normalizers::List.new
 ```
 `--users='J.R.,Gary,Bobby'` -> `['J.R.', 'Gary', 'Bobby']`
 
-* _HammerCLI::OptionFormatters.file_
+##### _File_
 
 Loads contents of a file and returns it as a value of the option.
 
-Usage:
 ```ruby
-option "--poem", "PATH_TO_POEM", "File containing the text of your poem", &HammerCLI::OptionFormatters.method(:file)
+option "--poem", "PATH_TO_POEM", "File containing the text of your poem",
+  :format => HammerCLI::Options::Normalizers::File.new
 ```
 `--poem=~/verlaine/les_poetes_maudits.txt` -> content of the file
 
+##### _Bool_
+
+Case insensitive true/false values. Translates _yes,y,true,t,1_ to `true` and _no,n,false,f,0_ to `false`.
+
+```ruby
+option "--start", "START", "Start the action",
+  :format => HammerCLI::Options::Normalizers::Bool.new
+```
+`--start=yes` -> `true`
+
+##### _KeyValueList_
+
+Parses a comma separated list of key=value pairs. Can be used for naming attributes with vague structure.
+
+```ruby
+option "--attributes", "ATTRIBUTES", "Values of various attributes",
+  :format => HammerCLI::Options::Normalizers::KeyValueList.new
+```
+`--attributes="material=unoptanium,thickness=3"` -> `{'material' => 'unoptanium', 'thickness' => '3'}`
 
 ### Adding subcommands
 Commands in the cli can be structured into a tree of parent commands (nodes) and subcommands (leaves).
@@ -441,35 +462,40 @@ Imagine there's an API of some service that returns list of users:
 
 We can create an output definition that selects and formats some of the fields:
 ```ruby
-dsl = HammerCLI::Output::Dsl.new
-dsl.build do
+class Command < HammerCLI::AbstractCommand
 
-  # Simple field with a label. The first parameter is key in the printed hash.
-  field :id, 'ID'
+  output do
+    # Simple field with a label. The first parameter is key in the printed hash.
+    field :id, 'ID'
 
-  # Fields can have types. The type determines how the field is printed.
-  # All available types are listed below.
-  # Here we want the roles to act as list.
-  field :roles, 'System Roles', Fields::List
+    # Fields can have types. The type determines how the field is printed.
+    # All available types are listed below.
+    # Here we want the roles to act as list.
+    field :roles, 'System Roles', Fields::List
 
-  # Label is used for grouping fields.
-  label 'Contacts' do
-    field :email, 'Email'
-    field :phone, 'Phone No.'
-  end
+    # Label is used for grouping fields.
+    label 'Contacts' do
+      field :email, 'Email'
+      field :phone, 'Phone No.'
+    end
 
-  # From is used for accessing nested fields.
-  from :timestamps do
-    # See how date gets formatted in the output
-    field :created, 'Created At', Fields::Date
+    # From is used for accessing nested fields.
+    from :timestamps do
+      # See how date gets formatted in the output
+      field :created, 'Created At', Fields::Date
+    end
   end
-end
 
-definition = HammerCLI::Output::Definition.new
-definition.append(dsl.fields)
-
-print_records(definition, data)
+  def execute
+    records = retrieve_data
+    print_records(         # <- printing utility of AbstractCommand
+      output_definition,   # <- method for accessing fields defined in the block 'output'
+      records              # <- the data to print
+    )
+    return HammerCLI::EX_OK
+  end
 
+end
 ```
 
 Using the base adapter the output will look like:
@@ -491,6 +517,21 @@ Contacts:
 Created At:    2012/12/18 15:25:00
 ```
 
+You can optionally use output definition from another command as a base and extend it with
+additional fields. This is helpful when there are two commands, one listing brief data and
+another one showing details. Typically it's list and show.
+```ruby
+class ShowCommand < HammerCLI::AbstractCommand
+
+  output ListCommand.output_definition do
+    # additional fields
+  end
+
+  # ...
+end
+```
+
+
 All Hammer field types are:
  * __Date__
  * __Id__ - Used to mark ID values, current print adapters have support for turning id printing on/off.
@@ -593,21 +634,300 @@ HammerCLI::Settings.get(:hello_world, :name)  # get a nested value
 There's more ways where to place your config file for hammer.
 Read more in [the settings howto](https://github.com/theforeman/hammer-cli#configuration).
 
+
 Creating commands for RESTful API with ApiPie
 ---------------------------------------------
-Coming soon...
+
+CLIs binded to a rest api do simillar things for most of the resources. Typically it's
+CRUD actions that appear for nearly every resource. Actions differ with parameters
+accross resources but the operations remain the same.
+
+Hammer is optimised for usage with [ApiPie](https://github.com/Pajk/apipie-rails)
+and generated api bindings and tries to reduce the effort neccessary for a command creation.
 
 
-<!--
-- this part is valid for foreman
-- what is apipie
-- apipie bindings
-- apipie, read and write commands
-- define ids a resources
-- apipie support, apipie_options
--->
+### ApiPie and bindings
 
+[ApiPie](https://github.com/Pajk/apipie-rails) is a documentation library for RESTful APIs.
+Unlike traditional tools ApiPie uses DSL for api description. This brings many advantages. See its
+documentation for details.
+
+Foreman comes with [ruby bindings](https://github.com/theforeman/foreman_api) automatically generated
+from the information provided by ApiPie. Every resource (eg. Architecture, User) has it's own
+class with methods for each available action (eg. create, show, index, destroy).
+Apart from that it contains also full api documentation with parameters for the actions.
+This enables to reuse the documentation on client side for automatic option definition
+and reduce the amount of custom code per CLI action.
+
+
+### ApiPie commands in Hammer
+
+Hammer identifies two basic types of ApiPie commands:
+
+-  __ReadCommand__
+  - should be used for actions that print records
+  - retrieves the data and prints them in given format (uses output definition)
+  - typical actions in rails terminology: _index, show_
+
+- __WriteCommand__
+  - should used for actions that modify records
+  - sends modifying request and prints the result
+  - typical actions in rails terminology: _create, update, destroy_
+
+Both command classes are single resource related and expect the resource and an action to be defined.
+There's a simple DSL for that:
+
+```ruby
+class ListCommand < HammerCLI::Apipie::ReadCommand
+  # define resource and the action together
+  resource ForemanApi::Resources::Architecture, :index
+end
 
+# or
+
+class ListCommand2 < HammerCLI::Apipie::ReadCommand
+  # define them separately
+  resource ForemanApi::Resources::Architecture
+  action :index
+end
+```
+
+#### Options definition
+
+When the resource-action pair is defined we can take the advantage of automatic option definition.
+There's a class method `apipie_options` for this purpose.
+
+```ruby
+class ListCommand < HammerCLI::Apipie::ReadCommand
+  resource ForemanApi::Resources::Architecture, :index
+
+  apipie_options
+end
+```
+
+If we plug the command into an existing command tree and check the help we will see there
+are four parameters defined from the ApiPie docs. Compare the result with
+[online api documentation](http://www.theforeman.org/api/apidoc/architectures/index.html).
+```
+$ hammer architecture list -h
+Usage:
+    hammer architecture list [OPTIONS]
+
+Options:
+    --search SEARCH               filter results
+    --order ORDER                 sort results
+    --page PAGE                   paginate results
+    --per-page PER_PAGE           number of entries per request
+    -h, --help                    print help
+```
+
+It is possible to combine apipie options with custom ones. If the generated options
+doesn't suit your needs for any reason, you can always skip and redefine them by hand.
+See following example.
+```ruby
+class ListCommand < HammerCLI::Apipie::ReadCommand
+  resource ForemanApi::Resources::Architecture, :index
+
+  apipie_options :without => [:search, :order]
+  option '--search', 'QUERY', "search query"
+end
+```
+
+```
+hammer architecture list -h
+Usage:
+    hammer architecture list [OPTIONS]
+
+Options:
+    --page PAGE                   paginate results
+    --per-page PER_PAGE           number of entries per request
+    --search QUERY                search query
+    -h, --help                    print help
+```
+Note that the `--search` description has changed and `--order` disappeared.
+
+Automatic options reflect:
+- parameter names and descriptions
+- required parameters
+- parameter types - the only supported type is array, which is translated to option normalizer `List`
+
+#### Write commands
+
+Write commands are expected to print result of the api action. There are
+two class methods for setting success and failure messages. Messages are
+printed according to the http status code the api returned.
+
+```ruby
+success_message "The user has been created"
+failure_message "Could not create the user"
+```
+
+
+#### Example 1: Create an architecture
+
+```ruby
+class CreateCommand < HammerCLI::Apipie::WriteCommand
+  command_name "create"
+  resource ForemanApi::Resources::Architecture, :create
 
+  success_message "Architecture created"
+  failure_message "Could not create the architecture"
 
+  apipie_options
+end
+```
+
+```
+$ hammer architecture create -h
+Usage:
+    hammer architecture create [OPTIONS]
+
+Options:
+    --name NAME
+    --operatingsystem-ids OPERATINGSYSTEM_IDS Operatingsystem ID’s
+                                  Comma separated list of values.
+    -h, --help                    print help
+```
+
+```
+$ hammer architecture create
+ERROR: option '--name' is required
+
+See: 'hammer architecture create --help'
+```
+
+```
+$ hammer architecture create --name test --operatingsystem-ids=1,2
+Architecture created
+```
+
+```
+$ hammer architecture create --name test
+Could not create the architecture:
+  Name has already been taken
+```
+
+
+#### Example 2: Show an architecture
+
+```ruby
+class InfoCommand < HammerCLI::Apipie::ReadCommand
+  command_name "info"
+  resource ForemanApi::Resources::Architecture, :show
+
+  # It's a good practice to reuse output definition from list commands
+  # and add more details. It helps avoiding duplicities.
+  output ListCommand.output_definition do
+    from "architecture" do
+      field :operatingsystem_ids, "OS ids", Fields::List
+      field :created_at, "Created at", Fields::Date
+      field :updated_at, "Updated at", Fields::Date
+    end
+  end
+
+  apipie_options
+end
+```
+
+```
+$ hammer architecture info -h
+Usage:
+    hammer architecture info [OPTIONS]
+
+Options:
+    --id ID
+    -h, --help                    print help
+```
+
+```
+$ hammer architecture info --id 1
+Id:          1
+Name:        x86_64
+OS ids:      1, 3
+Created at:  2013/06/08 18:53:56
+Updated at:  2013/06/08 19:17:43
+```
+
+
+#### Tips
+
+When you define more command like we've shown above you find yourself repeating
+`resource ...` in every one of them. As the commands are usually grouped by
+the resource it is handy to extract the resource definition one level up to
+the encapsulating command.
+
+```ruby
+ class Architecture < HammerCLI::Apipie::Command
+
+    resource ForemanApi::Resources::Architecture
+
+    class ListCommand < HammerCLI::Apipie::ReadCommand
+      action :index
+      # ...
+    end
+
+
+    class InfoCommand < HammerCLI::Apipie::ReadCommand
+      action :show
+      # ...
+    end
+
+    # ...
+  end
+```
+
+ApiPie resources are being looked up in the encapsulating classes and modules
+when the definition is missing in the command class. If they are not found even there
+the resource of the parent command is used at runtime. This is useful for context-aware
+shared commands.
+
+The following example shows a common subcommand that can be attached to
+any parent of which resource implements method `add_tag`. Please note that this example
+is fictitious. There's no tags in Foreman's architectures and users.
+```ruby
+module Tags
+  class AddTag < HammerCLI::Apipie::WriteCommand
+    option '--id', 'ID', 'ID of the resource'
+    option '--tag', 'TAG', 'Name of the tag to add'
+    action :add_tag
+    command_name 'add_tag'
+  end
+end
+
+class Architecture < HammerCLI::Apipie::Command
+  resource ForemanApi::Resources::Architecture
+  # ...
+  include Tags
+  autoload_subcommands
+end
+
+class User < HammerCLI::Apipie::Command
+  resource ForemanApi::Resources::User
+  # ...
+  include Tags
+  autoload_subcommands
+end
+```
+
+```
+$ hammer architecture add_tag -h
+Usage:
+    hammer architecture add_tag [OPTIONS]
+
+Options:
+    --id ID                       ID of the resource
+    --tag TAG                     Name of the tag to add
+    -h, --help                    print help
+```
+
+```
+$ hammer user add_tag -h
+Usage:
+    hammer user add_tag [OPTIONS]
+
+Options:
+    --id ID                       ID of the resource
+    --tag TAG                     Name of the tag to add
+    -h, --help                    print help
+```
 

data/lib/hammer_cli/abstract.rb

@@ -1,6 +1,7 @@
 require 'hammer_cli/autocompletion'
 require 'hammer_cli/exception_handler'
 require 'hammer_cli/logger_watch'
+require 'hammer_cli/options/option_definition'
 require 'clamp'
 require 'logging'
 
@@ -85,6 +86,23 @@ module HammerCLI
       super
     end
 
+    def self.output(definition=nil, &block)
+      dsl = HammerCLI::Output::Dsl.new
+      dsl.build &block if block_given?
+
+      output_definition.append definition.fields unless definition.nil?
+      output_definition.append dsl.fields
+    end
+
+    def output_definition
+      self.class.output_definition
+    end
+
+    def self.output_definition
+      @output_definition ||= HammerCLI::Output::Definition.new
+      @output_definition
+    end
+
     protected
 
     def print_records(definition, records)
@@ -139,6 +157,19 @@ module HammerCLI
       end
     end
 
+    def self.option(switches, type, description, opts = {}, &block)
+      formatter = opts.delete(:format)
+
+      HammerCLI::Options::OptionDefinition.new(switches, type, description, opts).tap do |option|
+        declared_options << option
+
+        option.value_formatter = formatter
+        block ||= option.default_conversion_block
+
+        define_accessors_for(option, &block)
+      end
+    end
+
     def all_options
       self.class.recognised_options.inject({}) do |h, opt|
         h[opt.attribute_name] = send(opt.read_method)

data/lib/hammer_cli/apipie/command.rb

@@ -9,8 +9,8 @@ module HammerCLI::Apipie
     include HammerCLI::Apipie::Options
 
     def initialize(*args)
+      super
       setup_identifier_options
-      super(*args)
     end
 
     def setup_identifier_options
@@ -32,7 +32,9 @@ module HammerCLI::Apipie
 
     def validate_options
       super
-      validator.any(*self.class.declared_identifiers.values).required
+      if self.class.declared_identifiers
+        validator.any(*self.class.declared_identifiers.values).required
+      end
     end
 
     def self.desc(desc=nil)

data/lib/hammer_cli/apipie/options.rb

@@ -1,4 +1,3 @@
-require 'hammer_cli/option_formatters'
 
 module HammerCLI::Apipie
   module Options
@@ -59,8 +58,7 @@ module HammerCLI::Apipie
           option_switches(param),
           option_type(param),
           option_desc(param),
-          option_opts(param),
-          &option_formatter(param)
+          option_opts(param)
         )
       end
 
@@ -81,15 +79,10 @@ module HammerCLI::Apipie
       def option_opts(param)
         opts = {}
         opts[:required] = true if param["required"]
-        return opts
-      end
-
-      def option_formatter(param)
         # FIXME: There is a bug in apipie, it does not produce correct expected type for Arrays
         # When it's fixed, we should test param["expected_type"] == "array"
-        if param["validator"].include? "Array"
-          HammerCLI::OptionFormatters.method(:list)
-        end
+        opts[:format] = HammerCLI::Options::Normalizers::List.new if param["validator"].include? "Array"
+        return opts
       end
 
     end

data/lib/hammer_cli/apipie/read_command.rb

@@ -4,23 +4,6 @@ module HammerCLI::Apipie
 
   class ReadCommand < Command
 
-      def self.output(definition=nil, &block)
-        dsl = HammerCLI::Output::Dsl.new
-        dsl.build &block if block_given?
-
-        output_definition.append definition.fields unless definition.nil?
-        output_definition.append dsl.fields
-      end
-
-      def output_definition
-        self.class.output_definition
-      end
-
-      def self.output_definition
-        @output_definition ||= HammerCLI::Output::Definition.new
-        @output_definition
-      end
-
       def execute
         d = retrieve_data
         logger.watch "Retrieved data: ", d

data/lib/hammer_cli/apipie/resource.rb

@@ -16,7 +16,7 @@ module HammerCLI::Apipie
       resource_class.doc["methods"].each do |method|
         return method if method["name"] == method_name.to_s
       end
-      raise "No method documentation found for #{resource_class}##{action}"
+      raise "No method documentation found for #{resource_class}##{method_name}"
     end
 
   end

data/lib/hammer_cli/apipie/write_command.rb

@@ -20,7 +20,6 @@ module HammerCLI::Apipie
     end
 
     def send_request
-      raise "resource or action not defined" unless self.class.resource_defined?
       resource.call(action, request_params)[0]
     end
 

data/lib/hammer_cli/options/normalizers.rb

@@ -0,0 +1,76 @@
+module HammerCLI
+  module Options
+    module Normalizers
+
+
+      class AbstractNormalizer
+        def description
+          ""
+        end
+
+        def format(val)
+          raise NotImplementedError, "Class #{self.class.name} must implement method format."
+        end
+      end
+
+
+      class KeyValueList < AbstractNormalizer
+
+        def description
+          "Comma-separated list of key=value."
+        end
+
+        def format(val)
+          return {} unless val.is_a?(String)
+
+          val.split(",").inject({}) do |result, item|
+            parts = item.split("=")
+            if parts.size != 2
+              raise ArgumentError, "value must be defined as a comma-separated list of key=value"
+            end
+            result.update(parts[0] => parts[1])
+          end
+        end
+      end
+
+
+      class List < AbstractNormalizer
+
+        def description
+          "Comma separated list of values."
+        end
+
+        def format(val)
+          val.is_a?(String) ? val.split(",") : []
+        end
+      end
+
+
+      class Bool < AbstractNormalizer
+
+        def description
+          "One of true/false, yes/no, 1/0."
+        end
+
+        def format(bool)
+          if bool.downcase.match(/^(true|t|yes|y|1)$/i)
+            return true
+          elsif bool.downcase.match(/^(false|f|no|n|0)$/i)
+            return false
+          else
+            raise ArgumentError, "value must be one of true/false, yes/no, 1/0"
+          end
+        end
+      end
+
+
+      class File < AbstractNormalizer
+
+        def format(path)
+          ::File.read(::File.expand_path(path))
+        end
+      end
+
+    end
+  end
+end

data/lib/hammer_cli/options/option_definition.rb

@@ -0,0 +1,68 @@
+require 'clamp'
+
+module HammerCLI
+  module Options
+
+    class OptionDefinition < Clamp::Option::Definition
+
+      attr_accessor :value_formatter
+
+      def help_lhs
+        super
+      end
+
+      def help_rhs
+        lines = [
+          description.strip,
+          format_description.strip,
+          value_description.strip
+        ]
+
+        rhs = lines.reject(&:empty?).join("\n")
+        rhs.empty? ? " " : rhs
+      end
+
+      def format_description
+        if value_formatter.nil?
+          ""
+        else
+          value_formatter.description
+        end
+      end
+
+      def value_description
+        default_sources = [
+          ("$#{@environment_variable}" if defined?(@environment_variable)),
+          (@default_value.inspect if defined?(@default_value))
+        ].compact
+
+        str = ""
+        str += "Can be specified multiple times. " if multivalued?
+        str += "Default: " + default_sources.join(", or ") unless default_sources.empty?
+        str
+      end
+
+      def default_conversion_block
+        if !value_formatter.nil?
+          value_formatter.method(:format)
+        elsif flag?
+          Clamp.method(:truthy?)
+        end
+      end
+
+      def default_value
+        if defined?(@default_value)
+          if value_formatter
+            value_formatter.format(@default_value)
+          else
+            @default_value
+          end
+        elsif multivalued?
+          []
+        end
+      end
+
+    end
+
+  end
+end

data/lib/hammer_cli/output/adapter/table.rb

@@ -24,6 +24,8 @@ module HammerCLI::Output::Adapter
       end
 
       printer = TablePrint::Printer.new(rows, options)
+      TablePrint::Config.max_width = 40
+
       output = printer.table_print
       dashes = /\n([-|]+)\n/.match(output)
 

data/lib/hammer_cli/version.rb

@@ -1,5 +1,5 @@
 module HammerCLI
   def self.version
-    @version ||= Gem::Version.new '0.0.8'
+    @version ||= Gem::Version.new '0.0.9'
   end
 end

data/lib/hammer_cli.rb

@@ -3,6 +3,7 @@ require 'hammer_cli/exit_codes'
 require 'hammer_cli/settings'
 require 'hammer_cli/validator'
 require 'hammer_cli/output'
+require 'hammer_cli/options/normalizers'
 require 'hammer_cli/abstract'
 require 'hammer_cli/main'
 

metadata

@@ -1,8 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hammer_cli
 version: !ruby/object:Gem::Version
-  version: 0.0.8
-  prerelease: 
+  version: 0.0.9
 platform: ruby
 authors:
 - Martin Bačovský
@@ -10,107 +9,94 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-10-29 00:00:00.000000000 Z
+date: 2013-11-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: clamp
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rest-client
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: logging
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: awesome_print
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: table_print
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: highline
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
-description: ! 'Hammer cli provides universal extendable CLI interface for ruby apps
-
-'
+description: |
+  Hammer cli provides universal extendable CLI interface for ruby apps
 email: mbacovsk@redhat.com
 executables:
 - hammer
@@ -120,74 +106,74 @@ extra_rdoc_files:
 - LICENSE
 - hammer_cli_complete
 - config/cli_config.template.yml
+- doc/developer_docs.md
 - doc/design.png
 - doc/design.uml
-- doc/developer_docs.md
 files:
-- lib/hammer_cli.rb
+- lib/hammer_cli/logger_watch.rb
+- lib/hammer_cli/apipie/write_command.rb
+- lib/hammer_cli/apipie/resource.rb
+- lib/hammer_cli/apipie/read_command.rb
+- lib/hammer_cli/apipie/options.rb
+- lib/hammer_cli/apipie/command.rb
+- lib/hammer_cli/logger.rb
 - lib/hammer_cli/messages.rb
-- lib/hammer_cli/output/fields.rb
-- lib/hammer_cli/output/formatters.rb
+- lib/hammer_cli/abstract.rb
+- lib/hammer_cli/apipie.rb
+- lib/hammer_cli/version.rb
+- lib/hammer_cli/exception_handler.rb
+- lib/hammer_cli/output.rb
+- lib/hammer_cli/autocompletion.rb
+- lib/hammer_cli/shell.rb
 - lib/hammer_cli/output/adapter/table.rb
 - lib/hammer_cli/output/adapter/base.rb
 - lib/hammer_cli/output/adapter/abstract.rb
 - lib/hammer_cli/output/adapter/silent.rb
 - lib/hammer_cli/output/adapter/csv.rb
+- lib/hammer_cli/output/definition.rb
 - lib/hammer_cli/output/adapter.rb
-- lib/hammer_cli/output/output.rb
 - lib/hammer_cli/output/dsl.rb
-- lib/hammer_cli/output/definition.rb
-- lib/hammer_cli/abstract.rb
-- lib/hammer_cli/shell.rb
-- lib/hammer_cli/autocompletion.rb
-- lib/hammer_cli/logger_watch.rb
-- lib/hammer_cli/logger.rb
-- lib/hammer_cli/apipie.rb
-- lib/hammer_cli/apipie/command.rb
-- lib/hammer_cli/apipie/options.rb
-- lib/hammer_cli/apipie/resource.rb
-- lib/hammer_cli/apipie/write_command.rb
-- lib/hammer_cli/apipie/read_command.rb
+- lib/hammer_cli/output/formatters.rb
+- lib/hammer_cli/output/output.rb
+- lib/hammer_cli/output/fields.rb
+- lib/hammer_cli/options/option_definition.rb
+- lib/hammer_cli/options/normalizers.rb
+- lib/hammer_cli/settings.rb
 - lib/hammer_cli/validator.rb
-- lib/hammer_cli/version.rb
 - lib/hammer_cli/exit_codes.rb
-- lib/hammer_cli/output.rb
-- lib/hammer_cli/exception_handler.rb
 - lib/hammer_cli/main.rb
-- lib/hammer_cli/option_formatters.rb
-- lib/hammer_cli/settings.rb
+- lib/hammer_cli.rb
 - bin/hammer
 - README.md
 - LICENSE
 - hammer_cli_complete
 - config/cli_config.template.yml
+- doc/developer_docs.md
 - doc/design.png
 - doc/design.uml
-- doc/developer_docs.md
 homepage: http://github.com/theforeman/hammer-cli
 licenses:
 - GPL-3
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 2.0.8
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Universal command-line interface
 test_files: []
 has_rdoc: 

data/lib/hammer_cli/option_formatters.rb

@@ -1,13 +0,0 @@
-module HammerCLI
-  module OptionFormatters
-
-    def self.list(val)
-      val.is_a?(String) ? val.split(",") : []
-    end
-
-    def self.file(path)
-      File.read(File.expand_path(path))
-    end
-
-  end
-end