Loading…

حول منسق TOML عبر الإنترنت

هل تعاني من فوضى في ملفات `pyproject.toml`، `Cargo.toml` أو تكوينات `poetry`؟ الصق محتوى TOML أو أسقط ملفاً وسيقوم منسقنا بتوحيد المسافات البيضاء، ترتيب المصفوفات والجداول المضمنة، والحفاظ على تباعد أقسامك بشكل متناسق. مثالي لـ Python، Rust، Go، مولدات المواقع الثابتة وأي مشروع يعتمد على TOML للتكوين.

الميزات الرئيسية لمنسق TOML

  • **أداة تجميل بنقرة واحدة** لملفات إعدادات TOML ومقتطفاتها
  • **حجم مسافة بادئة قابل للتعديل** من 1 إلى 8 مسافات عبر منزلق *حجم المسافة البادئة*
  • **تبديل نمط المسافة البادئة** – اختر بين المسافات أو علامات الجدولة للتنسيق البادئ
  • **تحكم في الالتفاف / طول السطر** للحفاظ على المصفوفات الطويلة والجداول المضمنة ضمن عرض عمود محدد
  • يدعم ملفات `.toml` مثل `pyproject.toml`، `Cargo.toml`، `Pipfile.toml`، `poetry.toml` والمزيد
  • محلل TOML قائم على Prettier يفهم التواريخ، المصفوفات، الجداول المتداخلة والجداول المضمنة
  • تنسيق مستقر وغير متغير – إعادة التشغيل على نفس الملف لن تسبب انحرافًا في التنسيق
  • نسخ الناتج المنسق بنقرة واحدة، جاهز لمحررك أو لعمليات الالتزام

🛠️ كيفية تنسيق ملفات TOML عبر الإنترنت for toml-formatter

1

1. الصق أو حمّل ملف TOML الخاص بك

📥 الصق TOML في المحرر أو اسحب وأفلت ملف `.toml` مثل `pyproject.toml` أو `Cargo.toml`. الأداة تحلل المحتوى كـ TOML، وليس كـ INI/JSON عام.

2

2. اختر إعدادات المسافة البادئة والالتفاف

⚙️ استخدم منزلق **حجم المسافة البادئة** لاختيار عدد المسافات لكل مستوى بادئ، وبدّل **نمط المسافة البادئة** إلى علامات الجدولة إذا كان مشروعك يفضلها. اضبط **الالتفاف / طول السطر** للتحكم في متى يجب أن تلتوي المصفوفات الطويلة أو الجداول المضمنة (أو اضبطه على `0` لتعطيل الالتفاف فعليًا).

3

3. انقر على "تنسيق"

🚀 اضغط على زر **تنسيق**. سيعيد المنسق تدفق المصفوفات، وينظف المسافات حول `=` والفوارز، ويوحد تباعد الجداول، ويفرض فواصل أسطر متسقة مع الحفاظ على بياناتك.

4

4. راجع، انسخ أو احفظ

🔍 قارن بين TOML الأصلي والمنسق. عندما تكون راضيًا، انسخ النتيجة مرة أخرى إلى محررك أو احفظها كملف `.toml` جديد في مشروعك.

المواصفات الفنية

ميزات TOML المدعومة

تم بناء المنسق لإعدادات المشاريع الواقعية ويفهم تركيبات TOML الحديثة.

الميزةالدعمأمثلة / ملاحظات
الجداول والجداول الفرعية✅ كامل[tool.poetry], [project], [database.replica]
المصفوفات✅ كاملالمصفوفات المضمنة ومصفوفات الجداول
الجداول المضمنة✅ كاملservers = { alpha = "10.0.0.1", beta = "10.0.0.2" }
التواريخ والأوقات✅ كامل2025-09-23T10:20:30Z وتنسيقات التواريخ المحلية
التعليقات✅ محفوظة# التعليقات تبقى قرب الإعدادات التي تصفها
السلاسل متعددة الأسطر✅ كاملسلاسل TOML ثلاثية الاقتباس للكتل النصية الطويلة

