yamllint - عبر الإنترنت في السحابة

برنامج:

اسم

يملينت -

لينتر لملفات YAML.

yamllint لا يتحقق فقط من صحة بناء الجملة ، بل يتحقق أيضًا من الغرابة مثل تكرار المفتاح
والمشكلات التجميلية مثل طول الأسطر ، والمسافات اللاحقة ، والمسافة البادئة ، وما إلى ذلك.

لقطة شاشة

[صورة: لقطة شاشة yamllint] [صورة]

NOTE:
تنسيق الإخراج الافتراضي مستوحى من eslint، أداة فحص رائعة لجافا سكريبت.

الجدول OF المحتويات

البداية السريعة
تثبيت يملينت
على Fedora / CentOS:

sudo dnf تثبيت yamllint

على Debian 9+ / Ubuntu 16.04+:

sudo apt-get install yamllint

في إصدارات Debian / Ubuntu الأقدم:

sudo add-apt-repository -y ppa: adrienverge / ppa && sudo apt-get update
sudo apt-get install yamllint

بدلاً من ذلك ، باستخدام النقطة ، فإن مدير حزمة بايثون:

sudo pip تثبيت yamllint

إذا كنت تفضل التثبيت من المصدر ، فيمكنك التشغيل من دليل المصدر:

إعداد python.py sdist
تثبيت sudo pip dist / yamllint - *. tar.gz

الركض يملينت
الاستخدام الأساسي:

yamllint file.yml Other-file.yaml

يمكنك أيضًا فحص جميع ملفات YAML في دليل كامل:

يملينت.

سيبدو الإخراج بالشكل (الألوان غير معروضة هنا):

file.yml
مسافات لاحقة الخطأ 1: 4 (مسافات لاحقة)
مسافة بادئة خاطئة 4: 4: توقع 4 ولكن تم العثور على 3 (مسافة بادئة)
تكرار الخطأ 5: 4 للمفتاح "id-00042" في التعيين (تكرارات المفتاح)
6: 6 تعليق تحذير لم يتم وضع مسافة بادئة به مثل المحتوى (مسافة بادئة للتعليقات)
خطأ 12: 6 مسافات كثيرة جدًا بعد الواصلة (واصلات)
15:12 خطأ كثير من المسافات قبل الفاصلة (فاصلات)

ملف آخر
1: 1 تحذير مفقود بدء المستند "---" (بدء المستند)
6:81 سطر خطأ طويل جدًا (87> 80 حرفًا) (طول السطر)
خطأ 10: 1 عدد كبير جدًا من الأسطر الفارغة (4> 2) (أسطر فارغة)
خطأ 11: 4 مسافات كثيرة جدًا داخل الأقواس (الأقواس)

إضافة -f قابل للتحليل الوسائط إذا كنت بحاجة إلى تنسيق إخراج قابل للتحليل بواسطة آلة (لـ
على سبيل المثال بناء الجملة تسليط الضوء in نص المحررين). سيبدو الإخراج بعد ذلك كما يلي:

file.yml: 6: 2: [تحذير] فقد مساحة البداية في التعليق (التعليقات)
file.yml: 57: 1: [خطأ] مسافات زائدة (مسافات زائدة)
file.yml: 60: 3: [خطأ] مسافة بادئة خاطئة: توقع 4 ولكن تم العثور على 2 (مسافة بادئة)

إذا كان لديك ملف تكوين فحص مخصص (انظر كيف إلى تكوين يملينت) ، يمكن أن يكون
إلى yamllint باستخدام -c الخيار:

يملينت -ج ~ / myconfig file.yaml

NOTE:
إذا كان لديك .yamllint ملف في دليل العمل الخاص بك ، سيتم تحميله تلقائيًا
كتكوين بواسطة yamllint.

الاعداد
يستخدم yamllint مجموعة من القواعد للتحقق من ملفات المصادر بحثًا عن مشاكل. كل قاعدة مستقلة
من الآخرين ، ويمكن تمكينه أو تعطيله أو تعديله. كل هذه الإعدادات يمكن أن تكون
جمعت في ملف التكوين.

