Penjelasan YAML: Sintaks, Masalah Norwegia, dan Jebakan Lain yang Kami Uji

  1. Beranda
  2. Blog
  3. DevOps

DevOps

Penjelasan YAML: Sintaks, Masalah Norwegia, dan Jebakan Lain yang Kami Uji

YAML menjalankan Kubernetes, Docker Compose, GitHub Actions, dan file konfigurasi yang tak terhitung jumlahnya. Kelihatannya bersahabat, tetapi nilai yang tidak diberi tanda kutip dapat secara diam-diam berubah menjadi bilangan boolean, float, dan oktal. Kami memasukkan file pengujian ke parser sebenarnya untuk menunjukkan apa yang sebenarnya terjadi.

10 menit baca
YAML menjelaskan: sintaksis, masalah Norwegia, dan jebakan lain yang kami uji

Poin penting

  • YAML mewakili data dengan lekukan: peta nilai kunci, daftar dengan tanda hubung, dan nilai skalar.
  • Nilai yang tidak diberi tanda kutip ditebak: dalam pengujian kami, NO menjadi False dan versi 1.10 menjadi 1.1.
  • Kutipan string yang terlihat seperti boolean, angka, waktu, atau versi.
  • Jangan pernah memuat YAML yang tidak tepercaya dengan pemuat yang tidak aman; gunakan yaml.safe_load dengan Python.

File konfigurasi mencantumkan negara tempat fitur diaktifkan: GB, SE, FI, dan NO. Semuanya berfungsi kecuali Norwegia. Kode menerima False dan bukan string “NO”, karena parser YAML memutuskan bahwa “NO” berarti “tidak”. Ini adalah masalah Norwegia yang terkenal, dan ini hanyalah salah satu dari beberapa cara YAML mengubah data Anda secara diam-diam.

Kami mem-parsing file yang sengaja rumit dengan PyYAML 6.0 di Python 3.13. Setiap nilai dan tipe yang ditampilkan di bawah berasal dari proses tersebut. Parser lain, khususnya yang mengikuti YAML 1.2, dapat memberikan hasil yang berbeda, dan ini merupakan bagian dari masalahnya.

Apa itu YAML?

YAML, singkatan dari “YAML Ain’t Markup Language”, adalah format data terstruktur yang ramah manusia. Ini menampung hal-hal yang sama seperti JSON, peta, daftar, string, angka, boolean, dan null, tetapi menggunakan indentasi alih-alih kurung kurawal dan mengizinkan komentar. Faktanya, JSON yang valid hampir selalu merupakan YAML yang valid. Keterbacaannya menjadikannya default untuk konfigurasi pada perkakas DevOps: manifes Kubernetes, file Docker Compose, alur kerja Tindakan GitHub, dan buku pedoman yang memungkinkan.

Sintaks dasar

# 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}

Indentasi menunjukkan penumpukan, dan spasi diperlukan setelah titik dua dan tanda hubung. Dua ruang per tingkat adalah konvensi umum. Daftar peta, yang sangat umum di Kubernetes, menggabungkan keduanya: masing-masing - memulai peta baru yang kuncinya sejajar di bawahnya.

Bagaimana tebakan YAML diketik

Nilai yang tidak diberi tanda kutip tidak secara otomatis menjadi string. Parser melihatnya dan memutuskan apakah itu boolean, angka, null atau string. Inilah yang dihasilkan PyYAML dari file pengujian kami:

YAML Nilai yang diurai Ketik
negara: TIDAK Salah bodoh
diaktifkan: ya Benar bodoh
debug: mati Salah bodoh
versi: 1.10 1.1 mengapung
ular sanca: 3.10 3.1 mengapung
zip: 01234 668 ke dalam
oktal: 0755 493 ke dalam
pelabuhan: 08 '08' str
waktu: 12:30 750 ke dalam
sha: 1e10 '1e10' str
kosong: Tidak ada Tidak Ada Tipe
gelombang laut: ~ Tidak ada Tidak Ada Tipe
dikutip_tidak: "TIDAK" 'TIDAK' str
quote_version: "1.10" '1.10' str

Hanya nilai yang dikutip yang muncul persis seperti yang tertulis. Setiap baris di atas yang dikutip merupakan potensi bug.

Masalah Norwegia

countries: [GB, NO, SE, FI]
# parsed: ['GB', False, 'SE', 'FI']

Berdasarkan aturan YAML 1.1, yang diikuti oleh PyYAML, kata yes, no, on, off, y dan n dalam berbagai huruf besar adalah boolean. Jadi kode negara untuk Norwegia menjadi False, sementara tetangganya tetap menggunakan string. Hal yang sama dapat terjadi pada jawaban dalam file survei, pada fitur flag bernama “on”, atau pada kode pendek apa pun yang cocok dengan salah satu kata tersebut. Cara mengatasinya sederhana setelah Anda mengetahuinya: kutip nilainya, "NO".

Angka yang berubah

Versi menjadi mengambang

1.10 dan 3.10 diurai sebagai angka 1.1 dan 3.1, kehilangan angka nol di belakangnya. File CI yang meminta Python 3.10 mungkin sebenarnya meminta Python 3.1. Pengguna GitHub Actions telah mencapai hal ini, dan saran standarnya adalah mengutip versi: python-version: "3.10". Lihat juga panduan pembuatan versi semantik kami untuk mengetahui alasan versi bukan angka.

