cocoapods-dependency-html 0.0.1

data/vendor/bundle/gems/cocoapods-core-1.6.1/lib/cocoapods-core/specification/consumer.rb

@@ -0,0 +1,418 @@
+require 'cocoapods-core/specification/root_attribute_accessors'
+
+module Pod
+  class Specification
+    # Allows to conveniently access a Specification programmatically.
+    #
+    # It takes care of:
+    #
+    # - standardizing the attributes
+    # - handling multi-platform values
+    # - handle default values
+    # - handle inherited values
+    #
+    # This class allows to store the values of the attributes in the
+    # Specification as specified in the DSL. The benefits is reduced reliance
+    # on meta programming to access the attributes and the possibility of
+    # serializing a specification back exactly as defined in a file.
+    #
+    class Consumer
+      # @return [Specification] The specification to consume.
+      #
+      attr_reader :spec
+
+      # @return [Symbol] The name of the platform for which the specification
+      #         needs to be consumed.
+      #
+      attr_reader :platform_name
+
+      # @param  [Specification] spec @see spec
+      # @param  [Symbol, Platform] platform
+      #         The platform for which the specification needs to be consumed.
+      #
+      def initialize(spec, platform)
+        @spec = spec
+        @platform_name = platform.is_a?(Symbol) ? platform : platform.name
+
+        unless spec.supported_on_platform?(platform)
+          raise StandardError, "#{self} is not compatible with #{platform}."
+        end
+      end
+
+      # Creates a method to access the contents of the attribute.
+      #
+      # @param  [Symbol] name
+      #         the name of the attribute.
+      #
+      # @macro  [attach]
+      #         @!method $1
+      #
+      def self.spec_attr_accessor(name)
+        define_method(name) do
+          value_for_attribute(name)
+        end
+      end
+
+      DSL::RootAttributesAccessors.instance_methods.each do |root_accessor|
+        define_method(root_accessor) do
+          spec.root.send(root_accessor)
+        end
+      end
+
+      #-----------------------------------------------------------------------#
+
+      # @!group Regular attributes
+
+      # @return [String] The name of the specification.
+      #
+      spec_attr_accessor :name
+
+      # @return [Bool] Whether the source files of the specification require to
+      #         be compiled with ARC.
+      #
+      spec_attr_accessor :requires_arc
+      alias_method :requires_arc?, :requires_arc
+
+      # @return [Array<String>] A list of frameworks that the user’s target
+      #         needs to link against
+      #
+      spec_attr_accessor :frameworks
+
+      # @return [Array<String>] A list of frameworks that the user’s target
+      #         needs to **weakly** link against
+      #
+      spec_attr_accessor :weak_frameworks
+
+      # @return [Array<String>] A list of libraries that the user’s target
+      #         needs to link against
+      #
+      spec_attr_accessor :libraries
+
+      # @return [Array<String>] the list of compiler flags needed by the
+      #         specification files.
+      #
+      spec_attr_accessor :compiler_flags
+
+      # @return [Hash{String => String}] the xcconfig flags for the current
+      #         specification for the pod target.
+      #
+      def pod_target_xcconfig
+        attr = Specification::DSL.attributes[:pod_target_xcconfig]
+        merge_values(attr, value_for_attribute(:xcconfig), value_for_attribute(:pod_target_xcconfig))
+      end
+
+      # @return [Hash{String => String}] the xcconfig flags for the current
+      #         specification for the user target.
+      #
+      def user_target_xcconfig
+        attr = Specification::DSL.attributes[:user_target_xcconfig]
+        merge_values(attr, value_for_attribute(:xcconfig), value_for_attribute(:user_target_xcconfig))
+      end
+
+      # @return [String] The contents of the prefix header.
+      #
+      spec_attr_accessor :prefix_header_contents
+
+      # @return [String] The path of the prefix header file.
+      #
+      spec_attr_accessor :prefix_header_file
+
+      # @return [String] the module name.
+      #
+      spec_attr_accessor :module_name
+
+      # @return [String] the path of the module map file.
+      #
+      spec_attr_accessor :module_map
+
+      # @return [String] the headers directory.
+      #
+      spec_attr_accessor :header_dir
+
+      # @return [String] the directory from where to preserve the headers
+      #         namespacing.
+      #
+      spec_attr_accessor :header_mappings_dir
+
+      #-----------------------------------------------------------------------#
+
+      # @!group Test Support
+
+      # @return [Bool] Whether this test specification requires an app host.
+      #
+      spec_attr_accessor :requires_app_host
+      alias_method :requires_app_host?, :requires_app_host
+
+      # @return [Symbol] the test type supported by this specification.
+      #
+      spec_attr_accessor :test_type
+
+      #-----------------------------------------------------------------------#
+
+      # @!group File patterns
+
+      # @return [Array<String>] the source files of the Pod.
+      #
+      spec_attr_accessor :source_files
+
+      # @return [Array<String>] the public headers of the Pod.
+      #
+      spec_attr_accessor :public_header_files
+
+      # @return [Array<String>] the private headers of the Pod.
+      #
+      spec_attr_accessor :private_header_files
+
+      # @return [Array<String>] The paths of the framework bundles shipped with
+      #         the Pod.
+      #
+      spec_attr_accessor :vendored_frameworks
+
+      # @return [Array<String>] The paths of the libraries shipped with the
+      #         Pod.
+      #
+      spec_attr_accessor :vendored_libraries
+
+      # @return [Hash{String=>String}]]  hash where the keys are the names of
+      #         the resource bundles and the values are their relative file
+      #         patterns.
+      #
+      spec_attr_accessor :resource_bundles
+
+      # @return [Array<Hash{Symbol=>String}>] An array of hashes where each hash
+      #         represents a script phase.
+      #
+      spec_attr_accessor :script_phases
+
+      # @return [Array<String>] A hash where the key represents the
+      #         paths of the resources to copy and the values the paths of
+      #         the resources that should be copied.
+      #
+      spec_attr_accessor :resources
+
+      # @return [Array<String>] The file patterns that the
+      #         Pod should ignore.
+      #
+      spec_attr_accessor :exclude_files
+
+      # @return [Array<String>] The paths that should be not
+      #         cleaned.
+      #
+      spec_attr_accessor :preserve_paths
+
+      #-----------------------------------------------------------------------#
+
+      # @return [Array<Dependency>] the dependencies on other Pods.
+      #
+      def dependencies
+        value = value_for_attribute(:dependencies)
+        value.map do |name, requirements|
+          Dependency.new(name, requirements)
+        end
+      end
+
+      # Raw values need to be prepared as soon as they are read so they can be
+      # safely merged to support multi platform attributes and inheritance
+      #-----------------------------------------------------------------------#
+
+      # Returns the value for the attribute with the given name for the
+      # specification. It takes into account inheritance, multi-platform
+      # attributes and default values.
+      #
+      # @param  [Symbol] attr_name
+      #         The name of the attribute.
+      #
+      # @return [String, Array, Hash] the value for the attribute.
+      #
+      def value_for_attribute(attr_name)
+        attr = Specification::DSL.attributes[attr_name]
+        value = value_with_inheritance(spec, attr)
+        value = attr.default(platform_name) if value.nil?
+        value = attr.container.new if value.nil? && attr.container
+        value
+      end
+
+      # Returns the value of a given attribute taking into account inheritance.
+      #
+      # @param  [Specification] the_spec
+      #         the specification for which the value is needed.
+      #
+      # @param  [Specification::DSL::Attribute] attr
+      #         the attribute for which that value is needed.
+      #
+      # @return [String, Array, Hash] the value for the attribute.
+      #
+      def value_with_inheritance(the_spec, attr)
+        value = raw_value_for_attribute(the_spec, attr)
+        if the_spec.root? || !attr.inherited?
+          return value
+        end
+
+        parent_value = value_with_inheritance(the_spec.parent, attr)
+        merge_values(attr, parent_value, value)
+      end
+
+      # Returns the value of a given attribute taking into account multi
+      # platform values.
+      #
+      # @param  [Specification] the_spec
+      #         the specification for which the value is needed.
+      #
+      # @param  [Specification::DSL::Attribute] attr
+      #         the attribute for which that value is needed.
+      #
+      # @return [String, Array, Hash] The value for an attribute.
+      #
+      def raw_value_for_attribute(the_spec, attr)
+        value = the_spec.attributes_hash[attr.name.to_s]
+        value = prepare_value(attr, value)
+
+        if attr.multi_platform?
+          if platform_hash = the_spec.attributes_hash[platform_name.to_s]
+            platform_value = platform_hash[attr.name.to_s]
+            platform_value = prepare_value(attr, platform_value)
+            value = merge_values(attr, value, platform_value)
+          end
+        end
+        value
+      end
+
+      # Merges the values of an attribute, either because the attribute is
+      # multi platform or because it is inherited.
+      #
+      # @param  [Specification::DSL::Attribute] attr
+      #         the attribute for which that value is needed.
+      #
+      # @param  [String, Array, Hash] existing_value
+      #         the current value (the value of the parent or non-multiplatform
+      #         value).
+      #
+      # @param  [String, Array, Hash] new_value
+      #         the value to append (the value of the spec or the
+      #         multi-platform value).
+      #
+      # @return [String, Array, Hash] The merged value.
+      #
+      def merge_values(attr, existing_value, new_value)
+        return existing_value if new_value.nil?
+        return new_value if existing_value.nil?
+
+        if attr.types.include?(TrueClass)
+          new_value.nil? ? existing_value : new_value
+        elsif attr.container == Array
+          r = [*existing_value] + [*new_value]
+          r.compact
+        elsif attr.container == Hash
+          existing_value.merge(new_value) do |_, old, new|
+            if new.is_a?(Array) || old.is_a?(Array)
+              r = [*old] + [*new]
+              r.compact
+            else
+              old + ' ' + new
+            end
+          end
+        else
+          new_value
+        end
+      end
+
+      # Wraps a value in an Array if needed and calls the prepare hook to
+      # allow further customization of a value before storing it in the
+      # instance variable.
+      #
+      # @note   Only array containers are wrapped. To automatically wrap
+      #         values for attributes with hash containers a prepare hook
+      #         should be used.
+      #
+      # @return [Object] the customized value of the original one if no
+      #         prepare hook was defined.
+      #
+      def prepare_value(attr, value)
+        if attr.container == Array
+          value = if value.is_a?(Hash)
+                    [value]
+                  else
+                    [*value].compact
+                  end
+        end
+
+        hook_name = prepare_hook_name(attr)
+        if self.respond_to?(hook_name, true)
+          send(hook_name, value)
+        else
+          value
+        end
+      end
+
+      # @!group Preparing Values
+      #-----------------------------------------------------------------------#
+
+      # @return [String] the name of the prepare hook for this attribute.
+      #
+      # @note   The hook is called after the value has been wrapped in an
+      #         array (if needed according to the container) but before
+      #         validation.
+      #
+      def prepare_hook_name(attr)
+        "_prepare_#{attr.name}"
+      end
+
+      # Converts the prefix header to a string if specified as an array.
+      #
+      # @param  [String, Array] value.
+      #         The value of the attribute as specified by the user.
+      #
+      # @return [String] the prefix header.
+      #
+      def _prepare_prefix_header_contents(value)
+        if value
+          value = value.join("\n") if value.is_a?(Array)
+          value.strip_heredoc.chomp
+        end
+      end
+
+      # Converts the array of hashes (script phases) where keys are strings into symbols.
+      #
+      # @param  [Array<Hash{String=>String}>] value.
+      #         The value of the attribute as specified by the user.
+      #
+      # @return [Array<Hash{Symbol=>String}>] the script phases array with symbols for each hash instead of strings.
+      #
+      def _prepare_script_phases(value)
+        if value
+          value.map do |script_phase|
+            if script_phase.is_a?(Hash)
+              phase = Specification.convert_keys_to_symbol(script_phase)
+              phase[:execution_position] = if phase.key?(:execution_position)
+                                             phase[:execution_position].to_sym
+                                           else
+                                             :any
+                                           end
+              phase
+            end
+          end.compact
+        end
+      end
+
+      # Ensures that the file patterns of the resource bundles are contained in
+      # an array.
+      #
+      # @param  [String, Array, Hash] value.
+      #         The value of the attribute as specified by the user.
+      #
+      # @return [Hash] the resources.
+      #
+      def _prepare_resource_bundles(value)
+        result = {}
+        if value
+          value.each do |key, patterns|
+            result[key] = [*patterns].compact
+          end
+        end
+        result
+      end
+
+      #-----------------------------------------------------------------------#
+    end
+  end
+end

