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, playbook-ів 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 to 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

Часті запитання