apache-iggy

Apache Iggy is the persistent message streaming platform written in Rust, supporting QUIC, TCP and HTTP transport protocols, capable of processing millions of messages per second.

Installation

Basic Installation

pip install apache-iggy

Development Installation

For testing:

pip install -e ".[testing]"

For development with all tools:

pip install -e ".[dev,testing,examples]"

Supported Python Versions

• Python 3.7+

Usage and Examples

All examples rely on a running iggy server. To start the server, execute:

# Using latest version
docker run --rm -p 8080:8080 -p 3000:3000 -p 8090:8090 apache/iggy:latest

# Or build from source (recommended for development)
cd ../../ && cargo run --bin iggy-server

Testing

Quick Test

# Run tests with Docker (recommended)
docker compose -f docker-compose.test.yml up --build

Local Development

# Install dependencies and build
pip install -e ".[testing]"
maturin develop

# Run tests (requires iggy-server running)
pytest tests/ -v

Examples

Refer to the python_examples/ directory for usage examples.

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

Licensed under the Apache License 2.0. See LICENSE for details.