data/vendor/bundle/gems/cocoapods-core-1.6.1/lib/cocoapods-core/specification/dsl.rb

@@ -0,0 +1,1588 @@
+require 'cocoapods-core/specification/dsl/attribute_support'
+require 'cocoapods-core/specification/dsl/attribute'
+require 'cocoapods-core/specification/dsl/platform_proxy'
+
+module Pod
+  class Specification
+    #- NOTE ------------------------------------------------------------------#
+    # The order of the methods defined in this file and the order of the
+    # methods is relevant for the documentation generated on the
+    # CocoaPods/cocoapods.github.com repository.
+    #-------------------------------------------------------------------------#
+
+    # A specification describes a version of Pod library. It includes details
+    # about where the source should be fetched from, what files to use, the
+    # build settings to apply, and other general metadata such as its name,
+    # version, and description.
+    #
+    # ---
+    #
+    # A stub specification file can be generated by the [pod spec
+    # create](http://guides.cocoapods.org/terminal/commands.html#pod_spec_create) command.
+    #
+    # ---
+    #
+    # The specification DSL provides great flexibility and dynamism. Moreover,
+    # the DSL adopts the
+    # [convention over configuration](http://en.wikipedia.org/wiki/Convention_over_configuration)
+    # and thus it can be very simple:
+    #
+    #     Pod::Spec.new do |spec|
+    #       spec.name         = 'Reachability'
+    #       spec.version      = '3.1.0'
+    #       spec.license      = { :type => 'BSD' }
+    #       spec.homepage     = 'https://github.com/tonymillion/Reachability'
+    #       spec.authors      = { 'Tony Million' => 'tonymillion@gmail.com' }
+    #       spec.summary      = 'ARC and GCD Compatible Reachability Class for iOS and OS X.'
+    #       spec.source       = { :git => 'https://github.com/tonymillion/Reachability.git', :tag => 'v3.1.0' }
+    #       spec.source_files = 'Reachability.{h,m}'
+    #       spec.framework    = 'SystemConfiguration'
+    #     end
+    #
+    # Or it can be quite detailed:
+    #
+    #     Pod::Spec.new do |spec|
+    #       spec.name          = 'Reachability'
+    #       spec.version       = '3.1.0'
+    #       spec.license       = { :type => 'BSD' }
+    #       spec.homepage      = 'https://github.com/tonymillion/Reachability'
+    #       spec.authors       = { 'Tony Million' => 'tonymillion@gmail.com' }
+    #       spec.summary       = 'ARC and GCD Compatible Reachability Class for iOS and OS X.'
+    #       spec.source        = { :git => 'https://github.com/tonymillion/Reachability.git', :tag => 'v3.1.0' }
+    #       spec.module_name   = 'Rich'
+    #       spec.swift_version = '4.0'
+    #
+    #       spec.ios.deployment_target  = '9.0'
+    #       spec.osx.deployment_target  = '10.10'
+    #
+    #       spec.source_files       = 'Reachability/common/*.swift'
+    #       spec.ios.source_files   = 'Reachability/ios/*.swift', 'Reachability/extensions/*.swift'
+    #       spec.osx.source_files   = 'Reachability/osx/*.swift'
+    #
+    #       spec.framework      = 'SystemConfiguration'
+    #       spec.ios.framework  = 'UIKit'
+    #       spec.osx.framework  = 'AppKit'
+    #
+    #       spec.dependency 'SomeOtherPod'
+    #     end
+    #
+    module DSL
+      extend Pod::Specification::DSL::AttributeSupport
+
+      # Deprecations must be required after include AttributeSupport
+      require 'cocoapods-core/specification/dsl/deprecations'
+
+      #-----------------------------------------------------------------------#
+
+      # @!group Root specification
+      #
+      #   A ‘root’ specification stores the information about the specific
+      #   version of a library.
+      #
+      #   The attributes in this group can only be written to on the ‘root’
+      #   specification, **not** on the ‘sub-specifications’.
+      #
+      #   ---
+      #
+      #   The attributes listed in this group are the only one which are
+      #   required by a podspec.
+      #
+      #   The attributes of the other groups are offered to refine the podspec
+      #   and follow a convention over configuration approach.  A root
+      #   specification can describe these attributes either directly of
+      #   through ‘[sub-specifications](#subspec)’.
+
+      #-----------------------------------------------------------------------#
+
+      # @!method name=(name)
+      #
+      #   The name of the Pod.
+      #
+      #   @example
+      #
+      #     spec.name = 'AFNetworking'
+      #
+      #   @param  [String] name
+      #           the name of the pod.
+      #
+      attribute :name,
+                :required => true,
+                :inherited => false,
+                :multi_platform => false
+
+      #------------------#
+
+      # @!method version=(version)
+      #
+      #   The version of the Pod. CocoaPods follows
+      #   [semantic versioning](http://semver.org).
+      #
+      #   @example
+      #
+      #     spec.version = '0.0.1'
+      #
+      #   @param  [String] version
+      #           the version of the Pod.
+      #
+      root_attribute :version,
+                     :required => true
+
+      #------------------#
+
+      # @!method swift_version=(version)
+      #
+      #   The version of Swift that the specification supports.
+      #
+      #   @example
+      #
+      #     spec.swift_version = '3.2'
+      #
+      #   @param  [String] swift_version
+      #
+      root_attribute :swift_version,
+                     :multi_platform => false
+
+      #-----------------------------------------------------------------------#
+
+      # @!method cocoapods_version=(cocoapods_version)
+      #
+      #   The version of CocoaPods that the specification supports.
+      #
+      #   @example
+      #
+      #     spec.cocoapods_version = '>= 0.36'
+      #
+      #   @param  [String] cocoapods_version
+      #           the CocoaPods version that the specification supports.
+      #           CocoaPods follows [semantic versioning](http://semver.org).
+      #
+      root_attribute :cocoapods_version
+
+      #------------------#
+
+      # @!method authors=(authors)
+      #
+      #   The name and email addresses of the library maintainers, not the
+      #   Podspec maintainer.
+      #
+      #   @example
+      #
+      #     spec.author = 'Darth Vader'
+      #
+      #   @example
+      #
+      #     spec.authors = 'Darth Vader', 'Wookiee'
+      #
+      #   @example
+      #
+      #     spec.authors = { 'Darth Vader' => 'darthvader@darkside.com',
+      #                      'Wookiee'     => 'wookiee@aggrrttaaggrrt.com' }
+      #
+      #   @param  [String, Hash{String=>String}] authors
+      #           the list of the authors of the library and their emails.
+      #
+      root_attribute :authors,
+                     :types       => [String, Array, Hash],
+                     :container   => Hash,
+                     :required    => true,
+                     :singularize => true
+
+      #------------------#
+
+      # @!method social_media_url=(social_media_url)
+      #
+      #   The URL for the social media contact of the Pod, CocoaPods web
+      #   services can use this.
+      #
+      #   For example, the @CocoaPodsFeed notifications will include the
+      #   Twitter handle (shortening the description) if the URL is relative to
+      #   Twitter. This does **not** necessarily have to be a Twitter URL, but
+      #   only those are included in the Twitter @CocoaPodsFeed notifications.
+      #
+      #   @example
+      #
+      #     spec.social_media_url = 'https://twitter.com/cocoapods'
+      #
+      #   @example
+      #
+      #     spec.social_media_url = 'https://groups.google.com/forum/#!forum/cocoapods'
+      #
+      #   @param  [String] social_media_url
+      #           the social media URL.
+      #
+      root_attribute :social_media_url
+
+      #------------------#
+
+      # The keys accepted by the license attribute.
+      #
+      LICENSE_KEYS = [:type, :file, :text].freeze
+
+      # @!method license=(license)
+      #
+      #   The license of the Pod.
+      #
+      #   ---
+      #
+      #   Unless the source contains a file named `LICENSE.*` or `LICENCE.*`,
+      #   the path of the license file **or** the integral text of the notice
+      #   commonly used for the license type must be specified.
+      #   If a license file is specified, it either must be without a file
+      #   extensions or be one of `txt`, `md`, or `markdown`.
+      #
+      #   This information is used by CocoaPods to generate acknowledgement
+      #   files (markdown and plist) which can be used in the acknowledgements
+      #   section of the final application.
+      #
+      #   @example
+      #
+      #     spec.license = 'MIT'
+      #
+      #   @example
+      #
+      #     spec.license = { :type => 'MIT', :file => 'MIT-LICENSE.txt' }
+      #
+      #   @example
+      #
+      #     spec.license = { :type => 'MIT', :text => <<-LICENSE
+      #                        Copyright 2012
+      #                        Permission is granted to...
+      #                      LICENSE
+      #                    }
+      #
+      #   @param  [String] license
+      #           The type of the license
+      #
+      #   @overload license=(license)
+      #     @param  [String, Hash{Symbol=>String}] license
+      #     @option license [String] :type license type
+      #     @option license [String] :file file containing full license text. Supports txt, md, and markdown
+      #     @option license [String] :text full license text
+      #
+      root_attribute :license,
+                     :container => Hash,
+                     :keys      => LICENSE_KEYS,
+                     :required  => true
+
+      #------------------#
+
+      # @!method homepage=(homepage)
+      #
+      #   The URL of the homepage of the Pod.
+      #
+      #   @example
+      #
+      #     spec.homepage = 'http://www.example.com'
+      #
+      #   @param  [String] homepage
+      #           the URL of the homepage of the Pod.
+      #
+      root_attribute :homepage,
+                     :required => true
+
+      #------------------#
+
+      # The keys accepted by the hash of the source attribute.
+      #
+      SOURCE_KEYS = {
+        :git  => [:tag, :branch, :commit, :submodules].freeze,
+        :svn  => [:folder, :tag, :revision].freeze,
+        :hg   => [:revision].freeze,
+        :http => [:flatten, :type, :sha256, :sha1].freeze,
+      }.freeze
+
+      # @!method source=(source)
+      #
+      #   The location from where the library should be retrieved.
+      #
+      #   @example Specifying a Git source with a tag. This is how most OSS Podspecs work.
+      #
+      #     spec.source = { :git => 'https://github.com/AFNetworking/AFNetworking.git',
+      #                     :tag => spec.version.to_s }
+      #
+      #   @example Using a tag prefixed with 'v' and submodules.
+      #
+      #     spec.source = { :git => 'https://github.com/typhoon-framework/Typhoon.git',
+      #                     :tag => "v#{spec.version}", :submodules => true }
+      #
+      #   @example Using Subversion with a tag.
+      #
+      #     spec.source = { :svn => 'http://svn.code.sf.net/p/polyclipping/code', :tag => '4.8.8' }
+      #
+      #   @example Using Mercurial with the same revision as the spec's semantic version string.
+      #
+      #     spec.source = { :hg => 'https://bitbucket.org/dcutting/hyperbek', :revision => "#{s.version}" }
+      #
+      #   @example Using HTTP to download a compressed file of the code. It supports zip, tgz, bz2, txz and tar.
+      #
+      #     spec.source = { :http => 'http://dev.wechatapp.com/download/sdk/WeChat_SDK_iOS_en.zip' }
+      #
+      #   @example Using HTTP to download a file using a hash to verify the download. It supports sha1 and sha256.
+      #
+      #     spec.source = { :http => 'http://dev.wechatapp.com/download/sdk/WeChat_SDK_iOS_en.zip',
+      #                     :sha1 => '7e21857fe11a511f472cfd7cfa2d979bd7ab7d96' }
+      #
+      #
+      #   @overload source=(git)
+      #     @param  [Hash] git
+      #     @option git [String] :git git source URI
+      #     @option git [String] :tag version tag
+      #     @option git [Bool] :submodules Whether to checkout submodules
+      #     @option git [String] :branch branch name
+      #     @option git [String] :commit commit hash
+      #
+      #   @overload source=(svn)
+      #     @param  [Hash] svn
+      #     @option svn [String] :svn svn source URI
+      #     @option svn [String] :tag version tag
+      #     @option svn [String] :folder folder
+      #     @option svn [String] :revision revision
+      #
+      #   @overload source=(hg)
+      #     @param  [Hash] hg
+      #     @option hg [String] :hg mercurial source URI
+      #     @option hg [String] :revision revision
+      #
+      #   @overload source=(http)
+      #     @param  [Hash] http
+      #     @option http [String] :http compressed source URL
+      #     @option http [String] :type file type. Supports zip, tgz, bz2, txz and tar
+      #     @option http [String] :sha1 SHA hash. Supports SHA1 and SHA256
+      #
+      root_attribute :source,
+                     :container => Hash,
+                     :keys      => SOURCE_KEYS,
+                     :required  => true
+
+      #------------------#
+
+      # @!method summary=(summary)
+      #
+      #   A short (maximum 140 characters) description of the Pod.
+      #
+      #   ---
+      #
+      #   The description should be short, yet informative. It represents the
+      #   tag line of the Pod and there is no need to specify that a Pod is a
+      #   library (they always are).
+      #
+      #   The summary is expected to be properly capitalised and containing the
+      #   correct punctuation.
+      #
+      #   @example
+      #
+      #     spec.summary = 'Computes the meaning of life.'
+      #
+      #   @param  [String] summary
+      #           A short description of the Pod.
+      #
+      root_attribute :summary,
+                     :required => true
+
+      #------------------#
+
+      # @!method description=(description)
+      #
+      #   A description of the Pod more detailed than the summary.
+      #
+      #   @example
+      #
+      #     spec.description = <<-DESC
+      #                          Computes the meaning of life.
+      #                          Features:
+      #                          1. Is self aware
+      #                          ...
+      #                          42. Likes candies.
+      #                        DESC
+      #
+      #   @param  [String] description
+      #           A longer description of the Pod.
+      #
+      root_attribute :description
+
+      #------------------#
+
+      # @!method screenshots=(screenshots)
+      #
+      #   A list of URLs to images showcasing the Pod. Intended for UI oriented
+      #   libraries. CocoaPods recommends the usage of the `gif` format.
+      #
+      #   @example
+      #
+      #     spec.screenshot  = 'http://dl.dropbox.com/u/378729/MBProgressHUD/1.png'
+      #
+      #   @example
+      #
+      #     spec.screenshots = [ 'http://dl.dropbox.com/u/378729/MBProgressHUD/1.png',
+      #                          'http://dl.dropbox.com/u/378729/MBProgressHUD/2.png' ]
+      #
+      #   @param  [String] screenshots
+      #           An URL for the screenshot of the Pod.
+      #
+      root_attribute :screenshots,
+                     :singularize    => true,
+                     :container      => Array
+
+      #------------------#
+
+      # @!method documentation_url=(documentation_url)
+      #
+      #   An optional URL for the documentation of the Pod which will be honoured by
+      #   CocoaPods web properties. Leaving it blank will default to a CocoaDocs
+      #   generated URL for your library.
+      #
+      #   @example
+      #
+      #     spec.documentation_url = 'http://www.example.com/docs.html'
+      #
+      #   @param  [String] documentation_url
+      #           The link of the web documentation of the Pod.
+      #
+      root_attribute :documentation_url
+
+      #------------------#
+
+      # @!method prepare_command=(command)
+      #
+      #   A bash script that will be executed after the Pod is downloaded. This
+      #   command can be used to create, delete and modify any file downloaded
+      #   and will be ran before any paths for other file attributes of the
+      #   specification are collected.
+      #
+      #   This command is executed before the Pod is cleaned and before the
+      #   Pods project is created. The working directory is the root of the
+      #   Pod.
+      #
+      #   If the pod is installed with the `:path` option this command will not
+      #   be executed.
+      #
+      #   @example
+      #
+      #     spec.prepare_command = 'ruby build_files.rb'
+      #
+      #   @example
+      #
+      #     spec.prepare_command = <<-CMD
+      #                             sed -i 's/MyNameSpacedHeader/Header/g' ./**/*.h
+      #                             sed -i 's/MyNameOtherSpacedHeader/OtherHeader/g' ./**/*.h
+      #                        CMD
+      #
+      #   @param  [String] command
+      #           the prepare command of the pod.
+      #
+      root_attribute :prepare_command
+
+      #------------------#
+
+      # @!method static_framework=(flag)
+      #
+      #   Indicates, that if use_frameworks! is specified, the
+      #   pod should include a static library framework.
+      #
+      #   @example
+      #
+      #     spec.static_framework = true
+      #
+      #   @param [Bool] flag
+      #          Indicates, that if use_frameworks! is specified, the
+      #          pod should include a static library framework.
+      #
+      root_attribute :static_framework,
+                     :types => [TrueClass, FalseClass],
+                     :default_value => false
+
+      #------------------#
+
+      # @!method deprecated=(flag)
+      #
+      #   Whether the library has been deprecated.
+      #
+      #   @example
+      #
+      #     spec.deprecated = true
+      #
+      #   @param [Bool] flag
+      #          whether the library has been deprecated.
+      #
+      root_attribute :deprecated,
+                     :types => [TrueClass, FalseClass],
+                     :default_value => false
+
+      # @!method deprecated_in_favor_of=(deprecated_in_favor_of)
+      #
+      #   The name of the Pod that this one has been deprecated in favor of.
+      #
+      #   @example
+      #
+      #     spec.deprecated_in_favor_of = 'NewMoreAwesomePod'
+      #
+      #   @param  [String] deprecated_in_favor_of
+      #           the name of the Pod that this one has been deprecated in
+      #           favor of.
+      #
+      root_attribute :deprecated_in_favor_of
+
+      #-----------------------------------------------------------------------#
+
+      # @!group Platform
+      #
+      #   A specification should indicate the platform and the correspondent
+      #   deployment targets on which the library is supported.
+      #
+      #   If not defined in a subspec the attributes of this group inherit the
+      #   value of the parent.
+
+      #-----------------------------------------------------------------------#
+
+      # The names of the platforms supported by the specification class.
+      #
+      PLATFORMS = [:osx, :ios, :tvos, :watchos].freeze
+
+      # @todo This currently is not used in the Ruby DSL.
+      #
+      attribute :platforms,
+                :container => Hash,
+                :keys => PLATFORMS,
+                :multi_platform => false,
+                :inherited => true
+
+      # The platform on which this Pod is supported. Leaving this blank
+      # means the Pod is supported on all platforms. When supporting multiple
+      # platforms you should use deployment_target below instead.
+      #
+      # @example
+      #
+      #   spec.platform = :osx, '10.8'
+      #
+      # @example
+      #
+      #   spec.platform = :ios
+      #
+      # @example
+      #
+      #   spec.platform = :osx
+      #
+      # @param  [Array<Symbol, String>] args
+      #         A tuple where the first value is the name of the platform,
+      #         (either `:ios` or `:osx`) and the second is the deployment
+      #         target.
+      #
+      def platform=(args)
+        name, deployment_target = args
+        name = :osx if name.to_s == 'macos'
+        attributes_hash['platforms'] = if name
+                                         { name.to_s => deployment_target }
+                                       else
+                                         {}
+                                       end
+      end
+
+      #------------------#
+
+      # The minimum deployment targets of the supported platforms.
+      #
+      # As opposed to the `platform` attribute, the `deployment_target`
+      # attribute allows to specify multiple platforms on which this pod
+      # is supported — specifying a different deployment target for each.
+      #
+      # @example
+      #
+      #   spec.ios.deployment_target = '6.0'
+      #
+      # @example
+      #
+      #   spec.osx.deployment_target = '10.8'
+      #
+      # @param    [String] _args
+      #           The deployment target of the platform.
+      #
+      def deployment_target=(*_args)
+        raise Informative, 'The deployment target can be declared only per ' \
+          'platform.'
+      end
+
+      #-----------------------------------------------------------------------#
+
+      # @!group Build settings
+      #
+      #   In this group are listed the attributes related to the configuration
+      #   of the build environment that should be used to build the library.
+      #
+      #   If not defined in a subspec the attributes of this group inherit the
+      #   value of the parent.
+
+      #-----------------------------------------------------------------------#
+
+      # @todo This currently is not used in the Ruby DSL.
+      #
+      attribute :dependencies,
+                :container => Hash,
+                :inherited => true
+
+      # Any dependency on other Pods or to a ‘sub-specification’.
+      #
+      # ---
+      #
+      # Dependencies can specify versions requirements. The use of the optimistic
+      # version indicator `~>` is recommended because it provides good
+      # control over the version without being too restrictive. For example,
+      # `~> 1.0.1` is equivalent to `>= 1.0.1` combined with `< 1.1`. Similarly,
+      # `~> 1.0` will match `1.0`, `1.0.1`, `1.1`, but will not upgrade to `2.0`.
+      #
+      # Pods with overly restrictive dependencies limit their compatibility with
+      # other Pods.
+      #
+      # @example
+      #   spec.dependency 'AFNetworking', '~> 1.0'
+      #
+      # @example
+      #   spec.dependency 'RestKit/CoreData', '~> 0.20.0'
+      #
+      # @example
+      #   spec.ios.dependency 'MBProgressHUD', '~> 0.5'
+      #
+      def dependency(*args)
+        name, *version_requirements = args
+        if name == self.name
+          raise Informative, "A specification can't require itself as a " \
+            'subspec'
+        end
+        if @parent
+          composed_name = ''
+          @parent.name.split('/').each do |component|
+            composed_name << component
+            if name == composed_name
+              raise Informative, "A subspec can't require one of its " \
+                'parents specifications'
+            else
+              composed_name << '/'
+            end
+          end
+        end
+        unless version_requirements.all? { |req| req.is_a?(String) }
+          raise Informative, 'Unsupported version requirements'
+        end
+        attributes_hash['dependencies'] ||= {}
+        attributes_hash['dependencies'][name] = version_requirements
+      end
+
+      def dependency=(args)
+        joined = args.join('\', \'')
+        arguments = "\'#{joined}\'"
+        raise Informative, "Cannot assign value to `dependency`. Did you mean: `dependency #{arguments}`?"
+      end
+
+      #------------------#
+
+      # @!method requires_arc=(flag)
+      #
+      #   `requires_arc` allows you to specify which source_files use ARC.
+      #   This can either be the files which support ARC, or true to indicate
+      #   all of the source_files use ARC.
+      #
+      #   Files which do not use ARC will have the `-fno-objc-arc` compiler
+      #   flag.
+      #
+      #   The default value of this attribute is `true`.
+      #
+      #   @example
+      #
+      #     spec.requires_arc = false
+      #
+      #   @example
+      #
+      #     spec.requires_arc = 'Classes/Arc'
+      #
+      #   @example
+      #
+      #     spec.requires_arc = ['Classes/*ARC.m', 'Classes/ARC.mm']
+      #
+      #   @param [Bool, String, Array<String>] flag
+      #          whether the source files require ARC.
+      #
+      attribute :requires_arc,
+                :types => [TrueClass, FalseClass, String, Array],
+                :file_patterns => true,
+                :default_value => true,
+                :inherited => true
+
+      #------------------#
+
+      # @!method frameworks=(*frameworks)
+      #
+      #   A list of system frameworks that the user’s target needs to link
+      #   against.
+      #
+      #   @example
+      #
+      #     spec.ios.framework = 'CFNetwork'
+      #
+      #   @example
+      #
+      #     spec.frameworks = 'QuartzCore', 'CoreData'
+      #
+      #   @param  [String, Array<String>] frameworks
+      #           A list of framework names.
+      #
+      attribute :frameworks,
+                :container   => Array,
+                :singularize => true,
+                :inherited => true
+
+      #------------------#
+
+      # @!method weak_frameworks=(*frameworks)
+      #
+      #   A list of frameworks that the user’s target needs to **weakly** link
+      #   against.
+      #
+      #   @example
+      #
+      #     spec.weak_framework = 'Twitter'
+      #
+      #   @example
+      #
+      #     spec.weak_frameworks = 'Twitter', 'SafariServices'
+      #
+      #   @param  [String, Array<String>] weak_frameworks
+      #           A list of frameworks names.
+      #
+      attribute :weak_frameworks,
+                :container   => Array,
+                :singularize => true,
+                :inherited => true
+
+      #------------------#
+
+      # @!method libraries=(*libraries)
+      #
+      #   A list of system libraries that the user’s target (application) needs to
+      #   link against.
+      #
+      #   @example
+      #
+      #     spec.ios.library = 'xml2'
+      #
+      #   @example
+      #
+      #     spec.libraries = 'xml2', 'z'
+      #
+      #   @param  [String, Array<String>] libraries
+      #           A list of library names.
+      #
+      attribute :libraries,
+                :container   => Array,
+                :singularize => true,
+                :inherited => true
+
+      #------------------#
+
+      # @!method compiler_flags=(flags)
+      #
+      #   A list of flags which should be passed to the compiler.
+      #
+      #   @example
+      #
+      #     spec.compiler_flags = '-DOS_OBJECT_USE_OBJC=0', '-Wno-format'
+      #
+      #   @param  [String, Array<String>] flags
+      #           A list of flags.
+      #
+      attribute :compiler_flags,
+                :container   => Array,
+                :singularize => true,
+                :inherited => true
+
+      #------------------#
+
+      # @!method pod_target_xcconfig=(value)
+      #
+      #   Any flag to add to the final __private__ pod target xcconfig file.
+      #
+      #   @example
+      #
+      #     spec.pod_target_xcconfig = { 'OTHER_LDFLAGS' => '-lObjC' }
+      #
+      #   @param  [Hash{String => String}] value
+      #           Key-value pairs representing build settings.
+      #
+      attribute :pod_target_xcconfig,
+                :container => Hash,
+                :inherited => true
+
+      # @!method user_target_xcconfig=(value)
+      #
+      #   Specifies flags to add to the final aggregate target xcconfig file,
+      #   which propagates to non-overridden and inheriting build settings to
+      #   the integrated user targets.
+      #
+      #   ---
+      #
+      #   This attribute is __not recommended__ as Pods should not pollute the
+      #   build settings of the user project and this can cause conflicts.
+      #
+      #   Multiple definitions for build settings that take multiple values
+      #   will be merged. The user is warned on conflicting definitions for
+      #   custom build settings and build settings that take only one value.
+      #
+      #   Typically clang compiler flags or precompiler macro definitions go
+      #   in here if they are required when importing the pod in the user
+      #   target. Note that, this influences not only the compiler view of the
+      #   public interface of your pod, but also all other integrated pods
+      #   alongside to yours. You should always prefer [`pod_target_xcconfig`](
+      #   http://guides.cocoapods.org/syntax/podspec.html#pod_target_xcconfig),
+      #   which can contain the same settings, but only influence the
+      #   toolchain when compiling your pod target.
+      #
+      #   @example
+      #
+      #     spec.user_target_xcconfig = { 'MY_SUBSPEC' => 'YES' }
+      #
+      #   @param  [Hash{String => String}] value
+      #           Key-value pairs representing build settings.
+      #
+      attribute :user_target_xcconfig,
+                :container => Hash,
+                :inherited => true
+
+      #------------------#
+
+      # @!method prefix_header_contents=(content)
+      #
+      #   Any content to inject in the prefix header of the pod project.
+      #
+      #   ---
+      #
+      #   This attribute is __not recommended__ as Pods should not pollute the
+      #   prefix header of other libraries or of the user project.
+      #
+      #   @example
+      #
+      #     spec.prefix_header_contents = '#import <UIKit/UIKit.h>'
+      #
+      #   @example
+      #
+      #     spec.prefix_header_contents = '#import <UIKit/UIKit.h>', '#import <Foundation/Foundation.h>'
+      #
+      #   @param  [String] content
+      #           The contents of the prefix header.
+      #
+      attribute :prefix_header_contents,
+                :types => [Array, String],
+                :inherited => true
+
+      #------------------#
+
+      # @!method prefix_header_file=(path)
+      #
+      #   A path to a prefix header file to inject in the prefix header of the
+      #   pod project.
+      #   `false` indicates that the default CocoaPods prefix header should not
+      #   be generated.
+      #   `true` is the default and indicates that the default CocoaPods prefix
+      #   header should be generated.
+      #
+      #   ---
+      #
+      #   The file path options is __not recommended__ as Pods should not
+      #   pollute the prefix header of other libraries or of the user project.
+      #
+      #
+      #   @example
+      #
+      #     spec.prefix_header_file = 'iphone/include/prefix.pch'
+      #
+      #   @example
+      #
+      #     spec.prefix_header_file = false
+      #
+      #   @param  [Bool, String] path
+      #           The path to the prefix header file or whether to disable
+      #           prefix_header generation.
+      #
+      attribute :prefix_header_file,
+                :types => [TrueClass, FalseClass, String],
+                :inherited => true
+
+      #------------------#
+
+      # @!method module_name=(name)
+      #
+      #   The name to use for the framework / clang module which
+      #   will be generated for this specification instead of the
+      #   default (header_dir if set, otherwise the specification
+      #   name).
+      #
+      #   @example
+      #
+      #     spec.module_name = 'Three20'
+      #
+      #   @param  [String] name
+      #           the module name.
+      #
+      root_attribute :module_name
+
+      #------------------#
+
+      # @!method header_dir=(dir)
+      #
+      #   The directory where to store the headers files so they don't break
+      #   includes.
+      #
+      #   @example
+      #
+      #     spec.header_dir = 'Three20Core'
+      #
+      #   @param  [String] dir
+      #           the headers directory.
+      #
+      attribute :header_dir,
+                :inherited => true
+
+      #------------------#
+
+      # @!method header_mappings_dir=(dir)
+      #
+      #   A directory from where to preserve the folder structure for the
+      #   headers files. If not provided the headers files are flattened.
+      #
+      #   @example
+      #
+      #     spec.header_mappings_dir = 'src/include'
+      #
+      #   @param  [String] dir
+      #           the directory from where to preserve the headers namespacing.
+      #
+      attribute :header_mappings_dir,
+                :inherited => true
+
+      #------------------#
+
+      SCRIPT_PHASE_REQUIRED_KEYS = [:name, :script].freeze
+
+      SCRIPT_PHASE_OPTIONAL_KEYS = [:shell_path, :input_files, :output_files, :show_env_vars_in_log, :execution_position].freeze
+
+      EXECUTION_POSITION_KEYS = [:before_compile, :after_compile, :any].freeze
+
+      ALL_SCRIPT_PHASE_KEYS = (SCRIPT_PHASE_REQUIRED_KEYS + SCRIPT_PHASE_OPTIONAL_KEYS).freeze
+
+      # @!method script_phases=(*script_phases)
+      #
+      #   This attribute allows to define a script phase to execute as part of compilation of the Pod.
+      #   Unlike a prepare command, script phases execute as part of `xcodebuild` they can also utilize all environment
+      #   variables that are set during compilation.
+      #
+      #   A Pod can provide multiple script phases to execute and they will be added in the order they were
+      #   declared and after taking into consideration their execution position setting.
+      #
+      #   **Note** In order to provide visibility and awareness of the contents of all script phases,
+      #   a warning will be presented to the user upon installing your pod if it includes any script phases.
+      #
+      #   @example
+      #
+      #     spec.script_phase = { :name => 'Hello World', :script => 'echo "Hello World"' }
+      #
+      #   @example
+      #
+      #     spec.script_phase = { :name => 'Hello World', :script => 'echo "Hello World"', :execution_position => :before_compile }
+      #
+      #   @example
+      #
+      #     spec.script_phase = { :name => 'Hello World', :script => 'puts "Hello World"', :shell_path => '/usr/bin/ruby' }
+      #
+      #   @example
+      #
+      #     spec.script_phases = [
+      #         { :name => 'Hello World', :script => 'echo "Hello World"' },
+      #         { :name => 'Hello Ruby World', :script => 'puts "Hello World"', :shell_path => '/usr/bin/ruby' },
+      #       ]
+      #
+      #   @param  [Array<Hash{Symbol=>String}>] script_phases
+      #           An array of hashes where each hash represents a single script phase.
+      #
+      attribute :script_phases,
+                :types => [Hash],
+                :container => Array,
+                :singularize => true
+
+      #-----------------------------------------------------------------------#
+
+      # @!group File patterns
+      #
+      #   Podspecs should be located at the **root** of the repository, and paths
+      #   to files should be specified **relative** to the root of the repository
+      #   as well. File patterns do not support traversing the parent directory ( `..` ).
+      #   File patterns may contain the following wildcard patterns:
+      #
+      #   ---
+      #
+      #   ### Pattern: *
+      #
+      #   Matches any file. Can be restricted by other values in the glob.
+      #
+      #   * `*` will match all files
+      #   * `c*` will match all files beginning with `c`
+      #   * `*c` will match all files ending with `c`
+      #   * `*c*` will match all files that have `c` in them (including at the
+      #     beginning or end)
+      #
+      #   Equivalent to `/.*/x` in regexp.
+      #
+      #   **Note** this will not match Unix-like hidden files (dotfiles). In
+      #   order to include those in the match results, you must use something
+      #   like `{*,.*}`.
+      #
+      #   ---
+      #
+      #   ### Pattern: **
+      #
+      #   Matches directories recursively.
+      #
+      #   ---
+      #
+      #   ### Pattern: ?
+      #
+      #   Matches any one character. Equivalent to `/.{1}/` in regexp.
+      #
+      #   ---
+      #
+      #   ### Pattern: [set]
+      #
+      #   Matches any one character in set.
+      #
+      #   Behaves exactly like character sets in Regexp, including set negation
+      #   (`[^a-z]`).
+      #
+      #   ---
+      #
+      #   ### Pattern: {p,q}
+      #
+      #   Matches either literal `p` or literal `q`.
+      #
+      #   Matching literals may be more than one character in length. More than
+      #   two literals may be specified.
+      #
+      #   Equivalent to pattern alternation in regexp.
+      #
+      #   ---
+      #
+      #   ### Pattern: \
+      #
+      #   Escapes the next meta-character.
+      #
+      #   ---
+      #
+      #   ### Examples
+      #
+      #   Consider these to be evaluated in the source root of
+      #   [JSONKit](https://github.com/johnezang/JSONKit).
+      #
+      #       "JSONKit.?"    #=> ["JSONKit.h", "JSONKit.m"]
+      #       "*.[a-z][a-z]" #=> ["CHANGELOG.md", "README.md"]
+      #       "*.[^m]*"      #=> ["JSONKit.h"]
+      #       "*.{h,m}"      #=> ["JSONKit.h", "JSONKit.m"]
+      #       "*"            #=> ["CHANGELOG.md", "JSONKit.h", "JSONKit.m", "README.md"]
+
+      #-----------------------------------------------------------------------#
+
+      # @!method source_files=(source_files)
+      #
+      #   The source files of the Pod.
+      #
+      #   @example
+      #
+      #     spec.source_files = 'Classes/**/*.{h,m}'
+      #
+      #   @example
+      #
+      #     spec.source_files = 'Classes/**/*.{h,m}', 'More_Classes/**/*.{h,m}'
+      #
+      #   @param  [String, Array<String>] source_files
+      #           the source files of the Pod.
+      #
+      attribute :source_files,
+                :container     => Array,
+                :file_patterns => true
+
+      #------------------#
+
+      # @!method public_header_files=(public_header_files)
+      #
+      #   A list of file patterns that should be used as public headers.
+      #
+      #   ---
+      #
+      #   These are the headers that will be exposed to the user’s project and
+      #   from which documentation will be generated. When the library is built,
+      #   these headers will appear in the build directory. If no public headers
+      #   are specified then **all** the headers in source_files are considered
+      #   public.
+      #
+      #   @example
+      #
+      #     spec.public_header_files = 'Headers/Public/*.h'
+      #
+      #   @param  [String, Array<String>] public_header_files
+      #           the public headers of the Pod.
+      #
+      attribute :public_header_files,
+                :container => Array,
+                :file_patterns => true
+
+      #------------------#
+
+      # @!method private_header_files=(private_header_files)
+      #
+      #   A list of file patterns that should be used to mark private headers.
+      #
+      #   ---
+      #
+      #   These patterns are matched against the public headers (or all the
+      #   headers if no public headers have been specified) to exclude those
+      #   headers which should not be exposed to the user project and which
+      #   should not be used to generate the documentation. When the library
+      #   is built, these headers will appear in the build directory.
+      #
+      #   Header files that are not listed as neither public nor private will
+      #   be treated as private, but in addition will not appear in the build
+      #   directory at all.
+      #
+      #
+      #   @example
+      #
+      #     spec.private_header_files = 'Headers/Private/*.h'
+      #
+      #   @param  [String, Array<String>] private_header_files
+      #           the private headers of the Pod.
+      #
+      attribute :private_header_files,
+                :container => Array,
+                :file_patterns => true
+
+      #------------------#
+
+      # @!method vendored_frameworks=(*frameworks)
+      #
+      #   The paths of the framework bundles that come shipped with the Pod.
+      #
+      #   @example
+      #
+      #     spec.ios.vendored_frameworks = 'Frameworks/MyFramework.framework'
+      #
+      #   @example
+      #
+      #     spec.vendored_frameworks = 'MyFramework.framework', 'TheirFramework.framework'
+      #
+      #   @param  [String, Array<String>] vendored_frameworks
+      #           A list of framework bundles paths.
+      #
+      attribute :vendored_frameworks,
+                :container => Array,
+                :file_patterns => true,
+                :singularize => true
+
+      #------------------#
+
+      # @!method vendored_libraries=(*frameworks)
+      #
+      #   The paths of the libraries that come shipped with the Pod.
+      #
+      #   @example
+      #
+      #     spec.ios.vendored_library = 'Libraries/libProj4.a'
+      #
+      #   @example
+      #
+      #     spec.vendored_libraries = 'libProj4.a', 'libJavaScriptCore.a'
+      #
+      #   @param  [String, Array<String>] vendored_libraries
+      #           A list of library paths.
+      #
+      attribute :vendored_libraries,
+                :container => Array,
+                :file_patterns => true,
+                :singularize => true
+
+      #------------------#
+
+      # @!method resource_bundles=(*resource_bundles)
+      #
+      #   This attribute allows to define the name and the file of the resource
+      #   bundles which should be built for the Pod. They are specified as a
+      #   hash where the keys represent the name of the bundles and the values
+      #   the file patterns that they should include.
+      #
+      #   For building the Pod as a static library, we strongly **recommend**
+      #   library developers to adopt resource bundles as there can be name
+      #   collisions using the resources attribute.
+      #
+      #   The names of the bundles should at least include the name of the Pod
+      #   to minimise the chance of name collisions.
+      #
+      #   To provide different resources per platform namespaced bundles *must*
+      #   be used.
+      #
+      #   @example
+      #
+      #     spec.ios.resource_bundle = { 'MapBox' => 'MapView/Map/Resources/*.png' }
+      #
+      #   @example
+      #
+      #     spec.resource_bundles = {
+      #         'MapBox' => ['MapView/Map/Resources/*.png'],
+      #         'OtherResources' => ['MapView/Map/OtherResources/*.png']
+      #       }
+      #
+      #   @param  [Hash{String=>String}] resource_bundles
+      #           A hash where the keys are the names of the resource bundles
+      #           and the values are their relative file patterns.
+      #
+      attribute :resource_bundles,
+                :types => [String, Array],
+                :container => Hash,
+                :file_patterns => true,
+                :singularize => true
+
+      #------------------#
+
+      # @!method resources=(resources)
+      #
+      #   A list of resources that should be copied into the target bundle.
+      #
+      #   For building the Pod as a static library, we strongly **recommend**
+      #   library developers to adopt [resource bundles](http://guides.cocoapods.org/syntax/podspec.html#resource_bundles)
+      #   as there can be name collisions using the resources attribute.
+      #   Moreover, resources specified with this attribute are copied
+      #   directly to the client target and therefore they are not
+      #   optimised by Xcode.
+      #
+      #   @example
+      #
+      #     spec.resource = 'Resources/HockeySDK.bundle'
+      #
+      #   @example
+      #
+      #     spec.resources = ['Images/*.png', 'Sounds/*']
+      #
+      #   @param  [String, Array<String>] resources
+      #           The resources shipped with the Pod.
+      #
+      attribute :resources,
+                :container     => Array,
+                :file_patterns => true,
+                :singularize   => true
+
+      #------------------#
+
+      # @!method exclude_files=(exclude_files)
+      #
+      #   A list of file patterns that should be excluded from the other
+      #   file patterns.
+      #
+      #   @example
+      #
+      #     spec.ios.exclude_files = 'Classes/osx'
+      #
+      #   @example
+      #
+      #     spec.exclude_files = 'Classes/**/unused.{h,m}'
+      #
+      #   @param  [String, Array<String>] exclude_files
+      #           the file patterns that the Pod should ignore.
+      #
+      attribute :exclude_files,
+                :container     => Array,
+                :file_patterns => true
+
+      #------------------#
+
+      # @!method preserve_paths=(preserve_paths)
+      #
+      #   Any file that should **not** be removed after being downloaded.
+      #
+      #   ---
+      #
+      #   By default, CocoaPods removes all files that are not matched by any
+      #   of the other file pattern.
+      #
+      #   @example
+      #
+      #     spec.preserve_path = 'IMPORTANT.txt'
+      #
+      #   @example
+      #
+      #     spec.preserve_paths = 'Frameworks/*.framework'
+      #
+      #   @param  [String, Array<String>] preserve_paths
+      #           the paths that should be not cleaned.
+      #
+      attribute :preserve_paths,
+                :container     => Array,
+                :file_patterns => true,
+                :singularize   => true
+
+      #------------------#
+
+      # @!method module_map=(module_map)
+      #
+      #   The module map file that should be used when this pod is integrated as
+      #   a framework.
+      #
+      #   ---
+      #
+      #   By default, CocoaPods creates a module map file based upon the public
+      #   headers in a specification.
+      #
+      #   @example
+      #
+      #     spec.module_map = 'source/module.modulemap'
+      #
+      #   @param  [String] module_map
+      #           the path to the module map file that should be used.
+      #
+      attribute :module_map,
+                :root_only     => true
+
+      #-----------------------------------------------------------------------#
+
+      # @!group Subspecs
+      #
+      #   A library can specify a dependency on either another library, a
+      #   subspec of another library, or a subspec of itself.
+
+      #-----------------------------------------------------------------------#
+
+      # Represents specification for a module of the library.
+      #
+      # ---
+      #
+      # Subspecs participate on a dual hierarchy.
+      #
+      # On one side, a specification automatically inherits as a dependency all
+      # it children ‘sub-specifications’ (unless a default subspec is
+      # specified).
+      #
+      # On the other side, a ‘sub-specification’ inherits the value of the
+      # attributes of the parents so common values for attributes can be
+      # specified in the ancestors.
+      #
+      # Although it sounds complicated in practice it means that subspecs in
+      # general do what you would expect:
+      #
+      #     pod 'ShareKit', '2.0'
+      #
+      # Installs ShareKit with all the sharers like `ShareKit/Evernote`,
+      # `ShareKit/Facebook`, etc, as they are defined as subspecs.
+      #
+      #     pod 'ShareKit/Twitter',  '2.0'
+      #     pod 'ShareKit/Pinboard', '2.0'
+      #
+      # Installs ShareKit with only the source files for `ShareKit/Twitter`,
+      # `ShareKit/Pinboard`. Note that, in this case, the ‘sub-specifications’
+      # to compile need the source files, the dependencies, and the other
+      # attributes defined by the root specification. CocoaPods is smart enough
+      # to handle any issues arising from duplicate attributes.
+      #
+      # @example Subspecs with different source files.
+      #
+      #   subspec 'Twitter' do |sp|
+      #     sp.source_files = 'Classes/Twitter'
+      #   end
+      #
+      #   subspec 'Pinboard' do |sp|
+      #     sp.source_files = 'Classes/Pinboard'
+      #   end
+      #
+      # @example Subspecs referencing dependencies to other subspecs.
+      #
+      #   Pod::Spec.new do |s|
+      #     s.name = 'RestKit'
+      #
+      #     s.subspec 'Core' do |cs|
+      #       cs.dependency 'RestKit/ObjectMapping'
+      #       cs.dependency 'RestKit/Network'
+      #       cs.dependency 'RestKit/CoreData'
+      #     end
+      #
+      #     s.subspec 'ObjectMapping' do |os|
+      #     end
+      #   end
+      #
+      # @example Nested subspecs.
+      #
+      #   Pod::Spec.new do |s|
+      #     s.name = 'Root'
+      #
+      #     s.subspec 'Level_1' do |sp|
+      #       sp.subspec 'Level_2' do |ssp|
+      #       end
+      #     end
+      #   end
+      #
+      def subspec(name, &block)
+        subspec = Specification.new(self, name, &block)
+        @subspecs << subspec
+        subspec
+      end
+
+      # The list of the test types currently supported.
+      #
+      SUPPORTED_TEST_TYPES = [:unit].freeze
+
+      # The test type this specification supports. This only applies to test specifications.
+      #
+      # ---
+      #
+      # @example
+      #
+      #   test_spec.test_type = :unit
+      #
+      # @example
+      #
+      #   test_spec.test_type = 'unit'
+      #
+      # @param  [Symbol, String] type
+      #         The test type to use.
+      attribute :test_type,
+                :types => [Symbol, String],
+                :multi_platform => false,
+                :test_only => true
+
+      # @!method requires_app_host=(flag)
+      #
+      #   Whether a test specification requires an app host to run tests. This only applies to test specifications.
+      #
+      #   @example
+      #
+      #     test_spec.requires_app_host = true
+      #
+      #   @param [Bool] flag
+      #          whether a test specification requires an app host to run tests.
+      #
+      attribute :requires_app_host,
+                :types => [TrueClass, FalseClass],
+                :default_value => false,
+                :test_only => true
+
+      # Represents a test specification for the library. Here you can place all
+      # your tests for your podspec along with the test dependencies.
+      #
+      # ---
+      #
+      # @example
+      #
+      #   Pod::Spec.new do |spec|
+      #     spec.name = 'NSAttributedString+CCLFormat'
+      #
+      #     spec.test_spec do |test_spec|
+      #       test_spec.source_files = 'NSAttributedString+CCLFormatTests.m'
+      #       test_spec.dependency 'Expecta'
+      #     end
+      #   end
+      #
+      def test_spec(name = 'Tests', &block)
+        subspec = Specification.new(self, name, true, &block)
+        @subspecs << subspec
+        subspec
+      end
+
+      #------------------#
+
+      # @!method default_subspecs=(subspec_array)
+      #
+      #   An array of subspecs names that should be used as preferred dependency.
+      #   If not specified a specifications requires all its subspecs as
+      #   dependencies.
+      #
+      #   ---
+      #
+      #   A Pod should make available the full library by default. Users can
+      #   fine tune their dependencies, and exclude unneeded subspecs, once
+      #   their requirements are known. Therefore, this attribute is rarely
+      #   needed. It is intended to be used to select a default if there are
+      #   ‘sub-specifications’ which provide alternative incompatible
+      #   implementations, or to exclude modules rarely needed (especially if
+      #   they trigger dependencies on other libraries).
+      #
+      #   @example
+      #
+      #     spec.default_subspec = 'Core'
+      #
+      #   @example
+      #     spec.default_subspecs = 'Core', 'UI'
+      #
+      #   @param  [Array<String>] subspec_names
+      #           An array of subspec names that should be inherited as
+      #           dependency.
+      #
+      attribute :default_subspecs,
+                :container => Array,
+                :singularize => true,
+                :multi_platform => false,
+                :root_only => true
+
+      #-----------------------------------------------------------------------#
+
+      # @!group Multi-Platform support
+      #
+      #   A specification can store values which are specific to only one
+      #   platform.
+      #
+      #   ---
+      #
+      #   For example one might want to store resources which are specific to
+      #   only iOS projects.
+      #
+      #       spec.resources = 'Resources/**/*.png'
+      #       spec.ios.resources = 'Resources_ios/**/*.png'
+
+      #-----------------------------------------------------------------------#
+
+      # Provides support for specifying iOS attributes.
+      #
+      # @example
+      #   spec.ios.source_files = 'Classes/ios/**/*.{h,m}'
+      #
+      # @return [PlatformProxy] the proxy that will set the attributes.
+      #
+      def ios
+        PlatformProxy.new(self, :ios)
+      end
+
+      # Provides support for specifying OS X attributes.
+      #
+      # @example
+      #   spec.osx.source_files = 'Classes/osx/**/*.{h,m}'
+      #
+      # @return [PlatformProxy] the proxy that will set the attributes.
+      #
+      def osx
+        PlatformProxy.new(self, :osx)
+      end
+
+      alias macos osx
+
+      # Provides support for specifying tvOS attributes.
+      #
+      # @example
+      #   spec.tvos.source_files = 'Classes/tvos/**/*.{h,m}'
+      #
+      # @return [PlatformProxy] the proxy that will set the attributes.
+      #
+      def tvos
+        PlatformProxy.new(self, :tvos)
+      end
+
+      # Provides support for specifying watchOS attributes.
+      #
+      # @example
+      #   spec.watchos.source_files = 'Classes/watchos/**/*.{h,m}'
+      #
+      # @return [PlatformProxy] the proxy that will set the attributes.
+      #
+      def watchos
+        PlatformProxy.new(self, :watchos)
+      end
+    end
+  end
+end