police-vminfo 0.0.1 → 0.0.2

data/Gemfile

@@ -1,10 +1,9 @@
-source :rubygems
+source 'https://rubygems.org'
 
 group :development do
-  gem 'bundler', '>= 1.1.0'
-  gem 'jeweler', '>= 1.8.3'
-  gem 'minitest', '>= 2.11.2'
-  gem 'rdoc', '>= 3.12'
-  gem 'simplecov', '>= 0.6.1'
-  gem 'yard', '>= 0.7'
+  gem 'bundler', '>= 1.3.5'
+  gem 'jeweler', '>= 1.8.4'
+  gem 'minitest', '>= 4.7.4'
+  gem 'simplecov', '>= 0.7.1'
+  gem 'yard', '>= 0.8.6.1'
 end

data/Gemfile.lock

@@ -1,31 +1,30 @@
 GEM
-  remote: http://rubygems.org/
+  remote: https://rubygems.org/
   specs:
     git (1.2.5)
-    jeweler (1.8.3)
+    jeweler (1.8.4)
       bundler (~> 1.0)
       git (>= 1.2.5)
       rake
       rdoc
-    json (1.6.6)
-    minitest (2.11.4)
-    multi_json (1.2.0)
-    rake (0.9.2.2)
-    rdoc (3.12)
+    json (1.7.7)
+    minitest (4.7.4)
+    multi_json (1.7.3)
+    rake (10.0.4)
+    rdoc (4.0.1)
       json (~> 1.4)
-    simplecov (0.6.1)
+    simplecov (0.7.1)
       multi_json (~> 1.0)
-      simplecov-html (~> 0.5.3)
-    simplecov-html (0.5.3)
-    yard (0.7.5)
+      simplecov-html (~> 0.7.1)
+    simplecov-html (0.7.1)
+    yard (0.8.6.1)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  bundler (>= 1.1.0)
-  jeweler (>= 1.8.3)
-  minitest (>= 2.11.2)
-  rdoc (>= 3.12)
-  simplecov (>= 0.6.1)
-  yard (>= 0.7)
+  bundler (>= 1.3.5)
+  jeweler (>= 1.8.4)
+  minitest (>= 4.7.4)
+  simplecov (>= 0.7.1)
+  yard (>= 0.8.6.1)

data/VERSION

@@ -1 +1 @@
-0.0.1
+0.0.2

data/lib/police/vminfo/objects.rb

@@ -4,8 +4,8 @@ module VmInfo
   # All loaded Ruby modules, obtained by walking the constants graph.
   #
   # @return [Array<Module>] the Ruby modules that could be discovered by
-  #     searching the constants graph; this should include everything except for
-  #     anonymous (not assigned to constants) classes
+  #     searching the constants graph; this should include everything except
+  #     for anonymous (not assigned to constants) classes
   def self.named_modules
     # NOTE: this is a Set, but we don't want to load the module.
     explored = { Object => true }
@@ -36,13 +36,13 @@ module VmInfo
   # Note that all classes are modules, so this is a subset of named_modules.
   #
   # @return [Array<Module>] the Ruby classes that could be discovered by
-  #     searching the constants graph; this should include everything except for
-  #     anonymous (not assigned to constants) classes
+  #     searching the constants graph; this should include everything except
+  #     for anonymous (not assigned to constants) classes
   def self.named_classes
     named_modules.select { |m| m.kind_of? Class }
   end
-  
-  # All loaded Ruby modules, obtained by querying ObjectSpace. 
+
+  # All loaded Ruby modules, obtained by querying ObjectSpace.
   #
   # Querying ObjectSpace can be painfully slow, especially on non-MRI VMs.
   #
@@ -50,24 +50,24 @@ module VmInfo
   def self.all_modules
     ObjectSpace.each_object(Module).to_a
   end
-  
-  # All loaded Ruby classes, obtained by querying ObjectSpace. 
+
+  # All loaded Ruby classes, obtained by querying ObjectSpace.
   #
   # Querying ObjectSpace can be painfully slow, especially on non-MRI VMs. Note
