hanami-cli 0.2.0 → 2.0.0.alpha2

data/lib/hanami/cli/parser.rb

@@ -1,122 +0,0 @@
-require "optparse"
-require "hanami/cli/program_name"
-
-module Hanami
-  class CLI
-    # Parse command line arguments and options
-    #
-    # @since 0.1.0
-    # @api private
-    module Parser
-      # @since 0.1.0
-      # @api private
-      #
-      # rubocop:disable Metrics/MethodLength
-      def self.call(command, arguments, names)
-        parsed_options = {}
-
-        OptionParser.new do |opts|
-          command.options.each do |option|
-            opts.on(*option.parser_options) do |value|
-              parsed_options[option.name.to_sym] = value
-            end
-          end
-
-          opts.on_tail("-h", "--help") do
-            return Result.help
-          end
-        end.parse!(arguments)
-
-        parsed_options = command.default_params.merge(parsed_options)
-        parse_required_params(command, arguments, names, parsed_options)
-      rescue ::OptionParser::ParseError
-        Result.failure
-      end
-      # rubocop:enable Metrics/MethodLength
-
-      # @since 0.1.0
-      # @api private
-      def self.full_command_name(names)
-        ProgramName.call(names)
-      end
-
-      # @since 0.1.0
-      # @api private
-      #
-      # rubocop:disable Metrics/AbcSize
-      # rubocop:disable Metrics/MethodLength
-      def self.parse_required_params(command, arguments, names, parsed_options)
-        parse_params = Hash[command.arguments.map(&:name).zip(arguments)]
-        parse_required_params = Hash[command.required_arguments.map(&:name).zip(arguments)]
-        all_required_params_satisfied = command.required_arguments.all? { |param| !parse_required_params[param.name].nil? }
-
-        unless all_required_params_satisfied
-          parse_required_params_values = parse_required_params.values.compact
-
-          usage = "\nUsage: \"#{full_command_name(names)} #{command.required_arguments.map(&:description_name).join(' ')}\""
-
-          if parse_required_params_values.empty? # rubocop:disable Style/GuardClause
-            return Result.failure("ERROR: \"#{full_command_name(names)}\" was called with no arguments#{usage}")
-          else
-            return Result.failure("ERROR: \"#{full_command_name(names)}\" was called with arguments #{parse_required_params_values}#{usage}")
-          end
-        end
-
-        parse_params.reject! { |_key, value| value.nil? }
-        Result.success(parsed_options.merge(parse_params))
-      end
-      # rubocop:enable Metrics/MethodLength
-      # rubocop:enable Metrics/AbcSize
-
-      # @since 0.1.0
-      # @api private
-      class Result
-        # @since 0.1.0
-        # @api private
-        def self.help
-          new(help: true)
-        end
-
-        # @since 0.1.0
-        # @api private
-        def self.success(arguments = {})
-          new(arguments: arguments)
-        end
-
-        # @since 0.1.0
-        # @api private
-        def self.failure(error = "Error: Invalid param provided")
-          new(error: error)
-        end
-
-        # @since 0.1.0
-        # @api private
-        attr_reader :arguments
-
-        # @since 0.1.0
-        # @api private
-        attr_reader :error
-
-        # @since 0.1.0
-        # @api private
-        def initialize(arguments: {}, error: nil, help: false)
-          @arguments = arguments
-          @error     = error
-          @help      = help
-        end
-
-        # @since 0.1.0
-        # @api private
-        def error?
-          !error.nil?
-        end
-
-        # @since 0.1.0
-        # @api private
-        def help?
-          @help
-        end
-      end
-    end
-  end
-end

data/lib/hanami/cli/program_name.rb

@@ -1,19 +0,0 @@
-module Hanami
-  class CLI
-    # Program name
-    #
-    # @since 0.1.0
-    # @api private
-    module ProgramName
-      # @since 0.1.0
-      # @api private
-      SEPARATOR = " ".freeze
-
-      # @since 0.1.0
-      # @api private
-      def self.call(names = [], program_name: $PROGRAM_NAME)
-        [File.basename(program_name), names].flatten.join(SEPARATOR)
-      end
-    end
-  end
-end

data/lib/hanami/cli/registry.rb

@@ -1,328 +0,0 @@
-require "hanami/cli/command_registry"
-
-module Hanami
-  class CLI
-    # Registry mixin
-    #
-    # @since 0.1.0
-    module Registry
-      # @since 0.1.0
-      # @api private
-      def self.extended(base)
-        base.class_eval do
-          @commands = CommandRegistry.new
-        end
-      end
-
-      # Register a command
-      #
-      # @param name [String] the command name
-      # @param command [NilClass,Hanami::CLI::Command] the optional command
-      # @param aliases [Array<String>] an optional list of aliases
-      # @param options [Hash] a set of options
-      #
-      # @since 0.1.0
-      #
-      # @example Register a command
-      #   require "hanami/cli"
-      #
-      #   module Foo
-      #     module Commands
-      #       extend Hanami::CLI::Registry
-      #
-      #       class Hello < Hanami::CLI::Command
-      #       end
-      #
-      #       register "hi", Hello
-      #     end
-      #   end
-      #
-      # @example Register a command with aliases
-      #   require "hanami/cli"
-      #
-      #   module Foo
-      #     module Commands
-      #       extend Hanami::CLI::Registry
-      #
-      #       class Hello < Hanami::CLI::Command
-      #       end
-      #
-      #       register "hello", Hello, aliases: ["hi", "ciao"]
-      #     end
-      #   end
-      #
-      # @example Register a group of commands
-      #   require "hanami/cli"
-      #
-      #   module Foo
-      #     module Commands
-      #       extend Hanami::CLI::Registry
-      #
-      #       module Generate
-      #         class App < Hanami::CLI::Command
-      #         end
-      #
-      #         class Action < Hanami::CLI::Command
-      #         end
-      #       end
-      #
-      #       register "generate", aliases: ["g"] do |prefix|
-      #         prefix.register "app",    Generate::App
-      #         prefix.register "action", Generate::Action
-      #       end
-      #     end
-      #   end
-      def register(name, command = nil, aliases: [], **options)
-        if block_given?
-          yield Prefix.new(@commands, name, aliases)
-        else
-          @commands.set(name, command, aliases, **options)
-        end
-      end
-
-      # Register a before callback.
-      #
-      # @param command_name [String] the name used for command registration
-      # @param callback [Class, #call] the callback object. If a class is given,
-      #   it MUST respond to `#call`.
-      # @param blk [Proc] the callback espressed as a block
-      #
-      # @raise [Hanami::CLI::UnkwnownCommandError] if the command isn't registered
-      # @raise [Hanami::CLI::InvalidCallbackError] if the given callback doesn't
-      #   implement the required interface
-      #
-      # @since 0.2.0
-      #
-      # @example
-      #   require "hanami/cli"
-      #
-      #   module Foo
-      #     module Commands
-      #       extend Hanami::CLI::Registry
-      #
-      #       class Hello < Hanami::CLI::Command
-      #         def call(*)
-      #           puts "hello"
-      #         end
-      #       end
-      #
-      #       register "hello", Hello
-      #       before "hello", -> { puts "I'm about to say.." }
-      #     end
-      #   end
-      #
-      # @example Register an object as callback
-      #   require "hanami/cli"
-      #
-      #   module Callbacks
-      #     class Hello
-      #       def call(*)
-      #         puts "world"
-      #       end
-      #     end
-      #   end
-      #
-      #   module Foo
-      #     module Commands
-      #       extend Hanami::CLI::Registry
-      #
-      #       class Hello < Hanami::CLI::Command
-      #         def call(*)
-      #           puts "I'm about to say.."
-      #         end
-      #       end
-      #
-      #       register "hello", Hello
-      #       before "hello", Callbacks::Hello.new
-      #     end
-      #   end
-      #
-      # @example Register a class as callback
-      #   require "hanami/cli"
-      #
-      #   module Callbacks
-      #     class Hello
-      #       def call(*)
-      #         puts "world"
-      #       end
-      #     end
-      #   end
-      #
-      #   module Foo
-      #     module Commands
-      #       extend Hanami::CLI::Registry
-      #
-      #       class Hello < Hanami::CLI::Command
-      #         def call(*)
-      #           puts "I'm about to say.."
-      #         end
-      #       end
-      #
-      #       register "hello", Hello
-      #       before "hello", Callbacks::Hello
-      #     end
-      #   end
-      def before(command_name, callback = nil, &blk)
-        command(command_name).before_callbacks.append(&_callback(callback, blk))
-      end
-
-      # Register an after callback.
-      #
-      # @param command_name [String] the name used for command registration
-      # @param callback [Class, #call] the callback object. If a class is given,
-      #   it MUST respond to `#call`.
-      # @param blk [Proc] the callback espressed as a block
-      #
-      # @raise [Hanami::CLI::UnkwnownCommandError] if the command isn't registered
-      # @raise [Hanami::CLI::InvalidCallbackError] if the given callback doesn't
-      #   implement the required interface
-      #
-      # @since 0.2.0
-      #
-      # @example
-      #   require "hanami/cli"
-      #
-      #   module Foo
-      #     module Commands
-      #       extend Hanami::CLI::Registry
-      #
-      #       class Hello < Hanami::CLI::Command
-      #         def call(*)
-      #           puts "hello"
-      #         end
-      #       end
-      #
-      #       register "hello", Hello
-      #       after "hello", -> { puts "world" }
-      #     end
-      #   end
-      #
-      # @example Register an object as callback
-      #   require "hanami/cli"
-      #
-      #   module Callbacks
-      #     class World
-      #       def call(*)
-      #         puts "world"
-      #       end
-      #     end
-      #   end
-      #
-      #   module Foo
-      #     module Commands
-      #       extend Hanami::CLI::Registry
-      #
-      #       class Hello < Hanami::CLI::Command
-      #         def call(*)
-      #           puts "hello"
-      #         end
-      #       end
-      #
-      #       register "hello", Hello
-      #       after "hello", Callbacks::World.new
-      #     end
-      #   end
-      #
-      # @example Register a class as callback
-      #   require "hanami/cli"
-      #
-      #   module Callbacks
-      #     class World
-      #       def call(*)
-      #         puts "world"
-      #       end
-      #     end
-      #   end
-      #
-      #   module Foo
-      #     module Commands
-      #       extend Hanami::CLI::Registry
-      #
-      #       class Hello < Hanami::CLI::Command
-      #         def call(*)
-      #           puts "hello"
-      #         end
-      #       end
-      #
-      #       register "hello", Hello
-      #       after "hello", Callbacks::World
-      #     end
-      #   end
-      def after(command_name, callback = nil, &blk)
-        command(command_name).after_callbacks.append(&_callback(callback, blk))
-      end
-
-      # @since 0.1.0
-      # @api private
-      def get(arguments)
-        @commands.get(arguments)
-      end
-
-      private
-
-      COMMAND_NAME_SEPARATOR = " ".freeze
-
-      # @since 0.2.0
-      # @api private
-      def command(command_name)
-        get(command_name.split(COMMAND_NAME_SEPARATOR)).tap do |result|
-          raise UnkwnownCommandError.new(command_name) unless result.found?
-        end
-      end
-
-      # @since 0.2.0
-      # @api private
-      #
-      # rubocop:disable Metrics/MethodLength
-      def _callback(callback, blk)
-        return blk if blk.respond_to?(:to_proc)
-
-        case callback
-        when ->(c) { c.respond_to?(:call) }
-          callback.method(:call)
-        when Class
-          begin
-            _callback(callback.new, blk)
-          rescue ArgumentError
-            raise InvalidCallbackError.new(callback)
-          end
-        else
-          raise InvalidCallbackError.new(callback)
-        end
-      end
-      # rubocop:enable Metrics/MethodLength
-
-      # Command name prefix
-      #
-      # @since 0.1.0
-      class Prefix
-        # @since 0.1.0
-        # @api private
-        def initialize(registry, prefix, aliases)
-          @registry = registry
-          @prefix   = prefix
-
-          registry.set(prefix, nil, aliases)
-        end
-
-        # @since 0.1.0
-        #
-        # @see Hanami::CLI::Registry#register
-        def register(name, command, aliases: [], **options)
-          command_name = "#{prefix} #{name}"
-          registry.set(command_name, command, aliases, **options)
-        end
-
-        private
-
-        # @since 0.1.0
-        # @api private
-        attr_reader :registry
-
-        # @since 0.1.0
-        # @api private
-        attr_reader :prefix
-      end
-    end
-  end
-end