Crate search_path[][src]

Expand description

Provides a very simple search path file finder.

The SearchPath type allows for the finding of files using a series of search directories. This is akin to the mechanism a shell uses to find executables using the PATH environment variable. It can be constructed with a search path from an environment variable, from a string, or from a list of either string or Path/PathBuf values. Typically the find methods return the first matching file or directory, but the find_all method specifically collects and returns a list of all matching paths.


The SearchPath type also has From<> implementations for PathBuf, Vec<PathBuf>, Vec<&Path>, Vec<&str>, String, and &str. In the case of vector values, or a single PathBuf, each path value will be used as-is without trying to split it into components. In the case of individual String and &str values the value will be split using the platform specific path separator into individual paths components.


The following example shows the common pattern of finding an executable command on the command line.

use search_path::SearchPath;
use std::path::PathBuf;

fn which_command(cmd_name: &str) -> Option<PathBuf> {
    let search_path = SearchPath::new("PATH").expect("How do you live with no $PATH?");


This is the search path itself, it wraps a list of file paths which can then be used to find file system entries. See the module description for an overview.