pry 0.10.1 → 0.14.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +5 -5
- data/CHANGELOG.md +412 -11
- data/LICENSE +1 -1
- data/README.md +352 -306
- data/bin/pry +4 -7
- data/lib/pry/basic_object.rb +10 -0
- data/lib/pry/block_command.rb +22 -0
- data/lib/pry/class_command.rb +194 -0
- data/lib/pry/cli.rb +83 -96
- data/lib/pry/code/code_file.rb +37 -26
- data/lib/pry/code/code_range.rb +7 -5
- data/lib/pry/code/loc.rb +26 -13
- data/lib/pry/code.rb +50 -31
- data/lib/pry/code_object.rb +53 -28
- data/lib/pry/color_printer.rb +46 -35
- data/lib/pry/command.rb +197 -369
- data/lib/pry/command_set.rb +89 -114
- 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 +85 -72
- data/lib/pry/commands/cat/file_formatter.rb +56 -46
- 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 -131
- data/lib/pry/commands/disable_pry.rb +23 -19
- data/lib/pry/commands/easter_eggs.rb +23 -34
- 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 +185 -157
- 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 +59 -31
- data/lib/pry/commands/ls/formatter.rb +42 -36
- 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 -21
- data/lib/pry/commands/ls.rb +124 -103
- 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 +57 -42
- data/lib/pry/commands/save_file.rb +45 -43
- data/lib/pry/commands/shell_command.rb +56 -29
- 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 +194 -155
- 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 -141
- 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 +313 -20
- data/lib/pry/control_d_handler.rb +28 -0
- data/lib/pry/core_extensions.rb +22 -9
- data/lib/pry/editor.rb +53 -33
- data/lib/pry/env.rb +18 -0
- data/lib/pry/exception_handler.rb +43 -0
- data/lib/pry/exceptions.rb +13 -17
- data/lib/pry/forwardable.rb +27 -0
- data/lib/pry/helpers/base_helpers.rb +20 -62
- data/lib/pry/helpers/command_helpers.rb +52 -62
- data/lib/pry/helpers/documentation_helpers.rb +21 -12
- data/lib/pry/helpers/options_helpers.rb +15 -8
- data/lib/pry/helpers/platform.rb +60 -0
- data/lib/pry/helpers/table.rb +44 -32
- data/lib/pry/helpers/text.rb +96 -85
- data/lib/pry/helpers.rb +3 -0
- data/lib/pry/history.rb +81 -55
- data/lib/pry/hooks.rb +60 -110
- data/lib/pry/indent.rb +72 -66
- data/lib/pry/input_completer.rb +199 -158
- 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 +19 -5
- data/lib/pry/method/patcher.rb +14 -8
- data/lib/pry/method/weird_method_locator.rb +79 -43
- data/lib/pry/method.rb +177 -124
- data/lib/pry/object_path.rb +37 -28
- data/lib/pry/output.rb +102 -16
- data/lib/pry/pager.rb +187 -174
- data/lib/pry/prompt.rb +213 -25
- data/lib/pry/pry_class.rb +106 -98
- data/lib/pry/pry_instance.rb +261 -224
- data/lib/pry/repl.rb +82 -27
- data/lib/pry/repl_file_loader.rb +27 -22
- data/lib/pry/ring.rb +89 -0
- data/lib/pry/slop/LICENSE +20 -0
- data/lib/pry/slop/commands.rb +190 -0
- data/lib/pry/slop/option.rb +210 -0
- data/lib/pry/slop.rb +672 -0
- data/lib/pry/syntax_highlighter.rb +26 -0
- data/lib/pry/system_command_handler.rb +17 -0
- data/lib/pry/testable/evalable.rb +24 -0
- data/lib/pry/testable/mockable.rb +22 -0
- data/lib/pry/testable/pry_tester.rb +88 -0
- data/lib/pry/testable/utility.rb +34 -0
- data/lib/pry/testable/variables.rb +52 -0
- data/lib/pry/testable.rb +68 -0
- data/lib/pry/version.rb +3 -1
- data/lib/pry/warning.rb +27 -0
- data/lib/pry/{module_candidate.rb → wrapped_module/candidate.rb} +29 -27
- data/lib/pry/wrapped_module.rb +67 -57
- data/lib/pry.rb +133 -149
- metadata +52 -63
- 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/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 -139
- data/lib/pry/config/convenience.rb +0 -25
- data/lib/pry/config/default.rb +0 -161
- data/lib/pry/history_array.rb +0 -121
- data/lib/pry/plugins.rb +0 -103
- data/lib/pry/rbx_path.rb +0 -22
- data/lib/pry/rubygem.rb +0 -82
- data/lib/pry/terminal.rb +0 -79
- data/lib/pry/test/helper.rb +0 -170
@@ -0,0 +1,210 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
class Pry
|
4
|
+
class Slop
|
5
|
+
class Option
|
6
|
+
# The default Hash of configuration options this class uses.
|
7
|
+
DEFAULT_OPTIONS = {
|
8
|
+
argument: false,
|
9
|
+
optional_argument: false,
|
10
|
+
tail: false,
|
11
|
+
default: nil,
|
12
|
+
callback: nil,
|
13
|
+
delimiter: ',',
|
14
|
+
limit: 0,
|
15
|
+
match: nil,
|
16
|
+
optional: true,
|
17
|
+
required: false,
|
18
|
+
as: String,
|
19
|
+
autocreated: false
|
20
|
+
}.freeze
|
21
|
+
|
22
|
+
attr_reader :short, :long, :description, :config, :types
|
23
|
+
attr_accessor :count, :argument_in_value
|
24
|
+
|
25
|
+
# Incapsulate internal option information, mainly used to store
|
26
|
+
# option specific configuration data, most of the meat of this
|
27
|
+
# class is found in the #value method.
|
28
|
+
#
|
29
|
+
# slop - The instance of Slop tied to this Option.
|
30
|
+
# short - The String or Symbol short flag.
|
31
|
+
# long - The String or Symbol long flag.
|
32
|
+
# description - The String description text.
|
33
|
+
# config - A Hash of configuration options.
|
34
|
+
# block - An optional block used as a callback.
|
35
|
+
def initialize(slop, short, long, description, config = {}, &block)
|
36
|
+
@slop = slop
|
37
|
+
@short = short
|
38
|
+
@long = long
|
39
|
+
@description = description
|
40
|
+
@config = DEFAULT_OPTIONS.merge(config)
|
41
|
+
@count = 0
|
42
|
+
@callback = block_given? ? block : config[:callback]
|
43
|
+
@value = nil
|
44
|
+
|
45
|
+
@types = {
|
46
|
+
string: proc { |v| v.to_s },
|
47
|
+
symbol: proc { |v| v.to_sym },
|
48
|
+
integer: proc { |v| value_to_integer(v) },
|
49
|
+
float: proc { |v| value_to_float(v) },
|
50
|
+
range: proc { |v| value_to_range(v) },
|
51
|
+
count: proc { @count }
|
52
|
+
}
|
53
|
+
|
54
|
+
if long && long.size > @slop.config[:longest_flag]
|
55
|
+
@slop.config[:longest_flag] = long.size
|
56
|
+
end
|
57
|
+
|
58
|
+
@config.each_key do |key|
|
59
|
+
predicate = :"#{key}?"
|
60
|
+
unless self.class.method_defined?(predicate)
|
61
|
+
self.class.__send__(:define_method, predicate) { !@config.key?(key) }
|
62
|
+
end
|
63
|
+
end
|
64
|
+
end
|
65
|
+
|
66
|
+
# Returns true if this option expects an argument.
|
67
|
+
def expects_argument?
|
68
|
+
config[:argument] && config[:argument] != :optional
|
69
|
+
end
|
70
|
+
|
71
|
+
# Returns true if this option accepts an optional argument.
|
72
|
+
def accepts_optional_argument?
|
73
|
+
config[:optional_argument] || config[:argument] == :optional
|
74
|
+
end
|
75
|
+
|
76
|
+
# Returns the String flag of this option. Preferring the long flag.
|
77
|
+
def key
|
78
|
+
long || short
|
79
|
+
end
|
80
|
+
|
81
|
+
# Call this options callback if one exists, and it responds to call().
|
82
|
+
#
|
83
|
+
# Returns nothing.
|
84
|
+
def call(*objects)
|
85
|
+
@callback.call(*objects) if @callback.respond_to?(:call)
|
86
|
+
end
|
87
|
+
|
88
|
+
# Set the new argument value for this option.
|
89
|
+
#
|
90
|
+
# We use this setter method to handle concatenating lists. That is,
|
91
|
+
# when an array type is specified and used more than once, values from
|
92
|
+
# both options will be grouped together and flattened into a single array.
|
93
|
+
def value=(new_value)
|
94
|
+
if config[:as].to_s.casecmp('array') == 0
|
95
|
+
@value ||= []
|
96
|
+
|
97
|
+
if new_value.respond_to?(:split)
|
98
|
+
@value.concat new_value.split(config[:delimiter], config[:limit])
|
99
|
+
end
|
100
|
+
else
|
101
|
+
@value = new_value
|
102
|
+
end
|
103
|
+
end
|
104
|
+
|
105
|
+
# Fetch the argument value for this option.
|
106
|
+
#
|
107
|
+
# Returns the Object once any type conversions have taken place.
|
108
|
+
def value
|
109
|
+
value = @value.nil? ? config[:default] : @value
|
110
|
+
|
111
|
+
return value if [true, false, nil].include?(value) && config[:as].to_s != 'count'
|
112
|
+
|
113
|
+
type = config[:as]
|
114
|
+
if type.respond_to?(:call)
|
115
|
+
type.call(value)
|
116
|
+
elsif (callable = types[type.to_s.downcase.to_sym])
|
117
|
+
callable.call(value)
|
118
|
+
else
|
119
|
+
value
|
120
|
+
end
|
121
|
+
end
|
122
|
+
|
123
|
+
# Returns the help String for this option.
|
124
|
+
def to_s
|
125
|
+
return config[:help] if config[:help].respond_to?(:to_str)
|
126
|
+
|
127
|
+
out = " #{short ? "-#{short}, " : ' ' * 4}"
|
128
|
+
|
129
|
+
if long
|
130
|
+
out += "--#{long}"
|
131
|
+
size = long.size
|
132
|
+
diff = @slop.config[:longest_flag] - size
|
133
|
+
out += (' ' * (diff + 6))
|
134
|
+
else
|
135
|
+
out += (' ' * (@slop.config[:longest_flag] + 8))
|
136
|
+
end
|
137
|
+
|
138
|
+
"#{out}#{description}"
|
139
|
+
end
|
140
|
+
alias help to_s
|
141
|
+
|
142
|
+
# Returns the String inspection text.
|
143
|
+
def inspect
|
144
|
+
"#<Slop::Option [-#{short} | --#{long}" \
|
145
|
+
"#{'=' if expects_argument?}#{'=?' if accepts_optional_argument?}]" \
|
146
|
+
" (#{description}) #{config.inspect}"
|
147
|
+
end
|
148
|
+
|
149
|
+
private
|
150
|
+
|
151
|
+
# Convert an object to an Integer if possible.
|
152
|
+
#
|
153
|
+
# value - The Object we want to convert to an integer.
|
154
|
+
#
|
155
|
+
# Returns the Integer value if possible to convert, else a zero.
|
156
|
+
def value_to_integer(value)
|
157
|
+
if @slop.strict?
|
158
|
+
begin
|
159
|
+
Integer(value.to_s, 10)
|
160
|
+
rescue ArgumentError
|
161
|
+
raise InvalidArgumentError, "#{value} could not be coerced into Integer"
|
162
|
+
end
|
163
|
+
else
|
164
|
+
value.to_s.to_i
|
165
|
+
end
|
166
|
+
end
|
167
|
+
|
168
|
+
# Convert an object to a Float if possible.
|
169
|
+
#
|
170
|
+
# value - The Object we want to convert to a float.
|
171
|
+
#
|
172
|
+
# Returns the Float value if possible to convert, else a zero.
|
173
|
+
def value_to_float(value)
|
174
|
+
if @slop.strict?
|
175
|
+
begin
|
176
|
+
Float(value.to_s)
|
177
|
+
rescue ArgumentError
|
178
|
+
raise InvalidArgumentError, "#{value} could not be coerced into Float"
|
179
|
+
end
|
180
|
+
else
|
181
|
+
value.to_s.to_f
|
182
|
+
end
|
183
|
+
end
|
184
|
+
|
185
|
+
# Convert an object to a Range if possible.
|
186
|
+
#
|
187
|
+
# value - The Object we want to convert to a range.
|
188
|
+
#
|
189
|
+
# Returns the Range value if one could be found, else the original object.
|
190
|
+
def value_to_range(value)
|
191
|
+
case value.to_s
|
192
|
+
when /\A(\-?\d+)\z/
|
193
|
+
Range.new(Regexp.last_match(1).to_i, Regexp.last_match(1).to_i)
|
194
|
+
when /\A(-?\d+?)(\.\.\.?|-|,)(-?\d+)\z/
|
195
|
+
Range.new(
|
196
|
+
Regexp.last_match(1).to_i,
|
197
|
+
Regexp.last_match(3).to_i,
|
198
|
+
Regexp.last_match(2) == '...'
|
199
|
+
)
|
200
|
+
else
|
201
|
+
if @slop.strict?
|
202
|
+
raise InvalidArgumentError, "#{value} could not be coerced into Range"
|
203
|
+
end
|
204
|
+
|
205
|
+
value
|
206
|
+
end
|
207
|
+
end
|
208
|
+
end
|
209
|
+
end
|
210
|
+
end
|