real 0.1.0

data/.index

@@ -0,0 +1,56 @@
+---
+type: ruby
+revision: 2013
+sources:
+- var
+authors:
+- name: Thomas Sawyer
+  email: transfire@gmail.com
+organizations: []
+requirements:
+- groups:
+  - build
+  development: true
+  name: detroit
+- groups:
+  - test
+  development: true
+  name: qed
+- groups:
+  - test
+  development: true
+  name: ae
+conflicts: []
+alternatives: []
+resources:
+- type: home
+  uri: http://rubyworks.github.com/real
+  label: Homepage
+- type: docs
+  uri: http://rubydoc.info/gems/real
+  label: Documentation
+- type: code
+  uri: http://github.com/rubyworks/real
+  label: Source Code
+- type: mail
+  uri: http://groups.google.com/group/rubyworks-mailinglist
+  label: Mailing List
+repositories:
+- name: upstream
+  scm: git
+  uri: git://github.com/rubyworks/real.git
+categories: []
+load_path:
+- lib
+copyrights:
+- holder: Thomas Sawyer, Rubyworks
+  year: '2009'
+  license: BSD-2-Clause
+created: '2012-12-17'
+summary: Real Reflections on Ruby Object
+title: Real
+version: 0.1.0
+name: real
+description: ! "Real makes true reflection possible for Ruby objects.\nThis can be
+  important to metaprogrammers who need to \nensure they have the true information."
+date: '2012-12-17'

data/.yardopts

@@ -0,0 +1,7 @@
+--title "Real Reflection API"
+--protected
+--private
+lib/
+-
+[A-Z]*.*
+

data/HISTORY.md

@@ -0,0 +1,11 @@
+# RELEASE HISTORY
+
+## 0.1.0 / 2012-12-17
+
+First release of Real, a library to make object reflection dependable
+as is possiblein pure Ruby.
+
+Changes:
+
+* Happy Release Day!!!
+

data/LICENSE.txt

@@ -0,0 +1,22 @@
+BSD-2-Clause License
+
+Redistribution and use in source and binary forms, with or without modification, are
+permitted provided that the following conditions are met:
+
+   1. Redistributions of source code must retain the above copyright notice, this list of
+      conditions and the following disclaimer.
+
+   2. Redistributions in binary form must reproduce the above copyright notice, this list
+      of conditions and the following disclaimer in the documentation and/or other materials
+      provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY Thomas Sawyer ``AS IS'' AND ANY EXPRESS OR IMPLIED
+WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL Thomas Sawyer OR
+CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

data/README.md

