README.md

easy_paths

Convenience library for talented devs on tight schedules.

This library exists to streamline the data-type juggling normally associated with disk pathing by accepting generic strings ( str / String ) and returning String types.

Github

https://github.com/jrhazlett/easy_paths

Rust crate

https://crates.io/crates/easy_paths

Warnings

This library is tested on mac and linux.

This is completely untested on Windows.

License: MIT

Usage examples

All arguments can be of type 'str' or 'String'.

get_absolute_path

let string_path = "./test/test_b/test_c/../";
assert_eq!( easy_paths::get_absolute_path( &string_path ), format!( "{}/test/test_b", env!( "CARGO_MANIFEST_DIR" ) ), );

let string_result = easy_paths::get_absolute_path( &"~/test" );
if string_result.contains( "~" ) { panic!( "Result contains tilde." ) }
if !string_result.ends_with( "/test" ) { panic!( "Result doesn't end with '/test'." ) }

get_absolute_path_or_error

let string_path = "./test/test_b/test_c/../";
let result = match easy_paths::get_absolute_path_or_error( &string_path ) {
    Ok( string_result ) => string_result,
    Err( err ) => panic!( "{}", err, )
};
let expected = format!( "{}/test/test_b", env!( "CARGO_MANIFEST_DIR" ).to_string(), );
assert_eq!( result, expected )

get_base_name_with_extension

let string_path = "test/test_a/text_a_a.txt";
let result = match easy_paths::get_base_name( &string_path ) {
    Some( string_result ) => string_result,
    None => panic!( "" )
};
let expected = "text_a_a.txt".to_string();
assert_eq!( result, expected )

get_base_name_on_dir

let string_path = "test/test_b/test_c/text_b_c_a.txt";
let result = match easy_paths::get_base_name( &string_path ) {
    Some( string_result ) => string_result,
    None => panic!( "" )
};
let expected = "text_b_c_a.txt".to_string();
assert_eq!( result, expected )

get_common_path

let slice_of_strings = [
    "src/helpers_disk/A/B/C",
    "src/helpers_disk/A/B",
    "src/helpers_disk/A",
];
let result = match easy_paths::get_common_path( &slice_of_strings ) {
    Ok( string_result ) => string_result,
    Err( err ) => panic!( "{}", err )
};
let expected = "src".to_string();
assert_eq!( result, expected )

get_common_prefix

let slice_of_strings = [
    "src/helpers_disk/A/B/C",
    "src/helpers_disk/A/B",
    "src/helpers_disk/A",
];
let result = match easy_paths::get_common_prefix( &slice_of_strings ) {
    Ok( string_result ) => string_result,
    Err( err ) => panic!( "{}", err )
};
let expected = "src/helpers_disk/A".to_string();
assert_eq!( result, expected )

get_dir_name

let string_path = "test/test_b/test_c/text_b_c_a.txt";
let result = match easy_paths::get_dir_name( &string_path ) {
    Some( string_result ) => string_result,
    None => panic!( "Failed" )
};
let expected = "test/test_b/test_c".to_string();
assert_eq!( result, expected )

get_dir_ancestor_n_levels_up

let string_path = "test/test_b/test_c/text_b_c_a.txt";
let int_layers_up: usize = 2;
let result = match easy_paths::get_dir_ancestor_n_levels_up( &string_path, int_layers_up ) {
    Some( string_result ) => string_result,
    None => panic!( "Failed" )
};
let expected = "test/test_b".to_string();
assert_eq!( result, expected )

get_dir_ancestor_that_exists

let string_path = "test/test_b/test_c/text_b_c_a.txt/A/B/C";
let result = match easy_paths::get_dir_ancestor_that_exists( &string_path ) {
    Some( string_result ) => string_result,
    None => panic!( "Failed" ),
};
let expected = "test/test_b/test_c/text_b_c_a.txt".to_string();
assert_eq!( result, expected )

