# itsdejavuuu/rhttp architecture

> Architecture diagram of the GitHub repository itsdejavuuu/rhttp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/itsdejavuuu/rhttp
- Repository: https://github.com/itsdejavuuu/rhttp

## Overview

gmsv_rhttp is a Rust-backed asynchronous HTTP extension for Garry’s Mod servers. Lua submits an options table and receives a request ID; the extension validates and prepares the request, runs network work asynchronously, then delivers success or failure callbacks back to Lua. Separate runtime capabilities include cancellation, statistics, retries, and bounded concurrency and body buffering. The excerpts show the Lua binding, worker coordination, and response callback path; retry details and several transport capabilities are documented in the README, not fully visible in the sampled source.

Main entry points: [`src/worker.rs`](https://github.com/itsdejavuuu/rhttp/blob/main/src/worker.rs) (Async worker), [`src/http.rs`](https://github.com/itsdejavuuu/rhttp/blob/main/src/http.rs) (Request admission), [`src/lib.rs`](https://github.com/itsdejavuuu/rhttp/blob/main/src/lib.rs) (Lua exports)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lua_api["Lua API"]
  node_lua_exports["Lua exports<br/>[lib.rs]"]
  node_lua_callbacks["Lua callbacks<br/>[worker.rs]"]
  node_cancel_api["Cancellation API<br/>[http.rs]"]
  node_stats_api["Statistics API<br/>[http.rs]"]
end

subgraph group_request_flow["Request processing"]
  node_request_options["Request options<br/>[http.rs]"]
  node_request_prepare["Request preparation<br/>[http.rs]"]
  node_request_admission["Request admission<br/>[http.rs]"]
end

subgraph group_worker_runtime["Async runtime"]
  node_request_registry["Request registry<br/>[worker.rs]"]
  node_async_worker["Async worker<br/>[worker.rs]"]
  node_network_limit["Network concurrency<br/>[worker.rs]"]
  node_body_budget["Body buffering budget<br/>[worker.rs]"]
  node_callback_queue["Callback queue<br/>[worker.rs]"]
  node_request_stats["Request counters<br/>[worker.rs]"]
end

subgraph group_http_transport["HTTP transport"]
  node_http_client["HTTP client<br/>[worker.rs]"]
  node_retry_policy["Retry and backoff<br/>[http.rs]"]
  node_response_stream["Response buffering<br/>[http.rs]"]
end

node_gmod_server(("GMod Lua server"))
node_remote_service(("HTTP services"))

node_gmod_server -->|"loads extension"| node_lua_exports
node_lua_exports -->|"initializes"| node_async_worker
node_lua_exports -->|"registers request"| node_request_options
node_gmod_server -->|"submits options"| node_request_options
node_request_options -->|"parses and validates"| node_request_prepare
node_request_prepare -->|"requests resources"| node_request_admission
node_request_admission -->|"starts request"| node_request_stats
node_request_admission -->|"reserves capacity"| node_body_budget
node_request_admission -->|"registers request"| node_request_registry
node_request_admission -->|"spawns task"| node_async_worker
node_async_worker -->|"acquires permit"| node_network_limit
node_async_worker -->|"sends request"| node_http_client
node_http_client -->|"HTTP exchange"| node_remote_service
node_async_worker -->|"retries eligible requests"| node_retry_policy
node_retry_policy -.->|"resends request"| node_http_client
node_async_worker -->|"reads response"| node_response_stream
node_response_stream -->|"reserves body capacity"| node_body_budget
node_response_stream -->|"queues result"| node_callback_queue
node_async_worker -->|"queues failure"| node_callback_queue
node_callback_queue -->|"dispatches callbacks"| node_lua_callbacks
node_lua_callbacks -->|"returns result"| node_gmod_server
node_gmod_server -->|"cancels by ID"| node_cancel_api
node_cancel_api -->|"cancels request"| node_request_registry
node_gmod_server -->|"reads counters"| node_stats_api
node_stats_api -->|"snapshots counters"| node_request_stats
node_async_worker -->|"records outcomes"| node_request_stats

click node_lua_exports "https://github.com/itsdejavuuu/rhttp/blob/main/src/lib.rs"
click node_request_options "https://github.com/itsdejavuuu/rhttp/blob/main/src/http.rs"
click node_request_prepare "https://github.com/itsdejavuuu/rhttp/blob/main/src/http.rs"
click node_request_admission "https://github.com/itsdejavuuu/rhttp/blob/main/src/http.rs"
click node_request_registry "https://github.com/itsdejavuuu/rhttp/blob/main/src/worker.rs"
click node_async_worker "https://github.com/itsdejavuuu/rhttp/blob/main/src/worker.rs"
click node_network_limit "https://github.com/itsdejavuuu/rhttp/blob/main/src/worker.rs"
click node_body_budget "https://github.com/itsdejavuuu/rhttp/blob/main/src/worker.rs"
click node_http_client "https://github.com/itsdejavuuu/rhttp/blob/main/src/worker.rs"
click node_retry_policy "https://github.com/itsdejavuuu/rhttp/blob/main/src/http.rs"
click node_response_stream "https://github.com/itsdejavuuu/rhttp/blob/main/src/http.rs"
click node_callback_queue "https://github.com/itsdejavuuu/rhttp/blob/main/src/worker.rs"
click node_lua_callbacks "https://github.com/itsdejavuuu/rhttp/blob/main/src/worker.rs"
click node_cancel_api "https://github.com/itsdejavuuu/rhttp/blob/main/src/http.rs"
click node_stats_api "https://github.com/itsdejavuuu/rhttp/blob/main/src/http.rs"
click node_request_stats "https://github.com/itsdejavuuu/rhttp/blob/main/src/worker.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_lua_exports,node_lua_callbacks,node_cancel_api,node_stats_api toneBlue
class node_request_options,node_request_prepare,node_request_admission toneAmber
class node_request_registry,node_async_worker,node_network_limit,node_body_budget,node_callback_queue,node_request_stats,node_gmod_server toneMint
class node_http_client,node_retry_policy,node_response_stream toneRose
class node_remote_service toneIndigo
```

## Components

### Lua API

- [Lua exports](https://github.com/itsdejavuuu/rhttp/blob/main/src/lib.rs): `src/lib.rs`
- [Lua callbacks](https://github.com/itsdejavuuu/rhttp/blob/main/src/worker.rs): `src/worker.rs`
- [Cancellation API](https://github.com/itsdejavuuu/rhttp/blob/main/src/http.rs): `src/http.rs`
- [Statistics API](https://github.com/itsdejavuuu/rhttp/blob/main/src/http.rs): `src/http.rs`

### Request processing

- [Request options](https://github.com/itsdejavuuu/rhttp/blob/main/src/http.rs): `src/http.rs`
- [Request preparation](https://github.com/itsdejavuuu/rhttp/blob/main/src/http.rs): `src/http.rs`
- [Request admission](https://github.com/itsdejavuuu/rhttp/blob/main/src/http.rs): `src/http.rs`

### Async runtime

- [Request registry](https://github.com/itsdejavuuu/rhttp/blob/main/src/worker.rs): `src/worker.rs`
- [Async worker](https://github.com/itsdejavuuu/rhttp/blob/main/src/worker.rs): `src/worker.rs`
- [Network concurrency](https://github.com/itsdejavuuu/rhttp/blob/main/src/worker.rs): `src/worker.rs`
- [Body buffering budget](https://github.com/itsdejavuuu/rhttp/blob/main/src/worker.rs): `src/worker.rs`
- [Callback queue](https://github.com/itsdejavuuu/rhttp/blob/main/src/worker.rs): `src/worker.rs`
- [Request counters](https://github.com/itsdejavuuu/rhttp/blob/main/src/worker.rs): `src/worker.rs`

### HTTP transport

- [HTTP client](https://github.com/itsdejavuuu/rhttp/blob/main/src/worker.rs): `src/worker.rs`
- [Retry and backoff](https://github.com/itsdejavuuu/rhttp/blob/main/src/http.rs): `src/http.rs`
- [Response buffering](https://github.com/itsdejavuuu/rhttp/blob/main/src/http.rs): `src/http.rs`

### Other components

- **GMod Lua server**
- **HTTP services**

## Connections

- GMod Lua server → Lua exports: loads extension (evidence: `src/lib.rs`)
- Lua exports → Async worker: initializes (evidence: `src/lib.rs`)
- Lua exports → Request options: registers request (evidence: `src/lib.rs`)
- GMod Lua server → Request options: submits options (evidence: `README.md`)
- Request options → Request preparation: parses and validates (evidence: `src/http.rs`)
- Request preparation → Request admission: requests resources (evidence: `src/http.rs`)
- Request admission → Request counters: starts request (evidence: `src/http.rs`)
- Request admission → Body buffering budget: reserves capacity (evidence: `src/http.rs`)
- Request admission → Request registry: registers request (evidence: `src/http.rs`)
- Request admission → Async worker: spawns task (evidence: `src/http.rs`)
- Async worker → Network concurrency: acquires permit (evidence: `README.md`)
- Async worker → HTTP client: sends request (evidence: `src/http.rs`)
- HTTP client → HTTP services: HTTP exchange (evidence: `README.md`)
- Async worker → Retry and backoff: retries eligible requests (evidence: `README.md`)
- Retry and backoff → HTTP client: resends request (evidence: `src/http.rs`)
- Async worker → Response buffering: reads response (evidence: `src/http.rs`)
- Response buffering → Body buffering budget: reserves body capacity (evidence: `src/http.rs`)
- Response buffering → Callback queue: queues result (evidence: `src/http.rs`)
- Async worker → Callback queue: queues failure (evidence: `src/http.rs`)
- Callback queue → Lua callbacks: dispatches callbacks (evidence: `src/worker.rs`)
- Lua callbacks → GMod Lua server: returns result (evidence: `README.md`)
- GMod Lua server → Cancellation API: cancels by ID (evidence: `README.md`)
- Cancellation API → Request registry: cancels request (evidence: `src/http.rs`)
- GMod Lua server → Statistics API: reads counters (evidence: `README.md`)
- Statistics API → Request counters: snapshots counters (evidence: `src/http.rs`)
- Async worker → Request counters: records outcomes (evidence: `src/http.rs`)
