DESCRIPTION.rst 2.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778
  1. lxml is a Pythonic, mature binding for the libxml2 and libxslt libraries. It
  2. provides safe and convenient access to these libraries using the ElementTree
  3. API.
  4. It extends the ElementTree API significantly to offer support for XPath,
  5. RelaxNG, XML Schema, XSLT, C14N and much more.
  6. To contact the project, go to the `project home page
  7. <http://lxml.de/>`_ or see our bug tracker at
  8. https://launchpad.net/lxml
  9. In case you want to use the current in-development version of lxml,
  10. you can get it from the github repository at
  11. https://github.com/lxml/lxml . Note that this requires Cython to
  12. build the sources, see the build instructions on the project home
  13. page. To the same end, running ``easy_install lxml==dev`` will
  14. install lxml from
  15. https://github.com/lxml/lxml/tarball/master#egg=lxml-dev if you have
  16. an appropriate version of Cython installed.
  17. After an official release of a new stable series, bug fixes may become
  18. available at
  19. https://github.com/lxml/lxml/tree/lxml-3.8 .
  20. Running ``easy_install lxml==3.8bugfix`` will install
  21. the unreleased branch state from
  22. https://github.com/lxml/lxml/tarball/lxml-3.8#egg=lxml-3.8bugfix
  23. as soon as a maintenance branch has been established. Note that this
  24. requires Cython to be installed at an appropriate version for the build.
  25. 3.8.0 (2017-06-03)
  26. ==================
  27. Features added
  28. --------------
  29. * ``ElementTree.write()`` has a new option ``doctype`` that writes out a
  30. doctype string before the serialisation, in the same way as ``tostring()``.
  31. * GH#220: ``xmlfile`` allows switching output methods at an element level.
  32. Patch by Burak Arslan.
  33. * LP#1595781, GH#240: added a PyCapsule Python API and C-level API for
  34. passing externally generated libxml2 documents into lxml.
  35. * GH#244: error log entries have a new property ``path`` with an XPath
  36. expression (if known, None otherwise) that points to the tree element
  37. responsible for the error. Patch by Bob Kline.
  38. * The namespace prefix mapping that can be used in ElementPath now injects
  39. a default namespace when passing a None prefix.
  40. Bugs fixed
  41. ----------
  42. * GH#238: Character escapes were not hex-encoded in the ``xmlfile`` serialiser.
  43. Patch by matejcik.
  44. * GH#229: fix for externally created XML documents. Patch by Theodore Dubois.
  45. * LP#1665241, GH#228: Form data handling in lxml.html no longer strips the
  46. option values specified in form attributes but only the text values.
  47. Patch by Ashish Kulkarni.
  48. * LP#1551797: revert previous fix for XSLT error logging as it breaks
  49. multi-threaded XSLT processing.
  50. * LP#1673355, GH#233: ``fromstring()`` html5parser failed to parse byte strings.
  51. Other changes
  52. -------------
  53. * The previously undocumented ``docstring`` option in ``ElementTree.write()``
  54. produces a deprecation warning and will eventually be removed.