hlight

A library for output syntax highlighting.

Quick Start

add dep

sh cargo add hlight

print to stdout

```rust use hlight::{gensyntaxhighlight, theme::themeayudark, HighLightRes};

let s: &str = r#" [main] enabled = false "😎" = "🍥" float = nan "#;

let mut res = HighLightRes::default().withbackground(false); // themeayudark: Cow::from("ayu-dark") *res.getnamemut() = themeayu_dark();

gensyntaxhighlight("toml", s, Some(&res), None) .expect("Failed to get highlighted toml text"); ```

output:

write to file

```rust use std::fs::File;

let mut file = File::create("test.txt").expect("Failed to create test.txt"); gensyntaxhighlight("toml", s, Some(&res), Some(&mut file)) .expect("Unable to write syntax-highlighted text to file.") ```

Advanced

Load custom set

The ["preset-syntax-set", "preset-theme-set"] features are enabled by default. If you want to customize the set, you don't need to load these features.

add deps:

sh cargo add hlight --no-default-features cargo add once_cell

theme-set

```rust use std::borrow::Cow; use hlight::{theme::loadthemeset, HighLightRes};

fn main() { const THEMES: &[u8] = includebytes!(concat!( env!("CARGOMANIFESTDIR"), "/assets/theme-set.packdump" )); let set = loadtheme_set(Some(THEMES));

let mut res = HighLightRes::default();

*res.get_theme_set_mut() = &set;
*res.get_name_mut() = Cow::from("Custom-theme-name");

} ```

syntax-set

```rust use hlight::{ syntax::{loadsyntaxset, SyntaxSet}, HighLightRes, }; // use std::cell::OnceCell; use once_cell::sync::OnceCell;

const SYNTAXES: &[u8] = includebytes!(concat!( env!("CARGOMANIFEST_DIR"), "/assets/theme-syntax-set/syntax-set.packdump" ));

fn staticsyntaxset() -> &'static SyntaxSet { static S: OnceCell = OnceCell::new(); S.getorinit(|| loadsyntaxset(Some(SYNTAXES))) }

fn main() { let set = staticsyntaxset();

let mut res = HighLightRes::default();
*res.get_syntax_set_mut() = set;

} ```