extract_sections returns sections in a list, which doesn't replicate the sections' hierarchy determined by heading levels. If a bot is supposed to understand the structure of an article, the hierarchy is crucial.
Providing our implementation will reduce the code needed by Pywikibot users.
Requirements:
| Subject | Repo | Branch | Lines +/- | |
|---|---|---|---|---|
| [IMPR] improvement for textlib.extract_sections() function | pywikibot/core | master | +176 -62 |
The stripped name does not contain the equals signs.
The section headers aren't stripped:
import pywikibot
from pywikibot.textlib import extract_sections
from pprint import pprint
s = pywikibot.Site('wikipedia:en')
t ="""'''A''' is a thing.
== History of A ==
Some history...
== Usage of A ==
Some usage...
=== Some details ===
Details of Usage...
[[Category:Things starting with A]]
"""
x = extract_sections(t, s)
pprint(x.sections)
[_Section(title='== History of A ==', content='\nSome history...\n\n'),
_Section(title='== Usage of A ==', content='\nSome usage...\n\n'),
_Section(title='=== Some details ===', content='\nDetails of Usage...\n\n')]
x.sections[0].title
'== History of A =='That's precisely why such a "stripped name" should exist. ("The stripped name does not contain the equals signs." is the description of the feature.)
Change 930899 had a related patch set uploaded (by Xqt; author: Xqt):
[pywikibot/core@master] [IMPR] improvement for textlib.extract_sections() function
Change 930899 merged by jenkins-bot:
[pywikibot/core@master] [IMPR] improvement for textlib.extract_sections() function