Angka nol di depan berarti oktal

Kode pos 01234 menjadi 668, karena angka nol di depan menandai bilangan oktal (basis 8) di YAML 1.1. Itu berguna untuk izin file seperti 0755, yang menjadi 493, namun berbahaya untuk kode pos, nomor telepon, dan ID. Anehnya, 08 tetap berupa string, karena 8 bukan digit oktal yang valid, sehingga nilai yang tampak serupa dapat berakhir dengan tipe berbeda dalam file yang sama.

Waktu menjadi detik

12:30 menjadi 750. YAML 1.1 membaca angka yang dipisahkan titik dua sebagai basis 60, format “sexagesimal”, jadi 12 × 60 + 30 = 750. Jadwal atau pemetaan port seperti 22:22 dapat dikonversi secara diam-diam. Dokumentasi Docker Compose merekomendasikan mengutip pemetaan port karena alasan ini.

Dan kejutan sebaliknya

1e10 tetap menggunakan string di PyYAML, karena pola floatnya memerlukan titik desimal. Pengurai lain mungkin membacanya sebagai sepuluh miliar. Mengandalkan parser untuk menebak adalah akar dari setiap masalah di bagian ini.

Aturan praktis: jika suatu nilai dimaksudkan sebagai teks, dan hanya terdiri dari angka, titik, titik dua, atau berupa kata pendek seperti ya, tidak, hidup atau mati, masukkan dalam tanda petik. Mengutip sebuah string tidak pernah salah.

YAML 1.1 vs 1.2

YAML 1.2, yang diterbitkan pada tahun 2009, memperbaiki sebagian besar masalah ini. Ia hanya menerima true dan false sebagai boolean, menggunakan 0o untuk oktal, dan menghilangkan bilangan basis 60. Namun banyak perpustakaan yang banyak digunakan, termasuk PyYAML, masih mengikuti versi 1.1 secara default, dan alat yang dibangun di dalamnya mewarisi perilaku tersebut. Perpustakaan seperti ruamel.yaml untuk Python mengimplementasikan 1.2. Karena dua alat mungkin membaca file yang sama secara berbeda, satu-satunya kebiasaan aman adalah mengutip nilai yang ambigu, apa pun versinya.

Indentasi dan tab

YAML tidak mengizinkan karakter tab untuk lekukan. Pengujian kami dengan tab menghasilkan kesalahan mulai while scanning for the next token. Indentasi yang tidak selaras sama fatalnya: item daftar menjorok satu spasi lebih kecil dari yang dihasilkan saudaranya while parsing a block mapping. Konfigurasikan editor Anda untuk menyisipkan spasi dan menampilkan spasi, dan selalu validasi setelah pengeditan. Kesalahan indentasi adalah alasan paling umum mengapa penerapan gagal tepat setelah “perubahan konfigurasi kecil”.

Kunci duplikat

name: first
name: second
# parsed: {'name': 'second'}

PyYAML menerima duplikat secara diam-diam dan mempertahankan nilai terakhir. Spesifikasi YAML mengatakan kunci harus unik, dan beberapa parser menolak duplikat, namun banyak yang tidak. Dalam manifes Kubernetes yang panjang, kunci duplikat dapat secara diam-diam menggantikan pengaturan yang ditentukan sebelumnya. Linters menangkap ini dengan andal.

String multi-baris

literal: |
  line one
  line two
folded: >
  line one
  line two

# literal: 'line one\nline two\n'
# folded:  'line one line two\n'

Pipa | menyimpan jeda baris, yang sesuai dengan skrip, sertifikat, dan SQL. > melipat garis menjadi satu, yang sesuai dengan deskripsi panjang. Menambahkan -, seperti pada |-, menghapus baris baru terakhir, yang penting ketika nilainya dibandingkan secara tepat atau digunakan sebagai rahasia.

Jangkar dan gabungkan kunci

defaults: &defaults
  retries: 3
  timeout: 30
prod:
  <<: *defaults
  timeout: 60

# prod: {'retries': 3, 'timeout': 60}

&defaults memberi nama sebuah blok, *defaults menggunakannya kembali, dan << menggabungkannya ke dalam peta, dengan kunci lokal yang menang. Hal ini untuk menghindari pengulangan dalam file Docker Compose dan CI. Gunakan dengan hemat: penggunaan jangkar yang berat membuat file sulit dibaca, dan kunci gabungan << bukan bagian dari YAML 1.2, jadi dukungan bervariasi antar alat.

Pemuatan yang aman

Beberapa pemuat YAML dapat membuat objek bahasa pemrograman arbitrer dari tag khusus, yang berarti memuat YAML yang tidak tepercaya dapat menjalankan kode. safe_load PyYAML menolak tag tersebut. Saat kami mencoba memuat dokumen yang meminta os.system, gagal dengan could not determine a constructor for the tag 'tag:yaml.org,2002:python/object/apply:os.system'. Selalu gunakan yaml.safe_load kecuali Anda memiliki alasan khusus untuk tidak melakukannya, dan jangan pernah menggunakan pemuat yang tidak aman pada file dari pengguna atau internet.

