Fast iteration of AVRO files
Project description
fastavro
The current Python avro package is packed with features but dog slow.
On a test case of about 10K records, it takes about 14sec to iterate over all of them. In comparison the JAVA avro SDK does it in about 1.9sec.
fastavro is less feature complete than avro, however it’s much faster. It iterates over the same 10K records in 2.9sec, and if you use it with PyPy it’ll do it in 1.5sec (to be fair, the JAVA benchmark is doing some extra JSON encoding/decoding).
If the optional C extension (generated by Cython) is available, then fastavro will be even faster. For the same 10K records it’ll run in about 1.7sec.
Usage
import fastavro as avro
with open('weather.avro', 'rb') as fo:
reader = avro.reader(fo)
schema = reader.schema
for record in reader:
process_record(record)
You can also use the fastavro script from the command line to dump avro files. Each record will be dumped to standard output in one line of JSON.
fastavro weather.avro
You can also dump the avro schema:
fastavro --schema weather.avro
Limitations
- Support only iteration
No writing for you!
- Supports only null and deflate codecs
avro also supports snappy
No reader schema
Hacking
As recommended by Cython, the C files output is distributed. This has the advantage that the end user does not need to have Cython installed. However it means that every time you change fastavro/pyfastavro.py you need to run make.
For make to succeed you need both python and python3 installed, cython on both of them. For ./test-install.sh you’ll need virtualenv.
Builds
We’re currently using travis.ci
Changes
See the ChangeLog
Contact
Miki Tebeka <miki.tebeka@gmail.com> https://bitbucket.org/tebeka/fastavro
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
File details
Details for the file fastavro-0.6.9.tar.gz.
File metadata
- Download URL: fastavro-0.6.9.tar.gz
- Upload date:
- Size: 69.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 6e7e03d6e2d65fe5e101cc3ab761d8c219d583a6608f8f0d7e05108272355624 |
|
| MD5 | 7aa6a01c8780138fa47be2144d020d90 |
|
| BLAKE2b-256 | 5e303ec1529508b93ee1c8b4c69dafedc78f7da6960594cd8f3fc4584104e209 |
File details
Details for the file fastavro-0.6.9-py3.2-linux-x86_64.egg.
File metadata
- Download URL: fastavro-0.6.9-py3.2-linux-x86_64.egg
- Upload date:
- Size: 162.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 63fb020e337b065353ae8042eedd227682d96f05051174145468c2005a4b4b3c |
|
| MD5 | 744ebaf16325b1529056dff0382ab92d |
|
| BLAKE2b-256 | 543f81d53463501e455e448c2ed9ef3c0697f0bad5f25b4bcc03a0882e0fd439 |
File details
Details for the file fastavro-0.6.9-py2.7-linux-x86_64.egg.
File metadata
- Download URL: fastavro-0.6.9-py2.7-linux-x86_64.egg
- Upload date:
- Size: 159.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 0b1758d365c284a0c2f770ea37ad364b1e4010b5ec1013762e1c9ec0f1c7a737 |
|
| MD5 | b17d76c23da14049376406c5863857c5 |
|
| BLAKE2b-256 | 02d111c82d59be9cfa22964626b4257f9f36c0863872eef3deda05acf577f216 |
