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 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105
/// Asserts that expression returns [`Poll::Ready(Ok(T))`] variant. /// /// This macro is available for Rust 1.36+. /// /// ## Uses /// /// Assertions are always checked in both debug and release builds, and cannot be disabled. /// See [`debug_assert_ready_ok!`] for assertions that are not enabled in release builds by default. /// /// ## Custom messages /// /// This macro has a second form, where a custom panic message can be provided /// with or without arguments for formatting. See [`std::fmt`] for syntax for this form. /// /// ## Examples /// /// ```rust /// # #[macro_use] extern crate claim; /// # use std::task::Poll; /// # fn main() { /// let res: Poll<Result<i32, ()>> = Poll::Ready(Ok(42)); /// /// assert_ready_ok!(res); /// # } /// ``` /// /// Value of `T` type from the `Poll::Ready(Ok(T))` will also be returned from this macro call: /// /// ```rust /// # #[macro_use] extern crate claim; /// # use std::task::Poll; /// # fn main() { /// let res: Poll<Result<i32, ()>> = Poll::Ready(Ok(42)); /// /// let value = assert_ready_ok!(res); /// assert_eq!(value, 42); /// # } /// ``` /// /// Both `Poll::Ready(Err(..))` and [`Poll::Pending`] variants will cause panic: /// /// ```rust,should_panic /// # #[macro_use] extern crate claim; /// # use std::task::Poll; /// # fn main() { /// let res: Poll<Result<i32, ()>> = Poll::Ready(Err(())); /// /// assert_ready_ok!(res); // Will panic /// # } /// ``` /// /// ```rust,should_panic /// # #[macro_use] extern crate claim; /// # use std::task::Poll; /// # fn main() { /// let res: Poll<Result<i32, ()>> = Poll::Pending; /// /// assert_ready_ok!(res); // Will panic /// # } /// ``` /// /// [`Poll::Ready(Ok(T))`]: https://doc.rust-lang.org/core/task/enum.Poll.html#variant.Ready /// [`Poll::Pending`]: https://doc.rust-lang.org/core/task/enum.Poll.html#variant.Pending /// [`std::fmt`]: https://doc.rust-lang.org/std/fmt/index.html /// [`debug_assert_ready_ok!`]: ./macro.debug_assert_ready_ok.html #[macro_export] macro_rules! assert_ready_ok { ($cond:expr,) => { $crate::assert_ready_ok!($cond); }; ($cond:expr) => { match $cond { core::task::Poll::Ready(Ok(t)) => t, err_or_pending => { panic!("assertion failed, expected Ready(Ok(..)), got {:?}", err_or_pending); } } }; ($cond:expr, $($arg:tt)+) => { match $cond { core::task::Poll::Ready(Ok(t)) => t, err_or_pending => { panic!("assertion failed, expected Ready(Ok(..)), got {:?}: {}", err_or_pending, format_args!($($arg)+)); } } }; } /// Asserts that expression returns [`Poll::Ready(Ok(T))`] variant in runtime. /// /// Like [`assert_ready_ok!`], this macro also has a second version, /// where a custom panic message can be provided. /// /// ## Uses /// /// See [`debug_assert!`] documentation for possible use cases. /// The same applies to this macro. /// /// [`Poll::Ready(Ok(T))`]: https://doc.rust-lang.org/core/task/enum.Poll.html#variant.Ready /// [`debug_assert!`]: https://doc.rust-lang.org/std/macro.debug_assert.html /// [`assert_ready_ok!`]: ./macro.assert_ready_ok.html #[macro_export] macro_rules! debug_assert_ready_ok { ($($arg:tt)*) => (if core::cfg!(debug_assertions) { $crate::assert_ready_ok!($($arg)*); }) }