brew/Library/Homebrew/api/versions.rb

# typed: true
# frozen_string_literal: true

module Homebrew
  module API
    # Helper functions for using the versions JSON API.
    #
    # @api private
    module Versions
      class << self
        extend T::Sig

        def formulae
          # The result is cached by Homebrew::API.fetch
          Homebrew::API.fetch "versions-formulae.json"
        end

        def linux
          # The result is cached by Homebrew::API.fetch
          Homebrew::API.fetch "versions-linux.json"
        end

        def casks
          # The result is cached by Homebrew::API.fetch
          Homebrew::API.fetch "versions-casks.json"
        end

        sig { params(name: String).returns(T.nilable(PkgVersion)) }
        def latest_formula_version(name)
          versions = if OS.mac? ||
                        Homebrew::EnvConfig.force_homebrew_on_linux? ||
                        Homebrew::EnvConfig.force_homebrew_core_repo_on_linux?
            formulae
          else
            linux
          end

          return unless versions.key? name

          version = Version.new(versions[name]["version"])
          revision = versions[name]["revision"]
          PkgVersion.new(version, revision)
        end

        sig { params(token: String).returns(T.nilable(Version)) }
        def latest_cask_version(token)
          return unless casks.key? token

          version = if casks[token]["versions"].key? MacOS.version.to_sym.to_s
            casks[token]["versions"][MacOS.version.to_sym.to_s]
          else
            casks[token]["version"]
          end
          Version.new(version)
        end
      end
    end
  end
end