https://github.com/archiewood/plot
A minimal terminal CLI charting tool
https://github.com/archiewood/plot
Last synced: 10 months ago
JSON representation
A minimal terminal CLI charting tool
- Host: GitHub
- URL: https://github.com/archiewood/plot
- Owner: archiewood
- License: mit
- Created: 2024-07-14T17:25:10.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-07-16T03:59:40.000Z (over 1 year ago)
- Last Synced: 2024-07-17T01:26:31.344Z (over 1 year ago)
- Language: Go
- Homepage:
- Size: 2.26 MB
- Stars: 6
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Plot
A minimalist CLI tool to plot data to the terminal.
- **Data**: From CSV files or command line arguments.
- **Charts**: Bar and Column charts.
## Installation
1. Download the [latest release for your OS](https://github.com/archiewood/plot/releases).
2. Move the binary to a directory in your PATH e.g. `mv plot-darwin-amd64 /usr/local/bin/plot` (May need sudo)
3. Make the binary executable e.g. `chmod +x /usr/local/bin/plot`
4. Adding plot to the list of allowed binaries e.g. `xattr -d com.apple.quarantine /usr/local/bin/plot`
### MacOS Install
```bash
curl -L -o plot https://github.com/archiewood/plot/releases/download/v0.0.2/plot-darwin-amd64
mv plot /usr/local/bin/
chmod +x /usr/local/bin/plot
xattr -d com.apple.quarantine /usr/local/bin/plot
```
## Usage
```bash
plot [-t title] [-c chartType] file.csv
plot [-t title] [-c chartType] [labels ,] values
```
### Bar Chart from CSV
```bash
plot test/two_col_header.csv
```
### Bar Chart with Title and Labels
```bash
plot -t "Programming Languages" go python r c++ , 84 950 923 27
```
### Column Chart
```bash
plot -c column test/two_col_header.csv
```
## Credits
This tool is heavily inspired by [YouPlot](https://github.com/red-data-tools/YouPlot)