Skip to main content

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.

Changes

See the ChangeLog

Contact

Miki Tebeka <miki.tebeka@gmail.com> https://bitbucket.org/tebeka/fastavro

Project details


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

fastavro-0.6.2.tar.gz (42.0 kB view details)

Uploaded Source

Built Distributions

fastavro-0.6.2-py3.2-linux-x86_64.egg (104.4 kB view details)

Uploaded Source

fastavro-0.6.2-py2.7-linux-x86_64.egg (103.8 kB view details)

Uploaded Source

File details

Details for the file fastavro-0.6.2.tar.gz.

File metadata

  • Download URL: fastavro-0.6.2.tar.gz
  • Upload date:
  • Size: 42.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for fastavro-0.6.2.tar.gz
Algorithm Hash digest
SHA256 07aceda78de127b172db52bd7efddd64eddfd5d20635461300afc964c5c8b0b4
MD5 2e5fc3347914037839228887268da637
BLAKE2b-256 ecfdffdb427cd613e6864787b88db4fff041014e9a19a3abc86571cec6708612

See more details on using hashes here.

File details

Details for the file fastavro-0.6.2-py3.2-linux-x86_64.egg.

File metadata

File hashes

Hashes for fastavro-0.6.2-py3.2-linux-x86_64.egg
Algorithm Hash digest
SHA256 31d69540159de6a63587e796357815e20fc8afbd0eb0019b9db870c0ab68b408
MD5 c84fc698804f17171196d76694848aaa
BLAKE2b-256 f7d4b5158be0abc596c546999e16ced555910db3dfa3e9c247cf463a53e99c7d

See more details on using hashes here.

File details

Details for the file fastavro-0.6.2-py2.7-linux-x86_64.egg.

File metadata

File hashes

Hashes for fastavro-0.6.2-py2.7-linux-x86_64.egg
Algorithm Hash digest
SHA256 ef487539c39e45efdad034e2784f66243c73783ead225a03d74d42c70d2ac9f3
MD5 d3128fdcde674690a26afab5281018c2
BLAKE2b-256 f7296d14199801f3d142c3f7f4b9c8e443e653b3caa622c9c31590b31067728c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page