لاستخدام ملف تكوين مخصص ، قم بتسميته .yamllint في دليل العمل الخاص بك ، أو
استخدم ال -c الخيار:

يملينت -ج ~ / myconfig file.yaml

الترتيب ترتيب
ما لم يُقال خلاف ذلك ، يستخدم yamllint ملف الافتراضي التكوين:

---

قواعد:
الأقواس:
الحد الأدنى للمسافات الداخلية: 0
الحد الأقصى للمسافات الداخلية: 0
اقواس:
الحد الأدنى للمسافات الداخلية: 0
الحد الأقصى للمسافات الداخلية: 0
النقطتين:
الحد الأقصى للمسافات قبل: 0
الحد الأقصى للمسافات بعد: 1
الفواصل:
الحد الأقصى للمسافات قبل: 0
الحد الأدنى للمسافات بعد: 1
الحد الأقصى للمسافات بعد: 1
تعليقات:
المستوى: تحذير
تتطلب مساحة البدء: نعم
الحد الأدنى للمسافات من المحتوى: 2
المسافة البادئة للتعليقات:
المستوى: تحذير
نهاية المستند: تعطيل
بداية المستند:
المستوى: تحذير
الحاضر: نعم
الأسطر الفارغة:
الحد الأقصى: 2
الحد الأقصى لبدء: 0
ماكس النهاية: 0
الواصلات:
الحد الأقصى للمسافات بعد: 1
المسافة الفارغة:
المساحات: متسقة
متواليات المسافة البادئة: نعم
تحقق من سلاسل متعددة الخطوط: لا
مكررة مفتاح: تمكين
طول الخط:
الحد الأقصى: 80
السماح بالكلمات غير القابلة للكسر: نعم
سطر جديد في نهاية الملف: تمكين
خطوط جديدة:
النوع: يونكس
مسافات زائدة: تمكين

يمكن العثور على تفاصيل القواعد على القادم القواعد صفحة.

هناك تكوين آخر محدد مسبقًا باسم خففت. كما يوحي اسمها ، فهي أكثر
متسامح.

يمكن اختياره باستخدام:

yamllint -d ملف مسترخى

تمتد القادم الافتراضي ترتيب
عند كتابة ملف تكوين مخصص ، لا تحتاج إلى إعادة تعريف كل قاعدة. فقط
تمديد الافتراضي التكوين (أو أي ملف تكوين موجود بالفعل).

على سبيل المثال ، إذا كنت تريد فقط تعطيل ملف المسافة البادئة للتعليقات القاعدة ، يمكن لملفك
يبدو مثل هذا:

# هذا هو أول ملف تكوين خاص بي لـ yamllint!
# يقوم بتوسيع نطاق conf الافتراضي عن طريق ضبط بعض الخيارات.

يمتد: الافتراضي

قواعد:
التعليقات البادئة: تعطيل # لا تزعجني بهذه القاعدة

وبالمثل ، إذا كنت تريد تعيين ملف طول الخط حكم كتحذير ويكون أقل صرامة على
المسافة البادئة لتسلسل الكتلة:

يمتد: الافتراضي

قواعد:
# 80 حرفًا يجب أن تكون كافية ، لكن لا تفشل إذا كان السطر أطول
طول الخط:
الحد الأقصى: 80
المستوى: تحذير

# قبول كلا المفتاحين:
# - غرض
#
# والمفتاح:
# - غرض
المسافة الفارغة:
متواليات المسافة البادئة: أيا كان

Custom ترتيب بدون a التكوين ملف
من الممكن - على الرغم من عدم التوصية بذلك - تمرير خيارات التكوين المخصصة إلى
yamllint مع -d (باختصار ل - تكوين البيانات) اختيار.

يمكن أن يكون محتواها إما اسم conf محدد مسبقًا (مثال: الافتراضي or خففت) أو
كائن YAML متسلسل يصف التكوين.

على سبيل المثال:

yamllint -d "{extends: relaxed، rules: {line-length: {max: 120}}}" file.yaml

أخطاء و تحذيرات
يمكن إثارة المشكلات التي تم اكتشافها بواسطة yamllint إما كأخطاء أو كتحذيرات.

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

قوانيـن
عند فحص مستند باستخدام yamllint ، فإن سلسلة من القواعد (مثل طول الخط,
مسافات زائدة، وما إلى ذلك) مقابل.

A ترتيب ملف يمكن استخدامها لتمكين أو تعطيل هذه القواعد ، لتعيين مستواها
(خطأ or تحذير) ، ولكن أيضًا لتعديل خياراتهم.

تصف هذه الصفحة القواعد وخياراتها.

قائمة of القواعد
· الأقواس

· بين قوسين

· كولون

· الفواصل

· تعليقات

· المسافة البادئة للتعليقات

· نهاية الوثيقة

· بدء المستند

· خطوط فارغة

· الواصلات

· المسافة الفارغة

· مكررة مفتاح

· طول الخط

· سطر جديد في نهاية الملف

· خطوط جديدة

· مسافات زائدة

الأقواس
استخدم هذه القاعدة للتحكم في عدد المسافات داخل الأقواس ({ و }). Options.INDENT 0.0

· الحد الأدنى للمسافات بالداخل يحدد أقل عدد من المسافات المطلوبة داخل الأقواس.

· ماكس-فراغات-بالداخل يحدد العدد الأقصى للمسافات المسموح بها داخل الأقواس.
1. مع الأقواس: {min-space-inside: 0, الحد الأقصى للمسافات الداخلية: 0}

مقتطف الشفرة التالي مرر:

الكائن: {key1: 4، key2: 8}

مقتطف الشفرة التالي يفشلون:

الكائن: {key1: 4، key2: 8}

2. مع الأقواس: {min-space-inside: 1, الحد الأقصى للمسافات الداخلية: 3}

مقتطف الشفرة التالي مرر:

الكائن: {key1: 4، key2: 8}

مقتطف الشفرة التالي مرر:

الكائن: {key1: 4، key2: 8}

مقتطف الشفرة التالي يفشلون:

الكائن: {key1: 4، key2: 8}

مقتطف الشفرة التالي يفشلون:

الكائن: {key1: 4، key2: 8}

بين قوسين
استخدم هذه القاعدة للتحكم في عدد المسافات داخل الأقواس ([ و ]). الخيارات
0.0

· الحد الأدنى للمسافات بالداخل يحدد الحد الأدنى لعدد المسافات المطلوبة داخل الأقواس.

· ماكس-فراغات-بالداخل يحدد العدد الأقصى للمسافات المسموح بها داخل الأقواس.
1. مع اقواس: {min-space-inside: 0, الحد الأقصى للمسافات الداخلية: 0}

مقتطف الشفرة التالي مرر:

الكائن: [1، 2، abc]

مقتطف الشفرة التالي يفشلون:

الكائن: [1، 2، abc]

2. مع اقواس: {min-space-inside: 1, الحد الأقصى للمسافات الداخلية: 3}

مقتطف الشفرة التالي مرر:

الكائن: [1، 2، abc]

مقتطف الشفرة التالي مرر:

الكائن: [1، 2، abc]

مقتطف الشفرة التالي يفشلون:

الكائن: [1، 2، abc]

مقتطف الشفرة التالي يفشلون:

الكائن: [1، 2، abc]

كولون
استخدم هذه القاعدة للتحكم في عدد المسافات قبل وبعد النقطتين (:). الخيارات
0.0

· الحد الأقصى للمسافات قبل يحدد العدد الأقصى للمسافات المسموح بها قبل النقطتين (استخدم -1 إلى
إبطال).

