# go-prompt [![Go Report Card](https://goreportcard.com/badge/github.com/c-bata/go-prompt)](https://goreportcard.com/report/github.com/c-bata/go-prompt) ![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square) Library for building a powerful interactive prompt, inspired by [python-prompt-toolkit](https://github.com/jonathanslenders/python-prompt-toolkit). More easy to build a multi-platform binary of the command line tools because written in Golang. ```go package main import ( "fmt" "github.com/c-bata/go-prompt" ) func completer(d prompt.Document) []prompt.Suggest { s := []prompt.Suggest{ {Text: "users", Description: "Store the username and age"}, {Text: "articles", Description: "Store the article text posted by user"}, {Text: "comments", Description: "Store the text commented to articles"}, } return prompt.FilterHasPrefix(s, d.GetWordBeforeCursor(), true) } func main() { fmt.Println("Please select table.") t := prompt.Input("> ", completer) fmt.Println("You selected " + t) } ``` #### Projects using go-prompt * [c-bata/kube-prompt : An interactive kubernetes client featuring auto-complete written in Go.](https://github.com/c-bata/kube-prompt) * [rancher/cli : The Rancher Command Line Interface (CLI)is a unified tool to manage your Rancher server](https://github.com/rancher/cli) * [kubicorn/kubicorn : Simple, cloud native infrastructure for Kubernetes.](https://github.com/kubicorn/kubicorn) * [cch123/asm-cli : Interactive shell of assembly language(X86/X64) based on unicorn and rasm2](https://github.com/cch123/asm-cli) * [ktr0731/evans : more expressive universal gRPC client](https://github.com/ktr0731/evans) * (If you create a CLI using go-prompt and want your own project to be listed here, Please submit a Github Issue.) ## Features ### Powerful auto-completion [![demo](https://github.com/c-bata/assets/raw/master/go-prompt/kube-prompt.gif)](https://github.com/c-bata/kube-prompt) (This is a GIF animation of kube-prompt.) ### Flexible options go-prompt provides many options. Please check [option section of GoDoc](https://godoc.org/github.com/c-bata/go-prompt#Option) for more details. [![options](https://github.com/c-bata/assets/raw/master/go-prompt/prompt-options.png)](#flexible-options) ### Keyboard Shortcuts Emacs-like keyboard shortcut is available by default (it's also default shortcuts in Bash shell). You can customize and expand these shortcuts. [![keyboard shortcuts](https://github.com/c-bata/assets/raw/master/go-prompt/keyboard-shortcuts.gif)](#keyboard-shortcuts) KeyBinding | Description --------------------|--------------------------------------------------------- Ctrl + A | Go to the beginning of the line (Home) Ctrl + E | Go to the End of the line (End) Ctrl + P | Previous command (Up arrow) Ctrl + N | Next command (Down arrow) Ctrl + F | Forward one character Ctrl + B | Backward one character Ctrl + D | Delete character under the cursor Ctrl + H | Delete character before the cursor (Backspace) Ctrl + W | Cut the Word before the cursor to the clipboard. Ctrl + K | Cut the Line after the cursor to the clipboard. Ctrl + U | Cut/delete the Line before the cursor to the clipboard. Ctrl + L | Clear the screen ### History You can use up-arrow and down-arrow to walk through the history of commands executed. [![History](https://github.com/c-bata/assets/raw/master/go-prompt/history.gif)](#history) ### Multiple platform support We confirmed go-prompt works fine on following terminals: * iTerm2 (macOS) * Terminal.app (macOS) * Command Prompt (Windows) * GNU Terminal (Ubuntu) ## Links * [Change Log](./CHANGELOG.md) * [GoDoc](http://godoc.org/github.com/c-bata/go-prompt) * [gocover.io](https://gocover.io/github.com/c-bata/go-prompt) ## Author Masashi Shibata * Twitter: [@c\_bata\_](https://twitter.com/c_bata_/) * Github: [@c-bata](https://github.com/c-bata/) * Facebook: [Masashi Shibata](https://www.facebook.com/masashi.cbata) ## LICENSE This software is licensed under the MIT License (See [LICENSE](./LICENSE) ).