نام (NAME)

ct_run - اجرای چارچوب Common Test از خط فرمان سیستم‌عامل

توضیحات (DESCRIPTION)

برنامه ct_run به صورت خودکار به همراه Erlang/OTP و برنامه کاربردی Common Test نصب می‌شود (برای اطلاعات بیشتر، بخش Installation را در User's Guide ببینید). این برنامه فلگ‌های شروع متعددی را می‌پذیرد. برخی از فلگ‌ها موجب می‌شوند ct_run برنامه Common Test را راه‌اندازی کرده و داده‌ها را به آن منتقل کند. برخی دیگر از فلگ‌ها یک گره (نود) ارلنگ آماده‌شده برای اجرای Common Test در حالتی خاص را آغاز می‌نمایند.

تابع رابط ct:run_test/1، متناظر با برنامه ct_run، برای اجرای Common Test از شل ارلنگ (یا از یک برنامه ارلنگ) استفاده می‌شود. برای جزئیات، صفحه راهنمای ct را ببینید.

برنامه ct_run همچنین فلگ‌های شبیه‌ساز ارلنگ (Erlang emulator) را می‌پذیرد. این فلگ‌ها زمانی به کار می‌روند که ct_run دستور erl را برای راه‌اندازی گره ارلنگ فراخوانی می‌کند (این امر افزودن دایرکتوری‌ها به مسیر سرور کد، تغییر کوکی در گره، آغاز برنامه‌های بیشتر و مواردی از این دست را ممکن می‌سازد).

با استفاده از فلگ اختیاری -erl_args، گزینه‌های موجود در خط فرمان ct_run می‌توانند به دو گروه تقسیم شوند:

•یک گروه که Common Test باید آن‌ها را پردازش کند (آن‌هایی که پیش از -erl_args قرار دارند).

•یک گروه که Common Test باید آن‌ها را نادیده گرفته و مستقیماً به شبیه‌ساز ارسال کند (آن‌هایی که پس از -erl_args قرار دارند).

گزینه‌های قبل از -erl_args که توسط Common Test شناسایی نمی‌شوند نیز بدون تغییر به شبیه‌ساز منتقل می‌گردند. با کمک -erl_args کاربر می‌تواند فلگ‌هایی با نام یکسان اما با مقصدهای متفاوت در خط فرمان ct_run مشخص کند.

اگر فلگ‌های -pa یا -pz در گروه گزینه‌های Common Test (قبل از -erl_args) مشخص شوند، دایرکتوری‌های نسبی به دایرکتوری‌های مطلق تبدیل شده و توسط Common Test مجدداً به مسیر کد اضافه می‌شوند. این کار به منظور جلوگیری از بروز مشکل در بارگذاری ماژول‌های کاربر هنگام تغییر دایرکتوری کاری توسط Common Test در طول اجرای آزمون‌ها انجام می‌شود. با این حال، Common Test فلگ‌های -pa و -pz پس از -erl_args در خط فرمان را نادیده می‌گیرد. این دایرکتوری‌ها به صورت عادی (به همان فرمت تعیین‌شده) به مسیر کد افزوده می‌شوند.

وضعیت خروج (Exit status) پیش از خاتمه برنامه تنظیم می‌شود. مقدار 0 نشان‌دهنده موفقیت‌آمیز بودن نتیجه آزمون، مقدار 1 نشان‌دهنده شکست یا رد شدن خودکار (auto-skip) یک یا چند مورد آزمون، و مقدار 2 نشان‌دهنده بروز خطا در روند اجرای آزمون است.

اگر ct_run با گزینه -help فراخوانی شود، تمام گزینه‌های معتبر شروع را در stdout چاپ می‌کند.

اجرای آزمون‌ها از خط فرمان (Run Tests from Command Line)

ct_run -dir TestDir1 TestDir2 .. TestDirN |
 [-dir TestDir] -suite Suite1 Suite2 .. SuiteN
 [-group Groups1 Groups2 .. GroupsN] [-case Case1 Case2 .. CaseN]
 [-step [config | keep_inactive]]
 [-config ConfigFile1 ConfigFile2 .. ConfigFileN]
 [-userconfig CallbackModule1 ConfigString1 and CallbackModule2
  ConfigString2 and .. CallbackModuleN ConfigStringN]
 [-decrypt_key Key] | [-decrypt_file KeyFile]
 [-label Label]
 [-logdir LogDir]
 [-logopts LogOpts]
 [-verbosity GenVLevel | [Category1 VLevel1 and
  Category2 VLevel2 and .. CategoryN VLevelN]]
 [-silent_connections [ConnType1 ConnType2 .. ConnTypeN]]
 [-stylesheet CSSFile]
 [-cover CoverCfgFile]
 [-cover_stop Bool]
 [-event_handler EvHandler1 EvHandler2 .. EvHandlerN] |
 [-event_handler_init EvHandler1 InitArg1 and
  EvHandler2 InitArg2 and .. EvHandlerN InitArgN]
 [-include InclDir1 InclDir2 .. InclDirN]
 [-no_auto_compile]
 [-abort_if_missing_suites]
 [-multiply_timetraps Multiplier]
 [-scale_timetraps]
 [-create_priv_dir auto_per_run | auto_per_tc | manual_per_tc]
 [-repeat N] |
 [-duration HHMMSS [-force_stop [skip_rest]]] |
 [-until [YYMoMoDD]HHMMSS [-force_stop [skip_rest]]]
 [-basic_html]
 [-no_esc_chars]
 [-keep_logs all | NLogs]
 [-ct_hooks CTHModule1 CTHOpts1 and CTHModule2 CTHOpts2 and ..
  CTHModuleN CTHOptsN]
 [-ct_hooks_order test | config]
 [-exit_status ignore_config]
 [-help]

اجرای آزمون‌ها با مشخصات آزمون (Run Tests using Test Specification)

ct_run -spec TestSpec1 TestSpec2 .. TestSpecN
 [-join_specs]
 [-config ConfigFile1 ConfigFile2 .. ConfigFileN]
 [-userconfig CallbackModule1 ConfigString1 and CallbackModule2
  ConfigString2 and .. and CallbackModuleN ConfigStringN]
 [-decrypt_key Key] | [-decrypt_file KeyFile]
 [-label Label]
 [-logdir LogDir]
 [-logopts LogOpts]
 [-verbosity GenVLevel | [Category1 VLevel1 and
  Category2 VLevel2 and .. CategoryN VLevelN]]
 [-allow_user_terms]
 [-silent_connections [ConnType1 ConnType2 .. ConnTypeN]]
 [-stylesheet CSSFile]
 [-cover CoverCfgFile]
 [-cover_stop Bool]
 [-event_handler EvHandler1 EvHandler2 .. EvHandlerN] |
 [-event_handler_init EvHandler1 InitArg1 and
  EvHandler2 InitArg2 and .. EvHandlerN InitArgN]
 [-include InclDir1 InclDir2 .. InclDirN]
 [-no_auto_compile]
 [-abort_if_missing_suites]
 [-multiply_timetraps Multiplier]
 [-scale_timetraps]
 [-create_priv_dir auto_per_run | auto_per_tc | manual_per_tc]
 [-repeat N] |
 [-duration HHMMSS [-force_stop [skip_rest]]] |
 [-until [YYMoMoDD]HHMMSS [-force_stop [skip_rest]]]
 [-basic_html]
 [-no_esc_chars]
 [-keep_logs all | NLogs]
 [-ct_hooks CTHModule1 CTHOpts1 and CTHModule2 CTHOpts2 and ..
  CTHModuleN CTHOptsN]
 [-ct_hooks_order test | config]
 [-exit_status ignore_config]

تازه‌سازی فایل‌های ایندکس HTML (Refresh HTML Index Files)

ct_run -refresh_logs [-logdir LogDir] [-basic_html]
 [-keep_logs all | NLogs]

اجرای Common Test در حالت تعاملی (Run Common Test in Interactive Mode)

ct_run -shell
 [-config ConfigFile1 ConfigFile2 ... ConfigFileN]
 [-userconfig CallbackModule1 ConfigString1 and CallbackModule2
  ConfigString2 and .. and CallbackModuleN ConfigStringN]
 [-decrypt_key Key] | [-decrypt_file KeyFile]

راه‌اندازی گره ارشد Common Test (Start a Common Test Master Node)

ct_run -ctmaster

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

برای کسب اطلاعات درباره فلگ‌های شروع، بخش Running Tests and Analyzing Results را در User's Guide مطالعه کنید.

common_test 1.31.1

Ericsson AB