pry-debugger-jruby 1.0.0-java
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 +7 -0
- data/.gitignore +17 -0
- data/.ruby-version +1 -0
- data/CHANGELOG.md +41 -0
- data/Gemfile +3 -0
- data/LICENSE +21 -0
- data/README.md +111 -0
- data/Rakefile +1 -0
- data/lib/pry-debugger-jruby.rb +8 -0
- data/lib/pry-debugger-jruby/base.rb +15 -0
- data/lib/pry-debugger-jruby/breakpoints.rb +94 -0
- data/lib/pry-debugger-jruby/cli.rb +15 -0
- data/lib/pry-debugger-jruby/commands.rb +252 -0
- data/lib/pry-debugger-jruby/processor.rb +147 -0
- data/lib/pry-debugger-jruby/pry_ext.rb +23 -0
- data/lib/pry-debugger-jruby/pry_remote_ext.rb +38 -0
- data/lib/pry-debugger-jruby/version.rb +3 -0
- data/pry-debugger-jruby.gemspec +29 -0
- metadata +122 -0
checksums.yaml
ADDED
@@ -0,0 +1,7 @@
|
|
1
|
+
---
|
2
|
+
SHA1:
|
3
|
+
metadata.gz: 81ff16ce021c8e8175681bf7680c0aaf3265d74e
|
4
|
+
data.tar.gz: 7a8faa1b0040ae47666c530080924cff69541c5e
|
5
|
+
SHA512:
|
6
|
+
metadata.gz: 4226ab1696b4932d899e25b5886ced67d816c42b4531fff5ea488a23652a02ac083522b212dc8684f055113452d405872f18abf4c3338aa04eb6c341cd821e3f
|
7
|
+
data.tar.gz: 7e13eee633369b8f0ed1745e5a934ee45b5406c6c9f3c9acd055180b4ef46877f4038f1bc8adfbdd17cf68a76a4d5c0a84c255426074cb5f08050cf2efecab45
|
data/.gitignore
ADDED
data/.ruby-version
ADDED
@@ -0,0 +1 @@
|
|
1
|
+
jruby-9.1.5.0
|
data/CHANGELOG.md
ADDED
@@ -0,0 +1,41 @@
|
|
1
|
+
## 1.0.0 (2016-12-01)
|
2
|
+
|
3
|
+
* Revamp documentation for JRuby usage
|
4
|
+
* Add workaround for using `step` in JRuby
|
5
|
+
* Fix circular require warning
|
6
|
+
* Fixed missing banner in commands causing uninitialized variable warning
|
7
|
+
* Drop support for ruby < 2.2
|
8
|
+
* Officially forked from `pry-debugger`, renaming gem to `pry-debugger-jruby` and releasing on RubyGems
|
9
|
+
|
10
|
+
## 0.2.3 (2014-07-02)
|
11
|
+
|
12
|
+
* Support [pry] 0.10
|
13
|
+
|
14
|
+
## 0.2.2 (2013-03-07)
|
15
|
+
|
16
|
+
* Relaxed [debugger][debugger] dependency.
|
17
|
+
|
18
|
+
## 0.2.1 (2012-12-26)
|
19
|
+
|
20
|
+
* Support breakpoints on methods defined in the pry console. (@banister)
|
21
|
+
* Fix support for specifying breakpoints by *file:line_number*. (@nviennot)
|
22
|
+
* Validate breakpoint conditionals are real Ruby expressions.
|
23
|
+
* Support for [debugger][debugger] ~> 1.2.0. (@jshou)
|
24
|
+
* Safer `alias_method_chain`-style patching of `Pry.start` and
|
25
|
+
`PryRemote::Server#teardown`. (@benizi)
|
26
|
+
|
27
|
+
## 0.2.0 (2012-06-11)
|
28
|
+
|
29
|
+
* Breakpoints
|
30
|
+
* **finish** command
|
31
|
+
* Internal cleanup and bug fixes
|
32
|
+
|
33
|
+
## 0.1.0 (2012-06-07)
|
34
|
+
|
35
|
+
* First release. **step**, **next**, and **continue** commands.
|
36
|
+
[pry-remote 0.1.4][pry-remote] support.
|
37
|
+
|
38
|
+
|
39
|
+
[pry]: http://pryrepl.org/
|
40
|
+
[pry-remote]: https://github.com/Mon-Ouie/pry-remote
|
41
|
+
[debugger]: https://github.com/cldwalker/debugger
|
data/Gemfile
ADDED
data/LICENSE
ADDED
@@ -0,0 +1,21 @@
|
|
1
|
+
MIT/Expat License
|
2
|
+
|
3
|
+
Copyright (c) 2016 by Ivo Anjo
|
4
|
+
Copyright (c) 2012 by Gopal Patel
|
5
|
+
|
6
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy of
|
7
|
+
this software and associated documentation files (the "Software"), to deal in
|
8
|
+
the Software without restriction, including without limitation the rights to
|
9
|
+
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
10
|
+
the Software, and to permit persons to whom the Software is furnished to do so,
|
11
|
+
subject to the following conditions:
|
12
|
+
|
13
|
+
The above copyright notice and this permission notice shall be included in all
|
14
|
+
copies or substantial portions of the Software.
|
15
|
+
|
16
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
17
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
18
|
+
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
19
|
+
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
20
|
+
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
21
|
+
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
data/README.md
ADDED
@@ -0,0 +1,111 @@
|
|
1
|
+
# pry-debugger-jruby
|
2
|
+
|
3
|
+
_JRuby 9k-compatible pry debugging!_
|
4
|
+
|
5
|
+
Using MRI? I strongly recommend [`pry-byebug`](https://github.com/deivid-rodriguez/pry-byebug) instead!
|
6
|
+
|
7
|
+
Adds `step`, `next`, `finish`, and `continue` commands and `breakpoints` to [Pry](http://pry.github.com).
|
8
|
+
|
9
|
+
To use, run JRuby with the `--debug` flag, and then invoke `pry` normally:
|
10
|
+
|
11
|
+
```ruby
|
12
|
+
def some_method
|
13
|
+
binding.pry # Execution will stop here.
|
14
|
+
puts 'Hello, World!' # Run 'step' or 'next' in the console to move here.
|
15
|
+
end
|
16
|
+
```
|
17
|
+
|
18
|
+
You can also add the `--debug` flag to your `JRUBY_OPTS` environment variable, so it will be picked up by any ruby application. Do note that running `JRuby` in debug mode **does** have a noticeable impact on performance.
|
19
|
+
|
20
|
+
## Execution Commands
|
21
|
+
|
22
|
+
* `step`: Step execution into the next line or method. Takes an optional numeric argument to step multiple times.
|
23
|
+
|
24
|
+
* `next`: Step over to the next line within the same frame. Also takes an optional numeric argument to step multiple lines.
|
25
|
+
|
26
|
+
* `finish`: Execute until current stack frame returns.
|
27
|
+
|
28
|
+
* `continue`: Continue program execution and end the Pry session.
|
29
|
+
|
30
|
+
## Breakpoints
|
31
|
+
|
32
|
+
You can set and adjust breakpoints directly from a Pry session using the following commands:
|
33
|
+
|
34
|
+
* `break`: Set a new breakpoint from a line number in the current file, a file and line number, or a method. Pass an optional expression to create a conditional breakpoint. Edit existing breakpoints via various flags.
|
35
|
+
|
36
|
+
Examples:
|
37
|
+
|
38
|
+
```ruby
|
39
|
+
break SomeClass#run Break at the start of `SomeClass#run`.
|
40
|
+
break Foo#bar if baz? Break at `Foo#bar` only if `baz?`.
|
41
|
+
break app/models/user.rb:15 Break at line 15 in user.rb.
|
42
|
+
break 14 Break at line 14 in the current file.
|
43
|
+
|
44
|
+
break --condition 4 x > 2 Change condition on breakpoint #4 to 'x > 2'.
|
45
|
+
break --condition 3 Remove the condition on breakpoint #3.
|
46
|
+
|
47
|
+
break --delete 5 Delete breakpoint #5.
|
48
|
+
break --disable-all Disable all breakpoints.
|
49
|
+
|
50
|
+
break List all breakpoints. (Same as `breakpoints`)
|
51
|
+
break --show 2 Show details about breakpoint #2.
|
52
|
+
```
|
53
|
+
|
54
|
+
Type `break --help` from a Pry session to see all available options.
|
55
|
+
|
56
|
+
* `breakpoints`: List all defined breakpoints. Pass `-v` or `--verbose` to see the source code around each breakpoint.
|
57
|
+
|
58
|
+
## Remote debugging
|
59
|
+
|
60
|
+
Support for [pry-remote](https://github.com/Mon-Ouie/pry-remote) is also included. Requires explicity requiring `pry-debugger-jruby`, not just relying on pry's plugin loader.
|
61
|
+
|
62
|
+
Want to debug a Rails app running inside `foreman`? Add to your `Gemfile`:
|
63
|
+
|
64
|
+
```ruby
|
65
|
+
gem 'pry'
|
66
|
+
gem 'pry-remote'
|
67
|
+
gem 'pry-debugger-jruby'
|
68
|
+
```
|
69
|
+
|
70
|
+
Then add `binding.remote_pry` where you want to pause:
|
71
|
+
|
72
|
+
```ruby
|
73
|
+
class UsersController < ApplicationController
|
74
|
+
def index
|
75
|
+
binding.remote_pry
|
76
|
+
# ...
|
77
|
+
end
|
78
|
+
end
|
79
|
+
```
|
80
|
+
|
81
|
+
Load a page that triggers the code. Connect to the session:
|
82
|
+
|
83
|
+
```bash
|
84
|
+
$ bundle exec pry-remote
|
85
|
+
```
|
86
|
+
|
87
|
+
## Tips
|
88
|
+
|
89
|
+
Stepping through code often? Add the following shortcuts to `~/.pryrc`:
|
90
|
+
|
91
|
+
```ruby
|
92
|
+
if defined?(PryDebuggerJRuby)
|
93
|
+
Pry.commands.alias_command 'c', 'continue'
|
94
|
+
Pry.commands.alias_command 's', 'step'
|
95
|
+
Pry.commands.alias_command 'n', 'next'
|
96
|
+
Pry.commands.alias_command 'f', 'finish'
|
97
|
+
end
|
98
|
+
```
|
99
|
+
|
100
|
+
## Contributors
|
101
|
+
|
102
|
+
`pry-debugger-jruby` is maintained by [@ivoanjo](https://github.com/ivoanjo/) and is based off the awesome previous work from the [`pry-debugger`](https://github.com/nixme/pry-debugger) creators:
|
103
|
+
|
104
|
+
* Gopal Patel (@nixme)
|
105
|
+
* John Mair (@banister)
|
106
|
+
* Nicolas Viennot (@nviennot)
|
107
|
+
* Benjamin R. Haskell (@benizi)
|
108
|
+
* Joshua Hou (@jshou)
|
109
|
+
* ...and others who helped with [`pry-nav`](https://github.com/nixme/pry-nav)
|
110
|
+
|
111
|
+
Patches and bug reports are welcome. Just send in a pull request or issue :)
|
data/Rakefile
ADDED
@@ -0,0 +1 @@
|
|
1
|
+
require 'bundler/gem_tasks'
|
@@ -0,0 +1,15 @@
|
|
1
|
+
module PryDebuggerJRuby
|
2
|
+
TRACE_IGNORE_FILES = Dir[File.join(File.dirname(__FILE__), '..', '**', '*.rb')].map { |f| File.expand_path(f) }
|
3
|
+
|
4
|
+
extend self
|
5
|
+
|
6
|
+
# Checks that a binding is in a local file context. Extracted from
|
7
|
+
# https://github.com/pry/pry/blob/master/lib/pry/default_commands/context.rb
|
8
|
+
def check_file_context(target)
|
9
|
+
file = target.eval('__FILE__')
|
10
|
+
file == Pry.eval_path || (file !~ /(\(.*\))|<.*>/ && file != '' && file != '-e')
|
11
|
+
end
|
12
|
+
|
13
|
+
# Reference to currently running pry-remote server. Used by the processor.
|
14
|
+
attr_accessor :current_remote_server
|
15
|
+
end
|
@@ -0,0 +1,94 @@
|
|
1
|
+
module PryDebuggerJRuby
|
2
|
+
# Wrapper for Debugger.breakpoints that respects our Processor and has better
|
3
|
+
# failure behavior. Acts as an Enumerable.
|
4
|
+
#
|
5
|
+
module Breakpoints
|
6
|
+
extend Enumerable
|
7
|
+
extend self
|
8
|
+
|
9
|
+
# Add a new breakpoint.
|
10
|
+
def add(file, line, expression = nil)
|
11
|
+
real_file = (file != Pry.eval_path)
|
12
|
+
raise ArgumentError, 'Invalid file!' if real_file && !File.exist?(file)
|
13
|
+
validate_expression expression
|
14
|
+
|
15
|
+
Pry.processor.debugging = true
|
16
|
+
|
17
|
+
path = (real_file ? File.expand_path(file) : file)
|
18
|
+
Debugger.add_breakpoint(path, line, expression)
|
19
|
+
end
|
20
|
+
|
21
|
+
# Change the conditional expression for a breakpoint.
|
22
|
+
def change(id, expression = nil)
|
23
|
+
validate_expression expression
|
24
|
+
|
25
|
+
breakpoint = find_by_id(id)
|
26
|
+
breakpoint.expr = expression
|
27
|
+
breakpoint
|
28
|
+
end
|
29
|
+
|
30
|
+
# Delete an existing breakpoint with the given ID.
|
31
|
+
def delete(id)
|
32
|
+
unless Debugger.started? && Debugger.remove_breakpoint(id)
|
33
|
+
raise ArgumentError, "No breakpoint ##{id}"
|
34
|
+
end
|
35
|
+
Pry.processor.debugging = false if to_a.empty?
|
36
|
+
end
|
37
|
+
|
38
|
+
# Delete all breakpoints.
|
39
|
+
def clear
|
40
|
+
Debugger.breakpoints.clear if Debugger.started?
|
41
|
+
Pry.processor.debugging = false
|
42
|
+
end
|
43
|
+
|
44
|
+
# Enable a disabled breakpoint with the given ID.
|
45
|
+
def enable(id)
|
46
|
+
change_status id, true
|
47
|
+
end
|
48
|
+
|
49
|
+
# Disable a breakpoint with the given ID.
|
50
|
+
def disable(id)
|
51
|
+
change_status id, false
|
52
|
+
end
|
53
|
+
|
54
|
+
# Disable all breakpoints.
|
55
|
+
def disable_all
|
56
|
+
each do |breakpoint|
|
57
|
+
breakpoint.enabled = false
|
58
|
+
end
|
59
|
+
end
|
60
|
+
|
61
|
+
def to_a
|
62
|
+
Debugger.started? ? Debugger.breakpoints : []
|
63
|
+
end
|
64
|
+
|
65
|
+
def size
|
66
|
+
to_a.size
|
67
|
+
end
|
68
|
+
|
69
|
+
def each(&block)
|
70
|
+
to_a.each(&block)
|
71
|
+
end
|
72
|
+
|
73
|
+
def find_by_id(id)
|
74
|
+
breakpoint = find { |b| b.id == id }
|
75
|
+
raise ArgumentError, "No breakpoint ##{id}!" unless breakpoint
|
76
|
+
breakpoint
|
77
|
+
end
|
78
|
+
|
79
|
+
private
|
80
|
+
|
81
|
+
def change_status(id, enabled = true)
|
82
|
+
breakpoint = find_by_id(id)
|
83
|
+
breakpoint.enabled = enabled
|
84
|
+
breakpoint
|
85
|
+
end
|
86
|
+
|
87
|
+
def validate_expression(expression)
|
88
|
+
if expression && # `nil` implies no expression given, so pass
|
89
|
+
(expression.empty? || !Pry::Code.complete_expression?(expression))
|
90
|
+
raise "Invalid breakpoint conditional: #{expression}"
|
91
|
+
end
|
92
|
+
end
|
93
|
+
end
|
94
|
+
end
|
@@ -0,0 +1,15 @@
|
|
1
|
+
# Pry's new plugin loading system ensures this file runs before pry-remote. So
|
2
|
+
# attempting to load everything directly from lib/pry-debugger-jruby.rb and
|
3
|
+
# referencing that here causes a circular dependency when running
|
4
|
+
# bin/pry-remote.
|
5
|
+
#
|
6
|
+
# So delay loading our monkey-patch to when someone explicity does a:
|
7
|
+
#
|
8
|
+
# require 'pry-debugger-jruby'
|
9
|
+
#
|
10
|
+
# Load everything else here.
|
11
|
+
#
|
12
|
+
|
13
|
+
require 'pry-debugger-jruby/base'
|
14
|
+
require 'pry-debugger-jruby/pry_ext'
|
15
|
+
require 'pry-debugger-jruby/commands'
|
@@ -0,0 +1,252 @@
|
|
1
|
+
require 'pry' unless defined? Pry
|
2
|
+
require 'pry-debugger-jruby/breakpoints'
|
3
|
+
|
4
|
+
module PryDebuggerJRuby
|
5
|
+
Commands = Pry::CommandSet.new do
|
6
|
+
create_command 'step' do
|
7
|
+
description 'Step execution into the next line or method.'
|
8
|
+
|
9
|
+
banner <<-BANNER
|
10
|
+
Usage: step [TIMES]
|
11
|
+
|
12
|
+
Step execution forward. By default, moves a single step.
|
13
|
+
|
14
|
+
Examples:
|
15
|
+
|
16
|
+
step Move a single step forward.
|
17
|
+
step 5 Execute the next 5 steps.
|
18
|
+
BANNER
|
19
|
+
|
20
|
+
def process
|
21
|
+
check_file_context
|
22
|
+
breakout_navigation :step, args.first
|
23
|
+
end
|
24
|
+
end
|
25
|
+
|
26
|
+
create_command 'next' do
|
27
|
+
description 'Execute the next line within the current stack frame.'
|
28
|
+
|
29
|
+
banner <<-BANNER
|
30
|
+
Usage: next [LINES]
|
31
|
+
|
32
|
+
Step over within the same frame. By default, moves forward a single
|
33
|
+
line.
|
34
|
+
|
35
|
+
Examples:
|
36
|
+
|
37
|
+
next Move a single line forward.
|
38
|
+
next 4 Execute the next 4 lines.
|
39
|
+
BANNER
|
40
|
+
|
41
|
+
def process
|
42
|
+
check_file_context
|
43
|
+
breakout_navigation :next, args.first
|
44
|
+
end
|
45
|
+
end
|
46
|
+
|
47
|
+
create_command 'finish' do
|
48
|
+
description 'Execute until current stack frame returns.'
|
49
|
+
|
50
|
+
banner <<-BANNER
|
51
|
+
Usage: finish
|
52
|
+
|
53
|
+
Execute until current stack frame returns.
|
54
|
+
BANNER
|
55
|
+
|
56
|
+
def process
|
57
|
+
check_file_context
|
58
|
+
breakout_navigation :finish
|
59
|
+
end
|
60
|
+
end
|
61
|
+
|
62
|
+
create_command 'continue' do
|
63
|
+
description 'End the Pry session and continue program execution.'
|
64
|
+
|
65
|
+
banner <<-BANNER
|
66
|
+
Usage: finish
|
67
|
+
|
68
|
+
End the Pry session and continue program execution.
|
69
|
+
BANNER
|
70
|
+
|
71
|
+
def process
|
72
|
+
check_file_context
|
73
|
+
run 'exit-all'
|
74
|
+
end
|
75
|
+
end
|
76
|
+
|
77
|
+
create_command 'break' do
|
78
|
+
description 'Set or edit a breakpoint.'
|
79
|
+
|
80
|
+
banner <<-BANNER
|
81
|
+
Usage: break <METHOD | FILE:LINE | LINE> [if CONDITION]
|
82
|
+
break --condition N [CONDITION]
|
83
|
+
break [--show | --delete | --enable | --disable] N
|
84
|
+
break [--delete-all | --disable-all]
|
85
|
+
Aliases: breakpoint
|
86
|
+
|
87
|
+
Set a breakpoint. Accepts a line number in the current file, a file and
|
88
|
+
line number, or a method, and an optional condition.
|
89
|
+
|
90
|
+
Pass appropriate flags to manipulate existing breakpoints.
|
91
|
+
|
92
|
+
Examples:
|
93
|
+
|
94
|
+
break SomeClass#run Break at the start of `SomeClass#run`.
|
95
|
+
break Foo#bar if baz? Break at `Foo#bar` only if `baz?`.
|
96
|
+
break app/models/user.rb:15 Break at line 15 in user.rb.
|
97
|
+
break 14 Break at line 14 in the current file.
|
98
|
+
|
99
|
+
break --condition 4 x > 2 Add/change condition on breakpoint #4.
|
100
|
+
break --condition 3 Remove the condition on breakpoint #3.
|
101
|
+
|
102
|
+
break --delete 5 Delete breakpoint #5.
|
103
|
+
break --disable-all Disable all breakpoints.
|
104
|
+
|
105
|
+
break List all breakpoints. (Same as `breakpoints`)
|
106
|
+
break --show 2 Show details about breakpoint #2.
|
107
|
+
BANNER
|
108
|
+
|
109
|
+
def options(opt)
|
110
|
+
opt.on :c, :condition, 'Change the condition of a breakpoint.', argument: true, as: Integer
|
111
|
+
opt.on :s, :show, 'Show breakpoint details and source.', argument: true, as: Integer
|
112
|
+
opt.on :D, :delete, 'Delete a breakpoint.', argument: true, as: Integer
|
113
|
+
opt.on :d, :disable, 'Disable a breakpoint.', argument: true, as: Integer
|
114
|
+
opt.on :e, :enable, 'Enable a disabled breakpoint.', argument: true, as: Integer
|
115
|
+
opt.on :'disable-all', 'Disable all breakpoints.'
|
116
|
+
opt.on :'delete-all', 'Delete all breakpoints.'
|
117
|
+
method_options(opt)
|
118
|
+
end
|
119
|
+
|
120
|
+
def process
|
121
|
+
Pry.processor.pry = _pry_
|
122
|
+
|
123
|
+
{
|
124
|
+
delete: :delete,
|
125
|
+
disable: :disable,
|
126
|
+
enable: :enable,
|
127
|
+
'disable-all': :disable_all,
|
128
|
+
'delete-all': :clear,
|
129
|
+
}.each do |action, method|
|
130
|
+
if opts.present?(action)
|
131
|
+
Breakpoints.__send__ method, *(method == action ? [opts[action]] : [])
|
132
|
+
return run 'breakpoints'
|
133
|
+
end
|
134
|
+
end
|
135
|
+
|
136
|
+
if opts.present?(:condition)
|
137
|
+
Breakpoints.change(opts[:condition], args.empty? ? nil : args.join(' '))
|
138
|
+
run 'breakpoints'
|
139
|
+
elsif opts.present?(:show)
|
140
|
+
print_full_breakpoint Breakpoints.find_by_id(opts[:show])
|
141
|
+
elsif args.empty?
|
142
|
+
run 'breakpoints'
|
143
|
+
else
|
144
|
+
new_breakpoint
|
145
|
+
end
|
146
|
+
end
|
147
|
+
|
148
|
+
def new_breakpoint
|
149
|
+
place = args.shift
|
150
|
+
condition = args.join(' ') if 'if' == args.shift
|
151
|
+
|
152
|
+
file, line =
|
153
|
+
case place
|
154
|
+
when /^(\d+)$/ # Line number only
|
155
|
+
line = $1
|
156
|
+
unless PryDebuggerJRuby.check_file_context(target)
|
157
|
+
raise ArgumentError, 'Line number declaration valid only in a file context.'
|
158
|
+
end
|
159
|
+
[target.eval('__FILE__'), line]
|
160
|
+
when /^(.+):(\d+)$/ # File and line number
|
161
|
+
[$1, $2]
|
162
|
+
else # Method or class name
|
163
|
+
self.args = [place]
|
164
|
+
method_object.source_location
|
165
|
+
end
|
166
|
+
|
167
|
+
print_full_breakpoint Breakpoints.add(file, line.to_i, condition)
|
168
|
+
end
|
169
|
+
end
|
170
|
+
alias_command 'breakpoint', 'break'
|
171
|
+
|
172
|
+
create_command 'breakpoints' do
|
173
|
+
description 'List defined breakpoints.'
|
174
|
+
|
175
|
+
banner <<-BANNER
|
176
|
+
Usage: breakpoints [OPTIONS]
|
177
|
+
Aliases: breaks
|
178
|
+
|
179
|
+
List registered breakpoints and their current status.
|
180
|
+
BANNER
|
181
|
+
|
182
|
+
def options(opt)
|
183
|
+
opt.on :v, :verbose, 'Print source around each breakpoint.'
|
184
|
+
end
|
185
|
+
|
186
|
+
def process
|
187
|
+
if Breakpoints.count > 0
|
188
|
+
if opts.verbose? # Long-form with source output
|
189
|
+
Breakpoints.each { |b| print_full_breakpoint(b) }
|
190
|
+
else # Simple table output
|
191
|
+
max_width = [Math.log10(Breakpoints.count).ceil, 1].max
|
192
|
+
header = "#{' ' * (max_width - 1)}# Enabled At "
|
193
|
+
|
194
|
+
output.puts
|
195
|
+
output.puts text.bold(header)
|
196
|
+
output.puts text.bold('-' * header.size)
|
197
|
+
Breakpoints.each do |breakpoint|
|
198
|
+
output.printf "%#{max_width}d ", breakpoint.id
|
199
|
+
output.print breakpoint.enabled? ? 'Yes ' : 'No '
|
200
|
+
output.print "#{breakpoint.source}:#{breakpoint.pos}"
|
201
|
+
output.print " (if #{breakpoint.expr})" if breakpoint.expr
|
202
|
+
output.puts
|
203
|
+
end
|
204
|
+
output.puts
|
205
|
+
end
|
206
|
+
else
|
207
|
+
output.puts text.bold('No breakpoints defined.')
|
208
|
+
end
|
209
|
+
end
|
210
|
+
end
|
211
|
+
alias_command 'breaks', 'breakpoints'
|
212
|
+
|
213
|
+
helpers do
|
214
|
+
def breakout_navigation(action, times = nil)
|
215
|
+
_pry_.binding_stack.clear # Clear the binding stack
|
216
|
+
throw :breakout_nav, { # Break out of the REPL loop and
|
217
|
+
action: action, # signal the tracer
|
218
|
+
times: times,
|
219
|
+
pry: _pry_,
|
220
|
+
}
|
221
|
+
end
|
222
|
+
|
223
|
+
# Ensures that a command is executed in a local file context.
|
224
|
+
def check_file_context
|
225
|
+
unless PryDebuggerJRuby.check_file_context(target)
|
226
|
+
raise Pry::CommandError, 'Cannot find local context. Did you use `binding.pry`?'
|
227
|
+
end
|
228
|
+
end
|
229
|
+
|
230
|
+
# Print out full information about a breakpoint including surrounding code
|
231
|
+
# at that point.
|
232
|
+
def print_full_breakpoint(breakpoint)
|
233
|
+
line = breakpoint.pos
|
234
|
+
output.print text.bold("Breakpoint #{breakpoint.id}: ")
|
235
|
+
output.print "#{breakpoint.source} @ line #{line} "
|
236
|
+
output.print breakpoint.enabled? ? '(Enabled)' : '(Disabled)'
|
237
|
+
output.puts ' :'
|
238
|
+
if (expr = breakpoint.expr)
|
239
|
+
output.puts "#{text.bold('Condition:')} #{expr}"
|
240
|
+
end
|
241
|
+
output.puts
|
242
|
+
output.puts(
|
243
|
+
Pry::Code.from_file(breakpoint.source)
|
244
|
+
.around(line, 3).with_line_numbers.with_marker(line).to_s
|
245
|
+
)
|
246
|
+
output.puts
|
247
|
+
end
|
248
|
+
end
|
249
|
+
end
|
250
|
+
end
|
251
|
+
|
252
|
+
Pry.commands.import PryDebuggerJRuby::Commands
|
@@ -0,0 +1,147 @@
|
|
1
|
+
require 'pry' unless defined? Pry
|
2
|
+
require 'ruby-debug-base'
|
3
|
+
|
4
|
+
module PryDebuggerJRuby
|
5
|
+
class Processor
|
6
|
+
attr_accessor :pry
|
7
|
+
|
8
|
+
def initialize
|
9
|
+
Debugger.handler = self
|
10
|
+
@always_enabled = true # FIXME: JRuby workaround
|
11
|
+
@delayed = Hash.new(0)
|
12
|
+
end
|
13
|
+
|
14
|
+
# Wrap a Pry REPL to catch navigational commands and act on them.
|
15
|
+
def run(initial = true)
|
16
|
+
return_value = nil
|
17
|
+
command = catch(:breakout_nav) do # Throws from PryDebuggerJRuby::Commands
|
18
|
+
return_value = yield
|
19
|
+
{} # Nothing thrown == no navigational command
|
20
|
+
end
|
21
|
+
|
22
|
+
times = (command[:times] || 1).to_i # Command argument
|
23
|
+
times = 1 if times <= 0
|
24
|
+
|
25
|
+
if [:step, :next, :finish].include? command[:action]
|
26
|
+
@pry = command[:pry] # Pry instance to resume after stepping
|
27
|
+
Debugger.start unless Debugger.started?
|
28
|
+
|
29
|
+
if initial
|
30
|
+
# Movement when on the initial binding.pry line will have a frame
|
31
|
+
# inside Debugger. If we step normally, it'll stop inside this
|
32
|
+
# Processor. So jump out and stop at the above frame, then step/next
|
33
|
+
# from our callback.
|
34
|
+
Debugger.current_context.stop_frame = 1
|
35
|
+
@delayed[command[:action]] = times
|
36
|
+
|
37
|
+
elsif :next == command[:action]
|
38
|
+
step_over times
|
39
|
+
|
40
|
+
elsif :step == command[:action]
|
41
|
+
step times
|
42
|
+
|
43
|
+
elsif :finish == command[:action]
|
44
|
+
finish
|
45
|
+
end
|
46
|
+
else
|
47
|
+
stop
|
48
|
+
end
|
49
|
+
|
50
|
+
return_value
|
51
|
+
end
|
52
|
+
|
53
|
+
# Adjust debugging. When set to false, the Processor will manage enabling
|
54
|
+
# and disabling the debugger itself. When set to true, the debugger is
|
55
|
+
# always enabled.
|
56
|
+
def debugging=(enabled)
|
57
|
+
if enabled
|
58
|
+
@always_enabled = true
|
59
|
+
Debugger.start unless Debugger.started?
|
60
|
+
else
|
61
|
+
@always_enabled = false
|
62
|
+
# Debugger will get stopped if necessary in `stop` once the repl ends.
|
63
|
+
end
|
64
|
+
end
|
65
|
+
|
66
|
+
# --- Callbacks from debugger C extension ---
|
67
|
+
|
68
|
+
def at_line(context, file, _line)
|
69
|
+
return if file && TRACE_IGNORE_FILES.include?(File.expand_path(file))
|
70
|
+
|
71
|
+
# If stopped for a breakpoint or catchpoint, can't play any delayed steps
|
72
|
+
# as they'll move away from the interruption point. (Unsure if scenario is
|
73
|
+
# possible, but just keeping assertions in check.)
|
74
|
+
@delayed = Hash.new(0) unless :step == context.stop_reason
|
75
|
+
|
76
|
+
if @delayed[:next] > 1 # If any delayed nexts/steps, do 'em.
|
77
|
+
step_over @delayed[:next] - 1
|
78
|
+
@delayed = Hash.new(0)
|
79
|
+
|
80
|
+
elsif @delayed[:step] > 1
|
81
|
+
step @delayed[:step] - 1
|
82
|
+
@delayed = Hash.new(0)
|
83
|
+
|
84
|
+
elsif @delayed[:finish] > 0
|
85
|
+
finish
|
86
|
+
@delayed = Hash.new(0)
|
87
|
+
|
88
|
+
else # Otherwise, resume the pry session at the stopped line.
|
89
|
+
resume_pry context
|
90
|
+
end
|
91
|
+
end
|
92
|
+
|
93
|
+
# Called when a breakpoint is triggered. Note: `at_line`` is called
|
94
|
+
# immediately after with the context's `stop_reason == :breakpoint`.
|
95
|
+
def at_breakpoint(_context, breakpoint)
|
96
|
+
@pry.output.print Pry::Helpers::Text.bold("\nBreakpoint #{breakpoint.id}. ")
|
97
|
+
@pry.output.puts (breakpoint.hit_count == 1 ?
|
98
|
+
'First hit.' :
|
99
|
+
"Hit #{breakpoint.hit_count} times.")
|
100
|
+
if (expr = breakpoint.expr)
|
101
|
+
@pry.output.print Pry::Helpers::Text.bold('Condition: ')
|
102
|
+
@pry.output.puts expr
|
103
|
+
end
|
104
|
+
end
|
105
|
+
|
106
|
+
def at_catchpoint(context, exception)
|
107
|
+
# TODO
|
108
|
+
end
|
109
|
+
|
110
|
+
private
|
111
|
+
|
112
|
+
# Resume an existing Pry REPL at the paused point. Binding extracted from
|
113
|
+
# the Debugger::Context.
|
114
|
+
def resume_pry(context)
|
115
|
+
new_binding = context.frame_binding(0)
|
116
|
+
Debugger.stop unless @always_enabled
|
117
|
+
|
118
|
+
@pry.binding_stack.clear
|
119
|
+
run(false) do
|
120
|
+
@pry.repl new_binding
|
121
|
+
end
|
122
|
+
end
|
123
|
+
|
124
|
+
# Move execution forward.
|
125
|
+
def step(times)
|
126
|
+
Debugger.current_context.step(times)
|
127
|
+
end
|
128
|
+
|
129
|
+
# Move execution forward a number of lines in the same frame.
|
130
|
+
def step_over(lines)
|
131
|
+
Debugger.current_context.step_over(lines, 0)
|
132
|
+
end
|
133
|
+
|
134
|
+
# Execute until current frame returns.
|
135
|
+
def finish
|
136
|
+
Debugger.current_context.stop_frame = 0
|
137
|
+
end
|
138
|
+
|
139
|
+
# Cleanup when debugging is stopped and execution continues.
|
140
|
+
def stop
|
141
|
+
Debugger.stop if !@always_enabled && Debugger.started?
|
142
|
+
if PryDebuggerJRuby.current_remote_server # Cleanup DRb remote if running
|
143
|
+
PryDebuggerJRuby.current_remote_server.teardown
|
144
|
+
end
|
145
|
+
end
|
146
|
+
end
|
147
|
+
end
|
@@ -0,0 +1,23 @@
|
|
1
|
+
require 'pry' unless defined? Pry
|
2
|
+
require 'pry-debugger-jruby/processor'
|
3
|
+
|
4
|
+
class << Pry
|
5
|
+
alias start_without_pry_debugger start
|
6
|
+
attr_reader :processor
|
7
|
+
|
8
|
+
def start_with_pry_debugger(target = TOPLEVEL_BINDING, options = {})
|
9
|
+
@processor ||= PryDebuggerJRuby::Processor.new
|
10
|
+
|
11
|
+
if target.is_a?(Binding) && PryDebuggerJRuby.check_file_context(target)
|
12
|
+
# Wrap the processer around the usual Pry.start to catch navigation
|
13
|
+
# commands.
|
14
|
+
@processor.run(true) do
|
15
|
+
start_without_pry_debugger(target, options)
|
16
|
+
end
|
17
|
+
else
|
18
|
+
# No need for the tracer unless we have a file context to step through
|
19
|
+
start_without_pry_debugger(target, options)
|
20
|
+
end
|
21
|
+
end
|
22
|
+
alias start start_with_pry_debugger
|
23
|
+
end
|
@@ -0,0 +1,38 @@
|
|
1
|
+
require 'pry-remote'
|
2
|
+
|
3
|
+
module PryRemote
|
4
|
+
class Server
|
5
|
+
# Override the call to Pry.start to save off current Server, and not
|
6
|
+
# teardown the server right after Pry.start finishes.
|
7
|
+
def run
|
8
|
+
if PryDebuggerJRuby.current_remote_server
|
9
|
+
raise 'Already running a pry-remote session!'
|
10
|
+
else
|
11
|
+
PryDebuggerJRuby.current_remote_server = self
|
12
|
+
end
|
13
|
+
|
14
|
+
setup
|
15
|
+
Pry.start(@object, input: client.input_proxy, output: client.output)
|
16
|
+
end
|
17
|
+
|
18
|
+
# Override to reset our saved global current server session.
|
19
|
+
alias teardown_without_pry_debugger teardown
|
20
|
+
def teardown_with_pry_debugger
|
21
|
+
return if @torn
|
22
|
+
|
23
|
+
teardown_without_pry_debugger
|
24
|
+
PryDebuggerJRuby.current_remote_server = nil
|
25
|
+
@torn = true
|
26
|
+
end
|
27
|
+
alias teardown teardown_with_pry_debugger
|
28
|
+
end
|
29
|
+
end
|
30
|
+
|
31
|
+
# Ensure cleanup when a program finishes without another break. For example,
|
32
|
+
# 'next' on the last line of a program won't hit PryDebuggerJRuby::Processor#run,
|
33
|
+
# which normally handles cleanup.
|
34
|
+
at_exit do
|
35
|
+
if PryDebuggerJRuby.current_remote_server
|
36
|
+
PryDebuggerJRuby.current_remote_server.teardown
|
37
|
+
end
|
38
|
+
end
|
@@ -0,0 +1,29 @@
|
|
1
|
+
lib = File.expand_path('../lib', __FILE__)
|
2
|
+
$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
|
3
|
+
|
4
|
+
require 'pry-debugger-jruby/version'
|
5
|
+
|
6
|
+
Gem::Specification.new do |spec|
|
7
|
+
spec.name = 'pry-debugger-jruby'
|
8
|
+
spec.version = PryDebuggerJRuby::VERSION
|
9
|
+
spec.platform = 'java'
|
10
|
+
spec.author = 'Ivo Anjo'
|
11
|
+
spec.email = 'ivo.anjo@ist.utl.pt'
|
12
|
+
spec.license = 'MIT'
|
13
|
+
spec.homepage = 'https://github.com/ivoanjo/pry-debugger-jruby'
|
14
|
+
spec.summary = 'JRuby 9k-compatible pry debugging!'
|
15
|
+
spec.description = "Add a JRuby-compatible debugger to 'pry'. Adds 'step', 'next', and 'continue' commands to control execution."
|
16
|
+
|
17
|
+
spec.files = `git ls-files -z`.split("\x0").reject do |f|
|
18
|
+
f.match(%r{^(test|spec|features)/})
|
19
|
+
end
|
20
|
+
spec.require_paths = ['lib']
|
21
|
+
|
22
|
+
spec.required_ruby_version = '>= 2.2.0'
|
23
|
+
|
24
|
+
spec.add_runtime_dependency 'pry', '>= 0.10', '< 0.11'
|
25
|
+
spec.add_runtime_dependency 'ruby-debug-base', '~> 0.10.4'
|
26
|
+
|
27
|
+
spec.add_development_dependency 'pry-remote', '~> 0.1.6'
|
28
|
+
spec.add_development_dependency 'rake', '~> 11.3'
|
29
|
+
end
|
metadata
ADDED
@@ -0,0 +1,122 @@
|
|
1
|
+
--- !ruby/object:Gem::Specification
|
2
|
+
name: pry-debugger-jruby
|
3
|
+
version: !ruby/object:Gem::Version
|
4
|
+
version: 1.0.0
|
5
|
+
platform: java
|
6
|
+
authors:
|
7
|
+
- Ivo Anjo
|
8
|
+
autorequire:
|
9
|
+
bindir: bin
|
10
|
+
cert_chain: []
|
11
|
+
date: 2016-12-01 00:00:00.000000000 Z
|
12
|
+
dependencies:
|
13
|
+
- !ruby/object:Gem::Dependency
|
14
|
+
requirement: !ruby/object:Gem::Requirement
|
15
|
+
requirements:
|
16
|
+
- - ">="
|
17
|
+
- !ruby/object:Gem::Version
|
18
|
+
version: '0.10'
|
19
|
+
- - "<"
|
20
|
+
- !ruby/object:Gem::Version
|
21
|
+
version: '0.11'
|
22
|
+
name: pry
|
23
|
+
prerelease: false
|
24
|
+
type: :runtime
|
25
|
+
version_requirements: !ruby/object:Gem::Requirement
|
26
|
+
requirements:
|
27
|
+
- - ">="
|
28
|
+
- !ruby/object:Gem::Version
|
29
|
+
version: '0.10'
|
30
|
+
- - "<"
|
31
|
+
- !ruby/object:Gem::Version
|
32
|
+
version: '0.11'
|
33
|
+
- !ruby/object:Gem::Dependency
|
34
|
+
requirement: !ruby/object:Gem::Requirement
|
35
|
+
requirements:
|
36
|
+
- - "~>"
|
37
|
+
- !ruby/object:Gem::Version
|
38
|
+
version: 0.10.4
|
39
|
+
name: ruby-debug-base
|
40
|
+
prerelease: false
|
41
|
+
type: :runtime
|
42
|
+
version_requirements: !ruby/object:Gem::Requirement
|
43
|
+
requirements:
|
44
|
+
- - "~>"
|
45
|
+
- !ruby/object:Gem::Version
|
46
|
+
version: 0.10.4
|
47
|
+
- !ruby/object:Gem::Dependency
|
48
|
+
requirement: !ruby/object:Gem::Requirement
|
49
|
+
requirements:
|
50
|
+
- - "~>"
|
51
|
+
- !ruby/object:Gem::Version
|
52
|
+
version: 0.1.6
|
53
|
+
name: pry-remote
|
54
|
+
prerelease: false
|
55
|
+
type: :development
|
56
|
+
version_requirements: !ruby/object:Gem::Requirement
|
57
|
+
requirements:
|
58
|
+
- - "~>"
|
59
|
+
- !ruby/object:Gem::Version
|
60
|
+
version: 0.1.6
|
61
|
+
- !ruby/object:Gem::Dependency
|
62
|
+
requirement: !ruby/object:Gem::Requirement
|
63
|
+
requirements:
|
64
|
+
- - "~>"
|
65
|
+
- !ruby/object:Gem::Version
|
66
|
+
version: '11.3'
|
67
|
+
name: rake
|
68
|
+
prerelease: false
|
69
|
+
type: :development
|
70
|
+
version_requirements: !ruby/object:Gem::Requirement
|
71
|
+
requirements:
|
72
|
+
- - "~>"
|
73
|
+
- !ruby/object:Gem::Version
|
74
|
+
version: '11.3'
|
75
|
+
description: Add a JRuby-compatible debugger to 'pry'. Adds 'step', 'next', and 'continue' commands to control execution.
|
76
|
+
email: ivo.anjo@ist.utl.pt
|
77
|
+
executables: []
|
78
|
+
extensions: []
|
79
|
+
extra_rdoc_files: []
|
80
|
+
files:
|
81
|
+
- ".gitignore"
|
82
|
+
- ".ruby-version"
|
83
|
+
- CHANGELOG.md
|
84
|
+
- Gemfile
|
85
|
+
- LICENSE
|
86
|
+
- README.md
|
87
|
+
- Rakefile
|
88
|
+
- lib/pry-debugger-jruby.rb
|
89
|
+
- lib/pry-debugger-jruby/base.rb
|
90
|
+
- lib/pry-debugger-jruby/breakpoints.rb
|
91
|
+
- lib/pry-debugger-jruby/cli.rb
|
92
|
+
- lib/pry-debugger-jruby/commands.rb
|
93
|
+
- lib/pry-debugger-jruby/processor.rb
|
94
|
+
- lib/pry-debugger-jruby/pry_ext.rb
|
95
|
+
- lib/pry-debugger-jruby/pry_remote_ext.rb
|
96
|
+
- lib/pry-debugger-jruby/version.rb
|
97
|
+
- pry-debugger-jruby.gemspec
|
98
|
+
homepage: https://github.com/ivoanjo/pry-debugger-jruby
|
99
|
+
licenses:
|
100
|
+
- MIT
|
101
|
+
metadata: {}
|
102
|
+
post_install_message:
|
103
|
+
rdoc_options: []
|
104
|
+
require_paths:
|
105
|
+
- lib
|
106
|
+
required_ruby_version: !ruby/object:Gem::Requirement
|
107
|
+
requirements:
|
108
|
+
- - ">="
|
109
|
+
- !ruby/object:Gem::Version
|
110
|
+
version: 2.2.0
|
111
|
+
required_rubygems_version: !ruby/object:Gem::Requirement
|
112
|
+
requirements:
|
113
|
+
- - ">="
|
114
|
+
- !ruby/object:Gem::Version
|
115
|
+
version: '0'
|
116
|
+
requirements: []
|
117
|
+
rubyforge_project:
|
118
|
+
rubygems_version: 2.6.6
|
119
|
+
signing_key:
|
120
|
+
specification_version: 4
|
121
|
+
summary: JRuby 9k-compatible pry debugging!
|
122
|
+
test_files: []
|