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

/// Test if an item implements `Debug` trait.
/// 
/// ### Examples
///
/// - Debug item:
/// 
/// ```
/// // either "test" or "all" features must be enabled
/// #[cfg(any(feature = "test", feature = "all"))]
/// {
///     use cs_utils::test::implements_debug;
///
///     #[derive(Debug)]
///     struct TestStruct {}
/// 
///     // compiles fine
///     implements_debug(TestStruct {});
/// }
/// ```
/// 
/// - Non-Debug item:
/// 
/// ```compile_fail
/// // either "test" or "all" features must be enabled
/// #[cfg(any(feature = "test", feature = "all"))]
/// {
///     use cs_utils::test::implements_debug;
///     
///     // don't derive Debug
///     struct TestStruct {}
/// 
///     // does not compile
///     implements_debug(TestStruct {});
/// }
/// ```
pub fn implements_debug<T: std::fmt::Debug>(item: T) -> T {
    return item;
}