A Python parser for MediaWiki wikicode https://mwparserfromhell.readthedocs.io/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 

224 lines
10 KiB

  1. v0.6 (unreleased):
  2. - ...
  3. v0.5.4 (released May 15, 2019):
  4. - Fixed an unlikely crash in the C tokenizer when interrupted while parsing
  5. a heading.
  6. v0.5.3 (released March 30, 2019):
  7. - Fixed manual construction of Node objects, previously unsupported. (#214)
  8. - Fixed Wikicode transformation methods (replace(), remove(), etc.) when passed
  9. an empty section as an argument. (#212)
  10. - Fixed the parser getting stuck inside malformed tables. (#206)
  11. v0.5.2 (released November 1, 2018):
  12. - Dropped support for end-of-life Python versions 2.6, 3.2, 3.3. (#199, #204)
  13. - Fixed signals getting stuck inside the C tokenizer until parsing finishes,
  14. in pathological cases. (#206)
  15. - Fixed <wbr> not being considered a single-only tag. (#200)
  16. - Fixed a C tokenizer crash on Python 3.7 when compiled with assertions. (#208)
  17. - Cleaned up some minor documentation issues. (#207)
  18. v0.5.1 (released March 3, 2018):
  19. - Improved behavior when adding parameters to templates (via Template.add())
  20. with poorly formatted whitespace conventions. (#185)
  21. - Fixed the parser getting stuck in deeply nested HTML tags with unclosed,
  22. quoted attributes. (#190)
  23. v0.5 (released June 23, 2017):
  24. - Added Wikicode.contains() to determine whether a Node or Wikicode object is
  25. contained within another Wikicode object.
  26. - Added Wikicode.get_ancestors() and Wikicode.get_parent() to find all
  27. ancestors and the direct parent of a Node, respectively.
  28. - Fixed a long-standing performance issue with deeply nested, invalid syntax
  29. (issue #42). The parser should be much faster on certain complex pages. The
  30. "max cycle" restriction has also been removed, so some situations where
  31. templates at the end of a page were being skipped are now resolved.
  32. - Made Template.remove(keep_field=True) behave more reasonably when the
  33. parameter is already empty.
  34. - Added the keep_template_params argument to Wikicode.strip_code(). If True,
  35. then template parameters will be preserved in the output.
  36. - Wikicode objects can now be pickled properly (fixed infinite recursion error
  37. on incompletely-constructed StringMixIn subclasses).
  38. - Fixed Wikicode.matches()'s behavior on iterables besides lists and tuples.
  39. - Fixed len() sometimes raising ValueError on empty node lists.
  40. - Fixed a rare parsing bug involving self-closing tags inside the attributes of
  41. unpaired tags.
  42. - Fixed release script after changes to PyPI.
  43. v0.4.4 (released December 30, 2016):
  44. - Added support for Python 3.6.
  45. - Fixed parsing bugs involving:
  46. - wikitables nested in templates;
  47. - wikitable error recovery when unable to recurse;
  48. - templates nested in template parameters before other parameters.
  49. - Fixed parsing file-like objects.
  50. - Made builds deterministic.
  51. - Documented caveats.
  52. v0.4.3 (released October 29, 2015):
  53. - Added Windows binaries for Python 3.5.
  54. - Fixed edge cases involving wikilinks inside of external links and vice versa.
  55. - Fixed a C tokenizer crash when a keyboard interrupt happens while parsing.
  56. v0.4.2 (released July 30, 2015):
  57. - Fixed setup script not including header files in releases.
  58. - Fixed Windows binary uploads.
  59. v0.4.1 (released July 30, 2015):
  60. - The process for building Windows binaries has been fixed, and these should be
  61. distributed along with new releases. Windows users can now take advantage of
  62. C speedups without having a compiler of their own.
  63. - Added support for Python 3.5.
  64. - '<' and '>' are now disallowed in wikilink titles and template names. This
  65. includes when denoting tags, but not comments.
  66. - Fixed the behavior of preserve_spacing in Template.add() and keep_field in
  67. Template.remove() on parameters with hidden keys.
  68. - Removed _ListProxy.detach(). SmartLists now use weak references and their
  69. children are garbage-collected properly.
  70. - Fixed parser bugs involving:
  71. - templates with completely blank names;
  72. - templates with newlines and comments.
  73. - Heavy refactoring and fixes to the C tokenizer, including:
  74. - corrected a design flaw in text handling, allowing for substantial speed
  75. improvements when parsing long strings of plain text;
  76. - implemented new Python 3.3 PEP 393 Unicode APIs.
  77. - Fixed various bugs in SmartList, including one that was causing memory issues
  78. on 64-bit builds of Python 2 on Windows.
  79. - Fixed some bugs in the release scripts.
  80. v0.4 (released May 23, 2015):
  81. - The parser now falls back on pure Python mode if C extensions cannot be
  82. built. This fixes an issue that prevented some Windows users from installing
  83. the parser.
  84. - Added support for parsing wikicode tables (patches by David Winegar).
  85. - Added a script to test for memory leaks in scripts/memtest.py.
  86. - Added a script to do releases in scripts/release.sh.
  87. - skip_style_tags can now be passed to mwparserfromhell.parse() (previously,
  88. only Parser().parse() allowed it).
  89. - The 'recursive' argument to Wikicode's filter methods now accepts a third
  90. option, RECURSE_OTHERS, which recurses over all children except instances of
  91. 'forcetype' (for example, `code.filter_templates(code.RECURSE_OTHERS)`
  92. returns all un-nested templates).
  93. - The parser now understands HTML tag attributes quoted with single quotes.
  94. When setting a tag attribute's value, quotes will be added if necessary. As
  95. part of this, Attribute's 'quoted' attribute has been changed to 'quotes',
  96. and is now either a string or None.
  97. - Calling Template.remove() with a Parameter object that is not part of the
  98. template now raises ValueError instead of doing nothing.
  99. - Parameters with non-integer keys can no longer be created with
  100. 'showkey=False', nor have the value of this attribute be set to False later.
  101. - _ListProxy.destroy() has been changed to _ListProxy.detach(), and now works
  102. in a more useful way.
  103. - If something goes wrong while parsing, ParserError will now be raised.
  104. Previously, the parser would produce an unclear BadRoute exception or allow
  105. an incorrect node tree to be build.
  106. - Fixed parser bugs involving:
  107. - nested tags;
  108. - comments in template names;
  109. - tags inside of <nowiki> tags.
  110. - Added tests to ensure that parsed trees convert back to wikicode without
  111. unintentional modifications.
  112. - Added support for a NOWEB environment variable, which disables a unit test
  113. that makes a web call.
  114. - Test coverage has been improved, and some minor related bugs have been fixed.
  115. - Updated and fixed some documentation.
  116. v0.3.3 (released April 22, 2014):
  117. - Added support for Python 2.6 and 3.4.
  118. - Template.has() is now passed 'ignore_empty=False' by default instead of True.
  119. This fixes a bug when adding parameters to templates with empty fields, and
  120. is a breaking change if you rely on the default behavior.
  121. - The 'matches' argument of Wikicode's filter methods now accepts a function
  122. (taking one argument, a Node, and returning a bool) in addition to a regex.
  123. - Re-added 'flat' argument to Wikicode.get_sections(), fixed the order in which
  124. it returns sections, and made it faster.
  125. - Wikicode.matches() now accepts a tuple or list of strings/Wikicode objects
  126. instead of just a single string or Wikicode.
  127. - Given the frequency of issues with the (admittedly insufficient) tag parser,
  128. there's a temporary skip_style_tags argument to parse() that ignores '' and
  129. ''' until these issues are corrected.
  130. - Fixed a parser bug involving nested wikilinks and external links.
  131. - C code cleanup and speed improvements.
  132. v0.3.2 (released September 1, 2013):
  133. - Added support for Python 3.2 (along with current support for 3.3 and 2.7).
  134. - Renamed Template.remove()'s first argument from 'name' to 'param', which now
  135. accepts Parameter objects in addition to parameter name strings.
  136. v0.3.1 (released August 29, 2013):
  137. - Fixed a parser bug involving URLs nested inside other markup.
  138. - Fixed some typos.
  139. v0.3 (released August 24, 2013):
  140. - Added complete support for HTML Tags, including forms like <ref>foo</ref>,
  141. <ref name="bar"/>, and wiki-markup tags like bold ('''), italics (''), and
  142. lists (*, #, ; and :).
  143. - Added support for ExternalLinks (http://example.com/ and
  144. [http://example.com/ Example]).
  145. - Wikicode's filter methods are now passed 'recursive=True' by default instead
  146. of False. This is a breaking change if you rely on any filter() methods being
  147. non-recursive by default.
  148. - Added a matches() method to Wikicode for page/template name comparisons.
  149. - The 'obj' param of Wikicode.insert_before(), insert_after(), replace(), and
  150. remove() now accepts other Wikicode objects and strings representing parts of
  151. wikitext, instead of just nodes. These methods also make all possible
  152. substitutions instead of just one.
  153. - Renamed Template.has_param() to has() for consistency with Template's other
  154. methods; has_param() is now an alias.
  155. - The C tokenizer extension now works on Python 3 in addition to Python 2.7.
  156. - Various bugfixes, internal changes, and cleanup.
  157. v0.2 (released June 20, 2013):
  158. - The parser now fully supports Python 3 in addition to Python 2.7.
  159. - Added a C tokenizer extension that is significantly faster than its Python
  160. equivalent. It is enabled by default (if available) and can be toggled by
  161. setting `mwparserfromhell.parser.use_c` to a boolean value.
  162. - Added a complete set of unit tests covering parsing and wikicode
  163. manipulation.
  164. - Renamed Wikicode.filter_links() to filter_wikilinks() (applies to ifilter as
  165. well).
  166. - Added filter methods for Arguments, Comments, Headings, and HTMLEntities.
  167. - Added 'before' param to Template.add(); renamed 'force_nonconformity' to
  168. 'preserve_spacing'.
  169. - Added 'include_lead' param to Wikicode.get_sections().
  170. - Removed 'flat' param from Wikicode.get_sections().
  171. - Removed 'force_no_field' param from Template.remove().
  172. - Added support for Travis CI.
  173. - Added note about Windows build issue in the README.
  174. - The tokenizer will limit itself to a realistic recursion depth to prevent
  175. errors and unreasonably long parse times.
  176. - Fixed how some nodes' attribute setters handle input.
  177. - Fixed multiple bugs in the tokenizer's handling of invalid markup.
  178. - Fixed bugs in the implementation of SmartList and StringMixIn.
  179. - Fixed some broken example code in the README; other copyedits.
  180. - Other bugfixes and code cleanup.
  181. v0.1.1 (released September 21, 2012):
  182. - Added support for Comments (<!-- foo -->) and Wikilinks ([[foo]]).
  183. - Added corresponding ifilter_links() and filter_links() methods to Wikicode.
  184. - Fixed a bug when parsing incomplete templates.
  185. - Fixed strip_code() to affect the contents of headings.
  186. - Various copyedits in documentation and comments.
  187. v0.1 (released August 23, 2012):
  188. - Initial release.