Class: Pod::Source

Inherits:
Object
  • Object
show all
Defined in:
lib/cocoapods-core/source.rb,
lib/cocoapods-core/source/acceptor.rb,
lib/cocoapods-core/source/aggregate.rb,
lib/cocoapods-core/source/health_reporter.rb

Overview

The Source class is responsible to manage a collection of podspecs.

The backing store of the podspecs collection is an implementation detail abstracted from the rest of CocoaPods.

The default implementation uses a git repo as a backing store, where the podspecs are namespaced as:

"#{SPEC_NAME}/#{VERSION}/#{SPEC_NAME}.podspec"

Defined Under Namespace

Classes: Acceptor, Aggregate, HealthReporter

Instance Attribute Summary collapse

Queering the source collapse

Searching the source collapse

Representations collapse

Instance Method Summary collapse

Constructor Details

#initialize(repo) ⇒ Source

Returns a new instance of Source.

Parameters:

  • repo (Pathname, String) —

    @see #repo.



25
26
27
 
# File 'lib/cocoapods-core/source.rb', line 25

def initialize(repo)
  @repo = Pathname.new(repo)
end

Instance Attribute Details

#repo ⇒ Pathname (readonly)

Returns the location of the repo of the source.

Returns:

  • (Pathname) —

    the location of the repo of the source.



21
22
23
 
# File 'lib/cocoapods-core/source.rb', line 21

def repo
  @repo
end

Instance Method Details

#<=>(other) ⇒ Integer

Note:

Source are compared by the alphabetical order of their name, and this convention should be used in any case where sources need to be disambiguated.

Returns compares a source with another one for sorting purposes.

Returns:

  • (Integer) —

    compares a source with another one for sorting purposes.



44
45
46
 
# File 'lib/cocoapods-core/source.rb', line 44

def <=>(other)
  name <=> other.name
end

#all_specs ⇒ Array<Specification>

Returns all the specifications contained by the source.

Returns:

  • (Array<Specification>) —

    all the specifications contained by the source.



130
131
132
133
134
135
136
137
138
139
140
 
# File 'lib/cocoapods-core/source.rb', line 130

def all_specs
  specs = pods.map do |name|
    begin
      versions(name).map { |version| specification(name, version) }
    rescue
      CoreUI.warn "Skipping `#{name}` because the podspec contains errors."
      next
    end
  end
  specs.flatten.compact
end

#fuzzy_search(query) ⇒ Set, Nil

Returns the set of the Pod whose name fuzzily matches the given query.

Parameters:

  • query (String) —

    The query to search for.

Returns:

  • (Set) —

    The name of the Pod.

  • (Nil) —

    If no Pod with a suitable name was found.



200
201
202
203
204
205
206
 
# File 'lib/cocoapods-core/source.rb', line 200

def fuzzy_search(query)
  require 'fuzzy_match'
  pod_name = FuzzyMatch.new(pods).find(query)
  if pod_name
    search(pod_name)
  end
end

#name ⇒ String Also known as: to_s

Returns the name of the source.

Returns:

  • (String) —

    the name of the source.



31
32
33
 
# File 'lib/cocoapods-core/source.rb', line 31

def name
  repo.basename.to_s
end

#pod_sets ⇒ Array<Sets>

Returns the sets of all the Pods.

Returns:

  • (Array<Sets>) —

    the sets of all the Pods.



77
78
79
 
# File 'lib/cocoapods-core/source.rb', line 77

def pod_sets
  pods.map { |pod_name| set(pod_name) }
end

#pods ⇒ Array<String>

Note:

Using Pathname#children is sensibly slower.

Returns the list of the name of all the Pods.

Returns:

  • (Array<String>) —

    the list of the name of all the Pods.



56
57
58
59
60
61
62
 
# File 'lib/cocoapods-core/source.rb', line 56

def pods
  specs_dir_as_string = specs_dir.to_s
  Dir.entries(specs_dir).select do |entry|
    valid_name = !(entry == '.' || entry == '..' || entry == '.git')
    valid_name && File.directory?(File.join(specs_dir_as_string, entry))
  end
end

#search(query) ⇒ Set

TODO:

Rename to #load_set

Returns a set for a given dependency. The set is identified by the name of the dependency and takes into account subspecs.

Returns:

  • (Set) —

    a set for a given dependency. The set is identified by the name of the dependency and takes into account subspecs.



