plugeth/vendor/github.com/gizak/termui
Péter Szilágyi 289b30715d Godeps, vendor: convert dependency management to trash (#3198)
This commit converts the dependency management from Godeps to the vendor
folder, also switching the tool from godep to trash. Since the upstream tool
lacks a few features proposed via a few PRs, until those PRs are merged in
(if), use github.com/karalabe/trash.

You can update dependencies via trash --update.

All dependencies have been updated to their latest version.

Parts of the build system are reworked to drop old notions of Godeps and
invocation of the go vet command so that it doesn't run against the vendor
folder, as that will just blow up during vetting.

The conversion drops OpenCL (and hence GPU mining support) from ethash and our
codebase. The short reasoning is that there's noone to maintain and having
opencl libs in our deps messes up builds as go install ./... tries to build
them, failing with unsatisfied link errors for the C OpenCL deps.

golang.org/x/net/context is not vendored in. We expect it to be fetched by the
user (i.e. using go get). To keep ci.go builds reproducible the package is
"vendored" in build/_vendor.
2016-10-28 19:05:01 +02:00
..
.gitignore Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
.travis.yml Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
barchart.go Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
block_common.go Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
block_windows.go Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
block.go Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
buffer.go Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
canvas.go Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
config Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
doc.go Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
events.go Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
gauge.go Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
glide.lock Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
glide.yaml Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
grid.go Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
helper.go Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
LICENSE Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
linechart_others.go Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
linechart_windows.go Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
linechart.go Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
list.go Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
mbarchart.go Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
mkdocs.yml Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
par.go Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
pos.go Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
README.md Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
render.go Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
sparkline.go Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
textbuilder.go Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
theme.go Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00
widget.go Godeps, vendor: convert dependency management to trash (#3198) 2016-10-28 19:05:01 +02:00

termui Build Status Doc Status

demo cast under osx 10.10; Terminal.app; Menlo Regular 12pt.)

termui is a cross-platform, easy-to-compile, and fully-customizable terminal dashboard. It is inspired by blessed-contrib, but purely in Go.

Now version v2 has arrived! It brings new event system, new theme system, new Buffer interface and specific colour text rendering. (some docs are missing, but it will be completed soon!)

Installation

master mirrors v2 branch, to install:

go get -u github.com/gizak/termui

It is recommanded to use locked deps by using glide: move to termui src directory then run glide up.

For the compatible reason, you can choose to install the legacy version of termui:

go get gopkg.in/gizak/termui.v1

Usage

Layout

To use termui, the very first thing you may want to know is how to manage layout. termui offers two ways of doing this, known as absolute layout and grid layout.

Absolute layout

Each widget has an underlying block structure which basically is a box model. It has border, label and padding properties. A border of a widget can be chosen to hide or display (with its border label), you can pick a different front/back colour for the border as well. To display such a widget at a specific location in terminal window, you need to assign .X, .Y, .Height, .Width values for each widget before sending it to .Render. Let's demonstrate these by a code snippet:

	import ui "github.com/gizak/termui" // <- ui shortcut, optional

	func main() {
		err := ui.Init()
		if err != nil {
			panic(err)
		}
		defer ui.Close()

		p := ui.NewPar(":PRESS q TO QUIT DEMO")
		p.Height = 3
		p.Width = 50
		p.TextFgColor = ui.ColorWhite
		p.BorderLabel = "Text Box"
		p.BorderFg = ui.ColorCyan

		g := ui.NewGauge()
		g.Percent = 50
		g.Width = 50
		g.Height = 3
		g.Y = 11
		g.BorderLabel = "Gauge"
		g.BarColor = ui.ColorRed
		g.BorderFg = ui.ColorWhite
		g.BorderLabelFg = ui.ColorCyan

		ui.Render(p, g) // feel free to call Render, it's async and non-block

		// event handler...
	}

Note that components can be overlapped (I'd rather call this a feature...), Render(rs ...Renderer) renders its args from left to right (i.e. each component's weight is arising from left to right).

Grid layout:

grid

Grid layout uses 12 columns grid system with expressive syntax. To use Grid, all we need to do is build a widget tree consisting of Rows and Cols (Actually a Col is also a Row but with a widget endpoint attached).

	import ui "github.com/gizak/termui"
	// init and create widgets...

	// build
	ui.Body.AddRows(
		ui.NewRow(
			ui.NewCol(6, 0, widget0),
			ui.NewCol(6, 0, widget1)),
		ui.NewRow(
			ui.NewCol(3, 0, widget2),
			ui.NewCol(3, 0, widget30, widget31, widget32),
			ui.NewCol(6, 0, widget4)))

	// calculate layout
	ui.Body.Align()

	ui.Render(ui.Body)

Events

termui ships with a http-like event mux handling system. All events are channeled up from different sources (typing, click, windows resize, custom event) and then encoded as universal Event object. Event.Path indicates the event type and Event.Data stores the event data struct. Add a handler to a certain event is easy as below:

	// handle key q pressing
	ui.Handle("/sys/kbd/q", func(ui.Event) {
		// press q to quit
		ui.StopLoop()
	})

	ui.Handle("/sys/kbd/C-x", func(ui.Event) {
		// handle Ctrl + x combination
	})

	ui.Handle("/sys/kbd", func(ui.Event) {
		// handle all other key pressing
	})

	// handle a 1s timer
	ui.Handle("/timer/1s", func(e ui.Event) {
		t := e.Data.(ui.EvtTimer)
		// t is a EvtTimer
		if t.Count%2 ==0 {
			// do something
		}
	})

	ui.Loop() // block until StopLoop is called

Widgets

Click image to see the corresponding demo codes.

par list gauge linechart barchart barchart sparklines

GoDoc

godoc

TODO

  • Grid layout
  • Event system
  • Canvas widget
  • Refine APIs
  • Focusable widgets

Changelog

License

This library is under the MIT License