metainfo

Crates.iometainfo
lib.rsmetainfo
version0.7.12
sourcesrc
created_at2021-06-06 09:49:46.64588
updated_at2024-06-24 12:46:27.931088
descriptionTransmissing metainfo across components.
homepagehttps://www.cloudwego.io/docs/volo/
repositoryhttps://github.com/cloudwego/metainfo
max_upload_size
id406810
size499,840
Volo-maintainers (github:cloudwego:volo-maintainers)

documentation

README

Metainfo

Crates.io Documentation License Build Status

Transmissing metainfo across components.

Quickstart

Metainfo is designed to be passed through task local, so we provided a unified key for it metainfo::METAINFO, and we recommend you to use it this way:

METAINFO.scope(...)

MetaInfo is used to passthrough information between components and even client-server.

It supports two types of info: typed map and string k-v.

It is designed to be tree-like, which means you can share a MetaInfo with multiple children.

Note: only the current scope is mutable.

Example:

use metainfo::MetaInfo;

fn test() {
    let mut m1 = MetaInfo::new();
    m1.insert::<i8>(2);
    assert_eq!(*m1.get::<i8>().unwrap(), 2);

    let (mut m1, mut m2) = m1.derive();
    assert_eq!(*m2.get::<i8>().unwrap(), 2);

    m2.insert::<i8>(4);
    assert_eq!(*m2.get::<i8>().unwrap(), 4);

    m2.remove::<i8>();
    assert_eq!(*m2.get::<i8>().unwrap(), 2);
}

Related Projects

  • Volo: A high-performance and strong-extensibility Rust RPC framework that helps developers build microservices.
  • Volo-rs: The volo ecosystem which contains a lot of useful components.
  • Motore: Middleware abstraction layer powered by GAT.
  • Pilota: A thrift and protobuf implementation in pure rust with high performance and extensibility.

Contributing

See CONTRIBUTING.md for more information.

License

Metainfo is dual-licensed under the MIT license and the Apache License (Version 2.0).

See LICENSE-MIT and LICENSE-APACHE for details.

Community

Commit count: 22

cargo fmt