dx

Zählt, was in einem Verzeichnis liegt, und wie schwer es ist — eine Ebene tief, ein Blick, sofort fertig.

$ dx ~/src -r -t 8
/Users/mike/src        2489     1.1G
  Wetter/               297     316M  ██▉         29%
  gblog/                 99     135M  █▎          12%
  gbld/                  82     131M  █▏          12%
  goca/                  80     108M  █           10%
  futterturm/            62      68M  ▋            6%
  BugSim/               323      68M  ▋            6%
  gvm/                   37      57M  ▌            5%
  mJournal/             204      42M  ▍            4%
  … 16 more            1305     179M  █▋          16%

Links der Name, dann die Zahl der enthaltenen Dateien, dann die Summe ihrer Größen, dann der Anteil am Ganzen. Die Kopfzeile ist das Verzeichnis selbst. Verzeichnisse werden vollständig durchlaufen, aber nicht aufgeklappt — für alles Weitere ist ncdu da.

Im Terminal ist die Ausgabe farbig, nach der Palette aus mwxcol.

Bauen und installieren

cd ~/src/dx
go build -trimpath -ldflags="-s -w" -o bin/dx .
cp bin/dx ~/bin/dx

Braucht Go ≥ 1.26 und github.com/fatih/color. Das Perl-Original (dx, 1.0.2, 2016) liegt unverändert daneben; es hat keine Farben und keine Balken, tut aber sonst dasselbe.

Optionen

-n	--number	nach Dateizahl sortieren statt nach Größe
-d	--dirs	nur Verzeichnisse zählen, Dateien der obersten Ebene weglassen
-r	--reverse	größtes zuerst
-t N	--top=N	nur die N größten zeigen, den Rest zu einer Zeile summieren
-h	--help	Hilfe
	--bar, --no-bar	Balken und Prozent erzwingen bzw. abschalten
	--color=auto|always|never	Farbe erzwingen bzw. abschalten
	--version	Version

Kurzoptionen lassen sich bündeln (-rt 3, -dn), der Wert von -t darf kleben (-t5) oder folgen (-t 5). Ein -- trennt Optionen von einem Pfad, der mit - beginnt. Ohne Pfad gilt das aktuelle Verzeichnis.

Sortiert wird aufsteigend, das Größte steht also direkt über dem Prompt und man muss nicht scrollen. -r dreht das um, für Pipes und lange Listen.

Bei -t steht die Sammelzeile immer am kleinen Ende: oben bei normaler Sortierung, unten bei -r.

Exit
0	alles gelesen
1	Pfad existiert nicht oder ist kein Verzeichnis
2	Option falsch benutzt

Farbe und Balken

Beides gilt am Terminal und entfällt in einer Pipe — dx | sort bekommt reinen Text. --color=always schaltet beides wieder ein, für less -R. Wer nur eins davon will, sagt es mit --bar / --no-bar ausdrücklich. NO_COLOR wird beachtet.

Die Farben folgen den file_type-Rollen aus themes/eza/theme.yml, damit dieselbe Datei in eza und dx gleich aussieht:

Verzeichnis	blue, fett		Archive	orange
ausführbar	green, fett		Bilder	violet
Symlink	pink		Video	pink
Quelltext, Konfiguration	blue		Audio	green
README, Makefile, go.mod	yellow		Schlüssel, Zertifikate	red
Dokumente	white		Kompilate (.o, .dylib)	grey
sonstige Dateien	white		.tmp, .bak, .DS_Store	darker

Die Zahlenspalte ist grey, eine Null dark. Die Größenspalte trägt die Größenrampe des eza-Themes — bis K green, M yellow, G orange, T red — und der Balken nimmt die Farbe der Spalte auf, deren Anteil er zeigt: die der Größe, mit -n die der Dateizahl.

Der Balken ist zehn Zellen breit und rechnet in Achteln (▏▎▍▌▋▊▉█). Was weniger als ein halbes Prozent ausmacht, bekommt keinen Strich und steht als <1% da statt als geschöntes 0%. Dadurch bleiben genau die Zeilen sichtbar, auf die es ankommt.

Größen

Die Schwellen sind die des Originals: ab 1024 der jeweiligen Einheit wird umgeschaltet. Unterhalb von 10 kommt eine Nachkommastelle dazu, weil 2G sonst alles zwischen 1,5 und 2,4 Gigabyte bedeuten könnte. Ganze Bytes bleiben ganz.

8   4.9K   316M   1.1G

Was genau gezählt wird

Gezählt werden reguläre Dateien, wie bei find -type f. Verzeichnisse, Sockets, Fifos und Geräte zählen nicht mit, auch nicht die Verzeichnisse selbst.

• Ein Symlink auf ein Verzeichnis wird nicht verfolgt und steht deshalb mit 0 da — pink eingefärbt, damit die Null erklärt ist.
• Ein Symlink auf eine Datei auf oberster Ebene zählt mit der Größe seines Ziels, ebenfalls pink.
• Hardlinks zählen so oft, wie sie vorkommen. In einem Baum mit rsync --link-dest oder Time Machine sind die Zahlen dadurch zu hoch; für so etwas ist dx nicht gedacht.
• Gemessen wird die Dateigröße, nicht der belegte Platz. Sparse-Dateien und APFS-Klone erscheinen größer, als sie auf der Platte sind.
• Was sich nicht lesen lässt — gesperrte Verzeichnisse, tote Symlinks — wird übersprungen und am Ende auf stderr gemeldet, damit die Tabelle heil bleibt.
• -d lässt Dateien der obersten Ebene ganz weg, auch aus der Summe.

Unterverzeichnisse werden nebenläufig durchlaufen, so viele auf einmal wie Kerne da sind. Das Original startete pro Verzeichnis einen find-Prozess; auf ~/go sind das 0,19 s statt 0,34 s.

Unterschiede zum Perl-Original

1. Gleichstände sortieren nach Namen. Perl ließ sie in der Reihenfolge des Hashes, dx -n gab bei jedem Aufruf eine andere Reihenfolge aus.
2. Ein ungültiger Pfad ist ein Fehler. Perl listete stillschweigend das aktuelle Verzeichnis — plausible, aber falsche Zahlen.
3. Die Namensspalte ist eine Stelle breiter, wenn der längste Eintrag ein Verzeichnis ist. Perl zählte den angehängten / bei der Spaltenbreite nicht mit, der längste Name klebte am Zahlenblock.
4. Fehler stehen auf stderr, statt als find: … Permission denied mitten in der Ausgabe.
5. Größen haben eine Nachkommastelle, siehe oben. Das ist die einzige Abweichung im alten Ausgabeformat; ohne Farbe und Balken ist der Rest byteweise identisch.

Neu sind -r, -t, die Balkenspalte, die Farben und die langen Optionen.

Aufbau

Datei
main.go	Zählen, Sortieren, Formatieren, Optionen
filetypes.go	Endung und Dateiname → Farbe
dx	das Perl-Original von 2016

Die Palette steht in main.go doppelt — einmal als Zahlenwerte, einmal in den Kommentaren als Rolle. Quelle der Wahrheit bleibt ~/src/mwxcol/mwxcol.go; ändert sie sich dort, müssen die elf rgb{…} hier nachgezogen werden.