autoloaded 1.4.1 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 002e4e92fb2d2dde6fc2e0f00ece6e13df188b1e
-  data.tar.gz: 0806960319493b98a01a0d8be789a32e519c2050
+  metadata.gz: b6f618df722d4ed99a713dfbcf0344a03eca3493
+  data.tar.gz: dc5dbdff9502b4c1988100f0fcf43e83cf69ee97
 SHA512:
-  metadata.gz: b4e6409a4cea035bc9e7d2102de99a97e0202106715b6873aad6ca1fd68f06e9850063037f03fe9c7c8bd569321729aa4d7092ac0fa56b8a67c00a7ea8b865dd
-  data.tar.gz: 2a0e5ba02e1a4ac86269c64bb5b788e3c5a29819284fef0ff258a73cabcb7a2ec01dec351d1395c8c1e223d9c2a8e42ebc359e5d5deb25a19d0cd68ab63261cb
+  metadata.gz: 1d7d80da2b33e2d1eebcfdd5d80d66790d7d9fcb173104114b530fb6d42437749d097e0347f9a7197e74ba1dd2c4ef41fcf03efcede9fc89f0088fd5a3696f0d
+  data.tar.gz: 7cccc5f5fe68de29fa48a07ceb18351e4e4b47d0a9c65fa911e8253ba7f8c6d025b544c64bf78d429c2d1bc12a3e52877624d0fdfb96de8581ea3f08061634e1

data/.gitignore

@@ -1,16 +1,12 @@
 /.bundle/
-/.yardoc
+/.rbx
+/.ruby-*
+/.yardoc/
 /Gemfile.lock
 /_yardoc/
 /coverage/
 /doc/
 /pkg/
+/spec/examples.txt
 /spec/reports/
 /tmp/
-*.bundle
-*.so
-*.o
-*.a
-.ruby-gemset
-.ruby-version
-mkmf.log

data/.rspec

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

data/.travis.yml

@@ -1,12 +1,22 @@
 language: ruby
+before_install: gem install bundler
 bundler_args: --without debug doc tooling
 rvm:
   - 2.0
   - 2.1
+  - 2.2
+  - 2.3
   - ruby-head
   - jruby-head
+  - rbx
+  - rbx-2
 script: "bundle exec rake test"
 matrix:
   allow_failures:
     - rvm: ruby-head
     - rvm: jruby-head
+    - rvm: rbx
+    - rvm: rbx-2
+branches:
+  except:
+    - /^gh-pages.*$/

data/Gemfile

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

data/Guardfile

@@ -1,38 +1,37 @@
-interactor :off
+require 'guard/rspec/dsl'
 
 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$}
+guard :rspec, all_on_start: true,
+              all_after_pass: true,
+              cmd: "bundle exec rspec --format progress#{debugger_require}" do
+  dsl = Guard::RSpec::Dsl.new(self)
+  rspec, ruby = dsl.rspec, dsl.ruby
 
-  # Run all specs when a shared spec changes.
-  watch( %r{^spec/.+_sharedspec\.rb$} ) { 'spec' }
+  # RSpec files
+  watch('.rspec')          { rspec.spec_dir }
+  watch rspec.spec_helper  { rspec.spec_dir }
+  watch rspec.spec_support { rspec.spec_dir }
+  watch(%r{^spec/support}) { rspec.spec_dir } # This should not be necessary.
+  watch rspec.spec_files
 
   # Run all specs when a matcher changes.
-  watch( 'spec/matchers.rb' ) { 'spec' }
+  watch('spec/matchers.rb') { 'spec' }
 
-  # Run all specs when a support file changes.
-  watch( %r{^spec/support} ) { 'spec' }
+  # Run all specs when a shared spec changes.
+  watch(%r{^spec/.+_sharedspec\.rb$}) { rspec.spec_dir }
 
   # Run all specs 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' }
+  watch(%r{^spec/fixtures}) { rspec.spec_dir }
 
   # Run all specs when the bundle changes.
-  watch( 'Gemfile.lock'      ) { 'spec' }
-  watch( %r{^(.+)\.gemspec$} ) { 'spec' }
+  watch('Gemfile.lock')      { rspec.spec_dir }
+  watch(%r{^(.+)\.gemspec$}) { rspec.spec_dir }
+
+  # Ruby files
+  dsl.watch_spec_files_for ruby.lib_files
 end

