bitstruct

About

This module is intended to have a similar interface as the python struct module, but working on bits instead of primitive data types (char, int, …).

Documentation: http://bitstruct.readthedocs.org/en/latest

Installation

pip install bitstruct

Example usage

See the test suite: https://github.com/eerimoq/bitstruct/blob/master/tests/test_bitstruct.py

A basic example of packing/unpacking four integers:

>>> from bitstruct import *
>>> pack('u1u3u4s16', 1, 2, 3, -4)
bytearray(b'\xa3\xff\xfc')
>>> unpack('u1u3u4s16', bytearray(b'\xa3\xff\xfc'))
(1, 2, 3, -4)
>>> calcsize('u1u3u4s16')
24

The unpacked fields can be named by assigning them to variables or by wrapping the result in a named tuple:

>>> from bitstruct import *
>>> from collections import namedtuple
>>> MyName = namedtuple('myname', [ 'a', 'b', 'c', 'd' ])
>>> unpacked = unpack('u1u3u4s16', bytearray(b'\xa3\xff\xfc'))
>>> myname = MyName(*unpacked)
>>> myname
myname(a=1, b=2, c=3, d=-4)
>>> myname.c
3

An example of packing/unpacking a unsinged integer, a signed integer, a float and a bytearray:

>>> from bitstruct import *
>>> pack('u5s5f32b13', 1, -1, 3.75, bytearray(b'\xff\xff'))
bytearray(b'\x0f\xd0\x1c\x00\x00?\xfe')
>>> unpack('u5s5f32b13', bytearray(b'\x0f\xd0\x1c\x00\x00?\xfe'))
(1, -1, 3.75, bytearray(b'\xff\xf8'))
>>> calcsize('u5s5f32b13')
55

An example of unpacking values from a hexstring and a binary file:

>>> from bitstruct import *
>>> from binascii import *
>>> unpack('s17s13b24', bytearray(unhexlify('0123456789abcdef')))
(582, -3751, bytearray(b'\xe2j\xf3'))
>>> with open("test.bin", "rb") as fin:
...     unpack('s17s13b24', bytearray(fin.read(8)))
...
...
(582, -3751, bytearray(b'\xe2j\xf3'))

Change endianness of the data with byteswap(), and then unpack the values:

>>> from bitstruct import *
>>> packed = pack('u1u3u4s16', 1, 2, 3, 1)
>>> unpack('u1u3u4s16', byteswap('12', packed))
(1, 2, 3, 256)

Metadata

Release files for bitstruct 2.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bitstruct 2.0.0
File	Size	Uploaded
bitstruct-2.0.0.tar.gz	3.8 kB	Dec 12, 2015	Details

Built distribution (wheel)

Table of built distributions (wheels) for bitstruct 2.0.0
File	Interpreter	ABI	Platform	Reset
bitstruct-2.0.0-py2.py3-none-any.whl 5.6 kB Dec 12, 2015	Python 3, Python 2	none	any	Details

Total release size: 9.4 kB

Release files / bitstruct-2.0.0.tar.gz

Download URL	bitstruct-2.0.0.tar.gz
Size	3.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`846d398673ad6f32516d1ade9d7d93c85c20d23d5e37badda20ebfa4591f185b`
BLAKE2b-256 checksum How to use checksums	`f82bfe75322181da1f222f4acbb3b1827343fadf07cebf9ab74d74cb5f65c4f7`
Upload date	Dec 12, 2015
Uploaded using Trusted Publishing? What is trusted publishing?	No

Release files / bitstruct-2.0.0-py2.py3-none-any.whl

Download URL	bitstruct-2.0.0-py2.py3-none-any.whl
Size	5.6 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`54eae38cfc622ee63927d4bad0b47ba932aa6b977653caee52134cae885d539e`
BLAKE2b-256 checksum How to use checksums	`5a35b77735fc351fdef0c45c448382884febdaaeedc99e28296589da57519adb`
Upload date	Dec 12, 2015
Uploaded using Trusted Publishing? What is trusted publishing?	No