Lines Matching +full:build +full:- +full:with +full:- +full:python
1 This is Python version 3.11.13
4 .. image:: https://github.com/python/cpython/workflows/Tests/badge.svg
5 :alt: CPython build status on GitHub Actions
6 :target: https://github.com/python/cpython/actions
8 .. image:: https://dev.azure.com/python/cpython/_apis/build/status/Azure%20Pipelines%20CI?branchNam…
9 :alt: CPython build status on Azure DevOps
10 :target: https://dev.azure.com/python/cpython/_build/latest?definitionId=4&branchName=main
12 .. image:: https://img.shields.io/badge/discourse-join_chat-brightgreen.svg
13 :alt: Python Discourse chat
14 :target: https://discuss.python.org/
17 Copyright © 2001-2023 Python Software Foundation. All rights reserved.
24 -------------------
26 - Website: https://www.python.org
27 - Source code: https://github.com/python/cpython
28 - Issue tracker: https://github.com/python/cpython/issues
29 - Documentation: https://docs.python.org
30 - Developer's Guide: https://devguide.python.org/
33 -----------------------
38 .. _Developer Guide: https://devguide.python.org/
40 Using Python
41 ------------
43 Installable Python kits, and information about using Python, are available at
44 `python.org`_.
46 .. _python.org: https://www.python.org/
48 Build Instructions
49 ------------------
58 This will install Python as ``python3``.
60 You can pass many options to the configure script; run ``./configure --help``
61 to find out more. On macOS case-insensitive file systems and on Cygwin,
62 the executable is called ``python.exe``; elsewhere it's just ``python``.
64 Building a complete Python installation requires the use of various
65 additional third-party libraries, depending on your build platform and
68 `Install dependencies <https://devguide.python.org/getting-started/setup-building.html#build-depend…
72 On macOS, there are additional configure and build options related
74 <https://github.com/python/cpython/blob/main/Mac/README.rst>`_.
77 <https://github.com/python/cpython/blob/main/PCbuild/readme.txt>`_.
84 ../configure --with-pydebug
88 (This will fail if you *also* built at the top-level directory. You should do
89 a ``make clean`` at the top-level first.)
91 To get an optimized build of Python, ``configure --enable-optimizations``
93 Profile Guided Optimization (PGO) and may be used to auto-enable Link Time
101 either via ``configure --enable-optimizations`` or by manually running
102 ``make profile-opt`` regardless of configure flags, the optimized build
105 The entire Python directory is cleaned of temporary files that may have
110 binary resulting from this step is not good for real-life workloads as it has
118 The final step is to build the actual interpreter, using the information
119 collected from the instrumented one. The end result will be a Python binary
126 Enabled via configure's ``--with-lto`` flag. LTO takes advantage of the
133 ----------
135 We have a comprehensive overview of the changes in the `What's New in Python
136 3.11 <https://docs.python.org/3.11/whatsnew/3.11.html>`_ document. For a more
138 <https://github.com/python/cpython/tree/main/Misc/NEWS.d>`_, but a full
140 <https://github.com/python/cpython/commits/main>`_.
142 If you want to install multiple versions of Python, see the section below
147 -------------
149 `Documentation for Python 3.11 <https://docs.python.org/3.11/>`_ is online,
154 is primarily for documentation authors, translators, and people with special
157 For information about building Python's documentation, refer to `Doc/README.rst
158 <https://github.com/python/cpython/blob/main/Doc/README.rst>`_.
161 Converting From Python 2.x to 3.x
162 ---------------------------------
164 Significant backward incompatible changes were made for the release of Python
165 3.0, which may cause programs written for Python 2 to fail when run with Python
166 3. For more information about porting your code from Python 2 to Python 3, see
167 the `Porting HOWTO <https://docs.python.org/3/howto/pyporting.html>`_.
171 -------
173 To test the interpreter, type ``make test`` in the top-level directory. The
182 If any tests fail, you can re-run the failing test(s) in verbose mode. For
185 make test TESTOPTS="-v test_os test_gdb"
187 If the failure persists and appears to be a problem with Python rather than
189 <https://github.com/python/cpython/issues>`_ and include relevant output from
192 See `Running & Writing Tests <https://devguide.python.org/testing/run-write-tests.html>`_
196 ----------------------------
198 On Unix and Mac systems if you intend to install multiple versions of Python
199 using the same installation prefix (``--prefix`` argument to the configure
200 script) you must take care that your primary python executable is not
203 version and can thus live side-by-side. ``make install`` also creates
209 For example, if you want to install Python 2.7, 3.6, and 3.11 with 3.11 being the
210 primary version, you would execute ``make install`` in your 3.11 build directory
215 ------------------------------
218 <https://github.com/python/cpython/issues>`_, and/or `submit pull requests
219 <https://github.com/python/cpython/pulls>`_.
221 You can also follow development discussion on the `python-dev mailing list
222 <https://mail.python.org/mailman/listinfo/python-dev/>`_.
226 -------------------------
228 If you have a proposal to change Python, you may want to send an email to the
229 `comp.lang.python`_ or `python-ideas`_ mailing lists for initial feedback. A
230 Python Enhancement Proposal (PEP) may be submitted if your idea gains ground.
232 `peps.python.org <https://peps.python.org/>`_.
234 .. _python-ideas: https://mail.python.org/mailman/listinfo/python-ideas/
235 .. _comp.lang.python: https://mail.python.org/mailman/listinfo/python-list
239 ----------------
241 See :pep:`664` for Python 3.11 release details.
245 ---------------------------------
248 Copyright © 2001-2023 Python Software Foundation. All rights reserved.
252 Copyright © 1995-2001 Corporation for National Research Initiatives. All
255 Copyright © 1991-1995 Stichting Mathematisch Centrum. All rights reserved.
257 See the `LICENSE <https://github.com/python/cpython/blob/main/LICENSE>`_ for
261 This Python distribution contains *no* GNU General Public License (GPL) code,