خيارات التنسيق (مرتبطة بأدوات التحكم)

هذه الخيارات معروضة مباشرة في واجهة المستخدم ومتصلة بإضافة Prettier TOML الأساسية:

الخيارأداة التحكم في الواجهةالنطاق / القيمالافتراضي
حجم المسافة البادئةشريط تمرير حجم المسافة البادئة1–8 مسافات2 مسافتين
نمط المسافة البادئةقائمة نمط المسافة البادئةمسافات / علامات جدولةمسافات
طول السطرالالتفاف / طول السطر0–120 عمود (0 = بدون التفاف فعليًا)80 عمود
نهاية السطرنهاية السطر (داخليًا)LF / CRLFLF في مخرجات المتصفح

الإدخال والحدود

الأداة مُحسنة لملفات TOML الصغيرة والمتوسطة الشائعة في مستودعات التطبيقات.

المعاملالقيمة / السلوكملاحظات
امتدادات الملفات.tomlأي ملف إعدادات يعتمد على TOML
أنواع MIMEapplication/toml, text/x-tomlيُستخدم للكشف عن الملفات في منطقة الإسقاط
الحد الأقصى لحجم الملف~5 ميجابايتالملفات الأكبر قد تكون أبطأ ومن الأفضل معالجتها في CI
الحد الأقصى للأحرف≈ 2,000,000حد صارم في وقت تشغيل المُنسِّق لتجنب تجميد المتصفح

التحقق من الصحة ومعالجة الأخطاء

إذا كان ملفك غير صالح لـ TOML (مثل فقدان `=` أو علامات اقتباس غير متطابقة)، فسيُرجع المُنسِّق عادةً خطأً مقروءًا بدلاً من الناتج المنسق. أصلح السطر المشار إليه وشغِّل المُنسِّق مرة أخرى.

بدائل سطر الأوامر لتنسيق TOML

هل أعجبك الناتج وتريد نفس النمط في CI أو خطافات pre-commit؟ إليك الخيارات المناسبة لسطر الأوامر:

متعدد المنصات (Node.js / Prettier)

تثبيت Prettier وإضافة TOML

npm install --save-dev prettier prettier-plugin-toml

يضيف Prettier ومحلل TOML إلى مشروعك.

تنسيق ملف TOML باستخدام Prettier

npx prettier --parser toml --write pyproject.toml

يعيد كتابة `pyproject.toml` في مكانه باستخدام قواعد TOML في Prettier.

Linux / macOS / Windows (Taplo CLI)

تنسيق TOML باستخدام Taplo

taplo fmt pyproject.toml

مُنسِّق شائع آخر لسطر الأوامر لملفات TOML.

التحقق من التنسيق في CI

taplo fmt --check .

فشل البناء إذا لم تكن ملفات TOML مُنسَّقة بشكل صحيح.

استخدم هذه الأداة عبر الإنترنت للتعديلات السريعة والتجارب، ثم فرض نفس النمط باستخدام Prettier أو Taplo في خطوط CI الخاصة بك.

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

تعبئة بايثون (`pyproject.toml`)

حافظ على نظافة بيانات تعريف مشروع بايثون وتكوين الأدوات وسهولة مراجعتها.

  • محاذاة أقسام `[project]` و `[tool.poetry]` و `[tool.black]`.
  • توحيد مصفوفات التبعيات ومحددات الإصدار.
  • جعل فروق التكوين أسهل للقراءة في طلبات السحب.
[project]
name = "my-app"
version = "0.1.0"

[tool.black]
line-length = 88
include = "\.(py|pyi)$"

مشاريع Rust (`Cargo.toml`)

ترتيب بيانات حزم Rust عبر مساحات العمل والخدمات المصغرة.

  • احتفظ بـ `[dependencies]` و `[dev-dependencies]` مرتبتين وبمسافات متسقة.
  • قم بتوحيد الجداول المضمنة المستخدمة لأعلام الميزات المعقدة.
  • وحد التنسيق عبر عدة صناديق في مساحة العمل.
