Class: TTY::Reader::History Private

Inherits:
Object
  • Object
show all
Extended by:
Forwardable
Includes:
Enumerable
Defined in:
lib/tty/reader/history.rb

Overview

This class is part of a private API. You should avoid using this class if possible, as it may be removed or be changed in the future.

A class responsible for storing a history of all lines entered by user when interacting with shell prompt.

Constant Summary collapse

DEFAULT_SIZE =

This constant is part of a private API. You should avoid using this constant if possible, as it may be removed or be changed in the future.

Default maximum size

32 << 4

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(max_size = DEFAULT_SIZE, **options) {|_self| ... } ⇒ History

Create a History buffer

param [Integer] max_size

the maximum size for history buffer

param [Hash] options

Options Hash (**options):

  • :cycle (Boolean) —

    whether or not the history should cycle, false by default

  • :duplicates (Boolean) —

    whether or not to store duplicates, true by default

  • :exclude (Boolean) —

    a Proc to exclude items from storing in history

Yields:

  • (_self)

Yield Parameters:



46
47
48
49
50
51
52
53
54
 
# File 'lib/tty/reader/history.rb', line 46

def initialize(max_size = DEFAULT_SIZE, **options)
  @max_size   = max_size
  @index      = nil
  @history    = []
  @duplicates = options.fetch(:duplicates) { true }
  @exclude    = options.fetch(:exclude) { proc {} }
  @cycle      = options.fetch(:cycle) { false }
  yield self if block_given?
end

Instance Attribute Details

#cycle ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



26
27
28
 
# File 'lib/tty/reader/history.rb', line 26

def cycle
  @cycle
end

#duplicates ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



28
29
30
 
# File 'lib/tty/reader/history.rb', line 28

def duplicates
  @duplicates
end

#exclude ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



30
31
32
 
# File 'lib/tty/reader/history.rb', line 30

def exclude
  @exclude
end

#index ⇒ Object (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



24
25
26
 
# File 'lib/tty/reader/history.rb', line 24

def index
  @index
end

#max_size ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Set and retrieve the maximum size of the buffer



22
23
24
 
# File 'lib/tty/reader/history.rb', line 22

def max_size
  @max_size
end

Instance Method Details

#[](index) ⇒ Object

Return line at the specified index

Raises:

  • (IndexError) —

    index out of range



119
120
121
122
123
124
125
126
127
128
 
# File 'lib/tty/reader/history.rb', line 119

def [](index)
  if index < 0
    index += @history.size if index < 0
  end
  line = @history[index]
  if line.nil?
    raise IndexError, 'invalid index'
  end
  line.dup
end

#clear ⇒ Object

Empty all history lines



142
143
144
145
 
# File 'lib/tty/reader/history.rb', line 142

def clear
  @history.clear
  @index = 0
end

#each ⇒ Object

Iterates over history lines



59
60
61
62
63
64
65
 
# File 'lib/tty/reader/history.rb', line 59

def each
  if block_given?
    @history.each { |line| yield line }
  else
    @history.to_enum
  end
end

#get ⇒ Object

Get current line



133
134
135
136
137
 
# File 'lib/tty/reader/history.rb', line 133

def get
  return if size.zero?

  self[@index]
end

#next ⇒ Object

Move the pointer to the next line in the history



87
88
89
90
91
92
93
94
 
# File 'lib/tty/reader/history.rb', line 87

def next
  return if size.zero?
  if @index == size - 1
    @index = 0 if @cycle
  else
    @index += 1
  end
end

#next? ⇒ Boolean

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



96
97
98
 
# File 'lib/tty/reader/history.rb', line 96

def next?
  size > 0 && !(@index == size - 1 && !@cycle)
end

#previous ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Move the pointer to the previous line in the history



101
102
103
104
105
106
107
108
 
# File 'lib/tty/reader/history.rb', line 101

def previous
  return if size.zero?
  if @index.zero?
    @index = size - 1 if @cycle
  else
    @index -= 1
  end
end

#previous? ⇒ Boolean

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



110
111
112
 
# File 'lib/tty/reader/history.rb', line 110

def previous?
  size > 0 && !(@index < 0 && !@cycle)
end

#push(line) ⇒ Object Also known as: <<

Add the last typed line to history buffer



72
73
74
75
76
77
78
79
80
81
 
# File 'lib/tty/reader/history.rb', line 72

def push(line)
  @history.delete(line) unless @duplicates
  return if line.to_s.empty? || @exclude[line]

  @history.shift if size >= max_size
  @history << line
  @index = @history.size - 1

  self
end