README.rst 2.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869
  1. ==========
  2. python-lz4
  3. ==========
  4. Status
  5. ======
  6. .. image:: https://travis-ci.org/python-lz4/python-lz4.svg?branch=master
  7. :target: https://travis-ci.org/python-lz4/python-lz4
  8. :alt: Build Status
  9. .. image:: https://ci.appveyor.com/api/projects/status/r2qvw9mlfo63lklo/branch/master?svg=true
  10. :target: https://ci.appveyor.com/project/jonathanunderwood/python-lz4
  11. :alt: Build Status Windows
  12. .. image:: https://readthedocs.org/projects/python-lz4/badge/?version=stable
  13. :target: https://readthedocs.org/projects/python-lz4/
  14. :alt: Documentation
  15. .. image:: https://codecov.io/gh/python-lz4/python-lz4/branch/codecov/graph/badge.svg
  16. :target: https://codecov.io/gh/python-lz4/python-lz4
  17. :alt: CodeCov
  18. Introduction
  19. ============
  20. This package provides python bindings for the `LZ4 compression library
  21. <https://lz4.github.io/lz4/>`_.
  22. The bindings provided in this package cover the `frame format
  23. <https://github.com/lz4/lz4/blob/master/doc/lz4_Frame_format.md>`_ and the `block format
  24. <https://github.com/lz4/lz4/blob/dev/doc/lz4_Block_format.md>`_ specifications. The frame
  25. format bindings are the recommended ones to use, as this guarantees
  26. interoperability with other implementations and language bindings.
  27. The API provided by the frame format bindings follows that of the LZMA, zlib,
  28. gzip and bzip2 compression libraries which are provided with the Python standard
  29. library. As such, these LZ4 bindings should provide a drop-in alternative to the
  30. compression libraries shipped with Python. The package provides context managers
  31. and file handler support.
  32. The bindings drop the GIL when calling in to the underlying LZ4 library, and is
  33. thread safe. An extensive test suite is included.
  34. Documenation
  35. ============
  36. .. image:: https://readthedocs.org/projects/python-lz4/badge/?version=stable
  37. :target: https://readthedocs.org/projects/python-lz4/
  38. :alt: Documentation
  39. Full documentation is included with the project. The documentation is
  40. generated using Sphinx. Documentation is also hosted on readthedocs.
  41. :master: http://python-lz4.readthedocs.io/en/stable/
  42. :development: http://python-lz4.readthedocs.io/en/latest/
  43. Homepage
  44. ========
  45. The `project homepage <https://www.github.com/python-lz4/python-lz4>`_ is hosted
  46. on Github. Please report any issues you find using the `issue tracker
  47. <https://github.com/python-lz4/python-lz4/issues>`_.
  48. Licensing
  49. =========
  50. Code specific to this project is covered by the `BSD 3-Clause License
  51. <http://opensource.org/licenses/BSD-3-Clause>`_