zeroload 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 8ff5fae430018bfb1219524cfd85e641487ccdd4
+  data.tar.gz: cf6085c9d9b835345a5046aaf4a4e8822cd9015f
+SHA512:
+  metadata.gz: 830b47b027951eafaf5b6175d1f4ab23c94a81b03a10468e9518618ad54ee8f133b0f2cdff2bda0c97334282943c9b543b1a49f4831598eda87e81952d70668a
+  data.tar.gz: f2799be3bdb1aae80d1082fbb061743bb1b9e36faa81b1773f6014d11c7deec7bb931dbac07f9bf4e411ccaa4e97395709224fae0272a59518c1732f2476a972

data/README.markdown

@@ -0,0 +1,75 @@
+README
+======
+
+
+Summary
+-------
+
+Automatically autoload all constants for a module.  
+Reduces your requires to one line per file, plus external dependencies.  
+Enables requiring always only the precise file holding the constant you
+depend on (or top level if you depend on many).
+
+
+Installation
+------------
+
+`gem install zeroload`
+
+
+Usage
+-----
+
+Map your constants to filenames by replacing :: with /. For example, the
+constant Foo::BarBaz should be defined in file lib/Foo/BarBaz.rb. Note that
+the case matters! Each file should require the nesting namespace. That is,
+Foo/BarBaz.rb should require "Foo". All modules & classes always use
+zeroload.
+
+### Example
+
+Given the files
+
+* lib/Foo.rb
+* lib/Foo/Bar.rb
+
+The contents of lib/Foo.rb is:
+
+    require "zeroload"
+
+    module Foo
+      zeroload!
+
+      # Code of Foo
+    end
+
+And the contents of lib/Foo/bar.rb is:
+
+    require "Foo"
+
+    module Foo
+      class Bar
+        zeroload! # only necessary if there's stuff nested below 
+
+      # Code of Foo::Bar
+    end
+
+
+
+Description
+-----------
+
+Automatically autoload all constants for a module. This requires a change from
+the current convention of putting class Foo::BarBaz into foo/barbaz.rb (or
+foo/bar_baz.rb in rails) to using Foo/BarBaz.rb instead.
+
+
+Caveats
+-------
+
+* **Q:** But didn't have Kernel#autoload problems with multi-threading?  
+* **A:** Yes, it did. They've since been resolved:
+  * [see bug 921](https://bugs.ruby-lang.org/issues/921)
+  * [see Revision 33078](https://bugs.ruby-lang.org/projects/ruby-trunk/repository/revisions/33078)
+* **Q:** But isn't Kernel#autoload deprecated?
+* **A:** Sadly, the state on this is not entirely clear. But it seems it is no longer deprecated.

data/Rakefile

@@ -0,0 +1,10 @@
+$LOAD_PATH.unshift(File.expand_path('../rake/lib', __FILE__))
+Dir.glob(File.expand_path('../rake/tasks/**/*.{rake,task,rb}', __FILE__)) do |task_file|
+  begin
+    import task_file
+  rescue LoadError => e
+    warn "Failed to load task file #{task_file}"
+    warn "  #{e.class} #{e.message}"
+    warn "  #{e.backtrace.first}"
+  end
+end

data/lib/zeroload/auto.rb

@@ -0,0 +1,7 @@
+module Kernel
+  def zeroload!(directory=nil, *args)
+    directory ||= caller_locations.first.absolute_path.sub(/\.[^.]*\z/, "")
+
+    Zeroload.module(self, directory, *args)
+  end
+end

data/lib/zeroload/version.rb

@@ -0,0 +1,5 @@
+require 'rubygems/version' # newer rubygems use this
+
+module Zeroload
+  Version = Gem::Version.new("0.0.1")
+end

data/lib/zeroload.rb

@@ -0,0 +1,21 @@
+require 'zeroload/version'
+require 'zeroload/auto'
+
+# Zeroload
+# Automatically autoload all constants for a module. This requires a change from
+# the current convention of putting class Foo::BarBaz into foo/barbaz.rb (or
+# foo/bar_baz.rb in rails) to using Foo/BarBaz.rb instead.
+module Zeroload
+  def self.module(mod, directory=nil)
+    directory ||= caller_locations.first.absolute_path.sub(/\.[^.]*\z/, "".freeze)
+
+    Dir.glob("#{directory}/*.{rb,so,bundle,dll}") do |path|
+      name = File.basename(path)
+      if /\A[A-Z]/ =~ name
+        name.sub!(/\.[^.]*\z/, "".freeze)
+        warn "#{mod} autoloads #{name} from #{path}" if $VERBOSE
+        mod.autoload :"#{name}", path
+      end
+    end
+  end
+end

data/zeroload.gemspec

@@ -0,0 +1,33 @@
+Gem::Specification.new do |s|
+  s.name                      = "zeroload"
+  s.version                   = "0.0.1"
+  s.authors                   = "Stefan Rusterholz"
+  s.email                     = "stefan.rusterholz@gmail.com"
+  s.homepage                  = "https://github.com/apeiros/jacob"
+  s.license                   = "BSD 2-Clause"
+
+  s.description               = <<-DESCRIPTION.gsub(/^    /, '').chomp
+    Automatically autoload all constants for a module. This requires a change from
+    the current convention of putting class Foo::BarBaz into foo/barbaz.rb (or
+    foo/bar_baz.rb in rails) to using Foo/BarBaz.rb instead.
+  DESCRIPTION
+  s.summary                   = <<-SUMMARY.gsub(/^    /, '').chomp
+    Automatically autoload all constants for a module.
+  SUMMARY
+
+  s.required_ruby_version     = ">= 2.1.0" # TODO: figure out, when autoload became thread-safe
+  s.files                     =
+    Dir['bin/**/*'] +
+    Dir['lib/**/*'] +
+    Dir['rake/**/*'] +
+    Dir['test/**/*'] +
+    Dir["*.gemspec"] +
+    %w[
+      Rakefile
+      README.markdown
+    ]
+
+  if File.directory?('bin') then
+    s.executables = Dir.chdir('bin') { Dir.glob('**/*').select { |f| File.executable?(f) } }
+  end
+end

metadata

@@ -0,0 +1,53 @@
+--- !ruby/object:Gem::Specification
+name: zeroload
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Stefan Rusterholz
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-11-29 00:00:00.000000000 Z
+dependencies: []
+description: |-
+  Automatically autoload all constants for a module. This requires a change from
+  the current convention of putting class Foo::BarBaz into foo/barbaz.rb (or
+  foo/bar_baz.rb in rails) to using Foo/BarBaz.rb instead.
+email: stefan.rusterholz@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.markdown
+- Rakefile
+- lib/zeroload.rb
+- lib/zeroload/auto.rb
+- lib/zeroload/version.rb
+- zeroload.gemspec
+homepage: https://github.com/apeiros/jacob
+licenses:
+- BSD 2-Clause
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5.1
+signing_key: 
+specification_version: 4
+summary: Automatically autoload all constants for a module.
+test_files: []
+has_rdoc: