تبدیل CSV به YAML

تبدیل CSV به YAML چیست؟

تبدیل CSV به YAML، داده‌های جدولی جداشده با کاما را به فرمت YAML (YAML Ain't Markup Language) تبدیل می‌کند. هر سطر فایل CSV به یک ورودی در یک آرایه YAML تبدیل می‌شود و هر سرستون به یک کلید در یک مپ YAML تبدیل می‌شود. خروجی یک سند مبتنی بر تورفتگی و قابل‌خواندن توسط انسان است که ابزارهای پیکربندی و خطوط لوله داده می‌توانند بدون نیاز به فایل‌های schema اضافی مستقیماً تجزیه کنند.

YAML در سال ۲۰۰۱ پیشنهاد شد و به مشخصات فعلی خود (YAML 1.2) در سال ۲۰۰۹ رسید. این فرمت، قالب پیکربندی پیش‌فرض برای مانیفست‌های Kubernetes، فایل‌های Docker Compose، playbook‌های Ansible، workflow‌های GitHub Actions و بسیاری از سیستم‌های CI/CD است. وقتی داده منبع شما در یک صفحه‌گسترده یا صادرات پایگاه داده قرار دارد، تبدیل CSV به YAML سریع‌ترین راه برای تولید ورودی‌های پیکربندی، fixture‌های داده اولیه یا ورودی‌های آزمون برای این سیستم‌ها است.

یک مبدل صحیح CSV به YAML باید قوانین تجزیه RFC 4180 را مدیریت کند: فیلدهای quote شده حاوی کاما یا سطر جدید، گیومه‌های دوتایی escape شده، و جداکننده‌های متغیر. در طرف YAML، رشته‌هایی که شبیه بولین (yes، no، true، false)، عدد یا null هستند باید quote شوند تا پارسرهای YAML آن‌ها را به انواع غیرمنتظره تبدیل نکنند. مبدل همچنین باید محتوای Unicode را مدیریت کرده و خروجی معتبر UTF-8 تولید کند، چرا که YAML 1.2 رمزگذاری UTF-8 را به‌عنوان پیش‌فرض الزامی می‌داند.

چرا از مبدل CSV به YAML استفاده کنیم؟

نوشتن دستی YAML از داده‌های صفحه‌گسترده خسته‌کننده و مستعد خطا است. یک تورفتگی اشتباه یا یک کاراکتر خاص بدون گیومه، YAML نامعتبری تولید می‌کند که استقرار پیکربندی یا وارد کردن داده را خراب می‌کند. این مبدل فیلدهای CSV را تجزیه می‌کند، سرستون‌ها را به کلیدها map می‌کند و خروجی YAML با تورفتگی و نقل‌قول‌گذاری صحیح تولید می‌کند.

موارد استفاده تبدیل CSV به YAML

مرجع نگاشت CSV به YAML

هر عنصر ساختاری یک فایل CSV معادل مستقیمی در YAML دارد.

CSV در برابر YAML

CSV یک فرمت تخت و جداشده با جداکننده است که هیچ اطلاعات نوع یا سلسله‌مراتبی ندارد. YAML یک superset از JSON است که از تورفتگی برای تودرتو شدن استفاده می‌کند، از انواع داده چندگانه پشتیبانی می‌کند و اجازه نظرات را می‌دهد. انتخاب به این بستگی دارد که ابزار پایین‌دست شما چه انتظاری دارد.

نمونه‌های کد

مثال‌های کاربردی در Node.js، Python، Go و ابزارهای CLI. هر کدام سطر سرصفحه CSV را به‌عنوان کلیدهای YAML می‌خواند، هر سطر داده را به یک ورودی آرایه map می‌کند و quote کردن را برای مقادیر مبهم از نظر نوع مدیریت می‌کند.

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

سوالات متداول