.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "AUGPARSE 1"
.TH AUGPARSE 1 2020-09-09 "Augeas 1.14.1" Augeas
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
augparse \- اجرای یک پودمان Augeas
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "خلاصه دستور (SYNOPSIS)"
augparse [گزینه‌ها] MODULE
.SH "توضیحات (DESCRIPTION)"
.IX Header "توضیحات (DESCRIPTION)"
اجرای یک پودمان Augeas، اغلب برای ارزیابی آزمون‌های موجود در آن به کار می‌رود.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "گزینه‌ها (OPTIONS)"
.IP "\fB\-I\fR, \fB\-\-include\fR=\fIDIR\fR" 4
.IX Item "-I, --include=DIR"
افزودن DIR به مسیر بارگذاری پودمان. می‌تواند چند بار تکرار شود. شاخه‌های مشخص‌شده در اینجا قبل از شاخه‌های تعیین‌شده در متغیر محیطی AUGEAS_LENS_LIB و قبل از شاخه پیش‌فرض \fI/usr/share/augeas/lenses\fR جستجو می‌شوند.
.IP "\fB\-t\fR, \fB\-\-trace\fR" 4
.IX Item "-t, --trace"
چاپ ردگیری (trace) پودمان‌هایی که در حال بارگذاری هستند.
.IP \fB\-\-nostdinc\fR 4
.IX Item "--nostdinc"
شاخه‌های پیش‌فرض را برای پودمان‌ها جستجو نکن. در صورت فعال بودن این گزینه، تنها شاخه‌هایی که صراحتاً با \fB\-I\fR مشخص شده‌اند یا در متغیر محیطی \fBAUGEAS_LENS_LIB\fR آمده‌اند بررسی می‌شوند.
.IP \fB\-\-notypecheck\fR 4
.IX Item "--notypecheck"
بررسی نوع (type check) لنزها را انجام نده. فقط در زمان توسعه لنز از این گزینه استفاده کنید و مطمئن شوید پس از پایان توسعه، بررسی نوع انجام شود؛ هرگز نباید از لنزی که بررسی نوع نشده استفاده کرد. این گزینه گاهی هنگام کار بر روی آزمون‌های واحد برای یک لنز جهت افزایش سرعت اجرای مکرر آزمون‌ها مفید است.
.IP \fB\-\-version\fR 4
.IX Item "--version"
چاپ اطلاعات نگارش و خروج.
.IP \fB\-h\fR 4
.IX Item "-h"
نمایش این راهنما و خروج.
.SH "مثال‌ها (EXAMPLES)"
.IX Header "مثال‌ها (EXAMPLES)"
برای اجرای آزمون‌ها در \fIlenses/tests/test_foo.aug\fR و استفاده از پودمان‌های شاخه \fIlenses\fR، دستور زیر را اجرا کنید:
.Sp
.RS 4
augparse \-I lenses lenses/tests/test_foo.aug
.RE
.SH "آزمون‌ها (TESTS)"
.IX Header "آزمون‌ها (TESTS)"
آزمون‌ها می‌توانند به صورت ساختارهای سطح بالا در هر کجای یک پودمان قرار گیرند. معمولاً، آزمون‌های یک پودمان \fIlenses/foo.aug\fR در یک پرونده جداگانه، عموماً در \fIlenses/tests/test_foo.aug\fR نگهداری می‌شوند.
.PP
دو نوع آزمون مختلف وجود دارد که Augeas می‌تواند اجرا کند: آزمون‌های \fBget\fR و \fBput\fR. نحو آزمون‌های \fBget\fR به این صورت است:
.Sp
.RS 4
test LENS get STRING = RESULT
.RE
.PP
که جهت \fIget\fR از لنز LENS را روی رشته STRING اعمال کرده و آن را با RESULT مشخص‌شده مقایسه می‌کند. مقدار RESULT می‌تواند یک درخت، نماد \fB?\fR برای چاپ نتیجه اعمال LENS روی STRING، یا نماد \fB*\fR برای نشان دادن ایجاد یک استثناء توسط آزمون باشد.
.PP
نحو آزمون‌های \fBput\fR به این صورت است:
.Sp
.RS 4
test LENS put STRING after COMMANDS = RESULT
.RE
.PP
که ابتدا جهت \fIget\fR از لنز LENS را روی STRING اعمال می‌کند، سپس COMMANDS را روی درخت حاصل پیاده می‌کند، و در نهایت درخت تغییریافته را با استفاده از جهت \fIput\fR از LENS به رشته تبدیل می‌کند. رشته حاصل سپس با RESULT مقایسه می‌شود که می‌تواند یک رشته، نماد \fB?\fR برای چاپ نتیجه اعمال LENS روی STRING، یا نماد \fB*\fR برای نشان دادن ایجاد استثناء باشد.
.SH "نویسنده (AUTHOR)"
.IX Header "نویسنده (AUTHOR)"
David Lutterkort <lutter@watzmann.net>
.SH "حق نشر و مجوز (COPYRIGHT AND LICENSE)"
.IX Header "حق نشر و مجوز (COPYRIGHT AND LICENSE)"
حق نشر ۲۰۰۷\-۲۰۱۶ David Lutterkort
.PP
نرم‌افزار Augeas (و augparse) تحت مجوز عمومی کلی کمتر گنو (LGPL) منتشر شده‌اند.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "همچنین ببینید (SEE ALSO)"
صفحه خانگی پروژه \fBAugeas\fR در نشانی <http://www.augeas.net/>
.PP
augtool