هذا هو الأمر genhtml الذي يمكن تشغيله في مزود الاستضافة المجانية OnWorks باستخدام إحدى محطات العمل المجانية المتعددة عبر الإنترنت مثل Ubuntu Online أو Fedora Online أو محاكي Windows عبر الإنترنت أو محاكي MAC OS عبر الإنترنت
برنامج:
اسم
genhtml - إنشاء عرض HTML من ملفات بيانات تغطية LCOV
موجز
com.genhtml [-h|--مساعدة] [-v|--الإصدار]
[-q|--هادئ] [-s|--اظهر التفاصيل] [-f|- إطارات]
[-b|- ملف الأساس] ملف الأساس
[-o|- إخراج الدليل دليل الإخراج]
[-t|--لقب الاسم]
[-d|--ملف الوصف وصف الملف]
[-k|- حفظ الأوصاف] [-c|- ملف css ملف css]
[-p|--اختصار بادئة] [--لا بادئة]
[--لا يوجد مصدر] [- عدد المسافات NUM] [--تسليط الضوء]
[--أسطورة] [- html-prolog ملف برولوج]
[--html-epilog ملف epilog] [- html- التمديد تمديد]
[- html-gzip] [--نوع] [--بدون فرز]
[- تغطية الوظائف] [--لا وظيفة التغطية]
[- تغطية فرع] [- لا يوجد فرع تغطية]
[--demangle-cpp] [- أخطاء قديمة أخطاء]
[--ملف التكوين ملف التكوين] [--rc الكلمة=قيمنا]
[--الاحكام NUM]
ملف (ملفات) تتبع
الوصف
قم بإنشاء عرض HTML لبيانات التغطية الموجودة في ملف التتبع. لاحظ أن ملف التتبع قد تكون أيضا
قائمة بأسماء الملفات.
يتم إنشاء ملفات إخراج HTML في دليل العمل الحالي ما لم يتم إنشاء ملفات
- يتم استخدام خيار دليل الإخراج. لو ملف التتبع ينتهي بـ ".gz" ، من المفترض أن يكون
يتم ضغط GZIP وأداة gunzip لفك ضغطه بشفافية.
لاحظ أن جميع ملفات التعليمات البرمجية المصدر يجب أن تكون موجودة وقابلة للقراءة في نظام الملفات المحدد
موقع تم تجميعها.
استخدم الخيار - ملف css لتعديل تنسيق وألوان ناتج 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
--اظهر التفاصيل
إنشاء عرض دليل مفصل.
عندما يتم تمكين هذا الخيار ، com.genhtml يولد نسختين من كل عرض ملف. واحد
تحتوي على المعلومات القياسية بالإضافة إلى ارتباط إلى نسخة "مفصلة". الأخير
بالإضافة إلى ذلك يحتوي على معلومات حول حالة الاختبار التي غطت عدد سطور
كل ملف مصدر.
-b ملف الأساس
- ملف الأساس ملف الأساس
استخدام البيانات بتنسيق ملف الأساس كخط أساس للتغطية.
ملف التتبع المحدد بواسطة ملف الأساس تتم قراءة وجميع التهم الموجهة إليه في ملف
أصلي ملف التتبع يتم إنقاصها من خلال التهم المقابلة في ملف الأساس
قبل إنشاء أي إخراج.
لاحظ أنه عند حساب لسطر معين في ملف الأساس أكبر من
العد في ملف التتبع، والنتيجة هي صفر.
-o دليل الإخراج
- إخراج الدليل دليل الإخراج
أنشئ ملفات بتنسيق دليل الإخراج.
استخدم هذا الخيار لتخبر com.genhtml لكتابة الملفات الناتجة إلى دليل آخر
من الحالي. لو دليل الإخراج غير موجود ، سيتم إنشاؤه.
يُنصح باستخدام هذا الخيار لأنه يعتمد على حجم المشروع كثيرًا
يمكن إنشاء الملفات والأدلة الفرعية.
-t الاسم
--لقب الاسم
العرض الاسم في رأس كل الصفحات.
الاسم تتم كتابته في جزء الرأس لكل صفحة HTML تم إنشاؤها لتحديد ملف
السياق الذي تم فيه إنشاء ناتج معين. افتراضيا هذا هو اسم
ملف التتبع.
-d وصف الملف
--ملف الوصف وصف الملف
اقرأ أوصاف حالة الاختبار من وصف الملف.
تم العثور على جميع أوصاف حالة الاختبار في وصف الملف والمشار إليها في المدخلات
تتم قراءة ملف البيانات وكتابته في صفحة إضافية يتم دمجها بعد ذلك في ملف
إخراج HTML.
تنسيق ملف وصف الملف هو:
لكل حالة اختبار:
TN:
TD:
يمكن أن تتكون أسماء حالات الاختبار الصالحة من أحرف وأرقام وشرطة سفلية
("_").
-k
- حفظ الأوصاف
لا تقم بإزالة أوصاف الاختبار غير المستخدمة.
احتفظ بالأوصاف الموجودة في ملف الوصف حتى إذا أشارت بيانات التغطية
أن حالة الاختبار المرتبطة بها لا تغطي أي سطور من التعليمات البرمجية.
يمكن أيضًا تكوين هذا الخيار بشكل دائم باستخدام خيار ملف التكوين
genhtml_keep_descriptions.
-c ملف css
- ملف css ملف css
استخدم ملف ورقة الأنماط الخارجية ملف css.
باستخدام هذا الخيار ، قد يتم تحديد ملف .css إضافي والذي سيحل محل ملف
الافتراضي واحد. قد يكون هذا مفيدًا إذا كانت الألوان الافتراضية تجعل عينيك ترغب في القفز
من مآخذهم :)
يمكن أيضًا تكوين هذا الخيار بشكل دائم باستخدام خيار ملف التكوين
genhtml_css_file.
-p بادئة
--اختصار بادئة
حذف بادئة من كافة أسماء الدلائل.
نظرًا لصعوبة قراءة القوائم التي تحتوي على أسماء ملفات طويلة ، فهناك آلية
تم تنفيذه والذي سيحاول تلقائيًا تقصير جميع أسماء الدلائل على ملف
تبدأ صفحة النظرة العامة ببادئة مشتركة. بشكل افتراضي ، يتم ذلك باستخدام ملف
الخوارزمية التي تحاول العثور على البادئة التي ، عند تطبيقها ، ستقلل من
الناتج مجموع أحرف جميع أسماء الدلائل.
استخدم هذا الخيار لتحديد البادئة التي تريد إزالتها بنفسك.
--لا بادئة
لا تقم بإزالة البادئة من أسماء الدلائل.
سيعطل هذا المفتاح تمامًا آلية البادئة الموضحة في السابق
والقسم الخاص به.
يمكن أيضًا تكوين هذا الخيار بشكل دائم باستخدام خيار ملف التكوين
genhtml_no_prefix.
--لا يوجد مصدر
لا تقم بإنشاء عرض التعليمات البرمجية المصدر.
استخدم رمز التبديل هذا إذا كنت لا تريد الحصول على طريقة عرض التعليمات البرمجية المصدر لكل ملف.
يمكن أيضًا تكوين هذا الخيار بشكل دائم باستخدام خيار ملف التكوين
genhtml_no_source.
- عدد المسافات المساحات
استبدل علامات التبويب في عرض المصدر بـ NUM المسافات.
القيمة الافتراضية هي 8.
يمكن أيضًا تكوين هذا الخيار بشكل دائم باستخدام خيار ملف التكوين
genhtml_num_spaces.
--تسليط الضوء
قم بتمييز الخطوط ببيانات التغطية المحولة فقط.
استخدم هذا الخيار جنبًا إلى جنب مع الخيار --diff لـ لكوف لتسليط الضوء على هؤلاء
الأسطر التي تمت تغطيتها فقط في مجموعات البيانات التي تم تحويلها من السابق
إصدارات التعليمات البرمجية المصدر.
يمكن أيضًا تكوين هذا الخيار بشكل دائم باستخدام خيار ملف التكوين
genhtml_highlight.
--أسطورة
قم بتضمين وسيلة إيضاح اللون في إخراج HTML.
استخدم هذا الخيار لتضمين وسيلة إيضاح تشرح معنى الترميز اللوني في ملف
الناتج HTML.
يمكن أيضًا تكوين هذا الخيار بشكل دائم باستخدام خيار ملف التكوين
genhtml_legend.
- html-prolog ملف برولوج
اقرأ برولوج HTML المخصص من ملف برولوج.
استخدم هذا الخيار لاستبدال نص HTML الافتراضي (الجزء الأول من HTML
شفرة المصدر المؤدية إلى ملف علامة) بمحتويات
ملف برولوج. داخل نص prolog ، سيتم استبدال الكلمات التالية عندما أ
تم إنشاء الصفحة:
@عنوان الصفحة@
عنوان الصفحة.
@ Basedir @
مسار نسبي يؤدي إلى الدليل الأساسي (على سبيل المثال لتحديد موقع ملفات css).
يمكن أيضًا تكوين هذا الخيار بشكل دائم باستخدام خيار ملف التكوين
genhtml_html_prolog.
--html-epilog ملف epilog
قراءة مخصصة HTML epilog من ملف epilog.
استخدم هذا الخيار لاستبدال النص الافتراضي HTML epilog (الجزء الأخير من HTML
بما في ذلك المصدر ) بمحتويات ملف epilog.
في نص الخاتمة ، سيتم استبدال الكلمات التالية عندما تكون الصفحة
ولدت:
@ Basedir @
مسار نسبي يؤدي إلى الدليل الأساسي (على سبيل المثال لتحديد موقع ملفات css).
يمكن أيضًا تكوين هذا الخيار بشكل دائم باستخدام خيار ملف التكوين
genhtml_html_epilog.
- html- التمديد تمديد
استخدم ملحق اسم الملف المخصص لصفحات HTML التي تم إنشاؤها.
هذا الخيار مفيد في المواقف التي تكون فيها امتدادات أسماء الملفات مختلفة
مطلوب لتقديم الصفحات الناتجة بشكل صحيح (مثل php). لاحظ أن "." سوف
بين اسم الملف والامتداد المحدد بواسطة هذا الخيار.
يمكن أيضًا تكوين هذا الخيار بشكل دائم باستخدام خيار ملف التكوين
genhtml_html_extension.
- html-gzip
ضغط جميع ملفات html التي تم إنشاؤها باستخدام gzip وأضف ملف htaccess
ترميز gzip في دليل الإخراج الجذر.
استخدم هذا الخيار إذا كنت تريد توفير مساحة على خادم الويب الخاص بك. يتطلب خادم ويب
مع دعم htaccess ومتصفح مع دعم html مضغوط gzip.
يمكن أيضًا تكوين هذا الخيار بشكل دائم باستخدام خيار ملف التكوين
genhtml_html_gzip.
--نوع
--بدون فرز
حدد ما إذا كنت تريد تضمين طرق العرض التي تم فرزها لنظرات عامة على الملف والدليل.
استخدم --sort لتضمين العروض التي تم فرزها أو - no-Sort لعدم تضمينها. المشاهدات المصنفة
. تمكين بشكل افتراضي.
عند تمكين طرق العرض المصنفة ، ستحتوي كل صفحة نظرة عامة على روابط لعروض
تلك الصفحة مرتبة حسب معدل التغطية.
يمكن أيضًا تكوين هذا الخيار بشكل دائم باستخدام خيار ملف التكوين
genhtml_sort.
- تغطية الوظائف
--لا وظيفة التغطية
حدد ما إذا كنت تريد عرض ملخصات تغطية الوظيفة في إخراج HTML.
استخدم - تغطية الوظائف لتمكين ملخصات تغطية الوظيفة أو
--لا وظيفة التغطية لتعطيلها. ملخصات تغطية الوظيفة هي تمكين by
الافتراضي
عند تمكين ملخصات تغطية الوظائف ، ستحتوي كل صفحة نظرة عامة على
عدد الوظائف التي تم العثور عليها وضربها لكل ملف أو دليل ، جنبًا إلى جنب مع
معدل التغطية الناتج. بالإضافة إلى ذلك ، سيحتوي كل عرض شفرة مصدر على ارتباط بـ
صفحة تسرد جميع الوظائف الموجودة في هذا الملف بالإضافة إلى عدد المكالمات المعنية
لتلك الوظائف.
يمكن أيضًا تكوين هذا الخيار بشكل دائم باستخدام خيار ملف التكوين
genhtml_function_coverage.
- تغطية فرع
- لا يوجد فرع تغطية
حدد ما إذا كنت تريد عرض بيانات تغطية الفرع في إخراج HTML.
استخدم - تغطية - فرع لتمكين عرض تغطية الفرع أو - تغطية - بلا فرع
تعطيله. عرض بيانات تغطية الفرع هو تمكين بشكل افتراضي
عند تمكين عرض تغطية الفرع ، ستحتوي كل صفحة نظرة عامة على الرقم
من الفروع التي تم العثور عليها وضربها لكل ملف أو دليل ، جنبًا إلى جنب مع الناتج
معدل التغطية. بالإضافة إلى ذلك ، سيحتوي كل عرض شفرة مصدر على عمود إضافي
الذي يسرد جميع فروع السطر مع مؤشرات على ما إذا كان الفرع مأخوذًا أم لا
أم لا. تظهر الفروع بالصيغة التالية:
"+": تم أخذ الفرع مرة واحدة على الأقل
"-": الفرع لم يؤخذ
'#': لم يتم تنفيذ الكتلة الأساسية التي تحتوي على الفرع مطلقًا
لاحظ أنه قد لا يكون من الممكن دائمًا ربط الفروع بما يقابلها
بيانات كود المصدر: أثناء التجميع ، قد يقوم GCC بتبديل الفروع حولها أو
القضاء على بعضها لإنشاء كود أفضل.
يمكن أيضًا تكوين هذا الخيار بشكل دائم باستخدام خيار ملف التكوين
genhtml_branch_coverage.
--demangle-cpp
حدد ما إذا كنت تريد فك أسماء وظائف C ++.
استخدم هذا الخيار إذا كنت تريد تحويل أسماء الوظائف الداخلية لـ C ++ إلى بشرية
تنسيق قابل للقراءة للعرض في صفحة نظرة عامة على وظيفة HTML. هذا الخيار
يتطلب أن يتم تثبيت أداة filt c ++ (انظر ج ++مرشح(1)).
- أخطاء قديمة أخطاء
حدد قائمة بالأخطاء لمتابعة المعالجة بعدها.
استخدم هذا الخيار لتحديد قائمة بفئة أو أكثر من فئات الأخطاء بعد ذلك
يجب أن تستمر geninfo في المعالجة بدلاً من إجهاضها.
أخطاء يمكن أن تكون قائمة بالكلمات الرئيسية التالية مفصولة بفواصل:
مصدر: تعذر العثور على ملف التعليمات البرمجية المصدر لمجموعة البيانات.
--ملف التكوين ملف التكوين
حدد ملف تكوين لاستخدامه.
عندما يتم تحديد هذا الخيار ، لا ملف التكوين على مستوى النظام
/ etc / lcovrc ، ولا ملف التكوين لكل مستخدم ~ / .lcovrc يقرأ.
قد يكون هذا الخيار مفيدًا عندما تكون هناك حاجة لتشغيل عدة مثيلات من com.genhtml
مع خيارات ملف التكوين المختلفة بالتوازي.
--rc الكلمة=قيمنا
تجاوز توجيه التكوين.
استخدم هذا الخيار لتحديد ملف الكلمة=قيمنا البيان الذي يلغي
بيان التكوين المقابل في ملف التكوين lcovrc. أنت تستطيع
حدد هذا الخيار أكثر من مرة لتجاوز عبارات التكوين المتعددة.
يرى لكوفرك(5) للحصول على قائمة الكلمات الرئيسية المتاحة ومعناها.
--الاحكام NUM
إظهار معدلات التغطية مع NUM عدد الأرقام بعد الفاصلة العشرية.
القيمة الافتراضية هي 1.
يمكن أيضًا تكوين هذا الخيار بشكل دائم باستخدام خيار ملف التكوين
genhtml_precision.
استخدم genhtml عبر الإنترنت باستخدام خدمات onworks.net
