eac_cli 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 744852edf04e3fbd1d56f052591c18a64d89822e17765621e2d413034561d16c
+  data.tar.gz: 81ae42735b990eacd912c99afa9ad577322f746b79b0bf2aecde6990ac72dfbd
+SHA512:
+  metadata.gz: f70e6a51577955715f4d36d10856fd9af6a21aa9713b58280c1425ca44eb0c2a1cff764d20376af1ea82883da12914b6e1da1ac6dc70dfd063af898751821319
+  data.tar.gz: ae3b2cbf2fbaed4f8bab7ca55ba39bebf5bdeb254d596d22aafb932195ee5e2c8bb82f15c2e43fe8f4ae8e04672bb35f32785969392c484d891ea3f9802e3e1e

data/Gemfile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec

data/lib/eac_cli.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacCli
+  require_sub __FILE__
+end

data/lib/eac_cli/default_runner.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require 'active_support/concern'
+require 'eac_cli/runner'
+require 'eac_ruby_utils/console/speaker'
+require 'eac_ruby_utils/simple_cache'
+
+module EacCli
+  module DefaultRunner
+    extend ::ActiveSupport::Concern
+
+    included do
+      include ::EacCli::Runner
+      include ::EacRubyUtils::Console::Speaker
+      include ::EacRubyUtils::SimpleCache
+      runner_definition.alt do
+        options_arg false
+        bool_opt '-h', '--help', 'Show help.', usage: true
+      end
+    end
+  end
+end

data/lib/eac_cli/runner.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require 'eac_cli/runner/definition'
+require 'eac_cli/runner/docopt_doc'
+require 'eac_ruby_utils/core_ext'
+
+module EacCli
+  module Runner
+    extend ::ActiveSupport::Concern
+
+    included do
+      extend ClassMethods
+      include InstanceMethods
+    end
+
+    module ClassMethods
+      def runner_definition(&block)
+        @runner_definition ||= ::EacCli::Runner::Definition.new
+        @runner_definition.instance_eval(&block) if block
+        @runner_definition
+      end
+    end
+
+    module InstanceMethods
+      def doc
+        ::EacCli::Runner::DocoptDoc.new(self.class.runner_definition).to_s
+      end
+    end
+  end
+end

data/lib/eac_cli/runner/argument_option.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'eac_cli/runner/base_option'
+
+module EacCli
+  module Runner
+    class ArgumentOption < ::EacCli::Runner::BaseOption
+      def argument?
+        true
+      end
+    end
+  end
+end

data/lib/eac_cli/runner/base_option.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacCli
+  module Runner
+    class BaseOption
+      attr_reader :short, :long, :description, :options
+
+      def initialize(short, long, description, options = {})
+        @short = short
+        @long = long
+        @description = description
+        @options = options.with_indifferent_access
+      end
+
+      def show_on_usage?
+        options[:usage]
+      end
+    end
+  end
+end

data/lib/eac_cli/runner/boolean_option.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require 'eac_cli/runner/base_option'
+
+module EacCli
+  module Runner
+    class BooleanOption < ::EacCli::Runner::BaseOption
+      def argument?
+        false
+      end
+    end
+  end
+end

data/lib/eac_cli/runner/definition.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require 'eac_cli/runner/argument_option'
+require 'eac_cli/runner/boolean_option'
+require 'eac_cli/runner/positional_argument'
+require 'eac_ruby_utils/core_ext'
+
+module EacCli
+  module Runner
+    class Definition
+      require_sub __FILE__
+      attr_accessor :description
+      attr_accessor :options_argument
+
+      def initialize
+        self.description = '-- NO DESCRIPTION SET --'
+        self.options_argument = true
+      end
+
+      def alt(&block)
+        r = ::EacCli::Runner::Definition.new
+        r.instance_eval(&block)
+        alternatives << r
+        r
+      end
+
+      def alternatives
+        @alternatives ||= []
+      end
+
+      def arg_opt(short, long, description, option_options = {})
+        options << ArgumentOption.new(short, long, description, option_options)
+      end
+
+      def bool_opt(short, long, description, option_options = {})
+        options << BooleanOption.new(short, long, description, option_options)
+      end
+
+      def desc(description)
+        self.description = description
+      end
+
+      def options_arg(options_argument)
+        self.options_argument = options_argument
+      end
+
+      def options
+        @options ||= []
+      end
+
+      def pos_arg(name)
+        positional << PositionalArgument.new(name)
+      end
+
+      def positional
+        @positional ||= []
+      end
+    end
+  end
+end

data/lib/eac_cli/runner/docopt_doc.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+require 'eac_ruby_utils/console/docopt_runner'
+
+module EacCli
+  module Runner
+    class DocoptDoc
+      common_constructor :definition
+
+      SEP = ' '
+      IDENT = SEP * 2
+      OPTION_DESC_SEP = IDENT * 2
+
+      def positional_argument(positional)
+        "<#{positional.name}>"
+      end
+
+      def option_argument(option)
+        option_long(option)
+      end
+
+      def option_definition(option)
+        option.short + SEP + option_long(option) + OPTION_DESC_SEP + option.description
+      end
+
+      def option_long(option)
+        b = option.long
+        b += '=<value>' if option.argument?
+        b
+      end
+
+      def section(header, include_header = true)
+        b = include_header ? "#{header.humanize}:\n" : ''
+        b += send("self_#{header}") + "\n"
+        definition.alternatives.each do |alternative|
+          b += self.class.new(alternative).section(header, false)
+        end
+        b
+      end
+
+      def self_options
+        definition.options.map { |option| IDENT + option_definition(option) }.join("\n")
+      end
+
+      def self_usage
+        b = IDENT + ::EacRubyUtils::Console::DocoptRunner::PROGRAM_MACRO
+        b += "#{SEP}[options]" if definition.options_argument
+        b + self_usage_arguments
+      end
+
+      def self_usage_arguments
+        definition.options.select(&:show_on_usage?)
+                  .map { |option| "#{SEP}#{option_argument(option)}" }.join +
+          definition.positional.map { |p| "#{SEP}#{positional_argument(p)}" }.join
+      end
+
+      def to_s
+        "#{definition.description}\n\n#{section('usage')}\n#{section('options')}\n"
+      end
+    end
+  end
+end

data/lib/eac_cli/runner/positional_argument.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'eac_ruby_utils/core_ext'
+
+module EacCli
+  module Runner
+    class PositionalArgument
+      common_constructor :name
+    end
+  end
+end

data/lib/eac_cli/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module EacCli
+  VERSION = '0.1.0'
+end

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification
+name: eac_cli
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Esquilo Azul Company
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-04-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: eac_ruby_utils
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: eac_ruby_gem_support
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+description: 
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- lib/eac_cli.rb
+- lib/eac_cli/default_runner.rb
+- lib/eac_cli/runner.rb
+- lib/eac_cli/runner/argument_option.rb
+- lib/eac_cli/runner/base_option.rb
+- lib/eac_cli/runner/boolean_option.rb
+- lib/eac_cli/runner/definition.rb
+- lib/eac_cli/runner/docopt_doc.rb
+- lib/eac_cli/runner/positional_argument.rb
+- lib/eac_cli/version.rb
+homepage: 
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.7
+signing_key: 
+specification_version: 4
+summary: Utilities to build CLI applications with Ruby.
+test_files: []