Class: Pod::Specification

Inherits:
Object
  • Object
show all
Includes:
DSL, DSL::Deprecations, RootAttributesAccessors, YAMLSupport
Defined in:
lib/cocoapods-core/specification.rb,
lib/cocoapods-core/specification/dsl.rb,
lib/cocoapods-core/specification/set.rb,
lib/cocoapods-core/specification/yaml.rb,
lib/cocoapods-core/specification/linter.rb,
lib/cocoapods-core/specification/consumer.rb,
lib/cocoapods-core/specification/dsl/attribute.rb,
lib/cocoapods-core/specification/set/presenter.rb,
lib/cocoapods-core/specification/set/statistics.rb,
lib/cocoapods-core/specification/dsl/deprecations.rb,
lib/cocoapods-core/specification/dsl/platform_proxy.rb,
lib/cocoapods-core/specification/dsl/attribute_support.rb,
lib/cocoapods-core/specification/root_attribute_accessors.rb

Overview

The Specification provides a DSL to describe a Pod. A pod is defined as a library originating from a source. A specification can support detailed attributes for modules of code through subspecs.

Usually it is stored in files with ‘podspec` extension.

Defined Under Namespace

Modules: DSL, YAMLSupport Classes: Consumer, Linter, Set

Constant Summary

Constants included from DSL

DSL::LICENSE_KEYS, DSL::PLATFORMS, DSL::SOURCE_KEYS

Deprecated Hooks support collapse

Instance Attribute Summary collapse

Hierarchy collapse

Dependencies & Subspecs collapse

DSL helpers collapse

Deprecated Hooks support collapse

DSL attribute writers collapse

File representation collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from YAMLSupport

#safe_to_hash?, #to_hash, #to_yaml

Methods included from DSL::Deprecations

#clean_paths=, #documentation=, #post_install, #pre_install, #preferred_dependency=, #singleton_method_added

Methods included from DSL

attributes, #authors=, #compiler_flags=, #default_subspec=, #dependency, #deployment_target=, #description=, #documentation_url=, #exclude_files=, #frameworks=, #header_dir=, #header_mappings_dir=, #homepage=, #ios, #libraries=, #license=, #name=, #osx, #platform=, #prefix_header_contents=, #prefix_header_file=, #prepare_command=, #preserve_paths=, #private_header_files=, #public_header_files=, #requires_arc=, #resource_bundles=, #resources=, #screenshots=, #source=, #source_files=, #subspec, #summary=, #vendored_frameworks=, #vendored_libraries=, #version=, #weak_frameworks=, #xcconfig=

Methods included from DSL::AttributeSupport

#attribute, #root_attribute

Constructor Details

#initialize(parent = nil, name = nil) {|_self| ... } ⇒ Specification

Returns a new instance of Specification.

Parameters:

  • parent (Specification) (defaults to: nil) —

    @see parent

  • name (String) (defaults to: nil) —

    the name of the specification.

Yields:

  • (_self)

Yield Parameters:



33
34
35
36
37
38
39
40
41
 
# File 'lib/cocoapods-core/specification.rb', line 33

def initialize(parent = nil, name = nil)
  @attributes_hash = {}
  @subspecs = []
  @consumers = {}
  @parent = parent
  attributes_hash['name'] = name

  yield self if block_given?
end

Instance Attribute Details

#attributes_hash ⇒ Hash

Returns the hash that stores the information of the attributes of the specification.

Returns:

  • (Hash) —

    the hash that stores the information of the attributes of the specification.



46
47
48
 
# File 'lib/cocoapods-core/specification.rb', line 46

def attributes_hash
  @attributes_hash
end

#parent ⇒ Specification (readonly)

Returns the parent of the specification unless the specification is a root.

Returns:

  • (Specification) —

    the parent of the specification unless the specification is a root.



26
27
28
 
# File 'lib/cocoapods-core/specification.rb', line 26

def parent
  @parent
end

#post_install_callback ⇒ Proc (readonly)

Returns the post install callback if defined.

Returns:

  • (Proc) —

    the post install callback if defined.



386
387
388
 
# File 'lib/cocoapods-core/specification.rb', line 386

def post_install_callback
  @post_install_callback
end

#pre_install_callback ⇒ Proc (readonly)

Returns the pre install callback if defined.

Returns:

  • (Proc) —

    the pre install callback if defined.



382
383
384
 
# File 'lib/cocoapods-core/specification.rb', line 382

def pre_install_callback
  @pre_install_callback
end

#subspecs ⇒ Array<Specification>

Returns The subspecs of the specification.

Returns:



50
51
52
 
# File 'lib/cocoapods-core/specification.rb', line 50

def subspecs
  @subspecs
end

Class Method Details

.from_file(path, subspec_name = nil) ⇒ Specification

Loads a specification form the given path.

Parameters:

  • path (Pathname, String) —

    the path of the ‘podspec` file.

  • subspec_name (String) (defaults to: nil) —

    the name of the specification that should be returned. If it is nil returns the root specification.

