Neue Dokumentation für api.existenz.ch

Meine APIs für diverse OpenData-Daten haben in den letzten Wochen eine aktualisierte Dokumentation im OpenAPI V3-Standard (Aka. Swagger) erhalten: https://api.existenz.ch/docs/apiv1

Zusätzlich verlinkt von der API-Startseite ist ein Newsletter mit unregelmässigen Updates zum Zustand der API.

Ich freue ich immer über eine Nachricht wenn dir die Daten von Nutzen sind.

GitHub Action: Apprise-Notifikationen

Beim Experimentieren mit der Beta-Version von GitHub Actions (Einem Tool für Build-Prozesse, Continous Integration, Deployment etc.) wollte ich mir Notifikationen aus Pipelines zukommen lassen. Zwar gab es schon einige Actions welche mit einzelnen Services funktionierten, aber jede dieser Action war unterschiedlich zu konfigurieren und benutzen.

Kurzerhand habe ich mich durch die lückenhafte Dokumentation gekämpft und eine eigene generelle Notifikation-Action erstellt: Apprise-GA.

Dank der Python-Bibliothek Apprise kann diese Action Nachrichten an Dutzende verschiedene Services schicken: Slack, Discord, IFTTT, Matrix, Telegram, Twitter, Pushover etc. etc.

Und mit dem Einsatz von Templates können auch dynamische Texte verschickt werden:

action "Send push notification" {
  uses = "cstuder/apprise-ga@master"
  secrets = ["APPRISE_URL"]
  args = [
    "Push received on {{ ref }}",
    "Commit by {{ head_commit.author.name }}: {{ head_commit.message | truncate(128) }} ({{ head_commit.id[0:7] }})"]
}

Ich finde meine Action überzeugt.

Dokumentation auf GitHub: https://github.com/cstuder/apprise-ga

Visual Studio Code-Extension: Marktplatzseite aktualisieren

Um die Informationsseite einer selbst entwickelten Extension im Marktplatz von Visual Studio Code zu aktualisieren, ohne eine neue Version publizieren zu müssen, kannst du einfach die bestehende Version mit

vsce package

neu packen. Nicht vsce publish ausführen, da dies die Versionsnummer automatisch erhöht.

Danach das Packet im Marketplace Manager erneut hinaufladen. Nach einigen Minuten wird die Informationsseite aktualisiert sein.

(Ich habe das benutzt um meine eigene Extension zum Wohle der neuen GitLab Workflow-Extension einzustampfen.)

Backslash unter macOS in Visual Studio Code eingeben mit installierter Git Lens

Das exzellente Git-Blame-Plugin Git Lens für meinen neuen Lieblingseditor Visual Studio Code überschreibt die Tastenkombination Shift-Alt-7 für den Backslash (\) auf der deutschen Tastaturbelegung in macOS.

Zur Behebung das Keybinding auf dem Kommando gitlens.showCommitSearch löschen.

(Menu Tastenkombinationen, Rechtsklick auf das störende Binding und Entfernen wählen.)

FileVault-Aktivierung und macOS-Systemupdates sind eine problematische Kombination

Kleine Warnung vor einem Problem über welches ich heute gestolpert bin: Die mitgelieferte Festplattenverschlüsselung FileVault von macOS ist grundsätzlich eine gute Idee und ich aktiviere sie auf jedem System welche ich betreue.

Dummerweise verträgt sie sich während dem erstmaligen Aktivieren nicht mit macOS-Systemupdates.

In meinem Fall versuchte ich ein frisches System von macOS 10.13.1 auf 10.13.2 zu aktualisieren. Das Update bricht ab weil die Festplattenverschlüsselung noch nicht vollständig ist, versucht aber nach einem Neustart wieder das Update zu starten. Man steckt in einer Endlosschlaufe fest.

Lösungsansatz 1: Die Anleitung hier mit Terminal im Recovery-Modus befolgen.

Lösungsansatz 2: Der meinen Erfahrungen nach kompetente Apple-Telefonsupport liess mich das Gerät im Safe-Mode starten (Shift-Taste beim Booten gedrückt halten). Damit konnte ich mich wieder anmelden und eingeloggt warten bis die Festplattenverschlüsselung abgeschlossen ist. Bei einem iMac mit 1 TB-HD veranschlagt macOS dafür ca. 16 Stunden. Erst danach wieder neu starten und das Update installieren.