gemkeeper 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f619f51cc389c49dbd52a00f22a6fc3766822a9d689eaea44d5fcfbb94e5bfe2
-  data.tar.gz: 79e3718a784f510d72156f071551af20bba3c2d9177ed4b9a2e9791917337947
+  metadata.gz: 001a1d05846be989be3ef4c6f4c614f0fc36d8da80f0adaa2cf26998c8664e07
+  data.tar.gz: 3816ebfed535178ac1a26c21d9605feb00860182b6558641436ac060cd3a51dd
 SHA512:
-  metadata.gz: 03ce5eeb1e672cc09815d80a505a0cf2974bbd378c0f3c38245168100a82b59783a45aacd2afb149b0e9814df8ecbd7114fb1eda4738dc8bfa772c5cfa104809
-  data.tar.gz: f26bf3d36e183c2aa7585a36349599092f84347fb45f6325b21c196e37b8893a6102afc7a169efa50a880c408c406ca09a0b80af7e5bd87dbac0b5538960e509
+  metadata.gz: e19335cfccc7d720acc122fed595b9d9115f0fe3bff5d1e29369413df03a4d799a91ce585a211f3b916af6f12aa38fef3b21f59318827a7008106cb0b523876b
+  data.tar.gz: 89832f20c7349469c53b7918fd58c85a43d8988374c321016d520b0e3b93ae567c16ca5d63e0e0bbf3b0a94dd2d5b023cadc359ec38a63e4ed6b89d39420a87e

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 ## [Unreleased]
 
+## [0.6.0] - 2026-05-28
+
+### Added
+
+- `gemkeeper setup` now accepts a directory path and finds `Gemfile.lock` inside it.
+- `gemkeeper setup` now accepts a `Gemfile` path and uses the sibling `Gemfile.lock`.
+- `gemkeeper setup` now works with no arguments by finding the nearest `Gemfile.lock` (walks up from the current directory).
+- `gemkeeper manifest generate` now accepts a directory, `Gemfile` path, or no arguments (same resolution as `setup`).
+
+### Fixed
+
+- `gemkeeper setup` no longer configures a Bundler mirror for a private gem registry when all gems from that source were skipped during manifest resolution.
+- `gemkeeper setup` and `gemkeeper manifest generate` now report a clear error when the resolved source path does not exist.
+- All commands that accept `--config` now report a clear error when the specified config file does not exist, instead of silently using defaults.
+- `gemkeeper server stop` now exits 0 when the server is already stopped; stopping an already-stopped server is not an error.
+
 ## [0.5.0] - 2026-05-27
 
 ### Added
@@ -67,7 +83,8 @@
 
 - Initial release
 
-[Unreleased]: https://github.com/danhorst/gemkeeper/compare/v0.5.0...HEAD
+[Unreleased]: https://github.com/danhorst/gemkeeper/compare/v0.6.0...HEAD
+[0.6.0]: https://github.com/danhorst/gemkeeper/compare/0.5.0...0.6.0
 [0.5.0]: https://github.com/danhorst/gemkeeper/compare/0.4.0...0.5.0
 [0.4.0]: https://github.com/danhorst/gemkeeper/compare/0.3.0...0.4.0
 [0.3.0]: https://github.com/danhorst/gemkeeper/compare/0.2.1...0.3.0

data/README.md

@@ -169,12 +169,21 @@ gemkeeper server status
 # Generate gemkeeper.yml from a Gemfile.lock and org manifest
 gemkeeper setup path/to/Gemfile.lock
 
+# Use an existing gemkeeper.yml as input (updates manifest, optionally installs as global config)
+gemkeeper setup path/to/gemkeeper.yml
+
 # Use a custom manifest path
 gemkeeper setup path/to/Gemfile.lock --manifest ~/.config/myorg/manifest.yml
 
+# Write gemkeeper.yml to a specific path
+gemkeeper setup path/to/Gemfile.lock --config path/to/output.yml
+
 # Overwrite existing gemkeeper.yml entirely
 gemkeeper setup path/to/Gemfile.lock --force
 
