CSV to YAML

Apa itu Konversi CSV ke YAML?

Konversi CSV ke YAML mengubah data tabular berformat koma-terpisah menjadi format YAML (YAML Ain't Markup Language). Setiap baris dalam file CSV menjadi sebuah entri dalam urutan YAML, dan setiap header kolom dipetakan ke kunci dalam pemetaan YAML. Hasilnya adalah dokumen berbasis indentasi yang mudah dibaca manusia, yang dapat diurai langsung oleh alat konfigurasi dan pipeline data tanpa memerlukan file skema tambahan.

YAML pertama kali diusulkan pada tahun 2001 dan mencapai spesifikasi saat ini (YAML 1.2) pada tahun 2009. YAML adalah format konfigurasi bawaan untuk manifes Kubernetes, file Docker Compose, playbook Ansible, alur kerja GitHub Actions, dan banyak sistem CI/CD. Ketika data sumber Anda berada di spreadsheet atau ekspor basis data, mengonversi CSV ke YAML adalah cara tercepat untuk menghasilkan entri konfigurasi, fixture data awal, atau input pengujian untuk sistem-sistem tersebut.

Konverter CSV ke YAML yang benar harus menangani aturan penguraian RFC 4180: kolom yang dikutip yang mengandung koma atau baris baru, tanda kutip ganda yang di-escape, dan pembatas yang bervariasi. Di sisi YAML, string yang menyerupai boolean (yes, no, true, false), angka, atau null harus dikutip agar parser YAML tidak mengonversinya menjadi tipe yang tidak diinginkan. Konverter juga harus menangani konten Unicode dan menghasilkan keluaran UTF-8 yang valid, karena YAML 1.2 mengharuskan UTF-8 sebagai encoding bawaan.

Mengapa Menggunakan Konverter CSV ke YAML?

Menulis YAML secara manual dari data spreadsheet itu membosankan dan rawan kesalahan. Indentasi yang salah atau karakter khusus yang tidak dikutip menghasilkan YAML tidak valid yang merusak deployment konfigurasi atau impor data. Konverter ini mengurai kolom CSV, memetakan header ke kunci, dan menghasilkan keluaran YAML yang diindentasi dengan benar dan dikutip secara tepat.

Kasus Penggunaan CSV ke YAML

Referensi Pemetaan CSV ke YAML

Setiap elemen struktural dalam file CSV memiliki padanan langsung dalam YAML.

CSV vs YAML

CSV adalah format flat berpisah pembatas tanpa informasi tipe atau hierarki. YAML adalah superset dari JSON yang menggunakan indentasi untuk nesting, mendukung berbagai tipe data, dan memungkinkan komentar. Pilihan bergantung pada apa yang diharapkan oleh alat hilir Anda.

Contoh Kode

Contoh yang berfungsi dalam Node.js, Python, Go, dan alat CLI. Masing-masing membaca baris header CSV sebagai kunci YAML, memetakan setiap baris data ke entri urutan, dan menangani pengutipan untuk nilai yang ambigu tipenya.

import { parse } from 'csv-parse/sync'
import { stringify } from 'yaml'

const csv = `name,age,city
Alice,30,Berlin
Bob,25,"New York"`

const records = parse(csv, { columns: true, skip_empty_lines: true })
console.log(stringify(records))
// → - name: Alice
// →   age: "30"
// →   city: Berlin
// → - name: Bob
// →   age: "25"
// →   city: New York

// Vanilla JS (no dependencies)
function csvToYaml(csv) {
  const [headerLine, ...dataLines] = csv.trim().split('\n')
  const headers = headerLine.split(',')
  return dataLines.map(line => {
    const values = line.split(',')
    return headers.map((h, i) => `  ${h}: ${values[i] || ''}`).join('\n')
  }).map(block => `- ${block.trimStart()}`).join('\n')
}

import csv, io, yaml

csv_string = """name,age,city
Alice,30,Berlin
Bob,25,New York"""

reader = csv.DictReader(io.StringIO(csv_string))
data = list(reader)

# default_flow_style=False produces block-style YAML
print(yaml.dump(data, default_flow_style=False, sort_keys=False))
# → - age: '30'
# →   city: Berlin
# →   name: Alice
# → - age: '25'
# →   city: New York
# →   name: Bob

# Preserve insertion order with sort_keys=False (Python 3.7+)
# To type-cast numbers: data = [{k: int(v) if v.isdigit() else v ...}]

package main

import (
	"encoding/csv"
	"fmt"
	"gopkg.in/yaml.v3"
	"strings"
)

func main() {
	input := "name,age,city
Alice,30,Berlin
Bob,25,New York"
	r := csv.NewReader(strings.NewReader(input))
	records, _ := r.ReadAll()
	headers := records[0]

	var data []map[string]string
	for _, row := range records[1:] {
		entry := make(map[string]string)
		for i, h := range headers {
			entry[h] = row[i]
		}
		data = append(data, entry)
	}

	out, _ := yaml.Marshal(data)
	fmt.Println(string(out))
	// → - age: "30"
	// →   city: Berlin
	// →   name: Alice
	// → - age: "25"
	// →   city: New York
	// →   name: Bob
}

# Using yq (https://github.com/mikefarah/yq)
# yq reads CSV with --input-format=csv
yq --input-format=csv --output-format=yaml '.' data.csv

# Using Miller (mlr) — converts between CSV, JSON, YAML, and more
mlr --icsv --oyaml cat data.csv

# Python one-liner for quick conversion
python3 -c "
import csv, sys, yaml
data = list(csv.DictReader(sys.stdin))
print(yaml.dump(data, default_flow_style=False, sort_keys=False))
" < data.csv

Pertanyaan yang Sering Diajukan