391 lines
		
	
	
		
			11 KiB
		
	
	
	
		
			Ruby
		
	
	
	
	
	
			
		
		
	
	
			391 lines
		
	
	
		
			11 KiB
		
	
	
	
		
			Ruby
		
	
	
	
	
	
| # typed: true
 | |
| # frozen_string_literal: true
 | |
| 
 | |
| require "cask/cask_loader"
 | |
| require "cask/config"
 | |
| require "cask/dsl"
 | |
| require "cask/metadata"
 | |
| require "utils/bottles"
 | |
| require "extend/api_hashable"
 | |
| 
 | |
| module Cask
 | |
|   # An instance of a cask.
 | |
|   #
 | |
|   # @api private
 | |
|   class Cask
 | |
|     extend T::Sig
 | |
| 
 | |
|     extend Forwardable
 | |
|     extend Predicable
 | |
|     extend APIHashable
 | |
|     include Metadata
 | |
| 
 | |
|     attr_reader :token, :sourcefile_path, :source, :config, :default_config, :loader
 | |
|     attr_accessor :download, :allow_reassignment
 | |
| 
 | |
|     attr_predicate :loaded_from_api?
 | |
| 
 | |
|     def self.all
 | |
|       # TODO: ideally avoid using ARGV by moving to e.g. CLI::Parser
 | |
|       if ARGV.exclude?("--eval-all") && !Homebrew::EnvConfig.eval_all?
 | |
|         odeprecated "Cask::Cask#all without --all or HOMEBREW_EVAL_ALL"
 | |
|       end
 | |
| 
 | |
|       Tap.flat_map(&:cask_files).map do |f|
 | |
|         CaskLoader::FromTapPathLoader.new(f).load(config: nil)
 | |
|       rescue CaskUnreadableError => e
 | |
|         opoo e.message
 | |
| 
 | |
|         nil
 | |
|       end.compact
 | |
|     end
 | |
| 
 | |
|     def tap
 | |
|       return super if block_given? # Object#tap
 | |
| 
 | |
|       @tap
 | |
|     end
 | |
| 
 | |
|     sig {
 | |
|       params(
 | |
|         token:              String,
 | |
|         sourcefile_path:    T.nilable(Pathname),
 | |
|         source:             T.nilable(String),
 | |
|         tap:                T.nilable(Tap),
 | |
|         loaded_from_api:    T::Boolean,
 | |
|         config:             T.nilable(Config),
 | |
|         allow_reassignment: T::Boolean,
 | |
|         loader:             T.nilable(CaskLoader::ILoader),
 | |
|         block:              T.nilable(T.proc.bind(DSL).void),
 | |
|       ).void
 | |
|     }
 | |
|     def initialize(token, sourcefile_path: nil, source: nil, tap: nil, loaded_from_api: false,
 | |
|                    config: nil, allow_reassignment: false, loader: nil, &block)
 | |
|       @token = token
 | |
|       @sourcefile_path = sourcefile_path
 | |
|       @source = source
 | |
|       @tap = tap
 | |
|       @allow_reassignment = allow_reassignment
 | |
|       @loaded_from_api = loaded_from_api
 | |
|       @loader = loader
 | |
|       # Sorbet has trouble with bound procs assigned to ivars: https://github.com/sorbet/sorbet/issues/6843
 | |
|       instance_variable_set(:@block, block)
 | |
| 
 | |
|       @default_config = config || Config.new
 | |
| 
 | |
|       self.config = if config_path.exist?
 | |
|         Config.from_json(File.read(config_path), ignore_invalid_keys: true)
 | |
|       else
 | |
|         @default_config
 | |
|       end
 | |
|     end
 | |
| 
 | |
|     def config=(config)
 | |
|       @config = config
 | |
| 
 | |
|       refresh
 | |
|     end
 | |
| 
 | |
|     def refresh
 | |
|       @dsl = DSL.new(self)
 | |
|       return unless @block
 | |
| 
 | |
|       @dsl.instance_eval(&@block)
 | |
|       @dsl.language_eval
 | |
|     end
 | |
