https://github.com/flowvix/lyneate

A crate for beautiful code underlining and error reporting
https://github.com/flowvix/lyneate

compiler crate display error error-reporting highlight parser rust

Last synced: 23 days ago
JSON representation

A crate for beautiful code underlining and error reporting

• Host: GitHub
• URL: https://github.com/flowvix/lyneate
• Owner: FlowVix
• License: mit
• Created: 2023-10-04T12:23:44.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2023-11-15T22:56:39.000Z (about 1 year ago)
• Last Synced: 2025-01-01T23:47:22.505Z (23 days ago)
• Topics: compiler, crate, display, error, error-reporting, highlight, parser, rust
• Language: Rust
• Homepage: https://crates.io/crates/lyneate
• Size: 152 KB
• Stars: 15
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Lyneate

[![crates.io](https://img.shields.io/crates/v/lyneate)](https://crates.io/crates/lyneate)

[![license](https://img.shields.io/crates/l/lyneate)](https://github.com/FlowVix/lyneate/blob/master/LICENSE)

[![docs.rs](https://img.shields.io/docsrs/lyneate)](https://docs.rs/lyneate)

Display beautiful code reports in the terminal with

support for single-line and multi-line highlighting.

## [Example](https://github.com/FlowVix/lyneate/blob/master/examples/basic.rs)



```rust

use colored::Colorize;

use lyneate::Report;

fn main() {

    println!(

        "{} Mismatched match expression branch return types\n",

        "Error:".bright_red()

    );

    let report = Report::new_char_spanned(

        include_str!("basic.pseudo"),

        [

            (

                29..102,

                format!("{}", "In this match expression".dimmed()),

                (255, 64, 112),

            ),

            (

                64..75,

                format!("{} {}", "This is of type".dimmed(), "int".bright_white()),

                (255, 159, 64),

            ),

            (

                87..92,

                format!("{} {}", "This is of type".dimmed(), "string".bright_white()),

                (207, 255, 64),

            ),

        ],

    );

    report.display();

}

```

[More examples](https://github.com/FlowVix/lyneate/blob/master/examples/)

## Usage

This crate provides:

-   the `Report` struct which takes the source code and an iterator over the span, text, and color of all messages

-   the `Theme`, `ThemeChars`, `ThemeEffects`, and `ThemeSizing` structs which can be used to customize the appearance of a report display

Code spans can be byte-aligned or char-aligned. Different methods for constructing a `Report` for either are provided.

The API is kept simple in order to allow as much flexibility

as possible to the user. It does not make any assumptions or care

about the provenance of the source code.

## Planned Features

-   Colorless support.