Camino
UTF-8 encoded path types for Rust, providing guaranteed UTF-8 strings for file system operations.
What is Camino?
Camino is a Rust library that extends the standard library's `std::path` module with UTF-8 guaranteed path types. It provides `Utf8Path` and `Utf8PathBuf` types that eliminate repetitive and error-prone conversions by encoding the UTF-8 invariant directly into the type system, addressing the common assumption that file paths are valid UTF-8.
Rust developers building portable, cross-platform software that interacts with file systems, especially those working with systems that already assume UTF-8 paths (like Cargo) or where files contain names of other files (avoiding the 'makefile problem').
Developers choose Camino because it provides a drop-in replacement for `Path` and `PathBuf` with guaranteed UTF-8 encoding, removing the need for repeated `to_str().unwrap()` calls and exposing path contents directly as strings. Its simplicity and safety through type system invariants reduce boilerplate and potential errors for the vast majority of use cases where non-Unicode paths are unnecessary.
Overview
Like Rust's std::path::Path, but UTF-8.
Use Cases
Best For
- Building portable, cross-platform software where Unicode is the common subset of supported paths across Windows and Unix platforms.
Related Projects
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
