Laminar

Laminar is a high-performance experimental load balancer written in Rust.

The project focuses on building modern load balancing infrastructure from first principles while emphasizing:

• correctness
• observability
• maintainability
• incremental architecture evolution

This repository is intentionally developed in stages, starting from a minimal working implementation and progressively evolving toward production-grade infrastructure.

---

Current Features

• TCP proxying
• Config-driven upstream management
• Async runtime powered by Tokio
• Backend state management
• Health checking foundation
• Structured CI workflow
• Clippy and formatting enforcement

---

Project Structure

src/
├── algorithms/
├── config/
├── proxy/
├── state/
└── common/

tests/
docs/
scripts/

---

Requirements

• Rust stable
• Cargo

Optional tooling:

cargo install cargo-watch
cargo install cargo-audit
cargo install cargo-deny

Initial Setup

After cloning the repository, run:

make setup

This configures:

• local git hooks
• executable development scripts
• automated pre-commit and pre-push checks

After setup:

• git commit automatically runs formatting and clippy fixes
• git push automatically runs verification checks

This setup only needs to be run once per repository clone.

---

Running The Project

make run

Release build:

make release

---

Development Workflow

Before pushing code:

make fix
make verify

This ensures:

• formatting passes
• clippy passes
• tests pass
• dependency checks pass
• license checks pass

CI will fail if these checks do not pass.

---

Available Commands

make help

Common commands:

make run
make test
make fix
make verify
make ci

---

CI Policy

All pull requests must pass CI before merging.

CI currently validates:

• formatting
• clippy
• tests
• build integrity

The project intentionally keeps CI lightweight during early development stages.

---

License

Licensed under :

• MIT license