data/History.md

@@ -1,5 +1,10 @@
 # Version history for the _Autoloaded_ project
 
+## <a name="v1.5.0"></a>v1.5.0, Wed 2/22/2017
+
+* Add support for Ruby load paths (`$:`) that contain one or more
+  [_Pathname_][Ruby-Stdlib-Pathname] objects
+
 ## <a name="v1.4.1"></a>v1.4.1, Sat 1/24/2015
 
 * Don’t warn about a _VERSION_ constant presumably loaded by a _.gemspec_
@@ -32,7 +37,8 @@
 (First release)
 
 [JRuby]:                      http://jruby.org
-[Ruby-Core-Module-autoload]:  http://ruby-doc.org/core/Module.html#method-i-autoload-3F   "‘Module#autoload’ method in the Ruby Core Library"
-[Ruby-Core-Module-constants]: http://ruby-doc.org/core/Module.html#method-i-constants     "‘Module#constants’ method in the Ruby Core Library"
-[readme]:                     http://github.com/njonsson/autoloaded/blob/master/README.md "Autoloaded readme"
-[inline-documentation]:       http://www.rubydoc.info/github/njonsson/autoloaded          "Autoloaded inline documentation"
+[Ruby-Core-Module-autoload]:  http://ruby-doc.org/core/Module.html#method-i-autoload-3F     "‘Module#autoload’ method in the Ruby Core Library"
+[Ruby-Core-Module-constants]: http://ruby-doc.org/core/Module.html#method-i-constants       "‘Module#constants’ method in the Ruby Core Library"
+[Ruby-Stdlib-Pathname]:       http://ruby-doc.org/stdlib/libdoc/pathname/rdoc/Pathname.html "‘Pathname’ class in the Ruby Standard Library"
+[readme]:                     http://github.com/njonsson/autoloaded/blob/master/README.md   "Autoloaded readme"
+[inline-documentation]:       http://www.rubydoc.info/github/njonsson/autoloaded            "Autoloaded inline documentation"

data/README.md

@@ -173,21 +173,21 @@ You can specify `with` multiple times, and its effects are cumulative.
 # lib/my_awesome_gem.rb
 module MyAwesomeGem
 
-  Autoloaded.module do |autoloaded|
-    autoloaded.with :DB, :VERSION
+  Autoloaded.module do |autoloading|
+    autoloading.with :DB, :VERSION
     # Or:
-    # autoloaded.with :DB
-    # autoloaded.with :VERSION
+    # autoloading.with :DB
+    # autoloading.with :VERSION
     # Or:
-    # autoloaded.with DB: 'db', VERSION: 'version'
+    # autoloading.with DB: 'db', VERSION: 'version'
     # Or:
-    # autoloaded.with DB:      'db'
-    # autoloaded.with VERSION: 'version'
+    # autoloading.with DB:      'db'
+    # autoloading.with VERSION: 'version'
     # Or:
-    # autoloaded.with 'db' => :DB, 'version' => :VERSION
+    # autoloading.with 'db' => :DB, 'version' => :VERSION
     # Or:
-    # autoloaded.with 'db'      => :DB
-    # autoloaded.with 'version' => :VERSION
+    # autoloading.with 'db'      => :DB
+    # autoloading.with 'version' => :VERSION
   end
 
   # The above is the equivalent of:
@@ -202,20 +202,20 @@ module MyAwesomeGem
 
   class DB
 
-    Autoloaded.class do |autoloaded|
-      autoloaded.with :MySQL, :PostgreSQL, [:Access, :SQLServer] => 'MicroSoft'
+    Autoloaded.class do |autoloading|
+      autoloading.with :MySQL, :PostgreSQL, [:Access, :SQLServer] => 'MicroSoft'
       # Or:
-      # autoloaded.with :MySQL,
-      #                 :PostgreSQL,
-      #                 Access:    'MicroSoft',
-      #                 SQLServer: 'MicroSoft'
+      # autoloading.with :MySQL,
+      #                  :PostgreSQL,
+      #                  Access:    'MicroSoft',
+      #                  SQLServer: 'MicroSoft'
       # Or:
-      # autoloaded.with :MySQL, :PostgreSQL, 'MicroSoft' => [:Access, :SQLServer]
+      # autoloading.with :MySQL, :PostgreSQL, 'MicroSoft' => [:Access, :SQLServer]
       # Or:
-      # autoloaded.with :MySQL,
-      #                 :PostgreSQL,
-      #                 'MicroSoft' => :Access,
-      #                 'MicroSoft' => :SQLServer
+      # autoloading.with :MySQL,
+      #                  :PostgreSQL,
+      #                  'MicroSoft' => :Access,
+      #                  'MicroSoft' => :SQLServer
       # Or ...
     end
 
@@ -283,12 +283,12 @@ module MyAwesomeGem
 
   class DB
 
-    Autoloaded.class do |autoloaded|
-      autoloaded.with :MySQL, :PostgreSQL, [:Access, :SQLServer] => 'MicroSoft'
+    Autoloaded.class do |autoloading|
+      autoloading.with :MySQL, :PostgreSQL, [:Access, :SQLServer] => 'MicroSoft'
 
-      autoloaded.except 'SELF-DESTRUCT!'
+      autoloading.except 'SELF-DESTRUCT!'
       # Or:
-      # autoloaded.except :SELF_DESTRUCT_
+      # autoloading.except :SELF_DESTRUCT_
       # Or ...
     end
 
@@ -357,12 +357,12 @@ which source files should be autoloaded.
 
 module MyAwesomeGem
 
-  Autoloaded.module do |autoloaded|
+  Autoloaded.module do |autoloading|
     # The following code is not actually very useful since the installed location
     # of a RubyGem varies with the operating system and user preferences. How to
     # compute the path properly is outside the scope of this readme and is left
     # as an exercise for the reader.
-    autoloaded.from '/absolute/path/to/my_awesome_gem'
+    autoloading.from '/absolute/path/to/my_awesome_gem'
   end
 
 end
@@ -448,9 +448,9 @@ module MyAwesomeGem
 
   class DB
 
-    results = Autoloaded.class do |autoloaded|
-      autoloaded.with   :MySQL, :PostgreSQL, [:Access, :SQLServer] => 'MicroSoft'
-      autoloaded.except 'SELF-DESTRUCT!'
+    results = Autoloaded.class do |autoloading|
+      autoloading.with   :MySQL, :PostgreSQL, [:Access, :SQLServer] => 'MicroSoft'
+      autoloading.except 'SELF-DESTRUCT!'
     end
     STDOUT.puts results.inspect  # See output below.
 
@@ -489,6 +489,19 @@ directories. This is by design.
 4. Push to the branch: `git push origin my-new-feature`.
 5. [Create][compare-Autoloaded-branches] a new pull request.
 
+Development
+-----------
+
+After cloning the repository, `bin/setup` to install dependencies. Then `rake` to
+run the tests. You can also `bin/console` to get an interactive prompt that will
+allow you to experiment.
+
+To install this gem onto your local machine, `bundle exec rake install`. To
+release a new version, update the version number in _lib/autoloaded/version.rb_,
+and then `bundle exec rake release`, which will create a Git tag for the version,
+push Git commits and tags, and push the _.gem_ file to
+[RubyGems.org](RubyGems-release).
+
 ## License
 
 Released under the [MIT License][MIT-License].

data/Rakefile

@@ -1,2 +1,6 @@
 require 'bundler/gem_tasks'
 require_relative 'lib/tasks'
+
+desc 'Run all specs'
+task '' => :spec
+task default: :spec

data/autoloaded.gemspec

@@ -1,46 +1,47 @@
 # coding: utf-8