· ماكس مسافات بعد يحدد العدد الأقصى للمسافات المسموح بها بعد النقطتين (استخدم -1 إلى
إبطال).
1. مع النقطتين: {الحد الأقصى للمسافات قبل: 0, الحد الأقصى للمسافات بعد: 1}

مقتطف الشفرة التالي مرر:

موضوع:
- 1
- ب
المفتاح: القيمة

2. مع النقطتين: {الحد الأقصى للمسافات قبل: 1}

مقتطف الشفرة التالي مرر:

هدف :
- 1
- ب

مقتطف الشفرة التالي يفشلون:

هدف :
- 1
- ب

3. مع النقطتين: {مسافات قصوى-بعد: 2}

مقتطف الشفرة التالي مرر:

الأول: 1
الثاني: 2
ثالثا: 3

مقتطف الشفرة التالي يفشلون:

الأول: 1
الثانية: 2
ثالثا: 3

الفواصل
استخدم هذه القاعدة للتحكم في عدد المسافات قبل وبعد الفواصل (,). الخيارات
0.0

· الحد الأقصى للمسافات قبل يحدد العدد الأقصى للمسافات المسموح بها قبل الفواصل (استخدم -1 إلى
إبطال).

· مسافات دقيقة بعد يحدد الحد الأدنى من المسافات المطلوبة بعد الفواصل.

· ماكس مسافات بعد يحدد العدد الأقصى للمسافات المسموح بها بعد الفواصل (استخدم -1 إلى
إبطال).
1. مع الفواصل: {الحد الأقصى للمسافات قبل: 0}

مقتطف الشفرة التالي مرر:

فار غريب:
[10 ، 20 ، 30 ، {س: 1 ، ص: 2}]

مقتطف الشفرة التالي يفشلون:

فار غريب:
[10 ، 20 ، 30 ، {س: 1 ، ص: 2}]

2. مع الفواصل: {الحد الأقصى للمسافات قبل: 2}

مقتطف الشفرة التالي مرر:

فار غريب:
[10 ، 20 ، 30 ، {س: 1 ، ص: 2}]

3. مع الفواصل: {الحد الأقصى للمسافات قبل: -1}

مقتطف الشفرة التالي مرر:

فار غريب:
[10 ،
20، 30
، {س: 1 ، ص: 2}]

4. مع الفواصل: {الحد الأدنى للمسافات-بعد: 1, الحد الأقصى للمسافات بعد: 1}

مقتطف الشفرة التالي مرر:

فار غريب:
[10 ، 20,30 ، 1 ، {س: 2 ، ص: XNUMX}]

مقتطف الشفرة التالي يفشلون:

فار غريب:
[10 ، 20,30 ، 1 ، {س: 2 ، ص: XNUMX}]

5. مع الفواصل: {الحد الأدنى للمسافات-بعد: 1, الحد الأقصى للمسافات بعد: 3}

مقتطف الشفرة التالي مرر:

فار غريب:
[10 ، 20 ، 30 ، {س: 1 ، ص: 2}]

6. مع الفواصل: {الحد الأدنى للمسافات-بعد: 0, الحد الأقصى للمسافات بعد: 1}

مقتطف الشفرة التالي مرر:

فار غريب:
[10 ، 20,30 ، 1 ، {س: 2 ، ص: XNUMX}]

تعليقات
استخدم هذه القاعدة للتحكم في موضع التعليقات وتنسيقها. Options.INDENT 0.0

· يستخدم تتطلب مساحة البدء لطلب حرف مسافة بعد #. ضبط ل نعم إلى
يُمكَِن، لا تعطيل.

· مسافات صغيرة من المحتوى تُستخدم لفصل التعليقات المضمنة بشكل مرئي عن المحتوى. هو - هي
يحدد الحد الأدنى المطلوب من المسافات بين تعليق وما يسبقه
المحتوى.
1. مع تعليقات: {تتطلب مساحة البدء: نعم}

مقتطف الشفرة التالي مرر:

# هذه الجملة
# هو تعليق كتلة

