fn_meta

Crates.iofn_meta
lib.rsfn_meta
version0.7.4
sourcesrc
created_at2021-04-26 01:58:41.83756
updated_at2024-08-31 08:01:26.954157
descriptionReturns metadata about a function at runtime.
homepage
repositoryhttps://github.com/azriel91/fn_meta
max_upload_size
id389540
size61,691
Azriel Hoh (azriel91)

documentation

https://docs.rs/fn_meta/

README

🧬 FnMeta

Crates.io docs.rs CI Coverage Status

Returns metadata about a function at runtime.

Currently this includes the TypeIds of function parameters.

This includes a FnMetadata struct and FnMetadataExt trait. FnMetadataExt adds the .metadata() function on functions and closures to return a FnMetadata, whose implementation returns function metadata at runtime.

Usage

Add the following to Cargo.toml

fn_meta = "0.7.3"

# or
fn_meta = { version = "0.7.3", features = ["fn_meta_ext"] }

Code:

use core::any::TypeId;

use fn_meta::{FnMetaDyn, FnMetadataExt};

fn f1(_: &S0, _: &mut S1, _: &S2) -> () {}

let fn_metadata = f1.metadata();

assert_eq!(
    [TypeId::of::<S0>(), TypeId::of::<S2>()],
    fn_metadata.borrows().as_slice()
);
assert_eq!([TypeId::of::<S1>()], fn_metadata.borrow_muts().as_slice());

struct S0;
struct S1;
struct S2;

Features

"fn_meta_ext":

Enables the FnMeta and FnMetaExt traits. FnMetaExt adds the .meta() function on functions and closures to return a Box<dyn FnMeta>, which is the dynamic dispatch analog to FnMetadata.

"high_arg_count":

Raises the number of arguments that FnMetaExt and FnMetadataExt are implemented for from 6 to 8.

This is feature gated because compilation time increasing significantly with higher numbers of arguments -- as much as from 1.5 seconds for 6 arguments to 8 seconds for 8 arguments.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Commit count: 74

cargo fmt