gel 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4b6c69f6e2a7fa19983fee2c4dcf3cc803b34126b98e8fb57df4f7da155736a7
-  data.tar.gz: 57441eef503b6a6e7b0d3a901ab91306ada2957336aa5734328bd56fdb0da065
+  metadata.gz: 7ac61e9a6e0ebdc00fe6c63fe59040cb50f66cfd375f4f4041a1f535f1c8e492
+  data.tar.gz: 28812a81b32b67c6d23370974de0963229caef262585ecd91f81d4045a1e407e
 SHA512:
-  metadata.gz: eca5ccd35a08b25914a57c2dd691bd3adf483b2f6433c751e8e9db44f4e0dcf4fa3bc3206876c447da247cf769190966dd11da46a074af4f7887b2dcfbfe8626
-  data.tar.gz: 5aee75b8749c9d7136b50e38b1a9f9c0624e73e20c154628330e0f07691e5f76f2f05d67fe6ab96effeb02793ea3cbabd0b885a56452e5c1754a8714aa082ee3
+  metadata.gz: 55fc3ff597234684ef052023204ac18a7fafe8289b88a8dfc896f66f06081bd72d4560092f88c3f74e5054d0030a80732ca30cf2ec7f560806cb260730b2a6ac
+  data.tar.gz: 2631449a64f1b976833b17a632acd28a1f44b3c0821f6e96163ddb53767b0c96a7ccfa02bd49d3b2381ec0738a8aad2c25cb1261f714701f1ae75f8bc645ec74

data/README.md

@@ -4,13 +4,79 @@
 
 A modern gem manager.
 
