@@ -5,7 +5,7 @@ Python Developer's Guide
5
5
.. highlight :: bash
6
6
7
7
This guide is a comprehensive resource for :ref: `contributing <contributing >`
8
- to Python _ -- for both new and experienced contributors. It is
8
+ to Python _ -- for both new and experienced contributors. It is
9
9
:ref: `maintained <helping-with-the-developers-guide >` by the same
10
10
community that maintains Python. We welcome your contributions to Python!
11
11
@@ -89,33 +89,30 @@ contributing to Python:
89
89
Status of Python branches
90
90
-------------------------
91
91
92
- +------------------+--------------+-------------+----------------+----------------+----------------------------------------------------------------------------+
93
- | Branch | Schedule | Status | First release | End-of-life | Comment |
94
- +==================+==============+=============+================+================+============================================================================+
95
- | master | :pep: `569 ` | features | *2019-10-20 * | *2024-10 * | The master branch is currently the future Python 3.8. |
96
- +------------------+--------------+-------------+----------------+----------------+----------------------------------------------------------------------------+
97
- | 3.7 | :pep: `537 ` | bugfix | 2018-06-27 | *2023-06-27 * | `Most recent binary release: Python 3.7.0 |
98
- | | | | | | <https://www.python.org/downloads/release/python-370/>`_ |
99
- +------------------+--------------+-------------+----------------+----------------+----------------------------------------------------------------------------+
100
- | 3.6 | :pep: `494 ` | bugfix | 2016-12-23 | *2021-12-23 * | `Most recent binary release: Python 3.6.6 |
101
- | | | | | | <https://www.python.org/downloads/release/python-366/>`_ |
102
- +------------------+--------------+-------------+----------------+----------------+----------------------------------------------------------------------------+
103
- | 2.7 | :pep: `373 ` | bugfix | 2010-07-03 | *2020-01-01 * | The support has been extended to 2020-01-01. |
104
- | | | | | | `Most recent binary release: Python 2.7.15 |
105
- | | | | | | <https://www.python.org/downloads/release/python-2715/>`_ |
106
- +------------------+--------------+-------------+----------------+----------------+----------------------------------------------------------------------------+
107
- | 3.5 | :pep: `478 ` | security | 2015-09-13 | *2020-09-13 * | `Most recent security release: Python 3.5.5 |
108
- | | | | | | <https://www.python.org/downloads/release/python-355/>`_ |
109
- +------------------+--------------+-------------+----------------+----------------+----------------------------------------------------------------------------+
110
- | 3.4 | :pep: `429 ` | security | 2014-03-16 | *2019-03-16 * | `Most recent security release: Python 3.4.8 |
111
- | | | | | | <https://www.python.org/downloads/release/python-348/>`_ |
112
- +------------------+--------------+-------------+----------------+----------------+----------------------------------------------------------------------------+
92
+ +------------------+--------------+-------------+----------------+----------------+-------------------+
93
+ | Branch | Schedule | Status | First release | End-of-life | Release manager |
94
+ +==================+==============+=============+================+================+===================+
95
+ | master | :pep: `569 ` | features | *2019-10-20 * | *2024-10 * | Łukasz Langa |
96
+ +------------------+--------------+-------------+----------------+----------------+-------------------+
97
+ | 3.7 | :pep: `537 ` | bugfix | 2018-06-27 | *2023-06-27 * | Ned Deily |
98
+ +------------------+--------------+-------------+----------------+----------------+-------------------+
99
+ | 3.6 | :pep: `494 ` | bugfix | 2016-12-23 | *2021-12-23 * | Ned Deily |
100
+ +------------------+--------------+-------------+----------------+----------------+-------------------+
101
+ | 2.7 | :pep: `373 ` | bugfix | 2010-07-03 | *2020-01-01 * | Benjamin Peterson |
102
+ +------------------+--------------+-------------+----------------+----------------+-------------------+
103
+ | 3.5 | :pep: `478 ` | security | 2015-09-13 | *2020-09-13 * | Larry Hastings |
104
+ +------------------+--------------+-------------+----------------+----------------+-------------------+
105
+ | 3.4 | :pep: `429 ` | security | 2014-03-16 | *2019-03-16 * | Larry Hastings |
106
+ +------------------+--------------+-------------+----------------+----------------+-------------------+
107
+
108
+ The master branch is currently the future Python 3.8, and is the only
109
+ branch that accepts new features. The latest release for each Python
110
+ version can be found on the `download page <https://www.python.org/downloads/ >`_.
113
111
114
112
Status:
115
113
116
- :features: new features are only added to the master branch, this branch
117
- accepts any kind of change.
118
- :prerelease: feature fixes, bugfixes and security fixes are accepted for the
114
+ :features: new features, bugfixes, and security fixes are accepted.
115
+ :prerelease: feature fixes, bugfixes, and security fixes are accepted for the
119
116
upcoming feature release.
120
117
:bugfix: bugfixes and security fixes are accepted, new binaries are still
121
118
released.
@@ -125,43 +122,12 @@ Status:
125
122
126
123
Dates in *italic * are scheduled and can be adjusted.
127
124
128
- By default, the end-of-life is scheduled 5 years after the first release. It
129
- can be adjusted by the release manager of each branch. Versions older than 2.7
130
- have reached end-of-life.
131
-
132
- See also :ref: `Security branches <secbranch >`.
133
-
134
- Each release of Python is tagged in the source repo with a tag of the form
135
- ``vX.Y.ZTN ``, where ``X `` is the major version, ``Y `` is the
136
- minor version, ``Z `` is the micro version, ``T `` is the release level
137
- (``a `` for alpha releases, ``b `` for beta, ``rc `` release candidate,
138
- and *null * for final releases), and ``N `` is the release serial number.
139
- Some examples of release tags: ``v3.7.0a1 ``, ``v3.6.3 ``, ``v2.7.14rc1 ``.
140
-
141
- The code base for a release cycle which has reached end-of-life status
142
- is frozen and no longer has a branch in the repo. The final state of
143
- the end-of-lifed branch is recorded as a tag with the same name as the
144
- former branch, e.g. ``3.3 `` or ``2.6 ``. For reference, here are the
145
- most recently end-of-lifed release cycles:
146
-
147
- +------------------+--------------+-------------+----------------+----------------+----------------------------------------------------------------------------+
148
- | Tag | Schedule | Status | First release | End-of-life | Comment |
149
- +==================+==============+=============+================+================+============================================================================+
150
- | 3.3 | :pep: `398 ` | end-of-life | 2012-09-29 | 2017-09-29 | `Final release: Python 3.3.7 |
151
- | | | | | | <https://www.python.org/downloads/release/python-337/>`_ |
152
- +------------------+--------------+-------------+----------------+----------------+----------------------------------------------------------------------------+
153
- | 3.2 | :pep: `392 ` | end-of-life | 2011-02-20 | 2016-02-20 | `Final release: Python 3.2.6 |
154
- | | | | | | <https://www.python.org/downloads/release/python-326/>`_ |
155
- +------------------+--------------+-------------+----------------+----------------+----------------------------------------------------------------------------+
156
- | 3.1 | :pep: `375 ` | end-of-life | 2009-06-27 | 2012-04-09 | `Final release: Python 3.1.5 |
157
- | | | | | | <https://www.python.org/downloads/release/python-315/>`_ |
158
- +------------------+--------------+-------------+----------------+----------------+----------------------------------------------------------------------------+
159
- | 3.0 | :pep: `361 ` | end-of-life | 2008-12-03 | 2009-01-13 | `Final release: Python 3.0.1 |
160
- | | | | | | <https://www.python.org/download/releases/3.0.1/>`_ |
161
- +------------------+--------------+-------------+----------------+----------------+----------------------------------------------------------------------------+
162
- | 2.6 | :pep: `361 ` | end-of-life | 2008-10-01 | 2013-10-29 | `Final release: Python 2.6.9 |
163
- | | | | | | <https://www.python.org/download/releases/2.6.9/>`_ |
164
- +------------------+--------------+-------------+----------------+----------------+----------------------------------------------------------------------------+
125
+ By default, the end-of-life is scheduled 5 years after the first release,
126
+ but can be adjusted by the release manager of each branch. The support for
127
+ Python 2.7 has currently been extended to 2020-01-01. Versions older than
128
+ 2.7 have reached end-of-life.
129
+
130
+ See also the :ref: `devcycle ` page for more information about branches.
165
131
166
132
.. _contributing :
167
133
@@ -210,7 +176,7 @@ Advanced tasks and topics for once you are comfortable:
210
176
See :ref: `how to review a Pull Request <how-to-review-a-pull-request >`.
211
177
* :doc: `fixingissues `
212
178
213
- It is **recommended ** that the above documents be read as needed. New
179
+ It is **recommended ** that the above documents be read as needed. New
214
180
contributors will build understanding of the CPython workflow by reading the
215
181
sections mentioned in this table. You
216
182
can stop where you feel comfortable and begin contributing immediately without
0 commit comments