REDROOM

Edit File Size: 2.06 KB

/home/godevadmin/public_html/upload_images/home/000~ROOT~000/usr/share/doc/python2-setuptools/releases.txt

Text Base64

===============
Release Process
===============

In order to allow for rapid, predictable releases, Setuptools uses a
mechanical technique for releases, enacted by Travis following a
successful build of a tagged release per
`PyPI deployment <https://docs.travis-ci.com/user/deployment/pypi>`_.

Prior to cutting a release, please check that the CHANGES.rst reflects
the summary of changes since the last release.
Ideally, these changelog entries would have been added
along with the changes, but it's always good to check.
Think about it from the
perspective of a user not involved with the development--what would
that person want to know about what has changed--or from the
perspective of your future self wanting to know when a particular
change landed.

To cut a release, install and run ``bump2version {part}`` where ``part``
is major, minor, or patch based on the scope of the changes in the
release. Then, push the commits to the master branch. If tests pass,
the release will be uploaded to PyPI (from the Python 3.6 tests).

Release Frequency
-----------------

Some have asked why Setuptools is released so frequently. Because Setuptools
uses a mechanical release process, it's very easy to make releases whenever the
code is stable (tests are passing). As a result, the philosophy is to release
early and often.

While some find the frequent releases somewhat surprising, they only empower
the user. Although releases are made frequently, users can choose the frequency
at which they use those releases. If instead Setuptools contributions were only
released in batches, the user would be constrained to only use Setuptools when
those official releases were made. With frequent releases, the user can govern
exactly how often he wishes to update.

Frequent releases also then obviate the need for dev or beta releases in most
cases. Because releases are made early and often, bugs are discovered and
corrected quickly, in many cases before other users have yet to encounter them.

Release Managers
----------------

Additionally, anyone with push access to the master branch has access to cut
releases.

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Name	Size	Perms	Modified	Actions
CHANGES.rst	109.49 KB	lrw-r--r--	2018-03-18 18:41:48	Edit Download recursive recursive
developer-guide.txt	3.93 KB	lrw-r--r--	2018-03-18 18:41:48	Edit Download recursive recursive
development.txt	1.44 KB	lrw-r--r--	2018-03-18 18:41:48	Edit Download recursive recursive
easy_install.txt	73.59 KB	lrw-r--r--	2018-03-18 18:41:48	Edit Download recursive recursive
formats.txt	30.49 KB	lrw-r--r--	2018-03-18 18:41:50	Edit Download recursive recursive
history.txt	1.84 KB	lrw-r--r--	2018-03-18 18:41:50	Edit Download recursive recursive
index.txt	537 B	lrw-r--r--	2018-03-18 18:41:50	Edit Download recursive recursive
pkg_resources.txt	91.38 KB	lrw-r--r--	2018-03-18 18:41:50	Edit Download recursive recursive
python3.txt	3.88 KB	lrw-r--r--	2018-03-18 18:41:50	Edit Download recursive recursive
README.rst	1.39 KB	lrwxr-xr-x	2018-03-18 18:41:48	Edit Download recursive recursive
releases.txt	2.06 KB	lrw-r--r--	2018-03-18 18:41:50	Edit Download recursive recursive
requirements.txt	61 B	lrw-r--r--	2018-03-18 18:41:50	Edit Download recursive recursive
roadmap.txt	167 B	lrw-r--r--	2018-03-18 18:41:50	Edit Download recursive recursive
setuptools.txt	124.95 KB	lrw-r--r--	2018-03-18 18:41:50	Edit Download recursive recursive

Directory Contents