autoloaded 0.0.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 33eb826f0b852296da2a599fc26e5c474e05718c
+  data.tar.gz: d1cd5c7cd96613522d93559ee959f7d6a3197a3a
+SHA512:
+  metadata.gz: 4c6050535f8b9948d416e63d8a0c9e9640eb37320b922995d6cded3e0fdba95f23494bb707bebd640f7fab079ee73ab0d3685f784a42a71731ed7eb18ff75d93
+  data.tar.gz: 0c1bbe28aa23983de38b5aff8972a6fa184b824c2e5ac801f852561f04c3f5737562c4daddea60f26b0b0ff2ef89261b0af90d9a2236c5b906b35d20c73231b7

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--format doc
+--require spec_helper

data/.ruby-gemset

@@ -0,0 +1 @@
+autoloaded

data/.ruby-version

@@ -0,0 +1 @@
+2.1.2

data/.yardopts

@@ -0,0 +1 @@
+--file License.md --no-private --protected --title "Autoloaded"

data/Gemfile

@@ -0,0 +1,20 @@
+source 'https://rubygems.org'
+
+gemspec
+
+group :debug do
+  gem   'pry-byebug',   '~> 2',                 platforms: [:mri_20, :mri_21]
+  gem   'pry-debugger', '~> 0',                 platforms: :mri_19
+end
+
+group :doc do
+  gem   'yard',         '~> 0', require: false
+  gem   'rdiscount',    '~> 2', require: false
+end
+
+group :tooling do
+  gem   'guard-rspec',  '~> 4', require: false
+  if RUBY_PLATFORM =~ /darwin/i
+    gem 'rb-fsevent',   '~> 0', require: false
+  end
+end

data/Guardfile

@@ -0,0 +1,35 @@
+interactor :off
+
+debugger_gem = %w(pry-byebug pry-debugger).detect do |gem|
+  `bundle show #{gem} 2>&1 >/dev/null`
+  $?.success?
+end
+debugger_require = debugger_gem ? " --require #{debugger_gem}" : nil
+guard :rspec, all_after_pass: true,
+              all_on_start:   true,
+              cmd: "bundle exec rspec#{debugger_require} --format progress" do
+  # Run the corresponding spec (or all specs) when code changes.
+  watch( %r{^lib/(.+)\.rb$} ) do |match|
+    Dir["spec/#{match[1]}_spec.rb"].first || 'spec'
+  end
+
+  # Run a spec when it changes.
+  watch %r{^spec/.+_spec\.rb$}
+
+  # Run all specs when a shared spec changes.
+  watch( %r{^spec/.+_sharedspec\.rb$} ) { 'spec' }
+
+  # Run all specs when a matcher changes.
+  watch( 'spec/matchers.rb' ) { 'spec' }
+
+  # Run all when a fixture changes.
+  watch( %r{^spec/fixtures} ) { 'spec' }
+
+  # Run all specs when the RSpec configuration changes.
+  watch( '.rspec'              ) { 'spec' }
+  watch( 'spec/spec_helper.rb' ) { 'spec' }
+
+  # Run all specs when the bundle changes.
+  watch( 'Gemfile.lock'      ) { 'spec' }
+  watch( %r{^(.+)\.gemspec$} ) { 'spec' }
+end

data/License.md