Returns:

Raises:

  • If the file doesn’t return a Pods::Specification after evaluation.



528
529
530
531
532
533
534
535
536
537
538
539
540
541
 
# File 'lib/cocoapods-core/specification.rb', line 528

def self.from_file(path, subspec_name = nil)
  path = Pathname.new(path)
  unless path.exist?
    raise Informative, "No podspec exists at path `#{path}`."
  end

  string = File.open(path, 'r:utf-8')  { |f| f.read }
  # Work around for Rubinius incomplete encoding in 1.9 mode
  if string.respond_to?(:encoding) && string.encoding.name != "UTF-8"
    string.encode!('UTF-8')
  end

  from_string(string, path, subspec_name)
end

.from_hash(hash, parent = nil) ⇒ Specification

Configures a new specification from the given hash.

Parameters:

  • the (Hash) —

    hash which contains the information of the specification.

Returns:



36
37
38
39
40
41
42
43
44
45
 
# File 'lib/cocoapods-core/specification/yaml.rb', line 36

def self.from_hash(hash, parent = nil)
  spec = Spec.new(parent)
  attributes_hash = hash.dup
  subspecs = attributes_hash.delete('subspecs')
  spec.attributes_hash = attributes_hash
  if subspecs
    spec.subspecs = subspecs.map { |s_hash| Specification.from_hash(s_hash, spec) }
  end
  spec
end

.from_string(spec_contents, path, subspec_name = nil) ⇒ Specification

Loads a specification with the given string.

Parameters:

  • spec_contents (String) —

    A string describing a specification.

  • path (Pathname, String) —

    @see from_file

  • subspec_name (String) (defaults to: nil) —

    @see from_file

Returns:



553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
 
# File 'lib/cocoapods-core/specification.rb', line 553

def self.from_string(spec_contents, path, subspec_name = nil)
  path = Pathname.new(path)
  case path.extname
  when '.podspec'
    spec = ::Pod._eval_podspec(spec_contents, path)
    unless spec.is_a?(Specification)
      raise Informative, "Invalid podspec file at path `#{path}`."
    end
  when '.yaml'
    spec = Specification.from_yaml(spec_contents)
  else
    raise Informative, "Unsupported specification format `#{path.extname}`."
  end

  spec.defined_in_file = path
  spec.subspec_by_name(subspec_name)
end

.from_yaml(yaml) ⇒ Specification

Configures a new specification from the given YAML representation.

Parameters:

  • the (String) —

    YAML encoded hash which contains the information of the specification.

Returns:



55
56
57
58
 
# File 'lib/cocoapods-core/specification/yaml.rb', line 55

def self.from_yaml(yaml)
  hash = YAML.load(yaml)
  from_hash(hash)
end

.name_and_version_from_string(string_representation) ⇒ Array<String, Version>

Returns the name and the version of a pod.

Examples:

Input examples


"libPusher (1.0)"
"libPusher (HEAD based on 1.0)"
"RestKit/JSON (1.0)"

Parameters:

Returns:

  • (Array<String, Version>) —

    the name and the version of a pod.



126
127
128
129
130
131
132
133
134
 
# File 'lib/cocoapods-core/specification.rb', line 126

def self.name_and_version_from_string(string_representation)
  match_data = string_representation.match(/(\S*) \((.*)\)/)
  unless match_data
    raise Informative, "Invalid string representation for a Specification: `#{string_representation}`."
  end
  name = match_data[1]
  vers = Version.new(match_data[2])
  [name, vers]
end

.root_name(full_name) ⇒ String

Returns the root name of a specification.

Parameters:

  • the (String) —

    name of a specification or of a subspec.

Returns:

  • (String) —

    the root name



142
143
144
 
# File 'lib/cocoapods-core/specification.rb', line 142

def self.root_name(full_name)
  full_name.split('/').first
end

Instance Method Details

#==(other) ⇒ Bool

TODO:

Not sure if comparing only the name and the version is the way to go. This is used by the installer to group specifications by root spec.

Checks if a specification is equal to the given one according its name and to its version.

Parameters:

Returns:

  • (Bool) —

    Whether the specifications are equal.



64
65
66
67
68
69
70
71
72
 
# File 'lib/cocoapods-core/specification.rb', line 64

def ==(other)
  # TODO
  # self.class === other &&
  #   attributes_hash == other.attributes_hash &&
  #   subspecs == other.subspecs &&
  #   pre_install_callback == other.pre_install_callback &&
  #   post_install_callback == other.post_install_callback
  self.to_s == other.to_s
end

#all_dependencies(platform = nil) ⇒ Array<Dependency>

Returns all the dependencies of the specification.

Returns:

  • (Array<Dependency>) —

    all the dependencies of the specification.



264
265
266
 
# File 'lib/cocoapods-core/specification.rb', line 264

def all_dependencies(platform = nil)
  dependencies(platform) + subspec_dependencies(platform)
end

#available_platforms ⇒ Array<Platform>

Note:

If no platform is specified, this method returns all known platforms.

Returns The platforms that the Pod is supported on.

Returns:

  • (Array<Platform>) —

    The platforms that the Pod is supported on.



319
320
321
322
323
 
# File 'lib/cocoapods-core/specification.rb', line 319

def available_platforms
  names = supported_platform_names
  names = PLATFORMS if names.empty?
  names.map { |name| Platform.new(name, deployment_target(name)) }
end

#checksum ⇒ String, Nil

Returns:

  • (String) —

    The SHA1 digest of the file in which the specification is defined.

  • (Nil) —

    If the specification is not defined in a file.



498
499
500
501
502
503
504
505
 
# File 'lib/cocoapods-core/specification.rb', line 498

def checksum
  require 'digest'
  unless defined_in_file.nil?
    checksum = Digest::SHA1.hexdigest(File.read(defined_in_file))
    checksum = checksum.encode('UTF-8') if checksum.respond_to?(:encode)
    checksum
  end
end

#consumer(platform) ⇒ Specification::Consumer

Returns a consumer to access the multi-platform attributes.

Parameters:

  • platform (String, Symbol, Platform) —

    he platform of the consumer

Returns:



275
276
277
278
 
# File 'lib/cocoapods-core/specification.rb', line 275

def consumer(platform)
  platform = platform.to_sym
  @consumers[platform] ||= Consumer.new(self, platform)
end

#default_subspec ⇒ String

Returns the name of the default subspec if provided.

Returns:

  • (String) —

    the name of the default subspec if provided.



218
219
220
 
# File 'lib/cocoapods-core/specification.rb', line 218

def default_subspec
  attributes_hash["default_subspec"]
end

#defined_in_file ⇒ String

Returns the path where the specification is defined, if loaded from a file.

Returns:

  • (String) —

    the path where the specification is defined, if loaded from a file.



510
511
512
 
# File 'lib/cocoapods-core/specification.rb', line 510

def defined_in_file
  root? ? @defined_in_file : root.defined_in_file
end

#dependencies(platform = nil) ⇒ Array<Dependency>

Note:

External dependencies are inherited by subspecs

Returns the dependencies on other Pods or subspecs of other Pods.

Parameters:

  • all_platforms (Bool) —

    whether the dependencies should be returned for all platforms instead of the active one.

Returns:

  • (Array<Dependency>) —

    the dependencies on other Pods.



252
253
254
255
256
257
258
259
260
 
# File 'lib/cocoapods-core/specification.rb', line 252

def dependencies(platform = nil)
  if platform
    consumer(platform).dependencies || []
  else
    available_platforms.map do |spec_platform|
      consumer(spec_platform).dependencies
    end.flatten.uniq
  end
end

#deployment_target(platform_name) ⇒ String, Nil

Returns the deployment target for the specified platform.

Parameters:

  • platform_name (String) —

    the symbolic name of the platform.

Returns:

  • (String) —

    the deployment target

  • (Nil) —

    if not deployment target was specified for the platform.



333
334
335
336
337
 
# File 'lib/cocoapods-core/specification.rb', line 333

def deployment_target(platform_name)
  result = platform_hash[platform_name.to_s]
  result ||= parent.deployment_target(platform_name) if parent
  result
end

#eql?(other) ⇒ Boolean

Returns:

  • (Boolean)

See Also:



76
77
78
 
# File 'lib/cocoapods-core/specification.rb', line 76

def eql?(other)
  self == other
end

#hash ⇒ Fixnum

Note:

This function must have the property that a.eql?(b) implies a.hash == b.hash.

Note:

This method is used by the Hash class.

Return the hash value for this specification according to its attributes hash.

Returns:

  • (Fixnum) —

    The hash value.



90
91
92
 
# File 'lib/cocoapods-core/specification.rb', line 90

def hash
  to_s.hash
end

#inspect ⇒ String

Returns A string suitable for debugging.

Returns:

  • (String) —

    A string suitable for debugging.



109
110
111
 
# File 'lib/cocoapods-core/specification.rb', line 109

def inspect
  "#<#{self.class.name} name=#{name.inspect}>"
end

#local? ⇒ Bool

Returns whether the specification should use a directory as it source.

Returns:

  • (Bool) —

    whether the specification should use a directory as it source.



289
290
291
 
# File 'lib/cocoapods-core/specification.rb', line 289

def local?
  !!(source[:path] || source[:local]) rescue false
end

#post_install!(target_installer) ⇒ Bool

Calls the post install callback if defined.

Parameters:

  • target_installer (Pod::TargetInstaller) —

    the target installer that is performing the installation of the pod.

Returns:

  • (Bool) —

    whether a post install callback was specified and it was called.



416
417
418
419
420
 
# File 'lib/cocoapods-core/specification.rb', line 416

def post_install!(target_installer)
  return false unless @post_install_callback
  @post_install_callback.call(target_installer)
  true
end

#pre_install!(pod, target_definition) ⇒ Bool

Calls the pre install callback if defined.

Parameters:

  • pod (Pod::LocalPod) —

    the local pod instance that manages the files described by this specification.

  • target_definition (Podfile::TargetDefinition) —

    the target definition that required this specification as a dependency.

Returns:

  • (Bool) —

    whether a pre install callback was specified and it was called.



401
402
403
404
405
 
# File 'lib/cocoapods-core/specification.rb', line 401

def pre_install!(pod, target_definition)
  return false unless @pre_install_callback
  @pre_install_callback.call(pod, target_definition)
  true
end

#recursive_subspecs ⇒ Array<Specifications>

Returns the recursive list of all the subspecs of a specification.

Returns:

  • (Array<Specifications>) —

    the recursive list of all the subspecs of a specification.



179
180
181
182
183
184
185
186
 
# File 'lib/cocoapods-core/specification.rb', line 179

def recursive_subspecs
  mapper = lambda do |spec|
    spec.subspecs.map do |subspec|
      [subspec, *mapper.call(subspec)]
    end.flatten
  end
  mapper.call(self)
end

#root ⇒ Specification

Returns The root specification or itself if it is root.

Returns:

  • (Specification) —

    The root specification or itself if it is root.



154
155
156
 
# File 'lib/cocoapods-core/specification.rb', line 154

def root
  parent ? parent.root : self
end

#root? ⇒ Bool

Returns whether the specification is root.

Returns:

  • (Bool) —

    whether the specification is root.



160
161
162
 
# File 'lib/cocoapods-core/specification.rb', line 160

def root?
  parent.nil?
end