مقتطف الشفرة التالي يفشلون:

#هذه الجملة
# هو تعليق كتلة

2. مع تعليقات: {min-space-from-content: 2}

مقتطف الشفرة التالي مرر:

x = 2 ^ 127 - 1 # عدد ميرسين الأولي

مقتطف الشفرة التالي يفشلون:

x = 2 ^ 127 - 1 # عدد ميرسين الأولي

المسافة البادئة للتعليقات
استخدم هذه القاعدة لفرض وضع مسافة بادئة للتعليقات مثل المحتوى. أمثلة INDENT 0.0

1. مع المسافة البادئة للتعليقات: {}

مقتطف الشفرة التالي مرر:

# فيبوناتشي
[0 ، 1 ، 1 ، 2 ، 3 ، 5]

مقتطف الشفرة التالي يفشلون:

# فيبوناتشي
[0 ، 1 ، 1 ، 2 ، 3 ، 5]

مقتطف الشفرة التالي مرر:

قائمة:
- 2
- 3
# - 4
- 5

مقتطف الشفرة التالي يفشلون:

قائمة:
- 2
- 3
# - 4
- 5

مقتطف الشفرة التالي مرر:

# هذا هو الكائن الأول
الهدف1:
- البند أ
# - البند ب
# هذا هو الكائن الثاني
كائن 2: []

مقتطف الشفرة التالي مرر:

# هذه الجملة
# هو تعليق كتلة

مقتطف الشفرة التالي يفشلون:

# هذه الجملة
# هو تعليق كتلة

نهاية الوثيقة
استخدم هذه القاعدة لطلب أو حظر استخدام علامة نهاية المستند ( ). الخيارات
0.0

· تعيين يقدم إلى نعم عندما تكون علامة نهاية المستند مطلوبة ، أو إلى لا عندما يكون
ممنوع.
1. مع نهاية المستند: {حاضر: نعم}

مقتطف الشفرة التالي مرر:

---
هذه:
هو: [a ، المستند]

---
- هذه
- هو: واحد آخر


مقتطف الشفرة التالي يفشلون:

---
هذه:
هو: [a ، المستند]
---
- هذه
- هو: واحد آخر


2. مع نهاية المستند: {حاضر: لا}

مقتطف الشفرة التالي مرر:

---
هذه:
هو: [a ، المستند]
---
- هذه
- هو: واحد آخر

مقتطف الشفرة التالي يفشلون:

---
هذه:
هو: [a ، المستند]

---
- هذه
- هو: واحد آخر

بدء المستند
استخدم هذه القاعدة لطلب أو حظر استخدام علامة بدء المستند (---). الخيارات
0.0

· تعيين يقدم إلى نعم عندما تكون علامة بدء المستند مطلوبة ، أو إلى لا عندما يكون
ممنوع.
1. مع بداية المستند: {حاضر: نعم}

مقتطف الشفرة التالي مرر:

---
هذه:
هو: [a ، المستند]
---
- هذه
- هو: واحد آخر

مقتطف الشفرة التالي يفشلون:

هذه:
هو: [a ، المستند]
---
- هذه
- هو: واحد آخر

2. مع بداية المستند: {حاضر: لا}

مقتطف الشفرة التالي مرر:

هذه:
هو: [a ، المستند]


مقتطف الشفرة التالي يفشلون:

---
هذه:
هو: [a ، المستند]


خطوط فارغة
استخدم هذه القاعدة لتعيين الحد الأقصى لعدد الأسطر الفارغة المتتالية المسموح بها. الخيارات
0.0

· ماكس يحدد الحد الأقصى لعدد الأسطر الفارغة المسموح بها في المستند.

· ماكس البداية يحدد الحد الأقصى لعدد الأسطر الفارغة المسموح بها في بداية
ملف. هذا الخيار له الأسبقية ماكس.

· ماكس نهاية يحدد الحد الأقصى لعدد الأسطر الفارغة المسموح بها في نهاية الملف. هذا
الخيار له الأسبقية ماكس.
1. مع الأسطر الفارغة: {الأعلى: 1}

