شغّل اختباراتك باستخدام
$ busted
راجع تثبيت Lua محليًا لمعرفة كيفية تثبيت busted.
تنقيح اختبارات الوحدة
سيرشدك هذا الدليل إلى كيفية إعداد VSCode مع إطار الاختبار Busted وLocal Lua Debugger، بحيث يمكنك وضع نقاط التوقف في ملف الاختبار وفي الملف الذي يختبره معًا، مما يسهّل اتباع سير عمل مباشر لـلتطوير الموجّه بالاختبارات. هذه ليست الطريقة المعتمدة الوحيدة، فهناك طرق كثيرة قد تنجح، لكن هذه الطريقة ستنقلك على الأقل إلى مرحلة العمل (ملاحظة: جُرّبت هذه الطريقة وتعمل على Windows 10 وUbuntu 20.04).
وبعد أن انتهينا من كل هذه المصطلحات، لنبدأ.
يمكنك تخطي هذه الأجزاء، فهي لا تخدم إلا شرح العملية.
في VSCode أزل جميع إضافات تنقيح Lua الأخرى أو عطّلها، ثم ثبّت Local Lua Debugger. بعد ذلك أنشئ إعداد تشغيل مخصّصًا بهذا الشكل:
{
"name": "Busted",
"type": "lua-local",
"request": "launch",
"program": {
"command": "busted"
},
"cwd": "${workspaceFolder}/${relativeFileDirname}",
"args": ["${file}"],
"integratedTerminal": true
}
ملاحظة: ستُظهر لك الخاصية integratedTerminal تحذيرًا نصّه Property integratedTerminal is not allowed، لكن يمكنك تجاهله بكل طمأنينة.
تحدّد الخاصية cwd دليل العمل الحالي، وهذا مهم لتحليل المسارات. افتراضيًا، يثبّت Exercism كل تمرين في مجلد خاص به داخل مجلد الـtrack. وفي حالة Lua يبدو الأمر هكذا:
└── Exercism/
├── lua/
│ ├── armstrong-numbers
│ ├── bank-account
│ ├── binarysearch
│ └── etc...
└── python/
└── etc...
فعندما نفتح VSCode من مجلد /lua بهذه الطريقة:
C:\users\<username>\Exercism\lua> code .
أو
/home/<username>/exercism/lua> code .
سيعرض VSCode كل تمرين في مجلد خاص به داخل مساحة العمل لدينا. وهذا يعني أننا نحتاج إلى أن يغيّر إعداد التشغيل دليل العمل الحالي، cwd، ليصبح مجلد كل تمرين على حدة. ونفعل ذلك باستخدام ${workspaceFolder} و${relativeFileDirname} معًا، وهما من متغيّرات VSCode.
تحدّد الخاصية args الوسيط الذي سيُمرَّر إلى Busted. وفي هذه الحالة نستخدم المتغير ${file} للإشارة إلى الملف المفتوح حاليًا.
بعد ذلك، أضف هذه الأسطر الثلاثة إلى أعلى ملف الاختبار الخاص بالتمرين الذي تعمل عليه، واسمه <exercise_name>_spec.lua:
if os.getenv("LOCAL_LUA_DEBUGGER_VSCODE") == "1" then
require("lldebugger").start()
end
الآن، عندما تريد تشغيل الاختبارات باستخدام المنقّح، افتح ملف الاختبار ثم شغّل إعداد التشغيل الذي أنشأته للتو من الشريط الجانبي Run and Debug (Ctrl+Shift+D) على اليسار. وإذا كان ملف الاختبار هو النافذة النشطة، فسيشغّل إعداد التشغيل تلك الاختبارات، ويتوقف عند نقاط التوقف، ويطبع الناتج في تبويب DEBUG CONSOLE داخل الطرفية المدمجة في الأسفل.
برمجة ممتعة!
