gem_changelog_diff 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c69caa73eea6c508419eff5debb1b5b75bd56edf29140519fb451a433ed67272
-  data.tar.gz: 310b2803925afeb1a107d5805d8f20e681c3257962bb762fcf0db11fb5c78c60
+  metadata.gz: 4c1e8032c69ad427e1469a9620c6df00d3d401e83f939e6fd8c99335fb709fc8
+  data.tar.gz: 9d536f58e4148db45d1de19107cfc28270ab5ce92b892375cf6eae01e3ea5613
 SHA512:
-  metadata.gz: 919f9f8da6bd23c1b2e5210ac0d4bd7f66217f4dd897b735006605858552c757eeffdf962acb23f97ec307fc2c1957964acd787ee9704ccf9061758cde4adb16
-  data.tar.gz: 1808e80f094a1035fc34245dd21a3965fd63a35d794e66c9a66d74b4405deba9fb84e0f15360419561b160a1b21807d82f170141aa2a666060b0d0777f8a7a8b
+  metadata.gz: 8e3c3547a707fa41cf491a35f66288f1fbe8210ee99d7742bcc918a5d9721298d9c75bdbe42bd68a77c5de535f1fe0899fc1beea269291adef2b80e27a9ded9a
+  data.tar.gz: 594f28bb073332585345ae5569c2c1298c4ca705df61ecd81e92f5cfd3c279110f13a5c34c18d543a20c75b7133d84cc011e5756116f331499644991a774ba73

data/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.9.0] - 2026-06-18
+
+### Added
+
+- `rubocop-rspec` plugin for spec linting with targeted cop overrides
+- VCR integration tests with recorded cassettes for rails, nokogiri, puma, and edge cases
+- Integration formatter tests verifying text, JSON, and markdown output against real API data
+- Complete RBS type signatures for all private methods in `GithubClient`, `UriResolver`, and `CLI`
+- `ExitCode` module with `SUCCESS` (0), `ERROR` (1), and `PARTIAL_FAILURE` (2) constants
+- `check` exits with status based on report errors (0 = all ok, 1 = all failed, 2 = partial)
+- `show` exits 0 on success, 1 on error
+- README: exit codes section, concurrency flag docs, CI integration guide
+
 ## [0.8.0] - 2026-06-18
 
 ### Added
@@ -118,7 +131,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.8.0...HEAD
+[Unreleased]: https://github.com/eclectic-coding/gem_changelog_diff/compare/v0.9.0...HEAD
+[0.9.0]: https://github.com/eclectic-coding/gem_changelog_diff/releases/tag/v0.9.0
 [0.8.0]: https://github.com/eclectic-coding/gem_changelog_diff/releases/tag/v0.8.0
 [0.7.0]: https://github.com/eclectic-coding/gem_changelog_diff/releases/tag/v0.7.0
 [0.6.0]: https://github.com/eclectic-coding/gem_changelog_diff/releases/tag/v0.6.0

data/CLAUDE.md

