irt 1.2.5 → 1.2.6
Sign up to get free protection for your applications and to get access to all the features.
- data/VERSION +1 -1
- data/lib/irt/commands/core.rb +2 -0
- data/lib/irt/commands/help.rb +84 -83
- data/lib/irt/extensions/debugger.rb +39 -0
- data/lib/irt/extensions/kernel.rb +14 -7
- data/lib/irt.rb +7 -0
- metadata +90 -88
data/VERSION
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
1.2.
|
|
1
|
+
1.2.6
|
data/lib/irt/commands/core.rb
CHANGED
data/lib/irt/commands/help.rb
CHANGED
|
@@ -11,116 +11,117 @@ module IRT
|
|
|
11
11
|
- The #{IRT.dye "Extensions", :log_color, :bold} are methods available anywhere
|
|
12
12
|
|
|
13
13
|
#{label " Inspecting Commands ", :interactive_color}
|
|
14
|
-
irt object
|
|
15
|
-
vdiff|vd obj_a, obj_b
|
|
16
|
-
p, pp, ap, y
|
|
17
|
-
|
|
14
|
+
irt object Opens an inspecting session into object
|
|
15
|
+
vdiff|vd obj_a, obj_b Prints the visual diff of the yaml dump of 2 objects
|
|
16
|
+
p, pp, ap, y When invoked with no arguments print the last_value
|
|
17
|
+
(e.g. just type 'y' instead 'y _')
|
|
18
18
|
|
|
19
19
|
#{label " Log Commands ", :interactive_color}
|
|
20
|
-
log|l [limit]
|
|
21
|
-
full_log|ll
|
|
22
|
-
print_lines|pl
|
|
23
|
-
|
|
24
|
-
print_all_lines|pll
|
|
20
|
+
log|l [limit] Prints limit or 'tail_size' lines of the virtual log
|
|
21
|
+
full_log|ll Prints all the lines in the virtual log
|
|
22
|
+
print_lines|pl Prints the last lines of the current session
|
|
23
|
+
without numbers (for easy copying)
|
|
24
|
+
print_all_lines|pll Like print_line but prints all the sessions lines
|
|
25
25
|
|
|
26
26
|
#{label " In Place Editing Commands ", :interactive_color}
|
|
27
27
|
(<editor> can be 'vi', 'nano|nn', 'emacs|em', 'edit|ed')
|
|
28
|
-
<editor>
|
|
29
|
-
|
|
30
|
-
<editor> file[, line]
|
|
31
|
-
|
|
32
|
-
<editor> hash
|
|
33
|
-
<editor> array
|
|
34
|
-
<editor> traceline
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
<editor> n
|
|
38
|
-
|
|
28
|
+
<editor> Uses <editor> to open the current evalued file at
|
|
29
|
+
the current evalued line for in place edit
|
|
30
|
+
<editor> file[, line] Uses <editor> to open file [at line] for in place
|
|
31
|
+
editing
|
|
32
|
+
<editor> hash Uses <editor> to open hash[:file] at the hash[:line]
|
|
33
|
+
<editor> array Uses <editor> to open array[0] at the array[1] line
|
|
34
|
+
<editor> traceline Uses <editor> to open the file at line in traceline
|
|
35
|
+
e.g.: nn "from /path/to/file.rb:34:in 'any_method'"
|
|
36
|
+
nn "a_gem (1.2.3) lib/file.rb:13:in 'a_meth'"
|
|
37
|
+
<editor> n Uses <editor> to open the backtraced file [n] at
|
|
38
|
+
the backtraced line
|
|
39
39
|
|
|
40
40
|
#{label( " Copy-Edit Commands ", :interactive_color ) + IRT.dye(" (use copy_to_clipboard_command)", :interactive_color, :bold)}
|
|
41
|
-
copy_lines|cl
|
|
42
|
-
copy_all_lines|cll
|
|
43
|
-
c<editor>
|
|
41
|
+
copy_lines|cl Copies the last session lines to the clipboard
|
|
42
|
+
copy_all_lines|cll Copies all the sessions' lines to the clipboard
|
|
43
|
+
c<editor> Like `copy_lines` and <editor> in just one step
|
|
44
44
|
|
|
45
45
|
#{label(" Test Commands ", :interactive_color) + IRT.dye(" (only available in interactive sessions)", :interactive_color, :bold)}
|
|
46
|
-
add_desc|ad|dd desc
|
|
47
|
-
add_test|at|tt
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
add_test|at|tt desc
|
|
51
|
-
save_as|sa path
|
|
46
|
+
add_desc|ad|dd desc Adds a description for the test in the log
|
|
47
|
+
add_test|at|tt Adds a test in the log, checking the last value (_)
|
|
48
|
+
by automatically choosing the :_eql?, or :_yaml_eql?
|
|
49
|
+
method, depending on the type of the last value (_)
|
|
50
|
+
add_test|at|tt desc Like add_test but adds a 'desc' directive first'
|
|
51
|
+
save_as|sa path Saves the current irt file as path
|
|
52
52
|
|
|
53
53
|
#{label " FileUtils Commands ", :interactive_color}
|
|
54
54
|
All the FileUtils methods are availabe as IRT Commands
|
|
55
55
|
(e.g. pwd, touch, mkdir, mv, cp, rm, rm_rf, compare_files, ...)
|
|
56
56
|
|
|
57
57
|
#{label " Documentation Commands ", :interactive_color}
|
|
58
|
-
ri "string_to_search"
|
|
59
|
-
ri to_search
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
ri obj.any_method
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
ri n
|
|
69
|
-
|
|
70
|
-
pri ...
|
|
71
|
-
|
|
58
|
+
ri "string_to_search" Search the ri doc for the literal string_to_search
|
|
59
|
+
ri to_search Search the ri doc for to_search (without quote)
|
|
60
|
+
If to_search represents any object in your code
|
|
61
|
+
it looks for the obj.class documentation
|
|
62
|
+
e.g.: ri arr #=> (where arr=[]) ri doc for Array
|
|
63
|
+
ri "" #=> ri doc for String
|
|
64
|
+
ri obj.any_method Search the method.owner ri doc for of any_method
|
|
65
|
+
(no quotes needed, and completion available)
|
|
66
|
+
e.g.: ri "".eql? #=> ri doc for String#eql?
|
|
67
|
+
ri [].eql? #=> ri doc for Array#eql?
|
|
68
|
+
ri n Search the ri doc for the method n in a multiple
|
|
69
|
+
choices list
|
|
70
|
+
pri ... Like the above commands for `ri ...` but uses the
|
|
71
|
+
pager to show the result
|
|
72
72
|
|
|
73
73
|
#{label(" Rails Commands ", :interactive_color) + IRT.dye(" (only available for Rails Apps)", :interactive_color, :bold)}
|
|
74
|
-
rails_log_on
|
|
75
|
-
rlon|rlo
|
|
76
|
-
rails_log_off
|
|
77
|
-
rloff|rlf
|
|
74
|
+
rails_log_on Turn the rails log-in-console ON
|
|
75
|
+
rlon|rlo Aliases for rails_log_on
|
|
76
|
+
rails_log_off Turn the rails log-in-console OFF
|
|
77
|
+
rloff|rlf Aliases for rails_log_off
|
|
78
78
|
|
|
79
79
|
#{label " Misc Commands ", :interactive_color}
|
|
80
|
-
x|q
|
|
81
|
-
xx|qq
|
|
82
|
-
status|ss
|
|
83
|
-
run file
|
|
84
|
-
rerun|rr
|
|
85
|
-
|
|
86
|
-
restart|rs
|
|
87
|
-
|
|
88
|
-
irt_help|hh
|
|
89
|
-
sh command
|
|
90
|
-
pager|pg string|block
|
|
91
|
-
|
|
80
|
+
x|q Aliases for exit (from the current session)
|
|
81
|
+
xx|qq Aliases for abort (abort the irt process)
|
|
82
|
+
status|ss Prints the session status line
|
|
83
|
+
run file Run an irt file (exiting from the current sessions)
|
|
84
|
+
rerun|rr Reruns the current irt file (exiting from the
|
|
85
|
+
current sessions)
|
|
86
|
+
restart|rs Restart the executable, reload IRT (and Rails) and
|
|
87
|
+
rerun the current file
|
|
88
|
+
irt_help|hh Shows this screen
|
|
89
|
+
sh command Alias for system("command") (no quotes needed)
|
|
90
|
+
pager|pg string|block Uses the pager to show a long string or executes
|
|
91
|
+
block and shows its captured stdout
|
|
92
92
|
|
|
93
93
|
#{label " Session Directives ", :file_color}
|
|
94
|
-
irt
|
|
95
|
-
|
|
96
|
-
irt binding
|
|
94
|
+
irt Opens an interactive session which retains the
|
|
95
|
+
current variables and the last value (_)
|
|
96
|
+
irt binding Opens a binding session at the line of the call
|
|
97
97
|
|
|
98
98
|
#{label(" Test Directives ", :file_color) + IRT.dye(" (auto added by the Test Commands)", :file_color, :bold)}
|
|
99
|
-
desc description
|
|
100
|
-
_eql? val
|
|
101
|
-
_yaml_eql? yaml_dump
|
|
99
|
+
desc description Adds a description to the next test
|
|
100
|
+
_eql? val Runs a test checking _ == val
|
|
101
|
+
_yaml_eql? yaml_dump Runs a test checking y _ == yaml_dump
|
|
102
102
|
|
|
103
103
|
#{label " Helper Directives ", :file_color}
|
|
104
|
-
insert_file file
|
|
105
|
-
eval_file
|
|
106
|
-
irt_at_exit block
|
|
107
|
-
|
|
104
|
+
insert_file file Evaluates file as it were inserted at that line
|
|
105
|
+
eval_file Alias for eval_file
|
|
106
|
+
irt_at_exit block Ensures execution of block at exit (useful for
|
|
107
|
+
cleanup of test env)
|
|
108
108
|
|
|
109
109
|
#{label " Extensions ", :log_color}
|
|
110
|
-
Kernel#capture
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
110
|
+
Kernel#capture stream {} Executes block and returns a string containing the
|
|
111
|
+
captured str(eam).
|
|
112
|
+
Kernel#silence stream {} Alias for capture
|
|
113
|
+
Object#own_methods Returns the methods implemented by the receiver
|
|
114
|
+
itself (not inherited)
|
|
115
|
+
Object#<editor> (<editor> can be 'vi', 'nano|nn', 'emacs|em')
|
|
116
|
+
Yaml-dump the object in a tmp.yml file and opens it
|
|
117
|
+
with <editor>. After your editing and save returns
|
|
118
|
+
the evaluated yaml file
|
|
119
|
+
e.g.: {:a => 2}.vi #=> {:an_edited => 'value'}
|
|
120
|
+
Method#location When possible, it returns file and line where the
|
|
121
|
+
method is defined. It is suitable to be passed to
|
|
122
|
+
the in place editing commands.
|
|
123
|
+
Method#info Returns useful info about the method. It is suitable
|
|
124
|
+
to be passed to the in place editing commands.
|
|
124
125
|
)
|
|
125
126
|
end
|
|
126
127
|
alias_method :hh, :irt_help
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
module IRB
|
|
2
|
+
|
|
3
|
+
def self.start_session(bind)
|
|
4
|
+
IRT.start
|
|
5
|
+
IRT::Session.enter :binding, bind
|
|
6
|
+
end
|
|
7
|
+
|
|
8
|
+
class Context
|
|
9
|
+
alias_method :evaluate_without_debugger, :evaluate
|
|
10
|
+
def evaluate(line, line_no)
|
|
11
|
+
$rdebug_irb_statements = line
|
|
12
|
+
evaluate_without_debugger line, line_no
|
|
13
|
+
end
|
|
14
|
+
end
|
|
15
|
+
|
|
16
|
+
end
|
|
17
|
+
|
|
18
|
+
module Kernel
|
|
19
|
+
alias_method :original_irt, :irt
|
|
20
|
+
def irt(bind=nil)
|
|
21
|
+
IRT.start
|
|
22
|
+
IRT::Commands::Core.irt(bind)
|
|
23
|
+
end
|
|
24
|
+
end
|
|
25
|
+
|
|
26
|
+
module IRT
|
|
27
|
+
module Session
|
|
28
|
+
|
|
29
|
+
private
|
|
30
|
+
|
|
31
|
+
def set_binding_file_pointers(context)
|
|
32
|
+
context.binding_file = Debugger.current_context.frame_file
|
|
33
|
+
context.binding_line_no = Debugger.current_context.frame_line
|
|
34
|
+
end
|
|
35
|
+
|
|
36
|
+
end
|
|
37
|
+
end
|
|
38
|
+
|
|
39
|
+
|
|
@@ -1,14 +1,21 @@
|
|
|
1
1
|
require 'stringio'
|
|
2
2
|
module Kernel
|
|
3
3
|
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
4
|
+
# copied from ActiveRecord 3.1 because of conflicting name with previous IRT implementation
|
|
5
|
+
# modified in the argument default in order to be used by both AR and IRT
|
|
6
|
+
def capture(stream=:stdout)
|
|
7
|
+
begin
|
|
8
|
+
stream = stream.to_s
|
|
9
|
+
eval "$#{stream} = StringIO.new"
|
|
10
|
+
yield
|
|
11
|
+
result = eval("$#{stream}").string
|
|
12
|
+
ensure
|
|
13
|
+
eval("$#{stream} = #{stream.upcase}")
|
|
14
|
+
end
|
|
15
|
+
|
|
16
|
+
result
|
|
11
17
|
end
|
|
18
|
+
alias :silence :capture
|
|
12
19
|
|
|
13
20
|
def irt(bind)
|
|
14
21
|
raise IRT::ArgumentTypeError, "You must pass binding instead of #{bind.class.name} object" unless bind.is_a?(Binding)
|
data/lib/irt.rb
CHANGED
|
@@ -153,6 +153,12 @@ module IRT
|
|
|
153
153
|
|
|
154
154
|
end
|
|
155
155
|
|
|
156
|
+
# before we patch irb
|
|
157
|
+
if defined?(Debugger)
|
|
158
|
+
require 'ruby-debug/command'
|
|
159
|
+
require 'ruby-debug/commands/irb'
|
|
160
|
+
end
|
|
161
|
+
|
|
156
162
|
require 'irt/extensions/irb'
|
|
157
163
|
require 'irb/completion'
|
|
158
164
|
IRT.init_config
|
|
@@ -161,5 +167,6 @@ require 'irt/extensions/object'
|
|
|
161
167
|
require 'irt/extensions/method'
|
|
162
168
|
require 'irt/prompter'
|
|
163
169
|
require 'irt/extensions/rails' if defined?(ActiveSupport::BufferedLogger)
|
|
170
|
+
require 'irt/extensions/debugger' if defined?(Debugger)
|
|
164
171
|
|
|
165
172
|
end
|
metadata
CHANGED
|
@@ -2,98 +2,101 @@
|
|
|
2
2
|
name: irt
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
4
|
prerelease:
|
|
5
|
-
version: 1.2.
|
|
5
|
+
version: 1.2.6
|
|
6
6
|
platform: ruby
|
|
7
7
|
authors:
|
|
8
|
-
|
|
8
|
+
- Domizio Demichelis
|
|
9
9
|
autorequire:
|
|
10
10
|
bindir: bin
|
|
11
11
|
cert_chain: []
|
|
12
12
|
|
|
13
|
-
date: 2011-
|
|
13
|
+
date: 2011-08-02 00:00:00 -04:00
|
|
14
|
+
default_executable:
|
|
14
15
|
dependencies:
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
16
|
+
- !ruby/object:Gem::Dependency
|
|
17
|
+
name: differ
|
|
18
|
+
prerelease: false
|
|
19
|
+
requirement: &id001 !ruby/object:Gem::Requirement
|
|
20
|
+
none: false
|
|
21
|
+
requirements:
|
|
22
|
+
- - ">="
|
|
23
|
+
- !ruby/object:Gem::Version
|
|
24
|
+
version: 0.1.1
|
|
25
|
+
type: :runtime
|
|
26
|
+
version_requirements: *id001
|
|
27
|
+
- !ruby/object:Gem::Dependency
|
|
28
|
+
name: dye
|
|
29
|
+
prerelease: false
|
|
30
|
+
requirement: &id002 !ruby/object:Gem::Requirement
|
|
31
|
+
none: false
|
|
32
|
+
requirements:
|
|
33
|
+
- - ">="
|
|
34
|
+
- !ruby/object:Gem::Version
|
|
35
|
+
version: 0.1.3
|
|
36
|
+
type: :runtime
|
|
37
|
+
version_requirements: *id002
|
|
38
|
+
- !ruby/object:Gem::Dependency
|
|
39
|
+
name: prompter
|
|
40
|
+
prerelease: false
|
|
41
|
+
requirement: &id003 !ruby/object:Gem::Requirement
|
|
42
|
+
none: false
|
|
43
|
+
requirements:
|
|
44
|
+
- - ">="
|
|
45
|
+
- !ruby/object:Gem::Version
|
|
46
|
+
version: 0.1.4
|
|
47
|
+
type: :runtime
|
|
48
|
+
version_requirements: *id003
|
|
48
49
|
description: If you use IRT in place of irb or Rails Console, you will have more tools that will make your life a lot easier.
|
|
49
50
|
email: dd.nexus@gmail.com
|
|
50
51
|
executables:
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
52
|
+
- irt
|
|
53
|
+
- irt_irb
|
|
54
|
+
- irt_rails2
|
|
54
55
|
extensions: []
|
|
55
56
|
|
|
56
57
|
extra_rdoc_files:
|
|
57
|
-
|
|
58
|
+
- README.markdown
|
|
58
59
|
files:
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
60
|
+
- .gitignore
|
|
61
|
+
- LICENSE
|
|
62
|
+
- README.markdown
|
|
63
|
+
- Rakefile
|
|
64
|
+
- VERSION
|
|
65
|
+
- bin/irt
|
|
66
|
+
- bin/irt_irb
|
|
67
|
+
- bin/irt_rails2
|
|
68
|
+
- goodies/nano/README
|
|
69
|
+
- goodies/nano/irt.nanorc
|
|
70
|
+
- goodies/vi/README
|
|
71
|
+
- irt.gemspec
|
|
72
|
+
- irtrc
|
|
73
|
+
- lib/irt.rb
|
|
74
|
+
- lib/irt/commands/core.rb
|
|
75
|
+
- lib/irt/commands/edit.rb
|
|
76
|
+
- lib/irt/commands/help.rb
|
|
77
|
+
- lib/irt/commands/log.rb
|
|
78
|
+
- lib/irt/commands/ri.rb
|
|
79
|
+
- lib/irt/commands/test.rb
|
|
80
|
+
- lib/irt/differ.rb
|
|
81
|
+
- lib/irt/directives.rb
|
|
82
|
+
- lib/irt/directives/test.rb
|
|
83
|
+
- lib/irt/extensions/debugger.rb
|
|
84
|
+
- lib/irt/extensions/irb.rb
|
|
85
|
+
- lib/irt/extensions/irb/commands.rb
|
|
86
|
+
- lib/irt/extensions/irb/context.rb
|
|
87
|
+
- lib/irt/extensions/kernel.rb
|
|
88
|
+
- lib/irt/extensions/method.rb
|
|
89
|
+
- lib/irt/extensions/object.rb
|
|
90
|
+
- lib/irt/extensions/rails.rb
|
|
91
|
+
- lib/irt/history.rb
|
|
92
|
+
- lib/irt/hunks.rb
|
|
93
|
+
- lib/irt/init.rb
|
|
94
|
+
- lib/irt/log.rb
|
|
95
|
+
- lib/irt/prompter.rb
|
|
96
|
+
- lib/irt/ruby_version.rb
|
|
97
|
+
- lib/irt/session.rb
|
|
98
|
+
- lib/irt/utils.rb
|
|
99
|
+
has_rdoc: true
|
|
97
100
|
homepage: http://github.com/ddnexus/irt
|
|
98
101
|
licenses: []
|
|
99
102
|
|
|
@@ -121,28 +124,27 @@ post_install_message: |+
|
|
|
121
124
|
________________________________________________________________________________
|
|
122
125
|
|
|
123
126
|
rdoc_options:
|
|
124
|
-
|
|
127
|
+
- --charset=UTF-8
|
|
125
128
|
require_paths:
|
|
126
|
-
|
|
129
|
+
- lib
|
|
127
130
|
required_ruby_version: !ruby/object:Gem::Requirement
|
|
128
131
|
none: false
|
|
129
132
|
requirements:
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
+
- - ">="
|
|
134
|
+
- !ruby/object:Gem::Version
|
|
135
|
+
version: "0"
|
|
133
136
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
|
134
137
|
none: false
|
|
135
138
|
requirements:
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
+
- - ">="
|
|
140
|
+
- !ruby/object:Gem::Version
|
|
141
|
+
version: 1.3.6
|
|
139
142
|
requirements: []
|
|
140
143
|
|
|
141
144
|
rubyforge_project:
|
|
142
|
-
rubygems_version: 1.
|
|
145
|
+
rubygems_version: 1.5.0
|
|
143
146
|
signing_key:
|
|
144
147
|
specification_version: 3
|
|
145
148
|
summary: Interactive Ruby Tools - Very improved irb and Rails Console with a lot of cool features.
|
|
146
149
|
test_files: []
|
|
147
150
|
|
|
148
|
-
has_rdoc:
|