# s-you/pico.v architecture

> Architecture diagram of the GitHub repository s-you/pico.v, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/s-you/pico.v
- Repository: https://github.com/s-you/pico.v

## Overview

pico.v is described as a V web server based on picoev and picohttpparser. The README supports those dependencies, but the available excerpts do not show the server’s request-handling flow or the V wrappers’ behavior, so the graph stays at that documented level.

Main entry points: [`main.v`](https://github.com/s-you/pico.v/blob/master/main.v) (Server app), [`picoev/picoev.v`](https://github.com/s-you/pico.v/blob/master/picoev/picoev.v) (picoev V API), [`picohttpparser/picohttpparser.v`](https://github.com/s-you/pico.v/blob/master/picohttpparser/picohttpparser.v) (HTTP parser V API), [`picoev/picoev.c`](https://github.com/s-you/pico.v/blob/master/picoev/picoev.c) (picoev backend selector)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_server["Web server"]
  node_app["Server app<br/>[main.v]"]
end

subgraph group_io["Event I/O"]
  node_eventv["picoev V API<br/>[picoev.v]"]
  node_eventc["picoev backend selector<br/>[picoev.c]"]
end

subgraph group_http["HTTP parsing"]
  node_httpv["HTTP parser V API<br/>[picohttpparser.v]"]
  node_request["Request helpers<br/>[request.v]"]
  node_response["Response helpers<br/>[response.v]"]
  node_httpc["Parser C wrapper<br/>[picohttpparser.c]"]
end

node_client(("HTTP client"))

node_client -.->|"sends requests"| node_app
node_app -->|"based on"| node_eventv
node_app -->|"based on"| node_httpv
node_eventc -.->|"backs"| node_eventv
node_httpc -.->|"backs"| node_httpv

click node_app "https://github.com/s-you/pico.v/blob/master/main.v"
click node_eventv "https://github.com/s-you/pico.v/blob/master/picoev/picoev.v"
click node_eventc "https://github.com/s-you/pico.v/blob/master/picoev/picoev.c"
click node_httpv "https://github.com/s-you/pico.v/blob/master/picohttpparser/picohttpparser.v"
click node_request "https://github.com/s-you/pico.v/blob/master/picohttpparser/request.v"
click node_response "https://github.com/s-you/pico.v/blob/master/picohttpparser/response.v"
click node_httpc "https://github.com/s-you/pico.v/blob/master/picohttpparser/picohttpparser.c"

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_app,node_client toneBlue
class node_eventv,node_eventc toneAmber
class node_httpv,node_request,node_response,node_httpc toneMint
```

## Components

### Web server

- [Server app](https://github.com/s-you/pico.v/blob/master/main.v): `main.v`

### Event I/O

- [picoev V API](https://github.com/s-you/pico.v/blob/master/picoev/picoev.v): `picoev/picoev.v`
- [picoev backend selector](https://github.com/s-you/pico.v/blob/master/picoev/picoev.c): `picoev/picoev.c`

### HTTP parsing

- [HTTP parser V API](https://github.com/s-you/pico.v/blob/master/picohttpparser/picohttpparser.v): `picohttpparser/picohttpparser.v`
- [Request helpers](https://github.com/s-you/pico.v/blob/master/picohttpparser/request.v): `picohttpparser/request.v`
- [Response helpers](https://github.com/s-you/pico.v/blob/master/picohttpparser/response.v): `picohttpparser/response.v`
- [Parser C wrapper](https://github.com/s-you/pico.v/blob/master/picohttpparser/picohttpparser.c): `picohttpparser/picohttpparser.c`

### Other components

- **HTTP client**

## Connections

- HTTP client → Server app: sends requests
- Server app → picoev V API: based on (evidence: `README.md`)
- Server app → HTTP parser V API: based on (evidence: `README.md`)
- picoev backend selector → picoev V API: backs
- Parser C wrapper → HTTP parser V API: backs
