Files
quicproquo/examples/python/README.md
Christian Nennemann 2e081ead8e chore: rename quicproquo → quicprochat in docs, Docker, CI, and packaging
Rename all project references from quicproquo/qpq to quicprochat/qpc
across documentation, Docker configuration, CI workflows, packaging
scripts, operational configs, and build tooling.

- Docker: crate paths, binary names, user/group, data dirs, env vars
- CI: workflow crate references, binary names, artifact names
- Docs: all markdown files under docs/, SDK READMEs, book.toml
- Packaging: OpenWrt Makefile, init script, UCI config (file renames)
- Scripts: justfile, dev-shell, screenshot, cross-compile, ai_team
- Operations: Prometheus config, alert rules, Grafana dashboard
- Config: .env.example (QPQ_* → QPC_*), CODEOWNERS paths
- Top-level: README, CONTRIBUTING, ROADMAP, CLAUDE.md
2026-03-21 19:14:06 +01:00

1.5 KiB

quicprochat Python FFI Client

Python wrapper around libquicprochat_ffi using ctypes.

Build the FFI library

cargo build --release -p quicprochat-ffi

This produces:

  • Linux: target/release/libquicprochat_ffi.so
  • macOS: target/release/libquicprochat_ffi.dylib
  • Windows: target/release/quicprochat_ffi.dll

Usage

python examples/python/qpq_client.py \
    --server 127.0.0.1:7000 \
    --ca-cert server-cert.der \
    --server-name localhost \
    --username alice \
    --password secret

Send a message

python examples/python/qpq_client.py \
    --server 127.0.0.1:7000 \
    --ca-cert server-cert.der \
    --username alice --password secret \
    --send-to bob --message "hello from Python"

Receive messages

python examples/python/qpq_client.py \
    --server 127.0.0.1:7000 \
    --ca-cert server-cert.der \
    --username bob --password secret \
    --receive --timeout 10000

Library path

The script auto-detects the library in target/release/ or target/debug/. Override with QPQ_FFI_LIB:

export QPQ_FFI_LIB=/path/to/libquicprochat_ffi.so

Programmatic usage

from qpq_client import QpqClient, _find_library, _load_library

lib = _load_library(_find_library())
with QpqClient(lib) as client:
    client.connect("127.0.0.1:7000", "server-cert.der", "localhost")
    client.login("alice", "secret")
    client.send("bob", "hello")
    messages = client.receive(timeout_ms=5000)