namespace_helper 1.0.0

data/.gitignore

@@ -0,0 +1,10 @@
+# Project metadata
+nbproject
+.idea
+
+doc
+coverage
+pkg
+.yardoc
+.rbx
+*.rbc

data/.rspec

@@ -0,0 +1 @@
+--color

data/.travis.yml

@@ -0,0 +1,5 @@
+rvm:
+  - 1.9.2
+  - 1.9.3
+  - rbx-19mode
+  - jruby-19mode

data/.yardopts

@@ -0,0 +1,5 @@
+--protected
+--no-private
+-
+HISTORY.md
+LICENSE.md

data/Gemfile

@@ -0,0 +1,23 @@
+# encoding: UTF-8
+=begin
+Copyright Alexander E. Fischer <aef@raxys.net>, 2012
+
+This file is part of NamespaceHelper.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+source 'http://rubygems.org'
+
+# Specify your gem's dependencies in namespace_helper.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,54 @@
+PATH
+  remote: .
+  specs:
+    namespace_helper (1.0.0rc1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    coderay (1.0.5)
+    diff-lcs (1.1.3)
+    maruku (0.6.0)
+      syntax (>= 1.0.0)
+    method_source (0.7.0)
+    multi_json (1.0.4)
+    pry (0.9.8.2)
+      coderay (~> 1.0.5)
+      method_source (~> 0.7)
+      slop (>= 2.4.4, < 3)
+    pry (0.9.8.2-java)
+      coderay (~> 1.0.5)
+      method_source (~> 0.7)
+      slop (>= 2.4.4, < 3)
+      spoon (~> 0.0)
+    rake (0.9.2.2)
+    rspec (2.6.0)
+      rspec-core (~> 2.6.0)
+      rspec-expectations (~> 2.6.0)
+      rspec-mocks (~> 2.6.0)
+    rspec-core (2.6.4)
+    rspec-expectations (2.6.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.6.0)
+    simplecov (0.5.4)
+      multi_json (~> 1.0.3)
+      simplecov-html (~> 0.5.3)
+    simplecov-html (0.5.3)
+    slop (2.4.4)
+    spoon (0.0.1)
+    syntax (1.0.0)
+    yard (0.7.5)
+
+PLATFORMS
+  java
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.21)
+  maruku (~> 0.6.0)
+  namespace_helper!
+  pry (~> 0.9.8)
+  rake (~> 0.9.2)
+  rspec (~> 2.6.0)
+  simplecov (~> 0.5.4)
+  yard (~> 0.7.5)

data/HISTORY.md

@@ -0,0 +1,7 @@
+1.0.0 / 2012-02-24
+==================
+
+* 1 major enhancement
+
+  * Birthday!
+

data/LICENSE.md

@@ -0,0 +1,15 @@
+Copyright Alexander E. Fischer <aef@raxys.net>, 2012
+
+NamespaceHelper is licensed under the following ISC-style license:
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

data/README.md

