gem_changelog_diff 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 157c1e084602c25e10cec4fde2c24b1999a9894ebe1232901cb9536bae50f33b
-  data.tar.gz: aa0be940c412f3b1a9b3ee08190d8a6e64ad0bed9cf1b2011979650b87264640
+  metadata.gz: 05a598faafc36b6f7a81836a1454668ab885425c63f8efa6b019190efc3c1614
+  data.tar.gz: 4f9eeeb3664f4ebde09921007292a2ad1af06caa0a2d738de04e6d6b28b67551
 SHA512:
-  metadata.gz: 0714bc35cee74f49ac0b09cda00e58b931c90a9f0a7688e122f5c8f2c790aedd269244d6e5a0af2dd538a33e8a91e2f8024b313f2c94b6227a4b3fa6901a160c
-  data.tar.gz: 8fb0ab418ac9c7e42adfd240360594ef1134536fe9ffa04a2dad8052d3355620d79d224b8f4342336bf853875ac60491ed6968ad8d105860dd770bccb6682fae
+  metadata.gz: 1544e2ec1db09d8dc3f34a7a24e69d55b9f7b7cbd8a5730aaa85faa94778e87de3551686912e0c83554204af3926b4b358eef0b86b5533ad952d8a11a170b88c
+  data.tar.gz: bdfe56aa40447f182fa846015d653570990308a3375d4edb25f8398dcbc5caa90abfbcf4d37383f391a93ba6b446a48f123410fa55e18e4a33fb47ed075d34f7

data/CHANGELOG.md

@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-06-18
+
+### Added
+
+- CHANGELOG.md fallback: fetches and parses changelog files when GitHub Releases are unavailable
+- Tries common filename variants: `CHANGELOG.md`, `CHANGES.md`, `History.md`, `NEWS.md`
+- `SourceResolver` orchestrates releases-first, changelog-fallback strategy
+- Colorized terminal output via `tty-color`; respects `$NO_COLOR` and `--no-color` flag
+- Summary line: "X gems outdated, Y with changelogs found, Z skipped"
+
 ## [0.2.0] - 2026-06-17
 
 ### Added
