shellexpand is a single dependency library which allows one to perform shell-like expansions in strings, that is, to expand variables like $A
or ${B}
into their values inside some context and to expand ~
in the beginning of a string into the home directory (again, inside some context).
This crate provides generic functions which accept arbitrary contexts as well as default, system-based functions which perform expansions using the system-wide context (represented by functions from std::env
module and dirs crate).
expanduser
: Tilde substitution only. Supports ~user
which this crate currently does not (although we hope to).envsubst
: Does not do offer tildeexpansion. Only supports certain concrete types (eg HashMap
for variable map).expand_str
: Uses %..%
syntax. Does not offer tilde expansion. Variable lookups can only be infallible.tilde_expand
: Only does tilde expansion, on bytes ([u8]
).Just add a dependency in your Cargo.toml
:
[dependencies] shellexpand = "2.1"
See the crate documentation (a link is present in the beginning of this readme) for more information and examples.
Minor changes:
shellexpand
on crates.io.cargo fix
.shellexpand-fork
on crates.io.dirs-next
instead of the obsolete dirs
as the underlying dependency used to resolve the home directory${ANSWER:-42}
)dyn
for trait objects to fix deprecation warningsource()
instead of cause()
in the Error
implementation, and therefore added a 'static
bound for the generic error parameter E
dirs
dependency to 2.0.std::env::home_dir
to the dirs::home_dir functionhome_dir
argument type for tilde expansion functions to FnOnce
instead FnMut
LookupError::name
field name to var_name
This program is licensed under either of
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.