نحوه استفاده
- TOML را در ورودی جای‌گذاری کنید یا نمونه را امتحان کنید.
- تورفتگی 2 یا 4 فاصله‌ای را انتخاب کنید.
- JSON را کپی کنید یا آن را به‌صورت فایل .json دانلود کنید.
نحوه کار
TOML با کتابخانه متن‌باز smol-toml تجزیه می‌شود که TOML 1.0 را پیاده‌سازی می‌کند و سندهای نامعتبر مانند کلیدهای تکراری، جدول‌های بازتعریف‌شده یا مقادیر جاافتاده را رد می‌کند. اولین خطا همراه با شماره خط و ستون نمایش داده می‌شود؛ متن پیام از کتابخانه گرفته می‌شود و به زبان انگلیسی است.
جدول‌ها به اشیاء JSON و آرایه‌های جدول به آرایه‌هایی از اشیاء تبدیل می‌شوند. تاریخ‌ها و زمان‌ها نوع JSON ندارند؛ بنابراین به رشته‌های ISO 8601 به همان شکلی که نوشته شده‌اند تبدیل می‌شوند: تاریخ‌زمان دارای آفست، آفست خود را حفظ می‌کند، تاریخ‌های محلی به‌صورت yyyy-mm-dd و زمان‌های محلی به‌صورت hh:mm:ss باقی می‌مانند. اعداد صحیح بزرگ‌تر از آنچه JavaScript می‌تواند دقیق نگه دارد، به‌صورت اعداد دقیق JSON نوشته می‌شوند. inf و nan را نمی‌توان در JSON نوشت و به همراه یادداشتی null می‌شوند.
TOML میان اعداد صحیح و اعشاری تمایزی که JSON حفظ می‌کند قائل نیست: 1.0 به‌صورت 1 نوشته می‌شود. توضیح‌ها حذف می‌شوند. مسیر دیگر JSON به TOML است.
نمونه‌ها
pyproject.toml
جدول [project] با نام، نسخه و وابستگی‌ها به یک شیء JSON تبدیل می‌شود که می‌توانید آن را با jq پرس‌وجو کنید یا در یک اسکریپت بارگذاری کنید.
یافتن خطای نحوی
اگر یک کلید دو بار تعریف شود، خطا شماره خط و ستون تعریف دوم را مشخص می‌کند.
پرسش‌های متداول
کدام نسخه TOML پشتیبانی می‌شود؟
TOML 1.0، شامل آرایه‌های با نوع ترکیبی، کلیدهای نقطه‌ای و همه انواع تاریخ و زمان.
چه اتفاقی برای تاریخ‌ها می‌افتد؟
آن‌ها به رشته‌هایی در قالب ISO 8601 تبدیل می‌شوند؛ برای مثال 1979-05-27T07:32:00.000-08:00 یا 1979-05-27 برای یک تاریخ محلی.
چرا پیام خطا انگلیسی است؟
پیام‌های خطای نحوی از کتابخانه تجزیه‌کننده TOML می‌آیند. شماره خط و ستون نشان می‌دهد کجا را باید بررسی کنید.
حریم خصوصی
تبدیل کاملاً در مرورگر شما انجام می‌شود. TOML و JSON شما بارگذاری یا ذخیره نمی‌شوند.