Soeben habe ich
shcol 0.2 auf PyPI hochgeladen.
Für eine grobe Doku muss man sich zunächst mit der README-Datei begnügen, deren Inhalt auch für die PyPI-Paketbeschreibung übernommen wurde. Die geplante HTML-basierte Dokumentation habe ich erstmal verschoben.
Zusätzlich ist `shcol` auch als Shell-Tool verwendbar. Sowohl für Linux als auch für die Windows PowerShell. Beispiele für beide "Welten" erhält man durch Eingabe von `shcol --help`:
Code: Alles auswählen
usage: shcol [-h] [-s N] [-w N] [-S] [-U] [-c N] [-v] [item [item ...]]
Generate columnized output for given string items.
Columize and sort:
shcol -S foo bar baz
Columnize command output on Linux (Debian):
shcol -S -c0 < /proc/modules
dpkg --get-selections 'python3*' | shcol -c0 -s4
Columnize process names on Windows PowerShell:
ps | foreach {$_.name} | shcol -U
positional arguments:
item an item to columnize
(read from stdin if item arguments are not present)
optional arguments:
-h, --help show this help message and exit
-s N, --spacing N number of blanks between two columns (default: 2)
-w N, --width N maximal amount of characters per line
(use terminal width by default)
-S, --sort sort the items
-U, --unique process only the first occurrence of an item
(i.e. doublets are eliminated)
-c N, --column N choose a specific column per line via an index value
(indices start at 0, column separator is whitespace)
will only work when items are supplied via stdin
-v, --version show program's version number and exit
Für Windows-Benutzer ist zu beachten, dass der Skript-Ordner vom verwendeten Python-Interpreter im PATH eingetragen sein muss, sofern man `shcol` als einfachen Befehl (also ohne umständliche Pfadangabe) verwenden möchte. Dies wurde bei der Python-Installation automatisch vorgenommen, sofern man das entsprechende Häkchen angeklickt hat.
`shcol` ist noch nicht komplett durchgetestet. Ich wollte aber mal wieder releasen, zumal ich intern einiges an Refactoring durchführen werde. Das wäre mir ein zu krasser Sprung vom vorherigen "rc1" gewesen.
Wie immer bin ich dankbar über jede Rückmeldung (Fehlermeldungen, Verbesserungsvorschläge, ...) und übernehme keinerlei Haftung für die Auswirkungen möglicher Fehlfunktionen seitens `shcol`.