CoAkka Logger Python

Python connector package for the standalone CoAkka native logger core.

New To CoAkka

CoAkka is a native-backed runtime and logger toolkit for application-owned work. The logger package gives Python applications a small host API over the native logger core, with bounded queues, pressure state, manual draining, structured records, and native-backed lifecycle without asking users to wire a separate logging service.

Use these public repositories to orient first:

Samples docs directory: https://github.com/phuong-tran/coakka-samples/tree/main/docs

Public artifact and release notes: https://github.com/phuong-tran/coakka-publish

Try the PyPI package without cloning any CoAkka repo:

python3 -m venv coakka-logger-first-run
source coakka-logger-first-run/bin/activate
python -m pip install coakka-logger==1.2.1

from coakka_logger import CoakkaLoggerLevel, Logger, LoggerSpec

with Logger.start(spec=LoggerSpec(system_name="logger-first-run", min_level=CoakkaLoggerLevel.INFO)) as logger:
    sequence = logger.info("orders", "accepted")
    record = logger.await_next(timeout_ms=1000)
    print({"sequence": sequence, "category": record.category, "message": record.message})

This package is intentionally smaller than the runtime connector:

• load libcoakka_logger_core through ctypes
• keep Python-side formatting above the native core
• let the native logger own queueing, pressure policy, sinks, and lifecycle
• package staged native libraries into the wheel for macOS aarch64, Linux aarch64/x86_64, and Windows aarch64/x86_64

Build

./logger/python/scripts/build_wheel.sh

The script stages native libraries from:

logger/staging/native/1.2.1+f50756ebff0d/

Smoke

./logger/python/scripts/test_package.sh
./logger/python/scripts/smoke_packaged_wheel.sh
./logger/python/scripts/check_pypi_readiness.sh

Example

from coakka_logger import Logger

with Logger.start() as logger:
    logger.info("app", "started")
    record = logger.await_next(timeout_ms=1000)

Public docs:

• CoAkka samples: https://github.com/phuong-tran/coakka-samples
• Public artifacts and release notes: https://github.com/phuong-tran/coakka-publish
• Package-manager roadmap: https://github.com/phuong-tran/coakka-publish/blob/main/docs/package-manager-roadmap.md