nodeview-slurm 0.1.0__py3-none-any.whl

nodeview/i18n.py

@@ -0,0 +1,455 @@
+"""Interface translation.
+
+Two languages, Italian and English. Keys are stable and descriptive; if one is
+missing we fall back to Italian and, as a last resort, to the key itself: a
+forgotten translation must leave the application usable, not break it.
+
+The language is chosen from the command palette (ctrl+p) and is remembered.
+"""
+from __future__ import annotations
+
+LANGUAGES = {'it': 'Italiano', 'en': 'English'}
+DEFAULT = 'it'
+
+IT = {
+    # --- key bindings ----------------------------------------------------
+    'bind.quit': "esci",
+    'bind.reload': "aggiorna",
+    'bind.me': "io",
+    'bind.cluster': "cluster",
+    'bind.queue': "coda",
+    'bind.manual': "manuale",
+    'bind.theme': "tema",
+    'bind.only_free': "solo liberi",
+    'bind.only_mine': "solo i miei",
+    'bind.search': "cerca",
+    'bind.leave_search': "lascia la ricerca",
+
+    # --- cards -----------------------------------------------------------
+    'card.my_jobs': "I MIEI JOB",
+    'card.fit': "DOVE ENTRO ADESSO",
+    'card.cluster': "CLUSTER",
+    'card.account': "IL MIO ACCOUNT",
+    'card.totals': "IL CLUSTER IN TRE NUMERI",
+    'card.nodes': "NODI",
+    'card.nodes_free': "NODI · solo quelli con GPU libere",
+    'card.usage': "CHI STA USANDO IL CLUSTER",
+    'card.specs': "SPECIFICHE DEI NODI",
+    'card.queue': "CODA",
+    'card.queue_mine': "CODA · solo i miei",
+    'card.manual': "COMANDI DEL CLUSTER",
+
+    # --- application -----------------------------------------------------
+    'app.loading': "lettura in corso…",
+    'app.subtitle': "{me}  ·  {nodes} nodi  ·  aggiornato {when} in {secs}s",
+    'app.read_error': "errore di lettura",
+    'app.slurm_down': "Slurm non risponde",
+    'app.theme_set': "tema: {theme}",
+    'app.lang_set': "lingua: {lang}",
+    'app.search_placeholder': "premi / per cercare per utente, nome o id · esc per uscire",
+    'app.cmd_language': "Lingua: {lang}",
+    'app.cmd_language_help': "usa l'interfaccia in {lang}",
+
+    # --- columns ---------------------------------------------------------
+    'col.id': "ID",
+    'col.name': "NOME",
+    'col.state': "ST",
+    'col.gpu': "GPU",
+    'col.ram': "RAM",
+    'col.time': "TEMPO",
+    'col.where_why': "DOVE / PERCHE'",
+    'col.user': "UTENTE",
+    'col.group': "GRUPPO",
+    'col.node': "NODO",
+    'col.used': "USO",
+    'col.model': "MODELLO",
+    'col.cpu': "CPU",
+    'col.status': "STATO",
+    'col.occupied_by': "CHI OCCUPA",
+    'col.gpu_model': "MODELLO GPU",
+    'col.usage': "uso",
+    'col.unix_group': "GRUPPO UNIX",
+    'col.account': "ACCOUNT",
+    'col.topology': "TOPOLOGIA",
+    'col.disk': "DISCO",
+    'col.partitions': "PARTIZIONI",
+    'col.weight': "PESO",
+    'col.uptime': "ACCESO DA",
+
+    # --- my jobs ---------------------------------------------------------
+    'job.none': "nessun job in esecuzione, nessuno in coda",
+    'job.running_short': "RUN",
+    'job.pending_short': "ATT",
+    'job.quota': "quota GPU  ",
+    'job.no_limit': "nessun limite noto",
+    'job.can_ask': "   puoi ancora chiedere ",
+    'job.gpus': "{n} GPU",
+    'job.by_group': "GPU per gruppo  ",
+
+    # --- where I fit -----------------------------------------------------
+    'fit.over_quota': "oltre il tuo limite per utente ({limit}): ",
+    'fit.left': "te ne restano {n}",
+    'fit.none': "nessun nodo libero adesso",
+    'fit.now_on': "subito su ",
+    'fit.roomiest': "   (piu' capiente: {node}, {gpus} GPU e {mem} liberi)",
+    'fit.free_ram': "        RAM piu' libera  ",
+
+    # --- cluster ---------------------------------------------------------
+    'cluster.free': "      libere ",
+    'cluster.queued': "      in coda ",
+    'cluster.running': "      in esecuzione ",
+    'cluster.free_on': "libere ",
+    'cluster.free_nodes': " su {n} nodi prenotabili",
+    'cluster.real_load': "carico reale ",
+    'cluster.of_allocated': " ({pct}% di quelle allocate)",
+    'cluster.unallocated': "non allocata ",
+    'cluster.n_nodes': "{n} nodi",
+    'cluster.n_models': "{n} modelli di GPU",
+    'cluster.n_down': "{n} giu'",
+    'cluster.n_drain': "{n} in drain",
+
+    # --- nodes -----------------------------------------------------------
+    'node.free': "libero",
+    'node.cpu_only': "solo cpu",
+    'node.partial': "parziale",
+    'node.full': "pieno",
+    'node.reserved': "riservato",
+    'node.drain': "drain",
+    'node.down': "giu",
+    'node.empty': "libero",
+    'node.cpu_job': " (cpu)",
+    'node.legend': "chi occupa  ",
+    'node.you': " (tu)",
+    'node.others': "altri {n}",
+    'node.no_gpu_used': "nessuna GPU occupata",
+
+    # --- my account ------------------------------------------------------
+    'acct.none': "nessuna informazione disponibile su questo cluster",
+    'acct.budget_spent': "budget di {project} esaurito ({pct}%)",
+    'acct.disk_full': "disco {fs} di {owner} quasi pieno ({pct}%)",
+    'acct.expiring': "utenza in scadenza fra {n} giorni",
+    'acct.expiration': "  scadenza utenza        ",
+    'acct.in_days': "   fra {n} giorni",
+    'acct.budget_title': "  BUDGET DI CALCOLO",
+    'acct.budget_sub': "   ore standard, consumo totale",
+    'acct.exhausted': "esaurito",
+    'acct.quota_title': "  QUOTE DISCO",
+    'acct.fairshare': "  FAIRSHARE               ",
+    'acct.fairshare_hint': "                          piu' e' basso, piu' hai gia' "
+                           "consumato rispetto alla tua fetta",
+    'acct.last_days': "  ULTIMI {n} GIORNI          ",
+    'acct.completed': "{n} completati",
+    'acct.failed': "{n} falliti",
+    'acct.cancelled': "{n} annullati",
+    'acct.timeout': "{n} scaduti",
+    'acct.accounts': "  ACCOUNT                 ",
+    'acct.qos': "  QOS                     ",
+
+    # --- pending reasons -------------------------------------------------
+    'reason.unknown.label': "in valutazione",
+    'reason.unknown.detail': "lo scheduler la sta ancora guardando",
+    'reason.QOSGrpGRES.label': "quota GPU di gruppo esaurita",
+    'reason.QOSGrpGRES.detail': "il gruppo ha gia' tutte le GPU che gli spettano",
+    'reason.QOSGrpGRESMinutes.label': "budget GPU di gruppo esaurito",
+    'reason.QOSGrpGRESMinutes.detail': "il gruppo ha finito le GPU-minuto",
+    'reason.QOSGrpMemLimit.label': "quota RAM di gruppo esaurita",
+    'reason.QOSGrpMemLimit.detail': "il gruppo ha gia' tutta la RAM che gli spetta",
+    'reason.QOSGrpCpuLimit.label': "quota CPU di gruppo esaurita",
+    'reason.QOSGrpCpuLimit.detail': "il gruppo ha gia' tutte le CPU che gli spettano",
+    'reason.QOSMaxGRESPerUser.label': "limite GPU per utente raggiunto",
+    'reason.QOSMaxGRESPerUser.detail': "quell'utente ha gia' il massimo di GPU",
+    'reason.QOSMaxCpuPerUserLimit.label': "limite CPU per utente raggiunto",
+    'reason.QOSMaxCpuPerUserLimit.detail': "quell'utente ha gia' il massimo di CPU",
+    'reason.QOSMaxMemPerUser.label': "limite RAM per utente raggiunto",
+    'reason.QOSMaxMemPerUser.detail': "quell'utente ha gia' il massimo di RAM",
+    'reason.QOSMaxJobsPerUserLimit.label': "limite di job per utente raggiunto",
+    'reason.QOSMaxJobsPerUserLimit.detail': "quell'utente ha gia' troppi job attivi",
+    'reason.Dependency.label': "attende un altro job",
+    'reason.Dependency.detail': "parte quando finisce il job da cui dipende",
+    'reason.Resources.label': "risorse occupate",
+    'reason.Resources.detail': "le GPU o i nodi richiesti sono tutti presi",
+    'reason.Priority.label': "priorita' piu' bassa",
+    'reason.Priority.detail': "altri job in coda passano prima",
+    'reason.BeginTime.label': "avvio programmato",
+    'reason.BeginTime.detail': "partira' all'orario richiesto",
+    'reason.ReqNodeNotAvail.label': "nodo non disponibile",
+    'reason.ReqNodeNotAvail.detail': "il nodo richiesto e' spento o riservato",
+    'reason.JobArrayTaskLimit.label': "limite di array",
+    'reason.JobArrayTaskLimit.detail': "troppe task dell'array gia' in esecuzione",
+
+    # --- summary lines and warnings --------------------------------------
+    'head.quota_not_gpus': "{n} job su {total} sono fermi: {label}. "
+                           "Non mancano le GPU, ce ne sono {free} libere.",
+    'head.all_busy': "{n} job aspettano risorse: tutte le GPU utilizzabili sono occupate.",
+    'head.generic': "{n} job su {total} sono in coda: {label}.",
+    'warn.down': "{n} {noun} giu': {nodes}",
+    'warn.drain': "{n} {noun} in drain: {nodes}",
+    'warn.reserved': "{n} {noun}: {nodes}",
+    'warn.node_one': "nodo",
+    'warn.node_many': "nodi",
+    'warn.reserved_one': "nodo riservato",
+    'warn.reserved_many': "nodi riservati",
+    'warn.maint_planned': "manutenzione programmata su {where}",
+    'warn.maint': "manutenzione {when} ({date}){lasting} su {where}",
+    'warn.maint_now': "IN CORSO",
+    'warn.maint_hours': "fra {n}h",
+    'warn.maint_days': "fra {n} {noun}",
+    'warn.lasting': ", dura {n} {noun}",
+    'warn.day_one': "giorno",
+    'warn.day_many': "giorni",
+    'warn.whole_cluster': "tutto il cluster",
+    'warn.n_nodes_sample': "{n} nodi ({sample}, ...)",
+    'time.hours': "{n}h",
+
+    # --- static snapshot -------------------------------------------------
+    'once.header': "{me} · {nodes} nodi · letto alle {when} in {secs}s",
+    'once.error': "impossibile leggere lo stato di Slurm:",
+    'src.missing': "nodeocc non risulta installato: serve per leggere job e limiti.\n"
+                   "Installalo con:  pip install --user nodeocc",
+    'src.scontrol_failed': "scontrol show node fallito: {err}",
+
+    # --- fallbacks -------------------------------------------------------
+    'na': "n/d",
+    'fallback.group': "sconosciuto",
+    'fallback.account': "senza account",
+    'fallback.job_name': "(senza nome)",
+}
+
+EN = {
+    'bind.quit': "quit",
+    'bind.reload': "refresh",
+    'bind.me': "me",
+    'bind.cluster': "cluster",
+    'bind.queue': "queue",
+    'bind.manual': "manual",
+    'bind.theme': "theme",
+    'bind.only_free': "free only",
+    'bind.only_mine': "mine only",
+    'bind.search': "search",
+    'bind.leave_search': "leave search",
+
+    'card.my_jobs': "MY JOBS",
+    'card.fit': "WHERE I FIT RIGHT NOW",
+    'card.cluster': "CLUSTER",
+    'card.account': "MY ACCOUNT",
+    'card.totals': "THE CLUSTER IN THREE NUMBERS",
+    'card.nodes': "NODES",
+    'card.nodes_free': "NODES · only those with free GPUs",
+    'card.usage': "WHO IS USING THE CLUSTER",
+    'card.specs': "NODE SPECIFICATIONS",
+    'card.queue': "QUEUE",
+    'card.queue_mine': "QUEUE · mine only",
+    'card.manual': "CLUSTER COMMANDS",
+
+    'app.loading': "reading…",
+    'app.subtitle': "{me}  ·  {nodes} nodes  ·  updated {when} in {secs}s",
+    'app.read_error': "read error",
+    'app.slurm_down': "Slurm is not responding",
+    'app.theme_set': "theme: {theme}",
+    'app.lang_set': "language: {lang}",
+    'app.search_placeholder': "press / to search by user, name or id · esc to leave",
+    'app.cmd_language': "Language: {lang}",
+    'app.cmd_language_help': "use the interface in {lang}",
+
+    'col.id': "ID",
+    'col.name': "NAME",
+    'col.state': "ST",
+    'col.gpu': "GPU",
+    'col.ram': "RAM",
+    'col.time': "TIME",
+    'col.where_why': "WHERE / WHY",
+    'col.user': "USER",
+    'col.group': "GROUP",
+    'col.node': "NODE",
+    'col.used': "USED",
+    'col.model': "MODEL",
+    'col.cpu': "CPU",
+    'col.status': "STATUS",
+    'col.occupied_by': "OCCUPIED BY",
+    'col.gpu_model': "GPU MODEL",
+    'col.usage': "in use",
+    'col.unix_group': "UNIX GROUP",
+    'col.account': "ACCOUNT",
+    'col.topology': "TOPOLOGY",
+    'col.disk': "DISK",
+    'col.partitions': "PARTITIONS",
+    'col.weight': "WEIGHT",
+    'col.uptime': "UP FOR",
+
+    'job.none': "no job running, none queued",
+    'job.running_short': "RUN",
+    'job.pending_short': "WAIT",
+    'job.quota': "GPU quota  ",
+    'job.no_limit': "no known limit",
+    'job.can_ask': "   you can still ask for ",
+    'job.gpus': "{n} GPUs",
+    'job.by_group': "GPUs per group  ",
+
+    'fit.over_quota': "beyond your per-user limit ({limit}): ",
+    'fit.left': "{n} left",
+    'fit.none': "no free node right now",
+    'fit.now_on': "right away on ",
+    'fit.roomiest': "   (roomiest: {node}, {gpus} GPUs and {mem} free)",
+    'fit.free_ram': "        most free RAM  ",
+
+    'cluster.free': "      free ",
+    'cluster.queued': "      queued ",
+    'cluster.running': "      running ",
+    'cluster.free_on': "free ",
+    'cluster.free_nodes': " across {n} bookable nodes",
+    'cluster.real_load': "actual load ",
+    'cluster.of_allocated': " ({pct}% of those allocated)",
+    'cluster.unallocated': "unallocated ",
+    'cluster.n_nodes': "{n} nodes",
+    'cluster.n_models': "{n} GPU models",
+    'cluster.n_down': "{n} down",
+    'cluster.n_drain': "{n} draining",
+
+    'node.free': "free",
+    'node.cpu_only': "cpu only",
+    'node.partial': "partial",
+    'node.full': "full",
+    'node.reserved': "reserved",
+    'node.drain': "drain",
+    'node.down': "down",
+    'node.empty': "free",
+    'node.cpu_job': " (cpu)",
+    'node.legend': "occupied by  ",
+    'node.you': " (you)",
+    'node.others': "{n} others",
+    'node.no_gpu_used': "no GPU in use",
+
+    'acct.none': "no information available on this cluster",
+    'acct.budget_spent': "{project} budget exhausted ({pct}%)",
+    'acct.disk_full': "disk {fs} for {owner} almost full ({pct}%)",
+    'acct.expiring': "account expires in {n} days",
+    'acct.expiration': "  account expires        ",
+    'acct.in_days': "   in {n} days",
+    'acct.budget_title': "  COMPUTE BUDGET",
+    'acct.budget_sub': "   standard hours, total consumption",
+    'acct.exhausted': "exhausted",
+    'acct.quota_title': "  DISK QUOTAS",
+    'acct.fairshare': "  FAIRSHARE               ",
+    'acct.fairshare_hint': "                          the lower it is, the more you have "
+                           "already used of your share",
+    'acct.last_days': "  LAST {n} DAYS             ",
+    'acct.completed': "{n} completed",
+    'acct.failed': "{n} failed",
+    'acct.cancelled': "{n} cancelled",
+    'acct.timeout': "{n} timed out",
+    'acct.accounts': "  ACCOUNTS                ",
+    'acct.qos': "  QOS                     ",
+
+    'reason.unknown.label': "under evaluation",
+    'reason.unknown.detail': "the scheduler is still looking at it",
+    'reason.QOSGrpGRES.label': "group GPU quota exhausted",
+    'reason.QOSGrpGRES.detail': "the group already holds every GPU it is entitled to",
+    'reason.QOSGrpGRESMinutes.label': "group GPU budget exhausted",
+    'reason.QOSGrpGRESMinutes.detail': "the group has run out of GPU-minutes",
+    'reason.QOSGrpMemLimit.label': "group RAM quota exhausted",
+    'reason.QOSGrpMemLimit.detail': "the group already holds all the RAM it is entitled to",
+    'reason.QOSGrpCpuLimit.label': "group CPU quota exhausted",
+    'reason.QOSGrpCpuLimit.detail': "the group already holds all the CPUs it is entitled to",
+    'reason.QOSMaxGRESPerUser.label': "per-user GPU limit reached",
+    'reason.QOSMaxGRESPerUser.detail': "that user already has the maximum number of GPUs",
+    'reason.QOSMaxCpuPerUserLimit.label': "per-user CPU limit reached",
+    'reason.QOSMaxCpuPerUserLimit.detail': "that user already has the maximum number of CPUs",
+    'reason.QOSMaxMemPerUser.label': "per-user RAM limit reached",
+    'reason.QOSMaxMemPerUser.detail': "that user already has the maximum amount of RAM",
+    'reason.QOSMaxJobsPerUserLimit.label': "per-user job limit reached",
+    'reason.QOSMaxJobsPerUserLimit.detail': "that user already has too many active jobs",
+    'reason.Dependency.label': "waiting for another job",
+    'reason.Dependency.detail': "it starts when the job it depends on finishes",
+    'reason.Resources.label': "resources busy",
+    'reason.Resources.detail': "the requested GPUs or nodes are all taken",
+    'reason.Priority.label': "lower priority",
+    'reason.Priority.detail': "other queued jobs go first",
+    'reason.BeginTime.label': "scheduled start",
+    'reason.BeginTime.detail': "it will start at the requested time",
+    'reason.ReqNodeNotAvail.label': "node unavailable",
+    'reason.ReqNodeNotAvail.detail': "the requested node is off or reserved",
+    'reason.JobArrayTaskLimit.label': "array limit",
+    'reason.JobArrayTaskLimit.detail': "too many array tasks already running",
+
+    'head.quota_not_gpus': "{n} of {total} jobs are stuck: {label}. "
+                           "GPUs are not the problem, {free} are free.",
+    'head.all_busy': "{n} jobs are waiting for resources: every usable GPU is taken.",
+    'head.generic': "{n} of {total} jobs are queued: {label}.",
+    'warn.down': "{n} {noun} down: {nodes}",
+    'warn.drain': "{n} {noun} draining: {nodes}",
+    'warn.reserved': "{n} {noun}: {nodes}",
+    'warn.node_one': "node",
+    'warn.node_many': "nodes",
+    'warn.reserved_one': "reserved node",
+    'warn.reserved_many': "reserved nodes",
+    'warn.maint_planned': "maintenance planned on {where}",
+    'warn.maint': "maintenance {when} ({date}){lasting} on {where}",
+    'warn.maint_now': "UNDER WAY",
+    'warn.maint_hours': "in {n}h",
+    'warn.maint_days': "in {n} {noun}",
+    'warn.lasting': ", lasting {n} {noun}",
+    'warn.day_one': "day",
+    'warn.day_many': "days",
+    'warn.whole_cluster': "the whole cluster",
+    'warn.n_nodes_sample': "{n} nodes ({sample}, ...)",
+    'time.hours': "{n}h",
+
+    'once.header': "{me} · {nodes} nodes · read at {when} in {secs}s",
+    'once.error': "cannot read the Slurm status:",
+    'src.missing': "nodeocc does not appear to be installed: it is needed to read jobs "
+                   "and limits.\nInstall it with:  pip install --user nodeocc",
+    'src.scontrol_failed': "scontrol show node failed: {err}",
+
+    'na': "n/a",
+    'fallback.group': "unknown",
+    'fallback.account': "no account",
+    'fallback.job_name': "(no name)",
+}
+
+CATALOGS = {'it': IT, 'en': EN}
+
+_lang = DEFAULT
+
+
+def active() -> str:
+    return _lang
+
+
+def use(lang: str) -> bool:
+    global _lang
+    if lang in CATALOGS:
+        _lang = lang
+        return True
+    return False
+
+
+def language_name(lang: str) -> str:
+    return LANGUAGES.get(lang, lang)
+
+
+def t(key: str, **kwargs) -> str:
+    """Translated text. If missing, fall back to Italian, then to the key."""
+    text = CATALOGS.get(_lang, IT).get(key)
+    if text is None:
+        text = IT.get(key, key)
+    if kwargs:
+        try:
+            return text.format(**kwargs)
+        except (KeyError, IndexError, ValueError):
+            return text
+    return text
+
+
+def pick(pair, lang: str | None = None) -> str:
+    """For texts kept inline as an (italian, english) pair."""
+    if isinstance(pair, (tuple, list)) and len(pair) == 2:
+        return pair[0] if (lang or _lang) == 'it' else pair[1]
+    return str(pair)
+
+
+def missing() -> dict:
+    """Keys present in one language but not the other: used by the checks."""
+    return {
+        'solo_it': sorted(set(IT) - set(EN)),
+        'solo_en': sorted(set(EN) - set(IT)),
+    }

