Leonard
c866ae602b
* Add `#[component]` attribute + system for creating component attributes + other stuff * Delete inlineprops.rs * Update inline_props.rs * Cargo fmt * Fix clippy warnings and paths in props/mods.rs * Include where clause in `#[inline_props]` output * Allow Clippy type complexity in `LinkProps` * Allow the type complexity lint for the entire link.rs file * Remove snake_case -> PascalCase converter, but rather enforce PascalCase Also: - Put the second function inside the main one instead of besides it. - Simplify * Simplify type check lints so they don't return false positives They will not always work, but they won't return any false positives, like for aliases. This is likely going to be replaced by a more polished Clippy-backed linting system. * Fix #583 * Cargo fmt * Add docs for `deserialize()` and remove useless comment * Add `#[component]` to prelude * Merge branch 'master' of https://github.com/tigerros/dioxus * #[inline_props] is no more. Except in the docs folder, but that's going to be removed * Remove docs folder * Remove docs from workspace * Resolve `DeserializerOutput` conversation
58 lines
2.2 KiB
Rust
58 lines
2.2 KiB
Rust
use crate::component_body::ComponentBody;
|
|
use dioxus_core::{Element, Scope};
|
|
use quote::ToTokens;
|
|
use syn::{parse_quote, Path};
|
|
|
|
/// The output produced by a deserializer.
|
|
///
|
|
/// # For implementors
|
|
/// Struct field guidelines:
|
|
/// * Must be public, so that other deserializers can utilize them.
|
|
/// * Should usually be [`Item`]s that you then simply combine in a [`quote!`]
|
|
/// in the [`ComponentBodyDeserializer::output_to_token_stream2`] function.
|
|
/// * If an [`Item`] might not be included, wrap it in an [`Option`].
|
|
/// * Must be at the component function "level"/"context".
|
|
/// For example, the [`InlinePropsDeserializer`](crate::component_body_deserializers::inline_props::InlinePropsDeserializer)
|
|
/// produces two [`Item`]s; the function but with arguments turned into props, and the props struct.
|
|
/// It does not return any [`Item`]s inside the struct or function.
|
|
pub trait DeserializerOutput: ToTokens {}
|
|
|
|
impl<T: ToTokens> DeserializerOutput for T {}
|
|
|
|
/// The args passed to a [`ComponentBody`] when deserializing it.
|
|
///
|
|
/// It's also the struct that does the deserializing.
|
|
/// It's called "DeserializerArgs", not "Deserializer". Why?
|
|
/// Because "args" makes more sense to the caller of [`ComponentBody::deserialize`], which
|
|
/// takes an [`DeserializerArgs`] argument. However, you can think of "DeserializerArgs" as the deserializer.
|
|
pub trait DeserializerArgs<TOutput>: Clone
|
|
where
|
|
TOutput: ToTokens,
|
|
{
|
|
// There's a lot of Results out there... let's make sure that this is a syn::Result.
|
|
// Let's also make sure there's not a warning.
|
|
/// Creates a [`ToTokens`] struct from the `self` args and a [`ComponentBody`].
|
|
/// The [`ComponentBody::deserialize`] provides a cleaner way of calling this function.
|
|
#[allow(unused_qualifications)]
|
|
fn to_output(&self, component_body: &ComponentBody) -> syn::Result<TOutput>;
|
|
}
|
|
|
|
pub trait TypeHelper {
|
|
fn get_path() -> Path;
|
|
fn get_path_string() -> String {
|
|
Self::get_path().to_token_stream().to_string()
|
|
}
|
|
}
|
|
|
|
impl<'a> TypeHelper for Scope<'a> {
|
|
fn get_path() -> Path {
|
|
parse_quote!(::dioxus::core::Scope)
|
|
}
|
|
}
|
|
|
|
impl<'a> TypeHelper for Element<'a> {
|
|
fn get_path() -> Path {
|
|
parse_quote!(::dioxus::core::Element)
|
|
}
|
|
}
|