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?, #shutup!, #stage

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.



308
309
310
# File 'download_strategy.rb', line 308

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

#cached_locationObject

Path for storing the completed download.



294
295
296
297
298
299
300
301
302
303
304
305
306
# File 'download_strategy.rb', line 294

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}--#{resolved_basename}"
  end
end

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



284
285
286
287
288
289
# File 'download_strategy.rb', line 284

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

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

#temporary_pathObject

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



276
277
278
# File 'download_strategy.rb', line 276

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