Struct DiffLine 

pub struct DiffLine {
    pub kind: DiffLineKind,
    pub content: String,
    pub old_line_num: Option<usize>,
    pub new_line_num: Option<usize>,
}

Represents a single line in a diff output.

A DiffLine contains the content of the line, its kind (context, added, removed, or hunk header), and the line numbers from both the old and new file versions.

Fields

• kind - The type of diff line (context, added, removed, or hunk header)
• content - The text content of the line
• old_line_num - Line number in the old version (None for added lines)
• new_line_num - Line number in the new version (None for removed lines)

Fields

kind: DiffLineKind

The type of this diff line.

content: String

The text content of the line.

old_line_num: Option<usize>

Line number in the old/original file. None for added lines since they don’t exist in the old version.

new_line_num: Option<usize>

Line number in the new/modified file. None for removed lines since they don’t exist in the new version.

Implementations

impl DiffLine

pub fn added(content: impl Into<String>, new_line_num: usize) -> Self

Creates an added diff line.

Added lines exist only in the new version of the file and are typically displayed with a green background and a ‘+’ prefix.

Arguments

• content - The text content of the line
• new_line_num - Line number in the new version

Returns

A new DiffLine with DiffLineKind::Added

Example

use ratatui_toolkit::code_diff::{DiffLine, DiffLineKind};

let line = DiffLine::added("new line", 10);
assert!(matches!(line.kind, DiffLineKind::Added));
assert!(line.old_line_num.is_none());

impl DiffLine

pub fn context( content: impl Into<String>, old_line_num: usize, new_line_num: usize, ) -> Self

Creates a context (unchanged) diff line.

Context lines appear in both the old and new versions of the file and are shown without highlighting to provide surrounding context.

Arguments

• content - The text content of the line
• old_line_num - Line number in the old version
• new_line_num - Line number in the new version

Returns

A new DiffLine with DiffLineKind::Context

Example

use ratatui_toolkit::code_diff::{DiffLine, DiffLineKind};

let line = DiffLine::context("unchanged line", 5, 7);
assert!(matches!(line.kind, DiffLineKind::Context));

impl DiffLine

pub fn hunk_header(content: impl Into<String>) -> Self

Creates a hunk header diff line.

Hunk headers mark the start of a diff section and contain line number information (e.g., @@ -1,4 +1,5 @@ function_name).

Arguments

• content - The full hunk header text

Returns

A new DiffLine with DiffLineKind::HunkHeader

Example

use ratatui_toolkit::code_diff::{DiffLine, DiffLineKind};

let line = DiffLine::hunk_header("@@ -1,4 +1,5 @@ fn main()");
assert!(matches!(line.kind, DiffLineKind::HunkHeader));

impl DiffLine

pub fn new( kind: DiffLineKind, content: impl Into<String>, old_line_num: Option<usize>, new_line_num: Option<usize>, ) -> Self

Creates a new diff line with all fields specified.

Arguments

• kind - The type of diff line
• content - The text content of the line
• old_line_num - Line number in the old version (None for added lines)
• new_line_num - Line number in the new version (None for removed lines)

Returns

A new DiffLine instance

Example

use ratatui_toolkit::code_diff::{DiffLine, DiffLineKind};

let line = DiffLine::new(
    DiffLineKind::Context,
    "unchanged line",
    Some(10),
    Some(12),
);

impl DiffLine

pub fn removed(content: impl Into<String>, old_line_num: usize) -> Self

Creates a removed diff line.

Removed lines exist only in the old version of the file and are typically displayed with a red background and a ‘-’ prefix.

Arguments

• content - The text content of the line
• old_line_num - Line number in the old version

Returns

A new DiffLine with DiffLineKind::Removed

Example

use ratatui_toolkit::code_diff::{DiffLine, DiffLineKind};

let line = DiffLine::removed("deleted line", 5);
assert!(matches!(line.kind, DiffLineKind::Removed));
assert!(line.new_line_num.is_none());

impl DiffLine

pub fn is_added(&self) -> bool

Returns true if this is an added line.

Returns

true if the line kind is Added, false otherwise

Example

use ratatui_toolkit::code_diff::DiffLine;

let line = DiffLine::added("new line", 5);
assert!(line.is_added());

impl DiffLine

pub fn is_context(&self) -> bool

Returns true if this is a context (unchanged) line.

Returns

true if the line kind is Context, false otherwise

Example

use ratatui_toolkit::code_diff::DiffLine;

let line = DiffLine::context("unchanged", 1, 1);
assert!(line.is_context());

impl DiffLine

pub fn is_hunk_header(&self) -> bool

Returns true if this is a hunk header line.

Returns

true if the line kind is HunkHeader, false otherwise

Example

use ratatui_toolkit::code_diff::DiffLine;

let line = DiffLine::hunk_header("@@ -1,4 +1,5 @@");
assert!(line.is_hunk_header());

impl DiffLine

pub fn is_removed(&self) -> bool

Returns true if this is a removed line.

Returns

true if the line kind is Removed, false otherwise

Example

use ratatui_toolkit::code_diff::DiffLine;

let line = DiffLine::removed("deleted line", 5);
assert!(line.is_removed());

impl DiffLine

pub fn prefix(&self) -> char

Returns the prefix character for this line kind.

• Context lines: ’ ’ (space)
• Added lines: ‘+’
• Removed lines: ‘-’
• Hunk headers: ‘@’

Returns

A single character prefix for display

Example

use ratatui_toolkit::code_diff::DiffLine;

let added = DiffLine::added("new line", 5);
assert_eq!(added.prefix(), '+');

let removed = DiffLine::removed("old line", 5);
assert_eq!(removed.prefix(), '-');

Trait Implementations

impl Clone for DiffLine

fn clone(&self) -> DiffLine

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DiffLine

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for DiffLine

fn eq(&self, other: &DiffLine) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for DiffLine

impl StructuralPartialEq for DiffLine