Поддержка no_std

masterror собирается без стандартной библиотеки Rust. Корень крейта объявляет #![cfg_attr(not(feature = "std"), no_std)], и включённая по умолчанию функция std — единственное, что отделяет вас от сборки, дружелюбной к embedded/WASM:

[dependencies]
masterror = { version = "0.28", default-features = false }

alloc обязателен

masterror — это no_std, но не no_alloc. Крейт безусловно объявляет extern crate alloc и использует Cow<'static, str>, String, Arc и BTreeMap для сообщений, метаданных и цепочек источников. Вашей целевой платформе нужен глобальный аллокатор; окружения только с core не поддерживаются.

Что работает без `std`

Всё фреймворк-независимое ядро:

Область	Доступно в `no_std`
Основные типы	`Error` / `AppError`, `AppResult`, `AppErrorKind`, `AppCode`
Метаданные	`Metadata`, `Field`, `FieldValue`, `FieldRedaction`, хелперы `field::*`
Контекст	`Context`, `ResultExt::{ctx, context}`
Управление потоком	`ensure!`, `fail!`
Derive	`#[derive(Error)]`, `#[derive(Masterror)]` со всеми атрибутами
Типы на проводе	`ProblemJson`, `ErrorResponse`, `CODE_MAPPINGS`, `mapping_for_code`
Интроспекция	`chain()`, `root_cause()`, `is`/`downcast`/`downcast_ref`/`downcast_mut`, `render_message()`
Serde	`serde` с `alloc` (JSON-сериализация типов на проводе)

Источники ошибок работают через core::error::Error: крейт реализует и использует core::error::Error (внутренний псевдоним CoreError) вместо std::error::Error, поэтому with_source(...), цепочки источников и даункастинг полностью функциональны в сборках no_std.

use masterror::{AppCode, AppError, AppErrorKind, field};

let err = AppError::new(AppErrorKind::Timeout, "deadline exceeded")
    .with_field(field::u64("attempt", 3));

assert_eq!(err.code, AppCode::Timeout);
assert_eq!(err.metadata().len(), 1);

Что требует `std`

Каждая runtime-интеграция явно включает std обратно в определении своей функции. Из Cargo.toml:

tracing, metrics, backtrace, colored
axum, actix, multipart, tonic, openapi
serde_json, redis, validator, config, tokio, reqwest, teloxide, init-data, frontend, turnkey

backtrace нуждается в std::backtrace::Backtrace и доступе к окружению; colored — в детекции TTY; веб- и клиентским интеграциям нужны их хост-крейты, которые сами работают только со std.

Матрица функций в CI

CI-задача no_std (.github/workflows/ci.yml) проверяет эти комбинации на каждом pull request и push в main:

Задача	Команда	Что проверяет
`bare`	`cargo check --no-default-features`	настоящую сборку `no_std` + `alloc`
`std-only`	`cargo check --features std`	стандартную поверхность std
`tracing`	`cargo check --no-default-features --features tracing`	что одиночная телеметрическая функция собирается автономно
`metrics`	`cargo check --no-default-features --features metrics`	то же для metrics
`colored`	`cargo check --no-default-features --features colored`	то же для colored
`all-features`	`cargo check --all-features`	полное объединение функций

Обратите внимание на семантику: только задача bare — настоящая компиляция no_std. tracing = [..., "std"], metrics = [..., "std"] и colored = [..., "std"] транзитивно включают std обратно, поэтому эти задачи проверяют, что каждая телеметрическая функция самодостаточна при отключённых значениях по умолчанию — а не то, что телеметрия работает без стандартной библиотеки. Если нужна телеметрия — нужен std.

Практическая настройка

Библиотечные крейты, которые хотят оставаться транспортно-независимыми и совместимыми с no_std:

[dependencies]
masterror = { version = "0.28", default-features = false }

[features]
std = ["masterror/std"]

Бинарный или сервисный крейт затем включает std плюс нужные ему интеграции:

[dependencies]
masterror = { version = "0.28", features = ["axum", "tracing", "metrics"] }

Поскольку AppErrorKind, AppCode и типы на проводе живут в ядре no_std, доменные крейты могут классифицировать ошибки и даже строить полезные нагрузки ProblemJson, тогда как отображение на HTTP происходит только в сервисном крейте — см. Лучшие практики.

Тулчейн

Крейт нацелен на edition 2024 с rust-version = "1.96" в Cargo.toml. core::error::Error (основа цепочек источников в no_std) стабилен начиная с Rust 1.81, поэтому никакие nightly-функции не задействованы.

См. также: Флаги возможностей · Начало работы · Лучшие практики

Keyboard shortcuts

masterror