1 unstable release

0.20.1 Mar 6, 2024

#1677 in Procedural macros

22 downloads per month
Used in near-async

MIT/Apache

21KB
371 lines

This crate provides a set of procedural macros for deriving traits for multi-sender types, which are structs that contain multiple Sender and AsyncSender fields. The structs can either have named fields or be a tuple struct.

The derive macros provided by this crate allows multi-senders to be created from anything that behaves like all of the individual senders, and allows the multi-sender to be used like any of the individual senders. This can be very useful when one component needs to send multiple kinds of messages to another component; for example the networking layer needs to send multiple types of messages to the ClientActor, each expecting a different response; it would be very cumbersome to have to construct the PeerManagerActor by passing in 10 different sender objects, so instead we create a multi-sender interface of all the senders and pass that in instead.

To better understand these macros,

  • Look at the tests in this crate for examples of what the macros generate.
  • Search for usages of the derive macros in the codebase.

Dependencies

~330–780KB
~19K SLoC