Add `duration` and `visited` to the `gc.callbacks` and `gc.get_stats()` dicts
@brandtbucher đang làm issue này rồi.
Từ ngày 26/10/2025.
- Ngôn ngữ chính
- Python
- Star
- 77.2k
- Fork
- 35.9k
- Chỉ số merge pull request
- Chỉ số pull request đang chờ
Mô tả
Feature or enhancement
The documentation for gc.callbacks states that its primary use cases are:
Gathering statistics about garbage collection, such as how often various generations are collected, and how long the collection takes.
We can be doing a bit more to serve users of gc.callbacks (and gc.get_stats() too). In particular:
duration: Collection time, which is mentioned above, is something we already have a low-overhead mechanism to measure for use with thegc.DEBUG_STATSflag. It's a bit finnicky to get right in a callback, since they're called in two phases (so the start time has to be stashed away somewhere between calls).visited: The number of visited objects is also extremely useful (collected/visitedgives you the efficiency of your collection). Getting this information from Python is very expensive (sum(len(gc.get_objects(g)) for g in range(gen + 1))), but it's cheap for us to provide from the GC itself.
With these changes, many users can probably get away with just handling stop events, or ditching callbacks entirely and just periodically checking gc.get_stats() instead for aggregates.
I already ran this idea by @nascheme and @markshannon this week. They were supportive of the idea, so I plan on working on this soon.
(Supersedes #140515.)
Linked PRs
- gh-141720
- gh-141814
Hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Đánh giá
Issue này chưa được đánh giá.