experimental-cli/README.md

# Pigeon CLI

A single executable to manage a Pigeon node.

# Project Status

Don't use the Go version yet. If you want something stable, there is a [Ruby version that is feature complete](https://tildegit.org/PigeonProtocolConsortium/Pigeon-Ruby).

# TODO

 - [ ] Finish http://go-database-sql.org/nulls.html
 - [ ] Fix go module nonsense. Read a tut or sth https://thenewstack.io/understanding-golang-packages/
 - [ ] Add a real testing lib to DRY things up.
 - [ ] Get a good CI system going? Run tests at PR time, provide prebuilt binaries, prevent coverage slips, etc..
 - [ ] Finish all the things below:

 |Done?|Verb        |Noun    | Flag / arg 1  | Flag 2    |
 |-----|------------|--------|---------------|-----------|
 |     |show        |peers   |               |           |
 |     |show        |peers   | --blocked     |           |
 |     |unfollow    |peer    |               |           |
 |     |follow      |peer    | user mhash    |           |
 |     |unblock     |peer    | user mhash    |           |
 |     |block       |peer    | user mhash    |           |
 |     |show        |blob    |               |           |
 |     |create      |blob    | file path     |           |
 |     |create      |blob    | pipe          |           |
 |     |create      |draft   |               |           |
 |     |update      |draft   | --key=?       | --value=? |
 |     |show        |draft   |               |           |
 |     |publish     |draft   |               |           |
 |     |create      |bundle  |               |           |
 |     |find        |message | --all         |           |
 |     |find        |message | --last        |           |
 |     |ingest      |bundle  |               |           |
 |     |show        |message | message mhash |           |
 |  X  |show        |identity|               |           |
 |  X  |create      |identity|               |           |
 |  X  |help        |        |               |           |
 |  X  |version     |        |               |           |

# Run Tests

Without coverage:

```
./tests.sh
```

With coverage:

```
./coverage.sh
```

# Build Project

```
./build.sh
```
Hello, world! 2020-08-02 18:59:32 +00:00			`# Pigeon CLI`

			`A single executable to manage a Pigeon node.`

Add coverage profile stuff 2020-08-11 12:25:45 +00:00			`# Project Status`

Minor typos, gitignore updates, removals 2020-08-23 23:23:17 +00:00			`Don't use the Go version yet. If you want something stable, there is a [Ruby version that is feature complete](https://tildegit.org/PigeonProtocolConsortium/Pigeon-Ruby).`
Add coverage profile stuff 2020-08-11 12:25:45 +00:00
			`# TODO`
Begin `create identity` 2020-08-10 12:19:20 +00:00
Persistence layer almost works. TODO: Fix test for `CreateKeypair` 2020-08-27 12:30:15 +00:00			`- [ ] Finish http://go-database-sql.org/nulls.html`
WIP need to re-do modules I think. 2020-09-01 12:52:44 +00:00			`- [ ] Fix go module nonsense. Read a tut or sth https://thenewstack.io/understanding-golang-packages/`
Add B32Decode() 2020-08-19 12:36:37 +00:00			`- [ ] Add a real testing lib to DRY things up.`
WIP need to re-do modules I think. 2020-09-01 12:52:44 +00:00			`- [ ] Get a good CI system going? Run tests at PR time, provide prebuilt binaries, prevent coverage slips, etc..`
Begin `create identity` 2020-08-10 12:19:20 +00:00			`- [ ] Finish all the things below:`

			`\|Done?\|Verb \|Noun \| Flag / arg 1 \| Flag 2 \|`
			`\|-----\|------------\|--------\|---------------\|-----------\|`
Remove coverage data from source control 2020-09-10 12:29:15 +00:00			`\| \|show \|peers \| \| \|`
			`\| \|show \|peers \| --blocked \| \|`
			`\| \|unfollow \|peer \| \| \|`
			`\| \|follow \|peer \| user mhash \| \|`
			`\| \|unblock \|peer \| user mhash \| \|`
			`\| \|block \|peer \| user mhash \| \|`
WIP - writing feature / tests for `identity create` 2020-08-11 12:58:39 +00:00			`\| \|show \|blob \| \| \|`
			`\| \|create \|blob \| file path \| \|`
Begin `create identity` 2020-08-10 12:19:20 +00:00			`\| \|create \|blob \| pipe \| \|`
Remove coverage data from source control 2020-09-10 12:29:15 +00:00			`\| \|create \|draft \| \| \|`
WIP - writing feature / tests for `identity create` 2020-08-11 12:58:39 +00:00			`\| \|update \|draft \| --key=? \| --value=? \|`
Remove coverage data from source control 2020-09-10 12:29:15 +00:00			`\| \|show \|draft \| \| \|`
WIP - writing feature / tests for `identity create` 2020-08-11 12:58:39 +00:00			`\| \|publish \|draft \| \| \|`
Begin `create identity` 2020-08-10 12:19:20 +00:00			`\| \|create \|bundle \| \| \|`
			`\| \|find \|message \| --all \| \|`
			`\| \|find \|message \| --last \| \|`
			`\| \|ingest \|bundle \| \| \|`
			`\| \|show \|message \| message mhash \| \|`
Remove coverage data from source control 2020-09-10 12:29:15 +00:00			`\| X \|show \|identity\| \| \|`
:clap: `pigeon create identity` works! 2020-09-09 12:42:56 +00:00			`\| X \|create \|identity\| \| \|`
Begin `create identity` 2020-08-10 12:19:20 +00:00			`\| X \|help \| \| \| \|`
			`\| X \|version \| \| \| \|`

Add coverage profile stuff 2020-08-11 12:25:45 +00:00			`# Run Tests`
Begin `create identity` 2020-08-10 12:19:20 +00:00
Add coverage profile stuff 2020-08-11 12:25:45 +00:00			`Without coverage:`
Begin `create identity` 2020-08-10 12:19:20 +00:00
Add coverage profile stuff 2020-08-11 12:25:45 +00:00			```
Remove coverage data from source control 2020-09-10 12:29:15 +00:00			`./tests.sh`
Add coverage profile stuff 2020-08-11 12:25:45 +00:00			```
Begin `create identity` 2020-08-10 12:19:20 +00:00
Add coverage profile stuff 2020-08-11 12:25:45 +00:00			`With coverage:`
Begin `create identity` 2020-08-10 12:19:20 +00:00
Add coverage profile stuff 2020-08-11 12:25:45 +00:00			```
Remove coverage data from source control 2020-09-10 12:29:15 +00:00			`./coverage.sh`
Add coverage profile stuff 2020-08-11 12:25:45 +00:00			```
Begin `create identity` 2020-08-10 12:19:20 +00:00
Add coverage profile stuff 2020-08-11 12:25:45 +00:00			`# Build Project`
Begin `create identity` 2020-08-10 12:19:20 +00:00
Add coverage profile stuff 2020-08-11 12:25:45 +00:00			```
Directory cleanup 2020-09-10 12:33:41 +00:00			`./build.sh`
Add coverage profile stuff 2020-08-11 12:25:45 +00:00			```