https://github.com/liamg/clinch

Go CLI toolkit :hammer:
https://github.com/liamg/clinch

cli terminal

Last synced: 3 months ago
JSON representation

Go CLI toolkit :hammer:

• Host: GitHub
• URL: https://github.com/liamg/clinch
• Owner: liamg
• License: unlicense
• Created: 2019-05-01T07:47:53.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2023-12-18T23:02:17.000Z (about 2 years ago)
• Last Synced: 2025-04-14T19:52:22.004Z (9 months ago)
• Topics: cli, terminal
• Language: Go
• Homepage:
• Size: 6.06 MB
• Stars: 19
• Watchers: 3
• Forks: 4
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# clinch

[![Build Status](https://travis-ci.org/liamg/clinch.svg "Travis CI status")](https://travis-ci.org/liamg/clinch)

[![GoDoc](https://godoc.org/github.com/liamg/clinch?status.svg)](https://godoc.org/github.com/liamg/clinch)

A Go module to make interactive CLI applications easier to develop, better looking and visually consistent.

![Demo gif](demo.gif)

A full list of included packages and how to use them is below.

For information about using coloured text within clinch, please see the [tml](https://github.com/liamg/tml) package.

## Packages

### Logging progress of sequential tasks with `task`

Tasks are single jobs from the users perspective. For example, in the following output:

```

Running test #1...

Running test #2...

Deploying code...

```

...each log line represents a single _task_. Tasks in clinch allow you to beautify these log lines slightly, by showing the status/outcome of each task, and even animate the status while the task is still running. For example:

![Tasks demo](tasks.gif)

Full example [here](_examples/task/main.go).

### Prompting for input with `prompt`

The `prompt` package provides various methods of gathering user input.

![List prompt demo](list.gif)

Full examples are available in [_examples/prompt](_examples/prompt):

- [Text input](_examples/prompt/input/main.go)

- [Password input](_examples/prompt/password/main.go)

- [Selection from a list](_examples/prompt/list/main.go)

- [Multi Selection from a list](_examples/prompt/multiSelectList/main.go) [(mutli list in action)](multilist.gif)

### More granular control with `terminal`

The `terminal` package allows for more granular control of the terminal. For example, you can use it to show/hide the cursor, get the terminal size, clear the terminal, position the cursor and some other basics.

### Loading bars with `loading`

The `loading` package allows for the rendering of animated loading bars, with the additional capability of logging messages to the terminal without disrupting the bar.

![Loading bar demo](loading.gif)

Full example [here](_examples/loading/bar/main.go).

### Output coloured/formatted text

You can output coloured and formatted text to the terminal with the external [tml](https://github.com/liamg/tml) module.

## Visual Guidelines

### Colour Usage

- Successful actions are reported in green.

- Warnings are reported in yellow.

- Errors/failures are reported in red.

- Items requiring a user action are reported in blue.