+# Skip auto-configuring Bundler mirrors
+gemkeeper setup path/to/Gemfile.lock --skip-bundler-config
+
 # Write to the global Homebrew service config instead of the current directory
 gemkeeper setup path/to/Gemfile.lock --global
 ```
@@ -183,6 +192,31 @@ gemkeeper setup path/to/Gemfile.lock --global
 It sets `repos_path` and `gems_path` as absolute paths under the corresponding `var` directory so the daemon finds them regardless of which directory you run commands from.
 `--global` and `--config` are mutually exclusive.
 
+### Manifest Management
+
+The manifest (`~/.config/gemkeeper/manifest.yml`) is the global name→repo lookup table shared across projects.
+`manifest generate` builds or updates it; `setup` reads it.
+
+```bash
+# Build or update the manifest from a Gemfile.lock
+gemkeeper manifest generate path/to/Gemfile.lock
+
+# Use a custom manifest path
+gemkeeper manifest generate path/to/Gemfile.lock --manifest ~/.config/myorg/manifest.yml
+
+# Overwrite the manifest entirely (discard existing entries)
+gemkeeper manifest generate path/to/Gemfile.lock --force
+
+# Validate the default manifest
+gemkeeper manifest validate
+
+# Validate a specific manifest file
+gemkeeper manifest validate path/to/manifest.yml
+
+# Validate and probe each repo via git ls-remote
+gemkeeper manifest validate --resolve
+```
+
 ### Gem Synchronization
 
 ```bash

data/exe/gemkeeper

@@ -10,4 +10,7 @@ begin
   Dry::CLI.new(Gemkeeper::CLI).call
 rescue SystemExit => e
   exit(ARGV.include?("--help") || ARGV.include?("-h") ? 0 : e.status)
+rescue Gemkeeper::ConfigFileNotFoundError => e
+  warn "Error: #{e.message}"
+  exit 1
 end

data/lib/gemkeeper/cli/commands/manifest/generate.rb

@@ -5,16 +5,19 @@ module Gemkeeper
     module Commands
       module Manifest
         class Generate < Dry::CLI::Command
+          include CLI::LockfileResolution
+
           desc "Build or update the gem manifest from a Gemfile.lock"
 
-          argument :lockfile_path, type: :string, required: true,
-                                   desc: "Path to the project's Gemfile.lock"
+          argument :lockfile_path, type: :string, required: false,
+                                   desc: "Gemfile.lock, Gemfile, or directory (default: nearest Gemfile.lock)"
           option :manifest, type: :string,
                             desc: "Path to write manifest (default: ~/.config/gemkeeper/manifest.yml)"
           option :force, type: :boolean, default: false,
                          desc: "Overwrite existing manifest entirely"
 
-          def call(lockfile_path:, **options)
+          def call(lockfile_path: nil, **options)
+            lockfile_path = resolve_source_path(lockfile_path)
             path = manifest_path(options)
             manifest = ManifestReader.load(path)
             manifest.clear! if options[:force]

data/lib/gemkeeper/cli/commands/server/stop.rb

@@ -15,9 +15,8 @@ module Gemkeeper
             manager.stop
 
             puts "Geminabox server stopped"
-          rescue ServerNotRunningError => error
-            warn "Error: #{error.message}"
-            exit 1
+          rescue ServerNotRunningError
+            puts "Geminabox server is not running"
           rescue ServerError => error
             warn "Error stopping server: #{error.message}"
             exit 1

data/lib/gemkeeper/cli/commands/setup.rb

@@ -4,10 +4,13 @@ module Gemkeeper
   module CLI
     module Commands
       class Setup < Dry::CLI::Command
+        include CLI::LockfileResolution
+
         desc "Generate gemkeeper.yml from a Gemfile.lock or existing gemkeeper.yml"
 
-        argument :source_path, type: :string, required: true,
-                               desc: "Path to a Gemfile.lock or gemkeeper.yml"
+        argument :source_path, type: :string, required: false,
+                               desc: "Gemfile.lock, Gemfile, directory, or gemkeeper.yml " \
+                                     "(default: nearest Gemfile.lock)"
         option :manifest, type: :string,
                           desc: "Path to gem manifest (default: ~/.config/gemkeeper/manifest.yml)"
         option :config, type: :string, desc: "Path to write gemkeeper.yml (default: ./gemkeeper.yml)"
@@ -18,14 +21,15 @@ module Gemkeeper
         option :skip_bundler_config, type: :boolean, default: false,
                                      desc: "Skip configuring Bundler mirrors for private gem sources"
 
-        def call(source_path:, **options)
+        def call(source_path: nil, **options)
           validate_options!(options)
           output_path = resolve_output_path(options)
+          resolved = resolve_source_path(source_path)
 
-          if lockfile?(source_path)
-            setup_from_lockfile(source_path, output_path, options)
+          if lockfile?(resolved)
+            setup_from_lockfile(resolved, output_path, options)
           else
-            setup_from_config(source_path, output_path, options)
+            setup_from_config(resolved, output_path, options)
           end
         rescue UnresolvableGemError, ManifestConflictError => error
           warn "Error: #{error.message}"
@@ -53,7 +57,8 @@ module Gemkeeper
           return if options[:skip_bundler_config]
 
           port = config.fetch("port", Configuration::DEFAULT_PORT)
-          BundlerMirrorConfigurator.new(result.candidates, port:, global: options[:global]).configure
+          resolved = result.candidates.select { |c| result.manifest.repo_for(c[:name]) }
+          BundlerMirrorConfigurator.new(resolved, port:, global: options[:global]).configure
         end
 
         def setup_from_config(source_path, output_path, options)

data/lib/gemkeeper/cli/lockfile_resolution.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Gemkeeper
+  module CLI
+    # Shared path coercion for commands that accept a Gemfile.lock argument.
+    # Accepts nil (find nearest), a directory, a Gemfile path, or an explicit path.
+    module LockfileResolution
+      private
+
+      def resolve_source_path(path)
+        resolved = coerce_source_path(path)
+        File.exist?(resolved) ? resolved : missing_source!(resolved)
+      end
+
+      def coerce_source_path(path)
+        return LockfileParser.find || no_lockfile! if path.nil?
+        return File.join(path, "Gemfile.lock") if File.directory?(path)
+        return File.join(File.dirname(path), "Gemfile.lock") if File.basename(path) == "Gemfile"
+
+        path
+      end
+
+      def no_lockfile!
+        warn "Error: no Gemfile.lock found in #{Dir.pwd} or any parent directory"
+        exit 1
+      end
+
+      def missing_source!(path)
+        warn "Error: file not found — #{path}"
+        exit 1
+      end
+    end
+  end
+end

data/lib/gemkeeper/cli.rb

@@ -12,6 +12,7 @@ module Gemkeeper
   end
 end
 
+require_relative "cli/lockfile_resolution"
 require_relative "cli/commands/version"
 require_relative "cli/commands/setup"
 require_relative "cli/commands/sync"

data/lib/gemkeeper/configuration.rb

@@ -56,6 +56,7 @@ module Gemkeeper
     end
 
     def initialize(config_path = nil)
+      @explicit_config = !config_path.nil?
       @config_path = config_path || find_config_file
       @config = load_config
       apply_config
@@ -91,7 +92,13 @@ module Gemkeeper
     end
 
     def load_config
-      return {} unless @config_path && File.exist?(@config_path)
+      return {} unless @config_path
+
+      unless File.exist?(@config_path)
+        raise ConfigFileNotFoundError, "config file not found — #{@config_path}" if @explicit_config
+
+        return {}
+      end
 
       begin
         YAML.safe_load_file(@config_path, permitted_classes: [], symbolize_names: true) || {}

data/lib/gemkeeper/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Gemkeeper
-  VERSION = "0.5.0"
+  VERSION = "0.6.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gemkeeper
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Dan Brubaker Horst
@@ -106,6 +106,7 @@ files:
 - lib/gemkeeper/cli/commands/setup.rb
 - lib/gemkeeper/cli/commands/sync.rb
 - lib/gemkeeper/cli/commands/version.rb
+- lib/gemkeeper/cli/lockfile_resolution.rb
 - lib/gemkeeper/config_generator.rb
 - lib/gemkeeper/configuration.rb
 - lib/gemkeeper/errors.rb