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
// Copyright (C) 2019-2025 Daniel Mueller <deso@posteo.net>
// SPDX-License-Identifier: (Apache-2.0 OR MIT)
//! A crate providing a replacement #[[macro@test]] attribute that
//! initializes logging and/or tracing infrastructure before running
//! tests.
/// A procedural macro for the `test` attribute.
///
/// The attribute can be used to define a test that has the `env_logger`
/// and/or `tracing` crates initialized (depending on the features used).
///
/// # Example
///
/// Specify the attribute on a per-test basis:
/// ```rust
/// # use logging::info;
/// # // Note that no test would actually run, regardless of `no_run`,
/// # // because we do not invoke the function.
/// #[test_log::test]
/// fn it_works() {
/// info!("Checking whether it still works...");
/// assert_eq!(2 + 2, 4);
/// info!("Looks good!");
/// }
/// ```
///
/// It can be very convenient to convert over all tests by overriding
/// the `#[test]` attribute on a per-module basis:
/// ```rust
/// use test_log::test;
///
/// #[test]
/// fn it_still_works() {
/// // ...
/// }
/// ```
///
/// The crate also supports stacking with other `#[test]` attributes.
/// For example, you can stack
/// [`#[tokio::test]`](https://docs.rs/tokio/1.45.1/tokio/attr.test.html)
/// on top of this crate's `#[test]` attribute and test `async`
/// functionality this way:
///
/// ```rust
/// #[tokio::test]
/// #[test_log::test]
/// async fn it_still_works() {
/// // ...
/// }
/// ```
///
/// Note that stacking `#[test]` attributes this way requires some minimal
/// level of cooperation from the other crate to work properly (see
/// [#46](https://github.com/d-e-s-o/test-log/pull/46) for details), but as
/// a fallback a wrapping style can be used as well:
/// ```rust
/// use test_log::test;
///
/// #[test(tokio::test)]
/// async fn it_also_works() {
/// // ...
/// }
/// ```
pub use test;
pub use tracing_subscriber;
pub use env_logger;