gem_changelog_diff 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f774074fe0186c0efa8cd2aef588301c81441f20de1c1b75cd64e0da40bdcb0a
-  data.tar.gz: cca9f1421c6e505a7b137727e8948e3d5fa7749c226e6e43c51fcd29d1781a2c
+  metadata.gz: 157c1e084602c25e10cec4fde2c24b1999a9894ebe1232901cb9536bae50f33b
+  data.tar.gz: aa0be940c412f3b1a9b3ee08190d8a6e64ad0bed9cf1b2011979650b87264640
 SHA512:
-  metadata.gz: cfe4e6aadaa4310be3a007ed61ae85d0a3aad6938599030b9914f35f41b066e9ed04cef679762faedfc8ebd406156c45688e13f84864645e9168aa73eaf22a54
-  data.tar.gz: 76f9ea402f5cab49fbe8ecf9466ee73fc633e4a3a35c8dc77aee54fe79763cacd40f775c039c1cde51f8e8f49efbe8cebaa8420da6d7cac549097f4f18a2a85a
+  metadata.gz: 0714bc35cee74f49ac0b09cda00e58b931c90a9f0a7688e122f5c8f2c790aedd269244d6e5a0af2dd538a33e8a91e2f8024b313f2c94b6227a4b3fa6901a160c
+  data.tar.gz: 8fb0ab418ac9c7e42adfd240360594ef1134536fe9ffa04a2dad8052d3355620d79d224b8f4342336bf853875ac60491ed6968ad8d105860dd770bccb6682fae

data/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-06-17
+
+### Added
+
+- GitHub personal access token support via `--token` flag or `GITHUB_TOKEN` env var
+- `Configuration` singleton for managing runtime settings
+- Custom error hierarchy: `RepoNotFoundError`, `GitHubAPIError`, `RateLimitError`, `NetworkError`
+- Graceful degradation: failed gems are skipped with a warning instead of aborting
+- Rate limit awareness: warns when GitHub API requests remaining drops below 10
+- `--verbose` flag for detailed status output
+- `--quiet` flag to suppress warnings
+
 ## [0.1.0] - 2026-06-17
 
 ### Added
@@ -18,3 +30,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - GitHub API client to fetch releases between locked and latest versions
 - 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.2.0...HEAD
