cocoapods-downloader 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 423ed46eabbb91ff618c8848326e3b66f006588f
+  data.tar.gz: d88c23a94aa7f69e33d8cd3ce429086fc072a858
+SHA512:
+  metadata.gz: 15f102043735c5a60b661d42485b2f286ab586210961d7f68f91cf306310ef679112412f7b1533d086556a60b0b5c2fa8b9efb825ad6daf1ad784845a5d06864
+  data.tar.gz: 375648ab909ee38343e34c240ec598e7316cb6fbb13aaaed321ecea90a4cc5a0fb0d260beb7bd99e1f516b46ceb8ac85d2cc3c83c59a770d6572c4bf16151ac5

data/LICENSE

@@ -0,0 +1,21 @@
+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.markdown

@@ -0,0 +1,72 @@
+# Downloader
+
+A small library for downloading files from remotes in a folder.
+
+[![Build Status](https://travis-ci.org/CocoaPods/cocoapods-downloader.png?branch=master)](https://travis-ci.org/CocoaPods/cocoapods-downloader)
+
+## Install
+
+```
+$ [sudo] gem install claide
+```
+
+## Usage
+
+```ruby
+require 'cocoapods-downloaders'
+
+target_path = './Downloads/MyDownload'
+options = { :git => 'example.com' }
+downloader = Pod::Downloaders.for_target(target_path, options)
+downloader.cache_root = '~/Library/Caches/APPNAME'
+downloader.max_cache_size = 500
+downloader.download
+downloader.checkout_options #=> { :git => 'example.com', :commit => 'd7f410490dabf7a6bde665ba22da102c3acf1bd9' }
+```
+
+The downloader class supports the following option keys:
+
+- git: commit, tag, branch, submodules
+- hg: revision
+- svn: revision, tag, folder
+- http: type
+
+The downloader also provides hooks which allow to customize its output or the way in which the commands are executed
+
+```ruby
+require 'cocoapods-downloader'
+
+module Pod
+  module Downloader
+    class Base
+
+      override_api do
+        def self.execute_command(executable, command, raise_on_failure = false)
+          puts "Will download"
+          super
+        end
+
+        def self.ui_action(ui_message)
+          puts ui_message.green
+          yield
+        end
+      end
+
+    end
+  end
+end
+```
+
+## Extraction
+
+This gem was extracted from [CocoaPods](https://github.com/CocoaPods/CocoaPods). Refer to also that repository for the history and the contributors.
+
+## 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-downloader.rb

@@ -0,0 +1,72 @@
+
+module Pod
+  module Downloader
+    require 'cocoapods-downloader/gem_version'
+
+    require 'cocoapods-downloader/api'
+    require 'cocoapods-downloader/api_exposable'
+    require 'cocoapods-downloader/base'
+
+
+    # @return [Hash{Symbol=>Class}] The symbol of the options array associated
+    #         with each class.
+    #
+    def self.downloader_class_by_key
+      require 'cocoapods-downloader/git'
+      require 'cocoapods-downloader/mercurial'
+      require 'cocoapods-downloader/subversion'
+      require 'cocoapods-downloader/http'
+
+      {
+        :git  => Git,
+        :hg   => Mercurial,
+        :svn  => Subversion,
+        :http => Http,
+      }
+    end
+
+    # @return [Downloader::Base] A concrete downloader according to the
+    #         options.
+    #
+    # @todo   Improve the common support for the cache in Base and add specs.
+    # @todo   Find a way to switch to GitHub tarballs if no cache is used. Have
+    #         global options for the Downloader cache?
+    #
+    def self.for_target(target_path, options)
+
+      if target_path.nil?
+        raise DownloaderError, "No target path provided."
+      end
+
+      if options.nil? || options.empty?
+        raise DownloaderError, "No source url provided."
+      end
+
+      options = options.dup
+      klass = nil
+      url = nil
+      downloader_class_by_key.each do |key, key_klass|
+        url = options.delete(key)
+        if url
+          klass = key_klass
+          break
+        end
+      end
+
+      unless klass
+        raise DownloaderError, "Unsupported download strategy `#{options.inspect}`."
+      end
+
+      if klass == Git && url.to_s =~ /github.com/
+        klass = GitHub
+      end
+
+      klass.new(target_path, url, options)
+    end
+
+    # Denotes the error generated by a Downloader
+    #
+    class DownloaderError < StandardError; end
+
+  end
+end

data/lib/cocoapods-downloader/api.rb

@@ -0,0 +1,73 @@
+module Pod
+  module Downloader
+
+    # The Downloader::Hooks module allows to adapt the Downloader to
+    # the UI of other gems.
+    #
+    module API
+
+      # Executes
+      # @return [String] the ouptu of the command.
+      #
+      def execute_command(executable, command, raise_on_failure = false)
+        output = `\n#{executable} #{command} 2>&1`
+        check_exit_code!(executable, command, output) if raise_on_failure
+        puts output
+        output
+      end
+
+      # Cheks if the just executed command completed sucessfully.
+      #
+      # @raise  If the command failed.
+      #
+      # @return [void]
+      #
+      def check_exit_code!(executable, command, output)
+        if $?.to_i != 0
+          raise DownloaderError, "Error on `#{executable} #{command}`.\n#{output}"
+        end
+      end
+
+      # Indicates that an action will be perfomed. The action is passed as a
+      # block.
+      #
+      # @param  [String] message
+      #         The message associated with the action.
+      #
+      # @yield  The action, this block is always exectued.
+      #
+      # @retur [void]
+      #
+      def ui_action(message)
+        puts message
+        yield
+      end
+
+      # Indicates that a minor action will be perfomed. The action is passed as
+      # a block.
+      #
+      # @param  [String] message
+      #         The message associated with the action.
+      #
+      # @yield  The action, this block is always exectued.
+      #
+      # @retur [void]
+      #
+      def ui_sub_action(message)
+        puts message
+        yield
+      end
+
+      # Prints an UI message.
+      #
+      # @param  [String] message
+      #         The message associated with the action.
+      #
+      # @retur [void]
+      #
+      def ui_message(message)
+        puts message
+      end
+    end
+  end
+end

data/lib/cocoapods-downloader/api_exposable.rb

@@ -0,0 +1,21 @@
+module Pod
+  module Downloader
+    module APIExposable
+
+      def expose_api(mod = nil, &block)
+        if mod.nil?
+          if block.nil?
+            raise "Either a module or a block that's used to create a module is required."
+          else
+            mod = Module.new(&block)
+          end
+        elsif mod && block
+          raise "Only a module *or* is required, not both."
+        end
+        include mod
+      end
+
+      alias_method :override_api, :expose_api
+    end
+  end
+end

data/lib/cocoapods-downloader/base.rb

@@ -0,0 +1,229 @@
+module Pod
+  module Downloader
+
+    # The base class defines the common behaviour of the downloaders.
+    #
+    # @abstract Subclass and implement {#download}.
+    #
+    # @private
+    #
+    class Base
+
+      extend APIExposable
+      expose_api API
+
+      # @abstract Override in subclasses.
+      #
+      # @return [Array<Symbol>] the options accepted by the concrete class.
+      #
+      def self.options
+        []
+      end
+
+      # @return [Pathname] the destination folder for the download.
+      #
+      attr_reader :target_path
+
+      # @return [String] the url of the remote source.
+      #
+      attr_reader :url
+
+      # @return [Hash={Symbol=>String}] options specific to each concrete
+      #         downloader.
+      #
+      attr_reader :options
+
+      # @param  [String, Pathname] target_path @see target_path
+      # @param  [String] url @see url
+      # @param  [Hash={Symbol=>String}] options @see options
+      #
+      # @todo   There is no need of the download only option, it should be
+      #         deprecated and the GitHub downloader should be initialized by
+      #         other means.
+      #
+      def initialize(target_path, url, options)
+        require 'pathname'
+        @target_path, @url, @options = Pathname.new(target_path), url, options
+        @max_cache_size = DEFAULT_MAX_CACHE_SIZE
+
+        accepted_options = self.class.options + [:download_only]
+        unrecognized_options = options.keys - accepted_options
+        unless unrecognized_options.empty?
+          raise DownloaderError, "Unrecognized options `#{unrecognized_options}`"
+        end
+      end
+
+      # @return [String] the name of the downloader.
+      #
+      # @example Downloader::Mercurial name
+      #
+      #   "Mercurial"
+      #
+      def name
+        self.class.name.split('::').last
+      end
+
+      #-----------------------------------------------------------------------#
+
+      # @!group Configuration
+
+      # @return [Fixnum] The maximum allowed size for the cache expressed in
+      #         Mb. Defaults to `500` Mb.
+      #
+      # @note   This is specific per downloader class.
+      #
+      attr_accessor :max_cache_size
+
+      # @return [String] The directory to use as root of the cache. If no
+      #         specified the caching will not be used. Defaults to `nil`.
+      #
+      attr_accessor :cache_root
+
+      # @return [Bool] Whether the downloader should use a more aggressive
+      #         caching or ensure that the cache always return the value of the
+      #         remote. Defaults to `false`.
+      #
+      attr_accessor :aggressive_cache
+      alias_method  :aggressive_cache?, :aggressive_cache
+
+      #-----------------------------------------------------------------------#
+
+      # @!group Downloading
+
+      # Downloads the revision specified in the option of a source. If no
+      # revision is specified it fall-back to {#download_head}.
+      #
+      # @return [void]
+      #
+      def download
+        ui_action("#{name} download") do
+          target_path.mkpath
+          download!
+          prune_cache
+        end
+      end
+
+      # Downloads the head revision of a source.
+      #
+      # @todo Spec for raise.
+      #
+      # @return [void]
+      #
+      def download_head
+        ui_action("#{name} HEAD download") do
+          if self.respond_to?(:download_head!, true)
+            download_head!
+          else
+            raise DownloaderError, "The `#{name}` downloader does not support " \
+            "the HEAD option."
+          end
+        end
+      end
+
+      # @return [Bool] Whether the options provided completely identify a source
+      #         or could lead to the download of different files in future.
+      #
+      def options_specific?
+        true
+      end
+
+      # @return [Hash{Symbol=>String}] The options that would allow to
+      #         re-download the exact files.
+      #
+      def checkout_options
+        raise "Abstract method"
+      end
+
+      #-----------------------------------------------------------------------#
+
+      # @!group Cache
+
+      public
+
+      # @return [Pathname] The directory where the cache for the current url
+      #         should be stored.
+      #
+      # @note   The name of the directory is the SHA1 hash value of the URL.
+      #
+      def cache_path
+        require 'digest/sha1'
+        if cache_root
+          @cache_path ||= class_cache_dir + "#{Digest::SHA1.hexdigest(url.to_s)}"
+        end
+      end
+
+      private
+
+      # @return [Pathname] The directory where the caches are stored.
+      #
+      def class_cache_dir
+        Pathname.new(File.expand_path(cache_root)) + name
+      end
+
+      # @return [Bool] Whether the downloader should use the cache.
+      #
+      def use_cache?
+         !cache_root.nil? && !@options[:download_only]
+      end
+
+      # The default maximum allowed size for the cache expressed in Mb.
+      #
+      DEFAULT_MAX_CACHE_SIZE = 500
+
+      # @return [Integer] The global size of the cache expressed in Mb.
+      #
+      def caches_size
+        `du -cm`.split("\n").last.to_i
+      end
+
+      # @return [void] Deletes the oldest caches until they the global size is
+      #         below the maximum allowed.
+      #
+      def prune_cache
+        return unless cache_root && class_cache_dir.exist?
+        Dir.chdir(class_cache_dir) do
+          repos = Pathname.new(class_cache_dir).children.select { |c| c.directory? }.sort_by(&:ctime)
+          while caches_size >= max_cache_size && !repos.empty?
+            dir = repos.shift
+            ui_message "Removing #{name} cache for `#{cache_origin_url(dir)}'"
+            dir.rmtree
+          end
+        end
+      end
+
+      private
+
+      # Defines two methods for an executable, based on its name. The bag version
+      # raises if the executable terminates with a non-zero exit code.
+      #
+      # For example
+      #
+      #     executable :git
+      #
+      # generates
+      #
+      #     def git(command)
+      #       Hooks.execute_with_check("git", command, false)
+      #     end
+      #
+      #     def git!(command)
+      #       Hooks.execute_with_check("git", command, true)
+      #     end
+      #
+      # @param  [Symbol] name
+      #         the name of the executable.
+      #
+      # @return [void]
+      #
+      def self.executable(name)
+        define_method(name) do |command|
+          execute_command(name.to_s, command, false)
+        end
+
+        define_method(name.to_s + "!") do |command|
+          execute_command(name.to_s, command, true)
+        end
+      end
+    end
+  end
+end

data/lib/cocoapods-downloader/gem_version.rb

@@ -0,0 +1,10 @@
+module Pod
+  module Downloader
+
+    # @return [String] Downloader’s version, following
+    #         [semver](http://semver.org).
+    #
+    VERSION = '0.1.0'
+
+  end
+end

data/lib/cocoapods-downloader/git.rb

@@ -0,0 +1,273 @@
+module Pod
+  module Downloader
+
+    # Concreted Downloader class that provides support for specifications with
+    # git sources.
+    #
+    class Git < Base
+
+      def self.options
+        [:commit, :tag, :branch, :submodules]
+      end
+
+      def options_specific?
+        !options[:commit].nil? || !options[:tag].nil?
+      end
+
+      def checkout_options
+        Dir.chdir(target_path) do
+          options = {}
+          options[:git] = url
+          options[:commit] = `git rev-parse HEAD`.chomp
+          options
+        end
+      end
+
+      private
+
+      executable :git
+
+      def download!
+        create_cache if use_cache? && !cache_exist?
+        if options[:tag]
+          download_tag
+        elsif options[:branch]
+          download_branch
+        elsif options[:commit]
+          download_commit
+        else
+          download_head!
+        end
+        Dir.chdir(target_path) { git! "submodule update --init"  } if options[:submodules]
+      end
+
+      # @return [void] Checkouts the HEAD of the git source in the destination
+      #         path.
+      #
+      def download_head!
+        update_cache if use_cache?
+        clone(clone_url, target_path)
+        Dir.chdir(target_path) { git! "submodule update --init"  } if options[:submodules]
+      end
+
+      #--------------------------------------#
+
+      # @!group Download implementations
+
+      # @return [Pathname] The clone URL, which resolves to the cache path.
+      #
+      def clone_url
+        use_cache? ? cache_path : url
+      end
+
+      # @return [void] Convenience method to perform clones operations.
+      #
+      def clone(from, to)
+        ui_sub_action("Cloning to Pods folder") do
+          git! %Q|clone "#{from}" "#{to}"|
+        end
+      end
+
+      # @return [void] Checkouts a specific tag of the git source in the
+      #         destination path.
+      #
+      # @note   Tags trigger a cache update unless aggressive cache is
+      #         specified.
+      #
+      # @note   Git fetch and checkout output to standard error and thus they
+      #         are redirected to stdout.
+      #
+      def download_tag
+        if use_cache?
+          if aggressive_cache?
+            ensure_ref_exists(options[:tag])
+          else
+            update_cache
+          end
+        end
+
+        Dir.chdir(target_path) do
+          git! "init"
+          git! "remote add origin '#{clone_url}'"
+          git! "fetch origin tags/#{options[:tag]} 2>&1"
+          git! "reset --hard FETCH_HEAD"
+          git! "checkout -b activated-pod-commit 2>&1"
+        end
+      end
+
+      # @return [void] Checkouts a specific commit of the git source in the
+      #         destination path.
+      #
+      # @note   Git checkouts output to standard error and thus it is
+      #         redirected to stdout.
+      #
+      def download_commit
+        ensure_ref_exists(options[:commit]) if use_cache?
+        clone(clone_url, target_path)
+        Dir.chdir(target_path) do
+          git! "checkout -b activated-pod-commit #{options[:commit]} 2>&1"
+        end
+      end
+
+      # @return [void] Checkouts the HEAD of a specific branch of the git
+      #         source in the destination path.
+      #
+      # @note   Git checkouts output to standard error and thus it is
+      #         redirected to stdout.
+      #
+      def download_branch
+        update_cache if use_cache?
+        clone(clone_url, target_path)
+        Dir.chdir(target_path) do
+          git! "remote add upstream '#{@url}'" # we need to add the original url, not the cache url
+          git! "fetch -q upstream" # refresh the branches
+          git! "checkout --track -b activated-pod-commit upstream/#{options[:branch]} 2>&1" # create a new tracking branch
+          ui_message("Just downloaded and checked out branch: #{options[:branch]} from upstream #{clone_url}")
+        end
+      end
+
+      #--------------------------------------#
+
+      # @!group Checking references
+
+      # @return [Bool] Whether a reference (commit SHA or tag)
+      #
+      def ref_exists?(ref)
+        if cache_exist?
+          Dir.chdir(cache_path) { git "rev-list --max-count=1 #{ref}" }
+          $? == 0
+        else
+          false
+        end
+      end
+
+      # @return [void] Checks if a reference exists in the cache and updates
+      #         only if necessary.
+      #
+      # @raise If after the update the reference can't be found.
+      #
+      def ensure_ref_exists(ref)
+        return if ref_exists?(ref)
+        update_cache
+        raise DownloaderError, "Cache unable to find git reference `#{ref}' for `#{url}'." unless ref_exists?(ref)
+      end
+
+      # @return [Bool] Whether a branch exists in the cache.
+      #
+      def branch_exists?(branch)
+        Dir.chdir(cache_path) { git "branch --all | grep #{branch}$" } # check for remote branch and do suffix matching ($ anchor)
+        $? == 0
+      end
+
+      # @return [void] Checks if a branch exists in the cache and updates
+      #         only if necessary.
+      #
+      # @raise  If after the update the branch can't be found.
+      #
+      def ensure_remote_branch_exists(branch)
+        return if branch_exists?(branch)
+        update_cache
+        raise DownloaderError, "Cache unable to find git reference `#{branch}' for `#{url}' (#{$?})." unless branch_exists?(branch)
+      end
+
+      #--------------------------------------#
+
+      # @!group Cache
+
+      # @return [Bool] Whether the cache exits.
+      #
+      # @note   The previous implementation of the cache didn't use a barebone
+      #         git repo. This method takes into account this fact and checks
+      #         that the cache is actually a barebone repo. If the cache was
+      #         not barebone it will be deleted and recreated.
+      #
+      def cache_exist?
+        cache_path.exist? &&
+          cache_origin_url(cache_path).to_s == url.to_s &&
+          Dir.chdir(cache_path) { git("config core.bare").chomp == "true" }
+      end
+
+      # @return [String] The origin URL of the cache with the given directory.
+      #
+      # @param [String] dir The directory of the cache.
+      #
+      def cache_origin_url(dir)
+        Dir.chdir(dir) { `git config remote.origin.url`.chomp }
+      end
+
+      # @return [void] Creates the barebone repo that will serve as the cache
+      #         for the current repo.
+      #
+      def create_cache
+        ui_sub_action("Creating cache git repo (#{cache_path})") do
+          cache_path.rmtree if cache_path.exist?
+          cache_path.mkpath
+          git! %Q|clone  --mirror "#{url}" "#{cache_path}"|
+        end
+      end
+
+      # @return [void] Updates the barebone repo used as a cache against its
+      #         remote creating it if needed.
+      #
+      def update_cache
+        if cache_exist?
+          ui_sub_action("Updating cache git repo (#{cache_path})") do
+            Dir.chdir(cache_path) { git! "remote update" }
+          end
+        else
+          create_cache
+        end
+      end
+    end
+
+    #---------------------------------------------------------------------------#
+
+    # Allows to download tarballs from GitHub.
+    #
+    class GitHub < Git
+
+      require 'open-uri'
+
+      def download_head!
+        download_only? ? download_and_extract_tarball('master') : super
+      end
+
+      def download_tag
+        download_only? ? download_and_extract_tarball(options[:tag]) : super
+      end
+
+      def download_commit
+        download_only? ? download_and_extract_tarball(options[:commit]) : super
+      end
+
+      def download_branch
+        download_only? ? download_and_extract_tarball(options[:branch]) : super
+      end
+
+      def tarball_url_for(id)
+        original_url, username, reponame = *(url.match(/[:\/]([\w\-]+)\/([\w\-]+)\.git/))
+        "https://github.com/#{username}/#{reponame}/tarball/#{id}"
+      end
+
+      def tmp_path
+        target_path + "tarball.tar.gz"
+      end
+
+      private
+
+      def download_only?
+        @options[:download_only]
+      end
+
+      def download_and_extract_tarball(id)
+        File.open(tmp_path, "w+") do |tmpfile|
+          open tarball_url_for(id) do |archive|
+            tmpfile.write Zlib::GzipReader.new(archive).read
+          end
+
+          system "tar xf #{tmpfile.path} -C #{target_path} --strip-components 1"
+        end
+      end
+    end
+  end
+end

data/lib/cocoapods-downloader/http.rb

@@ -0,0 +1,113 @@
+require 'zlib'
+
+module Pod
+  module Downloader
+    class Http < Base
+
+      def self.options
+        [:type, :flatten]
+      end
+
+      class UnsupportedFileTypeError < StandardError; end
+
+      private
+
+      executable :curl
+      executable :unzip
+      executable :tar
+
+      attr_accessor :filename, :download_path
+
+      def download!
+        @filename = filename_with_type(type)
+        @download_path = target_path + @filename
+        download_file(@download_path)
+        extract_with_type(@download_path, type)
+      end
+
+      def download_head!
+        download!
+      end
+
+      def type
+        options[:type] || type_with_url(url)
+      end
+
+      # @note   The archive is flattened if it contains only one folder and its
+      #         extension is either `tgz`, `tar`, `tbz` or the options specify
+      #         it.
+      #
+      # @return [Bool] Whether the archive should be flattened if it contains
+      #         only one folder.
+      #
+      def should_flatten?
+        if options.has_key?(:flatten)
+          true
+        elsif [:tgz, :tar, :tbz].include?(type)
+          true # those archives flatten by default
+        else
+          false # all others (actually only .zip) default not to flatten
+        end
+      end
+
+      def type_with_url(url)
+        if url =~ /.zip$/
+          :zip
+        elsif url =~ /.(tgz|tar\.gz)$/
+          :tgz
+        elsif url =~ /.tar$/
+          :tar
+        elsif url =~ /.(tbz|tar\.bz2)$/
+          :tbz
+        else
+          nil
+        end
+      end
+
+      def filename_with_type(type=:zip)
+        case type
+        when :zip
+          "file.zip"
+        when :tgz
+          "file.tgz"
+        when :tar
+          "file.tar"
+        when :tbz
+          "file.tbz"
+        else
+          raise UnsupportedFileTypeError.new "Unsupported file type: #{type}"
+        end
+      end
+
+      def download_file(full_filename)
+        curl! "-L -o '#{full_filename}' '#{url}'"
+      end
+
+      def extract_with_type(full_filename, type=:zip)
+        case type
+        when :zip
+          unzip! "'#{full_filename}' -d '#{target_path}'"
+        when :tgz
+          tar! "xfz '#{full_filename}' -C '#{target_path}'"
+        when :tar
+          tar! "xf '#{full_filename}' -C '#{target_path}'"
+        when :tbz
+          tar! "xfj '#{full_filename}' -C '#{target_path}'"
+        else
+          raise UnsupportedFileTypeError.new "Unsupported file type: #{type}"
+        end
+
+        # If the archive is a tarball and it only contained a folder, move its contents to the target (#727)
+        if should_flatten?
+          contents = target_path.children
+          contents.delete(full_filename)
+          entry = contents.first
+          if contents.count == 1 && entry.directory?
+            FileUtils.move(entry.children, target_path)
+          end
+        end
+      end
+
+    end
+  end
+end

data/lib/cocoapods-downloader/mercurial.rb

@@ -0,0 +1,45 @@
+module Pod
+  module Downloader
+    class Mercurial < Base
+
+      def self.options
+        [:revision]
+      end
+
+      def options_specific?
+        !options[:revision].nil?
+      end
+
+      def checkout_options
+        Dir.chdir(target_path) do
+          options = {}
+          options[:hg] = url
+          options[:revision] = `hg --debug id -i`.chomp
+          options
+        end
+      end
+
+      private
+
+      executable :hg
+
+      def download!
+        if options[:revision]
+          download_revision!
+        else
+          download_head!
+        end
+      end
+
+      def download_head!
+        hg! %|clone "#{url}" "#{target_path}"|
+      end
+
+      def download_revision!
+        hg! %|clone "#{url}" --rev '#{options[:revision]}' "#{target_path}"|
+      end
+
+    end
+  end
+end
+

data/lib/cocoapods-downloader/subversion.rb

@@ -0,0 +1,60 @@
+module Pod
+  module Downloader
+    class Subversion < Base
+
+      def self.options
+        [:revision, :tag, :folder]
+      end
+
+      def options_specific?
+        !options[:revision].nil? || !options[:tag].nil?
+      end
+
+      def checkout_options
+        Dir.chdir(target_path) do
+          options = {}
+          options[:svn] = url
+          options[:revision] = @exported_revision
+          options
+        end
+      end
+      private
+
+      executable :svn
+
+      def download!
+        output = svn!(%|#{export_subcommand} "#{reference_url}" "#{target_path}"|)
+          store_exported_revision(output)
+      end
+
+      def download_head!
+        output = svn!(%|#{export_subcommand} "#{trunk_url}" "#{target_path}"|)
+          store_exported_revision(output)
+      end
+
+      def store_exported_revision(output)
+        output.match(/Exported revision ([0-9]+)\./)
+        @exported_revision = $1
+      end
+
+      def export_subcommand
+        result = 'export --non-interactive --trust-server-cert --force'
+      end
+
+      def reference_url
+        result = url.dup
+        result << '/'       << options[:folder] if options[:folder]
+        result << '/tags/'  << options[:tag] if options[:tag]
+        result << '" -r "'  << options[:revision] if options[:revision]
+        result
+      end
+
+      def trunk_url
+        result = url.dup
+        result << '/' << options[:folder] if options[:folder]
+        result << '/trunk'
+        result
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,58 @@
+--- !ruby/object:Gem::Specification
+name: cocoapods-downloader
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Eloy Duran
+- Fabio Pelosin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-02-25 00:00:00.000000000 Z
+dependencies: []
+description: 
+email:
+- eloy.de.enige@gmail.com
+- fabiopelosin@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/cocoapods-downloader/api.rb
+- lib/cocoapods-downloader/api_exposable.rb
+- lib/cocoapods-downloader/base.rb
+- lib/cocoapods-downloader/gem_version.rb
+- lib/cocoapods-downloader/git.rb
+- lib/cocoapods-downloader/http.rb
+- lib/cocoapods-downloader/mercurial.rb
+- lib/cocoapods-downloader/subversion.rb
+- lib/cocoapods-downloader.rb
+- README.markdown
+- LICENSE
+homepage: https://github.com/CocoaPods/Downloader
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.0
+signing_key: 
+specification_version: 3
+summary: A small library for downloading files from remotes in a folder.
+test_files: []
+has_rdoc: