Metadata-Version: 2.1
Name: setuptools-twine
Version: 0.1.3
Summary: Adds twine_check and twine_upload commands to setuptools.
Home-page: https://github.com/cchurch/setuptools-twine
Author: Nine More Minutes, Inc.
Author-email: chris@ninemoreminutes.com
License: BSD
Project-URL: Documentation, https://github.com/cchurch/setuptools-twine/blob/master/README.rst
Project-URL: Source, https://github.com/cchurch/setuptools-twine
Project-URL: Tracker, https://github.com/cchurch/setuptools-twine/issues
Keywords: setuptools,twine
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Framework :: Setuptools Plugin
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Software Development :: Build Tools
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: setuptools
Requires-Dist: twine

|Build Status| |PyPI Version| |Python Versions| |License|

setuptools-twine
================

This package adds ``twine_check`` and ``twine_upload`` commands to ``setuptools``. These commands are equivalent to running |twine_check|_ or |twine_upload|_, but always operate on the latest source distribution and wheel generated by ``setup.py sdist`` and ``setup.py bdist_wheel``.

Basic Usage
-----------

Install with pip::

  pip install setuptools-twine

If you only want to simply your workflow that currently uses |twine_check|_ or |twine_upload|_, you can invoke the ``setup.py`` commands manually::

  python setup.py twine_check
  python setup.py twine_upload

Note that you no longer need to specify the ``dist/*`` files as with |twine_check|_ or |twine_upload|_; they are determined automatically from the results of the ``sdist`` and ``bdist_wheel`` commands.

Advanced Usage
--------------

If you're a package author or maintainer looking to automate even more, you can add ``setuptools-twine`` as a |setup_requires|_ dependency in your project's ``setup.cfg``::

  [options]
  setup_requires =
      setuptools-twine

Then, create an |alias|_ command to encapsulate multiple ``setup.py`` commands in one::

  [aliases]
  pypi_upload = clean sdist bdist_wheel twine_check twine_upload

Now, you can build, check, and upload with a single command::

  python setup.py pypi_upload

Roadmap
-------

* Allow passing additional options to ``twine_check`` and ``twine_upload`` commands.
* Allow using only source distributions or wheels, instead of both.
* Allow uploading other output formats in addition to source distributions and wheels.

.. |Build Status| image:: https://img.shields.io/github/workflow/status/cchurch/setuptools-twine/test
   :target: https://github.com/cchurch/setuptools-twine/actions?query=workflow%3Atest
.. |PyPI Version| image:: https://img.shields.io/pypi/v/setuptools-twine.svg
   :target: https://pypi.python.org/pypi/setuptools-twine
.. |Python Versions| image:: https://img.shields.io/pypi/pyversions/setuptools-twine.svg
   :target: https://pypi.python.org/pypi/setuptools-twine
.. |License| image:: https://img.shields.io/pypi/l/setuptools-twine.svg
   :target: https://pypi.python.org/pypi/setuptools-twine
.. |twine_check| replace:: ``twine check``
.. _twine_check: https://twine.readthedocs.io/en/latest/#twine-check
.. |twine_upload| replace:: ``twine upload``
.. _twine_upload: https://twine.readthedocs.io/en/latest/#twine-upload
.. |setup_requires| replace:: ``setup_requires``
.. _setup_requires: https://setuptools.readthedocs.io/en/latest/userguide/quickstart.html#dependency-management
.. |alias| replace:: ``alias``
.. _alias: https://setuptools.readthedocs.io/en/latest/userguide/commands.html#alias-define-shortcuts-for-commonly-used-commands
