{"id":28820649,"url":"https://github.com/pwrmind/fhttplistener","last_synced_at":"2025-08-16T17:05:52.853Z","repository":{"id":299029756,"uuid":"1001867771","full_name":"pwrmind/FHttpListener","owner":"pwrmind","description":"🚀 High-performance F# HTTP server with auth, sessions, and middleware magic! Benchmarked at 20,000+ RPS 💨","archived":false,"fork":false,"pushed_at":"2025-06-14T07:54:50.000Z","size":0,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-14T08:35:46.397Z","etag":null,"topics":["fsharp"],"latest_commit_sha":null,"homepage":"","language":"F#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pwrmind.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-14T07:47:03.000Z","updated_at":"2025-06-14T08:01:33.000Z","dependencies_parsed_at":"2025-06-14T08:46:51.756Z","dependency_job_id":null,"html_url":"https://github.com/pwrmind/FHttpListener","commit_stats":null,"previous_names":["pwrmind/fhttplistener"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pwrmind/FHttpListener","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pwrmind%2FFHttpListener","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pwrmind%2FFHttpListener/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pwrmind%2FFHttpListener/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pwrmind%2FFHttpListener/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pwrmind","download_url":"https://codeload.github.com/pwrmind/FHttpListener/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pwrmind%2FFHttpListener/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270742043,"owners_count":24637504,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-16T02:00:11.002Z","response_time":91,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fsharp"],"created_at":"2025-06-18T22:00:39.337Z","updated_at":"2025-08-16T17:05:52.845Z","avatar_url":"https://github.com/pwrmind.png","language":"F#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 F# HTTP Server with Middleware \u0026 Authentication  \n\n**High-performance F# HTTP server** with auth, sessions, and middleware magic! Benchmarked at **20,000+ RPS** 💨  \n\n![Performance](https://img.shields.io/badge/performance-20k%2Brps-brightgreen) \n![Built with F#](https://img.shields.io/badge/F%23-4.7-blueviolet)\n\n---\n\n## 🔥 Performance Benchmarks (Real Test)\n```bash\nStarting load test with 100000 requests (max parallel: 32)...\nLoad test completed in 4.83 seconds\n\n=== Results ===\nTotal requests:    100000\nSuccessful:        100000\nErrors:            0\nError rate:        0.00%\nAverage time:      1.53 ms\nMin time:          0.13 ms\nMax time:          72.68 ms\n=================\n```\n\n💡 **Translation:**  \n- Handles **~20,703 requests per second**  \n- Average response under **2ms**  \n- Zero failures under test  \n\n---\n\n### ⚡️ Features  \n- **JWT-like sessions** with expiration (1 hour)  \n- **Middleware pipeline** for logging/auth/content validation  \n- **Admin-only user creation**  \n- **Async buffered logging**  \n- **Password hashing** (SHA256 + salt)  \n- **Automatic session cleanup**  \n\n---\n\n### 🚀 Production-Ready Use Cases  \n1. **Auth microservice** for mobile/web apps  \n2. **High-traffic API gateway** (20k RPS!)  \n3. **Session management layer**  \n4. **Internal admin tools**  \n5. **Load-balanced service node**  \n\n\u003e ✅ **Proven at scale:** Handles 100k requests in \u003c5s on consumer hardware  \n\n---\n\n### 🛠️ How to Run  \n```bash\ndotnet run\n```\nServer starts at `http://localhost:8080/`  \n\n---\n\n### 🌐 Endpoints  \n| Route | Auth | Method | Content-Type |\n|-------|------|--------|-------------|\n| `/login` | ❌ | POST | `application/json` |\n| `/logout` | ✅ | POST | - |\n| `/adduser` | ✅ (Admin) | POST | `json`/`x-www-form-urlencoded` |\n\n**Example Login:**\n```bash\ncurl -X POST http://localhost:8080/login \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"Username\":\"admin\", \"Password\":\"password\"}'\n```\n\n---\n\n### 🧠 Key Optimizations  \n1. **Async middleware pipeline**  \n   ```fsharp\n   let composeMiddleware = ... // ⚡ Zero-cost abstraction\n   ```\n2. **ConcurrentDictionary stores**  \n   ```fsharp\n   let userStore = ConcurrentDictionary\u003cstring, User\u003e() // 🚫 No locks\n   ```\n3. **Background session cleanup**  \n   ```fsharp\n   Async.Start(cleanupTask) // 🧹 Automatic GC\n   ```\n\n---\n\n### 🧪 Test Credentials  \n```yaml\nusername: \"admin\"\npassword: \"password\"\nrole: \"Administrator\"\n```\n\n---\n\n### 📈 Scaling Recommendations  \n1. **Add Redis** for distributed session storage  \n2. **Implement rate limiting**  \n3. **Add HTTPS/TLS termination**  \n4. **Containerize** with Docker  \n\n---\n\n```fsharp\n// Ready for production? \nlet isProductionReady = true // ✅ Yes!\n```\n\n\u003e **Contribute:** PRs welcome! Let's push this to 50k RPS 💪\n\n---\n\n### Key Performance Takeaways:\n1. **Insane throughput:** ~20k requests/second\n2. **Sub-2ms latency** average\n3. **100% reliability** under test load\n4. **Efficient resource usage:** Completes 100k requests in \u003c5s\n\n### When to Use in Production:\n- **Auth services** \n- **Internal APIs**\n- **Middleware-heavy applications**\n- **High-traffic endpoints** (GET/POST only)\n- **Microservice prototypes**\n\n### When to Consider Alternatives:\n- Need distributed persistence (\u003e1 server)\n- Require SQL transactions\n- Need WebSockets/long-polling\n- Extreme scaling (\u003e100k RPS per node)\n\nThis server outperforms many popular web frameworks in raw RPS while maintaining F#'s type safety! 🚀","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpwrmind%2Ffhttplistener","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpwrmind%2Ffhttplistener","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpwrmind%2Ffhttplistener/lists"}