نام (NAME)

pas2ut - ابزار تبدیل یونیت Free Pascal به مورد آزمون واحد (unit test case)

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

pas2ut [گزینه‌ها] inputfile [outputfile]

توضیحات (DESCRIPTION)

دستور pas2ut فایل ورودی را برای یافتن کلاس‌ها و روتین‌ها پویش کرده و برای تمام کلاس‌ها و روتین‌های یافت‌شده در بخش interface فایل، یک مورد آزمون (testcase) می‌سازد. این ابزار می‌تواند یک یونیت یا یک فایل include تولید کند. تمام آزمون‌ها با یک پیام شکست (fail) استاندارد ایجاد می‌شوند. به‌طور پیش‌فرض، تنها برای اعضای public، published و اعضای با سطح دسترسی پیش‌فرض کلاس‌ها آزمون تولید می‌شود.

نحوه استفاده (USAGE)

دستور pas2ut در حال حاضر گزینه‌های زیر را می‌پذیرد:

--defaultclasstest=list: فهرستی جداشده با کاما از آزمون‌های پیش‌فرض را برای هر کلاس مشخص می‌کند. عناصر موجود در فهرست باید شناسه‌های معتبر پاسکال باشند.
--failmessage=Msg: پیام مربوط به عبارت Fail() درون هر متد آزمون را تنظیم می‌کند.
--limit=list: فهرستی جداشده با کاما از شناسه‌های سراسری را که باید برای آن‌ها آزمون تولید شود مشخص می‌کند. به‌طور پیش‌فرض، برای تمام شناسه‌های سراسری در بخش interface یک یونیت، آزمون تولید می‌شود.
--prefix=name: پیشوند نام‌های آزمون را تعیین می‌کند (پیش‌فرض Test است). هر آزمون بر اساس شناسه‌ای که آن را می‌آزماید، همراه با این پیشوند نام‌گذاری می‌شود.
--singletestclass: برای هر کلاس یافت‌شده از یک کلاس آزمون واحد استفاده می‌کند. حالت پیش‌فرض، ساخت یک کلاس testcase به ازای هر کلاس در یونیت ورودی است.
--skip-classes: برای کلاس‌ها کد آزمون تولید نمی‌کند، فقط برای توابع و رویه‌ها کد آزمون می‌سازد.
--skip-declaration: اعلان‌ها را برای آزمون‌ها تولید نمی‌کند، فقط پیاده‌سازی‌ها را ایجاد می‌کند.
--skip-default: از آزمون‌های مربوط به اعضای با سطح دسترسی پیش‌فرض صرف‌نظر می‌کند. به‌طور پیش‌فرض، این موارد به همراه اعضای public یا published تولید می‌شوند.
--skip-fail: عبارت‌های fail() را در پیاده‌سازی روتین‌های آزمون ایجاد نمی‌کند.
--skip-fields: برای فیلدهای کلاس‌ها مورد آزمون تولید نمی‌کند (تنها برای متدها و خصوصیت‌ها تولید می‌کند).
--skip-functions: برای توابع/رویه‌ها آزمون تولید نمی‌کند، فقط برای کلاس‌ها تولید می‌کند.
--skip-implementation: پیاده‌سازی (خالی) برای آزمون‌ها تولید نمی‌کند؛ تنها اعلان کلاس تولید می‌شود. (می‌توان آن را در یک IDE مانند Lazarus یا MSIDE تکمیل کرد)
--skip-methods: برای متدهای کلاس‌ها آزمون تولید نمی‌کند، فقط برای فیلدها و خصوصیت‌ها تولید می‌کند.
--skip-properties: برای خصوصیت‌های کلاس‌ها آزمون تولید نمی‌کند، فقط برای فیلدها و متدها تولید می‌کند.
--skip-property-default: برای هر خصوصیت، یک آزمون پیش‌فرض تولید نمی‌کند.
--skip-public: از آزمون‌ها برای اعضای public صرف‌نظر می‌کند؛ در صورتی که --test-protected فعال باشد، تنها اعضای protected آزمایش خواهند شد.
--skip-published: برای اعضای published آزمون تولید نمی‌کند؛ فقط اعضای public و پیش‌فرض آزمایش خواهند شد.
--skip-register: عبارت RegisterTests را تولید نمی‌کند.
--skip-setup: متد TTestCase.Setup() را در کلاس تولیدشده بازنویسی (override) نمی‌کند.
--skip-teardown: متد TTestCase.TearDown() را در کلاس تولیدشده بازنویسی (override) نمی‌کند.
--skip-unit: یک یونیت تولید نمی‌کند، تنها یک فایل include تولید می‌کند.
--testparentname=name: نام کلاس والد را برای کلاس‌های آزمون تولیدشده تنظیم می‌کند. پیش‌فرض TTestCase است؛ از این گزینه می‌توان برای تعیین نام کلاسی دیگر استفاده کرد.
--test-property-bounds: یک آزمون GetBounds برای هر خصوصیت تولید می‌کند.
--test-property-maxlen: یک آزمون MaxLen برای هر خصوصیت تولید می‌کند.
--test-property-notify: یک آزمون Notify برای هر خصوصیت تولید می‌کند.
--test-property-required: یک آزمون Required برای هر خصوصیت تولید می‌کند.
--test-protected: برای اعضای protected کلاس نیز آزمون تولید می‌کند. به‌طور پیش‌فرض، آزمون‌ها تنها برای اعضای public، published و اعضای با سطح دسترسی پیش‌فرض تولید می‌شوند.
--testunitname=name: نام یونیت تولیدشده را تعیین می‌کند (پیش‌فرض از روی نام فایل خروجی گرفته می‌شود).
--tiopf: آزمون‌های tiopf را ایجاد می‌کند (این کار معادل تعیین آزمون‌های --default، --bounds، --required، --notify و --maxlen است).
--unittestclassname=name: نام سراسری کلاس آزمون واحد را تنظیم می‌کند. برای استفاده همراه با --singletestclass. گزینه‌های --limit و --defaultclasstest می‌توانند چندین بار مشخص شوند.

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

: fpc(1)