Text-formatter-without-style-markup

Return a copy of a TextFormatter with message style markup disabled. This is the convenience helper for the common case where message text should stay literal even if it contains tag-like syntax.

Interface

pub fn TextFormatter::without_style_markup(self : TextFormatter) -> TextFormatter {

input

• self : TextFormatter - Base formatter to copy.

output

• TextFormatter - A new formatter value whose message markup policy is StyleMarkupMode::Disabled.

Explanation

Detailed rules explaining key parameters and behaviors

• This method is a convenience wrapper over with_style_markup(StyleMarkupMode::Disabled).
• Only the message-text markup scope changes.
• Target and field-value markup settings are preserved as-is.
• The original formatter value is not mutated.

How to Use

Here are some specific examples provided.

When Need Literal Message Text

When log messages may contain <tag>-like text that should not be parsed:

let formatter = text_formatter(color_mode=ColorMode::Always)
  .without_style_markup()

In this example, message text is rendered literally instead of interpreting inline style tags.

When Need A Safe Variant Of A Styled Base Formatter

When one formatter should keep the same colors and template but stop parsing message tags:

let base = text_formatter(color_mode=ColorMode::Always)
let safe = base.without_style_markup()

In this example, the derived formatter only changes the message markup policy.

Error Case

e.g.:

• There is no dedicated failure path for valid TextFormatter values.

• If target or field scopes should also stop parsing tags, callers need the corresponding dedicated formatter methods rather than this message-only helper.

Notes

1. Use this helper when the disabled case is what you want directly.

2. It is equivalent to calling with_style_markup(StyleMarkupMode::Disabled) explicitly.