CSV to YAML

Что такое конвертация CSV в YAML?

Конвертация CSV в YAML преобразует табличные данные с разделителями-запятыми в формат YAML (YAML Ain't Markup Language). Каждая строка CSV-файла становится элементом YAML-последовательности, а каждый заголовок столбца — ключом в YAML-отображении. Результат — читаемый человеком документ с отступами, который инструменты конфигурации и пайплайны обработки данных могут разбирать напрямую без дополнительных файлов схем.

YAML был впервые предложен в 2001 году и достиг своей текущей спецификации (YAML 1.2) в 2009 году. Это формат конфигурации по умолчанию для манифестов Kubernetes, файлов Docker Compose, плейбуков Ansible, рабочих процессов GitHub Actions и большинства CI/CD-систем. Когда исходные данные хранятся в электронной таблице или экспорте базы данных, конвертация CSV в YAML — самый быстрый способ создать записи конфигурации, фикстуры начальных данных или тестовые входные данные для этих систем.

Корректный конвертер CSV в YAML должен соблюдать правила разбора RFC 4180: поля в кавычках, содержащие запятые или переносы строк, экранированные двойные кавычки и различные разделители. На стороне YAML строки, похожие на булевы значения (yes, no, true, false), числа или null, должны заключаться в кавычки, чтобы YAML-парсеры не приводили их к нежелательным типам. Конвертер также должен работать с Unicode-контентом и генерировать корректный UTF-8-вывод, поскольку YAML 1.2 требует UTF-8 в качестве кодировки по умолчанию.

Зачем использовать конвертер CSV в YAML?

Вручную писать YAML на основе данных из электронных таблиц утомительно и чревато ошибками. Неверный отступ или незакавыченный специальный символ делают YAML недействительным, что ломает деплой конфигурации или импорт данных. Этот конвертер разбирает CSV-поля, сопоставляет заголовки с ключами и генерирует правильно отформатированный YAML-вывод с корректными отступами и кавычками.

Сценарии использования CSV в YAML

Справочник сопоставления CSV и YAML

Каждый структурный элемент CSV-файла имеет прямой аналог в YAML.

CSV и YAML

CSV — плоский формат с разделителями, не содержащий информации о типах и иерархии. YAML — надмножество JSON, использующее отступы для вложенности, поддерживающее несколько типов данных и допускающее комментарии. Выбор формата зависит от того, что ожидает принимающий инструмент.

Примеры кода

Рабочие примеры для Node.js, Python, Go и CLI-инструментов. Каждый пример читает строку заголовков CSV как YAML-ключи, сопоставляет каждую строку данных с элементом последовательности и обрабатывает кавычки для значений с неоднозначным типом.

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

Часто задаваемые вопросы