مقتطف الشفرة التالي مرر:

- فو:
- 1
- 2

- شريط: [3 ، 4]

مقتطف الشفرة التالي يفشلون:

- فو:
- 1
- 2

- شريط: [3 ، 4]

الواصلات
استخدم هذه القاعدة للتحكم في عدد المسافات بعد الواصلات (-). Options.INDENT 0.0

· ماكس مسافات بعد يحدد العدد الأقصى للمسافات المسموح بها بعد الواصلات.
1. مع الواصلات: {مسافات قصوى-بعد: 1}

مقتطف الشفرة التالي مرر:

- القائمة الأولى:
- 1
- ب
- - واحد
- 2
- 3

مقتطف الشفرة التالي يفشلون:

- القائمة الأولى:
- 1
- ب

مقتطف الشفرة التالي يفشلون:

- - واحد
- 2
- 3

2. مع الواصلات: {مسافات قصوى-بعد: 3}

مقتطف الشفرة التالي مرر:

- مفتاح
- مفتاح 2
- مفتاح 42

مقتطف الشفرة التالي يفشلون:

- مفتاح
- مفتاح 2
- مفتاح 42

المسافة الفارغة
استخدم هذه القاعدة للتحكم في المسافة البادئة. Options.INDENT 0.0

· المساحات يحدد عرض المسافة البادئة في المسافات. اضبط إما على عدد صحيح (على سبيل المثال 2 or 4,
تمثل عدد المسافات في مستوى المسافة البادئة) أو إلى ثابتة للسماح بأي
number ، طالما أنه لا يزال هو نفسه داخل الملف.

· متواليات المسافة البادئة يحدد ما إذا كان يجب وضع مسافة بادئة لتسلسلات الكتل أم لا (عندما تكون في ملف
رسم الخرائط ، هذه المسافة البادئة ليست إلزامية - بعض الناس يرون أن - كجزء من
المسافة الفارغة). القيم الممكنة: نعم , لا, أيا كان و ثابتة. ثابتة يتطلب
إما أن يتم وضع مسافة بادئة لجميع متواليات الكتل ، أو لا يتم وضع مسافات على الإطلاق. أيا كان يعني إما
لا بأس من وضع مسافة بادئة أو مسافة بادئة لتسلسلات الكتل الفردية.

· تحقق من سلاسل متعددة الخطوط يحدد ما إذا كان سيتم وضع مسافة بادئة في سلاسل متعددة الأسطر. تعيين
إلى نعم لتمكين ، لا تعطيل.
1. مع المسافة الفارغة: {مسافات: 1}

مقتطف الشفرة التالي مرر:

التاريخ:
- الاسم: يونكس
التاريخ: 1969
- الاسم: لينكس
التاريخ: 1991
عش:
يعيد تنفيذ:
- كومة قش:
إبرة

2. مع المسافة الفارغة: {مسافات: 4}

مقتطف الشفرة التالي مرر:

التاريخ:
- الاسم: يونكس
التاريخ: 1969
- الاسم: لينكس
التاريخ: 1991
عش:
يعيد تنفيذ:
- كومة قش:
إبرة

مقتطف الشفرة التالي يفشلون:

التاريخ:
- الاسم: يونكس
التاريخ: 1969
- الاسم: لينكس
التاريخ: 1991
عش:
يعيد تنفيذ:
- كومة قش:
إبرة

3. مع المسافة الفارغة: {مسافات: ثابت}

مقتطف الشفرة التالي مرر:

التاريخ:
- الاسم: يونكس
التاريخ: 1969
- الاسم: لينكس
التاريخ: 1991
عش:
يعيد تنفيذ:
- كومة قش:
إبرة

مقتطف الشفرة التالي يفشلون:

بعض:
الروسية:
دمى

4. مع المسافة الفارغة: {مسافات: 2, متواليات المسافة البادئة: لا}

