{"id":10850,"date":"2023-09-10T12:28:12","date_gmt":"2023-09-10T10:28:12","guid":{"rendered":"https:\/\/u-labs.de\/portal\/?p=10850"},"modified":"2023-09-10T12:32:58","modified_gmt":"2023-09-10T10:32:58","slug":"bequeme-autovervollstandigung-statusleiste-zeitmessung-mit-ble","status":"publish","type":"post","link":"https:\/\/u-labs.de\/portal\/bequeme-autovervollstandigung-statusleiste-zeitmessung-mit-ble\/","title":{"rendered":"Bequeme Autovervollst\u00e4ndigung, Statusleiste, Zeitmessung & mehr f\u00fcr dein Terminal mit „ble“"},"content":{"rendered":"

Hast du schon mal die gleichen Befehle \u00f6fters eingegeben? Warst du schon mal auf einem Raspberry Pi oder anderen GNU\/Linux-Installationen und hast dir eine Statusleiste mit Informationen zu diesem System gew\u00fcnscht? Fragst du dich bei l\u00e4nger andauernden Vorg\u00e4ngen wie z.B. dem Kopieren von Dateien \u00f6fter mal, wie viel Zeit dieser Befehl in Anspruch genommen hat? W\u00fcnschst du dir Syntax-Hervorhebung beim Tippen? All das und noch mehr kann jede Standard Bash-Shell mit dem n\u00fctzlichen Werkzeug namens ble<\/strong><\/a>, welches ich dir in diesem Beitrag vorstelle.<\/p>\n

Was ist ble?<\/h2>\n

Ble beschreibt sich selbst als Befehlszeileneditor, der komplett in der Skriptsprache Bash geschrieben wurde. Das Werkzeug m\u00f6chte GNU readline<\/a><\/strong> verbessern: Die Bibliothek dient zum Bearbeiten von Zeilen und wird von der Bash selbst verwendet, um Beispielsweise die Autovervollst\u00e4ndigung mit <Tab><\/strong> anzubieten: Wer beispielsweise unz<\/strong> gefolgt von der <Tab><\/strong>Taste eintippt, erh\u00e4lt den Befehl unzip<\/strong> – oder alternativ eine Liste, falls mehrere Befehle mit dem gleichen Name gefunden werden. Die Bash bietet weitere n\u00fctzliche Funktionen wie die Suche im Verlauf mit [STRG] + [R]<\/strong>. Auch die Suche ist jedoch recht rudiment\u00e4r gehalten. Daher sind Werkzeuge wie fzf entstanden<\/a>, um sie etwa mit einer Trefferliste oder zus\u00e4tzlichen Operatoren (z.B. Ausschlie\u00dfen von Begriffen) zu erg\u00e4nzen.<\/p>\n

\u00c4hnlich sieht es mit readline<\/strong> aus: \u00dcber die ~\/.inputrc<\/strong> kann man zwar einige Einstellungen vornehmen. Einige n\u00fctzliche Funktionen lassen sich damit aber nicht umsetzen. Hier \u00fcbernimmt ble<\/strong> und bietet eine Reihe an praktischen Funktionen, womit die Konsole nicht nur \u00fcbersichtlicher und produktiver wird, sondern auch etwas farbenfroher.<\/p>\n

Installation<\/h2>\n

Auf eurem System werden Gawl & Git als Abh\u00e4ngigkeiten ben\u00f6tigt. Anschlie\u00dfend das GitHub-Repository klonen, Make-Skript ausf\u00fchren, das Startskript von ble<\/strong> in die .bashrc einbetten um es bei jeder Konsolenanwendung automatisch zu laden und anschlie\u00dfend mit source<\/strong> eure .bashrc neu laden – dadurch werden die \u00c4nderungen sofort wirksam, statt erst bei der n\u00e4chsten Anmeldung.<\/p>\n

\n
\nsudo apt install make gawk git\n\ngit clone --recursive --depth 1 --shallow-submodules https:\/\/github.com\/akinomyoga\/ble.sh.git\nmake -C ble.sh install PREFIX=~\/.local\necho 'source ~\/.local\/share\/blesh\/ble.sh' >> ~\/.bashrc\nsource ~\/.bashrc\n<\/pre>\n<\/div>\n
Das Skript legt sich selbst und seine Daten in ~\/.local\/share\/blesh\/<\/strong> ab. Der erste Start dauert einige Sekunden, da hier die Initialisierung durchgef\u00fchrt wird. <\/p>\n
Diese praktischen Funktionen bietet dir ble<\/h2>\n
Anschlie\u00dfend ist ble<\/strong> aktiv: In diesem Beispiel habe ich ps<\/strong> eingetippt. Direkt nachdem ich mit Tippen aufh\u00f6re, zeigt ble<\/strong> einen Beispieleintrag aus dem Verlauf. Dieser wird als markierter Text rechts angezeigt und nur \u00fcbernommen, wenn wahlweise [Tab] oder die Pfeil-nach-Rechts-Taste gedr\u00fcckt wird. Tippt man weiter oder dr\u00fcckt Enter (weil man etwa ps ohne Parameter aufrufen m\u00f6chte), ignoriert das Werkzeug die Vorschl\u00e4ge. Sie erscheinen weiterhin, so lange es zum eingegebenen Befehl etwas passendes finden kann.<\/p>\n
\n
\"\"<\/a><\/figure>\n<\/div>\n
Das passiert Permanent im Hintergrund, w\u00e4hrend du tippst. Die Vorschl\u00e4ge k\u00f6nnen sich daher \u00e4ndern und sind vielseitig: Es wird auf verf\u00fcgbare Befehle in $PATH<\/strong>, zuvor ausgef\u00fchrte Befehle aus der Bash-Historie sowie existierende Dateien\/Ordner im Dateisystem zur\u00fcckgegriffen. In folgendem Beispiel wird daher \/etc\/resolv.conf<\/strong> vorgeschlagen, obwohl ich diesen Befehl auf dem Testsystem noch nie ausgef\u00fchrt habe.<\/p>\n
\n
\"\"<\/a><\/figure>\n<\/div>\n
Dabei versucht ble<\/strong>, den wahrscheinlichsten Treffer anzuzeigen. Teilweise gibt es aber auch mehrere: In diesem Beispiel etwa resolv.conf.bak<\/strong> und resolvconf.conf<\/strong>. Mit der <Tab><\/strong> Taste wird darunter eine Auswahl aller Treffer angezeigt, durch die man durch erneutes Dr\u00fccken von <Tab><\/strong> navigieren kann. \u00dcbernommen wird er mit <Enter><\/strong>. <\/p>\n
\n
\"\"<\/a><\/figure>\n<\/div>\n
Bereits bei diesen einfachen Demonstrationen sieht man, wie ble<\/strong> durch verschiedene Farben versucht, die Eingabe \u00fcbersichtlicher zu gestalten: Der Befehl selbst (hier cat<\/strong>) wird gr\u00fcn, der Ordner \/etc<\/strong> blau und der Dateiname resolvconf.conf<\/strong> wei\u00df. Das geschieht auch an anderen Stellen, etwa bei Parametern. Wird ein Befehl mit Fehlercode (= R\u00fcckgabewert ungleich 0) beendet, zeigt es den R\u00fcckgabewert in einer eigenen roten Zeile an.<\/p>\n
\n
\"\"<\/a><\/figure>\n<\/div>\n
Zum Vergleich: Die normale Bash alleine (also ohne ble<\/strong>) w\u00fcrde an dieser Stelle nichts unternehmen: Gibt euch die aufgerufene Software keine Fehlermeldung aus (wie z.B. grep), erscheint keinerlei Ausgabe. Dass aus Sicht des Programms ein Fehlerfall aufgetreten ist, seht ihr nur durch manuelle Ausgabe von $?<\/strong>: Die Variable enth\u00e4lt den Exit-Code des zuletzt ausgef\u00fchrten Befehls. Hier 1<\/strong>, was grep zur\u00fcck liefert, wenn der gesuchte Text nicht gefunden wurde.<\/p>\n
\n
\"\"<\/a><\/figure>\n<\/div>\n
Die Konfigurationsdatei bietet noch viel mehr n\u00fctzliche Dinge<\/h2>\n
Viele weitere Funktionen des Kommandozeilenwerkzeugs sind standardm\u00e4\u00dfig nicht eingeschaltet. Standardm\u00e4\u00dfig l\u00e4dt ble<\/strong> die Konfigurationsdatei ~\/.blerc<\/strong>, sofern vorhanden. Ihr k\u00f6nnt diese mit einem Texteditor eurer Wahl anlegen<\/a> und die gew\u00fcnschten Einstellungen aus den folgenden Abschnitten setzen. Diese werden nicht sofort wirksam, der Befehl ble-reload<\/strong> l\u00e4dt die Datei neu. <\/p>\n
\n
\nvim ~\/.blerc\nble-reload\n<\/pre>\n<\/div>\n
Aber Vorsicht<\/strong>: Fehler in der .blerc<\/strong> k\u00f6nnen dazu f\u00fchren, dass die Konsole nicht mehr funktionsf\u00e4hig ist! Ich empfehle daher, vorher<\/strong> einen zweiten Reiter zu \u00f6ffnen, in dem ihr eine weitere Konsole\/SSH-Sitzung \u00f6ffnet. Im Fehlerfall k\u00f6nnt ihr diese nutzen, um das Problem an der .blerc zu korrigieren und in einer neuen Konsole<\/strong> zu testen.<\/p>\n
Gerade beim ausprobieren passierte es in meinen Tests gelegentlich, dass die \u00c4nderungen nicht wie gew\u00fcnscht wirksam wurden. Hier half in den meisten F\u00e4llen das L\u00f6schen des Zwischenspeichers (Cache). In einem hartn\u00e4ckigen Fall funktioniert es nach dem \u00d6ffnen einer neuen Konsole\/SSH-Verbindung.<\/p>\n
\n
\nrm -rf $_ble_base_cache\n<\/pre>\n<\/div>\n
Statuszeile mit eigenen Informationen, Exitcode & Trennlinien<\/h3>\n
Mit ble<\/strong> kann man auch eine Statuszeile am unteren Ende des Bildschirms einblenden. Neben vorgefertigten Variablen lassen sich Befehle ausf\u00fchren, deren Ausgabe eingef\u00fcgt wird: Folgendes Beispiel ist f\u00fcr den Raspberry Pi optimiert und <\/p>\n
\n
\nfunction ble\/prompt\/backslash:custom\/memoryTime {\n  ble\/prompt\/unit\/add-hash '$SECONDS'\n  ble\/prompt\/process-prompt-string "\ud83d\udcbe$(free -h | grep Mem | awk '{printf $3 "\/" $2}')\\r\u23f0\\t"\n}\nbleopt prompt_status_line="\ud83d\udc27$(uname -o) $(uname -r) $(uname -m)\\r\ud83d\udcdf$(dmesg | grep 'Machine model' | awk -F': ' '{print $2}')\\r\\q{custom\/memoryTime}"\nbleopt prompt_status_align=$'justify=\\r'\n<\/pre>\n<\/div>\n
Dieses Beispiel zeigt links unten die Kernel-Version sowie Architektur an. In der Mitte Modell und Revision des Raspberry Pi. Daneben belegter\/insgesamt verf\u00fcgbarer Arbeitsspeicher und Uhrzeit. Die letzten beiden werden automatisch aktualisiert, allerdings nur, wenn man aktiv ist. H\u00f6rt das Tippen auf, pausiert ble<\/strong> die Aktualisierung. Alle Daten sollen zentriert dargestellt werden, anhand des Tabs ausgerichtet. F\u00fcr die meisten Angaben werden Shell-Befehle ausgef\u00fchrt, d.H. man kann viele weitere Daten darstellen, etwa den Akkustand eines Notebooks (wenngleich dies etwas Leistung kostet). Au\u00dferhalb des Raspberry Pis sollte man die Modellanzeige entfernen, da sie unter X86 Desktops\/Servern nicht wie auf dem Raspberry Pi OS funktioniert:<\/p>\n
\n
\nbleopt prompt_status_line="\ud83d\udc27$(uname -o) $(uname -r) $(uname -m)\\r\\q{custom\/memoryTime}"\n<\/pre>\n<\/div>\n
Interessant finde ich zudem die Ausf\u00fchrungszeit, Anzeige von Fehlercodes (Exitcode != 0) und mit dem promt_ruler<\/em> eine Trennlinie. So wird auf den ersten Blick klar, wo die Ausgabe eines Befehls anf\u00e4ngt bzw. endet.<\/p>\n
\n
\n# Zeigt die Ausf\u00fchrungszeit & CPU-Last an, wenn der Befehl > 10 ms ben\u00f6tigt hat\nbleopt exec_elapsed_mark=$' \\\\e[94m[\u21aa\ufe0f[%s \ud83d\udcc8%s%%]\\e[m'\nbleopt exec_elapsed_enabled='usr+sys>=10'\n# Exitcode (nur angezeigt, wenn nicht gleich null)\nbleopt exec_errexit_mark=$' \\e[91m[\u26a1\ufe0fRC \u27a1\ufe0f %d]\\e[m'\n# Blaue Trennlinie zwischen den Befehlen\nbleopt prompt_ruler=$'\\e[94m-' \n<\/pre>\n<\/div>\n
\n
\"\"<\/a><\/figure>\n<\/div>\n
Die komplette Konfigurationsdatei ~\/.blerc<\/strong>:<\/p>\n
\n
\nfunction ble\/prompt\/backslash:custom\/memoryTime {\n  ble\/prompt\/unit\/add-hash '$SECONDS'\n  ble\/prompt\/process-prompt-string "\ud83d\udcbe$(free -h | grep Mem | awk '{printf $3 "\/" $2}')\\r\u23f0\\t"\n}\nbleopt prompt_status_line="\ud83d\udc27$(uname -o) $(uname -r) $(uname -m)\\r\ud83d\udcdf$(dmesg | grep 'Machine model' | awk -F': ' '{print $2}')\\r\\q{custom\/memoryTime}"\nbleopt prompt_status_align=$'justify=\\r'\n# Zeigt die Ausf\u00fchrungszeit & CPU-Last an, wenn der Befehl > 10 ms ben\u00f6tigt hat\nbleopt exec_elapsed_mark=$' \\\\e[94m[\u21aa\ufe0f[%s \ud83d\udcc8%s%%]\\e[m'\nbleopt exec_elapsed_enabled='usr+sys>=10'\n# Exitcode (nur angezeigt, wenn nicht gleich null)\nbleopt exec_errexit_mark=$' \\e[91m[\u26a1\ufe0fRC \u27a1\ufe0f %d]\\e[m'\n# Blaue Trennlinie zwischen den Befehlen\nbleopt prompt_ruler=$'\\e[94m-' \n<\/pre>\n<\/div>\n
Fazit: N\u00fctzlich und eine nette Spielerei dazu<\/h3>\n
In ble<\/strong> sind einige n\u00fctzliche Funktionen enthalten, die teils von der Z-Shell<\/strong> inspiriert wurden, wie etwa die automatische Vervollst\u00e4ndigung von Befehlen – der Hauptgrund, warum ich mir ble<\/strong> genauer angeschaut habe. Die automatische Ausgabe des Exit-Codes ist nicht nur f\u00fcr weniger erfahrene Nutzer hilfreich. Auch wenn man wei\u00df, dass man diesen mit $?<\/strong> erf\u00e4hrt, ist es so doch deutlich einfacher. Mit den Farben und ein paar Unicode-Emojis<\/a> sieht die Konsole zudem auch noch ansprechender aus.<\/p>\n
Durch die hohe Anpassbarkeit kann man Stunden damit verbringen, sich seine Shell bis hin zu Details wie z.B. einzelnen Farben recht genau anzupassen. Sicherlich m\u00f6gen manche Funktionen unter ZSH<\/strong> & co. einfacher und teilweise sogar mit Boardmitteln realisierbar sein. Manch einer m\u00f6chte jedoch vielleicht nicht unbedingt seine komplette Shell wegen einzelnen Funktionen wechseln. Hier sehe ich ble<\/strong> als eine sinnvolle Erg\u00e4nzung.<\/p>\n
Weitere Infos<\/h3>\n
Das Werkzeug l\u00e4sst sich stark anpassen (z.B. Farben) und Erweitern (etwa eigene Befehle aufrufen und die Ausgabe einbetten). Im offiziellen Handbuch<\/a> sind die verf\u00fcgbaren Einstellungen dokumentiert, vieles aus den folgenden Abschnitten befindet sich in \u00a74 Edit<\/strong>. Erg\u00e4nzend empfand ich manchmal ein Blick in die blerc.template<\/strong> Datei des Repositorys<\/a> als hilfreich: Das ist eine Art Beispieldatei, in der die verschiedenen Einstellungsm\u00f6glichkeiten aufgelistet sind, oft mit einer mehr oder weniger ausf\u00fchrlichen Erkl\u00e4rung. \u00c4hnlich, wie man das von vielen GNU\/Linux-Programmen kennt, die solch eine Datei bei der Installation anlegen.<\/p>\n
Falls euch einzelne Funktionen von ble<\/strong> nicht gefallen, k\u00f6nnt ihr so ziemlich alle davon einzeln deaktivieren. Dazu m\u00fcsst ihr eine bestimmte Variable auf einen leeren Wert setzen. Meist ist es diejenige, in der man das Format anpassen kann. Die verf\u00fcgbaren werden in der README aufgelistet<\/a>. Folgende dient beispielsweise f\u00fcr die Formatierung der ben\u00f6tigten Ausf\u00fchrungsdauer, die auf eine leere Zeichenkette gesetzt und damit deaktiviert wird:<\/p>\n
\n
\nbleopt exec_elapsed_mark=\n<\/pre>\n<\/div>\n","protected":false},"excerpt":{"rendered":"
Hast du schon mal die gleichen Befehle \u00f6fters eingegeben? Warst du schon mal auf einem Raspberry Pi oder anderen GNU\/Linux-Installationen und hast dir eine Statusleiste mit Informationen zu diesem System gew\u00fcnscht? Fragst du dich bei l\u00e4nger andauernden Vorg\u00e4ngen wie z.B. dem Kopieren von Dateien \u00f6fter mal, wie viel Zeit dieser Befehl in Anspruch genommen hat? …<\/p>\n","protected":false},"author":5,"featured_media":11040,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[74],"tags":[844,1084],"class_list":["post-10850","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-linux","tag-bash","tag-cli"],"_links":{"self":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts\/10850","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/comments?post=10850"}],"version-history":[{"count":6,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts\/10850\/revisions"}],"predecessor-version":[{"id":10888,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/posts\/10850\/revisions\/10888"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/media\/11040"}],"wp:attachment":[{"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/media?parent=10850"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/categories?post=10850"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/u-labs.de\/portal\/wp-json\/wp\/v2\/tags?post=10850"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}