-  # that all classes are modules, so this is a subset of all_modules. 
+  # that all classes are modules, so this is a subset of all_modules.
   #
   # @return [Array<Classes>] all the Ruby classes
   def self.all_classes
     ObjectSpace.each_object(Class).to_a
   end
-  
+
   # The modules making up the Ruby VM implementation.
   #
   # @return [Array<Module>] the modules that are present in a vanilla Ruby
   #     environment
   def self.core_modules
     return @core_modules if @core_modules
-    
+
     output =
         `#{Gem.ruby} -e 'puts ObjectSpace.each_object(Module).to_a.join("\n")'`
     modules = []
@@ -82,14 +82,14 @@ module VmInfo
         next
       end
     end
-    
+
     @core_modules = modules.freeze
   end
   @core_modules = nil
-  
+
   # The classes making up the Ruby VM implementation.
   #
-  # Note that all classes are modules, so this is a subset of core_modules.  
+  # Note that all classes are modules, so this is a subset of core_modules.
   #
   # @return [Array<Class>] the classes that are present in a vanilla Ruby
   #     environment
@@ -99,11 +99,11 @@ module VmInfo
     @core_classes.freeze
   end
   @core_classes = nil
-  
+
   # All methods defined in a class or module.
   #
   # @param [Module] module_or_class a Class or Module instance
-  # @return [Array<Method, UnboundMethod>] all the class and instance methods
+  # @return [Array<UnboundMethod>] all the class and instance methods
   #     defined by the given Class or Module
   def self.all_methods(module_or_class)
     class_methods(module_or_class) + instance_methods(module_or_class)
@@ -112,8 +112,8 @@ module VmInfo
   # All instance methods defined in a class or module.
   #
   # @param [Module] module_or_class a Class or Module instance
-  # @return [Array<Method, UnboundMethod>] all the instance methods defined by
-  #     the given Class or Module
+  # @return [Array<UnboundMethod>] all the instance methods defined by the
+  #     given Class or Module
   def self.instance_methods(module_or_class)
     module_or_class.instance_methods.tap do |array|
       array.map! { |name| module_or_class.instance_method name }
@@ -123,23 +123,64 @@ module VmInfo
 
   # All class methods defined in a class or module.
   #
-  # Note: the class methods of a class or module are the instance methods of the
-  # class or module's meta-class.
+  # Note: the class methods of a class or module are the instance methods of
+  # the class or module's meta-class.
   #
   # @param [Module] module_or_class a Class or Module instance
-  # @return [Array<Method, UnboundMethod>] all the instance methods defined by
-  #     the given Class or Module
+  # @return [Array<UnboundMethod>] all the instance methods defined by the
+  #     given Class or Module
   def self.class_methods(module_or_class)
     # NOTE: this long-winded approach avoids creating new singleton classes
     method_names = module_or_class.singleton_methods
     return [] if method_names.empty?
     singleton_class = module_or_class.singleton_class
     method_names.tap do |array|
-      array.map! { |name| module_or_class.method name }
+      array.map! { |name| singleton_class.instance_method name }
       array.select! { |method| method.owner == singleton_class }
     end
   end