nodeview/manual.py

@@ -0,0 +1,176 @@
+"""The content of the "manual" page.
+
+Only commands that actually exist on this cluster: `seff` and `sview` are not
+there, so they do not appear. Each entry takes two lines, description and
+example, and the descriptions are kept short on purpose so they don't wrap on
+narrow terminals.
+
+Here the texts are data, not interface: keeping the two languages inline, side
+by side, is easier to read and fix than forty keys scattered across the
+catalog. The command and the example are not translated.
+"""
+from __future__ import annotations
+
+from .i18n import pick
+
+# (section title, [(command, description, example)]), with texts as (it, en)
+SECTIONS = [
+    (("LANCIARE", "SUBMITTING"), [
+        ("sbatch",
+         ("accoda uno script e ti ridà subito il prompt",
+          "queues a script and gives you the prompt back"),
+         "sbatch train.sh"),
+        ("srun",
+         ("esegue subito e resta attaccato al terminale",
+          "runs now and stays attached to the terminal"),
+         "srun --gres=gpu:1 --pty bash"),
+        ("salloc",
+         ("riserva risorse e ti apre una shell sopra",
+          "reserves resources and opens a shell on them"),
+         "salloc --gres=gpu:1 -t 1:00:00"),
+        ("sbcast",
+         ("copia un file sui nodi del job prima di usarlo",
+          "copies a file onto the job's nodes before use"),
+         "sbcast data.bin /tmp/data.bin"),
+        ("scrontab",
+         ("job ricorrenti, come cron ma dentro Slurm",
+          "recurring jobs, like cron but inside Slurm"),
+         "scrontab -e"),
+    ]),
+    (("GUARDARE", "INSPECTING"), [
+        ("squeue",
+         ("cosa gira e cosa aspetta in coda",
+          "what is running and what is waiting"),
+         "squeue -u $USER"),
+        ("sinfo",
+         ("stato di nodi e partizioni",
+          "state of nodes and partitions"),
+         'sinfo -N -o "%N %G %t"'),
+        ("scontrol show job",
+         ("tutto quello che Slurm sa di un job",
+          "everything Slurm knows about a job"),
+         "scontrol show job 110253"),
+        ("sacct",
+         ("storico, anche di job già finiti",
+          "history, including jobs already finished"),
+         "sacct -j 110253 --format=JobID,State,Elapsed"),
+        ("sstat",
+         ("consumi di un job mentre gira",
+          "resource use of a job while it runs"),
+         "sstat -j 110253 --format=AveRSS,MaxRSS"),
+        ("sprio",
+         ("perché il tuo job è dietro agli altri",
+          "why your job sits behind the others"),
+         "sprio -u $USER"),
+        ("sshare",
+         ("quanto hai consumato rispetto alla tua quota",
+          "how much you used against your share"),
+         "sshare -U"),
+        ("sreport",
+         ("riepiloghi di utilizzo su un periodo",
+          "usage summaries over a period"),
+         "sreport cluster UserUtilizationByAccount start=2026-09-01"),
+    ]),
+    (("GESTIRE", "CONTROLLING"), [
+        ("scancel",
+         ("annulla un job", "cancels a job"),
+         "scancel 110253"),
+        ("scancel -u",
+         ("annulla tutti i tuoi, in un colpo",
+          "cancels all of yours at once"),
+         "scancel -u $USER"),
+        ("scontrol hold|release",
+         ("congela un job in coda e poi lo libera",
+          "freezes a queued job, then releases it"),
+         "scontrol hold 110253"),
+        ("scontrol update",
+         ("cambia un job che è ancora in coda",
+          "changes a job that is still queued"),
+         "scontrol update job=110253 TimeLimit=2:00:00"),
+        ("sattach",
+         ("ti riattacchi a un job interattivo",
+          "reattaches you to an interactive job"),
+         "sattach 110253.0"),
+    ]),
+    (("LIMITI E PERMESSI", "LIMITS AND PERMISSIONS"), [
+        ("sacctmgr show qos",
+         ("i tetti delle QOS: GPU, RAM, CPU per utente",
+          "QOS ceilings: GPUs, RAM, CPUs per user"),
+         "sacctmgr show qos format=Name,MaxTRESPU,GrpTRES"),
+        ("sacctmgr show assoc",
+         ("a quali account e QOS appartieni",
+          "which accounts and QOS you belong to"),
+         "sacctmgr show assoc user=$USER"),
+    ]),
+    (("OPZIONI CHE SERVONO QUASI SEMPRE", "OPTIONS YOU ALMOST ALWAYS NEED"), [
+        ("--gres=gpu:N",
+         ("quante GPU vuoi: senza questa non ne ottieni",
+          "how many GPUs: without it you get none"),
+         "--gres=gpu:2"),
+        ("-c, --cpus-per-task",
+         ("quanti core per task", "how many cores per task"),
+         "-c 8"),
+        ("--mem",
+         ("RAM per nodo: chiedine il giusto, resta prenotata",
+          "RAM per node: ask for what you need, it stays booked"),
+         "--mem=64G"),
+        ("-t, --time",
+         ("durata massima: scaduta, il job viene ucciso",
+          "time limit: once past it, the job is killed"),
+         "-t 8:00:00"),
+        ("-p, --partition",
+         ("in quale partizione finire", "which partition to land in"),
+         "-p boost_usr_prod"),
+        ("-A, --account",
+         ("a quale account addebitare le ore",
+          "which account gets charged for the hours"),
+         "-A phd_drossi"),
+        ("-J, --job-name",
+         ("un nome riconoscibile in coda",
+          "a name you can recognise in the queue"),
+         "-J finetune_v3"),
+        ("-o, --output",
+         ("dove finisce lo stdout (%j = numero del job)",
+          "where stdout goes (%j = the job number)"),
+         "-o logs/%j.out"),
+        ("--array",
+         ("tanti job uguali con indice diverso",
+          "many identical jobs with a different index"),
+         "--array=0-9"),
+        ("-w, --nodelist",
+         ("pretendi un nodo preciso", "demand one specific node"),
+         "-w huber"),
+        ("-d, --dependency",
+         ("parte solo dopo che un altro è finito",
+          "starts only after another one finishes"),
+         "-d afterok:110253"),
+    ]),
+    (("SU QUESTO CLUSTER", "ON THIS CLUSTER"), [
+        ("all_usr_prod",
+         ("la partizione generale, 24 nodi, max 1 giorno",
+          "the general partition, 24 nodes, 1 day max"),
+         "-p all_usr_prod"),
+        ("boost_usr_prod",
+         ("i nodi più grossi, 13 nodi, max 1 giorno",
+          "the bigger nodes, 13 of them, 1 day max"),
+         "-p boost_usr_prod"),
+        ("all_serial",
+         ("per prove corte senza GPU, max 4 ore",
+          "for short GPU-less tests, 4 hours max"),
+         "-p all_serial"),
+        ("nodeview",
+         ("questo programma: stato del cluster e dove entri",
+          "this program: cluster state and where you fit"),
+         "nodeview --once"),
+        ("nodeocc",
+         ("la TUI originale delle occupazioni",
+          "the original occupancy TUI"),
+         "nodeocc"),
+    ]),
+]
+
+
+def sections():
+    """The sections in the active language: (title, [(command, text, example)])."""
+    return [(pick(title), [(cmd, pick(what), example) for cmd, what, example in items])
+            for title, items in SECTIONS]