rubysmith 0.16.1 → 1.2.0

data/lib/rubysmith/cli/actions/build.rb

@@ -8,12 +8,13 @@ module Rubysmith
         # Order is important.
         BUILDERS = [
           Builders::Core,
+          Builders::Version,
           Builders::Documentation::Readme,
-          Builders::Documentation::Change,
-          Builders::Documentation::Conduct,
-          Builders::Documentation::Contribution,
+          Builders::Documentation::Citation,
           Builders::Documentation::License,
+          Builders::Documentation::Version,
           Builders::Git::Setup,
+          Builders::Git::Ignore,
           Builders::Bundler,
           Builders::Rake,
           Builders::Console,
@@ -24,24 +25,23 @@ module Rubysmith
           Builders::Reek,
           Builders::RSpec::Context,
           Builders::RSpec::Helper,
-          Builders::Pragma,
-          Builders::Rubocop::Setup,
-          Builders::Rubocop::Formatter,
+          Builders::Rubocop,
+          Extensions::Bundler,
+          Extensions::Pragmater,
+          Extensions::Tocer,
+          Extensions::Rubocop,
           Builders::Git::Commit
         ].freeze
 
-        def initialize builders: BUILDERS, container: Container
+        def initialize builders: BUILDERS
           @builders = builders
-          @container = container
         end
 
-        def call = builders.each { |builder| builder.call configuration }
+        def call(configuration) = builders.each { |builder| builder.call configuration }
 
         private
 
-        attr_reader :builders, :container
-
-        def configuration = container[__method__]
+        attr_reader :configuration, :builders
       end
     end
   end

data/lib/rubysmith/cli/actions/config.rb

@@ -5,7 +5,7 @@ module Rubysmith
     module Actions
       # Handles the config action.
       class Config
-        def initialize client: CLI::Configuration::Loader::CLIENT, container: Container
+        def initialize client: Configuration::Loader::CLIENT, container: Container
           @client = client
           @container = container
         end
@@ -14,7 +14,7 @@ module Rubysmith
           case selection
             when :edit then edit
             when :view then view
-            else fail StandardError, "Invalid configuration selection: #{selection}."
+            else logger.error { "Invalid configuration selection: #{selection}." }
           end
         end
 
@@ -27,6 +27,8 @@ module Rubysmith
         def view = kernel.system("cat #{client.current}")
 
         def kernel = container[__method__]
+
+        def logger = container[__method__]
       end
     end
   end

data/lib/rubysmith/cli/actions/publish.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Rubysmith
+  module CLI
+    module Actions
+      # Handles parsing of Command Line Interface (CLI) publish options.
+      class Publish
+        def initialize extension: Extensions::Milestoner, container: Container
+          @extension = extension
+          @container = container
+        end
+
+        def call(configuration) = extension.call(configuration)
+
+        private
+
+        attr_reader :extension, :container
+      end
+    end
+  end
+end

data/lib/rubysmith/cli/parser.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require "optparse"
+
+module Rubysmith
+  module CLI
+    # Assembles and parses all Command Line Interface (CLI) options.
+    class Parser
+      CLIENT = OptionParser.new nil, 40, "  "
+      SECTIONS = [Parsers::Core, Parsers::Build].freeze # Order is important.
+
+      def initialize sections: SECTIONS, client: CLIENT, container: Container
+        @sections = sections
+        @client = client
+        @configuration = container[:configuration].dup
+      end
+
+      def call arguments = []
+        sections.each { |section| section.call configuration, client: }
+        client.parse arguments
+        configuration.freeze
+      end
+
+      def to_s = client.to_s
+
+      private
+
+      attr_reader :sections, :client, :configuration
+    end
+  end
+end

data/lib/rubysmith/cli/parsers/build.rb

@@ -1,33 +1,43 @@
 # frozen_string_literal: true
 
+require "refinements/structs"
+
 module Rubysmith
   module CLI
     module Parsers
       # Handles parsing of Command Line Interface (CLI) build options.
       class Build
+        using Refinements::Structs
+
         def self.call(...) = new(...).call
 