+Gel is a lightweight alternative to Bundler. 
+
+
+|         |         Gel        | Bundler & Rubygems |
+|---------|--------------------|--------------------|
+| install | :white_check_mark: | :white_check_mark: |
+| update  | :white_check_mark: | :white_check_mark: |
+| lock    | :white_check_mark: | :white_check_mark: |
+| exec    | :white_check_mark: | :white_check_mark: |
+| gem authoring | :x: | :white_check_mark: |
+| vendoring     | :x: | :white_check_mark: |
+| anything else | :x: | :white_check_mark: |
+
+This gem is still a work in progress, and things that are still needing some additional improvements include Documentation, UI & Error Messages, and Platform compatibility. We are open to and appreciate any help improving any of these areas.
+
+## Why Should I Use Gel?
+
+Gel was written with the goal of improving the performance of common Bundler tasks. Eventually we would like to backport known performance improvements back into Bundler so that everyone can benefit from these improvements, but it is easier to implement and test potential performance improvements in a smaller, more lightweight codebase beforehand.
+
+Another way that Gel gains a performance benefit over Bundler is simply that Gel includes less features overall. For anyone that doesn't need _all_ the features provided by Bundler, using Gel as a more lightweight gem manager might be beneficial.
+
+One of the improvements that Gel has over Bundler is being able to take advantage of a new version solver called [Pub Grub](https://medium.com/@nex3/pubgrub-2fb6470504f). Gel utilizes the `pub_grub` gem (https://github.com/jhawthorn/pub_grub) which is a Ruby port of the PubGrub algorithm.
+
+Some real world examples of the types of performance improvements Gel provides over Bundler are as follows:
+
+* `% gel exec rake -version`: 55% faster than `bundle`
+* `% gel exec rails --version`: 60% faster than `bundle`
+* `% gel exec rails runner nil`: 45% faster than `bundle`
+
+Comparing using a complex, mature Rails application:
+
+* `% gel install`: 55% faster than `bundle`
+* `% gel lock`: 78% faster than `bundle` on first run
+* `% gel lock`: 95% faster than `bundle` on later runs (cache exists)
+
+
+Comparing using a simple Gemfile with a complex gem:
+
+```
+source "https://rubygems.org"
+
+gem "tty"
+```
+
+* `% gel install`: 70% faster than `bundle`
+* `% gel lock`: 34% faster than `bundle`
+
+Comparing using an example Gemfile with gems that showcase a difficult version resolving:
+
+```
+source "https://rubygems.org"
+
+gem "activerecord"
+gem "quiet_assets"
+```
+
+* `% gel lock`: 96% faster than `bundle`
+
+This example showcases the speed improvements provided by the new PubGrub Version Solving algorithm.
+
+Note that all of the performance numbers were gathered using just a regular laptop used for common day-to-day development. These numbers were not measured in perfect isolation and your experience may vary.
+
 ## Installation
 
-Install the gem:
+If you're on a Mac, we recommend that you install via Homebrew:
+
+    $ brew install gel
+
+Otherwise, you can install Gel as a gem:
 
     $ gem install gel
 
-Then, either activate gel in your current shell:
+Then, either activate Gel in your current shell:
 
     $ eval "$(gel shell-setup)"
 
@@ -20,7 +86,7 @@ Or add it to your `.bashrc` or `.zshrc` to enable it everywhere:
 
 ## Usage
 
-Use `gel install`, `gel lock`, and `gel exec` as you would the equivalent `bundle` subcommands.
+Use `gel install`, `gel lock`, `gel update`, and `gel exec` as you would the equivalent `bundle` subcommands.
 
 ## Development
 

data/lib/gel.rb

@@ -20,3 +20,4 @@ require_relative "gel/gemspec_parser"
 require_relative "gel/gemfile_parser"
 require_relative "gel/lock_parser"
 require_relative "gel/lock_loader"
+require_relative "gel/version"

data/lib/gel/catalog.rb

@@ -144,7 +144,7 @@ class Gel::Catalog
       end
     end
 
-    raise "Too many redirects for #{original_uri}"
+    raise Gel::Error::TooManyRedirectsError.new(original_uri: original_uri)
   end
 end
 

data/lib/gel/command.rb

@@ -16,7 +16,7 @@ class Gel::Command
         command = Gel::Command::Exec.new
         command.run([command_name, *command_line])
       else
-        raise "Unknown command #{command_name.inspect}"
+        raise Gel::Error::UnknownCommandError.new(command_name: command_name)
       end
     else
       puts <<~EOF

data/lib/gel/compatibility/rubygems.rb

@@ -135,6 +135,15 @@ module Gem
       exec RbConfig.ruby, "--", $0, *ARGV
     end
 
+    if gem_name == "gel" && bin_name == "gel"
+      # Another extra-special case: gel is already activated, but it's
+      # being invoked via a rubygems-installed binstub. We can't
+      # activate gel inside gel, but we also don't need to: we know
+      # exactly which file they need.
+
+      return File.expand_path("../../../exe/gel", __dir__)
+    end
+
     if g = Gel::Environment.activated_gems[gem_name]
       Gel::Environment.gem g.name, version if version
     elsif g = Gel::Environment.find_gem(gem_name, *version) do |g|

data/lib/gel/config.rb

@@ -46,7 +46,7 @@ class Gel::Config
         elsif line =~ /\A\s*(?:#|\z)/
           # comment / empty
         else
-          raise "Unexpected config line #{line.inspect}"
+          raise Gel::Error::UnexpectedConfigError.new(line: line)
         end
       end
     end

data/lib/gel/environment.rb

@@ -72,7 +72,7 @@ class Gel::Environment
 
   def self.find_gemfile(path = nil, error: true)
     if path && @gemfile && @gemfile.filename != File.expand_path(path)
-      raise "Cannot activate #{path.inspect}; already activated #{@gemfile.filename.inspect}"
+      raise Gel::Error::CannotActivateError.new(path: path, gemfile: @gemfile.filename)
     end
     return @gemfile.filename if @gemfile
 
@@ -83,7 +83,7 @@ class Gel::Environment
     if File.exist?(path)
       path
     elsif error
-      raise "No Gemfile found in #{path.inspect}"
+      raise Gel::Error::NoGemfile.new(path: path)
     end
   end
 
@@ -391,9 +391,12 @@ class Gel::Environment
     end
 
     if found_any
-      raise "no version of gem #{gem_name.inspect} satifies #{requirements.inspect}"
+      raise Gel::Error::NoVersionSatisfyError.new(
+        gem_name: gem_name,
+        requirements: requirements,
+      )
     else
-      raise "unknown gem #{gem_name.inspect}"
+      raise Gel::Error::UnknownGemError.new(gem_name: gem_name)
     end
   end
 

data/lib/gel/error.rb

@@ -101,4 +101,110 @@ module Gel::Error
       "No available gem supplies a #{self[:name].inspect} executable"
     end
   end
+
+  class TooManyRedirectsError < Gel::UserError
+    def initialize(original_uri:)
+      super
+    end
+
+    def message
+      "Too many redirects for #{self[:original_uri].inspect}"
+    end
+  end
+
+  class UnknownCommandError < Gel::UserError
+    def initialize(command_name:)
+      super
+    end
+
+    def message
+      "Unknown command #{self[:command_name].inspect}"
+    end
+  end
+
+  class UnexpectedConfigError < Gel::UserError
+    def initialize(line:)
+      super
+    end
+
+    def message
+      "Unexpected config line #{self[:line].inspect}"
+    end
+  end
+
+  class CannotActivateError < Gel::UserError
+    def initialize(path:, gemfile:)
+      super
+    end
+
+    def message
+      "Cannot activate #{self[:path].inspect}; already activated #{self[:gemfile].inspect}"
+    end
+  end
+
+  class ExtensionBuildError < Gel::UserError
+    def initialize(program_name:, exitstatus:)
+      super
+    end
+
+    def message
+      "#{self[:program_name].inspect} exited with #{self[:exitstatus].inspect}"
+    end
+  end
+
+  class NoGemfile < Gel::UserError
+    def initialize(path:)
+      super
+    end
+
+    def message
+      "No Gemfile found in #{self[:path].inspect}"
+    end
+  end
+
+  class NoVersionSatisfy < Gel::UserError
+    def initialize(gem_name:, requirements:)
+      super
+    end
+
+    def message
+      "no version of gem #{self[:gem_name].inspect} satifies #{self[:requirements].inspect}"
+    end
+  end
+
+  class UnknownGemError < Gel::UserError
+    def initialize(gem_name:)
+      super
+    end
+
+    def message
+      "Unknown gem #{self[:gem_name].inspect}"
+    end
+  end
+
+  class MismatchRubyVersionError < Gel::UserError
+    def initialize(running:, requested:)
+      super
+    end
+
+    def message
+      "Running ruby version #{self[:running].inspect} does not match requested #{self[:requested].inspect}"
+    end
+  end
+
+  class MismatchRubyEngineError < Gel::UserError
+    def initialize(running:, engine:)
+      super
+    end
+
+    def message
+      "Running ruby engine #{self[:running].inspect} does not match requested #{self[:engine].inspect}"
+    end
+  end
+
+  class ParsedGemspecError < Gel::UserError
+    def message
+      "Gemspec parse failed"
+    end
+  end
 end

data/lib/gel/gemfile_parser.rb

@@ -40,8 +40,18 @@ module Gel::GemfileParser
 
     def ruby(version, engine: nil, engine_version: nil)
       req = Gel::Support::GemRequirement.new(version)
-      raise "Running ruby version #{RUBY_VERSION} does not match requested #{version.inspect}" unless req.satisfied_by?(Gel::Support::GemVersion.new(RUBY_VERSION))
-      raise "Running ruby engine #{RUBY_ENGINE} does not match requested #{engine.inspect}" unless !engine || RUBY_ENGINE == engine
+      unless req.satisfied_by?(Gel::Support::GemVersion.new(RUBY_VERSION))
+        raise Gel::Error::MismatchRubyVersionError.new(
+          running: RUBY_VERSION,
+          requested: version,
+        )
+      end
+      unless !engine || RUBY_ENGINE == engine
+        raise Gel::Error::MismatchRubyEngineError.new(
+          running: RUBY_ENGINE,
+          engine: engine,
+        )
+      end
       if engine_version
         raise "Cannot specify :engine_version without :engine" unless engine
         req = Gel::Support::GemRequirement.new(version)
@@ -55,12 +65,20 @@ module Gel::GemfileParser
       @result.add_gem(name, requirements, options)
     end
 
-    def gemspec
-      if file = Dir["#{File.dirname(@result.filename)}/*.gemspec"].first
-        spec = Gel::GemspecParser.parse(File.read(file), file)
-        gem spec.name, path: "."
+    def gemspec(name: nil, path: ".", development_group: :development)
+      dirname = File.expand_path(path, File.dirname(@result.filename))
+      gemspecs = Dir[File.join(dirname, "*.gemspec")]
+      gemspecs.map! { |file| Gel::GemspecParser.parse(File.read(file), file) }
+      gemspecs.select! { |s| s.name == name } if name
+      if gemspecs.empty?
+        raise "No gemspecs at #{dirname}"
+      elsif gemspecs.count > 1
+        raise "Multiple gemspecs at #{dirname}"
+      else
+        spec = gemspecs[0]
+        gem spec.name, path: path
         spec.development_dependencies.each do |name, constraints|
-          gem name, constraints, group: :development
+          gem name, constraints, group: development_group
         end
       end
     end

data/lib/gel/gemspec_parser.rb

@@ -81,7 +81,7 @@ class Gel::GemspecParser
       end
 
       _, status = Process.waitpid2(pid)
-      raise "Gemspec parse failed" unless status.success?
+      raise Gel::Error::ParsedGemspecError unless status.success?
 
       write_thread.join
       Marshal.load read_thread.value

data/lib/gel/lock_loader.rb

@@ -40,6 +40,7 @@ class Gel::LockLoader
           yield sym, body, name, version, platform, deps
         end
       when "PLATFORMS", "DEPENDENCIES"
+      when "RUBY VERSION"
       when "BUNDLED WITH"
       else
         warn "Unknown lockfile section #{section.inspect}"

data/lib/gel/package/installer.rb

@@ -4,6 +4,7 @@ require "fileutils"
 require "pathname"
 require "rbconfig"
 require "tempfile"
+require "shellwords"
 
 class Gel::Package::Installer
   def initialize(store)
@@ -182,7 +183,7 @@ class Gel::Package::Installer
             File.basename(ext),
             rake: true,
           )
-          raise "mkrf_conf exited with #{status.exitstatus}" unless status.success?
+          raise Gel::Error::ExtensionBuildError.new(program_name: "mkrf_conf", exitstatus: status.exitstatus) unless status.success?
         end
 
         status = build_command(
@@ -196,6 +197,7 @@ class Gel::Package::Installer
           "rake",
           rake: true,
         )
+        raise Gel::Error::ExtensionBuildError.new(program_name: "rake", exitstatus: status.exitstatus) unless status.success?
       end
     end
 

data/lib/gel/store.rb

@@ -141,7 +141,7 @@ class Gel::Store
     end
   end
 
-  def each(gem_name = nil)
+  def each(gem_name = nil, &block)
     return enum_for(__callee__, gem_name) unless block_given?
 
     if gem_name
@@ -159,7 +159,6 @@ class Gel::Store
         gem_names << $1 if k =~ /\Av\/(.*)\z/
       end
 
-      block = Proc.new
       gem_names.each do |n|
         each(n, &block)
       end

data/lib/gel/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Gel
-  VERSION = "0.2.0"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gel
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Gel Authors
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-04-18 00:00:00.000000000 Z
+date: 2019-04-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pub_grub