tree: 6211127fc87c7447db5a33605119b13c016cdf58 [path history] [tgz]
  1. bsdinput.go
  2. common.go
  3. COPYING
  4. fallbackinput.go
  5. input.go
  6. input_darwin.go
  7. input_linux.go
  8. input_test.go
  9. input_windows.go
  10. LICENSE
  11. line.go
  12. line_test.go
  13. output.go
  14. output_windows.go
  15. prefix_test.go
  16. race_test.go
  17. README.google
  18. README.md
  19. signal.go
  20. signal_legacy.go
  21. unixmode.go
  22. width.go
  23. width_test.go
go/src/github.com/peterh/liner/README.md

Liner

Liner is a command line editor with history. It was inspired by linenoise; everything Unix-like is a VT100 (or is trying very hard to be). If your terminal is not pretending to be a VT100, change it. Liner also support Windows.

Liner is released under the X11 license (which is similar to the new BSD license).

Line Editing

The following line editing commands are supported on platforms and terminals that Liner supports:

KeystrokeAction
Ctrl-A, HomeMove cursor to beginning of line
Ctrl-E, EndMove cursor to end of line
Ctrl-B, LeftMove cursor one character left
Ctrl-F, RightMove cursor one character right
Ctrl-LeftMove cursor to previous word
Ctrl-RightMove cursor to next word
Ctrl-D, Del(if line is not empty) Delete character under cursor
Ctrl-D(if line is empty) End of File - usually quits application
Ctrl-CReset input (create new empty prompt)
Ctrl-LClear screen (line is unmodified)
Ctrl-TTranspose previous character with current character
Ctrl-H, BackSpaceDelete character before cursor
Ctrl-WDelete word leading up to cursor
Ctrl-KDelete from cursor to end of line
Ctrl-UDelete from start of line to cursor
Ctrl-P, UpPrevious match from history
Ctrl-N, DownNext match from history
Ctrl-RReverse Search history (Ctrl-S forward, Ctrl-G cancel)
Ctrl-YPaste from Yank buffer (Alt-Y to paste next yank instead)
TabNext completion
Shift-Tab(after Tab) Previous completion

Getting started

package main

import (
	"log"
	"os"
	"strings"

	"github.com/peterh/liner"
)

var (
	history_fn = "/tmp/.liner_history"
	names      = []string{"john", "james", "mary", "nancy"}
)

func main() {
	line := liner.NewLiner()
	defer line.Close()

	line.SetCompleter(func(line string) (c []string) {
		for _, n := range names {
			if strings.HasPrefix(n, strings.ToLower(line)) {
				c = append(c, n)
			}
		}
		return
	})

	if f, err := os.Open(history_fn); err == nil {
		line.ReadHistory(f)
		f.Close()
	}

	if name, err := line.Prompt("What is your name? "); err != nil {
		log.Print("Error reading line: ", err)
	} else {
		log.Print("Got: ", name)
		line.AppendHistory(name)
	}

	if f, err := os.Create(history_fn); err != nil {
		log.Print("Error writing history file: ", err)
	} else {
		line.WriteHistory(f)
		f.Close()
	}
}

For documentation, see http://godoc.org/github.com/peterh/liner