borgbackup/borg

analyze: add --json output

Chiusa

#9992 aperta il 1 ago 2026

Vedi su GitHubGuida contributor
 (2 commenti) (0 reazioni) (1 assegnatario)Python (732 fork)batch import
easygood first issue

Metriche repository

Star
 (10.086 stelle)
Metriche merge PR
 (Merge medio 5g 12h) (91 PR mergiate in 30 g)

Descrizione

borg analyze currently only produces human-readable text output:

  • the set-dedup stats (set / exclusive / rest sizes, see #5741),
  • the hot-spot report (directory path -> churn),
  • the --by-name repository decomposition table (per-name archives / source / stored / compression, shared, unreferenced).

All other status-type commands (info, repo-info, repo-list, list, diff, prune) already offer --json or --json-lines, so tooling can consume their output without scraping text. analyze is the odd one out, and its output is exactly the kind of data monitoring/agent tooling wants (e.g. a read-only MCP status server, see #9955).

Proposal: add --json to borg analyze, emitting the same numbers the text report is rendered from (raw byte values, not pre-formatted sizes), for both the default mode and --by-name.

Guida contributor

Direzione di ricerca
Ispeziona come `borg analyze` genera attualmente l'output di testo e dove vengono analizzati gli argomenti della riga di comando. Trova il punto appropriato per aggiungere un flag ` json` ed esporta i valori numerici grezzi come JSON. Usa come riferimento le implementazioni ` json` esistenti in altri comandi borg (es. `borg info`).
Tech stack
python
Dominio
cli
Tipo issue
Funzionalità
DifficoltàQuanto dovrebbe essere impegnativa per un nuovo contributor.
3
Tempo stimatoTempo stimato per completare e verificare uno scope piccolo.
Mezza giornata
Stato attivitàQuanto è probabile che la issue sia ancora attiva e reviewable.
Attiva
ChiarezzaQuanto chiaramente la issue descrive problema, scope e risultato atteso.
Chiara
Prerequisiti
GitPython
Adatta ai principiantiQuanto la issue è adatta a contributor alla prima esperienza.
75