Enum DiffOptions 

pub enum DiffOptions {
    Typed {
        format: DiffFormat,
        whitespace: WhitespaceHandling,
    },
    Raw(String),
}

Diff routine options passed via -doptions, shared by commands such as p4 diff, p4 diff2, p4 describe, and p4 annotate.

The structured (Typed) options split into two orthogonal dimensions — DiffFormat (output format) and WhitespaceHandling — each of which is internally mutually exclusive. All options are assembled with a DiffOptionsBuilder, whose mode type parameter tracks at compile time whether structured or raw options are being built; both builder states convert into this type via From, and command methods accept impl Into<DiffOptions> so a builder can be passed directly.

Examples

use perforce_cli::cmd::{DiffOptions, DiffOptionsBuilder};

// `-dub`: unified format, ignore changes within whitespace
let opts = DiffOptions::from(
    DiffOptionsBuilder::unified(None).ignore_changes_within_whitespace(),
);

// `-dc3`: context format with 3 lines of context
let opts = DiffOptions::from(DiffOptionsBuilder::context(Some(3)));

// `-d-C 25`: pass `-C 25` straight to an external diff program
let opts = DiffOptions::from(DiffOptionsBuilder::raw("-C 25"));

Variants

Typed

Structured diff options (the documented subset of the standard UNIX diff flags).

Fields

format: DiffFormat

whitespace: WhitespaceHandling

Raw(String)

Raw option string passed directly to the underlying diff routine (useful with an external diff program configured via P4DIFF).

Implementations

impl DiffOptions

pub fn format(&self) -> Option<DiffFormat>

Returns the selected output format, or None if this is a Raw value.

pub fn whitespace_handling(&self) -> Option<WhitespaceHandling>

Returns the selected whitespace handling, or None if this is a Raw value.

pub fn raw_str(&self) -> Option<&str>

Returns the raw option string, or None if this is a Typed value.

pub fn inject_arg(&self, command: &mut Command)

Injects the -doptions argument into command.

If this is a Typed value with both the format and whitespace handling at their defaults, no -d argument is emitted.

Trait Implementations

impl Clone for DiffOptions

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DiffOptions

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

Formats the value using the given formatter.

impl Default for DiffOptions

fn default() -> Self

Returns the “default value” for a type.

impl Eq for DiffOptions

impl From<DiffOptionsBuilder<DiffOptionsRawMode>> for DiffOptions

fn from(builder: DiffOptionsBuilder<DiffOptionsRawMode>) -> Self

Converts to this type from the input type.

impl From<DiffOptionsBuilder<DiffOptionsTypedMode>> for DiffOptions

fn from(builder: DiffOptionsBuilder<DiffOptionsTypedMode>) -> Self

Converts to this type from the input type.

impl From<String> for DiffOptions

fn from(s: String) -> Self

Converts to this type from the input type.

impl PartialEq for DiffOptions

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DiffOptions