binding_of_caller 0.6.2 → 0.7.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml ADDED
@@ -0,0 +1,7 @@
1
+ ---
2
+ SHA1:
3
+ metadata.gz: f3fb3c7ee20b9b9ca1237d0540c2768efc657111
4
+ data.tar.gz: be4845aeca79432000b44be789993c23c1955715
5
+ SHA512:
6
+ metadata.gz: 3fd5d2a9ffbda43fcc2d8afa739ec51052f5dacc8632c3e88b60b7be90c2bd67c8a813156dab341e9f3399e46db667f3a1246043d50f1f60b6654d5c07e4e93c
7
+ data.tar.gz: 13fe3b6ab87052403c99be357fb91ea3ed2c9e9e5a8bafadc3123293bbb0a47bd7a235c67f7d25adb020f07bef0dee6d5a00424c7f59bf4c8b59dfc1f691d5c8
data/.gitignore CHANGED
@@ -1,7 +1,8 @@
1
- Makefile
2
- *.so
3
- *.o
4
- *.def
5
- doc/
6
- pkg/
7
- .yardoc/
1
+ Makefile
2
+ *.so
3
+ *.o
4
+ *.def
5
+ doc/
6
+ pkg/
7
+ .yardoc/
8
+ Gemfile.lock
data/.travis.yml ADDED
@@ -0,0 +1,23 @@
1
+ rvm:
2
+ - 1.9.2
3
+ - 1.9.3
4
+ - 2.0.0
5
+ - rbx-19mode
6
+
7
+ notifications:
8
+ irc: "irc.freenode.org#pry"
9
+ recipients:
10
+ - jrmair@gmail.com
11
+
12
+ branches:
13
+ only:
14
+ - master
15
+
16
+ #script: rake test --trace
17
+ #
18
+ #before_install:
19
+ # - gem update --system
20
+ # - gem --version
21
+ # - gem install rake bacon
22
+ # - rake gem
23
+ # - gem install pkg/*.gem
data/Gemfile ADDED
@@ -0,0 +1,2 @@
1
+ source 'https://rubygems.org'
2
+ gemspec
data/README.md CHANGED
@@ -1,9 +1,11 @@
1
+ [![Build Status](https://secure.travis-ci.org/banister/binding_of_caller.png)](http://travis-ci.org/banister/binding_of_caller)
2
+
1
3
  binding_of_caller
2
4
  ===========
3
5
 
4
- (C) John Mair (banisterfiend) 2011
6
+ (C) John Mair (banisterfiend) 2012
5
7
 
6
- _Retrieve the binding of a method's caller in MRI 1.9.2_
8
+ _Retrieve the binding of a method's caller in MRI 1.9.2+, MRI 2.0 and RBX (Rubinius)_
7
9
 
8
10
  The `binding_of_caller` gem provides the `Binding#of_caller` method.
9
11
 
@@ -13,7 +15,7 @@ call stack, not limited to just the immediate caller.
13
15
 
14
16
  **Recommended for use only in debugging situations. Do not use this in production apps.**
15
17
 
16
- **Only works in MRI Ruby 1.9.2 and 1.9.3**
18
+ **Only works in MRI Ruby 1.9.2, 1.9.3, 2.0 and RBX (Rubinius)**
17
19
 
18
20
  * Install the [gem](https://rubygems.org/gems/binding_of_caller): `gem install binding_of_caller`
19
21
  * See the [source code](http://github.com/banister/binding_of_caller)
@@ -50,7 +52,7 @@ This project is a spinoff from the [Pry REPL project.](http://pry.github.com)
50
52
  Features and limitations
51
53
  -------------------------
52
54
 
53
- * Only works with MRI 1.9.2 and 1.9.3
55
+ * Only works with MRI 1.9.2, 1.9.3, 2.0 and RBX (Rubinius)
54
56
  * Does not work in 1.8.7, but there is a well known (continuation-based) hack to get a `Binding#of_caller` there.
55
57
 
56
58
  Contact
@@ -64,7 +66,7 @@ License
64
66
 
65
67
  (The MIT License)
66
68
 
67
- Copyright (c) 2011 (John Mair)
69
+ Copyright (c) 2012 (John Mair)
68
70
 
69
71
  Permission is hereby granted, free of charge, to any person obtaining
70
72
  a copy of this software and associated documentation files (the
data/Rakefile CHANGED
@@ -1,81 +1,134 @@
1
- dlext = Config::CONFIG['DLEXT']
2
-
3
- $:.unshift 'lib'
4
-
5
- PROJECT_NAME = "binding_of_caller"
6
-
7
- require 'rake/clean'
8
- require 'rake/gempackagetask'
9
- require "#{PROJECT_NAME}/version"
10
-
11
- CLOBBER.include("**/*.#{dlext}", "**/*~", "**/*#*", "**/*.log", "**/*.o")
12
- CLEAN.include("ext/**/*.#{dlext}", "ext/**/*.log", "ext/**/*.o",
13
- "ext/**/*~", "ext/**/*#*", "ext/**/*.obj", "**/*#*", "**/*#*.*",
14
- "ext/**/*.def", "ext/**/*.pdb", "**/*_flymake*.*", "**/*_flymake")
15
-
16
- def apply_spec_defaults(s)
17
- s.name = PROJECT_NAME
18
- s.summary = "Retrieve the binding of a method's caller. Can also retrieve bindings even further up the stack. Currently only works for MRI 1.9.2+"
19
- s.version = BindingOfCaller::VERSION
20
- s.date = Time.now.strftime '%Y-%m-%d'
21
- s.author = "John Mair (banisterfiend)"
22
- s.email = 'jrmair@gmail.com'
23
- s.description = s.summary
24
- s.require_path = 'lib'
25
- s.add_development_dependency("bacon","~>1.1")
26
- s.homepage = "http://github.com/banister/binding_of_caller"
27
- s.has_rdoc = 'yard'
28
- s.required_ruby_version = '>= 1.9.2'
29
- s.files = `git ls-files`.split("\n")
30
- s.test_files = `git ls-files -- test/*`.split("\n")
31
- end
32
-
33
- desc "Run tests"
34
- task :test do
35
- sh "bacon -Itest -rubygems test.rb -q"
36
- end
37
-
38
- task :pry do
39
- puts "loading binding_of_caller into pry"
40
- sh "pry -r ./lib/binding_of_caller"
41
- end
42
-
43
- namespace :ruby do
44
- spec = Gem::Specification.new do |s|
45
- apply_spec_defaults(s)
46
- s.platform = Gem::Platform::RUBY
47
- s.extensions = ["ext/#{PROJECT_NAME}/extconf.rb"]
48
- end
49
-
50
- Rake::GemPackageTask.new(spec) do |pkg|
51
- pkg.need_zip = false
52
- pkg.need_tar = false
53
- end
54
- end
55
-
56
- desc "build the binaries"
57
- task :compile do
58
- chdir "./ext/#{PROJECT_NAME}/" do
59
- sh "ruby extconf.rb"
60
- sh "make clean"
61
- sh "make"
62
- sh "cp *.#{dlext} ../../lib/"
63
- end
64
- end
65
-
66
- desc "build all platform gems at once"
67
- task :gems => [:clean, :rmgems, "ruby:gem"]
68
-
69
- task :gem => [:gems]
70
-
71
- desc "remove all platform gems"
72
- task :rmgems => ["ruby:clobber_package"]
73
-
74
- desc "build and push latest gems"
75
- task :pushgems => :gems do
76
- chdir("./pkg") do
77
- Dir["*.gem"].each do |gemfile|
78
- sh "gem push #{gemfile}"
79
- end
80
- end
81
- end
1
+ dlext = RbConfig::CONFIG['DLEXT']
2
+ direc = File.dirname(__FILE__)
3
+
4
+ $:.unshift 'lib'
5
+
6
+ require 'rake/clean'
7
+ require 'rubygems/package_task'
8
+
9
+ require "binding_of_caller/version"
10
+
11
+ CLOBBER.include("**/*.#{dlext}", "**/*~", "**/*#*", "**/*.log", "**/*.o")
12
+ CLEAN.include("ext/**/*.#{dlext}", "ext/**/*.log", "ext/**/*.o",
13
+ "ext/**/*~", "ext/**/*#*", "ext/**/*.obj", "**/*#*", "**/*#*.*",
14
+ "ext/**/*.def", "ext/**/*.pdb", "**/*_flymake*.*", "**/*_flymake", "**/*.rbc")
15
+
16
+ def mri_2?
17
+ defined?(RUBY_ENGINE) && RUBY_ENGINE == "ruby" &&
18
+ RUBY_VERSION =~ /^2/
19
+ end
20
+
21
+ def apply_spec_defaults(s)
22
+ s.name = "binding_of_caller"
23
+ s.summary = "Retrieve the binding of a method's caller. Can also retrieve bindings even further up the stack."
24
+ s.version = BindingOfCaller::VERSION
25
+ s.date = Time.now.strftime '%Y-%m-%d'
26
+ s.author = "John Mair (banisterfiend)"
27
+ s.email = 'jrmair@gmail.com'
28
+ s.description = s.summary
29
+ s.require_path = 'lib'
30
+ s.add_dependency 'debug_inspector', '>= 0.0.1'
31
+ s.add_development_dependency 'bacon'
32
+ s.add_development_dependency 'rake'
33
+ s.homepage = "http://github.com/banister/binding_of_caller"
34
+ s.has_rdoc = 'yard'
35
+ s.files = `git ls-files`.split("\n")
36
+ s.test_files = `git ls-files -- test/*`.split("\n")
37
+ end
38
+
39
+ desc "Show version"
40
+ task :version do
41
+ puts "BindingOfCaller version: #{BindingOfCaller::VERSION}"
42
+ end
43
+
44
+ desc "run tests"
45
+ task :default => [:test]
46
+
47
+ desc "Run tests"
48
+ task :test do
49
+ unless defined?(Rubinius)
50
+ Rake::Task['compile'].execute
51
+ end
52
+
53
+ $stdout.puts("\033[33m")
54
+ sh "bacon -Itest -rubygems -a -q"
55
+ $stdout.puts("\033[0m")
56
+
57
+ unless defined?(Rubinius)
58
+ Rake::Task['cleanup'].execute
59
+ end
60
+ end
61
+
62
+ task :pry do
63
+ puts "loading binding_of_caller into pry"
64
+ sh "pry -r ./lib/binding_of_caller"
65
+ end
66
+
67
+ desc "generate gemspec"
68
+ task :gemspec => "ruby:gemspec"
69
+
70
+ namespace :ruby do
71
+ spec = Gem::Specification.new do |s|
72
+ apply_spec_defaults(s)
73
+ s.platform = Gem::Platform::RUBY
74
+ s.extensions = ["ext/binding_of_caller/extconf.rb"]
75
+ end
76
+
77
+ Gem::PackageTask.new(spec) do |pkg|
78
+ pkg.need_zip = false
79
+ pkg.need_tar = false
80
+ end
81
+
82
+ desc "Generate gemspec file"
83
+ task :gemspec do
84
+ File.open("#{spec.name}.gemspec", "w") do |f|
85
+ f << spec.to_ruby
86
+ end
87
+ end
88
+ end
89
+
90
+ desc "build the binaries"
91
+ task :compile => :cleanup do
92
+ if !mri_2?
93
+ chdir "./ext/binding_of_caller/" do
94
+ sh "ruby extconf.rb"
95
+ sh "make"
96
+ sh "cp *.#{dlext} ../../lib/"
97
+ end
98
+ end
99
+ end
100
+
101
+ desc 'cleanup the extensions'
102
+ task :cleanup do
103
+ if !mri_2?
104
+ sh 'rm -rf lib/binding_of_caller.so'
105
+ chdir "./ext/binding_of_caller/" do
106
+ sh 'make clean'
107
+ end
108
+ end
109
+ end
110
+
111
+ desc "reinstall gem"
112
+ task :reinstall => :gems do
113
+ sh "gem uninstall binding_of_caller" rescue nil
114
+ sh "gem install #{direc}/pkg/binding_of_caller-#{BindingOfCaller::VERSION}.gem"
115
+ end
116
+
117
+ task :install => :reinstall
118
+
119
+ desc "build all platform gems at once"
120
+ task :gems => [:clean, :rmgems, "ruby:gem"]
121
+
122
+ task :gem => [:gems]
123
+
124
+ desc "remove all platform gems"
125
+ task :rmgems => ["ruby:clobber_package"]
126
+
127
+ desc "build and push latest gems"
128
+ task :pushgems => :gems do
129
+ chdir("./pkg") do
130
+ Dir["*.gem"].each do |gemfile|
131
+ sh "gem push #{gemfile}"
132
+ end
133
+ end
134
+ end
@@ -0,0 +1,37 @@
1
+ # -*- encoding: utf-8 -*-
2
+
3
+ Gem::Specification.new do |s|
4
+ s.name = "binding_of_caller"
5
+ s.version = "0.7.2"
6
+
7
+ s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
8
+ s.authors = ["John Mair (banisterfiend)"]
9
+ s.date = "2013-06-07"
10
+ s.description = "Retrieve the binding of a method's caller. Can also retrieve bindings even further up the stack."
11
+ s.email = "jrmair@gmail.com"
12
+ s.extensions = ["ext/binding_of_caller/extconf.rb"]
13
+ s.files = [".gemtest", ".gitignore", ".travis.yml", ".yardopts", "Gemfile", "HISTORY", "LICENSE", "README.md", "Rakefile", "binding_of_caller.gemspec", "examples/example.rb", "ext/binding_of_caller/binding_of_caller.c", "ext/binding_of_caller/extconf.rb", "ext/binding_of_caller/ruby_headers/192/debug.h", "ext/binding_of_caller/ruby_headers/192/dln.h", "ext/binding_of_caller/ruby_headers/192/eval_intern.h", "ext/binding_of_caller/ruby_headers/192/id.h", "ext/binding_of_caller/ruby_headers/192/iseq.h", "ext/binding_of_caller/ruby_headers/192/method.h", "ext/binding_of_caller/ruby_headers/192/node.h", "ext/binding_of_caller/ruby_headers/192/regenc.h", "ext/binding_of_caller/ruby_headers/192/regint.h", "ext/binding_of_caller/ruby_headers/192/regparse.h", "ext/binding_of_caller/ruby_headers/192/rubys_gc.h", "ext/binding_of_caller/ruby_headers/192/thread_pthread.h", "ext/binding_of_caller/ruby_headers/192/thread_win32.h", "ext/binding_of_caller/ruby_headers/192/timev.h", "ext/binding_of_caller/ruby_headers/192/transcode_data.h", "ext/binding_of_caller/ruby_headers/192/version.h", "ext/binding_of_caller/ruby_headers/192/vm_core.h", "ext/binding_of_caller/ruby_headers/192/vm_exec.h", "ext/binding_of_caller/ruby_headers/192/vm_insnhelper.h", "ext/binding_of_caller/ruby_headers/192/vm_opts.h", "ext/binding_of_caller/ruby_headers/193/addr2line.h", "ext/binding_of_caller/ruby_headers/193/atomic.h", "ext/binding_of_caller/ruby_headers/193/constant.h", "ext/binding_of_caller/ruby_headers/193/debug.h", "ext/binding_of_caller/ruby_headers/193/dln.h", "ext/binding_of_caller/ruby_headers/193/encdb.h", "ext/binding_of_caller/ruby_headers/193/eval_intern.h", "ext/binding_of_caller/ruby_headers/193/id.h", "ext/binding_of_caller/ruby_headers/193/internal.h", "ext/binding_of_caller/ruby_headers/193/iseq.h", "ext/binding_of_caller/ruby_headers/193/method.h", "ext/binding_of_caller/ruby_headers/193/node.h", "ext/binding_of_caller/ruby_headers/193/parse.h", "ext/binding_of_caller/ruby_headers/193/regenc.h", "ext/binding_of_caller/ruby_headers/193/regint.h", "ext/binding_of_caller/ruby_headers/193/regparse.h", "ext/binding_of_caller/ruby_headers/193/revision.h", "ext/binding_of_caller/ruby_headers/193/rubys_gc.h", "ext/binding_of_caller/ruby_headers/193/thread_pthread.h", "ext/binding_of_caller/ruby_headers/193/thread_win32.h", "ext/binding_of_caller/ruby_headers/193/timev.h", "ext/binding_of_caller/ruby_headers/193/transcode_data.h", "ext/binding_of_caller/ruby_headers/193/transdb.h", "ext/binding_of_caller/ruby_headers/193/version.h", "ext/binding_of_caller/ruby_headers/193/vm_core.h", "ext/binding_of_caller/ruby_headers/193/vm_exec.h", "ext/binding_of_caller/ruby_headers/193/vm_insnhelper.h", "ext/binding_of_caller/ruby_headers/193/vm_opts.h", "lib/binding_of_caller.rb", "lib/binding_of_caller/mri2.rb", "lib/binding_of_caller/rubinius.rb", "lib/binding_of_caller/version.rb", "test/test_binding_of_caller.rb"]
14
+ s.homepage = "http://github.com/banister/binding_of_caller"
15
+ s.require_paths = ["lib"]
16
+ s.rubygems_version = "2.0.3"
17
+ s.summary = "Retrieve the binding of a method's caller. Can also retrieve bindings even further up the stack."
18
+ s.test_files = ["test/test_binding_of_caller.rb"]
19
+
20
+ if s.respond_to? :specification_version then
21
+ s.specification_version = 4
22
+
23
+ if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
24
+ s.add_runtime_dependency(%q<debug_inspector>, [">= 0.0.1"])
25
+ s.add_development_dependency(%q<bacon>, [">= 0"])
26
+ s.add_development_dependency(%q<rake>, [">= 0"])
27
+ else
28
+ s.add_dependency(%q<debug_inspector>, [">= 0.0.1"])
29
+ s.add_dependency(%q<bacon>, [">= 0"])
30
+ s.add_dependency(%q<rake>, [">= 0"])
31
+ end
32
+ else
33
+ s.add_dependency(%q<debug_inspector>, [">= 0.0.1"])
34
+ s.add_dependency(%q<bacon>, [">= 0"])
35
+ s.add_dependency(%q<rake>, [">= 0"])
36
+ end
37
+ end
@@ -2,7 +2,7 @@
2
2
 
3
3
  #include <ruby.h>
4
4
  #include "vm_core.h"
5
- #include "gc.h"
5
+ #include "rubys_gc.h"
6
6
 
7
7
  typedef enum { false, true } bool;
8
8
 
@@ -24,6 +24,7 @@ threadptr_data_type(void)
24
24
  }
25
25
 
26
26
  #define ruby_thread_data_type *threadptr_data_type()
27
+ #define ruby_threadptr_data_type *threadptr_data_type()
27
28
 
28
29
  #define ruby_current_thread ((rb_thread_t *)RTYPEDDATA_DATA(rb_thread_current()))
29
30
 
@@ -78,8 +79,12 @@ binding_alloc(VALUE klass)
78
79
  return obj;
79
80
  }
80
81
 
82
+ static bool ifunc_p(rb_control_frame_t * cfp) {
83
+ return (cfp->flag & VM_FRAME_MAGIC_MASK) == VM_FRAME_MAGIC_IFUNC;
84
+ }
85
+
81
86
  static bool valid_frame_p(rb_control_frame_t * cfp, rb_control_frame_t * limit_cfp) {
82
- return cfp->iseq && !NIL_P(cfp->self);
87
+ return cfp->iseq && !ifunc_p(cfp) && !NIL_P(cfp->self);
83
88
  }
84
89
 
85
90
  static rb_control_frame_t * find_valid_frame(rb_control_frame_t * cfp, rb_control_frame_t * limit_cfp) {
@@ -105,7 +110,6 @@ frametype_name(VALUE flag)
105
110
  case VM_FRAME_MAGIC_BLOCK: return string2sym("block");
106
111
  case VM_FRAME_MAGIC_CLASS: return string2sym("class");
107
112
  case VM_FRAME_MAGIC_TOP: return string2sym("top");
108
- case VM_FRAME_MAGIC_FINISH: return string2sym("finish");
109
113
  case VM_FRAME_MAGIC_CFUNC: return string2sym("cfunc");
110
114
  case VM_FRAME_MAGIC_PROC: return string2sym("proc");
111
115
  case VM_FRAME_MAGIC_IFUNC: return string2sym("ifunc");
@@ -144,10 +148,11 @@ static VALUE binding_of_caller(VALUE self, VALUE rb_level)
144
148
  rb_raise(rb_eRuntimeError, "Can't create Binding Object on top of Fiber.");
145
149
 
146
150
  GetBindingPtr(bindval, bind);
151
+
147
152
  bind->env = rb_vm_make_env_object(th, cfp);
148
153
  bind->filename = cfp->iseq->filename;
149
154
  bind->line_no = rb_vm_get_sourceline(cfp);
150
-
155
+
151
156
  rb_iv_set(bindval, "@frame_type", frametype_name(cfp->flag));
152
157
  rb_iv_set(bindval, "@frame_description", cfp->iseq->name);
153
158
 
@@ -1,13 +1,33 @@
1
- require 'mkmf'
1
+ def fake_makefile
2
+ File.open(File.join(File.dirname(__FILE__), "Makefile"), "w") do |f|
3
+ f.puts %[install:\n\techo "Nada."]
4
+ end
5
+ end
6
+
7
+ def mri_2?
8
+ defined?(RUBY_ENGINE) && RUBY_ENGINE == "ruby" &&
9
+ RUBY_VERSION =~ /^2/
10
+ end
11
+
12
+ def rbx?
13
+ defined?(RUBY_ENGINE) && RUBY_ENGINE =~ /rbx/
14
+ end
15
+
16
+ if mri_2? || rbx?
17
+ fake_makefile
18
+ else
19
+ require 'mkmf'
20
+
21
+ $CFLAGS += " -O0"
22
+ $CFLAGS += " -std=c99"
2
23
 
3
- $CFLAGS += " -O0"
4
- $CFLAGS += " -std=c99"
24
+ case RUBY_VERSION
25
+ when /1.9.2/
26
+ $CFLAGS += " -I./ruby_headers/192/ -DRUBY_192"
27
+ when /1.9.3/
28
+ $CFLAGS += " -I./ruby_headers/193/ -DRUBY_193"
29
+ end
5
30
 
6
- case RUBY_VERSION
7
- when /1.9.2/
8
- $CFLAGS += " -I./ruby_headers/192/ -DRUBY_192"
9
- when /1.9.3/
10
- $CFLAGS += " -I./ruby_headers/193/ -DRUBY_193"
31
+ create_makefile('binding_of_caller')
11
32
  end
12
33
 
13
- create_makefile('binding_of_caller')
@@ -1,13 +1,5 @@
1
1
  #define RUBY_VERSION "1.9.2"
2
- <<<<<<< HEAD
3
- <<<<<<< HEAD
4
- #define RUBY_PATCHLEVEL 34
5
- =======
6
- #define RUBY_PATCHLEVEL 27
7
- >>>>>>> 7f5d559... merges r29155 from trunk into ruby_1_9_2. fixes #3777, #3772 and #3722.
8
- =======
9
2
  #define RUBY_PATCHLEVEL 30
10
- >>>>>>> 13fdd22... merges r29188 from trunk into ruby_1_9_2.
11
3
  #define RUBY_VERSION_MAJOR 1
12
4
  #define RUBY_VERSION_MINOR 9
13
5
  #define RUBY_VERSION_TEENY 1
@@ -0,0 +1,69 @@
1
+ require 'debug_inspector'
2
+
3
+ module BindingOfCaller
4
+ module BindingExtensions
5
+ # Retrieve the binding of the nth caller of the current frame.
6
+ # @return [Binding]
7
+ def of_caller(n)
8
+ c = callers.drop(1)
9
+ if n > (c.size - 1)
10
+ raise "No such frame, gone beyond end of stack!"
11
+ else
12
+ c[n]
13
+ end
14
+ end
15
+
16
+ # Return bindings for all caller frames.
17
+ # @return [Array<Binding>]
18
+ def callers
19
+ ary = []
20
+
21
+ RubyVM::DebugInspector.open do |i|
22
+ n = 0
23
+ loop do
24
+ begin
25
+ b = i.frame_binding(n)
26
+ rescue ArgumentError
27
+ break
28
+ end
29
+
30
+ if b
31
+ b.instance_variable_set(:@iseq, i.frame_iseq(n))
32
+ ary << b
33
+ end
34
+
35
+ n += 1
36
+ end
37
+ end
38
+
39
+ ary.drop(1)
40
+ end
41
+
42
+ # Number of parent frames available at the point of call.
43
+ # @return [Fixnum]
44
+ def frame_count
45
+ callers.size - 1
46
+ end
47
+
48
+ # The type of the frame.
49
+ # @return [Symbol]
50
+ def frame_type
51
+ return nil if !@iseq
52
+
53
+ # apparently the 9th element of the iseq array holds the frame type
54
+ # ...not sure how reliable this is.
55
+ @frame_type ||= @iseq.to_a[9]
56
+ end
57
+
58
+ # The description of the frame.
59
+ # @return [String]
60
+ def frame_description
61
+ return nil if !@iseq
62
+ @frame_description ||= @iseq.label
63
+ end
64
+ end
65
+ end
66
+
67
+ class ::Binding
68
+ include BindingOfCaller::BindingExtensions
69
+ end
@@ -0,0 +1,74 @@
1
+ module BindingOfCaller
2
+ module BindingExtensions
3
+
4
+ # Retrieve the binding of the nth caller of the current frame.
5
+ # @return [Binding]
6
+ def of_caller(n)
7
+ bt = Rubinius::VM.backtrace(1 + n, true).first
8
+
9
+ raise RuntimeError, "Invalid frame, gone beyond end of stack!" if bt.nil?
10
+
11
+ b = Binding.setup(
12
+ bt.variables,
13
+ bt.variables.method,
14
+ bt.constant_scope,
15
+ bt.variables.self,
16
+ bt
17
+ )
18
+
19
+ b.instance_variable_set :@frame_description,
20
+ bt.describe.gsub("{ } in", "block in")
21
+
22
+ b
23
+ end
24
+
25
+ # The description of the frame.
26
+ # @return [String]
27
+ def frame_description
28
+ @frame_description
29
+ end
30
+
31
+ # Return bindings for all caller frames.
32
+ # @return [Array<Binding>]
33
+ def callers
34
+ ary = []
35
+ n = 0
36
+ loop do
37
+ begin
38
+ ary << Binding.of_caller(n)
39
+ rescue
40
+ break
41
+ end
42
+ n += 1
43
+ end
44
+ ary.drop_while do |v|
45
+ !(v.frame_type == :method && v.eval("__method__") == :callers)
46
+ end.drop(1)
47
+ end
48
+
49
+ # Number of parent frames available at the point of call.
50
+ # @return [Fixnum]
51
+ def frame_count
52
+ callers.size - 1
53
+ end
54
+
55
+ # The type of the frame.
56
+ # @return [Symbol]
57
+ def frame_type
58
+ if compiled_code.for_module_body?
59
+ :class
60
+ elsif compiled_code.for_eval?
61
+ :eval
62
+ elsif compiled_code.is_block?
63
+ :block
64
+ else
65
+ :method
66
+ end
67
+ end
68
+ end
69
+ end
70
+
71
+ class ::Binding
72
+ include BindingOfCaller::BindingExtensions
73
+ extend BindingOfCaller::BindingExtensions
74
+ end
@@ -1,3 +1,3 @@
1
- module BindingOfCaller
2
- VERSION = "0.6.2"
3
- end
1
+ module BindingOfCaller
2
+ VERSION = "0.7.2"
3
+ end
@@ -0,0 +1,14 @@
1
+ dlext = RbConfig::CONFIG['DLEXT']
2
+
3
+ def mri_2?
4
+ defined?(RUBY_ENGINE) && RUBY_ENGINE == "ruby" &&
5
+ RUBY_VERSION =~ /^2/
6
+ end
7
+
8
+ if mri_2?
9
+ require 'binding_of_caller/mri2'
10
+ elsif defined?(RUBY_ENGINE) && RUBY_ENGINE == "ruby"
11
+ require "binding_of_caller.#{dlext}"
12
+ elsif defined?(Rubinius)
13
+ require 'binding_of_caller/rubinius'
14
+ end
@@ -0,0 +1,161 @@
1
+ unless Object.const_defined? :BindingOfCaller
2
+ $:.unshift File.expand_path '../../lib', __FILE__
3
+ require 'binding_of_caller'
4
+ require 'binding_of_caller/version'
5
+ end
6
+
7
+ class Module
8
+ public :remove_const
9
+ end
10
+
11
+ puts "Testing binding_of_caller version #{BindingOfCaller::VERSION}..."
12
+ puts "Ruby version: #{RUBY_VERSION}"
13
+
14
+ describe BindingOfCaller do
15
+ describe "of_caller" do
16
+ it "should fetch immediate caller's binding when 0 is passed" do
17
+ o = Object.new
18
+ def o.a
19
+ var = 1
20
+ binding.of_caller(0).eval('var')
21
+ end
22
+
23
+ o. a.should == 1
24
+ end
25
+
26
+ it "should fetch parent of caller's binding when 1 is passed" do
27
+ o = Object.new
28
+ def o.a
29
+ var = 1
30
+ b
31
+ end
32
+
33
+ def o.b
34
+ binding.of_caller(1).eval('var')
35
+ end
36
+
37
+ o.a.should == 1
38
+ end
39
+
40
+ it "should modify locals in parent of caller's binding" do
41
+ o = Object.new
42
+ def o.a
43
+ var = 1
44
+ b
45
+ var
46
+ end
47
+
48
+ def o.b
49
+ binding.of_caller(1).eval('var = 20')
50
+ end
51
+
52
+ o.a.should == 20
53
+ end
54
+
55
+ it "should raise an exception when retrieving an out of band binding" do
56
+ o = Object.new
57
+ def o.a
58
+ binding.of_caller(100)
59
+ end
60
+
61
+ lambda { o.a }.should.raise RuntimeError
62
+ end
63
+ end
64
+
65
+ describe "callers" do
66
+ before do
67
+ @o = Object.new
68
+ end
69
+
70
+ it 'should return the first non-internal binding when using callers.first' do
71
+ def @o.meth
72
+ x = :a_local
73
+ [binding.callers.first, binding.of_caller(0)]
74
+ end
75
+
76
+ b1, b2 = @o.meth
77
+ b1.eval("x").should == :a_local
78
+ b2.eval("x").should == :a_local
79
+ end
80
+ end
81
+
82
+ describe "frame_count" do
83
+ it 'frame_count should equal callers.count' do
84
+ binding.frame_count.should == binding.callers.count
85
+ end
86
+ end
87
+
88
+ describe "frame_descripton" do
89
+ it 'can be called on ordinary binding without raising' do
90
+ lambda { binding.frame_description }.should.not.raise
91
+ end
92
+
93
+ it 'describes a block frame' do
94
+ binding.of_caller(0).frame_description.should =~ /block/
95
+ end
96
+
97
+ it 'describes a method frame' do
98
+ o = Object.new
99
+ def o.horsey_malone
100
+ binding.of_caller(0).frame_description.should =~ /horsey_malone/
101
+ end
102
+ o.horsey_malone
103
+ end
104
+
105
+ it 'describes a class frame' do
106
+ class HorseyMalone
107
+ binding.of_caller(0).frame_description.should =~ /class/i
108
+ end
109
+ Object.remove_const(:HorseyMalone)
110
+ end
111
+ end
112
+
113
+ describe "frame_type" do
114
+ it 'can be called on ordinary binding without raising' do
115
+ lambda { binding.frame_type }.should.not.raise
116
+ end
117
+
118
+ describe "when inside a class definition" do
119
+ before do
120
+ class HorseyMalone
121
+ @binding = binding.of_caller(0)
122
+ def self.binding; @binding; end
123
+ end
124
+ @binding = HorseyMalone.binding
125
+ end
126
+
127
+ it 'returns :class' do
128
+ @binding.frame_type.should == :class
129
+ end
130
+ end
131
+
132
+ describe "when evaluated" do
133
+ before { @binding = eval("binding.of_caller(0)") }
134
+
135
+ it 'returns :eval' do
136
+ @binding.frame_type.should == :eval
137
+ end
138
+ end
139
+
140
+ describe "when inside a block" do
141
+ before { @binding = proc { binding.of_caller(0) }.call }
142
+
143
+ it 'returns :block' do
144
+ @binding.frame_type.should == :block
145
+ end
146
+ end
147
+
148
+ describe "when inside an instance method" do
149
+ before do
150
+ o = Object.new
151
+ def o.a; binding.of_caller(0); end
152
+ @binding = o.a;
153
+ end
154
+
155
+ it 'returns :method' do
156
+ @binding.frame_type.should == :method
157
+ end
158
+ end
159
+ end
160
+ end
161
+
metadata CHANGED
@@ -1,29 +1,59 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: binding_of_caller
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.6.2
5
- prerelease:
4
+ version: 0.7.2
6
5
  platform: ruby
7
6
  authors:
8
7
  - John Mair (banisterfiend)
9
8
  autorequire:
10
9
  bindir: bin
11
10
  cert_chain: []
12
- date: 2012-02-02 00:00:00.000000000Z
11
+ date: 2013-06-07 00:00:00.000000000 Z
13
12
  dependencies:
13
+ - !ruby/object:Gem::Dependency
14
+ name: debug_inspector
15
+ requirement: !ruby/object:Gem::Requirement
16
+ requirements:
17
+ - - '>='
18
+ - !ruby/object:Gem::Version
19
+ version: 0.0.1
20
+ type: :runtime
21
+ prerelease: false
22
+ version_requirements: !ruby/object:Gem::Requirement
23
+ requirements:
24
+ - - '>='
25
+ - !ruby/object:Gem::Version
26
+ version: 0.0.1
14
27
  - !ruby/object:Gem::Dependency
15
28
  name: bacon
16
- requirement: &70103760947940 !ruby/object:Gem::Requirement
17
- none: false
29
+ requirement: !ruby/object:Gem::Requirement
30
+ requirements:
31
+ - - '>='
32
+ - !ruby/object:Gem::Version
33
+ version: '0'
34
+ type: :development
35
+ prerelease: false
36
+ version_requirements: !ruby/object:Gem::Requirement
37
+ requirements:
38
+ - - '>='
39
+ - !ruby/object:Gem::Version
40
+ version: '0'
41
+ - !ruby/object:Gem::Dependency
42
+ name: rake
43
+ requirement: !ruby/object:Gem::Requirement
18
44
  requirements:
19
- - - ~>
45
+ - - '>='
20
46
  - !ruby/object:Gem::Version
21
- version: '1.1'
47
+ version: '0'
22
48
  type: :development
23
49
  prerelease: false
24
- version_requirements: *70103760947940
50
+ version_requirements: !ruby/object:Gem::Requirement
51
+ requirements:
52
+ - - '>='
53
+ - !ruby/object:Gem::Version
54
+ version: '0'
25
55
  description: Retrieve the binding of a method's caller. Can also retrieve bindings
26
- even further up the stack. Currently only works for MRI 1.9.2+
56
+ even further up the stack.
27
57
  email: jrmair@gmail.com
28
58
  executables: []
29
59
  extensions:
@@ -32,18 +62,20 @@ extra_rdoc_files: []
32
62
  files:
33
63
  - .gemtest
34
64
  - .gitignore
65
+ - .travis.yml
35
66
  - .yardopts
67
+ - Gemfile
36
68
  - HISTORY
37
69
  - LICENSE
38
70
  - README.md
39
71
  - Rakefile
72
+ - binding_of_caller.gemspec
40
73
  - examples/example.rb
41
74
  - ext/binding_of_caller/binding_of_caller.c
42
75
  - ext/binding_of_caller/extconf.rb
43
76
  - ext/binding_of_caller/ruby_headers/192/debug.h
44
77
  - ext/binding_of_caller/ruby_headers/192/dln.h
45
78
  - ext/binding_of_caller/ruby_headers/192/eval_intern.h
46
- - ext/binding_of_caller/ruby_headers/192/gc.h
47
79
  - ext/binding_of_caller/ruby_headers/192/id.h
48
80
  - ext/binding_of_caller/ruby_headers/192/iseq.h
49
81
  - ext/binding_of_caller/ruby_headers/192/method.h
@@ -51,6 +83,7 @@ files:
51
83
  - ext/binding_of_caller/ruby_headers/192/regenc.h
52
84
  - ext/binding_of_caller/ruby_headers/192/regint.h
53
85
  - ext/binding_of_caller/ruby_headers/192/regparse.h
86
+ - ext/binding_of_caller/ruby_headers/192/rubys_gc.h
54
87
  - ext/binding_of_caller/ruby_headers/192/thread_pthread.h
55
88
  - ext/binding_of_caller/ruby_headers/192/thread_win32.h
56
89
  - ext/binding_of_caller/ruby_headers/192/timev.h
@@ -67,7 +100,6 @@ files:
67
100
  - ext/binding_of_caller/ruby_headers/193/dln.h
68
101
  - ext/binding_of_caller/ruby_headers/193/encdb.h
69
102
  - ext/binding_of_caller/ruby_headers/193/eval_intern.h
70
- - ext/binding_of_caller/ruby_headers/193/gc.h
71
103
  - ext/binding_of_caller/ruby_headers/193/id.h
72
104
  - ext/binding_of_caller/ruby_headers/193/internal.h
73
105
  - ext/binding_of_caller/ruby_headers/193/iseq.h
@@ -78,6 +110,7 @@ files:
78
110
  - ext/binding_of_caller/ruby_headers/193/regint.h
79
111
  - ext/binding_of_caller/ruby_headers/193/regparse.h
80
112
  - ext/binding_of_caller/ruby_headers/193/revision.h
113
+ - ext/binding_of_caller/ruby_headers/193/rubys_gc.h
81
114
  - ext/binding_of_caller/ruby_headers/193/thread_pthread.h
82
115
  - ext/binding_of_caller/ruby_headers/193/thread_win32.h
83
116
  - ext/binding_of_caller/ruby_headers/193/timev.h
@@ -88,32 +121,34 @@ files:
88
121
  - ext/binding_of_caller/ruby_headers/193/vm_exec.h
89
122
  - ext/binding_of_caller/ruby_headers/193/vm_insnhelper.h
90
123
  - ext/binding_of_caller/ruby_headers/193/vm_opts.h
124
+ - lib/binding_of_caller.rb
125
+ - lib/binding_of_caller/mri2.rb
126
+ - lib/binding_of_caller/rubinius.rb
91
127
  - lib/binding_of_caller/version.rb
92
- - test/test.rb
128
+ - test/test_binding_of_caller.rb
93
129
  homepage: http://github.com/banister/binding_of_caller
94
130
  licenses: []
131
+ metadata: {}
95
132
  post_install_message:
96
133
  rdoc_options: []
97
134
  require_paths:
98
135
  - lib
99
136
  required_ruby_version: !ruby/object:Gem::Requirement
100
- none: false
101
137
  requirements:
102
- - - ! '>='
138
+ - - '>='
103
139
  - !ruby/object:Gem::Version
104
- version: 1.9.2
140
+ version: '0'
105
141
  required_rubygems_version: !ruby/object:Gem::Requirement
106
- none: false
107
142
  requirements:
108
- - - ! '>='
143
+ - - '>='
109
144
  - !ruby/object:Gem::Version
110
145
  version: '0'
111
146
  requirements: []
112
147
  rubyforge_project:
113
- rubygems_version: 1.8.6
148
+ rubygems_version: 2.0.3
114
149
  signing_key:
115
- specification_version: 3
150
+ specification_version: 4
116
151
  summary: Retrieve the binding of a method's caller. Can also retrieve bindings even
117
- further up the stack. Currently only works for MRI 1.9.2+
152
+ further up the stack.
118
153
  test_files:
119
- - test/test.rb
154
+ - test/test_binding_of_caller.rb
data/test/test.rb DELETED
@@ -1,91 +0,0 @@
1
- unless Object.const_defined? :BindingOfCaller
2
- $:.unshift File.expand_path '../../lib', __FILE__
3
- require 'binding_of_caller'
4
- require 'binding_of_caller/version'
5
- end
6
-
7
- puts "Testing binding_of_caller version #{BindingOfCaller::VERSION}..."
8
- puts "Ruby version: #{RUBY_VERSION}"
9
-
10
- describe BindingOfCaller do
11
- describe "of_caller" do
12
- it "should fetch immediate caller's binding when 0 is passed" do
13
- o = Object.new
14
- def o.a
15
- var = 1
16
- binding.of_caller(0).eval('var')
17
- end
18
-
19
- o. a.should == 1
20
- end
21
-
22
- it "should fetch parent of caller's binding when 1 is passed" do
23
- o = Object.new
24
- def o.a
25
- var = 1
26
- b
27
- end
28
-
29
- def o.b
30
- binding.of_caller(1).eval('var')
31
- end
32
-
33
- o.a.should == 1
34
- end
35
-
36
- it "should modify locals in parent of caller's binding" do
37
- o = Object.new
38
- def o.a
39
- var = 1
40
- b
41
- var
42
- end
43
-
44
- def o.b
45
- binding.of_caller(1).eval('var = 20')
46
- end
47
-
48
- o.a.should == 20
49
- end
50
-
51
- it "should raise an exception when retrieving an out of band binding" do
52
- o = Object.new
53
- def o.a
54
- binding.of_caller(100)
55
- end
56
-
57
- lambda { o.a }.should.raise RuntimeError
58
- end
59
- end
60
-
61
- describe "frame_count" do
62
- it 'frame_count should equal callers.count' do
63
- binding.frame_count.should == binding.callers.count
64
- end
65
- end
66
-
67
- describe "frame_type" do
68
- it 'should return the correct frame types' do
69
- o = Object.new
70
-
71
- # method frame
72
- def o.a
73
- b
74
- end
75
-
76
- # method frame
77
- def o.b
78
- # block frame
79
- proc do
80
- binding.callers
81
- end.call
82
- end
83
- caller_bindings = o.a
84
- caller_bindings[0].frame_type.should == :block
85
- caller_bindings[1].frame_type.should == :method
86
- caller_bindings[2].frame_type.should == :method
87
- end
88
-
89
- end
90
- end
91
-