genhtml - آنلاین در ابر

برنامه:

نام

genhtml - نمای HTML را از فایل های داده پوشش LCOV ایجاد کنید

خلاصه

genhtml [-h|--کمک] [-v|- نسخه]
[-q|--ساکت] [-s|--نمایش جزئیات] [-f|--قاب ها]
[-b|--baseline-file] فایل پایه
[-o|--خروجی-دایرکتوری دایرکتوری خروجی]
[-t|--عنوان عنوان]
[-d|--description-file توضیحات-فایل]
[-k|-----توضیحات] [-c|--css-file فایل css]
[-p|-- پیشوند پیشوند] [--بدون پیشوند]
[--بدون منبع] [--num-spaces تعداد] [--برجسته]
[--افسانه] [--html-prolog پرولوگ-پرونده]
[--html-epilog اپیلوگ-پرونده] [--html-پسوند گسترش]
[--html-gzip] [--مرتب سازی] [--بدون مرتب سازی]
[- عملکرد-پوشش] [--بدون عملکرد-پوشش]
[--شعبه-پوشش] [--بدون پوشش شعبه]
[--demangle-cpp] [--نادیده گرفتن-خطاها خطا]
[--config-file فایل پیکربندی] [--rc کلمه کلیدی=ارزش]
[--دقت، درستی تعداد]
فایل (های) ردیابی

شرح

یک نمای HTML از داده های پوشش موجود در ایجاد کنید فایل ردیابی. توجه داشته باشید که فایل ردیابی ممکن است
لیستی از نام فایل ها

فایل های خروجی HTML در دایرکتوری کاری فعلی ایجاد می شوند مگر اینکه
گزینه --output-directory استفاده می شود. اگر فایل ردیابی با ".gz" به پایان می رسد، فرض می شود
فشرده سازی GZIP و ابزار gunzip برای فشرده سازی شفاف آن استفاده خواهد شد.

توجه داشته باشید که همه فایل های کد منبع باید در سیستم فایل دقیق موجود و قابل خواندن باشند
محل گردآوری آنها

استفاده از گزینه --css-file برای تغییر طرح و رنگ های خروجی HTML تولید شده. فایل ها هستند
بسته به نرخ پوشش مرتبط با رنگ های مختلف مشخص شده است. به طور پیش فرض،
محدودیت های پوشش برای پوشش کم، متوسط ​​و بالا 0-75٪، 75-90٪ و 90-100٪ تنظیم شده است.
درصد به ترتیب. برای تغییر این مقادیر، از گزینه های فایل پیکربندی استفاده کنید
genhtml_hi_limit و genhtml_med_limit.

همچنین توجه داشته باشید که هنگام نمایش درصدها، 0٪ و 100٪ فقط زمانی چاپ می شوند که مقادیر باشند
دقیقاً 0% و 100% هستند. مقادیر دیگری که به طور معمول گرد می شوند
تا 0% یا 100% به‌عنوان نزدیک‌ترین مقدار غیرمرز چاپ می‌شوند. این رفتار در
مطابق با آن از gcov(1) ابزار.

OPTIONS

-h
--کمک
یک متن راهنما کوتاه چاپ کنید، سپس خارج شوید.

-v
- نسخه
شماره نسخه را چاپ کنید، سپس خارج شوید.

-q
--ساکت
پیام های پیشرفت را چاپ نکنید.

تمام خروجی های پیشرفت اطلاعاتی را سرکوب می کند. فقط زمانی که این سوئیچ فعال باشد
پیام های خطا یا هشدار چاپ می شوند.

-f
--قاب ها
از فریم های HTML برای مشاهده کد منبع استفاده کنید.

