Conversor CSV para YAML

O que é a Conversão de CSV para YAML?

A conversão de CSV para YAML transforma dados tabulares separados por vírgula no formato YAML (YAML Ain't Markup Language). Cada linha do arquivo CSV se torna uma entrada em uma sequência YAML, e cada cabeçalho de coluna é mapeado para uma chave em um mapeamento YAML. O resultado é um documento legível por humanos, baseado em indentação, que ferramentas de configuração e pipelines de dados conseguem interpretar diretamente sem arquivos de esquema adicionais.

O YAML foi proposto pela primeira vez em 2001 e chegou à sua especificação atual (YAML 1.2) em 2009. É o formato de configuração padrão para manifests do Kubernetes, arquivos Docker Compose, playbooks do Ansible, workflows do GitHub Actions e muitos sistemas de CI/CD. Quando seus dados de origem estão em uma planilha ou exportação de banco de dados, converter CSV para YAML é a forma mais rápida de gerar entradas de configuração, fixtures de seed de dados ou entradas de teste para esses sistemas.

Um conversor correto de CSV para YAML deve seguir as regras de parsing do RFC 4180: campos entre aspas contendo vírgulas ou quebras de linha, aspas duplas escapadas e delimitadores variáveis. No lado do YAML, strings que parecem booleanos (yes, no, true, false), números ou null devem ser colocadas entre aspas para evitar que os parsers YAML as convertam em tipos não esperados. O conversor também deve tratar conteúdo Unicode e produzir saída UTF-8 válida, já que o YAML 1.2 exige UTF-8 como codificação padrão.

Por que usar um Conversor de CSV para YAML?

Escrever YAML à mão a partir de dados de planilha é tedioso e propenso a erros. Um espaço mal posicionado ou um caractere especial sem aspas produz YAML inválido que quebra implantações de configuração ou importações de dados. Este conversor interpreta os campos CSV, mapeia os cabeçalhos para chaves e gera saída YAML corretamente indentada e com aspas adequadas.

Casos de Uso do CSV para YAML

Referência de Mapeamento CSV para YAML

Cada elemento estrutural de um arquivo CSV tem uma contraparte direta no YAML.

CSV vs YAML

CSV é um formato plano, separado por delimitadores, sem informações de tipo ou hierarquia. YAML é um superconjunto do JSON que usa indentação para aninhamento, suporta múltiplos tipos de dados e permite comentários. A escolha depende do que sua ferramenta downstream espera.

Exemplos de Código

Exemplos funcionais em Node.js, Python, Go e ferramentas de linha de comando. Cada um lê a linha de cabeçalho do CSV como chaves YAML, mapeia cada linha de dados para uma entrada de sequência e trata as aspas para valores com tipos ambíguos.

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

Perguntas Frequentes