RubyGems - kettle-dev - Versions diffs - 1.1.10 → 1.1.11 - Mend

kettle-dev 1.1.10 → 1.1.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

checksums.yaml +4 -4
checksums.yaml.gz.sig +0 -0
data/CHANGELOG.md +13 -1
data/README.md +1 -1
data/README.md.example +1 -1
data/Rakefile.example +1 -1
data/exe/kettle-dev-setup +29 -265
data/lib/kettle/dev/setup_cli.rb +252 -0
data/lib/kettle/dev/version.rb +1 -1
data/lib/kettle/dev.rb +1 -0
data/sig/kettle/dev/setup_cli.rbs +8 -0
data.tar.gz.sig +0 -0
metadata +6 -4
metadata.gz.sig +0 -0

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e6cf7cc8f6c3a0d1dfc5f0dbc6da851e122abdad9a284c5835eb7f910214dbe7
-  data.tar.gz: 6ff4d986c36a7eb18e5413e29707c7a78fcfdb048852a16ecc403010963d67d3
+  metadata.gz: 84d3d2f6671ddba20e5cc07cb1b56051e9b6acaf6d3cb1157b8fc2bb3c76bb76
+  data.tar.gz: f962f26bb64d242f670899b45831a66036c4ff1db497702f0446669374f1f580
 SHA512:
-  metadata.gz: 640a7db16fab1bb407eca866f68209f5c354f8ed54fd40b20723ec0a8e3860018b4509891bb9875a2a268a082149c7013bfe0c1426dfe08cdd857c3e057dee8a
-  data.tar.gz: a32860690a84df178fbffddc65ffb14eb257f9481d1efd9cbcb177eb53452ce34493d370a9430c3dc2bdb3a295bd1fc55c584f7b174fcc379e102084166811dd
+  metadata.gz: a6f1fc475a0aa076e614c7c612ba2d6fc06327de919af2c29c01173dc6a7191c25a57a0d8392b2847c75931804b60a5360bcd610c4acac8a42c6ae835f36275f
+  data.tar.gz: d6163488e6f32e9633074faed8d8243f85edf29766871797678e84393a2d2dd575cad9c16ceccc7074a2e149256f2ea5861e4d739ac61381cd34a2a0e488556b

checksums.yaml.gz.sig CHANGED Viewed

Binary file

data/CHANGELOG.md CHANGED Viewed

@@ -24,6 +24,16 @@ Please file a bug if you notice a violation of semantic versioning.
 ### Fixed
 ### Security
+## [1.1.11] - 2025-09-08
+- TAG: [v1.1.11][1.1.11t]
+- COVERAGE: 96.56% -- 3396/3517 lines in 24 files
+- BRANCH COVERAGE: 81.33% -- 1385/1703 branches in 24 files
+- 77.06% documented
+### Changed
+- move kettle-dev-setup logic into Kettle::Dev::SetupCLI
+### Fixed
+- gem dependency detection in kettle-dev-setup to prevent duplication
 ## [1.1.10] - 2025-09-08
 - TAG: [v1.1.10][1.1.10t]
 - COVERAGE: 97.14% -- 3256/3352 lines in 23 files
@@ -571,7 +581,9 @@ Please file a bug if you notice a violation of semantic versioning.
   - Selecting will run the selected workflow via `act`
   - This may move to its own gem in the future.
-[Unreleased]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.10...HEAD
+[Unreleased]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.11...HEAD
+[1.1.11]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.10...v1.1.11
+[1.1.11t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v1.1.11
 [1.1.10]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.9...v1.1.10
 [1.1.10t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v1.1.10
 [1.1.9]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.8...v1.1.9

data/README.md CHANGED Viewed

@@ -907,7 +907,7 @@ Thanks for RTFM. ☺️
 [📌gitmoji]:https://gitmoji.dev
 [📌gitmoji-img]:https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square
 [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
-[🧮kloc-img]: https://img.shields.io/badge/KLOC-3.352-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-3.517-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: SECURITY.md
 [🔐security-img]: https://img.shields.io/badge/security-policy-259D6C.svg?style=flat
 [📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year

data/README.md.example CHANGED Viewed

@@ -507,7 +507,7 @@ Thanks for RTFM. ☺️
 [📌gitmoji]:https://gitmoji.dev
 [📌gitmoji-img]:https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square
 [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
-[🧮kloc-img]: https://img.shields.io/badge/KLOC-3.352-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-3.517-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: SECURITY.md
 [🔐security-img]: https://img.shields.io/badge/security-policy-259D6C.svg?style=flat
 [📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year

data/Rakefile.example CHANGED Viewed

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
-# kettle-dev Rakefile v1.1.10 - 2025-09-08
+# kettle-dev Rakefile v1.1.11 - 2025-09-08
 # Ruby 2.3 (Safe Navigation) or higher required
 #
 # MIT License (see License.txt)

data/exe/kettle-dev-setup CHANGED Viewed

@@ -19,7 +19,7 @@ $stdout.sync = true
 $stderr.sync = true
 script_basename = File.basename(__FILE__)
-running_as_script = File.basename($PROGRAM_NAME)
+File.basename($PROGRAM_NAME)
 begin
   require "kettle/dev"
@@ -31,273 +31,37 @@ rescue StandardError => e
   warn("[kettle-dev-setup] Warning: could not fully load kettle/dev (#{e.class}: #{e.message}). Proceeding with limited features.")
 end
-module Kettle
-  module Dev
-    class SetupCLI
-      def initialize(argv)
-        debug("initialize(argv=#{argv.inspect})")
-        @argv = argv
-        @passthrough = []
-        @options = {}
-        parse!
-      end
+# Always execute when this file is loaded (e.g., via a Bundler binstub).
+# Do not guard with __FILE__ == $PROGRAM_NAME because binstubs use Kernel.load.
+if ARGV.include?("-h") || ARGV.include?("--help")
+  puts <<~USAGE
+    Usage: kettle-dev-setup [options]
-      def run!
-        debug("run!")
-        say("Starting kettle-dev setup…")
-        prechecks!
-        ensure_dev_deps!
-        ensure_bin_setup!
-        ensure_rakefile!
-        run_bin_setup!
-        run_bundle_binstubs!
-        commit_bootstrap_changes!
-        run_kettle_install!
-        say("kettle-dev setup complete.")
-      end
+    Bootstraps a host gem repository to use kettle-dev tooling.
-      private
+    Options (passed through to rake kettle:dev:install):
+      --allowed=VAL
+      --force
+      --hook_templates=VAL
+      --only=VAL
-      def debug(msg)
-        return unless ENV.fetch("DEBUG", "false").casecmp("true").zero?
-        $stderr.puts("[kettle-dev-setup] DEBUG: #{msg}")
-      end
-      def parse!
-        debug("parse! argv_before=#{@argv.inspect}")
-        parser = OptionParser.new do |opts|
-          opts.banner = "Usage: kettle-dev-setup [options]"
-          # Map CLI flags to environment-style assignments for Rake (key=value)
-          opts.on("--allowed=VAL", "Pass through to kettle:dev:install") { |v| @passthrough << "allowed=#{v}" }
-          opts.on("--force", "Pass through to kettle:dev:install") { @passthrough << "force=true" }
-          opts.on("--hook_templates=VAL", "Pass through to kettle:dev:install") { |v| @passthrough << "hook_templates=#{v}" }
-          opts.on("--only=VAL", "Pass through to kettle:dev:install") { |v| @passthrough << "only=#{v}" }
-          opts.on("-h", "--help", "Show help") do
-            puts opts
-            exit(0)
-          end
-        end
-        begin
-          parser.parse!(@argv)
-        rescue OptionParser::ParseError => e
-          warn("[kettle-dev-setup] #{e.class}: #{e.message}")
-          puts parser
-          exit(2)
-        end
-        # Any remaining args pass through as-is
-        @passthrough.concat(@argv)
-        debug("parse! argv_after=#{@argv.inspect} passthrough=#{@passthrough.inspect}")
-      end
-      def say(msg)
-        puts "[kettle-dev-setup] #{msg}"
-      end
-      def abort!(msg)
-        debug("abort!(msg=#{msg.inspect})")
-        raise SystemExit, "[kettle-dev-setup] ERROR: #{msg}"
-      end
-      def sh!(cmd, env: {})
-        debug("sh!(cmd=#{cmd.inspect}, env_keys=#{env.keys.inspect})")
-        say("exec: #{cmd}")
-        stdout_str, stderr_str, status = Open3.capture3(env, cmd)
-        $stdout.print(stdout_str) unless stdout_str.empty?
-        $stderr.print(stderr_str) unless stderr_str.empty?
-        abort!("Command failed: #{cmd}") unless status.success?
-      end
-      # 1. Prechecks
-      def prechecks!
-        debug("prechecks!")
-        abort!("Not inside a git repository (missing .git).") unless Dir.exist?(".git")
-        # 1a. git clean
-        begin
-          # Use GitAdapter if available; otherwise shell out
-          if defined?(Kettle::Dev::GitAdapter)
-            ga = Kettle::Dev::GitAdapter.new
-            dirty = !ga.clean?
-          else
-            stdout, _stderr, _status = Open3.capture3("git status --porcelain")
-            dirty = !stdout.strip.empty?
-          end
-          abort!("Git working tree is not clean. Please commit/stash changes and try again.") if dirty
-        rescue StandardError
-          # Fallback if anything goes wrong: be conservative and require clean tree via shell
-          stdout, _stderr, _status = Open3.capture3("git status --porcelain")
-          abort!("Git working tree is not clean. Please commit/stash changes and try again.") unless stdout.strip.empty?
-        end
-        # 1b. target is a gem (has *.gemspec)
-        gemspecs = Dir["*.gemspec"]
-        abort!("No gemspec found in current directory.") if gemspecs.empty?
-        @gemspec_path = gemspecs.first
-        # 1c. target uses bundler (Gemfile)
-        abort!("No Gemfile found; bundler is required.") unless File.exist?("Gemfile")
-      end
-      # 3. Sync dev dependencies from this gem's example gemspec into target gemspec
-      def ensure_dev_deps!
-        debug("ensure_dev_deps!")
-        source_example = installed_path("kettle-dev.gemspec.example")
-        abort!("Internal error: kettle-dev.gemspec.example not found within the installed gem.") unless source_example && File.exist?(source_example)
-        example = File.read(source_example)
-        example = example.gsub("{KETTLE|DEV|GEM}", "kettle-dev")
-        wanted_lines = example.each_line.map(&:rstrip).select do |line|
-          line =~ /add_development_dependency\s*\(/
-        end
-        return if wanted_lines.empty?
-        target = File.read(@gemspec_path)
-        # Build a map from gem name to the desired line
-        wanted = {}
-        wanted_lines.each do |line|
-          if (m = line.match(/add_development_dependency\s*\(\s*["']([^"']+)["']/))
-            wanted[m[1]] = line
-          end
-        end
-        modified = target.dup
-        wanted.each do |gem_name, desired_line|
-          # Replace existing add_development_dependency for this gem, else append near the end
-          if /add_development_dependency\s*\(\s*["']#{Regexp.escape(gem_name)}["']/ =~ modified
-            modified = modified.gsub(/^[^\n]*add_development_dependency\s*\(\s*["']#{Regexp.escape(gem_name)}["'][^\n]*\)$/) do |_|
-              desired_line
-            end
-          elsif (idx = modified.rindex(/\nend\s*\z/))
-            # Insert before the last end, if present, otherwise append
-            before = modified[0...idx]
-            after = modified[idx..-1]
-            insertion = "\n  #{desired_line.strip}\n"
-            modified = before + insertion + after
-          else
-            modified << "\n#{desired_line}\n"
-          end
-        end
-        if modified != target
-          File.write(@gemspec_path, modified)
-          say("Updated development dependencies in #{@gemspec_path}.")
-        else
-          say("Development dependencies already up to date.")
-        end
-      end
-      # 4. Ensure bin/setup present (copy from gem if missing)
-      def ensure_bin_setup!
-        debug("ensure_bin_setup!")
-        target = File.join("bin", "setup")
-        return say("bin/setup present.") if File.exist?(target)
-        source = installed_path(File.join("bin", "setup"))
-        abort!("Internal error: source bin/setup not found within installed gem.") unless source && File.exist?(source)
-        FileUtils.mkdir_p("bin")
-        FileUtils.cp(source, target)
-        FileUtils.chmod("+x", target)
-        say("Copied bin/setup.")
-      end
-      # 5. Ensure Rakefile matches example (replace or create)
-      def ensure_rakefile!
-        debug("ensure_rakefile!")
-        source = installed_path("Rakefile.example")
-        abort!("Internal error: Rakefile.example not found within installed gem.") unless source && File.exist?(source)
-        content = File.read(source)
-        if File.exist?("Rakefile")
-          say("Replacing existing Rakefile with kettle-dev Rakefile.example.")
-        else
-          say("Creating Rakefile from kettle-dev Rakefile.example.")
-        end
-        File.write("Rakefile", content)
-      end
-      # 6. Run bin/setup
-      def run_bin_setup!
-        debug("run_bin_setup!")
-        sh!(Shellwords.join([File.join("bin", "setup")]))
-      end
-      # 7. Run bundle binstubs --all
-      def run_bundle_binstubs!
-        debug("run_bundle_binstubs!")
-        sh!("bundle exec bundle binstubs --all")
-      end
-      # 8. Stage and commit any changes made by the setup before install
-      def commit_bootstrap_changes!
-        debug("commit_bootstrap_changes!")
-        # Only operate if we are inside a git repo (prechecked earlier), and if dirty
-        dirty = begin
-          if defined?(Kettle::Dev::GitAdapter)
-            !Kettle::Dev::GitAdapter.new.clean?
-          else
-            out, _st = Open3.capture2("git", "status", "--porcelain")
-            !out.strip.empty?
-          end
-        rescue StandardError
-          out, _st = Open3.capture2("git", "status", "--porcelain")
-          !out.strip.empty?
-        end
-        unless dirty
-          say("No changes to commit from template bootstrap.")
-          return
-        end
-        # Stage all changes
-        sh!(Shellwords.join(["git", "add", "-A"]))
-        # Compose commit message exactly as required
-        script_name = File.basename(__FILE__)
-        msg = "🎨 Template bootstrap by #{script_name} v#{Kettle::Dev::Version::VERSION}"
-        # Commit; allow empty to be false (we already detected dirty)
-        sh!(Shellwords.join(["git", "commit", "-m", msg]))
-        say("Committed template bootstrap changes.")
-      end
-      # 9. Run rake kettle:dev:install with passthrough args
-      def run_kettle_install!
-        debug("run_kettle_install! passthrough=#{@passthrough.inspect}")
-        cmd = ["bin/rake", "kettle:dev:install"] + @passthrough
-        sh!(Shellwords.join(cmd))
-      end
-      # Locate files shipped with this gem installation. Handles execution under a checkout as well.
-      def installed_path(rel)
-        debug("installed_path(rel=#{rel.inspect})")
-        # Prefer real gem installation location
-        if defined?(Gem) && (spec = Gem.loaded_specs["kettle-dev"])
-          path = File.join(spec.full_gem_path, rel)
-          return path if File.exist?(path)
-        end
-        # Fallback: relative to this file (useful when running from repo)
-        here = File.expand_path(File.join(__dir__, "..")) # move from exe/ to project root
-        path = File.join(here, rel)
-        return path if File.exist?(path)
-        nil
-      end
-    end
-  end
+    Environment:
+      DEBUG=true                    # print backtraces on errors
+  USAGE
+  exit 0
 end
-if running_as_script == script_basename
-  begin
-    puts "== Kettle::Dev::SetupCLI.new => run! =="
-    Kettle::Dev::SetupCLI.new(ARGV).run!
-  rescue SystemExit => e
-    warn(e.message)
-    exit(e.status || 1)
-  rescue Exception => e
-    warn("[kettle-dev-setup] FATAL: #{e.class}: #{e.message}")
-    if ENV.fetch("DEBUG", "false").casecmp("true").zero?
-      warn(e.backtrace.join("\n"))
-    end
-    exit(1)
-  end
-else
-  puts "== #{script_basename} v#{Kettle::Dev::Version::VERSION} fin (#{running_as_script}) == (#{script_basename}) =="
+begin
+  Kettle::Dev::SetupCLI.new(ARGV).run!
+rescue LoadError => e
+  warn("#{script_basename}: could not load dependency: #{e.class}: #{e.message}")
+  warn(e.backtrace.join("\n")) if ENV["DEBUG"]
+  exit(1)
+rescue SystemExit => e
+  warn("#{script_basename}: exited (status=#{e.status}, msg=#{e.message})") if e.status != 0
+  raise
+rescue StandardError => e
+  warn("#{script_basename}: unexpected error: #{e.class}: #{e.message}")
+  warn(e.backtrace.join("\n")) if ENV["DEBUG"]
+  exit(1)
 end

data/lib/kettle/dev/setup_cli.rb ADDED Viewed

@@ -0,0 +1,252 @@
+# frozen_string_literal: true
+require "fileutils"
+require "shellwords"
+require "open3"
+require "optparse"
+module Kettle
+  module Dev
+    # SetupCLI bootstraps a host gem repository to use kettle-dev tooling.
+    # It performs prechecks, syncs development dependencies, ensures bin/setup and
+    # Rakefile templates, runs setup tasks, and invokes kettle:dev:install.
+    #
+    # Usage:
+    #   Kettle::Dev::SetupCLI.new(ARGV).run!
+    #
+    # Options are parsed from argv and passed through to the rake task as
+    # key=value pairs (e.g., --force => force=true).
+    class SetupCLI
+      # @param argv [Array<String>] CLI arguments
+      def initialize(argv)
+        @argv = argv
+        @passthrough = []
+        @options = {}
+        parse!
+      end
+      # Execute the full setup workflow.
+      # @return [void]
+      def run!
+        say("Starting kettle-dev setup…")
+        prechecks!
+        ensure_dev_deps!
+        ensure_bin_setup!
+        ensure_rakefile!
+        run_bin_setup!
+        run_bundle_binstubs!
+        commit_bootstrap_changes!
+        run_kettle_install!
+        say("kettle-dev setup complete.")
+      end
+      private
+      def debug(msg)
+        return if ENV.fetch("DEBUG", "false").casecmp("true").nonzero?
+        $stderr.puts("[kettle-dev-setup] DEBUG: #{msg}")
+      end
+      def parse!
+        parser = OptionParser.new do |opts|
+          opts.banner = "Usage: kettle-dev-setup [options]"
+          opts.on("--allowed=VAL", "Pass through to kettle:dev:install") { |v| @passthrough << "allowed=#{v}" }
+          opts.on("--force", "Pass through to kettle:dev:install") { @passthrough << "force=true" }
+          opts.on("--hook_templates=VAL", "Pass through to kettle:dev:install") { |v| @passthrough << "hook_templates=#{v}" }
+          opts.on("--only=VAL", "Pass through to kettle:dev:install") { |v| @passthrough << "only=#{v}" }
+          opts.on("-h", "--help", "Show help") do
+            puts opts
+            Kettle::Dev::ExitAdapter.exit(0)
+          end
+        end
+        begin
+          parser.parse!(@argv)
+        rescue OptionParser::ParseError => e
+          warn("[kettle-dev-setup] #{e.class}: #{e.message}")
+          puts parser
+          Kettle::Dev::ExitAdapter.exit(2)
+        end
+        @passthrough.concat(@argv)
+      end
+      def say(msg)
+        puts "[kettle-dev-setup] #{msg}"
+      end
+      def abort!(msg)
+        Kettle::Dev::ExitAdapter.abort("[kettle-dev-setup] ERROR: #{msg}")
+      end
+      def sh!(cmd, env: {})
+        say("exec: #{cmd}")
+        stdout_str, stderr_str, status = Open3.capture3(env, cmd)
+        $stdout.print(stdout_str) unless stdout_str.empty?
+        $stderr.print(stderr_str) unless stderr_str.empty?
+        abort!("Command failed: #{cmd}") unless status.success?
+      end
+      # 1. Prechecks
+      def prechecks!
+        abort!("Not inside a git repository (missing .git).") unless Dir.exist?(".git")
+        # Ensure clean working tree
+        begin
+          if defined?(Kettle::Dev::GitAdapter)
+            dirty = !Kettle::Dev::GitAdapter.new.clean?
+          else
+            stdout, _stderr, _status = Open3.capture3("git status --porcelain")
+            dirty = !stdout.strip.empty?
+          end
+          abort!("Git working tree is not clean. Please commit/stash changes and try again.") if dirty
+        rescue StandardError
+          stdout, _stderr, _status = Open3.capture3("git status --porcelain")
+          abort!("Git working tree is not clean. Please commit/stash changes and try again.") unless stdout.strip.empty?
+        end
+        # gemspec
+        gemspecs = Dir["*.gemspec"]
+        abort!("No gemspec found in current directory.") if gemspecs.empty?
+        @gemspec_path = gemspecs.first
+        # Gemfile
+        abort!("No Gemfile found; bundler is required.") unless File.exist?("Gemfile")
+      end
+      # 3. Sync dev dependencies from this gem's example gemspec into target gemspec
+      def ensure_dev_deps!
+        source_example = installed_path("kettle-dev.gemspec.example")
+        abort!("Internal error: kettle-dev.gemspec.example not found within the installed gem.") unless source_example && File.exist?(source_example)
+        example = File.read(source_example)
+        example = example.gsub("{KETTLE|DEV|GEM}", "kettle-dev")
+        wanted_lines = example.each_line.map(&:rstrip).select { |line| line =~ /add_development_dependency\s*\(?/ }
+        return if wanted_lines.empty?
+        target = File.read(@gemspec_path)
+        # Build gem=>desired line map
+        wanted = {}
+        wanted_lines.each do |line|
+          if (m = line.match(/add_development_dependency\s*\(?\s*["']([^"']+)["']/))
+            wanted[m[1]] = line
+          end
+        end
+        modified = target.dup
+        wanted.each do |gem_name, desired_line|
+          lines = modified.lines
+          found = false
+          lines.map! do |ln|
+            if ln =~ /add_development_dependency\s*\(?\s*["']#{Regexp.escape(gem_name)}["']/
+              found = true
+              indent = ln[/^\s*/] || ""
+              "#{indent}#{desired_line.strip}\n"
+            else
+              ln
+            end
+          end
+          modified = lines.join
+          next if found
+          if (idx = modified.rindex(/\nend\s*\z/))
+            before = modified[0...idx]
+            after = modified[idx..-1]
+            insertion = "\n  #{desired_line.strip}\n"
+            modified = before + insertion + after
+          else
+            modified << "\n#{desired_line}\n"
+          end
+        end
+        if modified != target
+          File.write(@gemspec_path, modified)
+          say("Updated development dependencies in #{@gemspec_path}.")
+        else
+          say("Development dependencies already up to date.")
+        end
+      end
+      # 4. Ensure bin/setup present (copy from gem if missing)
+      def ensure_bin_setup!
+        target = File.join("bin", "setup")
+        return say("bin/setup present.") if File.exist?(target)
+        source = installed_path(File.join("bin", "setup"))
+        abort!("Internal error: source bin/setup not found within installed gem.") unless source && File.exist?(source)
+        FileUtils.mkdir_p("bin")
+        FileUtils.cp(source, target)
+        FileUtils.chmod("+x", target)
+        say("Copied bin/setup.")
+      end
+      # 5. Ensure Rakefile matches example (replace or create)
+      def ensure_rakefile!
+        source = installed_path("Rakefile.example")
+        abort!("Internal error: Rakefile.example not found within installed gem.") unless source && File.exist?(source)
+        content = File.read(source)
+        if File.exist?("Rakefile")
+          say("Replacing existing Rakefile with kettle-dev Rakefile.example.")
+        else
+          say("Creating Rakefile from kettle-dev Rakefile.example.")
+        end
+        File.write("Rakefile", content)
+      end
+      # 6. Run bin/setup
+      def run_bin_setup!
+        sh!(Shellwords.join([File.join("bin", "setup")]))
+      end
+      # 7. Run bundle binstubs --all
+      def run_bundle_binstubs!
+        sh!("bundle exec bundle binstubs --all")
+      end
+      # 8. Commit template bootstrap changes if any
+      def commit_bootstrap_changes!
+        dirty = begin
+          if defined?(Kettle::Dev::GitAdapter)
+            !Kettle::Dev::GitAdapter.new.clean?
+          else
+            out, _st = Open3.capture2("git", "status", "--porcelain")
+            !out.strip.empty?
+          end
+        rescue StandardError
+          out, _st = Open3.capture2("git", "status", "--porcelain")
+          !out.strip.empty?
+        end
+        unless dirty
+          say("No changes to commit from template bootstrap.")
+          return
+        end
+        sh!(Shellwords.join(["git", "add", "-A"]))
+        msg = "🎨 Template bootstrap by kettle-dev-setup v#{Kettle::Dev::Version::VERSION}"
+        sh!(Shellwords.join(["git", "commit", "-m", msg]))
+        say("Committed template bootstrap changes.")
+      end
+      # 9. Invoke rake install task with passthrough
+      def run_kettle_install!
+        cmd = ["bin/rake", "kettle:dev:install"] + @passthrough
+        sh!(Shellwords.join(cmd))
+      end
+      # Resolve a path to files shipped within the gem or repo checkout
+      # @param rel [String]
+      # @return [String, nil]
+      def installed_path(rel)
+        if defined?(Gem) && (spec = Gem.loaded_specs["kettle-dev"])
+          path = File.join(spec.full_gem_path, rel)
+          return path if File.exist?(path)
+        end
+        here = File.expand_path(File.join(__dir__, "..", "..", "..")) # lib/kettle/dev/ -> project root
+        path = File.join(here, rel)
+        return path if File.exist?(path)
+        nil
+      end
+    end
+  end
+end

data/lib/kettle/dev/version.rb CHANGED Viewed

@@ -6,7 +6,7 @@ module Kettle
     module Version
       # The gem version.
       # @return [String]
-      VERSION = "1.1.10"
+      VERSION = "1.1.11"
       module_function

data/lib/kettle/dev.rb CHANGED Viewed

@@ -24,6 +24,7 @@ module Kettle
     autoload :ReadmeBackers, "kettle/dev/readme_backers"
     autoload :ReleaseCLI, "kettle/dev/release_cli"
     autoload :PreReleaseCLI, "kettle/dev/pre_release_cli"
+    autoload :SetupCLI, "kettle/dev/setup_cli"
     autoload :TemplateHelpers, "kettle/dev/template_helpers"
     autoload :Version, "kettle/dev/version"
     autoload :Versioning, "kettle/dev/versioning"

data/sig/kettle/dev/setup_cli.rbs ADDED Viewed

@@ -0,0 +1,8 @@
+module Kettle
+  module Dev
+    class SetupCLI
+      def initialize: (Array[String] argv) -> void
+      def run!: () -> void
+    end
+  end
+end

data.tar.gz.sig CHANGED Viewed

Binary file

metadata CHANGED Viewed

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-dev
 version: !ruby/object:Gem::Version
-  version: 1.1.10
+  version: 1.1.11
 platform: ruby
 authors:
 - Peter H. Boling
@@ -347,6 +347,7 @@ files:
 - lib/kettle/dev/rakelib/yard.rake
 - lib/kettle/dev/readme_backers.rb
 - lib/kettle/dev/release_cli.rb
+- lib/kettle/dev/setup_cli.rb
 - lib/kettle/dev/tasks.rb
 - lib/kettle/dev/tasks/ci_task.rb
 - lib/kettle/dev/tasks/install_task.rb
@@ -369,6 +370,7 @@ files:
 - sig/kettle/dev/pre_release_cli.rbs
 - sig/kettle/dev/readme_backers.rbs
 - sig/kettle/dev/release_cli.rbs
+- sig/kettle/dev/setup_cli.rbs
 - sig/kettle/dev/tasks.rbs
 - sig/kettle/dev/tasks/ci_task.rbs
 - sig/kettle/dev/tasks/install_task.rbs
@@ -381,10 +383,10 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://kettle-dev.galtzo.com/
-  source_code_uri: https://github.com/kettle-rb/kettle-dev/tree/v1.1.10
-  changelog_uri: https://github.com/kettle-rb/kettle-dev/blob/v1.1.10/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-rb/kettle-dev/tree/v1.1.11
+  changelog_uri: https://github.com/kettle-rb/kettle-dev/blob/v1.1.11/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-rb/kettle-dev/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/1.1.10
+  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/1.1.11
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-rb/kettle-dev/wiki
   news_uri: https://www.railsbling.com/tags/kettle-dev

metadata.gz.sig CHANGED Viewed

Binary file