מהו קובץ TOML?
TOML (שפה מינימלית ברורה של Tom) היא פורמט קובץ תצורה מינימלי המשתמש בסיומת .toml. TOML שואפת להיות קל לקריאה, למפות באופן חד משמעי למילונים, ולהיות קל לנתח למבני נתונים שונים. ל-TOML יש מפרט קוד פתוח שקיבל תרומות מהקהילה. TOML נתמך על ידי שפות תכנות רבות כמו C, C#, Dart, Elixir, Erlang, Go, Java, PHP, Python, Ruby, Swift וכו’. סוג MIME עבור קבצי TOML הוא application/toml.
פורמט קובץ TOML
קובצי TOML מורכבים בעיקר מצמדי מפתח/ערך, מקטעים/טבלאות, הערות וחייבים להיות מסמך Unicode חוקי בקוד UTF-8. TOML תומך בסוגי נתונים מסוג מחרוזת, מספר שלם, צף, בוליאנית, תאריך תאריך, מערך וטבלה (טבלת גיבוב/מילון). TOML היא שפה הרגישה לאותיות גדולות.
תחביר
- צמדי מפתח-ערך: זוגות מפתח-ערך מופרדים בסימן שווה (=). כל זוג חייב להיות על קו חדש.
ראשון = "טום"
אחרון = "פרסטון-ורנר"
- הערות: תגובות מתחילות בסמל ה-hash (#).
# זהו מסמך TOML.
- מחרוזות: מחרוזות מוקפות במרכאות ("").
string = "מחרוזת לדוגמה"
- מחרוזות מרובות שורות: מחרוזות מרובות שורות מוקפות בשלושה מרכאות (""").
[כתובת בית]
street = """123 Tornado Alley
סוויטה 16"""
עיר = "East Centerville"
מצב = "KS"
- מספרים שלמים/צפים
מספר שלם = 20
לצוף = 20.5
- בוליאניות: בוליאניות הן תמיד אותיות קטנות.
bool1 = נכון
bool2 = false
- תאריך-שעה: עבור DateTime, אתה יכול להשתמש בתאריך-שעה בפורמט RFC 3339 כפי שמוצג בדוגמה למטה.
offset_date_time = 1979-05-27 07:32:00Z
local_date_time = 1979-05-27T07:32:00
local_date = 1979-05-27
מקומי_זמן = 07:32:00
- מערכים: מערכים מוקפים בסוגריים מרובעים עם אלמנטים מופרדים בפסיקים (,).
צבעים = [ "אדום", "צהוב", "ירוק" ]
- טבלאות: טבלאות הן אוספים של זוגות מפתח/ערך המוגדרים על ידי כותרות על קו חדש מוקף בסוגריים מרובעים ([]). הטבלה מסתיימת כאשר מסופקת כותרת חדשה או כאשר הקובץ מסתיים.
[כתובת בית]
street = """123 Tornado Alley
סוויטה 16"""
עיר = "East Centerville"
מצב = "KS"
[כתובת משרד]
street = """123 Tornado Alley
סוויטה 16"""
עיר = "East Centerville"
מצב = "KS"
טבלאות מוטבעות מוקפות בסוגריים מסולסלים ({}) כאשר כל זוג מפתח/ערך מופרד בפסיק (,).
name = { first = "Tom", last = "Pitt" }
