kettle-family 0.1.4 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b3ec93e3425d765de198975bb390031d33f4a408c31994a18999e3178aec2cee
-  data.tar.gz: c22c0cec6c2dc9a387281adb456d7303bc838e687be27b0c69ecc59b7f8038ae
+  metadata.gz: e59cb730ec2b1f48e8cf47c533677f9c20bb4490004416558015375ddb88c932
+  data.tar.gz: 3450aa12f83fda8e385d9c7e02b6c3c7a735fcaa3ca512690aa9969fd34c8221
 SHA512:
-  metadata.gz: 7520e01212b4faebaed857c69a7bd0c068be891e8fa79c4ccb7485f9cd8fdd4daa824c5943cc030da765992422a1bf252fe76fde2e68b3b4f0feeaf179beb30a
-  data.tar.gz: '0683aae4dfdbbde5b004719856f32b65f7810acd81446145456a7810e4625f85a516f1d53d08d0c1622f65d7d8a2902c0dfb2ff57b35950f19bc76355cdded56'
+  metadata.gz: 68f19eb798c28c122e79e4a74e754e703f456addcf23105eaa940c8b466f233963d10062a9c5c9776fb80d86dac2e19448c88f8d788a4c426d389c8e81b61124
+  data.tar.gz: 7edcb026f774f469066f91972fa60523b8df626d2e50241cf14a966d744dd7c214c1eee7e920b1c5bc2f5f7decf36bde05743cf5da040dc8cd2cbf9997369833

data/CHANGELOG.md

@@ -30,6 +30,23 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [0.1.5] - 2026-06-17
+
+- TAG: [v0.1.5][0.1.5t]
+- COVERAGE: 94.24% -- 1162/1233 lines in 20 files
+- BRANCH COVERAGE: 77.32% -- 358/463 branches in 20 files
+- 39.73% documented
+
+### Added
+
+- Added `kettle-family install` to build and install selected local family gems,
+  including config-defined `install.local_dependencies` resolved relative to the
+  `.kettle-family.yml` file.
+
+### Changed
+
+- Development dependency `kettle-dev` now requires 2.2.10 or newer.
+
 ## [0.1.4] - 2026-06-16
 
 - TAG: [v0.1.4][0.1.4t]
@@ -140,7 +157,9 @@ Please file a bug if you notice a violation of semantic versioning.
 - Fixed CI load failures on engines without compatible `pty` support by falling back to Open3 for interactive release commands.
 - Fixed Ruby 3.2 version-bump support by loading Prism lazily and wiring the Prism gem only for MRI versions that need it.
 
-[Unreleased]: https://github.com/kettle-dev/kettle-family/compare/v0.1.4...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-family/compare/v0.1.5...HEAD
+[0.1.5]: https://github.com/kettle-dev/kettle-family/compare/v0.1.4...v0.1.5
+[0.1.5t]: https://github.com/kettle-dev/kettle-family/releases/tag/v0.1.5
 [0.1.4]: https://github.com/kettle-dev/kettle-family/compare/v0.1.3...v0.1.4
 [0.1.4t]: https://github.com/kettle-dev/kettle-family/releases/tag/v0.1.4
 [0.1.3]: https://github.com/kettle-dev/kettle-family/compare/v0.1.2...v0.1.3

data/README.md

@@ -546,7 +546,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-1.131-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-1.233-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: https://github.com/kettle-dev/kettle-family/blob/main/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/lib/kettle/family/cli.rb

@@ -6,7 +6,7 @@ require "optparse"
 module Kettle
   module Family
     class CLI
-      COMMANDS = %w[discover plan report metadata check test lint docs template bump-version release branch-lanes release-state].freeze
+      COMMANDS = %w[discover plan report metadata check test lint docs template install bump-version release branch-lanes release-state].freeze
       WORKFLOW_COMMANDS = %w[check test lint docs template release].freeze
 
       def self.call(argv, out: $stdout, err: $stderr)
@@ -59,6 +59,7 @@ module Kettle
               lint            Plan or execute configured lint command per member
               docs            Plan or execute configured docs command per member
               template        Plan or execute kettle-jem templating per member
+              install         Build and install selected local family gems
               bump-version    Check, plan, or execute family version alignment
               release         Plan or execute release build/publish phases
               branch-lanes    Audit configured branch lane release mappings
@@ -140,7 +141,9 @@ module Kettle
       def build_report(command, options)
         config = Config.load(root: options[:root], path: options[:config])
         members = Discovery.new(config: config).members
-        ordered = if %w[metadata release-state].include?(command)
+        ordered = if command == "install"
+          install_order(members, config)
+        elsif %w[metadata release-state].include?(command)
           members.sort_by(&:name)
         else
           Orderer.new(members: members, mode: config.order_mode, hints: config.order_hints).ordered
@@ -170,6 +173,7 @@ module Kettle
         return bump_version_results(members: members, options: options) if command == "bump-version"
         return branch_lane_results(config: config, members: members) if command == "branch-lanes"
         return release_state_results(config: config, members: members) if command == "release-state"
