pullr 0.1.1

data/.gitignore

@@ -0,0 +1,9 @@
+doc
+pkg
+tmp/*
+.DS_Store
+.yardoc
+*.db
+*.log
+*.swp
+*~

data/.specopts

@@ -0,0 +1 @@
+--colour --format specdoc

data/.yardopts

@@ -0,0 +1 @@
+--markup markdown --title 'Pullr Documentation' --protected --files ChangeLog.md,LICENSE.txt

data/ChangeLog.md

@@ -0,0 +1,9 @@
+### 0.1.1 / 2010-03-14
+
+* Initial release.
+  * Currently supports pulling from:
+    * Mercurial (Hg)
+    * Git
+    * SubVersion (SVN)
+    * Rsync
+

data/LICENSE.txt

@@ -0,0 +1,22 @@
+
+Copyright (c) 2010 Hal Brodigan
+
+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,76 @@
+# Pullr
+
+* [pullr.rubyforge.org](http://pullr.rubyforge.org/)
+* [github.com/postmodern/pullr](http://github.com/postmodern/pullr/)
+* Postmodern (postmodern.mod3 at gmail.com)
+
+## Description
+
+Pullr is a Ruby library for quickly pulling down or updating any Repository.
+Currently, Pullr supports Git, Mercurial (Hg), SubVersion (SVN) and Rsync.
+Pullr provides a command-line utility and an API which can be used by
+other frameworks.
+
+## Features
+
+* Currently supports pulling from:
+  * Mercurial (Hg)
+  * Git
+  * SubVersion (SVN)
+  * Rsync
+
+## Synopsis
+
+Pull down a repository:
+
+    $ pullr git://github.com/evanphx/rubinius.git
+
+Pull down a repository into a specific directory:
+
+    $ pullr git://github.com/datamapper/dm-rails.git /home/deploy/dm-rails
+
+Pull down a repository from a generic HTTP URL:
+
+    $ pullr http://www.tortall.net/svn/yasm/trunk/yasm -S svn
+
+Update an existing repository:
+
+    $ cd yasm
+    $ pullr -u
+
+## Examples
+
+Pull down a repository:
+
+    remote = Pullr::RemoteRepository.new(:uri => 'git://github.com/evanphx/rubinius.git')
+    remote.pull
+    # => #<Pullr::LocalRepository: ...>
+
+Pull down a repository into a specific directory:
+
+    remote = Pullr::RemoteRepository.new(:uri => 'git://github.com/datamapper/dm-rails.git /home/deploy/dm-rails')
+    remote.pull('/home/deploy/dm-rails')
+    # => #<Pullr::LocalRepository: ...>
+
+Pull down a repository from a generic HTTP URL:
+
+    remote = Pullr::RemoteRepository.new(:uri => 'http://www.tortall.net/svn/yasm/trunk/yasm', :scm => :svn)
+    remote.pull
+
+Update an existing repository:
+
+    local = Pullr::LocalRepository.new(:path => 'yasm')
+    local.update
+
+## Requirements
+
+* [addressable](http://addressable.rubyforge.org/) >= 0.2.1
+
+## Install
+
+    $ sudo gem install pullr
+
+## License
+
+See {file:LICENSE.txt} for license information.
+

data/Rakefile

@@ -0,0 +1,42 @@
+require 'rubygems'
+require 'rake'
+require './lib/pullr/version.rb'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = 'pullr'
+    gem.version = Pullr::VERSION
+    gem.summary = %Q{A Ruby library for quickly pulling down or updating any Repository.}
+    gem.description = %Q{Pullr is a Ruby library for quickly pulling down or updating any Repository. Pullr currently supports Git, Mercurial (Hg), SubVersion (SVN) and Rsync. Pullr provides a command-line utility and an API which can be used by other frameworks.}
+    gem.email = 'postmodern.mod3@gmail.com'
+    gem.homepage = 'http://github.com/postmodern/pullr'
+    gem.authors = ['Postmodern']
+    gem.add_dependency 'addressable', '>= 2.1.1'
+    gem.add_development_dependency 'rspec', '>= 1.3.0'
+    gem.add_development_dependency 'yard', '>= 0.5.3'
+    gem.has_rdoc = 'yard'
+  end
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs += ['lib', 'spec']
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+  spec.spec_opts = ['--options', '.specopts']
+end
+
+task :spec => :check_dependencies
+task :default => :spec
+
+begin
+  require 'yard'
+
+  YARD::Rake::YardocTask.new
+rescue LoadError
+  task :yard do
+    abort "YARD is not available. In order to run yard, you must: gem install yard"
+  end
+end

data/bin/pullr

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+lib_dir = File.expand_path(File.join(File.dirname(__FILE__),'..','lib'))
+unless $LOAD_PATH.include?(lib_dir)
+  $LOAD_PATH << lib_dir
+end
+
+require 'pullr/cli'
+
+Pullr::CLI.run

data/lib/pullr.rb

@@ -0,0 +1,3 @@
+require 'pullr/remote_repository'
+require 'pullr/local_repository'
+require 'pullr/version'

data/lib/pullr/cli.rb

@@ -0,0 +1,98 @@
+require 'pullr/local_repository'
+require 'pullr/remote_repository'
+
+require 'optparse'
+
+module Pullr
+  class CLI
+
+    #
+    # Initializes the Command Line Interface (CLI).
+    #
+    def initialize
+      @scm = nil
+      @uri = nil
+      @path = nil
+      @mode = :clone
+      @args = []
+    end
+
+    #
+    # Runs the Command Line Interface (CLI).
+    #
+    def CLI.run
+      self.new.run(*ARGV)
+    end
+
+    #
+    # Runs the Command Line Interface (CLI) with the given arguments.
+    #
+    # @param [Array<String>] args
+    #   Arguments to run the CLI with.
+    #
+    def run(*args)
+      optparse(*args)
+
+      case @mode
+      when :clone
+        @uri ||= @args[0]
+
+        unless @uri
+          STDERR.puts "pullr: missing the URI argument"
+          exit -1
+        end
+
+        repo = RemoteRepository.new(
+          :uri => @uri,
+          :scm => @scm
+        )
+
+        repo.pull(@path || @args[1])
+      when :update
+        repo = LocalRepository.new(
+          :uri => @uri,
+          :path => @path,
+          :scm => @scm
+        )
+
+        repo.update
+      end
+    end
+
+    protected
+
+    #
+    # Parses the given arguments.
+    #
+    # @param [Array<String>] args
+    #   The command-line arguments.
+    #
+    def optparse(*args)
+      opts = OptionParser.new
+
+      opts.banner = 'usage: pullr URI [PATH]'
+
+      opts.on('-S','--scm NAME','Source Code Management to use') do |scm|
+        @scm = scm
+      end
+
+      opts.on('-U','--uri URI','The URI of the repository') do |uri|
+        @uri = uri
+      end
+
+      opts.on('-u','--update [PATH]','Update the repository') do |path|
+        @mode = :update
+        @path = (path || Dir.pwd)
+      end
+
+      begin
+        @args = opts.parse!(args)
+      rescue OptionParser::InvalidOption => e
+        STDERR.puts e.message
+        STDERR.puts opts
+        exit -1
+      end
+    end
+
+  end
+end

data/lib/pullr/command_line.rb

@@ -0,0 +1,39 @@
+module Pullr
+  module CommandLine
+    #
+    # Changes directories.
+    #
+    # @param [String] path
+    #   Path to the new directory.
+    #
+    # @yield []
+    #   If a block is given, then the directory will only be changed
+    #   temporarily, then changed back after the block has finished.
+    #
+    def cd(path,&block)
+      if block
+        pwd = Dir.pwd
+        Dir.chdir(path)
+
+        block.call()
+
+        Dir.chdir(pwd)
+      else
+        Dir.chdir(path)
+      end
+    end
+
+    #
+    # Runs a command.
+    #
+    # @param [String] program
+    #   The name or path of the program to run.
+    #
+    # @param [Array<String>] args
+    #   The additional arguments to run with the program.
+    #
+    def sh(program,*args)
+      system(program,*args)
+    end
+  end
+end

data/lib/pullr/exceptions.rb

@@ -0,0 +1,3 @@
+require 'pullr/exceptions/ambigious_repository'
+require 'pullr/exceptions/ambigious_uri'
+require 'pullr/exceptions/unknown_scm'

data/lib/pullr/exceptions/ambigious_repository.rb

@@ -0,0 +1,4 @@
+module Pullr
+  class AmbigiousRepository < RuntimeError
+  end
+end

data/lib/pullr/exceptions/ambigious_uri.rb

@@ -0,0 +1,4 @@
+module Pullr
+  class AmbigiousURI < RuntimeError
+  end
+end

data/lib/pullr/exceptions/unknown_scm.rb

@@ -0,0 +1,4 @@
+module Pullr
+  class UnknownSCM < StandardError
+  end
+end

data/lib/pullr/local_repository.rb

@@ -0,0 +1,72 @@
+require 'pullr/exceptions/ambigious_repository'
+require 'pullr/repository'
+
+module Pullr
+  class LocalRepository
+
+    include Repository
+
+    # The path of the repository
+    attr_reader :path
+
+    # The SCM used for the repository
+    attr_reader :scm
+
+    # Optional URI for the remote repository
+    attr_accessor :uri
+
+    #
+    # Initializes the repository.
+    #
+    # @param [Hash] options
+    #   Options for the repository.
+    #
+    # @option options [String] :path
+    #   Path to the repository.
+    #
+    # @option options [Symbol, String] :scm
+    #   The SCM used to manage the repository.
+    #
+    # @option options [URI::Generic] :uri
+    #   Optional URI for the remote repository.
+    #
+    def initialize(options={})
+      super(options)
+
+      @path = options[:path]
+
+      unless @scm
+        infer_scm_from_dir && infer_scm_from_uri
+      end
+
+      unless @scm
+        raise(AmbigiousRepository,"could not infer the SCM from the directory #{@path.dump}",caller)
+      end
+
+      extend SCM.lookup(@scm)
+    end
+
+    #
+    # The control directory used by the SCM.
+    #
+    # @return [String]
+    #   The name of the control directory.
+    #
+    def scm_dir
+      dir, scm = SCM::DIRS.find { |dir,scm| scm == @scm }
+
+      return dir
+    end
+
+    #
+    # Pulls any new updates for the repository down.
+    #
+    # @param [URI::Generic] uri
+    #   Optional URI to pull from.
+    #
+    def update(uri=self.uri)
+      scm_update(@path,uri)
+    end
+  
+  end
+end

data/lib/pullr/remote_repository.rb

@@ -0,0 +1,56 @@
+require 'pullr/exceptions/ambigious_uri'
+require 'pullr/repository'
+require 'pullr/local_repository'
+
+module Pullr
+  class RemoteRepository
+
+    include Repository
+
+    # The SCM that manages the remote repository
+    attr_reader :scm
+
+    # The URI of the remote repository
+    attr_reader :uri
+
+    #
+    # Initializes the remote repository.
+    #
+    # @param [Hash] options
+    #   Options for the remote repository.
+    #
+    # @option options [URI::Generic] :uri
+    #   The URI of the remote repository.
+    #
+    # @option options [Symbol, String] :scm
+    #   The SCM used for the remote repository.
+    #
+    def initialize(options={})
+      super(options)
+
+      infer_scm_from_uri unless @scm
+
+      unless @scm
+        raise(AmbigiousURI,"could not infer the SCM used for the URI #{@uri}",caller)
+      end
+
+      extend SCM.lookup(@scm)
+    end
+
+    #
+    # Clones the remote repository into the given destination.
+    #
+    # @param [String] dest
+    #   The destination directory to clone the repository into.
+    #
+    # @return [Repository]
+    #   The cloned repository.
+    #
+    def pull(dest=nil)
+      scm_pull(@uri,dest)
+
+      return LocalRepository.new(:path => dest, :scm => @scm)
+    end
+
+  end
+end

data/lib/pullr/repository.rb

@@ -0,0 +1,67 @@
+require 'pullr/scm/scm'
+
+require 'addressable/uri'
+
+module Pullr
+  module Repository
+    #
+    # Initializes the repository.
+    #
+    # @param [Hash] options
+    #   Options for the repository.
+    #
+    # @option options [Symbol, String] :scm
+    #   The SCM used to manage the repository.
+    #
+    # @option options [URI::Generic] :uri
+    #   Optional URI for the remote repository.
+    #
+    def initialize(options={})
+      @scm = options[:scm]
+      @uri = nil
+
+      case options[:uri]
+      when Addressable::URI
+        @uri = options[:uri]
+      when Hash
+        @uri = Addressable::URI.new(options[:uri])
+      when URI::Generic, String
+        @uri = Addressable::URI.parse(options[:uri])
+      end
+    end
+
+    protected
+
+    #
+    # Attempts to infer the SCM used for the remote repository.
+    #
+    # @return [Boolean]
+    #   Specifies whether the SCM was infered from the repository's URI.
+    #
+    def infer_scm_from_uri
+      if @uri
+        if (@scm = SCM.infer_from_uri(@uri))
+          return true
+        end
+      end
+
+      return false
+    end
+
+    #
+    # Attempts to infer the SCM used for the repository.
+    #
+    # @return [Boolean]
+    #   Specifies whether the SCM was successfully infered.
+    #
+    def infer_scm_from_dir
+      if @path
+        if (@scm = SCM.infer_from_dir(@path))
+          return true
+        end
+      end
+
+      return false
+    end
+  end
+end

data/lib/pullr/scm.rb

@@ -0,0 +1 @@
+require 'pullr/scm/scm'

data/lib/pullr/scm/git.rb

@@ -0,0 +1,42 @@
+require 'pullr/command_line'
+
+module Pullr
+  module SCM
+    module Git
+      include CommandLine
+
+      #
+      # Pulls down a copy of a Git source repository.
+      #
+      # @param [Addressable::URI] uri
+      #   The URI of the Git repository.
+      #
+      # @param [String] dest
+      #   Optional destination to pull the repository down into.
+      #
+      def scm_pull(uri,dest=nil)
+        if dest
+          sh 'git', 'clone', uri, dest
+        else
+          sh 'git', 'clone', uri
+        end
+      end
+
+      #
+      # Updates a local Git repository.
+      #
+      # @param [String] path
+      #   Path to the local repository to update.
+      #
+      # @param [Addressable::URI] uri
+      #   Optional URI of the remote Git repository to update from.
+      #
+      def scm_update(path,uri=nil)
+        cd(path) do
+          sh 'git', 'reset', '-q', '--hard', 'HEAD'
+          sh 'git', 'pull'
+        end
+      end
+    end
+  end
+end

data/lib/pullr/scm/mercurial.rb

@@ -0,0 +1,42 @@
+require 'pullr/command_line'
+
+module Pullr
+  module SCM
+    module Mercurial
+      include CommandLine
+
+      #
+      # Pulls down a copy of a Mercurial repository.
+      #
+      # @param [Addressable::URI] uri
+      #   The URI of the Mercurial repository.
+      #
+      # @param [String] dest
+      #   Optional destination to pull the repository down into.
+      #
+      def scm_pull(uri,dest=nil)
+        if dest
+          sh 'hg', 'clone', uri, dest
+        else
+          sh 'hg', 'clone', uri
+        end
+      end
+
+      #
+      # Updates a local Mercurial repository.
+      #
+      # @param [String] path
+      #   Path to the local repository to update.
+      #
+      # @param [Addressable::URI] uri
+      #   Optional URI of the remote Mercurial repository to update from.
+      #
+      def scm_update(path,uri=nil)
+        cd(path) do
+          sh 'hg', 'pull'
+          sh 'hg', 'update', '-C'
+        end
+      end
+    end
+  end
+end

data/lib/pullr/scm/rsync.rb

@@ -0,0 +1,61 @@
+require 'pullr/command_line'
+
+module Pullr
+  module SCM
+    module Rsync
+      include CommandLine
+
+      #
+      # Pulls down a copy of a Rsync source repository.
+      #
+      # @param [Addressable::URI] uri
+      #   The URI of the Rsync repository.
+      #
+      # @param [String] dest
+      #   Optional destination to pull the repository down into.
+      #
+      def scm_pull(uri,dest=nil)
+        unless dest
+          raise(ArgumentError,"the destination argument for clone is missing",caller)
+        end
+
+        sh 'rsync', '-a', rsync_uri(uri), dest
+      end
+
+      #
+      # Updates a local Rsync repository.
+      #
+      # @param [String] path
+      #   Path to the local repository to update.
+      #
+      # @param [Addressable::URI] uri
+      #   Optional URI of the remote Rsync repository to update from.
+      #
+      def scm_update(path,uri=nil)
+        unless uri
+          raise(ArgumentError,"must specify the 'uri' argument to pull from",caller)
+        end
+
+        sh 'rsync', '-v', '-a', '--delete-after', rsync_uri(uri), path
+      end
+
+      #
+      # Converts a given URI to one compatible with `rsync`.
+      #
+      # @param [URI::Generic] uri
+      #   The URI to convert.
+      #
+      # @return [String]
+      #   The `rsync` compatible URI.
+      #
+      def rsync_uri(uri)
+        new_uri = uri.host
+
+        new_uri = "#{uri.user}@#{new_uri}" if uri.user
+        new_uri = "#{new_uri}:#{uri.path}" unless uri.path.empty?
+
+        return new_uri
+      end
+    end
+  end
+end

data/lib/pullr/scm/scm.rb

@@ -0,0 +1,107 @@
+require 'pullr/exceptions/unknown_scm'
+require 'pullr/scm/git'
+require 'pullr/scm/mercurial'
+require 'pullr/scm/sub_version'
+require 'pullr/scm/rsync'
+
+module Pullr
+  module SCM
+    # Mapping of known SCM names and their respective mixins
+    NAMES = {
+      :git => Git,
+      :mercurial => Mercurial,
+      :hg => Mercurial,
+      :sub_version => SubVersion,
+      :subversion => SubVersion,
+      :svn => SubVersion,
+      :rsync => Rsync
+    }
+
+    # Mapping of known URI schemes and their respective SCM names
+    SCHEMES = {
+      'git' => :git,
+      'hg' => :mercurial,
+      'svn' => :sub_version,
+      'svn+ssh' => :sub_version,
+      'rsync' => :rsync
+    }
+
+    # Mapping of URI path extensions and their respective SCM names
+    EXTS = {
+      '.git' => :git
+    }
+
+    # Mapping of directories and the SCMs that use them
+    DIRS = {
+      '.git' => :git,
+      '.hg' => :mercurial,
+      '.svn' => :sub_version
+    }
+
+    #
+    # Attempts to infer the SCM used for the remote repository.
+    #
+    # @param [Addressable::URI] uri
+    #   The URI to infer the SCM from.
+    #
+    # @return [Symbol]
+    #   The name of the infered SCM.
+    #
+    def SCM.infer_from_uri(uri)
+      uri_scheme = uri.scheme
+
+      if (scm = SCM::SCHEMES[uri_scheme])
+        return scm
+      end
+
+      uri_ext = File.extname(uri.path)
+
+      if (scm = SCM::EXTS[uri_ext])
+        return scm
+      end
+
+      return nil
+    end
+
+    #
+    # Attempts to infer the SCM used to manage a given directory.
+    #
+    # @param [String] path
+    #   The path to the directory.
+    #
+    # @return [Symbol]
+    #   The name of the infered SCM.
+    #
+    def SCM.infer_from_dir(path)
+      SCM::DIRS.each do |name,scm|
+        if File.directory?(File.join(path,name))
+          return scm
+        end
+      end
+
+      return nil
+    end
+
+    #
+    # Finds the SCM mixin for a given SCM name.
+    #
+    # @param [Symbol, String] name
+    #   The name of the SCM.
+    #
+    # @return [Module]
+    #   The SCM mixin.
+    #
+    # @raise [UnknownSCM]
+    #   The SCM name did not map to a known SCM mixin.
+    #
+    def SCM.lookup(name)
+      name = name.to_sym
+
+      unless NAMES.has_key?(name)
+        raise(UnknownSCM,"unknown SCM #{name}",caller)
+      end
+
+      return NAMES[name]
+    end
+  end
+end

data/lib/pullr/scm/sub_version.rb

@@ -0,0 +1,39 @@
+require 'pullr/command_line'
+
+module Pullr
+  module SCM
+    module SubVersion
+      include CommandLine
+
+      #
+      # Pulls down a copy of a SubVersion source repository.
+      #
+      # @param [Addressable::URI] uri
+      #   The URI of the SubVersion repository.
+      #
+      # @param [String] dest
+      #   Optional destination to pull the repository down into.
+      #
+      def scm_pull(uri,dest=nil)
+        if dest
+          sh 'svn', 'checkout', uri, dest
+        else
+          sh 'svn', 'checkout', uri
+        end
+      end
+
+      #
+      # Updates a local SubVersion repository.
+      #
+      # @param [String] path
+      #   Path to the local repository to update.
+      #
+      # @param [Addressable::URI] uri
+      #   Optional URI of the remote SubVersion repository to update from.
+      #
+      def scm_update(path,uri=nil)
+        cd(path) { sh 'svn', 'update' }
+      end
+    end
+  end
+end

data/lib/pullr/version.rb

@@ -0,0 +1,4 @@
+module Pullr
+  # pullr version
+  VERSION = '0.1.1'
+end

data/pullr.gemspec

@@ -0,0 +1,84 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{pullr}
+  s.version = "0.1.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Postmodern"]
+  s.date = %q{2010-03-14}
+  s.default_executable = %q{pullr}
+  s.description = %q{Pullr is a Ruby library for quickly pulling down or updating any Repository. Pullr currently supports Git, Mercurial (Hg), SubVersion (SVN) and Rsync. Pullr provides a command-line utility and an API which can be used by other frameworks.}
+  s.email = %q{postmodern.mod3@gmail.com}
+  s.executables = ["pullr"]
+  s.extra_rdoc_files = [
+    "ChangeLog.md",
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.files = [
+    ".gitignore",
+    ".specopts",
+    ".yardopts",
+    "ChangeLog.md",
+    "LICENSE.txt",
+    "README.md",
+    "Rakefile",
+    "bin/pullr",
+    "lib/pullr.rb",
+    "lib/pullr/cli.rb",
+    "lib/pullr/command_line.rb",
+    "lib/pullr/exceptions.rb",
+    "lib/pullr/exceptions/ambigious_repository.rb",
+    "lib/pullr/exceptions/ambigious_uri.rb",
+    "lib/pullr/exceptions/unknown_scm.rb",
+    "lib/pullr/local_repository.rb",
+    "lib/pullr/remote_repository.rb",
+    "lib/pullr/repository.rb",
+    "lib/pullr/scm.rb",
+    "lib/pullr/scm/git.rb",
+    "lib/pullr/scm/mercurial.rb",
+    "lib/pullr/scm/rsync.rb",
+    "lib/pullr/scm/scm.rb",
+    "lib/pullr/scm/sub_version.rb",
+    "lib/pullr/version.rb",
+    "pullr.gemspec",
+    "spec/pullr_spec.rb",
+    "spec/scm_spec.rb",
+    "spec/spec_helper.rb"
+  ]
+  s.has_rdoc = %q{yard}
+  s.homepage = %q{http://github.com/postmodern/pullr}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{A Ruby library for quickly pulling down or updating any Repository.}
+  s.test_files = [
+    "spec/spec_helper.rb",
+    "spec/pullr_spec.rb",
+    "spec/scm_spec.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<addressable>, [">= 2.1.1"])
+      s.add_development_dependency(%q<rspec>, [">= 1.3.0"])
+      s.add_development_dependency(%q<yard>, [">= 0.5.3"])
+    else
+      s.add_dependency(%q<addressable>, [">= 2.1.1"])
+      s.add_dependency(%q<rspec>, [">= 1.3.0"])
+      s.add_dependency(%q<yard>, [">= 0.5.3"])
+    end
+  else
+    s.add_dependency(%q<addressable>, [">= 2.1.1"])
+    s.add_dependency(%q<rspec>, [">= 1.3.0"])
+    s.add_dependency(%q<yard>, [">= 0.5.3"])
+  end
+end
+

data/spec/pullr_spec.rb

@@ -0,0 +1,9 @@
+require 'pullr/version'
+
+require 'spec_helper'
+
+describe Pullr do
+  it "should define a VERSION constant" do
+    Pullr.should be_const_defined('VERSION')
+  end
+end

data/spec/scm_spec.rb

@@ -0,0 +1,115 @@
+require 'pullr/scm/scm'
+
+require 'spec_helper'
+require 'addressable/uri'
+require 'fileutils'
+require 'tmpdir'
+
+describe SCM do
+  it "should lookup an SCM with a String name" do
+    SCM.lookup('git').should == SCM::Git
+  end
+
+  it "should lookup an SCM with a Symbol name" do
+    SCM.lookup(:git).should == SCM::Git
+  end
+
+  it "should raise UnknownSCM when looking up unknown SCM names" do
+    lambda {
+      SCM.lookup(:bla)
+    }.should raise_error(UnknownSCM)
+  end
+
+  describe "Git" do
+    it "should be known as 'git'" do
+      SCM.lookup(:git).should == SCM::Git
+    end
+
+    it "should be inferable from the scheme of a URI" do
+      uri = Addressable::URI.parse('git://sourceforge.net')
+
+      SCM.infer_from_uri(uri).should == :git
+    end
+
+    it "should be inferable from the extension of a URI" do
+      uri = Addressable::URI.parse('git@github.com/user/project.git')
+
+      SCM.infer_from_uri(uri).should == :git
+    end
+
+    it "should be inferable from the SCM control directory" do
+      repo = Dir.mktmpdir('repo')
+      FileUtils.mkdir(File.join(repo,'.git'))
+
+      SCM.infer_from_dir(repo).should == :git
+    end
+  end
+
+  describe "Mercurial" do
+    it "should be known as 'mercurial'" do
+      SCM.lookup(:mercurial).should == SCM::Mercurial
+    end
+
+    it "should also be known as 'hg'" do
+      SCM.lookup(:hg).should == SCM::Mercurial
+    end
+
+    it "should be inferable from the scheme of a URI" do
+      uri = Addressable::URI.parse('hg://sourceforge.net')
+
+      SCM.infer_from_uri(uri).should == :mercurial
+    end
+
+    it "should be inferable from the SCM control directory" do
+      repo = Dir.mktmpdir('repo')
+      FileUtils.mkdir(File.join(repo,'.hg'))
+
+      SCM.infer_from_dir(repo).should == :mercurial
+    end
+  end
+
+  describe "SubVersion" do
+    it "should be known as 'sub_version'" do
+      SCM.lookup(:sub_version).should == SCM::SubVersion
+    end
+
+    it "should also be known as 'subversion'" do
+      SCM.lookup(:subversion).should == SCM::SubVersion
+    end
+
+    it "should also be known as 'svn'" do
+      SCM.lookup(:svn).should == SCM::SubVersion
+    end
+
+    it "should be inferable from the scheme of a URI" do
+      uri = Addressable::URI.parse('svn://sourceforge.net')
+
+      SCM.infer_from_uri(uri).should == :sub_version
+    end
+
+    it "should be inferable from the 'svn+ssh' URI scheme " do
+      uri = Addressable::URI.parse('svn+ssh://sourceforge.net')
+
+      SCM.infer_from_uri(uri).should == :sub_version
+    end
+
+    it "should be inferable from the SCM control directory" do
+      repo = Dir.mktmpdir('repo')
+      FileUtils.mkdir(File.join(repo,'.svn'))
+
+      SCM.infer_from_dir(repo).should == :sub_version
+    end
+  end
+
+  describe "Rsync" do
+    it "should be known as 'rsync'" do
+      SCM.lookup(:rsync).should == SCM::Rsync
+    end
+
+    it "should be inferable from the scheme of a URI" do
+      uri = Addressable::URI.parse('rsync://sourceforge.net')
+
+      SCM.infer_from_uri(uri).should == :rsync
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,7 @@
+require 'rubygems'
+gem 'rspec', '>=1.3.0'
+require 'spec'
+
+require 'pullr/version'
+
+include Pullr

metadata

@@ -0,0 +1,135 @@
+--- !ruby/object:Gem::Specification 
+name: pullr
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 1
+  version: 0.1.1
+platform: ruby
+authors: 
+- Postmodern
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-03-14 00:00:00 -08:00
+default_executable: pullr
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: addressable
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 1
+        - 1
+        version: 2.1.1
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 3
+        - 0
+        version: 1.3.0
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: yard
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 5
+        - 3
+        version: 0.5.3
+  type: :development
+  version_requirements: *id003
+description: Pullr is a Ruby library for quickly pulling down or updating any Repository. Pullr currently supports Git, Mercurial (Hg), SubVersion (SVN) and Rsync. Pullr provides a command-line utility and an API which can be used by other frameworks.
+email: postmodern.mod3@gmail.com
+executables: 
+- pullr
+extensions: []
+
+extra_rdoc_files: 
+- ChangeLog.md
+- LICENSE.txt
+- README.md
+files: 
+- .gitignore
+- .specopts
+- .yardopts
+- ChangeLog.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/pullr
+- lib/pullr.rb
+- lib/pullr/cli.rb
+- lib/pullr/command_line.rb
+- lib/pullr/exceptions.rb
+- lib/pullr/exceptions/ambigious_repository.rb
+- lib/pullr/exceptions/ambigious_uri.rb
+- lib/pullr/exceptions/unknown_scm.rb
+- lib/pullr/local_repository.rb
+- lib/pullr/remote_repository.rb
+- lib/pullr/repository.rb
+- lib/pullr/scm.rb
+- lib/pullr/scm/git.rb
+- lib/pullr/scm/mercurial.rb
+- lib/pullr/scm/rsync.rb
+- lib/pullr/scm/scm.rb
+- lib/pullr/scm/sub_version.rb
+- lib/pullr/version.rb
+- pullr.gemspec
+- spec/pullr_spec.rb
+- spec/scm_spec.rb
+- spec/spec_helper.rb
+has_rdoc: yard
+homepage: http://github.com/postmodern/pullr
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: A Ruby library for quickly pulling down or updating any Repository.
+test_files: 
+- spec/spec_helper.rb
+- spec/pullr_spec.rb
+- spec/scm_spec.rb