Linting dan validasi

  • yamllint menangkap tab, lekukan buruk, kunci duplikat, spasi tambahan, dan nilai kebenaran seperti yes.
  • Skema memeriksa struktur dan tipe; editor seperti VS Code dapat memvalidasi file Kubernetes, Compose, dan GitHub Actions terhadap Skema JSON saat Anda mengetik.
  • Pemeriksaan khusus alat, seperti kubectl apply --dry-run=server atau docker compose config, memvalidasi terhadap apa yang sebenarnya diterima alat tersebut.
  • Jalankan di CI, sehingga konfigurasi yang rusak gagal dalam permintaan penarikan, bukan penerapan.

Kami tidak menjalankan yamllint atau pemeriksaan alat ini untuk artikel ini. Untuk rahasia, jauhkan semuanya dari file YAML dan muat dari variabel lingkungan atau pengelola rahasia.

Penutup

YAML menyenangkan untuk dibaca dan berbahaya untuk dipercaya secara membabi buta. Tebakan tipenya mengubah kode negara menjadi boolean, versi menjadi float, kode pos menjadi angka oktal, dan waktu menjadi detik dalam pengujian kami. Kutip apa pun yang dimaksudkan sebagai teks, gunakan spasi bukan tab, muat dengan pemuat yang aman, dan letakkan linter di saluran Anda.

Pertanyaan yang sering diajukan

Apa masalah Norwegia di YAML?

Berdasarkan aturan YAML 1.1, kode negara NO yang tidak dikutip dibaca sebagai boolean false. Dalam pengujian kami, [GB, NO, SE, FI] menjadi [‘GB’, False, ‘SE’, ‘FI’]. Mengutip “TIDAK” memperbaikinya.

Mengapa versi 3.10 saya menjadi 3.1?

3.10 yang tidak diberi tanda kutip diurai sebagai bilangan floating-point, yang menghilangkan angka nol di belakangnya. Versi kutipan, seperti “3.10”.

Bisakah saya menggunakan tab di YAML?

Tidak. YAML memerlukan spasi untuk lekukan. Sebuah tab menyebabkan kesalahan penguraian, seperti yang terjadi dalam pengujian kami.

Apa perbedaan antara | dan > di YAML?

| gaya menjaga jeda baris dengan tepat. Gaya > melipat garis menjadi satu, menggabungkannya dengan spasi.

Apakah YAML merupakan superset dari JSON?

YAML 1.2 dirancang untuk menjadi superset JSON, sehingga hampir semua dokumen JSON adalah YAML yang valid. Hal sebaliknya tidak benar.

Teruslah belajar

Bekerja dengan Stack Quora

Butuh bantuan dengan pengujian, WordPress atau SEO?

Kami membantu tim mengirimkan perangkat lunak yang lebih baik dan mengembangkan situs mereka. Beritahu kami apa yang sedang Anda kerjakan dan kami akan menyarankan langkah selanjutnya yang jelas.

Teruslah membaca

Panduan lebih lanjut tentang pengujian, AI & pengembangan modern

Menikmati artikel ini? Pilih topik dan langsung masuk ke tutorial terbaru kami.

Kecerdasan buatan

Penjelasan Strategi Chunking RAG: Tetap, Tumpang Tindih, Kalimat, Rekursif dan Judul, Terukur

Strategi pengelompokan RAG dibandingkan pada satu dokumen dengan tiktoken 0.14: ukuran tetap, tumpang tindih, pengepakan kalimat, pemisahan rekursif…

Baca artikel →
Pengembangan perangkat lunak

Penjelasan Idempotensi API: Kunci Idempotensi dan Percobaan Ulang Aman, Diuji

Idempotensi API dijelaskan dengan server dan klien Python yang kami jalankan: respons yang hilang menyebabkan tagihan ganda tanpa kunci dan satu tag…

Baca artikel →
DevOps

Penjelasan Git Stash: Simpan, Terapkan, Pop dan File Tidak Terlacak, Diuji

Git stash dijelaskan dengan perintah yang kami jalankan di Git 2.56: push dengan pesan, file yang tidak terlacak, daftar dan tampilkan, terapkan vs …

Baca artikel →
Pengujian perangkat lunak

Penjelasan Pengujian Berpasangan: Bagaimana Semua Pasangan Memotong 216 Tes menjadi 13, Diuji

Pengujian berpasangan dijelaskan dengan generator yang kami jalankan di Python 3.13: checkout dengan 216 kombinasi yang tercakup dalam 13 pengujian,…

Baca artikel →
Otomatisasi pengujian

Penjelasan Tes Ganda: Dummy, Stub, Spy, Mock dan Fake, dengan Kode Python yang Diuji

Tes ganda dijelaskan dengan satu contoh Python yang dijalankan di pytest 9.2: dummy, stub, spy, mock dan fake, kapan menggunakan masing-masing, peme…

Baca artikel →
Basis data & SQL

Penjelasan SQL COALESCE: Default, NULLIF, IFNULL vs ISNULL dan Traps, Diuji

SQL COALESCE dijelaskan dengan kueri yang kami jalankan di SQLite 3.50: nilai bukan nol pertama, string kosong, NULL dalam matematika, NULLIF untuk …

Baca artikel →
Basis data & SQL

SQL Self Join Dijelaskan: Karyawan-Manajer, Perbandingan Pasangan dan Baris, Diuji

Gabung mandiri SQL dijelaskan dengan kueri yang kami jalankan di SQLite 3.50: karyawan dan manajer, penghasilan lebih dari manajer, pasangan unik, p…

