ספרים
C#
פרק 10. פורמטים של נתונים וסריאליזציה
עבודה עם TOML

C#:
עבודה עם TOML

כיצד ל:

ראשית, התקן מנתח TOML כמו Tomlyn. השתמש במנהל החבילות שלך:

dotnet add package Tomlyn

לאחר מכן, נתח קובץ TOML:

using Tomlyn;
using Tomlyn.Model;
using System;

var tomlContent = @"
[owner]
name = 'Tom Preston-Werner'
dob = 1979-05-27T07:32:00Z";

var tomlTable = Toml.Parse(tomlContent).ToModel();

Console.WriteLine($"בעלים: {tomlTable["owner"]["name"]}");
// פלט:
// בעלים: Tom Preston-Werner

עכשיו, צור וכתוב TOML:

using Tomlyn;
using Tomlyn.Syntax;
using System;
using System.IO;

var doc = new DocumentSyntax
{
    Tables =
    {
        new TableSyntax("owner")
        {
            Items =
            {
                { "name", "Tom Preston-Werner" },
                { "dob", "1979-05-27T07:32:00Z" }
            }
        }
    }
};

var tomlString = doc.ToString();
File.WriteAllText("config.toml", tomlString);
Console.WriteLine("TOML נכתב ל- config.toml");
// פלט:
// TOML נכתב ל- config.toml

לעומק:

TOML נוצר על ידי טום פרסטון-וורנר, השותף המייסד של GitHub, בערך בשנת 2013 כתגובה למגבלות של פורמטים קיימים כמו YAML ו-JSON בהגדרות תצורה. הוא תוכנן במיוחד לקבצי תצורה עם דגש רב על פשטות וחד-משמעיות.

פורמטי תצורה חלופיים כוללים YAML, JSON, ו-XML. עם זאת, TOML בולט בכך שהוא ידידותי יותר לאדם, במיוחד עבור קבצי תצורה שעריכה בהם באופן ידני היא נפוצה. JSON, למרות שהוא נפוץ בכל מקום, פחות קריא עבור תצורות מורכבות, ו-XML מפורט. YAML, למרות שדומה בקריאות, יכול להיות מורכב עם שימוש כבד ברווחים לבנים ויש לו סיכוני אבטחה עם תוכן מסוים.

מבחינת יישום, TOML מתמקד במיפוי נקי לטבלת האש, דבר שהופך את חילוץ הנתונים לניתן לחיזוי. עם שחרור גרסה 1.0.0, TOML חיזק את המפרט שלו, משפר את היציבות ותמיכת הכלים.

ראה גם:

עבודה עם JSONעבודה עם XML