open_namespace 0.3.2 → 0.4.0

data/.gitignore

@@ -0,0 +1,6 @@
+pkg
+doc
+.DS_Store
+.yardoc
+*.swp
+*~

data/ChangeLog.md

@@ -1,6 +1,13 @@
+### 0.4.0 / 2011-11-19
+
+* Added {OpenNamespace.const_lookup}.
+* Added {OpenNamespace.const_search}.
+* Added {OpenNamespace::ClassMethods#const_lookup}.
+* Added {OpenNamespace::ClassMethods#const_defined?}.
+
 ### 0.3.2 / 2011-07-12
 
-* Fixed a bug in {OpenNamespace.constant_path} where the argument was
+* Fixed a bug in {OpenNamespace.const_path} where the argument was
   being modified in-place.
 
 ### 0.3.1 / 2011-03-08
@@ -9,7 +16,7 @@
 
 ### 0.3.0 / 2010-04-28
 
-* Added {OpenNamespace.constant_path}.
+* Added {OpenNamespace.const_path}.
 * Added {OpenNamespace::ClassMethods#require_file}.
 * Added {OpenNamespace::ClassMethods#const_search}.
 * Improved searching for constants with oddly capitalized names, such as

data/README.md

@@ -13,6 +13,7 @@ load plugin modules/classes from other gems.
 
 ## Features
 
+* Provides implicit loading of constants via `const_defined?`.
 * Provides implicit loading of constants via `const_missing`.
 * Provides explicit loading of constants via `require_const`.
 

data/Rakefile

@@ -25,7 +25,7 @@ task :test => :spec
 task :default => :spec
 
 begin
-  gem 'yard', '~> 0.7.0'
+  gem 'yard', '~> 0.7'
   require 'yard'
 
   YARD::Rake::YardocTask.new  

data/gemspec.yml

@@ -13,4 +13,4 @@ has_yard: true
 development_dependencies:
   ore-tasks: ~> 0.4
   rspec: ~> 2.4
-  yard: ~> 0.7.0
+  yard: ~> 0.7

data/lib/open_namespace/class_methods.rb

@@ -7,7 +7,7 @@ module OpenNamespace
     #   The file path used to load constants into the namespace.
     #
     def namespace_root
-      @namespace_root ||= OpenNamespace.constant_path(self.name)
+      @namespace_root ||= OpenNamespace.const_path(self.name)
     end
 
     #
@@ -79,6 +79,45 @@ module OpenNamespace
       return true
     end
 
+    #
+    # Checks if a constant is defined or attempts loading the constant.
+    #
+    # @param [String] name
+    #   The name of the constant.
+    #
+    # @param [Boolean] inherit
+    #   Specifies whether to search the ancestors for the constant.
+    #
+    # @return [Boolean]
+    #   Specifies whether the constant is defined.
+    #
+    def const_defined?(name,*inherit)
+      if super(name,*inherit)
+        true
+      else
+        # attempt to load the file that might have the constant
+        require_file(OpenNamespace.const_path(name))
+
+        # check for the constant again
+        return super(name,*inherit)
+      end
+    end
+
+    #
+    # Finds the exact constant.
+    #
+    # @param [String] name
+    #   The name of the constant.
+    #
+    # @return [Object, nil]
+    #   The exact constant or `nil` if the constant could not be found.
+    #
+    # @since 0.4.0
+    #
+    def const_lookup(name)
+      OpenNamespace.const_lookup(self,name)
+    end
+
     #
     # Finds the constant with a name similar to the given file name.
     #
@@ -92,28 +131,7 @@ module OpenNamespace
     # @since 0.3.0
     #
     def const_search(file_name)
-      names = file_name.to_s.split(/[:\/]+/)
-      scope = self
-
-      until names.empty?
-        name = names.shift
-
-        # strip any dashes or underscores
-        name.tr!('_-','')
-
-        # perform a case insensitive search
-        const_pattern = /^#{name}$/i
-
-        # grep for the constant
-        const_name = scope.constants.find { |name| name =~ const_pattern }
-
-        # the constant search failed
-        return nil unless const_name
-
-        scope = scope.const_get(const_name)
-      end
-
-      return scope
+      OpenNamespace.const_search(self,file_name)
     end
 
     protected
@@ -133,18 +151,9 @@ module OpenNamespace
     # @see require_const.
     #
     def const_missing(name)
-      file_name = OpenNamespace.constant_path(name)
-
-      if require_file(file_name)
-        #
-        # If const_missing is being called, the constant is not present yet.
-        # Therefor, only check for the constant if the file was
-        # successfully loaded by require_file.
-        #
-        if self.const_defined?(name)
-          # get the exact constant name that was requested
-          return self.const_get(name)
-        end
+      if self.const_defined?(name)
+        # get the exact constant name that was requested
+        return self.const_get(name)
       end
       
       return super(name)

data/lib/open_namespace/open_namespace.rb

@@ -16,7 +16,9 @@ module OpenNamespace
   #
   # @since 0.3.0
   #
-  def OpenNamespace.constant_path(name)
+  # @api semipublic
+  #
+  def self.const_path(name)
     path = name.to_s.dup
 
     # back-ported from extlib's String#to_const_path
@@ -31,4 +33,75 @@ module OpenNamespace
     path.downcase!
     return path
   end
+
+  #
+  # Finds the exact constant.
+  #
+  # @param [Module, Class] scope
+  #   The scope to begin searching within.
+  #
+  # @param [String] name
+  #   The name of the constant.
+  #
+  # @return [Object, nil]
+  #   The exact constant or `nil` if the constant could not be found.
+  #
+  # @since 0.4.0
+  #
+  # @api semipublic
+  #
+  def self.const_lookup(scope,name)
+    names = name.split('::')
+
+    until names.empty?
+      begin
+        scope = scope.const_get(names.shift)
+      rescue NameError
+        return nil
+      end
+    end
+
+    return scope
+  end
+
+  #
+  # Finds the constant with a name similar to the given file name.
+  #
+  # @param [Module, Class] scope
+  #   The scope to begin searching within.
+  #
+  # @param [Symbol, String] file_name
+  #   The file name that represents the constant.
+  #
+  # @return [Object, nil]
+  #   Returns the found constants, or `nil` if a `NameError` exception
+  #   was encountered.
+  #
+  # @since 0.4.0
+  #
+  # @api semipublic
+  #
+  def self.const_search(scope,file_name)
+    names = file_name.to_s.split(/[:\/]+/)
+
+    until names.empty?
+      name = names.shift
+
+      # strip any dashes or underscores
+      name.tr!('_-','')
+
+      # perform a case insensitive search
+      const_pattern = /^#{name}$/i
+
+      # grep for the constant
+      const_name = scope.constants.find { |name| name =~ const_pattern }
+
+      # the constant search failed
+      return nil unless const_name
+
+      scope = scope.const_get(const_name)
+    end
+
+    return scope
+  end
 end

data/lib/open_namespace/version.rb

@@ -1,4 +1,4 @@
 module OpenNamespace
   # open_namespace version
-  VERSION = '0.3.2'
+  VERSION = '0.4.0'
 end

data/open_namespace.gemspec

@@ -95,7 +95,7 @@ Gem::Specification.new do |gemspec|
   end
 
   if gemspec.respond_to?(:required_rubygems_version=)
-    gemspec.required_rubygems_version = metadata['required_ruby_version']
+    gemspec.required_rubygems_version = metadata['required_rubygems_version']
   end
 
   parse_versions = lambda { |versions|

data/spec/classes/custom/constant_three.rb

@@ -0,0 +1,6 @@
+module Classes
+  module CustomNamespace
+    class ConstantThree
+    end
+  end
+end

data/spec/classes/simple_namespace/constant_three.rb

@@ -0,0 +1,6 @@
+module Classes
+  module SimpleNamespace
+    class ConstantThree
+    end
+  end
+end

data/spec/open_namespace_spec.rb

@@ -66,6 +66,10 @@ describe OpenNamespace do
       const.should be_nil
     end
 
+    it "should attempt loading the constant when calling const_defined?" do
+      @module.const_defined?('ConstantThree').should == true
+    end
+
     it "should load constants transparently via const_missing" do
       const = @module::ConstantTwo
 
@@ -136,6 +140,10 @@ describe OpenNamespace do
       const.should be_nil
     end
 
+    it "should attempt loading the constant when calling const_defined?" do
+      @module.const_defined?('ConstantThree').should == true
+    end
+
     it "should load constants transparently via const_missing" do
       const = @module::ConstantTwo
 

metadata

@@ -1,61 +1,61 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: open_namespace
-version: !ruby/object:Gem::Version 
+version: !ruby/object:Gem::Version
+  version: 0.4.0
   prerelease: 
-  version: 0.3.2
 platform: ruby
-authors: 
+authors:
 - Postmodern
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2011-07-12 00:00:00 Z
-dependencies: 
-- !ruby/object:Gem::Dependency 
+date: 2011-11-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
   name: ore-tasks
-  prerelease: false
-  requirement: &id001 !ruby/object:Gem::Requirement 
+  requirement: &10491560 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        version: "0.4"
+      - !ruby/object:Gem::Version
+        version: '0.4'
   type: :development
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
-  name: rspec
   prerelease: false
-  requirement: &id002 !ruby/object:Gem::Requirement 
+  version_requirements: *10491560
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &10494620 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        version: "2.4"
+      - !ruby/object:Gem::Version
+        version: '2.4'
   type: :development
-  version_requirements: *id002
-- !ruby/object:Gem::Dependency 
-  name: yard
   prerelease: false
-  requirement: &id003 !ruby/object:Gem::Requirement 
+  version_requirements: *10494620
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: &10370760 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        version: 0.7.0
+      - !ruby/object:Gem::Version
+        version: '0.7'
   type: :development
-  version_requirements: *id003
-description: OpenNamespace allows namespaces to require and find classes and modules from other RubyGems.
-email: 
-- postmodern.mod3@gmail.com
+  prerelease: false
+  version_requirements: *10370760
+description: OpenNamespace allows namespaces to require and find classes and modules
+  from other RubyGems.
+email: postmodern.mod3@gmail.com
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
+- ChangeLog.md
+- LICENSE.txt
 - README.md
-files: 
+files:
 - .gemtest
+- .gitignore
 - .rspec
 - .yardopts
 - ChangeLog.md
@@ -70,6 +70,7 @@ files:
 - open_namespace.gemspec
 - spec/classes/custom/bad_constant.rb
 - spec/classes/custom/constant_one.rb
+- spec/classes/custom/constant_three.rb
 - spec/classes/custom/constant_two.rb
 - spec/classes/custom/odd_constant.rb
 - spec/classes/custom/sub/constant_four.rb
@@ -77,37 +78,37 @@ files:
 - spec/classes/simple_namespace.rb
 - spec/classes/simple_namespace/bad_constant.rb
 - spec/classes/simple_namespace/constant_one.rb
+- spec/classes/simple_namespace/constant_three.rb
 - spec/classes/simple_namespace/constant_two.rb
 - spec/classes/simple_namespace/odd_constant.rb
 - spec/classes/simple_namespace/sub/constant_four.rb
 - spec/open_namespace_spec.rb
 - spec/spec_helper.rb
 homepage: http://github.com/postmodern/open_namespace
-licenses: 
+licenses:
 - MIT
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
-rubyforge_project: open_namespace
-rubygems_version: 1.8.5
+rubyforge_project: 
+rubygems_version: 1.8.10
 signing_key: 
 specification_version: 3
 summary: Allows namespaces to load constants on-demand
-test_files: 
+test_files:
 - spec/open_namespace_spec.rb
+has_rdoc: