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'.

getabsolutepath

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'." ) }

getabsolutepathorerror

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 )

getbasenamewithextension

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 )

getbasenameondir

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 )

getcommonpath

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 )

getcommonprefix

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 )

getdirname

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 )

getdirancestornlevels_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 )

getdirancestorthatexists

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 )

getonlydirsfromslice

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, )

getonlyfilepathsfrom_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, )

getpathjoined

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 )

getpathsin_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 )

getpathsindirandsubdirs

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 )

getpathssortedbysizestartingwith_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 )

getpathstoonlydirsindirandsub_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 )

getpathstoonlyfilesindirandsub_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 )

getrelativepath

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 )

getvecbysplittingpath

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, )

isexistingpath

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

ispathtype

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

ispathbuf_type

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

ispathinsidedirparent

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

raiseerrorifpathisnotinprojectabsolute

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

raiseerrorifpathpointstosrc

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

raiseerrorifpathpointstocargo_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 ) }
}

raiseerrorifpathpointstomain_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 ) }
}