Baca artikel →
Pengembangan perangkat lunak

Penjelasan Operator Penyebaran JavaScript: Penyebaran vs Istirahat, Salinan dan Gotcha, Diuji

Operator penyebaran JavaScript menjelaskan dengan kode yang kami jalankan di Node 24: array, objek, salinan dangkal, parameter istirahat, batas Math…

Baca artikel →
Pengembangan perangkat lunak

Penjelasan Modul Koleksi Python: Counter, defaultdict, deque dan Lainnya, Diuji

Koleksi Python dijelaskan dengan kode yang kami jalankan di Python 3.13: Counter, defaultdict, deque, nametuple, OrderedDict dan ChainMap, ditambah …

Baca artikel →
Kecerdasan buatan

Jendela Konteks LLM Dijelaskan: Token, Batasan, dan Cara Menyesuaikannya Lebih Banyak, Diukur

Jendela konteks LLM dijelaskan dengan jumlah token yang kami ukur menggunakan tiktoken: kata vs token untuk prosa, kode dan bahasa Hindi, anggaran i…

Baca artikel →
Pengembangan perangkat lunak

Penjelasan Webhook: Cara Kerjanya dan Cara Menerimanya dengan Aman

Webhook menjelaskan dengan penerima dan pengirim yang kami jalankan dengan Python: push vs polling, tanda tangan HMAC-SHA256, menolak permintaan yan…

Baca artikel →
DevOps

Penjelasan Git Cherry-Pick: Salin Komit yang Anda Butuhkan, Aman, Teruji

Git cherry-pick dijelaskan dengan perintah yang kami jalankan di Git 2.56: menyalin perbaikan terbaru ke cabang rilis, hash baru dan id patch, -x, -…

Baca artikel →
Otomatisasi pengujian

Penjelasan Pengujian Snapshot: Cara Kerja, Kapan Membantu, dan Kapan Menyakitkan

Pengujian snapshot dijelaskan dengan demo pytest dan manis yang kami jalankan: membuat snapshot, membaca perbedaan setelah perubahan kode, menutupi …

Baca artikel →
Pengujian perangkat lunak

Penjelasan Pengujian Mutasi: Mengapa Cakupan 100% Masih Melewatkan Bug Kami

Pengujian mutasi dijelaskan dengan alat mutasi kecil yang kami buat dan jalankan: 14 mutan, rangkaian pengujian dengan cakupan garis 100% yang mempe…

Baca artikel →
Kecerdasan buatan

Penjelasan Injeksi Cepat: Bagaimana Aplikasi AI Ditipu dan Cara Mempertahankannya

Penjelasan injeksi cepat untuk pembuat: serangan langsung dan tidak langsung, mengapa filter kata kunci gagal (pengujian kami memblokir 1 dari 4), d…

Baca artikel →
DevOps

Penjelasan Catatan DNS: A, AAAA, CNAME, MX, TXT dan TTL Dengan Pencarian Nyata

Catatan DNS dijelaskan dengan pencarian yang kami jalankan: cara kerja resolusi, A dan AAAA, aturan CNAME, MX dan null MX, TXT untuk SPF dan verifik…

Baca artikel →
DevOps

Penjelasan Bendera Fitur: Rilis Aman, Peluncuran Bertahap, dan Kebersihan Bendera

Tanda fitur dijelaskan dengan simulasi peluncuran yang kami jalankan: jenis tanda, persentase peluncuran dengan hashing stabil, tombol pemutus, daft…

Baca artikel →
Otomatisasi pengujian

Uji Pembuatan Data Dengan Python Faker: Data yang Realistis, Dapat Diulang, dan Aman

Uji pembuatan data dengan Python Faker, jalankan dan ukur: penyemaian data berulang, lokal, nilai unik, catatan berbentuk domain, kasus tepi yang te…

Baca artikel →
Pengujian perangkat lunak

Penjelasan Pengujian Shift-Kiri: Temukan Bug Lebih Awal Tanpa Memperlambat Tim

Pengujian shift-kiri menjelaskan: apa artinya, mengapa cacat awal lebih murah, praktik mulai dari tinjauan persyaratan hingga pemeriksaan CI, peruba…

Baca artikel →
Basis data & SQL

Penjelasan Fungsi String SQL: TRIM, SUBSTR, REPLACE, CONCAT dan Pembersihan Data

Fungsi string SQL dijelaskan dengan kueri yang kami jalankan: penggabungan dan NULL, TRIM, UPPER dan LOWER, SUBSTR dan INSTR, REPLACE, padding, panj…

Baca artikel →
Basis data & SQL

Penjelasan Pemicu SQL: SEBELUM dan SETELAH Pemicu, Log Audit, dan Kesalahan

Pemicu SQL dijelaskan dengan pemicu yang kami jalankan: SEBELUM vs SETELAH, LAMA dan BARU, log audit, validasi, pembaruan stok, kondisi KAPAN, penge…

Baca artikel →
Pengembangan perangkat lunak

Penjelasan Modul Python JSON: dumps, load, Tipe Kustom, dan Kesalahan Umum

Modul Python JSON dijelaskan dengan kode yang kami jalankan: dumps dan load, file, konversi tipe, tanggal dan desimal, encoder khusus, object_hook, …

Baca artikel →
Pengembangan perangkat lunak

Modul ES vs CommonJS: Cara Kerja Impor JavaScript di Node.js, Diuji

