rubysmith 0.16.1 → 1.0.0

data/lib/rubysmith/builders/console.rb

@@ -1,9 +1,13 @@
 # frozen_string_literal: true
 
+require "refinements/structs"
+
 module Rubysmith
   module Builders
     # Builds project skeleton console for object inspection and exploration.
     class Console
+      using Refinements::Structs
+
       def self.call(...) = new(...).call
 
       def initialize configuration, builder: Builder
@@ -12,11 +16,13 @@ module Rubysmith
       end
 
       def call
-        return unless configuration.build_console
+        return configuration unless configuration.build_console
 
-        builder.call(configuration.with(template_path: "%project_name%/bin/console.erb"))
+        builder.call(configuration.merge(template_path: "%project_name%/bin/console.erb"))
                .render
                .permit 0o755
+
+        configuration
       end
 
       private

data/lib/rubysmith/builders/core.rb

@@ -1,9 +1,13 @@
 # frozen_string_literal: true
 
+require "refinements/structs"
+
 module Rubysmith
   module Builders
     # Builds project skeleton core structure and minimum file support.
     class Core
+      using Refinements::Structs
+
       def self.call(...) = new(...).call
 
       def initialize configuration, builder: Builder
@@ -12,14 +16,14 @@ module Rubysmith
       end
 
       def call
-        builder.call(configuration.with(template_path: "%project_name%/lib/%project_path%.rb.erb"))
+        builder.call(configuration.merge(template_path: "%project_name%/lib/%project_path%.rb.erb"))
                .render
                .replace("  require", "require")
                .replace(/    (?=(Zeit|\.tap|\.setup))/, "")
                .replace("\n  \n", "\n\n")
 
-        builder.call(configuration.with(template_path: "%project_name%/.ruby-version.erb")).render
-        nil
+        builder.call(configuration.merge(template_path: "%project_name%/.ruby-version.erb")).render
+        configuration
       end
 
       private

data/lib/rubysmith/builders/documentation/{change.rb → citation.rb}

@@ -1,12 +1,14 @@
 # frozen_string_literal: true
 
-require "tocer"
+require "refinements/structs"
 
 module Rubysmith
   module Builders
     module Documentation
-      # Builds project skeleton CHANGES documentation.
-      class Change
+      # Builds project skeleton citation documentation.
+      class Citation
+        using Refinements::Structs
+
         def self.call(...) = new(...).call
 
         def initialize configuration, builder: Builder
@@ -15,17 +17,15 @@ module Rubysmith
         end
 
         def call
-          return unless configuration.build_changes
+          return configuration unless configuration.build_citation
 
-          builder.call(configuration.with(template_path: "%project_name%/CHANGES.#{kind}.erb"))
-                 .render
+          builder.call(configuration.merge(template_path: "%project_name%/CITATION.cff.erb")).render
+          configuration
         end
 
         private
 
         attr_reader :configuration, :builder
-
-        def kind = configuration.documentation_format || "md"
       end
     end
   end

data/lib/rubysmith/builders/documentation/license.rb

@@ -1,12 +1,15 @@
 # frozen_string_literal: true
 
 require "tocer"
+require "refinements/structs"
 
 module Rubysmith
   module Builders
     module Documentation
       # Builds project skeleton LICENSE documentation.
       class License
+        using Refinements::Structs
+
         def self.call(...) = new(...).call
 
         def initialize configuration, builder: Builder
@@ -15,21 +18,23 @@ module Rubysmith
         end
 
         def call
-          return unless configuration.build_license
+          return configuration unless configuration.build_license
 
-          configuration.with(template_path: "%project_name%/LICENSE-#{license}.#{kind}.erb")
+          configuration.merge(template_path: "%project_name%/LICENSE-#{license}.#{kind}.erb")
                        .then do |updated_configuration|
                          builder.call(updated_configuration).render.rename "LICENSE.#{kind}"
                        end
+
+          configuration
         end
 
         private
 
         attr_reader :configuration, :builder
 
-        def kind = configuration.documentation_format || "md"
+        def kind = configuration.documentation_format
 
-        def license = configuration.documentation_license || "mit"
+        def license = configuration.license_name
       end
     end
   end

data/lib/rubysmith/builders/documentation/readme.rb

@@ -1,43 +1,37 @@
 # frozen_string_literal: true
 
 require "tocer"
+require "refinements/structs"
 
 module Rubysmith
   module Builders
     module Documentation
       # Builds project skeleton README documentation.
       class Readme
+        using Refinements::Structs
+
         def self.call(...) = new(...).call
 
-        def initialize configuration, builder: Builder, tocer: Tocer::Writer.new
+        def initialize configuration, builder: Builder
           @configuration = configuration
           @builder = builder
-          @tocer = tocer
         end
 
         def call
-          return unless configuration.build_readme
+          return configuration unless configuration.build_readme
+
+          builder.call(configuration.merge(template_path: "%project_name%/README.#{kind}.erb"))
+                 .render
+                 .replace(/\n{2,}/, "\n\n")
 
-          private_methods.sort.grep(/render_/).each { |method| __send__ method }
+          configuration
         end
 
         private
 
-        attr_reader :configuration, :builder, :tocer
-
-        def render_content
-          builder.call(configuration.with(template_path: "%project_name%/README.#{kind}.erb"))
-                 .render
-                 .replace("\n\n\n", "\n\n")
-        end
-
-        def render_table_of_contents
-          configuration.project_root
-                       .join("README.md")
-                       .then { |path| tocer.call path if path.exist? }
-        end
+        attr_reader :configuration, :builder
 
-        def kind = configuration.documentation_format || "md"
+        def kind = configuration.documentation_format
       end
     end
   end

data/lib/rubysmith/builders/documentation/{contribution.rb → version.rb}

@@ -1,12 +1,15 @@
 # frozen_string_literal: true
 
 require "tocer"
+require "refinements/structs"
 
 module Rubysmith
   module Builders
     module Documentation
-      # Builds project skeleton CONTRIBUTING documentation.
-      class Contribution
+      # Builds project skeleton version history.
+      class Version
+        using Refinements::Structs
+
         def self.call(...) = new(...).call
 
         def initialize configuration, builder: Builder
@@ -15,17 +18,19 @@ module Rubysmith
         end
 
         def call
-          return unless configuration.build_contributions
+          return configuration unless configuration.build_versions
 
-          builder.call(configuration.with(template_path: "%project_name%/CONTRIBUTING.#{kind}.erb"))
+          builder.call(configuration.merge(template_path: "%project_name%/VERSIONS.#{kind}.erb"))
                  .render
+
+          configuration
         end
 
         private
 
         attr_reader :configuration, :builder
 
-        def kind = configuration.documentation_format || "md"
+        def kind = configuration.documentation_format
       end
     end
   end

data/lib/rubysmith/builders/git/commit.rb

@@ -13,7 +13,7 @@ module Rubysmith
         end
 
         def call
-          return unless configuration.build_git
+          return configuration unless configuration.build_git
 
           builder.call(configuration)
                  .run("git add .", chdir: project_name)
@@ -21,6 +21,8 @@ module Rubysmith
                    %(git commit --all --message "Added project skeleton" --message "#{body}"),
                    chdir: project_name
                  )
+
+          configuration
         end
 
         private

data/lib/rubysmith/builders/git/setup.rb

@@ -13,9 +13,10 @@ module Rubysmith
         end
 
         def call
-          return unless configuration.build_git
+          return configuration unless configuration.build_git
 
           builder.call(configuration).run("git init", chdir: configuration.project_name)
+          configuration
         end
 
         private

data/lib/rubysmith/builders/git_hub.rb

@@ -1,9 +1,13 @@
 # frozen_string_literal: true
 
+require "refinements/structs"
+
 module Rubysmith
   module Builders
     # Builds project skeleton GitHub templates.
     class GitHub
+      using Refinements::Structs
+
       def self.call(...) = new(...).call
 
       def initialize configuration, builder: Builder
@@ -12,10 +16,11 @@ module Rubysmith
       end
 
       def call
-        return unless configuration.build_git_hub
+        return configuration unless configuration.build_git_hub
 
         builder.call(with_issue_template).render
         builder.call(with_pull_request_template).render
+        configuration
       end
 
       private
@@ -23,11 +28,11 @@ module Rubysmith
       attr_reader :configuration, :builder
 
       def with_issue_template
-        configuration.with template_path: "%project_name%/.github/ISSUE_TEMPLATE.md.erb"
+        configuration.merge template_path: "%project_name%/.github/ISSUE_TEMPLATE.md.erb"
       end
 
       def with_pull_request_template
-        configuration.with template_path: "%project_name%/.github/PULL_REQUEST_TEMPLATE.md.erb"
+        configuration.merge template_path: "%project_name%/.github/PULL_REQUEST_TEMPLATE.md.erb"
       end
     end
   end

data/lib/rubysmith/builders/guard.rb

@@ -1,9 +1,13 @@
 # frozen_string_literal: true
 
+require "refinements/structs"
+
 module Rubysmith
   module Builders
     # Builds project skeleton Guard support for a red, green, refactor loop.
     class Guard
+      using Refinements::Structs
+
       def self.call(...) = new(...).call
 
       def initialize configuration, builder: Builder
@@ -12,12 +16,14 @@ module Rubysmith
       end
 
       def call
-        return unless configuration.build_guard
+        return configuration unless configuration.build_guard
 
-        builder.call(configuration.with(template_path: "%project_name%/bin/guard.erb"))
+        builder.call(configuration.merge(template_path: "%project_name%/bin/guard.erb"))
                .render
                .permit 0o755
-        builder.call(configuration.with(template_path: "%project_name%/Guardfile.erb")).render
+
+        builder.call(configuration.merge(template_path: "%project_name%/Guardfile.erb")).render
+        configuration
       end
 
       private

data/lib/rubysmith/builders/rake.rb

@@ -1,9 +1,13 @@
 # frozen_string_literal: true
 
+require "refinements/structs"
+
 module Rubysmith
   module Builders
     # Builds project skeleton Rake support.
     class Rake
+      using Refinements::Structs
+
       def self.call(...) = new(...).call
 
       def initialize configuration, builder: Builder
@@ -12,16 +16,17 @@ module Rubysmith
       end
 
       def call
-        return unless configuration.build_rake
+        return configuration unless configuration.build_rake
 
-        builder.call(configuration.with(template_path: "%project_name%/Rakefile.erb"))
+        builder.call(configuration.merge(template_path: "%project_name%/Rakefile.erb"))
                .render
                .replace(/\[\s+/, "[")
                .replace(/\s+\]/, "]")
                .replace("  ", "")
                .replace(/\n+(?=require)/, "\n")
                .replace(/\n{2,}/, "\n\n")
-        nil
+
+        configuration
       end
 
       private

data/lib/rubysmith/builders/reek.rb

@@ -1,9 +1,13 @@
 # frozen_string_literal: true
 
+require "refinements/structs"
+
 module Rubysmith
   module Builders
     # Builds project skeleton Reek code quality support.
     class Reek
+      using Refinements::Structs
+
       def self.call(...) = new(...).call
 
       def initialize configuration, builder: Builder
@@ -12,9 +16,10 @@ module Rubysmith
       end
 
       def call
-        return unless configuration.build_reek
+        return configuration unless configuration.build_reek
 
-        builder.call(configuration.with(template_path: "%project_name%/.reek.yml.erb")).render
+        builder.call(configuration.merge(template_path: "%project_name%/.reek.yml.erb")).render
+        configuration
       end
 
       private

data/lib/rubysmith/builders/rspec/context.rb

@@ -1,10 +1,14 @@
 # frozen_string_literal: true
 
+require "refinements/structs"
+
 module Rubysmith
   module Builders
     module RSpec
       # Builds RSpec shared context for temporary directories.
       class Context
+        using Refinements::Structs
+
         def self.call(...) = new(...).call
 
         def initialize configuration, builder: Builder
@@ -13,13 +17,15 @@ module Rubysmith
         end
 
         def call
-          return unless configuration.build_rspec
+          return configuration unless configuration.build_rspec
 
           template = "%project_name%/spec/support/shared_contexts/temp_dir.rb.erb"
-          configuration.with(template_path: template)
+          configuration.merge(template_path: template)
                        .then { |updated_configuration| builder.call updated_configuration }
                        .render
                        .replace(/\n\s+\n\s+/, "\n  ")
+
+          configuration
         end
 
         private

data/lib/rubysmith/builders/rspec/helper.rb

@@ -1,10 +1,14 @@
 # frozen_string_literal: true
 
+require "refinements/structs"
+
 module Rubysmith
   module Builders
     module RSpec
       # Builds RSpec spec helper for project skeleton.
       class Helper
+        using Refinements::Structs
+
         def self.call(...) = new(...).call
 
         def initialize configuration, builder: Builder
@@ -13,12 +17,14 @@ module Rubysmith
         end
 
         def call
-          return unless configuration.build_rspec
+          return configuration unless configuration.build_rspec
 
-          builder.call(configuration.with(template_path: "%project_name%/spec/spec_helper.rb.erb"))
+          builder.call(configuration.merge(template_path: "%project_name%/spec/spec_helper.rb.erb"))
                  .render
                  .replace(/\n{3,}/, "\n\n")
                  .replace(/\n\s{2}(?=(require|Simple|using|Pathname|Dir))/, "\n")
+
+          configuration
         end
 
         private

data/lib/rubysmith/builders/rubocop.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require "refinements/structs"
+
+module Rubysmith
+  module Builders
+    # Builds project skeleton with RuboCop code quality support.
+    class Rubocop
+      using Refinements::Structs
+
+      def self.call(...) = new(...).call
+
+      def initialize configuration, builder: Builder
+        @configuration = configuration
+        @builder = builder
+      end
+
+      def call
+        return configuration unless configuration.build_rubocop
+
+        builder.call(configuration.merge(template_path: "%project_name%/bin/rubocop.erb"))
+               .render
+               .permit 0o755
+
+        builder.call(configuration.merge(template_path: "%project_name%/.rubocop.yml.erb")).render
+        configuration
+      end
+
+      private
+
+      attr_reader :configuration, :builder
+    end
+  end
+end

data/lib/rubysmith/builders/setup.rb

@@ -1,9 +1,13 @@
 # frozen_string_literal: true
 
+require "refinements/structs"
+
 module Rubysmith
   module Builders
     # Builds project skeleton setup script.
     class Setup
+      using Refinements::Structs
+
       def self.call(...) = new(...).call
 
       def initialize configuration, builder: Builder
@@ -12,11 +16,13 @@ module Rubysmith
       end
 
       def call
-        return unless configuration.build_setup
+        return configuration unless configuration.build_setup
 
-        builder.call(configuration.with(template_path: "%project_name%/bin/setup.erb"))
+        builder.call(configuration.merge(template_path: "%project_name%/bin/setup.erb"))
                .render
                .permit 0o755
+
+        configuration
       end
 
       private

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

@@ -9,10 +9,9 @@ module Rubysmith
         BUILDERS = [
           Builders::Core,
           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::Bundler,
           Builders::Rake,
@@ -24,24 +23,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