mirror of
https://github.com/tokio-rs/axum.git
synced 2025-09-30 06:21:07 +00:00
9c0a89cd09
* add `#[derive(FromRef)]` * tests * don't support skipping fields probably wouldn't work at all since the whole state likely needs `Clone` * UI tests * changelog * changelog link * revert hello-world example, used for testing * Re-export `#[derive(FromRef)]` * Don't need to return `Result` * use `collect` instead of quoting the iterator * Mention it in axum's changelog
27 lines
964 B
Rust
27 lines
964 B
Rust
/// Used to do reference-to-value conversions thus not consuming the input value.
|
|
///
|
|
/// This is mainly used with [`State`] to extract "substates" from a reference to main application
|
|
/// state.
|
|
///
|
|
/// See [`State`] for more details on how library authors should use this trait.
|
|
///
|
|
/// This trait can be derived using `#[derive(axum_macros::FromRef)]`.
|
|
///
|
|
/// [`State`]: https://docs.rs/axum/0.6/axum/extract/struct.State.html
|
|
/// [`#[derive(axum_macros::FromRef)]`]: https://docs.rs/axum-macros/latest/axum_macros/derive.FromRef.html
|
|
// NOTE: This trait is defined in axum-core, even though it is mainly used with `State` which is
|
|
// defined in axum. That allows crate authors to use it when implementing extractors.
|
|
pub trait FromRef<T> {
|
|
/// Converts to this type from a reference to the input type.
|
|
fn from_ref(input: &T) -> Self;
|
|
}
|
|
|
|
impl<T> FromRef<T> for T
|
|
where
|
|
T: Clone,
|
|
{
|
|
fn from_ref(input: &T) -> Self {
|
|
input.clone()
|
|
}
|
|
}
|