Modul ES vs CommonJS dijelaskan dengan kode yang kami jalankan di Node.js: sintaksis impor dan ekspor, persyaratan, pengikatan langsung, caching, pe…

Baca artikel →
Pengembangan perangkat lunak

Penjelasan Regex Python: Pola, Grup, Pandangan ke Depan, dan Kesalahan, Diuji

Regex Python dijelaskan dengan pola yang kami jalankan: pencarian vs kecocokan, temukan semua, grup dan grup bernama, serakah vs malas, sub, lihat k…

Baca artikel →
Kecerdasan buatan

Penjelasan Keluaran Terstruktur LLM: Mendapatkan JSON yang Andal dari Model AI

Output terstruktur LLM dijelaskan dengan validasi yang kami jalankan di Pydantic: mode dan skema JSON, decoding terbatas, cara output model terputus…

Baca artikel →
DevOps

Penjelasan Kunci SSH: Cara Kerjanya, ssh-keygen, Ed25519 dan Kebiasaan Aman

Kunci SSH dijelaskan dengan kunci yang kami buat: kunci publik vs pribadi, ssh-keygen, Ed25519 vs RSA, sidik jari, frasa sandi, ssh-agent, Authorize…

Baca artikel →
DevOps

Penjelasan Caching HTTP: Kontrol Cache, Respons ETag dan 304, Dengan Tes Langsung

Caching HTTP dijelaskan dengan server kecil yang kami jalankan: arahan Kontrol-Cache, max-age, no-cache vs no-store, validasi ulang ETag dan respons…

Baca artikel →
Otomatisasi pengujian

Penjelasan Pengujian Kontrak API: Tangkap Perubahan yang Dapat Mengganggu Sebelum Dikirim

Pengujian kontrak API dijelaskan dengan pemeriksaan skema yang kami jalankan: apa itu kontrak, kontrak yang digerakkan oleh konsumen, Pakta, OpenAPI…

Baca artikel →
Pengujian perangkat lunak

Penjelasan Pengujian Berbasis Risiko: Nilai Risiko, Buat Matriks, dan Uji Hal yang Penting

Pengujian berbasis risiko menjelaskan langkah demi langkah: mengidentifikasi risiko, menilai kemungkinan dan dampak, membangun matriks risiko, memet…

Baca artikel →
Basis data & SQL

Penjelasan Kendala SQL: BUKAN NULL, UNIK, PERIKSA dan KUNCI ASING, Diuji

Batasan SQL dijelaskan dengan pengujian yang kami jalankan: NOT NULL, UNIQUE, CHECK, DEFAULT, PRIMARY dan FOREIGN KEY, celah NULL, pengaturan kunci …

Baca artikel →
Basis data & SQL

Penjelasan Fungsi Tanggal SQL: Menambah, Membandingkan dan Mengelompokkan Tanggal Tanpa Bug

Fungsi tanggal SQL dijelaskan dengan kueri yang kami jalankan: penambahan interval, kejutan akhir bulan, perbedaan tanggal, jebakan ANTARA, pengelom…

Baca artikel →
Pengembangan perangkat lunak

Penjelasan Python asyncio: async, menunggu, mengumpulkan dan TaskGroup Dengan Waktu Nyata

Python asyncio dijelaskan dengan kode yang kami atur waktunya: coroutine, menunggu, mengumpulkan, TaskGroup, penanganan kesalahan, batas waktu, memb…

Baca artikel →
Pengembangan perangkat lunak

Debounce vs Throttle dalam JavaScript: Cara Kerjanya, Kapan Menggunakannya, Diuji

Debounce vs throttle dalam JavaScript dijelaskan dengan pengaturan waktu yang kami ukur di Node.js: cara kerja masing-masing, implementasi sederhana…

Baca artikel →
Pengembangan perangkat lunak

Penjelasan Manajer Konteks Python: Pernyataan with, lib konteks, dan Penggunaan Nyata

Manajer konteks Python menjelaskan dengan kode yang kami jalankan: cara kerja, __enter__ dan __exit__, kontekslib.contextmanager, penekan, ExitStack…

Baca artikel →
Kecerdasan buatan

Penjelasan Suhu dan Top-p LLM: Bagaimana Model AI Memilih Kata Berikutnya

Suhu LLM dan top-p dijelaskan dengan simulasi yang kami jalankan: bagaimana probabilitas dibentuk kembali, apa yang dipertahankan top-p, pengaturan …

Baca artikel →
DevOps

Penjelasan YAML: Sintaks, Masalah Norwegia, dan Jebakan Lain yang Kami Uji

YAML menjelaskan dengan tes parser: sintaks dasar, daftar dan peta, masalah Norwegia, versi berubah menjadi float, kode pos oktal, waktu sexagesimal…

Baca artikel →
DevOps

Penjelasan Cron Jobs: Sintaks, Jadwal Sebenarnya, dan Kesalahan yang Melanggarnya

Pekerjaan Cron dijelaskan dengan jadwal yang kami verifikasi: lima bidang, operator, contoh nyata, jebakan hari dalam sebulan ATAU hari dalam seming…

Baca artikel →
Kecerdasan buatan

Penjelasan Halusinasi AI: Mengapa Model Bahasa Memperbaiki Masalah dan Cara Menguranginya