-
 lib = File.expand_path('../lib', __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-
-require 'autoloaded'
+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.chomp.gsub(/^\s+/, '').gsub("\n", ' ')
-                         Eliminates the drudgery of handcrafting a Ruby Core
-                         library `autoload` statement for each Ruby source code
-                         file in your project. It also avoids the limitations of
-                         rigid convention-driven facilities such as those
-                         provided by the ActiveSupport RubyGem.
-                       end_summary
-  spec.description   = <<-end_description.chomp.gsub(/^\s+/, '').gsub("\n", ' ')
-                         If you like the ‘Module#autoload’ feature of the Ruby
-                         Core library, you may have wished for Autoloaded. It
-                         eliminates the drudgery of handcrafting an `autoload`
-                         statement for each Ruby source code file in your
-                         project. It also avoids the limitations of rigid
-                         convention-driven facilities such as those provided by
-                         the ActiveSupport RubyGem. Autoloaded assumes, but does
-                         not enforce, `CamelCase`-to-`snake_case` correspondence
-                         between the names of constants and source files. You can
-                         combine conventions, even putting multiple autoloaded
-                         constants in a single source file.
-                       end_description
-  spec.homepage      = 'http://njonsson.github.io/autoloaded'
-  spec.license       = 'MIT'
+  spec.name        = 'autoloaded'
+  spec.version     = Autoloaded::VERSION
+  spec.authors     = ['Nils Jonsson']
+  spec.email       = ['autoloaded@nilsjonsson.com']
 
-  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.summary     = <<-end_summary.chomp.gsub(/^\s+/, '').gsub("\n", ' ')
+                       Eliminates the drudgery of handcrafting a Ruby Core
+                       library `autoload` statement for each Ruby source code
+                       file in your project. It also avoids the limitations of
+                       rigid convention-driven facilities such as those provided
+                       by the ActiveSupport RubyGem.
+                     end_summary
+  spec.description = <<-end_description.chomp.gsub(/^\s+/, '').gsub("\n", ' ')
+                       If you like the ‘Module#autoload’ feature of the Ruby Core
+                       library, you may have wished for Autoloaded. It eliminates
+                       the drudgery of handcrafting an `autoload` statement for
+                       each Ruby source code file in your project. It also avoids
+                       the limitations of rigid convention-driven facilities such
+                       as those provided by the ActiveSupport RubyGem. Autoloaded
+                       assumes, but does not enforce, `CamelCase`-to-`snake_case`
+                       correspondence between the names of constants and source
+                       files. You can combine conventions, even putting multiple
+                       autoloaded constants in a single source file.
+                     end_description
+  spec.homepage    = 'http://njonsson.github.io/autoloaded'
+  spec.license     = 'MIT'
 
   spec.required_ruby_version = '~> 2'
 
-  spec.add_development_dependency 'bundler', '~>  1'
-  spec.add_development_dependency 'rake',    '~> 10'
-  spec.add_development_dependency 'rspec',   '~>  3'
+  spec.add_development_dependency 'bundler',                   '~>  1'
+  spec.add_development_dependency 'codeclimate-test-reporter', '~>  0'
+  spec.add_development_dependency 'rake',                      '~> 10'
+  spec.add_development_dependency 'rspec',                     '~>  3.3'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+                         f.match(%r{^(test|spec|features)/})
+                       end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename f }
+  spec.require_paths = %w(lib)
 end

data/bin/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'autoloaded'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+require 'pry'
+Pry.start

data/bin/setup

@@ -0,0 +1,8 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+which bundle || gem install bundler
+bundle
+
+# Do any other automated setup that you need to do here

data/lib/autoloaded/autoloader.rb

@@ -1,3 +1,9 @@
+require 'autoloaded/inflection'
+require 'autoloaded/load_pathed_directory'
+require 'autoloaded/specification'
+require 'autoloaded/specifications'
+require 'autoloaded/warning'
+
 module Autoloaded
 
   # Autoloads files in a source directory.

data/lib/autoloaded/constant.rb

@@ -1,3 +1,4 @@
+require 'autoloaded/refine/string/to_source_filename'
 require 'set'
 
 using ::Autoloaded::Refine::String::ToSourceFilename

data/lib/autoloaded/deprecation.rb

@@ -1,5 +1,3 @@
-module Autoloaded; end
-
 # Prints deprecation messages to _stderr_.
 #
 # @since 1.3

data/lib/autoloaded/inflection.rb

@@ -1,5 +1,3 @@
-module Autoloaded; end
-
 # Translates source filenames into constants.
 #
 # @since 1.3