اگر فعال باشد، یک مجموعه فریم برای هر فایل کد منبع ایجاد می شود که یک نمای کلی ارائه می کند
از کد منبع به عنوان یک تصویر "قابل کلیک". توجه داشته باشید که سرعت این گزینه کاهش می یابد
ایجاد خروجی قابل توجه است زیرا هر کاراکتر کد منبع باید بازرسی شود
یک بار. همچنین توجه داشته باشید که ماژول GD.pm Perl باید برای این گزینه نصب شود
کار (ممکن است از http://www.cpan.org).

-s
--نمایش جزئیات
نمای فهرست دقیق را ایجاد کنید.

وقتی این گزینه فعال است، genhtml دو نسخه از هر نمای فایل تولید می کند. یکی
حاوی اطلاعات استاندارد به همراه پیوندی به یک نسخه "جزئیات". دومی
علاوه بر این حاوی اطلاعاتی در مورد اینکه کدام مورد آزمایشی چند خط را پوشش می دهد
هر فایل منبع

-b فایل پایه
--baseline-file فایل پایه
استفاده از داده ها در فایل پایه به عنوان خط پایه پوشش

فایل ردیابی مشخص شده توسط فایل پایه خوانده می شود و همه شمارش ها در
اصلی فایل ردیابی با تعداد مربوطه در کاهش می یابد فایل پایه
قبل از ایجاد هر خروجی

توجه داشته باشید که وقتی یک شمارش برای یک خط خاص در فایل پایه بزرگتر از
شمارش در فایل ردیابی، نتیجه صفر است.

-o دایرکتوری خروجی
--خروجی-دایرکتوری دایرکتوری خروجی
ایجاد فایل در دایرکتوری خروجی

از این گزینه برای گفتن استفاده کنید genhtml برای نوشتن فایل های به دست آمده در یک دایرکتوری دیگر
نسبت به فعلی اگر دایرکتوری خروجی وجود ندارد، ایجاد خواهد شد.

توصیه می شود از این گزینه استفاده کنید زیرا بسته به اندازه پروژه، تعداد زیادی از آنها
ممکن است فایل ها و زیر شاخه ها ایجاد شوند.

-t عنوان
--عنوان عنوان
نمایش دادن عنوان در سربرگ تمام صفحات

عنوان در قسمت هدر هر صفحه HTML تولید شده برای شناسایی نوشته می شود
زمینه ای که در آن یک خروجی خاص ایجاد شده است. به طور پیش فرض این نام است
فایل ردیابی

-d توضیحات-فایل
--description-file توضیحات-فایل
توضیحات مورد تست را از توضیحات-فایل.

تمام توضیحات مورد آزمایشی موجود در توضیحات-فایل و در ورودی به آن اشاره شده است
فایل داده خوانده می شود و در یک صفحه اضافی نوشته می شود که سپس در آن گنجانده می شود
خروجی HTML

فرمت فایل از توضیحات-فایل است:

برای هر مورد آزمایشی:
TN:
TD:

نام موارد آزمایشی معتبر می تواند از حروف، اعداد و کاراکتر زیرخط تشکیل شود
('_').
-k
-----توضیحات
توضیحات تست استفاده نشده را حذف نکنید.

توضیحات موجود در فایل توضیحات را حتی اگر داده های پوشش نشان می دهد، نگه دارید
که مورد آزمایشی مرتبط هیچ خط کدی را پوشش نمی دهد.

همچنین می توان این گزینه را با استفاده از گزینه configuration file به صورت دائمی پیکربندی کرد
genhtml_keep_descriptions.

-c فایل css
--css-file فایل css
از فایل شیوه نامه خارجی استفاده کنید فایل css.

با استفاده از این گزینه، ممکن است یک فایل .css اضافی مشخص شود که جایگزین آن می شود
یک پیش فرض اگر رنگ‌های پیش‌فرض باعث می‌شود که چشمان شما بپرند، این ممکن است مفید باشد
خارج از سوکت :)

همچنین می توان این گزینه را با استفاده از گزینه configuration file به صورت دائمی پیکربندی کرد
genhtml_css_file.

-p پیشوند
-- پیشوند پیشوند
برداشتن پیشوند از همه نام های دایرکتوری

از آنجایی که خواندن لیست های حاوی نام فایل های طولانی دشوار است، مکانیسمی وجود دارد
پیاده سازی شده است که به طور خودکار سعی می کند همه نام دایرکتوری ها را کوتاه کند
صفحه نمای کلی که با یک پیشوند مشترک شروع می شود. به طور پیش فرض، این کار با استفاده از یک انجام می شود
الگوریتمی که سعی می‌کند پیشوندی را پیدا کند که در صورت اعمال، آن را به حداقل می‌رساند
حاصل جمع کاراکترهای همه نام دایرکتوری ها.

از این گزینه برای تعیین پیشوندی که باید توسط خودتان حذف شود استفاده کنید.

--بدون پیشوند
پیشوند را از نام دایرکتوری حذف نکنید.

این سوئیچ مکانیزم پیشوندی که در قسمت قبل توضیح داده شد را به طور کامل غیرفعال می کند
بخش.

همچنین می توان این گزینه را با استفاده از گزینه configuration file به صورت دائمی پیکربندی کرد
genhtml_no_prefix.

--بدون منبع
نمای کد منبع ایجاد نکنید.

اگر نمی‌خواهید برای هر فایل یک نمای کد منبع دریافت کنید، از این سوئیچ استفاده کنید.

همچنین می توان این گزینه را با استفاده از گزینه configuration file به صورت دائمی پیکربندی کرد
genhtml_no_source.

--num-spaces فضاها
جایگزین کردن برگه ها در نمای منبع با تعداد فضاها

