police-vminfo 0.0.1

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/Gemfile

@@ -0,0 +1,10 @@
+source :rubygems
+
+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'
+end

data/Gemfile.lock

@@ -0,0 +1,31 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    git (1.2.5)
+    jeweler (1.8.3)
+      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.4)
+    simplecov (0.6.1)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.5.3)
+    simplecov-html (0.5.3)
+    yard (0.7.5)
+
+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)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Victor Costan
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.markdown

@@ -0,0 +1,17 @@
+# police-vminfo
+
+Collects information about the internals of the running Ruby VM.
+
+This is useful for applications that want to re-implement standard library
+objects such as String, or track their usage, e.g. for data flow taint tracking.
+The code here can be used to ensure that an implementation fully covers an
+object's methods.
+
+Right now, this gem collects the Ruby exploration code used to build
+police-dataflow.
+
+
+## Copyright
+
+Copyright (c) 2012 Massachusetts Institute of Technology. See LICENSE.txt for
+further details.

data/Rakefile

@@ -0,0 +1,38 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "police-vminfo"
+  gem.homepage = "http://github.com/pwnall/police-vminfo"
+  gem.license = "MIT"
+  gem.summary = %Q{Information about the Ruby VM internals.}
+  gem.description = %Q{Collects information about the Ruby VM implementation details.}
+  gem.email = "victor@costan.us"
+  gem.authors = ["Victor Costan"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+task :default => :test
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/VERSION

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

data/lib/police-vminfo.rb

@@ -0,0 +1,2 @@
+# Allow require 'police-vminfo' instead of 'police/vminfo'
+require 'police/vminfo'

data/lib/police/vminfo.rb

@@ -0,0 +1,3 @@
+require 'police/vminfo/objects.rb'
+require 'police/vminfo/paths.rb'
+require 'police/vminfo/signature.rb'

data/lib/police/vminfo/objects.rb

@@ -0,0 +1,164 @@
+module Police
+
+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
+  def self.named_modules
+    # NOTE: this is a Set, but we don't want to load the module.
+    explored = { Object => true }
+    left = [Object]
+    until left.empty?
+      namespace = left.pop
+      namespace.constants.each do |const_name|
+        begin
+          const = if namespace.const_defined? const_name
+            namespace.const_get const_name
+          else
+            namespace.const_missing const_name
+          end
+        rescue LoadError, NameError
+          # Delayed loading failure.
+          next
+        end
+        next if explored[const] || !const.kind_of?(Module)
+        explored[const] = true
+        left.push const
+      end
+    end
+    explored.keys.sort_by!(&:name).freeze
+  end
+
+  # All loaded Ruby classes, obtained by walking the constants graph.
+  #
+  # 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
+  def self.named_classes
+    named_modules.select { |m| m.kind_of? Class }
+  end
+  
+  # All loaded Ruby modules, obtained by querying ObjectSpace. 
+  #
+  # Querying ObjectSpace can be painfully slow, especially on non-MRI VMs.
+  #
+  # @return [Array<Module>] all the Ruby modules
+  def self.all_modules
+    ObjectSpace.each_object(Module).to_a
+  end
+  
+  # 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. 
+  #
+  # @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 = []
+    output.split("\n").each do |name|
+      next if name[0] == ?#
+      begin
+        mod = constantize name
+        next unless mod.kind_of? Module
+        modules << mod
+      rescue NameError, LoadError
+        # Delayed loading failure.
+        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.  
+  #
+  # @return [Array<Class>] the classes that are present in a vanilla Ruby
+  #     environment
+  def self.core_classes
+    return @core_classes if @core_classes
+    @core_classes = core_modules.select { |m| m.kind_of? Class }
+    @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
+  #     defined by the given Class or Module
+  def self.all_methods(module_or_class)
+    class_methods(module_or_class) + instance_methods(module_or_class)
+  end
+
+  # 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
+  def self.instance_methods(module_or_class)
+    module_or_class.instance_methods.tap do |array|
+      array.map! { |name| module_or_class.instance_method name }
+      array.select! { |method| method.owner == module_or_class }
+    end
+  end
+
+  # 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.
+  #
+  # @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
+  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.select! { |method| method.owner == singleton_class }
+    end
+  end
+  
+  # Resolves the name of a constant into its value.
+  #
+  # @param [String] name a constant name, potentially including the scope
+  #     operator ::
+  # @return [Object] the value of the constant with the given name
+  # @raise [NameError] no constant with the given name is defined
+  def self.constantize(name)
+    segments = name.split '::'
+    value = Object
+    segments.each do |segment|
+      next if segment.empty?
+      value = if value.const_defined? segment
+        value.const_get segment
+      else
+        value.const_missing segment
+      end
+    end
+    value    
+  end
+end  # namespace VmInfo
+
+end  # namespace Police

data/lib/police/vminfo/paths.rb

@@ -0,0 +1,67 @@
+module Police
+  
+module VmInfo
+  # Classifies the path to a Ruby file based on its provenance.
+  #
+  # @param [Method, UnboundMethod] method VM information about a method; usually
+  #     obtained by calling Object#method or Module#instance_method
+  # @return [Symbol] :native for methods defined in a low-level language (C/C++
+  #     for MRI and Rubinius, Java for JRuby), :kernel for methods belonging to
+  #     the core VM code (Rubinius and JRuby), :stdlib for methods in Ruby's
+  #     standard library, :gem for methods that are implemented in a loaded Ruby
+  #     gem, and :app for all other methods (presumably defined in the current
+  #     application)
+  def self.method_source(method)
+    location = method.source_location
+    return :native if location.nil?
+    code_path = location.first
+    return :stdlib if stdlib_path?(code_path)
+    return :gem if gem_path?(code_path)
+    return :kernel if kernel_path?(code_path)
+    :app
+  end
+  
+  # True if the given source code path belongs to a gem.
+  def self.gem_path?(path)
+    Gem.default_path.any? { |gem_path| Paths.descendant? path, gem_path }
+  end
+  
+  # True if the given source code path belongs to the Ruby standard library.
+  def self.stdlib_path?(path)
+    # NOTE: assuming the convention that all directories are prepended to the
+    #       load path throughout a program's execution
+    load_paths = $LOAD_PATH    
+    last_gem_index = -1
+    (load_paths.length - 1).downto(0) do |index|
+      if gem_path? load_paths[index]
+        last_gem_index = index
+        break
+      end
+    end
+    stdlib_paths = load_paths[(last_gem_index + 1)..-1]
+    stdlib_paths.any? { |stdlib_path| Paths.descendant? path, stdlib_path }
+  end
+  
+  # True if the given source code path belongs to the Ruby VM kernel.
+  def self.kernel_path?(path)
+    !$LOAD_PATH.any? { |load_path| Paths.descendant? path, load_path }
+  end
+  
+  # Implementation details.
+  # @private
+  module Paths
+    class <<self
+      # True if a path points to a descendant of the directory in anothe
+      def descendant?(descendant, dir)
+        if descendant.length > dir.length
+          descendant[0, dir.length] == dir &&
+              descendant[dir.length] == File::SEPARATOR
+        else
+          descendant == dir
+        end
+      end
+    end
+  end
+end  # module VmInfo
+
+end  # namespace Police

data/lib/police/vminfo/signature.rb

@@ -0,0 +1,13 @@
+module Police
+  
+module VmInfo
+  # Fingerprint for the Ruby VM's core and stdlib API.
+  #
+  # @return [String] a string that contains the Ruby VM's engine name and
+  #     core version; this should be representative of the 
+  def self.signature
+    Gem.ruby_engine + Gem.ruby_version.segments[0, 3].join('.')
+  end
+end  # module VmInfo
+
+end  # namespace Police

data/police-vminfo.gemspec

@@ -0,0 +1,53 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "police-vminfo"
+  s.version = "0.0.1"
+
+  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.description = "Collects information about the Ruby VM implementation details."
+  s.email = "victor@costan.us"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.markdown"
+  ]
+  s.files = [
+    ".document",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.markdown",
+    "Rakefile",
+    "VERSION",
+    "lib/police-vminfo.rb",
+    "lib/police/vminfo.rb",
+    "lib/police/vminfo/objects.rb",
+    "lib/police/vminfo/paths.rb",
+    "lib/police/vminfo/signature.rb",
+    "police-vminfo.gemspec",
+    "test/helper.rb",
+    "test/vminfo/objects_test.rb",
+    "test/vminfo/paths_test.rb",
+    "test/vminfo/signature_test.rb"
+  ]
+  s.homepage = "http://github.com/pwnall/police-vminfo"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.21"
+  s.summary = "Information about the Ruby VM internals."
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

