class

Tracing::Targets

Inherits Tracing::Layer < Reference < Object

A programmatic filter that matches events by target (module) prefix.

Ported from upstream tracing_subscriber::filter::Targets.

Constructors

parse(s : String) : Targets

Parses a comma-delimited list of target=level directives.

Each directive is one of:

  • target=level (e.g. my_crate::module=info)
  • target (bare target, enabled at TRACE)
  • level (bare level, sets the default level)

Levels are case-insensitive names (off, error, warn, info, debug, trace) or numbers 0-5. Mirrors upstream FromStr.

Source

Instance methods

==(other : Targets) : Bool
Source
default_level

Returns the default level, or nil if no default has been set. An unset default behaves like LevelFilter::OFF when filtering.

Source
enabled?(metadata : Metadata, ctx : LayerContext) : Bool

Returns true if this layer would enable the given metadata.

Source
hash(hasher)

See Object#hash(hasher)

Source
iter

Returns a lazy iterator over the target/level pairs in this filter, excluding the default. Mirrors upstream Targets::iter, which returns an Iterator.

Source
max_level_hint

Returns the max level hint for this layer.

Source
to_s(io : IO) : Nil

Appends a short String representation of this object which includes its class name and its object address.

class Person
  def initialize(@name : String, @age : Int32)
  end
end

Person.new("John", 32).to_s # => #<Person:0x10a199f20>
Source
with_default(level : LevelFilter) : self
Source
with_target(target : String, level : Level) : self
Source
with_target(target : String, level : LevelFilter) : self
Source
with_targets(pairs : Enumerable(Tuple(String, Level)) | Enumerable(Tuple(String, LevelFilter))) : self
Source
with_targets(pairs : Enumerable(Tuple(String, Level | LevelFilter))) : self
Source
would_enable(target : String, level : Level) : Bool

Returns whether a target/level pair would be enabled by this filter.

Source

Nested types