anycrc 0.3.1

Python CRC Computation Library

This is a Cython module with bindings to the crcany library. It supports calculating CRC hashes of arbitary sizes as well as updating a crc hash over time.

Installation

pip install anycrc

Usage

Use an existing model:

>>> import anycrc
>>> crc32 = anycrc.Model('CRC32-ISO-HDLC')
>>> crc32.calc(b'Hello World!')
472456355

Read the data in chunks:

>>> crc32.reset() #set to the initial value
>>> crc32.calc(b'Hello ')
3928882368
>>> crc32.calc(b'World!')
472456355

Specify your own CRC parameters:

>>> # width, poly, init, refin, refout, xorout
>>> my_crc = anycrc.CRC(10, 0b0101010101, 0x3ff, True, False, 0)
>>> my_crc.calc('Hello World!')
35

The CRC's width cannot exceed the system's maximum integer width.

For a list of pre-built models, check models.py.

Benchmarks

Calculating the CRC32 for lorem ipsum 10 million times:

Module	Time Elapsed (s)	Average Time (MiB/s)	Relative
anycrc	6.660	637.26	1.000
binascii	7.567	560.86	1.136
fastcrc	17.508	242.39	2.629
crcmod-plus	19.619	216.32	2.946