Ruby  1.9.3p448(2013-06-27revision41675)
coverage.c
Go to the documentation of this file.
1 /************************************************
2 
3  coverage.c -
4 
5  $Author: $
6 
7  Copyright (c) 2008 Yusuke Endoh
8 
9 ************************************************/
10 
11 #include "ruby.h"
12 #include "vm_core.h"
13 
15 
16 /*
17  * call-seq:
18  * Coverage.start => nil
19  *
20  * Enables coverage measurement.
21  */
22 static VALUE
24 {
25  if (!RTEST(rb_get_coverages())) {
26  if (rb_coverages == Qundef) {
28  RBASIC(rb_coverages)->klass = 0;
29  }
31  }
32  return Qnil;
33 }
34 
35 static int
37 {
38  VALUE path = (VALUE)key;
39  VALUE coverage = (VALUE)val;
40  VALUE coverages = (VALUE)h;
41  coverage = rb_ary_dup(coverage);
42  rb_ary_clear((VALUE)val);
43  rb_ary_freeze(coverage);
44  rb_hash_aset(coverages, path, coverage);
45  return ST_CONTINUE;
46 }
47 
48 /*
49  * call-seq:
50  * Coverage.result => hash
51  *
52  * Returns a hash that contains filename as key and coverage array as value
53  * and disables coverage measurement.
54  */
55 static VALUE
57 {
58  VALUE coverages = rb_get_coverages();
59  VALUE ncoverages = rb_hash_new();
60  if (!RTEST(coverages)) {
61  rb_raise(rb_eRuntimeError, "coverage measurement is not enabled");
62  }
63  st_foreach(RHASH_TBL(coverages), coverage_result_i, ncoverages);
64  rb_hash_freeze(ncoverages);
66  return ncoverages;
67 }
68 
69 /* Coverage provides coverage measurement feature for Ruby.
70  * This feature is experimental, so these APIs may be changed in future.
71  *
72  * = Usage
73  *
74  * (1) require "coverage.so"
75  * (2) do Coverage.start
76  * (3) require or load Ruby source file
77  * (4) Coverage.result will return a hash that contains filename as key and
78  * coverage array as value.
79  *
80  * = Example
81  *
82  * [foo.rb]
83  * s = 0
84  * 10.times do |x|
85  * s += x
86  * end
87  *
88  * if s == 45
89  * p :ok
90  * else
91  * p :ng
92  * end
93  * [EOF]
94  *
95  * require "coverage.so"
96  * Coverage.start
97  * require "foo.rb"
98  * p Coverage.result #=> {"foo.rb"=>[1, 1, 10, nil, nil, 1, 1, nil, 0, nil]}
99  */
100 void
102 {
103  VALUE rb_mCoverage = rb_define_module("Coverage");
104  rb_define_module_function(rb_mCoverage, "start", rb_coverage_start, 0);
105  rb_define_module_function(rb_mCoverage, "result", rb_coverage_result, 0);
107 }
static VALUE rb_coverage_result(VALUE klass)
Definition: coverage.c:56
VALUE rb_get_coverages(void)
Definition: thread.c:4854
VALUE rb_ary_freeze(VALUE ary)
Definition: array.c:278
static VALUE rb_coverage_start(VALUE klass)
Definition: coverage.c:23
#define st_foreach
Definition: regint.h:150
void Init_coverage(void)
Definition: coverage.c:101
void rb_raise(VALUE exc, const char *fmt,...)
Definition: error.c:1574
VALUE rb_ary_clear(VALUE ary)
Definition: array.c:2870
static VALUE rb_coverages
Definition: coverage.c:14
void rb_gc_register_address(VALUE *addr)
Definition: gc.c:976
#define RHASH_TBL(h)
Definition: tkutil.c:27
VALUE rb_hash_aset(VALUE hash, VALUE key, VALUE val)
Definition: hash.c:1123
VALUE rb_eRuntimeError
Definition: error.c:466
static VALUE coverage(const char *f, int n)
Definition: ripper.c:10636
void rb_define_module_function(VALUE module, const char *name, VALUE(*func)(ANYARGS), int argc)
Defines a module function for module.
Definition: class.c:1357
VALUE rb_hash_new(void)
Definition: hash.c:229
#define Qnil
Definition: ruby.h:367
unsigned long VALUE
Definition: ruby.h:88
#define RBASIC(obj)
Definition: ruby.h:904
long st_data_t
Definition: syck.h:69
VALUE rb_hash_freeze(VALUE hash)
Definition: hash.c:30
void rb_reset_coverages(void)
Definition: thread.c:4867
uint8_t key[16]
Definition: random.c:1284
#define RTEST(v)
Definition: ruby.h:373
VALUE rb_ary_dup(VALUE ary)
Definition: array.c:1597
VALUE rb_define_module(const char *name)
Definition: class.c:586
#define Qundef
Definition: ruby.h:368
static int coverage_result_i(st_data_t key, st_data_t val, st_data_t h)
Definition: coverage.c:36
void rb_set_coverages(VALUE coverages)
Definition: thread.c:4860