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
|
.. image:: https://travis-ci.org/Changaco/python-libarchive-c.svg
:target: https://travis-ci.org/Changaco/python-libarchive-c
A Python interface to libarchive. It uses the standard ctypes_ module to
dynamically load and access the C library.
.. _ctypes: https://docs.python.org/3/library/ctypes.html
Installation
============
pip install libarchive-c
python-libarchive-c is compatible with python 2 and 3.
Usage
=====
Import::
import libarchive
To extract an archive to the current directory::
libarchive.extract_file('test.zip')
``extract_memory`` extracts from a buffer instead, and ``extract_fd`` extracts
from a file descriptor.
To read an archive::
with libarchive.file_reader('test.7z') as archive:
for entry in archive:
for block in entry.get_blocks():
...
``memory_reader`` reads from a memory buffer instead, and ``fd_reader`` reads
from a file descriptor.
To create an archive::
with libarchive.file_writer('test.tar.gz', 'ustar', 'gzip') as archive:
archive.add_files('libarchive/', 'README.rst')
``memory_writer`` writes to a memory buffer instead, ``fd_writer`` writes to a
file descriptor, and ``custom_writer`` sends the data to a callback function.
You can also find more thorough examples in the ``tests/`` directory.
License
=======
LGPLv2 (or any later version)
|
