Struct GlobalArgs 

pub struct GlobalArgs {

    pub python_preference: Option<PythonPreference>,
    pub managed_python: bool,
    pub no_managed_python: bool,
    pub allow_python_downloads: bool,
    pub no_python_downloads: bool,
    pub python_fetch: Option<PythonDownloads>,
    pub quiet: u8,
    pub verbose: u8,
    pub no_color: bool,
    pub color: Option<ColorChoice>,
    pub native_tls: bool,
    pub no_native_tls: bool,
    pub offline: bool,
    pub no_offline: bool,
    pub allow_insecure_host: Option<Vec<Maybe<TrustedHost>>>,
    pub preview: bool,
    pub no_preview: bool,
    pub preview_features: Vec<PreviewFeatures>,
    pub isolated: bool,
    pub show_settings: bool,
    pub no_progress: bool,
    pub no_installer_metadata: bool,
    pub directory: Option<PathBuf>,
    pub project: Option<PathBuf>,
}

Fields

python_preference: Option<PythonPreference>

managed_python: bool

Require use of uv-managed Python versions.

By default, uv prefers using Python versions it manages. However, it will use system Python versions if a uv-managed Python is not installed. This option disables use of system Python versions.

no_managed_python: bool

Disable use of uv-managed Python versions.

Instead, uv will search for a suitable Python version on the system.

allow_python_downloads: bool

Allow automatically downloading Python when required. [env: “UV_PYTHON_DOWNLOADS=auto”]

no_python_downloads: bool

Disable automatic downloads of Python. [env: “UV_PYTHON_DOWNLOADS=never”]

python_fetch: Option<PythonDownloads>

Deprecated version of [Self::python_downloads].

quiet: u8

Use quiet output.

Repeating this option, e.g., -qq, will enable a silent mode in which uv will write no output to stdout.

verbose: u8

Use verbose output.

You can configure fine-grained logging using the RUST_LOG environment variable. (https://docs.rs/tracing-subscriber/latest/tracing_subscriber/filter/struct.EnvFilter.html#directives)

no_color: bool

Disable colors.

Provided for compatibility with pip, use --color instead.

color: Option<ColorChoice>

Control the use of color in output.

By default, uv will automatically detect support for colors when writing to a terminal.

native_tls: 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.

no_native_tls: bool

offline: bool

Disable network access.

When disabled, uv will only use locally cached data and locally available files.

no_offline: bool

allow_insecure_host: Option<Vec<Maybe<TrustedHost>>>

Allow insecure connections to a host.

Can be provided multiple times.

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.

preview: bool

Whether to enable all experimental preview features.

Preview features may change without warning.

no_preview: bool

preview_features: Vec<PreviewFeatures>

Enable experimental preview features.

Preview features may change without warning.

Use comma-separated values or pass multiple times to enable multiple features.

The following features are available: python-install-default, python-upgrade, json-output, pylock, add-bounds.

isolated: bool

Avoid discovering a pyproject.toml or uv.toml file.

Normally, configuration files are discovered in the current directory, parent directories, or user configuration directories.

This option is deprecated in favor of --no-config.

show_settings: bool

Show the resolved settings for the current command.

This option is used for debugging and development purposes.

no_progress: bool

Hide all progress outputs.

For example, spinners or progress bars.

no_installer_metadata: bool

Skip writing uv installer metadata files (e.g., INSTALLER, REQUESTED, and direct_url.json) to site-packages .dist-info directories.

directory: Option<PathBuf>

Change to the given directory prior to running the command.

Relative paths are resolved with the given directory as the base.

See --project to only change the project root directory.

project: Option<PathBuf>

Discover a project in the given directory.

All pyproject.toml, uv.toml, and .python-version files will be discovered by walking up the directory tree from the project root, as will the project’s virtual environment (.venv).

Other command-line arguments (such as relative paths) will be resolved relative to the current working directory.

See --directory to change the working directory entirely.

This setting has no effect when used in the uv pip interface.

Trait Implementations

impl Args for GlobalArgs

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

impl Clone for GlobalArgs

fn clone(&self) -> GlobalArgs

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl CommandFactory for GlobalArgs

fn command<'b>() -> Command

Build a Command that can instantiate Self.

fn command_for_update<'b>() -> Command

Build a Command that can update self.

impl Debug for GlobalArgs

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

Formats the value using the given formatter.

impl FromArgMatches for GlobalArgs

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Parser for GlobalArgs

fn parse() -> Self

Parse from std::env::args_os(), exit on error.

fn try_parse() -> Result<Self, Error>

Parse from std::env::args_os(), return Err on error.

fn parse_from<I, T>(itr: I) -> Self

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, exit on error.

fn try_parse_from<I, T>(itr: I) -> Result<Self, Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, return Err on error.

fn update_from<I, T>(&mut self, itr: I)

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, exit on error.

fn try_update_from<I, T>(&mut self, itr: I) -> Result<(), Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, return Err on error.