deltachat core rust

Основная библиотека для Delta Chat, написанная в Rust

Установка ржавчины и груза

Чтобы загрузить и установить официальный компилятор для языка программирования Rust и менеджера по грузовым пакетам, запустите команду в вашей пользовательской среде:

 $ curl https://sh.rustup.rs -sSf | sh

В Windows вам может потребоваться также установить Perl , чтобы иметь возможность компилировать Deltachat-Core.

Использование клиента CLI

Скомпилируйте и запустите утилиту командной строки Delta Chat Core Command, используя cargo :

 $ cargo run --locked -p deltachat-repl -- ~/deltachat-db

где ~/deltachat-db является файлом базы данных. Delta Chat создаст его, если его не существует.

Необязательно, установите бинар deltachat-repl с

 $ cargo install --locked --path deltachat-repl/

и бежать как

 $ deltachat-repl ~/deltachat-db

Настройте свою учетную запись (если еще не настройка):

 Delta Chat Core is awaiting your commands.
> set addr [email protected]
> set mail_pw yourpassword
> configure

Подключитесь к вашему почтовому серверу (если уже настроено):

 > connect

Создайте контакт:

 > addcontact [email protected]
Command executed successfully.

Список контактов:

 > listcontacts
Contact#10: <name unset> <[email protected]>
Contact#1: Me √√ <[email protected]>

Создайте чат со своим другом и отправьте сообщение:

 > createchat 10
Single#10 created successfully.
> chat 10
Single#10: [email protected] [[email protected]]
> send hi
Message sent.

Если [email protected] использует Deltachat, но не получает только что отправлено сообщение, рекомендуется проверить папку Spam . Известно, что, по крайней мере, gmx.com рассматривают такие тестовые сообщения как спам, если не сказано иное с веб -интерфейсом.

Список сообщений, когда внутри чата:

 > chat

Для получения большего типа команд:

 > help

Установка системы Libdeltachat Wide

 $ git clone https://github.com/deltachat/deltachat-core-rust.git
$ cd deltachat-core-rust
$ cmake -B build . -DCMAKE_INSTALL_PREFIX=/usr
$ cmake --build build
$ sudo cmake --install build

Разработка

 # run tests
$ cargo test --all
# build c-ffi
$ cargo build -p deltachat_ffi --release

Отладка переменных среды

• DCC_MIME_DEBUG : Если будет напечатано исходящее и входящее сообщение

• RUST_LOG=async_imap=trace,async_smtp=trace : включить трассировку IMAP и SMTP в дополнение к информационным сообщениям.

Дорогие тесты

Некоторые тесты стоят дорого и отмечены #[ignore] , чтобы запустить их, используйте аргумент --ignored тестового двоичного тестирования (не для самого груза):

$ cargo test -- --ignored

Пузырь

Установите cargo-bolero с

$ cargo install cargo-bolero

Запустить тестирование пушинов с

$ cd fuzz
$ cargo bolero test fuzz_mailparse --release=false -s NONE

Корпус создается по адресу fuzz/fuzz_targets/corpus , вы можете добавить там начальные входы. Для fuzz_mailparse Target Corpus может быть заполнен ../test-data/message/*.eml .

Бежать с AFL вместо либфуззера:

$ cargo bolero test fuzz_format_flowed --release=false -e afl -s NONE

Функции

• vendored : при использовании OpenSSL для TLS это объединяет версию поставщики.

Обновление данных поставщика

Чтобы добавить обновления из провайдера-DB в ядро, запустите:

 ./src/provider/update.py ../provider-db/_providers/ > src/provider/data.rs

Языковые привязки и фронтальные проекты

Языковые привязки доступны для:

• C [Источник | Документы]
• Node.js
  • над JSON-RPC: [Источник | ? npm | Документы]
  • над CFFI ¹ : [Источник | ? npm | Документы]
• Питон [Источник | ? pypi | Документы]
• Идти
  • над JSONRPC: [Источник]
  • над CFFI ¹ : [Источник]
• Бесплатный Pascal ¹ [Источник]
• Java and Swift (содержатся в репозиции Android/IOS)

Следующие проекты «Frontend» используют ржавную библиотеку или ее языковые привязки:

• Android
• ios
• Настольный компьютер
• Пиджин
• Телепатия
• Ubuntu Touch
• Несколько ботов

Сноски

1. Устаревшим / невозможным, если вам нравятся эти языки, не стесняйтесь начать их поддерживать. Если у вас есть вопросы, мы вам поможем, спросите в этих вопросах. ↩ ↩ ² ↩ ³