CSV to YAML

Vad är CSV till YAML-konvertering?

CSV till YAML-konvertering omvandlar tabulär, kommaseparerad data till YAML-format (YAML Ain't Markup Language). Varje rad i CSV-filen blir en post i en YAML-sekvens, och varje kolumnrubrik mappas till en nyckel i en YAML-mappning. Resultatet är ett läsbart, indenteringsbaserat dokument som konfigurationsverktyg och datapipelines kan tolka direkt utan ytterligare schemafiler.

YAML föreslogs första gången 2001 och nådde sin nuvarande specifikation (YAML 1.2) år 2009. Det är standardkonfigurationsformatet för Kubernetes-manifest, Docker Compose-filer, Ansible-playbooks, GitHub Actions-arbetsflöden och många CI/CD-system. När källdata finns i ett kalkylblad eller en databasexport är konvertering från CSV till YAML det snabbaste sättet att generera konfigurationsposter, startdatafixtures eller testinmatningar för dessa system.

En korrekt CSV till YAML-konverterare måste hantera RFC 4180:s tolkningsregler: citerade fält som innehåller kommatecken eller radbrytningar, undkomna dubbla citattecken och varierande avgränsare. På YAML-sidan måste strängar som liknar booleaner (yes, no, true, false), tal eller null citeras för att förhindra att YAML-tolkare konverterar dem till oönskade typer. Konverteraren bör också hantera Unicode-innehåll och producera giltig UTF-8-utmatning, eftersom YAML 1.2 kräver UTF-8 som standardkodning.

Varför använda en CSV till YAML-konverterare?

Att skriva YAML för hand från kalkylbladsdata är omständligt och felbenäget. En felplacerad indentering eller ett ociterat specialtecken producerar ogiltig YAML som bryter konfigurationsdriftsättningar eller dataimporter. Den här konverteraren tolkar CSV-fält, mappar rubriker till nycklar och genererar korrekt indenterad och citerad YAML-utmatning.

Användningsfall för CSV till YAML

Referens för CSV till YAML-mappning

Varje strukturellt element i en CSV-fil har en direkt motsvarighet i YAML.

CSV jämfört med YAML

CSV är ett platt, avgränsarseparerat format utan typinformation eller hierarki. YAML är en supermängd av JSON som använder indentering för nästling, stöder flera datatyper och tillåter kommentarer. Valet beror på vad ditt efterföljande verktyg förväntar sig.

Kodexempel

Fungerande exempel i Node.js, Python, Go och CLI-verktyg. Varje exempel läser CSV-rubrikraden som YAML-nycklar, mappar varje datarad till en sekvensposts och hanterar citering av typambiguösa värden.

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

Vanliga frågor