Module upload_probe 

Upload instrumentation and experimental upload strategies (enabled via RANIM_PROFILE_UPLOAD). Lightweight upload instrumentation for the queue.write_buffer paths, recording bytes / calls / CPU time per buffer label. Enabled via RANIM_PROFILE_UPLOAD=1 (or set_mode at runtime, e.g. from the preview profiler panel); a no-op (one atomic read per upload) unless enabled.

This is the stable counting core. Experimental upload strategies (skip-identical / dirty-range uploads) live on a separate branch and extend this module.

Structs

Counters 🔒

UploadStats

Snapshot of the counters accumulated since the last take_stats.

Enums

UploadMode

Upload instrumentation mode, seeded from RANIM_PROFILE_UPLOAD and runtime-switchable via set_mode.

Statics

MODE 🔒

u8::MAX marks “not seeded from the environment yet”.

MODE_SEEDED 🔒

Functions

label_or 🔒

mode

The process-wide upload mode (seeded from RANIM_PROFILE_UPLOAD on first use, overridable at runtime via set_mode).

record 🔒

Record one upload for label.

registry 🔒

set_mode

Switch the process-wide upload mode at runtime (takes effect for uploads after this call).

take_stats

Take and reset the accumulated stats, per buffer label.