فایل TOML چیست؟

TOML (زبان حداقل آشکار تام) یک فرمت فایل پیکربندی حداقلی است که از پسوند .toml استفاده می کند. هدف TOML این است که خواندن آن آسان باشد، نگاشت بدون ابهام به فرهنگ لغت ها، و تجزیه آسان برای ساختارهای داده های مختلف باشد. TOML دارای مشخصات منبع باز است که مشارکت های جامعه را دریافت می کند. TOML توسط بسیاری از زبان های برنامه نویسی مانند C، C#، Dart، Elixir، Erlang، Go، Java، PHP، Python، Ruby، Swift و غیره پشتیبانی می شود. نوع MIME برای فایل های TOML application/toml است.

فرمت فایل TOML

فایل‌های TOML عمدتاً شامل جفت‌های کلید/مقدار، بخش‌ها/جدول، نظرات هستند و باید یک سند یونیکد رمزگذاری‌شده معتبر UTF-8 باشند. TOML از انواع داده‌های String، Integer، Float، Boolean، Datetime، Array و Table (جدول هش / دیکشنری) پشتیبانی می‌کند. TOML یک زبان حساس به حروف کوچک و بزرگ است.

نحو

  • جفت های کلید-مقدار: جفت های کلید-مقدار با علامت تساوی (=) از هم جدا می شوند. هر جفت باید در یک خط جدید باشد.

``تومل اول = تام آخرین = پرستون-ورنر


- **نظرات**: نظرات با علامت هش (#) شروع می شود.

``تومل
# این یک سند TOML است.
  • رشته: رشته ها با علامت نقل قول () احاطه شده اند.

``تومل string = رشته مثال


- ** رشته های چند خطی **: رشته های چند خطی توسط سه علامت نقل قول () احاطه شده اند.

``تومل
[آدرس خانه]
خیابان = 123 کوچه گردباد
سوئیت 16 
شهر = East Centerville
state = KS
  • اعداد صحیح/ شناور

``تومل عدد صحیح = 20 شناور = 20.5


- **Booleans**: Booleans همیشه با حروف کوچک هستند.

``تومل
bool1 = درست است
bool2 = نادرست
  • Date-Time: For DateTime, you may use an RFC 3339 formatted date-time as shown in the example below.

``تومل offset_date_time = 1979-05-27 07:32:00Z local_date_time = 1979-05-27T07:32:00 local_date = 1979-05-27 local_time = 07:32:00


- **آرایه ها**: آرایه ها با کروشه های مربع با عناصری که با کاما (،) از هم جدا شده اند احاطه شده اند.

``تومل
رنگها = [قرمز، زرد، سبز ]
  • جدول: جداول مجموعه‌ای از جفت‌های کلید/مقدار هستند که با سرصفحه‌ها در یک خط جدید احاطه‌شده با براکت‌های مربع ([]) تعریف می‌شوند. جدول زمانی به پایان می رسد که یک هدر جدید ارائه شود یا زمانی که فایل به پایان می رسد.

``تومل [آدرس خانه] خیابان = 123 کوچه گردباد سوئیت 16 شهر = East Centerville state = KS

[آدرس دفتر] خیابان = 123 کوچه گردباد سوئیت 16 شهر = East Centerville state = KS


جداول درون خطی با پرانتزهای فرفری ({}) احاطه شده اند که هر جفت کلید/مقدار با کاما (،) از هم جدا شده اند.

``تومل
name = { first = Tom, last = Pitt }

منابع

See Also