محوّل TOML إلى JSON

ما هو TOML ولماذا التحويل إلى JSON؟

// Convert TOML to JSON in Node.js using the smol-toml library
import { parse } from 'smol-toml';

const toml = `
[package]
name = "my-app"
version = "1.0.0"

[dependencies]
serde = { version = "1.0", features = ["derive"] }
`;

const data = parse(toml);
const json = JSON.stringify(data, null, 2);

console.log(json);
// {
//   "package": { "name": "my-app", "version": "1.0.0" },
//   "dependencies": {
//     "serde": { "version": "1.0", "features": ["derive"] }
//   }
// }

الميزات الرئيسية

أمثلة

[package]
name = "my-app"
version = "1.0.0"
edition = "2021"
authors = ["Jane Doe <jane@example.com>"]

[dependencies]
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }

[dev-dependencies]
criterion = "0.5"

[[bin]]
name = "my-app"
path = "src/main.rs"

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[project]
name = "my-package"
version = "0.3.1"
requires-python = ">=3.10"
dependencies = [
  "requests>=2.31",
  "pydantic>=2.0"
]

[project.optional-dependencies]
dev = ["pytest>=8.0", "ruff>=0.4"]

[tool.ruff]
line-length = 100

[build]
command = "npm run build"
publish = "dist"

[build.environment]
NODE_VERSION = "20"

[[redirects]]
from = "/old-path"
to = "/new-path"
status = 301
force = true

[[headers]]
for = "/*"

[headers.values]
X-Frame-Options = "DENY"

baseURL = "https://example.org"
languageCode = "en-us"
title = "My Hugo Site"
theme = "ananke"

[params]
description = "A static site built with Hugo"
mainSections = ["posts", "docs"]

[[menu.main]]
name = "Blog"
url = "/posts/"
weight = 1

[[menu.main]]
name = "About"
url = "/about/"
weight = 2

edition = "2021"
max_width = 100
hard_tabs = false
tab_spaces = 4
newline_style = "Unix"
use_small_heuristics = "Default"
reorder_imports = true
reorder_modules = true

title = "Deployment Log"
last_deployed = 1979-05-27T07:32:00Z
release_date = 1979-05-27
maintenance_window = 02:00:00

[[servers]]
name = "alpha"
ip = "10.0.0.1"
ports = [8001, 8002]

[[servers]]
name = "beta"
ip = "10.0.0.2"
ports = [9001]

كيفية الاستخدام

1. 1

   الصق TOML الخاص بك

   أدخِل أو الصق TOML في حقل الإدخال أعلاه. يمكنك أيضًا النقر «تحميل مثال» لتجربة ملف Cargo.toml أو pyproject.toml حقيقي أو إعداد نشر.

2. 2

   شاهِد ناتج JSON المباشر

   يظهر JSON فورًا في لوحة الإخراج. اضبط خيار المسافة البادئة (مسافتان أو أربع) لمطابقة صيغتك المستهدفة. تُعالَج التواريخ والجداول ومصفوفات الجداول تلقائيًا.

3. 3

   انسخ أو نزّل

   انقر «نسخ» لنقل JSON إلى حافظتك، أو «تنزيل» لحفظه كملف .json جاهز لبرنامجك أو واجهتك البرمجية أو أدواتك.

مزالق TOML الشائعة

name = my-app

name = "my-app"

name = "a"
name = "b"

name = "a"
alt_name = "b"

released = 2026-7-2

released = 2026-07-02

