TechEmpower.FrameworkBenchmarks/frameworks/Rust/ignitia

Ignitia TechEmpower Benchmarks

This repository contains the TechEmpower FrameworkBenchmarks implementations for the Ignitia web framework, designed to showcase high-performance web API serving in Rust.

---

Project Variants

Binary	Description
ignitia	Basic variant with JSON and plaintext endpoints
ignitia-pg	PostgreSQL variant using tokio-postgres
ignitia-pg-pool	PostgreSQL variant using deadpool connection pooling
ignitia-mongo	MongoDB variant

---

Benchmarked Endpoints

All variants implement the following HTTP endpoints:

• /plaintext - Returns a simple plaintext "Hello, World!"
• /json - Returns a JSON-serialized message
• /db - Single database query for a random World record
• /queries?q=N - Multiple database queries, default 1, max 500
• /updates?q=N - Database updates with N queries, default 1, max 500
• /fortunes - Renders HTML table with fortunes and adds one dynamically

---

Getting Started

Prerequisites

• Rust (latest stable)
• Docker & Docker Compose (for database services)
• PostgreSQL or MongoDB instance running (Docker recommended)

Setup Databases

Use the provided docker-compose.yml to start PostgreSQL and MongoDB databases locally:

docker-compose up -d

Initialize databases using provided SQL and JS scripts (init-db.sql, init-mongo.js).

Update .env with correct connection URLs and ports.

Build and Run

Build all variants:

cargo build --release

Run a variant (example PostgreSQL):

./target/release/ignitia-pg

Change ports if needed by modifying .env.

Test APIs

Use curl or the included test scripts to verify endpoints.

Example:

curl http://localhost:8000/json
curl http://localhost:8000/queries?q=5
curl http://localhost:8000/fortunes

---

Performance

Ignitia includes several performance optimizations:

• Zero-copy response construction
• Efficient routing with a radix tree
• High-performance async runtime using Tokio
• Connection pooling (deadpool for PostgreSQL)
• MiMalloc memory allocator for improved throughput
• HTTP/2 support and TCP tuning

The expected throughput matches or exceeds other Rust web frameworks in TechEmpower benchmarks.

---

Docker Support

Build the container image:

docker build -t ignitia-techempower -f ignitia.dockerfile .

Run the container (default JSON/plaintext variant):

docker run -p 8000:8000 ignitia-techempower

Override command to run other variants:

docker run -p 8000:8000 ignitia-techempower /app/ignitia-pg

---

Contributing

Contributions, bug reports, and feature requests are welcome.

Please submit issues or pull requests following the project coding and style guidelines.

---

License

This project is licensed under MIT License.

---

Acknowledgements

• Inspired by the TechEmpower Framework Benchmarks project
• Thanks to the Rust community and authors of Ignitia framework