Struct PublishArgs 

pub struct PublishArgs {
    pub files: Vec<String>,
    pub index: Option<String>,
    pub username: Option<String>,
    pub password: Option<String>,
    pub token: Option<String>,
    pub trusted_publishing: Option<TrustedPublishing>,
    pub keyring_provider: Option<KeyringProviderType>,
    pub publish_url: Option<DisplaySafeUrl>,
    pub check_url: Option<IndexUrl>,
    pub skip_existing: bool,
    pub dry_run: bool,
    pub no_attestations: bool,
}

Fields

files: Vec<String>

Paths to the files to upload. Accepts glob expressions.

Defaults to the dist directory. Selects only wheels and source distributions and their attestations, while ignoring other files.

index: Option<String>

The name of an index in the configuration to use for publishing.

The index must have a publish-url setting, for example:

[[tool.uv.index]]
name = "pypi"
url = "https://pypi.org/simple"
publish-url = "https://upload.pypi.org/legacy/"

The index url will be used to check for existing files to skip duplicate uploads.

With these settings, the following two calls are equivalent:

uv publish --index pypi
uv publish --publish-url https://upload.pypi.org/legacy/ --check-url https://pypi.org/simple

username: Option<String>

The username for the upload.

password: Option<String>

The password for the upload.

token: Option<String>

The token for the upload.

Using a token is equivalent to passing __token__ as --username and the token as --password password.

trusted_publishing: Option<TrustedPublishing>

Configure trusted publishing.

By default, uv checks for trusted publishing when running in a supported environment, but ignores it if it isn’t configured.

uv’s supported environments for trusted publishing include GitHub Actions and GitLab CI/CD.

keyring_provider: Option<KeyringProviderType>

Attempt to use keyring for authentication for remote requirements files.

At present, only --keyring-provider subprocess is supported, which configures uv to use the keyring CLI to handle authentication.

Defaults to disabled.

publish_url: Option<DisplaySafeUrl>

The URL of the upload endpoint (not the index URL).

Note that there are typically different URLs for index access (e.g., https:://.../simple) and index upload.

Defaults to PyPI’s publish URL (https://upload.pypi.org/legacy/).

check_url: Option<IndexUrl>

Check an index URL for existing files to skip duplicate uploads.

This option allows retrying publishing that failed after only some, but not all files have been uploaded, and handles errors due to parallel uploads of the same file.

Before uploading, the index is checked. If the exact same file already exists in the index, the file will not be uploaded. If an error occurred during the upload, the index is checked again, to handle cases where the identical file was uploaded twice in parallel.

The exact behavior will vary based on the index. When uploading to PyPI, uploading the same file succeeds even without --check-url, while most other indexes error. When uploading to pyx, the index URL can be inferred automatically from the publish URL.

The index must provide one of the supported hashes (SHA-256, SHA-384, or SHA-512).

skip_existing: bool

dry_run: bool

Perform a dry run without uploading files.

When enabled, the command will check for existing files if --check-url is provided, and will perform validation against the index if supported, but will not upload any files.

no_attestations: bool

Do not upload attestations for the published files.

By default, uv attempts to upload matching PEP 740 attestations with each distribution that is published.

Trait Implementations

impl Args for PublishArgs

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 Debug for PublishArgs

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

Formats the value using the given formatter.

impl FromArgMatches for PublishArgs

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.