@@ -0,0 +1,192 @@
+NamespaceHelper
+===============
+
+[![Build Status](https://secure.travis-ci.org/aef/namespace_helper.png)](
+https://secure.travis-ci.org/aef/namespace_helper)
+
+* [Documentation][1]
+* [Project][2]
+
+   [1]: http://rdoc.info/projects/aef/namespace_helper/
+   [2]: http://github.com/aef/namespace_helper/
+
+Description
+-----------
+
+NamespaceHelper provides a module with methods to ease namespace handling.
+For example getting the unprefixed name, the namespace parent or a list of
+namespace components of a class or module.
+
+Features / Problems
+-------------------
+
+This project tries to conform to:
+
+* [Semantic Versioning (2.0.0-rc.1)][5]
+* [Ruby Packaging Standard (0.5-draft)][6]
+* [Ruby Style Guide][7]
+* [Gem Packaging: Best Practices][8]
+
+   [5]: http://semver.org/
+   [6]: http://chneukirchen.github.com/rps/
+   [7]: https://github.com/bbatsov/ruby-style-guide
+   [8]: http://weblog.rubyonrails.org/2009/9/1/gem-packaging-best-practices
+
+Additional facts:
+
+* Written purely in Ruby.
+* Intended to be used with Ruby 1.9.2 or compatible.
+* Extends core classes. This can be disabled through bare mode.
+
+Synopsis
+--------
+
+This documentation defines the public interface of the library. Don't rely
+on elements marked as private. Those should be hidden in the documentation
+by default.
+
+### Loading
+
+In most cases you want to load the library by the following command:
+
+~~~~~ ruby
+require 'namespace_helper'
+~~~~~
+
+In a bundler Gemfile you should use the following:
+
+~~~~~ ruby
+gem 'namespace_helper'
+~~~~~
+
+By default, NamespaceHelper extends the Class and Module classes to allow make
+all classes and modules support the namespace helper methods. Should you really don't want this, use the following:
+
+~~~~~ ruby
+require 'namespace_helper/bare'
+~~~~~
+
+Or for bundler Gemfiles:
+
+~~~~~ ruby
+gem 'namespace_helper', require: 'namespace_helper/bare'
+~~~~~
+
+### Usage
+
+In normal mode, you can now ask every class or module namespace related
+stuff:
+
+~~~~~ ruby
+Process::Status.namespace_components
+# => [Process, Process::Status]
+
+Process::Status.namespace_component_names
+# => ["Process", "Process::Status"]
+
+Process::Status.unprefixed_namespace_component_names
+# => ["Process", "Status"]
+~~~~~
+
+See {Aef::NamespaceHelper::ClassMethods} for a list of available methods.
+
+If you're using the bare mode, you have to manually extend a class or module
+for which you require namespace information:
+
+~~~~~ ruby
+File::Constants.extend(Aef::NamespaceHelper::ClassMethods)
+
+File::Constants.unprefixed_name
+# => "Constants"
+
+File::Constants.namespace_parent
+# => File
+
+File::Constants.namespace_parent_name
+# => "File"
+~~~~~
+
+Requirements
+------------
+
+None
+
+Installation
+------------
+
+On *nix systems you may need to prefix the command with sudo to get root
+privileges.
+
+### High security (recommended)
+
+There is a high security installation option available through rubygems. It is
+highly recommended over the normal installation, although it may be a bit less
+comfortable. To use the installation method, you will need my public key, which
+I use for cryptographic signatures on all my gems. You can find the public key
+here: http://aef.name/crypto/aef-gem.pem
+
+Add the key to your rubygems' trusted certificates by the following command:
+
+    gem cert --add aef-gem.pem
+
+Now you can install the gem while automatically verifying it's signature by the
+following command:
+
+    gem install namespace_helper -P HighSecurity
+
+Please notice that you may need other keys for dependent libraries, so you may
+have to install dependencies manually.
+
+### Normal
+
+    gem install namespace_helper
+
+### Automated testing
+
+Go into the root directory of the installed gem and run the following command
+to fetch all development dependencies:
+
+    bundle
+
+Afterwards start the test runner:
+
+    rake spec
+
+If something goes wrong you should be noticed through failing examples.
+
+Development
+-----------
+
+This software is developed in the source code management system git hosted
+at github.com. You can download the most recent sourcecode through the
+following command:
+
+    git clone https://github.com/aef/namespace_helper.git
+
+Help on making this software better is always very appreciated. If you want
+your changes to be included in the official release, please clone my project
+on github.com, create a named branch to commit and push your changes in and
+send me a pull request afterwards.
+
+Please make sure to write tests for your changes so that I won't break them
+when changing other things on the library. Also notice that I can't promise
+to include your changes before reviewing them.
+
+License
+-------
+
+Copyright Alexander E. Fischer <aef@raxys.net>, 2012
+
+This file is part of NamespaceHelper.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

data/Rakefile

@@ -0,0 +1,47 @@
+# encoding: UTF-8
+=begin
+Copyright Alexander E. Fischer <aef@raxys.net>, 2012
+
+This file is part of NamespaceHelper.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+require 'rake'
+require 'pathname'
+require 'bundler/gem_tasks'
+require 'yard'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new
+
+YARD::Rake::YardocTask.new('doc')
+
+desc "Removes temporary project files"
+task :clean do
+  %w{doc coverage pkg .yardoc .rbx}.map{|name| Pathname.new(name) }.each do |path|
+    path.rmtree if path.exist?
+  end
+
+  Pathname.glob('*.gem').each &:delete
+  Pathname.glob('**/*.rbc').each &:delete
+end
+
+desc "Opens an interactive console with the library loaded"
+task :console do
+  require 'pry'
+  require 'namespace_helper'
+  Pry.start
+end
+
+task :default => :spec

data/lib/aef/namespace_helper.rb

@@ -0,0 +1,159 @@
+# encoding: UTF-8
+=begin
+Copyright Alexander E. Fischer <aef@raxys.net>, 2012
+
+This file is part of NamespaceHelper.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+# Namespace for projects of Alexander E. Fischer <aef@raxys.net>.
+# 
+# If you want to be able to simply type Example instead of Aef::Example to
+# address classes in this namespace simply write the following before using the
+# classes.
+#
+# @example Including the namespace
+#   include Aef
+# @author Alexander E. Fischer
+module Aef
+
+  # This module is intended to be included into the Class and/or Module class
+  # to make namespace helper methods available in all classes/modules.
+  # 
+  # @see Aef::NamespaceHelper::ClassMethods
+  module NamespaceHelper
+  
+    # The current library version
+    VERSION = '1.0.0'.freeze
+
+    protected
+
+    # This magic method is automatically called when NamespaceHelper is
+    # included into a class/module to extend Aef::NamespaceHelper::ClassMethods
+    # into the same class/module.
+    def self.included(klass)
+      klass.extend(ClassMethods)
+    end
+
+    # This mixin module is intended to extend a single class/module object to
+    # make the helper methods only available on that specific class/module.
+    # 
+    # @example
+    #   First::Second.extend(Aef::NamespaceHelper::ClassMethods)
+    #   First::Second.respond_to?(:unprefixed_name) # => true
+    # @see Aef::NamespaceHelper
+    module ClassMethods
+
+      # The name of the class/module itself, without any namespacing.
+      #
+      # @return [String] The unprefixed name of the class/module itself
+      # @since 1.0.0
+      # @example
+      #   First::Second::Third.unprefixed_name # => "Third"
+      def unprefixed_name
+        unprefixed_namespace_component_names.last
+      end
+
+      # Lists all namespace components' unprefixed names.
+      #
+      # @return [Array<String>] All namespace components' unprefixed names.
+      #   Ordered, so the class/module itself will be the last element
+      # @since 1.0.0
+      # @note This will not reference the class/module objects and thus won't
+      #   trigger autoloading
+      # @example
+      #   First::Second::Third.unprefixed_namespace_component_names
+      #   # => ["First", "Second", "Third"]
+      def unprefixed_namespace_component_names
+        if self.name.nil? || self.name == ''
+          []
+        else
+          self.name.split('::')
+        end
+      end
+      
+      # Lists all namespace components' names.
+      #
+      # @return [Array<String>] All namespace components' names. Ordered, so
+      #   the class/module itself will be the last element
+      # @since 1.0.0
+      # @note This will not reference the class/module objects and thus won't
+      #   trigger autoloading
+      # @example
+      #   First::Second::Third.namespace_component_names
+      #   # => ["First", "First::Second", "First::Second::Third"]
+      def namespace_component_names
+        if self.name.nil? || self.name == ''
+          []
+        else
+          unprefixed_names = unprefixed_namespace_component_names
+        
+          names = []
+
+          while current_name = unprefixed_names.pop
+            current_full_name = (unprefixed_names + [current_name]).join('::')
+            names.unshift(current_full_name)
+          end
+          
+          names
+        end
+      end
+      
+      # Lists all namespace components.
+      #
+      # @return [Array<Class, Module>] All namespace components. Ordered, so
+      #   the class/module itself will be the last element.
+      # @since 1.0.0
+      # @example
+      #   First::Second::Third.namespace_component_names
+      #   # => [First, First::Second, First::Second::Third]
+      def namespace_components
+        components = []
+        
+        unprefixed_names = unprefixed_namespace_component_names
+        current_component = Object
+          
+        while current_name = unprefixed_names.shift
+          current_component = current_component.const_get(current_name)
+          components << current_component
+        end
+        
+        components
+      end
+
+      # The name of component in the namespace which encapsulates this class/module.
+      #
+      # @return [String] The name of the parent namespace component
+      # @since 1.0.0
+      # @note This will not reference the class/module objects and thus won't trigger autoloading
+      # @example
+      #   First::Second::Third.namespace_parent
+      #   # => First::Second
+      def namespace_parent_name
+        namespace_component_names[-2]
+      end
+
+      # The component in the namespace which encapsulates this class/module.
+      #
+      # @return [Class, Module] The parent namespace component
+      # @since 1.0.0
+      # @example
+      #   First::Second::Third.namespace_parent
+      #   # => First::Second
+      def namespace_parent
+        namespace_components[-2]
+      end
+    end
+  end
+end

data/lib/namespace_helper/bare.rb

@@ -0,0 +1,20 @@
+# encoding: UTF-8
+=begin
+Copyright Alexander E. Fischer <aef@raxys.net>, 2012
+
+This file is part of NamespaceHelper.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+require 'aef/namespace_helper'

data/lib/namespace_helper.rb

@@ -0,0 +1,24 @@
+# encoding: UTF-8
+=begin
+Copyright Alexander E. Fischer <aef@raxys.net>, 2012
+
+This file is part of NamespaceHelper.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+require 'aef/namespace_helper'
+
+[Class, Module].each do |object|
+  object.method(:include).call(Aef::NamespaceHelper::ClassMethods)
+end

data/namespace_helper.gemspec

@@ -0,0 +1,57 @@
+# encoding: UTF-8
+=begin
+Copyright Alexander E. Fischer <aef@raxys.net>, 2012
+
+This file is part of NamespaceHelper.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+$LOAD_PATH << 'lib'
+
+require 'namespace_helper/bare'
+
+Gem::Specification.new do |s|
+  s.name        = 'namespace_helper'
+  s.version     = Aef::NamespaceHelper::VERSION.dup
+  s.authors     = ['Alexander E. Fischer']
+  s.email       = ['aef@raxys.net']
+  s.homepage    = 'http://github.com/aef/namespace_helper'
+  s.license     = 'ISC'
+  s.summary     = 'Helper methods for class/module namespace handling'
+  s.description = <<-DESCRIPTION
+NamespaceHelper provides a module with methods to ease namespace handling.
+For example getting the unprefixed name, the namespace parent or a list of
+namespace components of a class or module.
+  DESCRIPTION
+
+  s.rubyforge_project = nil
+  s.has_rdoc          = 'yard'
+  s.extra_rdoc_files  = ['HISTORY.md', 'LICENSE.md']
+
+  s.files         = `git ls-files`.lines.map(&:chomp)
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.lines.map(&:chomp)
+  s.executables   = `git ls-files -- bin/*`.lines.map{|f| File.basename(f.chomp) }
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency('bundler', '~> 1.0.21')
+  s.add_development_dependency('rake', '~> 0.9.2')
+  s.add_development_dependency('rspec', '~> 2.6.0')
+  s.add_development_dependency('simplecov', '~> 0.5.4')
+  s.add_development_dependency('pry', '~> 0.9.8')
+  s.add_development_dependency('yard', '~> 0.7.5')
+  s.add_development_dependency('maruku', '~> 0.6.0')
+
+  s.cert_chain = "#{ENV['GEM_CERT_CHAIN']}".split(':')
+  s.signing_key = ENV['GEM_SIGNING_KEY']
+end

data/spec/aef/namespace_helper_spec.rb

@@ -0,0 +1,281 @@
+# encoding: UTF-8
+=begin
+Copyright Alexander E. Fischer <aef@raxys.net>, 2012
+
+This file is part of NamespaceHelper.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+require 'spec_helper'
+require 'namespace_helper/bare'
+
+describe Aef::NamespaceHelper do
+  before(:all) do
+    samples = [
+      Class.new, Module.new,
+      Aef::NamespaceHelper::SomeClass = Class.new,
+      Aef::NamespaceHelper::SomeClass::SomeModule = Module.new,
+      Aef::NamespaceHelper::OtherModule = Module.new,
+      Aef::NamespaceHelper::OtherModule::OtherClass = Class.new,
+      AefNamespaceHelperParentlessClass = Class.new,
+      AefNamespaceHelperParentlessModule = Module.new
+    ]
+
+    samples.each do |sample|
+      sample.extend(Aef::NamespaceHelper::ClassMethods)
+    end
+
+    @anonymous_class  = samples[0]
+    @anonymous_module = samples[1]
+  end
+
+  describe "unprefixed name" do
+    it "should be nil for an anonymous class" do
+      @anonymous_class.unprefixed_name.should be_nil
+    end
+
+    it "should be nil for an anonymous module" do
+      @anonymous_module.unprefixed_name.should be_nil
+    end
+
+    it "should be SomeClass for Aef::NamespaceHelper::SomeClass" do
+      Aef::NamespaceHelper::SomeClass.
+        unprefixed_name.should == 'SomeClass'
+    end
+
+    it "should be SomeModule for Aef::NamespaceHelper::SomeClass::SomeModule" do
+      Aef::NamespaceHelper::SomeClass::SomeModule.
+        unprefixed_name.should == 'SomeModule'
+    end
+
+    it "should be OtherModule for Aef::NamespaceHelper::OtherModule" do
+      Aef::NamespaceHelper::OtherModule.
+        unprefixed_name.should == 'OtherModule'
+    end
+
+    it "should be OtherClass for Aef::NamespaceHelper::OtherModule::OtherClass" do
+      Aef::NamespaceHelper::OtherModule::OtherClass.
+        unprefixed_name.should == 'OtherClass'
+    end
+  end
+
+  describe "unprefixed_namespace_component_names" do
+    it "should be an empty array for an anonymous class" do
+      @anonymous_class.unprefixed_namespace_component_names.should == []
+    end
+
+    it "should be an emtpy array for an anonymous module" do
+      @anonymous_module.unprefixed_namespace_component_names.should == []
+    end
+
+    it "should list all unprefixed namespace component names for Aef::NamespaceHelper::SomeClass" do
+      Aef::NamespaceHelper::SomeClass.unprefixed_namespace_component_names.should ==
+        ['Aef', 'NamespaceHelper', 'SomeClass']
+    end
+
+    it "should list all unprefixed namespace component names for Aef::NamespaceHelper::SomeClass::SomeModule" do
+      Aef::NamespaceHelper::SomeClass::SomeModule.unprefixed_namespace_component_names.should ==
+        ['Aef', 'NamespaceHelper', 'SomeClass', 'SomeModule']
+    end
+
+    it "should list all unprefixed namespace component names for Aef::NamespaceHelper::OtherModule" do
+      Aef::NamespaceHelper::OtherModule.unprefixed_namespace_component_names.should ==
+        ['Aef', 'NamespaceHelper', 'OtherModule']
+    end
+
+    it "should list all unprefixed namespace component names for Aef::NamespaceHelper::OtherModule::OtherClass" do
+      Aef::NamespaceHelper::OtherModule::OtherClass.unprefixed_namespace_component_names.should ==
+        ['Aef', 'NamespaceHelper', 'OtherModule', 'OtherClass']
+    end
+  end
+  
+  describe "namespace_component_names" do
+    it "should be an empty array for an anonymous class" do
+      @anonymous_class.namespace_component_names.should == []
+    end
+
+    it "should be an emtpy array for an anonymous module" do
+      @anonymous_module.namespace_component_names.should == []
+    end
+
+    it "should list all namespace component names for Aef::NamespaceHelper::SomeClass" do
+      Aef::NamespaceHelper::SomeClass.namespace_component_names.should == [
+        'Aef',
+        'Aef::NamespaceHelper',
+        'Aef::NamespaceHelper::SomeClass'
+      ]
+    end
+
+    it "should list all namespace component names for Aef::NamespaceHelper::SomeClass::SomeModule" do
+      Aef::NamespaceHelper::SomeClass::SomeModule.namespace_component_names.should == [
+        'Aef',
+        'Aef::NamespaceHelper',
+        'Aef::NamespaceHelper::SomeClass',
+        'Aef::NamespaceHelper::SomeClass::SomeModule'
+      ]
+    end
+
+    it "should list all namespace component names for Aef::NamespaceHelper::OtherModule" do
+      Aef::NamespaceHelper::OtherModule.namespace_component_names.should == [
+        'Aef',
+        'Aef::NamespaceHelper',
+        'Aef::NamespaceHelper::OtherModule'
+      ]
+    end
+
+    it "should list all namespace component names for Aef::NamespaceHelper::OtherModule::OtherClass" do
+      Aef::NamespaceHelper::OtherModule::OtherClass.namespace_component_names.should == [
+        'Aef',
+        'Aef::NamespaceHelper',
+        'Aef::NamespaceHelper::OtherModule',
+        'Aef::NamespaceHelper::OtherModule::OtherClass',        
+      ]
+    end
+  end
+  
+  describe "namespace_components" do
+    it "should be an empty array for an anonymous class" do
+      @anonymous_class.namespace_components.should == []
+    end
+
+    it "should be an emtpy array for an anonymous module" do
+      @anonymous_module.namespace_components.should == []
+    end
+
+    it "should list all namespace component names for Aef::NamespaceHelper::SomeClass" do
+      Aef::NamespaceHelper::SomeClass.namespace_components.should == [
+        Aef,
+        Aef::NamespaceHelper,
+        Aef::NamespaceHelper::SomeClass
+      ]
+    end
+
+    it "should list all namespace component names for Aef::NamespaceHelper::SomeClass::SomeModule" do
+      Aef::NamespaceHelper::SomeClass::SomeModule.namespace_components.should == [
+        Aef,
+        Aef::NamespaceHelper,
+        Aef::NamespaceHelper::SomeClass,
+        Aef::NamespaceHelper::SomeClass::SomeModule
+      ]
+    end
+
+    it "should list all namespace component names for Aef::NamespaceHelper::OtherModule" do
+      Aef::NamespaceHelper::OtherModule.namespace_components.should == [
+        Aef,
+        Aef::NamespaceHelper,
+        Aef::NamespaceHelper::OtherModule
+      ]
+    end
+
+    it "should list all namespace component names for Aef::NamespaceHelper::OtherModule::OtherClass" do
+      Aef::NamespaceHelper::OtherModule::OtherClass.namespace_components.should == [
+        Aef,
+        Aef::NamespaceHelper,
+        Aef::NamespaceHelper::OtherModule,
+        Aef::NamespaceHelper::OtherModule::OtherClass
+      ]
+    end
+  end
+  
+  describe "namespace_parent_name" do
+    it "should be nil for an anonymous class" do
+      @anonymous_class.namespace_parent_name.should == nil
+    end
+
+    it "should be nil for an anonymous module" do
+      @anonymous_module.namespace_parent_name.should == nil
+    end
+
+    it "should be nil if a class has no namespace parent" do
+      AefNamespaceHelperParentlessClass.namespace_parent.should == nil
+    end
+    
+    it "should be nil if a module has no namespace parent" do
+      AefNamespaceHelperParentlessModule.namespace_parent.should == nil
+    end
+
+    it "should be Aef::NamespaceHelper for Aef::NamespaceHelper::SomeClass" do
+      Aef::NamespaceHelper::SomeClass.
+        namespace_parent_name.should == 'Aef::NamespaceHelper'
+    end
+
+    it "should be Aef::NamespaceHelper::SomeClass for Aef::NamespaceHelper::SomeClass::SomeModule" do
+      Aef::NamespaceHelper::SomeClass::SomeModule.
+        namespace_parent_name.should == 'Aef::NamespaceHelper::SomeClass'
+    end
+
+    it "should be Aef::NamespaceHelper for Aef::NamespaceHelper::OtherModule" do
+      Aef::NamespaceHelper::OtherModule.
+        namespace_parent_name.should == 'Aef::NamespaceHelper'
+    end
+
+    it "should be Aef::NamespaceHelper::OtherModule for Aef::NamespaceHelper::OtherModule::OtherClass" do
+      Aef::NamespaceHelper::OtherModule::OtherClass.
+        namespace_parent_name.should == 'Aef::NamespaceHelper::OtherModule'
+    end
+  end
+  
+  describe "namespace_parent" do
+    it "should be nil for an anonymous class" do
+      @anonymous_class.namespace_parent.should == nil
+    end
+
+    it "should be nil for an anonymous module" do
+      @anonymous_module.namespace_parent.should == nil
+    end
+    
+    it "should be nil if a class has no namespace parent" do
+      AefNamespaceHelperParentlessClass.namespace_parent.should == nil
+    end
+    
+    it "should be nil if a module has no namespace parent" do
+      AefNamespaceHelperParentlessModule.namespace_parent.should == nil
+    end
+
+    it "should be Aef::NamespaceHelper for Aef::NamespaceHelper::SomeClass" do
+      Aef::NamespaceHelper::SomeClass.
+        namespace_parent.should == Aef::NamespaceHelper
+    end
+
+    it "should be Aef::NamespaceHelper::SomeClass for Aef::NamespaceHelper::SomeClass::SomeModule" do
+      Aef::NamespaceHelper::SomeClass::SomeModule.
+        namespace_parent.should == Aef::NamespaceHelper::SomeClass
+    end
+
+    it "should be Aef::NamespaceHelper for Aef::NamespaceHelper::OtherModule" do
+      Aef::NamespaceHelper::OtherModule.
+        namespace_parent.should == Aef::NamespaceHelper
+    end
+
+    it "should be Aef::NamespaceHelper::OtherModule for Aef::NamespaceHelper::OtherModule::OtherClass" do
+      Aef::NamespaceHelper::OtherModule::OtherClass.
+        namespace_parent.should == Aef::NamespaceHelper::OtherModule
+    end
+  end
+  
+  describe "core extension" do
+    it "should add the helper methods to all classes and modules" do
+      lambda {
+        require 'namespace_helper'
+      }.should change{
+        [ Integer.respond_to?(:unprefixed_namespace_component_names),
+          Float.respond_to?(:unprefixed_name),
+          Object.respond_to?(:namespace_component_names),
+          Regexp.respond_to?(:namespace_components),
+          File.respond_to?(:namespace_parent_name),
+          String.respond_to?(:namespace_parent) ].all?
+      }.from(false).to(true)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,26 @@
+# encoding: UTF-8
+=begin
+Copyright Alexander E. Fischer <aef@raxys.net>, 2012
+
+This file is part of NamespaceHelper.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+=end
+
+unless defined?(Rubinius)
+  require 'simplecov'
+  SimpleCov.start
+end
+
+require 'rspec'
+require 'pry'

data.tar.gz.sig

@@ -0,0 +1,4 @@
+X8��3����T�g�g��-���]�d	���‹+g�R{n�*	`�7�&�����s�S׻�ה4ُ�~�GL�Yr��O܍�	��e��^`�p��@�U%���s�#|��$3G�,QN'���n6�kaMU@FKdj{1�2���0�qeJU�k��р-����	�PR�W�fPq^
n!VԳ�\�W���
+��B��k���{�ܞ��~S��M���Y����3���
+Ȳ�Hm���.ζ
+���~_�~�ͺ

metadata

@@ -0,0 +1,187 @@
+--- !ruby/object:Gem::Specification
+name: namespace_helper
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Alexander E. Fischer
+autorequire: 
+bindir: bin
+cert_chain:
+- ! '-----BEGIN CERTIFICATE-----
+
+  MIIDKDCCAhCgAwIBAgIBADANBgkqhkiG9w0BAQUFADA6MQwwCgYDVQQDDANhZWYx
+
+  FTATBgoJkiaJk/IsZAEZFgVyYXh5czETMBEGCgmSJomT8ixkARkWA25ldDAeFw0w
+
+  OTAyMjUyMDM5MDhaFw0xMDAyMjUyMDM5MDhaMDoxDDAKBgNVBAMMA2FlZjEVMBMG
+
+  CgmSJomT8ixkARkWBXJheHlzMRMwEQYKCZImiZPyLGQBGRYDbmV0MIIBIjANBgkq
+
+  hkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAoYtj0qad5/MpbdttITzBH0h1SNe6eO7R
+
+  7qVeqNYu6qDQAQ0rYc0JhubJCWYrZEJorHEBhUFU6cdQgQOs78wiJaDgkeU7YfXB
+
+  q2l125kJ8aHkA1ukrK2/DRzp2AHEmzxHIYpXV5/63h+NWjCP+uKvTELYsotS2MKt
+
+  3d43E0QajsPZu2ZuNFwkroqeue872gMHUldGOVy5WtSd9ajw2xI/CociY6746dL+
+
+  pYriV3QaYtR/ezeaLpKBLsc5T1UQ07t7Xs7mI281tdmRvpLdP5dQhjzInfio0CJv
+
+  1Pf5bZUjGG0K9RW2Gb/tGPSYEETiLMubjH61OwBooXKiWR5cs4/1BQIDAQABozkw
+
+  NzAJBgNVHRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQUSYvjhG2EWnR5kx5l
+
+  DAewXCkJOVEwDQYJKoZIhvcNAQEFBQADggEBAB2ryDbU4bQtnunKv/AXq4CuO3LS
+
+  kik9Xhye8E/5dTcsgitCZJXAqx0rHcK0u2EHnjA5CDcdF5JB7XgSvRrQkFWoW/9K
+
+  lCB4ih+sB2AI2IUiYBeoCGctXdBQ020prqop/oTQEudzFk/gyQ686lp06HdLRt+O
+
+  HoQjTIab8vmfgIubjPdIRzokMfHbelvhLi+mQfWVghRhs2jpEfdXbL0w5nNw+trp
+
+  rO70Dw59hduDUOpgpxew+PLbs4vP1tb1QKPG+39C+PZtosbbf1fai0hqYV1txMCx
+
+  55akF+N8NbO6tpVDy6TMagqa10LfEpiQH6dvDHe/xdAqYOCrXKpmqzwu2PI=
+
+  -----END CERTIFICATE-----
+
+'
+date: 2012-02-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &10350060 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.21
+  type: :development
+  prerelease: false
+  version_requirements: *10350060
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &10348240 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+  type: :development
+  prerelease: false
+  version_requirements: *10348240
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &10347220 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.6.0
+  type: :development
+  prerelease: false
+  version_requirements: *10347220
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: &10361840 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.5.4
+  type: :development
+  prerelease: false
+  version_requirements: *10361840
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: &10357220 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.8
+  type: :development
+  prerelease: false
+  version_requirements: *10357220
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: &10356380 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.5
+  type: :development
+  prerelease: false
+  version_requirements: *10356380
+- !ruby/object:Gem::Dependency
+  name: maruku
+  requirement: &10370880 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+  type: :development
+  prerelease: false
+  version_requirements: *10370880
+description: ! 'NamespaceHelper provides a module with methods to ease namespace handling.
+
+  For example getting the unprefixed name, the namespace parent or a list of
+
+  namespace components of a class or module.
+
+'
+email:
+- aef@raxys.net
+executables: []
+extensions: []
+extra_rdoc_files:
+- HISTORY.md
+- LICENSE.md
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- .yardopts
+- Gemfile
+- Gemfile.lock
+- HISTORY.md
+- LICENSE.md
+- README.md
+- Rakefile
+- lib/aef/namespace_helper.rb
+- lib/namespace_helper.rb
+- lib/namespace_helper/bare.rb
+- namespace_helper.gemspec
+- spec/aef/namespace_helper_spec.rb
+- spec/spec_helper.rb
+homepage: http://github.com/aef/namespace_helper
+licenses:
+- ISC
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Helper methods for class/module namespace handling
+test_files: []
+has_rdoc: yard