gem_changelog_diff 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 05a598faafc36b6f7a81836a1454668ab885425c63f8efa6b019190efc3c1614
-  data.tar.gz: 4f9eeeb3664f4ebde09921007292a2ad1af06caa0a2d738de04e6d6b28b67551
+  metadata.gz: 47e69603bad8c0641ed060fc572632c76d014dcc09f98d75322cafceefa4a1a2
+  data.tar.gz: beb52279aac1a12e5da0e19ce981d5b7bfa497a385130de9a7503cc4ac871742
 SHA512:
-  metadata.gz: 1544e2ec1db09d8dc3f34a7a24e69d55b9f7b7cbd8a5730aaa85faa94778e87de3551686912e0c83554204af3926b4b358eef0b86b5533ad952d8a11a170b88c
-  data.tar.gz: bdfe56aa40447f182fa846015d653570990308a3375d4edb25f8398dcbc5caa90abfbcf4d37383f391a93ba6b446a48f123410fa55e18e4a33fb47ed075d34f7
+  metadata.gz: e5fa45dae9504354720cafa62e7e05768b58de06d1b0376496ba3e38b74b05dc7a23b10b3ca00338acca5e38ce2f29f17495d040d508fe6f14e03515cdf33a02
+  data.tar.gz: 537bea10e8961bff3b2d2c55530afcbe0de4fd0ab422c224b4d7b821edfe264821cb683e3d2a242d29cd551779d15a6c480e4269795347a25f190b59e56e886d

data/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-06-18
+
+### Added
+
+- `Gemfile.lock` parsing via `Bundler::LockfileParser` with RubyGems API version lookup
+- Automatic fallback to lockfile parsing when `bundle outdated` is unavailable
+- `--strategy` flag: `auto` (default), `outdated`, or `lockfile`
+- `--lockfile` flag for custom lockfile path
+- Positional arguments to inspect specific gems: `gem_changelog_diff check rails sidekiq`
+- `--group` flag to filter by Bundler group
+- `--ignore` flag to exclude specific gems
+
 ## [0.3.0] - 2026-06-18
 
 ### Added
@@ -41,7 +53,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Plain text formatter for changelog output
 - Full end-to-end pipeline: detect → lookup → fetch → format
 
-[Unreleased]: https://github.com/eclectic-coding/gem_changelog_diff/compare/v0.3.0...HEAD
+[Unreleased]: https://github.com/eclectic-coding/gem_changelog_diff/compare/v0.4.0...HEAD
+[0.4.0]: https://github.com/eclectic-coding/gem_changelog_diff/releases/tag/v0.4.0
 [0.3.0]: https://github.com/eclectic-coding/gem_changelog_diff/releases/tag/v0.3.0
 [0.2.0]: https://github.com/eclectic-coding/gem_changelog_diff/releases/tag/v0.2.0
 [0.1.0]: https://github.com/eclectic-coding/gem_changelog_diff/releases/tag/v0.1.0

data/README.md

