.TH pas2ut 1 "5 سپتامبر 2015" "Free Pascal" "ابزار ساخت آزمون واحد Free Pascal"
.SH "نام (NAME)"
pas2ut \- ابزار تبدیل یونیت Free Pascal به مورد آزمون واحد (unit test case)

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

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

.SH "توضیحات (DESCRIPTION)"

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

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

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

.TP
.B
\-\-unittestclassname=name 
نام سراسری کلاس آزمون واحد را تنظیم می‌کند. برای استفاده همراه با \-\-singletestclass.
.RE 1
گزینه‌های \-\-limit و \-\-defaultclasstest می‌توانند چندین بار مشخص شوند.

.SH "همچنین ببینید (SEE ALSO)"
.IP 
.BR  fpc (1)