مقدار پیش فرض 8 است.

همچنین می توان این گزینه را با استفاده از گزینه configuration file به صورت دائمی پیکربندی کرد
genhtml_num_spaces.

--برجسته
خطوط با داده های پوشش فقط تبدیل شده را برجسته کنید.

از این گزینه به همراه گزینه --diff of استفاده کنید lcov برای برجسته کردن آن ها
خطوطی که فقط در مجموعه داده هایی که از قبلی تبدیل شده اند پوشش داده شده اند
نسخه های کد منبع

همچنین می توان این گزینه را با استفاده از گزینه configuration file به صورت دائمی پیکربندی کرد
genhtml_highlight.

--افسانه
شامل افسانه رنگ در خروجی HTML.

از این گزینه برای اضافه کردن افسانه ای استفاده کنید که معنای کدگذاری رنگ را در آن توضیح می دهد
خروجی HTML حاصل

همچنین می توان این گزینه را با استفاده از گزینه configuration file به صورت دائمی پیکربندی کرد
genhtml_legend.

--html-prolog پرولوگ-پرونده
خواندن prolog HTML سفارشی از پرولوگ-پرونده.

از این گزینه برای جایگزینی پیش‌فرض HTML (بخش اولیه HTML) استفاده کنید
کد منبع منتهی به و شامل برچسب) با محتویات
پرولوگ-پرونده. در متن پرولوگ، کلمات زیر زمانی جایگزین می شوند که a
صفحه ایجاد می شود:

@عنوان صفحه@
عنوان صفحه.

@basedir@
یک مسیر نسبی که به دایرکتوری پایه منتهی می شود (مثلاً برای مکان یابی فایل های css).

همچنین می توان این گزینه را با استفاده از گزینه configuration file به صورت دائمی پیکربندی کرد
genhtml_html_prolog.

--html-epilog اپیلوگ-پرونده
اپیلوگ HTML سفارشی شده را بخوانید اپیلوگ-پرونده.

از این گزینه برای جایگزینی اپیلوگ پیش فرض HTML (قسمت پایانی HTML) استفاده کنید
منبع از جمله ) با محتویات اپیلوگ-پرونده.

در متن اپیلوگ، زمانی که یک صفحه باشد، کلمات زیر جایگزین می شوند
تولید شده:

@basedir@
یک مسیر نسبی که به دایرکتوری پایه منتهی می شود (مثلاً برای مکان یابی فایل های css).

همچنین می توان این گزینه را با استفاده از گزینه configuration file به صورت دائمی پیکربندی کرد
genhtml_html_epilog.

--html-پسوند گسترش
از پسوند نام فایل سفارشی برای صفحات HTML تولید شده استفاده کنید.

این گزینه در مواقعی که پسوندهای نام فایل مختلف هستند مفید است
برای ارائه صحیح صفحات به دست آمده (مثلاً php) مورد نیاز است. توجه داشته باشید که یک '.' اراده
بین نام فایل و پسوند مشخص شده توسط این گزینه درج شود.

همچنین می توان این گزینه را با استفاده از گزینه configuration file به صورت دائمی پیکربندی کرد
genhtml_html_extension.

--html-gzip
تمام فایل های html تولید شده را با gzip فشرده کنید و یک فایل htaccess را مشخص کنید
gzip-encoding در دایرکتوری خروجی ریشه.

اگر می خواهید فضایی را در وب سرور خود ذخیره کنید از این گزینه استفاده کنید. به یک وب سرور نیاز دارد
با پشتیبانی htaccess و مرورگری با پشتیبانی از html فشرده gzip.

همچنین می توان این گزینه را با استفاده از گزینه configuration file به صورت دائمی پیکربندی کرد
genhtml_html_gzip.

--مرتب سازی
--بدون مرتب سازی
مشخص کنید که آیا نماهای مرتب شده از نمای کلی فایل و فهرست دایرکتوری شامل شود یا خیر.

از -- sort برای درج نماهای مرتب شده یا --no-sort برای درج نکردن آنها استفاده کنید. نماهای مرتب شده
هستند فعال به صورت پیش فرض.

هنگامی که نماهای مرتب شده فعال هستند، هر صفحه نمای کلی حاوی پیوندهایی به بازدیدها خواهد بود
آن صفحه بر اساس نرخ پوشش مرتب شده است.

همچنین می توان این گزینه را با استفاده از گزینه configuration file به صورت دائمی پیکربندی کرد
genhtml_sort.

- عملکرد-پوشش
--بدون عملکرد-پوشش
مشخص کنید که آیا خلاصه پوشش عملکرد در خروجی HTML نمایش داده شود یا خیر.

از --function-coverage برای فعال کردن خلاصه های پوشش عملکرد یا
--بدون عملکرد-پوشش برای غیرفعال کردن آن. خلاصه های پوشش تابع هستند فعال by
به طور پیش فرض

هنگامی که خلاصه های پوشش عملکرد فعال هستند، هر صفحه نمای کلی شامل موارد زیر خواهد بود
تعداد توابع یافت شده و در هر فایل یا فهرست، همراه با
نرخ پوشش حاصل علاوه بر این، هر نمای کد منبع حاوی پیوندی به
صفحه ای که تمام توابع موجود در آن فایل را به اضافه تعداد تماس مربوطه فهرست می کند
برای آن توابع

همچنین می توان این گزینه را با استفاده از گزینه configuration file به صورت دائمی پیکربندی کرد
genhtml_function_coverage.

--شعبه-پوشش
--بدون پوشش شعبه
مشخص کنید که آیا داده های پوشش شاخه در خروجی HTML نمایش داده شود یا خیر.

از --branch-coverage برای فعال کردن نمایش پوشش شاخه یا --no-branch-coverage برای فعال کردن
آن را غیرفعال کنید نمایش داده های پوشش شعبه می باشد فعال به صورت پیش فرض

وقتی نمایش پوشش شعب فعال است، هر صفحه نمای کلی شامل شماره خواهد بود
از شاخه های یافت شده و در هر فایل یا فهرست، همراه با نتیجه ضربه بزنید
نرخ پوشش علاوه بر این، هر نمای کد منبع شامل یک ستون اضافی خواهد بود
که تمام شاخه های یک خط را با نشانه هایی از اینکه آیا شاخه گرفته شده است فهرست می کند
یا نه. شاخه ها در قالب زیر نشان داده شده اند:

' + ': شاخه حداقل یک بار گرفته شده است
' - ': شعبه گرفته نشد
' # ': بلوک اصلی حاوی شاخه هرگز اجرا نشد

توجه داشته باشید که ممکن است همیشه نتوان شاخه‌ها را به شاخه‌های مربوطه مرتبط کرد
بیانیه های کد منبع: در طول کامپایل، GCC ممکن است شاخه ها را در اطراف یا به هم بزند
برخی از آنها را برای تولید کد بهتر حذف کنید.

همچنین می توان این گزینه را با استفاده از گزینه configuration file به صورت دائمی پیکربندی کرد
genhtml_branch_coverage.

--demangle-cpp
مشخص کنید که نام توابع C++ جدا شود.

اگر می خواهید نام توابع داخلی C++ را به انسان تبدیل کنید از این گزینه استفاده کنید
قالب قابل خواندن برای نمایش در صفحه نمای کلی تابع HTML. این گزینه
مستلزم نصب ابزار c++filt است (نگاه کنید به c ++فیلتر(1).

--نادیده گرفتن-خطاها خطا
لیستی از خطاها را مشخص کنید که پس از آن به پردازش ادامه دهید.

از این گزینه برای تعیین لیستی از یک یا چند کلاس از خطاها استفاده کنید که پس از آن
geninfo باید به جای سقط به پردازش ادامه دهد.

خطا می تواند لیستی از کلمات کلیدی زیر با کاما جدا شده باشد:

منبع: فایل کد منبع یک مجموعه داده پیدا نشد.

--config-file فایل پیکربندی
یک فایل پیکربندی را برای استفاده مشخص کنید.

هنگامی که این گزینه مشخص شده است، نه فایل پیکربندی گسترده سیستم
/etc/lcovrc، و نه فایل پیکربندی هر کاربر ~/.lcovrc خوانده شده است

این گزینه ممکن است زمانی مفید باشد که نیاز به اجرای چندین نمونه از آن وجود داشته باشد genhtml
با گزینه های مختلف فایل پیکربندی به صورت موازی.

--rc کلمه کلیدی=ارزش
یک دستورالعمل پیکربندی را لغو کنید.

از این گزینه برای تعیین a استفاده کنید کلمه کلیدی=ارزش بیانیه ای که نادیده گرفته می شود
بیانیه پیکربندی مربوطه در فایل پیکربندی lcovrc. تو می توانی
این گزینه را بیش از یک بار مشخص کنید تا چندین دستور پیکربندی را لغو کنید.
دیدن lcovrc(5) برای لیستی از کلمات کلیدی موجود و معنای آنها.

--دقت، درستی تعداد
نمایش نرخ های پوشش با تعداد تعداد ارقام بعد از اعشار

مقدار پیش فرض 1 است.

همچنین می توان این گزینه را با استفاده از گزینه configuration file به صورت دائمی پیکربندی کرد
genhtml_precision.

از genhtml به صورت آنلاین با استفاده از خدمات onworks.net استفاده کنید