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

Uploaded Source

Built Distributions

fastavro-0.6.1-py3.2-linux-x86_64.egg (105.4 kB view details)

Uploaded Source

fastavro-0.6.1-py2.7-linux-x86_64.egg (104.5 kB view details)

Uploaded Source

File details

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

File metadata

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

File hashes

Hashes for fastavro-0.6.1.tar.gz
Algorithm Hash digest
SHA256 4b11ab81c259812f85d632851f699999ab008047af175ba33afaae20919c109a
MD5 586b796f613dd4e0b5c2b256801ee615
BLAKE2b-256 9758a30ffa95fc01971b1ab15d5e73123d53af459df2f92633c456634f816f24

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for fastavro-0.6.1-py3.2-linux-x86_64.egg
Algorithm Hash digest
SHA256 e2a981c5e4ae8bafbec2d3d6eabaaf58f2e0cc4b5027cea811461bf2536b0a13
MD5 b2c2d4bf1f5cfd2a7f7d22bfc1085aaf
BLAKE2b-256 4052852d2c27673d57264dd1f92538f2fed01e6741b26144f9ffb5c32b793117

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for fastavro-0.6.1-py2.7-linux-x86_64.egg
Algorithm Hash digest
SHA256 b33887b958c46e7723dfd93b8a6f123ad3da2ede39b99b8566da54c5d184fec2
MD5 4a8d1c82f074f2d92afc7402d33008a3
BLAKE2b-256 184120dfdb48327b725410332150db833c6ffadf23d4f558035d68c51b2adce4

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