chatmail-core/deltachat-repl

Delta Chat REPL

This is a simple REPL 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 (macOS: brew install qrencode)

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. 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