Konwerter CSV na YAML

Czym jest konwersja CSV na YAML?

Konwersja CSV na YAML przekształca dane tabelaryczne rozdzielone przecinkami w format YAML (YAML Ain't Markup Language). Każdy wiersz pliku CSV staje się wpisem w sekwencji YAML, a każdy nagłówek kolumny mapuje się na klucz w odwzorowaniu YAML. Wynikiem jest czytelny dla człowieka dokument oparty na wcięciach, który narzędzia konfiguracyjne i potoki danych mogą parsować bezpośrednio, bez dodatkowych plików schematu.

YAML po raz pierwszy zaproponowano w 2001 roku, a jego obecna specyfikacja (YAML 1.2) pojawiła się w 2009 roku. Jest to domyślny format konfiguracji dla manifestów Kubernetes, plików Docker Compose, playbooków Ansible, przepływów pracy GitHub Actions i wielu systemów CI/CD. Gdy dane źródłowe znajdują się w arkuszu kalkulacyjnym lub eksporcie bazy danych, konwersja CSV na YAML to najszybszy sposób na generowanie wpisów konfiguracyjnych, danych inicjalizacyjnych lub danych testowych dla tych systemów.

Poprawny konwerter CSV na YAML musi obsługiwać zasady parsowania RFC 4180: pola w cudzysłowach zawierające przecinki lub znaki nowej linii, cudzysłowy ucieczki oraz różne separatory. Po stronie YAML wartości wyglądające jak wartości logiczne (yes, no, true, false), liczby lub null muszą być ujęte w cudzysłowy, aby parsery YAML nie rzutowały ich na niezamierzone typy. Konwerter powinien też obsługiwać zawartość Unicode i produkować poprawne wyjście UTF-8, ponieważ YAML 1.2 wymaga UTF-8 jako domyślnego kodowania.

Dlaczego warto używać konwertera CSV na YAML?

Ręczne pisanie YAML z danych arkusza kalkulacyjnego jest żmudne i podatne na błędy. Źle umieszczone wcięcie lub nieujęty w cudzysłów znak specjalny produkuje nieprawidłowy YAML, który psuje wdrożenia konfiguracji lub importy danych. Ten konwerter parsuje pola CSV, mapuje nagłówki na klucze i generuje poprawnie wcięty, prawidłowo cytowany wynik YAML.

Przypadki użycia konwersji CSV na YAML

Dokumentacja mapowania CSV na YAML

Każdy element strukturalny pliku CSV ma bezpośredni odpowiednik w YAML.

CSV a YAML

CSV to płaski format oparty na separatorach, bez informacji o typach ani hierarchii. YAML jest nadzbiorem JSON, który używa wcięć do zagnieżdżania, obsługuje wiele typów danych i dopuszcza komentarze. Wybór zależy od tego, czego oczekuje narzędzie docelowe.

Przykłady kodu

Działające przykłady w Node.js, Python, Go i narzędziach CLI. Każdy odczytuje wiersz nagłówka CSV jako klucze YAML, mapuje każdy wiersz danych na wpis sekwencji i obsługuje cytowanie dla wartości niejednoznacznych typowo.

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

Najczęściej zadawane pytania