Skip to content

Commit

Permalink
Merge pull request #19 from kyoto7250/update_readme_and_resources
Browse files Browse the repository at this point in the history
[skip ci]: update README
  • Loading branch information
kyoto7250 authored Jun 16, 2024
2 parents e41d05b + ecd0e07 commit c2c6737
Show file tree
Hide file tree
Showing 3 changed files with 27 additions and 102 deletions.
129 changes: 27 additions & 102 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,110 +1,25 @@
<div align="center">
# dolce

![zhobo](./resources/logo.png)

zhobo is currently in alpha

A cross-platform TUI database management tool written in Rust

[![github workflow status](https://img.shields.io/github/workflow/status/kyoto7250/zhobo/CI/main)](https://github.com/kyoto7250/zhobo/actions) [![crates](https://img.shields.io/crates/v/zhobo.svg?logo=rust)](https://crates.io/crates/zhobo)

![zhobo](./resources/zhobo.gif)

</div>
`dolce` is the rebaked [gobang project](https://github.com/TaKO8Ki/gobang).

## Features

- Cross-platform support (macOS, Windows, Linux)
- Multiple Database support (MySQL, PostgreSQL, SQLite)
- Intuitive keyboard only control

## TODOs

- [ ] SQL editor
- [ ] Custom key bindings
- [ ] Custom theme settings
- [ ] Support the other databases
## Additional Features
- [ ] custom keymap.
- [ ] support unix domain.
- [ ] sort based on specific columns.
- [ ] fix some bugs.

## What does "zhobo" come from?

zhobo means a Japanese game played on goban, a go board. The appearance of goban looks like table structure. And I live in Kyoto, Japan. In Kyoto city, streets are laid out on a grid (We call it “goban no me no youna (碁盤の目のような)”). They are why I named this project "zhobo".

## Installation

### With Homebrew (Linux, macOS)

If you’re using Homebrew or Linuxbrew, install the zhobo formula:

```
brew install kyoto7250/tap/zhobo
```
## installation

### On Windows

If you're a Windows Scoop user, then you can install zhobo from the [official bucket](https://github.com/ScoopInstaller/Main/blob/master/bucket/zhobo.json):

```
scoop install zhobo
```
### On NixOS

If you're a Nix user, you can install [zhobo](https://github.com/NixOS/nixpkgs/blob/master/pkgs/development/tools/database/zhobo/default.nix) from nixpkgs:

```
$ nix-env --install zhobo
```

### On Archlinux

If you're an Archlinux user, you can install [zhobo](https://aur.archlinux.org/packages/zhobo-bin) from AUR:

```
paru -S zhobo-bin
```
## homebrew

### On NetBSD
## cargo

If you're a NetBSD user, then you can install zhobo from [pkgsrc](https://pkgsrc.se/databases/zhobo):

```
pkgin install zhobo
```

### With Cargo (Linux, macOS, Windows)

If you already have a Rust environment set up, you can use the `cargo install` command:

```
cargo install --version 0.1.0-alpha.5 zhobo
```

### From binaries (Linux, macOS, Windows)

- Download the [latest release binary](https://github.com/kyoto7250/zhobo/releases) for your system
- Set the `PATH` environment variable

## Usage

```
$ zhobo
```

```
$ zhobo -h
USAGE:
zhobo [OPTIONS]
FLAGS:
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
-c, --config-path <config-path> Set the config file
```

If you want to add connections, you need to edit your config file. For more information, please see [Configuration](#Configuration).

## Keymap
## default keymap

| Key | Description |
| ---- | ---- |
Expand All @@ -120,13 +35,16 @@ If you want to add connections, you need to edit your config file. For more info
| <kbd>1</kbd>, <kbd>2</kbd>, <kbd>3</kbd>, <kbd>4</kbd>, <kbd>5</kbd> | Switch to records/columns/constraints/foreign keys/indexes tab |
| <kbd>Esc</kbd> | Hide pop up |

## Configuration

## configuration

### connection

The location of the file depends on your OS:

- macOS: `$HOME/.config/zhobo/config.toml`
- Linux: `$HOME/.config/zhobo/config.toml`
- Windows: `%APPDATA%/zhobo/config.toml`
- macOS: `$HOME/.config/gobang/config.toml`
- Linux: `$HOME/.config/gobang/config.toml`
- Windows: `%APPDATA%/gobang/config.toml`

The following is a sample config.toml file:

Expand Down Expand Up @@ -159,6 +77,13 @@ type = "sqlite"
path = "/path/to/baz.db"
```

## Contribution
### custom keymap

## contribution

Contributions are welcome.
If you are developing a new feature, we recommend creating an issue first.

## acknowledge

Contributions, issues and pull requests are welcome!
Most of the code in this project was ported from [gobang](https://github.com/TaKO8Ki/gobang), and we would like to express our deepest gratitude to the original author, [@Tako8ki](https://github.com/TaKO8Ki).
Binary file removed resources/gobang.gif
Binary file not shown.
Binary file removed resources/logo.png
Binary file not shown.

0 comments on commit c2c6737

Please sign in to comment.