forked from mirror/readline
223 lines
4.5 KiB
Go
223 lines
4.5 KiB
Go
package readline
|
|
|
|
import (
|
|
"io"
|
|
"os"
|
|
)
|
|
|
|
type Instance struct {
|
|
Config *Config
|
|
Terminal *Terminal
|
|
Operation *Operation
|
|
}
|
|
|
|
type Config struct {
|
|
// prompt supports ANSI escape sequence, so we can color some characters even in windows
|
|
Prompt string
|
|
|
|
// readline will persist historys to file where HistoryFile specified
|
|
HistoryFile string
|
|
// specify the max length of historys, it's 500 by default, set it to -1 to disable history
|
|
HistoryLimit int
|
|
DisableAutoSaveHistory bool
|
|
|
|
// AutoCompleter will called once user press TAB
|
|
AutoComplete AutoCompleter
|
|
|
|
// Any key press will pass to Listener
|
|
// NOTE: Listener will be triggered by (nil, 0, 0) immediately
|
|
Listener Listener
|
|
|
|
// If VimMode is true, readline will in vim.insert mode by default
|
|
VimMode bool
|
|
|
|
InterruptPrompt string
|
|
EOFPrompt string
|
|
|
|
FuncGetWidth func() int
|
|
|
|
Stdin io.Reader
|
|
Stdout io.Writer
|
|
Stderr io.Writer
|
|
|
|
EnableMask bool
|
|
MaskRune rune
|
|
|
|
// erase the editing line after user submited it
|
|
// it often use in IM.
|
|
UniqueEditLine bool
|
|
|
|
// force use interactive even stdout is not a tty
|
|
StdinFd int
|
|
StdoutFd int
|
|
ForceUseInteractive bool
|
|
|
|
// private fields
|
|
inited bool
|
|
opHistory *opHistory
|
|
opSearch *opSearch
|
|
}
|
|
|
|
func (c *Config) useInteractive() bool {
|
|
if c.ForceUseInteractive {
|
|
return true
|
|
}
|
|
return IsTerminal(c.StdoutFd) && IsTerminal(c.StdinFd)
|
|
}
|
|
|
|
func (c *Config) Init() error {
|
|
if c.inited {
|
|
return nil
|
|
}
|
|
c.inited = true
|
|
if c.Stdin == nil {
|
|
c.Stdin = os.Stdin
|
|
}
|
|
if c.Stdout == nil {
|
|
c.Stdout = Stdout
|
|
}
|
|
if c.Stderr == nil {
|
|
c.Stderr = Stderr
|
|
}
|
|
if c.StdinFd == 0 {
|
|
c.StdinFd = StdinFd
|
|
}
|
|
if c.StdoutFd == 0 {
|
|
c.StdoutFd = StdoutFd
|
|
}
|
|
if c.HistoryLimit == 0 {
|
|
c.HistoryLimit = 500
|
|
}
|
|
|
|
if c.InterruptPrompt == "" {
|
|
c.InterruptPrompt = "^C"
|
|
} else if c.InterruptPrompt == "\n" {
|
|
c.InterruptPrompt = ""
|
|
}
|
|
if c.EOFPrompt == "" {
|
|
c.EOFPrompt = "^D"
|
|
} else if c.EOFPrompt == "\n" {
|
|
c.EOFPrompt = ""
|
|
}
|
|
|
|
if c.FuncGetWidth == nil {
|
|
c.FuncGetWidth = genGetWidthFunc(c.StdoutFd)
|
|
}
|
|
|
|
return nil
|
|
}
|
|
|
|
func (c Config) Clone() *Config {
|
|
c.opHistory = nil
|
|
c.opSearch = nil
|
|
return &c
|
|
}
|
|
|
|
func (c *Config) SetListener(f func(line []rune, pos int, key rune) (newLine []rune, newPos int, ok bool)) {
|
|
c.Listener = FuncListener(f)
|
|
}
|
|
|
|
func NewEx(cfg *Config) (*Instance, error) {
|
|
t, err := NewTerminal(cfg)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
rl := t.Readline()
|
|
return &Instance{
|
|
Config: cfg,
|
|
Terminal: t,
|
|
Operation: rl,
|
|
}, nil
|
|
}
|
|
|
|
func New(prompt string) (*Instance, error) {
|
|
return NewEx(&Config{Prompt: prompt})
|
|
}
|
|
|
|
func (i *Instance) SetPrompt(s string) {
|
|
i.Operation.SetPrompt(s)
|
|
}
|
|
|
|
func (i *Instance) SetMaskRune(r rune) {
|
|
i.Operation.SetMaskRune(r)
|
|
}
|
|
|
|
// change hisotry persistence in runtime
|
|
func (i *Instance) SetHistoryPath(p string) {
|
|
i.Operation.SetHistoryPath(p)
|
|
}
|
|
|
|
// readline will refresh automatic when write through Stdout()
|
|
func (i *Instance) Stdout() io.Writer {
|
|
return i.Operation.Stdout()
|
|
}
|
|
|
|
// readline will refresh automatic when write through Stdout()
|
|
func (i *Instance) Stderr() io.Writer {
|
|
return i.Operation.Stderr()
|
|
}
|
|
|
|
// switch VimMode in runtime
|
|
func (i *Instance) SetVimMode(on bool) {
|
|
i.Operation.SetVimMode(on)
|
|
}
|
|
|
|
func (i *Instance) IsVimMode() bool {
|
|
return i.Operation.IsEnableVimMode()
|
|
}
|
|
|
|
func (i *Instance) GenPasswordConfig() *Config {
|
|
return i.Operation.GenPasswordConfig()
|
|
}
|
|
|
|
// we can generate a config by `i.GenPasswordConfig()`
|
|
func (i *Instance) ReadPasswordWithConfig(cfg *Config) ([]byte, error) {
|
|
return i.Operation.PasswordWithConfig(cfg)
|
|
}
|
|
|
|
func (i *Instance) ReadPasswordEx(prompt string, l Listener) ([]byte, error) {
|
|
return i.Operation.PasswordEx(prompt, l)
|
|
}
|
|
|
|
func (i *Instance) ReadPassword(prompt string) ([]byte, error) {
|
|
return i.Operation.Password(prompt)
|
|
}
|
|
|
|
// err is one of (nil, io.EOF, readline.ErrInterrupt)
|
|
func (i *Instance) Readline() (string, error) {
|
|
return i.Operation.String()
|
|
}
|
|
|
|
func (i *Instance) SaveHistory(content string) error {
|
|
return i.Operation.SaveHistory(content)
|
|
}
|
|
|
|
// same as readline
|
|
func (i *Instance) ReadSlice() ([]byte, error) {
|
|
return i.Operation.Slice()
|
|
}
|
|
|
|
// we must make sure that call Close() before process exit.
|
|
func (i *Instance) Close() error {
|
|
if err := i.Terminal.Close(); err != nil {
|
|
return err
|
|
}
|
|
i.Operation.Close()
|
|
return nil
|
|
}
|
|
|
|
func (i *Instance) SetConfig(cfg *Config) *Config {
|
|
if i.Config == cfg {
|
|
return cfg
|
|
}
|
|
old := i.Config
|
|
i.Config = cfg
|
|
i.Operation.SetConfig(cfg)
|
|
i.Terminal.SetConfig(cfg)
|
|
return old
|
|
}
|
|
|
|
func (i *Instance) Refresh() {
|
|
i.Operation.Refresh()
|
|
}
|