#reflection #bevy #traits #object #extension #steroids #bevy-reflect

reflect-steroids

Extensions for bevy_reflect enabling reflection through arbitrary trait objects

3 unstable releases

0.2.0 Aug 25, 2022
0.1.1 Aug 12, 2022
0.1.0 Aug 12, 2022

#2585 in Parser implementations

Download history 145/week @ 2024-02-26

145 downloads per month

MIT/Apache

76KB
1.5K SLoC

Bevy Reflection on Steroids

A series of supplementary extensions to the bevy_reflect crate that powers aspects of the Bevy game engine.

bevy_reflect provides is a general reflection framework for Rust structs, with rudimentary support for traits.

Highlights

  • Integrates seamlessly with bevy_reflect.
  • Includes a facility to register types globally without explicitly calling TypeRegistry::register(). This feature is gated behind the "inventory" crate feature, enabled by default. See enable_global_type_registration.
  • Includes a facility to perform generic dynamic casts between trait objects, patching a hole in the Rust language (similar to C++ dynamic_cast). See the Cast trait.
  • Includes the equivalent of downcast-rs, but using the Reflect trait instead of Any. See DowncastReflect.
  • Serialization and deserialization of opaque trait objects (similar to typetag).

This crate provides a much more intuitive and user-friendly way of interacting with reflected types through arbitrary trait objects.

By implementing DynamicTrait for dyn MyTrait, reflection is made available to all dynamic trait object references of that type. The only requirements are that the trait has DowncastReflect as a supertrait, and that a call to the macro impl_dynamic_trait!(MyTrait, ReflectMyTrait) is present in the code.

Dependencies

~3–11MB
~102K SLoC