Module: Pod::Downloader

Defined in:
lib/cocoapods/downloader.rb,
lib/cocoapods/downloader/cache.rb,
lib/cocoapods/downloader/request.rb,
lib/cocoapods/downloader/response.rb

Defined Under Namespace

Classes: Base, Cache, DownloaderError, Request, Response

Class Method Summary collapse

Class Method Details

.download(request, target, can_cache: true, cache_path: Config.instance.cache_root + 'Pods') ⇒ Response

Downloads a pod from the given request to the given target location.

Parameters:

  • request (Request)

    the request that describes this pod download.

  • target (Pathname, Nil)

    the location to which this pod should be downloaded. If nil, then the pod will only be cached.

  • can_cache (Boolean)

    whether caching is allowed.

  • cache_path (Pathname, Nil)

    the path used to cache pod downloads.

Returns:

  • (Response)

    The download response for this download.



29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
# File 'lib/cocoapods/downloader.rb', line 29

def self.download(
  request,
  target,
  can_cache: true,
  cache_path: Config.instance.cache_root + 'Pods'
)
  can_cache &&= !Config.instance.skip_download_cache
  if can_cache
    raise ArgumentError, 'Must provide a `cache_path` when caching.' unless cache_path
    cache = Cache.new(cache_path)
    result = cache.download_pod(request)
  else
    require 'cocoapods/installer/pod_source_preparer'
    result, = download_request(request, target)
    Installer::PodSourcePreparer.new(result.spec, result.location).prepare!
  end

  if target && result.location && target != result.location
    UI.message "Copying #{request.name} from `#{result.location}` to #{UI.path target}", '> ' do
      FileUtils.rm_rf target
      FileUtils.cp_r(result.location, target)
    end
  end
  result
end

.download_request(request, target) ⇒ Response, Hash<String,Specification>

Performs the download from the given request to the given target location.

Parameters:

  • request (Request)

    the request that describes this pod download.

  • target (Pathname, Nil)

    the location to which this pod should be downloaded. If nil, then the pod will only be cached.

Returns:

  • (Response, Hash<String,Specification>)

    The download response for this download, and the specifications for this download grouped by name.



68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
# File 'lib/cocoapods/downloader.rb', line 68

def self.download_request(request, target)
  result = Response.new
  result.checkout_options = download_source(target, request.params)
  result.location = target

  if request.released_pod?
    result.spec = request.spec
    podspecs = { request.name => request.spec }
  else
    podspecs = Sandbox::PodspecFinder.new(target).podspecs
    podspecs[request.name] = request.spec if request.spec
    podspecs.each do |name, spec|
      if request.name == name
        result.spec = spec
      end
    end
  end

  [result, podspecs]
end

.download_source(target, params) ⇒ Hash (private)

Downloads a pod with the given params to target.

Parameters:

  • target (Pathname)
  • params (Hash<Symbol,String>)

Returns:

  • (Hash)

    The checkout options required to re-download this exact same source.



100
101
102
103
104
105
106
107
108
109
110
111
# File 'lib/cocoapods/downloader.rb', line 100

def self.download_source(target, params)
  FileUtils.rm_rf(target)
  downloader = Downloader.for_target(target, params)
  downloader.download
  target.mkpath

  if downloader.options_specific?
    params
  else
    downloader.checkout_options
  end
end