'\"macro stdmacro
.\"
.\" Copyright (c) 2015,2019 Red Hat.
.\"
.\" 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 PCP-PYTHON 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
\f3pcp-python\f1 \- اجرای اسکریپت python با استفاده از نگارش ترجیحی python
.SH "خلاصه دستور (SYNOPSIS)"
\f3pcp\f1
\f3python\f1 [\f2SCRIPT\f1 [\f2ARG\f1] ...]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pcp-python
با
.BR pmpython (1)
جایگزین شده است که استفاده از آن ارجحیت دارد؛ با این حال
.B pcp-python
همچنان برای حفظ سازگاری رو به عقب (backwards compatibility) نصب می‌شود.
.PP
دستور
.B pcp-python
روشی را برای اجرای اسکریپت‌های python با استفاده از یک فایل باینری قابل‌شخصی‌سازی python به جای گنجاندن یک نسخه خاص از python در درون هر اسکریپت فراهم می‌کند.
.PP
این قابلیت می‌تواند مفید باشد چرا که اجازه می‌دهد کدهای python مستقل از نسخه در هر جایی اجرا شوند.
تمام ماژول‌های python ارائه‌شده همراه با PCP از نسخه ۲.۶ و بالاتر (در سری python2) و نسخه ۳.۳ و بالاتر (در سری انتشارهای python3) پشتیبانی می‌کنند.
.PP
از آنجا که اسکریپت‌های پایش و جمع‌آوری python در PCP نسبتاً ساده هستند (و به ماژول‌های جدید، ویژگی‌های تازه زبان و غیره نیازی ندارند)، اطمینان یافتن از عملکرد صحیح آن‌ها برای تمام نسخه‌های python ذکرشده در بالا ممکن شده است.
بنابراین، در اسکریپت‌های python مربوط به PCP معمول است که از خط «shebang» برای فراخوانی
.B pcp-python
به صورت زیر استفاده شود:
.PP
.in 1.0i
.ft CR
.nf
.I "#!/usr/bin/pcp python"
.fi
.ft R
.in
.PP
این امر اجازه می‌دهد تا به جای استفاده از یک نسخه ثابت و کدگذاری‌شده (hard-coded) برای python، تنظیمات سفارشی تزریق شوند، در حالی که کاربر همچنان می‌تواند نسخه python را به روش زیر بازنویسی کند:
.PP
.in 1.0i
.ft CR
.nf
.B "$ PCP_PYTHON_PROG=python3 /usr/bin/pcp python --version"
Python 3.3.2
.B "$ PCP_PYTHON_PROG=python2 /usr/bin/pcp python --version"
Python 2.7.5
.fi
.ft R
.in
.PP
این روش برای انتشار اسکریپت‌های یکسان بر روی چندین پلتفرم، و برای آزمایش نسخه‌های مختلف python با یک اسکریپت یکسان بسیار مناسب است (برای نمونه در شرایطی که چندین نسخه از python نصب شده باشد، می‌توان PCP_PYTHON_PROG را در محیط محلی مقداردهی کرد تا تنظیمات سراسری را بازنویسی کند).
.PP
به طور پیش‌فرض، مقدار متغیر PCP_PYTHON_PROG از فایل
.I /etc/pcp.conf
استفاده خواهد شد.
مقدار پیش‌فرض این پارامتر پیکربندی بسته به برخی سنجش‌های مکاشفه‌ای (heuristics) درباره پلتفرم ساخت هدف تعیین می‌شود.
این ارزیابی‌ها در تمامی انتشارهای اخیر PCP، استفاده از
.I python3
را برای پلتفرم‌هایی که از آن پشتیبانی می‌کنند، در اولویت قرار می‌دهند.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای پارامتربندی نام فایل‌ها و دایرکتوری‌های مورد استفاده توسط PCP به کار می‌روند.
در هر نصب، فایل \fI/etc/pcp.conf\fP حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP می‌تواند برای مشخص کردن یک فایل پیکربندی جایگزین استفاده شود، همان‌طور که در \fBpcp.conf\fP(5) شرح داده شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)
و
.BR pcp (1).