#store_attribute(name, value, platform_name = nil) ⇒ Object

Note:

If the provides value is Hash the keys are converted to a string.

Sets the value for the attribute with the given name.

Parameters:

  • name (Symbol) —

    the name of the attribute.

  • value (Object) —

    the value to store.

  • platform. (Symbol) —

    If provided the attribute is stored only for the given platform.

Returns:

  • void



443
444
445
446
447
448
449
450
451
452
453
 
# File 'lib/cocoapods-core/specification.rb', line 443

def store_attribute(name, value, platform_name = nil)
  name = name.to_s
  value = convert_keys_to_string(value) if value.is_a?(Hash)
  if platform_name
    platform_name = platform_name.to_s
    attributes_hash[platform_name] ||= {}
    attributes_hash[platform_name][name] = value
  else
    attributes_hash[name] = value
  end
end

#subspec? ⇒ Bool

Returns whether the specification is a subspec.

Returns:

  • (Bool) —

    whether the specification is a subspec.



166
167
168
 
# File 'lib/cocoapods-core/specification.rb', line 166

def subspec?
  !parent.nil?
end

#subspec_by_name(relative_name) ⇒ Specification

Returns the subspec with the given name or the receiver if the name is nil or equal to the name of the receiver.

Examples:

Retrieving a subspec


s.subspec_by_name('Pod/subspec').name #=> 'subspec'

Parameters:

  • relative_name (String) —

    the relative name of the subspecs starting from the receiver including the name of the receiver.

Returns:



201
202
203
204
205
206
207
208
209
210
211
212
213
214
 
# File 'lib/cocoapods-core/specification.rb', line 201

def subspec_by_name(relative_name)
  if relative_name.nil? || relative_name == base_name
    self
  else
    remainder = relative_name[base_name.size+1..-1]
    subspec_name = remainder.split('/').shift
    subspec = subspecs.find { |s| s.name == "#{self.name}/#{subspec_name}" }
    unless subspec
      raise Informative, "Unable to find a specification named " \
        "`#{relative_name}` in `#{self.name} (#{self.version})`."
    end
    subspec.subspec_by_name(remainder)
  end
end

#subspec_dependencies(platform = nil) ⇒ Array<Dependency>

Note:

A specification has a dependency on either the #default_subspec or each of its children subspecs that are compatible with its platform.

Returns the dependencies on subspecs.

Returns:

  • (Array<Dependency>) —

    the dependencies on subspecs.



230
231
232
233
234
235
236
237
238
239
240
 
# File 'lib/cocoapods-core/specification.rb', line 230

def subspec_dependencies(platform = nil)
  if default_subspec
    specs = [subspec_by_name("#{name}/#{default_subspec}")]
  else
    specs = subspecs.compact
  end
  if platform
    specs = specs.select { |s| s.supported_on_platform?(platform) }
  end
  specs.map { |s| Dependency.new(s.name) }
end

#supported_on_platform?(platform) ⇒ Bool #supported_on_platform?(symbolic_name, deployment_target) ⇒ Bool

Returns whether the specification is supported in the given platform.

Overloads:

  • #supported_on_platform?(platform) ⇒ Bool

    Parameters:

    • platform (Platform) —

      the platform which is checked for support.

  • #supported_on_platform?(symbolic_name, deployment_target) ⇒ Bool

    Parameters:

    • symbolic_name (Symbol) —

      the name of the platform which is checked for support.

    • deployment_target (String) —

      the deployment target which is checked for support.

Returns:

  • (Bool) —

    whether the specification is supported in the given platform.



309
310
311
312
 
# File 'lib/cocoapods-core/specification.rb', line 309

def supported_on_platform?(*platform)
  platform = Platform.new(*platform)
  available_platforms.any? { |available| platform.supports?(available) }
end

#to_s ⇒ String

Returns A string suitable for representing the specification in clients.

Returns:

  • (String) —

    A string suitable for representing the specification in clients.



97
98
99
100
101
102
103
104
105
 
# File 'lib/cocoapods-core/specification.rb', line 97

def to_s
  if name && !version.version.empty?
    "#{name} (#{version})"
  elsif name
    name
  else
    "No-name"
  end
end