1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64
/// Helper macro to chain multiple routes with .or(route()) between them.
///
/// # Example - single use with data injection
///
/// ```ignore
/// struct DbConnection;
/// fn display_user(#[data] user: DbConnection) {}
/// let db_connection = DbConnection;
/// assert_eq!(routes![db_connection; display_user], display_user(db_connection));
/// ```
///
/// # Example - Multiple routes
///
/// ```ignore
/// fn info() {}
/// fn ping() {}
/// assert_eq!(routes![ping, info], ping().or(info()));
/// ```
///
/// # Example - Multiple routes with data injection
///
/// ```ignore
/// struct DbConnection;
/// fn display_user(#[data] db: DbConnection) {}
/// fn display_users(#[data] db: DbConnection) {}
/// let db_connection = DbConnection;
/// assert_eq!(routes![db_connection; display_user, display_users], display_user(db_connection).or(display_users(db_connection)));
/// ```
///
/// # Example - Multiple routes chaining with data injection
///
/// ```ignore
/// struct DbConnection;
/// fn ping() {}
/// fn info() {}
/// fn display_user(#[data] db: DbConnection) {}
/// let db_connection = DbConnection;
/// assert_eq!(routes![ping, info].or(routes![db_connection; display_user]), ping().or(info()).or(display_user(db_connection)));
/// ```
#[macro_export]
macro_rules! routes {
( $s:expr ) => {
/// This is used when you use routes! with a single route without any data; I.e routes!(ping)
$s()
};
( $inject:expr; $s:expr ) => {
/// This is used when you use routes! with a single route and want to pass some data to it; I.e routes!(db_connection; get_user)
$s($inject)
};
( $s:expr, $( $x:expr ),* ) => {
/// This is used when you use routes! with multiple routes without any data: I.e routes!(ping, get_users, get_users)
$s()
$(
.or($x())
)*
};
( $inject:expr; $s:expr, $( $x:expr ),* ) => {
/// This is used when you use routes! with multiple routes and want to pass some data to it: I.e routes!(db_connection; ping, get_users, get_users)
$s(inject)
$(
.or($x($inject))
)*
};
}