Class: Pod::Source::Manager

Inherits:
Object
  • Object
show all
Defined in:
lib/cocoapods/sources_manager.rb

Updating Sources collapse

Instance Method Summary collapse

Instance Method Details

#add_source(source) ⇒ Object

Adds the provided source to the list of sources

Parameters:

  • source (Source)

    the source to add


140
141
142
# File 'lib/cocoapods/sources_manager.rb', line 140

def add_source(source)
  all << source unless all.any? { |s| s.url == source || s.name == source.name }
end

#cdn_url?(url) ⇒ Boolean

Determines whether `url` is a CocoaPods CDN URL.

Parameters:

  • url (String)

    The URL of the source.

Returns:

  • (Boolean)

    whether `url` is a CocoaPods CDN URL,


70
71
72
73
74
75
# File 'lib/cocoapods/sources_manager.rb', line 70

def cdn_url?(url)
  url =~ %r{^https:\/\/} &&
    REST.head(url + '/all_pods.txt').ok?
rescue => e
  raise Informative, "Couldn't determine repo type for URL: `#{url}`: #{e}"
end

#create_source_with_url(url) ⇒ Source

Adds the source whose Source#url is equal to `url`, in a manner similarly to `pod repo add` if it is not found.

Parameters:

  • url (String)

    The URL of the source.

Returns:

  • (Source)

    The source whose Source#url is equal to `url`,

Raises:

  • If no source with the given `url` could be created,


32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
# File 'lib/cocoapods/sources_manager.rb', line 32

def create_source_with_url(url)
  name = name_for_url(url)
  is_cdn = cdn_url?(url)

  # Hack to ensure that `repo add` output is shown.
  previous_title_level = UI.title_level
  UI.title_level = 0

  begin
    if is_cdn
      Command::Repo::AddCDN.parse([name, url]).run
    else
      Command::Repo::Add.parse([name, url]).run
    end
  rescue Informative => e
    message = "Unable to add a source with url `#{url}` " \
      "named `#{name}`.\n"
    message << "(#{e})\n" if Config.instance.verbose?
    message << 'You can try adding it manually in ' \
      "`#{Config.instance.repos_dir}` or via `pod repo add`."
    raise Informative, message
  ensure
    UI.title_level = previous_title_level
  end
  source = source_with_url(url)

  raise "Unable to create a source with URL #{url}" unless source

  source
end

#find_or_create_source_with_url(url) ⇒ Source

Returns the source whose Source#url is equal to `url`, adding the repo in a manner similarly to `pod repo add` if it is not found.

Parameters:

  • url (String)

    The URL of the source.

Returns:

  • (Source)

    The source whose Source#url is equal to `url`,

Raises:

  • If no source with the given `url` could be created,


18
19
20
# File 'lib/cocoapods/sources_manager.rb', line 18

def find_or_create_source_with_url(url)
  source_with_url(url) || create_source_with_url(url)
end

#search_index_pathPathname

Returns The path where the search index should be stored.

Returns:

  • (Pathname)

    The path where the search index should be stored.


93
94
95
# File 'lib/cocoapods/sources_manager.rb', line 93

def search_index_path
  @search_index_path ||= Config.instance.search_index_file
end

#source_with_name_or_url(name_or_url) ⇒ Source

Returns the source whose Source#name or Source#url is equal to the given `name_or_url`.

Parameters:

  • name_or_url (String)

    The name or the URL of the source.

Returns:

  • (Source)

    The source whose Source#name or Source#url is equal to the given `name_or_url`.


86
87
88
89
# File 'lib/cocoapods/sources_manager.rb', line 86

def source_with_name_or_url(name_or_url)
  all.find { |s| s.name == name_or_url } ||
    find_or_create_source_with_url(name_or_url)
end

#update(source_name = nil, show_output = false) ⇒ void

This method returns an undefined value.

Updates the local clone of the spec-repo with the given name or of all the git repos if the name is omitted.

Parameters:

  • source_name (String) (defaults to: nil)
  • show_output (Bool) (defaults to: false)

108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
# File 'lib/cocoapods/sources_manager.rb', line 108

def update(source_name = nil, show_output = false)
  if source_name
    sources = [updateable_source_named(source_name)]
  else
    sources = updateable_sources
  end

  changed_spec_paths = {}

  # Do not perform an update if the repos dir has not been setup yet.
  return unless repos_dir.exist?

  # Create the Spec_Lock file if needed and lock it so that concurrent
  # repo updates do not cause each other to fail
  File.open("#{repos_dir}/Spec_Lock", File::CREAT) do |f|
    f.flock(File::LOCK_EX)
    sources.each do |source|
      UI.section "Updating spec repo `#{source.name}`" do
        changed_source_paths = source.update(show_output)
        changed_spec_paths[source] = changed_source_paths if changed_source_paths.count > 0
        source.verify_compatibility!
      end
    end
  end
  # Perform search index update operation in background.
  update_search_index_if_needed_in_background(changed_spec_paths)
end