Christian Nennemann
2e081ead8e
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
69 lines
1.5 KiB
Markdown
69 lines
1.5 KiB
Markdown
# quicprochat Python FFI Client
|
|
|
|
Python wrapper around `libquicprochat_ffi` using `ctypes`.
|
|
|
|
## Build the FFI library
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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`:
|
|
|
|
```bash
|
|
export QPQ_FFI_LIB=/path/to/libquicprochat_ffi.so
|
|
```
|
|
|
|
## Programmatic usage
|
|
|
|
```python
|
|
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)
|
|
```
|