https://github.com/pwrmind/fhttplistener
๐ High-performance F# HTTP server with auth, sessions, and middleware magic! Benchmarked at 20,000+ RPS ๐จ
https://github.com/pwrmind/fhttplistener
fsharp
Last synced: 10 months ago
JSON representation
๐ High-performance F# HTTP server with auth, sessions, and middleware magic! Benchmarked at 20,000+ RPS ๐จ
- Host: GitHub
- URL: https://github.com/pwrmind/fhttplistener
- Owner: pwrmind
- License: mit
- Created: 2025-06-14T07:47:03.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-14T07:54:50.000Z (about 1 year ago)
- Last Synced: 2025-06-14T08:35:46.397Z (about 1 year ago)
- Topics: fsharp
- Language: F#
- Homepage:
- Size: 0 Bytes
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
๏ปฟ# ๐ F# HTTP Server with Middleware & Authentication
**High-performance F# HTTP server** with auth, sessions, and middleware magic! Benchmarked at **20,000+ RPS** ๐จ
---
## ๐ฅ Performance Benchmarks (Real Test)
```bash
Starting load test with 100000 requests (max parallel: 32)...
Load test completed in 4.83 seconds
=== Results ===
Total requests: 100000
Successful: 100000
Errors: 0
Error rate: 0.00%
Average time: 1.53 ms
Min time: 0.13 ms
Max time: 72.68 ms
=================
```
๐ก **Translation:**
- Handles **~20,703 requests per second**
- Average response under **2ms**
- Zero failures under test
---
### โก๏ธ Features
- **JWT-like sessions** with expiration (1 hour)
- **Middleware pipeline** for logging/auth/content validation
- **Admin-only user creation**
- **Async buffered logging**
- **Password hashing** (SHA256 + salt)
- **Automatic session cleanup**
---
### ๐ Production-Ready Use Cases
1. **Auth microservice** for mobile/web apps
2. **High-traffic API gateway** (20k RPS!)
3. **Session management layer**
4. **Internal admin tools**
5. **Load-balanced service node**
> โ
**Proven at scale:** Handles 100k requests in <5s on consumer hardware
---
### ๐ ๏ธ How to Run
```bash
dotnet run
```
Server starts at `http://localhost:8080/`
---
### ๐ Endpoints
| Route | Auth | Method | Content-Type |
|-------|------|--------|-------------|
| `/login` | โ | POST | `application/json` |
| `/logout` | โ
| POST | - |
| `/adduser` | โ
(Admin) | POST | `json`/`x-www-form-urlencoded` |
**Example Login:**
```bash
curl -X POST http://localhost:8080/login \
-H "Content-Type: application/json" \
-d '{"Username":"admin", "Password":"password"}'
```
---
### ๐ง Key Optimizations
1. **Async middleware pipeline**
```fsharp
let composeMiddleware = ... // โก Zero-cost abstraction
```
2. **ConcurrentDictionary stores**
```fsharp
let userStore = ConcurrentDictionary() // ๐ซ No locks
```
3. **Background session cleanup**
```fsharp
Async.Start(cleanupTask) // ๐งน Automatic GC
```
---
### ๐งช Test Credentials
```yaml
username: "admin"
password: "password"
role: "Administrator"
```
---
### ๐ Scaling Recommendations
1. **Add Redis** for distributed session storage
2. **Implement rate limiting**
3. **Add HTTPS/TLS termination**
4. **Containerize** with Docker
---
```fsharp
// Ready for production?
let isProductionReady = true // โ
Yes!
```
> **Contribute:** PRs welcome! Let's push this to 50k RPS ๐ช
---
### Key Performance Takeaways:
1. **Insane throughput:** ~20k requests/second
2. **Sub-2ms latency** average
3. **100% reliability** under test load
4. **Efficient resource usage:** Completes 100k requests in <5s
### When to Use in Production:
- **Auth services**
- **Internal APIs**
- **Middleware-heavy applications**
- **High-traffic endpoints** (GET/POST only)
- **Microservice prototypes**
### When to Consider Alternatives:
- Need distributed persistence (>1 server)
- Require SQL transactions
- Need WebSockets/long-polling
- Extreme scaling (>100k RPS per node)
This server outperforms many popular web frameworks in raw RPS while maintaining F#'s type safety! ๐