Struct File

pub struct File<'a> {
    pub old_path: Option<Cow<'a, Path>>,
    pub path: Cow<'a, Path>,
    pub file_mode: FileMode,
    pub sections: Vec<Section<'a>>,
}

The state of a file to be recorded.

Fields

old_path: Option<Cow<'a, Path>>

The path to the previous version of the file, for display purposes. This should be set if the file was renamed or copied from another file.

path: Cow<'a, Path>

The path to the current version of the file, for display purposes.

file_mode: FileMode

The Unix file mode of the file (before any changes), if available. This may be rendered by the UI.

This value is not directly modified by the UI; instead, construct a Section::FileMode and look for a user-provided update to the file mode in the changes returned from File::get_selected_contents().

sections: Vec<Section<'a>>

The set of Sections inside the file.

Implementations

impl File<'_>

pub fn get_selected_contents( &self, ) -> (SelectedChanges<'_>, SelectedChanges<'_>)

Calculate the (selected, unselected) contents of the file. For example, the first value would be suitable for staging or committing, and the second value would be suitable for potentially recording again.

pub fn tristate(&self) -> Tristate

Get the tristate value of the file. If there are no sections in this file, returns Tristate::False.

pub fn set_checked(&mut self, checked: bool)

Set the selection of all sections and lines in this file.

pub fn toggle_all(&mut self)

Toggle the selection of all sections in this file.

Trait Implementations

impl<'a> Clone for File<'a>

fn clone(&self) -> File<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for File<'a>

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

Formats the value using the given formatter.

impl<'de, 'a> Deserialize<'de> for File<'a>

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'a> PartialEq for File<'a>

fn eq(&self, other: &File<'a>) -> 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<'a> Serialize for File<'a>

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<'a> Eq for File<'a>

impl<'a> StructuralPartialEq for File<'a>