Class: AbstractFileDownloadStrategy Abstract Private

Inherits:
AbstractDownloadStrategy show all
Defined in:
download_strategy.rb

Overview

This class is part of a private API. This class may only be used in the Homebrew/brew repository. Third parties should avoid using this class if possible, as it may be removed or changed without warning.

This class is abstract.

Abstract superclass for all download strategies downloading a single file.

Instance Attribute Summary

Attributes inherited from AbstractDownloadStrategy

#cache, #source_modified_time, #url

Instance Method Summary collapse

Methods inherited from AbstractDownloadStrategy

#clear_cache, #fetch, #initialize, #quiet!, #quiet?, #shutup!, #stage

Methods included from SystemCommand::Mixin

#system_command, #system_command!

Methods included from Context

current, current=, #debug?, #quiet?, #verbose?, #with_context

Constructor Details

This class inherits a constructor from AbstractDownloadStrategy

Instance Method Details

#basenameObject

This method is part of a private API. This method may only be used in the Homebrew/brew repository. Third parties should avoid using this method if possible, as it may be removed or changed without warning.



319
320
321
# File 'download_strategy.rb', line 319

def basename
  cached_location.basename.sub(/^[\da-f]{64}--/, "")
end

#cached_locationObject

Path for storing the completed download.



305
306
307
308
309
310
311
312
313
314
315
316
317
# File 'download_strategy.rb', line 305

def cached_location
  return @cached_location if defined?(@cached_location)

  url_sha256 = Digest::SHA256.hexdigest(url)
  downloads = Pathname.glob(HOMEBREW_CACHE/"downloads/#{url_sha256}--*")
                      .reject { |path| path.extname.end_with?(".incomplete") }

  @cached_location = if downloads.count == 1
    downloads.first
  else
    HOMEBREW_CACHE/"downloads/#{url_sha256}--#{Utils.safe_filename(resolved_basename)}"
  end
end

Path of the symlink (whose name includes the resource name, version and extension) pointing to #cached_location.



295
296
297
298
299
300
# File 'download_strategy.rb', line 295

def symlink_location
  return @symlink_location if defined?(@symlink_location)

  ext = Pathname(parse_basename(url)).extname
  @symlink_location = @cache/Utils.safe_filename("#{name}--#{version}#{ext}")
end

#temporary_pathObject

Path for storing an incomplete download while the download is still in progress.



287
288
289
# File 'download_strategy.rb', line 287

def temporary_path
  @temporary_path ||= Pathname.new("#{cached_location}.incomplete")
end