@@ -14,6 +14,8 @@ CLI that shows you the changelog diff for each gem before you `bundle update`, p
 - [Usage](#usage)
   - [GitHub Authentication](#github-authentication)
   - [Output Control](#output-control)
+  - [Detection Strategy](#detection-strategy)
+  - [Filtering](#filtering)
 - [Development](#development)
 - [Contributing](#contributing)
 - [License](#license)
@@ -68,6 +70,23 @@ gem_changelog_diff --no-color  # Disable colored output
 
 The tool also respects the `$NO_COLOR` environment variable.
 
+### Detection Strategy
+
+```bash
+gem_changelog_diff --strategy lockfile   # Parse Gemfile.lock directly
+gem_changelog_diff --strategy outdated   # Use bundle outdated only
+gem_changelog_diff --strategy auto       # Try bundle outdated, fallback to lockfile (default)
+gem_changelog_diff --lockfile path/to/Gemfile.lock  # Custom lockfile path
+```
+
+### Filtering
+
+```bash
+gem_changelog_diff check rails sidekiq  # Only check specific gems
+gem_changelog_diff --group development   # Filter by Bundler group
+gem_changelog_diff --ignore rails rake   # Exclude specific gems
+```
+
 [Back to top](#gemchangelogdiff)
 
 ## Development

data/ROADMAP.md

@@ -2,19 +2,6 @@
 
 Feature roadmap for gem_changelog_diff. Each section is auto-pruned by `bin/release` when that version ships.
 
-## 0.4.0 -- Lockfile Parsing Fallback & Filtering
-
-Support environments where `bundle outdated` is unavailable. Let users narrow which gems to inspect.
-
-- Parse `Gemfile.lock` directly via `Bundler::LockfileParser` and query RubyGems API for latest versions
-- Automatic fallback when `bundle outdated` fails
-- Positional args to inspect specific gems: `gem_changelog_diff check rails sidekiq`
-- `--group`, `--ignore`, `--lockfile`, `--strategy` flags
-
-**New files:** `lockfile_parser.rb`
-
----
-
 ## 0.5.0 -- Caching & Performance
 
 Avoid redundant API calls. Make repeated runs fast on large dependency trees.

data/lib/gem_changelog_diff/cli.rb

@@ -14,11 +14,16 @@ module GemChangelogDiff
     class_option :verbose, type: :boolean, default: false, desc: "Show detailed output"
     class_option :quiet, type: :boolean, default: false, desc: "Suppress warnings"
     class_option :no_color, type: :boolean, default: false, desc: "Disable colored output"
+    class_option :lockfile, type: :string, desc: "Path to Gemfile.lock"
+    class_option :strategy, type: :string, default: "auto", desc: "Detection strategy (auto, outdated, lockfile)"
+    class_option :group, type: :string, desc: "Filter by Bundler group"
+    class_option :ignore, type: :array, desc: "Gems to skip"
 
-    desc "check", "Show changelog diffs for outdated gems"
-    def check
+    desc "check [GEM...]", "Show changelog diffs for outdated gems"
+    def check(*gem_names)
       configure_token
-      gems = Detector.new.detect
+      gems = detect_gems
+      gems = filter_gems(gems, gem_names)
 
       if gems.empty?
         say "All gems are up to date!"
@@ -44,6 +49,39 @@ module GemChangelogDiff
       GemChangelogDiff.configuration.github_token = token if token
     end
 
+    def detect_gems
+      case options[:strategy]
+      when "lockfile"
+        detect_via_lockfile
+      when "outdated"
+        Detector.new(group: options[:group]).detect
+      else
+        detect_with_fallback
+      end
+    end
+
+    def detect_with_fallback
+      Detector.new(group: options[:group]).detect
+    rescue Error
+      log_warning "  bundle outdated failed, falling back to lockfile parsing..."
+      detect_via_lockfile
+    end
+
+    def detect_via_lockfile
+      lockfile_path = options[:lockfile] || "Gemfile.lock"
+      LockfileParser.new.detect(lockfile_path: lockfile_path)
+    end
+
+    def filter_gems(gems, gem_names)
+      gems = gems.select { |g| gem_names.include?(g.name) } if gem_names.any?
+      gems = gems.reject { |g| ignore_list.include?(g.name) } if ignore_list.any?
+      gems
+    end
+
+    def ignore_list
+      @ignore_list ||= options[:ignore] || []
+    end
+
     def build_reports(gems)
       rubygems_client = RubygemsClient.new
       source_resolver = SourceResolver.new

data/lib/gem_changelog_diff/detector.rb

@@ -13,8 +13,15 @@ module GemChangelogDiff
 
     private
 
+    def initialize(group: nil)
+      @group = group
+    end
+
     def run_bundle_outdated
-      output, status = Open3.capture2("bundle", "outdated", "--parseable")
+      cmd = ["bundle", "outdated", "--parseable"]
+      cmd.push("--group", @group) if @group
+
+      output, status = Open3.capture2(*cmd)
       raise Error, "bundle outdated failed (exit #{status.exitstatus})" unless [0, 1].include?(status.exitstatus)
 
       output

data/lib/gem_changelog_diff/lockfile_parser.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require "bundler"
+
+module GemChangelogDiff
+  class LockfileParser
+    def initialize(rubygems_client: RubygemsClient.new)
+      @rubygems_client = rubygems_client
+    end
+
+    def detect(lockfile_path: "Gemfile.lock")
+      content = File.read(lockfile_path)
+      parser = Bundler::LockfileParser.new(content)
+      find_outdated(parser.specs)
+    rescue Errno::ENOENT
+      raise Error, "Lockfile not found: #{lockfile_path}"
+    end
+
+    private
+
+    def find_outdated(specs)
+      specs.filter_map { |spec| check_gem(spec) }
+    end
+
+    def check_gem(spec)
+      latest = @rubygems_client.latest_version(spec.name)
+      return nil unless latest
+
+      latest_version = Gem::Version.new(latest)
+      return nil unless latest_version > spec.version
+
+      OutdatedGem.new(
+        name: spec.name,
+        current_version: spec.version.to_s,
+        newest_version: latest
+      )
+    end
+  end
+end

data/lib/gem_changelog_diff/rubygems_client.rb

@@ -9,19 +9,30 @@ module GemChangelogDiff
     GITHUB_REPO_REGEX = %r{github\.com/([^/]+)/([^/]+)}
 
     def repo_url(gem_name)
+      data = fetch_gem_data(gem_name)
+      return nil unless data
+
+      extract_github_repo(data)
+    end
+
+    def latest_version(gem_name)
+      data = fetch_gem_data(gem_name)
+      data&.dig("version")
+    end
+
+    private
+
+    def fetch_gem_data(gem_name)
       uri = URI(format(RUBYGEMS_API, name: gem_name))
       response = Net::HTTP.get_response(uri)
       return nil unless response.is_a?(Net::HTTPSuccess)
 
-      data = JSON.parse(response.body)
-      extract_github_repo(data)
+      JSON.parse(response.body)
     rescue SocketError, Errno::ECONNREFUSED, Errno::EHOSTUNREACH,
            Net::OpenTimeout, Net::ReadTimeout => e
       raise NetworkError, "RubyGems API request failed: #{e.message}"
     end
 
-    private
-
     def extract_github_repo(data)
       %w[source_code_uri homepage_uri bug_tracker_uri].each do |field|
         url = data[field]

data/lib/gem_changelog_diff/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module GemChangelogDiff
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

data/lib/gem_changelog_diff.rb

@@ -11,6 +11,7 @@ require_relative "gem_changelog_diff/errors"
 require_relative "gem_changelog_diff/outdated_gem"
 require_relative "gem_changelog_diff/detector"
 require_relative "gem_changelog_diff/rubygems_client"
+require_relative "gem_changelog_diff/lockfile_parser"
 require_relative "gem_changelog_diff/github_client"
 require_relative "gem_changelog_diff/changelog_parser"
 require_relative "gem_changelog_diff/source_resolver"

data/sig/gem_changelog_diff.rbs

@@ -37,6 +37,7 @@ module GemChangelogDiff
   class Detector
     PARSEABLE_REGEX: Regexp
 
+    def initialize: (?group: String?) -> void
     def detect: () -> Array[OutdatedGem]
 
     private
@@ -50,12 +51,24 @@ module GemChangelogDiff
     GITHUB_REPO_REGEX: Regexp
 
     def repo_url: (String gem_name) -> String?
+    def latest_version: (String gem_name) -> String?
 
     private
 
+    def fetch_gem_data: (String gem_name) -> Hash[String, untyped]?
     def extract_github_repo: (Hash[String, untyped] data) -> String?
   end
 
+  class LockfileParser
+    def initialize: (?rubygems_client: RubygemsClient) -> void
+    def detect: (?lockfile_path: String) -> Array[OutdatedGem]
+
+    private
+
+    def find_outdated: (Array[untyped] specs) -> Array[OutdatedGem]
+    def check_gem: (untyped spec) -> OutdatedGem?
+  end
+
   type release_hash = {
     tag_name: String,
     name: String?,
@@ -143,6 +156,11 @@ module GemChangelogDiff
 
     def color_enabled?: () -> bool
     def configure_token: () -> void
+    def detect_gems: () -> Array[OutdatedGem]
+    def detect_with_fallback: () -> Array[OutdatedGem]
+    def detect_via_lockfile: () -> Array[OutdatedGem]
+    def filter_gems: (Array[OutdatedGem] gems, Array[String] gem_names) -> Array[OutdatedGem]
+    def ignore_list: () -> Array[String]
     def build_reports: (Array[OutdatedGem] gems) -> Array[gem_report]
     def build_gem_report: (OutdatedGem gem, RubygemsClient rubygems_client, SourceResolver source_resolver) -> gem_report
     def log: (String message) -> void

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gem_changelog_diff
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Chuck Smith
@@ -64,6 +64,7 @@ files:
 - lib/gem_changelog_diff/errors.rb
 - lib/gem_changelog_diff/formatter.rb
 - lib/gem_changelog_diff/github_client.rb
+- lib/gem_changelog_diff/lockfile_parser.rb
 - lib/gem_changelog_diff/outdated_gem.rb
 - lib/gem_changelog_diff/rubygems_client.rb
 - lib/gem_changelog_diff/source_resolver.rb