مقتطف الشفرة التالي مرر:

قائمة:
- طيران
- معكرونة
- وحش

مقتطف الشفرة التالي يفشلون:

قائمة:
- طيران
- معكرونة
- وحش

5. مع المسافة الفارغة: {مسافات: 2, متواليات المسافة البادئة: أيا كان}

مقتطف الشفرة التالي مرر:

قائمة:
- الطيران:
- معكرونة
- وحش
- لا تطير:
- معكرونة
- صلصة

6. مع المسافة الفارغة: {مسافات: 2, متواليات المسافة البادئة: ثابت}

مقتطف الشفرة التالي مرر:

- الطيران:
- معكرونة
- وحش
- لا تطير:
- معكرونة
- صلصة

مقتطف الشفرة التالي يفشلون:

- الطيران:
- معكرونة
- وحش
- لا تطير:
- معكرونة
- صلصة

7. مع المسافة الفارغة: {مسافات: 4, تحقق من سلاسل متعددة الخطوط: نعم}

مقتطف الشفرة التالي مرر:

بليز باسكال:
Je vous écris une longue letter parce que
je n'ai pas le temps d'en écrire une courte.

مقتطف الشفرة التالي مرر:

بليز باسكال: Je vous écris une longue lettre parce que
je n'ai pas le temps d'en écrire une courte.

مقتطف الشفرة التالي يفشلون:

بليز باسكال: Je vous écris une longue lettre parce que
je n'ai pas le temps d'en écrire une courte.

مقتطف الشفرة التالي يفشلون:

كود C:
باطل رئيسي () {
printf ("foo") ؛
}

مقتطف الشفرة التالي مرر:

كود C:
باطل رئيسي () {
printf ("شريط") ؛
}

مكررة مفتاح
استخدم هذه القاعدة لمنع الإدخالات المتعددة بنفس المفتاح في التعيينات. أمثلة
0.0

1. مع مكررة مفتاح: {}

مقتطف الشفرة التالي مرر:

- مفتاح 1: v
المفتاح 2: val
المفتاح 3: القيمة
- {أ: 1 ، ب: 2 ، ج: 3}

مقتطف الشفرة التالي يفشلون:

- مفتاح 1: v
المفتاح 2: val
المفتاح 1: القيمة

مقتطف الشفرة التالي يفشلون:

- {أ: 1 ، ب: 2 ، ب: 3}

مقتطف الشفرة التالي يفشلون:

مفتاح مكرر: 1
"مفتاح مكرر": 2

ازدواجية أخرى: 1
؟ > -
أخرى
تكرار
: 2

طول الخط
استخدم هذه القاعدة لتعيين حد لطول الأسطر. Options.INDENT 0.0

· ماكس يحدد الحد الأقصى (الشامل) لطول الخطوط.

· السماح للكلمات غير القابلة للكسر يستخدم للسماح للكلمات غير القابلة للكسر (بدون فراغات بالداخل)
لتجاوز الحد. هذا مفيد لعناوين URL الطويلة ، على سبيل المثال. يستخدم نعم لكى يسمح، لا
لمنع.
1. مع طول الخط: {الأعلى: 70}

مقتطف الشفرة التالي مرر:

جملة طويلة:
Lorem ipsum dolor sit amet، consectetur adipiscing elit، sed do
eiusmod tempor incidunt ut labore et dolore magna aliqua.

مقتطف الشفرة التالي يفشلون:

جملة طويلة:
Lorem ipsum dolor sit amet، consectetur adipiscing elit، sed do eiusmod
الصدمة incidunt ut labore et dolore magna aliqua.

2. مع طول الخط: {الأعلى: 60 السماح بالكلمات غير القابلة للكسر: نعم}

مقتطف الشفرة التالي مرر:

هذه:
هو:
- أ:
http://localhost/very/very/very/very/very/very/very/very/long/url

