polyglot-logger 0.3.3

Python bindings for the Polyglot native structured logger

polyglot-logger

Python bindings for Polyglot — a shared Go logging core with a C ABI. Same polyglot.yaml, JSON shape, and sinks as the Node and .NET packages. Native libs ship in the wheel (Linux, Windows, macOS arm64); no Go/CGO required.

Current line: 0.3.x.

pip install polyglot-logger

from polyglot_logger import Logger

with Logger(service="api", stdout=True) as log:
    log.info("hello", user_id=1)

__exit__ calls close(). Side-by-side APIs: sdk.md.

Config file (optional)

Constructors load polyglot.yaml in the native core (POLYGLOT_CONFIG → cwd → parents, stop at .git). No PyYAML required for that path. Kwargs override file keys.

# polyglot.yaml (repo root)
service: payments-api
environment: prod
level: info
stdout: true
file:
  enabled: true
  path: /var/log/payments.log

Logger(service="payments-api")  # sinks from YAML

Full schema: configuration · zero-config.

Levels, fields, lifecycle

from polyglot_logger import Logger, Level

with Logger(
    "payments-api",
    environment="prod",
    level="info",
    stdout=True,
) as log:
    log.set_fields({"region": "us-east"})
    req = log.with_fields(request_id="r1")  # or log.bind(...)
    req.info("order created", order_id=123, amount=42.5)
    req.log_simple(Level.ERROR, "payment failed")
    req.close()
    log.flush()

• Levels: trace … fatal (fatal does not exit the process).
• Prefer with_fields / bind for per-request context; avoid sharing set_fields across threads for request data.
• One instance is fine for concurrent log / flush / stats / set_fields. Close from a single owner (or use the context manager).

Native library

Published wheels include platform natives. For a local monorepo build:

export POLYGLOT_LOGGER_LIB=$PWD/dist/liblogger.so   # logger.dll / liblogger.dylib

Intel Macs: arm64 is what ships today; set POLYGLOT_LOGGER_LIB for amd64 until CI covers it.

From source

git clone --recurse-submodules https://github.com/kishankumarhs/Polyglot.git
cd Polyglot && make build-native
pip install -e bindings/python

Docs

• SDK comparison
• First log
• Python API
• Configuration
• Sinks & Loki
• Migrate from Python logging
• Compatibility
• Benchmarks / methodology

Polyglot is for multi-language stacks that want one ops model — shared config and sinks without reimplementing them per language.

Repos: polyglot-py · core: Polyglot

MIT