Halusinasi AI menjelaskan: apa itu, mengapa model bahasa memproduksinya, tipe umum, cara menguranginya dengan landasan dan petunjuk, dan pemeriksaan…

Baca artikel →
DevOps

Penjelasan Variabel Lingkungan: File .env, Rahasia, dan Konfigurasi Dilakukan dengan Benar

Variabel lingkungan dijelaskan dengan contoh Python yang kami jalankan: membaca dan mengaturnya, mengapa setiap nilai berupa string, file .env, pewa…

Baca artikel →
Pengembangan perangkat lunak

Penjelasan Pembatasan Kecepatan API: Algoritma, Header, dan Penanganan 429 Kesalahan

Pembatasan laju API dijelaskan dengan simulasi yang kami jalankan: keranjang token, jendela tetap, jendela geser, respons 429, header batas laju, pe…

Baca artikel →
Otomatisasi pengujian

Mengejek dengan Python: unittest.mock, patch dan Kesalahan yang Membuat Tes Berbohong

Mengejek dengan Python dengan unittest.mock, menguji: Mock dan return_value, side_effect, menambal di mana nama digunakan, spesifikasi dan autospec,…

Baca artikel →
Pengujian perangkat lunak

Penjelasan Cakupan Kode: Cakupan Jalur vs Cabang dan Apa Arti 100% Sebenarnya

Cakupan kode dijelaskan dengan coverage.py yang sebenarnya dijalankan: cakupan garis, cabang dan kondisi, membaca laporan, mengapa cakupan 100% masi…

Baca artikel →
Basis data & SQL

DELETE vs TRUNCATE vs DROP dalam SQL: Perbedaan, Rollback dan Kapan Menggunakan Masing-Masing

DELETE vs TRUNCATE vs DROP dijelaskan dengan SQL yang diuji: apa yang dihapus, rollback, pemicu, reset identitas, kecepatan, dan perbedaan PostgreSQ…

Baca artikel →
Basis data & SQL

Penjelasan Tampilan SQL: Membuat, Menggunakan, dan Menghindari Kesalahan, Dengan Contoh

Tampilan SQL dijelaskan dengan kueri yang kami jalankan: membuat tampilan, hasil langsung, menyembunyikan kolom, kinerja, tampilan yang dapat diperb…

Baca artikel →
Pengembangan perangkat lunak

Antarmuka TypeScript vs Tipe: Perbedaan Nyata, Diuji Dengan Kompiler

Antarmuka TypeScript vs tipe, diperiksa dengan kompiler sebenarnya: apa yang bisa dilakukan keduanya, apa yang hanya bisa dilakukan satu orang, peng…

Baca artikel →
Pengembangan perangkat lunak

Penjelasan Python *args dan **kwargs: Fungsi Fleksibel Dengan Contoh Jelas

Python *args dan **kwargs dijelaskan dengan kode yang kami jalankan: pengepakan dan pembongkaran, urutan parameter, argumen hanya kata kunci dan pos…

Baca artikel →
Pengembangan perangkat lunak

Fungsi Python Lambda: Sintaks, Kegunaan Sebenarnya, dan Kapan Tidak Digunakan

Fungsi python lambda dijelaskan dengan kode yang kami jalankan: sintaksis, pengurutan dengan kunci, peta dan filter, penutupan, jebakan pengikatan a…

Baca artikel →
Kecerdasan buatan

Apa Itu Agen AI? Cara Kerjanya, Dengan Agent Loop Sederhana yang Dapat Anda Jalankan

Apa itu agen AI? Panduan sederhana tentang loop agen, alat, memori, dan pagar pembatas, dengan loop Python kecil yang kami jalankan, risiko nyata da…

Baca artikel →
DevOps

Pemantauan vs Observabilitas: Perbedaan Nyata, Dengan Log, Metrik, dan Jejak

Penjelasan pemantauan vs observabilitas: kegagalan yang diketahui dan tidak diketahui, log, metrik dan jejak, penelusuran insiden checkout, sinyal e…

Baca artikel →
DevOps

Volume Docker vs Bind Mounts: Pertahankan Data Kontainer dengan Cara yang Benar

Volume Docker vs pengikatan pengikat dijelaskan: mengapa data kontainer menghilang, volume yang diberi nama, pengikatan pengikatan, tmpfs, contoh Tu…

Baca artikel →
Otomatisasi pengujian

TDD vs BDD: Perbedaan Utama, Satu Fitur Dibangun dengan Dua Cara dan Kapan Menggunakan Masing-masing

TDD vs BDD dijelaskan dengan satu fitur diskon yang dibuat dengan dua cara: refactor merah-hijau dengan kode yang kami jalankan, skenario Mengingat-…

Baca artikel →
Pengujian perangkat lunak

User Acceptance Testing (UAT): Proses, Checklist dan Contoh Nyata

Pengujian penerimaan pengguna menjelaskan: siapa yang menjalankannya, perbedaannya dengan QA, proses tujuh langkah, templat kasus uji UAT, daftar pe…

Baca artikel →
Basis data & SQL

Penjelasan Nilai NULL SQL: IS NULL, COALESCE, NULLIF dan Jebakan yang Harus Dihindari

Nilai SQL NULL dijelaskan dengan kueri yang kami jalankan: logika tiga nilai, IS NULL, COALESCE, NULLIF, cara agregat, penggabungan, dan pengurutan …

Baca artikel →
Basis data & SQL

