mirror of
https://github.com/astral-sh/uv.git
synced 2025-11-02 04:48:18 +00:00
Migrate to XDG and Linux strategy for macOS directories (#5806)
This PR moves us to the Linux strategy for our global directories on macOS. We both feel on the team _and_ have received feedback (in Issues and Polls) that the `Application Support` directories are more intended for GUIs, and CLI tools are correct to respect the XDG variables and use the same directory paths on Linux and macOS. Namely, we now use: - `/Users/crmarsh/.local/share/uv/tools` (for tools) - `/Users/crmarsh/.local/share/uv/python` (for Pythons) - `/Users/crmarsh/.cache/uv` (for the cache) The strategy is such that if the `/Users/crmarsh/Library/Application Support/uv` already exists, we keep using it -- same goes for `/Users/crmarsh/Library/Caches/uv`, so **it's entirely backwards compatible**. If you want to force a migration to the new schema, you can run: - `uv cache clean` - `uv tool uninstall --all` - `uv python uninstall --all` Which will clean up the macOS-specific directories, paving the way for the above paths. In other words, once you run those commands, subsequent `uv` operations will automatically use the `~/.cache` and `~/.local` variants. Closes https://github.com/astral-sh/uv/issues/4411. --------- Co-authored-by: Zanie Blue <contact@zanie.dev>
This commit is contained in:
parent
04e3e7ce65
commit
e11bbb539a
9 changed files with 136 additions and 17 deletions
|
|
@ -5,6 +5,7 @@ use std::{
|
|||
};
|
||||
|
||||
use directories::ProjectDirs;
|
||||
use etcetera::BaseStrategy;
|
||||
use fs_err as fs;
|
||||
use tempfile::{tempdir, TempDir};
|
||||
|
||||
|
|
@ -84,8 +85,19 @@ impl StateStore {
|
|||
pub fn from_settings(state_dir: Option<PathBuf>) -> Result<Self, io::Error> {
|
||||
if let Some(state_dir) = state_dir {
|
||||
StateStore::from_path(state_dir)
|
||||
} else if let Some(project_dirs) = ProjectDirs::from("", "", "uv") {
|
||||
StateStore::from_path(project_dirs.data_dir())
|
||||
} else if let Some(data_dir) = ProjectDirs::from("", "", "uv")
|
||||
.map(|dirs| dirs.data_dir().to_path_buf())
|
||||
.filter(|dir| dir.exists())
|
||||
{
|
||||
// If the user has an existing directory at (e.g.) `/Users/user/Library/Application Support/uv`,
|
||||
// respect it for backwards compatibility. Otherwise, prefer the XDG strategy, even on
|
||||
// macOS.
|
||||
StateStore::from_path(data_dir)
|
||||
} else if let Some(data_dir) = etcetera::base_strategy::choose_base_strategy()
|
||||
.ok()
|
||||
.map(|dirs| dirs.data_dir().join("uv"))
|
||||
{
|
||||
StateStore::from_path(data_dir)
|
||||
} else {
|
||||
StateStore::from_path(".uv")
|
||||
}
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue