This python module implements a container for data blocks.
Project description
jk_bincontainer
Introduction
This python module implements a container for data blocks.
Information about this module can be found here:
Why this module?
Sometimes it is more convenient to store a single file instead of multiple ones. For purposes of reuse of such kind of functionality, this module has been created. It implements a container that allows adding binary data blocks, store the whole set ob blocks in a single file, and load everything again later.
This module is heavily inspired by the internal structure of PNG files.
Limitations of this module
Every data block must have a unique key so that it can be identified within the container. This key must consist of exactly 4 ASCII characters.
All data handling is done in memory. Therefore it is recommended to not use this container for huge amounts of data. (This container is not intended to fit such requirements.)
How to use this module
Import this module
Please include this module into your application using the following code:
import jk_bincontainer
Create a data container
To create an empty container simply construct it:
bc = BinContainer()
The container is now ready for use.
Add a data block
You can add binary data blocks like this:
bc.addBinaryBlock("abcd", b"\x01\x02\x03")
Retrieve the block again
Of course you can later find the block again:
blockType, rawData = bc.getBlockByKeyE("abcd")
All named data retrieval methods return such a tuple. If you retrieve by index you will receive a triple:
blockKey, blockType, rawData = bc.getBlockByIndexE(0)
In general the following methods are available:
Method | Argument(s) | Return Value(s) |
---|---|---|
getBlockByIndexE |
int index |
str blockKey , str blockType , data |
getBlockByIndex |
int index |
str blockKey , str blockType , data |
getBlockByKeyE |
str key |
str blockType , data |
getBlockByKey |
str key |
str blockType , data |
Serialize the data container
The data container can be serialized like this:
rawBytes = bytes(bc)
Or:
rawBytes = bc.toBytes()
Which both will construct a bytes
object with data from the container.
Additionally you could construct a bytearray
object if you are interested in bytearray
instead of bytes
:
rawByteArray = bc.toByteArray()
Write the data container to disk
The data container can be serialized and written to disk:
bc.writeToFile("/path/tp/myfile")
Loading the data from disk
If you have written the data to disk you can load them again. Example:
bc.loadFromFile("/path/tp/myfile")
Deserialize data
Alternatively you might already have binary data and want to load directly from it. Example:
bc.loadFromData(binData)
Contact Information
This work is Open Source. This enables you to use this work for free.
Please have in mind this also enables you to contribute. We, the subspecies of software developers, can create great things. But the more collaborate, the more fantastic these things can become. Therefore Feel free to contact the author(s) listed below, either for giving feedback, providing comments, hints, indicate possible collaborations, ideas, improvements. Or maybe for "only" reporting some bugs:
- Jürgen Knauth: jknauth@uni-goettingen.de, pubsrc@binary-overflow.de
License
This software is provided under the following license:
- Apache Software License 2.0
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
Hashes for jk_bincontainer-0.2020.4.16.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | a465174eef0be81af6ebbefe78b36b2030f7e5d24eea5b6d52e3c9a8c3b5f020 |
|
MD5 | 51d038b5e6d0d15899f53ce8e366c157 |
|
BLAKE2b-256 | e69127ba123b5d7651aabfb24c0bea7eabe644db041376de27928a335fe16933 |