data/test/helper.rb

@@ -0,0 +1,20 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'minitest/unit'
+require 'minitest/spec'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'police-vminfo'
+
+class MiniTest::Unit::TestCase
+end
+
+MiniTest::Unit.autorun

data/test/vminfo/objects_test.rb

@@ -0,0 +1,302 @@
+require File.expand_path('../helper.rb', File.dirname(__FILE__))
+
+describe Police::VmInfo do
+  CORE_MODULES = [Kernel, Process::Sys]
+  GEM_MODULES = [MiniTest]
+  MODULES = CORE_MODULES + GEM_MODULES
+  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|
+      it "contains #{const}" do
+        result.must_include const
+      end
+    end
+  end
+  
+  describe '#named_classes' do
+    let(:result) { Police::VmInfo.named_classes }
+
+    CLASSES.each do |const|
+      it "contains #{const}" do
+        result.must_include const
+      end
+    end
+    
+    MODULES.each do |const|
+      it "does not contain #{const}" do
+        result.wont_include const
+      end
+    end
+  end
+
+  describe '#all_modules' do
+    let(:result) { Police::VmInfo.all_modules }
+    (MODULES + CLASSES).each do |const|
+      it "contains #{const}" do
+        result.must_include const
+      end
+    end
+    
+    it 'contains anonymous module' do
+      anonymous_module = Module.new
+      Police::VmInfo.all_modules.must_include anonymous_module
+    end
+
+    it 'contains anonymous class' do
+      anonymous_class = Class.new
+      Police::VmInfo.all_modules.must_include anonymous_class
+    end
+  end
+  
+  describe '#all_classes' do
+    let(:result) { Police::VmInfo.all_classes }
+
+    CLASSES.each do |const|
+      it "contains #{const}" do
+        result.must_include const
+      end
+    end
+    
+    MODULES.each do |const|
+      it "does not contain #{const}" do
+        result.wont_include const
+      end
+    end
+
+    it 'does not contain anonymous module' do
+      anonymous_module = Module.new
+      Police::VmInfo.all_classes.wont_include anonymous_module
+    end
+
+    it 'contains anonymous class' do
+      anonymous_class = Class.new
+      Police::VmInfo.all_classes.must_include anonymous_class
+    end
+  end
+
+  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
+    let(:result) { Police::VmInfo.core_classes }
+
+    (CORE_CLASSES).each do |const|
+      it "contains #{const}" 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    
+
+  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
+  end
+
+  def fixture_class
+    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)
+      end
+      
+      it 'contains overridden class methods' do
+        method_names.must_include :dup 
+      end
+
+      it 'contains new class methods' do
+        method_names.must_include :police_new_module_class_method
+      end
+
+      it 'does not contain inherited class methods' do
+        method_names.wont_include :clone
+      end
+
+      it 'contains overridden instance methods' do
+        method_names.must_include :map 
+      end
+
+      it 'contains new instance methods' do
+        method_names.must_include :police_new_module_method
+      end
+
+      it 'does not contain inherited instance methods' 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)
+      end
+      
+      it 'contains overridden class methods' do
+        method_names.must_include :new 
+      end
+
+      it 'contains new class methods' do
+        method_names.must_include :police_new_class_method
+      end
+
+      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 
+      end
+
+      it 'contains new instance methods' do
+        method_names.must_include :police_new_method
+      end
+
+      it 'does not contain inherited instance methods' do
+        method_names.wont_include :to_s
+      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)
+      end
+      
+      it 'contains overridden methods' do
+        method_names.must_include :dup 
+      end
+
+      it 'contains new methods' do
+        method_names.must_include :police_new_module_class_method
+      end
+
+      it 'does not contain inherited class methods' do
+        method_names.wont_include :clone
+      end
+
+      it 'does not contain instance methods' 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)
+      end
+      
+      it 'contains overridden methods' do
+        method_names.must_include :new 
+      end
+
+      it 'contains new methods' do
+        method_names.must_include :police_new_class_method
+      end
+
+      it 'does not contain inherited class methods' do
+        method_names.wont_include :superclass
+      end
+
+      it 'does not contain instance methods' do
+        method_names.wont_include :police_new_method
+      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)
+      end
+      
+      it 'contains overridden methods' do
+        method_names.must_include :map 
+      end
+
+      it 'contains new methods' do
+        method_names.must_include :police_new_module_method
+      end
+
+      it 'does not contain inherited methods' do
+        method_names.wont_include :select
+      end
+
+      it 'does not contain class methods' 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)
+      end
+      
+      it 'contains overridden methods' do
+        method_names.must_include :length 
+      end
+
+      it 'contains new methods' do
+        method_names.must_include :police_new_method
+      end
+
+      it 'does not contain inherited methods' do
+        method_names.wont_include :to_s
+      end
+
+      it 'does not contain class methods' do
+        method_names.wont_include :police_new_class_method
+      end
+    end
+  end
+  
+  describe "#constantize" do
+    it 'works on simple names' do
+      Police::VmInfo.constantize('Object').must_equal Object
+    end
+
+    it 'works on scoped names' do
+      Police::VmInfo.constantize('Process::Sys').must_equal Process::Sys
+    end
+
+    it 'works on global scoped names' do
+      Police::VmInfo.constantize('::Process::Sys').must_equal Process::Sys
+    end
+  end
+end

