Skip to main content

A Python library for reading and writing binary sources.

Project description

Pyjak

A Python library for reading and writing binary sources. The standard library package struct has many caveats and is not very user friendly. We wrap it for you and present a slick api with sane exception handling.

Build Status

Installation

The easiest way to install is through pip:

pip3 install pyjak

Examples

Heres how you would serialize a common integer:

from pyjak import dump_int32
_bytes = dump_int32(1)
print(_bytes)

Result: (On little endian systems)

b'\x01\x00\x00\x00'

And to turn it back into an integer:

from pyjak import parse_int32
_int = parse_int32(b'\x01\x00\x00\x00')
print(_int)

Result: (On little endian systems)

1

Unsigned integers

All integer functions have unsigned versions as well. Lets say you want to fit the number 4000000000 into a 4 byte integer. You would need the unsigned version:

from pyjak import dump_uint32
_bytes = dump_uint32(4000000000)
print(_bytes)

Result: (On little endian systems)

b'\x00(k\xee'

And to turn it back into an integer:

from pyjak import parse_uint32
_int = parse_uint32(b'\x00(k\xee')
print(_int)

Result: (On little endian systems)

4000000000

Byte order

As you may have noticed, we didn't need to specify the byte order (or endianness) of the byte array. This is because all functions in pyjak defaults to the native byte order of your system.

But you can also specify which byte order you want by using the ByteOrder enumeration (except when calling int8 or uint8 functions). The available orders are:

from pyjak import ByteOrder
ByteOrder.LITTLE
ByteOrder.BIG
ByteOrder.NATIVE
print(ByteOrder.NATIVE == ByteOrder.LITTLE)

Result: (On little endian systems)

True

You can specify what byte order the serialized output should have:

from pyjak import dump_int32, ByteOrder
_bytes = dump_int32(1, ByteOrder.BIG)
print(_bytes)

Result:

b'\x00\x00\x00\x01'

Or when parsing:

from pyjak import parse_int32, ByteOrder
_int = parse_int32(b'\x00\x00\x00\x01', ByteOrder.BIG)
print(_int)

Result:

1

Booleans

You can also serialize booleans. Booleans are assumed to represented as an unsigned 1 byte integer, where 0 means False and any other value means True.

Supported data types

  • int8 (Signed 1 byte integer)
  • uint8 (Unsigned 1 byte integer)
  • int16 (Signed 2 byte integer)
  • uint16 (Unsigned 2 byte integer)
  • int32 (Signed 4 byte integer)
  • uint32 (Unsigned 4 byte integer)
  • int64 (Signed 8 byte integer)
  • uint64 (Unsigned 8 byte integer)
  • float32 (4 byte single precision float)
  • float64 (8 byte double precision float)
  • bool (unsigned 1 byte integer)

Supported versions

  • Python 3.4
  • Python 3.5
  • Python 3.6
  • Python 3.7

Issues

Report issues using the issue tracker on the github repo.

Changelog

v0.1.0

  • Initial release.

Authors

  • Max Byrde (miniwa)

License

MIT (see LICENSE)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pyjak, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size pyjak-0.1.1-py3-none-any.whl (5.9 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size pyjak-0.1.1.tar.gz (6.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page