@@ -31,6 +41,7 @@ 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.2.0...HEAD
+[Unreleased]: https://github.com/eclectic-coding/gem_changelog_diff/compare/v0.3.0...HEAD
+[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

@@ -8,6 +8,16 @@
 
 CLI that shows you the changelog diff for each gem before you `bundle update`, pulled from GitHub releases.
 
+## Table of Contents
+
+- [Installation](#installation)
+- [Usage](#usage)
+  - [GitHub Authentication](#github-authentication)
+  - [Output Control](#output-control)
+- [Development](#development)
+- [Contributing](#contributing)
+- [License](#license)
+
 ## Installation
 
 Install the gem by executing:
@@ -22,6 +32,8 @@ Or add it to your Gemfile:
 bundle add gem_changelog_diff
 ```
 
+[Back to top](#gemchangelogdiff)
+
 ## Usage
 
 ```bash
@@ -49,20 +61,29 @@ gem_changelog_diff
 ### Output Control
 
 ```bash
-gem_changelog_diff --verbose  # Show detailed status messages
-gem_changelog_diff --quiet    # Suppress warnings
+gem_changelog_diff --verbose   # Show detailed status messages
+gem_changelog_diff --quiet     # Suppress warnings
+gem_changelog_diff --no-color  # Disable colored output
 ```
 
+The tool also respects the `$NO_COLOR` environment variable.
+
+[Back to top](#gemchangelogdiff)
+
 ## 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.
 
 To install this gem onto your local machine, run `bundle exec rake install`.
 
+[Back to top](#gemchangelogdiff)
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/eclectic-coding/gem_changelog_diff.
 
+[Back to top](#gemchangelogdiff)
+
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

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.3.0 -- CHANGELOG.md Fallback & Colored Output
-
-Many gems do not use GitHub Releases. Fall back to parsing CHANGELOG.md from the repository.
-
-- Fetch raw CHANGELOG.md via GitHub Contents API; try common variants (`CHANGELOG.md`, `CHANGES.md`, `History.md`, `NEWS.md`)
-- Parse Keep-a-Changelog and common freeform formats; extract entries between current and target versions
-- Colorized terminal output via `tty-color` (gem names, versions, warnings); respect `$NO_COLOR` and `--no-color`
-- Summary line: "X gems outdated, Y with changelogs found, Z skipped"
-
-**New files:** `changelog_parser.rb`, `source_resolver.rb`
-**Dependencies:** `tty-color` (runtime)
-
----
-
 ## 0.4.0 -- Lockfile Parsing Fallback & Filtering
 
 Support environments where `bundle outdated` is unavailable. Let users narrow which gems to inspect.

data/lib/gem_changelog_diff/changelog_parser.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+
+module GemChangelogDiff
+  class ChangelogParser
+    CONTENTS_URL = "https://api.github.com/repos/%<repo>s/contents/%<path>s"
+    FILENAMES = %w[CHANGELOG.md CHANGES.md History.md NEWS.md].freeze
+    VERSION_HEADING = /^##\s+\[?v?(\d+[^\]\s]+)/
+
+    def entries_between(repo, current_version, newest_version)
+      content = fetch_changelog(repo)
+      return [] unless content
+
+      parse_entries(content, current_version, newest_version)
+    rescue SocketError, Errno::ECONNREFUSED, Errno::EHOSTUNREACH,
+           Net::OpenTimeout, Net::ReadTimeout => e
+      raise NetworkError, "GitHub API request failed: #{e.message}"
+    end
+
+    private
+
+    def fetch_changelog(repo)
+      FILENAMES.each do |filename|
+        content = fetch_file(repo, filename)
+        return content if content
+      end
+
+      nil
+    end
+
+    def fetch_file(repo, path)
+      uri = URI(format(CONTENTS_URL, repo: repo, path: path))
+      response = execute_request(uri)
+      return nil unless response.is_a?(Net::HTTPSuccess)
+
+      data = JSON.parse(response.body)
+      data["content"].unpack1("m")
+    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}"
+
+      token = GemChangelogDiff.configuration.github_token
+      request["Authorization"] = "token #{token}" if token
+
+      Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
+    end
+
+    def parse_entries(content, current_version, newest_version)
+      current = Gem::Version.new(current_version)
+      newest = Gem::Version.new(newest_version)
+      sections = split_sections(content)
+
+      matched = sections.filter_map { |v, body| build_entry(v, body, current, newest) }
+      matched.sort_by { |e| Gem::Version.new(e[:tag_name]) }.reverse
+    end
+
+    def build_entry(version_str, body, current, newest)
+      gem_version = Gem::Version.new(version_str)
+      return unless gem_version > current && gem_version <= newest
+
+      { tag_name: version_str, name: version_str, published_at: nil, body: body.strip }
+    end
+
+    def split_sections(content)
+      sections = []
+      current_version = nil
+      current_body = []
+
+      content.each_line do |line|
+        current_version, current_body = process_line(line, sections, current_version, current_body)
+      end
+
+      flush_section(sections, current_version, current_body)
+      sections
+    end
+
+    def process_line(line, sections, current_version, current_body)
+      match = line.match(VERSION_HEADING)
+      if match
+        flush_section(sections, current_version, current_body)
+        [clean_version(match[1]), []]
+      else
+        current_body << line if current_version
+        [current_version, current_body]
+      end
+    end
+
+    def flush_section(sections, version, body)
+      sections << [version, body.join] if version
+    end
+
+    def clean_version(raw)
+      raw.sub(/\]\s*-?\s*\d{4}-\d{2}-\d{2}.*/, "").strip
+    end
+  end
+end

data/lib/gem_changelog_diff/cli.rb

@@ -13,6 +13,7 @@ module GemChangelogDiff
     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"
+    class_option :no_color, type: :boolean, default: false, desc: "Disable colored output"
 
     desc "check", "Show changelog diffs for outdated gems"
     def check
@@ -25,7 +26,8 @@ module GemChangelogDiff
       end
 
       reports = build_reports(gems)
-      say Formatter.new.format(reports)
+      formatter = Formatter.new(color: color_enabled?)
+      say formatter.format(reports)
     end
 
     desc "version", "Print version"
@@ -44,24 +46,28 @@ module GemChangelogDiff
 
     def build_reports(gems)
       rubygems_client = RubygemsClient.new
-      github_client = GithubClient.new
+      source_resolver = SourceResolver.new
 
-      gems.map { |gem| build_gem_report(gem, rubygems_client, github_client) }
+      gems.map { |gem| build_gem_report(gem, rubygems_client, source_resolver) }
     end
 
-    def build_gem_report(gem, rubygems_client, github_client)
+    def build_gem_report(gem, rubygems_client, source_resolver)
       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)
+      releases = source_resolver.resolve(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 color_enabled?
+      !options[:no_color]
+    end
+
     def log(message)
       warn message if options[:verbose]
     end

data/lib/gem_changelog_diff/formatter.rb

@@ -1,18 +1,37 @@
 # frozen_string_literal: true
 
+require "tty-color"
+
 module GemChangelogDiff
   class Formatter
+    BOLD = "\e[1m"
+    CYAN = "\e[36m"
+    GREEN = "\e[32m"
+    YELLOW = "\e[33m"
+    RED = "\e[31m"
+    RESET = "\e[0m"
+
+    def initialize(color: default_color?)
+      @color = color
+    end
+
     def format(gem_reports)
-      gem_reports.map { |report| format_gem(report) }.join("\n")
+      output = gem_reports.map { |report| format_gem(report) }.join("\n")
+      output + summary(gem_reports)
     end
 
     private
 
+    def default_color?
+      TTY::Color.color? && ENV.fetch("NO_COLOR", nil).nil?
+    end
+
     def format_gem(report)
-      header = "== #{report[:gem].name} (#{report[:gem].current_version} → #{report[:gem].newest_version}) =="
+      gem = report[:gem]
+      header = colorize("== #{gem.name} (#{gem.current_version} → #{gem.newest_version}) ==", BOLD, CYAN)
 
       body = if report[:releases].empty?
-               report[:error] || "  No GitHub releases found."
+               colorize(report[:error] || "  No changelog entries found.", RED)
              else
                report[:releases].map { |r| format_release(r) }.join("\n")
              end
@@ -24,9 +43,26 @@ module GemChangelogDiff
       title = "--- #{release[:tag_name]}"
       title += " (#{release[:published_at][0..9]})" if release[:published_at]
       title += " ---"
+      title = colorize(title, YELLOW)
+
       body = release[:body]&.strip.to_s
       body = "(no release notes)" if body.empty?
       "#{title}\n#{body}\n"
     end
+
+    def summary(gem_reports)
+      total = gem_reports.size
+      with_changelogs = gem_reports.count { |r| !r[:releases].empty? }
+      skipped = gem_reports.count { |r| r[:error] }
+
+      line = "\n#{total} gems outdated, #{with_changelogs} with changelogs found, #{skipped} skipped"
+      colorize(line, BOLD, GREEN)
+    end
+
+    def colorize(text, *codes)
+      return text unless @color
+
+      "#{codes.join}#{text}#{RESET}"
+    end
   end
 end

data/lib/gem_changelog_diff/source_resolver.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module GemChangelogDiff
+  class SourceResolver
+    def initialize(github_client: GithubClient.new, changelog_parser: ChangelogParser.new)
+      @github_client = github_client
+      @changelog_parser = changelog_parser
+    end
+
+    def resolve(repo, current_version, newest_version)
+      releases = @github_client.releases_between(repo, current_version, newest_version)
+      return releases unless releases.empty?
+
+      @changelog_parser.entries_between(repo, current_version, newest_version)
+    end
+  end
+end

data/lib/gem_changelog_diff/version.rb

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

data/lib/gem_changelog_diff.rb

@@ -12,5 +12,7 @@ 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/changelog_parser"
+require_relative "gem_changelog_diff/source_resolver"
 require_relative "gem_changelog_diff/formatter"
 require_relative "gem_changelog_diff/cli"

data/sig/gem_changelog_diff.rbs

@@ -63,6 +63,31 @@ module GemChangelogDiff
     body: String?
   }
 
+  class ChangelogParser
+    CONTENTS_URL: String
+    FILENAMES: Array[String]
+    VERSION_HEADING: Regexp
+
+    def entries_between: (String repo, String current_version, String newest_version) -> Array[release_hash]
+
+    private
+
+    def fetch_changelog: (String repo) -> String?
+    def fetch_file: (String repo, String path) -> String?
+    def execute_request: (URI::Generic uri) -> Net::HTTPResponse
+    def parse_entries: (String content, String current_version, String newest_version) -> Array[release_hash]
+    def build_entry: (String version_str, String body, Gem::Version current, Gem::Version newest) -> release_hash?
+    def split_sections: (String content) -> Array[[String, String]]
+    def process_line: (String line, Array[[String, String]] sections, String? current_version, Array[String] current_body) -> [String?, Array[String]]
+    def flush_section: (Array[[String, String]] sections, String? version, Array[String] body) -> void
+    def clean_version: (String raw) -> String
+  end
+
+  class SourceResolver
+    def initialize: (?github_client: GithubClient, ?changelog_parser: ChangelogParser) -> void
+    def resolve: (String repo, String current_version, String newest_version) -> Array[release_hash]
+  end
+
   class GithubClient
     RELEASES_URL: String
     TAG_VERSION_REGEX: Regexp
@@ -89,12 +114,23 @@ module GemChangelogDiff
   }
 
   class Formatter
+    BOLD: String
+    CYAN: String
+    GREEN: String
+    YELLOW: String
+    RED: String
+    RESET: String
+
+    def initialize: (?color: bool) -> void
     def format: (Array[gem_report] gem_reports) -> String
 
     private
 
+    def default_color?: () -> bool
     def format_gem: (gem_report report) -> String
     def format_release: (release_hash release) -> String
+    def summary: (Array[gem_report] gem_reports) -> String
+    def colorize: (String text, *String codes) -> String
   end
 
   class CLI < Thor
@@ -105,9 +141,10 @@ module GemChangelogDiff
 
     private
 
+    def color_enabled?: () -> bool
     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 build_gem_report: (OutdatedGem gem, RubygemsClient rubygems_client, SourceResolver source_resolver) -> gem_report
     def log: (String message) -> void
     def log_warning: (String message) -> void
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gem_changelog_diff
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Chuck Smith
@@ -23,6 +23,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: tty-color
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.6'
 description: CLI that shows you the changelog diff for each gem before you bundle
   update, pulled from GitHub releases.
 email:
@@ -43,6 +57,7 @@ files:
 - codecov.yml
 - exe/gem_changelog_diff
 - lib/gem_changelog_diff.rb
+- lib/gem_changelog_diff/changelog_parser.rb
 - lib/gem_changelog_diff/cli.rb
 - lib/gem_changelog_diff/configuration.rb
 - lib/gem_changelog_diff/detector.rb
@@ -51,6 +66,7 @@ files:
 - lib/gem_changelog_diff/github_client.rb
 - lib/gem_changelog_diff/outdated_gem.rb
 - lib/gem_changelog_diff/rubygems_client.rb
+- lib/gem_changelog_diff/source_resolver.rb
 - lib/gem_changelog_diff/version.rb
 - sig/gem_changelog_diff.rbs
 homepage: https://github.com/eclectic-coding/gem_changelog_diff