Ракета

Rocket — это асинхронный веб-фреймворк для Rust с акцентом на удобство использования, безопасность, расширяемость и скорость.

#[macro_use] extern crate rocket;

#[get("/<name>/<age>")]
fn hello(name: &str, age: u8) -> String {
    format!("Привет, {}-летний человек по имени {}!", age, name)
}

#[launch]
fn rocket() -> _ {
    rocket::build().mount("/hello", routes![hello])
}

При переходе по адресу localhost:8000/hello/Иван/35, например, будет запущена маршрут hello, что приведёт к отправке строки Привет, 35-летний человек по имени Иван! браузеру. Если переданная строка <age> не может быть преобразована в тип данных u8, маршрут не будет вызван, что приведёт к ошибке 404.

Документация

Rocket подробно документирован:

• Обзор: Краткий взгляд на то, что делает Rocket особенным.
• Быстрый старт: Как начать работу как можно быстрее.
• Начало работы: Как создать свой первый проект Rocket.
• Руководство: Подробное руководство и справочник по Rocket.

Документация API: https://api.rocket.rsДокументация для ветки master доступна по адресу https://rocket.rs/master и https://api.rocket.rs/master.

Документация для основной версии ${x} доступна по адресу https://[api.]rocket.rs/v${x}. Например, документация для версии v0.4 доступна по адресу https://rocket.rs/v0.4 и https://api.rocket.rs/v0.4.

Наконец, документация API для активных веток Git доступна по адресу https://api.rocket.rs/${branch}. Например, документация API для ветки master доступна по адресу https://api.rocket.rs/master. Документация для веток строится и разворачивается после каждого коммита.

Примеры

Каталог примеров содержит полные пакеты, демонстрирующие возможности Rocket и способы их использования. Каждый пример можно скомпилировать и запустить с помощью Cargo. Например, следующий набор команд собирает и запускает пример hello:

cd examples/hello
cargo run

Получение помощи

Если вы столкнулись со сложностями и нуждаетесь в помощи помимо документации, вы можете:

• Обратиться за помощью через [вопросы GitHub Discussions].
• Обсудить вопросы с нами в чате на Matrix (#rocket:mozilla.org) ([присоединиться через Element]).

Вклад

Вклады приветствуются и активно поддерживаются! Если вас интересует участие в разработке кода, пожалуйста, прочитайте CONTRIBUTING для получения полной информации. Кроме того, вы можете: 1. Создайте запрос на новую функцию или ошибку как issue. 2. Предложите улучшение документации как issue. 3. Оставьте комментарий к issues требующим обратной связи. 4. Ответьте на вопросы в GitHub discussions questions. 5. Поделитесь проектом в GitHub discussions show & tell.

Лицензия

Rocket распространяется под лицензией Apache License, Version 2.0, или MIT License, по вашему выбору:

• Apache License, Version 2.0, (LICENSE-APACHE или https://www.apache.org/licenses/LICENSE-2.0)
• MIT License (LICENSE-MIT или https://opensource.org/licenses/MIT)

Если вы не указываете другое, любой вклад, намеренно отправленный для включения в Rocket, будет распространяться под двойной лицензией MIT и Apache License, Version 2.0, без каких-либо дополнительных условий.

Документация сайта Rocket распространяется под отдельными условиями. Любой вклад, намеренно отправленный для включения в документацию сайта Rocket, будет распространяться под этими условиями.