end_of_life 0.5.0 → 1.0.0.alpha

data/lib/end_of_life/helpers/time.rb

@@ -0,0 +1,35 @@
+module EndOfLife
+  module Helpers::Time
+    include Helpers::Text
+
+    def relative_time_in_words(date)
+      days_away = (date - Date.today).to_i
+      return "today" if days_away.zero?
+
+      duration = duration_in_words(days_away.abs)
+
+      if days_away.positive?
+        "in #{duration}"
+      else
+        "#{duration} ago"
+      end
+    end
+
+    private
+
+    def duration_in_words(number_of_days)
+      if number_of_days >= 365
+        years = (number_of_days / 365.0).floor
+        pluralize(years, "year")
+      elsif number_of_days >= 30
+        months = (number_of_days / 30.0).floor
+        pluralize(months, "month")
+      elsif number_of_days >= 14
+        weeks = (number_of_days / 7.0).floor
+        pluralize(weeks, "week")
+      else
+        pluralize(number_of_days, "day")
+      end
+    end
+  end
+end

data/lib/end_of_life/parsers/gemfile.rb

@@ -22,7 +22,7 @@ module EndOfLife
           tempfile.rewind
 
           yield(tempfile)
-        rescue Bundler::BundlerError
+        rescue Bundler::BundlerError, Errno::ENOENT # Bundler tries to read the version file, and in some versions it raises this error
           nil # NOTE: maybe a Null object would be cleaner
         end
       end

data/lib/end_of_life/parsers/gemfile_lock.rb

@@ -8,6 +8,8 @@ module EndOfLife
         silence_bundler do
           Bundler::LockfileParser.new(file_content)
         end
+      rescue Bundler::BundlerError # outside a bundler project
+        nil
       end
     end
   end

data/lib/end_of_life/parsers/mise_toml.rb

@@ -0,0 +1,15 @@
+require "perfect_toml"
+
+module EndOfLife
+  module Parsers
+    module MiseToml
+      extend self
+
+      def parse(file_content)
+        PerfectTOML.parse(file_content)["tools"]
+      rescue PerfectTOML::ParseError
+        nil
+      end
+    end
+  end
+end

data/lib/end_of_life/parsers/tool_versions.rb

@@ -10,6 +10,7 @@ module EndOfLife
             line = line.strip
             next if line.start_with?("#") || line.empty?
 
+            line = line.split("#").first.strip # inline comments
             tool, version, * = line.split
 
             next if version == "latest"

data/lib/end_of_life/product/registry.rb

@@ -1,21 +1,22 @@
 module EndOfLife
   module Product::Registry
-    def scans_for(product_name, search_query:)
+    def scans_for(product_name, label: nil)
       product_registry[product_name.to_sym.downcase] = Product.new(
         product_name,
-        search_query,
-        version_detector_for(product_name)
+        version_detector_for(product_name),
+        label
       )
     end
 
     def find_product(name) = product_registry.fetch(name.to_sym.downcase)
 
     def products = product_registry.values
