Struct FileStructure

pub struct FileStructure { /* private fields */ }

A struct which represents a (sub)-filestructure.

Implementations

impl FileStructure

pub fn from_path(path: &str) -> Self

Constructs a FileStructure completely from a unix path.

If the path contains a starting /, will return a structure with a root node. If not, the root will be the first name of the path.

Example

use filestructure::{FileStructure, FileType};
let s = "/some/path";
let fs = FileStructure::from_path(s);
let expected = FileStructure::new("".to_string(), 
    FileType::Dir(vec![
        FileStructure::new("some".to_string(),
            FileType::Dir(vec![
                FileStructure::new("path".to_string(),
                    FileType::Dir(vec![])
                )
            ])
        )
    ])
);
assert_eq!(fs, expected);

pub fn write_to_disk(&self, root: &Path) -> Result<()>

Given a full FileStructure and a starting path, attempts to write it all to disk.

Directories are handled recursively. Everything else is converted to bytes and written to a specific file.

Errors

Errors whenever we fail to either write to a file or create a dir. See the documentation for File::create, Write::write_all and create_dir for more info.

pub fn get(&self, path: &str) -> Option<&Self>

Tries finding a file in the structure by its full path.

Path should be written unix style.

pub fn get_mut(&mut self, path: &str) -> Option<&mut Self>

Tries finding a file in the structure by its full path, mutably

Path should be written unix style.

pub fn insert_dir(&mut self, path: &str) -> Option<&mut Self>

Inserts a directory into the FileStructure. Returns a None if we fail, returns a mutable reference to the bottom directory if we succeed.

Functions like mkdir -p, meaning that it will automatically create directories as needed until the full path has been added.

pub fn insert_blob(&mut self, path: &str, blob: Box<[u8]>) -> Option<&mut Self>

Insert binary blob data at some path relative to the root FileStructure.

Will automatically create directories if needed.

pub fn insert_string(&mut self, path: &str, data: String) -> Option<&mut Self>

Insert a String at some path relative to the root FileStructure.

Will automatically create directories if needed.

pub fn insert(&mut self, child: Self) -> Option<&mut Self>

Insert a FileStructure as a child to this FileStructure.

Returns a None if this FileStructure is not a directory. Returns a mutable reference to the child otherwise.

pub fn get_path(&self) -> &str

Get the path for this node of the structure.

pub fn len(&self) -> usize

Get the “len” (file count) of the structure.

TODO: Precalculate this instead of exploring the whole tree.

pub fn is_empty(&self) -> bool

A filestructure is deemed empty if there are 0 and 0 subdirs in it.

pub fn iter(&self) -> FileIterator<'_>

Convert the FileStructure into a usable iterator.

This will iterate over all the nodes in a DFS style.

Trait Implementations

impl Debug for FileStructure

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

Formats the value using the given formatter.

impl Default for FileStructure

fn default() -> Self

Returns the “default value” for a type.

impl Display for FileStructure

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

Formats the value using the given formatter.

impl<'a> IntoIterator for &'a FileStructure

type Item = &'a FileStructure

The type of the elements being iterated over.

type IntoIter = FileIterator<'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl IntoIterator for FileStructure

type Item = FileStructure

The type of the elements being iterated over.

type IntoIter = OwnedFileIterator

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for FileStructure

fn eq(&self, other: &FileStructure) -> 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 FileStructure

impl StructuralPartialEq for FileStructure