'\"macro stdmacro
.\"
.\" Copyright (c) 2016 Ken McDonell.  All Rights Reserved.
.\"
.\" This program is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by the
.\" Free Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
.\" or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" for more details.
.\"
.TH PMPYTHON 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pmpython \- اجرای اسکریپت پایتون با استفاده از مفسر ترجیحی پایتون
.SH "خلاصه دستور (SYNOPSIS)"
\f3pmpython\f1
[\f2python-args-and-script\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pmpython
روشی را برای اجرای اسکریپت‌های پایتون با استفاده از یک مفسر پایتونِ قابل‌سفارشی‌سازی فراهم می‌کند، به‌جای آن‌که نام یک نسخهٔ خاص از پایتون درون هر اسکریپت گنجانده شود.
.PP
این قابلیت می‌تواند مفید باشد چرا که اجازه می‌دهد کدهای پایتونِ مستقل از نسخه در هر مکانی اجرا شوند.
تمامی ماژول‌های پایتونِ ارائه‌شده همراه با PCP از نسخه‌های 2.6 و بالاتر (در سری python2) و 3.3 و بالاتر (در سری نسخه‌های python3) پشتیبانی می‌کنند.
.PP
با توجه به این‌که اسکریپت‌های پایش و جمع‌آوری پایتون در PCP نسبتاً ساده هستند (به ماژول‌های جدید، ویژگی‌های زبانی تازه و غیره نیازی ندارند)، تضمین عملکرد صحیح آن‌ها روی تمامی نسخه‌های پایتونِ ذکرشده در بالا امکان‌پذیر بوده است.
.PP
با این حال، نام مفسر پایتون همیشه یکسان نیست؛ از این رو، معمول است که اسکریپت‌های پایتونِ PCP از یک خط \(lqshebang\(rq برای راه‌اندازی غیرمستقیم مفسر
.B python
به شکل زیر استفاده کنند:
.PP
.in 1.0i
.ft CR
.nf
#!/usr/bin/env pmpython
.fi
.ft
.in
.PP
دستور
.BR env (1)
برای یافتن مسیر صحیح فایل اجرایی
.B pmpython
از متغیر
.BR $PATH
کاربر استفاده می‌شود.
.PP
به‌طور پیش‌فرض، نام مفسر پایتون از مقدار متغیر محیطی
.B $PCP_PYTHON_PROG
(در صورت تنظیم بودن) و در غیر این صورت از فایل
.IR /etc/pcp.conf
به‌دست می‌آید. حالت دوم مورد معمول‌تری است که در آن مقدار بر اساس بررسی‌های اولیه از پلتفرم در زمان ساخت بسته‌های PCP تعیین شده و در تمامی نسخه‌های اخیر PCP (برای پلتفرم‌هایی که از آن پشتیبانی می‌کنند)، استفاده از
.I python3
را ترجیح می‌دهد.
.PP
این سازوکار امکان استفاده از یک نام مناسب را برای مفسر پایتون به‌جای نسخهٔ ثابت و تغییرناپذیر فراهم می‌کند، در حالی که کاربر همچنان می‌تواند مفسر پایتون را به‌صورت زیر بازنویسی کند:
.PP
.in 1.0i
.ft CR
.nf
$ PCP_PYTHON_PROG=python3 pmpython --version
Python 3.4.2
$ PCP_PYTHON_PROG=python2 pmpython --version
Python 2.7.9
.fi
.ft R
.in
.PP
این روش برای ارائهٔ اسکریپت‌های یکسان در پلتفرم‌های گوناگون و همچنین آزمودن نسخه‌های مختلف پایتون با یک اسکریپت واحد بسیار کاربردی است (به‌عنوان مثال در شرایطی که چند نسخه از پایتون نصب است، می‌توان متغیر PCP_PYTHON_PROG را در محیط محلی تنظیم کرد تا بر تنظیمات سراسری اولویت یابد).
.PP
دستور
.B pmpython
جایگزینی برای ابزار قدیمی‌تر با عملکردی مشابه، یعنی
.BR pcp-python (1)
است.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای پارامتریک‌سازی نام فایل‌ها و دایرکتوری‌های مورداستفادهٔ PCP به‌کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP ممکن است برای تعیین یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR env (1)،
.BR pcp (1)،
.BR pcp-python (1)
و
.BR PCPIntro (1).

.\" control lines for scripts/man-spell
.\" +ok+ args