data/test/vminfo/paths_test.rb

@@ -0,0 +1,84 @@
+require File.expand_path('../helper.rb', File.dirname(__FILE__))
+require 'net/http'
+
+describe Police::VmInfo do
+  def some_method; end
+
+  APP_PATH = Police::VmInfo.method(:gem_path?).source_location.first
+  TEST_PATH = self.instance_method(:some_method).source_location.first
+  HTTP_PATH = Net::HTTP.method(:new).source_location.first
+  BUNDLER_PATH = Bundler.method(:setup).source_location.first
+  
+  describe '#method_source' do
+    it 'recognizes stdlib methods' do
+      Police::VmInfo.method_source(Net::HTTP.method(:new)).must_equal :stdlib
+    end
+
+    it 'recognizes gem methods' do
+      Police::VmInfo.method_source(Bundler.method(:setup)).must_equal :gem
+    end
+
+    it 'recognizes app methods' do
+      Police::VmInfo.method_source(Police::VmInfo.method(:gem_path?)).
+                     must_equal :app
+    end
+  end
+  
+  describe '#gem_path?' do
+    it 'accepts Bundler path' do
+      Police::VmInfo.gem_path?(BUNDLER_PATH).must_equal true
+    end
+
+    it 'rejects Net::HTTP path' do
+      Police::VmInfo.gem_path?(HTTP_PATH).must_equal false
+    end
+    
+    it 'rejects test path' do
+      Police::VmInfo.gem_path?(TEST_PATH).must_equal false
+    end
+
+    it 'rejects app path' do
+      Police::VmInfo.gem_path?(APP_PATH).must_equal false
+    end
+  end
+  
+  describe '#stdlib_path?' do
+    it 'rejects Bundler path' do
+      Police::VmInfo.stdlib_path?(BUNDLER_PATH).must_equal false
+    end
+
+    it 'accepts Net::HTTP path' do
+      Police::VmInfo.stdlib_path?(HTTP_PATH).must_equal true
+    end
+    
+    it 'rejects test path' do
+      Police::VmInfo.stdlib_path?(TEST_PATH).must_equal false
+    end
+
+    it 'rejects app path' do
+      Police::VmInfo.stdlib_path?(APP_PATH).must_equal false
+    end
+  end
+  
+  describe '#kernel_path?' do
+    it 'rejects Bundler path' do
+      Police::VmInfo.kernel_path?(BUNDLER_PATH).must_equal false
+    end
+
+    it 'rejects Net::HTTP path' do
+      Police::VmInfo.kernel_path?(HTTP_PATH).must_equal false
+    end
+    
+    it 'rejects test path' do
+      Police::VmInfo.kernel_path?(TEST_PATH).must_equal false
+    end
+
+    it 'rejects app path' do
+      Police::VmInfo.kernel_path?(APP_PATH).must_equal false
+    end
+    
+    it 'accepts a Rubinius kernel path' do
+      Police::VmInfo.kernel_path?('kernel/bootstrap/string.rb').must_equal true
+    end
+  end
+end