get_extension() {

let string_path = "test/test_b/test_c/text_b_c_a.txt";
let result = match easy_paths::get_extension( &string_path ) {
    Some( string_result ) => string_result,
    None => panic!( "Failed" )
};
let expected = "txt".to_string();
assert_eq!( result, expected )

get_only_dirs_from_slice

let slice_of_strings = [
    "test/test_b",
    "test/test_b/test_c",
    "test/test_b/test_c/text_b_c_b.txt",
    "test/test_b/test_c/text_b_c_a.txt",
    "test/test_a",
    "test/test_a/text_a_a.txt",
];
let result = easy_paths::get_only_dirs_from_slice( &slice_of_strings );
let expected = [
    "test/test_b",
    "test/test_b/test_c",
    "test/test_a",
].iter().map( | item | { format!( "{}", item, ) } ).collect::<Vec<String>>();
assert_eq!( result, expected, )

get_only_file_paths_from_slice

let slice_of_strings = [
    "test/test_b",
    "test/test_b/test_c",
    "test/test_b/test_c/text_b_c_b.txt",
    "test/test_b/test_c/text_b_c_a.txt",
    "test/test_a",
    "test/test_a/text_a_a.txt",
];
let result = easy_paths::get_only_file_paths_from_slice( &slice_of_strings );
let expected = [
    "test/test_b/test_c/text_b_c_b.txt",
    "test/test_b/test_c/text_b_c_a.txt",
    "test/test_a/text_a_a.txt",
].iter().map( | item | { format!( "{}", item, ) } ).collect::<Vec<String>>();
assert_eq!( result, expected, )

get_path_joined

let slice_of_strings = [ "A", "B", "C" ];
let result = match easy_paths::get_path_joined( &slice_of_strings ) {
    Some( string_result ) => string_result,
    None => panic!( "Failed" )
};
let expected = "A/B/C".to_string();
assert_eq!( result, expected )

get_paths_in_dir

let string_path = "test";
let result = match easy_paths::get_paths_in_dir( &string_path ) {
    Ok( vec_result ) => vec_result,
    Err( err ) => panic!( "{}", err, )
};
let expected = [
    "test/test_a",
    "test/test_b",
].iter().map( | item_str | { item_str.to_string() } ).collect::<Vec<String>>();
assert_eq!( result, expected )

get_paths_in_dir_and_sub_dirs

let string_path = "test";
let result = match easy_paths::get_paths_in_dir_and_sub_dirs( &string_path ) {
    Ok( vec_result ) => vec_result,
    Err( err ) => panic!( "{}", err )
};
let expected = [
    "test/test_b",
    "test/test_b/test_c",
    "test/test_b/test_c/text_b_c_b.txt",
    "test/test_b/test_c/text_b_c_a.txt",
    "test/test_a",
    "test/test_a/text_a_a.txt",
].iter().map( | item_str | { item_str.to_string() } ).collect::<Vec<String>>();
assert_eq!( result, expected )

get_paths_sorted_by_size_starting_with_shortest

let slice_of_strings = [
    "/A/B/C",
    "/A",
    "/A/B",
];
let result = match easy_paths::get_paths_sorted_by_size_starting_with_shortest( &slice_of_strings ) {
    Ok( vec_result ) => vec_result,
    Err( err ) => panic!( "{}", err ),
};
let expected = [
    "/A",
    "/A/B",
    "/A/B/C"
].iter().map( | item_str | { item_str.to_string() } ).collect::<Vec<String>>();
assert_eq!( result, expected )

get_paths_to_only_dirs_in_dir_and_sub_dirs

let string_path = "test";
let result = match easy_paths::get_paths_to_only_dirs_in_dir_and_sub_dirs( &string_path ) {
    Ok( vec_result ) => vec_result,
    Err( err ) => panic!( "{}", err, )
};
let expected = [
    "test/test_b",
    "test/test_b/test_c",
    "test/test_a",
].iter().map(|item_str| {item_str.to_string()}).collect::<Vec<String>>();
assert_eq!( result, expected )

get_paths_to_only_files_in_dir_and_sub_dirs

let string_path = "test";
let result = match easy_paths::get_paths_to_only_files_in_dir_and_sub_dirs( &string_path ) {
    Ok( vec_result ) => vec_result,
    Err( err ) => panic!( "{}", err, )
};
let expected = [
    "test/test_b/test_c/text_b_c_b.txt",
    "test/test_b/test_c/text_b_c_a.txt",
    "test/test_a/text_a_a.txt",
].iter().map( | item_str | { item_str.to_string() } ).collect::<Vec<String>>();
assert_eq!( result, expected )

get_relative_path

let string_path_abs_root = "/A/B/C";
let string_path_abs = "/A/B/C/D";
let result = match easy_paths::get_relative_path( &string_path_abs, &string_path_abs_root ) {
    Ok( string_result ) => string_result,
    Err( err ) => panic!( "{}", err, ),
};
let expected = "D".to_string();
assert_eq!( result, expected )

get_vec_by_splitting_path

let string_path = "test/test_b/test_c/text_b_c_a.txt";
let result = match easy_paths::get_vec_by_splitting_path( &string_path ) {
    Some( vec_result ) => vec_result,
    None => panic!( "Failed" )
};
let expected = [
    "test",
    "test_b",
    "test_c",
    "text_b_c_a.txt",
].iter().map(|item_str|{item_str.to_string()}).collect::<Vec<String>>();
assert_eq!( result, expected )

is_absolute

assert_eq!( easy_paths::is_absolute( &"/A/B/C" ), true, )

is_existing_path

assert_eq!( easy_paths::is_existing_path( &"test/test_b/test_c/text_b_c_a.txt" ), true, )

is_path_type

assert_eq!( easy_paths::is_path_type( &Path::new( &"test/test_b/test_c/text_b_c_a.txt" ) ), true, )

is_path_buf_type

assert_eq!( easy_paths::is_path_buf_type( &PathBuf::from( "test/test_b/test_c/text_b_c_a.txt" ) ), true, )

is_path_inside_dir_parent

assert_eq!( easy_paths::is_path_inside_dir_parent( &"test/test_b/test_c/text_b_c_a.txt", &"test/test_b" ), true, )

raise_error_if_path_is_not_in_project_absolute

let mut string_path = "/badpath";
match easy_paths::raise_error_if_path_is_not_in_project( &string_path ) {
    Ok( () ) => {}
    Err( err ) => { panic!( "{}", err ) }
}

raise_error_if_path_points_to_src

match easy_paths::raise_error_if_path_points_to_src( &"src" ) {
    Ok( () ) => {}
    Err( err ) => { panic!( "{}", err ) }
}

raise_error_if_path_points_to_cargo_toml

let mut string_path = format!( "{}/Cargo.toml", env!( "CARGO_MANIFEST_DIR" ), );
match easy_paths::raise_error_if_path_points_to_cargo_toml( &string_path ) {
    Ok( () ) => {}
    Err( err ) => { panic!( "{}", err ) }
}

raise_error_if_path_points_to_main_rs

let mut string_path = format!( "{}/src/main.rs", env!( "CARGO_MANIFEST_DIR" ), );
match easy_paths::raise_error_if_path_points_to_main_rs( &string_path ) {
    Ok( () ) => {}
    Err( err ) => { panic!( "{}", err ) }
}