namespaces 0.0.2 → 0.0.3

data/README.MD

@@ -0,0 +1,32 @@
+## EXAMPLE
+
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+
+require File.expand_path('../../lib/namespaces.rb', __FILE__)
+
+module A
+  module B
+    module C
+      class X
+        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 [A::B::C, A::B, A], A::B::C::X.namespaces
+  end
+  
+  should "return modules array when called as instance method" do
+    assert_equal [A::B::C, A::B, A], A::B::C::X.new.namespaces
+  end
+end
+
+
+## USE CASES WHEN ONE MIGHT NEED IT
+

data/Rakefile

@@ -1,6 +1,5 @@
 require 'rake'
 require 'rake/testtask'
-require 'rake/rdoctask'
 
 Rake::TestTask.new do |t|
   t.libs << "test"
@@ -8,17 +7,4 @@ Rake::TestTask.new do |t|
   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
+task :default => "test"

data/examples/gdata-api.rb

@@ -1,27 +1,22 @@
-    require 'rubygems'
-    require 'namespaces'
+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
+module Base
+  class Service
+    include Namespaces
+    def atom_header
+      header = {}
+      header["GData-Version"] = namespaces.first::API_VERSION
+      header
     end
+  end
+end
 
-    module GData
-      XML_NAMESPACE = 'http://schemas.google.com/g/2005'
-      class Entry < Atom::Entry; end
-      class Feed < Atom::Feed; end
-    end
 
+module Contacts
+  API_VERSION = "1.0"
+  class Service < Base::Service
+  end
+end
 
-    module GCalendar
-      XML_NAMESPACE = "http://schemas.google.com/gCal/2005"
-      class Entry < GData::Entry; end
-      class Feed < GData::Feed; end
-    end
+puts Contacts::Service.new.atom_header.inspect # -> {"GData-Version"=>"1.0"}

data/lib/namespaces.rb

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

data/test/test.rb

@@ -2,12 +2,12 @@ require 'rubygems'
 require 'test/unit'
 require 'shoulda'
 
-require File.expand_path(File.dirname(__FILE__)+ '/../lib/namespaces')
+require File.expand_path('../../lib/namespaces.rb', __FILE__)
 
-module One
-  module Two
-    module Three
-      class A
+module A
+  module B
+    module C
+      class X
         include Namespaces
         extend Namespaces
       end
@@ -17,9 +17,10 @@ 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
+    assert_equal [A::B::C, A::B, A], A::B::C::X.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
+    assert_equal [A::B::C, A::B, A], A::B::C::X.new.namespaces
   end
 end

metadata

@@ -1,71 +1,87 @@
 --- !ruby/object:Gem::Specification 
 name: namespaces
 version: !ruby/object:Gem::Version 
+  hash: 25
   prerelease: false
   segments: 
   - 0
   - 0
-  - 2
-  version: 0.0.2
+  - 3
+  version: 0.0.3
 platform: ruby
 authors: 
-- Fedor Kocherga
+- Aleksandr Furmanov
 autorequire: 
 bindir: bin
 cert_chain: []
 
-date: 2010-07-04 00:00:00 -05:00
+date: 2010-09-06 00:00:00 -05:00
 default_executable: 
-dependencies: []
-
-description: 
-email: fkocherga@gmail.com
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: shoulda
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+description: Get lexical context of self as array of modules
+email: 
+- aleksandr.furmanov@gmail.com
 executables: []
 
 extensions: []
 
-extra_rdoc_files: 
-- README.html
-- README.markdown
+extra_rdoc_files: []
+
 files: 
-- .gitignore
-- README.markdown
 - Rakefile
-- VERSION
-- examples/gdata-api.rb
+- README.MD
 - lib/namespaces.rb
-- namespaces.gemspec
 - test/test.rb
-- README.html
+- examples/gdata-api.rb
 has_rdoc: true
-homepage: http://github.com/fkocherga/namespaces
+homepage: http://github.com/afurmanov/namespaces
 licenses: []
 
 post_install_message: 
-rdoc_options: 
-- --charset=UTF-8
+rdoc_options: []
+
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 3
       segments: 
       - 0
       version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
+      hash: 23
       segments: 
-      - 0
-      version: "0"
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
 requirements: []
 
 rubyforge_project: 
-rubygems_version: 1.3.6
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
-summary: "Gives access to enclosing modules through #namespaces."
-test_files: 
-- test/test.rb
+summary: Get lexical context of self as array of modules
+test_files: []
+

data/.gitignore

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

data/README.markdown

@@ -1,46 +0,0 @@
-## SYNOPSIS
-
-Provides *#namespaces* method returning list of modules a class declared within. (For explanations why one might ever need this, please see below):
-
-    module One
-      module Two
-        module Three
-          class A
-            include Namespaces
-            extend Namespaces
-          end
-        end
-      end
-    end
-
-    assert_equal [One, One::Two, One::Two::Three], One::Two::Three::A.namespaces
-    assert_equal [One, One::Two, One::Two::Three], One::Two::Three::A.new.namespaces
-
-## Raison d'etre
-
-Modules are two fold constructs in Ruby - they are namespaces and mixins. Sometimes when several 
-classes get placed under one namespace (in one module in Ruby) and they share something 
-it makes a perfect sense to put that thing they share in the same namespace. For example:
-
-    module A
-      COMMON_CONST = "value common for all classes in A"
-      class B; puts COMMON_CONST; end
-      class C; puts COMMON_CONST; end
-    end
-
-Now imagine if we building a library where that approach is common, and we want to write some
-generic code taking a class as an argument and  printing a COMMON_CONST for module where that 
-class is defined:
-
-    def generic_code(klass)
-      # How to do this? - klass.what? 
-    end
-
-In Ruby there is no way to ask class: "Please give modules where you defined in". The *namespaces* gem
-helps to bridge the gap:
-
-    def generic_code(klass)
-      puts klass.namespaces[-1].COMMON_CONST
-    end
-
-

data/VERSION

@@ -1 +0,0 @@
-0.0.2

data/namespaces.gemspec

@@ -1,47 +0,0 @@
-# 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.2"
-
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Fedor Kocherga"]
-  s.date = %q{2010-07-04}
-  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.6}
-  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
-