CSV Biçimlendirici

CSV Biçimlendirme Nedir?

CSV (Comma-Separated Values) biçimlendirme, ham tablo metnini normalleştirme sürecidir; bu sayede sınırlandırıcılar, tırnaklama, boşluklar ve satır sonları tutarlı bir kural setini izler. 2005 yılında yayımlanan RFC 4180, en yaygın benimsenen CSV standardını tanımlar: virgüllerle ayrılmış alanlar, CRLF ile sonlandırılan kayıtlar ve virgül, çift tırnak ya da satır sonu içeren alanlar çift tırnakla sarılır. Bir CSV biçimlendirici, dağınık veya tutarsız CSV verilerini alır ve bu kurallara uyacak şekilde yeniden yazar.

Gerçek dünyadaki CSV dosyaları nadiren temiz hâlde gelir. Excel, Google Sheets ve veritabanı döküm araçlarından yapılan elektronik tablo dışa aktarımları farklı tırnaklama stratejileri uygular, boşlukları farklı biçimde ele alır ve virgül yerine noktalı virgül veya sekme kullanabilir. Bu dosyaları katı RFC 4180 girdisi bekleyen bir ayrıştırıcıya verdiğinizde sonuç çoğu zaman bozuk satırlar, kaymış sütunlar veya sessiz veri kaybı olur. İşlemeden önce biçimlendirmek bu sorunları erken yakalar.

Bir CSV biçimlendirici, CSV dönüştürücüden farklıdır. Biçimlendirme veriyi CSV olarak tutar; tırnaklama normalleştirilir, gereksiz boşluklar kırpılır, sütunlar hizalanır ve isteğe bağlı olarak sınırlandırıcı değiştirilir. Dönüştürme ise biçimi tamamen değiştirir ve JSON, HTML, SQL veya Markdown çıktısı üretir.

Bu CSV Biçimlendiriciyi Neden Kullanmalısınız?

Bu araç, CSV'nizi tamamen tarayıcıda ayrıştırır ve yeniden serileştirir. Verileriniz makinenizden hiçbir zaman çıkmaz.

CSV Biçimlendirici Kullanım Senaryoları

CSV Tırnaklama ve Kaçış Kuralları (RFC 4180)

RFC 4180, alanların ne zaman ve nasıl tırnak içine alınması gerektiğine dair belirli kurallar tanımlar. Aşağıdaki altı senaryo, tırnaklama davranışının önemli olduğu durumları kapsar.

CSV Sınırlandırıcı Karşılaştırması

Sınırlandırıcı seçimi uyumluluğu, okunabilirliği ve tırnaklı alanlara ne sıklıkla ihtiyaç duyacağınızı etkiler.

Kod Örnekleri

Bu örnekler, dağınık CSV'nin farklı dillerde nasıl ayrıştırılacağını ve tutarlı biçimlendirmeyle nasıl yeniden serileştirileceğini gösterir. Her kod parçası boşluk kırpma, sınırlandırıcı normalleştirme ve tırnaklama işlemlerini kapsar.

import { parse, unparse } from 'papaparse'

const messy = `name, age ,city
Alice , 30, Berlin
Bob,25 , " Tokyo "`

// Parse with trimming, then re-serialize with consistent formatting
const parsed = parse(messy, {
  header: true,
  skipEmptyLines: true,
  transformHeader: h => h.trim(),
  transform: v => v.trim(),
})

const clean = unparse(parsed.data, { quotes: true })
console.log(clean)
// → "name","age","city"
// → "Alice","30","Berlin"
// → "Bob","25","Tokyo"

import csv
import io

messy = """name, age ,city
Alice , 30, Berlin
Bob,25 , " Tokyo " """

reader = csv.DictReader(io.StringIO(messy), skipinitialspace=True)
output = io.StringIO()
writer = csv.DictWriter(
    output,
    fieldnames=[f.strip() for f in reader.fieldnames],
    quoting=csv.QUOTE_ALL,
)
writer.writeheader()
for row in reader:
    writer.writerow({k.strip(): v.strip() for k, v in row.items()})

print(output.getvalue())
# → "name","age","city"
# → "Alice","30","Berlin"
# → "Bob","25","Tokyo"

package main

import (
	"encoding/csv"
	"fmt"
	"strings"
)

func main() {
	input := "name,age,city\nAlice,30,Berlin\nBob,25,Tokyo"
	r := csv.NewReader(strings.NewReader(input))
	records, _ := r.ReadAll()

	var buf strings.Builder
	w := csv.NewWriter(&buf)
	w.UseCRLF = true // RFC 4180 line endings
	for _, record := range records {
		_ = w.Write(record)
	}
	w.Flush()
	fmt.Print(buf.String())
	// → name,age,city\r\n
	// → Alice,30,Berlin\r\n
	// → Bob,25,Tokyo\r\n
}

# Re-format a CSV file with csvkit (Python-based)
csvformat -D ";" input.csv > output.csv

# Convert tabs to commas
csvformat -t input.tsv > output.csv

# Force-quote all fields
csvformat -U 1 input.csv > quoted.csv

# Using Miller (mlr) to normalize
mlr --icsv --ocsv --quote-all cat input.csv > clean.csv

Sıkça Sorulan Sorular