Convertisseur CSV en YAML

Qu'est-ce que la conversion CSV vers YAML ?

La conversion CSV vers YAML transforme des données tabulaires séparées par des virgules au format YAML (YAML Ain't Markup Language). Chaque ligne du fichier CSV devient une entrée dans une séquence YAML, et chaque en-tête de colonne correspond à une clé dans un mapping YAML. Le résultat est un document lisible par l'humain, basé sur l'indentation, que les outils de configuration et les pipelines de données peuvent analyser directement sans fichiers de schéma supplémentaires.

YAML a été proposé pour la première fois en 2001 et a atteint sa spécification actuelle (YAML 1.2) en 2009. C'est le format de configuration par défaut pour les manifests Kubernetes, les fichiers Docker Compose, les playbooks Ansible, les workflows GitHub Actions et la plupart des systèmes CI/CD. Lorsque vos données sources se trouvent dans un tableur ou un export de base de données, la conversion CSV vers YAML est le moyen le plus rapide de générer des entrées de configuration, des fixtures de données ou des entrées de test pour ces systèmes.

Un convertisseur CSV vers YAML correct doit gérer les règles de parsing de la RFC 4180 : les champs entre guillemets contenant des virgules ou des sauts de ligne, les guillemets doubles échappés et les délimiteurs variables. Côté YAML, les chaînes qui ressemblent à des booléens (yes, no, true, false), des nombres ou null doivent être mises entre guillemets pour éviter que les parseurs YAML les convertissent en types non voulus. Le convertisseur doit également gérer le contenu Unicode et produire une sortie UTF-8 valide, car YAML 1.2 exige UTF-8 comme encodage par défaut.

Pourquoi utiliser un convertisseur CSV vers YAML ?

Écrire du YAML à la main à partir de données de tableur est fastidieux et source d'erreurs. Une indentation mal placée ou un caractère spécial non entouré de guillemets produit du YAML invalide qui bloque les déploiements de configuration ou les imports de données. Ce convertisseur analyse les champs CSV, mappe les en-têtes sur des clés et génère une sortie YAML correctement indentée et entre guillemets.

Cas d'utilisation CSV vers YAML

Référence de mapping CSV vers YAML

Chaque élément structurel d'un fichier CSV a un équivalent direct en YAML.

CSV vs YAML

CSV est un format plat séparé par des délimiteurs sans information de type ni hiérarchie. YAML est un sur-ensemble de JSON qui utilise l'indentation pour l'imbrication, prend en charge plusieurs types de données et autorise les commentaires. Le choix dépend de ce qu'attend votre outil en aval.

Exemples de code

Exemples fonctionnels en Node.js, Python, Go et outils CLI. Chacun lit la ligne d'en-tête CSV comme clés YAML, mappe chaque ligne de données sur une entrée de séquence et gère les guillemets pour les valeurs ambiguës du point de vue du type.

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

Questions fréquentes