محول JSON إلى YAML

قم بلصق ملف JSON صالح — سواء كان كائنًا، أو مصفوفة، أو قيمة مفردة، أو استجابة واجهة برمجة تطبيقات (API)، أو بيان Kubernetes كاملًا — وسيقوم المحول بإنتاج ما يعادله بصيغة YAML في الوقت الفعلي.

يتم التحويل بالكامل داخل متصفحك باستخدام دالة JSON.parse الأصلية للتحقق من صحة المدخلات (وفقًا لمعيار ECMA-404 / RFC 8259)، ثم يمر عبر الشجرة المحللة لإنتاج صيغة YAML 1.2.2.

تعتبر المسافة البادئة بمقدار مسافتين هي الخيار الافتراضي — وهو المعيار الفعلي في Kubernetes وAnsible وGitHub Actions وDocker Compose. يمكنك التبديل إلى مسافة بادئة بمقدار 4 مسافات إذا كانت قاعدة الكود الخاصة بك تتطلب ذلك.

المخرجات جاهزة للصق مباشرة في ملف `.yaml` أو تمريرها إلى الأمر `kubectl apply -f -`. كما تعرض اللوحة اليمنى عدد البايتات والأسطر مباشرة لتتمكن من مراجعة الحجم بدقة قبل الاعتماد. وإذا كنت مهتمًا بأدواتنا الأخرى، فنحن نوفر أيضًا برنامج حساب الوقت لمساعدتك في حساب الساعات وحساب عدد الساعات المستغرقة في مشاريعك، بالإضافة إلى الحاسبة العلمية المتقدمة وميزة الـ عد تنازلي لإدارة المهام.

قم بالتحويل في ثلاث خطوات بسيطة:

• الخطوة 1: الصق نص JSON في المحرر. يتحقق المحول من الصلاحية أثناء الكتابة — ويعرض ملف JSON غير الصالح خطأ التحليل بدقة مع تحديد السطر والعمود.
• الخطوة 2: تظهر مخرجات YAML مباشرة في اللوحة اليمنى دون الحاجة للنقر على أي زر؛ حيث يتم تحديث المخرجات مع كل نقرة مفتاح.
• الخطوة 3: انقر على نسخ (إلى الحافظة) أو تنزيل (كملف `.yaml`).

بالنسبة لسير العمل البرمجي، يتم توفير نفس المنطق عبر نقطة النهاية `/api/calculate` — حيث يمكنك إرسال طلب POST يحتوي على JSON لتتلقى مخرجات YAML في جسم الاستجابة (وهي عملية سريعة للغاية تتيح لك حساب الوقت الفعلي للمعالجة بدقة تضاهي حساب الوقت بالدقائق عندما تريد أن احسب ساعات العمل البرمجية).

أمان التحويل العكسي: يمكنك تحويل YAML إلى JSON مجددًا باستخدام المحول الشقيق (YAML to JSON)؛ حيث يتم الحفاظ على نموذج البيانات تمامًا (علماً بأن التعليقات والمراسخ هي ميزات خاصة بـ YAML فقط ولا تستمر عند التحويل العكسي).

يمثل كل من JSON وYAML نفس نموذج البيانات — الخرائط (الكائنات)، والسلاسل (المصفوفات)، والقيم المفردة (النصوص/الأرقام/القيم المنطقية/القيم الفارغة) — ولكن بصيغة ظاهرية مختلفة تمامًا.

يعتمد JSON بشكل كبير على الأقواس وعلامات الاقتباس: يحصل كل مفتاح على `"`، وكل خريطة على `{}`، وكل مصفوفة على `[]`، ويكون كل فاصل صريحًا (`:` و `,`). بينما يعتمد YAML على المسافات البادئة: حيث يُفهم التداخل من خلال مسافة بادئة بمقدار مسافتين، وتستخدم السلاسل البادئة `- `، ولا تحتاج معظم النصوص إلى علامات اقتباس.