-  
+
+  # The core instance methods defined in a core class or module.
+  #
+  # @param [Module] module_or_class the module or class whose instance methods
+  #     will be retrieved; should be one of the core modules / classes in the
+  #     Ruby VM
+  # @return [Array<UnboundMethod>] the instance methods defined by the Ruby VM
+  def self.core_instance_methods(module_or_class)
+    output =
+        `#{Gem.ruby} -e 'puts #{module_or_class}.instance_methods.join("\n")'`
+
+    methods = []
+    output.split("\n").each do |name|
+      method = module_or_class.instance_method name.to_sym
+      # TODO(pwnall): consider checking for re-defined core methods
+      methods << method
+    end
+    methods
+  end
+
+  # The core class methods defined in a core class or module.
+  #
+  # @param [Module] module_or_class the module or class whose class methods
+  #     will be retrieved; should be one of the core modules / classes in the
+  #     Ruby VM
+  # @return [Array<UnboundMethod>] the class methods defined by the Ruby VM
+  def self.core_class_methods(module_or_class)
+    output =
+        `#{Gem.ruby} -e 'puts #{module_or_class}.singleton_methods.join("\n")'`
+
+    methods = []
+    method_names = output.split "\n"
+    return [] if method_names.empty?
+    singleton_class = module_or_class.singleton_class
+    output.split("\n").each do |name|
+      method = singleton_class.instance_method name.to_sym
+      # TODO(pwnall): consider checking for re-defined core methods
+      methods << method
+    end
+    methods
+  end
+
   # Resolves the name of a constant into its value.
   #
   # @param [String] name a constant name, potentially including the scope
@@ -157,7 +198,7 @@ module VmInfo
         value.const_missing segment
       end
     end
-    value    
+    value
   end
 end  # namespace VmInfo
 

