Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Correct the description of generation thresholds in the gc docs #1030

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 7 commits into from
Jan 15, 2023
Merged

Correct the description of generation thresholds in the gc docs #1030

Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
9ee1693
Correct the description of generation thresholds in the gc docs
pablogsal Jan 14, 2023
5344ff1
Apply suggestions from code review
pablogsal Jan 15, 2023
c4ab481
Update internals/garbage-collector.rst
pablogsal Jan 15, 2023
2f37185
Update internals/garbage-collector.rst
pablogsal Jan 15, 2023
c1efda7
fixup! Update internals/garbage-collector.rst
pablogsal Jan 15, 2023
da72571
fixup! fixup! Update internals/garbage-collector.rst
pablogsal Jan 15, 2023
547b6ea
Update internals/garbage-collector.rst
pablogsal Jan 15, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 10 additions & 4 deletions internals/garbage-collector.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -319,10 +319,15 @@ the same object survives another GC round in this new generation (generation 1)
it will be moved to the last generation (generation 2) where it will be
surveyed the least often.

Generations are collected when the number of objects that they contain reaches some
predefined threshold, which is unique for each generation and is lower the older
the generations are. These thresholds can be examined using the ``gc.get_threshold``
function:
In order to decide when to run, the collector keeps track of the number of object
allocations and deallocations since the last collection. When the number of
allocations minus the number of deallocations exceeds ``threshold_0``,
collection starts. Initially only generation 0 is examined. If generation 0 has
been examined more than ``threshold_1`` times since generation 1 has been
examined, then generation 1 is examined as well. With generation 2,
things are a bit more complicated; see :ref:`gc-oldest-generation` for
more information. These thresholds can be examined using the
:func:`gc.get_threshold` function:

.. code-block:: python

Expand Down Expand Up @@ -369,6 +374,7 @@ specifically in a generation by calling ``gc.collect(generation=NUM)``.
[..., <__main__.MyObj object at 0x7fbcc12a3400>, ...]


.. _gc-oldest-generation:

Collecting the oldest generation
--------------------------------
Expand Down