tracing_subscriber/filter/
mod.rs

1//! [Subscribers](crate::subscribe) that control which spans and events are
2//! enabled by the wrapped collector.
3//!
4//! This module contains a number of types that provide implementations of
5//! various strategies for filtering which spans and events are enabled. For
6//! details on filtering spans and events using [`Subscribe`] implementations,
7//! see the [`subscribe` module documentation].
8//!
9//! [`subscribe` module documentation]: crate::subscribe#filtering-with-subscribers
10//! [`Subscribe`]: crate::subscribe
11mod filter_fn;
12mod level;
13
14feature! {
15    #![all(feature = "env-filter", feature = "std")]
16    mod env;
17    pub use self::env::*;
18}
19
20feature! {
21    #![all(feature = "registry", feature = "std")]
22    mod subscriber_filters;
23    pub use self::subscriber_filters::*;
24}
25
26pub use self::filter_fn::*;
27#[cfg(not(feature = "registry"))]
28pub(crate) use self::has_psf_stubs::*;
29
30pub use self::level::{LevelFilter, ParseError as LevelParseError};
31
32#[cfg(not(all(feature = "registry", feature = "std")))]
33#[allow(unused_imports)]
34pub(crate) use self::has_psf_stubs::*;
35
36feature! {
37    #![any(feature = "std", feature = "alloc")]
38    pub mod targets;
39    pub use self::targets::Targets;
40
41    mod directive;
42    pub use self::directive::ParseError;
43}
44
45/// Stub implementations of the per-subscriber-filter detection functions for
46/// when the `registry` feature is disabled.
47#[cfg(not(all(feature = "registry", feature = "std")))]
48mod has_psf_stubs {
49    pub(crate) fn is_psf_downcast_marker(_: core::any::TypeId) -> bool {
50        false
51    }
52
53    /// Does a type implementing `Collect` contain any per-subscriber filters?
54    pub(crate) fn collector_has_psf<C>(_: &C) -> bool
55    where
56        C: tracing_core::Collect,
57    {
58        false
59    }
60
61    /// Does a type implementing `Subscribe` contain any per-subscriber filters?
62    pub(crate) fn subscriber_has_psf<S, C>(_: &S) -> bool
63    where
64        S: crate::Subscribe<C>,
65        C: tracing_core::Collect,
66    {
67        false
68    }
69}
tracing_subscriber/filter/mod.rs

tracing_subscriber/filter/
mod.rs