data/test/vminfo/signature_test.rb

@@ -0,0 +1,15 @@
+require File.expand_path('../helper.rb', File.dirname(__FILE__))
+
+describe Police::VmInfo do
+  describe '#signature' do
+    let(:result) { Police::VmInfo.signature }
+
+    it "should not be empty" do
+      result.length.wont_equal 0
+    end
+
+    it "should have a bunch of letters, numbers and .s" do
+      result.must_match(/\A\w+[0-9.]+\Z/)
+    end
+  end
+end

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: police-vminfo
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Victor Costan
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-03-28 00:00:00.000000000 Z
+dependencies: []
+description: Collects information about the Ruby VM implementation details.
+email: victor@costan.us
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.markdown
+files:
+- .document
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.markdown
+- Rakefile
+- VERSION
+- lib/police-vminfo.rb
+- lib/police/vminfo.rb
+- lib/police/vminfo/objects.rb
+- lib/police/vminfo/paths.rb
+- lib/police/vminfo/signature.rb
+- police-vminfo.gemspec
+- test/helper.rb
+- test/vminfo/objects_test.rb
+- test/vminfo/paths_test.rb
+- test/vminfo/signature_test.rb
+homepage: http://github.com/pwnall/police-vminfo
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -2040166733346347996
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.21
+signing_key: 
+specification_version: 3
+summary: Information about the Ruby VM internals.
+test_files: []