//! Highlight text. use crate::Color; use std::ops::Range; /// A type capable of highlighting text. /// /// A [`Highlighter`] highlights lines in sequence. When a line changes, /// it must be notified and the lines after the changed one must be fed /// again to the [`Highlighter`]. pub trait Highlighter: 'static { /// The settings to configure the [`Highlighter`]. type Settings: PartialEq + Clone; /// The output of the [`Highlighter`]. type Highlight; /// The highlight iterator type. type Iterator<'a>: Iterator, Self::Highlight)> where Self: 'a; /// Creates a new [`Highlighter`] from its [`Self::Settings`]. fn new(settings: &Self::Settings) -> Self; /// Updates the [`Highlighter`] with some new [`Self::Settings`]. fn update(&mut self, new_settings: &Self::Settings); /// Notifies the [`Highlighter`] that the line at the given index has changed. fn change_line(&mut self, line: usize); /// Highlights the given line. /// /// If a line changed prior to this, the first line provided here will be the /// line that changed. fn highlight_line(&mut self, line: &str) -> Self::Iterator<'_>; /// Returns the current line of the [`Highlighter`]. /// /// If `change_line` has been called, this will normally be the least index /// that changed. fn current_line(&self) -> usize; } /// A highlighter that highlights nothing. #[derive(Debug, Clone, Copy)] pub struct PlainText; impl Highlighter for PlainText { type Settings = (); type Highlight = (); type Iterator<'a> = std::iter::Empty<(Range, Self::Highlight)>; fn new(_settings: &Self::Settings) -> Self { Self } fn update(&mut self, _new_settings: &Self::Settings) {} fn change_line(&mut self, _line: usize) {} fn highlight_line(&mut self, _line: &str) -> Self::Iterator<'_> { std::iter::empty() } fn current_line(&self) -> usize { usize::MAX } } /// The format of some text. #[derive(Debug, Clone, Copy, PartialEq)] pub struct Format { /// The [`Color`] of the text. pub color: Option, /// The `Font` of the text. pub font: Option, } impl Default for Format { fn default() -> Self { Self { color: None, font: None, } } }