9 stable releases
3.0.5 | Oct 28, 2024 |
---|---|
3.0.4 | Sep 7, 2024 |
3.0.3 | Jul 25, 2024 |
3.0.2 | Mar 8, 2024 |
1.0.1 | Dec 27, 2022 |
#150 in Command-line interface
410 downloads per month
Used in 5 crates
18KB
156 lines
syntect-tui
A lightweight translation layer between syntect and ratatui style types. If you're building a CLI app with a UI powered by tui.rs and need syntax highlighting, then you may find this crate useful!
Given the limited scope of this crate I do not have plans to extend existing functionality much further. However, I am open to requests and/or contributions, so feel free to fork and submit a pull request.
Getting Started
syntect-tui
is available on crates.io. You can install it by adding the following line to your Cargo.toml
:
syntect-tui = "3.0"
Docs
For more usage information read the docs
Example Code
Building upon syntect's simple example, here's a snippet that parses some rust code, highlights it using syntect and converts it into ratatui::text::Line ready for rendering in a tui appliction:
use syntect::easy::HighlightLines;
use syntect::parsing::SyntaxSet;
use syntect::highlighting::{ThemeSet, Style};
use syntect::util::LinesWithEndings;
use syntui::into_span;
let ps = SyntaxSet::load_defaults_newlines();
let ts = ThemeSet::load_defaults();
let syntax = ps.find_syntax_by_extension("rs").unwrap();
let mut h = HighlightLines::new(syntax, &ts.themes["base16-ocean.dark"]);
let s = "pub struct Wow { hi: u64 }\nfn blah() -> u64 {}";
for line in LinesWithEndings::from(s) { // LinesWithEndings enables use of newlines mode
let line_spans: Vec<tui::text::Span> =
h.highlight_line(line, &ps)
.unwrap()
.into_iter()
.filter_map(|segment| into_span(segment).ok())
.collect();
let spans = tui::text::Spans::from(line_spans);
print!("{:?}", spans);
}
Licence & Acknowledgements
All code is released under the MIT License. Thanks to trishume,
fdehau, and the ratatui
community for building sytect
, tui
, and ratatui
!
Also a big thank you to fellow rustaceans who have contributed to the maintenance of this crate:
Dependencies
~9–19MB
~257K SLoC