نام (NAME)

dejagnu report card — خلاصه‌سازی نتایج حاصل از آزمون چندین ابزار

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

dejagnu report card [⟨option⟩ | ⟨tool⟩ | ⟨file⟩] ...

توضیحات (DESCRIPTION)

دستور dejagnu report card نتایج حاصل از آزمون ابزارهای متعدد را در قالب جدول نمایش می‌دهد. جدول ایجادشده برای هر ابزار (و چنانچه چندین مرحله اجرا شده باشد، برای هر مرحله) تعداد آزمون‌های موفق (passed)، ناموفق (failed)، پشتیبانی‌نشده (unsupported)، حل‌نشده (unresolved) و آزموده‌نشده (untested) را فهرست می‌کند. آزمون‌هایی که انتظار شکست آن‌ها وجود دارد، در ستون‌هایی مجزا از آزمون‌هایی که انتظار قبولی آن‌ها می‌رود شمرده می‌شوند، اما شکست‌های «شناخته‌شده» (known) و شکست‌های «مورد انتظار» (expected) با یکدیگر خلاصه می‌شوند. اگر آزمونی هشدارها یا خطاهایی تولید کرده باشد، برچسب ‘!W!’ یا ‘!E!’ به انتهای خط مربوطه اضافه می‌شود.

علاوه بر گزینه‌ها، فهرست آرگومان‌ها ممکن است شامل نام ابزارها یا فایل‌ها باشد. دستور dejagnu report card ترجیح می‌دهد فایل‌های خلاصهٔ DejaGnu را بخواند و نام‌ها را بر همین اساس تفسیر می‌کند:

*.sum

به همان صورت استفاده می‌شود.

*.log

با همان ریشه به *.sum تبدیل می‌شود.

*.

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

*

به‌عنوان نام ابزار در نظر گرفته می‌شود؛ پسوند .sum به انتهای آن اضافه می‌شود.

گزینه‌ها (OPTIONS)

-v, --verbose

خروجی‌های بیشتری را در توصیف عملکرد خودِ dejagnu report card تولید می‌کند.

فایل‌ها (FILES)

دستور dejagnu report card خروجی خود را با خواندن فایل‌های خلاصه تولیدشده توسط DejaGnu و شمارش مقادیر «PASS»، «FAIL» و غیره تولید می‌کند.

اگر هیچ نامی به‌عنوان آرگومان داده نشود، تمام فایل‌های منطبق بر *.sum در دایرکتوری جاری خوانده می‌شوند.

مثال‌ها (EXAMPLES)

$ dejagnu report card
             __________________________________________________
            /    PASS   FAIL  ?PASS  ?FAIL  UNSUP  UNRES UNTEST
            |--------------------------------------------------
  launcher  |      52      0      0      0      0      0      0
libdejagnu  |       5      0      0      0      0      0      0
   runtest  |     135      0      0      0      0      0      0
            |--------------------------------------------------
            |     192      0      0      0      0      0      0
            \__________________________________________________

$ dejagnu report-card
                    __________________________________________________
                   /    PASS   FAIL  ?PASS  ?FAIL  UNSUP  UNRES UNTEST
                   |--------------------------------------------------
   launcher        |      52      0      0      0      0      0      0
 libdejagnu        |       5      0      0      0      0      0      0
report-card / awk  |      36      0      0      0      0      0      0
report-card / sh   |      36      0      0      0      0      0      0
report-card / tcl  |      36      0      0      0      0      0      0
    runtest        |     135      0      0      0      0      0      0
                   |--------------------------------------------------
              awk  |      36      0      0      0      0      0      0
              sh   |      36      0      0      0      0      0      0
              tcl  |      36      0      0      0      0      0      0
                   |--------------------------------------------------
                   |     300      0      0      0      0      0      0
                   \__________________________________________________

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

dejagnu(1) runtest(1)

مستندات کامل DejaGnu در قالب یک دفترچه راهنمای Texinfo نگهداری می‌شود. اگر برنامهٔ info به‌درستی روی سیستم شما نصب شده باشد، دستور info dejagnu باید دسترسی به دفترچه راهنمای کامل را برای شما فراهم کند.

نویسندگان (AUTHORS)

Jacob Bachmeyer