Quanto costa
l’astrazione?

attrs restituisce modifica, dimensione e tipo. tree_attrs elenca la directory e raccoglie gli attributi di ogni file. local_path ottiene un file locale temporaneo, lo legge interamente e ne include la pulizia.

La mediana e il p95 usano le latenze delle singole chiamate nei batch validi. Il p95 segue il metodo nearest-rank. Ops/s e throughput dividono il lavoro totale per la somma dei tempi di batch: non derivano dall’inverso della mediana. Un batch errato è escluso per intero dalle statistiche.

Il numero di byte selezionato non descrive il payload del listing: per le prove di directory i file contengono 12 byte ciascuno. L’avvio client ha una sola osservazione; il suo p95 non è statisticamente informativo.

Dalla radice del repository, dopo aver installato le dipendenze del benchmark e del legacy:

python -m pip install -e '.[benchmark,dev]'
export BENCH_LEGACY_ROOT=/percorso/al/checkout/genropy
python -m pip install -e "$BENCH_LEGACY_ROOT/gnrpy"

docker compose -p genro-storage-bench \
  -f benchmarks/compose.yaml up -d --wait

# 1. File piccoli
python -m benchmarks --smoke --create-bucket

# 2. Trasferimenti da 1 e 32 MiB
python -m benchmarks --sizes 1048576 33554432 \
  --operations read write copy move local_path \
  --workers 1 4 --list-count 8 --repeats 3 --caches cold

# 3. Cinque versioni per chiave
python -m benchmarks --smoke --enable-versioning --history 5 \
  --adapters legacy genro genro-unversioned s3fs \
  --operations attrs listing tree_attrs --workers 1 --sizes 1024

# 4–5. Matrice prima/dopo, su bucket non versionato
# Eseguire sul sorgente originale e su quello ottimizzato, senza test concorrenti.
BENCH_S3_BUCKET=genro-storage-before-after python -m benchmarks --create-bucket \
  --adapters legacy genro --sizes 1024 33554432 \
  --workers 1 --repeats 9 --list-count 8 --caches cold

# Test della suite sul servizio reale
MINIO_ENDPOINT=http://127.0.0.1:29000 BENCH_TEST_ENDPOINT=http://127.0.0.1:29000 \
  python -m pytest tests benchmarks/tests -q -o addopts='' -p no:cacheprovider

Per Hetzner: impostare BENCH_S3_ENDPOINT, BENCH_S3_BUCKET, BENCH_S3_REGION, BENCH_S3_ACCESS_KEY e BENCH_S3_SECRET_KEY nell’ambiente, poi usare python -m benchmarks --target hetzner --smoke. Le credenziali non devono essere inserite in questo documento.