Pernyataan SQL CASE WHEN: Sintaks, Contoh Nyata dan Kesalahan Umum

SQL CASE KETIKA dijelaskan dengan kueri yang kami jalankan: formulir sederhana dan dicari, urutan kondisi, pivot dengan SUM, trik COUNT, pengurutan …

Baca artikel →
Pengembangan perangkat lunak

Apa itu JWT? Token Web JSON Dijelaskan Dengan Contoh Kerja

Apa itu JWT? JSON Web Tokens menjelaskan: tiga bagian, token yang dibuat dan dirusak dalam kode yang kami jalankan, sesi JWT vs, penyimpanan, token …

Baca artikel →
Pengembangan perangkat lunak

Penjelasan Loop Acara JavaScript: Call Stack, Microtasks, dan Timer Dengan Contoh

Perulangan peristiwa JavaScript dijelaskan dengan kode yang kami jalankan: tumpukan panggilan, antrian tugas dan tugas mikro, mengapa setTimeout 0 t…

Baca artikel →
Pengembangan perangkat lunak

Generator Python dan Penjelasan Hasil: Menghemat Memori Dengan Contoh Nyata

Generator dan hasil Python dijelaskan dengan kode yang kami jalankan: bagaimana mereka menjeda dan melanjutkan, mengukur penghematan memori, saluran…

Baca artikel →
Kecerdasan buatan

Apa itu Embedding? Kesamaan Vektor dan Kosinus Dijelaskan Secara Sederhana

Apa itu embeddings? Panduan bahasa sederhana tentang vektor, kesamaan kosinus, dan penelusuran semantik, dengan contoh kecil yang kami jalankan, pen…

Baca artikel →
DevOps

Penerapan Biru-Hijau vs Canary: Perbedaan, Kompromi, dan Cara Memilih

Penjelasan penerapan blue-green vs canary: cara kerja masing-masing, biaya, risiko dan rollback, pengelompokan pengguna stabil yang kami uji, migras…

Baca artikel →
Otomatisasi pengujian

Tes Tidak Stabil: Apa Penyebabnya dan Cara Memperbaikinya untuk Kebaikan

Pengujian yang tidak stabil dijelaskan dengan demo yang kami jalankan: penyebab utama, cara mengonfirmasi dan mendiagnosisnya, perbaikan waktu yang …

Baca artikel →
Pengujian perangkat lunak

Load Testing vs Stress Testing: Perbedaan, Metrik dan Contoh k6

Penjelasan pengujian beban vs pengujian stres: apa yang dibuktikan masing-masing, pengujian lonjakan dan rendam, metrik yang penting, mengapa rata-r…

Baca artikel →
Pengujian perangkat lunak

Kasus Uji vs Skenario Uji: Perbedaan Utama, Contoh, dan Kapan Menggunakan Masing-masing

Penjelasan kasus uji vs skenario pengujian: definisi yang jelas, tabel berdampingan, satu fitur pengaturan ulang kata sandi yang diambil dari skenar…

Baca artikel →
Basis data & SQL

Optimasi Kueri SQL: Baca Rencana Eksekusi dan Perbaiki Kueri Lambat, Dengan Pengaturan Waktu

Pengoptimalan kueri SQL diuji pada sejuta baris: membaca rencana eksekusi, menambahkan indeks yang tepat, memperbaiki filter yang tidak dapat disarg…

Baca artikel →
Basis data & SQL

SQL UNION vs UNION ALL: Perbedaan, Contoh dan Kinerja Diuji

SQL UNION vs UNION ALL dijelaskan dengan kueri yang kami jalankan: duplikat, aturan yang diikuti keduanya, bug data nyata, kinerja terukur, INTERSEC…

Baca artikel →
Pengembangan perangkat lunak

Tutorial API Pengambilan JavaScript: GET, POST, Penanganan Kesalahan, dan Batas Waktu

Tutorial JavaScript Fetch API diuji pada server lokal: GET dan POST, mengapa 404 tidak muncul, bantuan yang dapat digunakan kembali, string kueri, b…

Baca artikel →
Pengembangan perangkat lunak

Penanganan File Python: Baca, Tulis, CSV, JSON dan pathlib Dengan Contoh

Penanganan file Python dijelaskan dengan kode yang kami jalankan: mode terbuka, dengan, membaca file besar, CSV, JSON, pathlib, file biner, penulisa…

Baca artikel →
Pengembangan perangkat lunak

Kelas dan Objek Python: Tutorial OOP Dengan Contoh Nyata

Kelas dan objek Python dijelaskan dengan kode yang kami jalankan: __init__, metode, atribut kelas vs instance, warisan, properti, metode dunder, kel…

Baca artikel →
Kecerdasan buatan

Apa Itu Model Bahasa Besar? Bagaimana LLM Bekerja, Dijelaskan Tanpa Hype

Apa yang dimaksud dengan model bahasa besar? LLM dijelaskan dalam bahasa sederhana: token, penyematan, perhatian, pelatihan, jendela suhu dan kontek…

Baca artikel →
DevOps

Perintah Linux untuk Pemula: Panduan Terminal Penting Dengan Contoh

Perintah Linux untuk pemula, dikelompokkan berdasarkan tugas: navigasi, file, melihat log, grep, pipa, izin, proses dan arsip, dengan contoh analisi…

Baca artikel →
Otomatisasi pengujian

