touch 0.0.1

A thin wrapper around file and directory operations designed to take remove some of tediousness.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

//! This module contains basic methods to manipulate the contents of local directories.
//! All methods in this module represent cross-platform filesystem operations.

use std::fs;

use error::Error;
use operation::Operation;
use super::Result;
use super::exists as exists;

/// Recursively creates the directory indicated by the provided path if it
/// does not exist, otherwise it short circuits and returns immediately.
///
/// # Failures
/// Fails if the directory cannot be created for any reason.
pub fn create(path: &str) -> Result<()> {
    if exists(path) { return Ok(()); }

    match fs::create_dir_all(path) {
        Ok(_) => {
            debug!("Successfully created '{}'", path);
            Ok(())
        },
        Err(error) => {
            if exists(path) {
                Ok(())
            } else {
                Err(Error::with_cause(&Operation::Create, path, error)) }
        }
    }
}

/// Idempotently deletes the file indicated by the provided path.
///
/// # Failures
/// Fails if the directory cannot be deleted for any reason.
pub fn delete(path: &str) -> Result<()> {
    if !exists(path) { return Ok(()); }

    match fs::remove_dir_all(path) {
        Ok(_) => {
            debug!("Successfully deleted '{}'", path);
            Ok(())
        },
        Err(error) => {
            if !exists(path) {
                Ok(())
            } else {
                Err(Error::with_cause(&Operation::Delete, path, error))
            }
        }
    }
}