2018-05-09 01:58:49 +08:00
|
|
|
[](https://godoc.org/github.com/mum4k/termdash)
|
|
|
|
|
[](https://travis-ci.org/mum4k/termdash)
|
|
|
|
|
[](https://coveralls.io/github/mum4k/termdash?branch=master)
|
2018-05-28 02:40:08 +08:00
|
|
|
[](https://goreportcard.com/report/github.com/mum4k/termdash)
|
2018-05-28 02:41:21 +08:00
|
|
|
[](https://github.com/mum4k/termdash/blob/master/LICENSE)
|
2018-05-09 01:58:49 +08:00
|
|
|
|
2018-03-24 20:01:49 +08:00
|
|
|
# termdash
|
2018-03-24 20:14:06 +08:00
|
|
|
|
|
|
|
|
This project implements a terminal based dashboard. The feature set is inspired
|
2018-03-24 20:31:33 +08:00
|
|
|
by the [gizak/termui](http://github.com/gizak/termui) project, which in turn
|
|
|
|
|
was inspired by a javascript based
|
|
|
|
|
[yaronn/blessed-contrib](http://github.com/yaronn/blessed-contrib). Why the
|
|
|
|
|
rewrite you ask?
|
2018-03-24 20:14:06 +08:00
|
|
|
|
2018-03-24 20:31:33 +08:00
|
|
|
1. The above mentioned [gizak/termui](http://github.com/gizak/termui) is
|
|
|
|
|
abandoned and isn't maintained anymore.
|
2018-03-24 20:14:06 +08:00
|
|
|
1. The project doesn't follow the design goals outlined below.
|
|
|
|
|
|
|
|
|
|
# Design goals
|
|
|
|
|
|
2018-04-02 08:04:02 +08:00
|
|
|
This effort is focused on good software design and maintainability. By good
|
2018-04-02 08:03:15 +08:00
|
|
|
design I mean:
|
2018-03-24 20:14:06 +08:00
|
|
|
|
|
|
|
|
1. Write readable, well documented code.
|
2018-03-24 20:31:33 +08:00
|
|
|
1. Only beautiful, simple APIs, no exposed concurrency, channels, internals, etc.
|
|
|
|
|
1. Follow [Effective Go](http://golang.org/doc/effective_go.html).
|
2018-03-24 20:14:06 +08:00
|
|
|
1. Provide an infrastructure that allows development of individual dashboard
|
|
|
|
|
components in separation.
|
2018-03-24 20:31:33 +08:00
|
|
|
1. The infrastructure must enforce consistency in how the dashboard components
|
|
|
|
|
are implemented.
|
2018-03-24 20:14:06 +08:00
|
|
|
1. Focus on maintainability, the infrastructure and dashboard components must
|
|
|
|
|
have good test coverage, the repository must have CI/CD enabled.
|
|
|
|
|
|
|
|
|
|
On top of that - let's have fun, learn something and become better developers
|
|
|
|
|
together.
|
2018-03-24 20:31:33 +08:00
|
|
|
|
|
|
|
|
# Requirements
|
|
|
|
|
|
2018-03-26 22:40:23 +08:00
|
|
|
1. Native support of the UTF-8 encoding.
|
|
|
|
|
1. Simple container management to position the widgets and set their size.
|
2018-03-24 20:31:33 +08:00
|
|
|
1. Mouse and keyboard input.
|
|
|
|
|
1. Cross-platform terminal based output.
|
|
|
|
|
1. Unit testing framework for simple and readable tests of dashboard elements.
|
2018-03-26 22:40:23 +08:00
|
|
|
1. Tooling to streamline addition of new widgets.
|
|
|
|
|
1. Apache-2.0 licence for the project.
|
2018-03-25 01:09:34 +08:00
|
|
|
|
|
|
|
|
# High-Level design
|
|
|
|
|
|
2018-04-23 07:44:32 +08:00
|
|
|
See the [design document](doc/hld.md).
|
|
|
|
|
|
|
|
|
|
# Contributing
|
|
|
|
|
|
|
|
|
|
If you are willing to contribute, improve the infrastructure or develop a
|
|
|
|
|
widget, first of all Thank You! Your help is appreciated.
|
|
|
|
|
|
|
|
|
|
Please see the [CONTRIBUTING.md](CONTRIBUTING.md) file for guidelines related
|
|
|
|
|
to the Google's CLA, and code review requirements.
|
|
|
|
|
|
|
|
|
|
As stated above the primary goal of this project is to develop readable, well
|
2018-05-07 02:28:52 +08:00
|
|
|
designed code, the functionality and efficiency come second. This is achieved
|
|
|
|
|
through detailed code reviews, design discussions and following of the [design
|
|
|
|
|
guidelines](doc/design_guidelines.md). Please familiarize yourself with these
|
|
|
|
|
before contributing.
|
|
|
|
|
|
|
|
|
|
## Contributing widgets
|
|
|
|
|
|
|
|
|
|
If you're developing a new widget, please see the [widget
|
|
|
|
|
development](doc/widget_development.md) section.
|
2018-03-27 01:22:07 +08:00
|
|
|
|
2018-05-07 19:39:45 +08:00
|
|
|
## Implemented Widgets
|
|
|
|
|
|
|
|
|
|
### The Gauge
|
|
|
|
|
|
2018-05-21 06:27:57 +08:00
|
|
|
Displays the progress of an operation. Run the
|
|
|
|
|
[gaugedemo](widgets/gauge/demo/gaugedemo.go).
|
2018-05-08 08:12:36 +08:00
|
|
|
|
2018-05-21 06:27:57 +08:00
|
|
|
[<img src="./images/gaugedemo.gif" alt="gaugedemo" type="image/gif">](widgets/gauge/demo/gaugedemo.go)
|
|
|
|
|
|
|
|
|
|
### The Text
|
|
|
|
|
|
|
|
|
|
Displays text content, supports trimming and scrolling of content. Run the
|
|
|
|
|
[textdemo](widgets/text/demo/textdemo.go).
|
2018-05-15 04:42:25 +08:00
|
|
|
|
2018-06-05 00:46:21 +08:00
|
|
|
[<img src="./images/textdemo.gif" alt="gaugedemo" type="image/gif">](widgets/gauge/demo/gaugedemo.go)
|
|
|
|
|
|
2018-05-15 04:42:25 +08:00
|
|
|
## Disclaimer
|
|
|
|
|
|
|
|
|
|
This is not an official Google product.
|
