bootscale 0.3.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 80513d863b2fdb043fcb25e6fb2ddec6a1ecc1df
-  data.tar.gz: 67ab4ccbbe25e51f3baee0767b24d53a40f143b2
+  metadata.gz: f1bf0e9189a33d19e8121e188f245bc738d7d2fe
+  data.tar.gz: 214e8efc673b76c1eb4fdce6a076f72ec8952d86
 SHA512:
-  metadata.gz: c4ffc0949fbea19273eca3619cda2893aeae8c4acc625e72bc38bfa77b918ba8df335c8bc88a0fdca60a5826a233f36c47e027e0c0e153a25e94e4f9950b844e
-  data.tar.gz: 7c0754c91c6ff987ff1ef3700b3d2f20204bdbdb8443d44b095ec7ab677a96d174c93a77d629f459e34ffa6c941454763cb3ea450843ca4a11d6f5b1a1672e89
+  metadata.gz: 07d8b865970b3bc77bb10474554dd77c0413fdd6ff2c3b386dfef0809793b9739009d13182fba426c6ac559761865ec8dad68b8d2d10ac876261f4d45933e647
+  data.tar.gz: 6702914fcce11e5344ea9ea1af2bbeee95442f4e836ed57251e78cba7e12a57f86e5caf2ee4a2581281b43b6c2fe20744b2b4a48808ebee6d5441af1c770b10e

data/README.md

@@ -1,9 +1,9 @@
 # Bootscale
 
-Speedup applications boot by caching require calls.
+Speedup applications boot by caching file locations during require calls.
 
 Speed gain depends on your number of gems. Under 100 gems you likely won't see the difference,
-but for bigger applications it can save 1 to 2 seconds of boot time per 100 gems in the Gemfile.
+but for bigger applications it can save 1 to 3 seconds of boot time per 100 used gems.
 
 ## Installation
 
