Contents

require 'registry'
require 'cl/args'
require 'cl/dsl'
require 'cl/opts'
require 'cl/parser'

class Cl
  # Base class for all command classes that can be run.
  #
  # Inherit your command classes from this class, use the {Cl::Cmd::Dsl} to
  # declare arguments, options, summary, description, examples etc., and
  # implement the method #run.
  #
  # See {Cl::Cmd::Dsl} for details on the DSL methods.
  class Cmd
    include Registry
    extend Dsl

    class << self
      include Merge, Underscore

      inherited = ->(const) do
        const.register [registry_key, underscore(const.name.split('::').last)].compact.join(':') if const.name
        const.define_singleton_method(:inherited, &inherited)
      end
      define_method(:inherited, &inherited)

      def cmds
        registry.values
      end

      def parse(ctx, cmd, args)
        parser = Parser.new(cmd, args)
        args, opts = parser.args, parser.opts unless self == Help
        opts = merge(ctx.config[registry_key], opts) if ctx.config[registry_key]
        [args, opts || {}]
      end
    end

    opt '--help', 'Get help on this command'

    attr_reader :ctx, :args

    def initialize(ctx, args)
      @ctx = ctx
      args, opts = self.class.parse(ctx, self, args)
      @opts = self.class.opts.apply(self, self.opts.merge(opts))
      @args = self.class.args.apply(self, args, opts)
    end

    def opts
      @opts ||= {}
    end

    def deprecations
      @deprecations ||= {}
    end
  end
end

Version data entries

3 entries across 3 versions & 1 rubygems

Version	Path
cl-1.1.2	lib/cl/cmd.rb
cl-1.1.1	lib/cl/cmd.rb
cl-1.1.0	lib/cl/cmd.rb