# هذا التعليق طويل جدا ،
# لكن يصعب تقسيمه:
# http://localhost/another/very/very/very/very/very/very/very/very/long/url

مقتطف الشفرة التالي يفشلون:

- هذا الخط طويل جدًا ولكن يمكن تقسيمه بسهولة ...

3. مع طول الخط: {الأعلى: 60 السماح بالكلمات غير القابلة للكسر: لا}

مقتطف الشفرة التالي يفشلون:

هذه:
هو:
- أ:
http://localhost/very/very/very/very/very/very/very/very/long/url

سطر جديد في نهاية الملف
استخدم هذه القاعدة لطلب حرف سطر جديد (\n) في نهاية الملفات.

معيار POSIX يتطلب القادم آخر خط إلى النهاية مع a جديد خط حرف. جميع UNIX
تتوقع الأدوات سطرًا جديدًا في نهاية الملفات. يستخدم معظم محرري النصوص هذا الاصطلاح أيضًا.

خطوط جديدة
استخدم هذه القاعدة لفرض نوع أحرف السطر الجديد. Options.INDENT 0.0

· تعيين نوع إلى يونيكس لاستخدام أحرف سطر جديدة من نوع UNIX (\n)، أو دوس لاستخدام DOS- من النوع الجديد
أحرف الخط (\ ص \ ن).

مسافات زائدة
استخدم هذه القاعدة لمنع المسافات الزائدة في نهاية السطور. أمثلة INDENT 0.0

1. مع مسافات زائدة: {}

مقتطف الشفرة التالي مرر:

هذا المستند لا يحتوي على
أي زائدة
المساحات

مقتطف الشفرة التالي يفشلون:

يحتوي هذا المستند
مسافات زائدة
في السطر 1 و 3

التطوير
يوفر yamllint كلاً من البرنامج النصي ووحدة Python. يمكن استخدام هذا الأخير لكتابة ملف
أدوات الفحص الخاصة:

فئة yamllint.linter.LintProblem (سطر ، عمود، تنازلي = ' الوصف> '، القاعدة = لا شيء)
يمثل مشكلة فحص وجدتها yamllint.

عمود = بدون سلوفان
العمود الذي تم العثور على المشكلة فيه (بدءًا من 1)

تنازلي = بدون سلوفان
وصف يمكن قراءته من قبل الإنسان للمشكلة

خط = بدون سلوفان
السطر الذي تم العثور على المشكلة فيه (بدءًا من 1)

حكم = بدون سلوفان
معرّف القاعدة التي اكتشفت المشكلة

yamllint.linter.run (إدخال ، أسيوط)
Lints مصدر YAML.

يُرجع مُنشئ كائنات LintProblem.

المعاملات

· إدخال - مخزن مؤقت أو سلسلة أو دفق للقراءة منه

· أسيوط - كائن تكوين yamllint

الاندماج مع نص المحررين
تدعم معظم برامج تحرير النصوص التحقق من بناء الجملة والتمييز ، لتقرير بناء الجملة بصريًا
أخطاء وتحذيرات للمستخدم. يمكن استخدام yamllint للتحقق من بناء الجملة لمصدر YAML ، ولكن يمكن استخدام ملف
القليل من التكوين مطلوب اعتمادًا على محرر النصوص المفضل لديك.

همة
على افتراض أن نحوي تم تثبيت المكون الإضافي ، أضف إلى ملف .vimrc:

دعونا g: syntastic_yaml_checkers = ['yamllint']

نيوفيم
على افتراض أن نيوماكي تم تثبيت المكون الإضافي ، يتم دعم yamllint افتراضيًا. إنها
يتم تمكينه تلقائيًا عند تحرير ملفات YAML.

أخرى نص المحررين
مطلوب مساعدة!

محرر النصوص المفضل لديك غير مدرج هنا؟ ساعدنا على التحسين بإضافة قسم (بواسطة
فتح طلب سحب أو إصدار على جيثب).

استخدم yamllint عبر الإنترنت باستخدام خدمات onworks.net