@@ -23,7 +23,7 @@ If your application is a Rails application, you will find this in `config/boot.r
 
 ### Important
 
-Cache should be update everytime `$LOAD_PATH` is modified by calling `Bootscale.regenerate`.
+Cache should be updated everytime `$LOAD_PATH` is modified by calling `Bootscale.regenerate`.
 
 For Rails apps it means adding an initializer in `config/application.rb`:
 
@@ -39,7 +39,14 @@ end
 
 ## Faster cache loading
 
-Add the `msgpack` gem and `require 'msgpack'` to gain ~10-30ms of extra load speed by using msgpack. 
+Add the `msgpack` gem and `require 'msgpack'` to gain ~10-30ms of extra load speed by using msgpack.
+
+## Under the hood
+
+Bootscale caches the absolute location of all requirable files on the $LOAD_PATH and
+patches `require` + `autoload` to use these absolute paths, thereby avoiding having to check all load paths for every require.
+
+Problem outlined in this [talk](https://www.youtube.com/watch?v=kwkbrOwLsZY)
 
 ## Contributing
 

data/lib/bootscale/cache_builder.rb

@@ -1,17 +1,22 @@
 module Bootscale
   class CacheBuilder
-    attr_reader :entries
-
     def initialize
       @entries = {}
     end
 
+    # generate the requireables cache from all current load-path entries
+    # each load-path is cached individually, so new ones can be added or removed
+    # but added/removed files will not be discovered
     def generate(load_path)
-      ordered_entries = load_path.map do |path|
+      requireables = load_path.reverse_each.flat_map do |path|
         path = path.to_s
-        entries[path] ||= Entry.new(path)
+        entries[path] ||= Entry.new(path).requireables
       end
-      Hash[ordered_entries.reverse.flat_map(&:features)]
+      Hash[requireables]
     end
+
+    private
+
+    attr_reader :entries
   end
 end

data/lib/bootscale/core_ext.rb

@@ -1,26 +1,20 @@
 module Kernel
-  def require_with_cache(path)
+  alias_method :require_without_cache, :require
+  def require(path)
     require_without_cache(Bootscale[path] || path)
   end
-
-  alias_method :require_without_cache, :require
-  alias_method :require, :require_with_cache
 end
 
 class << Kernel
-  def require_with_cache(path)
+  alias_method :require_without_cache, :require
+  def require(path)
     require_without_cache(Bootscale[path] || path)
   end
-
-  alias_method :require_without_cache, :require
-  alias_method :require, :require_with_cache
 end
 
 class Module
-  def autoload_with_cache(const, path)
+  alias_method :autoload_without_cache, :autoload
+  def autoload(const, path)
     autoload_without_cache(const, Bootscale[path] || path)
   end
-
-  alias_method :autoload_without_cache, :autoload
-  alias_method :autoload, :autoload_with_cache
 end

data/lib/bootscale/entry.rb

@@ -4,29 +4,30 @@ module Bootscale
       RbConfig::CONFIG['DLEXT'],
       RbConfig::CONFIG['DLEXT2'],
     ].reject { |ext| !ext || ext.empty? }.map { |ext| ".#{ext}"}
-    FEATURE_FILES = "**/*{#{DOT_RB},#{DL_EXTENSIONS.join(',')}}"
+    REQUIREABLE_FILES = "**/*{#{DOT_RB},#{DL_EXTENSIONS.join(',')}}"
     NORMALIZE_NATIVE_EXTENSIONS = !DL_EXTENSIONS.include?(DOT_SO)
     ALTERNATIVE_NATIVE_EXTENSIONS_PATTERN = /\.(o|bundle|dylib)\z/
-
-    attr_reader :path, :features
+    SLASH = '/'.freeze
 
     def initialize(path)
       @path = path
-      @path_prefix = path.end_with?('/'.freeze) ? path : "#{path}/"
-      @features = list_features
     end
 
-    private
+    def requireables
+      unless absolute = @path.start_with?(SLASH)
+        warn "Bootscale: Cannot speedup load for relative path #{@path}"
+      end
 
-    def list_features
-      Dir[File.join(path, FEATURE_FILES)].map do |absolute_path|
-        relative_path = absolute_path.sub(@path_prefix, ''.freeze)
+      path_prefix = (@path.end_with?(SLASH) ? @path.size : @path.size + 1)
+      relative_part = path_prefix..-1
+      Dir[File.join(@path, REQUIREABLE_FILES)].map do |absolute_path|
+        relative_path = absolute_path.slice(relative_part)
 
         if NORMALIZE_NATIVE_EXTENSIONS
           relative_path.sub!(ALTERNATIVE_NATIVE_EXTENSIONS_PATTERN, DOT_SO)
         end
 
-        [relative_path, absolute_path]
+        [relative_path, (absolute ? absolute_path : :relative)]
       end
     end
   end

data/lib/bootscale/file_storage.rb

@@ -13,11 +13,12 @@ module Bootscale
 
     def dump(load_path, cache)
       path = cache_path(load_path)
-      return if File.exist?(path)
       FileUtils.mkdir_p(File.dirname(path))
       File.write(path, Serializer.dump(cache), mode: 'wb+')
     end
 
+    private
+
     if defined?(MessagePack)
       Serializer = MessagePack
 

data/lib/bootscale/version.rb

@@ -1,3 +1,3 @@
 module Bootscale
-  VERSION = '0.3.1'
+  VERSION = '0.4.0'
 end

data/lib/bootscale.rb

@@ -9,11 +9,12 @@ module Bootscale
     def [](path)
       path = path.to_s
       return if path.start_with?(LEADING_SLASH)
-      if path.end_with?(DOT_RB) || path.end_with?(DOT_SO)
-        cache[path]
+      result = if path.end_with?(DOT_RB, DOT_SO)
+        @cache[path]
       else
-        cache["#{path}#{DOT_RB}"] || cache["#{path}#{DOT_SO}"]
+        @cache["#{path}#{DOT_RB}"] || @cache["#{path}#{DOT_SO}"]
       end
+      result unless result == :relative
     end
 
     def setup(options = {})
@@ -26,9 +27,7 @@ module Bootscale
       @cache = load_cache || save_cache(cache_builder.generate($LOAD_PATH))
     end
 
-    def cache
-      @cache ||= {}
-    end
+    private
 
     def cache_builder
       @cache_builder ||= CacheBuilder.new

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bootscale
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Jean Boussier
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-08-24 00:00:00.000000000 Z
+date: 2015-08-27 00:00:00.000000000 Z
 dependencies: []
 description: Inspired by Aaron Patterson's talk on the subject
 email: