DEJAGNU-REPORT-CARD(1)   General Commands Manual (urm)  DEJAGNU-REPORT-CARD(1)

نام (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
     $ 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
                 \__________________________________________________

     سه ابزار با مجموع ۱۹۲ آزمون بررسی شدند که انتظار می‌رفت همگی موفق شوند. در
     این مثال، تمام آزمون‌ها با موفقیت سپری شدند، بنابراین سایر ستون‌ها صفر
     هستند. ستون‌های ‘?PASS’ و ‘?FAIL’ آزمون‌های شناخته‌شده یا مورد انتظاری را
     می‌شمارند که قرار بود با شکست مواجه شوند، اما یا به‌طور غیرمنتظره موفق شدند
     یا طبق انتظار شکست خوردند. سه ستون باقی‌مانده، نتایج استثنایی را برای
     آزمون‌های پشتیبانی‌نشده، آزمون‌های حل‌نشده و آزمون‌های ساختگی (stub) که صرفاً
     خود را آزمایش‌نشده اعلام می‌کنند، شمارش می‌کنند.

   همان مثال پس از افزودن آزمون‌ها برای dejagnu-report-card
     $ 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
                        \__________________________________________________

     ابزار ‘report-card’ اضافه شده است، با سه مرحله، یکی برای هر پیاده‌سازی.
     (پیاده‌سازی‌های shell و Tcl بعداً برای کاهش بار نگهداری در آینده کنار گذاشته
     شدند.) مانند قبل، تمام آزمون‌ها طبق انتظار با موفقیت سپری شدند. تفاوت جالب
     نسبت به مثال قبل، استفاده از قابلیت آزمون چندمرحله‌ای (multipass) در
     DejaGnu و اضافه شدن خطوط خلاصهٔ مجزا برای هر مرحله است. در این مثال، تنها
     ابزار ‘report-card’ از آزمون چندمرحله‌ای استفاده می‌کند، بنابراین مجموع هر
     مرحله صرفاً تعداد آزمون‌های مربوط به ‘report-card’ است، نه یک مجموع
     تفکیک‌شدهٔ جداگانه.

     همچنین توجه داشته باشید دستوری که برای فراخوانی dejagnu report card
     استفاده شده در اینجا کمی متفاوت است. راه‌انداز dejagnu(1) کلمات متعددی را
     که با خط تیره به یک آرگومان واحد متصل شده‌اند نیز می‌پذیرد. این قابلیت
     اجازه می‌دهد کلمات مجزا در نام یک دستور، در خط فرمان به جای یکدیگر با خط
     تیره یا فاصله از هم جدا شوند.

همچنین ببینید (SEE ALSO)
     dejagnu(1) runtest(1)

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

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

GNU                            December 31, 2018                           GNU