نحوه استفاده
- یک شیء JSON جای‌گذاری کنید یا مثال را امتحان کنید.
- اگر JSON شما شامل nullهایی است که نیاز ندارید، گزینه‌ی «حذف مقادیر null» را روشن کنید.
- TOML را کپی کنید یا آن را به‌صورت فایل .toml دانلود کنید.
نحوه کار
JSON ابتدا به‌صورت دقیق تجزیه می‌شود، سپس با کتابخانه متن‌باز smol-toml به‌صورت TOML 1.0 نوشته می‌شود. اشیاء تودرتو به [tables]، آرایه‌های اشیاء به [[arrays of tables]] تبدیل می‌شوند و کلیدهایی که واژه ساده نیستند داخل علامت نقل‌قول قرار می‌گیرند.
TOML نمی‌تواند همه چیزهایی را که JSON بیان می‌کند بیان کند. ریشه سند باید جدول باشد؛ بنابراین آرایه JSON یا یک مقدار تکی رد می‌شود. در TOML مقدار null وجود ندارد: به‌طور پیش‌فرض اولین null به‌همراه مسیر آن گزارش می‌شود؛ می‌توانید انتخاب کنید اعضای شیء که null هستند حذف شوند. null داخل آرایه همیشه خطا است، زیرا حذف آن جایگاه عناصر دیگر را تغییر می‌دهد. آرایه‌هایی که انواع را ترکیب می‌کنند (مثلاً عدد و رشته) در TOML 1.0 معتبرند اما در نسخه قدیمی‌تر 0.5 معتبر نیستند؛ به همین دلیل در یک یادداشت شمارش می‌شوند.
JSON تفاوتی بین 1 و 1.0 قائل نمی‌شود؛ بنابراین اعداد صحیح به‌صورت عدد صحیح TOML نوشته می‌شوند. رشته‌هایی که شبیه تاریخ هستند رشته باقی می‌مانند. مسیر برعکس، TOML به JSON است.
نمونه‌ها
تنظیمات برنامه
{"server": {"host": "0.0.0.0", "port": 8080}} به یک جدول [server] با کلیدهای host و port تبدیل می‌شود.
فهرست کارگرها
"workers": [{"queue": "mail"}, {"queue": "images"}] به دو بلوک [[workers]] تبدیل می‌شود.
پرسش‌های متداول
چرا null مجاز نیست؟
TOML مقدار null ندارد. بسته به انتظار برنامه خواننده، کلید را حذف کنید یا از مقداری مانند رشته خالی استفاده کنید.
چرا آرایه‌ای از اعداد و رشته‌ها یک یادداشت نشان می‌دهد؟
آرایه‌های با نوع مختلط از TOML 1.0 مجاز هستند، اما ابزارهایی که TOML 0.5 را پیاده‌سازی می‌کنند آن‌ها را رد می‌کنند. این یادداشت وقتی مفید است که ابزار هدف شما قدیمی‌تر باشد.
آیا 1.0 عدد اعشاری باقی می‌ماند؟
نه. JSON مقدار 1.0 و 1 را به‌صورت یک عدد ذخیره می‌کند، بنابراین به عدد صحیح 1 تبدیل می‌شود. اگر برنامه‌ی خواننده به عدد اعشاری نیاز دارد، 1.5 بنویسید یا TOML را ویرایش کنید.
حریم خصوصی
تبدیل کاملاً در مرورگر شما انجام می‌شود. JSON و TOML شما بارگذاری یا ذخیره نمی‌شوند.