@@ -27,7 +27,7 @@ All feature work lives on `feature/<version>-<scope>` branches (e.g. `feature/0.
 
 ## Code Style
 
-- RuboCop with `rubocop-rake` plugin; double quotes for strings
+- RuboCop with `rubocop-rake` and `rubocop-rspec` plugins; double quotes for strings
 - Target Ruby version: 3.3
 - `frozen_string_literal: true` on all Ruby files
 - `Style/Documentation` is disabled
@@ -37,6 +37,8 @@ All feature work lives on `feature/<version>-<scope>` branches (e.g. `feature/0.
 - RSpec with `--format documentation`
 - SimpleCov for coverage (HTML + JSON output); JSON uploaded to Codecov in CI
 - Coverage filters: `spec/` and `version.rb` excluded; tracks `lib/**/*.rb`
+- VCR integration tests in `spec/integration/` use recorded cassettes from `spec/cassettes/`
+- To re-record cassettes: `GITHUB_TOKEN=ghp_... bundle exec rspec spec/integration/`
 
 ## CI
 

data/README.md

@@ -22,6 +22,8 @@ CLI that shows you the changelog diff for each gem before you `bundle update`, p
   - [Caching](#caching)
   - [Dry Run](#dry-run)
   - [Timeouts](#timeouts)
+  - [Concurrency](#concurrency)
+  - [Exit Codes](#exit-codes)
 - [Configuration File](#configuration-file)
 - [Development](#development)
 - [Contributing](#contributing)
@@ -170,6 +172,51 @@ gem_changelog_diff --timeout 30  # Per-request timeout in seconds (default: 10)
 
 The total operation timeout (default: 120s) limits how long concurrent fetching can run. Both values are configurable via the config file.
 
+### Concurrency
+
+```bash
+gem_changelog_diff --concurrency 8   # Fetch 8 gems in parallel (default: 4)
+gem_changelog_diff --concurrency 1   # Disable concurrent fetching
+```
+
+The concurrency setting controls how many gems are fetched simultaneously using threads. Lower values reduce load on the GitHub API; higher values speed up large projects.
+
+### Exit Codes
+
+The CLI uses defined exit codes for scripting and CI integration:
+
+| Code | Meaning |
+|------|---------|
+| 0 | All gems processed successfully |
+| 1 | Complete failure (all gems failed, or fatal error) |
+| 2 | Some gems succeeded, some failed |
+
+The `check` command sets the exit code based on how many gems produced errors:
+
+```bash
+gem_changelog_diff check
+echo $?  # 0 = all ok, 1 = all failed, 2 = some failed
+```
+
+The `show` command exits 0 on success or 1 if the changelog could not be retrieved:
+
+```bash
+gem_changelog_diff show rails 7.0.8 7.1.3
+echo $?  # 0 = success, 1 = error
+```
+
+#### CI Integration
+
+Use exit codes to control CI behavior:
+
+```bash
+# Fail CI only on complete failure
+gem_changelog_diff check || [ $? -eq 2 ]
+
+# Strict mode: fail on any error
+gem_changelog_diff check
+```
+
 ### Configuration File
 
 Generate a config file template:

data/ROADMAP.md

@@ -2,20 +2,6 @@
 
 Feature roadmap for gem_changelog_diff. Each section is auto-pruned by `bin/release` when that version ships.
 
-## 0.9.0 -- Pre-1.0 Stabilization
-
-Freeze the public API. Harden the test suite. Prepare documentation for stable release.
-
-- Integration test suite with VCR-recorded HTTP fixtures against well-known gems
-- RBS type signatures in `sig/gem_changelog_diff.rbs`
-- Defined exit codes: 0 (success), 1 (error), 2 (partial failure)
-- Add `rubocop-rspec` for spec linting
-- README overhaul with examples for every subcommand and flag
-
-**Dependencies:** `vcr`, `rubocop-rspec` (development)
-
----
-
 ## 1.0.0 -- Stable Release
 
 Public API is frozen. Semantic versioning contract begins.

data/lib/gem_changelog_diff/cli.rb

@@ -34,11 +34,11 @@ module GemChangelogDiff
       gems = filter_gems(detect_gems, gem_names)
       return say("All gems are up to date!") if gems.empty?
 
-      gems = Interactive.new(gems: gems).select if options[:interactive]
+      gems = apply_interactive(gems)
       return say("No gems selected.") if gems.empty?
       return dry_run_output(gems) if options[:dry_run]
 
-      output_results(gems)
+      exit exit_status(output_results(gems))
     end
 
     desc "show GEM FROM_VERSION TO_VERSION", "Show changelog between two versions of a gem"
@@ -48,6 +48,7 @@ module GemChangelogDiff
       report = build_single_report(gem)
       formatter = Formatters.build(format: resolved_format, color: color_enabled?)
       write_output(formatter.format([report]))
+      exit report[:error] ? ExitCode::ERROR : ExitCode::SUCCESS
     end
 
     desc "cache SUBCOMMAND", "Manage the cache"
@@ -220,6 +221,21 @@ module GemChangelogDiff
       reports = with_spinner { build_reports(gems) }
       formatter = Formatters.build(format: resolved_format, color: color_enabled?)
       write_output(formatter.format(reports))
+      reports
+    end
+
+    def apply_interactive(gems)
+      return gems unless options[:interactive]
+
+      Interactive.new(gems: gems).select
+    end
+
+    def exit_status(reports)
+      error_count = reports.count { |r| r[:error] }
+      return ExitCode::SUCCESS if error_count.zero?
+      return ExitCode::ERROR if error_count == reports.size
+
+      ExitCode::PARTIAL_FAILURE
     end
 
     def resolved_format

data/lib/gem_changelog_diff/exit_code.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module GemChangelogDiff
+  module ExitCode
+    SUCCESS         = 0
+    ERROR           = 1
+    PARTIAL_FAILURE = 2
+  end
+end

data/lib/gem_changelog_diff/version.rb

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

data/lib/gem_changelog_diff.rb

@@ -9,6 +9,7 @@ module GemChangelogDiff
 end
 
 require_relative "gem_changelog_diff/errors"
+require_relative "gem_changelog_diff/exit_code"
 require_relative "gem_changelog_diff/cache"
 require_relative "gem_changelog_diff/outdated_gem"
 require_relative "gem_changelog_diff/detector"

data/sig/gem_changelog_diff.rbs

@@ -22,6 +22,12 @@ module GemChangelogDiff
   class NetworkError < Error
   end
 
+  module ExitCode
+    SUCCESS: Integer
+    ERROR: Integer
+    PARTIAL_FAILURE: Integer
+  end
+
   class Configuration
     attr_accessor github_token: String?
     attr_accessor cache_enabled: bool
@@ -119,6 +125,7 @@ module GemChangelogDiff
     def extract_github_slug: (Array[String] uris) -> String?
     def follow_redirects: (String slug, ?Integer remaining) -> String
     def execute_head_request: (URI::Generic uri) -> (Net::HTTPResponse)
+    def extract_slug_from_location: (String? location) -> String?
     def request_headers: () -> Hash[String, String]
   end
 
@@ -204,6 +211,8 @@ module GemChangelogDiff
     private
 
     def fetch_releases: (String repo, ?String? current_version) -> Array[Hash[String, untyped]]
+    def paginate_releases: (String repo, Gem::Version? current) -> Array[Hash[String, untyped]]
+    def fetch_release_page: (String repo, Integer page) -> [(Net::HTTPResponse | CachedResponse), Array[Hash[String, untyped]]]
     def build_releases_uri: (String repo, Integer page) -> URI::Generic
     def next_page?: ((Net::HTTPResponse | CachedResponse) response) -> bool
     def oldest_before_current?: (Array[Hash[String, untyped]] releases, Gem::Version current) -> bool
@@ -309,7 +318,9 @@ module GemChangelogDiff
     def format_dry_run: (Array[OutdatedGem] gems) -> String
     def configure_timeout: () -> void
     def rails_credentials_token: () -> String?
-    def output_results: (Array[OutdatedGem] gems) -> void
+    def apply_interactive: (Array[OutdatedGem] gems) -> Array[OutdatedGem]
+    def output_results: (Array[OutdatedGem] gems) -> Array[gem_report]
+    def exit_status: (Array[gem_report] reports) -> Integer
     def resolved_format: () -> String
     def resolved_concurrency: () -> Integer
     def build_single_report: (OutdatedGem gem) -> gem_report
@@ -325,6 +336,9 @@ module GemChangelogDiff
     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 setup_environment: () -> void
+    def fetch_gem_releases: (OutdatedGem gem, RubygemsClient rubygems_client, SourceResolver source_resolver) -> gem_report
+    def gem_error: (OutdatedGem gem, String message) -> gem_report
     def write_output: (String text) -> void
     def log: (String message) -> void
     def log_warning: (String message) -> void

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gem_changelog_diff
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Chuck Smith
@@ -93,6 +93,7 @@ files:
 - lib/gem_changelog_diff/configuration.rb
 - lib/gem_changelog_diff/detector.rb
 - lib/gem_changelog_diff/errors.rb
+- lib/gem_changelog_diff/exit_code.rb
 - lib/gem_changelog_diff/formatter.rb
 - lib/gem_changelog_diff/formatters/base.rb
 - lib/gem_changelog_diff/formatters/json.rb