@@ -0,0 +1,22 @@
+# The MIT License
+
+Source code for _Autoloaded_ is Copyright © 2014
+[Nils Jonsson](mailto:autoloaded@nilsjonsson.com) and
+[contributors](https://github.com/njonsson/autoloaded/contributors "Autoloaded contributors at GitHub").
+
+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,113 @@
+# Autoloaded
+
+_Autoloaded_ dynamically and flexibly loads source files in a directory when a
+corresponding constant is dereferenced. It offers several advantages over other
+autoloading facilities such as those provided by the
+[Ruby Core library](http://ruby-doc.org/core/Module.html#method-i-autoload) and
+the
+[ActiveSupport](http://api.rubyonrails.org/classes/ActiveSupport/Autoload.html)
+gem:
+
+* It does not require a separate `autoload` statement for each constant
+* It does not enforce `CamelCase` to `snake_case` correspondence between the
+  names of constants and source files
+
+## Installation
+
+Add this line to your application’s Gemfile:
+
+```ruby
+gem 'autoloaded', '~> 0'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install autoloaded
+
+## Usage
+
+Suppose you have the following source files:
+
+* lib/
+  * my_awesome_gem/
+    * db/
+      * mysql.rb
+      * postgresql.rb
+      * sql_server.rb
+    * db.rb
+  * my_awesome_gem.rb
+
+The following statements establish autoloading — one statement per namespace:
+
+```ruby
+# lib/my_awesome_gem.rb
+module MyAwesomeGem
+
+  extend Autoloaded
+
+end
+
+# lib/my_awesome_gem/db.rb
+module MyAwesomeGem
+
+  module DB
+
+    extend Autoloaded
+
+  end
+
+end
+```
+
+Note that your preferred casing of constants is accommodated automatically:
+
+```ruby
+MyAwesomeGem::DB::MySQL.new
+MyAwesomeGem::DB::PostgreSQL.new
+MyAwesomeGem::DB::SQLServer.new
+```
+
+_Autoloaded_ does not perform deep autoloading of nested namespaces and
+directories. This is by design.
+
+### Important note
+
+You must extend a namespace with _Autoloaded_ **from within the file in which the
+namespace is defined**. This is because _Autoloaded_ utilizes the source file
+path of the namespace to establish which directory will be autoloaded. That path
+is discoverable only via the stack trace of `extend Autoloaded`.
+
+In the following example, autoloading of the _MyAwesomeGem_ namespace will not
+occur because the name of the source file in which the `extend` statement is
+invoked does not match the name of the namespace.
+
+```ruby
+# lib/my_awesome_gem.rb
+module MyAwesomeGem; end
+
+# lib/my_awesome_gem/db.rb
+module MyAwesomeGem
+
+  # WRONG! Autoloading will not occur.
+  extend Autoloaded
+
+  module DB
+
+    extend Autoloaded
+
+  end
+
+end
+```
+
+## Contributing
+
+1. [Fork the official repository](https://github.com/njonsson/autoloaded/fork).
+2. Create your feature branch: `git checkout -b my-new-feature`.
+3. Commit your changes: `git commit -am 'Add some feature'`.
+4. Push to the branch: `git push origin my-new-feature`.
+5. Create a [new pull request](https://github.com/njonsson/autoloaded/compare).

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler/gem_tasks'
+

data/autoloaded.gemspec

@@ -0,0 +1,41 @@
+# coding: utf-8
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'autoloaded/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'autoloaded'
+  spec.version       = Autoloaded::VERSION
+  spec.authors       = ['Nils Jonsson']
+  spec.email         = ['autoloaded@nilsjonsson.com']
+  spec.summary       = <<-end_summary.gsub(/^\s+/, '').gsub("\n", ' ')
+                         Dynamically and flexibly loads source files in a
+                         directory when a corresponding constant is dereferenced.
+                       end_summary
+  spec.description   = spec.summary +
+                       ' '          +
+                       <<-end_description.gsub(/^\s+/, '').gsub(/\n(?=\S)/, ' ').chomp
+                         Offers several advantages over other autoloading
+                         facilities such as those provided by the Ruby Core
+                         library and the ActiveSupport gem: (a) it does not
+                         require a separate `autoload` statement for each
+                         constant, and (b) it does not enforce CamelCase to
+                         snake_case correspondence between the names of constants
+                         and source files.
+                       end_description
+  spec.homepage      = 'https://github.com/njonsson/autoloaded'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename f }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.required_ruby_version = '~> 2.1'
+
+  spec.add_development_dependency 'bundler', '~>  1'
+  spec.add_development_dependency 'rake',    '~> 10'
+  spec.add_development_dependency 'rspec',   '~>  3'
+end

data/lib/autoloaded.rb

@@ -0,0 +1,33 @@
+module Autoloaded
+
+  def self.extended(other_module)
+    caller_file_path = caller_locations.first.absolute_path
+    dir_path = "#{::File.dirname caller_file_path}/#{::File.basename caller_file_path, '.rb'}"
+    other_module.module_eval <<-end_module_eval, __FILE__, __LINE__
+      def self.autoload?(symbol)
+        #{dir_path.inspect}
+      end
+
+      def self.const_missing(symbol)
+        require 'autoloaded/constant'
+        ::Autoloaded::Constant.new(symbol).each_matching_filename_in #{dir_path.inspect} do |filename|
+          without_ext = "\#{::File.dirname filename}/\#{::File.basename filename}"
+          require without_ext
+          if const_defined?(symbol)
+            begin
+              return const_get(symbol)
+            rescue ::NameError
+            end
+          end
+        end
+
+        super symbol
+      end
+    end_module_eval
+  end
+
+end
+
+Dir.glob "#{File.dirname __FILE__}/#{File.basename __FILE__, '.rb'}/*.rb" do |f|
+  require_relative "#{File.basename __FILE__, '.rb'}/#{File.basename f, '.rb'}"
+end

data/lib/autoloaded/constant.rb

@@ -0,0 +1,45 @@
+require 'autoloaded/refine/string/to_source_filename'
+require 'set'
+
+using ::Autoloaded::Refine::String::ToSourceFilename
+
+module Autoloaded; end
+
+class Autoloaded::Constant
+
+  attr_reader :name
+
+  def initialize(name)
+    @name = name
+  end
+
+  def each_matching_filename_in(directory)
+    filenames = ::Set.new
+
+    ::Dir.chdir directory do
+      filename = [name.to_s.to_source_filename, extension].join
+      if ::File.file?(filename) && filenames.add?(filename)
+        yield ::File.join(directory, filename)
+      end
+
+      name_signature = signature(name)
+      ::Dir.glob(['*', extension].join, ::File::FNM_CASEFOLD) do |f|
+        f_signature = signature(::File.basename(f, extension))
+        if (f_signature == name_signature) && filenames.add?(f)
+          yield ::File.join(directory, f)
+        end
+      end
+    end
+  end
+
+private
+
+  def extension
+    '.rb'
+  end
+
+  def signature(string)
+    string.to_s.gsub(/[^a-z0-9]/i, '').downcase
+  end
+
+end

data/lib/autoloaded/refine.rb

@@ -0,0 +1,9 @@
+module Autoloaded
+
+  module Refine; end
+
+end
+
+Dir.glob "#{File.dirname __FILE__}/#{File.basename __FILE__, '.rb'}/*.rb" do |f|
+  require_relative "#{File.basename __FILE__, '.rb'}/#{File.basename f, '.rb'}"
+end

data/lib/autoloaded/refine/string.rb

@@ -0,0 +1,13 @@
+module Autoloaded
+
+  module Refine
+
+    module String; end
+
+  end
+
+end
+
+Dir.glob "#{File.dirname __FILE__}/#{File.basename __FILE__, '.rb'}/*.rb" do |f|
+  require_relative "#{File.basename __FILE__, '.rb'}/#{File.basename f, '.rb'}"
+end

data/lib/autoloaded/refine/string/to_source_filename.rb

@@ -0,0 +1,44 @@
+module Autoloaded
+
+  module Refine
+
+    module String; end
+
+  end
+
+end
+
+module Autoloaded::Refine::String::ToSourceFilename
+
+  refine ::String do
+    def replace_nonalphanumeric_sequence_with_separator
+      gsub(/[^a-z0-9]+/i, separator.to_s)
+    end
+
+    def separate_capital_and_following_capitalized_word
+      gsub(/([A-Z])([A-Z])([a-z])/,
+           "\\1#{separator}\\2\\3")
+    end
+
+    def separate_digit_and_following_letter
+      gsub(/([0-9])([a-z])/i, "\\1#{separator}\\2")
+    end
+
+    def separate_lowercase_letter_and_following_capital_letter
+      gsub(/([a-z])([A-Z])/, "\\1#{separator}\\2")
+    end
+
+    def separator
+      '_'
+    end
+
+    def to_source_filename
+      replace_nonalphanumeric_sequence_with_separator.
+        separate_capital_and_following_capitalized_word.
+        separate_lowercase_letter_and_following_capital_letter.
+        separate_digit_and_following_letter.
+        downcase
+    end
+  end
+
+end

data/lib/autoloaded/version.rb

@@ -0,0 +1,5 @@
+module Autoloaded
+
+  VERSION = '0.0.3'
+
+end

data/spec/autoloaded/constant_spec.rb

@@ -0,0 +1,33 @@
+require 'autoloaded/constant'
+
+RSpec.describe Autoloaded::Constant do
+  let(:constant_class) { described_class }
+
+  describe 'for' do
+    let(:directory) { 'spec/fixtures/filenames' }
+
+    {AFilename:  %w(a_filename  a-file-name a-filename a_file_name             AFilename),
+     A_FILENAME: %w(a_filename  a-file-name a-filename a_file_name             AFilename),
+     AFileName:  %w(a_file_name a-file-name a-filename             a_filename  AFilename),
+     AFILEName:  %w(a-file-name             a-filename a_file_name a_filename  AFilename)}.each do |constant_name,
+                                                                                                    filenames|
+      describe constant_name.inspect do
+        let(:constant) { constant_class.new constant_name }
+
+        let(:full_filenames) {
+          filenames.collect do |filename|
+            "#{directory}/#{filename}.rb"
+          end
+        }
+
+        describe '#each_matching_filename_in' do
+          specify {
+            expect { |block|
+              constant.each_matching_filename_in(directory, &block)
+            }.to yield_successive_args(*full_filenames)
+          }
+        end
+      end
+    end
+  end
+end

data/spec/autoloaded/refine/string/to_source_filename_spec.rb

@@ -0,0 +1,21 @@
+require 'autoloaded/refine/string/to_source_filename'
+
+using Autoloaded::Refine::String::ToSourceFilename
+
+RSpec.describe Autoloaded::Refine::String::ToSourceFilename do
+  {'Foo'        => 'foo',
+   'IO'         => 'io',
+   'MySQL2'     => 'my_sql2',
+   'PostgreSQL' => 'postgre_sql',
+   'Geo3D'      => 'geo3_d',
+   'Xfiles'     => 'xfiles',
+   'XFiles'     => 'x_files',
+   'FOOBar'     => 'foo_bar',
+   'FOO_BAR'    => 'foo_bar'}.each do |constant_name, filename|
+    describe "for #{constant_name.inspect}" do
+      describe '#to_source_filename' do
+        specify { expect(constant_name.to_source_filename).to eq(filename) }
+      end
+    end
+  end
+end

data/spec/autoloaded/shallow_spec.rb

@@ -0,0 +1,44 @@
+require 'autoloaded'
+require 'matchers'
+
+RSpec.describe Autoloaded do
+  describe 'not included in a namespace' do
+    let(:source_file) { 'spec/fixtures/namespace_that_is_not_autoloaded.rb' }
+
+    specify('does not dynamically define a nested constant') {
+      expect(source_file).not_to autoload_a_constant_named('NamespaceThatIsNotAutoloaded::Nested')
+    }
+  end
+
+  describe 'included in a namespace' do
+    describe 'whose source files have conventional names' do
+      let(:source_file) {
+        'spec/fixtures/namespace_that_is_autoloaded_conventionally.rb'
+      }
+
+      specify('dynamically defines a nested constant stored in a conventionally-named file') {
+        expect(source_file).to autoload_a_constant_named('NamespaceThatIsAutoloadedConventionally::Nested')
+      }
+
+      specify('does not pollute the namespace') {
+        expect(source_file).to define_only_constants_named(:Nested).
+                               in_a_namespace_named(:NamespaceThatIsAutoloadedConventionally)
+      }
+    end
+
+    describe 'whose source files have unconventional names' do
+      let(:source_file) {
+        'spec/fixtures/namespace_that_is_autoloaded_unconventionally.rb'
+      }
+
+      specify('dynamically defines a nested constant stored in a unconventionally-named file') {
+        expect(source_file).to autoload_a_constant_named('NamespaceThatIsAutoloadedUnconventionally::Nested')
+      }
+
+      specify('does not pollute the namespace') {
+        expect(source_file).to define_only_constants_named(:Nested).
+                               in_a_namespace_named(:NamespaceThatIsAutoloadedUnconventionally)
+      }
+    end
+  end
+end

data/spec/autoloaded/version_spec.rb

@@ -0,0 +1,5 @@
+require 'autoloaded/version'
+
+RSpec.describe "#{Autoloaded.name}::VERSION" do
+  specify { expect(Autoloaded::VERSION).to match( /^\d+\.\d+\.\d+/ ) }
+end

data/spec/fixtures/namespace_that_is_autoloaded_conventionally.rb

@@ -0,0 +1,7 @@
+require 'autoloaded'
+
+module NamespaceThatIsAutoloadedConventionally
+
+  extend ::Autoloaded
+
+end

data/spec/fixtures/namespace_that_is_autoloaded_conventionally/N-est-ed.rb

@@ -0,0 +1 @@
+raise "The file #{__FILE__} should not have been loaded"

data/spec/fixtures/namespace_that_is_autoloaded_conventionally/nest_ed.rb

@@ -0,0 +1 @@
+raise "The file #{__FILE__} should not have been loaded"

data/spec/fixtures/namespace_that_is_autoloaded_conventionally/nested.rb

@@ -0,0 +1,5 @@
+module NamespaceThatIsAutoloadedConventionally
+
+  module Nested; end
+
+end

data/spec/fixtures/namespace_that_is_autoloaded_unconventionally.rb

@@ -0,0 +1,7 @@
+require 'autoloaded'
+
+module NamespaceThatIsAutoloadedUnconventionally
+
+  extend ::Autoloaded
+
+end

data/spec/fixtures/namespace_that_is_autoloaded_unconventionally/N-est-ed.rb

@@ -0,0 +1,5 @@
+module NamespaceThatIsAutoloadedUnconventionally
+
+  module Nested; end
+
+end

data/spec/fixtures/namespace_that_is_autoloaded_unconventionally/nest_ed.rb

@@ -0,0 +1 @@
+raise "The file #{__FILE__} should not have been loaded"

data/spec/fixtures/namespace_that_is_not_autoloaded.rb

@@ -0,0 +1 @@
+module NamespaceThatIsNotAutoloaded; end

data/spec/fixtures/namespace_that_is_not_autoloaded/nested.rb

@@ -0,0 +1,5 @@
+module NamespaceThatIsNotAutoloaded
+
+  module Nested; end
+
+end

data/spec/matchers.rb

@@ -0,0 +1,89 @@
+require 'open3'
+
+RSpec::Matchers.define :autoload_a_constant_named do |constant_name|
+  match do |source_file|
+    # Ensure the file exists.
+    File.read source_file
+
+    constant_tokens = constant_name.split('::')
+    constant_up_till_last = constant_tokens[0...-1].join('::')
+    constant_last = constant_tokens.last
+    assertion = <<-end_assertion.gsub(/^      /, '')
+      begin;
+        #{constant_name};
+      rescue;
+      else;
+        raise('Constant #{constant_name} is already defined');
+      end;
+
+      load #{source_file.inspect};
+
+      puts(begin;
+             #{constant_name};
+           rescue;
+             'false';
+           else;
+             #{constant_up_till_last}.autoload?(:#{constant_last}) ?
+               'true'                                              :
+               'false';
+           end)
+    end_assertion
+    quoted_assertion = assertion.chomp.inspect.gsub('\n', "\n")
+    Open3.popen3 "bundle exec ruby -e #{quoted_assertion}" do |stdin,
+                                                               stdout,
+                                                               stderr|
+      if (stderr_output = stderr.read.chomp).empty?
+        eval stdout.read.chomp
+      else
+        raise stderr_output
+      end
+    end
+  end
+end
+
+RSpec::Matchers.define :define_only_constants_named do |*constant_names|
+  attr_reader :expected_constants, :extraneous_defined_constants, :namespace_name
+
+  match do |source_file|
+    # Ensure the file exists.
+    File.read source_file
+
+    unless namespace_name
+      raise "Missing .in_a_namespace_named(:Namespace) clause"
+    end
+
+    assertion = <<-end_assertion.gsub(/^      /, '')
+      load #{source_file.inspect};
+
+      puts(begin;
+             #{constant_names.inspect}.each do |constant_name|
+               #{namespace_name}.const_get constant_name;
+             end;
+             #{namespace_name}.constants.inspect;
+           rescue;
+             '[]';
+           end)
+    end_assertion
+    quoted_assertion = assertion.chomp.inspect.gsub('\n', "\n")
+    Open3.popen3 "bundle exec ruby -e #{quoted_assertion}" do |stdin,
+                                                               stdout,
+                                                               stderr|
+      if (stderr_output = stderr.read.chomp).empty?
+        defined_constants = Array(eval(stdout.read.chomp)).sort.collect(&:to_sym)
+        @expected_constants = constant_names.sort.collect(&:to_sym)
+        @extraneous_defined_constants = defined_constants - expected_constants
+        extraneous_defined_constants.empty?
+      else
+        raise stderr_output
+      end
+    end
+  end
+
+  chain :in_a_namespace_named do |namespace_name|
+    @namespace_name = namespace_name
+  end
+
+  failure_message do |source_file|
+    "expected only #{expected_constants.join ' and '} to be defined in #{namespace_name} but also found #{extraneous_defined_constants.join ' and '}"
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,85 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The generated `.rspec` file contains `--require spec_helper` which will cause this
+# file to always be loaded, without a need to explicitly require it in any files.
+#
+# Given that it is always loaded, you are encouraged to keep this file as
+# light-weight as possible. Requiring heavyweight dependencies from this file
+# will add to the boot time of your test suite on EVERY test run, even for an
+# individual file that may not need all of that loaded. Instead, consider making
+# a separate helper file that requires the additional dependencies and performs
+# the additional setup, and require it from the spec files that actually need it.
+#
+# The `.rspec` file also contains a few flags that are not defaults but that
+# users commonly want.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    # be_bigger_than(2).and_smaller_than(4).description
+    #   # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #   # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+  # These two settings work together to allow you to limit a spec run
+  # to individual examples or groups you care about by tagging them with
+  # `:focus` metadata. When nothing is tagged with `:focus`, all examples
+  # get run.
+  config.filter_run :focus
+  config.run_all_when_everything_filtered = true
+
+  # Limits the available syntax to the non-monkey patched syntax that is recommended.
+  # For more details, see:
+  #   - http://myronmars.to/n/dev-blog/2012/06/rspecs-new-expectation-syntax
+  #   - http://teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+  #   - http://myronmars.to/n/dev-blog/2014/05/notable-changes-in-rspec-3#new__config_option_to_disable_rspeccore_monkey_patching
+  config.disable_monkey_patching!
+
+  # This setting enables warnings. It's recommended, but in some cases may
+  # be too noisy due to issues in dependencies.
+  # config.warnings = true
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+  if config.files_to_run.one?
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.default_formatter = 'doc'
+  end
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  config.profile_examples = 1
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
+end

metadata

@@ -0,0 +1,150 @@
+--- !ruby/object:Gem::Specification
+name: autoloaded
+version: !ruby/object:Gem::Version
+  version: 0.0.3
+platform: ruby
+authors:
+- Nils Jonsson
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-10-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '10'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3'
+description: 'Dynamically and flexibly loads source files in a directory when a corresponding
+  constant is dereferenced. Offers several advantages over other autoloading facilities
+  such as those provided by the Ruby Core library and the ActiveSupport gem: (a) it
+  does not require a separate `autoload` statement for each constant, and (b) it does
+  not enforce CamelCase to snake_case correspondence between the names of constants
+  and source files.'
+email:
+- autoloaded@nilsjonsson.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .ruby-gemset
+- .ruby-version
+- .yardopts
+- Gemfile
+- Guardfile
+- License.md
+- README.md
+- Rakefile
+- autoloaded.gemspec
+- lib/autoloaded.rb
+- lib/autoloaded/constant.rb
+- lib/autoloaded/refine.rb
+- lib/autoloaded/refine/string.rb
+- lib/autoloaded/refine/string/to_source_filename.rb
+- lib/autoloaded/version.rb
+- spec/autoloaded/constant_spec.rb
+- spec/autoloaded/refine/string/to_source_filename_spec.rb
+- spec/autoloaded/shallow_spec.rb
+- spec/autoloaded/version_spec.rb
+- spec/fixtures/filenames/AFilename.rb
+- spec/fixtures/filenames/a-file-name.rb
+- spec/fixtures/filenames/a-filename.rb
+- spec/fixtures/filenames/a_file_name.rb
+- spec/fixtures/filenames/a_filename.rb
+- spec/fixtures/namespace_that_is_autoloaded_conventionally.rb
+- spec/fixtures/namespace_that_is_autoloaded_conventionally/N-est-ed.rb
+- spec/fixtures/namespace_that_is_autoloaded_conventionally/nest_ed.rb
+- spec/fixtures/namespace_that_is_autoloaded_conventionally/nested.rb
+- spec/fixtures/namespace_that_is_autoloaded_unconventionally.rb
+- spec/fixtures/namespace_that_is_autoloaded_unconventionally/N-est-ed.rb
+- spec/fixtures/namespace_that_is_autoloaded_unconventionally/nest_ed.rb
+- spec/fixtures/namespace_that_is_not_autoloaded.rb
+- spec/fixtures/namespace_that_is_not_autoloaded/nested.rb
+- spec/matchers.rb
+- spec/spec_helper.rb
+homepage: https://github.com/njonsson/autoloaded
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ~>
+    - !ruby/object:Gem::Version
+      version: '2.1'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Dynamically and flexibly loads source files in a directory when a corresponding
+  constant is dereferenced.
+test_files:
+- spec/autoloaded/constant_spec.rb
+- spec/autoloaded/refine/string/to_source_filename_spec.rb
+- spec/autoloaded/shallow_spec.rb
+- spec/autoloaded/version_spec.rb
+- spec/fixtures/filenames/AFilename.rb
+- spec/fixtures/filenames/a-file-name.rb
+- spec/fixtures/filenames/a-filename.rb
+- spec/fixtures/filenames/a_file_name.rb
+- spec/fixtures/filenames/a_filename.rb
+- spec/fixtures/namespace_that_is_autoloaded_conventionally.rb
+- spec/fixtures/namespace_that_is_autoloaded_conventionally/N-est-ed.rb
+- spec/fixtures/namespace_that_is_autoloaded_conventionally/nest_ed.rb
+- spec/fixtures/namespace_that_is_autoloaded_conventionally/nested.rb
+- spec/fixtures/namespace_that_is_autoloaded_unconventionally.rb
+- spec/fixtures/namespace_that_is_autoloaded_unconventionally/N-est-ed.rb
+- spec/fixtures/namespace_that_is_autoloaded_unconventionally/nest_ed.rb
+- spec/fixtures/namespace_that_is_not_autoloaded.rb
+- spec/fixtures/namespace_that_is_not_autoloaded/nested.rb
+- spec/matchers.rb
+- spec/spec_helper.rb
+has_rdoc: