# alizbeeb5/reliable-udp-transfer architecture

> Architecture diagram of the GitHub repository alizbeeb5/reliable-udp-transfer, 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/alizbeeb5/reliable-udp-transfer
- Repository: https://github.com/alizbeeb5/reliable-udp-transfer

## Overview

This repository implements a one-file reliable UDP transfer: the sender chunks and encodes a file, then transmits DATA and END packets through a simulated-loss channel under a sliding-window retransmission strategy. The receiver buffers out-of-order packets, writes the completed file, and checks its SHA-256 digest; cumulative ACKs travel back to the sender. Edges reflect the sampled sender, receiver, packetizer, channel, and protocol code plus README-described behavior. The window’s detailed internal logic is sampled, but the wire behavior is documented in the README.

Main entry points: [`receiver.py`](https://github.com/alizbeeb5/reliable-udp-transfer/blob/main/receiver.py) (Receiver loop), [`sender.py`](https://github.com/alizbeeb5/reliable-udp-transfer/blob/main/sender.py) (Sender loop), [`protocol.py`](https://github.com/alizbeeb5/reliable-udp-transfer/blob/main/protocol.py) (Packet codec), [`packetizer.py`](https://github.com/alizbeeb5/reliable-udp-transfer/blob/main/packetizer.py) (File packetizer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_prepare["Transfer preparation"]
  node_input_file["Input file"]
  node_packetizer["File packetizer<br/>[packetizer.py]"]
end

subgraph group_send["Sender reliability"]
  node_sender["Sender loop<br/>[sender.py]"]
  node_window["Sliding window<br/>[window.py]"]
  node_channel["Loss and reorder<br/>[channel.py]"]
end

subgraph group_receive["Receiver and output"]
  node_receiver["Receiver loop<br/>[receiver.py]"]
  node_file_output["Received file<br/>[receiver.py]"]
  node_digest_check["SHA-256 check<br/>[receiver.py]"]
end

subgraph group_wire["Wire protocol"]
  node_codec["Packet codec<br/>[protocol.py]"]
end

node_sender_user(("File sender"))
node_udp{{"UDP transport"}}

node_sender_user -->|"starts transfer"| node_sender
node_sender -->|"prepares file"| node_packetizer
node_input_file -->|"reads bytes"| node_packetizer
node_packetizer -->|"encodes packets"| node_codec
node_sender -->|"drives window"| node_window
node_sender -->|"creates channel"| node_channel
node_window -->|"sends datagrams"| node_channel
node_channel -->|"sends datagrams"| node_udp
node_udp -->|"delivers packets"| node_receiver
node_receiver -->|"decodes packets"| node_codec
node_receiver -->|"writes completed file"| node_file_output
node_receiver -->|"checks digest"| node_digest_check
node_digest_check -->|"reads written bytes"| node_file_output
node_receiver -->|"encodes ACKs"| node_codec
node_receiver -->|"sends ACKs"| node_udp
node_udp -->|"delivers ACKs"| node_sender
node_sender -->|"decodes ACKs"| node_codec

click node_packetizer "https://github.com/alizbeeb5/reliable-udp-transfer/blob/main/packetizer.py"
click node_sender "https://github.com/alizbeeb5/reliable-udp-transfer/blob/main/sender.py"
click node_window "https://github.com/alizbeeb5/reliable-udp-transfer/blob/main/window.py"
click node_channel "https://github.com/alizbeeb5/reliable-udp-transfer/blob/main/channel.py"
click node_receiver "https://github.com/alizbeeb5/reliable-udp-transfer/blob/main/receiver.py"
click node_file_output "https://github.com/alizbeeb5/reliable-udp-transfer/blob/main/receiver.py"
click node_digest_check "https://github.com/alizbeeb5/reliable-udp-transfer/blob/main/receiver.py"
click node_codec "https://github.com/alizbeeb5/reliable-udp-transfer/blob/main/protocol.py"

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_input_file,node_packetizer toneBlue
class node_sender,node_window,node_channel toneAmber
class node_receiver,node_file_output,node_digest_check toneMint
class node_codec toneRose
class node_sender_user,node_udp toneIndigo
```

## Components

### Transfer preparation

- **Input file**
- [File packetizer](https://github.com/alizbeeb5/reliable-udp-transfer/blob/main/packetizer.py): `packetizer.py`

### Sender reliability

- [Sender loop](https://github.com/alizbeeb5/reliable-udp-transfer/blob/main/sender.py): `sender.py`
- [Sliding window](https://github.com/alizbeeb5/reliable-udp-transfer/blob/main/window.py): `window.py`
- [Loss and reorder](https://github.com/alizbeeb5/reliable-udp-transfer/blob/main/channel.py): `channel.py`

### Receiver and output

- [Receiver loop](https://github.com/alizbeeb5/reliable-udp-transfer/blob/main/receiver.py): `receiver.py`
- [Received file](https://github.com/alizbeeb5/reliable-udp-transfer/blob/main/receiver.py): `receiver.py`
- [SHA-256 check](https://github.com/alizbeeb5/reliable-udp-transfer/blob/main/receiver.py): `receiver.py`

### Wire protocol

- [Packet codec](https://github.com/alizbeeb5/reliable-udp-transfer/blob/main/protocol.py): `protocol.py`

### Other components

- **File sender**
- **UDP transport**

## Connections

- File sender → Sender loop: starts transfer (evidence: `README.md`)
- Sender loop → File packetizer: prepares file (evidence: `sender.py`)
- Input file → File packetizer: reads bytes (evidence: `packetizer.py`)
- File packetizer → Packet codec: encodes packets (evidence: `packetizer.py`)
- Sender loop → Sliding window: drives window (evidence: `sender.py`)
- Sender loop → Loss and reorder: creates channel (evidence: `sender.py`)
- Sliding window → Loss and reorder: sends datagrams (evidence: `sender.py`)
- Loss and reorder → UDP transport: sends datagrams (evidence: `channel.py`)
- UDP transport → Receiver loop: delivers packets (evidence: `README.md`)
- Receiver loop → Packet codec: decodes packets (evidence: `receiver.py`)
- Receiver loop → Received file: writes completed file (evidence: `receiver.py`)
- Receiver loop → SHA-256 check: checks digest (evidence: `receiver.py`)
- SHA-256 check → Received file: reads written bytes (evidence: `receiver.py`)
- Receiver loop → Packet codec: encodes ACKs (evidence: `receiver.py`)
- Receiver loop → UDP transport: sends ACKs (evidence: `receiver.py`)
- UDP transport → Sender loop: delivers ACKs (evidence: `sender.py`)
- Sender loop → Packet codec: decodes ACKs (evidence: `sender.py`)
