Unnamed repository; edit this file 'description' to name the repository.
Diffstat (limited to 'helix-stdx/src/env.rs')
-rw-r--r--helix-stdx/src/env.rs226
1 files changed, 0 insertions, 226 deletions
diff --git a/helix-stdx/src/env.rs b/helix-stdx/src/env.rs
deleted file mode 100644
index 9e7781a0..00000000
--- a/helix-stdx/src/env.rs
+++ /dev/null
@@ -1,226 +0,0 @@
-//! Functions for working with the host environment.
-use std::{
- borrow::Cow,
- ffi::{OsStr, OsString},
- path::{Path, PathBuf},
- sync::RwLock,
-};
-
-use once_cell::sync::Lazy;
-
-// We keep the CWD as a static so that we can access it in places where we don't have access to the Editor
-static CWD: RwLock<Option<PathBuf>> = RwLock::new(None);
-
-/// Get the current working directory.
-/// This information is managed internally as the call to std::env::current_dir
-/// might fail if the cwd has been deleted.
-pub fn current_working_dir() -> PathBuf {
- if let Some(path) = &*CWD.read().unwrap() {
- return path.clone();
- }
-
- // implementation of crossplatform pwd -L
- // we want pwd -L so that symlinked directories are handled correctly
- let mut cwd = std::env::current_dir().expect("Couldn't determine current working directory");
-
- let pwd = std::env::var_os("PWD");
- #[cfg(windows)]
- let pwd = pwd.or_else(|| std::env::var_os("CD"));
-
- if let Some(pwd) = pwd.map(PathBuf::from) {
- if pwd.canonicalize().ok().as_ref() == Some(&cwd) {
- cwd = pwd;
- }
- }
- let mut dst = CWD.write().unwrap();
- *dst = Some(cwd.clone());
-
- cwd
-}
-
-/// Update the current working directory.
-pub fn set_current_working_dir(path: impl AsRef<Path>) -> std::io::Result<Option<PathBuf>> {
- let path = crate::path::canonicalize(path);
- std::env::set_current_dir(&path)?;
- let mut cwd = CWD.write().unwrap();
-
- Ok(cwd.replace(path))
-}
-
-/// Checks if the given environment variable is set.
-pub fn env_var_is_set(env_var_name: &str) -> bool {
- std::env::var_os(env_var_name).is_some()
-}
-
-/// Checks if a binary with the given name exists.
-pub fn binary_exists<T: AsRef<OsStr>>(binary_name: T) -> bool {
- which::which(binary_name).is_ok()
-}
-
-/// Attempts to find a binary of the given name. See [which](https://linux.die.net/man/1/which).
-pub fn which<T: AsRef<OsStr>>(
- binary_name: T,
-) -> Result<std::path::PathBuf, ExecutableNotFoundError> {
- let binary_name = binary_name.as_ref();
- which::which(binary_name).map_err(|err| ExecutableNotFoundError {
- command: binary_name.to_string_lossy().into_owned(),
- inner: err,
- })
-}
-
-fn find_brace_end(src: &[u8]) -> Option<usize> {
- use regex_automata::meta::Regex;
-
- static REGEX: Lazy<Regex> = Lazy::new(|| Regex::builder().build("[{}]").unwrap());
- let mut depth = 0;
- for mat in REGEX.find_iter(src) {
- let pos = mat.start();
- match src[pos] {
- b'{' => depth += 1,
- b'}' if depth == 0 => return Some(pos),
- b'}' => depth -= 1,
- _ => unreachable!(),
- }
- }
- None
-}
-
-fn expand_impl(src: &OsStr, mut resolve: impl FnMut(&OsStr) -> Option<OsString>) -> Cow<'_, OsStr> {
- use regex_automata::meta::Regex;
-
- static REGEX: Lazy<Regex> = Lazy::new(|| {
- Regex::builder()
- .build_many(&[
- r"\$\{([^\}:]+):-",
- r"\$\{([^\}:]+):=",
- r"\$\{([^\}-]+)-",
- r"\$\{([^\}=]+)=",
- r"\$\{([^\}]+)",
- r"\$(\w+)",
- ])
- .unwrap()
- });
-
- let bytes = src.as_encoded_bytes();
- let mut res = Vec::with_capacity(bytes.len());
- let mut pos = 0;
- for captures in REGEX.captures_iter(bytes) {
- let mat = captures.get_match().unwrap();
- let pattern_id = mat.pattern().as_usize();
- let mut range = mat.range();
- // A pattern may match multiple times on a single variable, for example `${HOME:-$HOME}`:
- // `${HOME:-` matches and also the default value (`$HOME`). Skip past any variables which
- // have already been expanded.
- if range.start < pos {
- continue;
- }
- let var = &bytes[captures.get_group(1).unwrap().range()];
- let default = if pattern_id != 5 {
- let Some(bracket_pos) = find_brace_end(&bytes[range.end..]) else {
- break;
- };
- let default = &bytes[range.end..range.end + bracket_pos];
- range.end += bracket_pos + 1;
- default
- } else {
- &[]
- };
- // safety: this is a codepoint aligned substring of an osstr (always valid)
- let var = unsafe { OsStr::from_encoded_bytes_unchecked(var) };
- let expansion = resolve(var);
- let expansion = match &expansion {
- Some(val) => {
- if val.is_empty() && pattern_id < 2 {
- default
- } else {
- val.as_encoded_bytes()
- }
- }
- None => default,
- };
- res.extend_from_slice(&bytes[pos..range.start]);
- pos = range.end;
- res.extend_from_slice(expansion);
- }
- if pos == 0 {
- src.into()
- } else {
- res.extend_from_slice(&bytes[pos..]);
- // safety: this is a composition of valid osstr (and codepoint aligned slices which are also valid)
- unsafe { OsString::from_encoded_bytes_unchecked(res) }.into()
- }
-}
-
-/// performs substitution of enviorment variables. Supports the following (POSIX) syntax:
-///
-/// * `$<var>`, `${<var>}`
-/// * `${<var>:-<default>}`, `${<var>-<default>}`
-/// * `${<var>:=<default>}`, `${<var>=default}`
-///
-pub fn expand<S: AsRef<OsStr> + ?Sized>(src: &S) -> Cow<'_, OsStr> {
- expand_impl(src.as_ref(), |var| std::env::var_os(var))
-}
-
-#[derive(Debug)]
-pub struct ExecutableNotFoundError {
- command: String,
- inner: which::Error,
-}
-
-impl std::fmt::Display for ExecutableNotFoundError {
- fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
- write!(f, "command '{}' not found: {}", self.command, self.inner)
- }
-}
-
-impl std::error::Error for ExecutableNotFoundError {}
-
-#[cfg(test)]
-mod tests {
- use std::ffi::{OsStr, OsString};
-
- use super::{current_working_dir, expand_impl, set_current_working_dir};
-
- #[test]
- fn current_dir_is_set() {
- let new_path = dunce::canonicalize(std::env::temp_dir()).unwrap();
- let cwd = current_working_dir();
- assert_ne!(cwd, new_path);
-
- set_current_working_dir(&new_path).expect("Couldn't set new path");
-
- let cwd = current_working_dir();
- assert_eq!(cwd, new_path);
- }
-
- macro_rules! assert_env_expand {
- ($env: expr, $lhs: expr, $rhs: expr) => {
- assert_eq!(&*expand_impl($lhs.as_ref(), $env), OsStr::new($rhs));
- };
- }
-
- /// paths that should work on all platforms
- #[test]
- fn test_env_expand() {
- let env = |var: &OsStr| -> Option<OsString> {
- match var.to_str().unwrap() {
- "FOO" => Some("foo".into()),
- "EMPTY" => Some("".into()),
- _ => None,
- }
- };
- assert_env_expand!(env, "pass_trough", "pass_trough");
- assert_env_expand!(env, "$FOO", "foo");
- assert_env_expand!(env, "bar/$FOO/baz", "bar/foo/baz");
- assert_env_expand!(env, "bar/${FOO}/baz", "bar/foo/baz");
- assert_env_expand!(env, "baz/${BAR:-bar}/foo", "baz/bar/foo");
- assert_env_expand!(env, "baz/${FOO:-$FOO}/foo", "baz/foo/foo");
- assert_env_expand!(env, "baz/${BAR:=bar}/foo", "baz/bar/foo");
- assert_env_expand!(env, "baz/${BAR-bar}/foo", "baz/bar/foo");
- assert_env_expand!(env, "baz/${BAR=bar}/foo", "baz/bar/foo");
- assert_env_expand!(env, "baz/${EMPTY:-bar}/foo", "baz/bar/foo");
- assert_env_expand!(env, "baz/${EMPTY:=bar}/foo", "baz/bar/foo");
- assert_env_expand!(env, "baz/${EMPTY-bar}/foo", "baz//foo");
- assert_env_expand!(env, "baz/${EMPTY=bar}/foo", "baz//foo");
- }
-}