pry 0.11.3 → 0.14.2
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +5 -5
- data/CHANGELOG.md +346 -2
- data/LICENSE +1 -1
- data/README.md +351 -292
- data/bin/pry +1 -0
- data/lib/pry/basic_object.rb +8 -4
- data/lib/pry/block_command.rb +22 -0
- data/lib/pry/class_command.rb +194 -0
- data/lib/pry/cli.rb +58 -76
- data/lib/pry/code/code_file.rb +33 -28
- data/lib/pry/code/code_range.rb +7 -5
- data/lib/pry/code/loc.rb +26 -13
- data/lib/pry/code.rb +37 -33
- data/lib/pry/code_object.rb +41 -39
- data/lib/pry/color_printer.rb +47 -45
- data/lib/pry/command.rb +178 -374
- data/lib/pry/command_set.rb +89 -121
- data/lib/pry/command_state.rb +31 -0
- data/lib/pry/commands/amend_line.rb +86 -82
- data/lib/pry/commands/bang.rb +18 -14
- data/lib/pry/commands/bang_pry.rb +15 -11
- data/lib/pry/commands/cat/abstract_formatter.rb +23 -18
- data/lib/pry/commands/cat/exception_formatter.rb +71 -59
- data/lib/pry/commands/cat/file_formatter.rb +55 -49
- data/lib/pry/commands/cat/input_expression_formatter.rb +35 -30
- data/lib/pry/commands/cat.rb +62 -54
- data/lib/pry/commands/cd.rb +40 -35
- data/lib/pry/commands/change_inspector.rb +29 -22
- data/lib/pry/commands/change_prompt.rb +48 -23
- data/lib/pry/commands/clear_screen.rb +20 -0
- data/lib/pry/commands/code_collector.rb +148 -133
- data/lib/pry/commands/disable_pry.rb +23 -19
- data/lib/pry/commands/easter_eggs.rb +19 -30
- data/lib/pry/commands/edit/exception_patcher.rb +21 -17
- data/lib/pry/commands/edit/file_and_line_locator.rb +34 -23
- data/lib/pry/commands/edit.rb +184 -160
- data/lib/pry/commands/exit.rb +40 -35
- data/lib/pry/commands/exit_all.rb +24 -20
- data/lib/pry/commands/exit_program.rb +20 -16
- data/lib/pry/commands/find_method.rb +168 -162
- data/lib/pry/commands/fix_indent.rb +16 -12
- data/lib/pry/commands/help.rb +140 -133
- data/lib/pry/commands/hist.rb +151 -149
- data/lib/pry/commands/import_set.rb +20 -15
- data/lib/pry/commands/jump_to.rb +25 -21
- data/lib/pry/commands/list_inspectors.rb +35 -28
- data/lib/pry/commands/ls/constants.rb +60 -43
- data/lib/pry/commands/ls/formatter.rb +42 -37
- data/lib/pry/commands/ls/globals.rb +38 -36
- data/lib/pry/commands/ls/grep.rb +17 -15
- data/lib/pry/commands/ls/instance_vars.rb +29 -28
- data/lib/pry/commands/ls/interrogatable.rb +18 -12
- data/lib/pry/commands/ls/jruby_hacks.rb +47 -41
- data/lib/pry/commands/ls/local_names.rb +26 -24
- data/lib/pry/commands/ls/local_vars.rb +38 -30
- data/lib/pry/commands/ls/ls_entity.rb +47 -52
- data/lib/pry/commands/ls/methods.rb +49 -51
- data/lib/pry/commands/ls/methods_helper.rb +46 -42
- data/lib/pry/commands/ls/self_methods.rb +23 -23
- data/lib/pry/commands/ls.rb +124 -105
- data/lib/pry/commands/nesting.rb +21 -17
- data/lib/pry/commands/play.rb +92 -82
- data/lib/pry/commands/pry_backtrace.rb +22 -17
- data/lib/pry/commands/pry_version.rb +15 -11
- data/lib/pry/commands/raise_up.rb +33 -27
- data/lib/pry/commands/reload_code.rb +60 -48
- data/lib/pry/commands/reset.rb +16 -12
- data/lib/pry/commands/ri.rb +56 -45
- data/lib/pry/commands/save_file.rb +45 -43
- data/lib/pry/commands/shell_command.rb +52 -51
- data/lib/pry/commands/shell_mode.rb +22 -18
- data/lib/pry/commands/show_doc.rb +80 -70
- data/lib/pry/commands/show_info.rb +192 -167
- data/lib/pry/commands/show_input.rb +16 -11
- data/lib/pry/commands/show_source.rb +110 -42
- data/lib/pry/commands/stat.rb +35 -31
- data/lib/pry/commands/switch_to.rb +21 -15
- data/lib/pry/commands/toggle_color.rb +20 -16
- data/lib/pry/commands/watch_expression/expression.rb +32 -27
- data/lib/pry/commands/watch_expression.rb +89 -84
- data/lib/pry/commands/whereami.rb +156 -148
- data/lib/pry/commands/wtf.rb +78 -40
- data/lib/pry/config/attributable.rb +22 -0
- data/lib/pry/config/lazy_value.rb +29 -0
- data/lib/pry/config/memoized_value.rb +34 -0
- data/lib/pry/config/value.rb +24 -0
- data/lib/pry/config.rb +312 -9
- data/lib/pry/control_d_handler.rb +28 -0
- data/lib/pry/core_extensions.rb +13 -10
- data/lib/pry/editor.rb +56 -34
- data/lib/pry/env.rb +18 -0
- data/lib/pry/exception_handler.rb +43 -0
- data/lib/pry/exceptions.rb +13 -18
- data/lib/pry/forwardable.rb +5 -1
- data/lib/pry/helpers/base_helpers.rb +58 -58
- data/lib/pry/helpers/command_helpers.rb +52 -62
- data/lib/pry/helpers/documentation_helpers.rb +21 -13
- data/lib/pry/helpers/options_helpers.rb +14 -7
- data/lib/pry/helpers/platform.rb +55 -0
- data/lib/pry/helpers/table.rb +44 -32
- data/lib/pry/helpers/text.rb +20 -18
- data/lib/pry/helpers.rb +3 -0
- data/lib/pry/history.rb +65 -60
- data/lib/pry/hooks.rb +24 -15
- data/lib/pry/indent.rb +72 -70
- data/lib/pry/input_completer.rb +251 -228
- data/lib/pry/input_lock.rb +7 -10
- data/lib/pry/inspector.rb +36 -24
- data/lib/pry/last_exception.rb +45 -45
- data/lib/pry/method/disowned.rb +18 -5
- data/lib/pry/method/patcher.rb +14 -5
- data/lib/pry/method/weird_method_locator.rb +74 -51
- data/lib/pry/method.rb +175 -121
- data/lib/pry/object_path.rb +37 -28
- data/lib/pry/output.rb +122 -35
- data/lib/pry/pager.rb +187 -180
- data/lib/pry/prompt.rb +213 -25
- data/lib/pry/pry_class.rb +91 -96
- data/lib/pry/pry_instance.rb +258 -223
- data/lib/pry/repl.rb +49 -25
- data/lib/pry/repl_file_loader.rb +27 -22
- data/lib/pry/ring.rb +89 -0
- data/lib/pry/slop/commands.rb +164 -170
- data/lib/pry/slop/option.rb +172 -170
- data/lib/pry/slop.rb +567 -556
- data/lib/pry/syntax_highlighter.rb +26 -0
- data/lib/pry/system_command_handler.rb +17 -0
- data/lib/pry/testable/evalable.rb +21 -12
- data/lib/pry/testable/mockable.rb +18 -10
- data/lib/pry/testable/pry_tester.rb +71 -56
- data/lib/pry/testable/utility.rb +29 -21
- data/lib/pry/testable/variables.rb +49 -43
- data/lib/pry/testable.rb +59 -61
- data/lib/pry/version.rb +3 -1
- data/lib/pry/warning.rb +20 -0
- data/lib/pry/wrapped_module/candidate.rb +31 -23
- data/lib/pry/wrapped_module.rb +63 -59
- data/lib/pry.rb +132 -149
- metadata +39 -51
- data/lib/pry/commands/disabled_commands.rb +0 -2
- data/lib/pry/commands/gem_cd.rb +0 -26
- data/lib/pry/commands/gem_install.rb +0 -32
- data/lib/pry/commands/gem_list.rb +0 -33
- data/lib/pry/commands/gem_open.rb +0 -29
- data/lib/pry/commands/gem_readme.rb +0 -25
- data/lib/pry/commands/gem_search.rb +0 -40
- data/lib/pry/commands/gist.rb +0 -101
- data/lib/pry/commands/install_command.rb +0 -53
- data/lib/pry/commands/list_prompts.rb +0 -35
- data/lib/pry/commands/simple_prompt.rb +0 -22
- data/lib/pry/commands.rb +0 -6
- data/lib/pry/config/behavior.rb +0 -231
- data/lib/pry/config/convenience.rb +0 -25
- data/lib/pry/config/default.rb +0 -149
- data/lib/pry/config/memoization.rb +0 -44
- data/lib/pry/history_array.rb +0 -121
- data/lib/pry/platform.rb +0 -93
- data/lib/pry/plugins.rb +0 -118
- data/lib/pry/rbx_path.rb +0 -22
- data/lib/pry/rubygem.rb +0 -84
- data/lib/pry/terminal.rb +0 -90
data/lib/pry/slop/commands.rb
CHANGED
@@ -1,196 +1,190 @@
|
|
1
|
-
|
2
|
-
|
3
|
-
|
4
|
-
|
5
|
-
|
6
|
-
|
7
|
-
|
8
|
-
|
9
|
-
|
10
|
-
|
11
|
-
|
12
|
-
|
13
|
-
|
14
|
-
|
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
|
-
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
class Pry
|
4
|
+
class Slop
|
5
|
+
class Commands
|
6
|
+
include Enumerable
|
7
|
+
|
8
|
+
attr_reader :config, :commands, :arguments
|
9
|
+
attr_writer :banner
|
10
|
+
|
11
|
+
# Create a new instance of Slop::Commands and optionally build
|
12
|
+
# Slop instances via a block. Any configuration options used in
|
13
|
+
# this method will be the default configuration options sent to
|
14
|
+
# each Slop object created.
|
15
|
+
#
|
16
|
+
# config - An optional configuration Hash.
|
17
|
+
# block - Optional block used to define commands.
|
18
|
+
#
|
19
|
+
# Examples:
|
20
|
+
#
|
21
|
+
# commands = Slop::Commands.new do
|
22
|
+
# on :new do
|
23
|
+
# on '-o', '--outdir=', 'The output directory'
|
24
|
+
# on '-v', '--verbose', 'Enable verbose mode'
|
25
|
+
# end
|
26
|
+
#
|
27
|
+
# on :generate do
|
28
|
+
# on '--assets', 'Generate assets', :default => true
|
29
|
+
# end
|
30
|
+
#
|
31
|
+
# global do
|
32
|
+
# on '-D', '--debug', 'Enable debug mode', :default => false
|
33
|
+
# end
|
34
|
+
# end
|
35
|
+
#
|
36
|
+
# commands[:new].class #=> Slop
|
37
|
+
# commands.parse
|
38
|
+
#
|
39
|
+
def initialize(config = {}, &block)
|
40
|
+
@config = config
|
41
|
+
@commands = {}
|
42
|
+
@banner = nil
|
43
|
+
@triggered_command = nil
|
44
|
+
|
45
|
+
warn "[DEPRECATED] Slop::Commands is deprecated and will be removed in "\
|
46
|
+
"Slop version 4. Check out http://injekt.github.com/slop/#commands for "\
|
47
|
+
"a new implementation of commands."
|
48
|
+
|
49
|
+
return unless block_given?
|
50
|
+
|
47
51
|
block.arity == 1 ? yield(self) : instance_eval(&block)
|
48
52
|
end
|
49
|
-
end
|
50
53
|
|
51
|
-
|
52
|
-
|
53
|
-
|
54
|
-
|
55
|
-
|
56
|
-
|
57
|
-
|
58
|
-
|
59
|
-
|
54
|
+
# Optionally set the banner for this command help output.
|
55
|
+
#
|
56
|
+
# banner - The String text to set the banner.
|
57
|
+
#
|
58
|
+
# Returns the String banner if one is set.
|
59
|
+
def banner(banner = nil)
|
60
|
+
@banner = banner if banner
|
61
|
+
@banner
|
62
|
+
end
|
60
63
|
|
61
|
-
|
62
|
-
|
63
|
-
|
64
|
-
|
65
|
-
|
66
|
-
|
67
|
-
|
68
|
-
|
69
|
-
|
70
|
-
|
64
|
+
# Add a Slop instance for a specific command.
|
65
|
+
#
|
66
|
+
# command - A String or Symbol key used to identify this command.
|
67
|
+
# config - A Hash of configuration options to pass to Slop.
|
68
|
+
# block - An optional block used to pass options to Slop.
|
69
|
+
#
|
70
|
+
# Returns the newly created Slop instance mapped to command.
|
71
|
+
def on(command, config = {}, &block)
|
72
|
+
commands[command.to_s] = Slop.new(@config.merge(config), &block)
|
73
|
+
end
|
71
74
|
|
72
|
-
|
73
|
-
|
74
|
-
|
75
|
-
|
76
|
-
|
77
|
-
|
78
|
-
|
79
|
-
|
80
|
-
|
75
|
+
# Add a Slop instance used when no other commands exist.
|
76
|
+
#
|
77
|
+
# config - A Hash of configuration options to pass to Slop.
|
78
|
+
# block - An optional block used to pass options to Slop.
|
79
|
+
#
|
80
|
+
# Returns the newly created Slop instance mapped to default.
|
81
|
+
def default(config = {}, &block)
|
82
|
+
on('default', config, &block)
|
83
|
+
end
|
81
84
|
|
82
|
-
|
83
|
-
|
84
|
-
|
85
|
-
|
86
|
-
|
87
|
-
|
88
|
-
|
89
|
-
|
90
|
-
|
85
|
+
# Add a global Slop instance.
|
86
|
+
#
|
87
|
+
# config - A Hash of configuration options to pass to Slop.
|
88
|
+
# block - An optional block used to pass options to Slop.
|
89
|
+
#
|
90
|
+
# Returns the newly created Slop instance mapped to global.
|
91
|
+
def global(config = {}, &block)
|
92
|
+
on('global', config, &block)
|
93
|
+
end
|
91
94
|
|
92
|
-
|
93
|
-
|
94
|
-
|
95
|
-
|
96
|
-
|
97
|
-
|
98
|
-
|
99
|
-
|
100
|
-
|
101
|
-
|
102
|
-
|
103
|
-
|
104
|
-
|
105
|
-
|
106
|
-
|
107
|
-
|
108
|
-
|
109
|
-
|
110
|
-
|
111
|
-
|
112
|
-
|
113
|
-
|
95
|
+
# Fetch the instance of Slop tied to a command.
|
96
|
+
#
|
97
|
+
# key - The String or Symbol key used to locate this command.
|
98
|
+
#
|
99
|
+
# Returns the Slop instance if this key is found, nil otherwise.
|
100
|
+
def [](key)
|
101
|
+
commands[key.to_s]
|
102
|
+
end
|
103
|
+
alias get []
|
104
|
+
|
105
|
+
# Check for a command presence.
|
106
|
+
#
|
107
|
+
# Examples:
|
108
|
+
#
|
109
|
+
# cmds.parse %w( foo )
|
110
|
+
# cmds.present?(:foo) #=> true
|
111
|
+
# cmds.present?(:bar) #=> false
|
112
|
+
#
|
113
|
+
# Returns true if the given key is present in the parsed arguments.
|
114
|
+
def present?(key)
|
115
|
+
key.to_s == @triggered_command
|
116
|
+
end
|
114
117
|
|
115
|
-
|
116
|
-
|
117
|
-
|
118
|
-
|
118
|
+
# Enumerable interface.
|
119
|
+
def each(&block)
|
120
|
+
@commands.each(&block)
|
121
|
+
end
|
119
122
|
|
120
|
-
|
121
|
-
|
122
|
-
|
123
|
-
|
124
|
-
|
125
|
-
|
126
|
-
|
127
|
-
|
128
|
-
|
123
|
+
# Parse a list of items.
|
124
|
+
#
|
125
|
+
# items - The Array of items to parse.
|
126
|
+
#
|
127
|
+
# Returns the original Array of items.
|
128
|
+
def parse(items = ARGV)
|
129
|
+
parse! items.dup
|
130
|
+
items
|
131
|
+
end
|
129
132
|
|
130
|
-
|
131
|
-
|
132
|
-
|
133
|
-
|
134
|
-
|
135
|
-
|
136
|
-
|
137
|
-
|
138
|
-
|
139
|
-
opts.parse! items
|
140
|
-
execute_global_opts! items
|
141
|
-
else
|
142
|
-
if opts = commands['default']
|
133
|
+
# Parse a list of items, removing any options or option arguments found.
|
134
|
+
#
|
135
|
+
# items - The Array of items to parse.
|
136
|
+
#
|
137
|
+
# Returns the original Array of items with options removed.
|
138
|
+
def parse!(items = ARGV)
|
139
|
+
if (opts = commands[items[0].to_s])
|
140
|
+
@triggered_command = items.shift
|
141
|
+
execute_arguments! items
|
143
142
|
opts.parse! items
|
144
|
-
|
145
|
-
|
146
|
-
|
147
|
-
|
143
|
+
elsif (opts = commands['default'])
|
144
|
+
opts.parse! items
|
145
|
+
elsif config[:strict] && items[0]
|
146
|
+
raise InvalidCommandError, "Unknown command `#{items[0]}`"
|
148
147
|
end
|
149
148
|
execute_global_opts! items
|
149
|
+
items
|
150
150
|
end
|
151
|
-
items
|
152
|
-
end
|
153
151
|
|
154
|
-
|
155
|
-
|
156
|
-
|
157
|
-
|
152
|
+
# Returns a nested Hash with Slop options and values. See Slop#to_hash.
|
153
|
+
def to_hash
|
154
|
+
Hash[commands.map { |k, v| [k.to_sym, v.to_hash] }]
|
155
|
+
end
|
158
156
|
|
159
|
-
|
160
|
-
|
161
|
-
|
162
|
-
|
163
|
-
|
164
|
-
|
165
|
-
helps
|
157
|
+
# Returns the help String.
|
158
|
+
def to_s
|
159
|
+
defaults = commands.delete('default')
|
160
|
+
globals = commands.delete('global')
|
161
|
+
helps = commands.reject { |_, v| v.options.none? }
|
162
|
+
helps['Global options'] = globals.to_s if globals && globals.options.any?
|
163
|
+
helps['Other options'] = defaults.to_s if defaults && defaults.options.any?
|
164
|
+
banner = @banner ? "#{@banner}\n" : ""
|
165
|
+
banner + helps.map { |key, opts| " #{key}\n#{opts}" }.join("\n\n")
|
166
166
|
end
|
167
|
-
|
168
|
-
|
167
|
+
alias help to_s
|
168
|
+
|
169
|
+
# Returns the inspection String.
|
170
|
+
def inspect
|
171
|
+
"#<Slop::Commands #{config.inspect} #{commands.values.map(&:inspect)}>"
|
169
172
|
end
|
170
|
-
banner = @banner ? "#{@banner}\n" : ""
|
171
|
-
banner + helps.map { |key, opts| " #{key}\n#{opts}" }.join("\n\n")
|
172
|
-
end
|
173
|
-
alias help to_s
|
174
173
|
|
175
|
-
|
176
|
-
def inspect
|
177
|
-
"#<Slop::Commands #{config.inspect} #{commands.values.map(&:inspect)}>"
|
178
|
-
end
|
174
|
+
private
|
179
175
|
|
180
|
-
|
176
|
+
# Returns nothing.
|
177
|
+
def execute_arguments!(items)
|
178
|
+
@arguments = items.take_while { |arg| !arg.start_with?('-') }
|
179
|
+
items.shift @arguments.size
|
180
|
+
end
|
181
181
|
|
182
|
-
|
183
|
-
|
184
|
-
|
185
|
-
items.shift @arguments.size
|
186
|
-
end
|
182
|
+
# Returns nothing.
|
183
|
+
def execute_global_opts!(items)
|
184
|
+
return unless (global_opts = commands['global'])
|
187
185
|
|
188
|
-
|
189
|
-
def execute_global_opts!(items)
|
190
|
-
if global_opts = commands['global']
|
191
|
-
global_opts.parse! items
|
186
|
+
global_opts.parse!(items)
|
192
187
|
end
|
193
188
|
end
|
194
|
-
|
195
189
|
end
|
196
190
|
end
|