.\" generated with Ronn-NG/v0.10.1
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
.TH "PUPPET\-PARSER" "8" "January 2025" "Vox Pupuli" "OpenVox manual"
.SH "نام (NAME)"
puppet-parser \- تعامل مستقیم با تجزیه‌کننده (parser)
.SH "خلاصه دستور (SYNOPSIS)"
puppet parser \fIaction\fR
.SH "گزینه‌ها (OPTIONS)"
توجه داشته باشید که هر پیکربندی معتبر در فایل پیکربندی، به عنوان یک آرگومان بلند نیز معتبر است، هرچند ممکن است به اقدام فعلی مرتبط باشد یا نباشد\. برای نمونه، \fBserver\fR و \fBrun_mode\fR تنظیمات معتبری هستند، بنابراین می‌توانید \fB\-\-server <servername>\fR یا \fB\-\-run_mode <runmode>\fR را به عنوان آرگومان مشخص کنید\.
.P
برای فهرست کامل پارامترهای قابل قبول، مستندات فایل پیکربندی را در نشانی <https://puppet.com/docs/puppet/latest/configuration.html> مشاهده کنید\. همچنین می‌توان فهرستی همراه با توضیح از تمام گزینه‌های پیکربندی را با اجرای puppet به همراه گزینه \fB\-\-genconfig\fR تولید کرد\.
.TP
\-\-render\-as FORMAT
قالب نمایش خروجی\. رایج‌ترین قالب‌ها عبارتند از \fBjson\fR، \fBs\fR (رشته)، \fByaml\fR و \fBconsole\fR، اما گزینه‌های دیگری مانند \fBdot\fR نیز گاهی در دسترس هستند\.
.TP
\-\-verbose
آیا گزارش‌ها با جزئیات کامل ثبت شوند یا خیر\.
.TP
\-\-debug
آیا اطلاعات اشکال‌زدایی ثبت شوند یا خیر\.
.SH "اقدامات (ACTIONS)"
.IP "\(bu" 4
\fBdump\fR \- خروجی گرفتن از درخت تجزیه داخلی برای اشکال‌زدایی: \fBSYNOPSIS\fR
.IP
puppet parser dump [\-\-e \fIsource\fR] [\-\-[no\-]validate] [\-\-format \fIold, pn, or json\fR] [\-\-pretty] [\-\-format \fIold|pn|json\fR] [\-\-pretty] { \-e \fIsource\fR | [\fItemplates\fR \|\.\|\.\|\.] }
.IP
\fBDESCRIPTION\fR
.IP
این اقدام ساختار نحوی Puppet DSL را بدون کامپایل کاتالوگ یا همگام‌سازی هیچ منبعی، تجزیه و اعتبارسنجی می‌کند\.
.IP
قالب خروجی را می‌توان با استفاده از \-\-format \fIold|pn|json\fR کنترل کرد که در آن:
.IP "\(bu" 4
مقدار 'old' پیش‌فرض است، اما اکنون منسوخ شده و جزو API نیست\.
.IP "\(bu" 4
مقدار 'pn' نمادگذاری بیان نمادین گسترش‌یافته پاپت (Puppet Extended S\-Expression Notation) است\.
.IP "\(bu" 4
مقدار 'json' همان نمودار 'pn' را اما با نحو JSON خروجی می‌دهد\.
.IP "" 0
.IP
هنگامی که گزینه \-\-pretty همراه با \-\-format 'pn' یا 'json' داده شود، خروجی به‌صورت «خوانا» (pretty printed) خواهد بود\. این گزینه روی قالب 'old' بی‌تأثیر است\.
.IP
این دستور یک یا چند فایل مانیفست (\.pp) یا یک \-e به همراه متن منبع پاپت را می‌پذیرد\. اگر آرگومانی ارائه نشود، ورودی استاندارد (stdin) خوانده می‌شود (مگر اینکه به یک ترمینال متصل باشد)\.
.IP
قالب خروجی درخت استخراج‌شده برای اهداف اشکال‌زدایی در نظر گرفته شده است و جزو API نیست، بنابراین ممکن است هر از چند گاهی تغییر کند\.
.IP
\fBOPTIONS\fR \fI\-\-e <source\fR> \- استخراج یک عبارت منبع داده‌شده در خط فرمان\.
.IP
\fI\-\-format <old, pn, or json\fR> \- دریافت نتیجه در قالب‌های 'old' (قالب منسوخ‌شده)، 'pn' (قالب جدید) یا 'json' (قالب جدید در JSON)\.
.IP
\fI\-\-pretty\fR \- چاپ خوانای خروجی\. تنها همراه با \-\-format pn یا json قابل استفاده است\.
.IP
\fI\-\-[no\-]validate\fR \- اعتبارسنجی یا عدم اعتبارسنجی نتیجه تجزیه‌شده؛ در صورت استفاده از no\-validate تنها خطاهای نحوی گزارش می‌شوند\.
.IP
\fBRETURNS\fR
.IP
خروجی مدل AST حاصل، مگر اینکه خطاهای نحوی یا اعتبارسنجی وجود داشته باشد\.
.IP "\(bu" 4
\fBvalidate\fR \- اعتبارسنجی نحو یک یا چند مانیفست پاپت: \fBSYNOPSIS\fR
.IP
puppet parser validate [\fImanifest\fR] [\fImanifest\fR \|\.\|\.\|\.]
.IP
\fBDESCRIPTION\fR
.IP
این اقدام نحو Puppet DSL را بدون کامپایل کاتالوگ یا همگام‌سازی هیچ منبعی اعتبارسنجی می‌کند\. اگر هیچ فایل مانیفستی ارائه نشود، مانیفست پیش‌فرض سایت را اعتبارسنجی خواهد کرد\.
.IP
هنگام اعتبارسنجی، چندین مورد اشکال در هر فایل تا سقف تنظیمات max_error و max_warnings گزارش می‌شود\. پردازش پس از گزارش اشکالات اولین فایل دارای خطا متوقف می‌شود\.
.IP
\fBRETURNS\fR
.IP
هیچ چیز، یا اولین خطای نحوی مشاهده‌شده\.
.IP "" 0
.SH "مثال‌ها (EXAMPLES)"
\fBvalidate\fR
.P
اعتبارسنجی مانیفست پیش‌فرض سایت در /etc/puppetlabs/puppet/manifests/site\.pp:
.P
$ puppet parser validate
.P
اعتبارسنجی دو فایل مانیفست دلخواه:
.P
$ puppet parser validate init\.pp vhost\.pp
.P
اعتبارسنجی از STDIN:
.P
$ cat init\.pp | puppet parser validate
.SH "حق نشر و مجوز (COPYRIGHT AND LICENSE)"
Copyright 2014 by Puppet Inc\., Vox Pupuli Apache 2 license; see COPYING