dybuf 0.2.0

Python bindings for the dybuf dynamic buffer library.

dybuf python package

Python bindings for the dybuf dynamic buffer library implemented in C. The package exposes the DyBuf class implemented in Cython and ships binary wheels across the major desktop platforms.

Key features

• Thin, fast wrapper around the original dybuf implementation.
• Supports reading and writing unsigned integers (8–64 bits), booleans, and raw byte payloads.
• Compatible with Windows, Linux, and macOS thanks to compiled extension modules.
• Designed for publishing on PyPI with automated release workflows.

Installation

Once released to PyPI the package can be installed with:

pip install dybuf

Quick start

from dybuf import DyBuf

buf = (
    DyBuf(capacity=64)
    .append_uint16(0x1234)
    .append_uint32(0xDEADBEEF)
    .append_bool(True)
)

buf.flip()  # prepare for reading
print(hex(buf.next_uint16()))  # 0x1234
print(hex(buf.next_uint32()))  # 0xdeadbeef
print(buf.next_bool())         # True

write() and read() let you work directly with arbitrary byte payloads, while position, limit, and capacity expose the cursor-style API provided by the original library.

Typdex markers

DyBuf also exposes helpers for working with the library's typdex encodings—a compact representation of a logical type paired with an index. These markers are commonly used by higher-level protocols such as dypkt to describe field layouts or function identifiers.

from dybuf import DyBuf, TYPDEX_TYP_INT, TYPDEX_TYP_STRING

buf = DyBuf(capacity=32)
buf.append_typdex(TYPDEX_TYP_INT, 3).append_typdex(TYPDEX_TYP_STRING, 0x42)

buf.flip()

assert buf.peek_typdex() == (TYPDEX_TYP_INT, 3)
assert buf.next_typdex() == (TYPDEX_TYP_INT, 3)
assert buf.next_typdex() == (TYPDEX_TYP_STRING, 0x42)

The constants TYPDEX_TYP_* mirror the underlying C enums. append_typdex validates that the type fits in 8 bits and the index can be represented by the packed encoding. next_typdex and peek_typdex raise EOFError for truncated markers and ValueError when encountering a malformed header.

Developing locally

Create a virtual environment and install the build requirements:

python -m venv .venv
source .venv/bin/activate
pip install -r requirements-dev.txt  # optional, see below

Build the extension in editable mode for local testing:

pip install -e .
pytest

The project is configured to build wheels via python -m build, producing both source and binary distributions:

python -m build

Generate the Sphinx documentation locally with:

pip install -r requirements-dev.txt  # ensures sphinx/docutils are present
sphinx-build -b html docs docs/_build/html
open docs/_build/html/index.html  # or use your preferred viewer

Automated releases

A GitHub Actions workflow under .github/workflows/pypi-release.yml drives cibuildwheel to produce Windows, Linux, and macOS artifacts and publish them to PyPI. Provide a PYPI_API_TOKEN secret in your repository and tag releases with a semantic version (e.g. v0.2.0) to trigger the pipeline.

Licensing

The wrapper is distributed under the GNU GPL v2, matching the original dybuf project.