data/police-vminfo.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "police-vminfo"
-  s.version = "0.0.1"
+  s.version = "0.0.2"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Victor Costan"]
-  s.date = "2012-03-28"
+  s.date = "2013-05-08"
   s.description = "Collects information about the Ruby VM implementation details."
   s.email = "victor@costan.us"
   s.extra_rdoc_files = [
@@ -38,7 +38,7 @@ Gem::Specification.new do |s|
   s.homepage = "http://github.com/pwnall/police-vminfo"
   s.licenses = ["MIT"]
   s.require_paths = ["lib"]
-  s.rubygems_version = "1.8.21"
+  s.rubygems_version = "1.8.23"
   s.summary = "Information about the Ruby VM internals."
 
   if s.respond_to? :specification_version then

data/test/vminfo/objects_test.rb

@@ -7,7 +7,7 @@ describe Police::VmInfo do
   CORE_CLASSES = [Object, Encoding::Converter]
   GEM_CLASSES = [MiniTest::Unit]
   CLASSES = CORE_CLASSES + GEM_CLASSES
-  
+
   describe '#named_modules' do
     let(:result) { Police::VmInfo.named_modules }
     (MODULES + CLASSES).each do |const|
@@ -16,7 +16,7 @@ describe Police::VmInfo do
       end
     end
   end
-  
+
   describe '#named_classes' do
     let(:result) { Police::VmInfo.named_classes }
 
@@ -25,7 +25,7 @@ describe Police::VmInfo do
         result.must_include const
       end
     end
-    
+
     MODULES.each do |const|
       it "does not contain #{const}" do
         result.wont_include const
@@ -40,7 +40,7 @@ describe Police::VmInfo do
         result.must_include const
       end
     end
-    
+
     it 'contains anonymous module' do
       anonymous_module = Module.new
       Police::VmInfo.all_modules.must_include anonymous_module
@@ -51,7 +51,7 @@ describe Police::VmInfo do
       Police::VmInfo.all_modules.must_include anonymous_class
     end
   end
-  
+
   describe '#all_classes' do
     let(:result) { Police::VmInfo.all_classes }
 
@@ -60,7 +60,7 @@ describe Police::VmInfo do
         result.must_include const
       end
     end
-    
+
     MODULES.each do |const|
       it "does not contain #{const}" do
         result.wont_include const
@@ -80,21 +80,21 @@ describe Police::VmInfo do
 
   describe '#core_modules' do
     let(:result) { Police::VmInfo.core_modules }
-    
+
     (CORE_MODULES + CORE_CLASSES).each do |const|
       it "contains #{const}" do
         result.must_include const
       end
     end
-    
+
     (GEM_MODULES + GEM_CLASSES).each do |const|
       it "does not contain #{const}" do
         result.wont_include const
       end
     end
   end
-  
-  describe '#code_classes' do
+
+  describe '#core_classes' do
     let(:result) { Police::VmInfo.core_classes }
 
     (CORE_CLASSES).each do |const|
@@ -102,21 +102,21 @@ describe Police::VmInfo do
         result.must_include const
       end
     end
-    
+
     (CORE_MODULES + GEM_MODULES + GEM_CLASSES).each do |const|
       it "does not contain #{const}" do
         result.wont_include const
       end
     end
-  end    
+  end
 
   def fixture_module
     Module.new do
       include Enumerable
-            
+
       def police_new_module_method; end
       def map; end
-      
+
       def self.dup; end
       def self.police_new_module_class_method; end
     end
@@ -126,20 +126,23 @@ describe Police::VmInfo do
     Class.new String do
       def police_new_method; end
       def length; end
-      
+
       def self.new; end
       def self.police_new_class_method; end
     end
   end
-  
+
   describe "#all_methods" do
     describe 'on the fixture module' do
-      let :method_names do
-        Police::VmInfo.all_methods(fixture_module).map(&:name)
+      let(:methods) { Police::VmInfo.all_methods(fixture_module) }
+      let(:method_names) { methods.map(&:name) }
+
+      it 'returns UnboundMethods' do
+        methods.each { |method| method.must_be_instance_of UnboundMethod }
       end
-      
+
       it 'contains overridden class methods' do
-        method_names.must_include :dup 
+        method_names.must_include :dup
       end
 
       it 'contains new class methods' do
@@ -151,7 +154,7 @@ describe Police::VmInfo do
       end
 
       it 'contains overridden instance methods' do
-        method_names.must_include :map 
+        method_names.must_include :map
       end
 
       it 'contains new instance methods' do
@@ -162,14 +165,17 @@ describe Police::VmInfo do
         method_names.wont_include :select
       end
     end
-    
+
     describe 'on the fixture class' do
-      let :method_names do
-        Police::VmInfo.all_methods(fixture_class).map(&:name)
+      let(:methods) { Police::VmInfo.all_methods(fixture_class) }
+      let(:method_names) { methods.map(&:name) }
+
+      it 'returns UnboundMethods' do
+        methods.each { |method| method.must_be_instance_of UnboundMethod }
       end
-      
+
       it 'contains overridden class methods' do
-        method_names.must_include :new 
+        method_names.must_include :new
       end
 
       it 'contains new class methods' do
@@ -179,9 +185,9 @@ describe Police::VmInfo do
       it 'does not contain inherited class methods' do
         method_names.wont_include :superclass
       end
-      
+
       it 'contains overridden instance methods' do
-        method_names.must_include :length 
+        method_names.must_include :length
       end
 
       it 'contains new instance methods' do
@@ -193,15 +199,18 @@ describe Police::VmInfo do
       end
     end
   end
-  
+
   describe "#class_methods" do
     describe 'on the fixture module' do
-      let :method_names do
-        Police::VmInfo.class_methods(fixture_module).map(&:name)
+      let(:methods) { Police::VmInfo.class_methods(fixture_module) }
+      let(:method_names) { methods.map(&:name) }
+
+      it 'returns UnboundMethods' do
+        methods.each { |method| method.must_be_instance_of UnboundMethod }
       end
-      
+
       it 'contains overridden methods' do
-        method_names.must_include :dup 
+        method_names.must_include :dup
       end
 
       it 'contains new methods' do
@@ -216,14 +225,17 @@ describe Police::VmInfo do
         method_names.wont_include :police_new_module_method
       end
     end
-    
+
     describe 'on the fixture class' do
-      let :method_names do
-        Police::VmInfo.class_methods(fixture_class).map(&:name)
+      let(:methods) { Police::VmInfo.class_methods(fixture_class) }
+      let(:method_names) { methods.map(&:name) }
+
+      it 'returns UnboundMethods' do
+        methods.each { |method| method.must_be_instance_of UnboundMethod }
       end
-      
+
       it 'contains overridden methods' do
-        method_names.must_include :new 
+        method_names.must_include :new
       end
 
       it 'contains new methods' do
@@ -238,16 +250,19 @@ describe Police::VmInfo do
         method_names.wont_include :police_new_method
       end
     end
-  end  
-  
+  end
+
   describe "#instance_methods" do
     describe 'on the fixture module' do
-      let :method_names do
-        Police::VmInfo.instance_methods(fixture_module).map(&:name)
+      let(:methods) { Police::VmInfo.instance_methods(fixture_module) }
+      let(:method_names) { methods.map(&:name) }
+
+      it 'returns UnboundMethods' do
+        methods.each { |method| method.must_be_instance_of UnboundMethod }
       end
-      
+
       it 'contains overridden methods' do
-        method_names.must_include :map 
+        method_names.must_include :map
       end
 
       it 'contains new methods' do
@@ -262,14 +277,17 @@ describe Police::VmInfo do
         method_names.wont_include :police_new_module_class_method
       end
     end
-    
+
     describe 'on the fixture class' do
-      let :method_names do
-        Police::VmInfo.instance_methods(fixture_class).map(&:name)
+      let(:methods) { Police::VmInfo.instance_methods(fixture_class) }
+      let(:method_names) { methods.map(&:name) }
+
+      it 'returns UnboundMethods' do
+        methods.each { |method| method.must_be_instance_of UnboundMethod }
       end
-      
+
       it 'contains overridden methods' do
-        method_names.must_include :length 
+        method_names.must_include :length
       end
 
       it 'contains new methods' do
@@ -285,7 +303,80 @@ describe Police::VmInfo do
       end
     end
   end
-  
+
+  describe "#core_class_methods" do
+    describe 'on Process' do
+      before do
+        module Process
+          def self.not_a_core_method
+          end
+        end
+      end
+      after do
+        module Process
+          class <<self
+            remove_method :not_a_core_method
+          end
+        end
+      end
+
+      let(:methods) { Police::VmInfo.core_class_methods(Process) }
+      let(:method_names) { methods.map(&:name) }
+
+      it 'returns UnboundMethods' do
+        methods.each { |method| method.must_be_instance_of UnboundMethod }
+      end
+
+      it 'contains spawn' do
+        method_names.must_include :spawn
+      end
+
+      it 'does not contain not_a_core_method' do
+        method_names.wont_include :not_a_core_method
+
+        # Ensure that the test setup is correct.
+        Police::VmInfo.class_methods(Process).map(&:name).
+                       must_include :not_a_core_method
+      end
+    end
+  end
+
+  describe "#core_instance_methods" do
+    describe 'on Object' do
+      before do
+        class Object
+          def not_a_core_method
+          end
+        end
+      end
+      after do
+        class Object
+          remove_method :not_a_core_method
+        end
+      end
+
+      let(:methods) { Police::VmInfo.core_instance_methods(Object) }
+      let(:method_names) { methods.map(&:name) }
+
+      it 'returns UnboundMethods' do
+        methods.each { |method| method.must_be_instance_of UnboundMethod }
+      end
+
+      it 'contains ==' do
+        method_names.must_include :==
+      end
+
+      it 'does not contain not_a_core_method' do
+        method_names.wont_include :not_a_core_method
+
+        # Ensure that the test setup is correct.
+        Police::VmInfo.instance_methods(Object).map(&:name).
+                       must_include :not_a_core_method
+      end
+    end
+  end
+
+
   describe "#constantize" do
     it 'works on simple names' do
       Police::VmInfo.constantize('Object').must_equal Object

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: police-vminfo
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-03-28 00:00:00.000000000 Z
+date: 2013-05-08 00:00:00.000000000 Z
 dependencies: []
 description: Collects information about the Ruby VM implementation details.
 email: victor@costan.us
@@ -51,7 +51,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -2040166733346347996
+      hash: 4055543244165856730
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -60,7 +60,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.21
+rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
 summary: Information about the Ruby VM internals.