Skip to main content

pyccobs

pyccobs provides Python bindings to ccobs using only the standard library's ctypes module. The ccobs C library is vendored and built into the package, so a separate ccobs installation is not required. It includes one-shot and streaming APIs as well as exposing the native library handle.

Build and use

Python 3.11+ and CMake 3.15+ are required.

python -m pip install -e .

The package build invokes the vendored ccobs CMake project directly. Because the package uses ctypes rather than the CPython extension API, the resulting wheel is tagged for Python 3 generally (for example, py3-none-win_amd64).

Set CCOBS_LIBRARY_PATH to a compatible shared library (or its directory) to override the bundled copy when testing a different ccobs build.

import ccobs

wire = ccobs.encode(b"hello\0world")
assert ccobs.decode(wire) == b"hello\0world"

batch = ccobs.encodev([b"first", b"", b"third"])
assert batch == b"".join(ccobs.encode(item) for item in [b"first", b"", b"third"])

encoder = ccobs.Encoder()
wire = encoder.feed(b"hello ") + encoder.feed(b"world", end_message=True)
wire += encoder.feedv([b"second", b"third"])
encoder.close()

decoder = ccobs.Decoder()
decoded, used, frame_sizes = decoder.feedv(wire)
decoder.close()

Decoder.feed() returns (decoded_bytes, consumed_bytes, message_complete) and stops after the first complete frame. Decoder.feedv() returns (decoded_bytes, consumed_bytes, frame_sizes) and decodes every complete frame in the supplied chunk in one ccobs_decodev() call. frame_sizes gives the decoded size of each completed frame in the flat output; a size may include bytes returned by an earlier partial call. Encoder.feedv() encodes a batch of complete messages through the native streaming vector API. Both stateful classes are context managers and have reset() and close().

For direct access to ccobs_create, ccobs_encodev, and the rest of the C API, use ccobs.load_library(). Its functions have their ctypes argtypes and restype declarations installed.

Metadata

Release files for pyccobs 0.1.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 pyccobs 0.1.0
File Size Uploaded Provenance
pyccobs-0.1.0.tar.gz 15.8 kB With provenance Details

Built distributions (wheels)

Table of built distributions (wheels) for pyccobs 0.1.0
File
pyccobs-0.1.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details
pyccobs-0.1.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details
pyccobs-0.1.0-py3-none-manylinux1_x86_64.manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_5_x86_64.whl Python 3 none Linux glibc 2.5+ x86-64, Linux glibc 2.17+ x86-64 Details
pyccobs-0.1.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details
pyccobs-0.1.0-py3-none-macosx_10_9_x86_64.whl Python 3 none macOS 10.9+ x86-64 Details

Total release size: 109.9 kB

Release files / pyccobs-0.1.0.tar.gz

Download URL pyccobs-0.1.0.tar.gz
Size 15.8 kB
Tags Source
SHA-256 checksum
How to use checksums
5f428434331c75e34b86ddb5e74d280fba30e5fe078d52b24c2978adc1d0f457
BLAKE2b-256 checksum
How to use checksums
a39bd951921ea07a8dc4419f0990a87ad7357873ca444d602c1c8585c10c6433
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.

Transparency log

Release files / pyccobs-0.1.0-py3-none-win_amd64.whl

Download URL pyccobs-0.1.0-py3-none-win_amd64.whl
Size 14.5 kB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
9a5805e5d2b335685698cb898282aa65a61ab866f2ed7abbe68d622a2d2f8399
BLAKE2b-256 checksum
How to use checksums
668d0d7a0aa4a8cc4e109ab21a65bdff1fe645a088f6785437311b991ec3e22e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.

Transparency log

Release files / pyccobs-0.1.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL pyccobs-0.1.0-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 23.1 kB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
4d8720ef20906789fd2137eaf9bba88f5eb3e53b269c3efb1cc3a15eddf2608e
BLAKE2b-256 checksum
How to use checksums
3234c6be16f935ac563bd88d4cce1f9f371ed972c07fef7d237882f90569972f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.

Transparency log

Release files / pyccobs-0.1.0-py3-none-manylinux1_x86_64.manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_5_x86_64.whl

Download URL pyccobs-0.1.0-py3-none-manylinux1_x86_64.manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_5_x86_64.whl
Size 21.9 kB
Tags Linux glibc 2.17+ x86-64 Linux glibc 2.5+ x86-64 Python 3
SHA-256 checksum
How to use checksums
7977ae8a69651af2c33577500c75c9e139dc9b3a9e731bcfde69dc56be036269
BLAKE2b-256 checksum
How to use checksums
177150ca947d74f534bce5c8ca1fb8164ccf962270c8e7546c0349068444fa8f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.

Transparency log

Release files / pyccobs-0.1.0-py3-none-macosx_11_0_arm64.whl

Download URL pyccobs-0.1.0-py3-none-macosx_11_0_arm64.whl
Size 17.6 kB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
edcd6488028b5c2523c4cae9ea6a2589b4061e2e268c03e178b6a20214b8a787
BLAKE2b-256 checksum
How to use checksums
8f261ea5d1d0fdc35d6dde2144b3998f0f206282382bb0faa97163cc3ae344ef
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.

Transparency log

Release files / pyccobs-0.1.0-py3-none-macosx_10_9_x86_64.whl

Download URL pyccobs-0.1.0-py3-none-macosx_10_9_x86_64.whl
Size 17.1 kB
Tags Python 3 macOS 10.9+ x86-64
SHA-256 checksum
How to use checksums
dde6e380f0903412c82da30f8e4c902fb36139b48389f3b7252463ac138126df
BLAKE2b-256 checksum
How to use checksums
d927a0f626ceecd0a54f2e57a2165e3ce92b0be2d120f679f81e650c5100b80f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.

Transparency log

Security for pyccobs 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 6 files in this release have been uploaded with provenance metadata.

Select from 6 files

Attestation for pyccobs-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Release history Release notifications | RSS feed

This release

0.1.0 This release

6 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page