Selenium vs Penulis Drama: Perbedaan Utama, Perbandingan Kode, dan Mana yang Harus Dipilih

Selenium vs Playwright dibandingkan: arsitektur, menunggu, dukungan browser dan bahasa, debugging, pengujian yang sama di kedua alat, saran migrasi …

Baca artikel →
Pengujian perangkat lunak

Partisi Ekivalensi: Teknik Desain Tes Dijelaskan Dengan Contoh yang Dikerjakan

Penjelasan partisi ekivalensi: cara menemukan partisi yang valid dan tidak valid, contoh yang berfungsi untuk usia, kata sandi dan kupon, pengujian …

Baca artikel →
Pengujian perangkat lunak

Severity vs Priority dalam Pengujian Perangkat Lunak: Perbedaan, Matriks dan Contoh Nyata

Keparahan vs prioritas dalam pengujian perangkat lunak dijelaskan: definisi yang jelas, matriks empat arah dengan contoh, skala level, siapa yang me…

Baca artikel →
Basis data & SQL

Tutorial Subkueri SQL: Jenis, Subkueri yang Berkorelasi, dan ADA Dengan Contoh

Tutorial subkueri SQL dengan kueri yang kami jalankan: subkueri skalar, IN, FROM dan SELECT, subkueri yang berkorelasi, EXISTS, jebakan NOT IN NULL …

Baca artikel →
Basis data & SQL

Penjelasan Transaksi SQL dan ACID: COMMIT, ROLLBACK dan Tingkat Isolasi

Transaksi SQL dan ACID dijelaskan dengan transfer bank yang kami jalankan: COMMIT, ROLLBACK, savepoint, kunci, tingkat isolasi, pembacaan kotor, keb…

Baca artikel →
Pengembangan perangkat lunak

Lembar Cheat Perintah Git: Perintah yang Sebenarnya Anda Gunakan, Beserta Contohnya

Lembar contekan perintah Git yang dikelompokkan berdasarkan tugas: pengaturan, pementasan, cabang, remote, simpanan, riwayat, dan pembatalan kesalah…

Baca artikel →
Pengembangan perangkat lunak

Penjelasan Janji JavaScript: lalu, tangkap, Janji.semua, dan Kesalahan Umum

Janji JavaScript dijelaskan dengan kode yang kami jalankan: status, rantai lalu dan tangkap, penanganan kesalahan, Promise.all, allSettled, race dan…

Baca artikel →
Pengembangan perangkat lunak

Tutorial Kamus Python: Metode, Contoh dan Pola Umum

Tutorial kamus Python dengan kode yang kami jalankan: membuat, membaca dan memperbarui dicts, metode utama, penggabungan, pemahaman, pola penghitung…

Baca artikel →
Kecerdasan buatan

Apa itu RAG? Generasi Retrieval-Augmented Dijelaskan Dengan Contoh Kerja

Apa itu RAG? Generasi yang ditambah pengambilan dijelaskan langkah demi langkah: pengindeksan, pemotongan, penyematan, pengambilan, contoh kecil Pyt…

Baca artikel →
DevOps

Tutorial Terraform untuk Pemula: Infrastruktur sebagai Kode Dari File Pertama hingga Modul

Tutorial Terraform untuk pemula: mulai tanpa akun cloud, pelajari init, rencanakan dan terapkan, lalu variabel, keluaran, status, modul, dan alur ke…

Baca artikel →
DevOps

Docker vs Kubernetes: Perbedaan Utama, Cara Kerja Sama, dan Yang Anda Butuhkan

Docker vs Kubernetes menjelaskan: apa yang dilakukan masing-masing, aplikasi yang sama dijalankan dengan keduanya, Docker Compose dan Swarm dibandin…

Baca artikel →
Otomatisasi pengujian

Tutorial Pytest untuk Pemula: Fixture, Parametrize dan Contoh Nyata

Tutorial pytest untuk pemula dengan pengujian yang kami jalankan di pytest 9.2: pernyataan, perlengkapan, parametrize, conftest, marker, tmp_path, m…

Baca artikel →
Pengujian perangkat lunak

Siklus Hidup Pengujian Perangkat Lunak (STLC): 6 Fase, Kriteria Masuk dan Keluar, Contoh

Siklus hidup pengujian perangkat lunak menjelaskan: enam fase STLC dengan kriteria masuk dan keluar, hasil, contoh fitur login yang berfungsi, STLC …

Baca artikel →
Pengembangan perangkat lunak

Git merge vs rebase: perbedaan, contoh, dan kapan memakai masing-masing

Git merge vs rebase dijelaskan dengan keluaran log nyata, tabel perbandingan, aturan emas rebase, dan alur kerja tim yang aman.

Baca artikel →
Pengembangan perangkat lunak

List Comprehension Python: Sintaks, Contoh, dan Kapan Harus Dihindari

List comprehension Python dijelaskan: sintaks, filter, if-else, perulangan bersarang, waktu yang diukur, dan kapan perulangan for biasa lebih baik.

Baca artikel →
Basis data & SQL

Penjelasan SQL JOIN dengan Contoh (Inner, Left, Right, Full)

Pahami SQL JOIN langkah demi langkah dengan tabel dan query contoh: INNER, LEFT, RIGHT, FULL, CROSS, dan SELF, plus kesalahan umum dan tips performa.

Baca artikel →