نام (NAME)

augparse - اجرای یک پودمان Augeas

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

augparse [گزینه‌ها] MODULE

توضیحات (DESCRIPTION)

اجرای یک پودمان Augeas، اغلب برای ارزیابی آزمون‌های موجود در آن به کار می‌رود.

گزینه‌ها (OPTIONS)

-I, --include=DIR: افزودن DIR به مسیر بارگذاری پودمان. می‌تواند چند بار تکرار شود. شاخه‌های مشخص‌شده در اینجا قبل از شاخه‌های تعیین‌شده در متغیر محیطی AUGEAS_LENS_LIB و قبل از شاخه پیش‌فرض /usr/share/augeas/lenses جستجو می‌شوند.
-t, --trace: چاپ ردگیری (trace) پودمان‌هایی که در حال بارگذاری هستند.
--nostdinc: شاخه‌های پیش‌فرض را برای پودمان‌ها جستجو نکن. در صورت فعال بودن این گزینه، تنها شاخه‌هایی که صراحتاً با -I مشخص شده‌اند یا در متغیر محیطی AUGEAS_LENS_LIB آمده‌اند بررسی می‌شوند.
--notypecheck: بررسی نوع (type check) لنزها را انجام نده. فقط در زمان توسعه لنز از این گزینه استفاده کنید و مطمئن شوید پس از پایان توسعه، بررسی نوع انجام شود؛ هرگز نباید از لنزی که بررسی نوع نشده استفاده کرد. این گزینه گاهی هنگام کار بر روی آزمون‌های واحد برای یک لنز جهت افزایش سرعت اجرای مکرر آزمون‌ها مفید است.
--version: چاپ اطلاعات نگارش و خروج.
-h: نمایش این راهنما و خروج.

مثال‌ها (EXAMPLES)

برای اجرای آزمون‌ها در lenses/tests/test_foo.aug و استفاده از پودمان‌های شاخه lenses، دستور زیر را اجرا کنید:

augparse -I lenses lenses/tests/test_foo.aug

آزمون‌ها (TESTS)

آزمون‌ها می‌توانند به صورت ساختارهای سطح بالا در هر کجای یک پودمان قرار گیرند. معمولاً، آزمون‌های یک پودمان lenses/foo.aug در یک پرونده جداگانه، عموماً در lenses/tests/test_foo.aug نگهداری می‌شوند.

دو نوع آزمون مختلف وجود دارد که Augeas می‌تواند اجرا کند: آزمون‌های get و put. نحو آزمون‌های get به این صورت است:

test LENS get STRING = RESULT

که جهت get از لنز LENS را روی رشته STRING اعمال کرده و آن را با RESULT مشخص‌شده مقایسه می‌کند. مقدار RESULT می‌تواند یک درخت، نماد ? برای چاپ نتیجه اعمال LENS روی STRING، یا نماد * برای نشان دادن ایجاد یک استثناء توسط آزمون باشد.

نحو آزمون‌های put به این صورت است:

test LENS put STRING after COMMANDS = RESULT

که ابتدا جهت get از لنز LENS را روی STRING اعمال می‌کند، سپس COMMANDS را روی درخت حاصل پیاده می‌کند، و در نهایت درخت تغییریافته را با استفاده از جهت put از LENS به رشته تبدیل می‌کند. رشته حاصل سپس با RESULT مقایسه می‌شود که می‌تواند یک رشته، نماد ? برای چاپ نتیجه اعمال LENS روی STRING، یا نماد * برای نشان دادن ایجاد استثناء باشد.

نویسنده (AUTHOR)

David Lutterkort <lutter@watzmann.net>

حق نشر و مجوز (COPYRIGHT AND LICENSE)

حق نشر ۲۰۰۷-۲۰۱۶ David Lutterkort

نرم‌افزار Augeas (و augparse) تحت مجوز عمومی کلی کمتر گنو (LGPL) منتشر شده‌اند.

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

صفحه خانگی پروژه Augeas در نشانی http://www.augeas.net/

augtool