Da CSV a YAML

Cos'è la conversione da CSV a YAML?

La conversione da CSV a YAML trasforma dati tabulari separati da virgole nel formato YAML (YAML Ain't Markup Language). Ogni riga del file CSV diventa una voce in una sequenza YAML, e ogni intestazione di colonna corrisponde a una chiave in un mapping YAML. Il risultato è un documento leggibile dall'uomo, basato sull'indentazione, che gli strumenti di configurazione e le pipeline di dati possono analizzare direttamente senza file di schema aggiuntivi.

YAML è stato proposto per la prima volta nel 2001 e ha raggiunto la specifica attuale (YAML 1.2) nel 2009. È il formato di configurazione predefinito per i manifest Kubernetes, i file Docker Compose, i playbook Ansible, i workflow GitHub Actions e molti sistemi CI/CD. Quando i dati di origine si trovano in un foglio di calcolo o in un export di database, convertire CSV in YAML è il modo più rapido per generare voci di configurazione, fixture di seed o input di test per questi sistemi.

Un convertitore da CSV a YAML corretto deve gestire le regole di parsing RFC 4180: campi tra virgolette che contengono virgole o a capo, virgolette doppie con escape e delimitatori variabili. Sul lato YAML, le stringhe che sembrano booleani (yes, no, true, false), numeri o null devono essere racchiuse tra virgolette per evitare che i parser YAML le convertano in tipi non desiderati. Il convertitore deve inoltre gestire contenuti Unicode e produrre output UTF-8 valido, poiché YAML 1.2 richiede UTF-8 come codifica predefinita.

Perché usare un convertitore da CSV a YAML?

Scrivere YAML a mano partendo da dati di fogli di calcolo è tedioso e soggetto a errori. Un'indentazione errata o un carattere speciale non quotato produce YAML non valido che blocca i deployment di configurazione o le importazioni di dati. Questo convertitore analizza i campi CSV, mappa le intestazioni in chiavi e genera output YAML correttamente indentato e quotato.

Casi d'uso da CSV a YAML

Riferimento per la mappatura da CSV a YAML

Ogni elemento strutturale di un file CSV ha una controparte diretta in YAML.

CSV vs YAML

CSV è un formato piatto, separato da delimitatori, senza informazioni sui tipi o gerarchia. YAML è un superset di JSON che usa l'indentazione per l'annidamento, supporta più tipi di dati e consente commenti. La scelta dipende da cosa si aspetta il tuo strumento a valle.

Esempi di codice

Esempi funzionanti in Node.js, Python, Go e strumenti CLI. Ognuno legge la riga di intestazione CSV come chiavi YAML, mappa ogni riga di dati in una voce di sequenza e gestisce la quotatura per valori con ambiguità di tipo.

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

Domande frequenti