1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
|
[](https://ci.appveyor.com/project/jd-boyd/python-lzo/branch/master)
```
Python-LZO -- Python bindings for LZO
Copyright (c) 1996-2002 Markus F.X.J. Oberhumer
<markus@oberhumer.com>
http://www.oberhumer.com/opensource/lzo/
Copyright (c) 2011-2016 Joshua D. Boyd
<jdboyd@jdboyd.net>
https://github.com/jd-boyd/python-lzo
```
# What is LZO ?
LZO is a portable lossless data compression library written in ANSI C.
It offers pretty fast compression and *very* fast decompression.
Decompression requires no memory.
In addition there are slower compression levels achieving a quite
competitive compression ratio while still decompressing at
this very high speed.
# What is Python-LZO ?
Python-LZO provides Python bindings for LZO, i.e. you can access
the LZO library from your Python scripts thereby compressing ordinary
Python strings.
# Installation
## Ubuntu/Debian Linux
You need the following dependencies installed:
* `zlib1g-dev`
* `liblzo2-dev`
* `python-pip` or `python3-pip`
Then, just `pip install python-lzo`.
## CentOS/Red Hat Enterprise Linux
You need the following dependencies installed:
* `yum install epel-release`
* `yum install python-pip`
* `yum install lzo-devel`
* `yum install lzo-minilzo`
Then, just `pip install python-lzo`.
## macOS
You need XCode installed, or something else that provides suitable C
compiler. Then just:
`pip install python-lzo`
## Windows
There is an issue filed to provide a pre-compiled wheel to greatly
simplify this.
Until then, here we go:
* Download http://www.oberhumer.com/opensource/lzo/download/lzo-2.09.tar.gz
* extract that file to `c:\src\` (should produce `c:\src\lzo-2.09` )
* Install a visual studio compatible with your python build. If you are using
python 2.7, MS has a package just for you at: https://www.microsoft.com/en-us/download/details.aspx?id=44266
Current automated tests are done with Visual Studio 2013, but newer should work as well.
* `python.exe setup.py install`
# Where's the documentation ?
Python-LZO comes with built-in documentation which is accessible
using `lzo.__doc__` and `lzo.func__doc__`. See ["Chapter 3: Data Model"
in the Python Reference Manual](https://docs.python.org/3.6/reference/datamodel.html) for more information.
Additionally you should read the docs and study the example
programs that ship with the LZO library.
# Python 2 support statement
As of 1.15, Python 2.x is unsupported. To continue using Python 2.6 or
Python 2.7, please stick with version 1.14.
# Notes
The Windows version is tested.
It is not currently continuously tested on OSX, but that is coming.
# Releasing
1. Update version in `setup.py` and the `MODULE_VERSION` define in
`lzomodule.c`.
1. Update NEWS.
1. Tag with new release.
1. wheels
1. PyPi
# Copyright
The LZO and Python-LZO algorithms and implementations are
Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002
Markus Franz Xaver Johannes Oberhumer <markus@oberhumer.com>
The Python-LZO algorithms implementated post 2011 are
Copyright (C) 2011, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021,
2022, & 2023
Joshua D. Boyd <jdboyd@jdboyd.net> and others as denoted in the git
history.
The LZO and Python-LZO algorithms and implementations are distributed under
the terms of the GNU General Public License (GPL). See the file COPYING.
|
