#!/usr/bin/env python3
"""Genera un _index.html per ogni cartella del sito, con l'elenco dei file
ordinato per data di ultima modifica (più recenti in cima).
Va rilanciato prima di ogni deploy: i file generati SONO la homepage e le
pagine-indice di ogni cartella. Non modificarli a mano, vengono sovrascritti
a ogni esecuzione.
Uso:
python3 scripts/generate-index.py
"""
import os
from datetime import datetime
ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
# Cartelle mai indicizzate né deployate (lavoro interno, chiavi, backup locali)
EXCLUDE_DIRS = {
".claude", ".git", "ssh-deploy-key", "_backup-locali",
"__pycache__", "node_modules",
}
# File specifici mai indicizzati né deployati
EXCLUDE_FILES = {"REMOTE.md"}
EXCLUDE_SUFFIXES = (".zip", ".pyc")
INDEX_NAME = "_index.html"
def human_size(n):
size = float(n)
for unit in ("B", "KB", "MB", "GB"):
if size < 1024:
return f"{size:.0f} {unit}" if unit == "B" else f"{size:.1f} {unit}"
size /= 1024
return f"{size:.1f} TB"
def should_skip_file(name):
return (
name == INDEX_NAME
or name in EXCLUDE_FILES
or name.startswith(".")
or name.endswith(EXCLUDE_SUFFIXES)
)
def build_index(dirpath):
entries = []
with os.scandir(dirpath) as it:
for e in it:
if e.is_dir(follow_symlinks=False):
if e.name in EXCLUDE_DIRS or e.name.startswith("."):
continue
st = e.stat()
entries.append((e.name + "/", st.st_mtime, None, True))
else:
if should_skip_file(e.name):
continue
st = e.stat()
entries.append((e.name, st.st_mtime, st.st_size, False))
# Ordine richiesto: per data di ultima modifica, più recenti in cima.
entries.sort(key=lambda x: x[1], reverse=True)
rel = os.path.relpath(dirpath, ROOT)
title = "San Marco Vision — indice" if rel == "." else f"San Marco Vision — {rel}/"
rows = []
if rel != ".":
rows.append('| .. (cartella superiore) | | |
')
for name, mtime, size, is_dir in entries:
dt = datetime.fromtimestamp(mtime).strftime("%d/%m/%Y %H:%M")
size_str = "" if is_dir else human_size(size)
rows.append(
f'| {name} | '
f'{dt} | {size_str} |
'
)
html = f"""
{title}
San Marco Vision · indice cartella
{title}
| Nome | Ultima modifica | Dimensione |
|---|
{''.join(rows)}
"""
with open(os.path.join(dirpath, INDEX_NAME), "w", encoding="utf-8") as f:
f.write(html)
def walk_and_build():
count = 0
for dirpath, dirnames, _filenames in os.walk(ROOT):
dirnames[:] = sorted(d for d in dirnames if d not in EXCLUDE_DIRS and not d.startswith("."))
build_index(dirpath)
count += 1
return count
if __name__ == "__main__":
n = walk_and_build()
print(f"Generati {n} file {INDEX_NAME} (uno per cartella), ordinati per ultima modifica.")