يتم تحليل JSON أسرع بمقدار 5 إلى 10 مرات عبر جميع بيئات تشغيل اللغات الرئيسية، وهو خالٍ تمامًا من الغموض، مما يجعله الخيار الأمثل لواجهات برمجة التطبيقات (APIs)، وصفوف الرسائل، وتدفقات السجلات، وتنسيقات التخزين.

يدعم YAML التعليقات (`#`)، والمراسخ والأسماء المستعارة لإعادة الاستخدام (`&name` / `*name`)، وتدفقات المستندات المتعددة (`---`)، وعلامات الأنواع الصريحة (`!!str`، `!!int`) — وهي نقاط قوة تجعله الخيار الأمثل لملفات التكوين الخاضعة للتحكم في الإصدارات، ومسارات العمل CI/CD، والبنية التحتية كأكواد (IaC)، وبيانات Kubernetes.

اختر JSON للآلات، وYAML للبشر، وقم بالتحويل بينهما عند الحاجة.

التداخل العميق هو المجال الذي تظهر فيه القيمة الحقيقية لمحولات JSON إلى YAML — فتتبع الأقواس والمسافات البادئة يدويًا عند الوصول إلى 5 مستويات أو أكثر يكون عرضة للأخطاء بشكل كبير.

يمر المحول عبر شجرة JSON المحللة بشكل تكراري:

• لكل خريطة (كائن)، يتم إصدار المفاتيح بترتيبها الأصلي باستخدام صيغة `key: value`؛ وتتم إزاحة القيم المتداخلة بمقدار مسافتين إضافيتين.
• لكل تسلسل (مصفوفة)، تستخدم العناصر البادئة `- `؛ وتبدأ الكائنات المتداخلة تحت علامة `-` في نفس السطر الذي توجد فيه الشرطة وترث مستوى المسافة البادئة التالي.

يتم عرض البنى المختلطة — مثل مصفوفات الكائنات، والكائنات التي تحتوي على مصفوفات من الكائنات بشكل تكراري — بشكل صحيح تمامًا. الحد الأقصى للعمق محدود فقط بمكدس الاستدعاءات (call stack) الخاص بمتصفحك (أكثر من 10,000 إطار في المتصفحات الحديثة، وهو ما يتجاوز بكثير أي ملف تكوين واقعي).

اختبر ذلك ببياناتك الخاصة: قم بتحليل مخرجات YAML وتحويلها مجددًا إلى JSON للتأكد من تطابق البنية الهيكلية مع المدخلات.

تعتبر بيانات Kubernetes (manifests) هي حالة الاستخدام الأكثر شيوعًا لهذا المحول. تصدر العديد من الأدوات (مثل kubectl وLens وk9s وHelm) ملفات JSON عبر أعلام `-o json`؛ بينما التنسيق المعتمد والموثوق الذي يتم حفظه في Git هو YAML.

الصق مخرجات JSON للأمر `kubectl get deployment -o json` وسيقوم المحول بإنتاج بيان نظيف جاهز للحفظ والاعتماد. تحافظ التدرجات الهيكلية لـ apiVersion وkind وmetadata وspec على الترتيب الدقيق للحقول.

بالنسبة لقيم مخططات Helm، الصق قيم JSON الخاصة بك وضع ملف YAML الناتج في `values.yaml` — وستلتقطه قوالب Helm دون أي تغيير. بالنسبة لتراكبات Kustomize، قم بتحويل كائن الرقعة (patch object) الخاص بك وأضفه إلى قائمة `patchesStrategicMerge`.

تحقق من صحة المخرجات باستخدام الأمر `kubectl apply --dry-run=client -f file.yaml` قبل الاعتماد — فهذا يكشف المشكلات على مستوى المخطط (schema) والتي قد يغفل عنها التحقق من صحة صيغة YAML وحدها.