@@ -0,0 +1,49 @@
+[![Build Status|align=right|float](https://secure.travis-ci.org/rubyworks/bang.png)](http://travis-ci.org/rubyworks/real)
+
+[Homepage](http://rubyworks.github.com/real) |
+[Support](http://github.com/rubyworks/real/issues) |
+[Source Code](http://github.com/rubyworks/real)
+
+
+# Real
+
+There is a problem in the realm of Ruby metaprogramming --objects
+can be liers. You see, there is no guaruntee that the return value of 
+a method is the "truth". Any object can play dirty tricks.
+
+    string = "Watch this..."
+
+    def string.class
+      nil
+    end
+
+    string.class  #=> nil
+
+We are never going to know what the *real* class of that object is
+by asking it. So what can we do?
+
+I've advocated for explict meta-programming methods be added to Ruby
+for a long time. So far to no avail. Finally, I've decided I could 
+at least provide my own library that provides the functionality.
+
+    require 'real'
+
+    $real.class(string)  #=> String
+
+
+### Installation
+
+Putting the old RubyGems to work:
+
+    $ gem install real
+
+
+### Copyrights
+
+Real is copyrighted open source software.
+
+    Copyright (c) 2012 Rubyworks (BSD-2-Clause)
+
+You many redistribute or modify this work in accordance with the **BSD-2-Clause** license.
+
+See LICENSE.txt for details.

data/demo/01_overview.md

@@ -0,0 +1,31 @@
+# Real
+
+## Overview
+
+There is a problem in the realm of Ruby metaprogramming --objects
+can be liers. You see, there is no guaruntee that the return value of 
+a method is the "truth". Any object can play dirty tricks.
+
+    string = "Watch this..."
+
+    def string.class
+      nil
+    end
+
+    string.class  #=> nil
+
+We are never going to know what the *real* class of that object is
+by asking it. So what can we do?
+
+I've advocated for explict meta-programming methods be added to Ruby
+for a long time. So far to no avail. Finally, I've decided I could 
+at least provide my own library that provides the functionality.
+
+    require 'real'
+
+    $real.class(string)  #=> String
+
+The use of global is just a reference to the `Real` module.
+
+    Real.class(string)  #=> String
+

data/lib/real.rb

@@ -0,0 +1,109 @@
+module Real
+  extend self
+
+  #####################
+  # Object Reflection #
+  #####################
+
+  # Get object's real id.
+  #
+  # @return [Integer]
+  def id(*a, &b)
+    bind_call(Object, :object_id, *a, &b)
+  end
+
+  # Get object's real class.
+  #
+  # @return [Class]
+  def class(*a, &b)
+    bind_call(Object, :class, *a, &b)
+  end
+
+  # Get object's real methods.
+  #
+  # @return [Array<Symbol>]
+  def methods(*a, &b)
+    bind_call(Object, :methods, *a, &b)
+  end
+
+  # Get object's real public methods.
+  #
+  # @return [Array<Symbol>]
+  def public_methods(*a, &b)
+    bind_call(Object, :public_methods, *a, &b)
+  end
+
+  # Get object's real protected methods.
+  #
+  # @return [Array<Symbol>]
+  def protected_methods(*a, &b)
+    bind_call(Object, :protected_methods, *a, &b)
+  end
+
+  # Get object's real private methods.
+  #
+  # @return [Array<Symbol>]
+  def private_methods(*a, &b)
+    bind_call(Object, :private_methods, *a, &b)
+  end
+
+  ###########################
+  # Class/Module Reflection #
+  ###########################
+
+  # Get class/module's real instance methods.
+  #
+  # @return [Array<Symbol>]
+  def instance_methods(*a, &b)
+    bind_call(Module, :instanance_methods, *a, &b)
+  end
+
+  # Get class/module's real public instance methods.
+  #
+  # @return [Array<Symbol>]
+  def public_instance_methods(*a, &b)
+    bind_call(Module, :public_instance_methods, *a, &b)
+  end
+
+  # Get class/module's real protected instance methods.
+  #
+  # @return [Array<Symbol>]
+  def protected_instance_methods(*a, &b)
+    bind_call(Module, :protected_instance_methods, *a, &b)
+  end
+
+  # Get class/module's real private instance methods.
+  #
+  # @return [Array<Symbol>]
+  def private_instance_methods(*a, &b)
+    bind_call(Module, :private_instance_methods, :class, *a, &b)
+  end
+
+private
+
+  def bind_call(c, m, o, *a, &b)
+    im = c.instance_method(m) 
+    im.bind(o).call(*a, &b)    
+  end
+
+  #
+  # Access to project metadata, e.g. VERSION.
+  #
+  def self.const_missing(const_name)
+    name = const_name.to_s.downcase
+    index[name] || super(const_name)
+  end
+
+  #
+  # Load project metadata file.
+  #
+  def self.index
+    @index ||= (
+      require 'yaml'
+      YAML.load_file(File.join(File.dirname(__FILE__), 'real.yml'))
+    )
+  end
+end
+
+$real = Real
+

data/lib/real.yml

@@ -0,0 +1,56 @@
+---
+type: ruby
+revision: 2013
+sources:
+- var
+authors:
+- name: Thomas Sawyer
+  email: transfire@gmail.com
+organizations: []
+requirements:
+- groups:
+  - build
+  development: true
+  name: detroit
+- groups:
+  - test
+  development: true
+  name: qed
+- groups:
+  - test
+  development: true
+  name: ae
+conflicts: []
+alternatives: []
+resources:
+- type: home
+  uri: http://rubyworks.github.com/real
+  label: Homepage
+- type: docs
+  uri: http://rubydoc.info/gems/real
+  label: Documentation
+- type: code
+  uri: http://github.com/rubyworks/real
+  label: Source Code
+- type: mail
+  uri: http://groups.google.com/group/rubyworks-mailinglist
+  label: Mailing List
+repositories:
+- name: upstream
+  scm: git
+  uri: git://github.com/rubyworks/real.git
+categories: []
+load_path:
+- lib
+copyrights:
+- holder: Thomas Sawyer, Rubyworks
+  year: '2009'
+  license: BSD-2-Clause
+created: '2012-12-17'
+summary: Real Reflections on Ruby Object
+title: Real
+version: 0.1.0
+name: real
+description: ! "Real makes true reflection possible for Ruby objects.\nThis can be
+  important to metaprogrammers who need to \nensure they have the true information."
+date: '2012-12-17'

metadata

@@ -0,0 +1,106 @@
+--- !ruby/object:Gem::Specification
+name: real
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Thomas Sawyer
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-12-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: detroit
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: qed
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: ae
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ! "Real makes true reflection possible for Ruby objects.\nThis can be
+  important to metaprogrammers who need to \nensure they have the true information."
+email:
+- transfire@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- HISTORY.md
+- README.md
+files:
+- .index
+- .yardopts
+- demo/01_overview.md
+- lib/real.rb
+- lib/real.yml
+- LICENSE.txt
+- HISTORY.md
+- README.md
+homepage: http://rubyworks.github.com/real
+licenses:
+- BSD-2-Clause
+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.23
+signing_key: 
+specification_version: 3
+summary: Real Reflections on Ruby Object
+test_files: []