2021-06-22 04:12:28 +00:00
|
|
|
<div align="center">
|
|
|
|
|
2021-06-12 05:18:24 +00:00
|
|
|
# gobang
|
2021-06-22 04:12:28 +00:00
|
|
|
|
2021-07-09 01:43:53 +00:00
|
|
|
gobang is currently in alpha
|
|
|
|
|
2021-06-12 04:44:52 +00:00
|
|
|
A cross-platform terminal database tool written in Rust
|
2021-06-22 04:12:28 +00:00
|
|
|
|
2021-06-25 16:44:54 +00:00
|
|
|
[![github workflow status](https://img.shields.io/github/workflow/status/TaKO8Ki/gobang/CI/main)](https://github.com/TaKO8Ki/gobang/actions) [![crates](https://img.shields.io/crates/v/gobang.svg?logo=rust)](https://crates.io/crates/gobang)
|
2021-06-22 04:12:28 +00:00
|
|
|
|
2021-06-22 18:40:27 +00:00
|
|
|
![gobang](./resources/gobang.gif)
|
|
|
|
|
2021-06-22 04:12:28 +00:00
|
|
|
</div>
|
2021-07-08 16:42:41 +00:00
|
|
|
|
|
|
|
## Features
|
|
|
|
|
|
|
|
- Cross-platform support (macOS, Windows, Linux)
|
|
|
|
- Multiple Database support (MySQL PostgreSQL, SQLite)
|
|
|
|
- Intuitive keyboard only control
|
2021-07-09 01:43:53 +00:00
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
|
|
|
### Cargo
|
|
|
|
|
|
|
|
If you already have a Rust environment set up, you can use the `cargo install` command:
|
|
|
|
|
|
|
|
```
|
2021-08-28 08:52:11 +00:00
|
|
|
$ cargo install --version 0.1.0-alpha.1 gobang
|
2021-07-09 01:43:53 +00:00
|
|
|
```
|
2021-07-23 18:16:17 +00:00
|
|
|
## Keymap
|
|
|
|
|
|
|
|
| Key | Description |
|
|
|
|
| ---- | ---- |
|
2021-08-28 06:42:44 +00:00
|
|
|
| <kbd>h</kbd> | Scroll left |
|
|
|
|
| <kbd>j</kbd> | Scroll down |
|
|
|
|
| <kbd>k</kbd> | Scroll up |
|
|
|
|
| <kbd>l</kbd> | Scroll right |
|
|
|
|
| <kbd>Ctrl</kbd> + <kbd>d</kbd> | Scroll down multiple lines |
|
|
|
|
| <kbd>Ctrl</kbd> + <kbd>u</kbd> | Scroll up multiple lines |
|
|
|
|
| <kbd>y</kbd> | Copy a cell value |
|
|
|
|
| <kbd>→</kbd> | Move focus to right |
|
|
|
|
| <kbd>←</kbd> | Move focus to left |
|
|
|
|
| <kbd>/</kbd> | Filter |
|
2021-08-28 08:47:49 +00:00
|
|
|
|
|
|
|
## Configuration
|
|
|
|
|
|
|
|
The location of the file depends on your OS:
|
|
|
|
|
2021-09-02 08:28:07 +00:00
|
|
|
- macOS: `$HOME/.config/gobang/config.toml`
|
|
|
|
- Linux: `$HOME/.config/gobang/config.toml`
|
|
|
|
- Windows: `%APPDATA%/gobang/config.toml`
|
2021-08-28 08:47:49 +00:00
|
|
|
|
|
|
|
The following is a sample config.toml file:
|
|
|
|
|
|
|
|
```toml
|
|
|
|
[[conn]]
|
|
|
|
type = "mysql"
|
|
|
|
user = "root"
|
|
|
|
host = "localhost"
|
|
|
|
port = 3306
|
|
|
|
|
|
|
|
[[conn]]
|
|
|
|
type = "mysql"
|
|
|
|
user = "root"
|
|
|
|
host = "localhost"
|
|
|
|
port = 3306
|
|
|
|
database = "foo"
|
|
|
|
```
|