ملفات Docker Compose هي ملفات YAML خالصة متوافقة مع مواصفات Compose (compose-spec.io). عندما يكون لديك مخرجات JSON برمجية — من منشئ تكوينات، أو تصدير سابق لـ Compose v2، أو سكريبت قوالب — قم بتحويلها هنا ولصقها في `docker-compose.yaml`. إن استخدام هذه الأداة يشبه استخدام برنامج حساب الوقت لتسهيل العمليات المعقدة وتوفير الجهد.\n\nتتحول جميع المفاتيح الرئيسية (`services`، `networks`، `volumes`، `configs`، `secrets`) والمواصفات المتداخلة الخاصة بها (image، ports، environment، depends_on، healthcheck) بشكل صحيح تماماً.\n\nانتبه للمنافذ (ports): السلاسل النصية المختصرة مثل `"8080:80"` يجب أن تظل بين علامتي اقتباس في YAML لمنع تحليلها كأرقام ستينية (وهي عملية تشبه حساب الوقت بالدقائق والثواني) — وتتعامل الحاسبة مع هذا تلقائياً.\n\nقم بالتحقق من صحة الملف باستخدام `docker compose config` قبل تشغيل `docker compose up`؛ حيث يقوم بتحليل ودمج ملفات متعددة، وطباعة التكوين النهائي تماماً كما سيقوم المحرك بتشغيله، ليبدأ عد تنازلي لتشغيل خدماتك بنجاح.

قواعد الإزاحة في YAML صارمة للغاية: مسافتان لكل مستوى (استخدام 4 مسافات صالح أيضاً ولكنه نادر)، واستخدام علامات التبويب (tabs) ممنوع تماماً، ويجب محاذاة المفاتيح الشقيقة بدقة تامة، تماماً كما تتطلب الحاسبة العلمية دقة متناهية في إدخال البيانات.\n\nتأتي السلاسل النصية متعددة الأسطر بنوعين: الكتل الحرفية (`|`) التي تحافظ على كل سطر جديد؛ والكتل المطوية (`>`) التي تدمج الأسطر بمسافات (على نمط الفقرة).\n\nتتيح لك المثبتات (`&name`) والأسماء المستعارة (`*name`) تعريف عقدة YAML مرة واحدة وإعادة استخدامها في مكان آخر — وهو أمر شائع في ملفات Compose للقوالب المشتركة، مما يسهل العمل تماماً مثل ميزة حساب الوقت التلقائي في المشاريع.\n\nتتجاوز علامات النوع الصريحة (`!!str`، `!!int`، `!!bool`، `!!null`) التحديد التلقائي للأنواع في YAML عندما تحتاج إلى سلسلة نصية تبدو كأرقام، أو العكس.\n\nيقوم المحول بوضع علامات اقتباس حول النصوص الغامضة تلقائياً: مثل `"yes"`، `"no"`، `"null"`، `"~"`، والقيم التي تبدو رقمية مثل `"01234"`، وأي سلسلة نصية تحتوي على رموز YAML الخاصة (`:`، `#`، `-`، `&`، `*`، `!`، `|`، `>`، `'`، `"`، `%`، `@`).

هناك ستة أخطاء شائعة تتسبب في 95% من مشاكل ملفات YAML.\n\n- (1) استخدام علامات التبويب (Tabs) في أي مكان — حتى لو كان رمز تبويب واحد فإنه يفسد عملية التحليل. اضبط محرر النصوص لديك لإدراج مسافات بدلاً منها.\n- (2) الإزاحة غير المتناسقة — إزاحة المفتاح الشقيق بمسافة واحدة زائدة أو ناقصة تؤدي إلى خطأ في التحليل، تماماً كما يحدث عند الخطأ في حساب عدد الساعات في جداول البيانات.\n- (3) غياب المسافة بعد `:` — الصيغة `key:value` غير صالحة؛ والصحيح هو `key: value`.\n- (4) النصوص غير المقتبسة التي تبدو كقيم منطقية (`yes`، `no`، `on`، `off`) — يتم تحويلها قسراً إلى true/false في إصدار YAML 1.1 (المحللات القديمة). بينما قصر إصدار YAML 1.2 القيم المنطقية على `true`/`false` فقط، ولكن استخدام الاقتباس الوقائي يظل خياراً ذكياً.\n- (5) السلاسل الرقمية بدون علامات اقتباس — الرقم `01234` يصبح العدد الصحيح 1234، مما يفقدك الصفر البادئ.\n- (6) غياب المسافة بعد `-` — الصيغة `-item` تعتبر سلسلة نصية تبدأ بشرطة؛ بينما `- item` هي عنصر في قائمة متسلسلة.\n\nلضمان الدقة، يمكنك التحقق من صحة الملفات باستخدام `yamllint` أو إضافة YAML في VS Code، أو أدوات التحقق الخاصة بالمنصات مثل (`kubectl --dry-run`، `docker compose config`، `ansible-playbook --syntax-check`) لتتأكد من سلامة الكود كما تتأكد من حساب ساعات العمل بدقة.