| 
 | |
|     DSL::DSL_METHODS.each do |method_name|
 | |
|       define_method(method_name) { |&block| @dsl.send(method_name, &block) }
 | |
|     end
 | |
| 
 | |
|     sig { returns(T::Array[[String, String]]) }
 | |
|     def timestamped_versions
 | |
|       relative_paths = Pathname.glob(metadata_timestamped_path(version: "*", timestamp: "*"))
 | |
|                                .map { |p| p.relative_path_from(p.parent.parent) }
 | |
|       # Sorbet is unaware that Pathname is sortable: https://github.com/sorbet/sorbet/issues/6844
 | |
|       T.unsafe(relative_paths).sort_by(&:basename) # sort by timestamp
 | |
|        .map { |p| p.split.map(&:to_s) }
 | |
|     end
 | |
| 
 | |
|     def versions
 | |
|       timestamped_versions.map(&:first)
 | |
|                           .reverse
 | |
|                           .uniq
 | |
|                           .reverse
 | |
|     end
 | |
| 
 | |
|     def os_versions
 | |
|       # TODO: use #to_hash_with_variations instead once all casks use on_system blocks
 | |
|       @os_versions ||= begin
 | |
|         version_os_hash = {}
 | |
|         actual_version = MacOS.full_version.to_s
 | |
| 
 | |
|         MacOSVersions::SYMBOLS.each do |os_name, os_version|
 | |
|           MacOS.full_version = os_version
 | |
|           cask = CaskLoader.load(full_name)
 | |
|           version_os_hash[os_name] = cask.version if cask.version != version
 | |
|         end
 | |
| 
 | |
|         version_os_hash
 | |
|       ensure
 | |
|         MacOS.full_version = actual_version if actual_version
 | |
|       end
 | |
|     end
 | |
| 
 | |
|     def full_name
 | |
|       return token if tap.nil?
 | |
|       return token if tap.user == "Homebrew"
 | |
| 
 | |
|       "#{tap.name}/#{token}"
 | |
|     end
 | |
| 
 | |
|     def installed?
 | |
|       !versions.empty?
 | |
|     end
 | |
| 
 | |
|     # The caskfile is needed during installation when there are
 | |
|     # `*flight` blocks or the cask has multiple languages
 | |
|     def caskfile_only?
 | |
|       languages.any? || artifacts.any?(Artifact::AbstractFlightBlock)
 | |
|     end
 | |
| 
 | |
|     sig { returns(T.nilable(Time)) }
 | |
|     def install_time
 | |
|       _, time = timestamped_versions.last
 | |
|       return unless time
 | |
| 
 | |
|       Time.strptime(time, Metadata::TIMESTAMP_FORMAT)
 | |
|     end
 | |
| 
 | |
|     def installed_caskfile
 | |
|       installed_version = timestamped_versions.last
 | |
|       caskfile_dir = metadata_main_container_path.join(*installed_version, "Casks")
 | |
|       return caskfile_dir.join("#{token}.json") if caskfile_dir.join("#{token}.json").exist?
 | |
| 
 | |
|       caskfile_dir.join("#{token}.rb")
 | |
|     end
 | |
| 
 | |
|     def config_path
 | |
|       metadata_main_container_path/"config.json"
 | |
|     end
 | |
| 
 | |
|     def checksumable?
 | |
|       DownloadStrategyDetector.detect(url.to_s, url.using) <= AbstractFileDownloadStrategy
 | |
|     end
 | |
| 
 | |
|     def download_sha_path
 | |
|       metadata_main_container_path/"LATEST_DOWNLOAD_SHA256"
 | |
|     end
 | |
| 
 | |
|     def new_download_sha
 | |
|       require "cask/installer"
 | |
| 
 | |
|       # Call checksumable? before hashing
 | |
|       @new_download_sha ||= Installer.new(self, verify_download_integrity: false)
 | |
|                                      .download(quiet: true)
 | |
|                                      .instance_eval { |x| Digest::SHA256.file(x).hexdigest }
 | |
|     end
 | |
| 
 | |
