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.

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.0.tar.gz (75.4 kB view details)

Uploaded Source

Built Distribution

fastavro-0.6.0-py2.7-linux-x86_64.egg (101.5 kB view details)

Uploaded Source

File details

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

File metadata

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

File hashes

Hashes for fastavro-0.6.0.tar.gz
Algorithm Hash digest
SHA256 6ea68b3724ced7e1bacff42c9e7d3458d41aad81a26d7cef606b2ac8370b600a
MD5 d1d9330db4933ecca0487899b28b22a1
BLAKE2b-256 1fb3971f478aac377069befd063c7b4314b6c7d7162b798d160e24bae74a2e9a

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for fastavro-0.6.0-py2.7-linux-x86_64.egg
Algorithm Hash digest
SHA256 ab556cd9ca7e3e45b27dd4ea6b4e0337cff0a7668d0a8d2041dc744c43601722
MD5 a2f00f31e5663ebc0d48f586cfa40e18
BLAKE2b-256 8bb45b3e23442e52bd1137027f3dc04efd3bf217f23d1fa28dda5dc227978b40

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