151
152
153
154
155
156
157
158
159
160
 
# File 'lib/cocoapods-core/source.rb', line 151

def search(query)
  if query.is_a?(Dependency)
    name = query.root_name
  else
    name = query
  end
  pod_sets.find do |set|
    set.name == name
  end
end

#search_by_name(query, full_text_search = false) ⇒ Array<Set>

Note:

full text search requires to load the specification for each pod, hence is considerably slower.

Returns The list of the sets that contain the search term.

Parameters:

  • query (String) —

    the search term.

  • full_text_search (Bool) (defaults to: false) —

    whether the search should be limited to the name of the Pod or should include also the author, the summary, and the description.

Returns:

  • (Array<Set>) —

    The list of the sets that contain the search term.



174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
 
# File 'lib/cocoapods-core/source.rb', line 174

def search_by_name(query, full_text_search = false)
  if full_text_search
    pod_sets.map do |set|
      begin
        s = set.specification
        text = "#{s.name} #{s.authors} #{s.summary} #{s.description}"
      rescue
        CoreUI.warn "Skipping `#{set.name}` because the podspec " \
          "contains errors."
      end
      set if text && text.downcase.include?(query.downcase)
    end.compact
  else
    names = pods.select { |name| name.downcase.include?(query.downcase) }
    names.map { |pod_name| set(pod_name) }
  end
end

#set(pod_name) ⇒ Sets

Returns the set for the Pod with the given name.

Parameters:

  • pod_name (String) —

    The name of the Pod.

Returns:

  • (Sets) —

    the set.



71
72
73
 
# File 'lib/cocoapods-core/source.rb', line 71

def set(pod_name)
  Specification::Set.new(pod_name, self)
end

#specification(name, version) ⇒ Specification

Returns the specification for a given version of Pod.

Parameters:

  • @see —

    specification_path

Returns:

  • (Specification) —

    the specification for a given version of Pod.



100
101
102
 
# File 'lib/cocoapods-core/source.rb', line 100

def specification(name, version)
  Specification.from_file(specification_path(name, version))
end

#specification_path(name, version) ⇒ Pathname

Returns the path of the specification with the given name and version.

Parameters:

  • name (String) —

    the name of the Pod.

  • version (Version, String) —

    the version for the specification.

Returns:

  • (Pathname) —

    The path of the specification.



114
115
116
117
118
119
120
121
122
123
124
125
 
# File 'lib/cocoapods-core/source.rb', line 114

def specification_path(name, version)
  path = specs_dir + name + version.to_s
  specification_path = path + "#{name}.podspec.yaml"
  unless specification_path.exist?
    specification_path = path + "#{name}.podspec"
  end
  unless specification_path.exist?
    raise StandardError, "Unable to find the specification #{name} " \
      "(#{version}) in the #{name} source."
  end
  specification_path
end

#to_hash ⇒ Hash{String=>{String=>Specification}}

Returns the static representation of all the specifications grouped first by name and then by version.

Returns:

  • (Hash{String=>{String=>Specification}}) —

    the static representation of all the specifications grouped first by name and then by version.



216
217
218
219
220
221
222
223
 
# File 'lib/cocoapods-core/source.rb', line 216

def to_hash
  hash = {}
  all_specs.each do |spec|
    hash[spec.name] ||= {}
    hash[spec.name][spec.version.version] = spec.to_hash
  end
  hash
end

#to_yaml ⇒ String

Returns the YAML encoded #to_hash representation.

Returns:

  • (String) —

    the YAML encoded #to_hash representation.



227
228
229
230
 
# File 'lib/cocoapods-core/source.rb', line 227

def to_yaml
  require 'yaml'
  to_hash.to_yaml
end

#versions(name) ⇒ Array<Version>

Returns all the available versions for the Pod, sorted from highest to lowest.

Parameters:

  • name (String) —

    the name of the Pod.

Returns:

  • (Array<Version>) —

    all the available versions for the Pod, sorted from highest to lowest.



87
88
89
90
91
92
93
94
 
# File 'lib/cocoapods-core/source.rb', line 87

def versions(name)
  pod_dir = specs_dir + name
  return unless pod_dir.exist?
  pod_dir.children.map do |v|
    basename = v.basename.to_s
    Version.new(basename) if v.directory? && basename[0, 1] != '.'
  end.compact.sort.reverse
end