[package]
name = "my-crate"
version = "0.1.0"
edition = "2021"

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

المواقع الثابتة والأدوات (Hugo، Zola، إلخ)

نظف TOML المستخدم لمولدات المواقع الثابتة والأدوات المتنوعة.

  • قم بتنسيق `config.toml` لـ Hugo أو مولدات المواقع الثابتة الأخرى.
  • احتفظ بكتل التكوين متعددة اللغات قابلة للقراءة.
  • وحد القوائم الطويلة مثل إدخالات القوائم والتصنيفات.

❓ Frequently Asked Questions

❓ما هو منسق TOML؟

يقوم منسق TOML تلقائيًا بإعادة هيكلة ملفات TOML الخاصة بك بحيث تتبع نمطًا متسقًا: فهو يصلح المسافات البادئة، ويحاذي المصفوفات والجداول المضمنة، ويوحد المسافات حول `=` والفوارز، ويحافظ على البيانات مع جعلها أسهل للقراءة والمراجعة.

📏كيف يجب أن أختار حجم ونمط المسافة البادئة؟

إذا لم يكن لدى فريقك تفضيل، فإن **مسافتين** تعد افتراضيًا جيدًا. طابق النمط المستخدم بالفعل في مستودعك: إذا كانت الملفات تستخدم المسافات في الغالب، استمر في استخدام المسافات؛ إذا كانت علامات الجدولة هي المعيار لفريقك، فقم بتبديل **نمط المسافة البادئة** إلى علامات الجدولة بحيث تتماشى التغييرات الجديدة مع الكود الحالي.

🧪هل يتحقق منسق TOML من صحة بناء الجملة؟

سيرفض المحلل الأساسي TOML غير الصالح (على سبيل المثال، `=` مفقود أو علامات اقتباس غير متطابقة). في هذه الحالة، تظهر الأداة رسالة خطأ بدلاً من الناتج المنسق، حتى تتمكن من إصلاح المشكلة والمحاولة مرة أخرى.

🔁هل يمكن لتشغيل المنسق أن يغير سلوك التكوين الخاص بي؟

تم تصميم المنسق ليكون **حافظًا على الدلالات**: فهو يغير فقط المسافات والتخطيط، وليس المفاتيح أو القيم أو هيكل الجدول. طالما أن الملف الأصلي هو TOML صالح، يجب أن يبقى معنى التكوين الخاص بك كما هو.

🔒هل من الآمن تنسيق ملفات التكوين الحساسة؟

كما هو الحال مع أي أداة عبر الإنترنت، تجنب لصق مواد حساسة للغاية مثل أسرار الإنتاج. للتكوينات شديدة السرية، استخدم منسق TOML محلي (مثل Prettier أو Taplo) داخل بيئة التطوير الخاصة بك.

Pro Tips

Best Practice

احتفظ بـ `pyproject.toml` أو `Cargo.toml` منسقين بشكل جيد في فرعك الرئيسي، ثم فرض نفس النمط في التكامل المستمر باستخدام Prettier أو Taplo.

Best Practice

قم بتنسيق TOML قبل إجراء تغييرات كبيرة في التبعيات أو التكوين حتى تركز فروق Git على **التغييرات الفعلية**، وليس ضوضاء المسافات.

Best Practice

عند إعادة هيكلة التكوينات، قم أولاً بتنسيق الملف، ثم أجرِ التغيير، ثم غير القيم. هذا يجعل مراجعة ما تغير فعليًا أسهل.

Best Practice

استخدم نفس **حجم المسافة البادئة** و**طول الالتفاف** في جميع ملفات TOML الخاصة بك لجعل التنقل بين المشاريع ومراجعات الكود تبدو متسقة.

Additional Resources

مواصفات TOML الإصدار 1.0.0
Documentation
إضافة Prettier لـ TOML
Documentation
Taplo – مجموعة أدوات TOML
Documentation

Other Tools