Go to file
su-fang 2dc4ea9a6b changed debian/source/format to native 2023-03-01 17:10:49 +08:00
debian changed debian/source/format to native 2023-03-01 17:10:49 +08:00
src Import Upstream version 3.0.0 2023-03-01 17:10:47 +08:00
.cargo_vcs_info.json Import Upstream version 3.0.0 2023-03-01 17:10:47 +08:00
COPYRIGHT Import Upstream version 3.0.0 2023-03-01 17:10:47 +08:00
Cargo.toml Import Upstream version 3.0.0 2023-03-01 17:10:47 +08:00
Cargo.toml.orig Import Upstream version 3.0.0 2023-03-01 17:10:47 +08:00
LICENSE-APACHE Import Upstream version 3.0.0 2023-03-01 17:10:47 +08:00
LICENSE-MIT Import Upstream version 3.0.0 2023-03-01 17:10:47 +08:00
README.md Import Upstream version 3.0.0 2023-03-01 17:10:47 +08:00

README.md

UniQuote

This crate allows quoting strings for use in output. It works similarly to str::escape_debug, but the result is meant to be shown to users. Simply call Quote::quote on an argument passed to println! or a similar macro to quote it.

One of the primary uses for this crate is displaying paths losslessly. Since Path has no Display implementation, it is usually output by calling Path::display or Path::to_string_lossy beforehand. However, both of those methods are lossy; they replace all invalid characters with REPLACEMENT_CHARACTER. This crate escapes those invalid characters instead, allowing them to always be displayed correctly.

GitHub Build Status

Usage

Add the following lines to your "Cargo.toml" file:

[dependencies]
uniquote = "3.0"

See the documentation for available functionality and examples.

Rust version support

The minimum supported Rust toolchain version is currently Rust 1.51.0.

Minor version updates may increase these version requirements. However, the previous two Rust releases will always be supported. If the minimum Rust version must not be increased, use a tilde requirement to prevent updating this crate's minor version:

[dependencies]
uniquote = "~3.0"

License

Licensing terms are specified in COPYRIGHT.

Unless you explicitly state otherwise, any contribution submitted for inclusion in this crate, as defined in LICENSE-APACHE, shall be licensed according to COPYRIGHT, without any additional terms or conditions.