CSV'den YAML'a Dönüştürücü

CSV'den YAML'a Dönüşüm Nedir?

CSV'den YAML'a dönüşüm, virgülle ayrılmış tablo verilerini YAML (YAML Ain't Markup Language) biçimine dönüştürür. CSV dosyasının her satırı bir YAML dizisinde bir girişe, her sütun başlığı ise bir YAML eşlemesinde bir anahtara dönüşür. Sonuç; yapılandırma araçlarının ve veri hatlarının ek şema dosyalarına gerek kalmadan doğrudan ayrıştırabileceği, girintilemeye dayalı ve insan tarafından okunabilir bir belgedir.

YAML ilk olarak 2001'de önerildi ve güncel belirtimi (YAML 1.2) 2009'da yayımlandı. Kubernetes manifest dosyaları, Docker Compose yapılandırmaları, Ansible playbook'ları, GitHub Actions iş akışları ve pek çok CI/CD sistemi için varsayılan yapılandırma biçimidir. Kaynak verileriniz bir elektronik tabloda veya veritabanı dışa aktarımındaysa, CSV'yi YAML'a dönüştürmek; bu sistemler için yapılandırma girdileri, seed veri sabitleri veya test girdileri oluşturmanın en hızlı yoludur.

Doğru bir CSV'den YAML'a dönüştürücü, RFC 4180 ayrıştırma kurallarını ele almalıdır: virgül veya satır sonu içeren tırnaklı alanlar, kaçırılmış çift tırnaklar ve değişen ayırıcılar. YAML tarafında ise boolean'a benzeyen (yes, no, true, false), sayıya veya null'a benzeyen dizeler, YAML ayrıştırıcılarının bunları istenmeyen türlere dönüştürmesini önlemek için tırnak içine alınmalıdır. Dönüştürücü ayrıca Unicode içeriği işlemeli ve geçerli UTF-8 çıktı üretmelidir; çünkü YAML 1.2, varsayılan kodlama olarak UTF-8'i gerektirir.

Neden CSV'den YAML'a Dönüştürücü Kullanmalısınız?

Elektronik tablo verilerinden YAML'ı elle yazmak sıkıcı ve hataya açıktır. Yanlış yerleştirilmiş bir girinti veya tırnak içine alınmamış özel bir karakter, yapılandırma dağıtımlarını veya veri içe aktarımlarını bozan geçersiz YAML üretir. Bu dönüştürücü, CSV alanlarını ayrıştırır, başlıkları anahtarlara eşler ve düzgün girintilenmiş, doğru tırnaklı YAML çıktısı üretir.

CSV'den YAML'a Kullanım Senaryoları

CSV'den YAML'a Eşleme Başvurusu

Bir CSV dosyasının her yapısal öğesinin YAML'da doğrudan bir karşılığı vardır.

CSV ve YAML Karşılaştırması

CSV, tür bilgisi veya hiyerarşi içermeyen düz, ayırıcı tabanlı bir biçimdir. YAML ise iç içe yapı için girintileme kullanan, birden fazla veri türünü destekleyen ve yorumlara izin veren bir JSON üst kümesidir. Seçim, aşağı akış aracınızın neyi beklediğine bağlıdır.

Kod Örnekleri

Node.js, Python, Go ve komut satırı araçlarında çalışan örnekler. Her örnek, CSV başlık satırını YAML anahtarları olarak okur, her veri satırını bir dizi girişine eşler ve türe belirsiz değerler için tırnaklama işlemini gerçekleştirir.

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

Sıkça Sorulan Sorular