Struct GlobalOptions 

pub struct GlobalOptions {
    pub required_version: Option<RequiredVersion>,
    pub native_tls: Option<bool>,
    pub offline: Option<bool>,
    pub no_cache: Option<bool>,
    pub cache_dir: Option<PathBuf>,
    pub preview: Option<bool>,
    pub python_preference: Option<PythonPreference>,
    pub python_downloads: Option<PythonDownloads>,
    pub concurrent_downloads: Option<NonZeroUsize>,
    pub concurrent_builds: Option<NonZeroUsize>,
    pub concurrent_installs: Option<NonZeroUsize>,
    pub allow_insecure_host: Option<Vec<TrustedHost>>,
}

Global settings, relevant to all invocations.

Fields

required_version: Option<RequiredVersion>

Enforce a requirement on the version of uv.

If the version of uv does not meet the requirement at runtime, uv will exit with an error.

Accepts a PEP 440 specifier, like ==0.5.0 or >=0.5.0.

native_tls: Option<bool>

Whether to load TLS certificates from the platform’s native certificate store.

By default, uv loads certificates from the bundled webpki-roots crate. The webpki-roots are a reliable set of trust roots from Mozilla, and including them in uv improves portability and performance (especially on macOS).

However, in some cases, you may want to use the platform’s native certificate store, especially if you’re relying on a corporate trust root (e.g., for a mandatory proxy) that’s included in your system’s certificate store.

offline: Option<bool>

Disable network access, relying only on locally cached data and locally available files.

no_cache: Option<bool>

Avoid reading from or writing to the cache, instead using a temporary directory for the duration of the operation.

cache_dir: Option<PathBuf>

Path to the cache directory.

Defaults to $XDG_CACHE_HOME/uv or $HOME/.cache/uv on Linux and macOS, and %LOCALAPPDATA%\uv\cache on Windows.

preview: Option<bool>

Whether to enable experimental, preview features.

python_preference: Option<PythonPreference>

Whether to prefer using Python installations that are already present on the system, or those that are downloaded and installed by uv.

python_downloads: Option<PythonDownloads>

Whether to allow Python downloads.

concurrent_downloads: Option<NonZeroUsize>

The maximum number of in-flight concurrent downloads that uv will perform at any given time.

concurrent_builds: Option<NonZeroUsize>

The maximum number of source distributions that uv will build concurrently at any given time.

Defaults to the number of available CPU cores.

concurrent_installs: Option<NonZeroUsize>

The number of threads used when installing and unzipping packages.

Defaults to the number of available CPU cores.

allow_insecure_host: Option<Vec<TrustedHost>>

Allow insecure connections to host.

Expects to receive either a hostname (e.g., localhost), a host-port pair (e.g., localhost:8080), or a URL (e.g., https://localhost).

WARNING: Hosts included in this list will not be verified against the system’s certificate store. Only use --allow-insecure-host in a secure network with verified sources, as it bypasses SSL verification and could expose you to MITM attacks.

Trait Implementations

impl Clone for GlobalOptions

fn clone(&self) -> GlobalOptions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Combine for GlobalOptions

fn combine(self, other: GlobalOptions) -> GlobalOptions

Combine two values, preferring the values in self.

impl Debug for GlobalOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for GlobalOptions

fn default() -> GlobalOptions

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for GlobalOptions

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl OptionsMetadata for GlobalOptions

fn record(visit: &mut dyn Visit)

Visits the options metadata of this object by calling visit for each option.

fn documentation() -> Option<&'static str>

fn metadata() -> OptionSet

where Self: Sized + 'static,

Returns the extracted metadata.