نام (NAME)

Devel::Cover::Report::Nvim - بک‌اند نمایش داده‌های پوشش آزمون (Coverage) در نئو‌ویم با زبان لوآ

نسخه (VERSION)

نسخه 1.52

خلاصه دستور (SYNOPSIS)

cover -report nvim

توضیحات (DESCRIPTION)

این ماژول سازوکاری گزارش‌دهی برای نمایش داده‌های پوشش کد در نئو‌ویم (Neovim) با استفاده از زبان Lua فراهم می‌کند. این ابزار به گونه‌ای طراحی شده است که از طریق برنامه cover فراخوانی شود.

به‌طور پیش‌فرض، خروجی این گزارش فایلی به نام coverage.lua در دایرکتوری پایگاه داده پوشش است. برای استفاده از آن در نئو‌ویم، دستور زیر را اجرا کنید:

:luafile cover_db/coverage.lua

پس از اجرا، علائمی را در ستون سمت چپ مشاهده خواهید کرد که وضعیت پوشش آن خط را نشان می‌دهند.

علائم و نشانه‌ها به شرح زیر هستند:

P - پوشش مستندات (Pod coverage)
S - پوشش عبارات (Statement coverage)
R - پوشش زیربرنامه‌ها و توابع (Subroutine coverage)
B - پوشش شاخه‌ها و انشعاب‌ها (Branch coverage)
C - پوشش شرط‌ها (Condition coverage)

آخرین معیار در ترتیبی که در بالا ذکر شد، موردی است که نمایش داده می‌شود. معیارهایی که به درستی پوشش داده شده‌اند با رنگ سبز نشان داده می‌شوند. معیارهای پوشش داده‌نشده با رنگ قرمز نمایش می‌یابند.

اگر داده‌های پوشش برای فایل در حال نمایش قدیمی باشند، تابع coverage_old() فراخوانی شده و نام فایل به آن ارسال می‌شود. به همین ترتیب برای داده‌های پوشش به‌روز، تابع coverage_valid() فراخوانی می‌گردد.

رنگ‌ها و علائم را می‌توان با استفاده از متغیرهای سراسری ویم سفارشی‌سازی کرد. این متغیرها را در فایل init.lua یا init.vim خود قبل از بارگذاری اسکریپت پوشش تنظیم کنید:

vim.g.devel_cover_fg         -- رنگ پیش‌زمینه خطوط پوشش‌داده‌شده (پیش‌فرض: "Green")
vim.g.devel_cover_error_fg   -- رنگ پیش‌زمینه خطوط پوشش‌داده‌نشده (پیش‌فرض: "Red")
vim.g.devel_cover_valid_bg   -- رنگ پس‌زمینه در زمان معتبر بودن داده‌ها
vim.g.devel_cover_old_bg     -- رنگ پس‌زمینه در زمان قدیمی بودن داده‌ها

فایل coverage.lua دو دستور کاربری جدید اضافه می‌کند: :Cov و :Uncov که می‌توان از آن‌ها برای تغییر وضعیت نمایش علائم پوشش استفاده کرد.

همچنین ببینید (SEE ALSO)

Devel::Cover(3pm), Devel::Cover::Report::Vim(3pm), https://github.com/nyarly/Simplecov-Vim

مجوز (LICENCE)

این نرم‌افزار آزاد است و تحت همان شرایط خود پرل (Perl) مجوزدهی شده است.

آخرین نسخه این نرم‌افزار در نشانی زیر در دسترس است: https://pjcj.net