+[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

@@ -35,6 +35,24 @@ gem_changelog_diff version    # Print version
 gem_changelog_diff --version  # Same as above
 ```
 
+### GitHub Authentication
+
+To avoid the 60 requests/hour unauthenticated rate limit, provide a GitHub personal access token:
+
+```bash
+gem_changelog_diff --token ghp_your_token
+# or
+export GITHUB_TOKEN=ghp_your_token
+gem_changelog_diff
+```
+
+### Output Control
+
+```bash
+gem_changelog_diff --verbose  # Show detailed status messages
+gem_changelog_diff --quiet    # Suppress warnings
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.

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.2.0 -- Error Handling & GitHub Authentication
-
-Handle real-world failures and unblock power users hitting the 60 req/hr unauthenticated rate limit.
-
-- GitHub personal access token via `--token` flag or `GITHUB_TOKEN` env var
-- Custom error hierarchy (`RepoNotFoundError`, `GitHubAPIError`, `RateLimitError`, `NetworkError`)
-- Graceful degradation: skip failed gems with a warning, do not abort the run
-- Rate limit awareness: read `X-RateLimit-Remaining` headers, warn when approaching the limit
-- `--verbose` and `--quiet` flags
-
-**New files:** `errors.rb`, `configuration.rb`
-
----
-
 ## 0.3.0 -- CHANGELOG.md Fallback & Colored Output
 
 Many gems do not use GitHub Releases. Fall back to parsing CHANGELOG.md from the repository.

data/lib/gem_changelog_diff/cli.rb

@@ -10,8 +10,13 @@ module GemChangelogDiff
 
     default_task :check
 
+    class_option :token, type: :string, desc: "GitHub personal access token"
+    class_option :verbose, type: :boolean, default: false, desc: "Show detailed output"
+    class_option :quiet, type: :boolean, default: false, desc: "Suppress warnings"
+
     desc "check", "Show changelog diffs for outdated gems"
     def check
+      configure_token
       gems = Detector.new.detect
 
       if gems.empty?
@@ -32,6 +37,11 @@ module GemChangelogDiff
 
     private
 
+    def configure_token
+      token = options[:token] || ENV.fetch("GITHUB_TOKEN", nil)
+      GemChangelogDiff.configuration.github_token = token if token
+    end
+
     def build_reports(gems)
       rubygems_client = RubygemsClient.new
       github_client = GithubClient.new
@@ -40,11 +50,24 @@ module GemChangelogDiff
     end
 
     def build_gem_report(gem, rubygems_client, github_client)
+      log "Checking #{gem.name}..."
       repo = rubygems_client.repo_url(gem.name)
       return { gem: gem, releases: [], error: "  Could not find GitHub repository." } if repo.nil?
 
+      log "  Found repo: #{repo}"
       releases = github_client.releases_between(repo, gem.current_version, gem.newest_version)
       { gem: gem, releases: releases }
+    rescue GemChangelogDiff::Error => e
+      log_warning "  Skipping #{gem.name}: #{e.message}"
+      { gem: gem, releases: [], error: "  #{e.message}" }
+    end
+
+    def log(message)
+      warn message if options[:verbose]
+    end
+
+    def log_warning(message)
+      warn message unless options[:quiet]
     end
   end
 end

data/lib/gem_changelog_diff/configuration.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module GemChangelogDiff
+  class Configuration
+    attr_accessor :github_token
+  end
+
+  def self.configuration
+    @configuration ||= Configuration.new
+  end
+
+  def self.configure
+    yield(configuration)
+  end
+
+  def self.reset_configuration!
+    @configuration = Configuration.new
+  end
+end

data/lib/gem_changelog_diff/errors.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module GemChangelogDiff
+  class RepoNotFoundError < Error; end
+  class GitHubAPIError < Error; end
+  class RateLimitError < GitHubAPIError; end
+  class NetworkError < Error; end
+end

data/lib/gem_changelog_diff/github_client.rb

@@ -7,6 +7,7 @@ module GemChangelogDiff
   class GithubClient
     RELEASES_URL = "https://api.github.com/repos/%<repo>s/releases"
     TAG_VERSION_REGEX = /\Av?(\d+\..+)\z/
+    RATE_LIMIT_WARNING_THRESHOLD = 10
 
     def releases_between(repo, current_version, newest_version)
       releases = fetch_releases(repo)
@@ -19,19 +20,47 @@ module GemChangelogDiff
       uri = URI(format(RELEASES_URL, repo: repo))
       uri.query = URI.encode_www_form(per_page: 30)
 
+      response = execute_request(uri)
+      check_rate_limit(response)
+      handle_response(response)
+    rescue SocketError, Errno::ECONNREFUSED, Errno::EHOSTUNREACH,
+           Net::OpenTimeout, Net::ReadTimeout => e
+      raise NetworkError, "GitHub API request failed: #{e.message}"
+    end
+
+    def execute_request(uri)
       request = Net::HTTP::Get.new(uri)
       request["Accept"] = "application/vnd.github.v3+json"
       request["User-Agent"] = "gem_changelog_diff/#{VERSION}"
+      apply_auth(request)
+
+      Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
+    end
+
+    def apply_auth(request)
+      token = GemChangelogDiff.configuration.github_token
+      request["Authorization"] = "token #{token}" if token
+    end
+
+    def handle_response(response)
+      return [] if response.code == "404"
 
-      response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
-        http.request(request)
+      if response.code == "403" && response["X-RateLimit-Remaining"] == "0"
+        raise RateLimitError, "GitHub API rate limit exceeded. Use --token to authenticate."
       end
 
-      return [] unless response.is_a?(Net::HTTPSuccess)
+      raise GitHubAPIError, "GitHub API error (HTTP #{response.code})" unless response.is_a?(Net::HTTPSuccess)
 
       JSON.parse(response.body)
     end
 
+    def check_rate_limit(response)
+      remaining = response["X-RateLimit-Remaining"]&.to_i
+      return if remaining.nil? || remaining >= RATE_LIMIT_WARNING_THRESHOLD
+
+      warn "Warning: GitHub API rate limit low (#{remaining} requests remaining). Use --token to authenticate."
+    end
+
     def filter_releases(releases, current_version, newest_version)
       current = Gem::Version.new(current_version)
       newest = Gem::Version.new(newest_version)

data/lib/gem_changelog_diff/rubygems_client.rb

@@ -15,6 +15,9 @@ module GemChangelogDiff
 
       data = JSON.parse(response.body)
       extract_github_repo(data)
+    rescue SocketError, Errno::ECONNREFUSED, Errno::EHOSTUNREACH,
+           Net::OpenTimeout, Net::ReadTimeout => e
+      raise NetworkError, "RubyGems API request failed: #{e.message}"
     end
 
     private

data/lib/gem_changelog_diff/version.rb

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

data/lib/gem_changelog_diff.rb

@@ -1,13 +1,16 @@
 # frozen_string_literal: true
 
 require_relative "gem_changelog_diff/version"
+require_relative "gem_changelog_diff/configuration"
+
+module GemChangelogDiff
+  class Error < StandardError; end
+end
+
+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/github_client"
 require_relative "gem_changelog_diff/formatter"
 require_relative "gem_changelog_diff/cli"
-
-module GemChangelogDiff
-  class Error < StandardError; end
-end

data/sig/gem_changelog_diff.rbs

@@ -1,9 +1,31 @@
 module GemChangelogDiff
   VERSION: String
 
+  self.@configuration: Configuration
+
+  def self.configuration: () -> Configuration
+  def self.configure: () { (Configuration) -> void } -> void
+  def self.reset_configuration!: () -> Configuration
+
   class Error < StandardError
   end
 
+  class RepoNotFoundError < Error
+  end
+
+  class GitHubAPIError < Error
+  end
+
+  class RateLimitError < GitHubAPIError
+  end
+
+  class NetworkError < Error
+  end
+
+  class Configuration
+    attr_accessor github_token: String?
+  end
+
   class OutdatedGem
     attr_reader name: String
     attr_reader current_version: String
@@ -50,6 +72,10 @@ module GemChangelogDiff
     private
 
     def fetch_releases: (String repo) -> Array[Hash[String, untyped]]
+    def execute_request: (URI::Generic uri) -> Net::HTTPResponse
+    def apply_auth: (Net::HTTPRequest request) -> void
+    def handle_response: (Net::HTTPResponse response) -> Array[Hash[String, untyped]]
+    def check_rate_limit: (Net::HTTPResponse response) -> void
     def filter_releases: (Array[Hash[String, untyped]] releases, String current_version, String newest_version) -> Array[release_hash]
     def build_release: (Hash[String, untyped] release, Gem::Version current, Gem::Version newest) -> release_hash?
     def sort_releases: (Array[release_hash] releases) -> Array[release_hash]
@@ -79,7 +105,10 @@ module GemChangelogDiff
 
     private
 
+    def configure_token: () -> void
     def build_reports: (Array[OutdatedGem] gems) -> Array[gem_report]
     def build_gem_report: (OutdatedGem gem, RubygemsClient rubygems_client, GithubClient github_client) -> gem_report
+    def log: (String message) -> void
+    def log_warning: (String message) -> void
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gem_changelog_diff
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Chuck Smith
@@ -44,7 +44,9 @@ files:
 - exe/gem_changelog_diff
 - lib/gem_changelog_diff.rb
 - lib/gem_changelog_diff/cli.rb
+- lib/gem_changelog_diff/configuration.rb
 - lib/gem_changelog_diff/detector.rb
+- lib/gem_changelog_diff/errors.rb
 - lib/gem_changelog_diff/formatter.rb
 - lib/gem_changelog_diff/github_client.rb
 - lib/gem_changelog_diff/outdated_gem.rb