|     def outdated_download_sha?
 | |
|       return true unless checksumable?
 | |
| 
 | |
|       current_download_sha = download_sha_path.read if download_sha_path.exist?
 | |
|       current_download_sha.blank? || current_download_sha != new_download_sha
 | |
|     end
 | |
| 
 | |
|     def caskroom_path
 | |
|       @caskroom_path ||= Caskroom.path.join(token)
 | |
|     end
 | |
| 
 | |
|     def outdated?(greedy: false, greedy_latest: false, greedy_auto_updates: false)
 | |
|       !outdated_versions(greedy: greedy, greedy_latest: greedy_latest,
 | |
|                          greedy_auto_updates: greedy_auto_updates).empty?
 | |
|     end
 | |
| 
 | |
|     def outdated_versions(greedy: false, greedy_latest: false, greedy_auto_updates: false)
 | |
|       # special case: tap version is not available
 | |
|       return [] if version.nil?
 | |
| 
 | |
|       if version.latest?
 | |
|         return versions if (greedy || greedy_latest) && outdated_download_sha?
 | |
| 
 | |
|         return []
 | |
|       elsif auto_updates && !greedy && !greedy_auto_updates
 | |
|         return []
 | |
|       end
 | |
| 
 | |
|       installed = versions
 | |
|       current   = installed.last
 | |
| 
 | |
|       # not outdated unless there is a different version on tap
 | |
|       return [] if current == version
 | |
| 
 | |
|       # collect all installed versions that are different than tap version and return them
 | |
|       installed.reject { |v| v == version }
 | |
|     end
 | |
| 
 | |
|     def outdated_info(greedy, verbose, json, greedy_latest, greedy_auto_updates)
 | |
|       return token if !verbose && !json
 | |
| 
 | |
|       installed_versions = outdated_versions(greedy: greedy, greedy_latest: greedy_latest,
 | |
|                                              greedy_auto_updates: greedy_auto_updates).join(", ")
 | |
| 
 | |
|       if json
 | |
|         {
 | |
|           name:               token,
 | |
|           installed_versions: installed_versions,
 | |
|           current_version:    version,
 | |
|         }
 | |
|       else
 | |
|         "#{token} (#{installed_versions}) != #{version}"
 | |
|       end
 | |
|     end
 | |
| 
 | |
|     def ruby_source_path
 | |
|       return @ruby_source_path if defined?(@ruby_source_path)
 | |
| 
 | |
|       return unless sourcefile_path
 | |
|       return unless tap
 | |
| 
 | |
|       @ruby_source_path = sourcefile_path.relative_path_from(tap.path)
 | |
|     end
 | |
| 
 | |
|     def ruby_source_checksum
 | |
|       @ruby_source_checksum ||= {
 | |
|         "sha256" => Digest::SHA256.file(sourcefile_path).hexdigest,
 | |
|       }.freeze
 | |
|     end
 | |
| 
 | |
|     def languages
 | |
|       @languages ||= @dsl.languages
 | |
|     end
 | |
| 
 | |
|     def tap_git_head
 | |
|       @tap_git_head ||= tap&.git_head
 | |
|     end
 | |
| 
 | |
|     def populate_from_api!(json_cask)
 | |
|       raise ArgumentError, "Expected cask to be loaded from the API" unless loaded_from_api?
 | |
| 
 | |
|       @languages = json_cask[:languages]
 | |
|       @tap_git_head = json_cask.fetch(:tap_git_head, "HEAD")
 | |
| 
 | |
|       @ruby_source_path = json_cask[:ruby_source_path]
 | |
|       @ruby_source_checksum = json_cask[:ruby_source_checksum].freeze
 | |
|     end
 | |
| 
 | |
|     def to_s
 | |
|       @token
 | |
|     end
 | |
| 
 | |
|     def hash
 | |
|       token.hash
 | |
|     end
 | |
| 
 | |
|     def eql?(other)
 | |
|       instance_of?(other.class) && token == other.token
 | |
|     end
 | |
|     alias == eql?
 | |
| 
 | |
|     def to_h
 | |