+    def products_pattern(suffix: nil) = /\A(?:#{products.map(&:name).join("|")})#{suffix}/i
 
     private
 
     def product_registry
-      @@product_registry ||= {}
+      @product_registry ||= {}
     end
 
     def version_detector_for(product) = VersionDetectors.for_product(product)

data/lib/end_of_life/product/release.rb

@@ -3,6 +3,17 @@ module EndOfLife
     class Release < Data.define(:product, :version, :eol_date)
       include Comparable
 
+      def self.parse!(string)
+        product, version = string.split("@", 2)
+        raise ArgumentError, "Invalid product release format: #{string}" if product.to_s.empty? || version.to_s.empty?
+
+        begin
+          new(product:, version:)
+        rescue ArgumentError
+          raise ArgumentError, "Malformed version number string: #{version}"
+        end
+      end
+
       def self.ruby(version, eol_date: nil) = new(product: "ruby", version:, eol_date:)
 
       def initialize(product:, version:, eol_date: nil)
@@ -19,12 +30,22 @@ module EndOfLife
         end
       end
 
+      def supported?(...) = !eol?(...)
+
+      def latest_release_in_cycle
+        product.all_releases.filter { |r| r.version.to_s.start_with?(cycle_version.to_s) }.max
+      end
+
+      def cycle_version
+        Gem::Version.new(version.segments.first(2).join("."))
+      end
+
       ZERO = Gem::Version.new("0")
       def zero? = version == ZERO
 
       def <=>(other) = version <=> other.version
 
-      def to_s = version.to_s
+      def to_s = "#{product.name}@#{version}"
     end
   end
 end

data/lib/end_of_life/product.rb

@@ -2,31 +2,32 @@ module EndOfLife
   class Product
     def self.find(name) = EndOfLife.find_product(name)
 
-    attr_reader :name, :search_query, :version_detector
+    attr_reader :name, :version_detector, :label
 
-    def initialize(name, search_query, version_detector)
+    def initialize(name, version_detector, label = nil)
       @name = name.to_s.downcase
-      @search_query = search_query
       @version_detector = version_detector
+      @label = label || @name.capitalize
     end
 
     def eol_releases_at(date)
-      all_releases.filter { |release| release.eol_date <= date }
+      all_releases.filter { |release| release.eol_date.nil? || release.eol_date <= date }
     end
 
     def latest_eol_release(at: Date.today)
       eol_releases_at(at).max
     end
 
-    def label = name.capitalize
-    def to_s = label
-
-    private
-
     def all_releases
       @all_releases ||= API.fetch_product(name)
         .dig(:result, :releases)
         .map { |json| Release.new(name, json[:latest][:name], json[:eolFrom]) }
     end
+
+    def search_query
+      version_detector.relevant_files.map { |f| %(filename:"#{f}") }.join(" ")
+    end
+
+    def to_s = label
   end
 end

data/lib/end_of_life/repository/search.rb

@@ -14,11 +14,22 @@ module EndOfLife
           github.auto_paginate = true
           options[:user] ||= github.user.login
 
+          # GitHub doesn't have a way to get repos that contain specific files.
+          # The language filter sort of works, but it might miss some repos that
+          # use a language, but it's not the main one.
+          #
+          # We have to use the code search endpoint to find files matching the
+          # product we're interested in and then extract the repositories from
+          # the results.
           query = Query.new(options).to_s
-          items = github.search_repositories(query, {sort: :updated}).items
+          repo_names = github.search_code(query).items.map { |item| item.repository.full_name }.uniq
+          return Success([]) if repo_names.empty?
+
+          repos_query = repo_names.map { |name| "repo:#{name}" }.join(" ")
+          repos = github.search_repositories(repos_query, {sort: :updated}).items
 
           Success(
-            items.filter_map do |repo|
+            repos.filter_map do |repo|
               next if repo.archived && options[:skip_archived]
 
               Repository.new(

data/lib/end_of_life/repository.rb

@@ -1,3 +1,6 @@
+require "base64"
+require "octokit"
+
 module EndOfLife
   class Repository
     class << self

data/lib/end_of_life/scanner/report.rb

@@ -0,0 +1,37 @@
+require "stringio"
+
+module EndOfLife
+  module Scanner
+    class Report < Data.define(:product, :repositories, :max_eol_date)
+      include Helpers::Text
+      include Helpers::Terminal
+
+      def to_s
+        report = StringIO.new
+        report.puts
+
+        if repositories.empty?
+          report.puts "No repositories using EOL #{product}."
+        else
+          report.puts "Found #{pluralize(repositories.size, "repository", "repositories")} using EOL #{product} (<= #{product.latest_eol_release(at: max_eol_date)}):"
+          report.puts end_of_life_table(repositories)
+        end
+
+        report.string
+      end
+
+      def failure? = repositories.any?
+
+      private
+
+      def end_of_life_table(repositories)
+        headers = ["", "Repository", "#{product} version"]
+        rows = repositories.map.with_index(1) do |repo, i|
+          [i, repo.url, repo.min_release_of(product)]
+        end
+
+        table(headers, rows)
+      end
+    end
+  end
+end

data/lib/end_of_life/scanner.rb

@@ -1,28 +1,34 @@
+require "async"
+require "dry-monads"
+
 module EndOfLife
   module Scanner
     include Helpers::Terminal
+    include Helpers::Text
     extend self
 
-    def scan(options)
-      fetch_repositories(options)
-        .fmap { |repositories| filter_repositories_with_eol_products(repositories, **options.slice(:product, :max_eol_date)) }
-        .fmap { |repositories| output_report(repositories, **options.slice(:product, :max_eol_date)) }
+    def scan(product, options)
+      fetch_repositories(product, options)
+        .fmap { |repositories| filter_repositories_with_eol_products(repositories, product, options[:max_eol_date]) }
+        .fmap { |repositories| output_report(repositories, product, options[:max_eol_date]) }
         .or { |error| abort "\n#{error_msg(error)}" }
     end
 
     private
 
-    def fetch_repositories(options)
-      with_loading_spinner("Searching repositories with #{options[:product].label}...") do |spinner|
-        result = Repository.search(options)
+    def fetch_repositories(product, options)
+      with_loading_spinner("Searching repositories that might use #{product.label}...") do |spinner|
+        result = Repository.search(options.merge(product:))
         spinner.error if result.failure?
 
         result
       end
     end
 
-    def filter_repositories_with_eol_products(repositories, product:, max_eol_date:)
-      with_loading_spinner("Searching for EOL #{product} in your repositories...") do
+    def filter_repositories_with_eol_products(repositories, product, max_eol_date)
+      return [] if repositories.empty?
+
+      with_loading_spinner("Scanning #{pluralize(repositories.size, "repository", "repositories")} for EOL #{product.label}...") do
         Sync do
           repositories
             .map { |repo| Async { [repo, repo.using_eol?(product, at: max_eol_date)] } }.map(&:wait)
@@ -31,7 +37,7 @@ module EndOfLife
       end
     end
 
-    def output_report(repositories, product:, max_eol_date:)
+    def output_report(repositories, product, max_eol_date)
       report = Report.new(product, repositories, max_eol_date)
       puts report
 

data/lib/end_of_life/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module EndOfLife
-  VERSION = "0.5.0"
+  VERSION = "1.0.0.alpha"
 end

data/lib/end_of_life/version_detector.rb

@@ -4,8 +4,8 @@ module EndOfLife
       @file_detectors ||= {}
     end
 
-    def detects_from(file, &block)
-      file_detectors[file] = block
+    def detects_from(*files, &block)
+      files.each { |file| file_detectors[file] = block }
     end
 
     def relevant_files = file_detectors.keys

data/lib/end_of_life/version_detectors/nodejs.rb

@@ -0,0 +1,31 @@
+require "bundler"
+
+module EndOfLife
+  module VersionDetectors
+    module Nodejs
+      extend VersionDetector
+
+      detects_from ".node-version", ".nvmrc" do |file_content|
+        string_version = Gem::Version.new(file_content.strip.delete_prefix("v"))
+
+        Product::Release.new(product: "nodejs", version: string_version)
+      rescue ArgumentError
+        nil
+      end
+
+      detects_from ".tool-versions" do |file_content|
+        tool_versions = Parsers::ToolVersions.parse(file_content)
+        version = tool_versions["nodejs"] or next
+
+        Product::Release.new(product: "nodejs", version:)
+      end
+
+      detects_from "mise.toml" do |file_content|
+        tools = Parsers::MiseToml.parse(file_content) or next
+        version = tools["node"] or next
+
+        Product::Release.new(product: "nodejs", version:)
+      end
+    end
+  end
+end

data/lib/end_of_life/version_detectors/ruby.rb

@@ -12,7 +12,7 @@ module EndOfLife
       end
 
       detects_from "Gemfile.lock" do |file_content|
-        gemfile_lock_version = Parsers::GemfileLock.parse(file_content).ruby_version or next
+        gemfile_lock_version = Parsers::GemfileLock.parse(file_content)&.ruby_version or next
 
         Product::Release.ruby(gemfile_lock_version.delete_prefix("ruby "))
       end
@@ -30,6 +30,13 @@ module EndOfLife
 
         Product::Release.ruby(ruby_version)
       end
+
+      detects_from "mise.toml" do |file_content|
+        tools = Parsers::MiseToml.parse(file_content) or next
+        ruby_version = tools["ruby"] or next
+
+        Product::Release.ruby(ruby_version)
+      end
     end
   end
 end

data/lib/end_of_life/version_detectors.rb

@@ -6,8 +6,6 @@ module EndOfLife
       detector_class = "#{self}::#{camelize(product.to_s)}"
 
       const_get(detector_class)
-    rescue NameError
-      raise ArgumentError, "Undefined version detector for product: #{product}"
     end
 
     private

data/lib/end_of_life.rb

@@ -1,10 +1,5 @@
 # frozen_string_literal: true
 
-require "async"
-require "dry-monads"
-require "json"
-require "base64"
-require "octokit"
 require "zeitwerk"
 
 Zeitwerk::Loader.for_gem.tap { |it|
@@ -15,6 +10,7 @@ module EndOfLife
   extend Product::Registry
   extend Helpers::Terminal
 
-  scans_for :ruby, search_query: "language:ruby"
-  scans_for :rails, search_query: "language:ruby"
+  scans_for :ruby
+  scans_for :rails
+  scans_for :nodejs, label: "Node.js"
 end

metadata

@@ -1,14 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: end_of_life
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 1.0.0.alpha
 platform: ruby
 authors:
 - Matheus Richard
+autorequire:
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2025-10-24 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: argument_parser
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.0
 - !ruby/object:Gem::Dependency
   name: async
   requirement: !ruby/object:Gem::Requirement
@@ -23,6 +38,40 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.7.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.7.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
 - !ruby/object:Gem::Dependency
   name: dry-monads
   requirement: !ruby/object:Gem::Requirement
@@ -37,6 +86,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: perfect_toml
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.9.0
 - !ruby/object:Gem::Dependency
   name: octokit
   requirement: !ruby/object:Gem::Requirement
@@ -51,6 +114,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '9.0'
+- !ruby/object:Gem::Dependency
+  name: faraday-retry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: pastel
   requirement: !ruby/object:Gem::Requirement
@@ -107,8 +184,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.7'
-description: Searches your GitHub repositores and lists the ones using end-of-life,
-  i.e. unmaintained, software versions.
+description: |
+  Searches your GitHub repositores and lists the ones using end-of-life, i.e.
+  unmaintained, software.
 email:
 - matheusrichardt@gmail.com
 executables:
@@ -118,7 +196,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".rspec"
-- ".tool-versions"
+- ".standard.yml"
 - CHANGELOG.md
 - Gemfile
 - Gemfile.lock
@@ -126,6 +204,7 @@ files:
 - README.md
 - Rakefile
 - bin/console
+- bin/end_of_life
 - bin/setup
 - demo.gif
 - end_of_life.gemspec
@@ -133,26 +212,31 @@ files:
 - exe/eol
 - lib/end_of_life.rb
 - lib/end_of_life/api.rb
+- lib/end_of_life/check.rb
 - lib/end_of_life/cli.rb
+- lib/end_of_life/cli/command/registry.rb
 - lib/end_of_life/helpers/silent_bundler.rb
 - lib/end_of_life/helpers/terminal.rb
+- lib/end_of_life/helpers/text.rb
+- lib/end_of_life/helpers/time.rb
 - lib/end_of_life/in_memory_file.rb
-- lib/end_of_life/options.rb
 - lib/end_of_life/parsers/gemfile.rb
 - lib/end_of_life/parsers/gemfile_lock.rb
+- lib/end_of_life/parsers/mise_toml.rb
 - lib/end_of_life/parsers/ruby_version.rb
 - lib/end_of_life/parsers/tool_versions.rb
 - lib/end_of_life/product.rb
 - lib/end_of_life/product/registry.rb
 - lib/end_of_life/product/release.rb
-- lib/end_of_life/report.rb
 - lib/end_of_life/repository.rb
 - lib/end_of_life/repository/search.rb
 - lib/end_of_life/repository/search/query.rb
 - lib/end_of_life/scanner.rb
+- lib/end_of_life/scanner/report.rb
 - lib/end_of_life/version.rb
 - lib/end_of_life/version_detector.rb
 - lib/end_of_life/version_detectors.rb
+- lib/end_of_life/version_detectors/nodejs.rb
 - lib/end_of_life/version_detectors/rails.rb
 - lib/end_of_life/version_detectors/ruby.rb
 homepage: https://github.com/MatheusRich/end_of_life
@@ -162,6 +246,7 @@ metadata:
   homepage_uri: https://github.com/MatheusRich/end_of_life
   source_code_uri: https://github.com/MatheusRich/end_of_life
   changelog_uri: https://github.com/MatheusRich/end_of_life/blob/main/CHANGELOG.md
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -172,11 +257,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
-rubygems_version: 3.7.1
+rubygems_version: 3.4.19
+signing_key:
 specification_version: 4
 summary: Lists repositories using end-of-life software
 test_files: []

data/.tool-versions

@@ -1 +0,0 @@
-ruby 3.4.2