.\" generated with Ronn/v0.7.3
.\" http://github.com/rtomayko/ronn/tree/0.7.3
.
.TH "RUBYTEST" "1" "July 2014" "" ""
.
.SH "نام (NAME)"
\fBrubytest\fR \- اجرای آزمون‌های روبی از طریق رابط برنامه‌نویسی rubytest
.
.SH "توضیحات (DESCRIPTION)"
دستور rubytest یک رابط خط فرمان برای اجرای آزمون‌های چارچوب‌های آزمون مبتنی بر RubyTest است\.
.
.SH "نمای کلی (OVERVIEW)"
ابزار خط فرمان rubytest از بسیاری از قواعد متداول پیروی می‌کند، بنابراین استفاده از آن بسیار ساده است\. گزینهٔ \fB\-h/\-\-help\fR برای مشاهدهٔ جزئیات تمام گزینه‌های آن در دسترس است\. در اینجا یک مثال پایه‌ای از نحوهٔ استفاده آورده شده است\.
.
.IP "" 4
.
.nf

$ rubytest \-Ilib test/*_test\.rb
.
.fi
.
.IP "" 0
.
.P
این دستور \fBlib\fR را به $LOAD_PATH روبی افزوده و سپس تمام فایل‌های آزمون منطبق با الگوی \fBtest/*_test\.rb\fR را بارگذاری می‌کند\.
.
.P
هنگام اجرای آزمون‌ها، باید مطمئن شوید که چارچوب آزمون خود یا تطبیق‌دهندهٔ (adapter) Ruby Test چارچوبتان بارگذاری شده باشد\. این کار معمولاً از طریق یک اسکریپت کمکی درون فایل‌های آزمون انجام می‌شود، اما می‌تواند از طریق گزینه‌های خط فرمان نیز انجام شود؛ مانند:
.
.IP "" 4
.
.nf

$ rubytest \-r lemon \-r ae test/test_*\.rb
.
.fi
.
.IP "" 0
.
.P
مسلماً، نوشتن مکرر چنین دستور طویلی می‌تواند خسته‌کننده شود\. این مسئله را می‌توان از طریق یک فایل پیکربندی حل کرد\. برای بهره‌گیری از این قابلیت، یک فایل \fBetc/test\.rb\fR به پروژه اضافه کرده و مدخل‌های \fBTest\.run\fR (نام مستعاری برای \fBTest\.configure\fR) را در آن قرار دهید\.
.
.IP "" 4
.
.nf

Test\.run do |r|
  r\.loadpath \'lib\'
  r\.test_files << \'test/*_test\.rb\'
end

Test\.run \'coverage\' do |r|
  r\.loadpath \'lib\'
  r\.test_files << \'test/*_test\.rb\'
  r\.before do
    require \'simplecov\'
    Simplecov\.setup do |s|
      s\.filter \'test/\'
      s\.command_name File\.basename($0)
      s\.coverage_dir \'log/coverage\'
    end
    # to ensure proper coverage
    require \'myapp\'
  end
end
.
.fi
.
.IP "" 0
.
.P
اکنون هنگام استفاده از rubytest، اولین پیکربندی اعمال خواهد شد\. برای استفاده از پیکربندی \'coverage\' از گزینهٔ \fB\-p/\-\-profile\fR استفاده کنید\.
.
.IP "" 4
.
.nf

$ rubytest \-p coverage
.
.fi
.
.IP "" 0
.
.P
به این ترتیب، یک پروژه می‌تواند چندین پیکربندی آزمون مختلف داشته باشد و انتخاب میان آن‌ها آسان خواهد بود\.
.
.P
توجه داشته باشید که در مثال بالا می‌شد به‌جای \fBTest\.run\fR از \fBTest\.configure\fR استفاده کرد؛ هر دوی آن‌ها عملکرد یکسانی دارند\. اما از \fBTest\.run!\fR استفاده نکنید، زیرا موجب اجرای فوری آزمون‌ها می‌شود\.
.
.P
فایل پیکربندی می‌تواند به‌جای \fBetc\fR در دایرکتوری \fBconfig\fR قرار گیرد که برای پروژه‌های Rails بسیار مناسب است\. اما اگر ترجیح می‌دهید فایلی در ریشهٔ پروژه داشته باشید، می‌توانید به‌جای آن از \fBTestfile\fR یا \fB\.test\fR نیز استفاده کنید\. تمامی این مکان‌ها صرفاً به این دلیل پشتیبانی می‌شوند که هیچ قرارداد پیکربندی واحدی در جامعهٔ روبی تثبیت نشده است\. با این وجود، ما استفاده از \fBetc/test\.rb\fR را اکیداً توصیه می‌کنیم؛ در نهایت به نظر می‌رسد این بهترین قرارداد کلی باشد\.
.
.SH "نحوه استفاده (USAGE)"
.
.nf

rubytest [options] [files \.\.\.]
.
.fi
.
.SH "گزینه‌ها (OPTIONS)"
.
.IP "\(bu" 4
\fB\-p\fR \fB\-\-profile <NAME>\fR استفاده از نمایهٔ پیکربندی\.
.
.IP "\(bu" 4
\fB\-f\fR \fB\-\-format <NAME>\fR قالب گزارش\.
.
.IP "\(bu" 4
\fBy\fR \fB\-\-tapy\fR میان‌بر برای \-f tapy\.
.
.IP "\(bu" 4
\fB\-j\fR \fB\-\-tapj\fR میان‌بر برای \-f tapj\.
.
.IP "\(bu" 4
\fB\-t\fR \fB\-\-tag <TAG>\fR انتخاب آزمون‌ها بر اساس برچسب\.
.
.IP "\(bu" 4
\fB\-u\fR \fB\-\-unit <TAG>\fR انتخاب آزمون‌ها بر اساس واحد نرم‌افزاری\.
.
.IP "\(bu" 4
\fB\-m\fR \fB\-\-match <TEXT>\fR انتخاب آزمون‌ها بر اساس شرح/توضیحات\.
.
.IP "\(bu" 4
\fB\-A\fR \fB\-\-autopath\fR افزودن خودکار مسیرها به $LOAD_PATH\.
.
.IP "\(bu" 4
\fB\-I\fR \fB\-\-loadpath <PATH>\fR افزودن مسیر داده‌شده به $LOAD_PATH\.
.
.IP "\(bu" 4
\fB\-C\fR \fB\-\-chdir <DIR>\fR تغییر دایرکتوری پیش از اجرای آزمون‌ها\.
.
.IP "\(bu" 4
\fB\-R\fR \fB\-\-chroot\fR تغییر به دایرکتوری ریشهٔ پروژه پیش از اجرای آزمون‌ها\.
.
.IP "\(bu" 4
\fB\-r\fR \fB\-\-require <FILE>\fR بارگذاری فایل مورد نیاز (require)\.
.
.IP "\(bu" 4
\fB\-c\fR \fB\-\-config <FILE>\fR استفاده از فایل پیکربندی جایگزین\.
.
.IP "\(bu" 4
\fB\-V\fR \fB\-\-verbose\fR ارائهٔ جزئیات بیشتر در گزارش‌ها\.
.
.IP "\(bu" 4
\fB\-\-[no\-]ansi\fR فعال/غیرفعال کردن رنگ‌های ANSI\.
.
.IP "\(bu" 4
\fB\-\-debug\fR فعال کردن حالت اشکال‌زدایی\.
.
.IP "\(bu" 4
\fB\-\-about\fR نمایش اطلاعاتی دربارهٔ rubytest\.
.
.IP "\(bu" 4
\fB\-\-version\fR نمایش نسخهٔ rubytest\.
.
.IP "\(bu" 4
\fB\-h\fR \fB\-\-help\fR نمایش این پیام راهنما\.
.
.IP "" 0
.
.SH "منابع (RESOURCES)"
.
.IP "\(bu" 4
وبگاه \fIhttp://rubyworks\.github\.com/rubytest\-cli\fR
.
.IP "\(bu" 4
پشتیبانی \fIhttp://github\.com/rubyworks/rubytest\-cli/issues\fR
.
.IP "\(bu" 4
توسعه \fIhttp://github\.com/rubyworks/rubytest\-cli\fR
.
.IP "\(bu" 4
 \fIhttp://travis\-ci\.org/rubyworks/rubytest\-cli\fR
.
.IP "\(bu" 4
 \fIhttp://badge\.fury\.io/rb/rubytest\-cli\fR
.
.IP "" 0
.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
نرم‌افزار rubytest یک نرم‌افزار متن‌باز دارای کپی‌رایت است\.
.
.IP "" 4
.
.nf

Copyright (c) 2013 Rubyworks\. All rights reserved\.
.
.fi
.
.IP "" 0
.
.P
این برنامه بر اساس شرایط مجوز BSD\-2\-Clause قابل بازتوزیع و تغییر است\.
.
.SH "همچنین ببینید (SEE ALSO)"
ruby(1)