sphinx-doc/sphinx

Cannot recover from MemoryErrors

已關閉

#7,635 建立於 2020年5月8日

在 GitHub 查看貢獻者指南
 (2 則留言) (0 個反應) (0 位負責人)Python (1,985 個分叉)batch import
help wantedtype:bug

倉庫指標

星標
 (5,625 顆星)
PR 合併指標
 (平均合併 10天 11小時) (30 天內合併 11 個 PR)

描述

We are using recommonmark with sphinx to parse 2.3k+ md files and experiencing excesive memory usage. Running 64 bit we see a peak of about 19gb of memory usage and an execution time around 30 minutes. On many machines (or running 32 bit) this is not doable. The majority of the markdown files have an rst label, and some of them have references to these labels. Are there configuration options that may be affecting this? Is there a way to review what's actually taking up this memory?

貢獻者指南

研究方向
Investigate memory usage during parsing of many markdown files with recommonmark. Use memory profiler or tracemalloc to identify peak memory allocations. Compare with direct Python memory usage and explore Sphinx's handling of large document sets. Look at recommonmark's parser and Sphinx's build process in sphinx/builders/ for potential optimizations or configuration options to reduce memory footprint.
技術棧
python
領域
documentationperformance
議題類型
錯誤
難度面向新貢獻者的預計實作難度，1 表示很小改動，5 表示專家級工作。
4
預計時間有經驗貢獻者完成調查、實作、測試並準備 pull request 的粗略時間範圍。
超過 1 週
活動狀態議題目前的可參與程度：新鮮、活躍、陳舊、阻塞或等待維護者輸入。
較久未更新
清晰度議題是否清楚說明預期改動、驗收標準和下一步。
需要先調研
前置要求
PythonMemory profilingSphinx internalsCPython debugging
新手友善度1-100 的估計分數，表示該議題對首次貢獻者的友善程度。
10