rubysmith 0.9.0 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 35f0eea5be27d1e8a8e05430c6b99d80bfa02bbeabbc6e1148f4c7b388280a26
-  data.tar.gz: ebce4666b017291222012d583ce61266cd15674bf6248199e6cff1700484d4fd
+  metadata.gz: 628bf912ecce44ded950cf18f54d54a3a8ca13430ccc300f7db53062da718716
+  data.tar.gz: cbefec98da88d0e1b6198789805eeed82ea6b5238bee41ca9341c7d6114ed84c
 SHA512:
-  metadata.gz: be592ad7f91f4589ba1aac09b26a7ff875edbc36974559abdae1410e0e41342f08dd5ff24c6517ff63eb87af30491a86115c165c161a39bb3b6453f315230a13
-  data.tar.gz: d245861a8bf50f49541dd9f0aae53007681905eebff6d561ac3a7a9d0fc70ccfa495233fa2f0764cb44313e8f2d0569130ef007e2d63468d587c455e9c3a8035
+  metadata.gz: 4b7bb2b58f60f60057c12e9f9358d720a10fe4825eefcefb8231d4998647c1d44523a550a05a2938b8d16536954ba2cb6f9fa3a4d5a484a0536f24420cb51991
+  data.tar.gz: 315a9e28cd8231629bb17fce77051f0fb42b86c25d1fb04245437333b20171c5b5dc40b1e3cbca33cce6c611761fea3ec31493a6dad2e34c56982a598e66785d

data/README.adoc

@@ -15,8 +15,11 @@ Rubysmith is a command line interface for smithing Ruby projects.
 
 This gem is useful in situations in which you need something more sophisticated than a
 link:https://bundler.io/guides/bundler_in_a_single_file_ruby_script.html[Bundler Inline] script but
-less complicated than a Ruby Gem as provided by
-link:https://www.alchemists.io/projects/gemsmith[Gemsmith].
+less complicated than a link:https://www.alchemists.io/projects/gemsmith[Gemsmith] gem. Rubysmith is
+the foundation of Gemsmith and provides a lot of the same functionality as Gemsmith but solely
+tailored for pure Ruby projects. Again, this is a great tool for spiking quick Ruby implementations,
+sharing code snippets with others, or building full blown Ruby projects for collaboration with
+others.
 
 toc::[]
 
@@ -26,12 +29,12 @@ toc::[]
 * Uses link:https://www.alchemists.io/projects/runcom[Runcom] for resource configuration management.
 * Uses link:https://www.alchemists.io/projects/pragmater[Pragmater] for Ruby source pragma directives.
 * Supports link:https://github.com/amazing-print/amazing_print[Amazing Print].
-* Supports link:https://github.com/rubysec/bundler-audit[Bundler Audit].
 * Supports link:https://github.com/rubymem/bundler-leak[Bundler Leak].
 * Supports link:https://git-scm.com[Git].
 * Supports link:https://www.alchemists.io/projects/git-lint[Git Lint].
 * Supports link:https://github.com/guard/guard[Guard].
 * Supports link:http://pryrepl.org[Pry].
+* Supports link:https://github.com/ruby/rake[Rake].
 * Supports link:https://github.com/troessner/reek[Reek].
 * Supports link:https://www.alchemists.io/projects/refinements[Refinements].
 * Supports link:https://rspec.info[RSpec].
@@ -39,7 +42,6 @@ toc::[]
 * Supports link:https://docs.rubocop.org/rubocop-performance[Rubocop Performance].
 * Supports link:https://github.com/rubocop-hq/rubocop-rake[Rubocop Rake].
 * Supports link:https://github.com/rubocop-hq/rubocop-rspec[Rubocop RSpec].
-* Supports link:https://github.com/whitesmith/RubyCritic[RubyCritic].
 * Supports link:https://github.com/simplecov-ruby/simplecov[SimpleCov].
 * Supports common settings and a structured layout for building projects.
 * Provides common documentation:
@@ -79,28 +81,28 @@ From the command line, type: `rubysmith --help`
 ....
 USAGE:
   -b, --build NAME [options]               Build new project.
-  -v, --version                            Show gem version.
-  -h, --help                               Show this message.
   -c, --config ACTION                      Manage gem configuration: edit or view.
+  -h, --help                               Show this message.
+  -v, --version                            Show gem version.
 
 BUILD OPTIONS:
   --[no-]amazing_print                 Add Amazing Print.
-  --[no-]bundler-audit                 Add Bundler Audit.
   --[no-]bundler-leak                  Add Bundler Leak.
   --[no-]console                       Add console script.
   --[no-]documentation                 Add documentation.
   --[no-]git                           Add Git.
   --[no-]git-lint                      Add Git Lint.
   --[no-]guard                         Add Guard.
+  --min                                Use minimum/no options.
   --[no-]pry                           Add Pry.
+  --[no-]rake                          Add Rake.
   --[no-]reek                          Add Reek.
   --[no-]refinements                   Add Refinements.
   --[no-]rspec                         Add RSpec.
   --[no-]rubocop                       Add Rubocop.
-  --[no-]ruby_critic                   Add RubyCritic.
   --[no-]setup                         Add setup script.
   --[no-]simple_cov                    Add SimpleCov.
-  --min                                Use minimum/no options.
+  --[no-]zeitwerk                      Add Zeitwerk.
 ....
 
 === Building
@@ -161,7 +163,6 @@ The default configuration is as follows:
   :license: "mit"
 :build:
   :amazing_print: true
-  :bundler_audit: true
   :bundler_leak: true
   :console: true
   :documentation: true
@@ -170,13 +171,14 @@ The default configuration is as follows:
   :guard: true
   :minimum: false
   :pry: true
+  :rake: true
   :reek: true
   :refinements: true
   :rspec: true
   :rubocop: true
-  :ruby_critic: true
   :setup: true
   :simple_cov: true
+  :zeitwerk: true
 :builders:
   :pragmater:
     :comments:

data/bin/rubysmith

@@ -2,7 +2,6 @@
 # frozen_string_literal: true
 
 require "rubysmith"
-require "rubysmith/cli/shell"
 
 Process.setproctitle Rubysmith::Identity::VERSION_LABEL
 Rubysmith::CLI::Shell.new.call ARGV

data/lib/rubysmith/builder.rb

@@ -6,7 +6,7 @@ require "logger"
 
 module Rubysmith
   # :reek:TooManyMethods
-  # rubocop:disable Metrics/ClassLength
+  # Provides common functionality necessary for all builders.
   class Builder
     using Refinements::Pathnames
 
@@ -19,12 +19,10 @@ module Rubysmith
       logger: LOGGER
     }.freeze
 
-    def self.call realm, helpers: HELPERS
-      new realm, helpers: helpers
-    end
+    def self.call(...) = new(...)
 
-    def initialize realm, helpers: HELPERS
-      @realm = realm
+    def initialize configuration, helpers: HELPERS
+      @configuration = configuration
       @helpers = helpers
     end
 
@@ -102,7 +100,7 @@ module Rubysmith
 
     private
 
-    attr_reader :realm, :helpers
+    attr_reader :configuration, :helpers
 
     def execute *command
       kernel.capture2e(*command).then do |result, status|
@@ -110,33 +108,23 @@ module Rubysmith
       end
     end
 
-    def inserter
-      helpers.fetch __method__
-    end
+    def inserter = helpers.fetch(__method__)
 
-    def renderer
-      helpers.fetch(__method__).new realm
-    end
+    def renderer = helpers.fetch(__method__).new(configuration)
 
-    def kernel
-      helpers.fetch __method__
-    end
+    def kernel = helpers.fetch(__method__)
 
-    def logger
-      helpers.fetch __method__
-    end
+    def logger = helpers.fetch(__method__)
 
-    def relative_build_path
-      build_path.relative_path_from realm.build_root
-    end
+    def relative_build_path = build_path.relative_path_from(configuration.build_root)
 
     def build_path
-      pathway.end_path.gsub("%project_name%", realm.project_name).sub(".erb", "")
+      pathway.end_path
+             .gsub("%project_name%", configuration.project_name)
+             .sub("%project_path%", configuration.project_path)
+             .sub ".erb", ""
     end
 
-    def pathway
-      realm.to_pathway
-    end
+    def pathway = configuration.to_pathway
   end
-  # rubocop:enable Metrics/ClassLength
 end

data/lib/rubysmith/builders/bundler.rb

@@ -10,33 +10,31 @@ module Rubysmith
     class Bundler
       using Refinements::Pathnames
 
-      def self.call realm, builder: Builder
-        new(realm, builder: builder).call
-      end
+      def self.call(...) = new(...).call
 
-      def initialize realm, builder: Builder, client: ::Bundler::CLI
-        @realm = realm
+      def initialize configuration, builder: Builder, client: ::Bundler::CLI
+        @configuration = configuration
         @builder = builder
         @client = client
       end
 
       def call
-        builder.call(realm.with(template_path: "%project_name%/Gemfile.erb"))
+        builder.call(configuration.with(template_path: "%project_name%/Gemfile.erb"))
                .render
                .replace(/\n\s+group/, "\n\ngroup")
                .replace(/\n\s+gem/, "\n  gem")
-               .replace(/  (?=.+refinements)/, "")
+               .replace(/  (?=.+(refinements|zeitwerk))/, "")
                .replace(/(\n+|\s+)end/, "\nend")
                .replace(/\n\ngroup :(code_quality|test|tools) do\nend/, "")
                .replace(/org"\n+/, "org\"\n\n")
 
-        realm.project_root.change_dir { client.start %w[install --quiet] }
+        configuration.project_root.change_dir { client.start %w[install --quiet] }
         nil
       end
 
       private
 
-      attr_reader :realm, :builder, :client
+      attr_reader :configuration, :builder, :client
     end
   end
 end

data/lib/rubysmith/builders/console.rb

@@ -4,26 +4,24 @@ module Rubysmith
   module Builders
     # Builds project skeleton console for object inspection and exploration.
     class Console
-      def self.call realm, builder: Builder
-        new(realm, builder: builder).call
-      end
+      def self.call(...) = new(...).call
 
-      def initialize realm, builder: Builder
-        @realm = realm
+      def initialize configuration, builder: Builder
+        @configuration = configuration
         @builder = builder
       end
 
       def call
-        return unless realm.build_console
+        return unless configuration.build_console
 
-        builder.call(realm.with(template_path: "%project_name%/bin/console.erb"))
+        builder.call(configuration.with(template_path: "%project_name%/bin/console.erb"))
                .render
                .permit 0o755
       end
 
       private
 
-      attr_reader :realm, :builder
+      attr_reader :configuration, :builder
     end
   end
 end

data/lib/rubysmith/builders/core.rb

@@ -4,24 +4,25 @@ module Rubysmith
   module Builders
     # Builds project skeleton core structure and minimum file support.
     class Core
-      def self.call realm, builder: Builder
-        new(realm, builder: builder).call
-      end
+      def self.call(...) = new(...).call
 
-      def initialize realm, builder: Builder
-        @realm = realm
+      def initialize configuration, builder: Builder
+        @configuration = configuration
         @builder = builder
       end
 
       def call
-        builder.call(realm.with(template_path: "%project_name%/lib/%project_name%.rb.erb")).render
-        builder.call(realm.with(template_path: "%project_name%/.ruby-version.erb")).render
+        builder.call(configuration.with(template_path: "%project_name%/lib/%project_path%.rb.erb"))
+               .render
+               .replace(/  (?!(module|end))/, "")
+
+        builder.call(configuration.with(template_path: "%project_name%/.ruby-version.erb")).render
         nil
       end
 
       private
 
-      attr_reader :realm, :builder
+      attr_reader :configuration, :builder
     end
   end
 end

data/lib/rubysmith/builders/documentation.rb

@@ -4,59 +4,54 @@ module Rubysmith
   module Builders
     # Builds project skeleton documentation.
     class Documentation
-      def self.call realm, builder: Builder
-        new(realm, builder: builder).call
-      end
+      def self.call(...) = new(...).call
 
-      def initialize realm, builder: Builder
-        @realm = realm
+      def initialize configuration, builder: Builder
+        @configuration = configuration
         @builder = builder
       end
 
       def call
-        return unless realm.build_documentation
+        return unless configuration.build_documentation
 
         private_methods.sort.grep(/render_/).each { |method| __send__ method }
       end
 
       private
 
-      attr_reader :realm, :builder
+      attr_reader :configuration, :builder
 
       def render_changes
-        builder.call(realm.with(template_path: "%project_name%/CHANGES.#{kind}.erb"))
+        builder.call(configuration.with(template_path: "%project_name%/CHANGES.#{kind}.erb"))
                .render
       end
 
       def render_conduct
-        builder.call(realm.with(template_path: "%project_name%/CODE_OF_CONDUCT.#{kind}.erb"))
-               .render
+        configuration.with(template_path: "%project_name%/CODE_OF_CONDUCT.#{kind}.erb")
+                     .then { |updated_configuration| builder.call(updated_configuration).render }
       end
 
       def render_contributions
-        builder.call(realm.with(template_path: "%project_name%/CONTRIBUTING.#{kind}.erb"))
+        builder.call(configuration.with(template_path: "%project_name%/CONTRIBUTING.#{kind}.erb"))
                .render
       end
 
       def render_license
-        builder.call(realm.with(template_path: "%project_name%/LICENSE-#{license}.#{kind}.erb"))
-               .render
-               .rename "LICENSE.#{kind}"
+        configuration.with(template_path: "%project_name%/LICENSE-#{license}.#{kind}.erb")
+                     .then do |updated_configuration|
+                       builder.call(updated_configuration).render.rename "LICENSE.#{kind}"
+                     end
       end
 
       def render_readme
-        builder.call(realm.with(template_path: "%project_name%/README.#{kind}.erb"))
+        builder.call(configuration.with(template_path: "%project_name%/README.#{kind}.erb"))
                .render
                .replace("\n\n\n", "\n\n")
       end
 
-      def kind
-        realm.documentation_format || "md"
-      end
+      def kind = configuration.documentation_format || "md"
 
-      def license
-        realm.documentation_license || "mit"
-      end
+      def license = configuration.documentation_license || "mit"
     end
   end
 end

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

@@ -5,19 +5,17 @@ module Rubysmith
     module Git
       # Builds project skeleton initial Git commit message.
       class Commit
-        def self.call realm, builder: Builder
-          new(realm, builder: builder).call
-        end
+        def self.call(...) = new(...).call
 
-        def initialize realm, builder: Builder
-          @realm = realm
+        def initialize configuration, builder: Builder
+          @configuration = configuration
           @builder = builder
         end
 
         def call
-          return unless realm.build_git
+          return unless configuration.build_git
 
-          builder.call(realm)
+          builder.call(configuration)
                  .run("git add .", chdir: project_name)
                  .run(
                    %(git commit --all --message "Added project skeleton" --message "#{body}"),
@@ -27,7 +25,7 @@ module Rubysmith
 
         private
 
-        attr_reader :realm, :builder
+        attr_reader :configuration, :builder
 
         def body
           <<~CONTENT
@@ -36,9 +34,7 @@ module Rubysmith
           CONTENT
         end
 
-        def project_name
-          realm.project_name
-        end
+        def project_name = configuration.project_name
       end
     end
   end

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

@@ -5,24 +5,22 @@ module Rubysmith
     module Git
       # Initializes project skeleton as a Git repository.
       class Setup
-        def self.call realm, builder: Builder
-          new(realm, builder: builder).call
-        end
+        def self.call(...) = new(...).call
 
-        def initialize realm, builder: Builder
-          @realm = realm
+        def initialize configuration, builder: Builder
+          @configuration = configuration
           @builder = builder
         end
 
         def call
-          return unless realm.build_git
+          return unless configuration.build_git
 
-          builder.call(realm).run("git init", chdir: realm.project_name)
+          builder.call(configuration).run("git init", chdir: configuration.project_name)
         end
 
         private
 
-        attr_reader :realm, :builder
+        attr_reader :configuration, :builder
       end
     end
   end