forked from python/cpython
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'main' into imaginary-class-109218
- Loading branch information
Showing
173 changed files
with
5,694 additions
and
3,264 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -8,13 +8,14 @@ on: | |
| required: false | ||
| type: boolean | ||
| default: false | ||
| os-matrix: | ||
| required: false | ||
| os: | ||
| description: OS to run the job | ||
| required: true | ||
| type: string | ||
|
|
||
| jobs: | ||
| build_macos: | ||
| name: build and test (${{ matrix.os }}) | ||
| name: build and test (${{ inputs.os }}) | ||
| timeout-minutes: 60 | ||
| env: | ||
| HOMEBREW_NO_ANALYTICS: 1 | ||
|
|
@@ -23,18 +24,7 @@ jobs: | |
| HOMEBREW_NO_INSTALLED_DEPENDENTS_CHECK: 1 | ||
| PYTHONSTRICTEXTENSIONBUILD: 1 | ||
| TERM: linux | ||
| strategy: | ||
| fail-fast: false | ||
| matrix: | ||
| os: ${{fromJson(inputs.os-matrix)}} | ||
| is-fork: | ||
| - ${{ github.repository_owner != 'python' }} | ||
| exclude: | ||
| - os: "ghcr.io/cirruslabs/macos-runner:sonoma" | ||
| is-fork: true | ||
| - os: "macos-14" | ||
| is-fork: false | ||
| runs-on: ${{ matrix.os }} | ||
| runs-on: ${{ inputs.os }} | ||
| steps: | ||
| - uses: actions/checkout@v4 | ||
| - name: Runner image version | ||
|
|
@@ -43,7 +33,7 @@ jobs: | |
| uses: actions/cache@v4 | ||
| with: | ||
| path: config.cache | ||
| key: ${{ github.job }}-${{ matrix.os }}-${{ env.IMAGE_VERSION }}-${{ inputs.config_hash }} | ||
| key: ${{ github.job }}-${{ inputs.os }}-${{ env.IMAGE_VERSION }}-${{ inputs.config_hash }} | ||
| - name: Install Homebrew dependencies | ||
| run: brew install pkg-config [email protected] xz gdbm tcl-tk | ||
| - name: Configure CPython | ||
|
|
||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -16,21 +16,16 @@ Documentation bugs | |
| ================== | ||
|
|
||
| If you find a bug in this documentation or would like to propose an improvement, | ||
| please submit a bug report on the :ref:`tracker <using-the-tracker>`. If you | ||
| please submit a bug report on the :ref:`issue tracker <using-the-tracker>`. If you | ||
| have a suggestion on how to fix it, include that as well. | ||
|
|
||
| You can also open a discussion item on our | ||
| `Documentation Discourse forum <https://discuss.python.org/c/documentation/26>`_. | ||
|
|
||
| If you find a bug in the theme (HTML / CSS / JavaScript) of the | ||
| documentation, please submit a bug report on the `python-doc-theme bug | ||
| documentation, please submit a bug report on the `python-doc-theme issue | ||
| tracker <https://github.com/python/python-docs-theme>`_. | ||
|
|
||
| If you're short on time, you can also email documentation bug reports to | ||
| [email protected] (behavioral bugs can be sent to [email protected]). | ||
| 'docs@' is a mailing list run by volunteers; your request will be noticed, | ||
| though it may take a while to be processed. | ||
|
|
||
| .. seealso:: | ||
|
|
||
| `Documentation bugs`_ | ||
|
|
||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -14,6 +14,7 @@ | |
| installing/index.rst | ||
| howto/index.rst | ||
| faq/index.rst | ||
| deprecations/index.rst | ||
| glossary.rst | ||
|
|
||
| about.rst | ||
|
|
||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,46 @@ | ||
| Pending Removal in Python 3.14 | ||
| ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | ||
|
|
||
| * The ``ma_version_tag`` field in :c:type:`PyDictObject` for extension modules | ||
| (:pep:`699`; :gh:`101193`). | ||
|
|
||
| * Creating :c:data:`immutable types <Py_TPFLAGS_IMMUTABLETYPE>` with mutable | ||
| bases (:gh:`95388`). | ||
|
|
||
| * Functions to configure Python's initialization, deprecated in Python 3.11: | ||
|
|
||
| * ``PySys_SetArgvEx()``: set :c:member:`PyConfig.argv` instead. | ||
| * ``PySys_SetArgv()``: set :c:member:`PyConfig.argv` instead. | ||
| * ``Py_SetProgramName()``: set :c:member:`PyConfig.program_name` instead. | ||
| * ``Py_SetPythonHome()``: set :c:member:`PyConfig.home` instead. | ||
|
|
||
| The :c:func:`Py_InitializeFromConfig` API should be used with | ||
| :c:type:`PyConfig` instead. | ||
|
|
||
| * Global configuration variables: | ||
|
|
||
| * :c:var:`Py_DebugFlag`: use :c:member:`PyConfig.parser_debug` instead. | ||
| * :c:var:`Py_VerboseFlag`: use :c:member:`PyConfig.verbose` instead. | ||
| * :c:var:`Py_QuietFlag`: use :c:member:`PyConfig.quiet` instead. | ||
| * :c:var:`Py_InteractiveFlag`: use :c:member:`PyConfig.interactive` instead. | ||
| * :c:var:`Py_InspectFlag`: use :c:member:`PyConfig.inspect` instead. | ||
| * :c:var:`Py_OptimizeFlag`: use :c:member:`PyConfig.optimization_level` instead. | ||
| * :c:var:`Py_NoSiteFlag`: use :c:member:`PyConfig.site_import` instead. | ||
| * :c:var:`Py_BytesWarningFlag`: use :c:member:`PyConfig.bytes_warning` instead. | ||
| * :c:var:`Py_FrozenFlag`: use :c:member:`PyConfig.pathconfig_warnings` instead. | ||
| * :c:var:`Py_IgnoreEnvironmentFlag`: use :c:member:`PyConfig.use_environment` instead. | ||
| * :c:var:`Py_DontWriteBytecodeFlag`: use :c:member:`PyConfig.write_bytecode` instead. | ||
| * :c:var:`Py_NoUserSiteDirectory`: use :c:member:`PyConfig.user_site_directory` instead. | ||
| * :c:var:`Py_UnbufferedStdioFlag`: use :c:member:`PyConfig.buffered_stdio` instead. | ||
| * :c:var:`Py_HashRandomizationFlag`: use :c:member:`PyConfig.use_hash_seed` | ||
| and :c:member:`PyConfig.hash_seed` instead. | ||
| * :c:var:`Py_IsolatedFlag`: use :c:member:`PyConfig.isolated` instead. | ||
| * :c:var:`Py_LegacyWindowsFSEncodingFlag`: use :c:member:`PyPreConfig.legacy_windows_fs_encoding` instead. | ||
| * :c:var:`Py_LegacyWindowsStdioFlag`: use :c:member:`PyConfig.legacy_windows_stdio` instead. | ||
| * :c:var:`!Py_FileSystemDefaultEncoding`: use :c:member:`PyConfig.filesystem_encoding` instead. | ||
| * :c:var:`!Py_HasFileSystemDefaultEncoding`: use :c:member:`PyConfig.filesystem_encoding` instead. | ||
| * :c:var:`!Py_FileSystemDefaultEncodeErrors`: use :c:member:`PyConfig.filesystem_errors` instead. | ||
| * :c:var:`!Py_UTF8Mode`: use :c:member:`PyPreConfig.utf8_mode` instead. (see :c:func:`Py_PreInitialize`) | ||
|
|
||
| The :c:func:`Py_InitializeFromConfig` API should be used with | ||
| :c:type:`PyConfig` instead. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,20 @@ | ||
| Pending Removal in Python 3.15 | ||
| ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | ||
|
|
||
| * The bundled copy of ``libmpdecimal``. | ||
| * :c:func:`PyImport_ImportModuleNoBlock`: use :c:func:`PyImport_ImportModule` instead. | ||
| * :c:func:`PyWeakref_GET_OBJECT`: use :c:func:`PyWeakref_GetRef` instead. | ||
| * :c:func:`PyWeakref_GetObject`: use :c:func:`PyWeakref_GetRef` instead. | ||
| * :c:type:`!Py_UNICODE_WIDE` type: use :c:type:`wchar_t` instead. | ||
| * :c:type:`Py_UNICODE` type: use :c:type:`wchar_t` instead. | ||
| * Python initialization functions: | ||
|
|
||
| * :c:func:`PySys_ResetWarnOptions`: clear :data:`sys.warnoptions` and | ||
| :data:`!warnings.filters` instead. | ||
| * :c:func:`Py_GetExecPrefix`: get :data:`sys.exec_prefix` instead. | ||
| * :c:func:`Py_GetPath`: get :data:`sys.path` instead. | ||
| * :c:func:`Py_GetPrefix`: get :data:`sys.prefix` instead. | ||
| * :c:func:`Py_GetProgramFullPath`: get :data:`sys.executable` instead. | ||
| * :c:func:`Py_GetProgramName`: get :data:`sys.executable` instead. | ||
| * :c:func:`Py_GetPythonHome`: get :c:member:`PyConfig.home` or | ||
| the :envvar:`PYTHONHOME` environment variable instead. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,31 @@ | ||
| Pending Removal in Future Versions | ||
| ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ | ||
|
|
||
| The following APIs are deprecated and will be removed, | ||
| although there is currently no date scheduled for their removal. | ||
|
|
||
| * :c:macro:`Py_TPFLAGS_HAVE_FINALIZE`: unneeded since Python 3.8. | ||
| * :c:func:`PyErr_Fetch`: use :c:func:`PyErr_GetRaisedException` instead. | ||
| * :c:func:`PyErr_NormalizeException`: use :c:func:`PyErr_GetRaisedException` instead. | ||
| * :c:func:`PyErr_Restore`: use :c:func:`PyErr_SetRaisedException` instead. | ||
| * :c:func:`PyModule_GetFilename`: use :c:func:`PyModule_GetFilenameObject` instead. | ||
| * :c:func:`PyOS_AfterFork`: use :c:func:`PyOS_AfterFork_Child` instead. | ||
| * :c:func:`PySlice_GetIndicesEx`: use :c:func:`PySlice_Unpack` and :c:func:`PySlice_AdjustIndices` instead. | ||
| * :c:func:`!PyUnicode_AsDecodedObject`: use :c:func:`PyCodec_Decode` instead. | ||
| * :c:func:`!PyUnicode_AsDecodedUnicode`: use :c:func:`PyCodec_Decode` instead. | ||
| * :c:func:`!PyUnicode_AsEncodedObject`: use :c:func:`PyCodec_Encode` instead. | ||
| * :c:func:`!PyUnicode_AsEncodedUnicode`: use :c:func:`PyCodec_Encode` instead. | ||
| * :c:func:`PyUnicode_READY`: unneeded since Python 3.12 | ||
| * :c:func:`!PyErr_Display`: use :c:func:`PyErr_DisplayException` instead. | ||
| * :c:func:`!_PyErr_ChainExceptions`: use ``_PyErr_ChainExceptions1`` instead. | ||
| * :c:member:`!PyBytesObject.ob_shash` member: | ||
| call :c:func:`PyObject_Hash` instead. | ||
| * :c:member:`!PyDictObject.ma_version_tag` member. | ||
| * Thread Local Storage (TLS) API: | ||
|
|
||
| * :c:func:`PyThread_create_key`: use :c:func:`PyThread_tss_alloc` instead. | ||
| * :c:func:`PyThread_delete_key`: use :c:func:`PyThread_tss_free` instead. | ||
| * :c:func:`PyThread_set_key_value`: use :c:func:`PyThread_tss_set` instead. | ||
| * :c:func:`PyThread_get_key_value`: use :c:func:`PyThread_tss_get` instead. | ||
| * :c:func:`PyThread_delete_key_value`: use :c:func:`PyThread_tss_delete` instead. | ||
| * :c:func:`PyThread_ReInitTLS`: unneeded since Python 3.7. |
Oops, something went wrong.