namespaces 0.0.1

data/.gitignore

@@ -0,0 +1,5 @@
+pkg
+doc
+Manifest
+README.html
+*.log

data/README.markdown

@@ -0,0 +1,45 @@
+## SYNOPSIS
+The purpose of namespace is probably not just to define a scope for classes, 
+I think there are cases when it could be used as placeholder of something 
+shared among these classes. The generic code accessing whatever is shared
+could use #namespaces method, which just returns Array of modules enclosing
+the callee. Here is an example of shared constant XML_NAMESPACE and generic 
+code in Atom::Base class:
+
+    require 'rubygems'
+    require 'namespaces'
+
+    module Atom
+      XML_NAMESPACE = 'http://www.w3.org/2005/Atom'
+      class Base
+        extend Namespaces
+        def self.inherited(klass) # generic code:
+          puts klass.namespaces[-1]::XML_NAMESPACE
+        end
+      end
+      class Entry < Base; end
+      class Feed < Base; end
+    end
+
+    module GData
+      XML_NAMESPACE = 'http://schemas.google.com/g/2005'
+      class Entry < Atom::Entry; end
+      class Feed < Atom::Feed; end
+    end
+
+
+    module GCalendar
+      XML_NAMESPACE = "http://schemas.google.com/gCal/2005"
+      class Entry < GData::Entry; end
+      class Feed < GData::Feed; end
+    end
+
+The output is:
+
+    http://www.w3.org/2005/Atom
+    http://www.w3.org/2005/Atom
+    http://schemas.google.com/g/2005
+    http://schemas.google.com/g/2005
+    http://schemas.google.com/gCal/2005
+    http://schemas.google.com/gCal/2005
+

data/Rakefile

@@ -0,0 +1,24 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList['test/test.rb']
+  t.verbose = true
+end
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |s|
+    s.name = "namespaces"
+    s.summary = "Gives access to enclosing modules through #namespaces."
+    s.email = "fkocherga@gmail.com"
+    s.homepage = "http://github.com/fkocherga/namespaces"
+    s.authors = ["Fedor Kocherga"]
+    s.test_files = ['test/test.rb']
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler not available. Install it with: sudo gem install jeweler"
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/examples/gdata-api.rb

@@ -0,0 +1,27 @@
+    require 'rubygems'
+    require 'namespaces'
+
+    module Atom
+      XML_NAMESPACE = 'http://www.w3.org/2005/Atom'
+      class Base
+        extend Namespaces
+        def self.inherited(klass) # generic code:
+          puts klass.namespaces[-1]::XML_NAMESPACE
+        end
+      end
+      class Entry < Base; end
+      class Feed < Base; end
+    end
+
+    module GData
+      XML_NAMESPACE = 'http://schemas.google.com/g/2005'
+      class Entry < Atom::Entry; end
+      class Feed < Atom::Feed; end
+    end
+
+
+    module GCalendar
+      XML_NAMESPACE = "http://schemas.google.com/gCal/2005"
+      class Entry < GData::Entry; end
+      class Feed < GData::Feed; end
+    end

data/lib/namespaces.rb

@@ -0,0 +1,13 @@
+module Namespaces
+  def namespaces
+    name = self.is_a?(Class) ? self.name : self.class.name
+    namespaces = []
+    name.split(/::/)[0..-2].inject([]) do |parts, name| 
+      fq_name = parts << name
+      namespaces << eval(fq_name.join("::"))
+      fq_name
+    end
+    namespaces
+  end
+end
+

data/namespaces.gemspec

@@ -0,0 +1,47 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{namespaces}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Fedor Kocherga"]
+  s.date = %q{2009-12-28}
+  s.email = %q{fkocherga@gmail.com}
+  s.extra_rdoc_files = [
+    "README.html",
+     "README.markdown"
+  ]
+  s.files = [
+    ".gitignore",
+     "README.markdown",
+     "Rakefile",
+     "VERSION",
+     "examples/gdata-api.rb",
+     "lib/namespaces.rb",
+     "namespaces.gemspec",
+     "test/test.rb"
+  ]
+  s.homepage = %q{http://github.com/fkocherga/namespaces}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Gives access to enclosing modules through #namespaces.}
+  s.test_files = [
+    "test/test.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

data/test/test.rb

@@ -0,0 +1,25 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+
+require File.expand_path(File.dirname(__FILE__)+ '/../lib/namespaces')
+
+module One
+  module Two
+    module Three
+      class A
+        include Namespaces
+        extend Namespaces
+      end
+    end
+  end
+end
+
+class ModulesTest < Test::Unit::TestCase
+  should "return modules array when called as class method" do
+    assert_equal [One, One::Two, One::Two::Three], One::Two::Three::A.namespaces
+  end
+  should "return modules array when called as instance method" do
+    assert_equal [One, One::Two, One::Two::Three], One::Two::Three::A.new.namespaces
+  end
+end

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification 
+name: namespaces
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Fedor Kocherga
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-12-28 00:00:00 -06:00
+default_executable: 
+dependencies: []
+
+description: 
+email: fkocherga@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.html
+- README.markdown
+files: 
+- .gitignore
+- README.markdown
+- Rakefile
+- VERSION
+- examples/gdata-api.rb
+- lib/namespaces.rb
+- namespaces.gemspec
+- test/test.rb
+- README.html
+has_rdoc: true
+homepage: http://github.com/fkocherga/namespaces
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: "Gives access to enclosing modules through #namespaces."
+test_files: 
+- test/test.rb