+        return install_results(config: config, members: members, options: options) if command == "install"
         return [] unless WORKFLOW_COMMANDS.include?(command)
 
         Workflow.new(
@@ -208,10 +212,21 @@ module Kettle
         BranchLaneAudit.new(config: config, members: members).results
       end
 
+      def install_results(config:, members:, options:)
+        LocalInstall.new(config: config, members: members, execute: options[:execute]).results
+      end
+
       def release_state_results(config:, members:)
         ReleaseStateCheck.new(config: config, members: members).results
       end
 
+      def install_order(members, config)
+        by_name = members.to_h { |member| [member.name, member] }
+        hinted = config.order_hints.filter_map { |name| by_name[name] }
+        hinted_names = hinted.map(&:name)
+        hinted + members.reject { |member| hinted_names.include?(member.name) }.sort_by(&:name)
+      end
+
       def write_report(report, options)
         return unless options[:report]
 

data/lib/kettle/family/config.rb

@@ -168,6 +168,14 @@ module Kettle
         fetch_path("template", "normalize_lockfiles_command") || "bundle lock"
       end
 
+      def install_local_dependencies
+        paths = fetch_path("install", "local_dependencies") || fetch_path("local_dependencies") || []
+        Array(paths).map do |entry|
+          value = entry.is_a?(Hash) ? stringify_keys(entry).fetch("path") : entry
+          expand_config_relative_path(value)
+        end
+      end
+
       def release_build_command
         fetch_path("release", "build_command") || command_for("release_build") || "bundle exec rake build"
       end
@@ -206,6 +214,17 @@ module Kettle
 
       private
 
+      def expand_config_relative_path(value)
+        text = value.to_s
+        return text if text.start_with?("/")
+
+        File.expand_path(text, config_dir)
+      end
+
+      def config_dir
+        path ? File.dirname(path) : root
+      end
+
       def sibling_member_roots
         Dir.children(root)
           .map { |entry| File.join(root, entry) }

data/lib/kettle/family/local_install.rb

@@ -0,0 +1,190 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require "json"
+require "open3"
+require "time"
+
+module Kettle
+  module Family
+    class LocalInstall
+      def initialize(config:, members:, execute: false)
+        @config = config
+        @members = members
+        @execute = execute
+      end
+
+      def results
+        results = install_members.each_with_object([]) do |member, memo|
+          memo << install_member(member)
+          break memo unless memo.last.ok?
+        end
+        write_local_install_marker if execute && results.all?(&:ok?)
+        results
+      end
+
+      private
+
+      attr_reader :config, :members, :execute
+
+      def install_members
+        seen = {}
+        (local_dependency_members + members).each_with_object([]) do |member, memo|
+          next if seen.key?(member.name)
+
+          seen[member.name] = true
+          memo << member
+        end
+      end
+
+      def local_dependency_members
+        config.install_local_dependencies.map { |path| member_from_path(path) }
+      end
+
+      def member_from_path(path)
+        gemspec = gemspec_path(path)
+        spec = load_gemspec(gemspec)
+        Member.new(
+          name: spec.name,
+          root: File.dirname(gemspec),
+          gemspec_path: gemspec,
+          version_file: version_file(File.dirname(gemspec)),
+          version: spec.version.to_s,
+          dependencies: spec.dependencies.map(&:name).sort,
+          required_ruby_version: required_ruby_version(spec),
+          licenses: Array(spec.licenses),
+          authors: Array(spec.authors)
+        )
+      end
+
+      def gemspec_path(path)
+        expanded = File.expand_path(path)
+        return expanded if File.file?(expanded) && File.extname(expanded) == ".gemspec"
+
+        raise Error, "install local dependency does not exist: #{path}" unless Dir.exist?(expanded)
+
+        gemspecs = Dir.glob(File.join(expanded, "*.gemspec"))
+        raise Error, "no gemspec found for install local dependency: #{path}" if gemspecs.empty?
+        raise Error, "multiple gemspecs found for install local dependency: #{path}" if gemspecs.size > 1
+
+        gemspecs.first
+      end
+
+      def load_gemspec(path)
+        # Some gemspecs use root-relative loads.
+        # rubocop:disable ThreadSafety/DirChdir
+        spec = Dir.chdir(File.dirname(path)) { Gem::Specification.load(path) }
+        # rubocop:enable ThreadSafety/DirChdir
+        raise Error, "could not load gemspec #{path}" unless spec
+
+        spec
+      rescue => error
+        raise Error, "could not load gemspec #{path}: #{error.message}"
+      end
+
+      def version_file(root)
+        Dir.glob(File.join(root, "lib", "**", "version.rb")).min
+      end
+
+      def required_ruby_version(spec)
+        value = spec.required_ruby_version&.to_s&.strip
+        value.empty? ? nil : value
+      end
+
+      def install_member(member)
+        gem_path = local_gem_path(member)
+        argv = install_argv(gem_path)
+        return skipped_result(member: member, argv: argv) unless execute
+
+        FileUtils.mkdir_p(File.dirname(gem_path))
+        FileUtils.rm_f(gem_path)
+        build_stdout, build_stderr, build_status = run(build_argv(member, gem_path), chdir: member.root)
+        return failed_result(member: member, argv: build_argv(member, gem_path), stdout: build_stdout, stderr: build_stderr, status: build_status) unless build_status.success?
+
+        stdout, stderr, status = run(argv)
+        CommandResult.new(
+          member_name: member.name,
+          phase: "install",
+          command: argv,
+          workdir: member.root,
+          status: status.exitstatus,
+          success: status.success?,
+          stdout: build_stdout + stdout,
+          stderr: build_stderr + stderr,
+          elapsed_seconds: 0.0,
+          skipped: false,
+          reason: status.success? ? nil : "command failed"
+        )
+      end
+
+      def run(argv, chdir: nil)
+        env = {"SKIP_GEM_SIGNING" => "true"}
+        chdir ? Open3.capture3(env, *argv, chdir: chdir) : Open3.capture3(env, *argv)
+      end
+
+      def local_gem_path(member)
+        File.join(member.root, "tmp", "local-gem-install", "#{member.name}-#{member.version}.gem")
+      end
+
+      def build_argv(member, gem_path)
+        ["gem", "build", member.gemspec_path, "--output", gem_path]
+      end
+
+      def install_argv(gem_path)
+        ["gem", "install", "--force", "--no-document", "--local", "--ignore-dependencies", gem_path]
+      end
+
+      def skipped_result(member:, argv:)
+        CommandResult.new(
+          member_name: member.name,
+          phase: "install",
+          command: argv,
+          workdir: member.root,
+          status: nil,
+          success: true,
+          stdout: "",
+          stderr: "",
+          elapsed_seconds: 0.0,
+          skipped: true,
+          reason: "dry-run; pass --execute to run"
+        )
+      end
+
+      def failed_result(member:, argv:, stdout:, stderr:, status:)
+        CommandResult.new(
+          member_name: member.name,
+          phase: "install",
+          command: argv,
+          workdir: member.root,
+          status: status.exitstatus,
+          success: false,
+          stdout: stdout,
+          stderr: stderr,
+          elapsed_seconds: 0.0,
+          skipped: false,
+          reason: "command failed"
+        )
+      end
+
+      def write_local_install_marker
+        FileUtils.mkdir_p(File.dirname(local_install_marker_path))
+        File.write(local_install_marker_path, JSON.pretty_generate(local_install_marker))
+      end
+
+      def local_install_marker
+        {
+          "family" => config.family_name,
+          "root" => config.root,
+          "members_root" => config.members_root,
+          "local_dependencies" => config.install_local_dependencies,
+          "installed_members" => install_members.map(&:name),
+          "installed_at" => Time.now.utc.iso8601
+        }
+      end
+
+      def local_install_marker_path
+        File.join(Dir.home, ".kettle-family", "local-install.json")
+      end
+    end
+  end
+end

data/lib/kettle/family/version.rb

@@ -3,7 +3,7 @@
 module Kettle
   module Family
     module Version
-      VERSION = "0.1.4"
+      VERSION = "0.1.5"
     end
     VERSION = Version::VERSION # Traditional Constant Location
   end

data/lib/kettle/family.rb

@@ -13,6 +13,7 @@ require_relative "family/git_status"
 require_relative "family/version_bump"
 require_relative "family/branch_lane_audit"
 require_relative "family/release_state_check"
+require_relative "family/local_install"
 require_relative "family/workflow"
 require_relative "family/config"
 require_relative "family/discovery"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-family
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
 platform: ruby
 authors:
 - Peter H. Boling
@@ -80,7 +80,7 @@ dependencies:
         version: '2.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.2.9
+        version: 2.2.10
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -90,7 +90,7 @@ dependencies:
         version: '2.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.2.9
+        version: 2.2.10
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -291,6 +291,7 @@ files:
 - lib/kettle/family/config.rb
 - lib/kettle/family/discovery.rb
 - lib/kettle/family/git_status.rb
+- lib/kettle/family/local_install.rb
 - lib/kettle/family/member.rb
 - lib/kettle/family/orderer.rb
 - lib/kettle/family/readiness_check.rb
@@ -308,10 +309,10 @@ licenses:
 - AGPL-3.0-only
 metadata:
   homepage_uri: https://kettle-family.galtzo.com
-  source_code_uri: https://github.com/kettle-dev/kettle-family/tree/v0.1.4
-  changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v0.1.4/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-family/tree/v0.1.5
+  changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v0.1.5/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-family/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-family/0.1.4
+  documentation_uri: https://www.rubydoc.info/gems/kettle-family/0.1.5
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-dev/kettle-family/wiki
   news_uri: https://www.railsbling.com/tags/kettle-family