twine

Upload to PyPI

$ twine upload dist/*

$ twine upload [[-r|--repository]] testpypi dist/*

$ twine upload [[-u|--username]] [username] [[-p|--password]] [password] dist/*

$ twine upload --repository-url [repository_url] dist/*

$ twine check dist/*

$ twine upload --config-file [configuration_file] dist/*

$ twine upload --skip-existing dist/*

$ twine upload --verbose dist/*

twine [OPTIONS] command [ARGS]

upload
    Upload distributions to a repository.

--repository-url
    The repository to use for the upload.

--username
    The username to use for authentication.

--password
    The password to use for authentication.

--cert
    Path to a custom certificate authority bundle.

--client-cert
    Path to a client certificate.

--config-file
    Path to the twine configuration file.

-v, --verbose
    Show verbose output.

-q, --quiet
    Suppress output except warnings and errors.

--version
    Show the version number and exit.

-h, --help
    Show this help message and exit.

Twine is a command-line tool designed to securely publish Python packages to PyPI (Python Package Index) and other PyPI-compatible repositories. It simplifies the process of uploading distributions built with tools like setuptools and wheel.

By default, twine uses HTTPS to encrypt communication. This significantly enhances security compared to older methods. Twine supports verifying uploaded packages with cryptographic signatures for added confidence. It is the recommended tool for uploading packages to PyPI.

Credentials provided via command-line options may be visible in shell history. It's recommended to use a configuration file or environment variables to store credentials.

Twine can be configured using a configuration file, typically located at ~/.pypirc. This file can store repository URLs, usernames, and passwords. This prevents these sensitive credentials from being stored directly on the command line.

Twine was created to address security vulnerabilities in older package uploading methods. It replaced the older 'python setup.py upload' command, which sent credentials in plaintext. Twine encrypts communication, making it much more secure to upload packages. It has become the standard tool for uploading Python packages to PyPI.

python(1)