-        def initialize client: CLIENT, container: Container
+        def initialize configuration = Container[:configuration],
+                       client: Parser::CLIENT,
+                       container: Container
+          @configuration = configuration
           @client = client
           @container = container
         end
 
         def call arguments = []
           client.separator "\nBUILD OPTIONS:\n"
-          private_methods.sort.grep(/add_/).each { |method| __send__ method }
-          arguments.empty? ? arguments : client.parse!(arguments)
+          collate
+          client.parse arguments
+          configuration
         end
 
         private
 
-        attr_reader :client, :container
+        attr_reader :configuration, :client, :container
+
+        def collate = private_methods.sort.grep(/add_/).each { |method| __send__ method }
 
         def add_amazing_print
           client.on(
             "--[no-]amazing_print",
             "Add Amazing Print gem. #{default __method__}."
           ) do |value|
-            configuration.build_amazing_print = value
+            configuration.merge! build_amazing_print: value
           end
         end
 
@@ -36,16 +46,7 @@ module Rubysmith
             "--[no-]bundler-leak",
             "Add Bundler Leak gem. #{default __method__}."
           ) do |value|
-            configuration.build_bundler_leak = value
-          end
-        end
-
-        def add_changes
-          client.on(
-            "--[no-]changes",
-            "Add CHANGES documentation. #{default __method__}."
-          ) do |value|
-            configuration.build_changes = value
+            configuration.merge! build_bundler_leak: value
           end
         end
 
@@ -54,16 +55,16 @@ module Rubysmith
             "--[no-]console",
             "Add console script. #{default __method__}."
           ) do |value|
-            configuration.build_console = value
+            configuration.merge! build_console: value
           end
         end
 
         def add_contributions
           client.on(
             "--[no-]contributions",
-            "Add CONTRIBUTING documentation. #{default __method__}."
+            "Add contributions documentation. #{default __method__}."
           ) do |value|
-            configuration.build_contributions = value
+            configuration.merge! build_contributions: value
           end
         end
 
@@ -72,16 +73,43 @@ module Rubysmith
             "--[no-]circle_ci",
             "Add Circle CI configuration and badge. #{default __method__}."
           ) do |value|
-            configuration.build_circle_ci = value
+            configuration.merge! build_circle_ci: value
+          end
+        end
+
+        def add_citation
+          client.on(
+            "--[no-]citation",
+            "Add citation documentation. #{default __method__}."
+          ) do |value|
+            configuration.merge! build_citation: value
+          end
+        end
+
+        def add_community
+          client.on(
+            "--[no-]community",
+            "Add community documentation. #{default __method__}."
+          ) do |value|
+            configuration.merge! build_community: value
           end
         end
 
         def add_conduct
           client.on(
             "--[no-]conduct",
-            "Add CODE_OF_CONDUCT documentation. #{default __method__}."
+            "Add code of conduct documentation. #{default __method__}."
           ) do |value|
-            configuration.build_conduct = value
+            configuration.merge! build_conduct: value
+          end
+        end
+
+        def add_dead_end
+          client.on(
+            "--[no-]dead_end",
+            "Add Dead End gem. #{default __method__}."
+          ) do |value|
+            configuration.merge! build_dead_end: value
           end
         end
 
@@ -90,7 +118,7 @@ module Rubysmith
             "--[no-]debug",
             "Add Debug gem. #{default __method__}."
           ) do |value|
-            configuration.build_debug = value
+            configuration.merge! build_debug: value
           end
         end
 
@@ -99,7 +127,7 @@ module Rubysmith
             "--[no-]git",
             "Add Git. #{default __method__}."
           ) do |value|
-            configuration.build_git = value
+            configuration.merge! build_git: value
           end
         end
 
@@ -108,7 +136,7 @@ module Rubysmith
             "--[no-]git_hub",
             "Add GitHub templates. #{default __method__}."
           ) do |value|
-            configuration.build_git_hub = value
+            configuration.merge! build_git_hub: value
           end
         end
 
@@ -117,7 +145,7 @@ module Rubysmith
             "--[no-]git-lint",
             "Add Git Lint gem. #{default __method__}."
           ) do |value|
-            configuration.build_git_lint = value
+            configuration.merge! build_git_lint: value
           end
         end
 
@@ -126,16 +154,16 @@ module Rubysmith
             "--[no-]guard",
             "Add Guard gem. #{default __method__}."
           ) do |value|
-            configuration.build_guard = value
+            configuration.merge! build_guard: value
           end
         end
 
         def add_license
           client.on(
             "--[no-]license",
-            "Add LICENSE documentation. #{default __method__}."
+            "Add license documentation. #{default __method__}."
           ) do |value|
-            configuration.build_license = value
+            configuration.merge! build_license: value
           end
         end
 
@@ -143,8 +171,8 @@ module Rubysmith
           client.on(
             "--max",
             "Use maximum/enabled options. #{default __method__}."
-          ) do |value|
-            configuration.maximize.build_maximum = value
+          ) do
+            configuration.merge!(**configuration.maximize.to_h)
           end
         end
 
@@ -152,8 +180,8 @@ module Rubysmith
           client.on(
             "--min",
             "Use minimum/disabled options. #{default __method__}."
-          ) do |value|
-            configuration.minimize.build_minimum = value
+          ) do
+            configuration.merge!(**configuration.minimize.to_h)
           end
         end
 
@@ -162,16 +190,16 @@ module Rubysmith
             "--[no-]rake",
             "Add Rake gem. #{default __method__}."
           ) do |value|
-            configuration.build_rake = value
+            configuration.merge! build_rake: value
           end
         end
 
         def add_readme
           client.on(
             "--[no-]readme",
-            "Add README documentation. #{default __method__}."
+            "Add readme documentation. #{default __method__}."
           ) do |value|
-            configuration.build_readme = value
+            configuration.merge! build_readme: value
           end
         end
 
@@ -180,7 +208,7 @@ module Rubysmith
             "--[no-]reek",
             "Add Reek gem. #{default __method__}."
           ) do |value|
-            configuration.build_reek = value
+            configuration.merge! build_reek: value
           end
         end
 
@@ -189,7 +217,7 @@ module Rubysmith
             "--[no-]refinements",
             "Add Refinements gem. #{default __method__}."
           ) do |value|
-            configuration.build_refinements = value
+            configuration.merge! build_refinements: value
           end
         end
 
@@ -198,16 +226,25 @@ module Rubysmith
             "--[no-]rspec",
             "Add RSpec gem. #{default __method__}."
           ) do |value|
-            configuration.build_rspec = value
+            configuration.merge! build_rspec: value
           end
         end
 
         def add_rubocop
           client.on(
             "--[no-]rubocop",
-            "Add Rubocop gems. #{default __method__}."
+            "Add RuboCop gems. #{default __method__}."
+          ) do |value|
+            configuration.merge! build_rubocop: value
+          end
+        end
+
+        def add_security
+          client.on(
+            "--[no-]security",
+            "Add security. #{default __method__}."
           ) do |value|
-            configuration.build_rubocop = value
+            configuration.merge! build_security: value
           end
         end
 
@@ -216,7 +253,7 @@ module Rubysmith
             "--[no-]setup",
             "Add setup script. #{default __method__}."
           ) do |value|
-            configuration.build_setup = value
+            configuration.merge! build_setup: value
           end
         end
 
@@ -225,7 +262,25 @@ module Rubysmith
             "--[no-]simple_cov",
             "Add SimpleCov gem. #{default __method__}."
           ) do |value|
-            configuration.build_simple_cov = value
+            configuration.merge! build_simple_cov: value
+          end
+        end
+
+        def add_versions
+          client.on(
+            "--[no-]versions",
+            "Add version history. #{default __method__}."
+          ) do |value|
+            configuration.merge! build_versions: value
+          end
+        end
+
+        def add_yard
+          client.on(
+            "--[no-]yard",
+            "Add Yard gem. #{default __method__}."
+          ) do |value|
+            configuration.merge! build_yard: value
           end
         end
 
@@ -234,7 +289,7 @@ module Rubysmith
             "--[no-]zeitwerk",
             "Add Zeitwerk gem. #{default __method__}."
           ) do |value|
-            configuration.build_zeitwerk = value
+            configuration.merge! build_zeitwerk: value
           end
         end
 
@@ -246,8 +301,6 @@ module Rubysmith
                 .then { |colored_boolean| "Default: #{colored_boolean}" }
         end
 
-        def configuration = container[__method__]
-
         def colorizer = container[__method__]
       end
     end

data/lib/rubysmith/cli/parsers/core.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-require "rubysmith/identity"
 require "refinements/structs"
 
 module Rubysmith
@@ -12,21 +11,25 @@ module Rubysmith
 
         def self.call(...) = new(...).call
 
-        def initialize client: CLIENT, container: Container
+        def initialize configuration = Container[:configuration],
+                       client: Parser::CLIENT,
+                       container: Container
+          @configuration = configuration
           @client = client
           @container = container
         end
 
         def call arguments = []
-          client.banner = "#{Identity::LABEL} - #{Identity::SUMMARY}"
+          client.banner = "Rubysmith - #{specification.summary}"
           client.separator "\nUSAGE:\n"
           collate
-          arguments.empty? ? arguments : client.parse!(arguments)
+          client.parse arguments
+          configuration
         end
 
         private
 
-        attr_reader :client, :container
+        attr_reader :configuration, :client, :container
 
         def collate = private_methods.sort.grep(/add_/).each { |method| __send__ method }
 
@@ -35,7 +38,7 @@ module Rubysmith
                     "--config ACTION",
                     %i[edit view],
                     "Manage gem configuration: edit or view." do |action|
-            configuration.action_config = action
+            configuration.merge! action_config: action
           end
         end
 
@@ -45,19 +48,25 @@ module Rubysmith
           end
         end
 
+        def add_publish
+          client.on "-p", "--publish VERSION", "Publish project." do |version|
+            configuration.merge! action_publish: true, project_version: version
+          end
+        end
+
         def add_version
           client.on "-v", "--version", "Show gem version." do
-            configuration.action_version = true
+            configuration.merge! action_version: true
           end
         end
 
         def add_help
           client.on "-h", "--help", "Show this message." do
-            configuration.action_help = true
+            configuration.merge! action_help: true
           end
         end
 
-        def configuration = container[__method__]
+        def specification = container[__method__]
       end
     end
   end

data/lib/rubysmith/cli/shell.rb

@@ -1,43 +1,52 @@
 # frozen_string_literal: true
 
+require "milestoner"
+
 module Rubysmith
   module CLI
     # The main Command Line Interface (CLI) object.
     class Shell
-      ACTIONS = {config: Actions::Config.new, build: Actions::Build.new}.freeze
+      ACTIONS = {
+        config: Actions::Config.new,
+        build: Actions::Build.new,
+        publish: Actions::Publish.new
+      }.freeze
 
-      def initialize parser: Parsers::Assembler.new, actions: ACTIONS, container: Container
+      def initialize parser: Parser.new, actions: ACTIONS, container: Container
         @parser = parser
         @actions = actions
         @container = container
       end
 
       def call arguments = []
-        case parse arguments
-          in action_config: Symbol => action then config action
-          in action_build: true then build
-          in action_version: true then logger.info configuration.version
-          else usage
-        end
+        perform parser.call(arguments)
+      rescue OptionParser::ParseError, Milestoner::Error => error
+        logger.error { error.message }
       end
 
       private
 
       attr_reader :parser, :actions, :container
 
-      def parse arguments = []
-        parser.call arguments
-      rescue StandardError => error
-        logger.error error.message
+      def perform configuration
+        case configuration
+          in action_config: Symbol => action then config action
+          in action_build: true then build configuration
+          in action_publish: true then publish configuration
+          in action_version: true then logger.info { "Rubysmith #{specification.version}" }
+          else usage
+        end
       end
 
       def config(action) = actions.fetch(__method__).call(action)
 
-      def build = actions.fetch(__method__).call
+      def build(configuration) = actions.fetch(__method__).call(configuration)
+
+      def publish(configuration) = actions.fetch(__method__).call(configuration)
 
       def usage = logger.unknown(parser.to_s)
 
-      def configuration = container[__method__]
+      def specification = container[__method__]
 
       def logger = container[__method__]
     end