gc_tracer 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 504e949ddef15f4e0e26f11fb9a2d009110014da
-  data.tar.gz: 0a482f4a58722d5ddbce5e36dca365b9cc8d485c
+  metadata.gz: 02c2e3a73f9c81c909ea34661ee28e724e46ae6a
+  data.tar.gz: f9ecb1757af0bf11518f6a4bf0065568fc1f6d78
 SHA512:
-  metadata.gz: 90a824f04f6ba0e034efe5f4997351b47ad5d7ff51f9901ef7f671f249e3c53430d1729f31a9a5228a12beda8db8b43e62bc5a17fcf09ac83e0e8dcabd0c832f
-  data.tar.gz: 509d4dd75c81bc866e540b8a1cd0917f07683ce6e415040abdfcd7dbfb02b201aecfdff108bc28184a99cd2cca736ba1da40bf82ecdd0ecfd7c2cb8e19db6a85
+  metadata.gz: c442b07afc88814c7dd2687872ba1a260bd6cfd26951596b488291fb31e06787265c1c9c2d1db353be6c712cfa209bfb91dc900a73e747d946d8ea4d7ab30b1d
+  data.tar.gz: ccb123ceff8944ef0405c37793d192eabbc8d515c364da02aaf5ca1b3ec4872c82487467a946a96264f18d3237fb1168b2f03318f89b6e1fc35aeb9905517676

data/README.md

@@ -20,6 +20,8 @@ Or install it yourself as:
 
 ## Usage
 
+### Logging
+
 You can get GC statistics information in block form like this:
 
 ```ruby
@@ -52,6 +54,28 @@ at each events, there are one of:
 
 For one GC, you can get all three lines.
 
+### ObjectSpace recorder
+
+You can records objspace snapshots on each events.  Snapshots are stored 
+in the [PPM (P6) format] (http://en.wikipedia.org/wiki/Netpbm_format).
+
+```ruby
+require 'gc_tracer'
+GC::Tracer.start_objspace_recording(dirname) do
+  # do something
+end
+```
+
+All PPM images are stored in dirname/ppm/.
+
+If you have netpbm package and pnmtopng command, 
+bin/objspace_recorder_convert.rb converts all ppm images into png files. 
+Converted png images stored into dirname/png/.
+
+You can view all converted png images with public/viewer.html.
+
+This feature is supported only latest Ruby versions (2.2, and later).
+
 ## Contributing
 
 1. Fork it ( http://github.com/ko1/gc_tracer/fork )

data/ext/gc_tracer/gc_tracer.c

@@ -505,22 +505,85 @@ categorical_color10(int n)
 }
 
 static int
-existance_color_picker(VALUE v) {
+categorical_color20(int n)
+{
+    const int colors[] = {
+	0x1f77b4,
+	0xaec7e8,
+	0xff7f0e,
+	0xffbb78,
+	0x2ca02c,
+	0x98df8a,
+	0xd62728,
+	0xff9896,
+	0x9467bd,
+	0xc5b0d5,
+	0x8c564b,
+	0xc49c94,
+	0xe377c2,
+	0xf7b6d2,
+	0x7f7f7f,
+	0xc7c7c7,
+	0xbcbd22,
+	0xdbdb8d,
+	0x17becf,
+	0x9edae5,
+    };
+    assert(n < 20);
+    return colors[n];
+}
+
+static int
+object_age_picker(VALUE v) {
     if (RB_TYPE_P(v, T_NONE)) {
-	return 0;
+	return categorical_color10(0);
     }
     else {
 	if (OBJ_PROMOTED(v)) {
 	    /* old */
-	    return 1;
+	    return categorical_color10(1);
 	}
 	else {
 	    /* young */
-	    return 2;
+	    return categorical_color10(2);
 	}
     }
 }
 
+static int
+object_type_picker(VALUE v) {
+    int type = BUILTIN_TYPE(v);
+    int color = 0;
+    switch (type) {
+      case RUBY_T_NONE:
+      case RUBY_T_OBJECT:
+      case RUBY_T_CLASS:
+      case RUBY_T_MODULE:
+      case RUBY_T_FLOAT:
+      case RUBY_T_STRING:
+      case RUBY_T_REGEXP:
+      case RUBY_T_ARRAY:
+      case RUBY_T_HASH:
+      case RUBY_T_STRUCT:
+      case RUBY_T_BIGNUM:
+      case RUBY_T_FILE:
+      case RUBY_T_DATA:
+      case RUBY_T_MATCH:
+      case RUBY_T_COMPLEX:
+      case RUBY_T_RATIONAL: /* 0x0f */
+	color = type;
+	break;
+      case RUBY_T_NODE:
+      case RUBY_T_ICLASS:
+      case RUBY_T_ZOMBIE:
+	color = type - 11;
+	break;
+      default:
+	rb_bug("object_type_picker: unreachable (type: %d)", type);
+    }
+    return categorical_color20(color);
+}
+
 static int
 objspace_recording_i(void *start, void *end, size_t stride, void *data)
 {
@@ -531,8 +594,7 @@ objspace_recording_i(void *start, void *end, size_t stride, void *data)
 
     for (i=0; i<size; i++) {
 	VALUE v = (VALUE)start + i * stride;
-	int color_index = (*objspace_recorder_color_picker)(v);
-	set_color(&buff[i*3], categorical_color10(color_index));
+	set_color(&buff[i*3], (*objspace_recorder_color_picker)(v));
     }
     for (; i<HEAP_OBJ_LIMIT; i++) {
 	set_color(&buff[i*3], 0);
@@ -589,11 +651,23 @@ gc_tracer_stop_objspace_recording(VALUE self)
 }
 
 static VALUE
-gc_tracer_start_objspace_recording(VALUE self, VALUE dirname)
+gc_tracer_start_objspace_recording(int argc, VALUE *argv, VALUE self)
 {
     if (objspace_recorder.enabled == Qfalse) {
 	int i;
 	VALUE ppmdir;
+	VALUE dirname;
+	VALUE picker_type = ID2SYM(rb_intern("age"));
+
+	switch (argc) {
+	  case 2:
+	    picker_type = argv[1];
+	  case 1:
+	    dirname = argv[0];
+	    break;
+	  default:
+	    rb_raise(rb_eArgError, "expect 1 or 2 arguments, but %d", argc);
+	}
 
 	/* setup */
 	if (rb_funcall(rb_cFile, rb_intern("directory?"), 1, dirname) != Qtrue) {
@@ -603,7 +677,15 @@ gc_tracer_start_objspace_recording(VALUE self, VALUE dirname)
 	    rb_funcall(rb_cDir, rb_intern("mkdir"), 1, ppmdir);
 	}
 
-	objspace_recorder_color_picker = existance_color_picker;
+	if (picker_type == ID2SYM(rb_intern("age"))) {
+	    objspace_recorder_color_picker = object_age_picker;
+	}
+	else if (picker_type == ID2SYM(rb_intern("type"))) {
+	    objspace_recorder_color_picker = object_type_picker;
+	}
+	else {
+	    rb_raise(rb_eArgError, "unsupported picker type: %s", rb_id2name(SYM2ID(picker_type)));
+	}
 
 	HEAP_OBJ_LIMIT = FIX2INT(rb_hash_aref(
 	    rb_const_get(rb_mGC, rb_intern("INTERNAL_CONSTANTS")),
@@ -662,8 +744,8 @@ Init_gc_tracer(void)
 
     /* recording methods */
 #ifdef HAVE_RB_OBJSPACE_EACH_OBJECTS_WITHOUT_SETUP
-    rb_define_module_function(mod, "start_objspace_recording", gc_tracer_start_objspace_recording, 1);
-    rb_define_module_function(mod, "stop_objspace_recording", gc_tracer_stop_objspace_recording, 1);
+    rb_define_module_function(mod, "start_objspace_recording", gc_tracer_start_objspace_recording, -1);
+    rb_define_module_function(mod, "stop_objspace_recording", gc_tracer_stop_objspace_recording, 0);
 #endif
 
     /* setup default banners */

data/lib/gc_tracer/version.rb

@@ -1,3 +1,3 @@
 module GcTracer
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/public/viewer.html

@@ -1,7 +1,7 @@
 <html>
   <head>
     <meta charset="utf-8">
-    <script src="./share/jquery-2.1.0.min.js"></script>
+    <script src="./jquery-2.1.0.min.js"></script>
 
 <script>
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gc_tracer
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Koichi Sasada
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-04-02 00:00:00.000000000 Z
+date: 2014-04-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler