[−][src]Struct grep_printer::UserColorSpec
A single color specification provided by the user.
Format
The format of a Spec
is a triple: {type}:{attribute}:{value}
. Each
component is defined as follows:
{type}
can be one ofpath
,line
,column
ormatch
.{attribute}
can be one offg
,bg
orstyle
.{attribute}
may also be the special valuenone
, in which case,{value}
can be omitted.{value}
is either a color name (forfg
/bg
) or a style instruction.
{type}
controls which part of the output should be styled.
When {attribute}
is none
, then this should cause any existing style
settings to be cleared for the specified type
.
{value}
should be a color when {attribute}
is fg
or bg
, or it
should be a style instruction when {attribute}
is style
. When
{attribute}
is none
, {value}
must be omitted.
Valid colors are black
, blue
, green
, red
, cyan
, magenta
,
yellow
, white
. Extended colors can also be specified, and are formatted
as x
(for 256-bit colors) or x,x,x
(for 24-bit true color), where
x
is a number between 0 and 255 inclusive. x
may be given as a normal
decimal number of a hexadecimal number, where the latter is prefixed by
0x
.
Valid style instructions are nobold
, bold
, intense
, nointense
,
underline
, nounderline
.
Example
The standard way to build a UserColorSpec
is to parse it from a string.
Once multiple UserColorSpec
s have been constructed, they can be provided
to the standard printer where they will automatically be applied to the
output.
A UserColorSpec
can also be converted to a termcolor::ColorSpec
:
extern crate grep_printer; extern crate termcolor; use termcolor::{Color, ColorSpec}; use grep_printer::UserColorSpec; let user_spec1: UserColorSpec = "path:fg:blue".parse().unwrap(); let user_spec2: UserColorSpec = "match:bg:0xff,0x7f,0x00".parse().unwrap(); let spec1 = user_spec1.to_color_spec(); let spec2 = user_spec2.to_color_spec(); assert_eq!(spec1.fg(), Some(&Color::Blue)); assert_eq!(spec2.bg(), Some(&Color::Rgb(0xFF, 0x7F, 0x00)));
Methods
impl UserColorSpec
[src]
pub fn to_color_spec(&self) -> ColorSpec
[src]
Convert this user provided color specification to a specification that
can be used with termcolor
. This drops the type of this specification
(where the type indicates where the color is applied in the standard
printer, e.g., to the file path or the line numbers, etc.).
Trait Implementations
impl Clone for UserColorSpec
[src]
fn clone(&self) -> UserColorSpec
[src]
default fn clone_from(&mut self, source: &Self)
1.0.0[src]
Performs copy-assignment from source
. Read more
impl PartialEq<UserColorSpec> for UserColorSpec
[src]
fn eq(&self, other: &UserColorSpec) -> bool
[src]
fn ne(&self, other: &UserColorSpec) -> bool
[src]
impl Eq for UserColorSpec
[src]
impl Debug for UserColorSpec
[src]
impl FromStr for UserColorSpec
[src]
type Err = ColorError
The associated error which can be returned from parsing.
fn from_str(s: &str) -> Result<UserColorSpec, ColorError>
[src]
Auto Trait Implementations
impl Send for UserColorSpec
impl Sync for UserColorSpec
Blanket Implementations
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
impl<T, U> Into for T where
U: From<T>,
[src]
U: From<T>,
impl<T> From for T
[src]
impl<T, U> TryFrom for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T> Borrow for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> BorrowMut for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T, U> TryInto for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,