cocoapods-core 0.17.0.rc1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9ec7156242ce09d5db9a9527275defb79e0727bb
+  data.tar.gz: 4d33bcedda0b6089ebb42650bd02ac234d361330
+SHA512:
+  metadata.gz: 1ceabc9d9aedd42ebc5e9273779bd141b0d99e19ca8766824e3ee00dd63cec388ca84fd15d52c21ab74d0c9732e66b02ede288976f292f474cb4839d34df31ce
+  data.tar.gz: 334537cee3087739db642d937b8bfa713f947d822b95224261c1b8f05d6c198f1a73c35f6d3db6eafde0175e73e0a72eb60e4386d7dd855ea2e95899ed6d7d49

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 - 2012 Eloy Durán <eloy.de.enige@gmail.com>
+Copyright (c)        2012 Fabio Pelosin <fabiopelosin@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,36 @@
+# CocoaPods Core
+
+[![Master Build Status](https://secure.travis-ci.org/CocoaPods/Core.png?branch=master)](https://secure.travis-ci.org/CocoaPods/Core)
+
+__This gem has not been released yet__.
+
+The CocoaPods-Core gem provides support to work with the models of CocoaPods. It is intended to be used in place of the CocoaPods when the the installation of the dependencies is not needed. Therefore, it is suitable for web services.
+
+Provides support for working with the following models:
+
+- `Pod::Specification` - [podspec files](http://cocoapods.github.com/specification.html).
+- `Pod::Podfile` - [podfile specifications](http://cocoapods.github.com/podfile.html).
+- `Pod::Source` - collections of podspec files like the [CocoaPods Spec repo](https://github.com/CocoaPods/Specs).
+
+The gem also provides support for ancillary features like `Pod::Specification::Set::Presenter` suitable for presetting descriptions of Pods and the `Specification::Linter`, which ensures the validity of podspec files.
+
+## Installation
+
+```
+$ [sudo] gem install cocoapods-core
+```
+
+The `cocoapods-core` gem requires either:
+
+- Ruby 1.8.7 (shipped with OS X 10.8).
+- Ruby 1.9.3 (recommended).
+
+## Collaborate
+
+All CocoaPods development happens on GitHub, there is a repository for [CocoaPods](https://github.com/CocoaPods/CocoaPods) and one for the [CocoaPods specs](https://github.com/CocoaPods/Specs). Contributing patches or Pods is really easy and gratifying. You even get push access when one of your specs or patches is accepted.
+
+Follow [@CocoaPodsOrg](http://twitter.com/CocoaPodsOrg) to get up to date information about what's going on in the CocoaPods world.
+
+## License
+
+This gem and CocoaPods are available under the MIT license.

data/lib/cocoapods-core/core_ui.rb

@@ -0,0 +1,19 @@
+module Pod
+
+  # Manages the UI output so dependent gems can customize it.
+  #
+  module CoreUI
+
+    class << self
+      def puts(message)
+        STDOUT.puts message
+      end
+
+      def warn(message)
+        STDERR.puts message
+      end
+
+    end
+  end
+end
+

data/lib/cocoapods-core/dependency.rb

@@ -0,0 +1,295 @@
+module Pod
+
+  # The Dependency allows to specify dependencies of a {Podfile} or a
+  # {Specification} on a Pod. It stores the name of the dependency, version
+  # requirements and external sources information.
+  #
+  # This class leverages the RubyGems dependency class with minor extension to
+  # support CocoaPods specific features like subspecs.
+  #
+  class Dependency < Pod::Vendor::Gem::Dependency
+
+    # @return [Hash{Symbol=>String}] a hash describing the external source
+    #         where the pod should be fetched. The external source has to
+    #         provide its own {Specification} file.
+    #
+    attr_accessor :external_source
+
+    # @return [Bool] whether the dependency should use the podspec with the
+    #         highest know version but force the downloader to checkout the
+    #         `head` of the source repository.
+    #
+    attr_accessor :head
+    alias_method  :head?, :head
+
+    # @overload   initialize(name, requirements)
+    #
+    #   @param    [String] name
+    #             the name of the Pod.
+    #
+    #   @param    [Array] requirements
+    #             an array specifying the version requirements of the
+    #             dependency.
+    #
+    #   @example  Initialization with version requirements.
+    #
+    #             Dependency.new('AFNetworking')
+    #             Dependency.new('AFNetworking', '~> 1.0')
+    #             Dependency.new('AFNetworking', '>= 0.5', '< 0.7')
+    #
+    # @overload   initialize(name, external_source)
+    #
+    #   @param    [String] name
+    #             the name of the Pod.
+    #
+    #   @param    [Hash] external_source
+    #             a hash describing the external source.
+    #
+    #   @example  Initialization with an external source.
+    #
+    #             Dependency.new('libPusher', {:git     => 'example.com/repo.git'})
+    #             Dependency.new('libPusher', {:local   => 'path/to/folder'})
+    #             Dependency.new('libPusher', {:podspec => 'example.com/libPusher.podspec'})
+    #
+    # @overload   initialize(name, is_head)
+    #
+    #   @param    [String] name
+    #             the name of the Pod.
+    #
+    #   @param    [Symbol] is_head
+    #             a symbol that can be `:head` or nil.
+    #
+    #   @example  Initialization with the head option
+    #
+    #             Dependency.new('RestKit', :head)
+    #
+    def initialize(name = nil, *requirements)
+      if requirements.last.is_a?(Hash)
+        @external_source = requirements.pop
+      elsif requirements.last == :head
+        @head = true
+        requirements.pop
+        unless requirements.empty?
+          raise StandardError, "A `:head` dependency may not specify version requirements."
+        end
+      end
+
+      super(name, *requirements)
+    end
+
+    # @return [Version] whether the dependency points to a specific version.
+    #
+    attr_accessor :specific_version
+
+    # @return [Requirement] the requirement of this dependency (a set of
+    #         one or more version restrictions).
+    #
+    def requirement
+      return Requirement.new(specific_version) if specific_version
+      super
+    end
+
+    # @return [Bool] whether the dependency points to a subspec.
+    #
+    def subspec_dependency?
+      @name.include?('/')
+    end
+
+    # @return [Bool] whether the dependency points to an external source.
+    #
+    def external?
+      !@external_source.nil?
+    end
+
+    # Creates a new dependency with the name of the top level spec and the same
+    # version requirements.
+    #
+    # @note   This is used by the {Specification::Set} class to merge
+    #         dependencies and resolve the required version of a Pod regardless
+    #         what particular specification (subspecs or top level) is
+    #         required.
+    #
+    # @return [Dependency] a dependency with the same versions requirements
+    #         that is guaranteed to point to a top level specification.
+    #
+    def to_root_dependency
+      dep = dup
+      dep.name = root_name
+      dep
+    end
+
+    # Returns the name of the Pod that the dependency is pointing to.
+    #
+    # @note   In case this is a dependency for a subspec, e.g.
+    #         'RestKit/Networking', this returns 'RestKit', which is what the
+    #         Pod::Source needs to know to retrieve the correct {Specification}
+    #         from disk.
+    #
+    # @return [String] the name of the Pod.
+    #
+    def root_name
+      subspec_dependency? ? @name.split('/').first : @name
+    end
+
+    # Checks if a dependency would be satisfied by the requirements of another
+    # dependency.
+    #
+    # @param  [Dependency] other
+    #         the other dependency.
+    #
+    # @note   This is used by the Lockfile to check if a stored dependency is
+    #         still compatible with the Podfile.
+    #
+    # @return [Bool] whether the dependency is compatible with the given one.
+    #
+    def compatible?(other)
+      return false unless name == other.name
+      return false unless head? == other.head?
+      return false unless external_source == other.external_source
+
+      other.requirement.requirements.all? do | operator, version |
+        self.requirement.satisfied_by? Version.new(version)
+      end
+    end
+
+    # @return [Bool] whether the dependency is equal to another taking into
+    #         account the loaded specification, the head options and the
+    #         external source.
+    #
+    def ==(other)
+      super && head? == other.head? && @external_source == other.external_source
+    end
+    alias :eql? :==
+
+    # Merges the version requirements of the dependency with another one.
+    #
+    # @param  [Dependency] other
+    #         the other dependency to merge with.
+    #
+    # @note   If one of the decencies specifies an external source or is head,
+    #         the resulting dependency preserves this attributes.
+    #
+    # @return [Dependency] a dependency (not necessary a new instance) that
+    #         includes also the version requirements of the given one.
+    #
+    def merge(other)
+      dep = super
+      dep.head = head? || other.head?
+      if external_source || other.external_source
+        self_external_source  = external_source || {}
+        other_external_source = other.external_source || {}
+        dep.external_source = self_external_source.merge(other_external_source)
+      end
+      dep
+    end
+
+    #-------------------------------------------------------------------------#
+
+    # !@group String representation
+
+    # Creates a string representation of the dependency suitable for
+    # serialization and de-serialization without loss of information. The
+    # string is also suitable for UI.
+    #
+    # @note     This representation is used by the {Lockfile}.
+    #
+    # @example  Output examples
+    #
+    #           "libPusher"
+    #           "libPusher (= 1.0)"
+    #           "libPusher (~> 1.0.1)"
+    #           "libPusher (> 1.0, < 2.0)"
+    #           "libPusher (HEAD)"
+    #           "libPusher (from `www.example.com')"
+    #           "libPusher (defined in Podfile)"
+    #           "RestKit/JSON"
+    #
+    # @return   [String] the representation of the dependency.
+    #
+    def to_s
+      version = ''
+      if external?
+        version << external_source_description
+      elsif head?
+        version << 'HEAD'
+      elsif @version_requirements != Requirement.default
+        version << @version_requirements.to_s
+      end
+      result = @name.dup
+      result << " (#{version})" unless version.empty?
+      result
+    end
+
+    # Generates a dependency from its string representation.
+    #
+    # @param    [String] string
+    #           The string that describes the dependency generated from
+    #           {#to_s}.
+    #
+    # @note     The information about external sources is not completely
+    #           serialized in the string representation and should be stored a
+    #           part by clients that need to create a dependency equal to the
+    #           original one.
+    #
+    # @return   [Dependency] the dependency described by the string.
+    #
+    def self.from_string(string)
+      match_data = string.match(/(\S*)( (.*))?/)
+      name = match_data[1]
+      version = match_data[2]
+      version = version.gsub(/[()]/,'') if version
+      case version
+      when nil || /from `(.*)(`|')/
+        Dependency.new(name)
+      when /HEAD/
+        Dependency.new(name, :head)
+      else
+        Dependency.new(name, version)
+      end
+    end
+
+    # @return [String] a string representation suitable for debugging.
+    #
+    def inspect
+      "<#{self.class} name=#{self.name} requirements=#{requirement.to_s} " \
+      "external_source=#{external_source||'nil'}>"
+    end
+
+    #--------------------------------------#
+
+    private
+
+    # Creates a string representation of the external source suitable for UI.
+    #
+    # @example  Output examples
+    #
+    #           "from `www.example.com/libPusher.git', tag `v0.0.1'"
+    #           "from `www.example.com/libPusher.podspec'"
+    #           "from `~/path/to/libPusher'"
+    #
+    # @todo     Improve the description for Mercurial and Subversion.
+    #
+    # @return   [String] the description of the external source.
+    #
+    def external_source_description
+      source = external_source
+      if source.key?(:git)
+        desc =  "`#{source[:git]}`"
+        desc << ", commit `#{source[:commit]}`" if source[:commit]
+        desc << ", branch `#{source[:branch]}`" if source[:branch]
+        desc << ", tag `#{source[:tag]}`"       if source[:tag]
+      elsif source.key?(:hg)
+        desc =  "`#{source[:hg]}`"
+      elsif source.key?(:svn)
+        desc =  "`#{source[:svn]}`"
+      elsif source.key?(:podspec)
+        desc = "`#{source[:podspec]}`"
+      elsif source.key?(:local)
+        desc = "`#{source[:local]}`"
+      else
+        desc = "`#{source.to_s}`"
+      end
+      "from #{desc}"
+    end
+  end
+end

data/lib/cocoapods-core/gem_version.rb

@@ -0,0 +1,6 @@
+module Pod
+
+  # The version of the cocoapods-core.
+  #
+  CORE_VERSION = '0.17.0.rc1' unless defined? Pod::CORE_VERSION
+end