pry 0.9.12.2 → 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 +1141 -0
- data/LICENSE +2 -2
- data/README.md +466 -0
- 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 +97 -92
- data/lib/pry/code/code_file.rb +114 -0
- data/lib/pry/code/code_range.rb +7 -4
- data/lib/pry/code/loc.rb +27 -14
- data/lib/pry/code.rb +62 -90
- data/lib/pry/code_object.rb +83 -39
- data/lib/pry/color_printer.rb +66 -0
- data/lib/pry/command.rb +202 -371
- data/lib/pry/command_set.rb +151 -133
- 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 -73
- data/lib/pry/commands/cat/file_formatter.rb +56 -63
- data/lib/pry/commands/cat/input_expression_formatter.rb +35 -30
- data/lib/pry/commands/cat.rb +64 -47
- data/lib/pry/commands/cd.rb +42 -26
- data/lib/pry/commands/change_inspector.rb +34 -0
- data/lib/pry/commands/change_prompt.rb +51 -0
- 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 +33 -24
- data/lib/pry/commands/edit.rb +183 -167
- 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 -17
- data/lib/pry/commands/find_method.rb +167 -167
- data/lib/pry/commands/fix_indent.rb +16 -12
- data/lib/pry/commands/help.rb +140 -133
- data/lib/pry/commands/hist.rb +153 -132
- 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 +42 -0
- data/lib/pry/commands/ls/constants.rb +75 -0
- data/lib/pry/commands/ls/formatter.rb +55 -0
- data/lib/pry/commands/ls/globals.rb +50 -0
- data/lib/pry/commands/ls/grep.rb +23 -0
- data/lib/pry/commands/ls/instance_vars.rb +40 -0
- data/lib/pry/commands/ls/interrogatable.rb +24 -0
- data/lib/pry/commands/ls/jruby_hacks.rb +55 -0
- data/lib/pry/commands/ls/local_names.rb +37 -0
- data/lib/pry/commands/ls/local_vars.rb +47 -0
- data/lib/pry/commands/ls/ls_entity.rb +65 -0
- data/lib/pry/commands/ls/methods.rb +55 -0
- data/lib/pry/commands/ls/methods_helper.rb +50 -0
- data/lib/pry/commands/ls/self_methods.rb +34 -0
- data/lib/pry/commands/ls.rb +100 -303
- data/lib/pry/commands/nesting.rb +21 -17
- data/lib/pry/commands/play.rb +93 -49
- data/lib/pry/commands/pry_backtrace.rb +22 -18
- 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 +57 -48
- data/lib/pry/commands/reset.rb +16 -12
- data/lib/pry/commands/ri.rb +57 -38
- data/lib/pry/commands/save_file.rb +45 -43
- data/lib/pry/commands/shell_command.rb +66 -34
- data/lib/pry/commands/shell_mode.rb +22 -20
- data/lib/pry/commands/show_doc.rb +80 -65
- data/lib/pry/commands/show_info.rb +193 -159
- data/lib/pry/commands/show_input.rb +16 -11
- data/lib/pry/commands/show_source.rb +113 -33
- data/lib/pry/commands/stat.rb +35 -31
- data/lib/pry/commands/switch_to.rb +21 -15
- data/lib/pry/commands/toggle_color.rb +21 -13
- data/lib/pry/commands/watch_expression/expression.rb +43 -0
- data/lib/pry/commands/watch_expression.rb +110 -0
- data/lib/pry/commands/whereami.rb +157 -134
- 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 +290 -220
- data/lib/pry/control_d_handler.rb +28 -0
- data/lib/pry/core_extensions.rb +50 -27
- data/lib/pry/editor.rb +130 -102
- data/lib/pry/env.rb +18 -0
- data/lib/pry/exception_handler.rb +43 -0
- data/lib/pry/exceptions.rb +73 -0
- data/lib/pry/forwardable.rb +27 -0
- data/lib/pry/helpers/base_helpers.rb +22 -151
- data/lib/pry/helpers/command_helpers.rb +55 -63
- data/lib/pry/helpers/documentation_helpers.rb +21 -13
- data/lib/pry/helpers/options_helpers.rb +15 -8
- data/lib/pry/helpers/platform.rb +55 -0
- data/lib/pry/helpers/table.rb +44 -32
- data/lib/pry/helpers/text.rb +96 -86
- data/lib/pry/helpers.rb +3 -0
- data/lib/pry/history.rb +101 -70
- data/lib/pry/hooks.rb +67 -137
- data/lib/pry/indent.rb +79 -73
- data/lib/pry/input_completer.rb +283 -0
- data/lib/pry/input_lock.rb +129 -0
- data/lib/pry/inspector.rb +39 -0
- data/lib/pry/last_exception.rb +61 -0
- data/lib/pry/method/disowned.rb +19 -5
- data/lib/pry/{commands/edit/method_patcher.rb → method/patcher.rb} +51 -42
- data/lib/pry/method/weird_method_locator.rb +80 -44
- data/lib/pry/method.rb +225 -176
- data/lib/pry/object_path.rb +91 -0
- data/lib/pry/output.rb +136 -0
- data/lib/pry/pager.rb +227 -68
- data/lib/pry/prompt.rb +214 -0
- data/lib/pry/pry_class.rb +216 -289
- data/lib/pry/pry_instance.rb +438 -500
- data/lib/pry/repl.rb +256 -0
- data/lib/pry/repl_file_loader.rb +34 -35
- 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 +20 -0
- data/lib/pry/{module_candidate.rb → wrapped_module/candidate.rb} +36 -43
- data/lib/pry/wrapped_module.rb +102 -103
- data/lib/pry.rb +135 -261
- metadata +94 -283
- data/.document +0 -2
- data/.gitignore +0 -16
- data/.travis.yml +0 -21
- data/.yardopts +0 -1
- data/CHANGELOG +0 -534
- data/CONTRIBUTORS +0 -55
- data/Gemfile +0 -9
- data/Guardfile +0 -62
- data/README.markdown +0 -400
- data/Rakefile +0 -140
- data/TODO +0 -117
- 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 -29
- 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 -102
- data/lib/pry/commands/install_command.rb +0 -51
- data/lib/pry/commands/simple_prompt.rb +0 -22
- data/lib/pry/commands.rb +0 -6
- data/lib/pry/completion.rb +0 -304
- data/lib/pry/custom_completions.rb +0 -6
- data/lib/pry/history_array.rb +0 -116
- data/lib/pry/plugins.rb +0 -103
- data/lib/pry/rbx_method.rb +0 -13
- data/lib/pry/rbx_path.rb +0 -22
- data/lib/pry/rubygem.rb +0 -74
- data/lib/pry/terminal.rb +0 -78
- data/lib/pry/test/helper.rb +0 -185
- data/man/pry.1 +0 -195
- data/man/pry.1.html +0 -204
- data/man/pry.1.ronn +0 -141
- data/pry.gemspec +0 -30
- data/spec/Procfile +0 -3
- data/spec/cli_spec.rb +0 -78
- data/spec/code_object_spec.rb +0 -277
- data/spec/code_spec.rb +0 -219
- data/spec/command_helpers_spec.rb +0 -29
- data/spec/command_integration_spec.rb +0 -644
- data/spec/command_set_spec.rb +0 -627
- data/spec/command_spec.rb +0 -821
- data/spec/commands/amend_line_spec.rb +0 -247
- data/spec/commands/bang_spec.rb +0 -19
- data/spec/commands/cat_spec.rb +0 -164
- data/spec/commands/cd_spec.rb +0 -250
- data/spec/commands/disable_pry_spec.rb +0 -25
- data/spec/commands/edit_spec.rb +0 -727
- data/spec/commands/exit_all_spec.rb +0 -34
- data/spec/commands/exit_program_spec.rb +0 -19
- data/spec/commands/exit_spec.rb +0 -34
- data/spec/commands/find_method_spec.rb +0 -70
- data/spec/commands/gem_list_spec.rb +0 -26
- data/spec/commands/gist_spec.rb +0 -79
- data/spec/commands/help_spec.rb +0 -56
- data/spec/commands/hist_spec.rb +0 -181
- data/spec/commands/jump_to_spec.rb +0 -15
- data/spec/commands/ls_spec.rb +0 -181
- data/spec/commands/play_spec.rb +0 -140
- data/spec/commands/raise_up_spec.rb +0 -56
- data/spec/commands/save_file_spec.rb +0 -177
- data/spec/commands/show_doc_spec.rb +0 -510
- data/spec/commands/show_input_spec.rb +0 -17
- data/spec/commands/show_source_spec.rb +0 -782
- data/spec/commands/whereami_spec.rb +0 -203
- data/spec/completion_spec.rb +0 -239
- data/spec/control_d_handler_spec.rb +0 -58
- data/spec/documentation_helper_spec.rb +0 -73
- data/spec/editor_spec.rb +0 -79
- data/spec/exception_whitelist_spec.rb +0 -21
- data/spec/fixtures/candidate_helper1.rb +0 -11
- data/spec/fixtures/candidate_helper2.rb +0 -8
- data/spec/fixtures/example.erb +0 -5
- data/spec/fixtures/example_nesting.rb +0 -33
- data/spec/fixtures/show_source_doc_examples.rb +0 -15
- data/spec/fixtures/testrc +0 -2
- data/spec/fixtures/testrcbad +0 -2
- data/spec/fixtures/whereami_helper.rb +0 -6
- data/spec/helper.rb +0 -34
- data/spec/helpers/bacon.rb +0 -86
- data/spec/helpers/mock_pry.rb +0 -43
- data/spec/helpers/table_spec.rb +0 -105
- data/spec/history_array_spec.rb +0 -67
- data/spec/hooks_spec.rb +0 -522
- data/spec/indent_spec.rb +0 -301
- data/spec/input_stack_spec.rb +0 -90
- data/spec/method_spec.rb +0 -482
- data/spec/prompt_spec.rb +0 -60
- data/spec/pry_defaults_spec.rb +0 -419
- data/spec/pry_history_spec.rb +0 -99
- data/spec/pry_output_spec.rb +0 -95
- data/spec/pry_spec.rb +0 -504
- data/spec/run_command_spec.rb +0 -25
- data/spec/sticky_locals_spec.rb +0 -157
- data/spec/syntax_checking_spec.rb +0 -81
- data/spec/wrapped_module_spec.rb +0 -261
- data/wiki/Customizing-pry.md +0 -397
- data/wiki/Home.md +0 -4
data/lib/pry/prompt.rb
ADDED
@@ -0,0 +1,214 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
class Pry
|
4
|
+
# Prompt represents the Pry prompt, which can be used with Readline-like
|
5
|
+
# libraries. It defines a few default prompts (default prompt, simple prompt,
|
6
|
+
# etc) and also provides an API for adding and implementing custom prompts.
|
7
|
+
#
|
8
|
+
# @example Registering a new Pry prompt
|
9
|
+
# Pry::Prompt.add(
|
10
|
+
# :ipython,
|
11
|
+
# 'IPython-like prompt', [':', '...:']
|
12
|
+
# ) do |_context, _nesting, pry_instance, sep|
|
13
|
+
# sep == ':' ? "In [#{pry_instance.input_ring.count}]: " : ' ...: '
|
14
|
+
# end
|
15
|
+
#
|
16
|
+
# # Produces:
|
17
|
+
# # In [3]: def foo
|
18
|
+
# # ...: puts 'foo'
|
19
|
+
# # ...: end
|
20
|
+
# # => :foo
|
21
|
+
# # In [4]:
|
22
|
+
#
|
23
|
+
# @example Manually instantiating the Prompt class
|
24
|
+
# prompt_procs = [
|
25
|
+
# proc { '#{rand(1)}>" },
|
26
|
+
# proc { "#{('a'..'z').to_a.sample}*" }
|
27
|
+
# ]
|
28
|
+
# prompt = Pry::Prompt.new(
|
29
|
+
# :random,
|
30
|
+
# 'Random number or letter prompt.',
|
31
|
+
# prompt_procs
|
32
|
+
# )
|
33
|
+
# prompt.wait_proc.call(...) #=>
|
34
|
+
# prompt.incomplete_proc.call(...)
|
35
|
+
#
|
36
|
+
# @since v0.11.0
|
37
|
+
# @api public
|
38
|
+
class Prompt
|
39
|
+
# A Hash that holds all prompts. The keys of the Hash are prompt
|
40
|
+
# names, the values are Hash instances of the format {:description, :value}.
|
41
|
+
@prompts = {}
|
42
|
+
|
43
|
+
class << self
|
44
|
+
# Retrieves a prompt.
|
45
|
+
#
|
46
|
+
# @example
|
47
|
+
# Prompt[:my_prompt]
|
48
|
+
#
|
49
|
+
# @param [Symbol] name The name of the prompt you want to access
|
50
|
+
# @return [Hash{Symbol=>Object}]
|
51
|
+
# @since v0.12.0
|
52
|
+
def [](name)
|
53
|
+
@prompts[name.to_s]
|
54
|
+
end
|
55
|
+
|
56
|
+
# @return [Hash{Symbol=>Hash}] the duplicate of the internal prompts hash
|
57
|
+
# @note Use this for read-only operations
|
58
|
+
# @since v0.12.0
|
59
|
+
def all
|
60
|
+
@prompts.dup
|
61
|
+
end
|
62
|
+
|
63
|
+
# Adds a new prompt to the prompt hash.
|
64
|
+
#
|
65
|
+
# @param [Symbol] name
|
66
|
+
# @param [String] description
|
67
|
+
# @param [Array<String>] separators The separators to differentiate
|
68
|
+
# between prompt modes (default mode and class/method definition mode).
|
69
|
+
# The Array *must* have a size of 2.
|
70
|
+
# @yield [context, nesting, pry_instance, sep]
|
71
|
+
# @yieldparam context [Object] the context where Pry is currently in
|
72
|
+
# @yieldparam nesting [Integer] whether the context is nested
|
73
|
+
# @yieldparam pry_instance [Pry] the Pry instance
|
74
|
+
# @yieldparam separator [String] separator string
|
75
|
+
# @return [nil]
|
76
|
+
# @raise [ArgumentError] if the size of `separators` is not 2
|
77
|
+
# @raise [ArgumentError] if `prompt_name` is already occupied
|
78
|
+
# @since v0.12.0
|
79
|
+
def add(name, description = '', separators = %w[> *])
|
80
|
+
name = name.to_s
|
81
|
+
|
82
|
+
unless separators.size == 2
|
83
|
+
raise ArgumentError, "separators size must be 2, given #{separators.size}"
|
84
|
+
end
|
85
|
+
|
86
|
+
if @prompts.key?(name)
|
87
|
+
raise ArgumentError, "the '#{name}' prompt was already added"
|
88
|
+
end
|
89
|
+
|
90
|
+
@prompts[name] = new(
|
91
|
+
name,
|
92
|
+
description,
|
93
|
+
separators.map do |sep|
|
94
|
+
proc do |context, nesting, pry_instance|
|
95
|
+
yield(context, nesting, pry_instance, sep)
|
96
|
+
end
|
97
|
+
end
|
98
|
+
)
|
99
|
+
|
100
|
+
nil
|
101
|
+
end
|
102
|
+
end
|
103
|
+
|
104
|
+
# @return [String]
|
105
|
+
attr_reader :name
|
106
|
+
|
107
|
+
# @return [String]
|
108
|
+
attr_reader :description
|
109
|
+
|
110
|
+
# @return [Array<Proc>] the array of procs that hold
|
111
|
+
# `[wait_proc, incomplete_proc]`
|
112
|
+
attr_reader :prompt_procs
|
113
|
+
|
114
|
+
# @param [String] name
|
115
|
+
# @param [String] description
|
116
|
+
# @param [Array<Proc>] prompt_procs
|
117
|
+
def initialize(name, description, prompt_procs)
|
118
|
+
@name = name
|
119
|
+
@description = description
|
120
|
+
@prompt_procs = prompt_procs
|
121
|
+
end
|
122
|
+
|
123
|
+
# @return [Proc] the proc which builds the wait prompt (`>`)
|
124
|
+
def wait_proc
|
125
|
+
@prompt_procs.first
|
126
|
+
end
|
127
|
+
|
128
|
+
# @return [Proc] the proc which builds the prompt when in the middle of an
|
129
|
+
# expression such as open method, etc. (`*`)
|
130
|
+
def incomplete_proc
|
131
|
+
@prompt_procs.last
|
132
|
+
end
|
133
|
+
|
134
|
+
# @deprecated Use a `Pry::Prompt` instance directly
|
135
|
+
def [](key)
|
136
|
+
key = key.to_s
|
137
|
+
if %w[name description].include?(key)
|
138
|
+
Pry::Warning.warn(
|
139
|
+
"`Pry::Prompt[:#{@name}][:#{key}]` is deprecated. " \
|
140
|
+
"Use `#{self.class}##{key}` instead"
|
141
|
+
)
|
142
|
+
public_send(key)
|
143
|
+
elsif key.to_s == 'value'
|
144
|
+
Pry::Warning.warn(
|
145
|
+
"`#{self.class}[:#{@name}][:value]` is deprecated. Use " \
|
146
|
+
"`#{self.class}#prompt_procs` instead or an instance of " \
|
147
|
+
"`#{self.class}` directly"
|
148
|
+
)
|
149
|
+
@prompt_procs
|
150
|
+
end
|
151
|
+
end
|
152
|
+
|
153
|
+
add(
|
154
|
+
:default,
|
155
|
+
"The default Pry prompt. Includes information about the current expression \n" \
|
156
|
+
"number, evaluation context, and nesting level, plus a reminder that you're \n" \
|
157
|
+
'using Pry.'
|
158
|
+
) do |context, nesting, pry_instance, sep|
|
159
|
+
format(
|
160
|
+
"[%<in_count>s] %<name>s(%<context>s)%<nesting>s%<separator>s ",
|
161
|
+
in_count: pry_instance.input_ring.count,
|
162
|
+
name: pry_instance.config.prompt_name,
|
163
|
+
context: Pry.view_clip(context),
|
164
|
+
nesting: (nesting > 0 ? ":#{nesting}" : ''),
|
165
|
+
separator: sep
|
166
|
+
)
|
167
|
+
end
|
168
|
+
|
169
|
+
add(
|
170
|
+
:simple,
|
171
|
+
"A simple `>>`.",
|
172
|
+
['>> ', ' | ']
|
173
|
+
) do |_, _, _, sep|
|
174
|
+
sep
|
175
|
+
end
|
176
|
+
|
177
|
+
add(
|
178
|
+
:nav,
|
179
|
+
"A prompt that displays the binding stack as a path and includes information \n" \
|
180
|
+
"about #{Helpers::Text.bold('_in_')} and #{Helpers::Text.bold('_out_')}.",
|
181
|
+
%w[> *]
|
182
|
+
) do |_context, _nesting, pry_instance, sep|
|
183
|
+
tree = pry_instance.binding_stack.map { |b| Pry.view_clip(b.eval('self')) }
|
184
|
+
format(
|
185
|
+
"[%<in_count>s] (%<name>s) %<tree>s: %<stack_size>s%<separator>s ",
|
186
|
+
in_count: pry_instance.input_ring.count,
|
187
|
+
name: pry_instance.config.prompt_name,
|
188
|
+
tree: tree.join(' / '),
|
189
|
+
stack_size: pry_instance.binding_stack.size - 1,
|
190
|
+
separator: sep
|
191
|
+
)
|
192
|
+
end
|
193
|
+
|
194
|
+
add(
|
195
|
+
:shell,
|
196
|
+
'A prompt that displays `$PWD` as you change it.',
|
197
|
+
%w[$ *]
|
198
|
+
) do |context, _nesting, pry_instance, sep|
|
199
|
+
format(
|
200
|
+
"%<name>s %<context>s:%<pwd>s %<separator>s ",
|
201
|
+
name: pry_instance.config.prompt_name,
|
202
|
+
context: Pry.view_clip(context),
|
203
|
+
pwd: Dir.pwd,
|
204
|
+
separator: sep
|
205
|
+
)
|
206
|
+
end
|
207
|
+
|
208
|
+
add(
|
209
|
+
:none,
|
210
|
+
'Wave goodbye to the Pry prompt.',
|
211
|
+
Array.new(2)
|
212
|
+
) { '' }
|
213
|
+
end
|
214
|
+
end
|