# informix-db

Pure-Python driver for IBM Informix IDS, speaking the SQLI wire protocol over raw sockets. **No IBM Client SDK. No JVM. No native libraries.**

## Status

🚧 **Phase 0 — Spike.** Characterizing the SQLI wire protocol. No library code yet.

The protocol has never been published byte-for-byte by IBM. Every existing Informix driver in every language wraps either IBM's CSDK or the JDBC JAR. This project closes that gap.

## Phase 0 deliverables

- [`docs/PROTOCOL_NOTES.md`](docs/PROTOCOL_NOTES.md) — byte-level wire-format reference, derived from packet captures + JDBC decompilation
- [`docs/JDBC_NOTES.md`](docs/JDBC_NOTES.md) — index into the decompiled IBM JDBC driver's wire-protocol classes
- [`docs/DECISION_LOG.md`](docs/DECISION_LOG.md) — running rationale for protocol/auth/type decisions
- `docs/CAPTURES/*.pcap` — annotated packet captures of reference exchanges

If Phase 0's exit criteria are met, library implementation begins in Phase 1.

## Test target

`icr.io/informix/informix-developer-database` (port 9088, native SQLI). See [`tests/docker-compose.yml`](tests/docker-compose.yml) once Phase 1 lands.

## License

MIT.