ports = [8001, 8002

ports = [8001, 8002]

snowflake = 1420070400000000000

snowflake = "1420070400000000000"

[servers]
name = "a"
[servers]
name = "b"

[[servers]]
name = "a"
[[servers]]
name = "b"

حالات الاستخدام الشائعة

بيانات Cargo الوصفية في Rust

حوّل Cargo.toml إلى JSON لبناء لوحات متابعة الاعتماديات، أو تدقيق إصدارات وميزات الحزم، أو تغذية بيانات المانيفست إلى سكربتات وأنظمة تكامل مستمر تتوقع JSON بدلًا من TOML.

إعداد مشروع Python

حوّل pyproject.toml إلى JSON لفحص بيانات مشروع PEP 621 الوصفية، أو استخراج قوائم الاعتماديات، أو تشغيل أدوات تقرأ إعداد التغليف برمجيًا.

فحص إعداد النشر

حوّل netlify.toml أو foundry.toml أو إعدادات منصات أخرى إلى JSON لتدقيق عمليات إعادة التوجيه والترويسات وإعدادات البناء، أو لتوليد إعداد مكافئ لمنصة مختلفة.

ترحيل صيغة الإعداد

حوّل إعداد تطبيق بصيغة TOML إلى JSON عند الانتقال إلى نظام يفضّل JSON، أو كخطوة وسيطة قبل تحويل إضافي بأدوات JSON مثل jq.

إعدادات المواقع الساكنة

حوّل config.toml الخاص بـ Hugo إلى JSON لترحيل إعدادات الموقع، أو مقارنة الإعداد عبر البيئات، أو بناء واجهة إعدادات مدعومة بـ JSON.

إدخال للواجهات البرمجية والسكربتات

حوّل TOML المكتوب بيد الإنسان إلى JSON تستطيع واجهة REST أو دالة بلا خادم أو سكربت أتمتة استهلاكه مباشرةً، جاسرًا بين الإعداد المقروء والإدخال الآلي.

تفاصيل تقنية

تحليل TOML 1.0.0 عبر smol-toml

يُحلَّل TOML بمكتبة smol-toml، وهي محلّل عديم الاعتماديات ومتوافق تمامًا مع TOML 1.0.0. يتعامل بصحة مع الجداول المتداخلة والمفاتيح المنقّطة والجداول المضمّنة ومصفوفات الجداول والسلاسل متعددة الأسطر وأنواع التاريخ والوقت الأربعة، ويبلّغ عن أخطاء التحليل مع مواضع السطر والعمود.

تعامل بلا خسارة مع التاريخ والوقت وأمين مع الأعداد الصحيحة

تُسلسَل تواريخ وأوقات TOML إلى سلاسل JSON تحافظ على نوعها بدقة (التاريخ والوقت مع الإزاحة، والتاريخ والوقت المحلي، والتاريخ المحلي، والوقت المحلي). الأعداد الصحيحة خارج النطاق الآمن لـ JavaScript (2^53 - 1) تُرقّى إلى BigInt أثناء التحليل، ثم تُحوَّل إلى أقرب عدد JSON مع تحذير عن الدقة، فلا يفشل TOML الصالح في التحويل أبدًا.

بنسبة 100% داخل المتصفح — بلا رفع وبلا خادم

تجري كل المعالجة في محرّك JavaScript بمتصفحك. لا تُرسَل أي بيانات في أي لحظة. المدخلات الأكبر من 200 كيلوبايت تنتقل من الوضع المباشر إلى اليدوي (نقرة «تحويل» صريحة) لإبقاء الواجهة مستجيبة.

أفضل الممارسات

خزّن الأعداد الصحيحة الكبيرة جدًا كسلاسل نصية

إن كان TOML يحتوي أعدادًا صحيحة تتجاوز 2^53 - 1 (معرّفات Snowflake، طوابع زمنية بالنانوثانية، عدّادات كبيرة)، ضعها بين علامتي اقتباس كسلاسل نصية قبل التحويل. أعداد JSON في المتصفح لا يمكنها الاحتفاظ بها بدقة، وستحذّرك الأداة عندما تضطر إلى التقريب.

فضّل المسافتين للمسافة البادئة في ناتج JSON

المسافة البادئة بمسافتين هي العُرف الأوسع استخدامًا لـ JSON، وتُنتج ناتجًا نظيفًا ومقروءًا يتوافق مع معظم المنسّقات وأدوات المقارنة. احتفظ بأربع مسافات لحين طلب دليل الأسلوب لها.

تحقّق من ناتج JSON قبل استخدامه

بعد التحويل، إن كنت تنوي تحرير JSON يدويًا أو تغذيته إلى جهة صارمة، مرّره عبر منسّق JSON للتأكد من صحته وتنسيقه المتّسق.

احتفظ بتعليقات TOML على حدة

لا يملك JSON صياغة للتعليقات، لذا تُسقَط تعليقات TOML التي تبدأ بـ # عند التحويل. إن كانت التعليقات توثيقًا مهمًا، احتفظ بملف TOML الأصلي في نظام التحكم بالإصدارات إلى جانب JSON المولَّد.

استخدم مصفوفات الجداول للأقسام المكرّرة

عندما يكون لديك أقسام متشابهة متعددة (خوادم، عمليات إعادة توجيه، ملفات ثنائية)، اكتبها كمصفوفات جداول ([[section]]) بدلًا من تكرار [section]. تُحوَّل إلى مصفوفة JSON نظيفة من الكائنات بدلًا من التسبّب بخطأ جدول مكرّر.

الأسئلة الشائعة