CSV থেকে YAML রূপান্তরকারী

CSV থেকে YAML রূপান্তর কী?

CSV থেকে YAML রূপান্তর হলো কমা-বিভাজিত টেবুলার ডেটাকে YAML (YAML Ain't Markup Language) ফরম্যাটে পরিবর্তন করার প্রক্রিয়া। CSV ফাইলের প্রতিটি সারি একটি YAML সিকোয়েন্সের এন্ট্রিতে পরিণত হয় এবং প্রতিটি কলাম হেডার একটি YAML ম্যাপিংয়ের কী হিসেবে ব্যবহৃত হয়। আউটপুট একটি human-readable, ইন্ডেন্টেশন-ভিত্তিক ডকুমেন্ট যা কনফিগারেশন টুল ও ডেটা পাইপলাইনগুলো অতিরিক্ত স্কিমা ফাইল ছাড়াই সরাসরি পার্স করতে পারে।

YAML প্রথম ২০০১ সালে প্রস্তাব করা হয়েছিল এবং ২০০৯ সালে এর বর্তমান স্পেসিফিকেশন (YAML 1.2) প্রকাশিত হয়। এটি Kubernetes ম্যানিফেস্ট, Docker Compose ফাইল, Ansible প্লেবুক, GitHub Actions ওয়ার্কফ্লো এবং অনেক CI/CD সিস্টেমের ডিফল্ট কনফিগারেশন ফরম্যাট। যখন আপনার উৎস ডেটা স্প্রেডশিট বা ডেটাবেজ এক্সপোর্টে থাকে, তখন CSV কে YAML এ রূপান্তর করাই হলো এই সিস্টেমগুলোর জন্য কনফিগ এন্ট্রি, সিড ডেটা ফিক্সচার বা পরীক্ষার ইনপুট তৈরির দ্রুততম উপায়।

একটি সঠিক CSV থেকে YAML কনভার্টারকে RFC 4180 পার্সিং নিয়ম পরিচালনা করতে হবে: কমা বা নতুন লাইনযুক্ত উদ্ধৃত ফিল্ড, escaped double quote এবং কাস্টম ডিলিমিটার। 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

প্রায়শই জিজ্ঞাসিত প্রশ্ন