carat 1.9.9.pre1

data/bin/carat

@@ -0,0 +1,21 @@
+#!/usr/bin/env ruby
+
+# Exit cleanly from an early interrupt
+Signal.trap("INT") { exit 1 }
+
+require 'carat'
+# Check if an older version of carat is installed
+$LOAD_PATH.each do |path|
+  if path =~ %r'/carat-0\.(\d+)' && $1.to_i < 9
+    err = "Looks like you have a version of carat that's older than 0.9.\n"
+    err << "Please remove your old versions.\n"
+    err << "An easy way to do this is by running `gem cleanup carat`."
+    abort(err)
+  end
+end
+
+require 'carat/friendly_errors'
+Carat.with_friendly_errors do
+  require 'carat/cli'
+  Carat::CLI.start(ARGV, :debug => true)
+end

data/bin/carat_ruby

@@ -0,0 +1,56 @@
+#!/usr/bin/env ruby
+
+Signal.trap("INT") { exit 1 }
+
+require 'carat/ruby_version'
+require 'carat/ruby_dsl'
+require 'carat/shared_helpers'
+
+module Carat
+  class GemfileError < RuntimeError; end
+  class Dsl
+    include RubyDsl
+
+    attr_accessor :ruby_version
+
+    def initialize
+      @ruby_version = nil
+    end
+
+    def eval_gemfile(gemfile, contents = nil)
+      contents ||= File.open(gemfile, "rb") { |f| f.read }
+      instance_eval(contents, gemfile.to_s, 1)
+    rescue SyntaxError => e
+      bt = e.message.split("\n")[1..-1]
+      raise GemfileError, ["Gemfile syntax error:", *bt].join("\n")
+    rescue ScriptError, RegexpError, NameError, ArgumentError => e
+      e.backtrace[0] = "#{e.backtrace[0]}: #{e.message} (#{e.class})"
+      STDERR.puts e.backtrace.join("\n       ")
+      raise GemfileError, "There was an error in your Gemfile," \
+        " and Carat cannot continue."
+    end
+
+    def source(source, options = {})
+    end
+
+    def gem(name, *args)
+    end
+
+    def group(*args, &blk)
+    end
+  end
+end
+
+dsl = Carat::Dsl.new
+begin
+  dsl.eval_gemfile(Carat::SharedHelpers.default_gemfile)
+  ruby_version = dsl.ruby_version
+  if ruby_version
+    puts ruby_version
+  else
+    puts "No ruby version specified"
+  end
+rescue Carat::GemfileError => e
+  puts e.message
+  exit(-1)
+end

data/carat.gemspec

@@ -0,0 +1,32 @@
+# coding: utf-8
+lib = File.expand_path('../lib/', __FILE__)
+$:.unshift lib unless $:.include?(lib)
+require 'carat/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'carat'
+  s.version     = Carat::VERSION
+  s.licenses    = ['MIT']
+  s.authors     = ["Justin Searls", "Aaron Patterson", "Eileen Uchitelle", "Sam Phippen", "André Arko", "Terence Lee", "Carl Lerche", "Yehuda Katz"]
+  s.email       = ["searls@gmail.com"]
+  s.homepage    = "https://github.com/caratrb/carat"
+  s.summary     = %q{One way to manage your application's dependencies}
+  s.description = %q{Carat manages an application's dependencies through its entire life, across many machines, systematically and repeatably}
+
+  s.required_ruby_version     = '>= 2.2.2'
+  s.required_rubygems_version = '>= 1.3.6'
+
+  s.add_development_dependency 'mustache',  '0.99.6'
+  s.add_development_dependency 'rdiscount', '~> 1.6'
+  s.add_development_dependency 'ronn',      '~> 0.7.3'
+  s.add_development_dependency 'rspec',     '~> 3.0'
+  s.add_development_dependency 'rake'
+
+  s.files       = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  # we don't check in man pages, but we need to ship them because
+  # we use them to generate the long-form help for each command.
+  s.files      += Dir.glob('lib/carat/man/**/*')
+
+  s.executables   = %w(carat)
+  s.require_paths = ["lib"]
+end

data/lib/carat.rb

@@ -0,0 +1,446 @@
+require 'fileutils'
+require 'pathname'
+require 'rbconfig'
+require 'carat/gem_path_manipulation'
+require 'carat/rubygems_ext'
+require 'carat/rubygems_integration'
+require 'carat/version'
+require 'carat/constants'
+require 'carat/current_ruby'
+
+module Carat
+  preserve_gem_path
+  ORIGINAL_ENV = ENV.to_hash
+
+  autoload :AnonymizableURI,       'carat/anonymizable_uri'
+  autoload :Definition,            'carat/definition'
+  autoload :Dependency,            'carat/dependency'
+  autoload :DepProxy,              'carat/dep_proxy'
+  autoload :Deprecate,             'carat/deprecate'
+  autoload :Dsl,                   'carat/dsl'
+  autoload :EndpointSpecification, 'carat/endpoint_specification'
+  autoload :Environment,           'carat/environment'
+  autoload :Env,                   'carat/env'
+  autoload :Fetcher,               'carat/fetcher'
+  autoload :GemHelper,             'carat/gem_helper'
+  autoload :GemHelpers,            'carat/gem_helpers'
+  autoload :GemInstaller,          'carat/gem_installer'
+  autoload :Graph,                 'carat/graph'
+  autoload :Index,                 'carat/index'
+  autoload :Installer,             'carat/installer'
+  autoload :Injector,              'carat/injector'
+  autoload :LazySpecification,     'carat/lazy_specification'
+  autoload :LockfileParser,        'carat/lockfile_parser'
+  autoload :MatchPlatform,         'carat/match_platform'
+  autoload :RemoteSpecification,   'carat/remote_specification'
+  autoload :Resolver,              'carat/resolver'
+  autoload :Retry,                 'carat/retry'
+  autoload :RubyVersion,           'carat/ruby_version'
+  autoload :RubyDsl,               'carat/ruby_dsl'
+  autoload :Runtime,               'carat/runtime'
+  autoload :Settings,              'carat/settings'
+  autoload :SharedHelpers,         'carat/shared_helpers'
+  autoload :SpecSet,               'carat/spec_set'
+  autoload :Source,                'carat/source'
+  autoload :SourceList,            'carat/source_list'
+  autoload :Specification,         'carat/shared_helpers'
+  autoload :SystemRubyVersion,     'carat/ruby_version'
+  autoload :UI,                    'carat/ui'
+
+  class CaratError < StandardError
+    def self.status_code(code)
+      define_method(:status_code) { code }
+    end
+  end
+
+  class GemfileNotFound       < CaratError; status_code(10) ; end
+  class GemNotFound           < CaratError; status_code(7)  ; end
+  class GemfileError          < CaratError; status_code(4)  ; end
+  class InstallError          < CaratError; status_code(5)  ; end
+  class InstallHookError      < CaratError; status_code(8)  ; end
+  class PathError             < CaratError; status_code(13) ; end
+  class GitError              < CaratError; status_code(11) ; end
+  class DeprecatedError       < CaratError; status_code(12) ; end
+  class GemspecError          < CaratError; status_code(14) ; end
+  class InvalidOption         < CaratError; status_code(15) ; end
+  class ProductionError       < CaratError; status_code(16) ; end
+  class HTTPError             < CaratError; status_code(17) ; end
+  class RubyVersionMismatch   < CaratError; status_code(18) ; end
+  class SecurityError         < CaratError; status_code(19) ; end
+  class LockfileError         < CaratError; status_code(20) ; end
+  class CyclicDependencyError < CaratError; status_code(21) ; end
+  class GemfileLockNotFound   < CaratError; status_code(22) ; end
+
+  # Internal errors, should be rescued
+  class VersionConflict  < CaratError
+    attr_reader :conflicts
+
+    def initialize(conflicts, msg = nil)
+      super(msg)
+      @conflicts = conflicts
+    end
+
+    status_code(6)
+  end
+
+  class MarshalError < StandardError; end
+
+  class << self
+    attr_writer :ui, :bundle_path
+
+    def configure
+      @configured ||= configure_gem_home_and_path
+    end
+
+    def ui
+      @ui ||= UI::Silent.new
+    end
+
+    # Returns absolute path of where gems are installed on the filesystem.
+    def bundle_path
+      @bundle_path ||= Pathname.new(settings.path).expand_path(root)
+    end
+
+    # Returns absolute location of where binstubs are installed to.
+    def bin_path
+      @bin_path ||= begin
+        path = settings[:bin] || "bin"
+        path = Pathname.new(path).expand_path(root).expand_path
+        FileUtils.mkdir_p(path)
+        path
+      end
+    end
+
+    def setup(*groups)
+      # Just return if all groups are already loaded
+      return @setup if defined?(@setup)
+
+      definition.validate_ruby!
+
+      if groups.empty?
+        # Load all groups, but only once
+        @setup = load.setup
+      else
+        @completed_groups ||= []
+        # Figure out which groups haven't been loaded yet
+        unloaded = groups - @completed_groups
+        # Record groups that are now loaded
+        @completed_groups = groups
+        unloaded.any? ? load.setup(*groups) : load
+      end
+    end
+
+    def require(*groups)
+      setup(*groups).require(*groups)
+    end
+
+    def load
+      @load ||= Runtime.new(root, definition)
+    end
+
+    def environment
+      Carat::Environment.new(root, definition)
+    end
+
+    # Returns an instance of Carat::Definition for given Gemfile and lockfile
+    #
+    # @param unlock [Hash, Boolean, nil] Gems that have been requested
+    #   to be updated or true if all gems should be updated
+    # @return [Carat::Definition]
+    def definition(unlock = nil)
+      @definition = nil if unlock
+      @definition ||= begin
+        configure
+        upgrade_lockfile
+        Definition.build(default_gemfile, default_lockfile, unlock)
+      end
+    end
+
+    def locked_gems
+      return @locked_gems if defined?(@locked_gems)
+      if Carat.default_lockfile.exist?
+        lock = Carat.read_file(Carat.default_lockfile)
+        @locked_gems = LockfileParser.new(lock)
+      else
+        @locked_gems = nil
+      end
+    end
+
+    def ruby_scope
+      "#{Carat.rubygems.ruby_engine}/#{Carat.rubygems.config_map[:ruby_version]}"
+    end
+
+    def user_bundle_path
+      Pathname.new(Carat.rubygems.user_home).join(".carat")
+    end
+
+    def home
+      bundle_path.join("carat")
+    end
+
+    def install_path
+      home.join("gems")
+    end
+
+    def specs_path
+      bundle_path.join("specifications")
+    end
+
+    def cache
+      bundle_path.join("cache/carat")
+    end
+
+    def root
+      @root ||= begin
+                  default_gemfile.dirname.expand_path
+                rescue GemfileNotFound
+                  bundle_dir = default_bundle_dir
+                  raise GemfileNotFound, "Could not locate Gemfile or .carat/ directory" unless bundle_dir
+                  Pathname.new(File.expand_path("..", bundle_dir))
+                end
+    end
+
+    def app_config_path
+      ENV['BUNDLE_APP_CONFIG'] ?
+        Pathname.new(ENV['BUNDLE_APP_CONFIG']).expand_path(root) :
+        root.join('.carat')
+    end
+
+    def app_cache(custom_path = nil)
+      path = custom_path || root
+      path.join(self.settings.app_cache_path)
+    end
+
+    def tmp(name = Process.pid.to_s)
+      Pathname.new(Dir.mktmpdir(["carat", name]))
+    end
+
+    def rm_rf(path)
+      FileUtils.remove_entry_secure(path) if path && File.exist?(path)
+    end
+
+    def settings
+      return @settings if defined?(@settings)
+      @settings = Settings.new(app_config_path)
+    rescue GemfileNotFound
+      @settings = Settings.new(Pathname.new(".carat").expand_path)
+    end
+
+    def with_original_env
+      bundled_env = ENV.to_hash
+      ENV.replace(ORIGINAL_ENV)
+      yield
+    ensure
+      ENV.replace(bundled_env.to_hash)
+    end
+
+    def with_clean_env
+      with_original_env do
+        ENV['MANPATH'] = ENV['BUNDLE_ORIG_MANPATH']
+        ENV.delete_if { |k,_| k[0,7] == 'BUNDLE_' }
+        if ENV.has_key? 'RUBYOPT'
+          ENV['RUBYOPT'] = ENV['RUBYOPT'].sub '-rcarat/setup', ''
+          ENV['RUBYOPT'] = ENV['RUBYOPT'].sub "-I#{File.expand_path('..', __FILE__)}", ''
+        end
+        yield
+      end
+    end
+
+    def clean_system(*args)
+      with_clean_env { Kernel.system(*args) }
+    end
+
+    def clean_exec(*args)
+      with_clean_env { Kernel.exec(*args) }
+    end
+
+    def default_gemfile
+      SharedHelpers.default_gemfile
+    end
+
+    def default_lockfile
+      SharedHelpers.default_lockfile
+    end
+
+    def default_bundle_dir
+      SharedHelpers.default_bundle_dir
+    end
+
+    def system_bindir
+      # Gem.bindir doesn't always return the location that Rubygems will install
+      # system binaries. If you put '-n foo' in your .gemrc, Rubygems will
+      # install binstubs there instead. Unfortunately, Rubygems doesn't expose
+      # that directory at all, so rather than parse .gemrc ourselves, we allow
+      # the directory to be set as well, via `carat config bindir foo`.
+      Carat.settings[:system_bindir] || Carat.rubygems.gem_bindir
+    end
+
+    def requires_sudo?
+      return @requires_sudo if defined?(@requires_sudo_ran)
+
+      if settings.allow_sudo?
+        sudo_present = which "sudo"
+      end
+
+      if sudo_present
+        # the bundle path and subdirectories need to be writable for Rubygems
+        # to be able to unpack and install gems without exploding
+        path = bundle_path
+        path = path.parent until path.exist?
+
+        # bins are written to a different location on OS X
+        bin_dir = Pathname.new(Carat.system_bindir)
+        bin_dir = bin_dir.parent until bin_dir.exist?
+
+        # if any directory is not writable, we need sudo
+        files = [path, bin_dir] | Dir[path.join('build_info/*').to_s] | Dir[path.join('*').to_s]
+        sudo_needed = files.any?{|f| !File.writable?(f) }
+      end
+
+      @requires_sudo_ran = true
+      @requires_sudo = settings.allow_sudo? && sudo_present && sudo_needed
+    end
+
+    def mkdir_p(path)
+      if requires_sudo?
+        sudo "mkdir -p '#{path}'" unless File.exist?(path)
+      else
+        FileUtils.mkdir_p(path)
+      end
+    end
+
+    def which(executable)
+      if File.file?(executable) && File.executable?(executable)
+        executable
+      elsif ENV['PATH']
+        path = ENV['PATH'].split(File::PATH_SEPARATOR).find do |p|
+          abs_path = File.join(p, executable)
+          File.file?(abs_path) && File.executable?(abs_path)
+        end
+        path && File.expand_path(executable, path)
+      end
+    end
+
+    def sudo(str)
+      prompt = "\n\n" + <<-PROMPT.gsub(/^ {6}/, '').strip + " "
+      Your user account isn't allowed to install to the system Rubygems.
+      You can cancel this installation and run:
+
+          carat install --path vendor/bundle
+
+      to install the gems into ./vendor/bundle/, or you can enter your password
+      and install the bundled gems to Rubygems using sudo.
+
+      Password:
+      PROMPT
+
+      `sudo -p "#{prompt}" #{str}`
+    end
+
+    def read_file(file)
+      File.open(file, "rb") { |f| f.read }
+    end
+
+    def load_marshal(data)
+      Marshal.load(data)
+    rescue => e
+      raise MarshalError, "#{e.class}: #{e.message}"
+    end
+
+    def load_gemspec(file)
+      @gemspec_cache ||= {}
+      key = File.expand_path(file)
+      spec = ( @gemspec_cache[key] ||= load_gemspec_uncached(file) )
+      # Protect against caching side-effected gemspecs by returning a
+      # new instance each time.
+      spec.dup if spec
+    end
+
+    def load_gemspec_uncached(file)
+      path = Pathname.new(file)
+      # Eval the gemspec from its parent directory, because some gemspecs
+      # depend on "./" relative paths.
+      SharedHelpers.chdir(path.dirname.to_s) do
+        contents = path.read
+        if contents[0..2] == "---" # YAML header
+          eval_yaml_gemspec(path, contents)
+        else
+          eval_gemspec(path, contents)
+        end
+      end
+    end
+
+    def clear_gemspec_cache
+      @gemspec_cache = {}
+    end
+
+    def git_present?
+      return @git_present if defined?(@git_present)
+      @git_present = Carat.which("git") || Carat.which("git.exe")
+    end
+
+    def ruby_version
+      @ruby_version ||= SystemRubyVersion.new
+    end
+
+    def reset!
+      @definition = nil
+    end
+
+  private
+
+    def eval_yaml_gemspec(path, contents)
+      # If the YAML is invalid, Syck raises an ArgumentError, and Psych
+      # raises a Psych::SyntaxError. See psyched_yaml.rb for more info.
+      Gem::Specification.from_yaml(contents)
+    rescue YamlSyntaxError, ArgumentError, Gem::EndOfYAMLException, Gem::Exception
+      eval_gemspec(path, contents)
+    end
+
+    def eval_gemspec(path, contents)
+      eval(contents, TOPLEVEL_BINDING, path.expand_path.to_s)
+    rescue ScriptError, StandardError => e
+      original_line = e.backtrace.find { |line| line.include?(path.to_s) }
+      msg  = "There was a #{e.class} while loading #{path.basename}: \n#{e.message}"
+      msg << " from\n  #{original_line}" if original_line
+      msg << "\n"
+
+      if e.is_a?(LoadError) && RUBY_VERSION >= "1.9"
+        msg << "\nDoes it try to require a relative path? That's been removed in Ruby 1.9."
+      end
+
+      raise GemspecError, msg
+    end
+
+    def configure_gem_home_and_path
+      blank_home = ENV['GEM_HOME'].nil? || ENV['GEM_HOME'].empty?
+      if settings[:disable_shared_gems]
+        ENV['GEM_PATH'] = ''
+      elsif blank_home || Carat.rubygems.gem_dir != bundle_path.to_s
+        possibles = [Carat.rubygems.gem_dir, Carat.rubygems.gem_path]
+        paths = possibles.flatten.compact.uniq.reject { |p| p.empty? }
+        ENV["GEM_PATH"] = paths.join(File::PATH_SEPARATOR)
+      end
+
+      configure_gem_home
+      bundle_path
+    end
+
+    def configure_gem_home
+      # TODO: This mkdir_p is only needed for JRuby <= 1.5 and should go away (GH #602)
+      FileUtils.mkdir_p bundle_path.to_s rescue nil
+
+      ENV['GEM_HOME'] = File.expand_path(bundle_path, root)
+      Carat.rubygems.clear_paths
+    end
+
+    def upgrade_lockfile
+      lockfile = default_lockfile
+      if lockfile.exist? && lockfile.read(3) == "---"
+        Carat.ui.warn "Detected Gemfile.lock generated by 0.9, deleting..."
+        lockfile.rmtree
+      end
+    end
+
+  end
+end