mirror of
https://github.com/chatmail/core.git
synced 2026-04-23 00:16:34 +03:00
60 lines
1.7 KiB
Markdown
60 lines
1.7 KiB
Markdown
# Delta Chat REPL
|
|
|
|
This is a simple [REPL](https://en.wikipedia.org/wiki/Read%E2%80%93eval%E2%80%93print_loop) frontend built on top of Delta Chat core.
|
|
Its purpose is to help with quick testing during development, it is not meant for end users.
|
|
|
|
Dependencies:
|
|
- if you want to use `getqr` you need `qrencode` (To install use your systems package manager)
|
|
|
|
## Usage
|
|
|
|
```
|
|
cargo run <path to deltachat db>
|
|
```
|
|
|
|
Type in `help` to learn about what comands are available.
|
|
|
|
## Usage with `tokio-console`
|
|
|
|
Tokio is an async runtime that Delta Chat core uses.
|
|
Core uses Tokio tasks, which are something similar to threads.
|
|
`tokio-console` is like a task manager for these Tokio tasks.
|
|
|
|
Examples of tasks:
|
|
- The event loop in the REPL tool which processes events received from core
|
|
- The repl loop itself which waits for and executes user commands
|
|
- The IMAP task that manages IMAP connection in core
|
|
|
|
```
|
|
RUSTFLAGS="--cfg tokio_unstable" cargo run <path to deltachat db>
|
|
```
|
|
|
|
Then in a new console window start [`tokio-console`](https://github.com/tokio-rs/console).
|
|
You can install it via `cargo install tokio-console`.
|
|
|
|
### Quick Example
|
|
|
|
An example session in the REPL tool:
|
|
|
|
```
|
|
RUSTFLAGS="--cfg tokio_unstable" cargo run test-db/db
|
|
setqr dcaccount:https://nine.testrun.org/new
|
|
configure
|
|
connect
|
|
listchats
|
|
getqr
|
|
```
|
|
|
|
If it crashes you can just start it again and use the openpgp4fpr URL instead of scanning the code from the terminal.
|
|
Or install `qrencode` to fix the crash and run `getqr` again.
|
|
|
|
Use the qrcode/openpgp4fpr link to setup the contact on Delta Chat.
|
|
Then write a message to that new contact, after that we can accept the chat in the repl tool and send a reply:
|
|
|
|
```
|
|
listchats
|
|
accept 12
|
|
chat 12
|
|
send hi!
|
|
chat
|
|
``` |