termdiff

Diff a string for presentation to a user in the terminal.

Usage

``` rust use termdiff::{signstheme, DrawDiff}; let old = "Double, double toil and trouble; Fire burn and Caldron bubble."; let new = "Double, double toil and trouble; Fire burn and caldron bubble. Cool it with a baboon's blood, Then the charm is firm and good."; let actual = format!("{}", DrawDiff::new(old, new, signstheme()));

assert_eq!( actual, "--- remove | insert +++ Double, double toil and trouble; Fire burn and -Caldron bubble. +caldron bubble. +Cool it with a baboon's blood, +Then the charm is firm and good. " ); ```

Alternatively you can use this interface

``` rust use termdiff::{arrowstheme, diff}; let old = "Double, double toil and trouble; Fire burn and Caldron bubble."; let new = "Double, double toil and trouble; Fire burn and caldron bubble. Cool it with a baboon's blood, Then the charm is firm and good."; let mut buffer: Vec = Vec::new(); diff(&mut buffer, old, new, arrowstheme()).unwrap(); let actual: String = String::from_utf8(buffer).expect("Not valid UTF-8");

assert_eq!( actual, "< left / > right Double, double toil and trouble; Fire burn and

caldron bubble. Cool it with a baboon's blood, Then the charm is firm and good. " ); ```

Read more at Docs.rs

Themes

We have a limited number of built in themes

Arrows

Signs

Custom

``` rust use termdiff::DrawDiff; use termdiff::Theme; use crossterm::style::Stylize;

let mytheme = Theme { header: format!("{}\n", "Header"), highlightinsert: crossterm::style::Stylize::stylize, highlightdelete: crossterm::style::Stylize::stylize, equalprefix: "=".tostring(), equalcontent: crossterm::style::Stylize::stylize, deleteprefix: "!".tostring(), deletecontent: crossterm::style::Stylize::stylize, insertprefix: "|".tostring(), insertline: crossterm::style::Stylize::stylize, line_end: "\n".into(), };

let old = "Double, double toil and trouble; Fire burn and Caldron bubble."; let new = "Double, double toil and trouble; Fire burn and caldron bubble. Cool it with a baboon's blood, Then the charm is firm and good."; let actual = format!("{}", DrawDiff::new(old, new, my_theme));

assert_eq!( actual, "Header =Double, double toil and trouble; =Fire burn and !Caldron bubble. |caldron bubble. |Cool it with a baboon's blood, |Then the charm is firm and good. " ); ```