تستفيد سير عمل الواجهات البرمجية (APIs) من تحويل JSON إلى YAML في موضعين رئيسيين.\n\nأولاً، تُكتب مواصفات OpenAPI 3.x عادةً بلغة YAML (لأنها أسهل في القراءة لهياكل المسارات والمعاملات المتشعبة) ولكن يتم تصديرها كملفات JSON للأدوات البرمجية — يمكنك التحويل في كلا الاتجاهين حسب متطلبات عملك. يحافظ المحول على الحقول المطلوبة، وتعاريف المخططات (schemas)، ومؤشرات $ref، ونماذج الاستجابة.\n\nثانياً، عند توثيق واجهة برمجية، يمكنك لصق عينة من استجابة JSON وعرض نسخة YAML في مستنداتك — مما يسهل على القراء تصفح أجسام الاستجابة العميقة والمتداخلة. إن تنظيم هذه البيانات يشبه استخدام حاسبة الوقت لترتيب المهام اليومية بوضوح.\n\nبالنسبة للتكامل مع Swagger UI، يتم قبول كل من `swagger.yaml` و`swagger.json`؛ حيث تحتفظ العديد من الفرق بملفات YAML في نظام التحكم بالإصدارات وتنتج ملفات JSON أثناء عملية البناء. تظل سلامة التحويل العكسي مضمونة لمواصفات OpenAPI لأنها لا تستخدم التعليقات أو المثبتات في شكلها القياسي.

تستخدم جميع منصات CI/CD الحديثة تقريباً لغة YAML لتحديد مسارات العمل (Pipelines):\n\n- GitHub Actions (`.github/workflows/*.yaml`)\n- GitLab CI (`.gitlab-ci.yml`)\n- CircleCI (`.circleci/config.yml`)\n- Travis (`.travis.yml`)\n- Drone\n- Concourse\n- Argo Workflows\n- Tekton\n\nعندما يكون لديك تكوين JSON — سواء من منشئ تلقائي، أو تصدير سابق لنظام التحكم في الإصدارات، أو أداة بناء برمجية — ما عليك سوى لصقه هنا للحصول على ملف YAML جاهز. يساعدك هذا في تنظيم مهامك البرمجية تماماً كما يساعدك تطبيق مخصص لـ حساب الساعات في إدارة وقتك.\n\nتعتمد سيناريوهات Ansible (Playbooks) بشكل كبير على بنية قوائم المهام في YAML مع استخدام المثبتات للكتل المعاد استخدامها؛ حيث يقوم المحول بإخراج المتتاليات بشكل نظيف لتتمكن من لصقها تحت قسم `tasks:` مباشرة دون تعديلات إضافية.\n\nبالنسبة لـ GitHub Actions، فإن الجزء الأكثر تعقيداً هو شروط `if:` واستراتيجيات المصفوفات (matrix) — احتفظ بملف YAML المحول، ثم أضف تعليقات تشرح الغرض منها (وهي ميزة حصرية لـ YAML ستفقدها إذا عدت إلى صيغة JSON). يمكنك استخدام هذه الأداة لتنظيم بيئة عملك وتوفير الوقت، تماماً كما تبحث عن حلول لتسهيل العمل مثل خيار احسب ساعات العمل لتنظيم الجداول الزمنية.

