YAML erklärt: Syntax, das Norwegen-Problem und andere von uns getestete Fallen
YAML führt Kubernetes, Docker Compose, GitHub Actions und unzählige Konfigurationsdateien aus. Es sieht zwar freundlich aus, aber nicht in Anführungszeichen gesetzte Werte können sich stillschweigend in Boolesche Werte, Gleitkommazahlen und Oktalzahlen verwandeln. Wir haben eine Testdatei einem echten Parser zugeführt, um genau zu zeigen, was passiert.
- YAML stellt Daten mit Einrückung dar: Schlüsselwertkarten, Listen mit Bindestrichen und Skalarwerte.
- Nicht zitierte Werte sind geschätzt: In unserem Test wurde
NOzuFalseund Version1.10wurde zu1.1. - Zitate Zeichenfolgen, die wie boolesche Werte, Zahlen, Zeiten oder Versionen aussehen.
- Laden Sie niemals nicht vertrauenswürdiges YAML mit einem unsicheren Loader; Verwenden Sie
yaml.safe_loadin Python.
Eine Konfigurationsdatei listet die Länder auf, für die eine Funktion aktiviert ist: GB, SE, FI und NO. Alles funktioniert außer Norwegen. Der Code erhält False anstelle der Zeichenfolge „NO“, da der YAML-Parser entschieden hat, dass „NO“ „nein“ bedeutet. Dies ist das berühmte Norwegen-Problem und nur eine von mehreren Möglichkeiten, wie YAML Ihre Daten stillschweigend ändert.
Wir haben eine bewusst knifflige Datei mit PyYAML 6.0 auf Python 3.13 geparst. Alle unten gezeigten Werte und Typen stammen aus diesem Lauf. Andere Parser, insbesondere solche, die YAML 1.2 folgen, können andere Ergebnisse liefern, was Teil des Problems ist.
Was ist YAML?
YAML, kurz für „YAML Ain’t Markup Language“, ist ein benutzerfreundliches Format für strukturierte Daten. Es enthält die gleichen Dinge wie JSON, Karten, Listen, Zeichenfolgen, Zahlen, boolesche Werte und Nullen, verwendet jedoch Einrückungen anstelle von geschweiften Klammern und erlaubt Kommentare. Tatsächlich ist gültiges JSON fast immer gültiges YAML. Seine Lesbarkeit machte es zum Standard für die Konfiguration in DevOps-Tools: Kubernetes-Manifeste, Docker Compose-Dateien, GitHub-Aktionen-Workflows und Ansible-Playbooks.
Grundlegende Syntax
# a comment
name: shop-api # a map: key, colon, space, value
replicas: 3
enabled: true
tags: # a list: each item starts with "- "
- web
- payments
database: # a nested map, indented by two spaces
host: db.internal
port: 5432
inline_list: [a, b, c]
inline_map: {x: 1, y: 2}
Durch Einrückungen wird die Verschachtelung angezeigt, und nach Doppelpunkten und Bindestrichen sind Leerzeichen erforderlich. Zwei Leerzeichen pro Ebene sind die übliche Konvention. Listen von Karten, die in Kubernetes sehr verbreitet sind, kombinieren beides: Jede - startet eine neue Karte, deren Schlüssel darunter aufgereiht sind.
Wie YAML Typen errät
Ein Wert ohne Anführungszeichen ist nicht automatisch eine Zeichenfolge. Der Parser betrachtet es und entscheidet, ob es sich um einen Booleschen Wert, eine Zahl, Null oder einen String handelt. Folgendes hat PyYAML aus unserer Testdatei erstellt:
| YAML | Geparster Wert | Typ |
|---|---|---|
Land: NEIN |
Falsch |
bool |
aktiviert: ja |
Stimmt |
bool |
debuggen: aus |
Falsch |
bool |
Version: 1.10 |
1.1 |
schweben |
Python: 3.10 |
3.1 |
schweben |
PLZ: 01234 |
668 |
int |
Oktal: 0755 |
493 |
int |
Hafen: 08 |
'08' |
str |
Zeit: 12:30 |
750 |
int |
sha: 1e10 |
'1e10' |
str |
leer: |
Keine |
NoneType |
Tilde: ~ |
Keine |
NoneType |
quoted_no: „NEIN“ |
„NEIN“ |
str |
quoted_version: „1.10“ |
'1.10' |
str |
Nur die angegebenen Werte entsprachen genau der Beschreibung. Jede Zeile über den zitierten Zeilen ist ein potenzieller Fehler.
Das Norwegen-Problem
countries: [GB, NO, SE, FI]
# parsed: ['GB', False, 'SE', 'FI']
Gemäß den YAML 1.1-Regeln, denen PyYAML folgt, sind die Wörter yes, no, on, off, y und n in verschiedenen Großschreibungen boolesche Werte. So wurde der Ländercode für Norwegen zu False, während seine Nachbarn Strings beibehielten. Das Gleiche kann mit Antworten in einer Umfragedatei, mit Feature-Flags mit dem Namen „on“ oder mit jedem Funktionscode passieren, der mit einem dieser Wörter übereinstimmt. Die Lösung ist einfach, sobald Sie es wissen: Geben Sie den Wert an, "NO".
Zahlen, die sich ändern
Versionen werden zu Floats
1.10 und 3.10 wurden als die Zahlen 1.1 und 3.1 geparst, wobei die nachgestellte Null verloren ging. Eine CI-Datei, die nach Python 3.10 fragt, fragt möglicherweise tatsächlich nach Python 3.1. Benutzer von GitHub Actions haben genau das gefunden, und der Standardratschlag lautet, Versionen zu zitieren: python-version: "3.10". Lesen Sie auch unseren Leitfaden zur semantischen Versionierung, um zu erfahren, warum Versionen keine Zahlen sind.
Führende Nullen bedeuten Oktal
Die Postleitzahl 01234 wurde zu 668, da eine führende Null in YAML 1.1 eine Oktalzahl (Basis 8) markiert. Das ist nützlich für Dateiberechtigungen wie 0755, die zu 493 wurden, aber katastrophal für Postleitzahlen, Telefonnummern und IDs. Seltsamerweise blieb 08 eine Zeichenfolge, da 8 keine gültige Oktalziffer ist, sodass ähnlich aussehende Werte möglicherweise unterschiedliche Typen in derselben Datei haben.
Aus Zeiten werden Sekunden
12:30 wurde zu 750. YAML 1.1 liest durch Doppelpunkte getrennte Zahlen als Basis 60, dem „sexagesimalen“ Format, also 12 × 60 + 30 = 750. Ein Zeitplan oder eine Portzuordnung wie 22:22 kann stillschweigend konvertiert werden. Aus diesem Grund wird in der Docker Compose-Dokumentation empfohlen, Portzuordnungen anzugeben.
Und die gegenteilige Überraschung
1e10 blieb in PyYAML ein String, da sein Float-Muster einen Dezimalpunkt erfordert. Ein anderer Parser könnte es als zehn Milliarden lesen. Sich darauf zu verlassen, dass der Parser errät, ist die Wurzel jedes Problems in diesem Abschnitt.
Faustregel: Wenn ein Wert als Text gedacht ist und nur aus Ziffern, Punkten oder Doppelpunkten besteht oder ein kurzes Wort wie „Ja“, „Nein“, „Ein“ oder „Aus“ ist, setzen Sie ihn in Anführungszeichen. Eine Zeichenfolge in Anführungszeichen zu setzen ist niemals falsch.
YAML 1.1 vs. 1.2
YAML 1.2, veröffentlicht im Jahr 2009, hat einen Großteil davon behoben. Es akzeptiert nur true und false als boolesche Werte, verwendet 0o für Oktalwerte und vermeidet Basis-60-Zahlen. Aber viele weit verbreitete Bibliotheken, einschließlich PyYAML, folgen standardmäßig immer noch 1.1, und darauf aufbauende Tools erben dieses Verhalten. Bibliotheken wie ruamel.yaml für Python implementieren 1.2. Da zwei Tools dieselbe Datei möglicherweise unterschiedlich lesen, besteht die einzig sichere Angewohnheit darin, unabhängig von der Version mehrdeutige Werte anzugeben.
Einrückung und Tabulatoren
YAML erlaubt keine Tabulatorzeichen zum Einrücken. Unser Test mit einem Tab ergab ab while scanning for the next token einen Fehler. Eine falsch ausgerichtete Einrückung ist ebenso fatal: Ein Listenelement wurde um ein Leerzeichen weniger eingerückt als seine Geschwister while parsing a block mapping. Konfigurieren Sie Ihren Editor so, dass er Leerzeichen einfügt und Leerzeichen anzeigt, und validieren Sie ihn nach der Bearbeitung immer. Einrückungsfehler sind der häufigste Grund, warum eine Bereitstellung unmittelbar nach einer „kleinen Konfigurationsänderung“ fehlschlägt.
Doppelte Schlüssel
name: first
name: second
# parsed: {'name': 'second'}
PyYAML akzeptierte das Duplikat stillschweigend und behielt den letzten Wert. Die YAML-Spezifikation besagt, dass Schlüssel eindeutig sein müssen, und einige Parser lehnen Duplikate ab, viele jedoch nicht. In einem langen Kubernetes-Manifest kann ein duplizierter Schlüssel stillschweigend eine zuvor definierte Einstellung überschreiben. Linters fangen dies zuverlässig auf.
Mehrzeilige Zeichenfolgen
literal: |
line one
line two
folded: >
line one
line two
# literal: 'line one\nline two\n'
# folded: 'line one line two\n'
Die Pipe | behält Zeilenumbrüche bei, was für Skripte, Zertifikate und SQL geeignet ist. > faltet Zeilen zu einer zusammen, was für lange Beschreibungen geeignet ist. Das Hinzufügen von - wie in |- entfernt die letzte neue Zeile, die wichtig ist, wenn der Wert genau verglichen oder als Geheimnis verwendet wird.
Anker und Zusammenführungsschlüssel
defaults: &defaults
retries: 3
timeout: 30
prod:
<<: *defaults
timeout: 60
# prod: {'retries': 3, 'timeout': 60}
&defaults benennt einen Block, *defaults verwendet ihn wieder und << führt ihn zu einer Karte zusammen, wobei lokale Schlüssel gewinnen. Dadurch werden Wiederholungen in Docker Compose- und CI-Dateien vermieden. Gehen Sie sparsam damit um: Die starke Verwendung von Ankern macht Dateien schwer lesbar und der Zusammenführungsschlüssel << ist nicht Teil von YAML 1.2, daher variiert die Unterstützung je nach Tool.
Sicheres Laden
Einige YAML-Loader können aus speziellen Tags beliebige Programmiersprachenobjekte erstellen, was bedeutet, dass beim Laden nicht vertrauenswürdiger YAML Code ausgeführt werden kann. PyYAMLs safe_load lehnt solche Tags ab. Als wir versuchten, ein Dokument zu laden, das nach os.system fragte, scheiterte es mit could not determine a constructor for the tag 'tag:yaml.org,2002:python/object/apply:os.system'. Verwenden Sie immer yaml.safe_load, es sei denn, Sie haben einen bestimmten Grund, dies nicht zu tun, und verwenden Sie niemals die unsicheren Ladeprogramme für Dateien von Benutzern oder aus dem Internet.
Flusen und Validierung
- yamllint fängt Tabulatoren, fehlerhafte Einrückungen, doppelte Schlüssel, nachgestellte Leerzeichen und wahrheitsgemäße Werte wie
yesab. - Schemas prüfen Struktur und Typen; Editoren wie VS Code können Kubernetes-, Compose- und GitHub-Aktionsdateien während der Eingabe anhand von JSON-Schemas validieren.
- Toolspezifische Prüfungen wie
kubectl apply --dry-run=serveroderdocker compose configvalidieren anhand dessen, was das Tool tatsächlich akzeptiert. - Führen Sie sie in CI aus, sodass eine fehlerhafte Konfiguration eine Pull-Anfrage und keine Bereitstellung scheitern lässt.
Wir haben Yamllint oder diese Tool-Prüfungen für diesen Artikel nicht ausgeführt. Halten Sie Secrets vollständig aus YAML-Dateien fern und laden Sie sie aus Umgebungsvariablen oder einem Secrets-Manager.
Fazit
YAML ist angenehm zu lesen und es ist gefährlich, blind zu vertrauen. Durch die Typschätzung wurde in unserem Test ein Ländercode in einen booleschen Wert, Versionen in Gleitkommazahlen, eine Postleitzahl in eine Oktalzahl und eine Zeit in Sekunden umgewandelt. Zitieren Sie alles, was als Text gedacht ist, verwenden Sie Leerzeichen und keine Tabulatoren, laden Sie es mit einem sicheren Ladeprogramm und fügen Sie einen Linter in Ihre Pipeline ein.
Häufige Fragen
Was ist das Norwegen-Problem in YAML?
Gemäß den YAML 1.1-Regeln wird der nicht in Anführungszeichen gesetzte Ländercode NO als boolescher Wert „false“ gelesen. In unserem Test wurde aus [GB, NO, SE, FI] [‘GB’, False, ‘SE’, ‘FI’]. Das Zitieren von „NEIN“ behebt das Problem.
Warum wurde meine Version 3.10 zu 3.1?
Eine nicht in Anführungszeichen gesetzte Zahl 3,10 wird als Gleitkommazahl geparst, wobei die nachgestellte Null weggelassen wird. Zitieren Sie Versionen wie „3.10“.
Kann ich Tabs in YAML verwenden?
Nein. YAML erfordert Leerzeichen zum Einrücken. Ein Tab führt wie in unserem Test zu einem Parsing-Fehler.
Was ist der Unterschied zwischen | und > in YAML?
Die | Der Stil hält die Zeilenumbrüche genau ein. Der >-Stil faltet Linien zu einer einzigen und verbindet sie mit Leerzeichen.
Ist YAML eine Obermenge von JSON?
YAML 1.2 ist als Obermenge von JSON konzipiert, sodass fast alle JSON-Dokumente gültiges YAML sind. Das Gegenteil ist nicht der Fall.
Lerne weiter
Benötigen Sie Hilfe beim Testen, WordPress oder SEO?
Wir helfen Teams, bessere Software zu liefern und ihre Websites zu erweitern. Sagen Sie uns, woran Sie gerade arbeiten, und wir schlagen Ihnen einen klaren nächsten Schritt vor.
Weitere Anleitungen finden Sie unter Tests, KI und moderne Entwicklung
Hat Ihnen dieser Artikel gefallen? Wählen Sie ein Thema und springen Sie direkt in unsere neuesten Tutorials.
Erklärte RAG-Chunking-Strategien: Fest, Überlappung, Satz, rekursiv und Überschriften, gemessen
RAG-Chunking-Strategien im Vergleich zu einem Dokument mit Tiktoken 0.14: feste Größe, Überlappung, Satzpackung, rekursive Aufteilung und überschrif…
Artikel lesen →SoftwareentwicklungAPI-Idempotenz erklärt: Idempotenzschlüssel und sichere Wiederholungsversuche, getestet
Erklärung der API-Idempotenz anhand eines von uns ausgeführten Python-Servers und -Clients: Eine verlorene Antwort verursachte eine doppelte Gebühr …
Artikel lesen →DevOpsGit Stash erklärt: Speichern, Anwenden, Pop und nicht verfolgte Dateien, getestet
Git Stash erklärt mit Befehlen, die wir auf Git 2.56 ausgeführt haben: Push mit einer Nachricht, nicht verfolgte Dateien, Auflisten und Anzeigen, An…
Artikel lesen →SoftwaretestsPaarweises Testen erklärt: Wie alle Paare 216 Tests auf 13 reduzieren, getestet
Paarweises Testen erklärt mit einem Generator, den wir in Python 3.13 ausgeführt haben: ein Checkout mit 216 Kombinationen, die durch 13 Tests abged…
Artikel lesen →TestautomatisierungTest-Doubles erklärt: Dummy, Stub, Spy, Mock und Fake, mit getestetem Python-Code
Test-Doubles werden anhand eines Python-Beispiels erklärt, das in Pytest 9.2 ausgeführt wird: Dummy, Stub, Spy, Mock und Fake, wann jeweils zu verwe…
Artikel lesen →Datenbanken & SQLSQL COALESCE erklärt: Standardwerte, NULLIF, IFNULL vs. ISNULL und Traps, getestet
SQL COALESCE wurde mit Abfragen erklärt, die wir in SQLite 3.50 ausgeführt haben: erste Nicht-Null-Werte, leere Zeichenfolgen, NULL in Mathematik, N…
Artikel lesen →Datenbanken & SQLSQL Self Join erklärt: Mitarbeiter-Manager, Paare und Zeilenvergleiche, getestet
SQL-Self-Join erklärt anhand von Abfragen, die wir in SQLite 3.50 ausgeführt haben: Mitarbeiter und Manager, mehr verdienen als der Manager, eindeut…
Artikel lesen →SoftwareentwicklungErklärter JavaScript-Spread-Operator: Spread vs. Rest, Kopien und Fallstricke, getestet
Der JavaScript-Spread-Operator wird mit Code erklärt, den wir auf Knoten 24 ausgeführt haben: Arrays, Objekte, flache Kopien, Restparameter, das Mat…
Artikel lesen →SoftwareentwicklungErklärtes Python-Sammlungsmodul: Counter, defaultdict, deque und mehr, getestet
Python-Sammlungen erklärt mit Code, den wir auf Python 3.13 ausgeführt haben: Counter, defaultdict, deque, benannttuple, OrderedDict und ChainMap, p…
Artikel lesen →Künstliche IntelligenzErklärtes LLM-Kontextfenster: Token, Grenzen und wie man mehr einpasst, gemessen
Das LLM-Kontextfenster wird anhand der Token-Anzahl erklärt, die wir mit Tiktoken gemessen haben: Wörter vs. Token für Prosa, Code und Hindi, Eingab…
Artikel lesen →SoftwareentwicklungWebhooks erklärt: Wie sie funktionieren und wie man sie sicher empfängt
Webhooks erklärt mit einem Empfänger und Sender, den wir in Python ausgeführt haben: Push vs. Polling, HMAC-SHA256-Signaturen, Ablehnen manipulierte…
Artikel lesen →DevOpsGit Cherry-Pick erklärt: Kopieren Sie den Commit, den Sie benötigen, sicher und getestet
Git Cherry-Pick erklärt mit Befehlen, die wir in Git 2.56 ausgeführt haben: Kopieren eines Hotfixes in einen Release-Zweig, neue Hashes und Patch-ID…
Artikel lesen →TestautomatisierungSnapshot-Tests erklärt: Wie es funktioniert, wann es hilft und wann es weh tut
Snapshot-Tests erklärt anhand einer Pytest- und Sirup-Demo, die wir ausgeführt haben: Snapshots erstellen, Diff nach einer Codeänderung lesen, Zeits…
Artikel lesen →SoftwaretestsMutationstests erklärt: Warum die 100-prozentige Abdeckung unseren Fehler immer noch übersehen hat
Mutationstests erklärt mit einem kleinen Mutationstool, das wir erstellt und ausgeführt haben: 14 Mutanten, eine Testsuite mit 100 % Linienabdeckung…
Artikel lesen →Künstliche IntelligenzPrompt Injection erklärt: Wie KI-Apps ausgetrickst werden und wie man sie verteidigt
Prompt-Injection erklärt für Builder: direkte und indirekte Angriffe, warum Schlüsselwortfilter fehlschlagen (unser Test hat 1 von 4 blockiert) und …
Artikel lesen →DevOpsErklärte DNS-Einträge: A, AAAA, CNAME, MX, TXT und TTL mit echten Lookups
DNS-Einträge erklärt anhand der von uns durchgeführten Suchvorgänge: Funktionsweise der Auflösung, A und AAAA, CNAME-Regeln, MX und Null-MX, TXT für…
Artikel lesen →DevOpsErklärte Funktionsflags: Sichere Veröffentlichungen, schrittweise Rollouts und Flag-Hygiene
Funktionsflags anhand einer von uns durchgeführten Rollout-Simulation erklärt: Flag-Typen, prozentuale Rollouts mit stabilem Hashing, Kill-Switches,…
Artikel lesen →TestautomatisierungTestdatengenerierung mit Python Faker: Realistische, wiederholbare und sichere Daten
Testen Sie die Datengenerierung mit Python Faker, führen Sie sie aus und messen Sie sie: Seeding für wiederholbare Daten, Gebietsschemata, eindeutig…
Artikel lesen →SoftwaretestsShift-Left-Tests erklärt: Finden Sie Fehler früher, ohne das Team zu verlangsamen
Shift-Left-Tests erklärt: Was es bedeutet, warum Frühdefekte günstiger sind, Vorgehensweisen von Anforderungsüberprüfungen bis hin zu CI-Prüfungen, …
Artikel lesen →Datenbanken & SQLErklärte SQL-String-Funktionen: TRIM, SUBSTR, REPLACE, CONCAT und Datenbereinigung
SQL-String-Funktionen, die mit von uns ausgeführten Abfragen erklärt wurden: Verkettung und NULL, TRIM, UPPER und LOWER, SUBSTR und INSTR, REPLACE, …
Artikel lesen →Datenbanken & SQLErklärte SQL-Trigger: VOR- und NACH-Trigger, Prüfprotokolle und Fallstricke
SQL-Trigger werden anhand von Triggern erklärt, die wir ausgeführt haben: VORHER vs. NACHHER, ALT und NEU, Prüfprotokolle, Validierung, Bestandsaktu…
Artikel lesen →SoftwareentwicklungErklärung des Python-JSON-Moduls: Dumps, Loads, benutzerdefinierte Typen und häufige Fehler
Das Python-JSON-Modul wird anhand des von uns ausgeführten Codes erklärt: Dumps und Loads, Dateien, Typkonvertierungen, Datumsangaben und Dezimalzah…
Artikel lesen →SoftwareentwicklungES-Module vs. CommonJS: Wie JavaScript-Importe in Node.js funktionieren, getestet
ES-Module vs. CommonJS erklärt mit Code, den wir in Node.js ausgeführt haben: Import- und Exportsyntax, Require, Live-Bindungen, Caching, Top-Level-…
Artikel lesen →SoftwareentwicklungPython Regex erklärt: Muster, Gruppen, Lookaheads und Fallstricke, getestet
Python-Regex erklärt mit Mustern, die wir ausgeführt haben: Suche vs. Übereinstimmung, Findall, Gruppen und benannte Gruppen, Greedy vs. Lazy, Sub, …
Artikel lesen →Künstliche IntelligenzErklärung der strukturierten LLM-Ausgabe: Zuverlässiges JSON aus KI-Modellen erhalten
Die strukturierte LLM-Ausgabe wird anhand der von uns in Pydantic ausgeführten Validierung erklärt: JSON-Modus und -Schemas, eingeschränkte Dekodier…
Artikel lesen →DevOpsSSH-Schlüssel erklärt: Wie sie funktionieren, ssh-keygen, Ed25519 und sichere Gewohnheiten
SSH-Schlüssel erklärt mit Schlüsseln, die wir generiert haben: öffentliche vs. private Schlüssel, ssh-keygen, Ed25519 vs. RSA, Fingerabdrücke, Passp…
Artikel lesen →DevOpsHTTP-Caching erklärt: Cache-Kontrolle, ETag und 304-Antworten, mit einem Live-Test
HTTP-Caching erklärt anhand eines kleinen Servers, den wir ausgeführt haben: Cache-Control-Anweisungen, Max-Age, No-Cache vs. No-Store, ETag-Revalid…
Artikel lesen →TestautomatisierungAPI-Vertragstests erklärt: Erkennen Sie wichtige Änderungen, bevor sie versendet werden
Das Testen von API-Verträgen wird anhand einer von uns durchgeführten Schemaprüfung erklärt: Was ein Vertrag ist, verbrauchergesteuerte Verträge, Pa…
Artikel lesen →SoftwaretestsRisikobasiertes Testen erklärt: Risiken bewerten, eine Matrix erstellen und testen, worauf es ankommt
Risikobasiertes Testen Schritt für Schritt erklärt: Risiken identifizieren, Wahrscheinlichkeit und Auswirkung bewerten, eine Risikomatrix erstellen,…
Artikel lesen →Datenbanken & SQLErklärte SQL-Einschränkungen: NOT NULL, UNIQUE, CHECK und FOREIGN KEY, getestet
SQL-Einschränkungen anhand der von uns durchgeführten Tests erklärt: NOT NULL, UNIQUE, CHECK, DEFAULT, PRIMARY und FOREIGN KEY, die NULL-Lücken, die…
Artikel lesen →Datenbanken & SQLErklärte SQL-Datumsfunktionen: Datumsangaben fehlerfrei hinzufügen, vergleichen und gruppieren
Erklärung der SQL-Datumsfunktionen anhand von Abfragen, die wir ausgeführt haben: Hinzufügen von Intervallen, Überraschungen am Monatsende, Datumsun…
Artikel lesen →SoftwareentwicklungPython-Asyncio erklärt: Async, Wait, Gather und TaskGroup mit echten Timings
Python-Asyncio erklärt mit Code, den wir getimt haben: Coroutinen, Wait, Gather, TaskGroup, Fehlerbehandlung, Zeitüberschreitungen, Einschränkung de…
Artikel lesen →SoftwareentwicklungDebounce vs. Throttle in JavaScript: Wie sie funktionieren, wann man sie verwendet, getestet
Debounce vs. Throttle in JavaScript erklärt anhand von Timings, die wir in Node.js gemessen haben: wie jedes funktioniert, einfache Implementierunge…
Artikel lesen →SoftwareentwicklungErklärte Python-Kontextmanager: Die with-Anweisung, contextlib und Real Uses
Python-Kontextmanager erklärt anhand des von uns ausgeführten Codes: Funktionsweise, __enter__ und __exit__, contextlib.contextmanager, supprimieren…
Artikel lesen →Künstliche IntelligenzLLM-Temperatur und Top-p erklärt: Wie KI-Modelle ihr nächstes Wort wählen
LLM-Temperatur und Top-P erklärt anhand einer von uns durchgeführten Simulation: wie Wahrscheinlichkeiten umgeformt werden, was Top-P beibehält, emp…
Artikel lesen →DevOpsYAML erklärt: Syntax, das Norwegen-Problem und andere von uns getestete Fallen
YAML erklärt mit einem Parser-Test: grundlegende Syntax, Listen und Karten, das Norwegen-Problem, Versionen, die in Gleitkommazahlen umgewandelt wer…
Artikel lesen →DevOpsCron-Jobs erklärt: Syntax, echte Zeitpläne und die Fehler, die sie zerstören
Cron-Jobs werden anhand von Zeitplänen erklärt, die wir überprüft haben: die fünf Felder, Operatoren, reale Beispiele, die Tag-des-Monats- ODER Woch…
Artikel lesen →Künstliche IntelligenzKI-Halluzinationen erklärt: Warum Sprachmodelle Dinge erfinden und wie man sie reduziert
KI-Halluzinationen erklärt: Was sie sind, warum Sprachmodelle sie produzieren, gängige Typen, wie man sie mit Erdung und Eingabeaufforderungen reduz…
Artikel lesen →DevOpsErklärte Umgebungsvariablen: .env-Dateien, Geheimnisse und Konfiguration richtig gemacht
Umgebungsvariablen anhand von Python-Beispielen erklärt, die wir ausgeführt haben: Sie lesen und festlegen, warum jeder Wert ein String ist, .env-Da…
Artikel lesen →SoftwareentwicklungAPI-Ratenbegrenzung erklärt: Algorithmen, Header und Behandlung von 429-Fehlern
API-Ratenbegrenzung anhand einer von uns durchgeführten Simulation erklärt: Token-Bucket, festes Fenster, gleitendes Fenster, 429 Antworten, Ratenbe…
Artikel lesen →TestautomatisierungSpott in Python: unittest.mock, Patch und die Fehler, die Tests zum Lügen machen
Mocking in Python mit unittest.mock, getestet: Mock und return_value, side_effect, Patchen, wo ein Name verwendet wird, Spezifikation und Autospec, …
Artikel lesen →SoftwaretestsCode-Abdeckung erklärt: Leitungs- und Zweigstellenabdeckung und was 100 % wirklich bedeutet
Erklärung der Codeabdeckung anhand eines echten Coverage.py-Laufs: Zeilen-, Zweig- und Bedingungsabdeckung, Lesen eines Berichts, warum bei 100 % Ab…
Artikel lesen →Datenbanken & SQLDELETE vs. TRUNCATE vs. DROP in SQL: Unterschiede, Rollback und Verwendungszweck
DELETE vs. TRUNCATE vs. DROP erklärt mit getestetem SQL: was jeweils entfernt wird, Rollback, Trigger, Identitätsrücksetzung, Geschwindigkeit und wi…
Artikel lesen →Datenbanken & SQLErklärte SQL-Ansichten: Erstellen, nutzen und vermeiden Sie Fallstricke mit Beispielen
SQL-Ansichten anhand der von uns ausgeführten Abfragen erklärt: Erstellen einer Ansicht, Live-Ergebnisse, Ausblenden von Spalten, Leistung, aktualis…
Artikel lesen →SoftwareentwicklungTypeScript-Schnittstelle vs. Typ: Echte Unterschiede, getestet mit dem Compiler
TypeScript-Schnittstelle vs. Typ, überprüft mit dem echten Compiler: Was beide können, was nur einer kann, Deklarationszusammenführung, Erweiterunge…
Artikel lesen →SoftwareentwicklungPython *args und **kwargs erklärt: Flexible Funktionen mit klaren Beispielen
Python *args und **kwargs erklärt mit Code, den wir ausgeführt haben: Packen und Entpacken, Parameterreihenfolge, Nur-Schlüsselwort- und Nur-Positio…
Artikel lesen →SoftwareentwicklungPython-Lambda-Funktionen: Syntax, tatsächliche Verwendung und wann man sie nicht verwendet
Python-Lambda-Funktionen erklärt mit Code, den wir ausgeführt haben: Syntax, Sortierung mit Schlüssel, Karte und Filter, Abschlüsse, die Late-Bindin…
Artikel lesen →Künstliche IntelligenzWas sind KI-Agenten? Wie sie funktionieren, mit einer einfachen Agentenschleife, die Sie ausführen können
Was sind KI-Agenten? Eine einfache Anleitung zur Agentenschleife, zu Tools, Speicher und Leitplanken, mit einer kleinen Python-Schleife, die wir aus…
Artikel lesen →DevOpsÜberwachung vs. Beobachtbarkeit: Der wahre Unterschied, mit Protokollen, Metriken und Traces
Überwachung vs. Beobachtbarkeit erklärt: bekannte und unbekannte Fehler, Protokolle, Metriken und Spuren, eine exemplarische Vorgehensweise für Chec…
Artikel lesen →DevOpsDocker-Volumes vs. Bind Mounts: Containerdaten auf die richtige Art und Weise beibehalten
Docker-Volumes vs. Bind-Mounts erklärt: Warum Containerdaten verschwinden, benannte Volumes, Bind-Mounts, tmpfs, Compose-Beispiele, Backups, Berecht…
Artikel lesen →TestautomatisierungTDD vs. BDD: Hauptunterschiede, eine Funktion, die auf beide Arten entwickelt wurde und wann sie jeweils verwendet werden sollte
TDD vs. BDD erklärt mit einer Rabattfunktion, die in beide Richtungen aufgebaut ist: Rot-Grün-Refaktor mit Code, den wir ausgeführt haben, Gegeben-W…
Artikel lesen →SoftwaretestsBenutzerakzeptanztests (UAT): Prozess, Checkliste und reale Beispiele
Benutzerakzeptanztests erklärt: Wer führt ihn durch, wie unterscheidet er sich von der Qualitätssicherung, ein siebenstufiger Prozess, eine UAT-Test…
Artikel lesen →Datenbanken & SQLErklärte SQL-NULL-Werte: IS NULL, COALESCE, NULLIF und die zu vermeidenden Fallen
SQL-NULL-Werte, die mit von uns ausgeführten Abfragen erklärt wurden: dreiwertige Logik, IS NULL, COALESCE, NULLIF, wie Aggregate, Joins und Sortier…
Artikel lesen →Datenbanken & SQLSQL CASE WHEN-Anweisung: Syntax, reale Beispiele und häufige Fehler
SQL CASE WHEN anhand der von uns ausgeführten Abfragen erklärt: einfache und durchsuchte Formulare, Bedingungsreihenfolge, Pivots mit SUM, COUNT-Tri…
Artikel lesen →SoftwareentwicklungWas ist JWT? JSON-Web-Tokens anhand eines funktionierenden Beispiels erklärt
Was ist JWT? JSON Web Tokens erklärt: die drei Teile, ein Token, das in dem von uns ausgeführten Code erstellt und manipuliert wurde, JWT vs. Sitzun…
Artikel lesen →SoftwareentwicklungErklärte JavaScript-Ereignisschleife: Aufrufstapel, Mikrotasks und Timer mit Beispielen
Die JavaScript-Ereignisschleife wurde mit dem von uns ausgeführten Code erklärt: Aufrufstapel, Aufgaben- und Mikrotask-Warteschlangen, warum setTime…
Artikel lesen →SoftwareentwicklungErklärung von Python-Generatoren und -Ertrag: Sparen Sie Speicher mit echten Beispielen
Python-Generatoren und Yield anhand des von uns ausgeführten Codes erklärt: wie sie angehalten und fortgesetzt werden, gemessene Speichereinsparunge…
Artikel lesen →Künstliche IntelligenzWas sind Einbettungen? Vektoren und Kosinusähnlichkeit einfach erklärt
Was sind Einbettungen? Ein Leitfaden in einfacher Sprache zu Vektoren, Kosinusähnlichkeit und semantischer Suche, mit einem kleinen Beispiel, das wi…
Artikel lesen →DevOpsBlau-Grün vs. Canary-Bereitstellung: Unterschiede, Kompromisse und Auswahl
Blue-Green vs. Canary-Bereitstellung erklärt: Funktionsweise, Kosten, Risiko und Rollback, stabiles Benutzer-Bucketing, das wir getestet haben, Date…
Artikel lesen →TestautomatisierungFlaky-Tests: Was sie verursacht und wie man sie endgültig behebt
Flaky-Tests wurden anhand von Demos erklärt, die wir durchgeführt haben: die Hauptursachen, wie man sie bestätigt und diagnostiziert, richtige Korre…
Artikel lesen →SoftwaretestsLasttest vs. Stresstest: Unterschiede, Metriken und k6-Beispiele
Erläuterungen zu Lasttests und Stresstests: Was die einzelnen Tests beweisen, Spike- und Soak-Tests, welche Kennzahlen wichtig sind, warum Durchschn…
Artikel lesen →SoftwaretestsTestfall vs. Testszenario: Hauptunterschiede, Beispiele und wann man sie jeweils verwendet
Testfall vs. Testszenario erklärt: klare Definitionen, eine Tabelle nebeneinander, eine Funktion zum Zurücksetzen von Passwörtern, die von Szenarios…
Artikel lesen →Datenbanken & SQLSQL-Abfrageoptimierung: Ausführungspläne lesen und langsame Abfragen mit Zeitvorgaben beheben
An einer Million Zeilen getestete SQL-Abfrageoptimierung: Ausführungspläne lesen, die richtigen Indizes hinzufügen, nicht sargierbare Filter korrigi…
Artikel lesen →Datenbanken & SQLSQL UNION vs. UNION ALL: Unterschiede, Beispiele und getestete Leistung
SQL UNION vs. UNION ALL anhand der von uns ausgeführten Abfragen erklärt: Duplikate, die Regeln, denen beide folgen, ein echter Datenfehler, gemesse…
Artikel lesen →SoftwareentwicklungTutorial zur JavaScript-Abruf-API: GET, POST, Fehlerbehandlung und Zeitüberschreitungen
Ein JavaScript-Abruf-API-Tutorial, das auf einem lokalen Server getestet wurde: GET und POST, warum 404 nicht ausgelöst wird, ein wiederverwendbarer…
Artikel lesen →SoftwareentwicklungUmgang mit Python-Dateien: Lesen, Schreiben, CSV, JSON und Pathlib mit Beispielen
Die Handhabung von Python-Dateien wird anhand des von uns ausgeführten Codes erklärt: Öffnungsmodi, Lesen großer Dateien, CSV, JSON, Pathlib, Binärd…
Artikel lesen →SoftwareentwicklungPython-Klassen und -Objekte: OOP-Tutorial mit echten Beispielen
Python-Klassen und -Objekte erklärt mit Code, den wir ausgeführt haben: __init__, Methoden, Klassen- und Instanzattribute, Vererbung, Eigenschaften,…
Artikel lesen →Künstliche IntelligenzWas ist ein großes Sprachmodell? Wie LLMs funktionieren, ohne großen Hype erklärt
Was ist ein großes Sprachmodell? LLMs im Klartext erklärt: Token, Einbettungen, Aufmerksamkeit, Training, Temperatur- und Kontextfenster, eine klein…
Artikel lesen →DevOpsLinux-Befehle für Anfänger: Der grundlegende Terminal-Leitfaden mit Beispielen
Linux-Befehle für Anfänger, gruppiert nach Aufgaben: Navigation, Dateien, Anzeigen von Protokollen, Grep, Pipes, Berechtigungen, Prozesse und Archiv…
Artikel lesen →TestautomatisierungSelenium vs. Playwright: Hauptunterschiede, Code im Vergleich und welche Sie wählen sollten
Selenium vs. Playwright im Vergleich: Architektur, Wartezeit, Browser- und Sprachunterstützung, Debugging, der gleiche Test in beiden Tools, Migrati…
Artikel lesen →SoftwaretestsÄquivalenzpartitionierung: Testdesigntechnik anhand von Beispielen erklärt
Erklärung der Äquivalenzpartitionierung: Wie man gültige und ungültige Partitionen findet, Beispiele für Alter, Passwörter und Gutscheine, von uns d…
Artikel lesen →SoftwaretestsSchweregrad vs. Priorität beim Softwaretest: Unterschiede, Matrix und reale Beispiele
Schweregrad vs. Priorität beim Softwaretest erklärt: klare Definitionen, eine Vier-Wege-Matrix mit Beispielen, Stufenskalen, wer die einzelnen Punkt…
Artikel lesen →Datenbanken & SQLTutorial zu SQL-Unterabfragen: Typen, korrelierte Unterabfragen und EXISTS mit Beispielen
Ein SQL-Unterabfrage-Tutorial mit Abfragen, die wir ausgeführt haben: Skalar-, IN-, FROM- und SELECT-Unterabfragen, korrelierte Unterabfragen, EXIST…
Artikel lesen →Datenbanken & SQLSQL-Transaktionen und ACID erklärt: COMMIT, ROLLBACK und Isolationsstufen
SQL-Transaktionen und ACID anhand einer von uns durchgeführten Banküberweisung erklärt: COMMIT, ROLLBACK, Sicherungspunkte, Sperren, Isolationsstufe…
Artikel lesen →SoftwareentwicklungSpickzettel für Git-Befehle: Die Befehle, die Sie tatsächlich verwenden, mit Beispielen
Ein Git-Befehls-Spickzettel, gruppiert nach Aufgabe: Setup, Staging, Branches, Remotes, Stash, Verlauf und Rückgängigmachen von Fehlern, mit Ausgabe…
Artikel lesen →SoftwareentwicklungErklärte JavaScript-Versprechen: Dann, Catch, Promise.all und häufige Fehler
JavaScript-Versprechen erklärt mit Code, den wir ausgeführt haben: Zustände, dann und Fangketten, Fehlerbehandlung, Promise.all, allSettled, Rennen …
Artikel lesen →SoftwareentwicklungPython-Wörterbuch-Tutorial: Methoden, Beispiele und gängige Muster
Ein Python-Wörterbuch-Tutorial mit Code, den wir ausgeführt haben: Diktate erstellen, lesen und aktualisieren, Schlüsselmethoden, Zusammenführung, V…
Artikel lesen →Künstliche IntelligenzWas ist RAG? Retrieval-Augmented Generation anhand eines Arbeitsbeispiels erklärt
Was ist RAG? Abruf-erweiterte Generierung Schritt für Schritt erklärt: Indizierung, Chunking, Einbettungen, Abruf, ein kleines funktionierendes Pyth…
Artikel lesen →DevOpsTerraform-Tutorial für Anfänger: Infrastruktur als Code von der ersten Datei bis zu den Modulen
Ein Terraform-Tutorial für Anfänger: Beginnen Sie ohne Cloud-Konto, lernen Sie Init, Planen und Anwenden, dann Variablen, Ausgaben, Status, Module u…
Artikel lesen →DevOpsDocker vs. Kubernetes: Hauptunterschiede, wie sie zusammenarbeiten und was Sie brauchen
Docker vs. Kubernetes erklärt: Was jeder tut, die gleiche App läuft mit beiden, Docker Compose und Swarm im Vergleich, die Dockershim-Änderung und w…
Artikel lesen →TestautomatisierungPytest-Tutorial für Anfänger: Vorrichtungen, Parametrisierung und reale Beispiele
Ein Pytest-Tutorial für Anfänger mit Tests, die wir auf Pytest 9.2 durchgeführt haben: Assertions, Fixtures, Parametrize, Conftest, Markers, tmp_pat…
Artikel lesen →SoftwaretestsSoftware Testing Life Cycle (STLC): 6 Phasen, Einstiegs- und Ausstiegskriterien, Beispiel
Der Softwaretest-Lebenszyklus erklärt: sechs STLC-Phasen mit Ein- und Ausstiegskriterien, Ergebnisse, ein Beispiel für eine funktionierende Anmeldef…
Artikel lesen →SoftwareentwicklungGit merge vs rebase: Unterschiede, Beispiele und wann man was nutzt
Git merge vs rebase erklärt mit echter Log-Ausgabe, einer Vergleichstabelle, der goldenen Regel des Rebase und einem sicheren Team-Workflow.
Artikel lesen →SoftwareentwicklungPython List Comprehension: Syntax, Beispiele und wann man darauf verzichtet
Python List Comprehension erklärt: Syntax, Filter, if-else, verschachtelte Schleifen, gemessene Zeiten und Fälle, in denen eine normale for-Schleife…
Artikel lesen →Datenbanken & SQLSQL Joins erklärt mit Beispielen (Inner, Left, Right, Full)
SQL Joins Schritt für Schritt mit Beispieltabellen und Abfragen verstehen: INNER, LEFT, RIGHT, FULL, CROSS und SELF, plus typische Fehler und Perfor…
Artikel lesen →