iseq_collector 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 32d9403f57f44d72f2ee72f561ab06992f8386ed
-  data.tar.gz: '01815aa3e10ae9e4604df248d4e30b43eab20ea8'
+  metadata.gz: 65748299ec8c1bc18d1b2331297771eeecf8f3dd
+  data.tar.gz: d29f03e81016604d187f8353cf785e20564bcdde
 SHA512:
-  metadata.gz: e4ef072b72332d02f84be80efb99349f60d81a52384536015eca377b0d09117f6cdf8097a68ee764d0708f7fd35184e0095ab38e5957fe2df891a077572513c7
-  data.tar.gz: 67b09baefad027719f545a1085a55337d7f6245dec1b9d81a3da0833698fc2b22ce16f796a3ff44dd4d8f5c8bf4accffc89df542c7dddacd869beca04503f088
+  metadata.gz: 42cc8cebb4387e286ba8aa17ea2b130b225e45405d913d28c698452b109e43c7030ef5e095e5e7c56078b68829177b95f13cb2975e518e4e48981953fffd0393
+  data.tar.gz: 12acb6034afd13b57f49059769a1f19eb31165bb4da0ae9af1c9bb967cc2ed69ec961a0af6c99a1ec7afea8366b7b661f55d32b0530816e6e4ceecd0377025c6

data/README.md

@@ -1,8 +1,13 @@
 # IseqCollector
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/iseq_collector`. To experiment with that code, run `bin/console` for an interactive prompt.
+This gem introduce several methdos to `ObjectSpace` to operate all of iseq objects in a process.
 
-TODO: Delete this and the text above, and describe your gem
+## Background
+
+Ruby (MRI) 2.2 and erlier, all of bytecode (iseq: instruction sequence) are `RubyVM::InstructionSequence` objects and we can touch them with `ObjectSpace.each_object` method.
+However Ruby 2.3 and later does not expose iseqs by `RubyVM::InstructionSequence`. You need to use `RubyVM::InstructionSequence.of(proc or method object)` to get `RubyVM::InstructionSequence` and it is impossible to get all of iseqs in a process.
+
+This gem provides `ObjectSpace.each_iseq`, `ObjectSpace.count_iseq` and `ObjectSpace.memsize_of_all_iseq` to get all of iseqs in a process for Ruby 2.3, 2.4. Ruby 2.5 will provide same feature in `objspace` external lib.
 
 ## Installation
 
@@ -22,7 +27,11 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+`require 'iseq_collector'` adds the following singleton methods to `ObjectSpace` module.
+
+* `ObjectSpace.each_iseq{|iseq| ...}`
+* `ObjectSpace.count_iseq #=> Integer`
+* `ObjectSpace.memsize_of_all_iseq #=> Integer` (this feature can be implemented by `ObjectSpace.each_iseq`)
 
 ## Development
 

data/ext/iseq_collector/extconf.rb

@@ -0,0 +1,4 @@
+require 'mkmf'
+
+create_makefile('iseq_collector')
+

data/iseq_collector.gemspec

@@ -21,6 +21,8 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
+  spec.extensions    = ['ext/iseq_collector/extconf.rb']
+
   spec.add_development_dependency "bundler", "~> 1.14"
   spec.add_development_dependency "rake", "~> 10.0"
   spec.add_development_dependency "minitest", "~> 5.0"

data/lib/iseq_collector/version.rb

@@ -1,3 +1,3 @@
 module IseqCollector
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: iseq_collector
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Koichi Sasada
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-04-06 00:00:00.000000000 Z
+date: 2018-03-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -70,7 +70,8 @@ description: ISeq collector for MRI 2.3 and 2.4
 email:
 - ko1@atdot.net
 executables: []
-extensions: []
+extensions:
+- ext/iseq_collector/extconf.rb
 extra_rdoc_files: []
 files:
 - ".gitignore"
@@ -81,6 +82,7 @@ files:
 - Rakefile
 - bin/console
 - bin/setup
+- ext/iseq_collector/extconf.rb
 - iseq_collector.gemspec
 - lib/iseq_collector.rb
 - lib/iseq_collector/version.rb
@@ -104,7 +106,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.2
+rubygems_version: 2.6.11
 signing_key: 
 specification_version: 4
 summary: ISeq collector for MRI 2.3 and 2.4