هناك خمس حالات استثنائية قد تؤدي إلى فشل المحولات البسيطة.\n\n- (1) التعليقات: لا تدعم صيغة JSON التعليقات، بينما تدعمها YAML باستخدام رمز `#`. التحويل الدائري من JSON ← YAML ← JSON يتم دون فقدان للبيانات، ولكن التحويل من YAML ← JSON ← YAML يؤدي إلى حذف جميع التعليقات. لذا، احتفظ بملف YAML كمصدر أساسي للمعلومات إذا كانت التعليقات تهمك.\n- (2) تحويل القيم المنطقية: تعامل محللات YAML 1.1 القديمة الكلمات `yes`/`no`/`on`/`off` كقيم منطقية. بينما تقتصر المحللات الحديثة (1.2.2) على معاملة `true`/`false` فقط كقيم منطقية، ولكن استخدام علامات الاقتباس يحميك من المفاجآت غير المتوقعة.\n- (3) قيم Null: تقابل قيمة `null` في JSON قيم `null` أو `~` أو القيمة الفارغة في YAML. يقوم المحول بإنتاج `null` بوضوح؛ وتفضل بعض الأدوات تركها فارغة (`key:`) ولكن هذا قد يسبب التباساً مع السلاسل النصية الفارغة.\n- (4) السلاسل الرقمية: تفقد السلسلة النصية `"01234"` (مثل الرمز البريدي) الصفر البادئ إذا لم توضع بين علامتي اقتباس في YAML — ويقوم المحول باقتباسها تلقائياً لضمان الدقة، تماماً كما تتطلب عمليات حساب عدد الساعات والدقائق دقة متناهية في الإدخال.\n- (5) الأعداد العشرية ذات الأصفار اللاحقة: القيمة `1.50` تتحول ذهاباً وإياباً إلى `1.5` لأن كلاً من JSON و YAML يستخدمان التمثيل الرقمي القياسي. إذا كانت الأصفار اللاحقة مهمة بالنسبة لك (مثل العملات أو إصدارات البرامج)، فقم بتمثيلها كسلاسل نصية.

مخطط مطابقة الأنواع بلمحة سريعة:\n\n- كائن JSON ← خريطة YAML (نمط الكتلة)\n- مصفوفة JSON ← متتالية YAML (عناصر تبدأ بـ `-`)\n- سلسلة نصية JSON ← سلسلة نصية YAML (مقتبسة تلقائياً عند الغموض)\n- رقم JSON ← قيمة قياسية في YAML بنفس القيمة الرقمية\n- قيمة منطقية true/false في JSON ← قيمة منطقية true/false في YAML\n- قيمة null في JSON ← قيمة null في YAML\n\nخيارات التنسيق:\n\n- يفضل نمط الكتلة (متعدد الأسطر، المزاح) لسهولة القراءة على النمط الانسيابي المدمج الشبيه بـ JSON (`{key: value, ...}`)\n- استخدم دائماً إزاحة بمسافتين\n- يتم إنتاج المفاتيح بنفس ترتيبها في المصدر (يطابق سلوك JSON)\n\nنصائح التحويل العكسي:\n\n- (1) التحويل من JSON ← YAML ← JSON يتم دون أي فقدان للبيانات.\n- (2) التحويل من YAML ← JSON يؤدي إلى إسقاط التعليقات، والمثبتات (يتم توسيعها)، والعلامات الصريحة، وتدفقات المستندات المتعددة.\n- (3) ضع دائماً علامات اقتباس حول السلاسل النصية التي تبدو كقيم منطقية، أو null، أو أرقام.\n- (4) اختبر مخرجاتك باستخدام الأداة الفعلية التي تستخدمها (مثل kubectl، docker compose، ansible-playbook) — فهذه الأدوات تحتوي على قواعد تحقق أكثر صرامة من محللات YAML العامة.\n- (5) احتفظ بكلا الإصدارين في نظام التحكم بالإصدارات إذا كان فريقك يستخدم التنسيقين؛ واعتبر أحدهما المصدر الأساسي المعتمد (عادةً YAML للتكوينات، وJSON للواجهات البرمجية) وأعد إنشاء الآخر أثناء عملية البناء.