|       url_specs = url&.specs.dup
 | |
|       case url_specs&.dig(:user_agent)
 | |
|       when :default
 | |
|         url_specs.delete(:user_agent)
 | |
|       when Symbol
 | |
|         url_specs[:user_agent] = ":#{url_specs[:user_agent]}"
 | |
|       end
 | |
| 
 | |
|       {
 | |
|         "token"                => token,
 | |
|         "full_token"           => full_name,
 | |
|         "tap"                  => tap&.name,
 | |
|         "name"                 => name,
 | |
|         "desc"                 => desc,
 | |
|         "homepage"             => homepage,
 | |
|         "url"                  => url,
 | |
|         "url_specs"            => url_specs,
 | |
|         "appcast"              => appcast,
 | |
|         "version"              => version,
 | |
|         "versions"             => os_versions,
 | |
|         "installed"            => versions.last,
 | |
|         "outdated"             => outdated?,
 | |
|         "sha256"               => sha256,
 | |
|         "artifacts"            => artifacts_list,
 | |
|         "caveats"              => (caveats unless caveats.empty?),
 | |
|         "depends_on"           => depends_on,
 | |
|         "conflicts_with"       => conflicts_with,
 | |
|         "container"            => container&.pairs,
 | |
|         "auto_updates"         => auto_updates,
 | |
|         "tap_git_head"         => tap_git_head,
 | |
|         "languages"            => languages,
 | |
|         "ruby_source_path"     => ruby_source_path,
 | |
|         "ruby_source_checksum" => ruby_source_checksum,
 | |
|       }
 | |
|     end
 | |
| 
 | |
|     def to_hash_with_variations
 | |
|       if loaded_from_api? && !Homebrew::EnvConfig.no_install_from_api?
 | |
|         return api_to_local_hash(Homebrew::API::Cask.all_casks[token])
 | |
|       end
 | |
| 
 | |
|       hash = to_h
 | |
|       variations = {}
 | |
| 
 | |
|       hash_keys_to_skip = %w[outdated installed versions]
 | |
| 
 | |
|       begin
 | |
|         if @dsl.on_system_blocks_exist?
 | |
|           [:arm, :intel].each do |arch|
 | |
|             MacOSVersions::SYMBOLS.each_key do |os_name|
 | |
|               bottle_tag = ::Utils::Bottles::Tag.new(system: os_name, arch: arch)
 | |
|               next unless bottle_tag.valid_combination?
 | |
| 
 | |
|               Homebrew::SimulateSystem.os = os_name
 | |
|               Homebrew::SimulateSystem.arch = arch
 | |
| 
 | |
|               refresh
 | |
| 
 | |
|               to_h.each do |key, value|
 | |
|                 next if hash_keys_to_skip.include? key
 | |
|                 next if value.to_s == hash[key].to_s
 | |
| 
 | |
|                 variations[bottle_tag.to_sym] ||= {}
 | |
|                 variations[bottle_tag.to_sym][key] = value
 | |
|               end
 | |
|             end
 | |
|           end
 | |
|         end
 | |
|       ensure
 | |
|         Homebrew::SimulateSystem.clear
 | |
|       end
 | |
| 
 | |
|       refresh
 | |
| 
 | |
|       hash["variations"] = variations
 | |
|       hash
 | |
|     end
 | |
| 
 | |
|     private
 | |
| 
 | |
|     def api_to_local_hash(hash)
 | |
|       hash["token"] = token
 | |
|       hash["installed"] = versions.last
 | |
|       hash["outdated"] = outdated?
 | |
|       hash
 | |
|     end
 | |
| 
 | |
|     def artifacts_list
 | |
|       artifacts.map do |artifact|
 | |
|         case artifact
 | |
|         when Artifact::AbstractFlightBlock
 | |
|           # Only indicate whether this block is used as we don't load it from the API
 | |
|           { artifact.summarize => nil }
 | |
|         else
 | |
|           { artifact.class.dsl_key => artifact.to_args }
 | |
|         end
 | |
|       end
 | |
|     end
 | |
|   end
 | |
| end
 | 
