Class: Reline::ANSI
Constant Summary collapse
- CAPNAME_KEY_BINDINGS =
{ 'khome' => :ed_move_to_beg, 'kend' => :ed_move_to_end, 'kdch1' => :key_delete, 'kpp' => :ed_search_prev_history, 'knp' => :ed_search_next_history, 'kcuu1' => :ed_prev_history, 'kcud1' => :ed_next_history, 'kcuf1' => :ed_next_char, 'kcub1' => :ed_prev_char, }
- ANSI_CURSOR_KEY_BINDINGS =
{ # Up 'A' => [:ed_prev_history, {}], # Down 'B' => [:ed_next_history, {}], # Right 'C' => [:ed_next_char, { ctrl: :em_next_word, meta: :em_next_word }], # Left 'D' => [:ed_prev_char, { ctrl: :ed_prev_word, meta: :ed_prev_word }], # End 'F' => [:ed_move_to_end, {}], # Home 'H' => [:ed_move_to_beg, {}], }
- START_BRACKETED_PASTE =
String.new("\e[200~", encoding: Encoding::ASCII_8BIT)
- END_BRACKETED_PASTE =
String.new("\e[201~", encoding: Encoding::ASCII_8BIT)
Constants inherited from IO
Instance Method Summary collapse
- #both_tty? ⇒ Boolean
- #clear_screen ⇒ Object
- #cursor_pos ⇒ Object
- #deprep(otio) ⇒ Object
- #empty_buffer? ⇒ Boolean
- #encoding ⇒ Object
- #erase_after_cursor ⇒ Object
- #get_screen_size ⇒ Object
-
#getc(timeout_second) ⇒ Object
if the usage expects to wait indefinitely, use Float::INFINITY for timeout_second.
- #hide_cursor ⇒ Object
- #in_pasting? ⇒ Boolean
-
#initialize ⇒ ANSI
constructor
A new instance of ANSI.
- #inner_getc(timeout_second) ⇒ Object
- #input=(val) ⇒ Object
- #move_cursor_column(x) ⇒ Object
- #move_cursor_down(x) ⇒ Object
- #move_cursor_up(x) ⇒ Object
- #output=(val) ⇒ Object
- #prep ⇒ Object
- #read_bracketed_paste ⇒ Object
- #retrieve_keybuffer ⇒ Object
-
#scroll_down(x) ⇒ Object
This only works when the cursor is at the bottom of the scroll range For more details, see github.com/ruby/reline/pull/577#issuecomment-1646679623.
- #set_bracketed_paste_key_bindings(config) ⇒ Object
- #set_default_key_bindings(config, allow_terminfo: true) ⇒ Object
- #set_default_key_bindings_ansi_cursor(config) ⇒ Object
- #set_default_key_bindings_comprehensive_list(config) ⇒ Object
- #set_default_key_bindings_terminfo(config) ⇒ Object
- #set_screen_size(rows, columns) ⇒ Object
- #set_winch_handler(&handler) ⇒ Object
- #show_cursor ⇒ Object
- #ungetc(c) ⇒ Object
- #with_raw_input ⇒ Object
Methods inherited from IO
decide_io_gate, #dumb?, #reset_color_sequence, #win?
Constructor Details
#initialize ⇒ ANSI
Returns a new instance of ANSI.
36 37 38 39 40 41 |
# File 'lib/reline/io/ansi.rb', line 36 def initialize @input = STDIN @output = STDOUT @buf = [] @old_winch_handler = nil end |
Instance Method Details
#both_tty? ⇒ Boolean
283 284 285 |
# File 'lib/reline/io/ansi.rb', line 283 def both_tty? @input.tty? && @output.tty? end |
#clear_screen ⇒ Object
343 344 345 346 |
# File 'lib/reline/io/ansi.rb', line 343 def clear_screen @output.write "\e[2J" @output.write "\e[1;1H" end |
#cursor_pos ⇒ Object
248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 |
# File 'lib/reline/io/ansi.rb', line 248 def cursor_pos if both_tty? res = +'' m = nil @input.raw do |stdin| @output << "\e[6n" @output.flush loop do c = stdin.getc next if c.nil? res << c m = res.match(/\e\[(?<row>\d+);(?<column>\d+)R/) break if m end (m.pre_match + m.post_match).chars.reverse_each do |ch| stdin.ungetc ch end end column = m[:column].to_i - 1 row = m[:row].to_i - 1 else begin buf = @output.pread(@output.pos, 0) row = buf.count("\n") column = buf.rindex("\n") ? (buf.size - buf.rindex("\n")) - 1 : 0 rescue Errno::ESPIPE, IOError # Just returns column 1 for ambiguous width because this I/O is not # tty and can't seek. row = 0 column = 1 end end Reline::CursorPos.new(column, row) end |
#deprep(otio) ⇒ Object
366 367 368 369 370 371 |
# File 'lib/reline/io/ansi.rb', line 366 def deprep(otio) # Disable bracketed paste @output.write "\e[?2004l" if Reline.core.config.enable_bracketed_paste && both_tty? Signal.trap('WINCH', @old_winch_handler) if @old_winch_handler Signal.trap('CONT', @old_cont_handler) if @old_cont_handler end |
#empty_buffer? ⇒ Boolean
209 210 211 212 213 214 |
# File 'lib/reline/io/ansi.rb', line 209 def empty_buffer? unless @buf.empty? return false end !@input.wait_readable(0) end |
#encoding ⇒ Object
43 44 45 |
# File 'lib/reline/io/ansi.rb', line 43 def encoding Encoding.default_external end |
#erase_after_cursor ⇒ Object
331 332 333 |
# File 'lib/reline/io/ansi.rb', line 331 def erase_after_cursor @output.write "\e[K" end |
#get_screen_size ⇒ Object
231 232 233 234 235 236 237 238 239 |
# File 'lib/reline/io/ansi.rb', line 231 def get_screen_size s = @input.winsize return s if s[0] > 0 && s[1] > 0 s = [ENV["LINES"].to_i, ENV["COLUMNS"].to_i] return s if s[0] > 0 && s[1] > 0 [24, 80] rescue Errno::ENOTTY, Errno::ENODEV [24, 80] end |
#getc(timeout_second) ⇒ Object
if the usage expects to wait indefinitely, use Float::INFINITY for timeout_second
201 202 203 |
# File 'lib/reline/io/ansi.rb', line 201 def getc(timeout_second) inner_getc(timeout_second) end |
#hide_cursor ⇒ Object
307 308 309 310 311 312 313 314 315 316 317 |
# File 'lib/reline/io/ansi.rb', line 307 def hide_cursor seq = "\e[?25l" if Reline::Terminfo.enabled? && Reline::Terminfo.term_supported? begin seq = Reline::Terminfo.tigetstr('civis') rescue Reline::Terminfo::TerminfoError # civis is undefined end end @output.write seq end |
#in_pasting? ⇒ Boolean
205 206 207 |
# File 'lib/reline/io/ansi.rb', line 205 def in_pasting? not empty_buffer? end |
#inner_getc(timeout_second) ⇒ Object
170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 |
# File 'lib/reline/io/ansi.rb', line 170 def inner_getc(timeout_second) unless @buf.empty? return @buf.shift end until @input.wait_readable(0.01) timeout_second -= 0.01 return nil if timeout_second <= 0 Reline.core.line_editor.handle_signal end c = @input.getbyte (c == 0x16 && @input.tty? && @input.raw(min: 0, time: 0, &:getbyte)) || c rescue Errno::EIO # Maybe the I/O has been closed. nil end |
#input=(val) ⇒ Object
154 155 156 |
# File 'lib/reline/io/ansi.rb', line 154 def input=(val) @input = val end |
#move_cursor_column(x) ⇒ Object
287 288 289 |
# File 'lib/reline/io/ansi.rb', line 287 def move_cursor_column(x) @output.write "\e[#{x + 1}G" end |
#move_cursor_down(x) ⇒ Object
299 300 301 302 303 304 305 |
# File 'lib/reline/io/ansi.rb', line 299 def move_cursor_down(x) if x > 0 @output.write "\e[#{x}B" elsif x < 0 move_cursor_up(-x) end end |
#move_cursor_up(x) ⇒ Object
291 292 293 294 295 296 297 |
# File 'lib/reline/io/ansi.rb', line 291 def move_cursor_up(x) if x > 0 @output.write "\e[#{x}A" elsif x < 0 move_cursor_down(-x) end end |
#output=(val) ⇒ Object
158 159 160 |
# File 'lib/reline/io/ansi.rb', line 158 def output=(val) @output = val end |
#prep ⇒ Object
359 360 361 362 363 364 |
# File 'lib/reline/io/ansi.rb', line 359 def prep # Enable bracketed paste @output.write "\e[?2004h" if Reline.core.config.enable_bracketed_paste && both_tty? retrieve_keybuffer nil end |
#read_bracketed_paste ⇒ Object
189 190 191 192 193 194 195 196 197 198 |
# File 'lib/reline/io/ansi.rb', line 189 def read_bracketed_paste buffer = String.new(encoding: Encoding::ASCII_8BIT) until buffer.end_with?(END_BRACKETED_PASTE) c = inner_getc(Float::INFINITY) break unless c buffer << c end string = buffer.delete_suffix(END_BRACKETED_PASTE).force_encoding(encoding) string.valid_encoding? ? string : '' end |
#retrieve_keybuffer ⇒ Object
220 221 222 223 224 225 226 227 228 229 |
# File 'lib/reline/io/ansi.rb', line 220 def retrieve_keybuffer begin return unless @input.wait_readable(0.001) str = @input.read_nonblock(1024) str.bytes.each do |c| @buf.push(c) end rescue EOFError end end |
#scroll_down(x) ⇒ Object
This only works when the cursor is at the bottom of the scroll range For more details, see github.com/ruby/reline/pull/577#issuecomment-1646679623
337 338 339 340 341 |
# File 'lib/reline/io/ansi.rb', line 337 def scroll_down(x) return if x.zero? # We use `\n` instead of CSI + S because CSI + S would cause https://github.com/ruby/reline/issues/576 @output.write "\n" * x end |
#set_bracketed_paste_key_bindings(config) ⇒ Object
70 71 72 73 74 |
# File 'lib/reline/io/ansi.rb', line 70 def set_bracketed_paste_key_bindings(config) [:emacs, :vi_insert, :vi_command].each do |keymap| config.add_default_key_binding_by_keymap(keymap, START_BRACKETED_PASTE.bytes, :bracketed_paste_start) end end |
#set_default_key_bindings(config, allow_terminfo: true) ⇒ Object
47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 |
# File 'lib/reline/io/ansi.rb', line 47 def set_default_key_bindings(config, allow_terminfo: true) set_bracketed_paste_key_bindings(config) set_default_key_bindings_ansi_cursor(config) if allow_terminfo && Reline::Terminfo.enabled? set_default_key_bindings_terminfo(config) else set_default_key_bindings_comprehensive_list(config) end { [27, 91, 90] => :completion_journey_up, # S-Tab }.each_pair do |key, func| config.add_default_key_binding_by_keymap(:emacs, key, func) config.add_default_key_binding_by_keymap(:vi_insert, key, func) end { # default bindings [27, 32] => :em_set_mark, # M-<space> [24, 24] => :em_exchange_mark, # C-x C-x }.each_pair do |key, func| config.add_default_key_binding_by_keymap(:emacs, key, func) end end |
#set_default_key_bindings_ansi_cursor(config) ⇒ Object
76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 |
# File 'lib/reline/io/ansi.rb', line 76 def set_default_key_bindings_ansi_cursor(config) ANSI_CURSOR_KEY_BINDINGS.each do |char, (default_func, modifiers)| bindings = [["\e[#{char}", default_func]] # CSI + char if modifiers[:ctrl] # CSI + ctrl_key_modifier + char bindings << ["\e[1;5#{char}", modifiers[:ctrl]] end if modifiers[:meta] # CSI + meta_key_modifier + char bindings << ["\e[1;3#{char}", modifiers[:meta]] # Meta(ESC) + CSI + char bindings << ["\e\e[#{char}", modifiers[:meta]] end bindings.each do |sequence, func| key = sequence.bytes config.add_default_key_binding_by_keymap(:emacs, key, func) config.add_default_key_binding_by_keymap(:vi_insert, key, func) config.add_default_key_binding_by_keymap(:vi_command, key, func) end end end |
#set_default_key_bindings_comprehensive_list(config) ⇒ Object
115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 |
# File 'lib/reline/io/ansi.rb', line 115 def set_default_key_bindings_comprehensive_list(config) { # xterm [27, 91, 51, 126] => :key_delete, # kdch1 [27, 91, 53, 126] => :ed_search_prev_history, # kpp [27, 91, 54, 126] => :ed_search_next_history, # knp # Console (80x25) [27, 91, 49, 126] => :ed_move_to_beg, # Home [27, 91, 52, 126] => :ed_move_to_end, # End # KDE # Del is 0x08 [27, 71, 65] => :ed_prev_history, # ↑ [27, 71, 66] => :ed_next_history, # ↓ [27, 71, 67] => :ed_next_char, # → [27, 71, 68] => :ed_prev_char, # ← # urxvt / exoterm [27, 91, 55, 126] => :ed_move_to_beg, # Home [27, 91, 56, 126] => :ed_move_to_end, # End # GNOME [27, 79, 72] => :ed_move_to_beg, # Home [27, 79, 70] => :ed_move_to_end, # End # Del is 0x08 # Arrow keys are the same of KDE [27, 79, 65] => :ed_prev_history, # ↑ [27, 79, 66] => :ed_next_history, # ↓ [27, 79, 67] => :ed_next_char, # → [27, 79, 68] => :ed_prev_char, # ← }.each_pair do |key, func| config.add_default_key_binding_by_keymap(:emacs, key, func) config.add_default_key_binding_by_keymap(:vi_insert, key, func) config.add_default_key_binding_by_keymap(:vi_command, key, func) end end |
#set_default_key_bindings_terminfo(config) ⇒ Object
98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 |
# File 'lib/reline/io/ansi.rb', line 98 def set_default_key_bindings_terminfo(config) key_bindings = CAPNAME_KEY_BINDINGS.map do |capname, key_binding| begin key_code = Reline::Terminfo.tigetstr(capname) [ key_code.bytes, key_binding ] rescue Reline::Terminfo::TerminfoError # capname is undefined end end.compact.to_h key_bindings.each_pair do |key, func| config.add_default_key_binding_by_keymap(:emacs, key, func) config.add_default_key_binding_by_keymap(:vi_insert, key, func) config.add_default_key_binding_by_keymap(:vi_command, key, func) end end |
#set_screen_size(rows, columns) ⇒ Object
241 242 243 244 245 246 |
# File 'lib/reline/io/ansi.rb', line 241 def set_screen_size(rows, columns) @input.winsize = [rows, columns] self rescue Errno::ENOTTY, Errno::ENODEV self end |
#set_winch_handler(&handler) ⇒ Object
348 349 350 351 352 353 354 355 356 357 |
# File 'lib/reline/io/ansi.rb', line 348 def set_winch_handler(&handler) @old_winch_handler = Signal.trap('WINCH', &handler) @old_cont_handler = Signal.trap('CONT') do @input.raw!(intr: true) if @input.tty? # Rerender the screen. Note that screen size might be changed while suspended. handler.call end rescue ArgumentError # Signal.trap may raise an ArgumentError if the platform doesn't support the signal. end |
#show_cursor ⇒ Object
319 320 321 322 323 324 325 326 327 328 329 |
# File 'lib/reline/io/ansi.rb', line 319 def show_cursor seq = "\e[?25h" if Reline::Terminfo.enabled? && Reline::Terminfo.term_supported? begin seq = Reline::Terminfo.tigetstr('cnorm') rescue Reline::Terminfo::TerminfoError # cnorm is undefined end end @output.write seq end |
#ungetc(c) ⇒ Object
216 217 218 |
# File 'lib/reline/io/ansi.rb', line 216 def ungetc(c) @buf.unshift(c) end |
#with_raw_input ⇒ Object
162 163 164 165 166 167 168 |
# File 'lib/reline/io/ansi.rb', line 162 def with_raw_input if @input.tty? @input.raw(intr: true) { yield } else yield end end |