'\" t
.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "PYLINT" "1" "Aug 10, 2026" "4.0" "Pylint"
.SH "نام (NAME)"
pylint \- مستندات Pylint
[تصویر]
 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:actions>[تصویر]
 \%<https://\:codecov\:.io/\:gh/\:pylint-dev/\:pylint>[تصویر: نسخه بسته PyPI]
[تصویر]
 \%<https://\:pypi\:.python\:.org/\:pypi/\:pylint>[تصویر: وضعیت مستندات]
[تصویر]
 \%<https://\:pylint\:.readthedocs\:.io/\:en/\:latest/?\:badge=latest>[تصویر]
 \%<https://\:github\:.com/\:ambv/\:black>[تصویر]
 \%<https://\:github\:.com/\:pylint-dev/\:pylint>[تصویر: وضعیت pre-commit.ci]
[تصویر]
 \%<https://\:results\:.pre-commit\:.ci/\:latest/\:github/\:pylint-dev/\:pylint/\:main>[تصویر: بهترین شیوه‌های CII]
[تصویر]
 \%<https://\:bestpractices\:.coreinfrastructure\:.org/\:projects/\:6328>[تصویر: کارت امتیاز OpenSSF]
[تصویر]
 \%<https://\:api\:.securityscorecards\:.dev/\:projects/\:github\:.com/\:PyCQA/\:pylint>[تصویر: Discord]
[تصویر]
 \%<https://\:discord\:.gg/\:qYxpadCgkx>
.SH "پایلینت چیست؟ (WHAT IS PYLINT?)"
.sp
Pylint یک تحلیل‌گر ایستای کد \%<https://\:en\:.wikipedia\:.org/\:wiki/\:Static_code_analysis> برای Python 2 یا Python 3 است. آخرین نسخه از Python 3.10.0 و بالاتر پشتیبانی می‌کند.
.sp
Pylint کد شما را بدون اجرای واقعی آن تحلیل می‌کند. این ابزار خطاها را بررسی می‌کند، استانداردهای کدنویسی را اعمال می‌نماید، به دنبال بوی کد (code smells) \%<https://\:martinfowler\:.com/\:bliki/\:CodeSmell\:.html> می‌گردد و می‌تواند پیشنهادهایی دربارهٔ چگونگی بازآرایی (refactor) کد ارائه دهد.
.SH "نصب (INSTALL)"
.sp
برای استفاده در خط فرمان، pylint به صورت زیر نصب می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pip install pylint
.EE
.UNINDENT
.UNINDENT
.sp
یا اگر می‌خواهید املای واژگان را نیز با \fBenchant\fP بررسی کنید (ممکن است لازم باشد کتابخانه C مربوط به enchant را نصب کنید \%<https://\:pyenchant\:.github\:.io/\:pyenchant/\:install\:.html#\:installing-the-enchant-c-library>):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pip install pylint[spelling]
.EE
.UNINDENT
.UNINDENT
.sp
همچنین می‌توان آن را با بیشتر ویرایشگرها یا IDEها یکپارچه کرد. اطلاعات بیشتر را می‌توانید در مستندات \%<https://\:pylint\:.readthedocs\:.io/\:en/\:latest/\:user_guide/\:installation/\:index\:.html>\& بیابید..SH "چه چیزی PYLINT را متمایز می‌کند؟ (WHAT DIFFERENTIATES PYLINT?)"
.sp
ابزار Pylint به تعیین نوع (typing) شما اعتماد نمی‌کند و مقادیر واقعی گره‌ها را با استفاده از نمایش کد داخلی خود (astroid) استنتاج می‌کند (در وهله اول به این دلیل که وقتی pylint آغاز به کار کرد، هنوز نوع‌بندی در پایتون وجود نداشت). اگر کد شما به صورت \fBimport logging as argparse\fP باشد، Pylint می‌تواند بررسی کرده و متوجه شود که \fBargparse.error(...)\fP در واقع یک فراخوانی از logging است و نه فراخوانی argparse. این امر pylint را کندتر می‌کند، اما همچنین به آن اجازه می‌دهد در صورتی که کد شما به طور کامل تعیین نوع نشده باشد، مشکلات بیشتری را بیابد.
.INDENT 0.0
.INDENT 3.5
[استنتاج] ویژگی کلیدی و تعیین‌کننده‌ای است که باعث می‌شود با وجود کُندی دردناکش، همچنان از [pylint] در پروژه‌مان استفاده کنیم.
\- یک کاربر واقع‌بین pylint \%<https://\:github\:.com/\:charliermarsh/\:ruff/\:issues/\:970#\:issuecomment-1381067064>، 2022
.UNINDENT
.UNINDENT
.sp
ابزار pylint که هراسی از کمی کندتر بودن نسبت به وضعیت فعلی‌اش ندارد، بسیار دقیق‌تر و جامع‌تر از سایر لینترها عمل می‌کند. بررسی‌های بیشتری در آن گنجانده شده است، از جمله برخی بررسی‌های سلیقه‌ای (opinionated) که به صورت پیش‌فرض غیرفعال هستند اما می‌توان با استفاده از پیکربندی آن‌ها را فعال کرد.
.SH "نحوه استفاده از PYLINT (HOW TO USE PYLINT)"
.sp
ابزار Pylint باهوش‌تر از شما نیست: ممکن است درباره مواردی به شما هشدار دهد که آگاهانه انجام داده‌اید یا مواردی را بررسی کند که برایتان اهمیتی ندارند. در زمان به‌کارگیری، به‌ویژه در یک پروژه قدیمی (legacy) که pylint هرگز در آن اعمال نشده بود، بهتر است کار را با پرچم \fB\-\-errors\-only\fP آغاز کنید، سپس پیام‌های مربوط به قراردادها و بازسازی (refactor) را با \fB\-\-disable=C,R\fP غیرفعال نمایید و به تدریج همگام با تحول اولویت‌هایتان، پیام‌ها را بازبینی و مجدداً فعال کنید.
.sp
ابزار Pylint بسیار پیکربندی‌پذیر است و امکان نگارش پلاگین‌ها را برای افزودن بررسی‌های دلخواهتان (برای نمونه، برای کتابخانه‌های داخلی یا یک قاعده داخلی) فراهم می‌کند. Pylint همچنین دارای زیست‌بومی از پلاگین‌های موجود برای چارچوب‌های محبوب و کتابخانه‌های شخص ثالث است.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
ابزار Pylint به صورت پیش‌فرض و بی‌درنگ از کتابخانه استاندارد پایتون پشتیبانی می‌کند. کتابخانه‌های شخص ثالث همیشه پشتیبانی نمی‌شوند، بنابراین ممکن است به یک پلاگین نیاز باشد. یک نقطه شروع مناسب \fBPyPI\fP است که اغلب با جستجوی \fBpylint <library>\fP یک پلاگین ارائه می‌دهد. نمونه‌هایی از این دست پلاگین‌ها عبارتند از: pylint\-pydantic \%<https://\:pypi\:.org/\:project/\:pylint-pydantic>، pylint\-django \%<https://\:github\:.com/\:pylint-dev/\:pylint-django> و pylint\-sonarjson \%<https://\:github\:.com/\:cnescatlab/\:pylint-sonarjson-catlab>\&. اطلاعات بیشتر درباره پلاگین‌ها و نحوه بارگذاری آن‌ها را می‌توانید در plugins \%<https://\:pylint\:.readthedocs\:.io/\:en/\:latest/\:development_guide/\:how_tos/\:plugins\:.html#\:plugins>\& بیابید.
.UNINDENT
.UNINDENT
.SH "لینترهای توصیه‌شده در کنار PYLINT (ADVISED LINTERS ALONGSIDE PYLINT)"
.sp
پروژه‌هایی که ممکن است بخواهید در کنار pylint استفاده کنید عبارتند از ruff \%<https://\:github\:.com/\:astral-sh/\:ruff> (\fBبسیار\fP سریع، به همراه تصحیح خودکار داخلی و تعداد زیادی بررسی برگرفته از لینترهای محبوب، اما پیاده‌سازی‌شده در \fBrust\fP) یا flake8 \%<https://\:github\:.com/\:PyCQA/\:flake8> (چارچوبی برای پیاده‌سازی بررسی‌های دلخواهتان در پایتون با استفاده مستقیم از \fBast\fP)، mypy \%<https://\:github\:.com/\:python/\:mypy>، pyright \%<https://\:github\:.com/\:microsoft/\:pyright> / pylance یا pyre \%<https://\:github\:.com/\:facebook/\:pyre-check> (بررسی‌های مربوط به تعیین نوع)، bandit \%<https://\:github\:.com/\:PyCQA/\:bandit> (بررسی‌های متمرکز بر امنیت)، black \%<https://\:github\:.com/\:psf/\:black> و isort \%<https://\:pycqa\:.github\:.io/\:isort> (قالب‌بندی خودکار)، autoflake \%<https://\:github\:.com/\:myint/\:autoflake> (حذف خودکار واردسازی‌ها یا متغیرهای استفاده‌نشده)، pyupgrade \%<https://\:github\:.com/\:asottile/\:pyupgrade> (ارتقای خودکار به نحو جدیدتر پایتون) و pydocstringformatter \%<https://\:github\:.com/\:DanielNoord/\:pydocstringformatter> (پیاده‌سازی خودکار pep257).
.SH "ابزارهای اضافی موجود در PYLINT (ADDITIONAL TOOLS INCLUDED IN PYLINT)"
.sp
ابزار Pylint همراه با دو ابزار جانبی عرضه می‌شود:
.INDENT 0.0
.IP \(bu 2
pyreverse \%<https://\:pylint\:.readthedocs\:.io/\:en/\:latest/\:additional_tools/\:pyreverse/\:index\:.html> (ابزاری مستقل که نمودارهای بسته و کلاس را تولید می‌کند.)
.IP \(bu 2
symilar \%<https://\:pylint\:.readthedocs\:.io/\:en/\:latest/\:additional_tools/\:symilar/\:index\:.html>  (ابزار شناسایی کدهای تکراری که درون pylint نیز ادغام شده است)
.UNINDENT
.SH "مشارکت (CONTRIBUTING)"
.sp
ما از تمامی اشکال مشارکت استقبال می‌کنیم؛ مانند به‌روزرسانی مستندات، کدهای جدید، بررسی تکراری نبودن گزارش‌ها (issues) یا اطلاع دادن به ما برای بستن آن‌ها، تأیید اینکه مشکلات همچنان وجود دارند، باز کردن گزارش مشکل به دلیل یافتن یک باگ یا درخواست یک قابلیت \%<https://\:pylint\:.readthedocs\:.io/\:en/\:latest/\:contact\:.html#\:bug-reports-feedback> و غیره. هرگونه مشارکتی بسیار ارزشمند است!
.sp
لطفاً مرام‌نامه اخلاقی \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:CODE_OF_CONDUCT\:.md> را رعایت کرده و اگر مایل به مشارکت کدی هستید، راهنماهای مشارکت‌کنندگان \%<https://\:pylint\:.readthedocs\:.io/\:en/\:latest/\:development_guide/\:contribute\:.html> را مطالعه نمایید.
.SH "نمایش استفاده شما (SHOW YOUR USAGE)"
.sp
شما می‌توانید این نشان (badge) را در فایل README خود قرار دهید تا دیگران بدانند پروژه شما از pylint استفاده می‌کند.
.INDENT 0.0
.INDENT 3.5
[تصویر]
 \%<https://\:github\:.com/\:pylint-dev/\:pylint>.UNINDENT
.UNINDENT
.sp
نحوه افزودن نشان به مستندات خود را در مستندات نشان \%<https://\:pylint\:.readthedocs\:.io/\:en/\:latest/\:user_guide/\:installation/\:badge\:.html>\& بیاموزید.
.SH "مجوز (LICENSE)"
.sp
ابزار pylint، به استثنای چند مورد ذکر شده در زیر، تحت GPLv2 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:LICENSE>\& منتشر می‌شود.
.sp
فایل‌های آیکون تحت پروانه CC BY\-SA 4.0 \%<https://\:creativecommons\:.org/\:licenses/\:by-sa/\:4\:.0> هستند:
.INDENT 0.0
.IP \(bu 2
doc/logo.png \%<https://\:raw\:.githubusercontent\:.com/\:pylint-dev/\:pylint/\:main/\:doc/\:logo\:.png>
.IP \(bu 2
doc/logo.svg \%<https://\:raw\:.githubusercontent\:.com/\:pylint-dev/\:pylint/\:main/\:doc/\:logo\:.svg>
.UNINDENT.SH "پشتیبانی (SUPPORT)"
.sp
لطفاً اطلاعات تماس را در \%<https://\:pylint\:.readthedocs\:.io/\:en/\:latest/\:contact\:.html>\& بررسی کنید.
.TS
box center;
l|l.
T{
[تصویر: Tidelift]
[تصویر]
T}	T{
پشتیبانی حرفه‌ای از pylint به‌عنوان بخشی از اشتراک Tidelift
\%<https://\:tidelift\:.com/\:subscription/\:pkg/\:pypi-pylint?\:utm_source=pypi-pylint&\:utm_medium=referral&\:utm_campaign=readme>\& در دسترس است. Tidelift به تیم‌های توسعهٔ نرم‌افزار مرجعی یکپارچه برای خرید و نگهداری نرم‌افزارهایشان با تضمین‌های حرفه‌ای از سوی کارشناسانی که آن را به بهترین شکل می‌شناسند ارائه می‌دهد، در حالی که به‌طور یکپارچه با ابزارهای موجود سازگار است.
T}
.TE
.SS "آموزش (Tutorial)"
.sp
این آموزش تماماً دربارهٔ مواجهه با استانداردهای کدنویسی، با دانش اندک یا بدون داشتن شناختی عمیق از برنامه‌نویسی یا خود استانداردهای کد است. این کار معادل نادیده گرفتن دفترچهٔ راهنما و پریدن مستقیم به میان کار است.
.sp
اعلان خط فرمان برای این مثال‌ها بدین صورت است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
tutor Desktop$
.EE
.UNINDENT
.UNINDENT
.SS "شروع به کار (Getting Started)"
.sp
اجرای Pylint با آرگومان‌های \fB\-\-help\fP دیدی کلی از آرگومان‌های موجود به شما می‌دهد. این کار را اکنون انجام دهید، مانند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pylint \-\-help
.EE
.UNINDENT
.UNINDENT
.sp
برخی از گزینه‌هایی که در اینجا بر آن‌ها تمرکز خواهیم کرد عبارتند از:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Commands:
  \-\-help\-msg=<msg\-id>
  \-\-generate\-toml\-config
Messages control:
  \-\-disable=<msg\-ids>
Reports:
  \-\-reports=<y or n>
  \-\-output\-format=<format>
.EE
.UNINDENT
.UNINDENT
.sp
اگر به جزئیات بیشتری نیاز دارید، می‌توانید پیام راهنمای حتی طولانی‌تری را درخواست کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pylint \-\-long\-help
.EE
.UNINDENT
.UNINDENT
.sp
به بخش پایانی خروجی این راهنمای طولانی‌تر دقت کنید. این بخش به شما نشان می‌دهد که Pylint قرار است به چه مواردی \fBایراد بگیرد\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Output:
   Using the default text output, the message format is :
  MESSAGE_TYPE: LINE_NUM:[OBJECT:] MESSAGE
  There are 5 kind of message types :
  * (C) convention, for programming standard violation
  * (R) refactor, for bad code smell
  * (W) warning, for python specific problems
  * (E) error, for probable bugs in the code
  * (F) fatal, if an error occurred which prevented pylint from doing
  further processing.
.EE
.UNINDENT
.UNINDENT
.sp
هنگامی که Pylint برای نخستین بار روی یک قطعه کد تازه اجرا می‌شود، یک شکایت رایج این است که بیش از حد \fBپرسروصدا\fP\& (noisy) است. پیکربندی پیش‌فرض هشدارهای زیادی را اعمال می‌کند. ما از برخی گزینه‌هایی که در بالا اشاره کردیم استفاده خواهیم کرد تا آن را کمی بیشتر با ترجیحات شما سازگار کنیم..SS "نخستین اجرای Pylint (Your First Pylint\(aqing)"
.sp
ما از یک اسکریپت پایه پایتون که ابزار black \%<https://\:github\:.com/\:psf/\:black> از قبل روی آن اعمال شده است،
به‌عنوان محتوای نمونه برای آموزش خود استفاده خواهیم کرد. کد آغازی که به کار خواهیم برد
\fBsimplecaesar.py\fP نام دارد و در اینجا به‌صورت کامل آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
#!/usr/bin/env python3

import string

shift = 3
choice = input(\(dqwould you like to encode or decode?\(dq)
word = input(\(dqPlease enter text\(dq)
letters = string.ascii_letters + string.punctuation + string.digits
encoded = \(dq\(dq
if choice == \(dqencode\(dq:
    for letter in word:
        if letter == \(dq \(dq:
            encoded = encoded + \(dq \(dq
        else:
            x = letters.index(letter) + shift
            encoded = encoded + letters[x]
if choice == \(dqdecode\(dq:
    for letter in word:
        if letter == \(dq \(dq:
            encoded = encoded + \(dq \(dq
        else:
            x = letters.index(letter) \- shift
            encoded = encoded + letters[x]

print(encoded)
.EE
.UNINDENT
.UNINDENT
.sp
بیایید شروع کنیم. اگر این دستور را اجرا کنیم:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
tutor Desktop$ pylint simplecaesar.py
************* Module simplecaesar
simplecaesar.py:1:0: C0114: Missing module docstring (missing\-module\-docstring)
simplecaesar.py:5:0: C0103: Constant name \(dqshift\(dq doesn\(aqt conform to UPPER_CASE naming style (invalid\-name)
simplecaesar.py:8:0: C0103: Constant name \(dqletters\(dq doesn\(aqt conform to UPPER_CASE naming style (invalid\-name)
simplecaesar.py:9:0: C0103: Constant name \(dqencoded\(dq doesn\(aqt conform to UPPER_CASE naming style (invalid\-name)
simplecaesar.py:13:12: C0103: Constant name \(dqencoded\(dq doesn\(aqt conform to UPPER_CASE naming style (invalid\-name)
simplecaesar.py:15:12: C0103: Constant name \(dqx\(dq doesn\(aqt conform to UPPER_CASE naming style (invalid\-name)
simplecaesar.py:16:12: C0103: Constant name \(dqencoded\(dq doesn\(aqt conform to UPPER_CASE naming style (invalid\-name)
simplecaesar.py:20:12: C0103: Constant name \(dqencoded\(dq doesn\(aqt conform to UPPER_CASE naming style (invalid\-name)
simplecaesar.py:22:12: C0103: Constant name \(dqx\(dq doesn\(aqt conform to UPPER_CASE naming style (invalid\-name)
simplecaesar.py:23:12: C0103: Constant name \(dqencoded\(dq doesn\(aqt conform to UPPER_CASE naming style (invalid\-name)

\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
Your code has been rated at 4.74/10
.EE
.UNINDENT
.UNINDENT
.sp
می‌توانیم ببینیم که خط دوم چنین است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqsimplecaesar.py:1:0: C0114: Missing module docstring (missing\-module\-docstring)\(dq
.EE
.UNINDENT
.UNINDENT
.sp
این موضوع اساساً بدین معناست که سطر ۱ در ستون ۰ از قرارداد \fBC0114\fP\& عدول کرده است.
بخش دیگری از اطلاعات، نماد پیام در میان پرانتزها، یعنی
\fBmissing\-module\-docstring\fP\& است.
.sp
اگر بخواهیم کمی بیشتر در این باره مطالعه کنیم، می‌توانیم به
خط فرمان بازگردیم و این دستور را امتحان کنیم:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
tutor Desktop$ pylint \-\-help\-msg=missing\-module\-docstring
:missing\-module\-docstring (C0114): *Missing module docstring*
  Used when a module has no docstring.Empty modules do not require a docstring.
  This message belongs to the basic checker.
.EE
.UNINDENT
.UNINDENT
.sp
این مورد کاملاً ساده و بدیهی بود، اما ممکن است با پیام‌های خطایی
نیز روبرو شویم که با مفاهیم نظری کدِ مربوط به آن‌ها آشنایی نداشته باشیم..SS گام بعدی
.sp
حال که برخی از موارد پیکربندی را پشت سر گذاشتیم، بیایید ببینیم با
هشدارهای باقی‌مانده چه کار می‌توانیم بکنیم. اگر یک docstring برای توصیف
کاری که کد قرار است انجام دهد اضافه کنیم، کمک خواهد کرد. پیام‌های \fBinvalid\-name\fP وجود
دارند که بعداً به آن‌ها خواهیم پرداخت. در اینجا کد به‌روزشده آمده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
#!/usr/bin/env python3

\(dq\(dq\(dqThis script prompts a user to enter a message to encode or decode
using a classic Caesar shift substitution (3 letter shift)\(dq\(dq\(dq

import string

shift = 3
choice = input(\(dqwould you like to encode or decode?\(dq)
word = input(\(dqPlease enter text\(dq)
letters = string.ascii_letters + string.punctuation + string.digits
encoded = \(dq\(dq
if choice == \(dqencode\(dq:
    for letter in word:
        if letter == \(dq \(dq:
            encoded = encoded + \(dq \(dq
        else:
            x = letters.index(letter) + shift
            encoded = encoded + letters[x]
if choice == \(dqdecode\(dq:
    for letter in word:
        if letter == \(dq \(dq:
            encoded = encoded + \(dq \(dq
        else:
            x = letters.index(letter) \- shift
            encoded = encoded + letters[x]

print(encoded)
.EE
.UNINDENT
.UNINDENT
.sp
در ادامه آنچه هنگام اجرای آن رخ می‌دهد آمده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
tutor Desktop$ pylint simplecaesar.py
************* Module simplecaesar
simplecaesar.py:8:0: C0103: Constant name \(dqshift\(dq doesn\(aqt conform to UPPER_CASE naming style (invalid\-name)
simplecaesar.py:11:0: C0103: Constant name \(dqletters\(dq doesn\(aqt conform to UPPER_CASE naming style (invalid\-name)
simplecaesar.py:12:0: C0103: Constant name \(dqencoded\(dq doesn\(aqt conform to UPPER_CASE naming style (invalid\-name)
simplecaesar.py:16:12: C0103: Constant name \(dqencoded\(dq doesn\(aqt conform to UPPER_CASE naming style (invalid\-name)
simplecaesar.py:18:12: C0103: Constant name \(dqx\(dq doesn\(aqt conform to UPPER_CASE naming style (invalid\-name)
simplecaesar.py:19:12: C0103: Constant name \(dqencoded\(dq doesn\(aqt conform to UPPER_CASE naming style (invalid\-name)
simplecaesar.py:23:12: C0103: Constant name \(dqencoded\(dq doesn\(aqt conform to UPPER_CASE naming style (invalid\-name)
simplecaesar.py:25:12: C0103: Constant name \(dqx\(dq doesn\(aqt conform to UPPER_CASE naming style (invalid\-name)
simplecaesar.py:26:12: C0103: Constant name \(dqencoded\(dq doesn\(aqt conform to UPPER_CASE naming style (invalid\-name)

\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
Your code has been rated at 5.26/10 (previous run: 4.74/10, +0.53)
.EE
.UNINDENT
.UNINDENT
.sp
عالی است! Pylint به ما نشان داد که امتیاز کدمان از آخرین اجرا چقدر بهبود یافته است،
و اکنون تنها پیام‌های \fBinvalid\-name\fP باقی مانده‌اند.
.sp
قراردادهای نسبتاً مشخصی پیرامون نام‌گذاری مواردی چون متغیرهای نمونه،
توابع، کلاس‌ها و غیره وجود دارد. این قراردادها بر استفاده از حروف بزرگ (UPPERCASE)
و کوچک (lowercase) و همچنین نویسه‌های جداکننده چند کلمه در نام تمرکز دارند.
این مسئله برای بررسی از طریق عبارت باقاعده (regular expression) بسیار مناسب است،
از این رو عبارت \fBshould match (([A\-Z_][A\-Z1\-9_]*)|(__.*__))$\fP\& مطرح می‌شود.
.sp
در این حالت Pylint به ما می‌گوید که این متغیرها ثابت (constant) به نظر می‌رسند
و باید تماماً با حروف بزرگ باشند. این یک قرارداد داخلی است که از بدو پیدایش Pylint
همراه آن بوده است. شما نیز می‌توانید قراردادهای نام‌گذاری داخلی خود را ایجاد کنید
اما برای اهداف این راهنما، می‌خواهیم به استاندارد PEP 8 \%<https://\:peps\:.python\:.org/\:pep-0008>
پایبند باشیم. در این مورد، متغیرهایی که تعریف کردیم باید از قرارداد حروف تماماً کوچک پیروی کنند.
قاعده مناسب چیزی شبیه به این خواهد بود:
\(dqshould match [a\-z_][a\-z0\-9_]{2,30}$\(dq. به حروف کوچک در عبارت باقاعده (a\-z در مقابل A\-Z) توجه کنید.
.sp
اگر این قاعده را با استفاده از گزینه \fB\-\-const\-rgx=\(aq[a\-z\e_][a\-z0\-9\e_]{2,30}$\(aq\fP اجرا کنیم،
اکنون خروجی بسیار ساکت‌تر خواهد بود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
tutor Desktop$ pylint simplecaesar.py \-\-const\-rgx=\(aq[a\-z\e_][a\-z0\-9\e_]{2,30}$\(aq
************* Module simplecaesar
simplecaesar.py:18:12: C0103: Constant name \(dqx\(dq doesn\(aqt conform to \(aq[a\-z\e\e_][a\-z0\-9\e\e_]{2,30}$\(aq pattern (invalid\-name)
simplecaesar.py:25:12: C0103: Constant name \(dqx\(dq doesn\(aqt conform to \(aq[a\-z\e\e_][a\-z0\-9\e\e_]{2,30}$\(aq pattern (invalid\-name)

\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
Your code has been rated at 8.95/10 (previous run: 5.26/10, +3.68)
.EE
.UNINDENT
.UNINDENT
.sp
می‌توانید درباره عبارات باقاعده در \%<https://\:docs\:.python\:.org/\:library/\:re\:.html> مطالعه کنید یا از وب‌سایتی مانند \%<https://\:regex101\:.com>\& برای کمک گرفتن استفاده نمایید.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
مشخص کردن مداوم این عبارت باقاعده در خط فرمان واقعاً دردسرساز خواهد بود، به‌ویژه اگر از گزینه‌های بسیار دیگری نیز استفاده کنیم.
فایل پیکربندی دقیقاً برای همین منظور است. می‌توانیم Pylint را به گونه‌ای پیکربندی کنیم که
گزینه‌هایمان را برای ما ذخیره کند تا مجبور نباشیم آن‌ها را در خط فرمان تعریف کنیم. استفاده از یک فایل پیکربندی روش مناسبی برای رسمی کردن قواعد شما و
اشتراک‌گذاری سریع آن‌ها با دیگران است. اجرای \fBpylint \-\-generate\-toml\-config\fP یک بخش نمونه \fB\&.toml\fP با تمام گزینه‌های تنظیم‌شده و توضیح داده‌شده در کامنت‌ها ایجاد می‌کند.
سپس می‌توان این بخش را به فایل \fBpyproject.toml\fP خود یا هر فایل \fB\&.toml\fP دیگری که با گزینه \fB\-\-rcfile\fP مشخص شده اضافه کرد.
.UNINDENT
.UNINDENT.SS "نصب (Installation)"
.sp
Pylint را می‌توان به روش‌های زیر نصب کرد:
.INDENT 0.0
.IP \(bu 2
به عنوان یک ابزار خط فرمان \%<#\:installation>
.IP \(bu 2
یکپارچه‌شده در ویرایشگر یا IDE شما \%<#\:ide-integration>
.IP \(bu 2
به عنوان یک قلاب pre\-commit \%<#\:pre-commit-integration>
.IP \(bu 2
برای چندین مفسر python در یکپارچه‌سازی مداوم (CI) شما \%<#\:continuous-integration>
.UNINDENT
.SS "نصب از خط فرمان (Command line installation)"
.sp
Pylint با استفاده از یک مدیر بسته قابل نصب است. مدیر بستهٔ شما نسخه‌ای سازگار با مفسر شما را پیدا خواهد کرد. ما \fBpip\fP را توصیه می‌کنیم:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pip install pylint
.EE
.UNINDENT
.UNINDENT
.sp
یا اگر می‌خواهید املا را نیز با \fBenchant\fP بررسی کنید (ممکن است به نصب کتابخانهٔ C مربوط به enchant نیاز داشته باشید \%<https://\:pyenchant\:.github\:.io/\:pyenchant/\:install\:.html#\:installing-the-enchant-c-library>):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pip install pylint[spelling]
.EE
.UNINDENT
.UNINDENT
.sp
جدیدترین نسخهٔ pylint از تمام مفسرهای Python که پایان عمرشان فرانرسیده است پشتیبانی می‌کند.
.sp
ما استفاده از آخرین مفسر را توصیه می‌کنیم زیرا به ماژول توکار \fBast\fP متکی هستیم که با هر مفسر جدید Python بهبود می‌یابد. به عنوان مثال، یک مفسر Python 3.6 نمی‌تواند نحو 3.8 را تحلیل کند (به ویژه به دلیل عملگر جدید walrus)، در حالی که یک مفسر 3.8 می‌تواند با Python 3.6 نیز کار کند. برای جزئیات بیشتر به بخش استفاده از pylint با چندین مفسر \%<#\:continuous-integration> مراجعه کنید.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
شما همچنین می‌توانید از \fBconda\fP یا مدیر بستهٔ سیستم خود در سیستم‌عامل‌های مبتنی بر debian استفاده کنید.
این مدیر بسته‌ها کمی عقب‌تر هستند چرا که توسط نهادی جداگانه با چرخهٔ انتشار کندتری نگهداری می‌شوند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
conda install pylint
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sudo apt\-get install pylint
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SS "یکپارچه‌سازی با ویرایشگر و IDE (Editor and IDE integration)"
.sp
Pylint را می‌توان در ویرایشگرها و IDEهای گوناگون ادغام کرد.
در زیر می‌توانید راهنماهایی را برای برخی از متداول‌ترین آن‌ها پیدا کنید.
.INDENT 0.0
.IP \(bu 2
Eclipse \%<https://\:www\:.pydev\:.org/\:manual_adv_pylint\:.html>
.IP \(bu 2
Emacs \%<https://\:www\:.emacswiki\:.org/\:emacs/\:PythonProgrammingInEmacs>
.IP \(bu 2
Eric IDE \%<https://\:eric-ide\:.python-projects\:.org> در منوی \fIProject > Check\fP،
.IP \(bu 2
gedit \%<https://\:launchpad\:.net/\:gedit-pylint-2> (گزینه‌ای دیگر برای gedit \%<https://\:wiki\:.gnome\:.org/\:Apps/\:Gedit/\:PylintPlugin>)
.IP \(bu 2
Flymake \%<#\:pylint-in-flymake>
.IP \(bu 2
Jupyter Notebook \%<https://\:github\:.com/\:nbQA-dev/\:nbQA>
.IP \(bu 2
Komodo \%<https://\:mateusz\:.loskot\:.net/\:post/\:2006/\:01/\:15/\:running-pylint-from-komodo>
.IP \(bu 2
Pycharm \%<https://\:stackoverflow\:.com/\:a/\:46409649/\:2519059>
.IP \(bu 2
PyDev \%<https://\:www\:.pydev\:.org/\:manual_adv_pylint\:.html>
.IP \(bu 2
pyscripter \%<https://\:github\:.com/\:pyscripter/\:pyscripter> در منوی \fITool \-> Tools\fP.
.IP \(bu 2
Spyder \%<https://\:docs\:.spyder-ide\:.org/\:current/\:panes/\:pylint\:.html> در منوی \fIView \-> Panes \-> Static code analysis\fP
.IP \(bu 2
Sublime Text \%<https://\:packagecontrol\:.io/\:packages/\:SublimeLinter-pylint>
.IP \(bu 2
TextMate \%<#\:pylint-in-textmate>
.IP \(bu 2
Vim \%<https://\:www\:.vim\:.org/\:scripts/\:script\:.php?\:script_id=891>
.IP \(bu 2
Visual Studio Code \%<https://\:code\:.visualstudio\:.com/\:docs/\:python/\:linting> در منوی \fIPreferences \-> Settings\fP
.IP \(bu 2
Visual Studio Code Pylint Extension \%<https://\:marketplace\:.visualstudio\:.com/\:items?\:itemName=ms-python\:.pylint>
.IP \(bu 2
Visual Studio \%<https://\:docs\:.microsoft\:.com/\:visualstudio/\:python/\:code-pylint> در دستور \fIPython > Run PyLint\fP در منوی زمینه‌ای (context menu) یک پروژه.
.IP \(bu 2
WingIDE \%<https://\:wingware\:.com/\:doc/\:warnings/\:external-checkers>
.UNINDENT.SS استفاده از Pylint از طریق Flymake در Emacs
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
ابزار epylint در نسخهٔ 2.16.0 منسوخ شد و برای حذف در نسخهٔ 3.0.0 در نظر گرفته شده است.
تمام فایل‌های مرتبط با emacs و flymake حذف شدند و پشتیبانی از آن‌ها
اکنون در یک مخزن خارجی انجام خواهد شد: \%<https://\:github\:.com/\:emacsorphanage/\:pylint>\&.
.UNINDENT
.UNINDENT
.SS یکپارچه‌سازی Pylint با TextMate
.sp
Pylint را به روش معمول نصب کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pip install pylint
.EE
.UNINDENT
.UNINDENT
.sp
بستهٔ Python را برای TextMate نصب کنید \%<https://\:github\:.com/\:textmate/\:python\:.tmbundle>:
.INDENT 0.0
.IP 1. 3
مسیر \fITextMate\fP > \fIPreferences\fP را انتخاب کنید
.IP 2. 3
برگهٔ \fIBundles\fP را انتخاب کنید
.IP 3. 3
بستهٔ \fIPython\fP را در فهرست پیدا کرده و تیک بزنید
.UNINDENT
.sp
اکنون باید آن را در \fIBundles\fP > \fIPython\fP مشاهده کنید\&.
.sp
در \fIPreferences\fP، برگهٔ \fIVariables\fP را انتخاب کنید. اگر متغیر \fBTM_PYCHECKER\fP از پیش در فهرست نیست،
آن را با مقدار \fBpylint\fP اضافه کنید\&.
.sp
میان‌بر پیش‌فرض صفحه‌کلید برای اجرای بررسی‌کننده نحو (syntax checker) کلیدهای \fIControl\-Shift\-V\fP است \- یک فایل \fB\&.py\fP را
در Textmate باز کرده و آن را آزمایش کنید.
.sp
باید خروجی را در یک پنجرهٔ جدید ببینید:
.INDENT 0.0
.INDENT 3.5
PyCheckMate 1.2 – Pylint 1.4.4
.sp
No config file found, using default configuration
.UNINDENT
.UNINDENT
.sp
آنگاه همه چیز روبه‌راه است و به احتمال زیاد Pylint نکاتی را دربارهٔ کد پایتون شما گوشزد کرده است
(یا اگر کد شما از قبل با انتظارات آن مطابقت داشته باشد، با وضعیت \fB0\fP خارج خواهد شد).
.sp
اگر پیامی به این صورت دریافت کردید:
.INDENT 0.0
.INDENT 3.5
Please install PyChecker, PyFlakes, Pylint, PEP 8 or flake8 for more extensive code checking.
.UNINDENT
.UNINDENT
.sp
این پیام یعنی Pylint پیدا نشد، که احتمالاً ناشی از مشکلی در مسیرهای دستور است \- TextMate
باید در مسیرهای درستی به دنبال Pylint بگردد.
.sp
با استفاده از دستور \fBwhich\fP بررسی کنید که Pylint در کجا نصب شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ which pylint
/usr/local/bin/pylint
.EE
.UNINDENT
.UNINDENT
.sp
خروجی به شما خواهد گفت که Pylint کجا قرار دارد؛ در این مورد، در \fB/usr/local/bin\fP\&.
.INDENT 0.0
.IP 1. 3
مسیر \fITextMate\fP > \fIPreferences\fP را انتخاب کنید
.IP 2. 3
برگهٔ \fIVariables\fP را انتخاب کنید
.IP 3. 3
بررسی کنید که متغیر \fBPATH\fP وجود داشته باشد و شامل مسیر مناسب باشد (اگر
مسیر Pylint همان‌طور که در بالا آمد \fB/usr/local/bin/pylint\fP باشد، متغیر باید شامل
\fB/usr/local/bin\fP باشد). یک نمونهٔ واقعی در این مورد می‌تواند
\fB$PATH:/opt/local/bin:/usr/local/bin:/usr/texbin\fP باشد که شامل مسیرهای دیگر نیز می‌شود.
.UNINDENT
.sp
\&... و دوباره اجرای Pylint را امتحان کنید..SS یکپارچه‌سازی با Pre\-commit (Pre\-commit integration)
.sp
از \fBpylint\fP می‌توان به عنوان یک هوک pre\-commit \%<https://\:pre-commit\:.com> استفاده کرد. با این حال ما استفاده از آن را توصیه نمی‌کنیم، چرا که pylint \-\- با توجه به سرعتش \-\- برای یک کار یکپارچه‌سازی پیوسته (CI) یا هوک \fBpre\-push\fP در git مناسب‌تر است، به‌ویژه اگر مخزن شما بزرگ باشد.
.sp
از آنجا که \fBpylint\fP برای عملکرد صحیح نیاز به وارد کردن (import) ماژول‌ها و وابستگی‌ها دارد، این هوک تنها با نصب محلی \fBpylint\fP (در محیط شما) کار می‌کند. این بدان معناست که نمی‌توان از آن به همراه \fBpre\-commit.ci\fP استفاده کرد و لازم است موارد زیر را به \fB\&.pre\-commit\-config.yaml\fP خود اضافه کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\&.. sourcecode:: yaml
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B ci:
skip: [pylint]
.UNINDENT
.UNINDENT
.UNINDENT
.sp
محدودیت دیگر این است که pylint برای استنتاج بهینهٔ مقادیر واقعی ناشی از فراخوانی‌ها، باید تمام کد شما را به یک‌باره تحلیل کند. اگر تنها بخشی از فایل‌ها به آن داده شوند، ممکن است pylint نوع یک مقدار خاص را تشخیص ندهد و برای آن زیرمجموعه استنتاج ضعیف‌تری ارائه کند. از آنجا که pre\-commit فایل‌های ورودی را به منظور موازی‌سازی پردازش تکه‌بندی (slice) می‌کند، ممکن است نتیجه دچار افت کیفیت شود. همچنین در صورت تغییر مجموعهٔ فایل‌ها، نتیجه ممکن است به شکلی غیرمنتظره متفاوت باشد چرا که برش‌بندی جدید می‌تواند استنتاج را تغییر دهد. بنابراین در صورتی که درستی و قطعیت (تکرارپذیری) برای شما اهمیت بیشتری نسبت به موازی‌سازی دارد، گزینهٔ \fBrequire_serial\fP باید روی \fBtrue\fP تنظیم شود.
.sp
اگر \fBpylint\fP را به صورت محلی نصب کرده‌اید، می‌توانید آن را به شکل زیر به \fB\&.pre\-commit\-config.yaml\fP بیفزایید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\- repo: local
  hooks:
    \- id: pylint
      name: pylint
      entry: pylint
      language: system
      types: [python]
      require_serial: true
      args:
        [
          \(dq\-rn\(dq, # Only display messages
          \(dq\-sn\(dq, # Don\(aqt display the score
        ]
.EE
.UNINDENT
.UNINDENT
.sp
می‌توانید همان‌طور که در آموزش \%<#\:tutorial>\& شرح داده شده است، از \fBargs\fP برای ارسال آرگومان‌های خط فرمان استفاده کنید. یک هوک با آرگومان‌های بیشتر می‌تواند شبیه به این باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\- repo: local
  hooks:
    \- id: pylint
      name: pylint
      entry: pylint
      language: system
      types: [python]
      args:
        [
          \(dq\-rn\(dq, # Only display messages
          \(dq\-sn\(dq, # Don\(aqt display the score
          \(dq\-\-rcfile=pylintrc\(dq, # Link to your config file
          \(dq\-\-load\-plugins=pylint.extensions.docparams\(dq, # Load an extension
        ]
.EE
.UNINDENT
.UNINDENT.SS نصب با چندین مفسر
.sp
امکان تحلیل کدهای نوشته‌شده برای مفسرهای قدیمی‌تر یا چندگانه با استفاده از
گزینهٔ \fBpy\-version\fP و تنظیم آن روی قدیمی‌ترین مفسر پشتیبانی‌شده توسط کد شما وجود دارد. برای نمونه، می‌توانید بررسی کنید
که هیچ \fBf\-strings\fPی در کد Python 3.5 وجود نداشته باشد در حالی که از Python 3.8 به همراه یک نسخهٔ به‌روز از
pylint استفاده می‌کنید، حتی اگر دورهٔ پشتیبانی رسمی (EOL) از Python 3.5 به پایان رسیده باشد و نسخهٔ pylint مورد استفاده شما با آن
سازگار نباشد.
.sp
ما تضمین نمی‌کنیم که \fBpy\-version\fP تا ابد برای تمام مفسرهای منسوخ‌شدهٔ پایتون کار کند
(برای نسخه‌های قبل از Python 3.5 احتمالاً کار نخواهد کرد). اگر نسخهٔ جدیدتر برای شما کار نمی‌کند،
بهترین pylint در دسترس ممکن است نسخهٔ قدیمی‌تری باشد که با مفسر قدیمی شما کار می‌کند، اما
فاقد رفع اشکالات و قابلیت‌های نسخه‌های بعدی خواهد بود.
.SS نمایش نشان استفاده
.sp
می‌توانید این نشان (badge) را در فایل README خود قرار دهید تا دیگران بدانند پروژهٔ شما از pylint استفاده می‌کند.
.INDENT 0.0
.INDENT 3.5
[تصویر]
 \%<https://\:github\:.com/\:pylint-dev/\:pylint>
.UNINDENT
.UNINDENT
.sp
استفاده از نشان در فایل README.md پروژه (یا هر فایل Markdown دیگر):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[![linting: pylint](https://img.shields.io/badge/linting\-pylint\-yellowgreen)](https://github.com/pylint\-dev/pylint)
.EE
.UNINDENT
.UNINDENT
.sp
استفاده از نشان در فایل README.rst پروژه (یا هر فایل rst دیگر):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\&.. image:: https://img.shields.io/badge/linting\-pylint\-yellowgreen
    :target: https://github.com/pylint\-dev/pylint
.EE
.UNINDENT
.UNINDENT
.sp
اگر از GitHub Actions استفاده می‌کنید و یکی از گردش‌های کاری CI شما با \(dqname: pylint\(dq آغاز می‌شود،
می‌توانید از نشان‌های وضعیت گردش‌کار گیت‌هاب \%<https://\:docs\:.github\:.com/\:en/\:actions/\:monitoring-and-troubleshooting-workflows/\:adding-a-workflow-status-badge#\:using-the-workflow-file-name>
برای نمایش وضعیت لحظه‌ای گذراندن موفق pylint در pushهای ارسالی به شاخهٔ پیش‌فرض خود استفاده کنید.
برای اطلاعات دقیق‌تر، مستندات را بررسی کنید.
.SS ارتقای pylint
.sp
احتمالاً بهتر است نسخهٔ pylint را در محیط توسعهٔ خود تثبیت کنید تا بتوانید زمان ارتقای
هشدارهای pylint را مدیریت نمایید. pylint از نسخه‌بندی معنایی (semver) پیروی می‌کند؛
اما ما نمی‌توانیم تضمین کنیم که خروجی برنامه در بین نسخه‌های مختلف کاملاً یکسان باقی بماند. معنای این امر این است که:
.INDENT 0.0
.IP \(bu 2
در \fBانتشارهای وصله‌ای (patch release)\fP (\fB1.2.3\fP)، ما فقط هشدارهای مثبت کاذب (false positives) و خرابی‌ها (crashes) را رفع می‌کنیم.
.UNINDENT
.sp
اگر نسخهٔ فرعی (minor) را ثابت نگه داشته و به یک نسخهٔ وصله‌ای جدید ارتقا دهید، می‌توانید انتظار پیام‌های کمتری را داشته باشید.
با این وجود، فعال بودن \fBuseless\-suppression\fP به این معناست که پس از برطرف شدن یک مثبت کاذب که قبلاً آن را غیرفعال کرده بودید،
ممکن است یک هشدار جدید \fBuseless\-suppression\fP دریافت کنید. همچنین، اگر کتابخانهٔ مورد استفاده شما ارتقا یافته باشد
و رفتار آن نسبت به قبل بهتر یا بدتر تشخیص داده شود، ممکن است پیام‌های جدیدی نیز دریافت کنید.
.INDENT 0.0
.IP \(bu 2
در \fBانتشارهای فرعی (minor releases)\fP (\fB1.2.0\fP)، بررسی‌های جدیدی اضافه می‌کنیم، برخی بررسی‌ها را حذف می‌کنیم، مفسرهای پایتون منسوخ‌شده را کنار می‌گذاریم، نسخه‌های اصلی یا فرعی astroid را ارتقا داده و منفی‌های کاذب (false negatives) را رفع می‌کنیم.
.UNINDENT
.sp
در این حالت می‌توانید انتظار تغییرات بسیار بیشتری در خروجی داشته باشید که عمدهٔ آن مربوط به بررسی‌های جدید است.
.INDENT 0.0
.IP \(bu 2
در \fBانتشارهای اصلی (major releases)\fP (\fB1.0.0\fP)، باقی بخش‌ها را تغییر می‌دهیم (گزینه‌های pylint، خروجی json، رابط برنامه‌نویسی توسعه و...)، در حالی که همچنان سعی می‌کنیم اختلالات به حداقل ممکن برسد.
.UNINDENT
.sp
در این شرایط ممکن است لازم باشد دستوری را که اجرا می‌کنید یا افزونه و یکپارچه‌سازی ویرایشگر مورد استفادهٔ خود را تغییر دهید.
.SS نحوه استفاده
.SS اجرای Pylint
.SS روی بسته‌های ماژول یا دایرکتوری‌ها
.sp
ابزار Pylint برای فراخوانی از خط فرمان طراحی شده است. نحوهٔ استفاده بدین صورت است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pylint [options] modules_or_packages
.EE
.UNINDENT
.UNINDENT
.sp
به‌طور پیش‌فرض دستور \fBpylint\fP تنها فهرستی از ماژول‌ها و بسته‌های پایتون را می‌پذیرد.
در نسخه‌های قبل از 2.15، تعیین دایرکتوری‌ای که یک بستهٔ صریح نباشد
(حاوی \fB__init__.py\fP نباشد) به خطا منجر می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pylint mydir
************* Module mydir
mydir/__init__.py:1:0: F0010: error while code parsing: Unable to load file mydir/__init__.py:
[Errno 2] No such file or directory: \(aqmydir/__init__.py\(aq (parse\-error)
.EE
.UNINDENT
.UNINDENT
.sp
بنابراین، در نسخه‌های قبل از 2.15 استفاده از گزینهٔ \fB\-\-recursive=y\fP امکان تحلیل ایستای بسته‌های فضای نام (namespace package) را فراهم می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pylint \-\-recursive=y mydir mymodule mypackage
.EE
.UNINDENT
.UNINDENT
.sp
این گزینه باعث می‌شود \fBpylint\fP تلاش کند تمام ماژول‌ها (فایل‌های منتهی به پسوند \fB\&.py\fP)
و تمام بسته‌های صریح (تمامی دایرکتوری‌های حاوی فایل \fB__init__.py\fP) را شناسایی کند.
.sp
ابزار Pylint این بسته یا ماژول را \fBوارد (import) نخواهد کرد\fP، اما برای تعیین مکان آن‌ها از ساختار درونی پایتون استفاده می‌کند
و به همین دلیل مشمول همان قوانین و پیکربندی‌ها خواهد بود.
شما باید به متغیر محیطی \fBPYTHONPATH\fP خود توجه داشته باشید، زیرا تحلیل نسخهٔ نصب‌شدهٔ یک ماژول
به جای نسخهٔ در حال توسعهٔ آن یک خطای رایج است..SS روی فایل‌ها (On files)
.sp
همچنین تحلیل فایل‌های Python، با چند محدودیت، امکان‌پذیر است. برای سهولت کار،
در صورتی که بتوان با استفاده از python path نام ماژول را از روی مسیر فایل
تشخیص داد، می‌توانید نام فایل را به آن بدهید. چند مثال:
.sp
دستور \fBpylint mymodule.py\fP باید همیشه کار کند، چرا که دایرکتوری کاری فعلی
به‌طور خودکار به ابتدای python path اضافه می‌شود
.sp
دستور \fBpylint directory/mymodule.py\fP کار خواهد کرد اگر: \fBdirectory\fP یک
بستهٔ Python باشد (یعنی شامل یک فایل \fB__init__.py\fP باشد)، یک بستهٔ فضای‌نام
ضمنی (implicit namespace package) باشد، یا اگر \fBdirectory\fP در python path قرار داشته باشد.
.SS با بسته‌های فضای‌نام ضمنی (With implicit namespace packages)
.sp
اگر سورس‌های تحلیل‌شده از بسته‌های فضای‌نام ضمنی (PEP 420) استفاده می‌کنند، ریشه(های) سورس باید
با استفاده از گزینهٔ \fB\-\-source\-roots\fP مشخص شوند. در غیر این صورت، نام بسته‌ها
به اشتباه تشخیص داده می‌شود، زیرا بسته‌های فضای‌نام ضمنی فاقد فایل \fB__init__.py\fP\& هستند.
.SS پشتیبانی از تطبیق الگو (Globbing support)
.sp
همچنین امکان مشخص کردن دایرکتوری‌ها و فایل‌ها با استفاده از الگوهای تطبیق (globbing patterns) وجود دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pylint [options] packages/*/src
.EE
.UNINDENT
.UNINDENT
.SS گزینه‌های خط فرمان (Command line options)
.sp
پیش از هر چیز، دو گزینهٔ پایه (اما کاربردی) وجود دارد.
.INDENT 0.0
.TP
.B  \-\-version
نمایش شمارهٔ نسخهٔ برنامه و خروج
.TP
.B  \-h\fP,\fB  \-\-help
نمایش راهنما دربارهٔ گزینه‌های خط فرمان
.UNINDENT
.sp
ابزار Pylint بر پایهٔ چندین بررسی‌کننده (checker) معماری شده است. شما می‌توانید یک بررسی‌کنندهٔ
خاص یا برخی از پیام‌ها یا دسته‌های پیام آن را با مشخص کردن
\fB\-\-disable=<symbol>\fP\& غیرفعال کنید. اگر می‌خواهید تنها برخی از بررسی‌کننده‌ها یا برخی از
نمادهای پیام را فعال کنید، ابتدا از \fB\-\-disable=all\fP و سپس از
\fB\-\-enable=<symbol>\fP استفاده کنید که در آن \fB<symbol>\fP فهرستی از نام‌های بررسی‌کننده
و نمادهای پیام جداشده با کاما است. برای شرح بررسی‌کننده‌های ارائه‌شده همراه با قابلیت‌هایشان،
فهرست ویژگی‌های موجود را ببینید.
گزینه‌های \fB\-\-disable\fP و \fB\-\-enable\fP را می‌توان با فهرست‌های جداشده با کاما
شامل ترکیبی از بررسی‌کننده‌ها، شناسه‌های پیام و دسته‌ها مانند \fB\-d C,W,no\-error,design\fP به کار برد
.sp
غیرفعال کردن همهٔ پیام‌ها با \fB\-\-disable=all\fP\& امکان‌پذیر است. این کار برای
فعال کردن تنها چند بررسی‌کننده یا چند پیام، با ابتدا غیرفعال کردن همه‌چیز و سپس
فعال‌سازی دوبارهٔ تنها مواردی که نیاز دارید، کاربردی است.
.sp
هر بررسی‌کننده گزینه‌های خاصی دارد که می‌توانند یک مقدار yes/no، یک عدد صحیح،
یک عبارت باقاعدهٔ Python، یا فهرستی از مقادیر جداشده با کاما (که عموماً برای
بازنویسی یک عبارت باقاعده در شرایط خاص استفاده می‌شوند) دریافت کنند. برای فهرست کامل گزینه‌ها، از \fB\-\-help\fP استفاده کنید
.sp
مشخص کردن تمام گزینه‌های مناسب برای پیکربندی و استانداردهای کدنویسی شما
می‌تواند خسته‌کننده باشد؛ بنابراین می‌توان از یک فایل پیکربندی برای تعیین
مقادیر پیش‌فرض استفاده کرد. می‌توانید یک فایل پیکربندی را در خط فرمان با استفاده
از گزینهٔ \fB\-\-rcfile\fP مشخص کنید. در غیر این صورت، Pylint به ترتیب زیر به دنبال فایل
پیکربندی می‌گردد و از اولین موردی که بیابد استفاده می‌کند:
.INDENT 0.0
.IP 1. 4
فایل \fBpylintrc\fP در دایرکتوری کاری فعلی
.IP 2. 4
فایل \fBpylintrc.toml\fP در دایرکتوری کاری فعلی،
به شرطی که دست‌کم یک بخش \fBtool.pylint.\fP داشته باشد.
.IP 3. 4
فایل \fB\&.pylintrc\fP در دایرکتوری کاری فعلی
.IP 4. 4
فایل \fB\&.pylintrc.toml\fP در دایرکتوری کاری فعلی،
به شرطی که دست‌کم یک بخش \fBtool.pylint.\fP داشته باشد.
.IP 5. 4
فایل \fBpyproject.toml\fP در دایرکتوری کاری فعلی،
به شرطی که دست‌کم یک بخش \fBtool.pylint.\fP داشته باشد.
در \fBpyproject.toml\fP باید نام بخش‌ها با پیشوند \fBtool.pylint.\fP آغاز شود،
برای نمونه \fB[tool.pylint.\(aqMESSAGES CONTROL\(aq]\fP\&. آن‌ها همچنین می‌توانند از
طریق خط فرمان ارسال شوند.
.IP 6. 4
فایل \fBsetup.cfg\fP در دایرکتوری کاری فعلی،
به شرطی که دست‌کم یک بخش \fBpylint.\fP داشته باشد
.IP 7. 4
فایل \fBtox.ini\fP در دایرکتوری کاری فعلی،
به شرطی که دست‌کم یک بخش \fBpylint.\fP داشته باشد
.IP 8. 4
ابزار Pylint برای یافتن فایل \fBpyproject.toml\fP سلسله‌مراتب دایرکتوری‌ها را به سمت بالا جستجو می‌کند،
مگر آن‌که فایل پیدا شود، یا یک دایرکتوری \fB\&.git\fP/\fB\&.hg\fP یافت شود، یا به ریشهٔ
سیستم‌فایل رسیده باشد.
.IP 9. 4
اگر دایرکتوری کاری فعلی در یک بستهٔ Python باشد، Pylint سلسله‌مراتب بسته‌های Python را به سمت بالا تا زمانی که یک فایل \fBpylintrc\fP بیابد جستجو می‌کند. این به شما امکان می‌دهد استانداردهای کدنویسی را بر پایهٔ هر ماژول مشخص کنید. البته، در صورتی یک دایرکتوری یک بستهٔ Python محسوب می‌شود که شامل یک فایل \fB__init__.py\fP باشد.
.IP 10. 4
فایل مشخص‌شده توسط متغیر محیطی \fBPYLINTRC\fP
.IP 11. 4
اگر یک دایرکتوری خانگی دارید که \fB/root\fP نیست:
.INDENT 4.0
.IP 1. 3
فایل \fB\&.pylintrc\fP در دایرکتوری خانگی شما
.IP 2. 3
فایل \fB\&.config/pylintrc\fP در دایرکتوری خانگی شما
.UNINDENT
.IP 12. 4
\fB/etc/pylintrc\fP
.UNINDENT
.sp
گزینهٔ \fB\-\-generate\-toml\-config\fP یک فایل پیکربندی همراه با توضیحات را بر اساس
پیکربندی فعلی در خروجی استاندارد تولید کرده و خارج می‌شود. این شامل موارد
زیر است:
.INDENT 0.0
.IP \(bu 2
هر فایل پیکربندی پیدا شده همان‌گونه که در بالا توضیح داده شد
.IP \(bu 2
گزینه‌هایی که قبل از \fB\-\-generate\-toml\-config\fP در خط فرمان Pylint آمده‌اند
.UNINDENT
.sp
البته شما همچنین می‌توانید با مقادیر پیش‌فرض شروع کرده و پیکربندی را به‌صورت دستی
تنظیم کنید.
.sp
سایر گزینه‌های سراسری کاربردی عبارتند از:
.INDENT 0.0
.TP
.BI \-\-ignore\fB= <file[,file...]>
فایل‌ها یا دایرکتوری‌هایی که باید نادیده گرفته شوند. آن‌ها باید
نام پایه (base name) باشند، نه مسیر کامل.
.TP
.BI \-\-output\-format\fB= <format>
انتخاب قالب خروجی (text، json، custom).
.TP
.BI \-\-msg\-template\fB= <template>
تغییر الگوی پیام خروجی متنی.
.TP
.B  \-\-list\-msgs
تولید پیام‌های pylint.
.TP
.B  \-\-list\-msgs\-enabled
نمایش فهرستی از پیام‌هایی که با پیکربندی داده‌شده فعال و
غیرفعال هستند.
.TP
.B  \-\-full\-documentation
تولید مستندات کامل pylint، در قالب reST.
.UNINDENT.SS "اجرای موازی (Parallel execution)"
.sp
امکان افزایش سرعت اجرای Pylint وجود دارد. اگر رایانه بیش از یک پردازنده (CPU) داشته باشد، کار بررسی تمامی فایل‌ها می‌تواند از طریق زیرپردازه‌های Pylint روی تمامی هسته‌ها تقسیم شود.
.sp
این قابلیت از طریق پارامتر خط فرمان \fB\-j\fP ارائه می‌شود.
اگر عدد ارائه‌شده 0 باشد، تعداد کل پردازنده‌ها به‌طور خودکار تشخیص داده شده و استفاده می‌شود.
.sp
مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pylint \-j 4 mymodule1.py mymodule2.py mymodule3.py mymodule4.py
.EE
.UNINDENT
.UNINDENT
.sp
این دستور ۴ زیرپردازهٔ موازی Pylint ایجاد می‌کند که در آن هر ماژول مشخص‌شده به‌طور موازی بررسی می‌شود. مشکلات کشف‌شده توسط بررسی‌کننده‌ها بلافاصله نمایش داده نمی‌شوند، بلکه درست پس از اتمام بررسی یک ماژول نشان داده خواهند شد.
.sp
شما همچنین می‌توانید موازی‌سازی مدنظر خود را با چند بار اجرای pylint روی زیرمجموعه‌هایی از فایل‌هایتان انجام دهید (مشابه رفتاری که \fBpre\-commit\fP با مقدار پیش‌فرض \fBrequire_serial=false\fP انجام می‌دهد). با این حال آگاه باشید: pylint باید تمام کد شما را به یک‌باره تجزیه و تحلیل کند تا بتواند مقادیر واقعی حاصل از فراخوانی‌ها را به بهترین شکل استنتاج کند. اگر تنها بخشی از فایل‌ها به آن داده شود، ممکن است pylint نوع یک مقدار خاص را نادیده بگیرد و استنتاج ضعیف‌تری برای آن زیرمجموعه ارائه دهد. همچنین ممکن است با تغییر مجموعهٔ فایل‌ها، نتایج به‌طور غیرمنتظره‌ای متفاوت باشد؛ زیرا تقسیم‌بندی جدید می‌تواند استنتاج را تغییر دهد. بنابراین، اگر صحت و قطعی بودن نتایج برای شما مهم است، این کار را انجام ندهید.
.SS "کدهای خروج (Exit codes)"
.sp
برنامهٔ Pylint کدهای خروج کدگذاری‌شده با بیت (bit\-encoded) را برمی‌گرداند.
.TS
box center;
l|l.
T{
کد خروج
T}	T{
مفهوم
T}
_
T{
0
T}	T{
بدون خطا
T}
_
T{
1
T}	T{
پیام مهلک (fatal) صادر شده است
T}
_
T{
2
T}	T{
پیام خطا (error) صادر شده است
T}
_
T{
4
T}	T{
پیام هشدار (warning) صادر شده است
T}
_
T{
8
T}	T{
پیام بازسازی کد (refactor) صادر شده است
T}
_
T{
16
T}	T{
پیام شیوه‌نامه (convention) صادر شده است
T}
_
T{
32
T}	T{
خطای نحوهٔ استفاده (usage error)
T}
.TE
.sp
برای مثال، کد خروج \fB20\fP به این معنی است که حداقل یک پیام هشدار (4) و حداقل یک پیام شیوه‌نامه (16) وجود داشته و هیچ خطای دیگری رخ نداده است..SS خروجی Pylint
.SS گزینه‌های خروجی
.sp
خروجی به صورت پیش‌فرض در stdout نوشته می‌شود. ساده‌ترین راه برای فرستادن خروجی به یک فایل، استفاده از گزینهٔ \fB\-\-output=<filename>\fP است.
.sp
قالب پیش‌فرض برای خروجی، متن خام است. می‌توانید با دادن گزینهٔ \fB\-\-output\-format=<value>\fP به pylint این را تغییر دهید. مقادیر ممکن عبارتند از:
.INDENT 0.0
.IP \(bu 2
\fBtext\fP
.IP \(bu 2
\fBparseable\fP
.IP \(bu 2
\fBcolorized\fP
.IP \(bu 2
\fBjson2\fP: قالب بهبود‌یافتهٔ json
.IP \(bu 2
\fBjson\fP: قالب قدیمی json
.IP \(bu 2
\fBmsvs\fP: برای visual studio
.IP \(bu 2
\fBgithub\fP: پیام‌های GitHub action \%<https://\:docs\:.github\:.com/\:en/\:actions/\:writing-workflows/\:choosing-what-your-workflow-does/\:workflow-commands-for-github-actions>
.UNINDENT
.sp
با ارسال فهرستی از قالب‌ها که با کاما از هم جدا شده‌اند به \fB\-\-output\-format\fP، می‌توان چندین قالب خروجی را به طور همزمان استفاده کرد.
این خروجی را می‌توان با مشخص کردن نام فایل پس از دونقطه (:) به یک فایل هدایت کرد.
.sp
برای نمونه، جهت ذخیرهٔ گزارش json در \fBsomefile.json\fP و همزمان چاپ گزارشی رنگی در stdout:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\-\-output\-format=json:somefile.json,colorized
.EE
.UNINDENT
.UNINDENT
.SS قالب‌های سفارشی پیام
.sp
می‌توانید شیوهٔ دقیق نمایش اطلاعات را با استفاده از گزینهٔ \fI\-\-msg\-template=<format string>\fP سفارشی‌سازی کنید. \fIformat string\fP از نحو جدید قالب‌بندی پایتون \%<https://\:docs\:.python\:.org/\:2/\:library/\:string\:.html#\:formatstrings> بهره می‌برد و فیلدهای زیر در دسترس هستند:
.INDENT 0.0
.TP
.B path
مسیر نسبی فایل
.TP
.B abspath
مسیر مطلق فایل
.TP
.B line
شمارهٔ خط
.TP
.B column
شمارهٔ ستون
.TP
.B end_line
شمارهٔ خط پایان گره (node)
.TP
.B end_column
شمارهٔ ستون پایان گره (node)
.TP
.B module
نام ماژول
.TP
.B obj
شیء درون ماژول (در صورت وجود)
.TP
.B msg
متن پیام
.TP
.B msg_id
کد پیام (مثلاً I0011)
.TP
.B symbol
نام نمادین پیام (مثلاً locally\-disabled)
.TP
.B C
نشانهٔ تک‌حرفی دسته‌بندی پیام
.TP
.B category
نام کامل دسته‌بندی پیام
.UNINDENT
.sp
برای نمونه، قالب پیش‌فرض پیشین (قبل از 1.0) را می‌توان با این دستور به دست آورد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pylint \-\-msg\-template=\(aq{msg_id}:{line:3d},{column}: {obj}: {msg}\(aq
.EE
.UNINDENT
.UNINDENT
.sp
چند نمونهٔ دیگر:
.INDENT 0.0
.IP \(bu 2
قالب پیش‌فرض:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
{path}:{line}:{column}: {msg_id}: {msg} ({symbol})
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
قالب سازگار با Visual Studio (قالب خروجی پیشین \(aqmsvs\(aq):
.INDENT 2.0
.INDENT 3.5
.sp
.EX
{path}({line}): [{msg_id}{obj}] {msg}
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
قالب Parseable (برای Emacs و مانند آن، قالب خروجی پیشین \(aqparseable\(aq):
.INDENT 2.0
.INDENT 3.5
.sp
.EX
{path}:{line}: [{msg_id}({symbol}), {obj}] {msg}
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گزینهٔ \fB\-\-msg\-template\fP تنها با گزارشگرهای متنی قابل ترکیب است (\fB\-\-output\-format\fP یا تعیین نشده باشد یا یکی از مقادیر parseable، colorized یا msvs باشد).
اگر هر دو گزینهٔ \fB\-\-output\-format\fP و \fB\-\-msg\-template\fP تعیین شوند، گزینهٔ \fB\-\-msg\-template\fP بر قالب خطی پیش‌فرضی که توسط کلاس گزارشگر تعریف شده است، اولویت خواهد داشت.
.sp
اگر مقادیر \fBend_line\fP یا \fBend_column\fP برابر با \fBNone\fP باشند، توسط \fBTextReporter\fP پیش‌فرض به صورت یک رشتهٔ خالی نمایش داده می‌شوند\&..SS بخش تحلیل کد منبع (Source code analysis section)
.sp
برای هر ماژول python، ابزار Pylint ابتدا چند نویسهٔ \(aq*\(aq و به‌دنبال آن
نام ماژول را نمایش می‌دهد. سپس، تعدادی پیام با قالب زیر نمایش داده می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
MESSAGE_TYPE: LINE_NUM:[OBJECT:] MESSAGE
.EE
.UNINDENT
.UNINDENT
.sp
می‌توانید با استفاده از گزینهٔ \fB\-\-output\-format=parseable\fP قالب خروجی دیگری
دریافت کنید که بسیار کاربردی است، چرا که توسط اکثر ویرایشگرها و سایر ابزارهای
توسعه شناخته می‌شود.
.sp
نوع پیام می‌تواند یکی از موارد زیر باشد:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
پیام‌های اطلاعاتی ([I]nformational) که Pylint صادر می‌کند (در امتیاز تحلیل شما تأثیری ندارند)
.IP \(bu 2
بازآرایی ([R]efactor) برای نقض معیارهای \(dqروش‌های مناسب\(dq (good practice)
.IP \(bu 2
قرارداد ([C]onvention) برای نقض استانداردهای کدنویسی
.IP \(bu 2
هشدار ([W]arning) برای مشکلات شیوه‌ای (stylistic) یا مسائل جزئی برنامه‌نویسی
.IP \(bu 2
خطا ([E]rror) برای مسائل مهم برنامه‌نویسی (یعنی به احتمال زیاد باگ)
.IP \(bu 2
خطای مهلک ([F]atal) برای خطاهایی که مانع از ادامهٔ پردازش شده‌اند
.UNINDENT
.UNINDENT
.UNINDENT
.sp
گاهی خطی از کد که باعث خطا شده است همراه با یک علامت درج (caret: ^)
که به خطا اشاره می‌کند نمایش داده می‌شود. این ویژگی ممکن است در
نسخه‌های آیندهٔ Pylint تعمیم یابد.
.sp
مثال (برگرفته از اجرای Pylint روی خودش...):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
************* Module pylint.checkers.format
W: 50: Too long line (86/80)
W:108: Operator not followed by a space
     print >>sys.stderr, \(aqUnable to match %r\(aq, line
            ^
W:141: Too long line (81/80)
W: 74:searchall: Unreachable code
W:171:FormatChecker.process_tokens: Redefining built\-in (type)
W:150:FormatChecker.process_tokens: Too many local variables (20/15)
W:150:FormatChecker.process_tokens: Too many branches (13/12)
.EE
.UNINDENT
.UNINDENT
.SS بخش گزارش‌ها (Reports section)
.sp
به‌دنبال پیام‌های تحلیل، Pylint می‌تواند مجموعه‌ای از گزارش‌ها را نمایش دهد
که هر کدام بر جنبهٔ خاصی از پروژه تمرکز دارند؛ مانند تعداد پیام‌ها بر پایهٔ
دسته‌بندی، وابستگی‌های ماژول‌ها. این ویژگی‌ها را می‌توان از طریق
گزینهٔ \fB\-\-reports=y\fP یا نگارش کوتاه آن \fB\-ry\fP فعال کرد.
.sp
به‌عنوان مثال، گزارش معیارها خلاصه‌های جمع‌آوری‌شده از اجرای فعلی را
نمایش می‌دهد:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
تعداد ماژول‌های پردازش‌شده
.IP \(bu 2
برای هر ماژول، درصد خطاها و هشدارها
.IP \(bu 2
تعداد کل خطاها و هشدارها
.IP \(bu 2
درصد کلاس‌ها، توابع و ماژول‌های دارای docstring، همراه با مقایسه نسبت به اجرای پیشین
.IP \(bu 2
درصد کلاس‌ها، توابع و ماژول‌ها با نام‌گذاری صحیح (مطابق با استاندارد کدنویسی)، همراه با مقایسه نسبت به اجرای پیشین
.IP \(bu 2
فهرستی از وابستگی‌های خارجی یافت‌شده در کد و محل قرارگیری آن‌ها
.UNINDENT
.UNINDENT
.UNINDENT.SS بخش امتیازدهی (Score section)
.sp
در نهایت، Pylint یک امتیاز ارزیابی کلی برای کد نمایش می‌دهد که از حداکثر امتیاز ۱۰.۰ محاسبه
می‌شود. این خروجی را می‌توان از طریق گزینهٔ \fB\-\-score=n\fP یا فرم خلاصهٔ آن، \fB\-sn\fP\&،
غیرفعال کرد.
.sp
فرمول ارزیابی را می‌توان با گزینهٔ
\fB\-\-evaluation=<python_expression>\fP بازنویسی کرد.
.SS پیام‌ها (Messages)
.SS نمای کلی پیام‌ها (Messages overview)
.sp
Pylint می‌تواند پیام‌های زیر را صادر کند:
.SS مهلک (Fatal)
.sp
تمام پیام‌ها در دسته‌بندی مهلک (fatal):
.SS astroid\-error / F0002
.sp
\fBپیام صادرشده:\fP
.sp
\fB%s: %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که خطایی غیرمنتظره حین ساخت نمایش Astroid رخ داده باشد. این حالت معمولاً با یک traceback همراه است. لطفاً چنین خطاهایی را گزارش دهید!\fP
.sp
\fBجزئیات تکمیلی:\fP
.sp
این پیام مربوط به یک مشکل داخلی در pylint است. نیازی به تغییر در کد شما نیست،
اما شاید نیاز به تغییر در پیکربندی یا نحوهٔ نصب pylint باشد.
.sp
ایجادشده توسط بررسی‌کنندهٔ اصلی \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:lint/\:pylinter\:.py>.
.SS config\-parse\-error / F0011
.sp
\fBپیام صادرشده:\fP
.sp
\fBerror while parsing the configuration: %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که حین تجزیهٔ یک فایل پیکربندی pylint، استثنایی رخ داده باشد.\fP
.sp
\fBجزئیات تکمیلی:\fP
.sp
این پیام مربوط به مشکلی در پیکربندی شماست، نه کد شما.
.sp
ایجادشده توسط بررسی‌کنندهٔ اصلی \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:lint/\:pylinter\:.py>.
.SS fatal / F0001
.sp
\fBپیام صادرشده:\fP
.sp
\fB%s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که خطایی مانع از تحلیل یک ماژول شده باشد (برای نمونه، عدم توانایی در یافتن آن).\fP
.sp
\fBجزئیات تکمیلی:\fP
.sp
این پیام مربوط به یک مشکل داخلی در pylint است. نیازی به هیچ تغییری در کد شما نیست.
.sp
ایجادشده توسط بررسی‌کنندهٔ اصلی \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:lint/\:pylinter\:.py>.
.SS method\-check\-failed / F0202
.sp
\fBپیام صادرشده:\fP
.sp
\fBUnable to check methods signature (%s / %s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که Pylint به دلیلی غیرمنتظره نتوانسته است سازگاری امضای متدها را بررسی کند. لطفاً در صورتی که دلیلی برای آن نیافتید، این مورد را گزارش دهید.\fP
.sp
\fBجزئیات تکمیلی:\fP
.sp
این پیام مربوط به یک مشکل داخلی در pylint است. نیازی به هیچ تغییری در کد شما نیست.
.sp
ایجادشده توسط بررسی‌کنندهٔ classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>.
.SS parse\-error / F0010
.sp
\fBپیام صادرشده:\fP
.sp
\fBerror while code parsing: %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که حین ساخت نمایش Astroid استثنایی رخ داده باشد که توسط astroid قابل رسیدگی بود.\fP
.sp
\fBجزئیات تکمیلی:\fP
.sp
این پیام مربوط به یک مشکل داخلی در pylint است. نیازی به هیچ تغییری در کد شما نیست.
.sp
ایجادشده توسط بررسی‌کنندهٔ اصلی \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:lint/\:pylinter\:.py>.
.sp
تمام پیام‌های تغییرنام‌یافته در دسته‌بندی مهلک (fatal):.SS old\-import\-error / F0401
.sp
پیام \(aqold\-import\-error\(aq تغییر نام داده است. پیام جدید را می‌توانید در این بخش بیابید:
.SS import\-error / E0401
.sp
\fBپیام صادرشده:\fP
.sp
\fBUnable to import %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی به کار می‌رود که pylint نتواند ماژولی را وارد (import) کند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from patlib import Path  # [import\-error]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from pathlib import Path

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
این وضعیت ممکن است زمانی رخ دهد که بسته‌ای را وارد کنید که در محیط شما نصب نشده است، یا اینکه دچار غلط املایی شده باشید.
.sp
راه‌حل این است که بسته را از طریق pip/setup.py/wheel نصب نمایید یا غلط تایپی را برطرف سازید.
.sp
ایجادشده توسط بررسی‌کننده imports \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:imports\:.py>.
.SS خطا (Error)
.sp
تمام پیام‌های موجود در دسته‌بندی خطا:
.SS abstract\-class\-instantiated / E0110
.sp
\fBپیام صادرشده:\fP
.sp
\fBAbstract class %r with abstract methods instantiated\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که از یک کلاس انتزاعی با فراکلاس \(gaabc.ABCMeta\(ga که دارای متدهای انتزاعی است، نمونه‌سازی (instantiate) شده باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import abc


class Animal(abc.ABC):
    @abc.abstractmethod
    def make_sound(self):
        pass


sheep = Animal()  # [abstract\-class\-instantiated]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import abc


class Animal(abc.ABC):
    @abc.abstractmethod
    def make_sound(self):
        pass


class Sheep(Animal):
    def make_sound(self):
        print(\(dqbhaaaaa\(dq)


sheep = Sheep()

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_error_checker\:.py>..SS access\-member\-before\-definition / E0203
.sp
\fBپیام صادرشده:\fP
.sp
\fBدسترسی به عضو %r پیش از سطر تعریف آن %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که به یکی از اعضای نمونه پیش از مقداردهی واقعی آن دسترسی پیدا شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Unicorn:
    def __init__(self, fluffiness_level):
        if self.fluffiness_level > 9000:  # [access\-member\-before\-definition]
            print(\(dqIt\(aqs OVER\-FLUFFYYYY ! *crush glasses*\(dq)
        self.fluffiness_level = fluffiness_level

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Unicorn:
    def __init__(self, fluffiness_level):
        self.fluffiness_level = fluffiness_level
        if self.fluffiness_level > 9000:
            print(\(dqIt\(aqs OVER\-FLUFFYYYY ! *crush glasses*\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>.
.SS assigning\-non\-slot / E0237
.sp
\fBپیام صادرشده:\fP
.sp
\fBانتساب به ویژگی %r که در slots کلاس تعریف نشده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که به ویژگی‌ای که در slots کلاس تعریف نشده است، مقداری منتسب شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Student:
    __slots__ = (\(dqname\(dq,)

    def __init__(self, name, surname):
        self.name = name
        self.surname = surname  # [assigning\-non\-slot]
        self.setup()

    def setup(self):
        pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Student:
    __slots__ = (\(dqname\(dq, \(dqsurname\(dq)

    def __init__(self, name, surname):
        self.name = name
        self.surname = surname
        self.setup()

    def setup(self):
        pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>..SS assignment\-from\-no\-return / E1111
.sp
\fBپیام صادرشده:\fP
.sp
\fBانتساب نتیجه فراخوانی یک تابع، در حالی که تابع هیچ مقداری بازنمی‌گرداند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که نتیجه فراخوانی یک تابع منتسب شود، اما تابع استنتاج‌شده هیچ مقداری را بازنگرداند.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def add(x, y):
    print(x + y)


value = add(10, 10)  # [assignment\-from\-no\-return]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد تصحیح‌شده:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def add(x, y):
    return x + y


value = add(10, 10)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>.
.SS assignment\-from\-none / E1128
.sp
\fBپیام صادرشده:\fP
.sp
\fBانتساب نتیجه فراخوانی یک تابع، در حالی که تابع None بازمی‌گرداند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که نتیجه فراخوانی یک تابع منتسب شود، اما تابع استنتاج‌شده چیزی جز None بازنگرداند.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def function():
    return None


f = function()  # [assignment\-from\-none]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد تصحیح‌شده:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def function():
    return None


f = function() if function() else 1

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>..SS async\-context\-manager\-with\-regular\-with / E1145
.sp
\fBپیام صادرشده:\fP
.sp
\fBمدیر زمینه \(aq%s\(aq ناهمگام است و باید با \(aqasync with\(aq استفاده شود.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک مدیر زمینه ناهمگام به جای \(aqasync with\(aq با یک دستور معمولی \(aqwith\(aq به کار رود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from contextlib import asynccontextmanager


@asynccontextmanager
async def async_context():
    yield


with async_context():  # [async\-context\-manager\-with\-regular\-with]
    print(\(dqThis will cause an error at runtime\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import asyncio
from contextlib import asynccontextmanager


@asynccontextmanager
async def async_context():
    yield


async def main():
    async with async_context():
        print(\(dqThis works correctly\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
PEP 492 \- کوروتین‌ها با نحو async و await \%<https://\:peps\:.python\:.org/\:pep-0492>
.IP \(bu 2
contextlib.asynccontextmanager \%<https://\:docs\:.python\:.org/\:3/\:library/\:contextlib\:.html#\:contextlib\:.asynccontextmanager>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>.
.SS await\-outside\-async / E1142
.sp
\fBپیام صادرشده:\fP
.sp
\fBعبارت \(aqawait\(aq باید درون یک تابع async به کار رود\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که await خارج از یک تابع async استفاده شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import asyncio


def main():
    await asyncio.sleep(1)  # [await\-outside\-async]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import asyncio


async def main():
    await asyncio.sleep(1)

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
PEP 492 \%<https://\:peps\:.python\:.org/\:pep-0492/#\:await-expression>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>..SS bad\-configuration\-section / E0014
.sp
\fBپیام صادرشده:\fP
.sp
\fBتنظیم نابجا در بخش پیکربندی سطح بالای \(aq%s\(aq یافت شد : \(aq%s\(aq\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که تنظیمی در سطح بالای یک پیکربندی toml شناسایی شود که نباید در آنجا باشد.\fP
.sp
\fBجزئیات تکمیلی:\fP
.sp
این خطا بین pylint 2.12 و pylint 2.14 (پیش از بازسازی ساختار argparse) زمانی رخ می‌داد که با یک نوع مقدار غیرمنتظره در یک پیکربندی toml مواجه می‌شدیم.
.sp
ایجادشده توسط بررسی‌کنندهٔ اصلی \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:lint/\:pylinter\:.py>.
.SS bad\-except\-order / E0701
.sp
\fBپیام صادرشده:\fP
.sp
\fBترتیب نادرست بندهای except (%s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که بندهای except به ترتیب درست (از خاص‌ترین به عام‌ترین) نباشند. اگر ترتیب را اصلاح نکنید، ممکن است برخی از استثناها توسط خاص‌ترین گرداننده گرفته نشوند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
try:
    print(int(input()))
except Exception:
    raise
except TypeError:  # [bad\-except\-order]
    # This block cannot be reached since TypeError exception
    # is caught by previous exception handler.
    raise

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
try:
    print(int(input()))
except TypeError:
    raise
except Exception:
    raise

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ exceptions \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:exceptions\:.py>.
.SS bad\-exception\-cause / E0705
.sp
\fBپیام صادرشده:\fP
.sp
\fBعلت استثنا روی چیزی تنظیم شده است که نه استثنا است و نه None\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که از نحو \(dqraise ... from ...\(dq استفاده شود، در حالی که علت استثنا نه یک استثنا باشد و نه None.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def divide(x, y):
    result = 0
    try:
        result = x / y
    except ZeroDivisionError:
        # +1: [bad\-exception\-cause]
        raise ValueError(f\(dqDivision by zero when dividing {x} by {y} !\(dq) from result
    return result

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def divide(x, y):
    result = 0
    try:
        result = x / y
    except ZeroDivisionError as exc:
        raise ValueError(f\(dqDivision by zero when dividing {x} by {y} !\(dq) from exc
    return result

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
دستور raise \%<https://\:docs\:.python\:.org/\:3/\:reference/\:simple_stmts\:.html#\:the-raise-statement>
.IP \(bu 2
زنجیره‌سازی صریح استثناها \%<https://\:peps\:.python\:.org/\:pep-3134/#\:explicit-exception-chaining> بر اساس PEP 3134
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ exceptions \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:exceptions\:.py>..SS bad\-format\-character / E1300
.sp
\fBپیام صادرشده:\fP
.sp
\fBUnsupported format character %r (%#02x) at index %d\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک نویسهٔ قالب‌بندیِ پشتیبانی‌نشده در یک رشتهٔ قالب به کار رفته باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dq%s %z\(dq % (\(dqhello\(dq, \(dqworld\(dq))  # [bad\-format\-character]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dq%s %s\(dq % (\(dqhello\(dq, \(dqworld\(dq))

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
این بررسی در حال حاضر تنها برای قالب‌بندی رشته‌ها به «سبک قدیمی» (old\-style) همان‌طور که در مثال‌ها دیده می‌شود، فعال است.
برای اطلاعات بیشتر، گزارش شمارۀ #6085 در \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6085> را ببینید.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
قواعد نحوی رشته‌های قالب \%<https://\:docs\:.python\:.org/\:3/\:library/\:string\:.html#\:formatstrings>
.IP \(bu 2
وبگاه PyFormat \%<https://\:pyformat\:.info>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>.
.SS bad\-plugin\-value / E0013
.sp
\fBپیام صادرشده:\fP
.sp
\fBPlugin \(aq%s\(aq is impossible to load, is it installed ? (\(aq%s\(aq)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک مقدار نامعتبر در \(aqload\-plugins\(aq به کار رفته باشد.\fP
.sp
\fBجزئیات بیشتر:\fP
.sp
یکی از افزونه‌های pylint شما بارگیری نمی‌شود. نیازی به تغییر در کد شما نیست،
اما پیکربندی pylint یا نصب آن با مشکل مواجه است.
.sp
برای نمونه، ممکن است یک غلط املایی وجود داشته باشد. پیکربندی زیر:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins = pylint.extensions.bad_biultin
.EE
.UNINDENT
.UNINDENT
.sp
باید به این صورت باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins = pylint.extensions.bad_builtin
.EE
.UNINDENT
.UNINDENT
.sp
یا افزونه‌ای که اضافه کرده‌اید در محیط شما قابل وارد کردن (importable) نیست.
.sp
ایجادشده توسط بررسی‌کنندهٔ main \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:lint/\:pylinter\:.py>..SS bad\-reversed\-sequence / E0111
.sp
\fBپیام صادر شده:\fP
.sp
\fBThe first reversed() argument is not a sequence\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که نخستین آرگومان تابع توکار ()reversed یک دنباله نباشد (__reversed__ یا __getitem__ و __len__ را پیاده‌سازی نکرده باشد)\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reversed({1, 2, 3, 4})  # [bad\-reversed\-sequence]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
reversed([1, 2, 3, 4])

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_checker\:.py>.
.SS bad\-str\-strip\-call / E1310
.sp
\fBپیام صادر شده:\fP
.sp
\fBSuspicious argument in %s.%s call\fP
.sp
\fBتوضیحات:\fP
.sp
\fIآرگومان فراخوانی str.{l,r,}strip حاوی یک نویسه تکراری است،\fP
.sp
\fBکد دارای اشکال:\fP
.sp
\fBhello_world.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqHello World\(dq.strip(\(dqHello\(dq)  # [bad\-str\-strip\-call]
# >>> \(aq World\(aq

.EE
.UNINDENT
.UNINDENT
.sp
\fBremove_abc_from_both_side.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqabcbc def bacabc\(dq.strip(\(dqabcbc \(dq)  # [bad\-str\-strip\-call]
# >>> \(aqdef\(aq

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.sp
\fBhello_world.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqHello World\(dq.strip(\(dqHelo\(dq)
# >>> \(aq World\(aq

.EE
.UNINDENT
.UNINDENT
.sp
\fBremove_abc_from_both_side.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqabcbc def bacabc\(dq.strip(\(dqabc \(dq)
# >>> \(aqdef\(aq

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
یک تصور نادرست رایج این است که \fBstr.strip(\(aqHello\(aq)\fP زیررشته‌ی \fB\(aqHello\(aq\fP را از ابتدا و انتهای رشته حذف می‌کند.
این‌گونه \fBنیست\fP.
برگرفته از مستندات \%<https://\:docs\:.python\:.org/\:3/\:library/\:stdtypes\:.html?\:highlight=strip#\:str\:.strip>:
.sp
> آرگومان chars یک پیشوند یا پسوند نیست؛ بلکه تمام ترکیب‌های مقادیر آن حذف می‌شوند
.sp
وجود نویسه‌های تکراری در فراخوانی \fBstr.strip\fP، گذشته از اینکه هیچ تأثیری بر نتیجه نهایی ندارد، ممکن است نشان‌دهنده این برداشت نادرست باشد.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
مستندات: str.strip([chars]) \%<https://\:docs\:.python\:.org/\:3/\:library/\:stdtypes\:.html?\:highlight=strip#\:str\:.strip>
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>..SS bad\-string\-format\-type / E1307
.sp
\fBپیام صادرشده:\fP
.sp
\fBآرگومان %r با نوع قالب‌بندی %r مطابقت ندارد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که نوع مورد نیاز رشتهٔ قالب‌بندی با نوع آرگومان واقعی سازگار نباشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dq%d\(dq % \(dq1\(dq)  # [bad\-string\-format\-type]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dq%d\(dq % 1)

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
این بررسی در حال حاضر تنها برای قالب‌بندی رشته‌ها به \(dqسبک قدیمی\(dq (old\-style) همان‌طور که در مثال‌ها دیده می‌شود، فعال است.
برای اطلاعات بیشتر، گزارش #6085 را در \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6163> ببینید.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
سینتکس رشتهٔ قالب‌بندی \%<https://\:docs\:.python\:.org/\:3/\:library/\:string\:.html#\:formatstrings>
.IP \(bu 2
PyFormat \%<https://\:pyformat\:.info>
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کنندهٔ string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>\&.
.SS bad\-super\-call / E1003
.sp
\fBپیام صادرشده:\fP
.sp
\fBآرگومان نخست نامعتبر %r به super() داده شده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که آرگومانی غیر از کلاس جاری به عنوان نخستین آرگومان تابع توکار super داده شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Animal:
    pass


class Tree:
    pass


class Cat(Animal):
    def __init__(self):
        super(Tree, self).__init__()  # [bad\-super\-call]
        super(Animal, self).__init__()

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Animal:
    pass


class Tree:
    pass


class Cat(Animal):
    def __init__(self):
        super(Animal, self).__init__()

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
در Python 2.7، تابع \fBsuper()\fP باید با کلاس خودش و \fBself\fP به عنوان آرگومان فراخوانی می‌شد (\fBsuper(Cat, self)\fP) که این امر می‌توانست منجر به اشتباه گرفتن کلاس والد و فرزند در کد شود.
.sp
در Python 3 روش توصیه‌شده، فراخوانی \fBsuper()\fP بدون آرگومان است (همچنین ببینید: \fBsuper\-with\-arguments\fP).
.sp
یک استثنا، فراخوانی \fBsuper()\fP روی یک کلاس والد غیرمستقیم است. این کار می‌تواند برای به‌دست آوردن متدی غیر از متد پیش‌فرض بازگردانده‌شده توسط \fBmro()\fP استفاده شود.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
مستندات super() \%<https://\:docs\:.python\:.org/\:3/\:library/\:functions\:.html#\:super>
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کنندهٔ newstyle \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:newstyle\:.py>\&..SS bare\-name\-capture\-pattern / E1901
.sp
\fBپیام صادرشده:\fP
.sp
\fBالگوی گرفتن نام \(gacase %s\(ga باقی الگوها را غیرقابل‌دسترس می‌کند. برای رفع این مشکل از یک نام نقطه‌دار (برای نمونه یک enum) استفاده کنید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که یک الگوی ضبط نام (name capture pattern) در دستور match استفاده شده باشد و گزاره‌های case در ادامهٔ آن وجود داشته باشند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
red = 0
green = 1
blue = 2


def func(color):
    match color:
        case red:  # [bare\-name\-capture\-pattern]
            print(\(dqI see red!\(dq)
        case green:  # [bare\-name\-capture\-pattern]
            print(\(dqGrass is green\(dq)
        case blue:
            print(\(dqI\(aqm feeling the blues :(\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from enum import Enum


class Color(Enum):
    RED = 0
    GREEN = 1
    BLUE = 2


def func(color: Color) \-> None:
    match color:
        case Color.RED:
            print(\(dqI see red!\(dq)
        case Color.GREEN:
            print(\(dqGrass is green\(dq)
        case Color.BLUE:
            print(\(dqI\(aqm feeling the blues :(\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
PEP 636 \%<https://\:peps\:.python\:.org/\:pep-0636/#\:matching-against-constants-and-enums>
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده match_statements \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:match_statements_checker\:.py>.
.SS bidirectional\-unicode / E2502
.sp
\fBپیام صادرشده:\fP
.sp
\fBحاوی نویسه‌های کنترلی است که می‌توانند اجازه دهند کد مبهم، متفاوت از آنچه نمایش داده می‌شود اجرا گردد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIیونیکدهای دوجهته (bidirectional unicode) معمولاً نویسه‌هایی نمایش‌داده‌نشده هستند که برای نمایش صحیح خطوط راست‌به‌چپ (RTL) (مانند چینی، ژاپنی، عربی، عبری و...) مورد نیازند. بنابراین آیا می‌توانید به این کد اعتماد کنید؟ آیا مطمئن هستید که در تمام ویرایشگرها به‌درستی نمایش داده می‌شود؟ اگر خودتان آن را ننوشته‌اید یا زبانتان راست‌به‌چپ نیست، نویسه‌های ویژه را حذف کنید؛ زیرا می‌توان از آن‌ها برای فریب شما در اجرای کدی استفاده کرد که کاری متفاوت از ظاهرش انجام می‌دهد.
اطلاعات بیشتر:
https://en.wikipedia.org/wiki/Bidirectional_text
https://trojansource.codes\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# +1: [bidirectional\-unicode]
example = \(dqx‏\(dq * 100  #    \(dq‏x\(dq is assigned

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
example = \(dqx[U+2194]\(dq * 100

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده unicode_checker \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:unicode\:.py>..SS broken\-collections\-callable / E6005
.sp
\fBپیام صادرشده:\fP
.sp
\fB\(aqcollections.abc.Callable\(aq درون Optional و Union در 3.9.0 / 3.9.1 معیوب است (به‌جای آن از \(aqtyping.Callable\(aq استفاده کنید)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاستفاده از \(ga\(gacollections.abc.Callable\(ga\(ga درون Optional و Union در پایتون 3.9.0 و 3.9.1 با مشکل مواجه است. در این موارد به‌جای آن از \(ga\(gatyping.Callable\(ga\(ga استفاده کنید. https://bugs.python.org/issue42965\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from collections.abc import Callable
from typing import Optional


def func() \-> Optional[Callable[[int], None]]:  # [broken\-collections\-callable]
    ...

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import Callable, Optional


def func() \-> Optional[Callable[[int], None]]: ...

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
py\-version=3.9
load\-plugins=pylint.extensions.typing

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
bpo\-42965 \%<https://\:bugs\:.python\:.org/\:issue42965>
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqtyping\(aq \%<#\:pylint-extensions-typing>
صادر می‌شود، که نیازمند بارگذاری افزونه \fBpylint.extensions.typing\fP است.
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده typing \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:typing\:.py>.
.SS broken\-noreturn / E6004
.sp
\fBپیام صادرشده:\fP
.sp
\fB\(aqNoReturn\(aq درون انواع مرکب در 3.7.0 / 3.7.1 معیوب است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاستفاده از \(ga\(gatyping.NoReturn\(ga\(ga درون انواع مرکب در پایتون 3.7.0 و 3.7.1 با مشکل مواجه است. اگر به درون‌نگری زمان اجرا وابسته نیستید، به‌جای آن از نشانه‌گذاری رشته‌ای استفاده کنید؛ مانند \(ga\(gaCallable[..., \(aqNoReturn\(aq]\(ga\(ga. https://bugs.python.org/issue34921\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import NoReturn, Union


def exploding_apple(apple) \-> Union[None, NoReturn]:  # [broken\-noreturn]
    print(f\(dq{apple} is about to explode\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import NoReturn


def exploding_apple(apple) \-> NoReturn:
    print(f\(dq{apple} is about to explode\(dq)
    raise Exception(\(dq{apple} exploded !\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
py\-version=3.7
load\-plugins=pylint.extensions.typing

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqtyping\(aq \%<#\:pylint-extensions-typing>
صادر می‌شود، که نیازمند بارگذاری افزونه \fBpylint.extensions.typing\fP است.
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده typing \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:typing\:.py>..SS catching\-non\-exception / E0712
.sp
\fBپیام صادرشده:\fP
.sp
\fBگرفتن استثنایی که از Exception ارث‌بری نمی‌کند: %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که کلاسی که از Exception ارث‌بری نمی‌کند، به‌عنوان استثنا در یک بند except به کار رود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class FooError:
    pass


try:
    1 / 0
except FooError:  # [catching\-non\-exception]
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class FooError(Exception):
    pass


try:
    1 / 0
except FooError:
    pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ exceptions \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:exceptions\:.py>.
.SS class\-variable\-slots\-conflict / E0242
.sp
\fBپیام صادرشده:\fP
.sp
\fBمقدار %r در slots با متغیر کلاس تداخل دارد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که مقداری در __slots__ با یک متغیر کلاس، property یا متد تداخل داشته باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Person:
    # +1: [class\-variable\-slots\-conflict, class\-variable\-slots\-conflict, class\-variable\-slots\-conflict]
    __slots__ = (\(dqage\(dq, \(dqname\(dq, \(dqsay_hi\(dq)
    name = None

    def __init__(self, age, name):
        self.age = age
        self.name = name

    @property
    def age(self):
        return self.age

    def say_hi(self):
        print(f\(dqHi, I\(aqm {self.name}.\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Person:
    __slots__ = (\(dq_age\(dq, \(dqname\(dq)

    def __init__(self, age, name):
        self._age = age
        self.name = name

    @property
    def age(self):
        return self._age

    def say_hi(self):
        print(f\(dqHi, I\(aqm {self.name}.\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>..SS declare\-non\-slot / E0245
.sp
\fBپیام صادرشده:\fP
.sp
\fBنام %r در __slots__ وجود ندارد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی صادر می‌شود که یک یادداشت نوع (type annotation) در یک کلاس، در فهرست نام‌های موجود در __slots__ وجود نداشته باشد و __slots__ نیز شامل مدخل __dict__ نباشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Student:
    __slots__ = (\(dqname\(dq,)

    name: str
    surname: str  # [declare\-non\-slot]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Student:
    __slots__ = (\(dqname\(dq, \(dqsurname\(dq)

    name: str
    surname: str

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>.
.SS dict\-iter\-missing\-items / E1141
.sp
\fBپیام صادرشده:\fP
.sp
\fBبازگشایی یک دیکشنری در پیمایش بدون فراخوانی .items()\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگام تلاش برای پیمایش یک dict بدون فراخوانی .items() صادر می‌شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
data = {\(dqParis\(dq: 2_165_423, \(dqNew York City\(dq: 8_804_190, \(dqTokyo\(dq: 13_988_129}
for city, population in data:  # [dict\-iter\-missing\-items]
    print(f\(dq{city} has population {population}.\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
data = {\(dqParis\(dq: 2_165_423, \(dqNew York City\(dq: 8_804_190, \(dqTokyo\(dq: 13_988_129}
for city, population in data.items():
    print(f\(dq{city} has population {population}.\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>.
.SS duplicate\-argument\-name / E0108
.sp
\fBپیام صادرشده:\fP
.sp
\fBنام آرگومان تکراری %r در تعریف تابع\fP
.sp
\fBتوضیحات:\fP
.sp
\fIنام‌های آرگومان تکراری در تعریف توابع، خطای نحوی هستند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def get_fruits(apple, banana, apple):  # [duplicate\-argument\-name]
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def get_fruits(apple, banana, orange):
    pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_error_checker\:.py>..SS duplicate\-bases / E0241
.sp
\fBپیام صادرشده:\fP
.sp
\fBپایه‌های تکراری برای کلاس %r\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاستفاده تکراری از کلاس‌های پایه در کلاس‌های مشتق‌شده باعث بروز TypeError می‌شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Animal:
    pass


class Cat(Animal, Animal):  # [duplicate\-bases]
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Animal:
    pass


class Bird(Animal):
    pass


class Cat(Animal):
    pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>.
.SS format\-needs\-mapping / E1303
.sp
\fBپیام صادرشده:\fP
.sp
\fBبرای رشته قالب‌بندی نگاشت انتظار می‌رفت، نه %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک رشته قالب‌بندی دارای مشخص‌کننده‌های تبدیل نام‌دار، به همراه آرگومانی به کار رود که نگاشت (mapping) نیست.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dq%(x)d %(y)d\(dq % [1, 2])  # [format\-needs\-mapping]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dq%(x)d %(y)d\(dq % {\(dqx\(dq: 1, \(dqy\(dq: 2})

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>..SS function\-redefined / E0102
.sp
\fBپیام صادرشده:\fP
.sp
\fB%s already defined line %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک تابع / کلاس / متد بازتعریف شده باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def get_email():
    pass


def get_email():  # [function\-redefined]
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def get_email():
    pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_error_checker\:.py>.
.SS inconsistent\-mro / E0240
.sp
\fBپیام صادرشده:\fP
.sp
\fBInconsistent method resolution order for class %r\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک کلاس ترتیب تفکیک متد (MRO) ناسازگاری داشته باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class A:
    pass


class B(A):
    pass


class C(A, B):  # [inconsistent\-mro]
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class A:
    pass


class B(A):
    pass


class C(B):  # or \(aqB, A\(aq or \(aqA\(aq but not \(aqA, B\(aq
    pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>..SS inherit\-non\-class / E0239
.sp
\fBپیام صادرشده:\fP
.sp
\fBارث‌بری از %r، که یک کلاس نیست.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک کلاس از چیزی که کلاس نیست ارث‌بری کند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit(bool):  # [inherit\-non\-class]
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    def __bool__(self):
        pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>.
.SS init\-is\-generator / E0100
.sp
\fBپیام صادرشده:\fP
.sp
\fBمتد __init__ یک مولد (generator) است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که متد ویژهٔ کلاس __init__ به دلیل وجود yield در بدنهٔ خود، به یک مولد (generator) تبدیل شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    def __init__(self, worms):  # [init\-is\-generator]
        yield from worms


apple = Fruit([\(dqFahad\(dq, \(dqAnisha\(dq, \(dqTabatha\(dq])

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    def __init__(self, worms):
        self.__worms = worms

    def worms(self):
        yield from self.__worms


apple = Fruit([\(dqFahad\(dq, \(dqAnisha\(dq, \(dqTabatha\(dq])
for worm in apple.worms():
    pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_error_checker\:.py>..SS invalid\-all\-format / E0605
.sp
\fBپیام صادرشده:\fP
.sp
\fBقالب نامعتبر برای __all__، باید tuple یا list باشد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که __all__ دارای قالبی نامعتبر باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
__all__ = \(dqCONST\(dq  # [invalid\-all\-format]

CONST = 42

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
__all__ = (\(dqCONST\(dq,)

CONST = 42

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>.
.SS invalid\-all\-object / E0604
.sp
\fBپیام صادرشده:\fP
.sp
\fBشیء نامعتبر %r در __all__، باید فقط شامل رشته‌ها باشد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک شیء نامعتبر (غیررشته‌ای) در __all__ قرار گیرد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
__all__ = (
    None,  # [invalid\-all\-object]
    Fruit,
    Worm,
)


class Fruit:
    pass


class Worm:
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
__all__ = [\(dqFruit\(dq, \(dqWorm\(dq]


class Fruit:
    pass


class Worm:
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.INDENT 0.0
.TP
.B از مرجع زبان پایتون – دستور import \%<https://\:docs\:.python\:.org/\:3/\:reference/\:simple_stmts\:.html#\:the-import-statement>:
\(dq\fIنام‌های عمومی\fP تعریف‌شده توسط یک ماژول با بررسی فضای نام ماژول برای یافتن متغیری به نام \fB__all__\fP مشخص می‌شوند؛ در صورت تعریف، باید دنباله‌ای از رشته‌ها باشد که نام‌های تعریف‌شده یا واردشده توسط آن ماژول هستند.\(dq
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
PEP 8 – شیوه‌نامه کدنویسی پایتون \%<https://\:peps\:.python\:.org/\:pep-0008/#\:module-level-dunder-names>
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>..SS invalid\-bool\-returned / E0304
.sp
\fBپیام صادرشده:\fP
.sp
\fB__bool__ مقدار bool برنمی‌گرداند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک متد __bool__ مقداری غیر از bool برگرداند\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class CustomBool:
    \(dq\(dq\(dq__bool__ returns an int\(dq\(dq\(dq

    def __bool__(self):  # [invalid\-bool\-returned]
        return 1

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class CustomBool:
    \(dq\(dq\(dq__bool__ returns \(gabool\(ga\(dq\(dq\(dq

    def __bool__(self):
        return True

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:special_methods_checker\:.py>.
.SS invalid\-bytes\-returned / E0308
.sp
\fBپیام صادرشده:\fP
.sp
\fB__bytes__ مقدار bytes برنمی‌گرداند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک متد __bytes__ مقداری غیر از bytes برگرداند\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class CustomBytes:
    \(dq\(dq\(dq__bytes__ returns <type \(aqstr\(aq>\(dq\(dq\(dq

    def __bytes__(self):  # [invalid\-bytes\-returned]
        return \(dq123\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class CustomBytes:
    \(dq\(dq\(dq__bytes__ returns <type \(aqbytes\(aq>\(dq\(dq\(dq

    def __bytes__(self):
        return b\(dqsome bytes\(dq

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:special_methods_checker\:.py>..SS invalid\-character\-backspace / E2510
.sp
\fBپیام صادرشده:\fP
.sp
\fBنویسهٔ backspace بدون گریز نامعتبر است، به‌جای آن از \(dq\eb\(dq استفاده کنید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIمکان‌نما را به عقب بازمی‌گرداند، بنابراین نویسهٔ بعد از آن روی نویسهٔ قبلی بازنویسی خواهد شد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
STRING = \(dqInvalid character backspace  \(dq  # [invalid\-character\-backspace]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
STRING = \(dqValid character backspace \eb\(dq

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ unicode_checker \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:unicode\:.py>.
.SS invalid\-character\-carriage\-return / E2511
.sp
\fBپیام صادرشده:\fP
.sp
\fBنویسهٔ carriage\-return بدون گریز نامعتبر است، به‌جای آن از \(dq\er\(dq استفاده کنید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIمکان‌نما را به ابتدای سطر می‌برد، نویسه‌های بعدی ابتدای سطر را بازنویسی خواهند کرد.\fP
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
STRING = \(dqValid carriage return: \er\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
این پیام به این دلیل وجود دارد که یکی از بررسی‌کننده‌های ما بسیار عمومی است، اما در استفادهٔ عادی هرگز
رخ نخواهد داد زیرا یک \fBsyntax\-error\fP است که مانع از ایجاد بازنمایی کد فایل توسط python ast
(و در نتیجه pylint) می‌شود.
.sp
ممکن است تنها با ارسال مستقیم یک گرهِ به‌درستی ساخته‌شده به بررسی‌کننده با آن روبرو شوید.
.sp
ایجادشده توسط بررسی‌کنندهٔ unicode_checker \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:unicode\:.py>.
.SS invalid\-character\-esc / E2513
.sp
\fBپیام صادرشده:\fP
.sp
\fBنویسهٔ esc بدون گریز نامعتبر است، به‌جای آن از \(dq\ex1B\(dq استفاده کنید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIمعمولاً کدهای گریزی را آغاز می‌کند که امکان کنترل اختیاری ترمینال را فراهم می‌سازند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
STRING = \(dqInvalid escape character  \(dq  # [invalid\-character\-esc]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
STRING = \(dqValid escape character \ex1b\(dq

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ unicode_checker \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:unicode\:.py>..SS invalid\-character\-nul / E2514
.sp
\fBپیام صادرشده:\fP
.sp
\fBنویسهٔ nul فرارنشده نامعتبر است، به جای آن از \(dq\e0\(dq استفاده کنید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIعمدتاً پایان ورودی برای پایتون.\fP
.sp
\fBجزئیات بیشتر:\fP
.sp
نیازی به استفاده از نویسه‌های پایان رشته نیست. اشیاء رشته‌ای طول خود را نگهداری می‌کنند.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
Null terminator در پایتون \%<https://\:stackoverflow\:.com/\:a/\:24410304/\:2519059>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ unicode_checker \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:unicode\:.py>.
.SS invalid\-character\-sub / E2512
.sp
\fBپیام صادرشده:\fP
.sp
\fBنویسهٔ sub فرارنشده نامعتبر است، به جای آن از \(dq\ex1A\(dq استفاده کنید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIترکیب کلیدهای Ctrl+Z به عنوان \(dqپایان متن\(dq در ویندوز. برخی برنامه‌ها (مانند type) ادامهٔ فایل را پس از آن نادیده می‌گیرند.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
STRING = \(dqInvalid character sub  \(dq  # [invalid\-character\-sub]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
STRING = \(dqValid character sub x1A\(dq

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ unicode_checker \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:unicode\:.py>.
.SS invalid\-character\-zero\-width\-space / E2515
.sp
\fBپیام صادرشده:\fP
.sp
\fBنویسهٔ zero\-width\-space (فاصله با پهنای صفر) فرارنشده نامعتبر است، به جای آن از \(dq\eu200B\(dq استفاده کنید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIنویسهٔ فاصلهٔ نامرئی می‌تواند اجرای واقعی کد را پنهان کند.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
STRING = \(dqInvalid character zero\-width\-space ​\(dq  # [invalid\-character\-zero\-width\-space]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
STRING = \(dqValid character zero\-width\-space u200B\(dq

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ unicode_checker \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:unicode\:.py>..SS invalid\-class\-object / E0243
.sp
\fBپیام صادرشده:\fP
.sp
\fBانتساب نامعتبر به \(aq__class__\(aq. باید یک تعریف کلاس باشد اما \(aq%s\(aq دریافت شد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک شیء نامعتبر به ویژگی __class__ منتسب شود. تنها یک کلاس مجاز است.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Apple:
    pass


Apple.__class__ = 1  # [invalid\-class\-object]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Apple:
    pass


class RedDelicious:
    pass


Apple.__class__ = RedDelicious

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده‌ی classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>.
.SS invalid\-enum\-extension / E0244
.sp
\fBپیام صادرشده:\fP
.sp
\fBگسترش کلاس ارث‌بری‌شده‌ی Enum با نام \(dq%s\(dq\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک کلاس برای گسترش یک کلاس ارث‌بری‌شده‌ی Enum تلاش کند. انجام این کار باعث بروز TypeError در زمان اجرا خواهد شد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from enum import Enum


class Color(Enum):
    ORANGE = 1
    CHERRY = 2


class Fruit(Color):  # [invalid\-enum\-extension]
    APPLE = 3

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from enum import Enum


class Color(Enum):
    ORANGE = 1
    CHERRY = 2


class Fruit(Enum):
    ORANGE = 1
    CHERRY = 2
    APPLE = 3

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده‌ی classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>..SS invalid\-envvar\-value / E1507
.sp
\fBپیام صادرشده:\fP
.sp
\fB%s از آرگومان نوع %s پشتیبانی نمی‌کند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIتوابع دستکاری متغیرهای محیطی فقط از آرگومان‌های نوع رشته پشتیبانی می‌کنند. https://docs.python.org/3/library/os.html#os.getenv را ببینید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import os

os.getenv(1)  # [invalid\-envvar\-value]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import os

os.getenv(\(dq1\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده stdlib \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:stdlib\:.py>.
.SS invalid\-field\-call / E3701
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده نامعتبر از field()، %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIمشخص‌کننده dataclasses.field() باید تنها به‌عنوان مقدار یک انتساب درون یک dataclass، یا درون تابع make_dataclass() استفاده شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from dataclasses import dataclass, field


@dataclass
class C:
    a: float
    b: float
    c: float

    field(init=False)  # [invalid\-field\-call]

    def __post_init__(self):
        self.c = self.a + self.b


print(field(init=False))  # [invalid\-field\-call]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from dataclasses import dataclass, field, make_dataclass

C = make_dataclass(
    \(dqC\(dq,
    [(\(dqx\(dq, int), \(dqy\(dq, (\(dqz\(dq, int, field(default=5))],
    namespace={\(dqadd_one\(dq: lambda self: self.x + 1},
)


@dataclass
class C:
    a: float
    b: float
    c: float = field(init=False)

    def __post_init__(self):
        self.c = self.a + self.b

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده dataclass \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:dataclass_checker\:.py>..SS invalid\-format\-returned / E0311
.sp
\fBپیام صادرشده:\fP
.sp
\fB__format__ مقدار str برنمی‌گرداند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که متد __format__ مقداری غیر از رشته بازگرداند\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class CustomFormat:
    \(dq\(dq\(dq__format__ returns <type \(aqint\(aq>\(dq\(dq\(dq

    def __format__(self, format_spec):  # [invalid\-format\-returned]
        return 1

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class CustomFormat:
    \(dq\(dq\(dq__format__ returns <type \(aqstr\(aq>\(dq\(dq\(dq

    def __format__(self, format_spec):
        return \(dqhello!\(dq

.EE
.UNINDENT
.UNINDENT
.sp
تولید شده توسط بررسی‌کنندهٔ classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:special_methods_checker\:.py>.
.SS invalid\-getnewargs\-ex\-returned / E0313
.sp
\fBپیام صادرشده:\fP
.sp
\fB__getnewargs_ex__ تاپلی شامل (tuple, dict) برنمی‌گرداند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که متد __getnewargs_ex__ مقداری را بازگرداند که به صورت tuple(tuple, dict) نباشد\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class CustomGetNewArgsEx:
    \(dq\(dq\(dq__getnewargs_ex__ returns tuple with incorrect arg length\(dq\(dq\(dq

    def __getnewargs_ex__(self):  # [invalid\-getnewargs\-ex\-returned]
        return (tuple(1), dict(x=\(dqy\(dq), 1)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class CustomGetNewArgsEx:
    \(dq\(dq\(dq__getnewargs_ex__ returns <type \(aqtuple\(aq>\(dq\(dq\(dq

    def __getnewargs_ex__(self):
        return ((1,), {\(dq2\(dq: 2})

.EE
.UNINDENT
.UNINDENT
.sp
تولید شده توسط بررسی‌کنندهٔ classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:special_methods_checker\:.py>..SS invalid\-getnewargs\-returned / E0312
.sp
\fBپیام صادرشده:\fP
.sp
\fB__getnewargs__ یک tuple بازنمی‌گرداند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی به کار می‌رود که متد __getnewargs__ چیزی غیر از tuple بازگرداند\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class CustomGetNewArgs:
    \(dq\(dq\(dq__getnewargs__ returns an integer\(dq\(dq\(dq

    def __getnewargs__(self):  # [invalid\-getnewargs\-returned]
        return 1

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class CustomGetNewArgs:
    \(dq\(dq\(dq__getnewargs__ returns <type \(aqtuple\(aq>\(dq\(dq\(dq

    def __getnewargs__(self):
        return (1, 2)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ classes در \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:special_methods_checker\:.py>.
.SS invalid\-hash\-returned / E0309
.sp
\fBپیام صادرشده:\fP
.sp
\fB__hash__ یک int بازنمی‌گرداند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی به کار می‌رود که متد __hash__ چیزی غیر از یک عدد صحیح (integer) بازگرداند\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class CustomHash:
    \(dq\(dq\(dq__hash__ returns dict\(dq\(dq\(dq

    def __hash__(self):  # [invalid\-hash\-returned]
        return {}

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class CustomHash:
    \(dq\(dq\(dq__hash__ returns \(gaint\(ga\(dq\(dq\(dq

    def __hash__(self):
        return 19

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ classes در \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:special_methods_checker\:.py>..SS invalid\-index\-returned / E0305
.sp
\fBپیام صادرشده:\fP
.sp
\fB__index__ مقدار int برنمی‌گرداند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که متد __index__ مقداری را برگرداند که عدد صحیح نیست\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class CustomIndex:
    \(dq\(dq\(dq__index__ returns a dict\(dq\(dq\(dq

    def __index__(self):  # [invalid\-index\-returned]
        return {\(dq19\(dq: \(dq19\(dq}

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class CustomIndex:
    \(dq\(dq\(dq__index__ returns <type \(aqint\(aq>\(dq\(dq\(dq

    def __index__(self):
        return 19

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بازبین classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:special_methods_checker\:.py>.
.SS invalid\-length\-hint\-returned / E0310
.sp
\fBپیام صادرشده:\fP
.sp
\fB__length_hint__ عدد صحیح غیرمنفی برنمی‌گرداند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که متد __length_hint__ مقداری را برگرداند که یک عدد صحیح غیرمنفی نیست\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class CustomLengthHint:
    \(dq\(dq\(dq__length_hint__ returns non\-int\(dq\(dq\(dq

    def __length_hint__(self):  # [invalid\-length\-hint\-returned]
        return 3.0

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class CustomLengthHint:
    \(dq\(dq\(dq__length_hint__ returns <type \(aqint\(aq>\(dq\(dq\(dq

    def __length_hint__(self):
        return 10

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بازبین classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:special_methods_checker\:.py>..SS invalid\-length\-returned / E0303
.sp
\fBپیام صادرشده:\fP
.sp
\fB__len__ عدد صحیح غیرمنفی برنمی‌گرداند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک متد __len__ مقداری را برگرداند که یک عدد صحیح غیرمنفی نیست\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class FruitBasket:
    def __init__(self, fruits):
        self.fruits = [\(dqApple\(dq, \(dqBanana\(dq, \(dqOrange\(dq]

    def __len__(self):  # [invalid\-length\-returned]
        return \-len(self.fruits)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class FruitBasket:
    def __init__(self, fruits):
        self.fruits = [\(dqApple\(dq, \(dqBanana\(dq, \(dqOrange\(dq]

    def __len__(self):
        return len(self.fruits)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:special_methods_checker\:.py>.
.SS invalid\-match\-args\-definition / E1902
.sp
\fBپیام صادرشده:\fP
.sp
\fB\(ga__match_args__\(ga باید یک تاپل از رشته‌ها باشد.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که \(ga__match_args__\(ga یک تاپل از رشته‌های مورد نیاز برای match نباشد.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Book:
    __match_args__ = [\(dqtitle\(dq, \(dqyear\(dq]  # [invalid\-match\-args\-definition]

    def __init__(self, title, year):
        self.title = title
        self.year = year

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Book:
    __match_args__ = (\(dqtitle\(dq, \(dqyear\(dq)

    def __init__(self, title, year):
        self.title = title
        self.year = year

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
مستندات Python \%<https://\:docs\:.python\:.org/\:3/\:reference/\:datamodel\:.html#\:customizing-positional-arguments-in-class-pattern-matching>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ match_statements \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:match_statements_checker\:.py>..SS invalid\-metaclass / E1139
.sp
\fBپیام صادرشده:\fP
.sp
\fBمتاکلاس نامعتبر %r استفاده شده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که تشخیص داده شود یک کلاس از چیزی به عنوان متاکلاس استفاده می‌کند که ممکن است برای استفاده به عنوان متاکلاس نامعتبر باشد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Apple(metaclass=int):  # [invalid\-metaclass]
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Plant:
    pass


class Apple(Plant):
    pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>.
.SS invalid\-repr\-returned / E0306
.sp
\fBپیام صادرشده:\fP
.sp
\fB__repr__ مقدار str برنمی‌گرداند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که متد __repr__ چیزی غیر از رشته برگرداند\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class CustomRepr:
    \(dq\(dq\(dq__repr__ returns <type \(aqint\(aq>\(dq\(dq\(dq

    def __repr__(self):  # [invalid\-repr\-returned]
        return 1

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class CustomRepr:
    \(dq\(dq\(dq__repr__ returns <type \(aqstr\(aq>\(dq\(dq\(dq

    def __repr__(self):
        return \(dqapples\(dq

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:special_methods_checker\:.py>..SS invalid\-sequence\-index / E1126
.sp
\fBپیام صادرشده:\fP
.sp
\fBنمایهٔ دنباله یک int،‏ slice یا نمونه‌ای با __index__ نیست\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک نوع دنباله با نوعی نامعتبر نمایه‌گذاری شود. انواع معتبر عبارتند از intها،‏ sliceها و اشیایی با متد __index__.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruits = [\(dqapple\(dq, \(dqbanana\(dq, \(dqorange\(dq]
print(fruits[\(dqapple\(dq])  # [invalid\-sequence\-index]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruits = [\(dqapple\(dq, \(dqbanana\(dq, \(dqorange\(dq]
print(fruits[0])

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
مراقب استفاده از \fB[True]\fP یا \fB[False]\fP به عنوان نمایهٔ دنباله باشید، زیرا \fBTrue\fP و \fBFalse\fP به ترتیب به صورت \fB1\fP و \fB0\fP ارزیابی می‌شوند و بدون ایجاد خطا، عنصر دوم و اول لیست را برمی‌گردانند.
.sp
ایجادشده توسط بررسی‌کنندهٔ typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>.
.SS invalid\-slice\-index / E1127
.sp
\fBپیام صادرشده:\fP
.sp
\fBنمایهٔ برش یک int،‏ None یا نمونه‌ای با __index__ نیست\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که نمایهٔ برش یک عدد صحیح، None یا شیئی با متد __index__ نباشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
LETTERS = [\(dqa\(dq, \(dqb\(dq, \(dqc\(dq, \(dqd\(dq]

FIRST_THREE = LETTERS[:\(dq3\(dq]  # [invalid\-slice\-index]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
LETTERS = [\(dqa\(dq, \(dqb\(dq, \(dqc\(dq, \(dqd\(dq]

FIRST_THREE = LETTERS[:3]

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>.
.SS invalid\-slice\-step / E1144
.sp
\fBپیام صادرشده:\fP
.sp
\fBگام برش نمی‌تواند 0 باشد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که گام برش 0 باشد و شیء، متد سفارشی __getitem__ را پیاده‌سازی نکرده باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
LETTERS = [\(dqa\(dq, \(dqb\(dq, \(dqc\(dq, \(dqd\(dq]

LETTERS[::0]  # [invalid\-slice\-step]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
LETTERS = [\(dqa\(dq, \(dqb\(dq, \(dqc\(dq, \(dqd\(dq]

LETTERS[::2]

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>..SS invalid\-slots / E0238
.sp
\fBپیام صادرشده:\fP
.sp
\fBInvalid __slots__ object\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک __slots__ نامعتبر در کلاس یافت شود. تنها یک رشته، یک شیء تکرارپذیر یا یک دنباله مجاز است.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Person:  # [invalid\-slots]
    __slots__ = 42

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Person:
    __slots__ = (\(dqname\(dq, \(dqage\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>.
.SS invalid\-slots\-object / E0236
.sp
\fBپیام صادرشده:\fP
.sp
\fBInvalid object %r in __slots__, must contain only non empty strings\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک شیء نامعتبر (غیررشته‌ای) در __slots__ قرار گیرد.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Person:
    __slots__ = (\(dqname\(dq, 3)  # [invalid\-slots\-object]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Person:
    __slots__ = (\(dqname\(dq, \(dqsurname\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
مستندات برای __slots__ \%<https://\:docs\:.python\:.org/\:3/\:reference/\:datamodel\:.html#\:slots>
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>.
.SS invalid\-star\-assignment\-target / E0113
.sp
\fBپیام صادرشده:\fP
.sp
\fBStarred assignment target must be in a list or tuple\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی صادر می‌شود که یک عبارت ستاره‌دار به‌عنوان مقصد انتساب ستاره‌دار استفاده شود.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
*fruit = [\(dqapple\(dq, \(dqbanana\(dq, \(dqorange\(dq]  # [invalid\-star\-assignment\-target]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruit = [\(dqapple\(dq, \(dqbanana\(dq, \(dqorange\(dq]

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_error_checker\:.py>..SS invalid\-str\-returned / E0307
.sp
\fBپیام صادرشده:\fP
.sp
\fB__str__ مقدار str بازنمی‌گرداند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی به کار می‌رود که متد __str__ چیزی غیر از یک رشته را بازگرداند.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class CustomStr:
    \(dq\(dq\(dq__str__ returns int\(dq\(dq\(dq

    def __str__(self):  # [invalid\-str\-returned]
        return 1

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class CustomStr:
    \(dq\(dq\(dq__str__ returns <type \(aqstr\(aq>\(dq\(dq\(dq

    def __str__(self):
        return \(dqoranges\(dq

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:special_methods_checker\:.py>.
.SS invalid\-unary\-operand\-type / E1130
.sp
\fBپیام صادرشده:\fP
.sp
\fB%s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی صادر می‌شود که یک عملوند یکانی روی شیئی به کار رود که از این نوع عملیات پشتیبانی نمی‌کند.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cherries = 10
eaten_cherries = int
cherries = \-eaten_cherries  # [invalid\-unary\-operand\-type]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cherries = 10
eaten_cherries = 2
cherries \-= eaten_cherries

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>.
.SS invalid\-unicode\-codec / E2501
.sp
\fBپیام صادرشده:\fP
.sp
\fBUTF\-16 و UTF\-32 با نسخه‌های پیشین سازگار نیستند. به‌جای آن‌ها از UTF\-8 استفاده کنید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIبرای سازگاری، به‌جای UTF\-16/UTF\-32 از UTF\-8 استفاده کنید. همچنین برای پیشینهٔ این موضوع به https://bugs.python.org/issue1503789 مراجعه کنید. و برای برخی از مشکلات احتمالی، برای نمونه هنگام استفاده از UTF\-16، https://softwareengineering.stackexchange.com/questions/102205 را ببینید.\fP
.sp
\fBجزئیات تکمیلی:\fP
.sp
این پیام یک جای‌نگه‌دار برای مشکلی احتمالی در آینده در رابطه با کدک‌های یونیکد است.
.sp
ایجادشده توسط بررسی‌کنندهٔ unicode_checker \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:unicode\:.py>..SS logging\-format\-truncated / E1201
.sp
\fBپیام صادرشده:\fP
.sp
\fBرشته قالب‌بندی لاگ‌گیری در میانه مشخص‌کننده تبدیل پایان می‌یابد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که رشته قالب دستور لاگ‌گیری پیش از پایان مشخص‌کننده تبدیل خاتمه یابد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import logging
import sys

logging.warning(\(dqPython version: %\(dq, sys.version)  # [logging\-format\-truncated]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import logging
import sys

logging.warning(\(dqPython version: %s\(dq, sys.version)

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده logging \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:logging\:.py>.
.SS logging\-too\-few\-args / E1206
.sp
\fBپیام صادرشده:\fP
.sp
\fBآرگومان‌های ناکافی برای رشته قالب‌بندی لاگ‌گیری\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که به رشته قالب‌بندی لاگ‌گیری، آرگومان‌های بسیار کمی اختصاص داده شود.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import logging

try:
    function()
except Exception as e:
    logging.error(\(dq%s error occurred: %s\(dq, e)  # [logging\-too\-few\-args]
    raise

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import logging

try:
    function()
except Exception as e:
    logging.error(\(dq%s error occurred: %s\(dq, type(e), e)
    raise

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده logging \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:logging\:.py>..SS logging\-too\-many\-args / E1205
.sp
\fBپیام صادرشده:\fP
.sp
\fBآرگومان‌های بیش از حد برای رشته قالب‌بندی لاگ‌گیری\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که به یک رشته قالب‌بندی لاگ‌گیری، بیش از حد آرگومان داده شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import logging

try:
    function()
except Exception as e:
    logging.error(\(dqError occurred: %s\(dq, type(e), e)  # [logging\-too\-many\-args]
    raise

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import logging

try:
    function()
except Exception as e:
    logging.error(\(dq%s error occurred: %s\(dq, type(e), e)
    raise

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده logging \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:logging\:.py>.
.SS logging\-unsupported\-format / E1200
.sp
\fBپیام صادرشده:\fP
.sp
\fBنویسه قالب‌بندی لاگ‌گیری پشتیبانی‌نشده %r (%#02x) در اندیس %d\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک نویسه قالب‌بندی پشتیبانی‌نشده در رشته قالب‌بندی دستور لاگ‌گیری به کار رود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import logging

logging.info(\(dq%s %y !\(dq, \(dqHello\(dq, \(dqWorld\(dq)  # [logging\-unsupported\-format]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import logging

logging.info(\(dq%s %s !\(dq, \(dqHello\(dq, \(dqWorld\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده logging \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:logging\:.py>..SS method\-hidden / E0202
.sp
\fBپیام صادرشده:\fP
.sp
\fBصفت تعریف‌شده در %s خط %s این متد را پنهان می‌کند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک کلاس متدی را تعریف کند که توسط یک صفت نمونه از یک کلاس والد یا تنظیم‌شده توسط کد بیرونی پنهان شده باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    def __init__(self, vitamins):
        self.vitamins = vitamins

    def vitamins(self):  # [method\-hidden]
        pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    def __init__(self, vitamins):
        self.vitamins = vitamins

    def antioxidants(self):
        pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>.
.SS misplaced\-bare\-raise / E0704
.sp
\fBپیام صادرشده:\fP
.sp
\fBدستور raise درون یک بند except قرار ندارد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک raise بدون آرگومان (bare raise) درون یک بند except استفاده نشده باشد. این کار خطایی تولید می‌کند، زیرا هیچ استثنای فعالی برای پرتاب مجدد وجود ندارد. یک استثنا در این قاعده، یک raise بدون آرگومان درون یک بند finally است که تا زمانی که استثنایی درون بلوک try ایجاد شده باشد ممکن است کار کند، اما با این وجود نوعی بوی بد کد (code smell) به شمار می‌رود و نباید به آن اتکا کرد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def validate_positive(x):
    if x <= 0:
        raise  # [misplaced\-bare\-raise]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def validate_positive(x):
    if x <= 0:
        raise ValueError(f\(dq{x} is not positive\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده exceptions \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:exceptions\:.py>..SS misplaced\-format\-function / E0119
.sp
\fBپیام صادرشده:\fP
.sp
\fBتابع format روی str فراخوانی نشده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که تابع format روی یک شیء str فراخوانی نشود؛ مانند انجام print(\(dqvalue: {}\(dq).format(123) به‌جای print(\(dqvalue: {}\(dq.format(123)). ممکن است این چیزی نباشد که کاربر قصد انجام آن را داشته است.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqValue: {}\(dq).format(\(dqCar\(dq)  # [misplaced\-format\-function]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqValue: {}\(dq.format(\(dqCar\(dq))

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_checker\:.py>.
.SS missing\-format\-string\-key / E1304
.sp
\fBپیام صادرشده:\fP
.sp
\fBکلید %r در دیکشنری رشتهٔ قالب وجود ندارد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک رشتهٔ قالب با مشخص‌کننده‌های تبدیل نام‌گذاری‌شده، همراه با دیکشنری‌ای به‌کار رود که شامل تمام کلیدهای مورد نیاز آن رشتهٔ قالب نیست.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# +1: [missing\-format\-string\-key]
fruit_prices = \(dq\(dq\(dq
Apple: %(apple_price)d ¤
Orange: %(orange_price)d ¤
\(dq\(dq\(dq % {
    \(dqapple_price\(dq: 42
}

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruit_prices = \(dq\(dq\(dq
Apple: %(apple_price)d ¤
Orange: %(orange_price)d ¤
\(dq\(dq\(dq % {
    \(dqapple_price\(dq: 42,
    \(dqorange_price\(dq: 87,
}

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>.
.SS missing\-kwoa / E1125
.sp
\fBپیام صادرشده:\fP
.sp
\fBآرگومان کلیدواژه‌ای اجباری %r در فراخوانی %s وجود ندارد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که در فراخوانی یک تابع، یک آرگومان فقط-کلیدواژه‌ای (keyword\-only) اجباری ارسال نشود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def target(pos, *, keyword):
    return pos + keyword


def not_forwarding_kwargs(*args, **kwargs):
    target(*args)  # [missing\-kwoa]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def target(pos, *, keyword):
    return pos + keyword


def not_forwarding_kwargs(*args, **kwargs):
    target(*args, **kwargs)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>..SS mixed\-format\-string / E1302
.sp
\fBپیام صادرشده:\fP
.sp
\fBترکیب مشخص‌کننده‌های تبدیل نام‌دار و بدون نام در رشته قالب‌بندی\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک رشته قالب‌بندی، هم شامل مشخص‌کننده‌های تبدیل نام‌دار (مانند \(aq%(foo)d\(aq) و هم بدون نام (مانند \(aq%d\(aq) باشد. همچنین زمانی استفاده می‌شود که یک مشخص‌کننده تبدیل نام‌دار شامل * برای حداقل عرض فیلد و/یا دقت باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqx=%(x)d, y=%d\(dq % (0, 1))  # [mixed\-format\-string]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.sp
\fBonly_named.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqx=%(x)d, y=%(y)d\(dq % {\(dqx\(dq: 0, \(dqy\(dq: 1})

.EE
.UNINDENT
.UNINDENT
.sp
\fBonly_ordered.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqx=%d, y=%d\(dq % (0, 1))

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>.
.SS modified\-iterating\-dict / E4702
.sp
\fBپیام صادرشده:\fP
.sp
\fBدیکشنری در حال پیمایش \(aq%s\(aq در داخل بدنه حلقه for در حال تغییر است؛ در عوض روی رونوشتی از آن پیمایش کنید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی صادر می‌شود که مواردی به یک dict در حال پیمایش اضافه یا از آن حذف شوند. انجام این کار باعث ایجاد خطای RuntimeError می‌شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruits = {\(dqapple\(dq: 1, \(dqorange\(dq: 2, \(dqmango\(dq: 3}

i = 0
for fruit in fruits:
    fruits[\(dqapple\(dq] = i  # [modified\-iterating\-dict]
    i += 1

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruits = {\(dqapple\(dq: 1, \(dqorange\(dq: 2, \(dqmango\(dq: 3}

i = 0
for fruit in fruits.copy():
    fruits[\(dqapple\(dq] = i
    i += 1

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده modified_iteration \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:modified_iterating_checker\:.py>..SS modified\-iterating\-set / E4703
.sp
\fBپیام صادرشده:\fP
.sp
\fBمجموعهٔ در حال پیمایش \(aq%s\(aq در بدنهٔ حلقهٔ for تغییر داده می‌شود، به‌جای آن روی یک رونوشت از آن پیمایش کنید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که مواردی به یک مجموعهٔ در حال پیمایش اضافه یا از آن حذف شوند. انجام این کار باعث ایجاد یک RuntimeError می‌شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruits = {\(dqapple\(dq, \(dqorange\(dq, \(dqmango\(dq}
for fruit in fruits:
    fruits.add(fruit + \(dqyum\(dq)  # [modified\-iterating\-set]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruits = {\(dqapple\(dq, \(dqorange\(dq, \(dqmango\(dq}
for fruit in fruits.copy():
    fruits.add(fruit + \(dqyum\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بازبین modified_iteration \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:modified_iterating_checker\:.py>.
.SS multiple\-class\-sub\-patterns / E1904
.sp
\fBپیام صادرشده:\fP
.sp
\fBچندین زیرالگو برای صفت %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که بیش از یک زیرالگو برای یک صفت مشخص در یک الگوی کلاس وجود داشته باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Book:
    __match_args__ = (\(dqtitle\(dq, \(dqyear\(dq)

    def __init__(self, title, year):
        self.title = title
        self.year = year


def func(item: Book):
    match item:
        case Book(\(dqabc\(dq, title=\(dqabc\(dq):  # [multiple\-class\-sub\-patterns]
            ...
        case Book(year=2000, year=2001):  # [multiple\-class\-sub\-patterns]
            ...

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Book:
    __match_args__ = (\(dqtitle\(dq, \(dqyear\(dq)

    def __init__(self, title, year):
        self.title = title
        self.year = year


def func(item: Book):
    match item:
        case Book(title=\(dqabc\(dq):
            ...
        case Book(year=2000):
            ...

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
مستندات Python \%<https://\:docs\:.python\:.org/\:3/\:reference/\:compound_stmts\:.html#\:class-patterns>
.UNINDENT
.sp
ایجاد شده توسط بازبین match_statements \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:match_statements_checker\:.py>..SS no\-member / E1101
.sp
\fBپیام صادرشده:\fP
.sp
\fB%s %r has no %r member%s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که به یک عضو ناموجود از یک متغیر دسترسی پیدا شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from pathlib import Path

directories = Path("\(dq.\(dq).mothers  # [no\-member]


class Cat:
    def meow(self):
        print("\(dqMeow\(dq)


Cat().roar()  # [no\-member]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد تصحیح‌شده:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from pathlib import Path

directories = Path("\(dq.\(dq).parents


class Cat:
    def meow(self):
        print("\(dqMeow\(dq)


Cat().meow()

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
اگر با خطای ناخوشایند \fBno\-member\fP مواجه شده‌اید، این احتمال وجود دارد که یکی از موارد زیر رخ داده باشد:
.INDENT 0.0
.IP \(bu 2
ابزار pylint یک باگ در کد شما پیدا کرده است
.IP \(bu 2
شما pylint را بدون نصب وابستگی‌ها در محیط اجرایی آن اجرا می‌کنید
.IP \(bu 2
بررسی کد مستلزم تحلیل یک ماژول اکستنشن C توسط pylint است و از انجام آن خودداری می‌کند
.IP \(bu 2
ابزار pylint کدهای تولیدشده به‌صورت پویا را درک نمی‌کند
.UNINDENT
.sp
تحلیل ماژول‌های اکستنشن C به‌صورت پیش‌فرض پشتیبانی نمی‌شود، به‌ویژه از آنجا که pylint راهی برای استخراج شیء AST از ماژول اکستنشن ندارد.
.sp
اما pylint در واقع سازوکاری دارد که در صورت تمایل به تحلیل اکستنشن‌های C می‌توانید از آن استفاده کنید. pylint پرچمی با نام \fBextension\-pkg\-allow\-list\fP (سابقاً \fBextension\-pkg\-whitelist\fP) دارد که از طریق آن می‌توانید به آن اعلام کنید که ماژول مربوطه را وارد (import) کرده و از آن ماژول واردشده یک AST بسازد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ pylint \-\-extension\-pkg\-allow\-list=your_c_extension
.EE
.UNINDENT
.UNINDENT
.sp
توجه داشته باشید که استفاده از این پرچم بدین معناست که اکستنشن‌ها درون مفسر فعال پایتون بارگذاری می‌شوند و ممکن است کدهای دلخواهی را اجرا کنند که شاید شما تمایلی به آن نداشته باشید. به همین دلیل است که بارگذاری اکستنشن‌های C به‌صورت پیش‌فرض غیرفعال است. در صورتی که نمی‌خواهید دردسر مشخص کردن مداوم ماژول‌های اکستنشن C را با این پرچم متحمل شوید، می‌توانید گزینهٔ \fBunsafe\-load\-any\-extension\fP را در فایل پیکربندی خود فعال کنید؛ این کار باعث ساخت اشیاء AST از تمام اکستنشن‌های C می‌شود که pylint با آن‌ها مواجه می‌گردد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ pylint \-\-unsafe\-load\-any\-extension=y
.EE
.UNINDENT
.UNINDENT
.sp
همچنین از آنجا که pylint برای صفاتی که در اکستنشن‌های C یافت نمی‌شوند خطای جداگانه‌ای تحت عنوان \fBc\-extension\-no\-member\fP صادر می‌کند، می‌توانید این خطا را برای پروژهٔ خود غیرفعال نمایید.
.sp
اگر چیزی به‌صورت پویا تولید شود، pylint قادر به فهم کد کتابخانهٔ شما (چه اکستنشن C باشد و چه نباشد) نخواهد بود. در این حالت می‌توانید صفات تولیدشده را با گزینهٔ \fBgenerated\-members\fP مشخص کنید. برای مثال اگر \fBcv2.LINE_AA\fP و \fBsphinx.generated_member\fP موارد مثبت کاذب برای \fBno\-member\fP ایجاد می‌کنند، می‌توانید این دستور را اجرا کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ pylint \-\-generated\-member=cv2.LINE_AA,sphinx.generated_member
.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>..SS no\-method\-argument / E0211
.sp
\fBپیام صادرشده:\fP
.sp
\fBMethod %r has no argument\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که متدی که باید نمونه مقید (bound instance) را به عنوان نخستین آرگومان داشته باشد، هیچ آرگومانی برای آن تعریف نشده باشد.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Person:
    def print_greeting():  # [no\-method\-argument]
        print(\(dqhello\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Person:
    def print_greeting(self):
        print(\(dqhello\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بازبین classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>.
.SS no\-name\-in\-module / E0611
.sp
\fBپیام صادرشده:\fP
.sp
\fBNo name %r in module %r\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که نامی در یک ماژول پیدا نشود.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from os import pizza  # [no\-name\-in\-module]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from os import path

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بازبین variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>.
.SS no\-self\-argument / E0213
.sp
\fBپیام صادرشده:\fP
.sp
\fBMethod %r should have \(dqself\(dq as first argument\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک متد آرگومانی غیر از \(dqself\(dq را به عنوان نخستین آرگومان خود داشته باشد. این مورد یک خطا در نظر گرفته می‌شود زیرا این قرارداد به قدری رایج است که نباید آن را زیر پا بگذارید!\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    def __init__(this, name):  # [no\-self\-argument]
        this.name = name

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    def __init__(self, name):
        self.name = name

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بازبین classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>..SS no\-value\-for\-parameter / E1120
.sp
\fBپیام صادرشده:\fP
.sp
\fBهیچ مقداری برای آرگومان %s در فراخوانی %s وجود ندارد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که در فراخوانی یک تابع، آرگومان‌های بسیار کمی ارسال شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def add(x, y):
    return x + y


add(1)  # [no\-value\-for\-parameter]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def add(x, y):
    return x + y


add(1, 2)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>.
.SS non\-iterator\-returned / E0301
.sp
\fBپیام صادرشده:\fP
.sp
\fB__iter__ یک غیرتکرارکننده بازمی‌گرداند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک متد __iter__ چیزی را بازگرداند که تکرارپذیر نیست (یعنی فاقد متد \(ga__next__\(ga است)\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import random


class GenericAstrology:
    def __init__(self, signs, predictions):
        self.signs = signs
        self.predictions = predictions

    def __iter__(self):  # [non\-iterator\-returned]
        self.index = 0
        self.number_of_prediction = len(self.predictions)
        return self


SIGNS = [\(dqAries\(dq, \(dqTaurus\(dq, \(dqGemini\(dq, \(dqCancer\(dq, \(dqLeo\(dq, \(dqVirgo\(dq, \(dqLibra\(dq]
PREDICTIONS = [\(dqgood things\(dq, \(dqbad thing\(dq, \(dqexistential dread\(dq]
for sign, prediction in GenericAstrology(SIGNS, PREDICTIONS):
    print(f\(dq{sign} : {prediction} today\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import random


class GenericAstrology:
    def __init__(self, signs, predictions):
        self.signs = signs
        self.predictions = predictions

    def __iter__(self):
        self.index = 0
        self.number_of_prediction = len(self.predictions)
        return self

    def __next__(self):
        if self.index == len(self.signs):
            raise StopIteration
        self.index += 1
        prediction_index = random.randint(0, self.number_of_prediction \- 1)
        return self.signs[self.index \- 1], self.predictions[prediction_index]


SIGNS = [\(dqAries\(dq, \(dqTaurus\(dq, \(dqGemini\(dq, \(dqCancer\(dq, \(dqLeo\(dq, \(dqVirgo\(dq, \(dqLibra\(dq]
PREDICTIONS = [\(dqgood things\(dq, \(dqbad thing\(dq, \(dqexistential dread\(dq]
for sign, prediction in GenericAstrology(SIGNS, PREDICTIONS):
    print(f\(dq{sign} : {prediction} today\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:special_methods_checker\:.py>..SS nonexistent\-operator / E0107
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از عملگر ناموجود %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که تلاش کنید از عملگرهای پیش‌افزایش یا پیش‌کاهش به سبک C (\-\- و ++) که در Python وجود ندارند، استفاده کنید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
i = 0

while i <= 10:
    print(i)
    ++i  # [nonexistent\-operator]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
i = 0

while i <= 10:
    print(i)
    i += 1

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_error_checker\:.py>.
.SS nonlocal\-and\-global / E0115
.sp
\fBپیام صادرشده:\fP
.sp
\fBنام %r هم nonlocal و هم global است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که یک نام، هم nonlocal و هم global باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
NUMBER = 42


def update_number(number):  # [nonlocal\-and\-global]
    global NUMBER
    nonlocal NUMBER
    NUMBER = number
    print(f\(dqNew global number is: {NUMBER}\(dq)


update_number(24)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
NUMBER = 42


def update_number(number):
    global NUMBER
    NUMBER = number
    print(f\(dqNew global number is: {NUMBER}\(dq)


update_number(24)

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_error_checker\:.py>..SS nonlocal\-without\-binding / E0117
.sp
\fBپیام صادرشده:\fP
.sp
\fBnonlocal name %s found without binding\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که یک متغیر nonlocal هیچ نام متصل‌شده‌ای در دامنه‌های والد نداشته باشد\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    def get_color(self):
        nonlocal colors  # [nonlocal\-without\-binding]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    colors = [\(dqred\(dq, \(dqgreen\(dq]

    def get_color(self):
        nonlocal colors

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_error_checker\:.py>.
.SS not\-a\-mapping / E1134
.sp
\fBپیام صادرشده:\fP
.sp
\fBNon\-mapping value %s is used in a mapping context\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک مقدار غیرنگاشت در جایی که نگاشت انتظار می‌رود، به کار رود\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def print_colors(**colors):
    print(colors)


print_colors(**list(\(dqred\(dq, \(dqblack\(dq))  # [not\-a\-mapping]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def print_colors(**colors):
    print(colors)


print_colors(**dict(red=1, black=2))

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>..SS not\-an\-iterable / E1133
.sp
\fBپیام صادرشده:\fP
.sp
\fBمقدار غیرقابل‌پیمایش %s در یک بافت پیمایشی استفاده شده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک مقدار غیرقابل‌پیمایش در جایی که انتظار یک شیء قابل‌پیمایش می‌رود به کار گرفته شود\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
for i in 10:  # [not\-an\-iterable]
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
for i in \(dq10\(dq:
    pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>.
.SS not\-async\-context\-manager / E1701
.sp
\fBپیام صادرشده:\fP
.sp
\fBمدیر زمینه ناهمگام \(aq%s\(aq متدهای __aenter__ و __aexit__ را پیاده‌سازی نکرده است.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک مدیر زمینه ناهمگام با شیئی به کار رود که پروتکل مدیریت زمینه ناهمگام را پیاده‌سازی نکرده است.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class ContextManager:
    def __enter__(self):
        pass

    def __exit__(self, *exc):
        pass


async def foo():
    async with ContextManager():  # [not\-async\-context\-manager]
        pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class AsyncContextManager:
    def __aenter__(self):
        pass

    def __aexit__(self, *exc):
        pass


async def foo():
    async with AsyncContextManager():
        pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
مدیر زمینه ناهمگام متدهای \fB__aenter__\fP و \fB__aexit__\fP را پیاده‌سازی نکرده است\&. این پیام هنگام استفاده از Python < 3.5 صادر نمی‌شود.
.sp
ایجاد شده توسط بررسی‌کننده async \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:async_checker\:.py>..SS not\-callable / E1102
.sp
\fBپیام صادرشده:\fP
.sp
\fB%s قابل فراخوانی نیست\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که شیء فراخوانی‌شده، به عنوان یک شیء غیرقابل فراخوانی استنتاج شده باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
NUMBER = 42
print(NUMBER())  # [not\-callable]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
NUMBER = 42
print(NUMBER)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>.
.SS not\-context\-manager / E1129
.sp
\fBپیام صادرشده:\fP
.sp
\fBمدیر زمینه \(aq%s\(aq متدهای __enter__ و __exit__ را پیاده‌سازی نکرده است.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک نمونه در دستور with پروتکل مدیر زمینه (__enter__/__exit__) را پیاده‌سازی نکرده باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class MyContextManager:
    def __enter__(self):
        pass


with MyContextManager() as c:  # [not\-context\-manager]
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class MyContextManager:
    def __enter__(self):
        pass

    def __exit__(self, *exc):
        pass


with MyContextManager() as c:
    pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>..SS not\-in\-loop / E0103
.sp
\fBپیام صادرشده:\fP
.sp
\fB%r به درستی درون حلقه قرار نگرفته است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که کلیدواژه‌های break یا continue بیرون از یک حلقه استفاده شده باشند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def print_even_numbers():
    for i in range(100):
        if i % 2 == 0:
            print(i)
    else:
        continue  # [not\-in\-loop]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def print_even_numbers():
    for i in range(100):
        if i % 2:
            continue
        print(i)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_error_checker\:.py>.
.SS notimplemented\-raised / E0711
.sp
\fBپیام صادرشده:\fP
.sp
\fBNotImplemented برانگیخته شده است \- باید NotImplementedError برانگیخته شود\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که به جای NotImplementedError، خودِ NotImplemented برانگیخته شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Worm:
    def bore(self):
        raise NotImplemented  # [notimplemented\-raised]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Worm:
    def bore(self):
        raise NotImplementedError

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده exceptions \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:exceptions\:.py>.
.SS positional\-only\-arguments\-expected / E3102
.sp
\fBپیام صادرشده:\fP
.sp
\fB\(ga%s()\(ga برخی آرگومان‌های فقط\-موقعیتی را به صورت آرگومان‌های کلیدواژه‌ای دریافت کرد: %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که آرگومان‌های فقط\-موقعیتی (positional\-only) به صورت آرگومان‌های کلیدواژه‌ای ارسال شده باشند. کلیدواژه‌ها را برای آرگومان‌های مربوطه در فراخوانی تابع حذف کنید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def cube(n, /):
    \(dq\(dq\(dqTakes in a number n, returns the cube of n\(dq\(dq\(dq
    return n**3


cube(n=2)  # [positional\-only\-arguments\-expected]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def cube(n, /):
    \(dq\(dq\(dqTakes in a number n, returns the cube of n\(dq\(dq\(dq
    return n**3


cube(2)

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
PEP 570 \%<https://\:peps\:.python\:.org/\:pep-570>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده method_args \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:method_args\:.py>..SS possibly\-used\-before\-assignment / E0606
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفادهٔ احتمالی از متغیر %r پیش از انتساب\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که به یک متغیر محلی پیش از انتساب مقدار به آن در هر دو شاخهٔ ساختار if/else دسترسی پیدا شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def check_lunchbox(items: list[str]):
    if not items:
        empty = True
    print(empty)  # [possibly\-used\-before\-assignment]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def check_lunchbox(items: list[str]):
    empty = False
    if not items:
        empty = True
    print(empty)

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
می‌توانید از \fBassert_never\fP برای مشخص کردن انتخاب‌های جامع (exhaustive) استفاده کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import assert_never

def handle_date_suffix(suffix):
    if suffix == \(dqd\(dq:
        ...
    elif suffix == \(dqm\(dq:
        ...
    elif suffix == \(dqy\(dq:
        ...
    else:
        assert_never(suffix)

if suffix in \(dqdmy\(dq:
    handle_date_suffix(suffix)
.EE
.UNINDENT
.UNINDENT
.sp
یا به جای \fIassert_never()\fP، می‌توانید تابعی با حاشیه‌نویسی بازگشتی \fINever\fP یا \fINoReturn\fP را فراخوانی کنید\&. برخلاف حالت معمول که pylint طبق طراحی خود حاشیه‌نویسی‌های نوع را نادیده می‌گیرد و تحلیل ایستای خودش را انجام می‌دهد، در اینجا pylint با این حاشیه‌نویسی‌های خاص مانند یک کامنت غیرفعال‌سازی رفتار می‌کند.
.sp
در حال حاضر pylint تکرار همان شرط را مانند این مجاز می‌داند، حتی با وجود اینکه این کار باعث نادیده ماندن برخی از موارد خطا می‌شود، چرا که pylint کدهای میانی را ارزیابی نمی‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
if guarded():
    var = 1

# what if code here affects the result of guarded()?

if guarded():
    print(var)
.EE
.UNINDENT
.UNINDENT
.sp
اما این استثنا محدود به تکرار دقیقاً همان شرط است.
این مورد هشدار صادر می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
if guarded():
    var = 1

if guarded() or other_condition:
    print(var)  # [possibly\-used\-before\-assignment]
.EE
.UNINDENT
.UNINDENT
.sp
اگر این رفتار برایتان عجیب است، در نظر داشته باشید که pylint به عنوان یک ابزار تحلیل ایستا، نمی‌داند که آیا \fBguarded()\fP قطعی (deterministic) است یا با یک پایگاه‌داده ارتباط برقرار می‌کند. برای متغیرها (برای مثال \fBguarded\fP در برابر \fBguarded()\fP)، این موضوع کمتر مسئله‌ساز است؛ بنابراین در این حالت، \fBpossibly\-used\-before\-assignment\fP بیشتر به عنوان یک ترجیح سبکی برای آینده‌نگری (future-proofing) عمل می‌کند تا این‌که ذاتاً یک خطا باشد.
.sp
ایجادشده توسط بررسی‌کنندهٔ variables در \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>\&..SS potential\-index\-error / E0643
.sp
\fBپیام صادرشده:\fP
.sp
\fBنمایهٔ نامعتبر برای طول شیء تکرارپذیر\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که نمایهٔ استفاده‌شده روی یک شیء تکرارپذیر، فراتر از طول آن شیء باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print([1, 2, 3][3])  # [potential\-index\-error]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print([1, 2, 3][2])

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>.
.SS raising\-bad\-type / E0702
.sp
\fBپیام صادرشده:\fP
.sp
\fBپرتاب %s در حالی که تنها کلاس‌ها یا نمونه‌ها مجاز هستند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که چیزی پرتاب شود که نه کلاس است و نه نمونه (یعنی یک \(gaTypeError\(ga رخ خواهد داد).\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class FasterThanTheSpeedOfLightError(ZeroDivisionError):
    def __init__(self):
        super().__init__(\(dqYou can\(aqt go faster than the speed of light !\(dq)


def calculate_speed(distance: float, time: float) \-> float:
    try:
        return distance / time
    except ZeroDivisionError as e:
        raise None  # [raising\-bad\-type]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class FasterThanTheSpeedOfLightError(ZeroDivisionError):
    def __init__(self):
        super().__init__(\(dqYou can\(aqt go faster than the speed of light !\(dq)


def calculate_speed(distance: float, time: float) \-> float:
    try:
        return distance / time
    except ZeroDivisionError as e:
        raise FasterThanTheSpeedOfLightError() from e

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ exceptions \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:exceptions\:.py>..SS raising\-non\-exception / E0710
.sp
\fBپیام صادرشده:\fP
.sp
\fBبرانگیختن کلاسی که از BaseException ارث‌بری نمی‌کند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که کلاسی برانگیخته شود که از BaseException ارث‌بری نمی‌کند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
raise str  # [raising\-non\-exception]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
raise Exception(\(dqGoodbye world !\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ exceptions \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:exceptions\:.py>.
.SS redundant\-keyword\-arg / E1124
.sp
\fBپیام صادرشده:\fP
.sp
\fBآرگومان %r بر پایهٔ موقعیت و کلیدواژه در فراخوانی %s ارسال شده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که فراخوانی یک تابع منجر به انتساب چندین مقدار به یک پارامتر تابع شود؛ یک مقدار از طریق آرگومان موقعیتی و مقداری دیگر از طریق آرگومان کلیدواژه‌ای.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def square(x):
    return x * x


square(5, x=4)  # [redundant\-keyword\-arg]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.sp
\fBonly_arg.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def square(x):
    return x * x


square(5)

.EE
.UNINDENT
.UNINDENT
.sp
\fBonly_kwarg.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def square(x):
    return x * x


square(x=4)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>..SS relative\-beyond\-top\-level / E0402
.sp
\fBپیام صادرشده:\fP
.sp
\fBتلاش برای واردسازی نسبی فراتر از بستهٔ سطح‌بالا\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک واردسازی نسبی تلاش کند به سطوحی بیش از حد مجاز در بستهٔ جاری دسترسی یابد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from ................antigravity import NGField  # [relative\-beyond\-top\-level]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.sp
\fBabsolute_import.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from physic.antigravity import NGField

.EE
.UNINDENT
.UNINDENT
.sp
\fBfix_the_relative_import.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# Right number of dots in the import: you needed 15 dots, not 16, duh.
# from ...............antigravity import NGField

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
از نظر تاریخی، واردسازی‌های مطلق (absolute imports) به‌شدت ترجیح داده می‌شدند. واردسازی‌های نسبی به شما امکان می‌دهند بسته‌ها را بدون تغییر هیچ کدی بازسازمان‌دهی کنید، اما امروزه ابزارهای بازآفرینی کد (refactoring) و IDEها به شما اجازه می‌دهند در صورت صریح/مطلق بودن واردسازی‌ها، در هر صورت این کار را تقریباً بدون هیچ هزینه‌ای انجام دهید. بنابراین، همچنان واردسازی‌های مطلق اغلب نسبت به موارد نسبی ترجیح داده می‌شوند.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
واردسازی مطلق در برابر واردسازی نسبی صریح ماژول پایتون \%<https://\:stackoverflow\:.com/\:a/\:16748366/\:2519059>
.IP \(bu 2
حذف توصیه علیه واردسازی‌های نسبی از مستندات \%<https://\:bugs\:.python\:.org/\:msg118031>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ imports \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:imports\:.py>.
.SS repeated\-keyword / E1132
.sp
\fBپیام صادرشده:\fP
.sp
\fBدریافت چندین مقدار برای آرگومان کلیدواژه‌ای %r در فراخوانی تابع\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که یک فراخوانی تابع چندین مقدار برای یک آرگومان کلیدواژه‌ای دریافت کند.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def func(a, b, c):
    return a, b, c


func(1, 2, c=3, **{\(dqc\(dq: 4})  # [repeated\-keyword]
func(1, 2, **{\(dqc\(dq: 3}, **{\(dqc\(dq: 4})  # [repeated\-keyword]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def func(a, b, c):
    return a, b, c


func(1, 2, c=3)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>..SS return\-arg\-in\-generator / E0106
.sp
\fBپیام صادرشده:\fP
.sp
\fBدستور return همراه با آرگومان درون generator\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک عبارت \(dqreturn\(dq همراه با آرگومان در یک تابع یا متد مولد (generator) یافت شود (برای مثال به همراه چند عبارت \(dqyield\(dq).\fP
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def yield_numbers():
    for number in range(10):
        yield number
        return \(dqI am now allowed!\(dq  # This was not allowed in Python 3.3 and earlier.

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
این پیامی است که برای python > 3.3 صادر نخواهد شد. این پیام قبلاً برای کدهایی مانند زیر صادر می‌شد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def interrogate_until_you_find_jack(pirates):
    for pirate in pirates:
        if pirate == \(dqCaptain Jack Sparrow\(dq:
            return \(dqArrr! We\(aqve found our captain!\(dq
        yield pirate
.EE
.UNINDENT
.UNINDENT
.sp
که اکنون معتبر بوده و معادل حالت مورد انتظار پیشین است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def interrogate_until_you_find_jack(pirates):
    for pirate in pirates:
        if pirate == \(dqCaptain Jack Sparrow\(dq:
            raise StopIteration(\(dqArrr! We\(aqve found our captain!\(dq)
        yield pirate
.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
PEP380 \%<https://\:peps\:.python\:.org/\:pep-0380>
.IP \(bu 2
توضیحات Stackoverflow \%<https://\:stackoverflow\:.com/\:a/\:16780113/\:2519059>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_error_checker\:.py>.
.SS return\-in\-init / E0101
.sp
\fBپیام صادرشده:\fP
.sp
\fBدستور return صریح در __init__\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که متد خاص کلاس، یعنی __init__، دارای یک مقدار بازگشتی صریح باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Sum:
    def __init__(self, a, b):  # [return\-in\-init]
        return a + b

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Sum:
    def __init__(self, a, b) \-> None:
        self.result = a + b

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
مستندات متد __init__ \%<https://\:docs\:.python\:.org/\:3/\:reference/\:datamodel\:.html#\:object\:.__init__>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_error_checker\:.py>..SS return\-outside\-function / E0104
.sp
\fBپیام صادرشده:\fP
.sp
\fBبازگشت خارج از تابع\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک دستور \(dqreturn\(dq در خارج از یک تابع یا متد پیدا شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
return 42  # [return\-outside\-function]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def get_the_answer():
    return 42

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_error_checker\:.py>.
.SS singledispatch\-method / E1519
.sp
\fBپیام صادرشده:\fP
.sp
\fBدکوراتور singledispatch نباید با متدها استفاده شود، به جای آن از singledispatchmethod استفاده کنید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIدکوراتور singledispatch باید توابع را تزیین کند و نه متدهای کلاس یا نمونه را. برای چنین مواردی از singledispatchmethod استفاده کنید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from functools import singledispatch


class Board:
    @singledispatch  # [singledispatch\-method]
    def convert_position(self, position):
        pass

    @convert_position.register  # [singledispatch\-method]
    def _(self, position: str) \-> tuple:
        position_a, position_b = position.split(\(dq,\(dq)
        return (int(position_a), int(position_b))

    @convert_position.register  # [singledispatch\-method]
    def _(self, position: tuple) \-> str:
        return f\(dq{position[0]},{position[1]}\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from functools import singledispatch


@singledispatch
def convert_position(position):
    print(position)


@convert_position.register
def _(position: str) \-> tuple:
    position_a, position_b = position.split(\(dq,\(dq)
    return (int(position_a), int(position_b))


@convert_position.register
def _(position: tuple) \-> str:
    return f\(dq{position[0]},{position[1]}\(dq

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده stdlib \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:stdlib\:.py>..SS singledispatchmethod\-function / E1520
.sp
\fBپیام صادرشده:\fP
.sp
\fBدکوراتور singledispatchmethod نباید برای توابع استفاده شود؛ به‌جای آن از singledispatch استفاده کنید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIsingledispatchmethod باید متدهای کلاس یا نمونه را تزیین کند و نه توابع را. در این موارد از singledispatch استفاده کنید.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from functools import singledispatchmethod


@singledispatchmethod  # [singledispatchmethod\-function]
def convert_position(position):
    print(position)


@convert_position.register  # [singledispatchmethod\-function]
def _(position: str) \-> tuple:
    position_a, position_b = position.split(\(dq,\(dq)
    return (int(position_a), int(position_b))


@convert_position.register  # [singledispatchmethod\-function]
def _(position: tuple) \-> str:
    return f\(dq{position[0]},{position[1]}\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from functools import singledispatchmethod


class Board:
    @singledispatchmethod
    def convert_position(cls, position):
        pass

    @singledispatchmethod
    @classmethod
    def _(cls, position: str) \-> tuple:
        position_a, position_b = position.split(\(dq,\(dq)
        return (int(position_a), int(position_b))

    @singledispatchmethod
    @classmethod
    def _(cls, position: tuple) \-> str:
        return f\(dq{position[0]},{position[1]}\(dq

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بازبین stdlib \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:stdlib\:.py>.
.SS star\-needs\-assignment\-target / E0114
.sp
\fBپیام صادرشده:\fP
.sp
\fBعبارت ستاره‌دار فقط می‌تواند در مقصد انتساب استفاده شود\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی صادر می‌شود که یک عبارت ستاره‌دار در مقصد انتساب استفاده نشده باشد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
stars = *[\(dqSirius\(dq, \(dqArcturus\(dq, \(dqVega\(dq]  # [star\-needs\-assignment\-target]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
sirius, *arcturus_and_vega = [\(dqSirius\(dq, \(dqArcturus\(dq, \(dqVega\(dq]

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بازبین basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_error_checker\:.py>..SS syntax\-error / E0001
.sp
\fBپیام صادرشده:\fP
.sp
\fB%s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک خطای نحوی برای یک پودمان رخ دهد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruit_stock = {
    \(aqapple\(aq: 42,
    \(aqorange\(aq: 21  # [syntax\-error]
    \(aqbanana\(aq: 12
}

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruit_stock = {\(dqapple\(dq: 42, \(dqorange\(dq: 21, \(dqbanana\(dq: 12}

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
پودمان توکار ast در python در صورت وجود یک خطای نحوی نمی‌تواند کد شما را تجزیه کند، بنابراین در صورت بروز خطای نحوی، سایر پیام‌ها اصلاً در دسترس نخواهند بود.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
چرا pylint نمی‌تواند از یک خطای نحوی بازیابی شود؟ \%<https://\:stackoverflow\:.com/\:a/\:78419051/\:2519059>
.UNINDENT
.sp
ایجاد شده توسط بازبین main \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:lint/\:pylinter\:.py>.
.SS too\-few\-format\-args / E1306
.sp
\fBپیام صادرشده:\fP
.sp
\fBآرگومان‌های کافی برای رشتهٔ قالب‌بندی وجود ندارد (Not enough arguments for format string)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که به یک رشتهٔ قالب‌بندی که از مشخص‌کننده‌های تبدیل بدون نام استفاده می‌کند، آرگومان‌های بسیار کمی داده شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqToday is {0}, so tomorrow will be {1}\(dq.format(\(dqMonday\(dq))  # [too\-few\-format\-args]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqToday is {0}, so tomorrow will be {1}\(dq.format(\(dqMonday\(dq, \(dqTuesday\(dq))

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
قالب‌بندی رشته \%<https://\:docs\:.python\:.org/\:3/\:library/\:string\:.html#\:formatstrings>
.UNINDENT
.sp
ایجاد شده توسط بازبین string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>..SS too\-many\-format\-args / E1305
.sp
\fBپیام صادرشده:\fP
.sp
\fBآرگومان‌های بیش از حد برای رشته قالب‌بندی\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که به یک رشته قالب‌بندی که از مشخص‌کننده‌های تبدیل بدون نام استفاده می‌کند، آرگومان‌های بیش از حد داده شود.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# +1: [too\-many\-format\-args]
print(\(dqToday is {0}, so tomorrow will be {1}\(dq.format(\(dqMonday\(dq, \(dqTuesday\(dq, \(dqWednesday\(dq))

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqToday is {0}, so tomorrow will be {1}\(dq.format(\(dqMonday\(dq, \(dqTuesday\(dq))

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
قالب‌بندی رشته \%<https://\:docs\:.python\:.org/\:3/\:library/\:string\:.html#\:formatstrings>
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>.
.SS too\-many\-function\-args / E1121
.sp
\fBپیام صادرشده:\fP
.sp
\fBآرگومان‌های مکانی بیش از حد برای فراخوانی %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که در فراخوانی یک تابع، آرگومان‌های مکانی بیش از حد ارسال شود.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    def __init__(self, color):
        self.color = color


apple = Fruit(\(dqred\(dq, \(dqapple\(dq, [1, 2, 3])  # [too\-many\-function\-args]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    def __init__(self, color, name):
        self.color = color
        self.name = name


apple = Fruit(\(dqred\(dq, \(dqapple\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>..SS too\-many\-positional\-sub\-patterns / E1903
.sp
\fBپیام صادرشده:\fP
.sp
\fB%s انتظار %d زیرالگوی موقعیتی دارد (%d داده شده است)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی صادر می‌شود که تعداد زیرالگوهای موقعیتی از تعداد زیرالگوهای مجاز مشخص‌شده در \(ga__match_args__\(ga فراتر رود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Book:
    __match_args__ = (\(dqtitle\(dq, \(dqyear\(dq)

    def __init__(self, title, year, author):
        self.title = title
        self.year = year
        self.author = author


def func(item: Book):
    match item:
        case Book(\(dqtitle\(dq, 2000, \(dqauthor\(dq):  # [too\-many\-positional\-sub\-patterns]
            ...

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Book:
    __match_args__ = (\(dqtitle\(dq, \(dqyear\(dq)

    def __init__(self, title, year, author):
        self.title = title
        self.year = year
        self.author = author


def func(item: Book):
    match item:
        case Book(\(dqtitle\(dq, 2000, author=\(dqauthor\(dq):
            ...

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
مستندات پایتون \%<https://\:docs\:.python\:.org/\:3/\:reference/\:compound_stmts\:.html#\:class-patterns>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ match_statements \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:match_statements_checker\:.py>.
.SS too\-many\-star\-expressions / E0112
.sp
\fBپیام صادرشده:\fP
.sp
\fBبیش از یک عبارت ستاره‌دار در انتساب\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی صادر می‌شود که بیش از یک عبارت ستاره‌دار (\(ga*x\(ga) در یک انتساب وجود داشته باشد. این یک SyntaxError است.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
*stars, *constellations = [\(dqSirius\(dq, \(dqArcturus\(dq, \(dqVega\(dq]  # [too\-many\-star\-expressions]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
*sirius_and_arcturus, vega = [\(dqSirius\(dq, \(dqArcturus\(dq, \(dqVega\(dq]

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_error_checker\:.py>..SS truncated\-format\-string / E1301
.sp
\fBپیام صادرشده:\fP
.sp
\fBرشته قالب‌بندی در میانه مشخص‌کننده تبدیل پایان می‌یابد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک رشته قالب‌بندی پیش از پایان یک مشخص‌کننده تبدیل خاتمه یابد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
PARG_2 = 1

print(\(dqstrange format %2\(dq % PARG_2)  # [truncated\-format\-string]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
PARG_2 = 1

print(f\(dqstrange format {PARG_2}\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>.
.SS undefined\-all\-variable / E0603
.sp
\fBپیام صادرشده:\fP
.sp
\fBنام متغیر تعریف‌نشده %r در __all__\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که در __all__ به یک نام متغیر تعریف‌نشده ارجاع داده شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
__all__ = [\(dqget_fruit_colour\(dq]  # [undefined\-all\-variable]


def get_fruit_color():
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
__all__ = [\(dqget_fruit_color\(dq]


def get_fruit_color():
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
وارد کردن * از یک بسته \%<https://\:docs\:.python\:.org/\:3/\:tutorial/\:modules\:.html#\:importing-from-a-package>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>..SS undefined\-variable / E0602
.sp
\fBپیام صادرشده:\fP
.sp
\fBمتغیر تعریف‌نشده %r\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که به یک متغیر تعریف‌نشده دسترسی پیدا شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(number + 2)  # [undefined\-variable]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
number = 3
print(number + 2)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>.
.SS unexpected\-keyword\-arg / E1123
.sp
\fBپیام صادرشده:\fP
.sp
\fBآرگومان کلیدواژه‌ای غیرمنتظره %r در فراخوانی %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که در فراخوانی یک تابع، آرگومان کلیدواژه‌ای ارسال شود که با هیچ‌یک از نام‌های پارامتر تابع مطابقت ندارد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def print_coordinates(x=0, y=0):
    print(f\(dq{x=}, {y=}\(dq)


print_coordinates(x=1, y=2, z=3)  # [unexpected\-keyword\-arg]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def print_coordinates(x=0, y=0):
    print(f\(dq{x=}, {y=}\(dq)


print_coordinates(x=1, y=2)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>.
.SS unexpected\-special\-method\-signature / E0302
.sp
\fBپیام صادرشده:\fP
.sp
\fBمتد ویژه %r انتظار %s پارامتر(ها) را دارد، %d %s داده شده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که یک متد ویژه با تعداد نامعتبری از پارامترها تعریف شده باشد. اگر تعداد آن‌ها بسیار کم یا بسیار زیاد باشد، ممکن است اصلاً کار نکند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class ContextManager:
    def __enter__(self, context):  # [unexpected\-special\-method\-signature]
        pass

    def __exit__(self, type):  # [unexpected\-special\-method\-signature]
        pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class ContextManager:
    def __enter__(self):
        pass

    def __exit__(self, type, value, traceback):
        pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:special_methods_checker\:.py>..SS unhashable\-member / E1143
.sp
\fBپیام صادرشده:\fP
.sp
\fB\(aq%s\(aq هش‌پذیر نیست و نمی‌تواند به عنوان یک %s در یک %s به کار رود\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که یک کلید dict یا عضو set هش‌پذیر نباشد (یعنی متد __hash__ را تعریف نکرده باشد).\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# Print the number of apples:
print({\(dqapple\(dq: 42}[[\(dqapple\(dq]])  # [unhashable\-member]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# Print the number of apples:
print({\(dqapple\(dq: 42}[\(dqapple\(dq])

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>.
.SS unpacking\-non\-sequence / E0633
.sp
\fBپیام صادرشده:\fP
.sp
\fBتلاش برای بازگشایی یک غیردنباله%s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که چیزی که یک دنباله نیست، در یک انتساب بازگشایی (unpack) به کار رود\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
a, b, c = 1  # [unpacking\-non\-sequence]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
a, b, c = 1, 2, 3

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>.
.SS unrecognized\-inline\-option / E0011
.sp
\fBپیام صادرشده:\fP
.sp
\fBگزینه فایل ناشناخته %r\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که با یک گزینه درون‌خطی ناشناخته مواجه شویم.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# +1: [unrecognized\-inline\-option]
# pylint:applesoranges=1

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# pylint: enable=too\-many\-public\-methods

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده main \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:lint/\:pylinter\:.py>..SS unrecognized\-option / E0015
.sp
\fBپیام صادرشده:\fP
.sp
\fBگزینه ناشناخته یافت شد: %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که گزینه‌ای تشخیص داده شود که برای برنامه ناشناخته است.\fP
.sp
\fBجزئیات تکمیلی:\fP
.sp
یکی از گزینه‌های شما ناشناخته است. نیازی به ایجاد تغییر در کد شما نیست،
اما پیکربندی pylint یا نحوه فراخوانی pylint باید اصلاح شود.
.sp
برای نمونه، این پیام هنگام اجرای pylint به صورت
\fBpylint \-\-unknown\-option=yes test.py\fP\& صادر می‌شود. یا ممکن است
pylint را با پیکربندی \fBtoml\fP زیر اجرا کرده باشید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint]
jars = \(dq10\(dq
.EE
.UNINDENT
.UNINDENT
.sp
در حالی که باید از مورد زیر استفاده شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint]
jobs = \(dq10\(dq
.EE
.UNINDENT
.UNINDENT
.sp
این هشدار در pylint 2.14 اضافه شد؛ پیش از آن، گزینه‌های نادرست در سکوت و بدون خطا نادیده گرفته می‌شدند.
.sp
ایجاد شده توسط بازبین main \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:lint/\:pylinter\:.py>.
.SS unsubscriptable\-object / E1136
.sp
\fBپیام صادرشده:\fP
.sp
\fBمقدار \(aq%s\(aq قابل اندیس‌گذاری نیست\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی صادر می‌شود که یک مقدار اندیس‌گذاری‌شده از قابلیت اندیس‌گذاری پشتیبانی نکند (یعنی متد __getitem__ یا برای یک کلاس متد __class_getitem__ را تعریف نکرده باشد).\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    pass


Fruit()[1]  # [unsubscriptable\-object]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    def __init__(self):
        self.colors = [\(dqred\(dq, \(dqorange\(dq, \(dqyellow\(dq]

    def __getitem__(self, idx):
        return self.colors[idx]


Fruit()[1]

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بازبین typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>..SS unsupported\-assignment\-operation / E1137
.sp
\fBپیام صادرشده:\fP
.sp
\fB%r does not support item assignment\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که یک شیء از انتساب آیتم پشتیبانی نکند (یعنی متد __setitem__ را تعریف نکرده باشد).\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def pick_fruits(fruits):
    for fruit in fruits:
        print(fruit)


pick_fruits([\(dqapple\(dq])[0] = \(dqorange\(dq  # [unsupported\-assignment\-operation]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def pick_fruits(fruits):
    for fruit in fruits:
        print(fruit)

    return []


pick_fruits([\(dqapple\(dq])[0] = \(dqorange\(dq

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>.
.SS unsupported\-binary\-operation / E1131
.sp
\fBپیام صادرشده:\fP
.sp
\fB%s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که یک عملیات حسابی دودویی بین دو عملوند پشتیبانی نشود.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
drink = \(dqwater\(dq | None  # [unsupported\-binary\-operation]
result = [] | None  # [unsupported\-binary\-operation]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
masked = 0b111111 & 0b001100
result = 0xAEFF | 0x0B99

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
py\-version=3.9

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>..SS unsupported\-delete\-operation / E1138
.sp
\fBپیام صادرشده:\fP
.sp
\fB%r does not support item deletion\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که یک شیء از حذف آیتم پشتیبانی نکند (یعنی متد __delitem__ را تعریف نکرده باشد).\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
FRUITS = (\(dqapple\(dq, \(dqorange\(dq, \(dqberry\(dq)

del FRUITS[0]  # [unsupported\-delete\-operation]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
FRUITS = [\(dqapple\(dq, \(dqorange\(dq, \(dqberry\(dq]

del FRUITS[0]

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>.
.SS unsupported\-membership\-test / E1135
.sp
\fBپیام صادرشده:\fP
.sp
\fBValue \(aq%s\(aq doesn\(aqt support membership test\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که یک نمونه در عبارت آزمون عضویت، پروتکل عضویت (__contains__/__iter__/__getitem__) را پیاده‌سازی نکرده باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    pass


apple = \(dqapple\(dq in Fruit()  # [unsupported\-membership\-test]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    FRUITS = [\(dqapple\(dq, \(dqorange\(dq]

    def __contains__(self, name):
        return name in self.FRUITS


apple = \(dqapple\(dq in Fruit()

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>..SS used\-before\-assignment / E0601
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از متغیر %r پیش از انتساب\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که به یک متغیر محلی پیش از انتساب آن دسترسی پیدا شود. هنگام ارزیابی بلوک‌های except/finally مرتبط، فرض می‌شود که انتساب‌های درون بلوک‌های try رخ نداده‌اند. همچنین هنگام ارزیابی دستورهای خارج از بلوک، فرض بر این است که انتساب‌های درون بلوک‌های except انجام نگرفته‌اند، مگر زمانی که بلوک try مرتبط شامل دستور return باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(hello)  # [used\-before\-assignment]
hello = \(dqHello World !\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
hello = \(dqHello World !\(dq
print(hello)

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>.
.SS used\-prior\-global\-declaration / E0118
.sp
\fBپیام صادرشده:\fP
.sp
\fBنام %r پیش از اعلان global استفاده شده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که یک نام پیش از اعلان global استفاده شود، که از Python 3.6 به بعد منجر به خطا می‌شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
TOMATO = \(dqblack cherry\(dq


def update_tomato():
    print(TOMATO)  # [used\-prior\-global\-declaration]
    global TOMATO
    TOMATO = \(dqcherry tomato\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
TOMATO = \(dqblack cherry\(dq


def update_tomato():
    global TOMATO
    TOMATO = \(dqmoneymaker\(dq

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_error_checker\:.py>.
.SS yield\-inside\-async\-function / E1700
.sp
\fBپیام صادرشده:\fP
.sp
\fByield درون تابع async\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک دستور \(gayield\(ga یا \(gayield from\(ga درون یک تابع async یافت شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
async def foo():
    yield from [1, 2, 3]  # [yield\-inside\-async\-function]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
async def foo():
    def _inner_foo():
        yield from [1, 2, 3]


async def foo():
    yield 42

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
این پیام هنگام استفاده از Python < 3.5 نمی‌تواند صادر شود.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
PEP 525 \%<https://\:peps\:.python\:.org/\:pep-0525>
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده async \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:async_checker\:.py>..SS yield\-outside\-function / E0105
.sp
\fBپیام صادرشده:\fP
.sp
\fBدستور yield خارج از تابع\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک دستور \(dqyield\(dq خارج از یک تابع یا متد یافت شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
for i in range(10):
    yield i  # [yield\-outside\-function]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def one_to_ten():
    for i in range(10):
        yield i

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_error_checker\:.py>.
.sp
تمام پیام‌های تغییرنام‌یافته در دسته‌بندی خطا:
.SS bad\-context\-manager / E0235
.sp
پیام \(aqbad\-context\-manager\(aq تغییر نام یافته است. پیام جدید را می‌توان در این نشانی یافت:
.SS bad\-exception\-context / E0703
.sp
پیام \(aqbad\-exception\-context\(aq تغییر نام یافته است. پیام جدید را می‌توان در این نشانی یافت:
.SS bad\-option\-value / E0012
.sp
پیام \(aqbad\-option\-value\(aq تغییر نام یافته است. پیام جدید را می‌توان در این نشانی یافت:
.SS useless\-option\-value / R0022
.sp
\fBپیام صادرشده:\fP
.sp
\fBمقدار گزینهٔ بی‌استفاده برای \(aq%s\(aq، %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که با مقداری برای گزینه‌ای که اکنون از pylint حذف شده است، برخورد شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dq\(dq\(dq\(aqbad\-continuation\(aq was removed from pylint in https://github.com/pylint\-dev/pylint/pull/3571\(dq\(dq\(dq

# pylint: disable=bad\-continuation  # [useless\-option\-value]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dq\(dq\(dq\(aqbad\-continuation\(aq was removed from pylint in https://github.com/pylint\-dev/pylint/pull/3571\(dq\(dq\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
اگر نمی‌خواهید پیکربندی خود را از پیام‌های قدیمی پاک‌سازی کنید، می‌توانید این بررسی را غیرفعال کنید.
.sp
ایجادشده توسط بررسی‌کنندهٔ main \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:lint/\:pylinter\:.py>..SS unknown\-option\-value / W0012
.sp
\fBپیام صادرشده:\fP
.sp
\fBمقدار ناشناختهٔ گزینه برای \(aq%s\(aq، یک پیام معتبر pylint انتظار می‌رفت اما \(aq%s\(aq دریافت شد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که با یک مقدار ناشناخته برای یک گزینه مواجه شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# pylint: disable=missnig\-docstring  # [unknown\-option\-value]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# pylint: disable=missing\-docstring

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط وارسی‌کنندهٔ main \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:lint/\:pylinter\:.py>.
.SS maybe\-no\-member / E1103
.sp
نام \(aqmaybe\-no\-member\(aq تغییر یافته است. پیام جدید را می‌توان در اینجا یافت:
.SS old\-non\-iterator\-returned\-2 / E0234
.sp
نام \(aqold\-non\-iterator\-returned\-2\(aq تغییر یافته است. پیام جدید را می‌توان در اینجا یافت:
.SS old\-unbalanced\-tuple\-unpacking / E0632
.sp
نام \(aqold\-unbalanced\-tuple\-unpacking\(aq تغییر یافته است. پیام جدید را می‌توان در اینجا یافت:
.SS unbalanced\-tuple\-unpacking / W0632
.sp
\fBپیام صادرشده:\fP
.sp
\fBاحتمال بازگشایی ناتراز تاپل با دنبالهٔ %s: سمت چپ دارای %d برچسب%s، سمت راست دارای %d مقدار%s است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک بازگشایی ناتراز تاپل در انتساب وجود داشته باشد\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruits = (\(dqorange\(dq, \(dqapple\(dq, \(dqstrawberry\(dq, \(dqpeer\(dq)
orange, apple, strawberry = fruits  # [unbalanced\-tuple\-unpacking]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruits = (\(dqorange\(dq, \(dqapple\(dq, \(dqstrawberry\(dq, \(dqpeer\(dq)
orange, apple, *remaining_fruits = fruits

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
PEP 3132 \- Extended Iterable Unpacking \%<https://\:peps\:.python\:.org/\:pep-3132>
.UNINDENT
.sp
ایجادشده توسط وارسی‌کنندهٔ variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>..SS unhashable\-dict\-key / E1140
.sp
\(aqunhashable\-dict\-key\(aq تغییر نام یافته است. پیام جدید را می‌توان در اینجا یافت:
.SS هشدار (Warning)
.sp
تمام پیام‌ها در دسته‌بندی هشدار:
.SS abstract\-method / W0223
.sp
\fBپیام صادرشده:\fP
.sp
\fBمتد %r در کلاس %r انتزاعی است اما در کلاس فرزند %r بازنویسی نشده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک متد انتزاعی (یعنی raise NotImplementedError) در کلاس عینی (concrete) بازنویسی نشده باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.sp
\fBabstract_method.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import abc


class WildAnimal:
    @abc.abstractmethod
    def make_sound(self):
        pass


class Panther(WildAnimal):  # [abstract\-method]
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBfunction_raising_not_implemented_error.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Pet:
    def make_sound(self):
        raise NotImplementedError


class Cat(Pet):  # [abstract\-method]
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.sp
\fBabstract_method.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import abc


class WildAnimal:
    @abc.abstractmethod
    def make_sound(self):
        pass


class Panther(WildAnimal):
    def make_sound(self):
        print(\(dqMEEEOW\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBfunction_raising_not_implemented_error.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Pet:
    def make_sound(self):
        raise NotImplementedError


class Cat(Pet):
    def make_sound(self):
        print(\(dqMeeeow\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>..SS anomalous\-backslash\-in\-string / W1401
.sp
\fBپیام صادرشده:\fP
.sp
\fBبک‌اسلش غیرعادی در رشته: \(aq%s\(aq. ممکن است ثابت رشته فاقد پیشوند r باشد.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک بک‌اسلش در یک رشتهٔ لیترال وجود داشته باشد اما به عنوان یک نویسهٔ گریز عمل نکند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
string = \(dq\ez\(dq  # [syntax\-error]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.sp
\fBdouble_escape.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
string = \(dq\e\ez\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBexisting_escape_sequence.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
string = \(dq\et\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBr_prefix.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
string = r\(dq\ez\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
\fB\ez\fP همانند \fB\e\ez\fP است زیرا هیچ توالی گریزی برای \fBz\fP وجود ندارد\&. اما این موضوع برای خوانندهٔ کد مشخص نیست\&.
.sp
تنها دلیلی که نشان داده شده این مورد منجر به \fBsyntax\-error\fP می‌شود این است که CI مربوط به pylint اکنون بر روی Python 3.12 اجرا می‌شود، جایی که این حالت واقعاً یک \fBSyntaxError\fP صادر می‌کند\&.
امیدواریم در آینده این ناهمخوانی را در مستندات برطرف کنیم\&.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
لیترال‌های رشته و بایت \%<https://\:docs\:.python\:.org/\:3/\:reference/\:lexical_analysis\:.html#\:string-and-bytes-literals>
.IP \(bu 2
توضیح مفصل در Stack Overflow \%<https://\:stackoverflow\:.com/\:a/\:19030982/\:2519059>
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کنندهٔ string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>\&.
.SS anomalous\-unicode\-escape\-in\-string / W1402
.sp
\fBپیام صادرشده:\fP
.sp
\fBتوالی گریز یونیکد غیرعادی در رشتهٔ بایتی: \(aq%s\(aq. ممکن است ثابت رشته فاقد پیشوند r یا u باشد.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک گریز مانند u در یک رشتهٔ بایتی دیده شود در حالی که هیچ اثری در آن ندارد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(b\(dq\eu%b\(dq % b\(dq0394\(dq)  # [syntax\-error]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(b\(dq\e\eu%b\(dq % b\(dq0394\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کنندهٔ string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>\&..SS arguments\-differ / W0221
.sp
\fBپیام صادرشده:\fP
.sp
\fB%s %s %r method\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک متد تعداد متفاوتی آرگومان نسبت به رابط پیاده‌سازی‌شده یا متد بازنویسی‌شده داشته باشد. آرگومان‌های اضافی دارای مقدار پیش‌فرض نادیده گرفته می‌شوند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Drink:
    def mix(self, fluid_one, fluid_two):
        return fluid_one + fluid_two


class Cocktail(Drink):
    def mix(self, fluid_one, fluid_two, alcoholic_fluid):  # [arguments\-differ]
        return fluid_one + fluid_two + alcoholic_fluid

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.sp
\fBadd_option_in_base_class.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dq\(dq\(dq
Here we assume that drink and cocktail are the same thing and should actually
inherit from each over. We also assume that \(aqDrink\(aq are \(aqCocktail\(aq without
alcohol (we added the alcohol option in the base class).

This permit to not have to modify the cocktails calls downstream but the case where
an alcohol is mixed in a soft drink will need to be handled.
\(dq\(dq\(dq


class Drink:
    def mix(self, fluid_one, fluid_two, alcoholic_fluid=None):
        # if alcoholic_fluid is not None:
        #     raise Exception(f\(dqThis soft drink has {alcoholic_fluid} in it !\(dq)
        return fluid_one + fluid_two


class Cocktail(Drink):
    def mix(self, fluid_one, fluid_two, alcoholic_fluid):
        return fluid_one + fluid_two + alcoholic_fluid

.EE
.UNINDENT
.UNINDENT
.sp
\fBdefault_value.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dq\(dq\(dq
Here we assume that drink and cocktail are the same thing and should actually
inherit from each over. We also assume that any Cocktail can be treated like
a Drink (if you add beer to it).

This permit to not have to modify the calls downstream and causes the least
amount of disturbance at the cost of making cocktails beer\-based implicitly.
\(dq\(dq\(dq


class Drink:
    def mix(self, fluid_one, fluid_two):
        return fluid_one + fluid_two


class Cocktail(Drink):
    def mix(self, fluid_one, fluid_two, alcoholic_fluid=\(dqBeer\(dq):
        return fluid_one + fluid_two + alcoholic_fluid

.EE
.UNINDENT
.UNINDENT
.sp
\fBno_inheritance.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dq\(dq\(dq
Here we assume that \(aqDrink\(aq and \(aqCocktail\(aq are different things and should
not be treated together like if they were the same thing.

This will force some downstream changes and force the API user to make a
conscious decision about the alcoholic content of its drink when using the
API. For example, it\(aqs impossible to create a mojito with beer without
explicitly wanting to, or to add an alcohol to a soft\-drink.
\(dq\(dq\(dq


class Drink:
    def mix(self, fluid_one, fluid_two):
        return fluid_one + fluid_two


class Cocktail:
    def mix(self, fluid_one, fluid_two, alcoholic_fluid):
        return fluid_one + fluid_two + alcoholic_fluid

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
\fBargument\-differ\fP نشان‌دهنده مشکلی در رابطه با «اصل جایگزینی لیسکوف» (Liskov Substitution Principle) است.
این بدان معناست که کد مورد نظر یک اصل مهم طراحی را نقض می‌کند که راه‌حل واحدی ندارد.
توصیه می‌کنیم برای یافتن بهترین راه‌حل متناسب با مورد خود، در اینترنت جستجو کنید.
.sp
برای ارائه چند نمونه از راه‌حل‌های بالقوه:
.INDENT 0.0
.IP \(bu 2
افزودن آرگومان به کلاس والد
.IP \(bu 2
حذف کامل توارث
.IP \(bu 2
افزودن آرگومان‌های پیش‌فرض به کلاس فرزند
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
اصل جایگزینی لیسکوف (Liskov Substitution Principle) \%<https://\:en\:.wikipedia\:.org/\:wiki/\:Liskov_substitution_principle>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>..SS arguments\-out\-of\-order / W1114
.sp
\fBپیام صادرشده:\fP
.sp
\fBPositional arguments appear to be out of order\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که نام‌های آرگومان فراخواننده کاملاً با نام‌های پارامتر در امضای تابع مطابقت دارند اما ترتیبی یکسان ندارند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def function_3_args(first_argument, second_argument, third_argument):
    \(dq\(dq\(dqThree arguments function\(dq\(dq\(dq
    return first_argument, second_argument, third_argument


def args_out_of_order():
    first_argument = 1
    second_argument = 2
    third_argument = 3

    function_3_args(  # [arguments\-out\-of\-order]
        first_argument, third_argument, second_argument
    )

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def function_3_args(first_argument, second_argument, third_argument):
    \(dq\(dq\(dqThree arguments function\(dq\(dq\(dq
    return first_argument, second_argument, third_argument


def args_out_of_order():
    first_argument = 1
    second_argument = 2
    third_argument = 3

    function_3_args(first_argument, second_argument, third_argument)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>.
.SS arguments\-renamed / W0237
.sp
\fBپیام صادرشده:\fP
.sp
\fB%s %s %r method\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک پارامتر متد نامی متفاوت با رابط پیاده‌سازی‌شده یا متد بازنویسی‌شده داشته باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    def brew(self, ingredient_name: str):
        print(f\(dqBrewing a {type(self)} with {ingredient_name}\(dq)


class Apple(Fruit): ...


class Orange(Fruit):
    def brew(self, flavor: str):  # [arguments\-renamed]
        print(f\(dqBrewing an orange with {flavor}\(dq)


for fruit, ingredient_name in [[Orange(), \(dqthyme\(dq], [Apple(), \(dqcinnamon\(dq]]:
    fruit.brew(ingredient_name=ingredient_name)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    def brew(self, ingredient_name: str):
        print(f\(dqBrewing a {type(self)} with {ingredient_name}\(dq)


class Apple(Fruit): ...


class Orange(Fruit):
    def brew(self, ingredient_name: str):
        print(f\(dqBrewing an orange with {ingredient_name}\(dq)


for fruit, ingredient_name in [[Orange(), \(dqthyme\(dq], [Apple(), \(dqcinnamon\(dq]]:
    fruit.brew(ingredient_name=ingredient_name)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>..SS assert\-on\-string\-literal / W0129
.sp
\fBپیام صادرشده:\fP
.sp
\fBدستور assert یک لیترال رشته‌ای را به عنوان نخستین آرگومان خود دارد. این assert به‌صورت %s با شکست مواجه خواهد شد.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک دستور assert یک لیترال رشته‌ای را به عنوان نخستین آرگومان خود داشته باشد، که باعث می‌شود assert همیشه برقرار باشد.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def test_division():
    a = 9 / 3
    assert \(dqNo ZeroDivisionError were raised\(dq  # [assert\-on\-string\-literal]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def test_division():
    a = 9 / 3
    assert a == 3

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
اعمال مستقیم assert روی یک لیترال رشته‌ای همواره برقرار خواهد بود. راهکار این است که
چیزی را بیازمایید که امکان شکست خوردن آن وجود داشته باشد، یا اصلاً از assert استفاده نکنید.
.sp
برای assertionهای \fBunittest\fP، پیام مشابه redundant\-unittest\-assert / W1503 \%<#\:redundant-unittest-assert> وجود دارد.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
آزمون‌های بدون assertion \%<https://\:stackoverflow\:.com/\:a/\:137418/\:2519059>
.IP \(bu 2
آزمودن اینکه هیچ خطایی ایجاد نمی‌شود \%<https://\:stackoverflow\:.com/\:questions/\:20274987>
.IP \(bu 2
پارامتریک‌سازی raiseهای شرطی \%<https://\:docs\:.pytest\:.org/\:en/\:latest/\:example/\:parametrize\:.html#\:parametrizing-conditional-raising>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده‌ی basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_checker\:.py>.
.SS assert\-on\-tuple / W0199
.sp
\fBپیام صادرشده:\fP
.sp
\fBدستور assert روی یک تاپل غیرخالی فراخوانی شده است. آیا منظورتان \(aqassert x,y\(aq بود؟\fP
.sp
\fBتوضیحات:\fP
.sp
\fIفراخوانی assert روی یک تاپل، در صورتی که تاپل خالی نباشد همواره به true ارزیابی می‌شود، و اگر خالی باشد همواره به false ارزیابی خواهد شد.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
assert (1, None)  # [assert\-on\-tuple]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
x, y = (1, None)
assert x
assert y

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.INDENT 0.0
.TP
.B اعمال مستقیم assert روی یک تاپل غیرخالی همواره برقرار خواهد بود. راهکار این است که
چیزی را بیازمایید که امکان شکست خوردن آن وجود داشته باشد، یا اصلاً از assert استفاده نکنید.
.sp
برای assertionهای \fBunittest\fP، پیام مشابه redundant\-unittest\-assert / W1503 \%<#\:redundant-unittest-assert> وجود دارد.
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده‌ی basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_checker\:.py>..SS attribute\-defined\-outside\-init / W0201
.sp
\fBپیام صادرشده:\fP
.sp
\fBصفت %r خارج از __init__ تعریف شده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک صفت نمونه خارج از متد __init__ تعریف شده باشد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Student:
    def register(self):
        self.is_registered = True  # [attribute\-defined\-outside\-init]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Student:
    def __init__(self):
        self.is_registered = False

    def register(self):
        self.is_registered = True

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>.
.SS bad\-builtin / W0141
.sp
\fBپیام صادرشده:\fP
.sp
\fBاز تابع توکار %s استفاده شده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک تابع توکار غیرمجاز به کار رفته باشد (گزینهٔ bad\-function را ببینید). توابع غیرمجاز معمول مواردی همچون map یا filter هستند که پایتون امروزه جایگزین تمیزتری مانند list comprehension برای آن‌ها ارائه می‌دهد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
numbers = list(map(lambda x: 2 * x, [1, 2, 3]))  # [bad\-builtin]
print(numbers)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
numbers = [2 * x for x in [1, 2, 3]]
print(numbers)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins = pylint.extensions.bad_builtin

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کنندهٔ اختیاری \(aqdeprecated_builtins\(aq \%<#\:pylint-extensions-bad-builtin>
صادر می‌شود، که نیازمند بارگذاری افزونهٔ \fBpylint.extensions.bad_builtin\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ deprecated_builtins \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:bad_builtin\:.py>..SS bad\-chained\-comparison / W3601
.sp
\fBپیام صادرشده:\fP
.sp
\fBمقایسه زنجیره‌ای مشکوک %s\-بخشی با استفاده از عملگرهای ناسازگار از نظر معنایی (%s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک مقایسه زنجیره‌ای وجود دارد که در آن یک عبارت، بخشی از دو مقایسه متعلق به گروه‌های معنایی متفاوت است (\(dq<\(dq معنای یکسانی با \(dqis\(dq ندارد، زنجیره‌سازی آن‌ها در \(dq0 < x is None\(dq احتمالاً یک اشتباه است).\fP
.sp
\fBکد مشکل‌دار:\fP
.sp
\fBparrot.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
shop = {
    # animal: (specie, descriptions)
    \(dqparrot\(dq: (\(dqNorvegian blue\(dq, (\(dqrestin\(aq\(dq, \(dqremarkable\(dq, \(dqbeautiful plumage\(dq)),
}

if \(dqparrot\(dq in shop is \(dqrestin\(aq\(dq:  # [bad\-chained\-comparison]
    print(\(dqHellooooo, Pooolllllyyy ! WAAAAKEEY, WAKKEEEY !\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBxor.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def xor_check(*, left=None, right=None):
    if left is None != right is None:  # [bad\-chained\-comparison]
        raise ValueError(
            \(dqEither both left= and right= need to be provided or none should.\(dq
        )

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.sp
\fBparrot.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
shop = {
    # animal: (specie, descriptions)
    \(dqparrot\(dq: (\(dqNorvegian blue\(dq, (\(dqrestin\(aq\(dq, \(dqremarkable\(dq, \(dqbeautiful plumage\(dq)),
}

if \(dqparrot\(dq in shop and \(dqrestin\(aq\(dq in shop[\(dqparrot\(dq][1]:
    print(\(dqHellooooo, Pooolllllyyy ! WAAAAKEEY, WAKKEEEY !\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBxor.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def xor_check(*, left=None, right=None):
    if (left is None) != (right is None):
        raise ValueError(
            \(dqEither both left= and right= need to be provided or none should.\(dq
        )

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
زنجیره‌سازی مقایسه‌ها (Comparison Chaining) \%<https://\:docs\:.python\:.org/\:3/\:reference/\:expressions\:.html#\:comparisons>
.UNINDENT
.sp
ایجاد شده توسط بازبین bad\-chained\-comparison \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:bad_chained_comparison\:.py>..SS bad\-dunder\-name / W3201
.sp
\fBپیام صادرشده:\fP
.sp
\fBنام متد dunder نامعتبر است یا دارای غلط املایی است %s.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک متد dunder دارای غلط املایی باشد یا با نامی خارج از فهرست از پیش تعریف‌شدهٔ نام‌های dunder تعریف شده باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Apples:
    def _init_(self):  # [bad\-dunder\-name]
        pass

    def __hello__(self):  # [bad\-dunder\-name]
        print(\(dqhello\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Apples:
    def __init__(self):
        pass

    def hello(self):
        print(\(dqhello\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins=pylint.extensions.dunder

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کنندهٔ اختیاری \(aqdunder\(aq \%<#\:pylint-extensions-dunder>
صادر می‌شود که مستلزم بارگذاری افزونهٔ \fBpylint.extensions.dunder\fP است.
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کنندهٔ dunder \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:dunder\:.py>.
.SS bad\-format\-string / W1302
.sp
\fBپیام صادرشده:\fP
.sp
\fBرشتهٔ قالب‌بندی نامعتبر\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک رشتهٔ قالب‌بندی PEP 3101 نامعتبر باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dq{a[0] + a[1]}\(dq.format(a=[0, 1]))  # [bad\-format\-string]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dq{a[0]} + {a[1]}\(dq.format(a=[0, 1]))

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
نحو رشتهٔ قالب‌بندی (Format String Syntax) \%<https://\:docs\:.python\:.org/\:3/\:library/\:string\:.html#\:formatstrings>
.IP \(bu 2
PyFormat \%<https://\:pyformat\:.info>
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کنندهٔ string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>..SS bad\-format\-string\-key / W1300
.sp
\fBپیام صادرشده:\fP
.sp
\fBکلید دیکشنری رشتهٔ قالب‌بندی باید یک رشته باشد، نه %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک رشتهٔ قالب‌بندی با مشخص‌کننده‌های تبدیل نام‌گذاری‌شده، به همراه دیکشنری‌ای به کار رود که همهٔ کلیدهای آن رشته نیستند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dq%(one)d\(dq % {\(dqone\(dq: 1, 2: 2})  # [bad\-format\-string\-key]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dq%(one)d, %(two)d\(dq % {\(dqone\(dq: 1, \(dqtwo\(dq: 2})

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
این بررسی تنها برای قالب‌بندی رشته به سبک قدیمی با استفاده از عملگر \(aq%\(aq کار می‌کند.
.sp
این بررسی تنها در صورتی کار می‌کند که دیکشنری حاوی مقادیر برای قالب‌بندی به‌صورت درون‌خطی (inline) تعریف شده باشد.
ارسال یک متغیر این بررسی را فعال نخواهد کرد، زیرا ممکن است از کلیدهای دیگر در این دیکشنری در زمینه‌های دیگری
استفاده شده باشد، در حالی که یک دیکشنری تعریف‌شده به‌صورت درون‌خطی مشخصاً تنها برای نگه‌داشتن مقادیری در نظر گرفته شده است
که باید قالب‌بندی شوند.
.sp
ایجادشده توسط بررسی‌کنندهٔ string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>.
.SS bad\-indentation / W0311
.sp
\fBپیام صادرشده:\fP
.sp
\fBدندانه‌گذاری نادرست. %s %s یافت شد، مورد انتظار %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که تعداد غیرمنتظره‌ای از فاصله‌ها یا تب‌های دندانه‌گذاری یافت شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
if input():
   print(\(aqyes\(aq)  # [bad\-indentation]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
if input():
    print(\(dqyes\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
از گزینهٔ \fB\-\-indent\-string\fP می‌توان برای تنظیم واحد دندانه‌گذاری برای این بررسی استفاده کرد.
.sp
ایجادشده توسط بررسی‌کنندهٔ format \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:format\:.py>..SS bad\-open\-mode / W1501
.sp
\fBپیام صادرشده:\fP
.sp
\fB\(dq%s\(dq حالت معتبری برای open نیست.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIپایتون از حالت‌های r، w، a[، x] همراه با گزینه‌های b، + و U (تنها با r) پشتیبانی می‌کند. صفحه https://docs.python.org/3/library/functions.html#open را ببینید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def open_and_get_content(file_path):
    with open(file_path, \(dqrwx\(dq) as file:  # [bad\-open\-mode]
        return file.read()

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def open_and_get_content(file_path):
    with open(file_path, \(dqr\(dq) as file:
        return file.read()

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده stdlib \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:stdlib\:.py>.
.SS bad\-staticmethod\-argument / W0211
.sp
\fBپیام صادرشده:\fP
.sp
\fBمتد ایستا با %r به‌عنوان نخستین آرگومان\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک متد ایستا دارای \(dqself\(dq یا مقداری مشخص‌شده در گزینه valid\-classmethod\-first\-arg یا گزینه valid\-metaclass\-classmethod\-first\-arg به‌عنوان نخستین آرگومان باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Wolf:
    @staticmethod
    def eat(self):  # [bad\-staticmethod\-argument]
        pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Wolf:
    @staticmethod
    def eat(sheep):
        pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>.
.SS bad\-thread\-instantiation / W1506
.sp
\fBپیام صادرشده:\fP
.sp
\fBthreading.Thread به تابع target نیاز دارد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاین هشدار زمانی صادر می‌شود که از کلاس threading.Thread بدون ارسال تابع target به‌صورت یک kwarg یا به‌عنوان آرگومان دوم نمونه‌سازی شود. به‌طور پیش‌فرض، پارامتر نخست پارامتر group است، نه پارامتر target.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import threading


def thread_target(n):
    print(n**2)


thread = threading.Thread(lambda: None)  # [bad\-thread\-instantiation]
thread.start()

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import threading


def thread_target(n):
    print(n**2)


thread = threading.Thread(target=thread_target, args=(10,))
thread.start()

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده stdlib \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:stdlib\:.py>..SS bare\-except / W0702
.sp
\fBپیام صادرشده:\fP
.sp
\fBهیچ نوع استثنایی مشخص نشده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIیک عبارت \(ga\(gaexcept:\(ga\(ga خالی، استثناهای \(ga\(gaSystemExit\(ga\(ga و \(ga\(gaKeyboardInterrupt\(ga\(ga را نیز می‌گیرد که این امر متوقف کردن برنامه با \(ga\(gaControl\-C\(ga\(ga را دشوارتر ساخته و می‌تواند مشکلات دیگر را پنهان کند. اگر می‌خواهید تمام استثناهایی را بگیرید که نشان‌دهنده خطاهای برنامه هستند، از \(ga\(gaexcept Exception:\(ga\(ga استفاده کنید (عبارت except خالی معادل \(ga\(gaexcept BaseException:\(ga\(ga است).\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
try:
    import platform_specific_module
except:  # [bare\-except]
    platform_specific_module = None

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
try:
    import platform_specific_module
except ImportError:
    platform_specific_module = None

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
یک قاعده سرانگشتی خوب این است که استفاده از عبارت‌های ‘except’ خالی را به دو حالت محدود کنید:
\- اگر گرداننده استثنا، گزارش ردیابی (traceback) را چاپ یا ثبت (log) کند؛ حداقل کاربر متوجه خواهد شد که خطایی رخ داده است.
\- اگر کد نیاز به انجام عملیات پاک‌سازی داشته باشد، اما سپس با raise اجازه دهد استثنا به سمت بالا منتشر شود. بلوک \fBtry...finally\fP می‌تواند روش بهتری برای مدیریت این حالت باشد.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
توصیه برنامه‌نویسی در PEP8 \%<https://\:peps\:.python\:.org/\:pep-0008/#\:programming-recommendations>
.IP \(bu 2
PEP 760 – No More Bare Excepts (ردشده) \%<https://\:peps\:.python\:.org/\:pep-0760>
.IP \(bu 2
بحث درباره PEP 760 \%<https://\:discuss\:.python\:.org/\:t/\:pep-760-no-more-bare-excepts/\:67182>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده exceptions \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:exceptions\:.py>.
.SS binary\-op\-exception / W0711
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستثنای موردنظر برای گرفتن، نتیجه یک عملیات باینری \(dq%s\(dq است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که استثنای موردنظر برای گرفتن به صورت \(dqexcept A or B:\(dq باشد. اگر قصد گرفتن چند استثنا را دارید، آن را به شکل \(dqexcept (A, B):\(dq بازنویسی کنید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
try:
    1 / 0
except ZeroDivisionError or ValueError:  # [binary\-op\-exception]
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
try:
    1 / 0
except (ZeroDivisionError, ValueError):
    pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده exceptions \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:exceptions\:.py>..SS boolean\-datetime / W1502
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از datetime.time در بافت بولی (boolean).\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاستفاده از datetime.time در یک بافت بولی می‌تواند باعث پنهان شدن باگ‌های ظریفی شود، به‌ویژه زمانی که زمان مشخص‌شده با نیمه‌شب UTC مطابقت دارد. این رفتار در Python 3.5 اصلاح شد. برای ارجاع، https://bugs.python.org/issue13936 را ببینید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import datetime

if datetime.time():  # [boolean\-datetime]
    print(\(dqIt is time.\(dq)


if datetime.datetime.now().time():  # [boolean\-datetime]
    print(\(dqNow or never.\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import datetime

time_now_utc = datetime.datetime.now(tz=datetime.UTC).time()

if time_now_utc > datetime.time(6, 0):
    print(\(dqDaytime!\(dq)

if time_now_utc < datetime.time(6, 0):
    print(\(dqNighttime!\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
py\-version=3.4

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
ردیاب باگ‌های Python \%<https://\:bugs\:.python\:.org/\:issue13936>
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده stdlib \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:stdlib\:.py>.
.SS break\-in\-finally / W0137
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از \(aqbreak\(aq درون بند \(aqfinally\(aq توصیه نمی‌شود\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که کلیدواژه \(gabreak\(ga درون یک بند finally پیدا شود. این مورد از Python 3.14 به بعد یک SyntaxWarning ایجاد خواهد کرد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
while True:
    try:
        pass
    finally:
        break  # [break\-in\-finally]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
while True:
    try:
        pass
    except ValueError:
        pass
    else:
        break

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
مستندات Python 3، بند \(aqfinally\(aq \%<https://\:docs\:.python\:.org/\:3/\:reference/\:compound_stmts\:.html#\:finally-clause>
.IP \(bu 2
PEP 765 \- منع return/break/continue که از بلوک finally خارج می‌شوند \%<https://\:peps\:.python\:.org/\:pep-0765>
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_error_checker\:.py>..SS broad\-exception\-caught / W0718
.sp
\fBپیام صادرشده:\fP
.sp
\fBگرفتن استثنای بیش از حد عمومی %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاگر از یک عبارت ساده‌ی \(ga\(gaexcept Exception:\(ga\(ga استفاده کنید، ممکن است در نهایت استثناهایی غیر از مواردی که انتظار دارید را بگیرید. این کار می‌تواند با پنهان کردن خطاهای نامرتبط، اشکال‌ها (باگ‌ها) را مخفی کرده و عیب‌یابی برنامه‌ها را دشوارتر کند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
try:
    import platform_specific_module
except Exception:  # [broad\-exception\-caught]
    platform_specific_module = None

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
try:
    import platform_specific_module
except ImportError:
    platform_specific_module = None

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
برای نمونه، اگر در حال تلاش برای وارد کردن یک کتابخانه با وابستگی‌های سیستمی موردنیاز باشید و به‌جای خطاهای واردسازی تنها، همه‌چیز را بگیرید، پیام خطایی را که می‌گوید کد شما در صورت نصب وابستگی‌های سیستمی می‌توانست اجرا شود، از دست خواهید داد.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
آیا همیشه باید نوع استثنا را در عبارات \(aqexcept\(aq مشخص کنم؟ \%<https://\:stackoverflow\:.com/\:a/\:14797508/\:2519059>
.UNINDENT
.sp
ایجادشده توسط ارزیاب exceptions \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:exceptions\:.py>.
.SS broad\-exception\-raised / W0719
.sp
\fBپیام صادرشده:\fP
.sp
\fBپرتاب استثنای بیش از حد عمومی: %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIپرتاب استثناهایی که بیش از حد کلی هستند شما را مجبور می‌کند که استثناها را نیز به‌صورت کلی بگیرید. این امر شما را وادار به استفاده از یک عبارت ساده‌ی \(ga\(gaexcept Exception:\(ga\(ga خواهد کرد. سپس ممکن است در نهایت استثناهایی به‌جز موارد مورد انتظار را بگیرید. این وضعیت می‌تواند خطاها را پنهان کرده و هنگام پنهان ماندن خطاهای غیرمرتبط، عیب‌یابی برنامه‌ها را سخت‌تر کند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def small_apple(apple, length):
    if len(apple) < length:
        raise Exception(\(dqApple is too small!\(dq)  # [broad\-exception\-raised]
    print(f\(dq{apple} is proper size.\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def small_apple(apple, length):
    if len(apple) < length:
        raise ValueError(\(dqApple is too small!\(dq)
    print(f\(dq{apple} is proper size.\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
توصیه‌های برنامه‌نویسی در PEP8 \%<https://\:peps\:.python\:.org/\:pep-0008/#\:programming-recommendations>
.UNINDENT
.sp
ایجادشده توسط ارزیاب exceptions \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:exceptions\:.py>..SS cell\-var\-from\-loop / W0640
.sp
\fBپیام صادرشده:\fP
.sp
\fBمتغیر سلولی %s در حلقه تعریف شده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIمتغیری که در یک بستار (closure) به کار رفته، درون یک حلقه تعریف شده است. این امر باعث می‌شود که تمام بستارها از همان مقدار یکسان برای متغیر محصورشده (closed\-over) استفاده کنند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def teacher_greeting(names):
    greetings = []
    for name in names:

        def greet():
            # do something
            print(f\(dqHello, {name}!\(dq)  # [cell\-var\-from\-loop]

        if name.isalpha():
            greetings.append(greet)

    for greet in greetings:
        # the \(dqname\(dq variable is evaluated when the function is called here,
        # which is the last value it had in the loop \- \(dqNot\-A\-Name\(dq
        greet()


teacher_greeting([\(dqGraham\(dq, \(dqJohn\(dq, \(dqTerry\(dq, \(dqEric\(dq, \(dqTerry\(dq, \(dqMichael\(dq])
# \(dqHello, Michael!\(dq
# \(dqHello, Michael!\(dq
# \(dqHello, Michael!\(dq
# \(dqHello, Michael!\(dq
# \(dqHello, Michael!\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.sp
\fBfunctools.partial.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import functools


def teacher_greeting(names):
    greetings = []
    for name in names:
        if name.isalpha():
            # \(dqname\(dq is evaluated when the partial is created here, so this
            # does not do lazy evaluation
            greetings.append(functools.partial(print, f\(dqHello, {name}!\(dq))

    for greet in greetings:
        # \(gapartial\(gas are called like functions, but you\(aqve already passed the
        # arguments to them
        greet()


teacher_greeting([\(dqGraham\(dq, \(dqJohn\(dq, \(dqTerry\(dq, \(dqEric\(dq, \(dqTerry\(dq, \(dqMichael\(dq])
# \(dqHello, Graham!\(dq
# \(dqHello, John!\(dq
# \(dqHello, Eric!\(dq
# \(dqHello, Terry!\(dq
# \(dqHello, Michael!\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBnew_function.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def teacher_greeting(names):
    def greet(name):
        # do something
        print(f\(dqHello, {name}!\(dq)

    for name in names:
        if name.isalpha():
            # we\(aqre passing the value of \(dqname\(dq to the function here
            greet(name)


teacher_greeting([\(dqGraham\(dq, \(dqJohn\(dq, \(dqTerry\(dq, \(dqEric\(dq, \(dqTerry\(dq, \(dqMichael\(dq])
# \(dqHello, Graham!\(dq
# \(dqHello, John!\(dq
# \(dqHello, Eric!\(dq
# \(dqHello, Terry!\(dq
# \(dqHello, Michael!\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
بحث در Stackoverflow \%<https://\:stackoverflow\:.com/\:questions/\:25314547/\:cell-var-from-loop-warning-from-pylint>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>..SS comparison\-with\-callable / W0143
.sp
\fBپیام صادرشده:\fP
.sp
\fBمقایسه با یک callable، آیا پرانتزها را از قلم انداخته‌اید؟\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاین پیام زمانی صادر می‌شود که pylint تشخیص دهد مقایسه‌ای با یک شیء قابل فراخوانی (callable) انجام شده است؛ امری که ممکن است نشان‌دهنده از قلم افتادن پرانتزها و در نتیجه بروز رفتار ناخواسته باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def function_returning_a_fruit() \-> str:
    return \(dqorange\(dq


def is_an_orange(fruit: str = \(dqapple\(dq):
    # apple == <function function_returning_a_fruit at 0x7f343ff0a1f0>
    return fruit == function_returning_a_fruit  # [comparison\-with\-callable]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def function_returning_a_fruit() \-> str:
    return \(dqorange\(dq


def is_an_orange(fruit: str = \(dqapple\(dq):
    # apple == orange
    return fruit == function_returning_a_fruit()

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:comparison_checker\:.py>.
.SS confusing\-with\-statement / W0124
.sp
\fBپیام صادرشده:\fP
.sp
\fBآمدن یک مدیر زمینه (context manager) دیگر پس از \(dqas\(dq شبیه یک تاپل به نظر می‌رسد.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که یکی از بخش‌های دستور \(gawith\(ga چندین مقدار بازگرداند و انتساب نام با \(gaas\(ga را تنها برای بخشی از آن مقادیر به کار ببرد، مانند with ctx() as a, b. این وضعیت می‌تواند گمراه‌کننده باشد، زیرا مشخص نیست که آیا مدیر زمینه یک تاپل برمی‌گرداند یا آن گره فاقد انتساب نام، خود یک مدیر زمینه دیگر است.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
with open(\(dqfile.txt\(dq, \(dqw\(dq) as fh1, fh2:  # [confusing\-with\-statement]
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
with open(\(dqfile.txt\(dq, \(dqw\(dq, encoding=\(dqutf8\(dq) as fh1:
    with open(\(dqfile.txt\(dq, \(dqw\(dq, encoding=\(dqutf8\(dq) as fh2:
        pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_checker\:.py>..SS consider\-ternary\-expression / W0160
.sp
\fBپیام صادرشده:\fP
.sp
\fBبازنویسی به‌صورت یک عبارت سه‌تایی را مد نظر قرار دهید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIچندین دستور انتساب که در بلوک‌های if/else پخش شده‌اند را می‌توان با یک انتساب واحد و یک عبارت سه‌تایی (ternary expression) بازنویسی کرد\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
x, y = input(), input()
if x >= y:  # [consider\-ternary\-expression]
    maximum = x
else:
    maximum = y

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
x, y = input(), input()
maximum = x if x >= y else y

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins=pylint.extensions.consider_ternary_expression

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کنندهٔ اختیاری \(aqconsider_ternary_expression\(aq \%<#\:pylint-extensions-consider-ternary-expression>
صادر می‌شود، که نیازمند بارگذاری افزونهٔ \fBpylint.extensions.consider_ternary_expression\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ consider_ternary_expression \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:consider_ternary_expression\:.py>.
.SS contextmanager\-generator\-missing\-cleanup / W0135
.sp
\fBپیام صادرشده:\fP
.sp
\fBاز زمینهٔ استفاده‌شده در تابع %r خارج نخواهد شد.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک contextmanager درون یک تابع مولد (generator function) استفاده شده باشد و پاک‌سازی مدیریت نشده باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import contextlib


@contextlib.contextmanager
def cm():
    contextvar = \(dqacquired context\(dq
    print(\(dqcm enter\(dq)
    yield contextvar
    print(\(dqcm exit\(dq)


def genfunc_with_cm():
    with cm() as context:  # [contextmanager\-generator\-missing\-cleanup]
        yield context * 2

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import contextlib


@contextlib.contextmanager
def good_cm_except():
    contextvar = \(dqacquired context\(dq
    print(\(dqgood cm enter\(dq)
    try:
        yield contextvar
    except GeneratorExit:
        print(\(dqgood cm exit\(dq)


def genfunc_with_cm():
    with good_cm_except() as context:
        yield context * 2


def genfunc_with_discard():
    with good_cm_except():
        yield \(dqdiscarded\(dq


@contextlib.contextmanager
def good_cm_yield_none():
    print(\(dqgood cm enter\(dq)
    yield
    print(\(dqgood cm exit\(dq)


def genfunc_with_none_yield():
    with good_cm_yield_none() as var:
        print(var)
        yield \(dqconstant yield\(dq


@contextlib.contextmanager
def good_cm_finally():
    contextvar = \(dqacquired context\(dq
    print(\(dqgood cm enter\(dq)
    try:
        yield contextvar
    finally:
        print(\(dqgood cm exit\(dq)


def good_cm_finally_genfunc():
    with good_cm_finally() as context:
        yield context * 2


@contextlib.contextmanager
def good_cm_no_cleanup():
    contextvar = \(dqacquired context\(dq
    print(\(dqcm enter\(dq)
    yield contextvar


def good_cm_no_cleanup_genfunc():
    with good_cm_no_cleanup() as context:
        yield context * 2

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
نمونه‌سازی و استفاده از یک contextmanager در داخل یک تابع مولد (generator function) در صورتی که این انتظار وجود داشته باشد که زمینه (context) فقط برای تابع مولد در دسترس باشد، می‌تواند به رفتارهای غیرمنتظره منجر شود. در صورتی که مولد بسته یا تخریب نشود، مدیر زمینه به همان صورت معلق باقی می‌ماند.
.sp
این پیام به‌جای تابع contextmanager به تابع مولد هشدار می‌دهد، زیرا روش‌های استفاده از یک contextmanager بسیار متنوع است.
یک contextmanager می‌تواند به‌عنوان یک دکوراتور استفاده شود (که بلافاصله متدهای \fB__enter__\fP/\fB__exit__\fP روی آن اعمال می‌شوند)
و استفاده از \fBas ...\fP یا دور انداختن مقدار بازگشتی نیز بیانگر این است که آیا زمینه به پاک‌سازی نیاز دارد یا خیر.
بنابراین برای این پیام، هشدار دادن به فراخوانندهٔ contextmanager اهمیت دارد.
.sp
این بررسی در صورتی که دستور \fByield\fP درون یک بلوک \fBif\-else\fP بدون پاک‌سازی سفارشی استفاده شود، می‌تواند موارد مثبت کاذب (false positive) ایجاد کند. برای این موارد از \fBpylint: disable\fP استفاده کنید.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from contextlib import contextmanager

@contextmanager
def good_cm_no_cleanup():
    contextvar = \(dqacquired context\(dq
    print(\(dqcm enter\(dq)
    if some_condition:
        yield contextvar
    else:
        yield contextvar


def good_cm_no_cleanup_genfunc():
    # pylint: disable\-next=contextmanager\-generator\-missing\-cleanup
    with good_cm_no_cleanup() as context:
        yield context * 2
.EE
.UNINDENT
.UNINDENT.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
دلایل توجیهی (Rationale) \%<https://\:discuss\:.python\:.org/\:t/\:preventing-yield-inside-certain-context-managers/\:1091>
.IP \(bu 2
گزارش اشکال CPython \%<https://\:github\:.com/\:python/\:cpython/\:issues/\:81924#\:issuecomment-1093830682>
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:function_checker\:.py>.
.SS continue\-in\-finally / W0136
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از \(aqcontinue\(aq در بند \(aqfinally\(aq توصیه نمی‌شود\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی صادر می‌شود که کلیدواژه \(gacontinue\(ga درون یک بند finally یافت شود. این مورد از Python 3.14 به بعد، یک SyntaxWarning ایجاد خواهد کرد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
while True:
    try:
        pass
    finally:
        continue  # [continue\-in\-finally]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
while True:
    try:
        pass
    except ValueError:
        pass
    else:
        continue

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
مستندات بند \(aqfinally\(aq در Python 3 \%<https://\:docs\:.python\:.org/\:3/\:reference/\:compound_stmts\:.html#\:finally-clause>
.IP \(bu 2
PEP 765 \- غیرمجاز کردن return/break/continue که از بلوک finally خارج می‌شوند \%<https://\:peps\:.python\:.org/\:pep-0765>
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_error_checker\:.py>.
.SS dangerous\-default\-value / W0102
.sp
\fBپیام صادرشده:\fP
.sp
\fBمقدار پیش‌فرض خطرناک %s به عنوان آرگومان\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک مقدار تغییرپذیر مانند لیست یا دیکشنری در مقدار پیش‌فرض یک آرگومان شناسایی شود.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def whats_on_the_telly(penguin=[]):  # [dangerous\-default\-value]
    penguin.append(\(dqproperty of the zoo\(dq)
    return penguin

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def whats_on_the_telly(penguin=None):
    if penguin is None:
        penguin = []
    penguin.append(\(dqproperty of the zoo\(dq)
    return penguin

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
با یک مقدار پیش‌فرض تغییرپذیر، با هر بار فراخوانی مقدار پیش‌فرض تغییر می‌یابد، یعنی:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
whats_on_the_telly() # [\(dqproperty of the zoo\(dq]
whats_on_the_telly() # [\(dqproperty of the zoo\(dq, \(dqproperty of the zoo\(dq]
whats_on_the_telly() # [\(dqproperty of the zoo\(dq, \(dqproperty of the zoo\(dq, \(dqproperty of the zoo\(dq]
.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_checker\:.py>..SS deprecated\-argument / W4903
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از آرگومان منسوخ‌شده %s در متد %s()\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاین آرگومان به‌عنوان منسوخ‌شده علامت‌گذاری شده است و در آینده حذف خواهد شد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
int(x=1)  # [deprecated\-argument]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
int(1)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
جایگزین واقعی باید به‌صورت موردی و با مطالعهٔ هشدار منسوخ‌شدن یا یادداشت‌های انتشار بررسی شود.
.sp
ایجادشده توسط بررسی‌کنندهٔ stdlib \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:stdlib\:.py>.
.SS deprecated\-attribute / W4906
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از صفت منسوخ‌شده %r\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاین صفت به‌عنوان منسوخ‌شده علامت‌گذاری شده است و در آینده حذف خواهد شد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from configparser import ParsingError

err = ParsingError(\(dqfilename\(dq)
source = err.filename  # [deprecated\-attribute]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from configparser import ParsingError

err = ParsingError(\(dqfilename\(dq)
source = err.source

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
جایگزین واقعی باید به‌صورت موردی و با مطالعهٔ هشدار منسوخ‌شدن یا یادداشت‌های انتشار بررسی شود.
.sp
ایجادشده توسط بررسی‌کنندهٔ stdlib \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:stdlib\:.py>..SS deprecated\-class / W4904
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از کلاس منسوخ‌شدهٔ %s از ماژول %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاین کلاس به عنوان منسوخ‌شده علامت‌گذاری شده است و در آینده حذف خواهد شد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from collections import Iterable  # [deprecated\-class]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from collections.abc import Iterable

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
جایگزین مناسب باید به صورت موردی و با مطالعهٔ هشدار منسوخ‌شدن یا یادداشت‌های انتشار بررسی شود.
.sp
ایجاد شده توسط بررسی‌کنندهٔ stdlib \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:stdlib\:.py>.
.SS deprecated\-decorator / W4905
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از دکوراتور منسوخ‌شدهٔ %s()\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاین دکوراتور به عنوان منسوخ‌شده علامت‌گذاری شده است و در آینده حذف خواهد شد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import abc


class Animal:
    @abc.abstractclassmethod  # [deprecated\-decorator]
    def breath(cls):
        pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import abc


class Animal:
    @abc.classmethod
    @abc.abstractmethod
    def breath(cls):
        pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
py\-version = 3.3

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
جایگزین مناسب باید به صورت موردی و با مطالعهٔ هشدار منسوخ‌شدن یا یادداشت‌های انتشار بررسی شود.
.sp
ایجاد شده توسط بررسی‌کنندهٔ stdlib \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:stdlib\:.py>..SS deprecated\-method / W4902
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از متد منسوخ‌شده %s()\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاین متد به عنوان منسوخ‌شده علامت‌گذاری شده است و در آینده حذف خواهد شد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import logging

logging.warn(\(dqI\(aqm coming, world !\(dq)  # [deprecated\-method]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import logging

logging.warning(\(dqI\(aqm coming, world !\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
جایگزین واقعی باید به‌صورت موردی و با خواندن هشدار منسوخ‌شدن
یا یادداشت‌های انتشار بررسی شود.
.sp
ایجادشده توسط بررسی‌کننده stdlib \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:stdlib\:.py>.
.SS deprecated\-module / W4901
.sp
\fBپیام صادرشده:\fP
.sp
\fBماژول منسوخ‌شده %r\fP
.sp
\fBتوضیحات:\fP
.sp
\fIماژولی که به عنوان منسوخ‌شده علامت‌گذاری شده است، درون‌ریزی شده است.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import distutils  # [deprecated\-module]

import whatever_you_want  # [deprecated\-module]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import setuptools
import whatever_replacement_you_want

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
py\-version=3.7
deprecated\-modules=whatever_you_want

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
جایگزین واقعی باید به‌صورت موردی و با خواندن هشدار منسوخ‌شدن
یا یادداشت‌های انتشار بررسی شود.
.sp
ایجادشده توسط بررسی‌کننده imports \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:imports\:.py>..SS deprecated\-typing\-alias / W6001
.sp
\fBپیام صادرشده:\fP
.sp
\fB\(aq%s\(aq منسوخ شده است، به جای آن از \(aq%s\(aq استفاده کنید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی صادر می‌شود که از یک نام مستعار منسوخ‌شده برای typing استفاده شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import typing

item_to_number_of_item: typing.Dict[str, int]  # [deprecated\-typing\-alias]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
item_to_number_of_item: dict[str, int]

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
load\-plugins = pylint.extensions.typing

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqtyping\(aq \%<#\:pylint-extensions-typing>
صادر می‌شود که نیازمند بارگذاری افزونه \fBpylint.extensions.typing\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده typing \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:typing\:.py>.
.SS differing\-param\-doc / W9017
.sp
\fBپیام صادرشده:\fP
.sp
\fBمغایرت \(dq%s\(dq در مستندسازی پارامتر\fP
.sp
\fBتوضیحات:\fP
.sp
\fIلطفاً نام‌های پارامتر را در اعلان‌ها بررسی کنید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def add(x, y):  # [differing\-param\-doc]
    \(dq\(dq\(dqAdd two numbers.

    :param int x: x value.
    :param int z: z value.
    \(dq\(dq\(dq

    return x + y

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def add(x, y):
    \(dq\(dq\(dqAdd two numbers.

    :param int x: x value.
    :param int y: y value.
    \(dq\(dq\(dq

    return x + y

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins = pylint.extensions.docparams

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqparameter_documentation\(aq \%<#\:pylint-extensions-docparams>
صادر می‌شود که نیازمند بارگذاری افزونه \fBpylint.extensions.docparams\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده parameter_documentation \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:docparams\:.py>..SS differing\-type\-doc / W9018
.sp
\fBپیام صادرشده:\fP
.sp
\fBتفاوت \(dq%s\(dq در مستندسازی نوع پارامتر\fP
.sp
\fBتوضیحات:\fP
.sp
\fIلطفاً نام پارامترها را در اعلان‌های نوع بررسی کنید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def add(x: int, y: int):  # [differing\-type\-doc]
    \(dq\(dq\(dqAdd two numbers.

    :param int xy: x value.
    :param str y: y value.
    \(dq\(dq\(dq

    return x + y

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def add(x, y):
    \(dq\(dq\(dqAdd two numbers.

    :param int x: x value.
    :param int y: y value.
    \(dq\(dq\(dq

    return x + y

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins = pylint.extensions.docparams

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کنندهٔ اختیاری \(aqparameter_documentation\(aq \%<#\:pylint-extensions-docparams> صادر می‌شود که نیازمند بارگذاری افزونهٔ \fBpylint.extensions.docparams\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ parameter_documentation \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:docparams\:.py>.
.SS duplicate\-except / W0705
.sp
\fBپیام صادرشده:\fP
.sp
\fBگرفتن نوع استثنای %s که پیش‌تر گرفته شده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک except نوعی را دریافت کند که پیش‌تر توسط یک گردانندهٔ قبلی گرفته شده است.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
try:
    1 / 0
except ZeroDivisionError:
    pass
except ZeroDivisionError:  # [duplicate\-except]
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
try:
    1 / 0
except ZeroDivisionError:
    pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ exceptions \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:exceptions\:.py>..SS duplicate\-key / W0109
.sp
\fBپیام صادرشده:\fP
.sp
\fBکلید تکراری %r در دیکشنری\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک عبارت دیکشنری، یک کلید یکسان را چندین بار مقید کند.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
test_score = {\(dqMathematics\(dq: 85, \(dqBiology\(dq: 90, \(dqMathematics\(dq: 75}  # [duplicate\-key]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
test_score = {\(dqMathematics\(dq: 85, \(dqBiology\(dq: 90, \(dqHistory\(dq: 75}

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
دیکشنری‌های پایتون \%<https://\:docs\:.python\:.org/\:3/\:tutorial/\:datastructures\:.html#\:dictionaries>
.IP \(bu 2
انواع نگاشت — dict \%<https://\:docs\:.python\:.org/\:3/\:library/\:stdtypes\:.html#\:typesmapping>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_checker\:.py>.
.SS duplicate\-string\-formatting\-argument / W1308
.sp
\fBپیام صادرشده:\fP
.sp
\fBآرگومان تکراری قالب‌بندی رشته %r، ارسال به عنوان آرگومان نام‌دار را مد نظر قرار دهید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که تشخیص دهیم در یک قالب‌بندی رشته، به‌جای استفاده از آرگومان‌های نام‌دار رشته، یک آرگومان تکرار شده است\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# pylint: disable=missing\-docstring, consider\-using\-f\-string

SEE = \(dqsee 👀\(dq
SEA = \(dqsea 🌊\(dq

# +1: [duplicate\-string\-formatting\-argument,duplicate\-string\-formatting\-argument]
CONST = \(dq\(dq\(dq
A sailor went to {}, {}, {}
To {} what he could {}, {}, {}
But all that he could {}, {}, {}
Was the bottom of the deep blue {}, {}, {}!
\(dq\(dq\(dq.format(
    SEA,
    SEA,
    SEA,
    SEE,
    SEE,
    SEE,
    SEE,
    SEE,
    SEE,
    SEE,
    SEA,
    SEA,
    SEA,
)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# pylint: disable=missing\-docstring, consider\-using\-f\-string

SEE = \(dqsee 👀\(dq
SEA = \(dqsea 🌊\(dq

CONST = \(dq\(dq\(dq
A sailor went to {sea}, {sea}, {sea}
To {see} what he could {see}, {see}, {see}
But all that he could {see}, {see}, {see}
Was the bottom of the deep blue {sea}, {sea}, {sea}!
\(dq\(dq\(dq.format(
    sea=SEA, see=SEE
)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>..SS duplicate\-value / W0130
.sp
\fBپیام صادرشده:\fP
.sp
\fBمقدار تکراری %r در مجموعه\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاین پیام زمانی صادر می‌شود که یک مجموعه دارای مقداری یکسان، دو بار یا بیشتر باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
incorrect_set = {\(dqvalue1\(dq, 23, 5, \(dqvalue1\(dq}  # [duplicate\-value]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
correct_set = {\(dqvalue1\(dq, 23, 5}

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_checker\:.py>.
.SS eq\-without\-hash / W1641
.sp
\fBپیام صادرشده:\fP
.sp
\fBپیاده‌سازی __eq__ بدون پیاده‌سازی هم‌زمان __hash__\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک کلاس __eq__ را پیاده‌سازی کند اما __hash__ را خیر. در صورتی که اشیاء __eq__ را پیاده‌سازی کنند، مقدار پیش‌فرض پیاده‌سازی __hash__ آن‌ها برابر با None قرار می‌گیرد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:  # [eq\-without\-hash]
    def __init__(self) \-> None:
        self.name = \(dqapple\(dq

    def __eq__(self, other: object) \-> bool:
        return isinstance(other, Fruit) and other.name == self.name

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    def __init__(self) \-> None:
        self.name = \(dqapple\(dq

    def __eq__(self, other: object) \-> bool:
        return isinstance(other, Fruit) and other.name == self.name

    def __hash__(self) \-> int:
        return hash(self.name)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins=pylint.extensions.eq_without_hash,

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqeq\-without\-hash\(aq \%<#\:pylint-extensions-eq-without-hash>
صادر می‌شود که مستلزم بارگذاری افزونهٔ \fBpylint.extensions.eq_without_hash\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده eq\-without\-hash \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:eq_without_hash\:.py>..SS eval\-used / W0123
.sp
\fBپیام صادرشده:\fP
.sp
\fBUse of eval\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی که از تابع \(dqeval\(dq استفاده می‌شود، برای جلوگیری از به‌کارگیری آن صادر می‌شود. برای ارزیابی امن رشته‌های حاوی عبارات پایتون از منابع غیرقابل‌اعتماد، استفاده از \(gaast.literal_eval\(ga را مد نظر قرار دهید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
eval(\(dq[1, 2, 3]\(dq)  # [eval\-used]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from ast import literal_eval

literal_eval(\(dq[1, 2, 3]\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_checker\:.py>.
.SS exec\-used / W0122
.sp
\fBپیام صادرشده:\fP
.sp
\fBUse of exec\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی که دستور \(aqexec\(aq به کار می‌رود صادر می‌شود. استفاده از این تابع برای ورودی‌های کاربر خطرناک است و به‌طور کلی نیز از کد واقعی کُندتر عمل می‌کند. این بدان معنا نیست که هرگز نباید از آن استفاده کنید، بلکه باید ابتدا راهکارهای جایگزین را بررسی کرده و توابع در دسترس را محدود نمایید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
username = \(dqAda\(dq
code_to_execute = f\(dq\(dq\(dqinput(\(aqEnter code to be executed please, {username}: \(aq)\(dq\(dq\(dq
program = exec(code_to_execute)  # [exec\-used]
exec(program)  # [exec\-used]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def get_user_code(name):
    return input(f\(dqEnter code to be executed please, {name}: \(dq)


username = \(dqAda\(dq
# If the globals dictionary does not contain a value for the key __builtins__,
# all builtins are allowed. You need to be explicit about it being disallowed.
allowed_globals = {\(dq__builtins__\(dq: {}}
allowed_locals = {}
# pylint: disable\-next=exec\-used
exec(get_user_code(username), allowed_globals, allowed_locals)

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
متدها و متغیرهای دردسترسِ استفاده‌شده در \fBexec()\fP ممکن است یک رخنهٔ امنیتی ایجاد کنند.
می‌توانید با ارسال پارامترهای اختیاریِ globals و locals (دیکشنری‌ها) به متد \fBexec()\fP، استفاده از این متغیرها و متدها را محدود کنید.
.sp
با این حال، در صورتی که توابعی مانند \fB__import__\fP یا \fBopen\fP مجاز باشند، استفاده از \fBexec()\fP همچنان ناامن است. برای نمونه، فراخوانی زیر را در نظر بگیرید که فایلی را روی سیستم کاربر می‌نویسد و سپس کدی را اجرا می‌کند که توسط پارامترهای \fBallowed_globals\fP یا \fBallowed_locals\fP مهار نشده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import textwrap


def forbid_print(*args):
    raise ValueError(\(dqThis is raised when a print is used\(dq)


allowed_globals = {
    \(dq__builtins__\(dq: {
        \(dq__import__\(dq: __builtins__.__import__,
        \(dqopen\(dq: __builtins__.open,
        \(dqprint\(dq: forbid_print,
    }
}

exec(
    textwrap.dedent(
        \(dq\(dq\(dq
    import textwrap

    with open(\(dqnefarious.py\(dq, \(dqw\(dq) as f:
        f.write(textwrap.dedent(\(aq\(aq\(aq
            def connive():
                print(\(dqHere\(aqs some code as nefarious as imaginable\(dq)
        \(aq\(aq\(aq))

    import nefarious

    nefarious.connive()  # This will NOT raise a ValueError
    \(dq\(dq\(dq
    ),
    allowed_globals,
)
.EE
.UNINDENT
.UNINDENT
.sp
در این حالت، import صرفاً برای خوانایی مثال به کار رفته است اما می‌تواند توابع خطرناکی را وارد کند:
.INDENT 0.0
.IP \(bu 2
\fBsubprocess.run(\(aqecho \(dqprint(\e\(dqHello, World!\e\(dq)\(dq > nefarious.py\(aq\fP
.IP \(bu 2
\fBpathlib.Path(\(dqnefarious.py\(dq).write_file(\(dqprint(\e\(dqHello, World!\e\(dq)\(dq)\fP
.IP \(bu 2
\fBos.system(\(aqecho \(dqprint(\e\(dqHello, World!\e\(dq)\(dq > nefarious.py\(aq)\fP
.IP \(bu 2
\fBlogging.basicConfig(filename=\(aqnefarious.py\(aq); logging.error(\(aqprint(\(dqHello, World!\(dq)\(aq)\fP
.IP \(bu 2
و غیره.
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
مراقب exec و eval در پایتون باشید \%<https://\:lucumr\:.pocoo\:.org/\:2011/\:2/\:1/\:exec-in-python>
.IP \(bu 2
مستندات پایتون \%<https://\:docs\:.python\:.org/\:3/\:library/\:functions\:.html#\:exec>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_checker\:.py>..SS expression\-not\-assigned / W0106
.sp
\fBپیام صادرشده:\fP
.sp
\fBعبارت \(dq%s\(dq به هیچ چیزی انتساب نیافته است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که عبارتی که فراخوانی تابع نیست، به هیچ چیزی تخصیص داده نشده باشد. احتمالاً منظور چیز دیگری بوده است.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
str(42) == \(dq42\(dq  # [expression\-not\-assigned]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
are_equal: bool = str(42) == \(dq42\(dq

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_checker\:.py>.
.SS f\-string\-without\-interpolation / W1309
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از یک f\-string که فاقد هرگونه متغیر درون‌یابی‌شده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک f\-string بدون هیچ متغیر درون‌یابی‌شده‌ای شناسایی شود، که در این صورت می‌تواند یک رشتهٔ عادی یا یک اشکال در کد باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
x = 1
y = 2
print(f\(dqx + y = x + y\(dq)  # [f\-string\-without\-interpolation]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
x = 1
y = 2
print(f\(dq{x} + {y} = {x + y}\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>.
.SS fixme / W0511
.sp
\fBپیام صادرشده:\fP
.sp
\fB%s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یادداشت هشداری مانند FIXME یا XXX شناسایی شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# TODO: We should fix this at some point  # [fixme]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.sp
\fBbug_tracker.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# The issue was added to the bug tracker: no longer need the comment

.EE
.UNINDENT
.UNINDENT
.sp
\fBfixed.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# The issue was fixed: no longer need the comment

.EE
.UNINDENT
.UNINDENT
.sp
\fBno_fix.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# We no longer want to fix this: no longer need the comment

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
می‌توانید از عبارت‌های باقاعده و گزینهٔ \fBnotes\-rgx\fP برای ایجاد محدودیت‌هایی برای این پیام استفاده کنید.
برای مشاهدهٔ چند مثال، موضوع \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:2874> را ببینید.
.sp
ایجادشده توسط بررسی‌کننده miscellaneous \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:misc\:.py>..SS forgotten\-debug\-statement / W1515
.sp
\fBپیام صادرشده:\fP
.sp
\fBباقی گذاشتن توابعی که نقطه توقف ایجاد می‌کنند در کد عملیاتی توصیه نمی‌شود\fP
.sp
\fBتوضیحات:\fP
.sp
\fIفراخوانی‌های breakpoint()، sys.breakpointhook() و pdb.set_trace() باید از کدی که فعالانه اشکال‌زدایی نمی‌شود حذف شوند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import pdb


def find_the_treasure(clues):
    for clue in clues:
        pdb.set_trace()  # [forgotten\-debug\-statement]
        if \(dqtreasure\(dq in clue:
            return True
    return False


treasure_hunt = [
    \(dqDead Man\(aqs Chest\(dq,
    \(dqX marks the spot\(dq,
    \(dqThe treasure is buried near the palm tree\(dq,
]
find_the_treasure(treasure_hunt)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def find_the_treasure(clues):
    for clue in clues:
        if \(dqtreasure\(dq in clue:
            return True
    return False


treasure_hunt = [
    \(dqDead Man\(aqs Chest\(dq,
    \(dqX marks the spot\(dq,
    \(dqThe treasure is buried near the palm tree\(dq,
]
find_the_treasure(treasure_hunt)

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده stdlib \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:stdlib\:.py>.
.SS format\-combined\-specification / W1305
.sp
\fBپیام صادرشده:\fP
.sp
\fBرشته قالب‌بندی شامل هر دو حالت شماره‌گذاری خودکار فیلدها و تعیین دستی فیلد است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک رشته قالب‌بندی بر اساس PEP 3101 هم شامل شماره‌گذاری خودکار فیلد (مانند \(aq{}\(aq) و هم تعیین دستی فیلد (مانند \(aq{0}\(aq) باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dq{} {1}\(dq.format(\(dqhello\(dq, \(dqworld\(dq))  # [format\-combined\-specification]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.sp
\fBindex_formatting.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dq{0} {1}\(dq.format(\(dqhello\(dq, \(dqworld\(dq))

.EE
.UNINDENT
.UNINDENT
.sp
\fBorder_formatting.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dq{} {}\(dq.format(\(dqhello\(dq, \(dqworld\(dq))

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>..SS format\-string\-without\-interpolation / W1310
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از قالب‌بندی برای رشته‌ای که فاقد هرگونه متغیر درون‌یابی‌شده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که رشته‌ای فاقد هرگونه متغیر درون‌یابی شناسایی شود؛ در این صورت می‌تواند یک رشته معمولی بدون قالب‌بندی یا یک باگ در کد باشد.\fP
.sp
\fBکد دارای ایراد:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqnumber\(dq.format(1))  # [format\-string\-without\-interpolation]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqnumber: {}\(dq.format(1))

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>\&.
.SS global\-at\-module\-level / W0604
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از دستور global در سطح ماژول\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که از دستور \(dqglobal\(dq در سطح ماژول استفاده کنید، زیرا این کار هیچ تأثیری ندارد.\fP
.sp
\fBکد دارای ایراد:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
price = 25
global price  # [global\-at\-module\-level]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
price = 25

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
پرسش‌های متداول رسمی Python \- متغیرهای global و local \%<https://\:docs\:.python\:.org/\:3/\:faq/\:programming\:.html#\:what-are-the-rules-for-local-and-global-variables-in-python>
.IP \(bu 2
PEP 3104 \- دسترسی به نام‌ها در حوزه‌های بیرونی \%<https://\:peps\:.python\:.org/\:pep-3104>
.IP \(bu 2
دستور global در Python \%<https://\:docs\:.python\:.org/\:3/\:reference/\:simple_stmts\:.html#\:global>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>\&.
.SS global\-statement / W0603
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از دستور global\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که از دستور \(dqglobal\(dq برای به‌روزرسانی یک متغیر سراسری استفاده کنید. Pylint استفاده از آن را توصیه نمی‌کند. البته این بدان معنا نیست که نمی‌توانید از آن استفاده کنید!\fP
.sp
\fBکد دارای ایراد:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
var = 1


def foo():
    global var  # [global\-statement]
    var = 10
    print(var)


foo()
print(var)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
var = 1


def foo():
    print(var)
    return 10


var = foo()
print(var)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>\&..SS global\-variable\-not\-assigned / W0602
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از global برای %r اما هیچ انتسابی انجام نشده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی که متغیری تعریف‌شده در دامنه سراسری در یک دامنه درونی تغییر داده می‌شود، کلمه کلیدی \(aqglobal\(aq در دامنه درونی تنها در صورتی مورد نیاز است که عملیات انتساب در آن دامنه درونی انجام شده باشد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
TOMATO = \(dqblack cherry\(dq


def update_tomato():
    global TOMATO  # [global\-variable\-not\-assigned]
    print(TOMATO)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
TOMATO = \(dqblack cherry\(dq


def update_tomato():
    global TOMATO
    TOMATO = \(dqmoneymaker\(dq

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>.
.SS global\-variable\-undefined / W0601
.sp
\fBپیام صادرشده:\fP
.sp
\fBمتغیر سراسری %r در سطح ماژول تعریف نشده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که متغیری از طریق دستور \(dqglobal\(dq تعریف شده باشد اما متغیر در دامنه ماژول تعریف نشده باشد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def update_tomato():
    global TOMATO  # [global\-variable\-undefined]
    TOMATO = \(dqmoneymaker\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
TOMATO = \(dqblack cherry\(dq


def update_tomato():
    global TOMATO
    TOMATO = \(dqmoneymaker\(dq

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>..SS implicit\-flag\-alias / W0213
.sp
\fBپیام صادرشده:\fP
.sp
\fBعضو پرچم %(overlap)s جایگاه‌های بیتی مشترکی با %(sources)s دارد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که چندین مقدار عدد صحیحِ تعریف‌شده درون یک کلاس enum.IntFlag دارای یک موقعیت بیتی مشترک باشند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from enum import IntFlag


class FilePermissions(IntFlag):
    READ = 1
    WRITE = 2
    EXECUTE = 3  # [implicit\-flag\-alias]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from enum import IntFlag


class FilePermissions(IntFlag):
    READ = 1
    WRITE = 2
    EXECUTE = 4

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>.
.SS implicit\-str\-concat / W1404
.sp
\fBپیام صادرشده:\fP
.sp
\fBالحاق ضمنی رشته در %s یافت شد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIلیترال‌های رشته‌ای به‌طور ضمنی در تعریف لیترال یک پیمایش‌پذیر الحاق شده‌اند: شاید یک ویرگول جا افتاده است؟\fP
.sp
\fBکد دارای مشکل:\fP
.sp
\fBlist.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
x = [\(dqa\(dq \(dqb\(dq]  # [implicit\-str\-concat]

.EE
.UNINDENT
.UNINDENT
.sp
\fBopen.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
with open(\(dqhello.txt\(dq \(dqr\(dq) as f:  # [implicit\-str\-concat]
    print(f.read())

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.sp
\fBlist.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
x = [\(dqa\(dq, \(dqb\(dq]

.EE
.UNINDENT
.UNINDENT
.sp
\fBopen.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
with open(\(dqhello.txt\(dq, \(dqr\(dq) as f:
    print(f.read())

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
به‌طور پیش‌فرض، تشخیص الحاق ضمنی رشته در شکست خطوط غیرفعال است.
بنابراین کد زیر این قاعده را فعال نخواهد کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
SEQ = (\(aqa\(aq, \(aqb\(aq
            \(aqc\(aq)
.EE
.UNINDENT
.UNINDENT
.sp
به‌منظور تشخیص این حالت، باید \fIcheck\-str\-concat\-over\-line\-jumps\fP را فعال کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[STRING_CONSTANT]
check\-str\-concat\-over\-line\-jumps = true
.EE
.UNINDENT
.UNINDENT
.sp
با این حال، ایراد این تنظیم این است که برای پارامترهای رشته‌ای که در چند سطر در فراخوانی توابع ارسال می‌شوند، مثبت کاذب ایجاد خواهد کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
warnings.warn(
    \(dqrotate() is deprecated and will be removed in a future release. \(dq
    \(dqUse the rotation() context manager instead.\(dq,
    DeprecationWarning,
    stacklevel=3,
)
.EE
.UNINDENT
.UNINDENT
.sp
اگر الحاق مورد نظر را با پرانتز مشخص کنید، هیچ پیامی صادر نخواهد شد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
warnings.warn(
    (
        \(dqrotate() is deprecated and will be removed in a future release. \(dq
        \(dqUse the rotation() context manager instead.\(dq
    ),
    DeprecationWarning,
    stacklevel=3,
)
.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>..SS import\-self / W0406
.sp
\fBپیام صادرشده:\fP
.sp
\fBماژول خود را وارد (import) می‌کند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک ماژول خود را import می‌کند.\fP
.sp
\fBجزئیات بیشتر:\fP
.sp
فرض کنید فایلی به نام \fBmy_file.py\fP\& دارید. خطای \fBimport\-self\fP در کد زیر صادر خواهد شد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from my_file import a_function  # [import\-self]

def a_function():
    pass
.EE
.UNINDENT
.UNINDENT
.sp
راهکار این است که import حذف شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def a_function():
    pass
.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده imports \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:imports\:.py>.
.SS inconsistent\-quotes / W1405
.sp
\fBپیام صادرشده:\fP
.sp
\fBجداکننده نقل‌قول %s با سایر بخش‌های فایل ناسازگار است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIجداکننده‌های نقل‌قول در سرتاسر یک ماژول به‌طور یکدست استفاده نشده‌اند (با در نظر گرفتن مواردی جهت جلوگیری از escape کردن‌های غیرضروری).\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import datetime

print(\(aqCurrent year: \(aq, datetime.date.today().strftime(\(dq%Y\(dq)) # [inconsistent\-quotes]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import datetime

print(\(dqCurrent year: \(dq, datetime.date.today().strftime(\(dq%Y\(dq))

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
check\-quote\-consistency=yes

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>..SS invalid\-envvar\-default / W1508
.sp
\fBپیام صادرشده:\fP
.sp
\fBنوع پیش‌فرض %s برابر %s است. str یا None مورد انتظار بود.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIتوابع دستکاری متغیرهای محیطی مقادیر None یا str را بازمی‌گردانند. ارسال هر مقداری به جز این‌ها به عنوان پیش‌فرض ممکن است باعث بروز باگ شود. ببینید: https://docs.python.org/3/library/os.html#os.getenv.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import os

env = os.getenv(\(dqSECRET_KEY\(dq, 1)  # [invalid\-envvar\-default]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import os

env = os.getenv(\(dqSECRET_KEY\(dq, \(dq1\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده stdlib \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:stdlib\:.py>.
.SS invalid\-format\-index / W1307
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از کلید جستجوی نامعتبر %r در مشخص‌کننده قالب %r\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک رشته قالب‌بندی PEP 3101 از یک مشخص‌کننده جستجو ({a[1]}) استفاده کند، اما آرگومان ارسال‌شده برای قالب‌بندی فاقد آن کلید باشد یا آن کلید را به عنوان یک صفت نداشته باشد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
not_enough_fruits = [\(dqapple\(dq]
print(\(aqThe second fruit is a {fruits[1]}\(aq.format(fruits=not_enough_fruits))  # [invalid\-format\-index]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
enough_fruits = [\(dqapple\(dq, \(dqbanana\(dq]
print(\(dqThe second fruit is a {fruits[1]}\(dq.format(fruits=enough_fruits))

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>.
.SS invalid\-overridden\-method / W0236
.sp
\fBپیام صادرشده:\fP
.sp
\fBانتظار می‌رفت متد %r به صورت %r باشد، اما در عوض %r یافت شد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که تشخیص داده شود یک متد به شیوه‌ای بازنویسی شده است که با کلاس پایه خود همخوانی ندارد، که می‌تواند منجر به باگ‌های بالقوه در زمان اجرا شود.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    async def bore(self, insect):
        insect.eat(self)


class Apple(Fruit):
    def bore(self, insect):  # [invalid\-overridden\-method]
        insect.eat(self)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    async def bore(self, insect):
        insect.eat(self)


class Apple(Fruit):
    async def bore(self, insect):
        insect.eat(self)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>..SS isinstance\-second\-argument\-not\-valid\-type / W1116
.sp
\fBپیام صادرشده:\fP
.sp
\fBآرگومان دوم isinstance یک نوع نیست\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی صادر می‌شود که آرگومان دوم یک فراخوانی isinstance یک نوع (type) نباشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
isinstance(\(dqapples and oranges\(dq, hex)  # [isinstance\-second\-argument\-not\-valid\-type]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
isinstance(\(dqapples and oranges\(dq, str)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>.
.SS keyword\-arg\-before\-vararg / W1113
.sp
\fBپیام صادرشده:\fP
.sp
\fBآرگومان کلیدواژه‌ای پیش از فهرست آرگومان‌های مکانی متغیر در تعریف تابع %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگام تعریف یک آرگومان کلیدواژه‌ای پیش از آرگومان‌های مکانی متغیر، در صورتی که تابع یا متد با آرگومان‌های کلیدواژه‌ای فراخوانی شود، ممکن است چندین مقدار برای پارامتر مذکور ارسال شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def func(x=None, *args):  # [keyword\-arg\-before\-vararg]
    return [x, *args]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def func(*args, x=None):
    return [*args, x]

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>.
.SS kwarg\-superseded\-by\-positional\-arg / W1117
.sp
\fBپیام صادرشده:\fP
.sp
\fBمقدار %r در %r گنجانده خواهد شد، زیرا پارامتری فقط\-مکانی با همین نام از قبل وجود دارد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی صادر می‌شود که تابعی با یک آرگومان کلیدواژه‌ای هم‌نام با یک پارامتر فقط\-مکانی فراخوانی شود و تابع دارای یک دیکشنری از پارامترهای متغیر کلیدواژه‌ای باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def print_name(name=\(dqSarah\(dq, /, **kwds):
    print(name)


print_name(name=\(dqJacob\(dq)  # [kwarg\-superseded\-by\-positional\-arg]
# Will print \(dqSarah\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def print_name(name=\(dqSarah\(dq, /, **kwds):
    print(name)


print_name(\(dqJacob\(dq)
# Will print \(dqJacob\(dq

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>..SS logging\-format\-interpolation / W1202
.sp
\fBپیام صادرشده:\fP
.sp
\fBاز قالب‌بندی %s در توابع logging استفاده کنید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک عبارت logging به شکل فراخوانی \(dqlogging.<logging method>(format_string.format(format_args...))\(dq باشد. به‌جای آن از نوع دیگری از قالب‌بندی رشته استفاده کنید. می‌توانید از قالب‌بندی % استفاده کنید اما با ارسال پارامترها به‌عنوان آرگومان، درون‌یابی را به تابع logging واگذار نمایید. اگر logging\-fstring\-interpolation غیرفعال باشد، می‌توانید از قالب‌بندی fstring استفاده کنید. اگر logging\-not\-lazy غیرفعال باشد، می‌توانید طبق روال معمول از قالب‌بندی % استفاده کنید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import logging
import sys

# +1: [logging\-format\-interpolation]
logging.error(\(dqPython version: {}\(dq.format(sys.version))

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import logging
import sys

logging.error(\(dqPython version: %s\(dq, sys.version)

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
یک گزینهٔ معقول دیگر استفاده از f\-string است. اگر قصد انجام این کار را دارید، باید
\fBlogging\-format\-interpolation\fP را فعال و \fBlogging\-fstring\-interpolation\fP را غیرفعال کنید\&.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
داده‌های متغیر در logging \%<https://\:docs\:.python\:.org/\:3/\:howto/\:logging\:.html#\:logging-variable-data>
.IP \(bu 2
دلیل منطقی برای این پیام در Stack Overflow \%<https://\:stackoverflow\:.com/\:a/\:34634301/\:2519059>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ logging \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:logging\:.py>.
.SS logging\-fstring\-interpolation / W1203
.sp
\fBپیام صادرشده:\fP
.sp
\fBاز قالب‌بندی %s در توابع logging استفاده کنید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک عبارت logging به شکل فراخوانی \(dqlogging.<logging method>(f\(dq...\(dq)\(dq باشد. به‌جای آن از نوع دیگری از قالب‌بندی رشته استفاده کنید. می‌توانید از قالب‌بندی % استفاده کنید اما با ارسال پارامترها به‌عنوان آرگومان، درون‌یابی را به تابع logging واگذار نمایید. اگر logging\-format\-interpolation غیرفعال باشد، می‌توانید از str.format استفاده کنید. اگر logging\-not\-lazy غیرفعال باشد، می‌توانید طبق روال معمول از قالب‌بندی % استفاده کنید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import logging
import sys

logging.error(f\(dqPython version: {sys.version}\(dq)  # [logging\-fstring\-interpolation]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import logging
import sys

logging.error(\(dqPython version: %s\(dq, sys.version)

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
این پیام امکان مجاز دانستن f\-string در logging را فراهم می‌کند در حالی که همچنان در صورت وقوع
\fBlogging\-format\-interpolation\fP هشدار می‌دهد\&.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
داده‌های متغیر در logging \%<https://\:docs\:.python\:.org/\:3/\:howto/\:logging\:.html#\:logging-variable-data>
.IP \(bu 2
دلیل منطقی \%<https://\:stackoverflow\:.com/\:questions/\:34619790>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ logging \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:logging\:.py>..SS logging\-not\-lazy / W1201
.sp
\fBپیام صادرشده:\fP
.sp
\fBاز قالب‌بندی %s در توابع logging استفاده کنید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک عبارت logging فراخوانی‌ای به شکل \(dqlogging.<logging method>(format_string % (format_args...))\(dq داشته باشد. به‌جای آن از نوع دیگری از قالب‌بندی رشته استفاده کنید. می‌توانید از قالب‌بندی % استفاده کنید اما با ارسال پارامترها به‌عنوان آرگومان، درون‌یابی (interpolation) را به تابع logging بسپارید. اگر logging\-fstring\-interpolation غیرفعال باشد می‌توانید از قالب‌بندی fstring استفاده کنید. اگر logging\-format\-interpolation غیرفعال باشد می‌توانید از str.format استفاده کنید.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import logging

try:
    function()
except Exception as e:
    logging.error(\(dqError occurred: %s\(dq % e)  # [logging\-not\-lazy]
    raise

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import logging

try:
    function()
except Exception as e:
    logging.error(\(dqError occurred: %s\(dq, e)
    raise

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
گزینهٔ معقول دیگر استفاده از f\-string است. اگر قصد انجام این کار را دارید، باید
\fBlogging\-not\-lazy\fP را فعال و \fBlogging\-fstring\-interpolation\fP را غیرفعال کنید\&.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
ثبت داده‌های متغیر \%<https://\:docs\:.python\:.org/\:3/\:howto/\:logging\:.html#\:logging-variable-data>
.IP \(bu 2
دلیل وجود این پیام در stackoverflow \%<https://\:stackoverflow\:.com/\:a/\:34634301/\:2519059>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ logging \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:logging\:.py>\&.
.SS lost\-exception / W0150
.sp
\fBپیام صادرشده:\fP
.sp
\fBدستور %s در بلوک finally ممکن است استثنا را ببلعد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک دستور break یا return درون بند finally از یک بلوک try...finally یافت شود: استثناهای رخ‌داده در بند try به‌جای برانگیخته شدن مجدد (re\-raised)، در سکوت بلعیده و نادیده گرفته خواهند شد.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class FasterThanTheSpeedOfLightError(ZeroDivisionError):
    def __init__(self):
        super().__init__(\(dqYou can\(aqt go faster than the speed of light !\(dq)


def calculate_speed(distance: float, time: float) \-> float:
    try:
        return distance / time
    except ZeroDivisionError as e:
        raise FasterThanTheSpeedOfLightError() from e
    finally:
        return 299792458  # [lost\-exception]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class FasterThanTheSpeedOfLightError(ZeroDivisionError):
    def __init__(self):
        super().__init__(\(dqYou can\(aqt go faster than the speed of light !\(dq)


def calculate_speed(distance: float, time: float) \-> float:
    try:
        return distance / time
    except ZeroDivisionError as e:
        raise FasterThanTheSpeedOfLightError() from e

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_checker\:.py>\&..SS method\-cache\-max\-size\-none / W1518
.sp
\fBپیام صادرشده:\fP
.sp
\fBعبارت \(aqlru_cache(maxsize=None)\(aq یا \(aqcache\(aq تمام آرگومان‌های متد، از جمله \(aqself\(aq را تا ابد زنده نگه می‌دارد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIبا استفاده از دکوراتور lru_cache یا cache روی یک متد، آرگومان \(aqself\(aq به تابع پیوند خورده و در نتیجه هرگز زباله‌روبی (garbage collected) نخواهد شد. مگر اینکه نمونه شیء شما هرگز نیازی به بازیافت حافظه نداشته باشد (تک‌نمونه یا singleton)، توصیه می‌شود کد را بازنویسی کرده تا از این الگو پرهیز شود یا یک maxsize به حافظه پنهان (cache) بیفزایید. مقدار پیش‌فرض برای maxsize برابر 128 است.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import functools


class Fibonnaci:
    def __init__(self):
        self.result = []

    @functools.lru_cache(maxsize=None)  # [method\-cache\-max\-size\-none]
    def fibonacci(self, n):
        if n in {0, 1}:
            self.result.append(n)
        self.result.append(self.fibonacci(n \- 1) + self.fibonacci(n \- 2))

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import functools


@functools.cache
def cached_fibonacci(n):
    if n in {0, 1}:
        return n
    return cached_fibonacci(n \- 1) + cached_fibonacci(n \- 2)


class Fibonnaci:
    def __init__(self):
        self.result = []

    def fibonacci(self, n):
        self.result.append(cached_fibonacci(n))

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده stdlib \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:stdlib\:.py>.
.SS misplaced\-future / W0410
.sp
\fBپیام صادرشده:\fP
.sp
\fBواردسازی __future__ نخستین عبارت غیر docstring نیست\fP
.sp
\fBتوضیحات:\fP
.sp
\fIپایتون 2.5 و بالاتر نیازمند این است که واردسازی __future__ نخستین دستور غیر docstring در ماژول باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import sys

from __future__ import print_function  # [misplaced\-future]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from __future__ import print_function

import sys

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
یک عبارت raise خالی آخرین استثنای فعال در حوزه (scope) جاری را مجدداً برمی‌انگیزد (re\-raise). اگر دستور \fBraise\fP درون یک بلوک \fBexcept\fP یا \fBfinally\fP نباشد، به‌جای آن یک RuntimeError صادر خواهد شد.
.sp
ایجاد شده توسط بررسی‌کننده imports \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:imports\:.py>..SS missing\-any\-param\-doc / W9021
.sp
\fBپیام صادرشده:\fP
.sp
\fBنبود هرگونه مستندات در \(dq%s\(dq\fP
.sp
\fBتوضیحات:\fP
.sp
\fIلطفاً مستندات پارامتر و/یا نوع را اضافه کنید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def puppies(head, tail):  # [missing\-any\-param\-doc]
    \(dq\(dq\(dqPrint puppy\(aqs details.\(dq\(dq\(dq
    print(head, tail)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def puppies(head: str, tail: str):
    \(dq\(dq\(dqPrint puppy\(aqs details.

    :param head: description of the head of the dog
    :param tail: description of the tail of the dog
    \(dq\(dq\(dq
    print(head, tail)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
load\-plugins = pylint.extensions.docparams
accept\-no\-param\-doc = false

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqparameter_documentation\(aq \%<#\:pylint-extensions-docparams>
صادر می‌شود که نیازمند بارگذاری افزونه \fBpylint.extensions.docparams\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده parameter_documentation \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:docparams\:.py>.
.SS missing\-format\-argument\-key / W1303
.sp
\fBپیام صادرشده:\fP
.sp
\fBنبود آرگومان کلیدواژه‌ای %r برای رشته قالب‌بندی\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک رشته قالب‌بندی PEP 3101 که از فیلدهای نام‌گذاری‌شده استفاده می‌کند، یک یا چند کلیدواژه لازم را دریافت نکند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqMy name is {first} {last}\(dq.format(first=\(dqJohn\(dq))  # [missing\-format\-argument\-key]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqMy name is {first} {last}\(dq.format(first=\(dqJohn\(dq, last=\(dqWick\(dq))

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
PEP 3101 \%<https://\:peps\:.python\:.org/\:pep-3101>
.IP \(bu 2
قالب‌بندی سفارشی رشته \%<https://\:docs\:.python\:.org/\:3/\:library/\:string\:.html#\:custom-string-formatting>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>..SS missing\-format\-attribute / W1306
.sp
\fBپیام صادرشده:\fP
.sp
\fBویژگی قالب‌بندی %r در مشخص‌کننده قالب %r وجود ندارد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک رشته قالب‌بندی PEP 3101 از یک مشخص‌کننده ویژگی ({0.length}) استفاده کند، اما آرگومان ارسال‌شده برای قالب‌بندی فاقد آن ویژگی باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dq{0.real}\(dq.format(\(dq1\(dq))  # [missing\-format\-attribute]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dq{0.real}\(dq.format(1))

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>.
.SS missing\-param\-doc / W9015
.sp
\fBپیام صادرشده:\fP
.sp
\fB\(dq%s\(dq در مستندات پارامتر وجود ندارد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIلطفاً اعلان پارامترها را برای همه پارامترها اضافه کنید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def integer_sum(a: int, b):  # [missing\-param\-doc]
    \(dq\(dq\(dqReturns sum of two integers
    :param a: first integer
    \(dq\(dq\(dq
    return a + b

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def integer_sum(a: int, b: int):
    \(dq\(dq\(dqReturns sum of two integers
    :param a: first integer
    :param b: second integer
    \(dq\(dq\(dq
    return a + b

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins = pylint.extensions.docparams

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqparameter_documentation\(aq \%<#\:pylint-extensions-docparams>
صادر می‌شود که نیازمند بارگذاری افزونه \fBpylint.extensions.docparams\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده parameter_documentation \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:docparams\:.py>..SS missing\-parentheses\-for\-call\-in\-test / W0126
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از یک عبارت شرطی با فراخوانی احتمالاً اشتباه تابع یا متد به دلیل نبود پرانتز\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که به نظر برسد یک عبارت شرطی (If یا if سه‌تایی) به دلیل نبود پرانتز تابعی را به اشتباه فراخوانی می‌کند\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import random


def is_it_a_good_day():
    return random.choice([True, False])


if is_it_a_good_day:  # [missing\-parentheses\-for\-call\-in\-test]
    print(\(dqToday is a good day!\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import random


def is_it_a_good_day():
    return random.choice([True, False])


if is_it_a_good_day():
    print(\(dqToday is a good day!\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کنندهٔ basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_checker\:.py>.
.SS missing\-raises\-doc / W9006
.sp
\fBپیام صادرشده:\fP
.sp
\fB\(dq%s\(dq به عنوان پرتاب‌شده مستند نشده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIلطفاً استثناها را برای تمام انواع استثناهای پرتاب‌شده مستندسازی کنید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def integer_sum(a: int, b: int):  # [missing\-raises\-doc]
    \(dq\(dq\(dqReturns sum of two integers
    :param a: first integer
    :param b: second integer
    \(dq\(dq\(dq
    if not (isinstance(a, int) and isinstance(b, int)):
        raise ValueError(\(dqFunction supports only integer parameters.\(dq)
    return a + b

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def integer_sum(a: int, b: int):
    \(dq\(dq\(dqReturns sum of two integers
    :param a: first integer
    :param b: second integer
    :raises ValueError: One of the parameters is not an integer.
    \(dq\(dq\(dq
    if not (isinstance(a, int) and isinstance(b, int)):
        raise ValueError(\(dqFunction supports only integer parameters.\(dq)
    return a + b

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins = pylint.extensions.docparams

[BASIC]
accept\-no\-raise\-doc = no

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کنندهٔ اختیاری \(aqparameter_documentation\(aq \%<#\:pylint-extensions-docparams>
صادر می‌شود، که نیازمند بارگذاری افزونهٔ \fBpylint.extensions.docparams\fP است.
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کنندهٔ parameter_documentation \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:docparams\:.py>..SS missing\-return\-doc / W9011
.sp
\fBپیام صادرشده:\fP
.sp
\fBMissing return documentation (مستندات مقدار بازگشتی وجود ندارد)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIلطفاً مستنداتی دربارهٔ آنچه این متد بازمی‌گرداند اضافه کنید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def integer_sum(a: int, b: int):  # [missing\-return\-doc]
    \(dq\(dq\(dqReturns sum of two integers
    :param a: first integer
    :param b: second integer
    \(dq\(dq\(dq
    return a + b

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def integer_sum(a: int, b: int) \-> int:
    \(dq\(dq\(dqReturns sum of two integers
    :param a: first integer
    :param b: second integer
    :return: sum of parameters a and b
    \(dq\(dq\(dq
    return a + b

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
load\-plugins=pylint.extensions.docparams

[Parameter_documentation]
accept\-no\-return\-doc=no

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
این پیام تنها زمانی صادر می‌شود که پارامتر \fBaccept\-no\-return\-doc\fP روی \fBno\fP تنظیم شده باشد\&.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کنندهٔ اختیاری \(aqparameter_documentation\(aq \%<#\:pylint-extensions-docparams>
صادر می‌شود که نیازمند بارگذاری افزونهٔ \fBpylint.extensions.docparams\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ parameter_documentation \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:docparams\:.py>\&.
.SS missing\-return\-type\-doc / W9012
.sp
\fBپیام صادرشده:\fP
.sp
\fBMissing return type documentation (مستندات نوع مقدار بازگشتی وجود ندارد)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIلطفاً نوع مقدار بازگشتی این متد را مستند کنید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def integer_sum(a: int, b: int):  # [missing\-return\-type\-doc]
    \(dq\(dq\(dqReturns sum of two integers
    :param a: first integer
    :param b: second integer
    :return: sum of parameters a and b
    \(dq\(dq\(dq
    return a + b

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def integer_sum(a: int, b: int) \-> int:
    \(dq\(dq\(dqReturns sum of two integers
    :param a: first integer
    :param b: second integer
    :return: sum of parameters a and b
    \(dq\(dq\(dq
    return a + b

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
load\-plugins=pylint.extensions.docparams

[Parameter_documentation]
accept\-no\-return\-doc=no

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
این پیام تنها زمانی صادر می‌شود که پارامتر \fBaccept\-no\-return\-doc\fP روی \fBno\fP تنظیم شده باشد\&.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کنندهٔ اختیاری \(aqparameter_documentation\(aq \%<#\:pylint-extensions-docparams>
صادر می‌شود که نیازمند بارگذاری افزونهٔ \fBpylint.extensions.docparams\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ parameter_documentation \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:docparams\:.py>\&..SS missing\-timeout / W3101
.sp
\fBپیام صادرشده:\fP
.sp
\fBنبود آرگومان timeout برای متد \(aq%s\(aq می‌تواند باعث قفل شدن نامحدود برنامه شما شود\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک متد برای جلوگیری از انتظار طولانی‌مدت به پارامتر \(aqtimeout\(aq نیاز دارد. اگر هیچ مهلت زمانی به‌طور صریح مشخص نشود، مقدار پیش‌فرض استفاده خواهد شد. به عنوان مثال برای \(aqrequests\(aq، برنامه هرگز با اتمام مهلت زمانی مواجه نمی‌شود (یعنی به‌طور نامحدود قفل می‌کند).\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import requests

requests.post(\(dqhttp://localhost\(dq)  # [missing\-timeout]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import requests

requests.post(\(dqhttp://localhost\(dq, timeout=10)

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
می‌توانید متدهای جدیدی را که باید دارای یک آرگومان تعریف‌شدهٔ \fB\(gatimeout\fP باشند، به‌صورت نام‌های واجد شرایط (qualified names) در گزینهٔ \fBtimeout\-methods\fP اضافه کنید؛ به عنوان مثال:
.INDENT 0.0
.IP \(bu 2
\fBrequests.api.get\fP
.IP \(bu 2
\fBrequests.api.head\fP
.IP \(bu 2
\fBrequests.api.options\fP
.IP \(bu 2
\fBrequests.api.patch\fP
.IP \(bu 2
\fBrequests.api.post\fP
.IP \(bu 2
\fBrequests.api.put\fP
.IP \(bu 2
\fBrequests.api.request\fP
.UNINDENT
.sp
ایجاد شده توسط بازرس method_args \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:method_args\:.py>.
.SS missing\-type\-doc / W9016
.sp
\fBپیام صادرشده:\fP
.sp
\fB\(dq%s\(dq در مستندات نوع پارامتر وجود ندارد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIلطفاً تعریف نوع پارامتر را برای همهٔ پارامترها اضافه کنید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def integer_sum(a: int, b):  # [missing\-type\-doc]
    \(dq\(dq\(dqReturns sum of two integers
    :param a: first integer
    :param b: second integer
    \(dq\(dq\(dq
    return a + b

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def integer_sum(a: int, b: int):
    \(dq\(dq\(dqReturns sum of two integers
    :param a: first integer
    :param b: second integer
    \(dq\(dq\(dq
    return a + b

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins = pylint.extensions.docparams

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بازرس اختیاری \(aqparameter_documentation\(aq \%<#\:pylint-extensions-docparams> صادر می‌شود که به بارگذاری افزونهٔ \fBpylint.extensions.docparams\fP نیاز دارد.
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بازرس parameter_documentation \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:docparams\:.py>..SS missing\-yield\-doc / W9013
.sp
\fBپیام صادرشده:\fP
.sp
\fBمستندات yield وجود ندارد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIلطفاً مستنداتی درباره آنچه این مولد (generator) با yield تولید می‌کند اضافه کنید.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def even_number_under(n: int):  # [missing\-yield\-doc]
    \(dq\(dq\(dqPrints even numbers smaller than n.
    Args:
        n: Upper limit of even numbers.
    \(dq\(dq\(dq
    for i in range(n):
        if i % 2 == 1:
            continue
        yield i

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد اصلاح‌شده:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import Iterator


def even_number_under(n: int) \-> Iterator[int]:
    \(dq\(dq\(dqPrints even numbers smaller than n.
    Args:
        n: Upper limit of even numbers.

    Yields:
        even numbers
    \(dq\(dq\(dq
    for i in range(n):
        if i % 2 == 1:
            continue
        yield i

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
load\-plugins=pylint.extensions.docparams

[Parameter_documentation]
accept\-no\-yields\-doc=no

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
این پیام تنها زمانی ایجاد می‌شود که پارامتر \fBaccept\-no\-yields\-doc\fP روی \fBno\fP تنظیم شده باشد\&.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqparameter_documentation\(aq \%<#\:pylint-extensions-docparams> صادر می‌شود که مستلزم بارگذاری افزونه \fBpylint.extensions.docparams\fP است.
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده parameter_documentation \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:docparams\:.py>\&..SS missing\-yield\-type\-doc / W9014
.sp
\fBپیام صادرشده:\fP
.sp
\fBمستندات نوع yield موجود نیست (Missing yield type documentation)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIلطفاً نوع بازگردانده‌شده توسط این متد با yield را مستندسازی کنید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def even_number_under(n: int):  # [missing\-yield\-type\-doc]
    \(dq\(dq\(dqPrints even numbers smaller than n.
    Args:
        n: Upper limit of even numbers.

    Yields:
        even numbers
    \(dq\(dq\(dq
    for i in range(n):
        if i % 2 == 1:
            continue
        yield i

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import Iterator


def even_number_under(n: int) \-> Iterator[int]:
    \(dq\(dq\(dqPrints even numbers smaller than n.
    Args:
        n: Upper limit of even numbers.

    Yields:
        even numbers
    \(dq\(dq\(dq
    for i in range(n):
        if i % 2 == 1:
            continue
        yield i

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
load\-plugins=pylint.extensions.docparams

[Parameter_documentation]
accept\-no\-yields\-doc=no

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
این پیام تنها زمانی صادر می‌شود که پارامتر \fBaccept\-no\-yields\-doc\fP بر روی \fBno\fP تنظیم شده باشد\&.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqparameter_documentation\(aq \%<#\:pylint-extensions-docparams> صادر می‌شود، که نیازمند بارگذاری افزونه \fBpylint.extensions.docparams\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده parameter_documentation \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:docparams\:.py>\&..SS modified\-iterating\-list / W4701
.sp
\fBپیام صادرشده:\fP
.sp
\fBلیست در حال پیمایش \(aq%s\(aq درون بدنه حلقه for در حال تغییر است، در عوض پیمایش روی یک کپی از آن را در نظر بگیرید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که مواردی به لیستی که در حال پیمایش است افزوده یا از آن حذف شوند. انجام این کار می‌تواند منجر به رفتاری غیرمنتظره شود، به همین دلیل ترجیح داده می‌شود که از یک کپی از لیست استفاده شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruits = [\(dqapple\(dq, \(dqorange\(dq, \(dqmango\(dq]
for fruit in fruits:
    fruits.append(\(dqpineapple\(dq)  # [modified\-iterating\-list]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruits = [\(dqapple\(dq, \(dqorange\(dq, \(dqmango\(dq]
for fruit in fruits.copy():
    fruits.append(\(dqpineapple\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده modified_iteration \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:modified_iterating_checker\:.py>.
.SS multiple\-constructor\-doc / W9005
.sp
\fBپیام صادرشده:\fP
.sp
\fB\(dq%s\(dq پارامترهای سازنده را در کلاس و __init__ مستند کرده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIلطفاً اعلان‌های پارامتر را در کلاس یا سازنده حذف کنید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Point:  # [multiple\-constructor\-doc]
    \(dq\(dq\(dqRepresents a point in the xy\-coordinate plane.

    :param x: coordinate
    :param y: coordinate
    \(dq\(dq\(dq

    def __init__(self, x, y):
        \(dq\(dq\(dqRepresents a point in the xy\-coordinate plane.

        :param x: coordinate
        :param y: coordinate
        \(dq\(dq\(dq
        self.x = x
        self.y = y

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Point:
    def __init__(self, x, y):
        \(dq\(dq\(dqRepresents a point in the xy\-coordinate plane.

        :param x: x coordinate
        :param y: y coordinate
        \(dq\(dq\(dq
        self.x = x
        self.y = y

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
load\-plugins=pylint.extensions.docparams

[Parameter_documentation]
no\-docstring\-rgx=^(?!__init__$)_

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
هر دو docstring قابل قبول هستند اما نه هر دو به‌طور هم‌زمان.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqparameter_documentation\(aq \%<#\:pylint-extensions-docparams>
صادر می‌شود، که نیازمند بارگذاری افزونه \fBpylint.extensions.docparams\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده parameter_documentation \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:docparams\:.py>..SS named\-expr\-without\-context / W0131
.sp
\fBپیام صادرشده:\fP
.sp
\fBعبارت نام‌گذاری‌شده بدون زمینه به کار رفته است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که یک عبارت نام‌گذاری‌شده برای انجام انتساب عادی، بیرون از زمینه‌هایی مانند if، for، while یا یک comprehension به کار رود.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
(a := 42)  # [named\-expr\-without\-context]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
if a := 42:
    print(\(dqSuccess\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_checker\:.py>.
.SS nan\-comparison / W0177
.sp
\fBپیام صادرشده:\fP
.sp
\fBمقایسه %s باید %s باشد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک عبارت با مقادیر NaN مانند numpy.NaN و float(\(aqnan\(aq) مقایسه شود.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import numpy as np


def both_nan(x, y) \-> bool:
    return x == np.NaN and y == float(\(dqnan\(dq)  # [nan\-comparison, nan\-comparison]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import numpy as np


def both_nan(x, y) \-> bool:
    return np.isnan(x) and np.isnan(y)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:comparison_checker\:.py>.
.SS nested\-min\-max / W3301
.sp
\fBپیام صادرشده:\fP
.sp
\fBاز فراخوانی تو در توی \(aq%s\(aq استفاده نکنید؛ امکان استفاده از \(aq%s\(aq به‌جای آن وجود دارد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIفراخوانی‌های تو در تو مانند \(ga\(gamin(1, min(2, 3))\(ga\(ga را می‌توان به‌صورت \(ga\(gamin(1, 2, 3)\(ga\(ga بازنویسی کرد.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(min(1, min(2, 3)))  # [nested\-min\-max]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(min(1, 2, 3))

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده nested_min_max \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:nested_min_max\:.py>..SS non\-ascii\-file\-name / W2402
.sp
\fBپیام صادرشده:\fP
.sp
\fBنام %s \(dq%s\(dq شامل یک نویسه غیر ASCII است.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIدر نسخه‌های پیش از Python 3.5، استاندارد PEP 3131 شناسه‌های غیر ASCII را مجاز می‌دانست، اما نام‌های فایل غیر ASCII را خیر. از Python 3.5 به بعد، با وجود اینکه Python از فایل‌های UTF\-8 پشتیبانی می‌کند، برخی از ویرایشگرها یا ابزارها از آن پشتیبانی نمی‌کنند.\fP
.sp
\fBکد دارای مشکل:\fP
.sp
\fBbàd.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# [non\-ascii\-file\-name]

.EE
.UNINDENT
.UNINDENT
.sp
\fBnot_bétter.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# [non\-ascii\-file\-name]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.sp
\fB__init__.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX

.EE
.UNINDENT
.UNINDENT
.sp
\fBbad.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX

.EE
.UNINDENT
.UNINDENT
.sp
\fBnot_better.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
PEP 489 \%<https://\:peps\:.python\:.org/\:pep-0489/#\:export-hook-name>
.IP \(bu 2
PEP 672 \%<https://\:peps\:.python\:.org/\:pep-0672/#\:confusing-features>
.IP \(bu 2
گزارش مشکل ۲۰۴۸۵ در Python \%<https://\:bugs\:.python\:.org/\:issue20485>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ nonascii\-checker \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:non_ascii_names\:.py>.
.SS non\-parent\-init\-called / W0233
.sp
\fBپیام صادرشده:\fP
.sp
\fBمتد __init__ از یک کلاس پایه غیرمستقیم %r فراخوانی شده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک متد __init__ روی کلاسی فراخوانی شود که در میان نیاکان مستقیم کلاس تحلیل‌شده قرار ندارد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Animal:
    def __init__(self):
        self.is_multicellular = True


class Vertebrate(Animal):
    def __init__(self):
        super().__init__()
        self.has_vertebrae = True


class Cat(Vertebrate):
    def __init__(self):
        Animal.__init__(self)  # [non\-parent\-init\-called]
        self.is_adorable = True

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Animal:
    def __init__(self):
        self.is_multicellular = True


class Vertebrate(Animal):
    def __init__(self):
        super().__init__()
        self.has_vertebrae = True


class Cat(Vertebrate):
    def __init__(self):
        super().__init__()
        self.is_adorable = True

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>..SS non\-str\-assignment\-to\-dunder\-name / W1115
.sp
\fBپیام صادرشده:\fP
.sp
\fBمقدار غیررشته‌ای به __name__ انتساب داده شده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی صادر می‌شود که یک مقدار غیررشته‌ای به __name__ اختصاص یابد\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    pass


Fruit.__name__ = 1  # [non\-str\-assignment\-to\-dunder\-name]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    pass


Fruit.__name__ = \(dqFRUIT\(dq

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>.
.SS overlapping\-except / W0714
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستثناهای دارای هم‌پوشانی (%s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که استثناها در مدیریت‌کننده (handler) هم‌پوشانی داشته یا یکسان باشند\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def divide_x_by_y(x: float, y: float):
    try:
        print(x / y)
    except (ArithmeticError, FloatingPointError) as e:  # [overlapping\-except]
        print(f\(dqThere was an issue: {e}\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.sp
\fBless_generic_first.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def divide_x_by_y(x: float, y: float):
    try:
        print(x / y)
    except FloatingPointError as e:
        print(f\(dqThere was a FloatingPointError: {e}\(dq)
    except ArithmeticError as e:
        # FloatingPointError  were already caught at this point
        print(f\(dqThere was an OverflowError or a ZeroDivisionError: {e}\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBonly_generic.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def divide_x_by_y(x: float, y: float):
    try:
        print(x / y)
    except ArithmeticError as e:
        print(
            f\(dqThere was an OverflowError, a ZeroDivisionError or a FloatingPointError: {e}\(dq
        )

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins=pylint.extensions.overlapping_exceptions,

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
سلسله‌مراتب استثناها \%<https://\:docs\:.python\:.org/\:3/\:library/\:exceptions\:.html#\:exception-hierarchy>
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqoverlap\-except\(aq \%<#\:pylint-extensions-overlapping-exceptions>
صادر می‌شود که نیازمند بارگذاری افزونه \fBpylint.extensions.overlapping_exceptions\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده overlap\-except \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:overlapping_exceptions\:.py>..SS overridden\-final\-method / W0239
.sp
\fBپیام صادرشده:\fP
.sp
\fBمتد %r متدی را که با typing.final تزیین شده و در کلاس %r تعریف شده است، بازنویسی می‌کند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک متد تزیین‌شده با typing.final بازنویسی شده باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import final


class Animal:
    @final
    def can_breathe(self):
        return True


class Cat(Animal):
    def can_breathe(self):  # [overridden\-final\-method]
        pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import final


class Animal:
    @final
    def can_breathe(self):
        return True


class Cat(Animal):
    def can_purr(self):
        return True

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
py\-version=3.8

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
این پیام هنگام استفاده از Python < 3.8 صادر نمی‌شود.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
PEP 591 \%<https://\:peps\:.python\:.org/\:pep-0591>
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کنندهٔ classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>.
.SS pointless\-exception\-statement / W0133
.sp
\fBپیام صادرشده:\fP
.sp
\fBدستور استثنا هیچ اثری ندارد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک استثنا ایجاد شده باشد بدون آنکه انتساب یابد، صادر (raise) شود یا برای استفاده‌های بعدی در جای دیگری بازگردانده شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
Exception(\(dqThis exception is a statement.\(dq)  # [pointless\-exception\-statement]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
raise Exception(\(dqThis will raise.\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کنندهٔ basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_checker\:.py>..SS pointless\-statement / W0104
.sp
\fBپیام صادرشده:\fP
.sp
\fBبه‌نظر می‌رسد دستور هیچ تأثیری ندارد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک دستور هیچ تأثیری نداشته باشد (یا دست‌کم این‌طور به‌نظر برسد).\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[1, 2, 3]  # [pointless\-statement]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
NUMBERS = [1, 2, 3]

print(NUMBERS)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_checker\:.py>.
.SS pointless\-string\-statement / W0105
.sp
\fBپیام صادرشده:\fP
.sp
\fBدستور رشته‌ای هیچ تأثیری ندارد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک رشته به‌عنوان یک دستور استفاده شود (که البته هیچ تأثیری ندارد). این یک حالت خاص از W0104 با پیام مختص به خود است تا اگر از این رشته‌ها به‌جای کامنت‌ها برای مستندسازی استفاده می‌کنید، بتوانید به‌سادگی آن را غیرفعال کنید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dq\(dq\(dqThis is a docstring which describes the module\(dq\(dq\(dq

\(dq\(dq\(dqThis is not a docstring\(dq\(dq\(dq  # [pointless\-string\-statement]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dq\(dq\(dqThis is a docstring which describes the module\(dq\(dq\(dq

# This is comment which describes a particular part of the module.

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
رشته‌گفتگوی مربوط به docstringها روی انتساب‌ها \%<https://\:discuss\:.python\:.org/\:t/\:docstrings-for-new-type-aliases-as-defined-in-pep-695/\:39816>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_checker\:.py>.
.SS possibly\-unused\-variable / W0641
.sp
\fBپیام صادرشده:\fP
.sp
\fBاحتمالاً متغیر %r استفاده نشده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک متغیر تعریف شده باشد اما ممکن است استفاده نشود. این احتمال از این واقعیت ناشی می‌شود که ممکن است locals() استفاده شده باشد، که می‌تواند متغیر مذکور را مصرف کند یا نکند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def choose_fruits(fruits):
    print(fruits)
    color = \(dqred\(dq  # [possibly\-unused\-variable]
    return locals()

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def choose_fruits(fruits):
    current_locals = locals()
    print(fruits)
    color = \(dqred\(dq
    print(color)
    return current_locals

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>..SS preferred\-module / W0407
.sp
\fBپیام صادرشده:\fP
.sp
\fBوارد کردن %r به جای %r ترجیح داده می‌شود\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک ماژول واردشده، ماژول جایگزین ترجیحی داشته باشد.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import urllib  # [preferred\-module]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import requests

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[IMPORTS]
preferred\-modules=urllib:requests,

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده imports \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:imports\:.py>.
.SS protected\-access / W0212
.sp
\fBپیام صادرشده:\fP
.sp
\fBدسترسی به عضو محافظت‌شده %s از یک کلاس کلاینت\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که به یک عضو محافظت‌شده (یعنی عضوی از کلاس با نامی که با یک زیرخط آغاز می‌شود) در خارج از کلاس یا نوادگان کلاسی که در آن تعریف شده است، دسترسی پیدا شود.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Worm:
    def __swallow(self):
        pass


jim = Worm()
jim.__swallow()  # [protected\-access]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Worm:
    def __swallow(self):
        pass

    def eat(self):
        return self.__swallow()


jim = Worm()
jim.eat()

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>..SS raise\-missing\-from / W0707
.sp
\fBپیام صادرشده:\fP
.sp
\fBطرح مجدد صریح با استفاده از %s\(aq%s from %s\(aq را مد نظر قرار دهید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزنجیره‌سازی استثناها در پایتون، هم گزارش ردیابی (traceback) استثنای فعلی و هم استثنای اصلی را نشان می‌دهد. هنگامی که پس از گرفتن یک استثنا، استثنای جدیدی را raise می‌کنید، احتمال دارد استثنای دوم یک بسته‌بندی مجددِ کاربرپسند از استثنای نخست باشد. در چنین مواردی، \(garaise from\(ga پیوند بهتری میان دو traceback در خطای نهایی ایجاد می‌کند.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
try:
    1 / 0
except ZeroDivisionError as e:
    raise ValueError(\(dqRectangle Area cannot be zero\(dq)  # [raise\-missing\-from]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
try:
    1 / 0
except ZeroDivisionError as e:
    raise ValueError(\(dqRectangle Area cannot be zero\(dq) from e

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
PEP 3134 \%<https://\:peps\:.python\:.org/\:pep-3134>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده exceptions \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:exceptions\:.py>.
.SS raising\-format\-tuple / W0715
.sp
\fBپیام صادرشده:\fP
.sp
\fBآرگومان‌های استثنا نشان می‌دهند که احتمالاً قالب‌بندی رشته مد نظر بوده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که چندین آرگومان به سازندهٔ یک استثنا ارسال شود و اولین آرگومان، یک لیترال رشته‌ای حاوی مواردی باشد که به نظر می‌رسد جای‌نگه‌دارهایی برای قالب‌بندی باشند\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
raise RuntimeError(\(dqThis looks wrong %s %s\(dq, (\(dqa\(dq, \(dqb\(dq))  # [raising\-format\-tuple]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
raise RuntimeError(\(dqThis looks wrong %s %s\(dq % (\(dqa\(dq, \(dqb\(dq))

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده exceptions \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:exceptions\:.py>.
.SS redeclared\-assigned\-name / W0128
.sp
\fBپیام صادرشده:\fP
.sp
\fBاعلان مجدد متغیر %r در انتساب\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که تشخیص داده شود یک متغیر در همان انتساب دوباره اعلان شده است.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
FIRST, FIRST = (1, 2)  # [redeclared\-assigned\-name]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
FIRST, SECOND = (1, 2)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_checker\:.py>..SS redefined\-builtin / W0622
.sp
\fBپیام صادرشده:\fP
.sp
\fBبازتعریف شناسهٔ توکار %r\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک متغیر یا تابع، یک شناسهٔ توکار را بازنویسی کند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def map():  # [redefined\-builtin]
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def map_iterable():
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
گزینهٔ allowed\-redefined\-builtins \%<#\:variables-options> به شما امکان می‌دهد نام‌هایی را مشخص کنید که مجاز به پوشاندن شناسه‌های توکار هستند.
.sp
با این حال، این گزینه برای بازتعریف‌ها در سطح ماژول یا متغیرهای سراسری مؤثر نیست. برای مثال:
.sp
بازتعریف‌ها در سطح ماژول:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# module_level_redefine.py
id = 1  # Shadows the built\-in \(gaid\(ga
.EE
.UNINDENT
.UNINDENT
.sp
بازتعریف‌های متغیرهای سراسری:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# global_variable_redefine.py
def my_func():
    global len
    len = 1  # Shadows the built\-in \(galen\(ga
.EE
.UNINDENT
.UNINDENT
.sp
دلیل:
.sp
پوشاندن شناسه‌های توکار در حوزهٔ سراسری توصیه نمی‌شود، زیرا رفتار آن‌ها را در سراسر ماژول مبهم می‌سازد و خطر بروز باگ‌های ظریف را هنگامی که در جای دیگری از ماژول به آن شناسه نیاز باشد، افزایش می‌دهد.
در مقابل، بازتعریف‌های محلی قابل‌قبول هستند چرا که تأثیر آن‌ها به یک حوزهٔ مشخص محدود می‌شود، عوارض جانبی ناخواسته را کاهش می‌دهد و اشکال‌زدایی را ساده‌تر می‌کند.
.sp
ایجادشده توسط بررسی‌کنندهٔ variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>.
.SS redefined\-loop\-name / W2901
.sp
\fBپیام صادرشده:\fP
.sp
\fBبازتعریف %r از حلقه (خط %s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که متغیر حلقه در بدنهٔ حلقه بازنویسی شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def normalize_names(names):
    for name in names:
        name = name.lower()  # [redefined\-loop\-name]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def normalize_names(names):
    for name in names:
        lowercased_name = name.lower()

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins=pylint.extensions.redefined_loop_name,

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کنندهٔ اختیاری \(aqredefined\-loop\-name\(aq \%<#\:pylint-extensions-redefined-loop-name> صادر می‌شود که نیازمند بارگذاری افزونهٔ \fBpylint.extensions.redefined_loop_name\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ redefined\-loop\-name \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:redefined_loop_name\:.py>..SS redefined\-outer\-name / W0621
.sp
\fBپیام صادرشده:\fP
.sp
\fBبازتعریف نام %r از دامنه بیرونی (خط %s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که نام یک متغیر، نام تعریف‌شده در یک دامنه بیرونی یا گرداننده استثنا (except handler) را بپوشاند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
count = 10


def count_it(count):  # [redefined\-outer\-name]
    for i in range(count):
        print(i)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
count = 10


def count_it(limit):
    for i in range(limit):
        print(i)

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
یک مشکل رایج این است که این پیام هنگام استفاده از فیکسچرهای \fIpytest\fP فعال می‌شود \%<https://\:docs\:.pytest\:.org/\:en/\:7\:.1\:.x/\:how-to/\:fixtures\:.html>:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import pytest

@pytest.fixture
def setup():
    ...


def test_something(setup):  # [redefined\-outer\-name]
    ...
.EE
.UNINDENT
.UNINDENT
.sp
یک راه‌حل برای این مشکل، نام‌گذاری صریح فیکسچر است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
@pytest.fixture(name=\(dqsetup\(dq)
def setup_fixture():
    ...
.EE
.UNINDENT
.UNINDENT
.sp
به عنوان روش دیگر، می‌توان از افزونه‌های \fIpylint\fP مانند pylint\-pytest \%<https://\:pypi\:.org/\:project/\:pylint-pytest> استفاده کرد.
.sp
ایجاد شده توسط بررسی‌کننده variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>.
.SS redefined\-slots\-in\-subclass / W0244
.sp
\fBپیام صادرشده:\fP
.sp
\fBبازتعریف اسلات‌های %r در زیرکلاس\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک slot در یک زیرکلاس دوباره تعریف شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Base:
    __slots__ = (\(dqa\(dq, \(dqb\(dq)


class Subclass(Base):
    __slots__ = (\(dqa\(dq, \(dqd\(dq)  # [redefined\-slots\-in\-subclass]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Base:
    __slots__ = (\(dqa\(dq, \(dqb\(dq)


class Subclass(Base):
    __slots__ = (\(dqd\(dq,)

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>..SS redundant\-returns\-doc / W9008
.sp
\fBپیام صادرشده:\fP
.sp
\fBمستندات بازگشت مازاد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIلطفاً مستندات return/rtype را از این متد حذف کنید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def print_fruits(fruits):  # [redundant\-returns\-doc]
    \(dq\(dq\(dqPrint list of fruits

    Returns
    \-\-\-\-\-\-\-
        str
    \(dq\(dq\(dq
    print(fruits)
    return None

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def print_fruits(fruits):
    \(dq\(dq\(dqPrint list of fruits

    Returns
    \-\-\-\-\-\-\-
        str
    \(dq\(dq\(dq
    print(fruits)
    return \(dq,\(dq.join(fruits)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins = pylint.extensions.docparams

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqparameter_documentation\(aq \%<#\:pylint-extensions-docparams> صادر می‌شود که نیازمند بارگذاری افزونه \fBpylint.extensions.docparams\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده parameter_documentation \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:docparams\:.py>.
.SS redundant\-u\-string\-prefix / W1406
.sp
\fBپیام صادرشده:\fP
.sp
\fBپیشوند u برای رشته‌ها در Python >=3.0 دیگر ضروری نیست\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که رشته‌ای با پیشوند u شناسایی شود. این پیشوندها در Python 2 برای مشخص کردن اینکه یک رشته Unicode است لازم بودند، اما از Python 3.0 به بعد رشته‌ها به صورت پیش‌فرض Unicode هستند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def print_fruit():
    print(u\(dqApple\(dq)  # [redundant\-u\-string\-prefix]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def print_fruit():
    print(\(dqApple\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>..SS redundant\-unittest\-assert / W1503
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفادهٔ زائد از %s با مقدار ثابت %r\fP
.sp
\fBتوضیحات:\fP
.sp
\fIنخستین آرگومان assertTrue و assertFalse یک شرط است. اگر یک مقدار ثابت به عنوان پارامتر ارسال شود، آن شرط همواره درست خواهد بود. در این حالت باید یک هشدار صادر شود.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import unittest


class DummyTestCase(unittest.TestCase):
    def test_dummy(self):
        self.assertTrue(\(dqfoo\(dq)  # [redundant\-unittest\-assert]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import unittest


class DummyTestCase(unittest.TestCase):
    def test_dummy(self):
        actual = \(dqtest_result\(dq
        self.assertEqual(actual, \(dqexpected\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
اعتبارسنجی مستقیم یک رشتهٔ لفظی (string literal) همواره با موفقیت همراه خواهد بود. راه‌حل این است که چیزی را که امکان شکست در آن وجود دارد آزمایش کنید، یا اصلاً هیچ اعتبارسنجی‌ای انجام ندهید.
.sp
برای اعتبارسنجی‌ها با استفاده از \fBassert\fP، پیام‌های مشابهی وجود دارند: assert\-on\-string\-literal / W0129 \%<#\:assert-on-string-literal> و assert\-on\-tuple / W0199 \%<#\:assert-on-tuple>\&.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
آزمون‌های بدون اعتبارسنجی \%<https://\:stackoverflow\:.com/\:a/\:137418/\:2519059>
.IP \(bu 2
آزمودن این‌که هیچ خطایی رخ نمی‌دهد \%<https://\:stackoverflow\:.com/\:questions/\:20274987>
.IP \(bu 2
پارامتری‌سازی برانگیختن شرطی خطا \%<https://\:docs\:.pytest\:.org/\:en/\:latest/\:example/\:parametrize\:.html#\:parametrizing-conditional-raising>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ stdlib \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:stdlib\:.py>\&.
.SS redundant\-yields\-doc / W9010
.sp
\fBپیام صادرشده:\fP
.sp
\fBمستندسازی زائد yields\fP
.sp
\fBتوضیحات:\fP
.sp
\fIلطفاً مستندسازی yields را از این متد حذف کنید.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def give_fruits(fruits):  # [redundant\-yields\-doc]
    \(dq\(dq\(dqSomething about fruits

    Yields
    \-\-\-\-\-\-\-
        list
            fruits
    \(dq\(dq\(dq
    return fruits

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def give_fruits(fruits):
    \(dq\(dq\(dqSomething about fruits

    Yields
    \-\-\-\-\-\-\-
        str
            fruit
    \(dq\(dq\(dq
    for fruit in fruits:
        yield fruit

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins = pylint.extensions.docparams

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کنندهٔ اختیاری \(aqparameter_documentation\(aq \%<#\:pylint-extensions-docparams> صادر می‌شود که نیازمند بارگذاری افزونهٔ \fBpylint.extensions.docparams\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ parameter_documentation \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:docparams\:.py>\&..SS reimported / W0404
.sp
\fBپیام صادرشده:\fP
.sp
\fBوارد کردن مجدد %r (واردشده در خط %s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک ماژول بیش از یک بار وارد شده باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import re
import re  # [reimported]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import re

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ imports \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:imports\:.py>.
.SS return\-in\-finally / W0134
.sp
\fBپیام صادرشده:\fP
.sp
\fB\(aqreturn\(aq توسط بند \(aqfinally\(aq تحت‌الشعاع قرار گرفته است.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی صادر می‌شود که یک دستور \(aqreturn\(aq در یک بلوک \(aqfinally\(aq یافت شود. این کار مقدار بازگشتی تابع را رونویسی خواهد کرد و باید از آن خودداری شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def second_favorite():
    fruits = [\(dqkiwi\(dq, \(dqpineapple\(dq]
    try:
        return fruits[1]
    finally:
        # because of this \(gareturn\(ga statement, this function will always return \(dqkiwi\(dq
        return fruits[0]  # [return\-in\-finally]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def second_favorite():
    fruits = [\(dqkiwi\(dq, \(dqpineapple\(dq]
    try:
        return fruits[1]
    except KeyError:
        ...

    return fruits[0]

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
مستندات Python 3، بند \(aqfinally\(aq \%<https://\:docs\:.python\:.org/\:3/\:reference/\:compound_stmts\:.html#\:finally-clause>
.IP \(bu 2
PEP 765 \- Disallow return/break/continue that exit a finally block \%<https://\:peps\:.python\:.org/\:pep-0765>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_checker\:.py>..SS self\-assigning\-variable / W0127
.sp
\fBپیام صادرشده:\fP
.sp
\fBانتساب متغیر یکسان %r به خودش\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که تشخیص داده شود یک متغیر به خودش منتسب شده است\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
year = 2000
year = year  # [self\-assigning\-variable]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
year = 2000

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
دستور انتساب در پایتون \%<https://\:docs\:.python\:.org/\:3/\:reference/\:simple_stmts\:.html#\:assignment-statements>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_checker\:.py>.
.SS self\-cls\-assignment / W0642
.sp
\fBپیام صادرشده:\fP
.sp
\fBانتساب نامعتبر به %s در متد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIانتساب نامعتبر به self یا cls به ترتیب در متد نمونه یا متد کلاس.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    @classmethod
    def list_fruits(cls):
        cls = \(dqapple\(dq  # [self\-cls\-assignment]

    def print_color(self, *colors):
        self = \(dqred\(dq  # [self\-cls\-assignment]
        color = colors[1]
        print(color)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    @classmethod
    def list_fruits(cls):
        fruit = \(dqapple\(dq
        print(fruit)

    def print_color(self, *colors):
        color = colors[1]
        print(color)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>..SS shadowed\-import / W0416
.sp
\fBپیام صادرشده:\fP
.sp
\fBپوشانده‌شدن %r (واردشده در خط %s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که برای یک ماژول نام مستعاری تعیین شود که یک import دیگر را می‌پوشاند.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from pathlib import Path

import FastAPI.Path as Path  # [shadowed\-import]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from pathlib import Path

import FastAPI.Path as FastApiPath

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ imports \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:imports\:.py>.
.SS shallow\-copy\-environ / W1507
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از copy.copy(os.environ). به‌جای آن از os.environ.copy() استفاده کنید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIمتغیر os.environ یک شیء dict نیست بلکه یک شیء پروکسی است، بنابراین کپی سطحی (shallow copy) همچنان بر شیء اصلی اثر می‌گذارد. برای مرجع، https://bugs.python.org/issue15373 را ببینید.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import copy
import os

copied_env = copy.copy(os.environ)  # [shallow\-copy\-environ]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import os

copied_env = os.environ.copy()

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ stdlib \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:stdlib\:.py>.
.SS signature\-differs / W0222
.sp
\fBپیام صادرشده:\fP
.sp
\fBامضا با متد %s %r متفاوت است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که امضای یک متد با امضای موجود در رابط پیاده‌سازی‌شده یا متد بازنویسی‌شده متفاوت باشد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Animal:
    def run(self, distance=0):
        print(f\(dqRan {distance} km!\(dq)


class Dog(Animal):
    def run(self, distance):  # [signature\-differs]
        super(Animal, self).run(distance)
        print(\(dqFetched that stick, wuff !\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Animal:
    def run(self, distance=0):
        print(f\(dqRan {distance} km!\(dq)


class Dog(Animal):
    def run(self, distance=0):
        super(Animal, self).run(distance)
        print(\(dqFetched that stick, wuff !\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>..SS subclassed\-final\-class / W0240
.sp
\fBپیام صادرشده:\fP
.sp
\fBکلاس %r زیرکلاسی از یک کلاس تزیین‌شده با typing.final است: %r\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که کلاسی با دکوراتور typing.final زیرکلاس‌بندی (ارث‌بری) شده باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import final


@final
class PlatypusData:
    \(dq\(dq\(dqGeneral Platypus data.\(dq\(dq\(dq

    average_length = 46
    average_body_temperature = 32


class FluorescentPlaytipus(PlatypusData):  # [subclassed\-final\-class]
    \(dq\(dq\(dqPlaytipus with fluorescent fur.\(dq\(dq\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import final


@final
class PlatypusData:
    \(dq\(dq\(dqGeneral Platypus data.\(dq\(dq\(dq

    average_length = 46
    average_body_temperature = 32


def print_average_length_platypus():
    output = f\(dqThe average length of a platypus is: {PlatypusData.average_length}cm\(dq
    print(output)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
py\-version=3.8

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
این پیام زمانی صادر می‌شود که از کلاسی تزیین‌شده با \fIfinal\fP زیرکلاس ایجاد شود؛ این دکوراتور نشان می‌دهد که کلاس نباید ارث‌بری یا گسترش داده شود.
.sp
توجه داشته باشید که این پیام هنگام استفاده از Python < 3.8 صادر نمی‌شود.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
PEP 591 \%<https://\:peps\:.python\:.org/\:pep-0591/#\:the-final-decorator>
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>..SS subprocess\-popen\-preexec\-fn / W1509
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از کلیدواژه preexec_fn که ممکن است در حضور threadها ناامن باشد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاستفاده از پارامتر preexec_fn در صورت وجود threadها در برنامه شما ایمن نیست. فرآیند فرزند (child process) ممکن است پیش از فراخوانی exec دچار بن‌بست (deadlock) شود. اگر مجبور به استفاده از آن هستید، آن را بسیار ساده نگه دارید! تعداد کتابخانه‌هایی را که فراخوانی می‌کنید به حداقل برسانید. ببینید: https://docs.python.org/3/library/subprocess.html#popen\-constructor\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import subprocess


def foo():
    pass


subprocess.Popen(preexec_fn=foo)  # [subprocess\-popen\-preexec\-fn]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import subprocess

subprocess.Popen()

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده stdlib \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:stdlib\:.py>.
.SS subprocess\-run\-check / W1510
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از \(aqsubprocess.run\(aq بدون تعیین صریح مقدار برای \(aqcheck\(aq.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIکلیدواژه \(ga\(gacheck\(ga\(ga به‌طور پیش‌فرض روی False تنظیم شده است. این بدان معناست که فرآیند راه‌اندازی‌شده توسط \(ga\(gasubprocess.run\(ga\(ga می‌تواند با یک کد خروج غیرصفر خارج شده و بدون هشدار شکست بخورد. بهتر است آن را به‌طور صریح مقداردهی کنید تا رفتار مدیریت خطا کاملاً مشخص باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import subprocess

proc = subprocess.run([\(dqls\(dq])  # [subprocess\-run\-check]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import subprocess

proc = subprocess.run([\(dqls\(dq], check=False)

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
مستندات subprocess.run \%<https://\:docs\:.python\:.org/\:3/\:library/\:subprocess\:.html#\:subprocess\:.run>
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده stdlib \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:stdlib\:.py>..SS super\-init\-not\-called / W0231
.sp
\fBپیام صادرشده:\fP
.sp
\fBمتد __init__ از کلاس پایه %r فراخوانی نشده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که کلاس والد متد __init__ داشته باشد که توسط کلاس مشتق‌شده فراخوانی نشده است.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    def __init__(self, name=\(dqfruit\(dq):
        self.name = name
        print(\(dqCreating a {self.name}\(dq)


class Apple(Fruit):
    def __init__(self):  # [super\-init\-not\-called]
        print(\(dqCreating an apple\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    def __init__(self, name=\(dqfruit\(dq):
        self.name = name
        print(\(dqCreating a {self.name}\(dq)


class Apple(Fruit):
    def __init__(self):
        super().__init__(\(dqapple\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>.
.SS super\-without\-brackets / W0245
.sp
\fBپیام صادرشده:\fP
.sp
\fBفراخوانی super بدون پرانتز\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که فراخوانی super بدون پرانتز باشد و در نتیجه یک فراخوانی واقعی نبوده و آن‌طور که انتظار می‌رود عمل نکند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Soup:
    @staticmethod
    def temp():
        print(\(dqSoup is hot!\(dq)


class TomatoSoup(Soup):
    @staticmethod
    def temp():
        super.temp()  # [super\-without\-brackets]
        print(\(dqBut tomato soup is even hotter!\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Soup:
    @staticmethod
    def temp():
        print(\(dqSoup is hot!\(dq)


class TomatoSoup(Soup):
    @staticmethod
    def temp():
        super().temp()
        print(\(dqBut tomato soup is even hotter!\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>..SS too\-many\-try\-statements / W0717
.sp
\fBپیام صادرشده:\fP
.sp
\fB%s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIبند try حاوی دستورهای بیش از حد است.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
FRUITS = {\(dqapple\(dq: 1, \(dqorange\(dq: 10}


def pick_fruit(name):
    try:  # [too\-many\-try\-statements]
        count = FRUITS[name]
        count += 1
        print(f\(dqGot fruit count {count}\(dq)
    except KeyError:
        return

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
FRUITS = {\(dqapple\(dq: 1, \(dqorange\(dq: 10}


def pick_fruit(name):
    try:
        count = FRUITS[name]
    except KeyError:
        return

    count += 1
    print(f\(dqGot fruit count {count}\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins=pylint.extensions.broad_try_clause,

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqbroad_try_clause\(aq \%<#\:pylint-extensions-broad-try-clause> صادر می‌شود که نیازمند بارگذاری افزونه \fBpylint.extensions.broad_try_clause\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده broad_try_clause \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:broad_try_clause\:.py>.
.SS try\-except\-raise / W0706
.sp
\fBپیام صادرشده:\fP
.sp
\fBگرداننده except بلافاصله raise می‌کند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک گرداننده except از raise به عنوان نخستین یا تنها عملگر خود استفاده کند. این کار بیهوده است زیرا بلافاصله استثنا را دوباره raise می‌کند. عملگر raise یا کل بلوک try\-except\-raise را حذف کنید!\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
try:
    1 / 0
except ZeroDivisionError as e:  # [try\-except\-raise]
    raise

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.sp
\fBremove_try_except.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# The try except might be removed entirely:
1 / 0

.EE
.UNINDENT
.UNINDENT
.sp
\fBspecialized_exception.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# Another more detailed exception can be raised:
try:
    1 / 0
except ZeroDivisionError as e:
    raise ValueError(\(dqThe area of the rectangle cannot be zero\(dq) from e

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
یک مورد کاربرد معتبر برای raise مجدد و فوری وجود دارد؛ به عنوان مثال در درخت وراثت زیر:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
+\-\- ArithmeticError
     +\-\- FloatingPointError
     +\-\- OverflowError
     +\-\- ZeroDivisionError
.EE
.UNINDENT
.UNINDENT
.sp
کد زیر یک حالت معتبر برای raise مجدد و فوری استثنا را نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def execute_calculation(a, b):
    try:
        return some_calculation(a, b)
    except ZeroDivisionError:
        raise
    except ArithmeticError:
        return float(\(aqnan\(aq)
.EE
.UNINDENT
.UNINDENT
.sp
ابزار pylint قادر به شناسایی این حالت است و خطایی ایجاد نمی‌کند.
.sp
ایجادشده توسط بررسی‌کننده exceptions \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:exceptions\:.py>..SS unbalanced\-dict\-unpacking / W0644
.sp
\fBپیام صادرشده:\fP
.sp
\fBاحتمال بازگشایی نامتوازن دیکشنری با %s: سمت چپ دارای %d برچسب%s و سمت راست دارای %d مقدار%s است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک بازگشایی (unpacking) نامتوازن دیکشنری در انتساب یا حلقه for وجود داشته باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
FRUITS = {\(dqapple\(dq: 2, \(dqorange\(dq: 3, \(dqmellon\(dq: 10}

for fruit, price in FRUITS.values():  # [unbalanced\-dict\-unpacking]
    print(fruit)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
FRUITS = {\(dqapple\(dq: 2, \(dqorange\(dq: 3, \(dqmellon\(dq: 10}

for fruit, price in FRUITS.items():
    print(fruit)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>.
.SS undefined\-loop\-variable / W0631
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از متغیر حلقه احتمالاً تعریف‌نشده %r\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک متغیر حلقه (یعنی متغیری که توسط یک حلقه for، یک توصیف لیست (list comprehension) یا یک عبارت مولد (generator expression) تعریف شده است) در خارج از حلقه استفاده شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def find_even_number(numbers):
    for x in numbers:
        if x % 2 == 0:
            break
    return x  # [undefined\-loop\-variable]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def find_even_number(numbers):
    for x in numbers:
        if x % 2:
            return x
    return None

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>..SS unnecessary\-ellipsis / W2301
.sp
\fBپیام صادرشده:\fP
.sp
\fBثابت ellipsis غیرضروری\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که با ثابت ellipsis برخورد شود و بتوان از آن اجتناب کرد. یک خط کد متشکل از یک ellipsis در صورتی غیرضروری است که یک docstring در خط قبلی آن وجود داشته باشد یا دستوری در همان حوزه (scope) قرار گرفته باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def my_function():
    \(dq\(dq\(dqMy docstring\(dq\(dq\(dq
    ...  # [unnecessary\-ellipsis]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def my_function():
    \(dq\(dq\(dqMy docstring\(dq\(dq\(dq

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده unnecessary_ellipsis \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:ellipsis_checker\:.py>.
.SS unnecessary\-lambda / W0108
.sp
\fBپیام صادرشده:\fP
.sp
\fBممکن است lambda غیرضروری باشد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که بدنه یک عبارت lambda فراخوانی تابعی با همان فهرست آرگومان‌های خود lambda باشد؛ چنین عبارت‌های lambdaای تقریباً در تمام موارد، به‌جز مواردی معدود، با تابعی که درون بدنه lambda فراخوانی می‌شود قابل جایگزینی هستند.\fP
.sp
\fBکد دارای مشکل:\fP
.sp
\fBpandas.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
df.apply(lambda x: str(x))  # [unnecessary\-lambda]

.EE
.UNINDENT
.UNINDENT
.sp
\fBprint.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
function = lambda x: print(x)  # [unnecessary\-lambda]

function(\(dqHello world !\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.sp
\fBpandas.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
df.apply(str)

.EE
.UNINDENT
.UNINDENT
.sp
\fBprint.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqHello world !\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_checker\:.py>..SS unnecessary\-pass / W0107
.sp
\fBپیام صادرشده:\fP
.sp
\fBدستور pass غیرضروری\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک دستور \(dqpass\(dq را بتوان بدون تأثیر بر رفتار کد حذف کرد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class DataEntryError(Exception):
    \(dq\(dq\(dqThis exception is raised when a user has provided incorrect data.\(dq\(dq\(dq

    pass  # [unnecessary\-pass]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class DataEntryError(Exception):
    \(dq\(dq\(dqThis exception is raised when a user has provided incorrect data.\(dq\(dq\(dq

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:pass_checker\:.py>.
.SS unnecessary\-semicolon / W0301
.sp
\fBپیام صادرشده:\fP
.sp
\fBنقطه‌ویرگول غیرضروری\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که انتهای یک عبارت با نقطه‌ویرگول (\(dq;\(dq) خاتمه یابد، در حالی که نیازی به آن نیست (اینجا پایتون است، نه C ;).\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqHello World!\(dq);  # [unnecessary\-semicolon]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqHello World!\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده format \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:format\:.py>.
.SS unreachable / W0101
.sp
\fBپیام صادرشده:\fP
.sp
\fBکد غیرقابل‌دسترس\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که کدی پس از یک دستور \(dqreturn\(dq یا \(dqraise\(dq قرار گرفته باشد که هیچ‌گاه به آن دسترسی پیدا نخواهد شد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def say_hello():
    return True
    print(\(dqHello World!, Outside function.\(dq)  # [unreachable]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def say_hello():
    print(\(dqHello World!, Inside function.\(dq)
    return True

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_checker\:.py>..SS unspecified\-encoding / W1514
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از open بدون مشخص‌کردن صریح کدگذاری\fP
.sp
\fBتوضیحات:\fP
.sp
\fIبهتر است هنگام باز کردن اسناد، یک کدگذاری را مشخص کنید. استفادهٔ ضمنی از پیش‌فرض سیستم می‌تواند در سایر سیستم‌عامل‌ها مشکلاتی ایجاد کند. https://peps.python.org/pep\-0597 را ببینید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def foo(file_path):
    with open(file_path) as file:  # [unspecified\-encoding]
        contents = file.read()

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def foo(file_path):
    with open(file_path, encoding=\(dqutf\-8\(dq) as file:
        contents = file.read()

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ stdlib \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:stdlib\:.py>.
.SS unused\-argument / W0613
.sp
\fBپیام صادرشده:\fP
.sp
\fBآرگومان استفاده‌نشده %r\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک آرگومان تابع یا متد به کار نرفته باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def print_point(x, y):  # [unused\-argument]
    print(f\(dqPoint is located at {x},{x}\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def print_point(x, y):
    print(f\(dqPoint is located at {x},{y}\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>.
.SS unused\-format\-string\-argument / W1304
.sp
\fBپیام صادرشده:\fP
.sp
\fBآرگومان قالب‌بندی استفاده‌نشده %r\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک رشتهٔ قالب‌بندی PEP 3101 دارای فیلدهای نام‌گذاری‌شده، با آرگومانی به کار رود که توسط رشتهٔ قالب‌بندی مورد نیاز نیست.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dq{x} {y}\(dq.format(x=1, y=2, z=3))  # [unused\-format\-string\-argument]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.sp
\fBadd_format_target.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dq{x} {y} {z}\(dq.format(x=1, y=2, z=3))

.EE
.UNINDENT
.UNINDENT
.sp
\fBremove_unused_args.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dq{x} {y}\(dq.format(x=1, y=2))

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>..SS unused\-format\-string\-key / W1301
.sp
\fBپیام صادرشده:\fP
.sp
\fBکلید استفاده‌نشده %r در دیکشنری رشته قالب‌بندی\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک رشته قالب‌بندی که از مشخص‌کننده‌های تبدیل نام‌دار استفاده می‌کند، با دیکشنری‌ای به کار رود که حاوی کلیدهایی است که توسط رشته قالب‌بندی مورد نیاز نیستند.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqThe quick %(color)s fox jumps over the lazy dog.\(dq % {
    \(dqcolor\(dq: \(dqbrown\(dq,
    \(dqaction\(dq: \(dqhops\(dq,
}
# \-4: [unused\-format\-string\-key]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqThe quick %(color)s fox %(action)s over the lazy dog.\(dq % {
    \(dqcolor\(dq: \(dqbrown\(dq,
    \(dqaction\(dq: \(dqhops\(dq,
}

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده string \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:strings\:.py>.
.SS unused\-import / W0611
.sp
\fBپیام صادرشده:\fP
.sp
\fB%s استفاده‌نشده\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک ماژول یا متغیر واردشده، مورد استفاده قرار نگرفته باشد.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from logging import getLogger
from pathlib import Path  # [unused\-import]

LOGGER = getLogger(__name__)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from logging import getLogger

LOGGER = getLogger(__name__)

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
به‌طور پیش‌فرض، این بررسی برای فایل‌های \fB__init__.py\fP نادیده گرفته می‌شود، زیرا این فایل‌ها اغلب برای راحتی کاربران نهایی، حاوی واردکردن‌هایی (imports) از زیرماژول‌ها هستند. گرچه این واردکردن‌ها درون \fB__init__.py\fP استفاده نمی‌شوند، اما هدف آن‌ها فراهم کردن مسیرهای واردسازی سرراست برای کلاس‌ها و مقادیر ثابتِ مهم ماژول است.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
\-\-init\-import \%<#\:variables-options>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>..SS unused\-private\-member / W0238
.sp
\fBپیام صادرشده:\fP
.sp
\fBعضو خصوصی استفاده‌نشده \(ga%s.%s\(ga\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که یک عضو خصوصی در یک کلاس تعریف شده اما استفاده نشده باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    FRUITS = {\(dqapple\(dq: \(dqred\(dq, \(dqorange\(dq: \(dqorange\(dq}

    def __print_color(self):  # [unused\-private\-member]
        pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    FRUITS = {\(dqapple\(dq: \(dqred\(dq, \(dqorange\(dq: \(dqorange\(dq}

    def __print_color(self, name, color):
        print(f\(dq{name}: {color}\(dq)

    def print(self):
        for fruit, color in self.FRUITS.items():
            self.__print_color(fruit, color)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>.
.SS unused\-variable / W0612
.sp
\fBپیام صادرشده:\fP
.sp
\fBمتغیر استفاده‌نشده %r\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک متغیر تعریف شده اما به کار نرفته باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def print_fruits():
    fruit1 = \(dqorange\(dq
    fruit2 = \(dqapple\(dq  # [unused\-variable]
    print(fruit1)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def print_fruits():
    fruit1 = \(dqorange\(dq
    fruit2 = \(dqapple\(dq
    print(fruit1, fruit2)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>..SS unused\-wildcard\-import / W0614
.sp
\fBپیام صادرشده:\fP
.sp
\fBواردسازی(های) استفاده‌نشدهٔ %s از واردسازی نویسه‌عام (wildcard) از %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک ماژول یا متغیر واردشده از طریق واردسازی با شیوهٔ \(ga\(aqfrom X import *\(aq\(ga مورد استفاده قرار نگرفته باشد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from abc import *  # [unused\-wildcard\-import]


class Animal(ABC): ...

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from abc import ABC


class Animal(ABC): ...

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کنندهٔ variables \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:variables\:.py>.
.SS useless\-else\-on\-loop / W0120
.sp
\fBپیام صادرشده:\fP
.sp
\fBبند else در حلقهٔ بدون دستور break؛ بند else را حذف کرده و تورفتگی تمام کدهای درون آن را بردارید (de\-indent)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIحلقه‌ها فقط در صورتی باید دارای بند else باشند که بتوان با یک دستور break زودتر از موعد از آن‌ها خارج شد، در غیر این صورت دستورات زیر else باید در همان حوزهٔ (scope) حلقه قرار گیرند.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def find_even_number(numbers):
    for x in numbers:
        if x % 2 == 0:
            return x
    else:  # [useless\-else\-on\-loop]
        print(\(dqDid not find an even number\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def find_even_number(numbers):
    for x in numbers:
        if x % 2 == 0:
            return x
    print(\(dqDid not find an even number\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کنندهٔ basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_error_checker\:.py>..SS useless\-param\-doc / W9019
.sp
\fBپیام صادرشده:\fP
.sp
\fBمستندسازی بی‌استفاده پارامتر نادیده‌گرفته‌شده \(dq%s\(dq\fP
.sp
\fBتوضیحات:\fP
.sp
\fIلطفاً مستندسازی پارامتر نادیده‌گرفته‌شده را حذف کنید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def say_hello(_new: str) \-> str:  # [useless\-param\-doc]
    \(dq\(dq\(dqsay hello!

    :param _new:
    :return: comment
    \(dq\(dq\(dq
    return \(dqhello\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def say_hello(_new: str) \-> str:
    \(dq\(dq\(dqsay hello!

    :return: comment
    \(dq\(dq\(dq
    return \(dqhello\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins=pylint.extensions.docparams,

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqparameter_documentation\(aq \%<#\:pylint-extensions-docparams>
صادر می‌شود، که نیازمند بارگذاری افزونه \fBpylint.extensions.docparams\fP است.
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده parameter_documentation \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:docparams\:.py>.
.SS useless\-parent\-delegation / W0246
.sp
\fBپیام صادرشده:\fP
.sp
\fBتفویض بی‌استفاده به والد یا ()super در متد %r\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که بتوان تشخیص داد یک متد بازنویسی‌شده بی‌استفاده است و با اتکا به تفویض به والد یا ()super، دقیقاً همان کار متد دیگری از MRO را انجام می‌دهد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Animal:
    def eat(self, food):
        print(f\(dqEating {food}\(dq)


class Human(Animal):
    def eat(self, food):  # [useless\-parent\-delegation]
        super(Human, self).eat(food)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Animal:
    def eat(self, food):
        print(f\(dqEating {food}\(dq)


class Human(Animal):
    \(dq\(dq\(dqThere is no need to override \(aqeat\(aq it has the same signature as the implementation in Animal.\(dq\(dq\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
توضیحات Stackoverflow درباره \(aquseless\-super\-delegation\(aq \%<https://\:stackoverflow\:.com/\:a/\:51030674/\:2519059>
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>..SS useless\-type\-doc / W9020
.sp
\fBپیام صادرشده:\fP
.sp
\fBمستندسازی بی‌فایدهٔ نوع پارامتر نادیده‌گرفته‌شدهٔ \(dq%s\(dq\fP
.sp
\fBتوضیحات:\fP
.sp
\fIلطفاً مستندسازی نوع پارامتر نادیده‌گرفته‌شده را حذف کنید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def print_fruit(fruit, _):  # [useless\-type\-doc]
    \(dq\(dq\(dqdocstring ...

    Args:
        fruit (str): A fruit.
        _ (float): Another argument.
    \(dq\(dq\(dq
    print(fruit)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def print_fruit(fruit):
    \(dq\(dq\(dqdocstring ...

    Args:
        fruit (str): A fruit.
    \(dq\(dq\(dq
    print(fruit)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins=pylint.extensions.docparams,

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کنندهٔ اختیاری \(aqparameter_documentation\(aq \%<#\:pylint-extensions-docparams> صادر می‌شود که مستلزم بارگذاری افزونهٔ \fBpylint.extensions.docparams\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ parameter_documentation \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:docparams\:.py>.
.SS useless\-with\-lock / W2101
.sp
\fBپیام صادرشده:\fP
.sp
\fB\(aq%s()\(aq ایجادشده به‌طور مستقیم در \(aqwith\(aq بی‌اثر است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک نمونهٔ قفل جدید با استفاده از دستور with ایجاد شود که هیچ اثری ندارد. در عوض، باید از یک نمونهٔ موجود برای گرفتن قفل استفاده شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import threading

with threading.Lock():  # [useless\-with\-lock]
    print(\(dqMake your bed.\(dq)
with threading.Lock():  # [useless\-with\-lock]
    print(\(dqSleep in it\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import threading

lock = threading.Lock()
with lock:
    print(\(dqMake your bed.\(dq)
with lock:
    print(\(dqSleep in it.\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ threading \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:threading_checker\:.py>..SS using\-assignment\-expression\-in\-unsupported\-version / W2605
.sp
\fBپیام صادرشده:\fP
.sp
\fBAssignment expression is not supported by all versions included in the py\-version setting\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که py\-version تنظیم‌شده توسط کاربر کمتر از 3.8 باشد و pylint با عملگر عبارت انتساب (walrus) مواجه شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import random

# +1: [using\-assignment\-expression\-in\-unsupported\-version]
if zero_or_one := random.randint(0, 1):
    assert zero_or_one == 1

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import random

zero_or_one = random.randint(0, 1)
if zero_or_one:
    assert zero_or_one == 1

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
py\-version=3.7

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
عملگر عبارت انتساب (walrus) (\fI:=\fP) در Python 3.8 معرفی شد؛ برای استفاده از آن، لطفاً از نسخه جدیدتری از Python استفاده کنید.
.sp
ایجادشده توسط بررسی‌کننده unsupported_version \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:unsupported_version\:.py>.
.SS using\-constant\-test / W0125
.sp
\fBپیام صادرشده:\fP
.sp
\fBUsing a conditional statement with a constant value\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که یک دستور شرطی (If یا if سه‌گانه) از یک مقدار ثابت برای آزمون شرط خود استفاده کند. این ممکن است هدف مورد نظر کاربر نبوده باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
if 0:  # [using\-constant\-test]
    print(\(dqThis code is never executed.\(dq)
if 1:  # [using\-constant\-test]
    print(\(dqThis code is always executed.\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqThis code is always executed.\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:basic_checker\:.py>..SS using\-exception\-groups\-in\-unsupported\-version / W2603
.sp
\fBپیام صادرشده:\fP
.sp
\fBگروه‌های استثنا در تمام نسخه‌های مشخص‌شده در تنظیم py\-version پشتیبانی نمی‌شوند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که py\-version تنظیم‌شده توسط کاربر کمتر از 3.11 باشد و pylint با \(ga\(gaexcept*\(ga\(ga یا \(gaExceptionGroup\(ga\(ga مواجه شود.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def f():
    excs = [OSError(\(dqerror 1\(dq), SystemError(\(dqerror 2\(dq)]
    # +1: [using\-exception\-groups\-in\-unsupported\-version]
    raise ExceptionGroup(\(dqthere were problems\(dq, excs)


try:  # [using\-exception\-groups\-in\-unsupported\-version]
    f()
except* OSError as e:
    print(\(dqThere were OSErrors\(dq)
except* SystemError as e:
    print(\(dqThere were SystemErrors\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def f():
    raise OSError(\(dqerror 1\(dq)


try:
    f()
except OSError as e:
    print(\(dqThere were OSErrors\(dq)
except SystemError as e:
    print(\(dqThere were SystemErrors\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
py\-version=3.10

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
گروه‌های استثنا در Python 3.11 معرفی شدند؛ برای استفاده از آن‌ها، لطفاً از نسخه جدیدتری از Python استفاده کنید.
.sp
ایجادشده توسط بررسی‌کننده unsupported_version \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:unsupported_version\:.py>.
.SS using\-f\-string\-in\-unsupported\-version / W2601
.sp
\fBپیام صادرشده:\fP
.sp
\fBF\-stringها در تمام نسخه‌های مشخص‌شده در تنظیم py\-version پشتیبانی نمی‌شوند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که py\-version تنظیم‌شده توسط کاربر کمتر از 3.6 باشد و pylint با یک f\-string مواجه شود.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
f\(dqpython {3.5} is past end of life\(dq  # [using\-f\-string\-in\-unsupported\-version]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqpython {} is past end of life\(dq.format(3.5)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
py\-version=3.5

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
f\-stringها در Python نسخه 3.6 معرفی شدند؛ برای استفاده از آن‌ها، لطفاً از نسخه جدیدتری از Python استفاده کنید.
.sp
ایجادشده توسط بررسی‌کننده unsupported_version \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:unsupported_version\:.py>..SS using\-final\-decorator\-in\-unsupported\-version / W2602
.sp
\fBپیام صادرشده:\fP
.sp
\fBtyping.final در تمامی نسخه‌های موجود در تنظیم py\-version پشتیبانی نمی‌شود\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که py\-version تعیین‌شده توسط کاربر کمتر از 3.8 باشد و pylint با یک دکوراتور \(ga\(gatyping.final\(ga\(ga مواجه شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import final


@final  # [using\-final\-decorator\-in\-unsupported\-version]
class Playtypus(Animal):
    @final  # [using\-final\-decorator\-in\-unsupported\-version]
    def lay_egg(self): ...

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Playtypus(Animal):
    def lay_egg(self): ...

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
py\-version=3.7

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
این پیام زمانی صادر می‌شود که دکوراتور \fBfinal\fP با نسخه‌ای از Python کمتر از 3.8 به کار رود.
دکوراتور \fBfinal\fP در نسخه 3.8 از Python معرفی شد.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
PEP 591 \%<https://\:peps\:.python\:.org/\:pep-0591/#\:the-final-decorator>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ unsupported_version \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:unsupported_version\:.py>.
.SS using\-generic\-type\-syntax\-in\-unsupported\-version / W2604
.sp
\fBپیام صادرشده:\fP
.sp
\fBنحو نوع جنریک (PEP 695) در تمامی نسخه‌های موجود در تنظیم py\-version پشتیبانی نمی‌شود\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که py\-version تعیین‌شده توسط کاربر کمتر از 3.12 باشد و pylint با نحو نوع جنریک مواجه شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
type Vector = list[float]  # [using\-generic\-type\-syntax\-in\-unsupported\-version]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import TypeAlias

Vector: TypeAlias = list[float]

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
py\-version=3.11

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
نحو نوع جنریک در Python 3.12 معرفی شد؛ برای استفاده از آن، لطفاً از نسخهٔ جدیدتری از Python استفاده کنید.
.sp
ایجادشده توسط بررسی‌کنندهٔ unsupported_version \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:unsupported_version\:.py>..SS using\-positional\-only\-args\-in\-unsupported\-version / W2606
.sp
\fBپیام صادرشده:\fP
.sp
\fBآرگومان‌های صرفاً موضعی (positional\-only) در تمام نسخه‌های موجود در تنظیم py\-version پشتیبانی نمی‌شوند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که py\-version تنظیم‌شده توسط کاربر کمتر از 3.8 باشد و pylint با آرگومان‌های صرفاً موضعی مواجه شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def add(x, y, /):  # [using\-positional\-only\-args\-in\-unsupported\-version]
    return x + y

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# pylint: disable=missing\-function\-docstring, missing\-module\-docstring
def add(x, y):
    return x + y

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
py\-version=3.7

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
آرگومان‌های صرفاً موضعی در Python 3.8 معرفی شدند؛ برای استفاده از آن‌ها، لطفاً از نسخه جدیدتری از Python استفاده کنید.
.sp
ایجادشده توسط بررسی‌کننده unsupported_version \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:unsupported_version\:.py>.
.SS while\-used / W0149
.sp
\fBپیام صادرشده:\fP
.sp
\fBحلقه \(gawhile\(ga استفاده شده است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIحلقه‌های نامحدود \(gawhile\(ga اغلب می‌توانند به صورت حلقه‌های محدود \(gafor\(ga بازنویسی شوند. مواردی مانند حلقه‌های رویداد (event loops)، شنونده‌ها (listeners) و غیره می‌توانند استثنا باشند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import requests


def fetch_data():
    i = 1
    while i < 6:  # [while\-used]
        print(f\(dqAttempt {i}...\(dq)
        try:
            return requests.get(\(dqhttps://example.com/data\(dq)
        except requests.exceptions.RequestException:
            pass
        i += 1

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import requests


def fetch_data():
    for i in range(1, 6):
        print(f\(dqAttempt {i}...\(dq)
        try:
            return requests.get(\(dqhttps://example.com/data\(dq)
        except requests.exceptions.RequestException:
            pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
load\-plugins=pylint.extensions.while_used

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
گفتگوی Stackoverflow \%<https://\:stackoverflow\:.com/\:questions/\:920645/\:when-to-use-while-or-for-in-python>
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqwhile_used\(aq \%<#\:pylint-extensions-while-used>
صادر می‌شود، که نیازمند بارگذاری افزونه \fBpylint.extensions.while_used\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده while_used \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:while_used\:.py>..SS wildcard\-import / W0401
.sp
\fBپیام صادرشده:\fP
.sp
\fBWildcard import %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که \(gafrom module import *\(ga شناسایی شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from abc import *  # [wildcard\-import]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# Either import module or
# only import required objects from module.
import abc
from abc import ABC, abstractmethod

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ imports \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:imports\:.py>.
.SS wrong\-exception\-operation / W0716
.sp
\fBپیام صادرشده:\fP
.sp
\fBInvalid exception operation. %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که عملیاتی روی یک استثنا انجام گیرد، اما آن عملیات برای استثنای مورد نظر معتبر نباشد. معمولاً هنگام وجود عملیات‌های دودویی بین استثناها در گرداننده‌های except صادر می‌شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
try:
    1 / 0
except ValueError + TypeError:  # [wrong\-exception\-operation]
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
try:
    1 / 0
except (ValueError, TypeError):
    pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ exceptions \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:exceptions\:.py>.
.sp
تمام پیام‌های تغییرنام‌یافته در دسته‌بندی warning:
.SS broad\-except / W0703
.sp
\(aqbroad\-except\(aq تغییرنام یافته است. پیام جدید را می‌توان در این نشانی یافت:.SS cache\-max\-size\-none / W1517
.sp
نام \(aqcache\-max\-size\-none\(aq تغییر یافته است. پیام جدید را می‌توانید در اینجا بیابید:
.SS implicit\-str\-concat\-in\-sequence / W1403
.sp
نام \(aqimplicit\-str\-concat\-in\-sequence\(aq تغییر یافته است. پیام جدید را می‌توانید در اینجا بیابید:
.SS lru\-cache\-decorating\-method / W1516
.sp
نام \(aqlru\-cache\-decorating\-method\(aq تغییر یافته است. پیام جدید را می‌توانید در اینجا بیابید:
.SS old\-assignment\-from\-none / W1111
.sp
نام \(aqold\-assignment\-from\-none\(aq تغییر یافته است. پیام جدید را می‌توانید در اینجا بیابید:
.SS old\-deprecated\-argument / W1511
.sp
نام \(aqold\-deprecated\-argument\(aq تغییر یافته است. پیام جدید را می‌توانید در اینجا بیابید:
.SS old\-deprecated\-class / W1512
.sp
نام \(aqold\-deprecated\-class\(aq تغییر یافته است. پیام جدید را می‌توانید در اینجا بیابید:
.SS old\-deprecated\-decorator / W1513
.sp
نام \(aqold\-deprecated\-decorator\(aq تغییر یافته است. پیام جدید را می‌توانید در اینجا بیابید:
.SS old\-deprecated\-method / W1505
.sp
نام \(aqold\-deprecated\-method\(aq تغییر یافته است. پیام جدید را می‌توانید در اینجا بیابید:
.SS old\-deprecated\-module / W0402
.sp
نام \(aqold\-deprecated\-module\(aq تغییر یافته است. پیام جدید را می‌توانید در اینجا بیابید:
.SS old\-empty\-docstring / W0132
.sp
نام \(aqold\-empty\-docstring\(aq تغییر یافته است. پیام جدید را می‌توانید در اینجا بیابید:
.SS empty\-docstring / C0112
.sp
\fBپیام صادرشده:\fP
.sp
\fBEmpty %s docstring\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک ماژول، تابع، کلاس یا متد دارای docstring خالی باشد (دیگر خیلی ساده می‌شد ;).\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def foo():  # [empty\-docstring]
    \(dq\(dq\(dq\(dq\(dq\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def foo():
    \(dq\(dq\(dqA dummy description.\(dq\(dq\(dq

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:docstring_checker\:.py>.
.SS old\-missing\-param\-doc / W9003
.sp
نام \(aqold\-missing\-param\-doc\(aq تغییر یافته است. پیام جدید را می‌توانید در اینجا بیابید:
.SS old\-missing\-returns\-doc / W9007
.sp
نام \(aqold\-missing\-returns\-doc\(aq تغییر یافته است. پیام جدید را می‌توانید در اینجا بیابید:
.SS old\-missing\-type\-doc / W9004
.sp
نام \(aqold\-missing\-type\-doc\(aq تغییر یافته است. پیام جدید را می‌توانید در اینجا بیابید:
.SS old\-missing\-yields\-doc / W9009
.sp
نام \(aqold\-missing\-yields\-doc\(aq تغییر یافته است. پیام جدید را می‌توانید در اینجا بیابید:
.SS old\-non\-iterator\-returned\-1 / W0234
.sp
نام \(aqold\-non\-iterator\-returned\-1\(aq تغییر یافته است. پیام جدید را می‌توانید در اینجا بیابید:.SS old\-unidiomatic\-typecheck / W0154
.sp
نام \(aqold\-unidiomatic\-typecheck\(aq تغییر یافته است. پیام جدید را می‌توان در بخش زیر یافت:
.SS unidiomatic\-typecheck / C0123
.sp
\fBپیام صادرشده:\fP
.sp
\fBبرای بررسی نوع، به جای type() از isinstance() استفاده کنید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIروش استاندارد و اصولی برای انجام یک بررسی نوع صریح در پایتون، استفاده از isinstance(x, Y) به جای type(x) == Y یا type(x) is Y است؛ هرچند شرایط نادری وجود دارند که در آن‌ها این دو روش نتایج متفاوتی ارائه می‌دهند.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
test_score = {\(dqBiology\(dq: 95, \(dqHistory\(dq: 80}
if type(test_score) is dict:  # [unidiomatic\-typecheck]
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
test_score = {\(dqBiology\(dq: 95, \(dqHistory\(dq: 80}
if isinstance(test_score, dict):
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
تابع توکار type() \%<https://\:docs\:.python\:.org/\:3/\:library/\:functions\:.html#\:type>
.IP \(bu 2
تابع توکار isinstance() \%<https://\:docs\:.python\:.org/\:3/\:library/\:functions\:.html#\:isinstance>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:comparison_checker\:.py>.
.SS old\-unpacking\-non\-sequence / W0633
.sp
نام \(aqold\-unpacking\-non\-sequence\(aq تغییر یافته است. پیام جدید را می‌توان در بخش زیر یافت:
.SS useless\-super\-delegation / W0235
.sp
نام \(aquseless\-super\-delegation\(aq تغییر یافته است. پیام جدید را می‌توان در بخش زیر یافت:
.SS "قرارداد (Convention)"
.sp
تمام پیام‌ها در دسته‌بندی قرارداد (convention):
.SS bad\-classmethod\-argument / C0202
.sp
\fBپیام صادرشده:\fP
.sp
\fBمتد کلاس %s باید %s را به عنوان اولین آرگومان داشته باشد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی به کار می‌رود که نام نخستین آرگومان یک متد کلاس با مقدار مشخص‌شده در گزینه valid\-classmethod\-first\-arg (به طور پیش‌فرض \(dqcls\(dq) متفاوت باشد؛ این کار توصیه می‌شود تا بتوان آن‌ها را به آسانی از متدهای عادی نمونه تشخیص داد.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Klass:
    @classmethod
    def get_instance(self):  # [bad\-classmethod\-argument]
        return self()

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Klass:
    @classmethod
    def get_instance(cls):
        return cls()

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>..SS bad\-docstring\-quotes / C0198
.sp
\fBپیام صادرشده:\fP
.sp
\fBنقل‌قول‌های نادرست docstring در %s، مورد انتظار: \(dq\(dq\(dq، ارائه‌شده: %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک docstring نقل‌قول سه‌گانه دوگانه (\(dq\(dq\(dq) نداشته باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def foo():  # [bad\-docstring\-quotes]
    \(dqDocstring.\(dq
    return

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def foo():
    \(dq\(dq\(dqDocstring.\(dq\(dq\(dq
    return

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
load\-plugins=pylint.extensions.docstyle

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.INDENT 0.0
.TP
.B از \fIPEP 257\fP:
\(dqبرای یکدستی، همواره از \fB\(dq\(dq\(dqنقل‌قول‌های سه‌گانه دوگانه\(dq\(dq\(dq\fP در اطراف docstringها استفاده کنید.\(dq
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
PEP 257 – Docstring Conventions \%<https://\:peps\:.python\:.org/\:pep-0257/#\:specification>
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqdocstyle\(aq \%<#\:pylint-extensions-docstyle> صادر می‌شود که نیازمند بارگذاری افزونه \fBpylint.extensions.docstyle\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده docstyle \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:docstyle\:.py>.
.SS bad\-file\-encoding / C2503
.sp
\fBپیام صادرشده:\fP
.sp
\fBPEP8 استفاده از UTF\-8 را به عنوان کدگذاری فایل‌های پایتون توصیه می‌کند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIPEP8 کدگذاری پیش‌فرض UTF\-8 را برای فایل‌های Python توصیه می‌کند. https://peps.python.org/pep\-0008/#source\-file\-encoding را ببینید\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# coding: latin_1 # [bad\-file\-encoding]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده unicode_checker \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:unicode\:.py>..SS bad\-mcs\-classmethod\-argument / C0204
.sp
\fBپیام صادرشده:\fP
.sp
\fBمتد کلاسی فراکلاس %s باید %s را به‌عنوان نخستین آرگومان داشته باشد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که نام نخستین آرگومان یک متد کلاسی فراکلاس با مقدار مشخص‌شده در گزینهٔ valid\-metaclass\-classmethod\-first\-arg (پیش‌فرض \(dqmcs\(dq) متفاوت باشد؛ این کار برای تمایز آسان آن‌ها از متدهای معمولی نمونه توصیه می‌شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Meta(type):
    @classmethod
    def foo(some):  # [bad\-mcs\-classmethod\-argument]
        pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Meta(type):
    @classmethod
    def foo(mcs):
        pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>.
.SS bad\-mcs\-method\-argument / C0203
.sp
\fBپیام صادرشده:\fP
.sp
\fBمتد فراکلاس %s باید %s را به‌عنوان نخستین آرگومان داشته باشد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که نام نخستین آرگومان یک متد فراکلاس با مقدار مشخص‌شده در گزینهٔ valid\-classmethod\-first\-arg (پیش‌فرض \(dqcls\(dq) متفاوت باشد؛ این کار برای تمایز آسان آن‌ها از متدهای معمولی نمونه توصیه می‌شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Meta(type):
    def func(some):  # [bad\-mcs\-method\-argument]
        pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Meta(type):
    def func(cls):
        pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>.
.SS consider\-iterating\-dictionary / C0201
.sp
\fBپیام صادرشده:\fP
.sp
\fBبه‌جای فراخوانی .keys()، پیمایش مستقیم دیکشنری را در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی صادر می‌شود که کلیدهای یک دیکشنری از طریق متد \(ga\(ga.keys()\(ga\(ga پیمایش شوند یا زمانی که \(ga\(ga.keys()\(ga\(ga برای بررسی عضویت استفاده شود. پیمایش خود دیکشنری کافی است: \(ga\(gafor key in dictionary\(ga\(ga. برای بررسی‌های عضویت، \(ga\(gaif key in dictionary\(ga\(ga سریع‌تر است.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
FRUITS = {\(dqapple\(dq: 1, \(dqpear\(dq: 5, \(dqpeach\(dq: 10}


for fruit in FRUITS.keys():  # [consider\-iterating\-dictionary]
    print(fruit)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
FRUITS = {\(dqapple\(dq: 1, \(dqpear\(dq: 5, \(dqpeach\(dq: 10}


for fruit in FRUITS:
    print(fruit)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:recommendation_checker\:.py>..SS consider\-using\-any\-or\-all / C0501
.sp
\fBپیام صادرشده:\fP
.sp
\fB\(gafor\(ga loop could be \(ga%s\(ga\fP
.sp
\fBتوضیحات:\fP
.sp
\fIیک حلقهٔ for که شرطی را بررسی می‌کند و یک مقدار bool برمی‌گرداند، می‌تواند با any یا all جایگزین شود.\fP
.sp
\fBکد دارای مشکل:\fP
.sp
\fBall_even.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def all_even(items):
    \(dq\(dq\(dqReturn True if the list contains all even numbers\(dq\(dq\(dq
    for item in items:  # [consider\-using\-any\-or\-all]
        if not item % 2 == 0:
            return False
    return True

.EE
.UNINDENT
.UNINDENT
.sp
\fBany_even.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def any_even(items):
    \(dq\(dq\(dqReturn True if the list contains any even numbers\(dq\(dq\(dq
    for item in items:  # [consider\-using\-any\-or\-all]
        if item % 2 == 0:
            return True
    return False

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.sp
\fBall_even.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def all_even(items):
    \(dq\(dq\(dqReturn True if the list contains all even numbers\(dq\(dq\(dq
    return all(item % 2 == 0 for item in items)

.EE
.UNINDENT
.UNINDENT
.sp
\fBany_even.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def any_even(items):
    \(dq\(dq\(dqReturn True if the list contains any even numbers\(dq\(dq\(dq
    return any(item % 2 == 0 for item in items)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins=pylint.extensions.for_any_all

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کنندهٔ اختیاری \(aqconsider\-using\-any\-or\-all\(aq \%<#\:pylint-extensions-for-any-all>
صادر می‌شود، که نیازمند بارگذاری پلاگین \fBpylint.extensions.for_any_all\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ consider\-using\-any\-or\-all \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:for_any_all\:.py>..SS consider\-using\-dict\-items / C0206
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از ()items. را برای پیمایش مد نظر قرار دهید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که روی کلیدهای یک دیکشنری پیمایش صورت گرفته و مقدار با جستجوی اندیس به دست می‌آید. در عوض می‌توان با پیمایش با متد ()items. دیکشنری، به هر دوی کلید و مقدار دسترسی یافت.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ORCHESTRA = {
    \(dqviolin\(dq: \(dqstrings\(dq,
    \(dqoboe\(dq: \(dqwoodwind\(dq,
    \(dqtuba\(dq: \(dqbrass\(dq,
    \(dqgong\(dq: \(dqpercussion\(dq,
}


for instrument in ORCHESTRA:  # [consider\-using\-dict\-items]
    print(f\(dq{instrument}: {ORCHESTRA[instrument]}\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ORCHESTRA = {
    \(dqviolin\(dq: \(dqstrings\(dq,
    \(dqoboe\(dq: \(dqwoodwind\(dq,
    \(dqtuba\(dq: \(dqbrass\(dq,
    \(dqgong\(dq: \(dqpercussion\(dq,
}


for instrument, section in ORCHESTRA.items():
    print(f\(dq{instrument}: {section}\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بازبین refactoring در \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:recommendation_checker\:.py>.
.SS consider\-using\-enumerate / C0200
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از enumerate را به‌جای پیمایش با range و len مد نظر قرار دهید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگام مواجهه با کدی صادر می‌شود که با range و len پیمایش می‌کند. چنین کدی را می‌توان با استفاده از تابع توکار enumerate ساده‌سازی کرد.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
seasons = [\(dqSpring\(dq, \(dqSummer\(dq, \(dqFall\(dq, \(dqWinter\(dq]

for i in range(len(seasons)):  # [consider\-using\-enumerate]
    print(i, seasons[i])

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
seasons = [\(dqSpring\(dq, \(dqSummer\(dq, \(dqFall\(dq, \(dqWinter\(dq]

for i, season in enumerate(seasons):
    print(i, season)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بازبین refactoring در \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:recommendation_checker\:.py>..SS consider\-using\-f\-string / C0209
.sp
\fBپیام صادرشده:\fP
.sp
\fBقالب‌بندی یک رشته معمولی که می‌تواند یک f\-string باشد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که تشخیص داده شود یک رشته با format() یا % قالب‌بندی شده است، در حالی که امکان تبدیل آن به یک f\-string وجود دارد. استفاده از f\-stringها ترجیح داده می‌شود. نیازمند Python 3.6 و \(ga\(gapy\-version >= 3.6\(ga\(ga است.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from string import Template

menu = (\(dqeggs\(dq, \(dqspam\(dq, 42.4)

old_order = \(dq%s and %s: %.2f ¤\(dq % menu  # [consider\-using\-f\-string]
beginner_order = menu[0] + \(dq and \(dq + menu[1] + \(dq: \(dq + str(menu[2]) + \(dq ¤\(dq
joined_order = \(dq and \(dq.join(menu[:2])
# +1: [consider\-using\-f\-string]
format_order = \(dq{} and {}: {:0.2f} ¤\(dq.format(menu[0], menu[1], menu[2])
# +1: [consider\-using\-f\-string]
named_format_order = \(dq{eggs} and {spam}: {price:0.2f} ¤\(dq.format(
    eggs=menu[0], spam=menu[1], price=menu[2]
)
template_order = Template(\(dq$eggs and $spam: $price ¤\(dq).substitute(
    eggs=menu[0], spam=menu[1], price=menu[2]
)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
menu = (\(dqeggs\(dq, \(dqspam\(dq, 42.4)

f_string_order = f\(dq{menu[0]} and {menu[1]}: {menu[2]:0.2f} ¤\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
لفظ‌های رشته‌ای قالب‌بندی‌شده (f\-stringها) ساختار نحوی مختصر و یکدستی را ارائه می‌دهند
که می‌تواند جایگزین بیشتر موارد استفاده از عملگر قالب‌بندی \fB%\fP،
\fBstr.format()\fP و \fBstring.Template\fP\& شود.
.sp
همچنین f\-stringها عملکرد بهتری نسبت به روش‌های جایگزین دارند؛ برای
یک مثال ساده به این توییت \%<https://\:twitter\:.com/\:raymondh/\:status/\:1205969258800275456> مراجعه
کنید.
.sp
ایجادشده توسط بررسی‌کنندهٔ refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:recommendation_checker\:.py>.
.SS dict\-init\-mutate / C3401
.sp
\fBپیام صادرشده:\fP
.sp
\fBهنگام مقداردهی اولیه دیکشنری، تمام کلید/مقدارهای شناخته‌شده را اعلان کنید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIدیکشنری‌ها می‌توانند در یک دستور واحد و با استفاده از نحو لفظِ دیکشنری (dictionary literal) مقداردهی اولیه شوند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruit_prices = {}  # [dict\-init\-mutate]
fruit_prices[\(dqapple\(dq] = 1
fruit_prices[\(dqbanana\(dq] = 10

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruit_prices = {\(dqapple\(dq: 1, \(dqbanana\(dq: 10}

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins=pylint.extensions.dict_init_mutate,

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کنندهٔ اختیاری \(aqdict\-init\-mutate\(aq \%<#\:pylint-extensions-dict-init-mutate>
صادر می‌شود که مستلزم بارگذاری افزونهٔ \fBpylint.extensions.dict_init_mutate\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ dict\-init\-mutate \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:dict_init_mutate\:.py>..SS disallowed\-name / C0104
.sp
\fBپیام صادرشده:\fP
.sp
\fBنام غیرمجاز \(dq%s\(dq\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که نام با bad\-names یا bad\-names\-rgxs\- (نام‌های غیرمجاز) مطابقت داشته باشد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def foo():  # [disallowed\-name]
    print(\(dqapples\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def print_fruit():
    print(\(dqapples\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
bad\-names=foo,bar,baz

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:name_checker/\:checker\:.py>.
.SS docstring\-first\-line\-empty / C0199
.sp
\fBپیام صادرشده:\fP
.sp
\fBخط اول در docstring %s خالی است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک خط خالی در ابتدای docstring یافت شود.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def foo():  # [docstring\-first\-line\-empty]
    \(dq\(dq\(dq
    Lorem Ipsum is simply dummy text of the printing and typesetting
    industry.

    Lorem Ipsum has been the industry\(aqs standard dummy text ever since the
    1500s, when an unknown printer took a galley of type and scrambled it
    to make a type specimen book
    \(dq\(dq\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def foo():
    \(dq\(dq\(dqLorem Ipsum is simply dummy text of the printing and typesetting
    industry.

    Lorem Ipsum has been the industry\(aqs standard dummy text ever since the
    1500s, when an unknown printer took a galley of type and scrambled it
    to make a type specimen book
    \(dq\(dq\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins = pylint.extensions.docstyle

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کنندهٔ اختیاری \(aqdocstyle\(aq \%<#\:pylint-extensions-docstyle>
صادر می‌شود که نیازمند بارگذاری افزونهٔ \fBpylint.extensions.docstyle\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ docstyle \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:docstyle\:.py>..SS import\-outside\-toplevel / C0415
.sp
\fBپیام صادرشده:\fP
.sp
\fBوارد کردن خارج از بالاترین سطح (%s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک دستور import در جایی غیر از بالاترین سطح ماژول به کار رفته باشد. این import را به ابتدای فایل منتقل کنید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def print_python_version():
    import sys  # [import\-outside\-toplevel]

    print(sys.version_info)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import sys


def print_python_version():
    print(sys.version_info)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بازبین imports \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:imports\:.py>.
.SS import\-private\-name / C2701
.sp
\fBپیام صادرشده:\fP
.sp
\fBوارد کردن %s خصوصی (%s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک ماژول یا شیء خصوصی با پیشوند _ وارد شود. راهنمای PEP8 در بخش قراردادهای نام‌گذاری بیان می‌کند که ویژگی‌های عمومی با زیرخط آغازین باید خصوصی در نظر گرفته شوند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from argparse import _AttributeHolder, _SubParsersAction  # [import\-private\-name]

attr_holder = _AttributeHolder()


def add_sub_parser(sub_parsers: _SubParsersAction):
    sub_parsers.add_parser(\(dqmy_subparser\(dq)
    # ...

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dq\(dq\(dqPrivate import can be used as type annotations.\(dq\(dq\(dq

from argparse import _SubParsersAction


def add_sub_parser(sub_parsers: _SubParsersAction):
    sub_parsers.add_parser(\(dqmy_subparser\(dq)
    # ...

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
load\-plugins = pylint.extensions.private_import

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
استفاده از وارد کردن‌های خصوصی، شما را در هر ارتقای نسخه وابستگی‌هایتان،
حتی در نسخه‌های وصله‌ای (patch)، در معرض تغییرات ناسازگار و غیرمنتظره قرار می‌دهد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بازبین اختیاری \(aqimport\-private\-name\(aq \%<#\:pylint-extensions-private-import>
صادر می‌شود که نیازمند بارگذاری افزونه \fBpylint.extensions.private_import\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بازبین import\-private\-name \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:private_import\:.py>..SS invalid\-characters\-in\-docstring / C0403
.sp
\fBپیام صادرشده:\fP
.sp
\fBInvalid characters %r in a docstring\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک کلمه در docstring توسط enchant قابل بررسی نباشد.\fP
.sp
\fBجزئیات تکمیلی:\fP
.sp
این پیامی مرتبط با یک مشکل داخلی در enchant است. نیازی به تغییر در کد شما نیست،
بلکه ممکن است در پیکربندی pylint یا نحوه نصب کتابخانه سیستمی \(aqenchant\(aq مشکلی وجود داشته باشد.
.sp
ایجادشده توسط بررسی‌کننده spelling \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:spelling\:.py>\&.
.SS invalid\-name / C0103
.sp
\fBپیام صادرشده:\fP
.sp
\fB%s name \(dq%s\(dq doesn\(aqt conform to %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که نام با قواعد نام‌گذاری مرتبط با نوع خود (ثابت، متغیر، کلاس...) مطابقت نداشته باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class cat:  # [invalid\-name]
    def Meow(self, NUMBER_OF_MEOW):  # [invalid\-name, invalid\-name]
        print(\(dqMeow\(dq * NUMBER_OF_MEOW)
        return NUMBER_OF_MEOW


Cat = cat().Meow(42)  # [invalid\-name]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Cat:
    def meow(self, number_of_meow):
        print(\(dqMeow\(dq * number_of_meow)
        return number_of_meow


CAT = Cat().meow(42)

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
ابزار Pylint در درون خود چندین نوع نام مختلف را تشخیص می‌دهد. با چند
استثنا، نوع یک نام توسط مکانی که انتساب به آن نام در آنجا یافت می‌شود تعیین می‌گردد،
نه بر اساس نوع شیء اختصاص‌داده‌شده.
.TS
box center;
l|l.
T{
نوع نام
T}	T{
توضیحات
T}
_
T{
\fBmodule\fP
T}	T{
نام‌های ماژول و بسته (package)، همانند نام فایل‌ها.
T}
_
T{
\fBconst\fP
T}	T{
ثابت‌های سطح ماژول: هر نام تعریف‌شده در سطح ماژول که نه به یک شیء کلاس متصل است و نه مجدداً مقداردهی می‌شود.
T}
_
T{
\fBclass\fP
T}	T{
نام‌ها در دستورهای \fBclass\fP، و همچنین نام‌های متصل به اشیاء کلاس در سطح ماژول.
T}
_
T{
\fBfunction\fP
T}	T{
توابع؛ در سطح بالا یا تودرتو درون توابع یا متدها.
T}
_
T{
\fBmethod\fP
T}	T{
متدها؛ توابع تعریف‌شده در بدنه کلاس. شامل متدهای ایستا (static) و متدهای کلاس.
T}
_
T{
\fBattr\fP
T}	T{
صفت‌های ایجادشده روی نمونه‌های کلاس در درون متدها.
T}
_
T{
\fBargument\fP
T}	T{
آرگومان‌های هر نوع تابع، از جمله توابع لامبدا (lambdas).
T}
_
T{
\fBvariable\fP
T}	T{
متغیرهای محلی در حوزه توابع یا نام‌های سطح ماژول که چندین بار مقداردهی می‌شوند.
T}
_
T{
\fBclass\-attribute\fP
T}	T{
صفت‌های تعریف‌شده در بدنه کلاس.
T}
_
T{
\fBclass\-const\fP
T}	T{
ثابت‌های Enum و متغیرهای کلاس نشانه‌گذاری‌شده با \fBFinal\fP
T}
_
T{
\fBinlinevar\fP
T}	T{
متغیرهای حلقه در فهم لیست‌ها (list comprehensions) و عبارات مولد (generator expressions).
T}
_
T{
\fBtypevar\fP
T}	T{
متغیر نوع اعلان‌شده با \fBTypeVar\fP\&.
T}
_
T{
\fBparamspec\fP
T}	T{
متغیر مشخصات پارامتر اعلان‌شده با \fBParamSpec\fP\&.
T}
_
T{
\fBtypevartuple\fP
T}	T{
تاپل متغیر نوع اعلان‌شده با \fBTypeVarTuple\fP\&.
T}
_
T{
\fBtypealias\fP
T}	T{
نام مستعار نوع اعلان‌شده با \fBTypeAlias\fP یا انتساب‌های \fBUnion\fP\&.
T}
.TE.SS رفتار پیش‌فرض
.sp
به‌طور پیش‌فرض، Pylint نام‌های پیشنهادی در PEP8 \%<https://\:peps\:.python\:.org/\:pep-0008> را اعمال می‌کند.
.SS سبک‌های نام‌گذاری از پیش‌تعریف‌شده
.sp
ابزار Pylint مجموعه‌ای از سبک‌های نام‌گذاری از پیش‌تعریف‌شده را ارائه می‌دهد. این سبک‌های
نام‌گذاری از پیش‌تعریف‌شده می‌توانند برای تطبیق پیکربندی Pylint با سبک کدنویسیِ
استفاده‌شده در پروژهٔ مورد بررسی به کار روند.
.sp
سبک‌های نام‌گذاری از پیش‌تعریف‌شدهٔ زیر در دسترس هستند:
.INDENT 0.0
.IP \(bu 2
\fBsnake_case\fP
.IP \(bu 2
\fBcamelCase\fP
.IP \(bu 2
\fBPascalCase\fP
.IP \(bu 2
\fBUPPER_CASE\fP
.IP \(bu 2
\fBany\fP \- سبک ساختگی که هیچ محدودیتی را اعمال نمی‌کند
.UNINDENT
.sp
گزینه‌های زیر در دسترس قرار دارند:
.INDENT 0.0
.TP
.B \-\-module\-naming\-style=<style>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-const\-naming\-style=<style>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-class\-naming\-style=<style>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-function\-naming\-style=<style>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-method\-naming\-style=<style>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-attr\-naming\-style=<style>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-argument\-naming\-style=<style>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-variable\-naming\-style=<style>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-class\-attribute\-naming\-style=<style>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-class\-const\-naming\-style=<style>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-inlinevar\-naming\-style=<style>
.UNINDENT
.SS الگوهای نام‌گذاری از پیش‌تعریف‌شده
.sp
ابزار Pylint الگوهای نام‌گذاری از پیش‌تعریف‌شده‌ای را برای برخی نام‌ها ارائه می‌کند. این الگوها
اغلب بر پایهٔ یک سبک نام‌گذاری هستند، اما گزینه‌ای برای انتخاب یکی از سبک‌های ذکرشده در بالا وجود ندارد.
این الگو را می‌توان با گزینه‌هایی که در ادامه شرح داده شده‌اند بازنویسی کرد.
.sp
انواع نام‌های زیر با یک الگوی از پیش‌تعریف‌شده بررسی می‌شوند:
.TS
box center;
l|l|l.
T{
نوع نام
T}	T{
نام‌های مناسب
T}	T{
نام‌های نامناسب
T}
_
T{
\fBtypevar\fP
T}	T{
\fBT\fP, \fB_CallableT\fP, \fB_T_co\fP, \fBAnyStr\fP,
\fBDeviceTypeT\fP, \fBIPAddressT\fP
T}	T{
\fBDICT_T\fP, \fBCALLABLE_T\fP, \fBENUM_T\fP, \fBDeviceType\fP,
\fB_StrType\fP
T}
_
T{
\fBparamspec\fP
T}	T{
\fBP\fP, \fB_P\fP
T}	T{
\fBCALLABLE_P\fP
T}
_
T{
\fBtypevartuple\fP
T}	T{
\fBTs\fP, \fB_Ts\fP
T}	T{
\fBTUPLE_TS\fP
T}
_
T{
\fBtypealias\fP
T}	T{
.INDENT 0.0
.TP
.B \fBGoodName\fP, \fB_GoodName\fP, \fBIPAddressType\fP,
\fBGoodName2\fP و سایر گونه‌های PascalCase که با
\fBT\fP یا \fBType\fP شروع نمی‌شوند\&. این به منظور
متمایز ساختن آن‌ها از \fBtypevars\fP است\&. توجه داشته باشید که
\fBTopName\fP مجاز است اما \fBTTopName\fP مجاز نیست\&.
.UNINDENT
T}	T{
.INDENT 0.0
.TP
.B \fBBadNameT\fP, \fBbadName\fP, \fBTBadName\fP, \fBTypeBadName\fP,
\fB_1BadName\fP
.UNINDENT
T}
.TE
.sp
پیش از pylint 3.0، بیشتر الگوهای از پیش‌تعریف‌شده حداقل طول سه نویسه را نیز
اعمال می‌کردند. اگر این رفتار در نگارش‌های 3.0 و پس از آن مورد نیاز باشد،
می‌توان با ارائهٔ عبارت‌های باقاعدهٔ سفارشی، مطابق آنچه در ادامه توضیح داده شده، به آن دست یافت. (یا
چنانچه بررسی \fBdisallowed\-name\fP به‌جای \fBinvalid\-name\fP کافی باشد،
ارائهٔ تک‌گزینهٔ \fBbad\-names\-rgxs=\(dq^..?$\(dq\fP برای رد کردن نام‌های ۱ تا ۲
نویسه‌ای کفایت خواهد کرد)..SS عبارت‌های باقاعده سفارشی
.sp
اگر سبک‌های نام‌گذاری از پیش تعریف‌شده بیش از حد محدود باشند، می‌توان رفتار بررسی‌کننده را بیشتر سفارشی‌سازی کرد. برای هر نوع نام، می‌توان یک عبارت باقاعده جداگانه برای تطبیق با نام‌های معتبر آن نوع تعریف نمود. اگر هر یک از عبارت‌های باقاعده سفارشی تعریف شوند، مقدار گزینه \fB*\-naming\-style\fP را بازنویسی (override) می‌کنند.
.sp
عبارت‌های باقاعده برای نام‌ها از ابتدا مهار شده‌اند؛ هر مهارکننده‌ای برای انتها باید به‌طور صریح ارائه شود. هر نامی که با عبارت باقاعده مطابقت نداشته باشد، منجر به یک نمونه از هشدار \fBinvalid\-name\fP خواهد شد\&.
.INDENT 0.0
.TP
.B \-\-module\-rgx=<regex>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-const\-rgx=<regex>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-class\-rgx=<regex>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-function\-rgx=<regex>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-method\-rgx=<regex>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-attr\-rgx=<regex>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-argument\-rgx=<regex>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-variable\-rgx=<regex>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-class\-attribute\-rgx=<regex>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-class\-const\-rgx=<regex>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-inlinevar\-rgx=<regex>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-typevar\-rgx=<regex>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-paramspec\-rgx=<regex>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-typevartuple\-rgx=<regex>
.UNINDENT
.INDENT 0.0
.TP
.B \-\-typealias\-rgx=<regex>
.UNINDENT
.SS چندین سبک‌ نام‌گذاری برای عبارت‌های باقاعده سفارشی
.sp
پایگاه‌های کد بزرگی که چندین سال توسعه یافته‌اند، اغلب دچار تحول در سبک نیز می‌شوند. در برخی موارد، ماژول‌ها ممکن است درون یک بسته یکسان باشند، اما بسته به لایه‌ای که به آن تعلق دارند، از سبک‌های نام‌گذاری متفاوتی استفاده کنند. با این حال، برای آسان‌تر شدن ایجاد تغییرات درون یک فایل، همچنان یکپارچگی درون‌ماژولی الزامی است. برای این مورد، Pylint از عبارت‌های باقاعده با چندین گروه ضبط نام‌گذاری‌شده (named capturing group) پشتیبانی می‌کند.
.sp
به‌جای صدور فوری هشدارهای نام، Pylint سبک نام‌گذاری غالب در هر ماژول را تعیین کرده و آن را بر تمام نام‌ها اعمال می‌کند.
.sp
مثال (ساده‌شده) زیر را در نظر بگیرید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pylint \-\-function\-rgx=\(aq(?:(?P<snake>[a\-z_]+)|(?P<camel>[a\-z]+([A\-Z][a\-z]*)*))$\(aq sample.py
.EE
.UNINDENT
.UNINDENT
.sp
این عبارت باقاعده دو سبک نام‌گذاری را تعریف می‌کند: \fBsnake\fP برای نام‌های snake\-case و \fBcamel\fP برای نام‌های camel\-case.
.sp
در فایل \fBsample.py\fP، نام تابع در خط ۱ و ۷ ماژول را علامت‌گذاری کرده و تطابق با گروه نام‌گذاری‌شده \fBsnake\fP را برای سایر نام‌های موجود در ماژول اجباری می‌سازد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def valid_snake_case(arg):
   ...

def InvalidCamelCase(arg):
   ...

def more_valid_snake_case(arg):
 ...
.EE
.UNINDENT
.UNINDENT
.sp
به همین دلیل، نام موجود در خط ۴ یک هشدار \fBinvalid\-name\fP ایجاد خواهد کرد، حتی با وجود این‌که نام با عبارت باقاعده داده‌شده مطابقت دارد.
.sp
تطابق‌های نام‌گذاری‌شده با \fBexempt\fP یا \fBignore\fP می‌توانند برای نام‌های بی‌اثر (non\-tainting) به کار روند، تا از فعال شدن سبک‌های نام‌گذاری خاص توسط نام‌های توکار (built\-in) یا تحمیل‌شده توسط رابط جلوگیری شود.
.INDENT 0.0
.TP
.B \-\-name\-group=<name1:name2:...,...>
مقدار پیش‌فرض: خالی
.sp
قالب: گروه‌های جداشده با کاما از نام‌های جداشده با دونقطه.
.sp
این گزینه می‌تواند برای ترکیب سبک‌های نام‌گذاری استفاده شود. برای مثال، \fBfunction:method\fP الزامی می‌کند که توابع و متدها از سبکی یکسان استفاده کنند، و سبکی که توسط هر یک از این دو نوع نام فعال شود به دیگری نیز سرایت می‌کند. این امر مستلزم آن است که عبارت باقاعده برای انواع نام‌های ترکیب‌شده از نام‌های گروه مشابهی استفاده کند.
.UNINDENT.SS راهنمایی‌های نام‌گذاری (Name Hints)
.INDENT 0.0
.TP
.B \-\-include\-naming\-hint=y|n
پیش‌فرض: off
.sp
همراه با هر هشدار \fBinvalid\-name\fP، یک راهنمایی (عبارت باقاعده استفاده‌شده) برای قالب نام صحیح گنجانده شود.
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:name_checker/\:checker\:.py>.
.SS line\-too\-long / C0301
.sp
\fBپیام صادرشده:\fP
.sp
\fBLine too long (%s/%s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک خط طولانی‌تر از تعداد نویسه‌های مشخص‌شده باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# +1: [line\-too\-long]
FRUIT = [\(dqapricot\(dq, \(dqblackcurrant\(dq, \(dqcantaloupe\(dq, \(dqdragon fruit\(dq, \(dqelderberry\(dq, \(dqfig\(dq, \(dqgrapefruit\(dq, ]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
FRUIT = [
    \(dqapricot\(dq,
    \(dqblackcurrant\(dq,
    \(dqcantaloupe\(dq,
    \(dqdragon fruit\(dq,
    \(dqelderberry\(dq,
    \(dqfig\(dq,
    \(dqgrapefruit\(dq,
]

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
max\-line\-length=100

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
کنترل‌های pragma مانند \fB# pylint: disable=all\fP برای اهداف این پیام، در محاسبه طول خط شمرده نمی‌شوند.
.sp
اگر تلاش کنید این پیام را از طریق \fB# pylint: disable=line\-too\-long\fP در یک ماژول بدون کد غیرفعال کنید، ممکن است پیامی برای \fBuseless\-suppression\fP\& دریافت کنید. این یک مثبت کاذب از \fBuseless\-suppression\fP است که نمی‌توانیم آن را به‌راحتی برطرف کنیم.
.sp
برای اطلاعات بیشتر \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3368> را ببینید.
.sp
ایجادشده توسط بررسی‌کننده format \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:format\:.py>.
.SS misplaced\-comparison\-constant / C2201
.sp
\fBپیام صادرشده:\fP
.sp
\fBComparison should be %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که مقدار ثابت در سمت چپ یک مقایسه قرار گیرد. معمولاً از نظر بیان مقصود، قرار دادن آن در سمت راست مقایسه واضح‌تر است.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def compare_apples(apples=20):
    for i in range(10):
        if 5 <= i:  # [misplaced\-comparison\-constant]
            pass
        if 1 == i:  # [misplaced\-comparison\-constant]
            pass
        if 20 < len(apples):  # [misplaced\-comparison\-constant]
            pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def compare_apples(apples=20):
    for i in range(10):
        if i >= 5:
            pass
        if i == 1:
            pass
        if len(apples) > 20:
            pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins=pylint.extensions.comparison_placement

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqcomparison\-placement\(aq \%<#\:pylint-extensions-comparison-placement> صادر می‌شود که به بارگذاری افزونه \fBpylint.extensions.comparison_placement\fP نیاز دارد.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده comparison\-placement \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:comparison_placement\:.py>..SS missing\-class\-docstring / C0115
.sp
\fBپیام صادرشده:\fP
.sp
\fBdocstring کلاس وجود ندارد (Missing class docstring)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک کلاس فاقد docstring باشد. حتی یک کلاس خالی نیز باید یک docstring داشته باشد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Person:  # [missing\-class\-docstring]
    def __init__(self, first_name, last_name):
        self.first_name = first_name
        self.last_name = last_name

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Person:
    \(dq\(dq\(dqClass representing a person\(dq\(dq\(dq

    def __init__(self, first_name, last_name):
        self.first_name = first_name
        self.last_name = last_name

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:docstring_checker\:.py>.
.SS missing\-final\-newline / C0304
.sp
\fBپیام صادرشده:\fP
.sp
\fBخط جدید پایانی وجود ندارد (Final newline missing)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که آخرین خط یک فایل فاقد خط جدید (newline) باشد.\fP
.sp
\fBکد مشکل‌دار:\fP
.sp
\fBcrlf.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqHello\(dq)  # CRLF (\er\en)
print(\(dqworld\(dq)  # End\-of\-file (EOF)
# [missing\-final\-newline]
.EE
.UNINDENT
.UNINDENT
.sp
\fBlf.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqHello\(dq)  # LF (\en)
print(\(dqworld\(dq)  # End\-of\-file (EOF)
# [missing\-final\-newline]
.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.sp
\fBcrlf.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqHello\(dq)  # CRLF (\er\en)
print(\(dqworld\(dq)  # CRLF (\er\en)
# End\-of\-file (EOF)

.EE
.UNINDENT
.UNINDENT
.sp
\fBlf.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqHello\(dq)  # LF (\en)
print(\(dqworld\(dq)  # LF (\en)
# End\-of\-file (EOF)

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.INDENT 0.0
.TP
.B استاندارد POSIX یک خط را این‌گونه تعریف می‌کند:
\(dqدنباله‌ای از صفر یا چند نویسه غیر\- <newline> به همراه یک نویسه خاتمه‌دهنده <newline>.\(dq
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
استاندارد POSIX \%<https://\:pubs\:.opengroup\:.org/\:onlinepubs/\:9699919799>
.IP \(bu 2
استاندارد POSIX، فصل 3.206 (Line) \%<https://\:pubs\:.opengroup\:.org/\:onlinepubs/\:9699919799/\:basedefs/\:V1_chap03\:.html#\:tag_03_206>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده format \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:format\:.py>..SS missing\-function\-docstring / C0116
.sp
\fBپیام صادرشده:\fP
.sp
\fBنبود docstring تابع یا متد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک تابع یا متد فاقد docstring باشد. برخی متدهای خاص مانند __init__ نیازی به docstring ندارند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import sys


def print_python_version():  # [missing\-function\-docstring]
    print(sys.version)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import sys


def print_python_version():
    \(dq\(dq\(dqFunction printing python version.\(dq\(dq\(dq
    print(sys.version)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:docstring_checker\:.py>.
.SS missing\-module\-docstring / C0114
.sp
\fBپیام صادرشده:\fP
.sp
\fBنبود docstring ماژول\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک ماژول فاقد docstring باشد. ماژول‌های خالی نیازی به docstring ندارند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import sys  # [missing\-module\-docstring]


def print_python_version():
    print(sys.version)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dq\(dq\(dqModule providing a function printing python version.\(dq\(dq\(dq

import sys


def print_python_version():
    print(sys.version)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:docstring_checker\:.py>..SS mixed\-line\-endings / C0327
.sp
\fBپیام صادرشده:\fP
.sp
\fBپایان خط‌های ترکیبی LF و CRLF\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که نشانه‌های پایان خط ترکیبی (LF و CRLF) در یک فایل وجود داشته باشند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqHello\(dq)  # CRLF (\er\en)
print(\(dqWorld\(dq)  # LF (\en) # [mixed\-line\-endings]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.sp
\fBfull_crlf.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqHello\(dq)  # CRLF (\er\en)
print(\(dqWorld\(dq)  # CRLF (\er\en)

.EE
.UNINDENT
.UNINDENT
.sp
\fBfull_lf.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqHello\(dq)  # LF (\en)
print(\(dqWorld\(dq)  # LF (\en)

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
تاریخچه CRLF و LF \%<https://\:stackoverflow\:.com/\:a/\:6521730/\:2519059>
.IP \(bu 2
مدیریت پایان خطوط در Git \%<https://\:stackoverflow\:.com/\:a/\:10855862/\:2519059>
.IP \(bu 2
مجموعه‌ای از الگوهای کاربردی .gitattributes \%<https://\:github\:.com/\:alexkaratarakis/\:gitattributes>
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده format \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:format\:.py>.
.SS multiple\-imports / C0410
.sp
\fBپیام صادرشده:\fP
.sp
\fBچندین import در یک خط (%s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که دستور import در حال وارد کردن چندین ماژول شناسایی شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import os, sys  # [multiple\-imports]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import os
import sys

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده imports \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:imports\:.py>..SS multiple\-statements / C0321
.sp
\fBپیام صادرشده:\fP
.sp
\fBبیش از یک دستور در یک سطر\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که بیش از یک دستور در یک سطر یکسان یافت شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruits = [\(dqapple\(dq, \(dqorange\(dq, \(dqmango\(dq]

if \(dqapple\(dq in fruits: pass  # [multiple\-statements]
else:
    print(\(dqno apples!\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruits = [\(dqapple\(dq, \(dqorange\(dq, \(dqmango\(dq]

if \(dqapple\(dq in fruits:
    pass
else:
    print(\(dqno apples!\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کنندهٔ format \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:format\:.py>.
.SS non\-ascii\-module\-import / C2403
.sp
\fBپیام صادرشده:\fP
.sp
\fBنام %s \(dq%s\(dq شامل یک نویسهٔ غیر ASCII است، برای import از یک نام مستعارِ فقط ASCII استفاده کنید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که نام حاوی حداقل یک نویسهٔ یونیکد غیر ASCII باشد. برای پیشینه‌ای دربارهٔ اینکه چرا این می‌تواند بد باشد، https://peps.python.org/pep\-0672/#confusing\-features را ببینید.
اگر شیوه‌نامهٔ برنامه‌نویسی شما مشخص کرده است که به زبان انگلیسی برنامه‌نویسی می‌کنید، پس نباید نیازی به نویسه‌های غیر ASCII در نام‌های Python باشد. در غیر این صورت، می‌توانید به سادگی این بررسی را غیرفعال کنید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from os.path import join as łos  # [non\-ascii\-module\-import]

foo = łos(\(dqa\(dq, \(dqb\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from os.path import join as os_join

foo = os_join(\(dqa\(dq, \(dqb\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کنندهٔ nonascii\-checker \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:non_ascii_names\:.py>..SS non\-ascii\-name / C2401
.sp
\fBپیام صادرشده:\fP
.sp
\fBنام %s \(dq%s\(dq حاوی یک نویسه غیر ASCII است، تغییر نام آن را در نظر بگیرید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که نام حاوی حداقل یک نویسه یونیکد غیر ASCII باشد. برای پیش‌زمینه‌ای در مورد چرایی نامناسب بودن این مورد، https://peps.python.org/pep\-0672/#confusing\-features را ببینید.
اگر شیوه‌نامه برنامه‌نویسی شما مشخص کرده که به زبان انگلیسی برنامه‌نویسی می‌کنید، دیگر نیازی به نویسه‌های غیر ASCII در نام‌های پایتون نخواهد بود. در غیر این صورت، می‌توانید به سادگی این بررسی را غیرفعال کنید.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ápple_count = 4444  # [non\-ascii\-name]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
apple_count = 4444

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده nonascii\-checker \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:non_ascii_names\:.py>.
.SS single\-string\-used\-for\-slots / C0205
.sp
\fBپیام صادرشده:\fP
.sp
\fBمقدار __slots__ کلاس باید یک شیء تکرارپذیر (غیر از رشته) باشد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که __slots__ کلاس به جای یک شیء تکرارپذیر، یک رشته ساده باشد.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:  # [single\-string\-used\-for\-slots]
    __slots__ = \(dqname\(dq

    def __init__(self, name):
        self.name = name

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    __slots__ = (\(dqname\(dq,)

    def __init__(self, name):
        self.name = name

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>.
.SS singleton\-comparison / C0121
.sp
\fBپیام صادرشده:\fP
.sp
\fBمقایسه %s باید %s باشد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک عبارت با مقادیر تکین (singleton) مانند True، False یا None مقایسه شود.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
game_won = True
if game_won == True:  # [singleton\-comparison]
    print(\(dqGame won !\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
game_won = True
if game_won:
    print(\(dqGame won !\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
PEP 285 – افزودن نوع داده bool \%<https://\:peps\:.python\:.org/\:pep-0285>
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:comparison_checker\:.py>..SS superfluous\-parens / C0325
.sp
\fBپیام صادرشده:\fP
.sp
\fBپرانتزهای غیرضروری پس از کلیدواژهٔ %r\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک عبارت منفرد درون پرانتز پس از if، for یا دیگر کلیدواژه‌ها قرار گیرد.\fP
.sp
\fBکد دارای مشکل:\fP
.sp
\fBexample_1.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
x = input()
y = input()
if (x == y):  # [superfluous\-parens]
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBexample_2.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
i = 0
exclude = []
if (i \- 0) in exclude:  # [superfluous\-parens]
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.sp
\fBexample_1.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
x = input()
y = input()
if x == y:
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBexample_2.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
i = 0
exclude = []
if i \- 0 in exclude:
    pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ format \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:format\:.py>.
.SS too\-many\-lines / C0302
.sp
\fBپیام صادرشده:\fP
.sp
\fBخطوط بیش از حد در ماژول (%s/%s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک ماژول خطوط بسیار زیادی داشته باشد و خوانایی آن کاهش یابد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def is_palindrome(string):  # [too\-many\-lines]
    left_pos = 0
    right_pos = len(string) \- 1
    while right_pos >= left_pos:
        if not string[left_pos] == string[right_pos]:
            return False
        left_pos += 1
        right_pos \-= 1
    return True


def main():
    print(is_palindrome(\(dqaza\(dq))
    print(is_palindrome(\(dqracecar\(dq))
    print(is_palindrome(\(dqtrigger\(dq))
    print(is_palindrome(\(dqogre\(dq))

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.sp
\fB__init__.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
__all__ = [\(dqis_palindrome\(dq, \(dqmain\(dq]

from is_palindrome import is_palindrome
from main import main

.EE
.UNINDENT
.UNINDENT
.sp
\fBis_palindrome.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def is_palindrome(string):
    return string == string[::\-1]

.EE
.UNINDENT
.UNINDENT
.sp
\fBmain.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from is_palindrome import is_palindrome


def main():
    for string in [\(dqaza\(dq, \(dqracecar\(dq, \(dqtrigger\(dq, \(dqogre\(dq]:
        print(is_palindrome(string))

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
max\-module\-lines=15

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
هنگامی که یک ماژول خطوط بسیار زیادی داشته باشد، خواندن و درک آن دشوار می‌شود. همچنین ممکن است هنگام ویرایش فایل به دلیل نیاز IDE به تجزیه و تحلیل کد بیشتر، افت کارایی رخ دهد. برای پیمایش مناسب در فایل نیز به مهارت بیشتری نیاز خواهید داشت (مانند رفتن به خطی خاص هنگام اشکال‌زدایی، یا جستجو برای یک ساختار کد مشخص، به‌جای پیمایش صرف با کلیک و اسکرول).
.sp
این معیار، جایگزینی تقریبی برای پیچیدگی چرخه‌ای (cyclomatic complexity) بالاتر است که اگر از \fBload\-plugins=pylint.extensions.mccabe,\fP\& استفاده نکنید، ممکن است آن را محاسبه نکرده باشید. محاسبهٔ پیچیدگی چرخه‌ای زمان‌برتر است، اما در عین حال معیاری دقیق‌تر و ریزدانه‌تر از SLOC خام محسوب می‌شود. به‌ویژه، در صورت استفاده از پیچیدگی چرخه‌ای، نمی‌توانید با ساختن یک کد تک‌خطی بسیار پیچیده خوانایی کد را پایین بیاورید.
.sp
مثال بالا کد را ساده‌سازی می‌کند، اما این کار همیشه ممکن نیست. در اغلب موارد، شکستن فایل و تقسیم آن از طریق ایجاد یک بسته (package) با همان رابط برنامه‌نویسی (API) تنها راه‌حل موجود است. پیش‌بینی این موضوع و ساختاردهی فایل‌ها از همان آغاز کار باعث می‌شود به همان نتیجهٔ نهایی برسید در حالی که تاریخچهٔ بهتری در سیستم کنترل نسخه خواهید داشت.
.sp
ایجادشده توسط بررسی‌کنندهٔ format \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:format\:.py>..SS trailing\-newlines / C0305
.sp
\fBپیام صادرشده:\fP
.sp
\fBخطوط جدید پایانی\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که خطوط خالی پایانی در یک فایل وجود داشته باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqapple\(dq)
# The file ends with 2 lines that are empty # +1: [trailing\-newlines]


.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqapple\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده format \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:format\:.py>.
.SS trailing\-whitespace / C0303
.sp
\fBپیام صادرشده:\fP
.sp
\fBفاصله‌های خالی پایانی\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که بین انتهای یک خط و نویسه‌ی خط جدید، فاصله‌ی خالی وجود داشته باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqHello\(dq)  # [trailing\-whitespace]   
#                                       ^^^ trailing whitespaces

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqHello\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده format \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:format\:.py>.
.SS typevar\-double\-variance / C0131
.sp
\fBپیام صادرشده:\fP
.sp
\fBTypeVar نمی‌تواند هم‌زمان هم covariant و هم contravariant باشد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی صادر می‌شود که هر دو آرگومان کلیدی \(dqcovariant\(dq و \(dqcontravariant\(dq در یک TypeVar روی \(dqTrue\(dq تنظیم شده باشند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import TypeVar

T = TypeVar(\(dqT\(dq, covariant=True, contravariant=True)  # [typevar\-double\-variance]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import TypeVar

T_co = TypeVar(\(dqT_co\(dq, covariant=True)
T_contra = TypeVar(\(dqT_contra\(dq, contravariant=True)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:name_checker/\:checker\:.py>..SS typevar\-name\-incorrect\-variance / C0105
.sp
\fBپیام صادرشده:\fP
.sp
\fBType variable name does not reflect variance%s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که نام یک TypeVar نشان‌دهنده واریانس نوع آن نباشد. طبق استاندارد PEP8، توصیه می‌شود پسوندهای \(aq_co\(aq و \(aq_contra\(aq به متغیرهایی اضافه شوند که به ترتیب برای اعلان رفتار هم‌وردا (covariant) یا پادوردا (contravariant) به کار می‌روند. متغیرهای ناوردا (invariant، پیش‌فرض) نیازی به پسوند ندارند. این پیام همچنین زمانی صادر می‌شود که متغیرهای ناوردا دارای پسوند باشند.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import TypeVar

T_co = TypeVar(\(dqT_co\(dq)  # [typevar\-name\-incorrect\-variance]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import TypeVar

T = TypeVar(\(dqT\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
هنگام نام‌گذاری متغیرهای نوع (type vars)، تنها زمانی از پسوند \fB_co\fP برای نشان دادن هم‌وردایی یا از \fB_contra\fP برای نشان دادن پادوردایی استفاده کنید.
.sp
ایجاد شده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:name_checker/\:checker\:.py>.
.SS typevar\-name\-mismatch / C0132
.sp
\fBپیام صادرشده:\fP
.sp
\fBTypeVar name \(dq%s\(dq does not match assigned variable name \(dq%s\(dq\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که یک TypeVar به متغیری انتساب داده شود که با آرگومان نام آن مطابقت ندارد.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import TypeVar

X = TypeVar(\(dqT\(dq)  # [typevar\-name\-mismatch]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import TypeVar

T = TypeVar(\(dqT\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:name_checker/\:checker\:.py>.
.SS unexpected\-line\-ending\-format / C0328
.sp
\fBپیام صادرشده:\fP
.sp
\fBUnexpected line ending format. There is \(aq%s\(aq while it should be \(aq%s\(aq.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که نویسه خط جدید متفاوتی با آنچه انتظار می‌رود وجود داشته باشد.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqI\(aqm drinking tea!\(dq)  # CRLF (\er\en) # [unexpected\-line\-ending\-format]
print(\(dqI\(aqm drinking water!\(dq)  # CRLF (\er\en) # [unexpected\-line\-ending\-format]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dqI\(aqm drinking tea!\(dq)  # LF (\en)
print(\(dqI\(aqm drinking water!\(dq)  # LF (\en)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[FORMAT]
expected\-line\-ending\-format=LF

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
تاریخچه CRLF و LF \%<https://\:stackoverflow\:.com/\:a/\:6521730/\:2519059>
.IP \(bu 2
مدیریت پایان خطوط در Git \%<https://\:stackoverflow\:.com/\:a/\:10855862/\:2519059>
.IP \(bu 2
مجموعه‌ای از الگوهای کاربردی .gitattributes \%<https://\:github\:.com/\:alexkaratarakis/\:gitattributes>
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده format \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:format\:.py>..SS ungrouped\-imports / C0412
.sp
\fBپیام صادرشده:\fP
.sp
\fBوارد کردن‌ها از بسته‌ی %s گروه‌بندی نشده‌اند\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که وارد کردن‌ها بر اساس بسته‌ها گروه‌بندی نشده باشند.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import logging
import os
import sys
import logging.config  # [ungrouped\-imports]
from logging.handlers import WatchedFileHandler

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import logging
import logging.config
import os
import sys
from logging.handlers import FileHandler

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده‌ی imports \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:imports\:.py>.
.SS unnecessary\-direct\-lambda\-call / C3002
.sp
\fBپیام صادرشده:\fP
.sp
\fBعبارت لامبدا مستقیماً فراخوانی شده است. در عوض عبارت را به‌صورت درون‌خطی اجرا کنید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک عبارت لامبدا به جای اجرای محتوای آن به‌صورت درون‌خطی، مستقیماً فراخوانی شود.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
y = (lambda x: x**2 + 2 * x + 1)(a)  # [unnecessary\-direct\-lambda\-call]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
y = a**2 + 2 * a + 1

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده‌ی lambda\-expressions \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:lambda_expressions\:.py>.
.SS unnecessary\-dunder\-call / C2801
.sp
\fBپیام صادرشده:\fP
.sp
\fBمتد داندر %s به‌طور غیرضروری فراخوانی شده است. %s.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک متد داندر به‌صورت دستی و به جای تابع/متد/عملگر متناظر فراخوانی شده باشد.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
three = (3.0).__str__()  # [unnecessary\-dunder\-call]
twelve = \(dq1\(dq.__add__(\(dq2\(dq)  # [unnecessary\-dunder\-call]


def is_bigger_than_two(x):
    return x.__gt__(2)  # [unnecessary\-dunder\-call]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
three = str(3.0)
twelve = \(dq1\(dq + \(dq2\(dq


def is_bigger_than_two(x):
    return x > 2

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
متدهای داندر را تعریف کنید اما آن‌ها را مستقیماً فراخوانی نکنید \%<https://\:www\:.pythonmorsels\:.com/\:avoid-dunder-methods>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده‌ی unnecessary\-dunder\-call \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:dunder_methods\:.py>..SS unnecessary\-lambda\-assignment / C3001
.sp
\fBپیام صادرشده:\fP
.sp
\fBعبارت لاندا به یک متغیر نسبت داده شده است. به‌جای آن یک تابع با استفاده از کلیدواژه \(dqdef\(dq تعریف کنید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک عبارت لاندا به‌جای تعریف یک تابع استاندارد با کلیدواژه \(dqdef\(dq، به یک متغیر نسبت داده شود.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
foo = lambda x: x**2 + 2 * x + 1  # [unnecessary\-lambda\-assignment]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def foo(x):
    return x**2 + 2 * x + 1

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده lambda\-expressions \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:lambda_expressions\:.py>.
.SS unnecessary\-negation / C0117
.sp
\fBپیام صادرشده:\fP
.sp
\fBتغییر دادن \(dq%s\(dq به \(dq%s\(dq را در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک عبارت بولی شامل یک نقیض غیرضروری باشد؛ برای نمونه هنگامی که دو عملگر نقیض اثر یکدیگر را خنثی می‌کنند.\fP
.sp
\fBکد دارای اشکال:\fP
.sp
\fBdouble_not.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
if not not input():  # [unnecessary\-negation]
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBequivalent_comparator_exists.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
a = 3
b = 10
if not a > b:  # [unnecessary\-negation]
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.sp
\fBdouble_not.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
if input():
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBequivalent_comparator_exists.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
a = 3
b = 10
if a <= b:
    pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:not_checker\:.py>..SS use\-implicit\-booleaness\-not\-comparison / C1803
.sp
\fBپیام صادرشده:\fP
.sp
\fB\(dq%s\(dq می‌تواند به \(dq%s\(dq ساده‌سازی شود، در صورتی که دقیقاً یک دنباله باشد، زیرا یک %s خالی فالس‌گونه (falsey) است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIدنباله‌های خالی در یک زمینهٔ بولی (boolean context) نادرست (false) در نظر گرفته می‌شوند. پیروی کورکورانه از این بررسی در پایگاه‌های کدی با نوع‌بندی ضعیف (weakly typed)، می‌تواند اشکالاتی ایجاد کند که عیب‌یابی آن‌ها دشوار است. اگر مقدار بتواند چیز دیگری باشد که فالس‌گونه (falsey) است اما دنباله نیست (برای مثال \(ga\(gaNone\(ga\(ga، یک رشتهٔ خالی، یا \(ga\(ga0\(ga\(ga)، کد معادل نخواهد بود.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
z = []

if z != []:  # [use\-implicit\-booleaness\-not\-comparison]
    print(\(dqz is not an empty sequence\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
z = []

if z:
    print(\(dqz is not an empty sequence\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بازبین refactoring در \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:implicit_booleaness_checker\:.py>.
.SS use\-implicit\-booleaness\-not\-comparison\-to\-string / C1804
.sp
\fBپیام صادرشده:\fP
.sp
\fB\(dq%s\(dq می‌تواند به \(dq%s\(dq ساده‌سازی شود، در صورتی که دقیقاً یک رشته باشد، زیرا یک رشتهٔ خالی فالس‌گونه (falsey) است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIرشته‌های خالی در یک زمینهٔ بولی (boolean context) نادرست (false) در نظر گرفته می‌شوند. پیروی کورکورانه از این بررسی در پایگاه‌های کدی با نوع‌بندی ضعیف (weakly typed)، می‌تواند اشکالاتی ایجاد کند که عیب‌یابی آن‌ها دشوار است. اگر مقدار بتواند چیز دیگری باشد که فالس‌گونه (falsey) است اما رشته نیست (برای مثال \(ga\(gaNone\(ga\(ga، یک دنبالهٔ خالی، یا \(ga\(ga0\(ga\(ga)، کد معادل نخواهد بود.\fP
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
این پیام به‌طور پیش‌فرض غیرفعال است. برای فعال‌کردن آن، \fBuse\-implicit\-booleaness\-not\-comparison\-to\-string\fP را به گزینهٔ \fBenable\fP بیفزایید.
.UNINDENT
.UNINDENT
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def important_string_manipulation(x: str, y: str) \-> None:
    if x == \(dq\(dq:  # [use\-implicit\-booleaness\-not\-comparison\-to\-string]
        print(\(dqx is an empty string\(dq)

    if y != \(dq\(dq:  # [use\-implicit\-booleaness\-not\-comparison\-to\-string]
        print(\(dqy is not an empty string\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def important_string_manipulation(x: str, y: str) \-> None:
    if not x:
        print(\(dqx is an empty string\(dq)

    if y:
        print(\(dqy is not an empty string\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
enable=use\-implicit\-booleaness\-not\-comparison\-to\-string

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بازبین refactoring در \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:implicit_booleaness_checker\:.py>..SS use\-implicit\-booleaness\-not\-comparison\-to\-zero / C1805
.sp
\fBپیام صادرشده:\fP
.sp
\fBاگر مقدار دقیقاً از نوع int باشد، عبارت \(dq%s\(dq می‌تواند به \(dq%s\(dq ساده‌سازی شود، زیرا 0 مقداری کاذب (falsey) است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIدر یک بافت بولی (boolean context)، مقدار 0 نادرست (false) در نظر گرفته می‌شود. پیروی کورکورانه از این بررسی در پایگاه‌های کدی با نوع‌بندی ضعیف (weakly typed)، می‌تواند اشکالاتی ایجاد کند که اشکال‌زدایی آن‌ها دشوار است. اگر مقدار متغیر بتواند چیزی غیر از int اما همچنان کاذب باشد (برای نمونه \(ga\(gaNone\(ga\(ga، یک رشته خالی، یا یک توالی خالی)، کد معادل نخواهد بود.\fP
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
این پیام به‌طور پیش‌فرض غیرفعال است. برای فعال‌سازی آن، \fBuse\-implicit\-booleaness\-not\-comparison\-to\-zero\fP را به گزینهٔ \fBenable\fP اضافه کنید.
.UNINDENT
.UNINDENT
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def important_math(x: int, y: int) \-> None:
    if x == 0:  # [use\-implicit\-booleaness\-not\-comparison\-to\-zero]
        print(\(dqx is equal to zero\(dq)

    if y != 0:  # [use\-implicit\-booleaness\-not\-comparison\-to\-zero]
        print(\(dqy is not equal to zero\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def important_math(x: int, y: int) \-> None:
    if not x:
        print(\(dqx is equal to zero\(dq)

    if y:
        print(\(dqy is not equal to zero\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
enable=use\-implicit\-booleaness\-not\-comparison\-to\-zero

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کنندهٔ بازسازی (refactoring) \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:implicit_booleaness_checker\:.py>.
.SS use\-implicit\-booleaness\-not\-len / C1802
.sp
\fBپیام صادرشده:\fP
.sp
\fBبرای تعیین خالی بودن یک توالی، از \(galen(SEQUENCE)\(ga بدون مقایسه استفاده نکنید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIتوالی‌های خالی در بافت بولی نادرست (false) در نظر گرفته می‌شوند. می‌توانید فراخوانی \(aqlen\(aq را حذف کنید (\(ga\(gaif not x\(ga\(ga) یا طول را با یک مقدار اسکالر مقایسه نمایید (\(ga\(gaif len(x) > 1\(ga\(ga).\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruits = [\(dqorange\(dq, \(dqapple\(dq]

if len(fruits):  # [use\-implicit\-booleaness\-not\-len]
    print(fruits)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruits = [\(dqorange\(dq, \(dqapple\(dq]

if fruits:
    print(fruits)

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کنندهٔ بازسازی (refactoring) \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:implicit_booleaness_checker\:.py>..SS use\-maxsplit\-arg / C0207
.sp
\fBپیام صادرشده:\fP
.sp
\fBبه جای آن از %s استفاده کنید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که تنها به اولین یا آخرین عنصر ()str.split دسترسی پیدا شود. دسترسی به اولین و آخرین عنصر می‌تواند در عوض با استفاده از [0]str.split(sep, maxsplit=1) یا [\-1]str.rsplit(sep, maxsplit=1) انجام گیرد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
url = \(dqwww.example.com\(dq
suffix = url.split(\(dq.\(dq)[\-1]  # [use\-maxsplit\-arg]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
url = \(dqwww.example.com\(dq
suffix = url.rsplit(\(dq.\(dq, maxsplit=1)[\-1]

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
توجه داشته باشید که بهبود کارایی حاصل از عدم تقسیم چندباره رشته، تنها در مواردی حاصل می‌شود که تعداد موارد نویسه جداکننده، بیشتر از این مثال کمینه باشد.
.sp
ایجاد شده توسط بازبین refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:recommendation_checker\:.py>.
.SS use\-sequence\-for\-iteration / C0208
.sp
\fBپیام صادرشده:\fP
.sp
\fBهنگام پیمایش روی مقادیر از یک نوع دنباله استفاده کنید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگام پیمایش روی مقادیر، انواع دنباله (مانند \(ga\(galists\(ga\(ga، \(ga\(gatuples\(ga\(ga، \(ga\(garanges\(ga\(ga) کارآمدتر از \(ga\(gasets\(ga\(ga هستند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
for food in {\(dqapples\(dq, \(dqlemons\(dq, \(dqwater\(dq}:  # [use\-sequence\-for\-iteration]
    print(f\(dqI like {food}.\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.sp
\fBlist.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
for food in [\(dqapples\(dq, \(dqlemons\(dq, \(dqwater\(dq]:
    print(f\(dqI like {food}.\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBtuple.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
for food in (\(dqapples\(dq, \(dqlemons\(dq, \(dqwater\(dq):
    print(f\(dqI like {food}.\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
\%<https://\:gist\:.github\:.com/\:hofrob/\:8b1c1e205a0d4c66a680b1fe4bfeba11>
.sp
این اسکریپت نمونه، افزایش چشمگیر کارایی را هنگام استفاده از list، tuple یا range به جای set در پایتون نسخه 3.11.1 نشان می‌دهد.
.sp
ایجاد شده توسط بازبین refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:recommendation_checker\:.py>..SS useless\-import\-alias / C0414
.sp
\fBپیام صادرشده:\fP
.sp
\fBنام مستعار واردسازی، بسته اصلی را تغییر نام نمی‌دهد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که نام مستعار واردسازی با بسته اصلی یکسان باشد؛ مانند استفاده از import numpy as numpy به جای import numpy as np.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import pandas as pandas  # [useless\-import\-alias]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import pandas as pd

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.SS مشکل شناخته‌شده
.sp
اگر ترجیح می‌دهید برای بازصادر کردن صریح در API به جای استفاده از \fB__all__\fP از \(dqfrom\-as\(dq (\fBfrom fruit import orange as orange\fP) استفاده کنید، این پیام یک مثبت کاذب (false positive) خواهد بود.
.sp
از \fB\-\-allow\-reexport\-from\-package\fP برای مجاز کردن بازصادر کردن‌های صریح با نام مستعار در فایل‌های \fB__init__\fP بسته استفاده کنید.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
\-\-allow\-reexport\-from\-package \%<#\:imports-options>
.IP \(bu 2
راهنمای واردسازی PEP 8 \%<https://\:peps\:.python\:.org/\:pep-0008/#\:imports>
.IP \(bu 2
Pylint block\-disable \%<#\:block-disables>
.IP \(bu 2
mypy \-\-no\-implicit\-reexport \%<https://\:mypy\:.readthedocs\:.io/\:en/\:stable/\:command_line\:.html#\:cmdoption-mypy-no-implicit-reexport>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده imports \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:imports\:.py>.
.SS wrong\-import\-order / C0411
.sp
\fBپیام صادرشده:\fP
.sp
\fB%s باید پیش از %s قرار گیرد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که ترتیب واردسازی PEP8 رعایت نشده باشد (ابتدا واردسازی‌های استاندارد، سپس کتابخانه‌های شخص ثالث و در نهایت واردسازی‌های محلی).\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import os
from . import utils
import pylint  # [wrong\-import\-order]
import sys  # [wrong\-import\-order]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import os
import sys

import pylint

from . import utils

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده imports \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:imports\:.py>..SS wrong\-import\-position / C0413
.sp
\fBپیام صادرشده:\fP
.sp
\fBواردسازی \(dq%s\(dq باید در ابتدای ماژول قرار گیرد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که کد و دستورهای واردسازی (import) با یکدیگر آمیخته شده باشند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import os

home = os.environ[\(dqHOME\(dq]

import sys  # [wrong\-import\-position]

print(f\(dqHome directory is {home}\(dq, file=sys.stderr)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import os
import sys

home = os.environ[\(dqHOME\(dq]
print(f\(dqHome directory is {home}\(dq, file=sys.stderr)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ imports \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:imports\:.py>.
.SS wrong\-spelling\-in\-comment / C0401
.sp
\fBپیام صادرشده:\fP
.sp
\fBاملای نادرست واژهٔ \(aq%s\(aq در یک کامنت:
%s
%s
آیا منظور شما: \(aq%s\(aq بود؟\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که املای واژه‌ای در کامنت نادرست باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# There\(aqs a mistkae in this string  # [wrong\-spelling\-in\-comment]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# There\(aqs no mistake in this string

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
# This might not run in your env if you don\(aqt have the en_US dict installed.
spelling\-dict=en_US

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ spelling \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:spelling\:.py>..SS wrong\-spelling\-in\-docstring / C0402
.sp
\fBپیام صادرشده:\fP
.sp
\fBاملای نادرست واژه \(aq%s\(aq در docstring:
%s
%s
آیا منظور شما \(aq%s\(aq بود؟\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که املای یک واژه در docstring نادرست باشد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dq\(dq\(dqThere\(aqs a mistkae in this string\(dq\(dq\(dq  # [wrong\-spelling\-in\-docstring]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dq\(dq\(dqThere\(aqs no mistake in this string\(dq\(dq\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
# This might not run in your env if you don\(aqt have the en_US dict installed.
spelling\-dict=en_US

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده spelling \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:spelling\:.py>.
.sp
تمام پیام‌های تغییرنام‌یافته در دسته‌بندی convention:
.SS blacklisted\-name / C0102
.sp
\(aqblacklisted\-name\(aq تغییر نام یافته است. پیام جدید را می‌توان در اینجا یافت:
.SS compare\-to\-empty\-string / C1901
.sp
\(aqcompare\-to\-empty\-string\(aq تغییر نام یافته است. پیام جدید را می‌توان در اینجا یافت:
.SS compare\-to\-zero / C2001
.sp
\(aqcompare\-to\-zero\(aq تغییر نام یافته است. پیام جدید را می‌توان در اینجا یافت:
.SS len\-as\-condition / C1801
.sp
\(aqlen\-as\-condition\(aq تغییر نام یافته است. پیام جدید را می‌توان در اینجا یافت:
.SS missing\-docstring / C0111
.sp
\(aqmissing\-docstring\(aq تغییر نام یافته است. پیام جدید را می‌توان در اینجا یافت:
.SS old\-misplaced\-comparison\-constant / C0122
.sp
\(aqold\-misplaced\-comparison\-constant\(aq تغییر نام یافته است. پیام جدید را می‌توان در اینجا یافت:
.SS old\-non\-ascii\-name / C0144
.sp
\(aqold\-non\-ascii\-name\(aq تغییر نام یافته است. پیام جدید را می‌توان در اینجا یافت:
.SS unneeded\-not / C0113
.sp
\(aqunneeded\-not\(aq تغییر نام یافته است. پیام جدید را می‌توان در اینجا یافت:
.SS بازآرایی (Refactor)
.sp
تمام پیام‌های دسته‌بندی بازآرایی (refactor):
.SS chained\-comparison / R1716
.sp
\fBپیام صادرشده:\fP
.sp
\fBساده‌سازی مقایسه زنجیره‌ای میان عملوندها\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاین پیام زمانی صادر می‌شود که pylint با عملیاتی بولی مانند \(dqa < b and b < c\(dq مواجه شود و پیشنهاد می‌دهد که در عوض آن را به \(dqa < b < c\(dq بازآرایی کنید.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
a = int(input())
b = int(input())
c = int(input())
if a < b and b < c:  # [chained\-comparison]
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
a = int(input())
b = int(input())
c = int(input())
if a < b < c:
    pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>..SS comparison\-of\-constants / R0133
.sp
\fBپیام صادرشده:\fP
.sp
\fBمقایسه بین مقادیر ثابت: \(dq%s %s %s\(dq دارای یک مقدار ثابت است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی که دو لیترال با یکدیگر مقایسه می‌شوند، نتیجه یک مقدار ثابت است. استفادهٔ مستقیم از مقدار ثابت، هم خواناتر است و هم کارایی بالاتری دارد. مقداردهی اولیهٔ \(aqTrue\(aq و \(aqFalse\(aq به این شیوه، از Python 2.3 به بعد دیگر لازم نیست.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def is_the_answer() \-> bool:
    return 42 == 42  # [comparison\-of\-constants]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def is_the_answer(meaning_of_life: int) \-> bool:
    return meaning_of_life == 42

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:comparison_checker\:.py>.
.SS comparison\-with\-itself / R0124
.sp
\fBپیام صادرشده:\fP
.sp
\fBمقایسهٔ زائد \- %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که چیزی با خودش مقایسه شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def is_an_orange(fruit):
    an_orange = \(dqorange\(dq
    return fruit == fruit  # [comparison\-with\-itself]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def is_an_orange(fruit):
    an_orange = \(dqorange\(dq
    return an_orange == fruit

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:comparison_checker\:.py>.
.SS condition\-evals\-to\-constant / R1727
.sp
\fBپیام صادرشده:\fP
.sp
\fBشرط بولی \(aq%s\(aq همواره به \(aq%s\(aq ارزیابی خواهد شد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی صادر می‌شود که بتوان یک شرط بولی را به یک مقدار ثابت ساده کرد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def is_a_fruit(fruit):
    return bool(fruit in {\(dqapple\(dq, \(dqorange\(dq} or True)  # [condition\-evals\-to\-constant]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def is_a_fruit(fruit):
    return fruit in {\(dqapple\(dq, \(dqorange\(dq}

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>..SS confusing\-consecutive\-elif / R5601
.sp
\fBپیام صادرشده:\fP
.sp
\fBelif متوالی با سطح تورفتگی متفاوت؛ برای جداسازی elif درونی، ایجاد یک تابع را در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک عبارت elif بلافاصله پس از یک بلوک دارای تورفتگی قرار می‌گیرد که خود با if یا elif پایان یافته است. ممکن است مشخص نباشد که آیا کاهش تورفتگی عبارت elif عمداً انجام شده یا بر اثر اشتباه بوده است. استخراج عبارت if دارای تورفتگی در یک تابع جداگانه می‌تواند از سردرگمی جلوگیری کرده و مانع از بروز خطا شود.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def myfunc(shall_continue: bool, shall_exit: bool):
    if shall_continue:
        if input(\(dqAre you sure?\(dq) == \(dqy\(dq:
            print(\(dqMoving on.\(dq)
    elif shall_exit:  # [confusing\-consecutive\-elif]
        print(\(dqExiting.\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# Option 1: add explicit \(aqelse\(aq
def myfunc(shall_continue: bool, shall_exit: bool):
    if shall_continue:
        if input(\(dqAre you sure?\(dq) == \(dqy\(dq:
            print(\(dqMoving on.\(dq)
        else:
            pass
    elif shall_exit:
        print(\(dqExiting.\(dq)


# Option 2: extract function
def user_confirmation():
    if input(\(dqAre you sure?\(dq) == \(dqy\(dq:
        print(\(dqMoving on.\(dq)


def myfunc2(shall_continue: bool, shall_exit: bool):
    if shall_continue:
        user_confirmation()
    elif shall_exit:
        print(\(dqExiting.\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins=pylint.extensions.confusing_elif

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
ایجاد یک تابع برای عبارت شرطی تودرتو، یا افزودن یک \fBelse\fP صریح در عبارت \fBif\fP دارای تورفتگی، حتی اگر تنها شامل یک دستور \fBpass\fP باشد، می‌تواند به خوانایی و شفافیت کد کمک کند.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بازبین اختیاری \(aqconfusing_elif\(aq \%<#\:pylint-extensions-confusing-elif> صادر می‌شود که نیازمند بارگذاری افزونهٔ \fBpylint.extensions.confusing_elif\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بازبین confusing_elif \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:confusing_elif\:.py>..SS consider\-alternative\-union\-syntax / R6003
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از نحو جایگزین union به جای \(aq%s\(aq%s را در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که \(ga\(gatyping.Union\(ga\(ga یا \(ga\(gatyping.Optional\(ga\(ga به جای نحو کوتاه union استفاده شود. برای مثال، \(ga\(gaUnion[int, float]\(ga\(ga به جای \(ga\(gaint | float\(ga\(ga. استفاده از نحو کوتاه برای union با توصیه‌های نوع‌گذاری (typing) پایتون هم‌خوانی دارد، نیاز به importها را برطرف می‌کند و از سردرگمی در امضای توابع جلوگیری می‌نماید.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import Optional, Union


def forecast(
    temp: Union[int, float],  # [consider\-alternative\-union\-syntax]
    unit: Optional[str],  # [consider\-alternative\-union\-syntax]
) \-> None:
    print(f\(aqTemperature: {temp}{unit or \(dq\(dq}\(aq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def forecast(temp: int | float, unit: str | None) \-> None:
    print(f\(aqTemperature: {temp}{unit or \(dq\(dq}\(aq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins = pylint.extensions.typing

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
استفاده از نحو کوتاه برای انواع union نسبت به ماژول \fBtyping\fP توصیه می‌شود \%<https://\:docs\:.python\:.org/\:3/\:library/\:typing\:.html#\:typing\:.Union>\&. این موضوع با توصیهٔ گسترده‌تر مبنی بر ترجیح انواع توکار (built\-in) نسبت به importها هم‌خوانی دارد (به عنوان مثال، استفاده از \fBlist\fP به جای \fBtyping.List\fP که اکنون منسوخ شده است).
.sp
همچنین \fBtyping.Optional\fP می‌تواند در آرگومان‌های نشانه‌گذاری‌شدهٔ توابع باعث سردرگمی شود، زیرا آرگومانی که به عنوان \fBOptional\fP نشانه‌گذاری شده، در صورتی که مقدار پیش‌فرضی برای آن تعیین نشده باشد همچنان یک آرگومان \fIاجباری\fP (required) است. نشانه‌گذاری صریح چنین آرگومان‌هایی با \fBtype | None\fP قصد و نیت کد را کاملاً شفاف می‌سازد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کنندهٔ اختیاری \(aqtyping\(aq \%<#\:pylint-extensions-typing> صادر می‌شود که نیازمند بارگذاری افزونهٔ \fBpylint.extensions.typing\fP است.
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کنندهٔ typing \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:typing\:.py>.
.SS consider\-math\-not\-float / R6106
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از %smath.%s به جای %s را در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاستفاده از math.inf یا math.nan امکان بهره‌مندی از سیستم نوع‌گذاری (typing) را فراهم می‌کند و تا ۴ برابر سریع‌تر از فراخوانی float است (پس از import اولیهٔ math). این بررسی همچنین به عنوان یک اثر جانبی، غلط‌های املایی در فراخوانی‌های float را شناسایی می‌کند.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
swag = float(\(dqinf\(dq)  # [consider\-math\-not\-float]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import math

swag = math.inf

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins=pylint.extensions.code_style

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
این یک بررسی افزونه‌ای (extension check) است زیرا مزیت نوع‌گذاری (typing) ممکن است برطرف شود.
.sp
از لحاظ کارایی، float(\(dqnan\(dq) و float(\(dqinf\(dq) پس از import اولیهٔ math، به ضریب ۴ برابر کندتر از همتایان خود یعنی math.inf و math.nan هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import math
import timeit

time_math_inf = timeit.timeit(\(aqmath.nan\(aq, globals=globals(), number=10**8)
print(f\(aqmath.nan: {time_math_inf:.2f} seconds\(aq)

import timeit
time_inf_str = timeit.timeit(\(aqfloat(\(dqnan\(dq)\(aq, number=10**8)
print(f\(aqfloat(\(dqnan\(dq): {time_inf_str:.2f} seconds\(aq)
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
math.nan: 1.24 seconds
float(\(dqnan\(dq): 5.15 seconds
.EE
.UNINDENT
.UNINDENT
.sp
اما اگر import اولیه را به حساب آوریم، وضعیت بدتر است.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import timeit

time_math_inf = timeit.timeit(\(aqimport math;math.nan\(aq, globals=globals(), number=10**8)
print(f\(aqmath.nan: {time_math_inf:.2f} seconds\(aq)

import timeit
time_inf_str = timeit.timeit(\(aqfloat(\(dqnan\(dq)\(aq, number=10**8)
print(f\(aqfloat(\(dqnan\(dq): {time_inf_str:.2f} seconds\(aq)
.EE
.UNINDENT
.UNINDENT
.sp
نتیجه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
math.nan: 9.08 seconds
float(\(dqnan\(dq): 5.33 seconds
.EE
.UNINDENT
.UNINDENT
.sp
بنابراین تصمیم‌گیری به این بستگی دارد که چگونه و با چه بسامدی نیاز به استفاده از آن دارید و چه چیزی برای شما اهمیت دارد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کنندهٔ اختیاری \(aqcode_style\(aq \%<#\:pylint-extensions-code-style> صادر می‌شود که نیازمند بارگذاری افزونهٔ \fBpylint.extensions.code_style\fP است.
.UNINDENT
.UNINDENT.sp
ایجادشده توسط بررسی‌کننده code_style \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:code_style\:.py>.
.SS consider\-merging\-isinstance / R1701
.sp
\fBپیام صادرشده:\fP
.sp
\fBادغام این فراخوانی‌های isinstance در isinstance(%s, (%s)) را در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که بتوان چندین فراخوانی متوالی isinstance را در یکی ادغام کرد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import Any


def is_number(value: Any) \-> bool:
    # +1: [consider\-merging\-isinstance]
    return isinstance(value, int) or isinstance(value, float)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import Any


def is_number(value: Any) \-> bool:
    return isinstance(value, (int, float))

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>.
.SS consider\-refactoring\-into\-while\-condition / R3501
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از \(aqwhile %s\(aq را به جای \(aqwhile %s:\(aq، یک \(aqif\(aq و یک \(aqbreak\(aq در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که یک حلقه \(gawhile True:\(ga استفاده شده باشد و نخستین دستور یک شرط break باشد. اگر شرط معکوس شده و به دستور \(ga\(gawhile\(ga\(ga منتقل شود، ساختار \(ga\(gaif / break\(ga\(ga می‌تواند حذف شود.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruit_basket = [\(dqapple\(dq, \(dqorange\(dq, \(dqbanana\(dq, \(dqcherry\(dq, \(dqguava\(dq]

while True:  # [consider\-refactoring\-into\-while\-condition]
    if len(fruit_basket) == 0:
        break
    fruit = fruit_basket.pop()
    print(f\(dqWe removed {fruit} from the basket\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruit_basket = [\(dqapple\(dq, \(dqorange\(dq, \(dqbanana\(dq, \(dqcherry\(dq, \(dqguava\(dq]

while len(fruit_basket) != 0:
    fruit = fruit_basket.pop()
    print(f\(dqWe removed {fruit} from the basket\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins=pylint.extensions.consider_refactoring_into_while_condition

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqconsider_refactoring_into_while\(aq \%<#\:pylint-extensions-consider-refactoring-into-while-condition>
صادر می‌شود که نیازمند بارگذاری افزونه \fBpylint.extensions.consider_refactoring_into_while_condition\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده consider_refactoring_into_while \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:consider_refactoring_into_while_condition\:.py>..SS consider\-swap\-variables / R1712
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از tuple unpacking را برای جابه‌جایی متغیرها در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIبرای جابه‌جا کردن متغیرها نیازی به استفاده از یک متغیر موقت ندارید. استفاده از \(dqtuple unpacking\(dq برای جابه‌جایی مستقیم متغیرها، هدف را واضح‌تر می‌کند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
a = 1
b = 2

temp = a  # [consider\-swap\-variables]
a = b
b = temp

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
a = 1
b = 2

a, b = b, a

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>.
.SS consider\-using\-alias / R6002
.sp
\fBپیام صادرشده:\fP
.sp
\fB\(aq%s\(aq در PY39 منسوخ خواهد شد، استفاده از \(aq%s\(aq را به‌جای آن در نظر بگیرید%s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIتنها در صورتی صادر می‌شود که \(aqruntime\-typing=no\(aq باشد و یک alias منسوخ‌شدهٔ typing در بستر type annotation در Python 3.7 یا 3.8 استفاده شده باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import typing

cats: typing.Dict[str, int]  # [consider\-using\-alias]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import typing

cats: typing.cast(dict[str, int], \(dqstring\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
load\-plugins = pylint.extensions.typing
py\-version = 3.7
runtime\-typing=no

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqtyping\(aq \%<#\:pylint-extensions-typing>
صادر می‌شود که نیازمند بارگذاری افزونه \fBpylint.extensions.typing\fP است.
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده typing \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:typing\:.py>..SS consider\-using\-assignment\-expr / R6103
.sp
\fBپیام صادرشده:\fP
.sp
\fBبه جای آن از \(aq%s\(aq استفاده کنید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که یک انتساب بلافاصله پیش از یک دستور if قرار گیرد و هر دو بتوانند با استفاده از یک عبارت انتساب \(ga\(ga:=\(ga\(ga با یکدیگر ترکیب شوند. نیازمند Python 3.8 و \(ga\(gapy\-version >= 3.8\(ga\(ga است.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
apples = 2

if apples:  # [consider\-using\-assignment\-expr]
    print(\(dqGod apples!\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
if apples := 2:
    print(\(dqGod apples!\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
py\-version=3.8
load\-plugins=pylint.extensions.code_style

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بازبین اختیاری \(aqcode_style\(aq \%<#\:pylint-extensions-code-style> صادر می‌شود، که نیازمند بارگذاری افزونه \fBpylint.extensions.code_style\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بازبین code_style \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:code_style\:.py>.
.SS consider\-using\-augmented\-assign / R6104
.sp
\fBپیام صادرشده:\fP
.sp
\fBبرای انجام مستقیم یک انتساب افزوده از \(aq%s\(aq استفاده کنید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که یک انتساب به همان شیئی ارجاع می‌دهد که در حال انتساب مقدار به آن است. این مورد می‌تواند به یک انتساب افزوده تبدیل شود. به‌طور پیش‌فرض غیرفعال است!\fP
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
این پیام به‌طور پیش‌فرض غیرفعال است. برای فعال‌سازی آن، \fBconsider\-using\-augmented\-assign\fP را به گزینه \fBenable\fP بیفزایید.
.UNINDENT
.UNINDENT
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
x = 1
x = x + 1  # [consider\-using\-augmented\-assign]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
x = 1
x += 1

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins=pylint.extensions.code_style
enable=consider\-using\-augmented\-assign

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بازبین اختیاری \(aqcode_style\(aq \%<#\:pylint-extensions-code-style> صادر می‌شود، که نیازمند بارگذاری افزونه \fBpylint.extensions.code_style\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بازبین code_style \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:code_style\:.py>..SS consider\-using\-dict\-comprehension / R1717
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از یک dictionary comprehension را در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی صادر می‌شود که ساخت یک دیکشنری با استفاده از فراخوان‌پذیر dict() و یک لیست گذرا تشخیص داده شود. اگرچه این کد از نظر نحوی مشکلی ندارد، اما خوانایی پایینی دارد و می‌توان آن را به یک dict comprehension ساده‌تر تبدیل کرد. همچنین سریع‌تر است، زیرا نیازی به ایجاد یک لیست گذرای دیگر ندارید.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
NUMBERS = [1, 2, 3]

# +1: [consider\-using\-dict\-comprehension]
DOUBLED_NUMBERS = dict([(number, number * 2) for number in NUMBERS])

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
NUMBERS = [1, 2, 3]

DOUBLED_NUMBERS = {number: number * 2 for number in NUMBERS}

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
ابزار pyupgrade \%<https://\:github\:.com/\:asottile/\:pyupgrade> یا ruff \%<https://\:docs\:.astral\:.sh/\:ruff> می‌توانند این مورد را به‌طور خودکار رفع کنند.
.sp
ایجادشده توسط بررسی‌کنندهٔ refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>.
.SS consider\-using\-from\-import / R0402
.sp
\fBپیام صادرشده:\fP
.sp
\fBبه‌جای آن از \(aqfrom %s import %s\(aq استفاده کنید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی صادر می‌شود که یک زیرماژول از یک بسته وارد (import) شده و با همان نام، نام مستعار (alias) بگیرد؛ برای نمونه، به‌جای \(ga\(gaimport concurrent.futures as futures\(ga\(ga از \(ga\(gafrom concurrent import futures\(ga\(ga استفاده کنید.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import os.path as path  # [consider\-using\-from\-import]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from os import path

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ imports \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:imports\:.py>.
.SS consider\-using\-generator / R1728
.sp
\fBپیام صادرشده:\fP
.sp
\fBبه‌جای \(aq%s(%s)\(aq، استفاده از یک generator را در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاگر کانتینر شما می‌تواند بزرگ باشد، استفاده از یک generator کارایی بهتری به همراه خواهد داشت.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
list([0 for y in list(range(10))])  # [consider\-using\-generator]
tuple([0 for y in list(range(10))])  # [consider\-using\-generator]
sum([y**2 for y in list(range(10))])  # [consider\-using\-generator]
max([y**2 for y in list(range(10))])  # [consider\-using\-generator]
min([y**2 for y in list(range(10))])  # [consider\-using\-generator]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
list(0 for y in list(range(10)))
tuple(0 for y in list(range(10)))
sum(y**2 for y in list(range(10)))
max(y**2 for y in list(range(10)))
min(y**2 for y in list(range(10)))

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
حذف \fB[]\fP در داخل فراخوانی‌هایی که می‌توانند از کانتینرها یا مولدها (generators) استفاده کنند باید به دلایل کارایی مد نظر قرار گیرد، چرا که یک generator هزینهٔ اولیه‌ای خواهد داشت. اگر با لیست‌ها یا مجموعه‌های بزرگ کار می‌کنید، کارایی بهتر خواهد بود.
.sp
برای \fBmax\fP، \fBmin\fP و \fBsum\fP، استفاده از یک generator توسط pep289 نیز توصیه شده است.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
PEP 289 \%<https://\:peps\:.python\:.org/\:pep-0289>
.IP \(bu 2
بنچمارک و بحث پیرامون any/all/list/tuple \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:pull/\:3309#\:discussion_r576683109>
.IP \(bu 2
بنچمارک و بحث پیرامون sum/max/min \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:pull/\:6595#\:issuecomment-1125704244>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>..SS consider\-using\-get / R1715
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از dict.get را برای دریافت مقادیر از یک dict در صورت وجود کلید یا مقدار پیش‌فرض در غیر این صورت در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاستفاده از متد توکار dict.get برای دریافت یک مقدار از دیکشنری در صورت وجود کلید یا مقدار پیش‌فرض در صورت عدم وجود آن، ساده‌تر بوده و استانداردتر (idiomatic) در نظر گرفته می‌شود، اگرچه گاهی اوقات کمی کندتر است\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
knights = {\(dqGallahad\(dq: \(dqthe pure\(dq, \(dqRobin\(dq: \(dqthe brave\(dq}

if \(dqGallahad\(dq in knights:  # [consider\-using\-get]
    DESCRIPTION = knights[\(dqGallahad\(dq]
else:
    DESCRIPTION = \(dq\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
knights = {\(dqGallahad\(dq: \(dqthe pure\(dq, \(dqRobin\(dq: \(dqthe brave\(dq}

description = knights.get(\(dqGallahad\(dq, \(dq\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده بازآفرینی (refactoring) \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>.
.SS consider\-using\-in / R1714
.sp
\fBپیام صادرشده:\fP
.sp
\fBادغام این مقایسه‌ها با \(aqin\(aq با استفاده از \(aq%s %sin (%s)\(aq را در نظر بگیرید. در صورتی که عناصر قابل درهم‌سازی (hashable) هستند، به‌جای آن از یک set استفاده کنید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIبرای بررسی اینکه آیا یک متغیر با یکی از چندین مقدار برابر است یا خیر، مقادیر را در یک set یا tuple ترکیب کرده و به‌جای بررسی برابری با تک‌تک مقادیر، بررسی کنید که آیا متغیر \(dqin\(dq آن قرار دارد یا خیر. این کار سریع‌تر بوده و پرگویی کمتری دارد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def fruit_is_round(fruit):
    # +1: [consider\-using\-in]
    return fruit == \(dqapple\(dq or fruit == \(dqorange\(dq or fruit == \(dqmelon\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def fruit_is_round(fruit):
    return fruit in {\(dqapple\(dq, \(dqorange\(dq, \(dqmelon\(dq}

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده بازآفرینی (refactoring) \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>.
.SS consider\-using\-join / R1713
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از str.join(sequence) را برای پیوند دادن رشته‌ها از یک شیء تکرارپذیر (iterable) در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاستفاده از str.join(sequence) در مقایسه با پیمایش با حلقه for، سریع‌تر است، حافظه کمتری مصرف می‌کند و خوانایی را افزایش می‌دهد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def fruits_to_string(fruits):
    formatted_fruit = \(dq\(dq
    for fruit in fruits:
        formatted_fruit += fruit  # [consider\-using\-join]
    return formatted_fruit


print(fruits_to_string([\(dqapple\(dq, \(dqpear\(dq, \(dqpeach\(dq]))

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(\(dq\(dq.join([\(dqapple\(dq, \(dqpear\(dq, \(dqpeach\(dq]))

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده بازآفرینی (refactoring) \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>..SS consider\-using\-max\-builtin / R1731
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از \(aq%s\(aq به جای بلوک if غیرضروری را در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاستفاده از تابع توکار max به جای عبارت شرطی، خوانایی و ایجاز کد را بهبود می‌بخشد.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def get_max(value1, value2):
    if value1 < value2:  # [consider\-using\-max\-builtin]
        value1 = value2
    return value1


print(get_max(1, 2))

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(max(1, 2))

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بازبین refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>.
.SS consider\-using\-min\-builtin / R1730
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از \(aq%s\(aq به جای بلوک if غیرضروری را در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاستفاده از تابع توکار min به جای عبارت شرطی، خوانایی و ایجاز کد را بهبود می‌بخشد.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def get_min(value1, value2):
    if value1 > value2:  # [consider\-using\-min\-builtin]
        value1 = value2
    return value1


print(get_min(1, 2))

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
print(min(1, 2))

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بازبین refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>.
.SS consider\-using\-namedtuple\-or\-dataclass / R6101
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از namedtuple یا dataclass را برای مقادیر دیکشنری در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی صادر می‌شود که بتوان مقادیر دیکشنری را با نمونه‌هایی از namedtuple یا dataclass جایگزین کرد.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
FELIDAES = {  # [consider\-using\-namedtuple\-or\-dataclass]
    \(dqThe queen\(aqs cymric, fragile furry friend\(dq: {
        \(dqtail_length_cm\(dq: 1,
        \(dqpaws\(dq: 4,
        \(dqeyes\(dq: 2,
        \(dqElizabethan collar\(dq: 1,
    },
    \(dqRackat the red, terror of the sea\(dq: {
        \(dqtail_length_cm\(dq: 13,
        \(dqpaws\(dq: 3,
        \(dqeyes\(dq: 1,
        \(dqRed Hat\(dq: 1,
    },
}

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import NamedTuple


class FelidaeCharacteristics(NamedTuple):
    tail_length_cm: int
    paws: int
    eyes: int
    hat: str | None


FELIDAES = {
    \(dqThe queen\(aqs cymric, fragile furry friend\(dq: FelidaeCharacteristics(
        tail_length_cm=1, paws=4, eyes=2, hat=\(dqElizabethan collar\(dq
    ),
    \(dqRackat the red, terror of the sea\(dq: FelidaeCharacteristics(
        tail_length_cm=21, paws=3, eyes=1, hat=\(dqRed Hat\(dq
    ),
}

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins=pylint.extensions.code_style

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بازبین اختیاری \(aqcode_style\(aq \%<#\:pylint-extensions-code-style>
صادر می‌شود، که نیازمند بارگذاری افزونه \fBpylint.extensions.code_style\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بازبین code_style \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:code_style\:.py>..SS consider\-using\-set\-comprehension / R1718
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از set comprehension را در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاگرچه این کد از نظر نحوی هیچ ایرادی ندارد، اما خوانایی پایینی دارد و می‌توان آن را به یک set comprehension ساده کرد. همچنین به دلیل عدم نیاز به ایجاد یک لیست موقت دیگر، سریع‌تر است.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
NUMBERS = [1, 2, 2, 3, 4, 4]

# +1: [consider\-using\-set\-comprehension]
UNIQUE_EVEN_NUMBERS = set([number for number in NUMBERS if number % 2 == 0])

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
NUMBERS = [1, 2, 2, 3, 4, 4]

UNIQUE_EVEN_NUMBERS = {number for number in NUMBERS if number % 2 == 0}

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
ابزارهای pyupgrade \%<https://\:github\:.com/\:asottile/\:pyupgrade> یا ruff \%<https://\:docs\:.astral\:.sh/\:ruff> می‌توانند این مورد را به‌صورت خودکار برطرف کنند.
.sp
ایجاد شده توسط بررسی‌کننده refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>.
.SS consider\-using\-sys\-exit / R1722
.sp
\fBپیام صادرشده:\fP
.sp
\fBبه‌جای آن استفاده از \(aqsys.exit\(aq را در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIبرخلاف \(aqexit()\(aq یا \(aqquit()\(aq، دستور \(aqsys.exit\(aq وابسته به در دسترس بودن ماژول site نیست (زیرا ماژول \(aqsys\(aq همواره در دسترس است).\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
if __name__ == \(dq__main__\(dq:
    user = input(\(dqEnter user name: \(dq)
    print(f\(dqHello, {user}\(dq)
    exit(0)  # [consider\-using\-sys\-exit]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import sys

if __name__ == \(dq__main__\(dq:
    user = input(\(dqEnter user name: \(dq)
    print(f\(dqHello, {user}\(dq)
    sys.exit(0)

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>..SS consider\-using\-ternary / R1706
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از عملگر سه‌تایی (%s) را در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یکی از نحوهای سه‌تایی شناخته‌شدهٔ پیش از Python 2.5 به کار رفته باشد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
x, y = 1, 2
maximum = x >= y and x or y  # [consider\-using\-ternary]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
x, y = 1, 2
maximum = x if x >= y else y

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>.
.SS consider\-using\-tuple / R6102
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از تاپل درجا به‌جای لیست را در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIصرفاً جهت یک‌دستی سبک نگارش! زمانی صادر می‌شود که یک \(ga\(galist\(ga\(ga تعریف‌شده به‌صورت درجا بتواند با یک \(ga\(gatuple\(ga\(ga جایگزین شود. به دلیل بهینه‌سازی‌های انجام‌شده توسط CPython، این کار هیچ بهبود عملکردی به همراه ندارد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
for i in [1, 2, 3]:  # [consider\-using\-tuple]
    print(i)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
for i in (1, 2, 3):
    print(i)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins=pylint.extensions.code_style

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کنندهٔ اختیاری \(aqcode_style\(aq \%<#\:pylint-extensions-code-style> صادر می‌شود که نیازمند بارگذاری افزونهٔ \fBpylint.extensions.code_style\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ code_style \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:code_style\:.py>..SS consider\-using\-with / R1732
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از \(aqwith\(aq را برای عملیات‌های تخصیص منابع در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که یک انتساب یا فراخوانی تخصیص‌دهندهٔ منابع بتواند با یک بلوک \(aqwith\(aq جایگزین شود. با استفاده از \(aqwith\(aq، آزادسازی منابع تخصیص‌یافته حتی در صورت بروز استثنا تضمین می‌شود.\fP
.sp
\fBکد دارای اشکال:\fP
.sp
\fBclose.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
file = open(\(dqapple.txt\(dq, \(dqr\(dq, encoding=\(dqutf8\(dq)  # [consider\-using\-with]
contents = file.read()
file.close()

.EE
.UNINDENT
.UNINDENT
.sp
\fBnot_even_close.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
contents = open(\(dqapple.txt\(dq, \(dqr\(dq, encoding=\(dqutf8\(dq).read()  # [consider\-using\-with]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
with open(\(dqapple.txt\(dq, \(dqr\(dq, encoding=\(dqutf8\(dq) as file:
    contents = file.read()

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
فراخوانی \fBwrite()\fP بدون استفاده از کلمهٔ کلیدی \fBwith\fP یا فراخوانی \fBclose()\fP ممکن است
باعث شود آرگومان‌های \fBwrite()\fP به‌طور کامل روی دیسک نوشته نشوند،
حتی اگر برنامه با موفقیت پایان یابد.
.sp
این پیام برای فراخوانی‌پذیرهای stdlib پایتون که می‌توانند با یک دستور \fBwith\fP جایگزین شوند، اعمال می‌شود.
در موارد زیر از صدور آن صرف‌نظر می‌شود:
.INDENT 0.0
.IP \(bu 2
فراخوانی درون یک مدیر زمینه (context manager) قرار داشته باشد
.IP \(bu 2
نتیجهٔ فراخوانی از تابع دربرگیرنده بازگردانده شود
.IP \(bu 2
نتیجهٔ فراخوانی خودش در یک دستور \fBwith\fP استفاده شود
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
مستندات پایتون: خواندن و نوشتن فایل‌ها \%<https://\:docs\:.python\:.org/\:3/\:tutorial/\:inputoutput\:.html#\:reading-and-writing-files>
.IP \(bu 2
PEP 343 \%<https://\:peps\:.python\:.org/\:pep-0343>
.IP \(bu 2
مدیرهای زمینه در پایتون \%<https://\:johnlekberg\:.com/\:blog/\:2020-10-11-ctx-manage\:.html> نوشته John Lekberg
.IP \(bu 2
منطق و دلایل \%<https://\:stackoverflow\:.com/\:a/\:73181877/\:2519059>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>.
.SS cyclic\-import / R0401
.sp
\fBپیام صادرشده:\fP
.sp
\fBدرون‌ریزی چرخه‌ای (%s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک درون‌ریزی چرخه‌ای بین دو یا چند ماژول شناسایی شود.\fP
.sp
\fBکد دارای اشکال:\fP
.sp
\fB__init__.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX

.EE
.UNINDENT
.UNINDENT
.sp
\fBbad.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def count_to_one():
    return 1


def count_to_three():
    from .bad2 import count_to_two

    return count_to_two() + 1

.EE
.UNINDENT
.UNINDENT
.sp
\fBbad2.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from .bad import count_to_one  # [cyclic\-import]


def count_to_two():
    return count_to_one() + 1

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def count_to_one():
    return 1


def count_to_two():
    return count_to_one() + 1


def count_to_three():
    return count_to_two() + 1

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
کد صحیح صرفاً یک مثال است. راهبردهای گوناگونی برای برطرف کردن درون‌ریزی‌های
چرخه‌ای وجود دارد و بهترین انتخاب تا حد زیادی به زمینهٔ کد
و ماژول‌های متأثر بستگی دارد.
.sp
ایجادشده توسط بررسی‌کنندهٔ imports \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:imports\:.py>..SS duplicate\-code / R0801
.sp
\fBپیام صادرشده:\fP
.sp
\fBخطوط مشابه در %s فایل
%s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIنشان می‌دهد که مجموعه‌ای از خطوط مشابه میان چندین فایل شناسایی شده است. این معمولاً بدین معناست که برای جلوگیری از این تکرار، کد باید بازآرایی (refactor) شود.\fP
.sp
\fBکد دارای مشکل:\fP
.sp
\fB__init__.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX

.EE
.UNINDENT
.UNINDENT
.sp
\fBapple.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Apple:
    def __init__(self):
        self.remaining_bites = 3

    def take_bite(self):
        if self.remaining_bites > 0:
            print(\(dqYou take a bite of the apple.\(dq)
            self.remaining_bites \-= 1
        else:
            print(\(dqThe apple is already eaten up!\(dq)

    def eaten_by_animal(self, animal):
        self.remaining_bites = 0
        print(\(dqThe apple has been eaten by an animal.\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBorange.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Orange:  # [duplicate\-code]
    def __init__(self):
        self.remaining_bites = 3

    def take_bite(self):
        if self.remaining_bites > 0:
            print(\(dqYou take a bite of the apple.\(dq)
            self.remaining_bites \-= 1
        else:
            print(\(dqThe orange is already eaten up!\(dq)

    def eaten_by_animal(self, animal):
        if animal == \(dqcat\(dq:
            raise ValueError(\(dqA cat would never do that !\(dq)
        self.remaining_bites = 0
        print(\(dqThe orange has been eaten by an animal.\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.sp
\fB__init__.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX

.EE
.UNINDENT
.UNINDENT
.sp
\fBapple.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from fruit import Fruit


class Apple(Fruit): ...

.EE
.UNINDENT
.UNINDENT
.sp
\fBfruit.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    def __init__(self):
        self.remaining_bites = 3

    def take_bite(self):
        if self.remaining_bites > 0:
            print(f\(dqYou take a bite of the {self.__class__.__name__.lower()}.\(dq)
            self.remaining_bites \-= 1
        else:
            print(f\(dqThe {self.__class__.__name__.lower()} is already eaten up!\(dq)

    def eaten_by_animal(self, animal):
        self.remaining_bites = 0
        print(f\(dqThe {self.__class__.__name__.lower()} has been eaten by an animal.\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBorange.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from fruit import Fruit


class Orange(Fruit):
    def eaten_by_animal(self, animal):
        if animal == \(dqcat\(dq:
            raise ValueError(\(dqA cat would never do that !\(dq)
        super().eaten_by_animal(animal)

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
اگر نیاز به اعمال تغییر در منطق یا عملکرد کد تکراری داشته باشید، باید تمام بخش‌هایی را که نیاز به تغییر دارند شناسایی کنید که این کار می‌تواند زمان‌بر و مستعد خطا باشد. اگر چندین رونوشت از یک کد یکسان وجود داشته باشد، باید هر نسخه را نیز آزمایش کنید تا مطمئن شوید عملکرد آن درست است. کد تکراری می‌تواند برای کسی که در تلاش برای درک منطق و جریان کد است گیج‌کننده باشد، به‌ویژه اگر با چندین بلوک کد یکسان یا تقریباً یکسان مواجه شود. در این حالت خواننده ممکن است کد را به‌صورت گذرا مرور کند و تصور کند همه‌چیز یکسان است، در حالی که در واقعیت چنین نیست. این موضوع به‌ویژه در زمان بازبینی کد رخ می‌دهد.
.sp
تولیدشده توسط بررسی‌کنندهٔ similarities \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:symilar\:.py>..SS else\-if\-used / R5501
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از \(dqelif\(dq را به‌جای \(dqelse\(dq و سپس \(dqif\(dq برای حذف یک سطح تورفتگی در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک عبارت else بلافاصله با یک عبارت if دنبال شده باشد و شامل عبارت‌های غیرمرتبط با آن نباشد.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
if input():
    pass
else:
    if len(input()) >= 10:  # [else\-if\-used]
        pass
    else:
        pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
if input():
    pass
elif len(input()) >= 10:
    pass
else:
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins=pylint.extensions.check_elif

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqelse_if_used\(aq \%<#\:pylint-extensions-check-elif> صادر می‌شود، که نیازمند بارگذاری افزونه \fBpylint.extensions.check_elif\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده else_if_used \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:check_elif\:.py>.
.SS empty\-comment / R2044
.sp
\fBپیام صادرشده:\fP
.sp
\fBخط دارای کامنت خالی\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که نماد # روی خطی ظاهر شود و به دنبال آن کامنت واقعی نیامده باشد\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# +1:[empty\-comment]
#

# +1:[empty\-comment]
x = 0  #

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# comment

x = 0  # comment

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
load\-plugins=pylint.extensions.empty_comment

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqempty\-comment\(aq \%<#\:pylint-extensions-empty-comment> صادر می‌شود، که نیازمند بارگذاری افزونه \fBpylint.extensions.empty_comment\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده empty\-comment \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:empty_comment\:.py>..SS inconsistent\-return\-statements / R1710
.sp
\fBپیام صادرشده:\fP
.sp
\fBیا تمام دستورهای return در یک تابع باید یک عبارت را برگردانند، یا هیچ‌کدام نباید برگردانند.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIبر اساس PEP8، اگر هر یک از دستورهای return عبارتی را برگرداند، سایر دستورهای return که مقداری برنمی‌گردانند باید صراحتاً به صورت return None مشخص شوند، و یک دستور return صریح نیز باید در پایان تابع (در صورت دسترسی‌پذیر بودن) وجود داشته باشد\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def get_the_answer(value: str) \-> str | None:  # [inconsistent\-return\-statements]
    if value:
        return value

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def get_the_answer(value: str) \-> str | None:
    if value:
        return value
    return None

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>.
.SS literal\-comparison / R0123
.sp
\fBپیام صادرشده:\fP
.sp
\fBدر \(aq%s\(aq، هنگام مقایسه لیترال‌های ثابت از \(aq%s\(aq استفاده کنید نه \(aq%s\(aq (\(aq%s\(aq)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی به کار می‌رود که یک شیء با یک مقدار لیترال مقایسه شود؛ کاری که معمولاً نباید انجام دهید، زیرا ممکن است مقایسه با لیترالی کاملاً متفاوت از آنچه انتظار می‌رفت صورت گیرد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def is_an_orange(fruit):
    return fruit is \(dqorange\(dq  # [literal\-comparison]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def is_an_orange(fruit):
    return fruit == \(dqorange\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
عملیات مقایسه‌ای در Python \%<https://\:docs\:.python\:.org/\:3/\:library/\:stdtypes\:.html#\:comparisons>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده basic \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:base/\:comparison_checker\:.py>.
.SS magic\-value\-comparison / R2004
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از یک ثابت نام‌گذاری‌شده یا یک enum را به جای \(aq%s\(aq در نظر بگیرید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاستفاده از ثابت‌های نام‌گذاری‌شده به جای مقادیر جادویی (magic values) به بهبود خوانایی و قابلیت نگهداری کد شما کمک می‌کند؛ سعی کنید در مقایسه‌ها از آن‌ها پرهیز کنید.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import random

measurement = random.randint(0, 200)
above_threshold = False
i = 0
while i < 5:  # [magic\-value\-comparison]
    above_threshold = measurement > 100  # [magic\-value\-comparison]
    if above_threshold:
        break
    measurement = random.randint(0, 200)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import random

MAX_NUM_OF_ITERATIONS = 5
THRESHOLD_VAL = 100
MIN_MEASUREMENT_VAL = 0
MAX_MEASUREMENT_VAL = 200

measurement = random.randint(MIN_MEASUREMENT_VAL, MAX_MEASUREMENT_VAL)
above_threshold = False
i = 0
while i < MAX_NUM_OF_ITERATIONS:
    above_threshold = measurement > THRESHOLD_VAL
    if above_threshold:
        break
    measurement = random.randint(MIN_MEASUREMENT_VAL, MAX_MEASUREMENT_VAL)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
load\-plugins=pylint.extensions.magic_value

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqmagic\-value\(aq \%<#\:pylint-extensions-magic-value>
صادر می‌شود، که نیازمند بارگذاری افزونه \fBpylint.extensions.magic_value\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده magic\-value \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:magic_value\:.py>..SS match\-class\-bind\-self / R1905
.sp
\fBپیام صادرشده:\fP
.sp
\fBبه‌جای آن از \(aq%s() as %s\(aq استفاده کنید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIالگوهای تطبیق کلاس سریع‌تر هستند اگر مقیدسازی نام برای کل الگو صورت گیرد و بتوان از هرگونه جست‌وجو برای \(ga__match_args__\(ga جلوگیری کرد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Book:
    __match_args__ = (\(dqtitle\(dq, \(dqyear\(dq)

    def __init__(self, title, year):
        self.title = title
        self.year = year


def func(item: Book):
    match item:
        case Book(title=str(title)):  # [match\-class\-bind\-self]
            ...
        case Book(year=int(year)):  # [match\-class\-bind\-self]
            ...

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Book:
    __match_args__ = (\(dqtitle\(dq, \(dqyear\(dq)

    def __init__(self, title, year):
        self.title = title
        self.year = year


def func(item: Book):
    match item:
        case Book(title=str() as title):
            ...
        case Book(year=int() as year):
            ...

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
مستندات پایتون \%<https://\:docs\:.python\:.org/\:3/\:reference/\:compound_stmts\:.html#\:class-patterns>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده match_statements \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:match_statements_checker\:.py>.
.SS match\-class\-positional\-attributes / R1906
.sp
\fBپیام صادرشده:\fP
.sp
\fBبه‌جای ویژگی‌های ترتیبی از ویژگی‌های کلیدواژه‌ای استفاده کنید (%s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIویژگی‌های کلیدواژه‌ای صریح‌تر و اندکی سریع‌تر هستند، زیرا CPython می‌تواند از جست‌وجوی \(ga__match_args__\(ga صرف‌نظر کند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Book:
    __match_args__ = (\(dqtitle\(dq, \(dqyear\(dq)

    def __init__(self, title, year):
        self.title = title
        self.year = year


def func(item: Book):
    match item:
        case Book(\(dqabc\(dq, 2000):  # [match\-class\-positional\-attributes]
            ...

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Book:
    __match_args__ = (\(dqtitle\(dq, \(dqyear\(dq)

    def __init__(self, title, year):
        self.title = title
        self.year = year


def func(item: Book):
    match item:
        case Book(title=\(dqabc\(dq, year=2000):
            ...

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
مستندات پایتون \%<https://\:docs\:.python\:.org/\:3/\:reference/\:compound_stmts\:.html#\:class-patterns>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده match_statements \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:match_statements_checker\:.py>..SS no\-classmethod\-decorator / R0202
.sp
\fBپیام صادرشده:\fP
.sp
\fBبه‌جای فراخوانی classmethod، استفاده از دکوراتور را در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک متد کلاس بدون به‌کارگیری نحو دکوراتور تعریف شده باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    COLORS = []

    def __init__(self, color):
        self.color = color

    def pick_colors(cls, *args):
        \(dq\(dq\(dqclassmethod to pick fruit colors\(dq\(dq\(dq
        cls.COLORS = args

    pick_colors = classmethod(pick_colors)  # [no\-classmethod\-decorator]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    COLORS = []

    def __init__(self, color):
        self.color = color

    @classmethod
    def pick_colors(cls, *args):
        \(dq\(dq\(dqclassmethod to pick fruit colors\(dq\(dq\(dq
        cls.COLORS = args

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>.
.SS no\-else\-break / R1723
.sp
\fBپیام صادرشده:\fP
.sp
\fB\(dq%s\(dq غیرضروری پس از \(dqbreak\(dq، %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIبرای برجسته‌سازی یک بلوک کد غیرضروری پس از یک if حاوی دستور break به کار می‌رود. به این ترتیب، هنگام مواجهه با یک else پس از زنجیره‌ای از دستورهای if که همگی شامل دستور break هستند، هشدار می‌دهد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def next_seven_elements(iterator):
    for i, item in enumerate(iterator):
        if i == 7:  # [no\-else\-break]
            break
        else:
            yield item

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def next_seven_elements(iterator):
    for i, item in enumerate(iterator):
        if i == 7:
            break
        yield item

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>..SS no\-else\-continue / R1724
.sp
\fBپیام صادرشده:\fP
.sp
\fB\(dq%s\(dq غیرضروری پس از \(dqcontinue\(dq، %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIبرای مشخص کردن یک بلوک کد غیرضروری پس از یک if حاوی دستور continue به کار می‌رود. به همین ترتیب، هنگامی که پس از زنجیره‌ای از ifها که همگی شامل دستور continue هستند با یک else مواجه شود، هشدار خواهد داد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def even_number_under(n: int):
    for i in range(n):
        if i % 2 == 1:  # [no\-else\-continue]
            continue
        else:
            yield i

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def even_number_under(n: int):
    for i in range(n):
        if i % 2 == 1:
            continue
        yield i

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>.
.SS no\-else\-raise / R1720
.sp
\fBپیام صادرشده:\fP
.sp
\fB\(dq%s\(dq غیرضروری پس از \(dqraise\(dq، %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIبرای مشخص کردن یک بلوک کد غیرضروری پس از یک if یا یک try/except حاوی دستور raise به کار می‌رود. به همین ترتیب، هنگامی که پس از زنجیره‌ای از ifها که همگی شامل دستور raise هستند با یک else مواجه شود، هشدار خواهد داد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def integer_sum(a: int, b: int) \-> int:
    if not (isinstance(a, int) and isinstance(b, int)):  # [no\-else\-raise]
        raise ValueError(\(dqFunction supports only integer parameters.\(dq)
    else:
        return a + b

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def integer_sum(a: int, b: int) \-> int:
    if not (isinstance(a, int) and isinstance(b, int)):
        raise ValueError(\(dqFunction supports only integer parameters.\(dq)
    return a + b

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>..SS no\-else\-return / R1705
.sp
\fBپیام صادرشده:\fP
.sp
\fB\(dq%s\(dq غیرضروری پس از \(dqreturn\(dq، %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIبرای مشخص کردن یک بلوک کد غیرضروری پس از یک if یا یک try/except حاوی دستور return به کار می‌رود. به این ترتیب، زمانی که پس از زنجیره‌ای از دستورهای if که همگی دارای دستور return هستند با یک else مواجه شود، هشدار خواهد داد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def compare_numbers(a: int, b: int) \-> int:
    if a == b:  # [no\-else\-return]
        return 0
    elif a < b:
        return \-1
    else:
        return 1

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def compare_numbers(a: int, b: int) \-> int:
    if a == b:
        return 0
    if a < b:
        return \-1
    return 1

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>.
.SS no\-self\-use / R6301
.sp
\fBپیام صادرشده:\fP
.sp
\fBمتد می‌تواند یک تابع باشد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی به کار می‌رود که یک متد از نمونهٔ مقید خود استفاده نمی‌کند و بنابراین می‌تواند به صورت یک تابع نوشته شود.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Person:
    def greeting(self):  # [no\-self\-use]
        print(\(dqGreetings pythonista!\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.sp
\fBfunction.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def greeting():
    print(\(dqGreetings pythonista!\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBstaticmethod.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Person:
    @staticmethod
    def greeting():
        print(\(dqGreetings pythonista!\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBuse_self.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Person:
    name: str = \(dqAmelia\(dq

    def greeting(self):
        print(f\(dqGreetings {self.name} the pythonista!\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins=pylint.extensions.no_self_use,

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
اگر یک تابع از هیچ‌یک از ویژگی‌های کلاس استفاده نمی‌کند، می‌تواند یک \fB@staticmethod\fP
یا یک تابع در خارج از کلاس باشد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کنندهٔ اختیاری \(aqno_self_use\(aq \%<#\:pylint-extensions-no-self-use>
صادر می‌شود که نیازمند بارگذاری افزونهٔ \fBpylint.extensions.no_self_use\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ no_self_use \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:no_self_use\:.py>..SS no\-staticmethod\-decorator / R0203
.sp
\fBپیام صادرشده:\fP
.sp
\fBConsider using a decorator instead of calling staticmethod\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک متد استاتیک بدون استفاده از نحو دکوراتور تعریف شده باشد.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Worm:
    def bore(self):
        pass

    bore = staticmethod(bore)  # [no\-staticmethod\-decorator]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Worm:
    @staticmethod
    def bore(self):
        pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>.
.SS prefer\-typing\-namedtuple / R6105
.sp
\fBپیام صادرشده:\fP
.sp
\fBPrefer \(aqtyping.NamedTuple\(aq over \(aqcollections.namedtuple\(aq\fP
.sp
\fBتوضیحات:\fP
.sp
\fI\(aqtyping.NamedTuple\(aq از کلیدواژهٔ نام‌آشنای \(aqclass\(aq همراه با type\-hints برای خوانایی بهتر استفاده می‌کند (همچنین به دلیل اجتناب از فراخوانی داخلی exec، سریع‌تر است).
به‌طور پیش‌فرض غیرفعال است!\fP
.sp
\fBاحتیاط:\fP
.INDENT 0.0
.INDENT 3.5
این پیام به‌طور پیش‌فرض غیرفعال است. برای فعال‌سازی آن، \fBprefer\-typing\-namedtuple\fP را به گزینهٔ \fBenable\fP اضافه کنید.
.UNINDENT
.UNINDENT
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from collections import namedtuple

Philosophy = namedtuple(  # [prefer\-typing\-namedtuple]
    \(dqPhilosophy\(dq, (\(dqgoodness\(dq, \(dqtruth\(dq, \(dqbeauty\(dq)
)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import NamedTuple


class Philosophy(NamedTuple):
    goodness: str
    truth: bool
    beauty: float

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins = pylint.extensions.code_style

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
typing.NamedTuple \%<https://\:docs\:.python\:.org/\:3/\:library/\:typing\:.html#\:typing\:.NamedTuple>
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کنندهٔ اختیاری \(aqcode_style\(aq \%<#\:pylint-extensions-code-style>
صادر می‌شود که نیازمند بارگذاری افزونهٔ \fBpylint.extensions.code_style\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ code_style \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:code_style\:.py>..SS property\-with\-parameters / R0206
.sp
\fBپیام صادرشده:\fP
.sp
\fBنمی‌توان برای ویژگی‌ها پارامتر تعریف کرد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که تشخیص دهیم یک ویژگی (property) دارای پارامتر نیز هست؛ این پارامترها بی‌استفاده هستند، زیرا ویژگی‌ها نمی‌توانند با آرگومان‌های اضافی فراخوانی شوند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Worm:
    @property
    def bore(self, depth):  # [property\-with\-parameters]
        pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Worm:
    @property
    def bore(self):
        \(dq\(dq\(dqProperty accessed with \(aq.bore\(aq.\(dq\(dq\(dq
        pass

    def bore_with_depth(depth):
        \(dq\(dq\(dqFunction called with .bore_with_depth(depth).\(dq\(dq\(dq
        pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>.
.SS redefined\-argument\-from\-local / R1704
.sp
\fBپیام صادرشده:\fP
.sp
\fBبازتعریف آرگومان با نام محلی %r\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک نام محلی، آرگومانی را بازتعریف کند که می‌تواند نشان‌دهندهٔ یک خطای احتمالی باشد. این مورد تنها برای تعداد اندکی از عملیات مقیدسازی نام (name binding)، مانند پیمایش در حلقهٔ for، انتساب در دستور with و انتساب در مدیریت‌کنندهٔ استثنا (exception handler) لحاظ می‌شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def show(host_id=10.11):
    # +1: [redefined\-argument\-from\-local]
    for host_id, host in [[12.13, \(dqVenus\(dq], [14.15, \(dqMars\(dq]]:
        print(host_id, host)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def show(host_id=10.11):
    for inner_host_id, host in [[12.13, \(dqVenus\(dq], [14.15, \(dqMars\(dq]]:
        print(host_id, inner_host_id, host)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>..SS redefined\-variable\-type / R0204
.sp
\fBپیام صادرشده:\fP
.sp
\fBتعریف مجدد نوع %s از %s به %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که نوع یک متغیر درون یک متد یا تابع تغییر کند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
x = 1
x = \(dq2\(dq  # [redefined\-variable\-type]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
x = 1
x = 2

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins=pylint.extensions.redefined_variable_type,

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqmultiple_types\(aq \%<#\:pylint-extensions-redefined-variable-type>
صادر می‌شود، که نیازمند بارگذاری افزونه \fBpylint.extensions.redefined_variable_type\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده multiple_types \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:redefined_variable_type\:.py>.
.SS redundant\-typehint\-argument / R6006
.sp
\fBپیام صادرشده:\fP
.sp
\fBنوع \(ga%s\(ga بیش از یک بار در حاشیه‌نویسی نوع union استفاده شده است. راهنماهای نوع اضافی را حذف کنید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIآرگومان‌های نوع تکراری توسط ابزار \(gamypy\(ga نادیده گرفته خواهند شد، بنابراین برای جلوگیری از سردرگمی باید حذف شوند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import Union

sweet_count: Union[int, str, int] = 42  # [redundant\-typehint\-argument]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import Union

sweet_count: Union[str, int] = 42

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
load\-plugins=pylint.extensions.typing

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqtyping\(aq \%<#\:pylint-extensions-typing>
صادر می‌شود، که نیازمند بارگذاری افزونه \fBpylint.extensions.typing\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده typing \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:typing\:.py>..SS simplifiable\-condition / R1726
.sp
\fBپیام صادرشده:\fP
.sp
\fBشرط بولی \(dq%s\(dq می‌تواند به \(dq%s\(dq ساده‌سازی شود\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که یک شرط بولی قابل ساده‌سازی باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def has_apples(apples) \-> bool:
    return bool(apples or False)  # [simplifiable\-condition]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def has_apples(apples) \-> bool:
    return bool(apples)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>.
.SS simplifiable\-if\-expression / R1719
.sp
\fBپیام صادرشده:\fP
.sp
\fBعبارت if می‌تواند با %s جایگزین شود\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک عبارت if بتواند با \(aqbool(test)\(aq یا در صورت ضمنی بودن تبدیل نوع بولی، به سادگی با \(aqtest\(aq جایگزین شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
FLYING_THINGS = [\(dqbird\(dq, \(dqplane\(dq, \(dqsuperman\(dq, \(dqthis example\(dq]


def is_flying_thing(an_object):
    return True if an_object in FLYING_THINGS else False  # [simplifiable\-if\-expression]


def is_not_flying_thing(an_object):
    return False if an_object in FLYING_THINGS else True  # [simplifiable\-if\-expression]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
FLYING_THINGS = [\(dqbird\(dq, \(dqplane\(dq, \(dqsuperman\(dq, \(dqthis example\(dq]


def is_flying_thing(an_object):
    return an_object in FLYING_THINGS


def is_not_flying_thing(an_object):
    return an_object not in FLYING_THINGS

.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
ساده‌سازی یک دستور \(aqif\(aq با ()bool \%<https://\:stackoverflow\:.com/\:questions/\:49546992>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>..SS simplifiable\-if\-statement / R1703
.sp
\fBپیام صادرشده:\fP
.sp
\fBThe if statement can be replaced with %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک دستور if بتواند با \(aqbool(test)\(aq جایگزین شود.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
FLYING_THINGS = [\(dqbird\(dq, \(dqplane\(dq, \(dqsuperman\(dq, \(dqthis example\(dq]


def is_flying_animal(an_object):
    # +1: [simplifiable\-if\-statement]
    if isinstance(an_object, Animal) and an_object in FLYING_THINGS:
        is_flying = True
    else:
        is_flying = False
    return is_flying

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
FLYING_THINGS = [\(dqbird\(dq, \(dqplane\(dq, \(dqsuperman\(dq, \(dqthis example\(dq]


def is_flying_animal(an_object):
    is_flying = isinstance(an_object, Animal) and an_object.name in FLYING_THINGS
    return is_flying

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>.
.SS simplify\-boolean\-expression / R1709
.sp
\fBپیام صادرشده:\fP
.sp
\fBBoolean expression may be simplified to %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی صادر می‌شود که از نحو سه‌گانه (ternary) زائد pre\-python 2.5 استفاده شده باشد.\fP
.sp
\fBکد دارای اشکال:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def has_oranges(oranges, apples=None) \-> bool:
    return apples and False or oranges  # [simplify\-boolean\-expression]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def has_oranges(oranges, apples=None) \-> bool:
    return oranges

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>..SS stop\-iteration\-return / R1708
.sp
\fBپیام صادرشده:\fP
.sp
\fBدر generator از raise StopIteration استفاده نکنید، به‌جای آن از دستور return استفاده کنید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIمطابق با PEP479، ایجاد خطای StopIteration با دستور raise برای خاتمه دادن به حلقه یک generator ممکن است منجر به باگ‌هایی شود که یافتن آن‌ها دشوار است. این PEP مشخص می‌کند که raise StopIteration باید با یک دستور return ساده جایگزین شود.\fP
.sp
\fBکد مشکل‌دار:\fP
.sp
\fBfruit_generator.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def fruit_generator():
    for fruit in [\(dqapple\(dq, \(dqbanana\(dq]:
        yield fruit
    raise StopIteration  # [stop\-iteration\-return]

.EE
.UNINDENT
.UNINDENT
.sp
\fBtwo_fruit_generator.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def two_fruits_generator(fruits):
    for fruit in fruits:
        yield fruit, next(fruits)  # [stop\-iteration\-return]

.EE
.UNINDENT
.UNINDENT
.sp
\fBtwo_good_fruit_generator.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def two_good_fruits_generator(fruits):
    for fruit in fruits:
        if not fruit.is_tasty():
            continue
        while True:
            next_fruit = next(fruits)  # [stop\-iteration\-return]
            if next_fruit.is_tasty():
                yield fruit, next_fruit
                break

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.sp
\fBfruit_generator.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def fruit_generator():
    \(dq\(dq\(dqThe example is simple enough you don\(aqt need an explicit return.\(dq\(dq\(dq
    for fruit in [\(dqapple\(dq, \(dqbanana\(dq]:
        yield fruit

.EE
.UNINDENT
.UNINDENT
.sp
\fBtwo_fruit_generator.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def two_fruits_generator(fruits):
    \(dq\(dq\(dqCatching the StopIteration.\(dq\(dq\(dq
    for fruit in fruits:
        try:
            yield fruit, next(fruits)
        except StopIteration:
            print(\(dqSorry there is only one fruit left.\(dq)
            yield fruit, None

.EE
.UNINDENT
.UNINDENT
.sp
\fBtwo_good_fruit_generator.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def two_good_fruits_generator(fruits):
    \(dq\(dq\(dqA return can be used to end the iterator early, but not a StopIteration.\(dq\(dq\(dq
    for fruit in fruits:
        if not fruit.is_tasty():
            continue
        while True:
            next_fruit = next(fruits, None)
            if next_fruit is None:
                print(\(dqSorry there is only one fruit left.\(dq)
                yield fruit, None
                # We reached the end of the \(aqfruits\(aq generator but raising a
                # StopIteration instead of returning would create a RuntimeError
                return
            if next_fruit.is_tasty():
                yield fruit, next_fruit
                break

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
امکان‌پذیر است که یک مقدار پیش‌فرض به \fBnext\fP داده شود یا \fBStopIteration\fP دریافت (catch) گردد،
یا مستقیماً return انجام شود. یک \fBStopIteration\fP نمی‌تواند از یک generator به بیرون منتشر شود.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
PEP 479 \%<https://\:peps\:.python\:.org/\:pep-0479>
.UNINDENT
.sp
ایجادشده توسط بازرس (checker) refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>..SS super\-with\-arguments / R1725
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از ()super بدون آرگومان به سبک Python 3 را در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگام فراخوانی تابع توکار ()super با کلاس و نمونه جاری صادر می‌شود. در Python 3 این آرگومان‌ها پیش‌فرض هستند و می‌توان آن‌ها را حذف کرد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    pass


class Orange(Fruit):
    def __init__(self):
        super(Orange, self).__init__()  # [super\-with\-arguments]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:
    pass


class Orange(Fruit):
    def __init__(self):
        super().__init__()

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>.
.SS too\-complex / R1260
.sp
\fBپیام صادرشده:\fP
.sp
\fB%s بیش از حد پیچیده است. رتبه‌بندی McCabe برابر با %d است\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک متد یا تابع بر اساس پیچیدگی سیکلوماتیک McCabe بیش از حد پیچیده باشد\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def fifty_percent_off(whole):
    return (float(whole)) * 50 / 100


def calculate_sum_and_display_price_of_fruits(*fruits):  # [too\-complex]
    # McCabe rating is 13 here (by default 10)
    shopping_list = []

    if \(dqapple\(dq in fruits:
        v = fifty_percent_off(1.1)
        shopping_list.append(v)
    if \(dqpear\(dq in fruits:
        shopping_list.append(0.8)
    if \(dqbanana\(dq in fruits:
        shopping_list.append(1.2)
    if \(dqmango\(dq in fruits:
        shopping_list.append(3.5)
    if \(dqpeach\(dq in fruits:
        shopping_list.append(0.5)
    if \(dqmelon\(dq in fruits:
        shopping_list.append(4.9)
    if \(dqorange\(dq in fruits:
        shopping_list.append(2.0)
    if \(dqstrawberry\(dq in fruits:
        shopping_list.append(2.5)
    if \(dqmandarin\(dq in fruits:
        shopping_list.append(2.3)
    if \(dqplum\(dq in fruits:
        shopping_list.append(0.5)
    if \(dqwatermelon\(dq in fruits:
        v = fifty_percent_off(6.4)
        shopping_list.append(v)

    combine = zip(fruits, shopping_list)

    for i in combine:
        print(f\(dq{i[0]} ${i[1]:.2f}\(dq)

    total = sum(shopping_list)
    print(f\(dqTotal price is ${total:.2f}\(dq)


fruits_to_buy = [\(dqapple\(dq, \(dqorange\(dq, \(dqwatermelon\(dq]
calculate_sum_and_display_price_of_fruits(*fruits_to_buy)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
FRUIT_PRICES = {
    \(dqapple\(dq: 1.1,
    \(dqpear\(dq: 0.8,
    \(dqbanana\(dq: 1.2,
    \(dqmango\(dq: 3.5,
    \(dqpeach\(dq: 0.5,
    \(dqmelon\(dq: 4.9,
    \(dqorange\(dq: 2.0,
    \(dqstrawberry\(dq: 2.5,
    \(dqmandarin\(dq: 2.3,
    \(dqplum\(dq: 0.5,
    \(dqwatermelon\(dq: 6.4,
}
DISCOUNTED_FRUITS = [\(dqapple\(dq, \(dqwatermelon\(dq]


def fifty_percent_off(whole):
    return (float(whole)) * 50 / 100


def get_price(fruit):
    full_price = FRUIT_PRICES.get(fruit)
    if fruit in DISCOUNTED_FRUITS:
        return fifty_percent_off(full_price)
    else:
        return full_price


def display_fruit_and_price(fruits):
    for fruit in fruits:
        print(f\(dq{fruit} ${get_price(fruit) :.2f}\(dq)


def get_total(fruits):
    return sum(get_price(f) for f in fruits)


fruits_to_buy = [\(dqapple\(dq, \(dqorange\(dq, \(dqwatermelon\(dq]
display_fruit_and_price(fruits_to_buy)
print(f\(dqTotal price is ${get_total(fruits_to_buy):.2f}\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]

load\-plugins=pylint.extensions.mccabe

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqdesign\(aq \%<#\:pylint-extensions-mccabe> صادر می‌شود که مستلزم بارگذاری افزونه \fBpylint.extensions.mccabe\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده design \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:mccabe\:.py>..SS too\-few\-public\-methods / R0903
.sp
\fBپیام صادرشده:\fP
.sp
\fBمتدهای عمومی بسیار کم (%s/%s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که کلاس متدهای عمومی بسیار کمی دارد، بنابراین مطمئن شوید که واقعاً ارزشش را دارد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Worm:  # [too\-few\-public\-methods]
    def __init__(self, name: str, fruit_of_residence: Fruit):
        self.name = name
        self.fruit_of_residence = fruit_of_residence

    def bore(self):
        print(f\(dq{self.name} is boring into {self.fruit_of_residence}\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.sp
\fBdataclass_and_function.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import dataclasses


@dataclasses.dataclass
class Worm:
    name: str
    fruit_of_residence: Fruit


def bore(worm: Worm):
    print(f\(dq{worm.name} is boring into {worm.fruit_of_residence}\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBfunction.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def bore(fruit: Fruit, worm_name: str):
    print(f\(dq{worm_name} is boring into {fruit}\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
\fBlarger_api.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Worm:
    def __init__(self, name: str, fruit_of_residence: Fruit):
        self.name = name
        self.fruit_of_residence = fruit_of_residence

    def bore(self):
        print(f\(dq{self.name} is boring into {self.fruit_of_residence}\(dq)

    def wiggle(self):
        print(f\(dq{self.name} wiggle around wormily.\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ design \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:design_analysis\:.py>..SS too\-many\-ancestors / R0901
.sp
\fBپیام صادرشده:\fP
.sp
\fBاجداد بیش از حد (%s/%s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که کلاس بیش از حد کلاس والد داشته باشد؛ سعی کنید این تعداد را کاهش دهید تا به کلاسی ساده‌تر (و در نتیجه با استفادهٔ آسان‌تر) دست یابید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Animal: ...
class BeakyAnimal(Animal): ...
class FurryAnimal(Animal): ...
class Swimmer(Animal): ...
class EggLayer(Animal): ...
class VenomousAnimal(Animal): ...
class ProtectedSpecie(Animal): ...
class BeaverTailedAnimal(Animal): ...
class Vertebrate(Animal): ...


# max of 7 by default, can be configured
# each edge of a diamond inheritance counts
class Playtypus(  # [too\-many\-ancestors]
    BeakyAnimal,
    FurryAnimal,
    Swimmer,
    EggLayer,
    VenomousAnimal,
    ProtectedSpecie,
    BeaverTailedAnimal,
    Vertebrate,
):
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Animal:
    beaver_tailed: bool
    can_swim: bool
    has_beak: bool
    has_fur: bool
    has_vertebrae: bool
    lays_egg: bool
    protected_specie: bool
    venomous: bool


class Invertebrate(Animal):
    has_vertebrae = False


class Vertebrate(Animal):
    has_vertebrae = True


class Mammal(Vertebrate):
    has_beak = False
    has_fur = True
    lays_egg = False
    venomous = False


class Playtypus(Mammal):
    beaver_tailed = True
    can_swim = True
    has_beak = True
    lays_egg = True
    protected_specie = True
    venomous = True

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کنندهٔ design \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:design_analysis\:.py>..SS too\-many\-arguments / R0913
.sp
\fBپیام صادرشده:\fP
.sp
\fBآرگومان‌های بیش از حد (%s/%s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک تابع یا متد بیش از حد آرگومان بپذیرد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def three_d_chess_move(  # [too\-many\-arguments]
    x_white,
    y_white,
    z_white,
    piece_white,
    x_black,
    y_black,
    z_black,
    piece_black,
    x_blue,
    y_blue,
    z_blue,
    piece_blue,
    current_player,
):
    pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from dataclasses import dataclass


@dataclass
class ThreeDChessPiece:
    x: int
    y: int
    z: int
    type: str


def three_d_chess_move(
    white: ThreeDChessPiece,
    black: ThreeDChessPiece,
    blue: ThreeDChessPiece,
    current_player,
):
    pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ design \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:design_analysis\:.py>.
.SS too\-many\-boolean\-expressions / R0916
.sp
\fBپیام صادرشده:\fP
.sp
\fBعبارات بولی بیش از حد در دستور if (%s/%s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک دستور if شامل عبارات بولی بیش از حد باشد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def can_be_divided_by_two_and_are_not_zero(x, y, z):
    # Maximum number of boolean expressions in an if statement (by default 5)
    # +1: [too\-many\-boolean\-expressions]
    if (x and y and z) and (x % 2 == 0 and y % 2 == 0 and z % 2 == 0):
        pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def can_be_divided_by_two_and_are_not_zero(x, y, z):
    if all(i and i % 2 == 0 for i in [x, y, z]):
        pass

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ design \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:design_analysis\:.py>..SS too\-many\-branches / R0912
.sp
\fBپیام صادرشده:\fP
.sp
\fBتعداد شاخه‌ها بیش از حد مجاز (%s/%s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک تابع یا متد دارای شاخه‌های بیش از حد باشد، که دنبال کردن آن را دشوار می‌سازد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def num_to_word(x):  # [too\-many\-branches]
    if x == 0:
        return \(dqzero\(dq
    elif x == 1:
        return \(dqone\(dq
    elif x == 2:
        return \(dqtwo\(dq
    elif x == 3:
        return \(dqthree\(dq
    elif x == 4:
        return \(dqfour\(dq
    elif x == 5:
        return \(dqfive\(dq
    elif x == 6:
        return \(dqsix\(dq
    elif x == 7:
        return \(dqseven\(dq
    elif x == 8:
        return \(dqeight\(dq
    elif x == 9:
        return \(dqnine\(dq
    else:
        return None

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def num_to_word(x):
    return {
        0: \(dqzero\(dq,
        1: \(dqone\(dq,
        2: \(dqtwo\(dq,
        3: \(dqthree\(dq,
        4: \(dqfour\(dq,
        5: \(dqfive\(dq,
        6: \(dqsix\(dq,
        7: \(dqseven\(dq,
        8: \(dqeight\(dq,
        9: \(dqnine\(dq,
    }.get(x)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
max\-branches=10

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ design \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:design_analysis\:.py>.
.SS too\-many\-instance\-attributes / R0902
.sp
\fBپیام صادرشده:\fP
.sp
\fBتعداد ویژگی‌های نمونه بیش از حد مجاز (%s/%s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک کلاس ویژگی‌های نمونهٔ بیش از حدی داشته باشد؛ تلاش کنید این تعداد را کاهش دهید تا به کلاسی ساده‌تر (و در نتیجه با کاربرد آسان‌تر) دست یابید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Fruit:  # [too\-many\-instance\-attributes]
    def __init__(self):
        # max of 7 attributes by default, can be configured
        self.worm_name = \(dqJimmy\(dq
        self.worm_type = \(dqCodling Moths\(dq
        self.worm_color = \(dqlight brown\(dq
        self.fruit_name = \(dqLittle Apple\(dq
        self.fruit_color = \(dqBright red\(dq
        self.fruit_vitamins = [\(dqA\(dq, \(dqB1\(dq]
        self.fruit_antioxidants = None
        self.secondary_worm_name = \(dqKim\(dq
        self.secondary_worm_type = \(dqApple maggot\(dq
        self.secondary_worm_color = \(dqWhitish\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import dataclasses


@dataclasses.dataclass
class Worm:
    name: str
    type: str
    color: str


class Fruit:
    def __init__(self):
        self.name = \(dqLittle Apple\(dq
        self.color = \(dqBright red\(dq
        self.vitamins = [\(dqA\(dq, \(dqB1\(dq]
        self.antioxidants = None
        self.worms = [
            Worm(name=\(dqJimmy\(dq, type=\(dqCodling Moths\(dq, color=\(dqlight brown\(dq),
            Worm(name=\(dqKim\(dq, type=\(dqApple maggot\(dq, color=\(dqWhitish\(dq),
        ]

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ design \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:design_analysis\:.py>..SS too\-many\-locals / R0914
.sp
\fBپیام صادرشده:\fP
.sp
\fBمتغیرهای محلی بیش از حد (%s/%s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که یک تابع یا متد بیش از حد متغیر محلی داشته باشد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from childhood import Child, Sweet


def handle_sweets(infos):  # [too\-many\-locals]
    # Create children
    children = [Child(info) for info in infos]
    number_of_sweets = 87
    sweets = [Sweet() * number_of_sweets]
    number_of_sweet_per_child = 5
    money = 45.0
    sweets_given = 0
    time_to_eat_sweet = 54
    price_of_sweet = 0.42
    # distribute sweet
    for child in children:
        sweets_given += number_of_sweet_per_child
        child.give(sweets[number_of_sweet_per_child:])
    # calculate prices
    cost_of_children = sweets_given * price_of_sweet
    # Calculate remaining money
    remaining_money = money \- cost_of_children
    # Calculate time it took
    time_it_took_assuming_parallel_eating = (
        time_to_eat_sweet * number_of_sweet_per_child
    )
    print(
        f\(dq{children} ate {cost_of_children}¤ of sweets in {time_it_took_assuming_parallel_eating}, \(dq
        f\(dqyou still have {remaining_money}\(dq
    )

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import NamedTuple

from childhood import Child, Sweet


class SweetDistrubutionCharacteristics(NamedTuple):
    number_of_sweets: int
    number_of_sweet_per_child: int
    number_of_children: int

    @property
    def sweets_given(self):
        return self.number_of_sweet_per_child * self.number_of_children


def handle_sweets(infos):
    children = [Child(info) for info in infos]
    characteristics = SweetDistrubutionCharacteristics(87, 5, len(children))
    _allocate_sweets_to_children(children, characteristics)
    financial_impact = _assess_financial_impact(characteristics)
    print(f\(dq{children} ate {financial_impact}\(dq)


def _allocate_sweets_to_children(
    children, characteristics: SweetDistrubutionCharacteristics
) \-> None:
    sweets = [Sweet() * characteristics.number_of_sweets]
    for child in children:
        child.give(sweets[characteristics.number_of_sweet_per_child :])


def _assess_financial_impact(characteristics: SweetDistrubutionCharacteristics) \-> str:
    time_to_eat_sweet = 54
    money = 45.0
    price_of_sweet = 0.42
    cost_of_children = characteristics.sweets_given * price_of_sweet
    remaining_money = money \- cost_of_children
    time_it_took_assuming_parallel_eating = (
        time_to_eat_sweet * characteristics.number_of_sweet_per_child
    )
    return (
        f\(dq{cost_of_children}¤ of sweets in \(dq
        f\(dq{time_it_took_assuming_parallel_eating}, you still have {remaining_money}\(dq
    )

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[design]
max\-locals = 11

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
داشتن متغیرهای محلی بیش از حد ممکن است نشان‌دهنده این باشد که در یک تابع کارهای زیادی انجام می‌دهید و می‌توان کلاس‌هایی برای گروه‌بندی برخی از ویژگی‌ها ایجاد کرد. شاید بتوان عملیات را در چندین تابع تفکیک کرد. آیا واقعاً همه متغیرهای شما ارتباط نزدیکی با یکدیگر دارند؟
.sp
ایجاد شده توسط بررسی‌کننده design \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:design_analysis\:.py>..SS too\-many\-nested\-blocks / R1702
.sp
\fBپیام صادرشده:\fP
.sp
\fBToo many nested blocks (%s/%s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک تابع یا متد دارای بیش از حد بلوک‌های تو در تو باشد. این امر درک و نگهداری‌پذیری کد را دشوارتر می‌کند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def correct_fruits(fruits):
    if len(fruits) > 1:  # [too\-many\-nested\-blocks]
        if \(dqapple\(dq in fruits:
            if \(dqorange\(dq in fruits:
                count = fruits[\(dqorange\(dq]
                if count % 2:
                    if \(dqkiwi\(dq in fruits:
                        if count == 2:
                            return True
    return False

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def correct_fruits(fruits):
    if len(fruits) > 1 and \(dqapple\(dq in fruits and \(dqorange\(dq in fruits:
        count = fruits[\(dqorange\(dq]
        if count % 2 and \(dqkiwi\(dq in fruits and count == 2:
            return True
    return False

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>\&.
.SS too\-many\-positional\-arguments / R0917
.sp
\fBپیام صادرشده:\fP
.sp
\fBToo many positional arguments (%s/%s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک تابع بیش از حد آرگومان موقعیتی (positional) داشته باشد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# +1: [too\-many\-positional\-arguments]
def calculate_drag_force(velocity, area, density, drag_coefficient):
    \(dq\(dq\(dqEach argument is positional\-or\-keyword unless a \(ga/\(ga or \(ga*\(ga is present.\(dq\(dq\(dq
    return 0.5 * drag_coefficient * density * area * velocity**2


drag_force = calculate_drag_force(30, 2.5, 1.225, 0.47)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def calculate_drag_force(*, velocity, area, density, drag_coefficient):
    \(dq\(dq\(dqThis function is \(aqKeyword only\(aq for all args due to the \(aq*\(aq.\(dq\(dq\(dq
    return 0.5 * drag_coefficient * density * area * velocity**2


# This is now impossible to do and will raise a TypeError:
# drag_force = calculate_drag_force(30, 2.5, 1.225, 0.47)
#              ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
# TypeError: calculate_drag_force() takes 0 positional arguments but 4 were given

# And this is the only way to call \(aqcalculate_drag_force\(aq
drag_force = calculate_drag_force(
    velocity=30, area=2.5, density=1.225, drag_coefficient=0.47
)

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[DESIGN]
max\-positional\-arguments=3

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
امضاهای مناسب تابع پارامترهای موقعیتی زیادی ندارند. در تقریباً تمام
رابط‌ها، فراتر رفتن از چند آرگومان محدود به فهم‌پذیری کد آسیب می‌زند.
.sp
آرگومان‌های موقعیتی برای مواردی که نحوهٔ استفاده
بدیهی و مشخص است به‌خوبی عمل می‌کنند؛ مانند \fBassertEqual(first, second, \(dqassert msg\(dq)\fP
در unittest یا \fBzip(fruits, vegetables)\fP\&.
.sp
استثناهای اندکی وجود دارند که در آن‌ها چهار یا چند پارامتر موقعیتی منطقی است؛
برای نمونه \fBrgba(1.0, 0.5, 0.3, 1.0)\fP، زیرا از قراردادی بسیار شناخته‌شده و
تثبیت‌شده پیروی می‌کند و استفادهٔ همیشگی از کلمات کلیدی، اتلاف وقت خواهد بود.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
پارامترهای ویژه در پایتون \%<https://\:docs\:.python\:.org/\:3/\:tutorial/\:controlflow\:.html#\:special-parameters>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ design \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:design_analysis\:.py>\&..SS too\-many\-public\-methods / R0904
.sp
\fBپیام صادرشده:\fP
.sp
\fBمتدهای عمومی بیش از حد (%s/%s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک کلاس بیش از حد متد عمومی داشته باشد؛ تلاش کنید این متدها را کاهش دهید تا به کلاسی ساده‌تر (و در نتیجه با استفاده آسان‌تر) دست یابید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class SpaceInvaders:  # [too\-many\-public\-methods]
    def __init__(self):
        pass

    def fire_laser_beam(self):
        pass

    def deploy_shield(self):
        pass

    def launch_missile(self):
        pass

    def activate_super_laser(self):
        pass

    def summon_mothership(self):
        pass

    def destroy_planet(self):
        pass

    def teleport(self):
        pass

    def invoke_aliens(self):
        pass

    def invade_earth(self):
        pass

    def takeover_galaxy(self):
        pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class LaserBeam:
    def __init__(self):
        pass

    def fire(self):
        pass

    def activate_super(self):
        pass

    def destroy_planet(self):
        pass


class Shield:
    def deploy(self):
        pass


class Missile:
    def launch(self):
        pass


class SpaceInvaders:
    def __init__(self):
        self.laser = LaserBeam()
        self.shield = Shield()
        self.missile = Missile()

    def summon_mothership(self):
        pass

    def destroy_planet(self):
        pass

    def teleport(self):
        pass

    def invoke_aliens(self):
        pass

    def invade_earth(self):
        pass

    def takeover_galaxy(self):
        pass

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
max\-public\-methods=7

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
داشتن متدهای عمومی بیش از حد نشان‌دهنده این است که احتمالاً اصل تک‌مسئولیتی
(Single\-responsibility principle یا همان S در SOLID) را رعایت نکرده‌اید.
.sp
کلاس باید تنها یک دلیل برای تغییر داشته باشد، اما در این مثال سفینه فضایی حداقل
۴ فرد یا نقش دارد که می‌توانند درخواست تغییر در آن را داشته باشند
(مدیر لیزر، مدیر سپر دفاعی، مدیر موشک، مسئول دورنوردی...).
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
اصل تک‌مسئولیتی (Single\-responsibility principle) \%<https://\:en\:.wikipedia\:.org/\:wiki/\:Single-responsibility_principle>
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده design \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:design_analysis\:.py>..SS too\-many\-return\-statements / R0911
.sp
\fBپیام صادرشده:\fP
.sp
\fBتعداد بیش از حد دستورهای return (%s/%s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک تابع یا متد بیش از حد دستور return داشته باشد که دنبال کردن آن را دشوار می‌سازد.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def to_string(x):  # [too\-many\-return\-statements]
    # max of 6 by default, can be configured
    if x == 1:
        return \(dqThis is one.\(dq
    if x == 2:
        return \(dqThis is two.\(dq
    if x == 3:
        return \(dqThis is three.\(dq
    if x == 4:
        return \(dqThis is four.\(dq
    if x == 5:
        return \(dqThis is five.\(dq
    if x == 6:
        return \(dqThis is six.\(dq
    if x == 7:
        return \(dqThis is seven.\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
NUMBERS_TO_STRINGS = {
    1: \(dqone\(dq,
    2: \(dqtwo\(dq,
    3: \(dqthree\(dq,
    4: \(dqfour\(dq,
    5: \(dqfive\(dq,
    6: \(dqsix\(dq,
    7: \(dqseven\(dq,
}


def to_string(x):
    return f\(dqThis is {NUMBERS_TO_STRINGS.get(x)}.\(dq

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بازبین design \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:design_analysis\:.py>.
.SS too\-many\-statements / R0915
.sp
\fBپیام صادرشده:\fP
.sp
\fBتعداد بیش از حد دستورها (%s/%s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک تابع یا متد بیش از حد دستور داشته باشد. در این صورت باید آن را به توابع / متدهای کوچک‌تر تقسیم کنید.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import random


def distribute_candies(  # [too\-many\-statements]
    children: list[Child], candies_per_child: int
):
    # This function is a masterpiece of code that embodies the epitome of efficiency
    # it\(aqs also an essential part of a high\-priority project with extremely tight deadlines
    # and there is absolutely no time to refactor it to make it more concise.
    # The lead developer on the project, who has decades of experience,
    # has personally reviewed this implementation and deemed it good enough as it is.
    # The person writing this code has a demanding job and multiple responsibilities,
    # and simply does not have the luxury of spending time making this code more readable.
    total_candies = len(children) * candies_per_child
    eaten_candies = 0
    # Counting candies given to each child
    for child in children:
        # If a child eat more than 1 candies they\(aqre going to eat all
        # the candies for sure
        eaten_for_child = random.choices([0, 1, candies_per_child])
        print(
            f\(dqChild {child} gets {candies_per_child} candies and eat {eaten_for_child}\(dq
        )
        remaining_candies_for_children = child.eat_candies(eaten_for_child)
        if remaining_candies_for_children == 0:
            print(f\(dqAll the candies have been devoured by {child.name}!\(dq)
        else:
            print(
                f\(dq{child.name} still have {remaining_candies_for_children} candies left.\(dq
            )
        eaten_candies += eaten_for_child
    return eaten_candies, total_candies

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import random


def distribute_candies(children: list[Child], candies_per_child: int):
    total_candies = len(children) * candies_per_child
    eaten_candies = 0
    for child in children:
        eaten_candies += _distribute_candies_to_child(candies_per_child, child)
    return eaten_candies, total_candies


def _distribute_candies_to_child(candies_per_child: int, child: Child):
    # If a child eat more than 1 candies they\(aqre going to eat all
    # the candies for sure
    eaten_for_child = random.choices([0, 1, candies_per_child])
    print(f\(dqChild {child} gets {candies_per_child} candies and eat {eaten_for_child}\(dq)
    remaining_candies_for_children = child.eat_candies(eaten_for_child)
    if remaining_candies_for_children == 0:
        print(f\(dqAll the candies have been devoured by {child.name}!\(dq)
    else:
        print(f\(dq{child.name} still have {remaining_candies_for_children} candies left.\(dq)
    return eaten_for_child

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[DESIGN]
max\-statements=7

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بازبین design \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:design_analysis\:.py>..SS trailing\-comma\-tuple / R1707
.sp
\fBپیام صادرشده:\fP
.sp
\fBعدم مجاز بودن تاپل با ویرگول پایانی\fP
.sp
\fBتوضیحات:\fP
.sp
\fIدر پایتون، یک تاپل در واقع با نماد ویرگول ایجاد می‌شود، نه با پرانتزها. متأسفانه ممکن است با قرار دادن اشتباه یک ویرگول پایانی ندانسته یک تاپل ایجاد شود که می‌تواند منجر به باگ‌های عجیب بالقوه‌ای در کد شما گردد. همیشه باید برای ایجاد تاپل به‌طور صریح از پرانتز استفاده کنید.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
COMPASS = \(dqnorth\(dq, \(dqsouth\(dq, \(dqeast\(dq, \(dqwest\(dq,  # [trailing\-comma\-tuple]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
COMPASS = (\(dqnorth\(dq, \(dqsouth\(dq, \(dqeast\(dq, \(dqwest\(dq)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>.
.SS unnecessary\-comprehension / R1721
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده غیرضروری از comprehension، به جای آن از %s استفاده کنید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIبه جای استفاده از یک identity comprehension، استفاده از سازندهٔ list، dict یا set را در نظر بگیرید. این روش سریع‌تر و ساده‌تر است.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
NUMBERS = [1, 1, 2, 2, 3, 3]

UNIQUE_NUMBERS = {number for number in NUMBERS}  # [unnecessary\-comprehension]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
NUMBERS = [1, 1, 2, 2, 3, 3]

UNIQUE_NUMBERS = set(NUMBERS)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>.
.SS unnecessary\-default\-type\-args / R6007
.sp
\fBپیام صادرشده:\fP
.sp
\fBنوع \(ga%s\(ga دارای آرگومان‌های نوع پیش‌فرض غیرضروری است. آن را به \(ga%s\(ga تغییر دهید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که نوع‌ها دارای آرگومان‌های نوع پیش‌فرضی باشند که می‌توان آن‌ها را حذف کرد. بیشتر برای \(gatyping.Generator\(ga و \(gatyping.AsyncGenerator\(ga استفاده می‌شود.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from collections.abc import AsyncGenerator, Generator

a1: AsyncGenerator[int, None]  # [unnecessary\-default\-type\-args]
b1: Generator[int, None, None]  # [unnecessary\-default\-type\-args]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from collections.abc import AsyncGenerator, Generator

a1: AsyncGenerator[int]
b1: Generator[int]

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[main]
load\-plugins=pylint.extensions.typing

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
در حال حاضر، این بررسی تنها برای \fBGenerator\fP و \fBAsyncGenerator\fP\& کار می‌کند.
.sp
از Python 3.13 به بعد، مقدار پیش‌فرض \fBSendType\fP و \fBReturnType\fP برابر با \fBNone\fP\& است.
به همین دلیل، دیگر مشخص کردن آن‌ها ضروری نیست. گونه‌های \fBcollections.abc\fP
تعداد آرگومان‌های نوع را اعتبارسنجی نمی‌کنند؛ بنابراین مقادیر پیش‌فرض این موارد
می‌تواند در نسخه‌های پیشین نیز استفاده شود.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
مستندات Python برای AsyncGenerator \%<https://\:docs\:.python\:.org/\:3\:.13/\:library/\:typing\:.html#\:typing\:.AsyncGenerator>
.IP \(bu 2
مستندات Python برای Generator \%<https://\:docs\:.python\:.org/\:3\:.13/\:library/\:typing\:.html#\:typing\:.Generator>
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کنندهٔ اختیاری \(aqtyping\(aq \%<#\:pylint-extensions-typing>
صادر می‌شود، که نیازمند بارگذاری پلاگین \fBpylint.extensions.typing\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ typing \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:typing\:.py>..SS unnecessary\-dict\-index\-lookup / R1733
.sp
\fBپیام صادرشده:\fP
.sp
\fBجستجوی غیرضروری اندیس دیکشنری، به‌جای آن از \(aq%s\(aq استفاده کنید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگام پیمایش روی آیتم‌های دیکشنری (جفت‌های کلید\-آیتم) و دسترسی به مقدار از طریق جستجوی اندیس صادر می‌شود. به‌جای این کار می‌توان مستقیماً به مقدار دسترسی داشت.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
FRUITS = {\(dqapple\(dq: 1, \(dqorange\(dq: 10, \(dqberry\(dq: 22}

for fruit_name, fruit_count in FRUITS.items():
    print(FRUITS[fruit_name])  # [unnecessary\-dict\-index\-lookup]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
FRUITS = {\(dqapple\(dq: 1, \(dqorange\(dq: 10, \(dqberry\(dq: 22}

for fruit_name, fruit_count in FRUITS.items():
    print(fruit_count)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>.
.SS unnecessary\-list\-index\-lookup / R1736
.sp
\fBپیام صادرشده:\fP
.sp
\fBجستجوی غیرضروری اندیس لیست، به‌جای آن از \(aq%s\(aq استفاده کنید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگام پیمایش روی یک شمارش (enumeration) و دسترسی به مقدار از طریق جستجوی اندیس صادر می‌شود. به‌جای این کار می‌توان مستقیماً به مقدار دسترسی داشت.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
letters = [\(dqa\(dq, \(dqb\(dq, \(dqc\(dq]

for index, letter in enumerate(letters):
    print(letters[index])  # [unnecessary\-list\-index\-lookup]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
letters = [\(dqa\(dq, \(dqb\(dq, \(dqc\(dq]

for index, letter in enumerate(letters):
    print(letter)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>.
.SS use\-a\-generator / R1729
.sp
\fBپیام صادرشده:\fP
.sp
\fBبه‌جای \(aq%s(%s)\(aq از یک مولد استفاده کنید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIاستفاده از comprehension درون توابع \(aqany\(aq، \(aqall\(aq، \(aqmax\(aq، \(aqmin\(aq یا \(aqsum\(aq غیرضروری است. یک مولد (generator) کافی بوده و سریع‌تر خواهد بود.\fP
.sp
\fBکد مشکل‌دار:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from random import randint

all([randint(\-5, 5) > 0 for _ in range(10)])  # [use\-a\-generator]
any([randint(\-5, 5) > 0 for _ in range(10)])  # [use\-a\-generator]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from random import randint

all(randint(\-5, 5) > 0 for _ in range(10))
any(randint(\-5, 5) > 0 for _ in range(10))

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
با استفاده از یک مولد، می‌توانید درخت اجرا را کوتاه کرده و به‌جای محاسبهٔ همهٔ عناصر، مستقیماً در نخستین عنصری که برای \fBall\fP برابر با \fBFalse\fP یا برای \fBany\fP برابر با \fBTrue\fP است خارج شوید. به‌جز در بدترین حالت ممکن که در آن همچنان باید همه‌چیز ارزیابی شود (همهٔ مقادیر برای \fBall\fP برابر با True باشند یا همهٔ مقادیر برای \fBany\fP برابر با false باشند)، عملکرد بهتر خواهد بود.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
PEP 289 – Generator Expressions \%<https://\:peps\:.python\:.org/\:pep-0289>
.IP \(bu 2
بنچمارک و گفتگو در زمان پیاده‌سازی اولیه \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:pull/\:3309#\:discussion_r576683109>
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>..SS use\-dict\-literal / R1735
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از \(aq%s\(aq را به‌جای فراخوانی \(aqdict\(aq در نظر بگیرید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که برای ایجاد یک دیکشنری به‌جای لیترال \(aq{ ... }\(aq از ()dict استفاده شود. لیترال سریع‌تر است زیرا از یک فراخوانی تابع اضافی جلوگیری می‌کند.\fP
.sp
\fBکد دارای اشکال:\fP
.sp
\fBempty_dict.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
empty_dict = dict()  # [use\-dict\-literal]

.EE
.UNINDENT
.UNINDENT
.sp
\fBinit_dict_from_another.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
original_dict = {\(dqname\(dq: \(dqSunny\(dq, \(dqage\(dq: 10, \(dqfavorite_color\(dq: \(dqyellow\(dq}
copied_dict = dict(**original_dict)  # [use\-dict\-literal]

.EE
.UNINDENT
.UNINDENT
.sp
\fBinit_with_keyword.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
response_dict = dict(answer=\(dqNo\(dq)  # [use\-dict\-literal]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.sp
\fBempty_dict.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
empty_dict = {}

.EE
.UNINDENT
.UNINDENT
.sp
\fBinit_dict_from_another.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
original_dict = {\(dqname\(dq: \(dqSunny\(dq, \(dqage\(dq: 10, \(dqfavorite_color\(dq: \(dqyellow\(dq}
# shallow copy a dict
copied_dict = {**original_dict}

.EE
.UNINDENT
.UNINDENT
.sp
\fBinit_with_literal.py\fP:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
response_dict = {\(dqanswer\(dq: \(dqNo\(dq}

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
\%<https://\:gist\:.github\:.com/\:hofrob/\:ad143aaa84c096f42489c2520a3875f9>
.sp
این اسکریپت نمونه ۱۸٪ افزایش کارایی را هنگام استفاده از لیترال به‌جای
سازنده در پایتون نسخهٔ 3.10.6 نشان می‌دهد.
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
تحلیل کارایی ()dict در برابر لیترال دیکشنری در پایتون \%<https://\:madebyme\:.today/\:blog/\:python-dict-vs-curly-brackets>
.UNINDENT
.sp
ایجادشده توسط بازرس refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>..SS use\-list\-literal / R1734
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از [] به‌جای ()list را در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی صادر می‌شود که به‌جای لیترال []، از ()list برای ایجاد یک لیست خالی استفاده شود. لیترال سریع‌تر است زیرا از یک فراخوانی تابع اضافی جلوگیری می‌کند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
empty_list = list()  # [use\-list\-literal]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
empty_list = []

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>.
.SS use\-set\-for\-membership / R6201
.sp
\fBپیام صادرشده:\fP
.sp
\fBاستفاده از set را برای بررسی عضویت در نظر بگیرید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIبررسی‌های عضویت زمانی که روی یک نوع داده بهینه‌شده برای جستجو (مانند \(ga\(gasets\(ga\(ga) انجام شوند، کارآمدتر هستند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def fruit_is_dangerous_for_cat(fruit: str) \-> bool:
    \(dq\(dq\(dqThis list is only a silly example, don\(aqt make decision regarding your cat diet based on it.\(dq\(dq\(dq
    return fruit in [\(dqcherry\(dq, \(dqgrapes\(dq]  # [use\-set\-for\-membership]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def fruit_is_dangerous_for_cat(fruit: str) \-> bool:
    \(dq\(dq\(dqThis list is only a silly example, don\(aqt make decision regarding your cat diet based on it.\(dq\(dq\(dq
    return fruit in {\(dqcherry\(dq, \(dqgrapes\(dq}

.EE
.UNINDENT
.UNINDENT
.sp
\fBفایل پیکربندی:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[MAIN]
load\-plugins=pylint.extensions.set_membership

.EE
.UNINDENT
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این پیام توسط بررسی‌کننده اختیاری \(aqset_membership\(aq \%<#\:pylint-extensions-set-membership>
صادر می‌شود، که نیازمند بارگذاری افزونه \fBpylint.extensions.set_membership\fP است.
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده set_membership \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:extensions/\:set_membership\:.py>..SS use\-yield\-from / R1737
.sp
\fBپیام صادرشده:\fP
.sp
\fBبه‌جای بازگردانی تک‌تک عناصر، مستقیماً از \(aqyield from\(aq استفاده کنید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIبازگردانی مستقیم از تکرارکننده (iterator) سریع‌تر بوده و مسلماً در مقایسه با بازگردانی تک‌تک عناصر در حلقه، کد تمیزتری است.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def bad_yield_from(generator):
    for item in generator:  # [use\-yield\-from]
        yield item

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def good_yield_from(generator):
    yield from generator

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
می‌توان \fByield from\fP را مانند حذف واسطه (حلقه for شما) میان فراخواننده تابع و مولد (generator) مورد درخواست دانست. این کار به فراخواننده امکان می‌دهد مستقیماً با مولد ارتباط برقرار کند (برای مثال با استفاده از \fBsend()\fP). این ارتباط هنگام بازگردانی دستی تک‌تک عناصر در یک حلقه ممکن نیست.
.sp
سند PEP 380 امکان افزودن بهینه‌سازی‌های خاص به \fByield from\fP\& را شرح می‌دهد. به نظر می‌رسد تا زمان نگارش این مطلب، این موارد پیاده‌سازی نشده‌اند. حتی بدون بهینه‌سازی‌های مذکور، قطعه‌کد زیر نشان می‌دهد که \fByield from\fP اندکی سریع‌تر است.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ python3 \-m timeit \(dqdef yield_from(): yield from range(100)\(dq \(dqfor _ in yield_from(): pass\(dq
100000 loops, best of 5: 2.44 usec per loop
$ python3 \-m timeit \(dqdef yield_loop():\(dq \(dq    for item in range(100): yield item\(dq \(dqfor _ in yield_loop(): pass\(dq
100000 loops, best of 5: 2.49 usec per loop
.EE
.UNINDENT
.UNINDENT
.sp
\fBپیوندهای مرتبط:\fP
.INDENT 0.0
.IP \(bu 2
PEP 380 \%<https://\:peps\:.python\:.org/\:pep-0380>
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده refactoring \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>.
.SS useless\-object\-inheritance / R0205
.sp
\fBپیام صادرشده:\fP
.sp
\fBکلاس %r از object ارث‌بری می‌کند، در python3 می‌توان با اطمینان آن را از پایه‌ها حذف کرد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک کلاس از object ارث‌بری کند؛ این مورد در python3 ضمنی است، بنابراین می‌توان با اطمینان آن را از کلاس‌های پایه حذف کرد.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Banana(object):  # [useless\-object\-inheritance]
    ...

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Banana: ...

.EE
.UNINDENT
.UNINDENT
.sp
ایجاد شده توسط بررسی‌کننده classes \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:classes/\:class_checker\:.py>..SS useless\-return / R1711
.sp
\fBپیام صادرشده:\fP
.sp
\fBدستور return بی‌فایده در پایان تابع یا متد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی صادر می‌شود که یک دستور مجزای \(dqreturn\(dq یا \(dqreturn None\(dq در انتهای تعریف تابع یا متد یافت شود. این دستور را می‌توان با اطمینان حذف کرد زیرا پایتون به‌طور ضمنی None را برمی‌گرداند.\fP
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import sys


def print_python_version():  # [useless\-return]
    print(sys.version)
    return None

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import sys


def print_python_version():
    print(sys.version)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده بازسازی ساختار (refactoring) \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:refactoring/\:refactoring_checker\:.py>.
.sp
تمام پیام‌های تغییرنام‌یافته در دسته‌بندی بازسازی ساختار (refactor):
.SS old\-no\-self\-use / R0201
.sp
پیام \(aqold\-no\-self\-use\(aq تغییر نام یافته است. پیام جدید را می‌توانید در اینجا بیابید:
.SS old\-simplifiable\-if\-statement / R0102
.sp
پیام \(aqold\-simplifiable\-if\-statement\(aq تغییر نام یافته است. پیام جدید را می‌توانید در اینجا بیابید:
.SS old\-too\-many\-nested\-blocks / R0101
.sp
پیام \(aqold\-too\-many\-nested\-blocks\(aq تغییر نام یافته است. پیام جدید را می‌توانید در اینجا بیابید:
.SS اطلاعات (Information)
.sp
تمام پیام‌ها در دسته‌بندی اطلاعات (information):
.SS bad\-inline\-option / I0010
.sp
\fBپیام صادرشده:\fP
.sp
\fBامکان در نظر گرفتن گزینه درون‌خطی %r وجود ندارد\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک گزینه درون‌خطی قالب‌بندی نادرستی داشته باشد یا نتوان از آن در داخل ماژول‌ها استفاده کرد.\fP
.sp
\fBاحتیاط:\fP
.INDENT 0.0
.INDENT 3.5
این پیام به‌طور پیش‌فرض غیرفعال است. برای فعال‌سازی آن، \fBbad\-inline\-option\fP را به گزینه \fBenable\fP اضافه کنید.
.UNINDENT
.UNINDENT
.sp
\fBاحتیاط:\fP
.INDENT 0.0
.INDENT 3.5
به‌طور پیش‌فرض، این پیام مانع از اجرای موفقیت‌آمیز نخواهد شد (pylint مقدار 0 را برمی‌گرداند).
برای اینکه pylint با مواجهه با این پیام با خطا خارج شود، از گزینه \fB\-\-fail\-on=I0010\fP
یا \fB\-\-fail\-on=I\fP جهت توقف با تمام پیام‌های اطلاعاتیِ فعال‌شده استفاده کنید.
.UNINDENT
.UNINDENT
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# 2:[bad\-inline\-option]
# pylint: disable line\-too\-long

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# pylint: disable=line\-too\-long

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کننده اصلی \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:lint/\:pylinter\:.py>..SS c\-extension\-no\-member / I1101
.sp
\fBپیام صادرشده:\fP
.sp
\fBعضو %r در %s %r وجود ندارد%s، اما کد منبع در دسترس نیست. اگر می‌خواهید تحلیل را بر پایهٔ درون‌نگری زمان اجرای اشیاء زنده انجام دهید، افزودن این ماژول به extension\-pkg\-allow\-list را در نظر بگیرید.\fP
.sp
\fBتوضیحات:\fP
.sp
\fIهنگامی استفاده می‌شود که از طریق یک متغیر، به عضوی ناموجود از یک افزونهٔ C دسترسی پیدا شود. به دلیل در دسترس نبودن کد منبع، تحلیل ایستا غیرممکن است، اما می‌تواند با درون‌نگری اشیاء زنده در زمان اجرا انجام شود.\fP
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
به‌طور پیش‌فرض، این پیام مانع از اجرای موفق نخواهد شد (pylint مقدار 0 را برمی‌گرداند).
برای اینکه pylint به ازای این پیام با خطا خارج شود، از گزینهٔ \fB\-\-fail\-on=I1101\fP
یا \fB\-\-fail\-on=I\fP برای خروج همراه با خطا در تمام پیام‌های اطلاعاتی فعال‌شده استفاده کنید.
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
\fBc\-extension\-no\-member\fP یک گونهٔ اطلاعاتی از \fBno\-member\fP است تا اجازه دادن به درون‌نگری افزونه‌های C را طبق آنچه در صفحهٔ \%<https://\:pylint\:.readthedocs\:.io/\:en/\:latest/\:user_guide/\:messages/\:error/\:no-member\:.html> برای \fBno\-member\fP\& شرح داده شده، توصیه کند.
.sp
ایجادشده توسط بررسی‌کنندهٔ typecheck \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:typecheck\:.py>\&.
.SS deprecated\-pragma / I0022
.sp
\fBپیام صادرشده:\fP
.sp
\fBپراگمای \(dq%s\(dq منسوخ شده است، به‌جای آن از \(dq%s\(dq استفاده کنید\fP
.sp
\fBتوضیحات:\fP
.sp
\fIبرخی از گزینه‌های درون‌خطی pylint تغییر نام یافته یا بازنگری شده‌اند؛ فقط باید از جدیدترین شکل آن استفاده شود. یادداشت: skip\-all فقط در pylint >= 0.26 در دسترس است\fP
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
این پیام به‌طور پیش‌فرض غیرفعال است. برای فعال کردن آن، \fBdeprecated\-pragma\fP را به گزینهٔ \fBenable\fP اضافه کنید.
.UNINDENT
.UNINDENT
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
به‌طور پیش‌فرض، این پیام مانع از اجرای موفق نخواهد شد (pylint مقدار 0 را برمی‌گرداند).
برای اینکه pylint به ازای این پیام با خطا خارج شود، از گزینهٔ \fB\-\-fail\-on=I0022\fP
یا \fB\-\-fail\-on=I\fP برای خروج همراه با خطا در تمام پیام‌های اطلاعاتی فعال‌شده استفاده کنید.
.UNINDENT
.UNINDENT
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# pylint: disable\-msg=eval\-used # [deprecated\-pragma]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# pylint: disable = eval\-used

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ اصلی \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:lint/\:pylinter\:.py>\&.
.SS file\-ignored / I0013
.sp
\fBپیام صادرشده:\fP
.sp
\fBنادیده گرفتن کل فایل\fP
.sp
\fBتوضیحات:\fP
.sp
\fIبرای اعلام این‌که فایل بررسی نخواهد شد استفاده می‌شود\fP
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
این پیام به‌طور پیش‌فرض غیرفعال است. برای فعال کردن آن، \fBfile\-ignored\fP را به گزینهٔ \fBenable\fP اضافه کنید.
.UNINDENT
.UNINDENT
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
به‌طور پیش‌فرض، این پیام مانع از اجرای موفق نخواهد شد (pylint مقدار 0 را برمی‌گرداند).
برای اینکه pylint به ازای این پیام با خطا خارج شود، از گزینهٔ \fB\-\-fail\-on=I0013\fP
یا \fB\-\-fail\-on=I\fP برای خروج همراه با خطا در تمام پیام‌های اطلاعاتی فعال‌شده استفاده کنید.
.UNINDENT
.UNINDENT
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# pylint: skip\-file
# \-1: [file\-ignored]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات بیشتر:\fP
.sp
اگر فایلی با \fB# pylint: skip\-file\fP\& شروع شود، اصلاً هیچ بررسی‌ای روی آن انجام نمی‌گیرد.
.sp
ایجادشده توسط بررسی‌کنندهٔ اصلی \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:lint/\:pylinter\:.py>\&..SS locally\-disabled / I0011
.sp
\fBپیام صادرشده:\fP
.sp
\fBغیرفعال‌سازی محلی %s (%s)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک گزینهٔ درون‌خطی یک پیام یا یک دسته از پیام‌ها را غیرفعال کند.\fP
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
این پیام به‌طور پیش‌فرض غیرفعال است. برای فعال کردن آن، \fBlocally\-disabled\fP را به گزینهٔ \fBenable\fP اضافه کنید.
.UNINDENT
.UNINDENT
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
به‌طور پیش‌فرض، این پیام مانع از اجرای موفق نخواهد شد (pylint مقدار 0 را برمی‌گرداند).
برای خروج با خطا در مواجهه با این پیام از گزینهٔ \fB\-\-fail\-on=I0011\fP
یا \fB\-\-fail\-on=I\fP برای خروج با خطا روی تمام پیام‌های اطلاعاتی فعال‌شده استفاده کنید.
.UNINDENT
.UNINDENT
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def wizard_spells(spell_book):
    # pylint: disable=maybe\-no\-member # [locally\-disabled]
    for spell in spell_book:
        print(f\(dqAbracadabra! {spell}.\(dq)


spell_list = [\(dqLevitation\(dq, \(dqInvisibility\(dq, \(dqFireball\(dq, \(dqTeleportation\(dq]
wizard_spells(spell_list)

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد صحیح:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def wizard_spells(spell_book):
    for spell in spell_book:
        print(f\(dqAbracadabra! {spell}.\(dq)


spell_list = [\(dqLevitation\(dq, \(dqInvisibility\(dq, \(dqFireball\(dq, \(dqTeleportation\(dq]
wizard_spells(spell_list)

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ اصلی \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:lint/\:pylinter\:.py>.
.SS raw\-checker\-failed / I0001
.sp
\fBپیام صادرشده:\fP
.sp
\fBعدم امکان اجرای بررسی‌کننده‌های خام روی ماژول توکار %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIبرای اطلاع از این‌که یک ماژول توکار توسط بررسی‌کننده‌های خام بررسی نشده است، استفاده می‌شود.\fP
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
این پیام به‌طور پیش‌فرض غیرفعال است. برای فعال کردن آن، \fBraw\-checker\-failed\fP را به گزینهٔ \fBenable\fP اضافه کنید.
.UNINDENT
.UNINDENT
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
به‌طور پیش‌فرض، این پیام مانع از اجرای موفق نخواهد شد (pylint مقدار 0 را برمی‌گرداند).
برای خروج با خطا در مواجهه با این پیام از گزینهٔ \fB\-\-fail\-on=I0001\fP
یا \fB\-\-fail\-on=I\fP برای خروج با خطا روی تمام پیام‌های اطلاعاتی فعال‌شده استفاده کنید.
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
این پیام هشدار می‌دهد که تحلیل یک ماژول توکار غیرممکن بوده است (یک گره ast از نوع پایتون خالص نیست).
نیازی به تغییر چیزی در کد شما نیست؛ این هشداری دربارهٔ محدودیت‌های astroid و pylint است.
.sp
ایجادشده توسط بررسی‌کنندهٔ اصلی \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:lint/\:pylinter\:.py>..SS suppressed\-message / I0020
.sp
\fBپیام صادرشده:\fP
.sp
\fBSuppressed %s (from line %d)\fP
.sp
\fBتوضیحات:\fP
.sp
\fIپیامی روی یک سطر فعال شده، اما صریحاً توسط یک کامنت disable= در فایل سرکوب شده است. این پیام برای پیام‌هایی که به دلیل تنظیمات پیکربندی نادیده گرفته می‌شوند، تولید نمی‌شود.\fP
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
این پیام به‌طور پیش‌فرض غیرفعال است. برای فعال‌سازی آن، \fBsuppressed\-message\fP را به گزینهٔ \fBenable\fP اضافه کنید.
.UNINDENT
.UNINDENT
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
به‌طور پیش‌فرض، این پیام مانع از اجرای موفق نخواهد شد (pylint مقدار 0 را برمی‌گرداند).
برای اینکه pylint به ازای این پیام با خطا مواجه شود، از گزینهٔ \fB\-\-fail\-on=I0020\fP
یا \fB\-\-fail\-on=I\fP جهت توقف با خطا روی تمامی پیام‌های اطلاعاتی فعال‌شده استفاده کنید.
.UNINDENT
.UNINDENT
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
### This is a contrived example, to show how suppressed\-message works.
### First we enable all messages
# pylint: enable=all

### Here we disable two messages so we get two warnings
# pylint: disable=locally\-disabled, useless\-suppression # [suppressed\-message, suppressed\-message]

### Here we disable a message, so we get a warning for suppressed\-message again.
\(dqA\(dq  # pylint: disable=pointless\-statement # [suppressed\-message, suppressed\-message]

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد تصحیح‌شده:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dq\(dq\(dqInstead of a single string somewhere in the file, write a module docstring!\(dq\(dq\(dq

.EE
.UNINDENT
.UNINDENT
.sp
\fBجزئیات تکمیلی:\fP
.sp
\fBsuppressed\-message\fP صرفاً روشی برای مشاهدهٔ پیام‌هایی است که در صورت عدم وجود disable در پایگاه کد شما نمایش داده می‌شدند.
در بیشتر موارد نیازی به فعال‌سازی آن نیست. همچنین اگر می‌خواهید پیام‌هایی را مشاهده کنید که بدون دلیل غیرفعال شده‌اند،
\fBuseless\-suppression\fP را ببینید.
.sp
ایجادشده توسط بازبین اصلی (checker) در \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:lint/\:pylinter\:.py>.
.SS use\-symbolic\-message\-instead / I0023
.sp
\fBپیام صادرشده:\fP
.sp
\fB%s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی استفاده می‌شود که یک پیام بر اساس شناسه (id) فعال یا غیرفعال شده باشد.\fP
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
این پیام به‌طور پیش‌فرض غیرفعال است. برای فعال‌سازی آن، \fBuse\-symbolic\-message\-instead\fP را به گزینهٔ \fBenable\fP اضافه کنید.
.UNINDENT
.UNINDENT
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
به‌طور پیش‌فرض، این پیام مانع از اجرای موفق نخواهد شد (pylint مقدار 0 را برمی‌گرداند).
برای اینکه pylint به ازای این پیام با خطا مواجه شود، از گزینهٔ \fB\-\-fail\-on=I0023\fP
یا \fB\-\-fail\-on=I\fP جهت توقف با خطا روی تمامی پیام‌های اطلاعاتی فعال‌شده استفاده کنید.
.UNINDENT
.UNINDENT
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruit_name = \(dqplum\(dq


# pylint: disable\-next=W0621
def eat(fruit_name: str):  # [use\-symbolic\-message\-instead]
    ...

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد تصحیح‌شده:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruit_name = \(dqplum\(dq


# pylint: disable\-next=redefined\-outer\-name
def eat(fruit_name: str): ...

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بازبین متفرقه (miscellaneous) در \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:checkers/\:misc\:.py>..SS useless\-suppression / I0021
.sp
\fBپیام صادرشده:\fP
.sp
\fBفرونشانی بی‌استفاده از %s\fP
.sp
\fBتوضیحات:\fP
.sp
\fIزمانی گزارش می‌شود که پیامی به‌طور صریح برای یک خط یا بلوکی از کد غیرفعال شده باشد، اما هرگز رخ ندهد.\fP
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
این پیام به‌طور پیش‌فرض غیرفعال است. برای فعال‌سازی آن، \fBuseless\-suppression\fP را به گزینهٔ \fBenable\fP اضافه کنید.
.UNINDENT
.UNINDENT
.sp
\fBهشدار:\fP
.INDENT 0.0
.INDENT 3.5
به‌طور پیش‌فرض، این پیام موجب شکست در اجرا نخواهد شد (pylint مقدار 0 را بازمی‌گرداند).
برای اینکه pylint به دلیل این پیام با خطا متوقف شود از گزینهٔ \fB\-\-fail\-on=I0021\fP
یا \fB\-\-fail\-on=I\fP جهت شکست در صورت وقوع تمامی پیام‌های اطلاعاتیِ فعال‌شده استفاده کنید.
.UNINDENT
.UNINDENT
.sp
\fBکد دارای مشکل:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruit_counter = 0


# pylint: disable\-next=redefined\-outer\-name
def eat(fruit_name: str):  # [useless\-suppression]
    ...

.EE
.UNINDENT
.UNINDENT
.sp
\fBکد درست:\fP
.INDENT 0.0
.INDENT 3.5
.sp
.EX
fruit_counter = 0


def eat(fruit_name: str): ...

.EE
.UNINDENT
.UNINDENT
.sp
ایجادشده توسط بررسی‌کنندهٔ اصلی \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:build/\:lib/\:pylint/\:lint/\:pylinter\:.py>\&.
.sp
تمامی پیام‌های تغییرنام‌یافته در دسته‌بندی اطلاعات:
.SS deprecated\-disable\-all / I0014
.sp
پیام \(aqdeprecated\-disable\-all\(aq تغییر نام یافته است. پیام جدید را می‌توانید در این آدرس بیابید:
.SS کنترل پیام‌ها (Messages control)
.sp
به منظور کنترل پیام‌ها، \fBpylint\fP مقادیر زیر را می‌پذیرد:
.INDENT 0.0
.IP \(bu 2
یک پیام نمادین: \fBno\-member\fP، \fBundefined\-variable\fP و غیره.
.IP \(bu 2
یک شناسهٔ عددی: \fBE1101\fP، \fBE1102\fP و غیره.
.IP \(bu 2
نام گروهی از بررسی‌ها. می‌توانید آن‌ها را با \fBpylint \-\-list\-groups\fP به دست آورید.
برای مثال، می‌توانید تمام بررسی‌های مربوط به بررسی نوع را با
\fBtypecheck\fP یا تمام بررسی‌های مربوط به متغیرها را با \fBvariables\fP غیرفعال / فعال کنید.
.IP \(bu 2
دسته‌بندی متناظر بررسی‌ها
.INDENT 2.0
.IP \(bu 2
\fBC\fP بررسی‌های مربوط به شیوه‌نامه‌ها و قراردادها (convention)
.IP \(bu 2
\fBR\fP بررسی‌های مربوط به بازنویسی و بازسازی کد (refactoring)
.IP \(bu 2
\fBW\fP هشدارهای گوناگون (warnings)
.IP \(bu 2
\fBE\fP خطاها، برای باگ‌های احتمالی در کد (errors)
.IP \(bu 2
\fBF\fP خطای مهلک (fatal)، در صورتی که خطایی مانع از ادامهٔ پردازش توسط \fBpylint\fP شود.
.UNINDENT
.IP \(bu 2
تمامی بررسی‌ها با \fBall\fP
.UNINDENT.SS غیرفعال‌سازی‌های بلوکی (Block disables)
.sp
این بخش نحوهٔ عملکرد کنترل‌های پراگما را در سطح کد شرح می‌دهد.
.sp
کنترل‌های پراگما می‌توانند موارد زیر را غیرفعال / فعال کنند:
.INDENT 0.0
.IP \(bu 2
تمامی تخطی‌ها در یک خط واحد
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
a, b = ... # pylint: disable=unbalanced\-tuple\-unpacking
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
تمامی تخطی‌ها در خط بعدی
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# pylint: disable\-next=unbalanced\-tuple\-unpacking
a, b = ...
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
تمامی تخطی‌ها در یک حوزه (scope)
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def test():
    # Disable all the no\-member violations in this function
    # pylint: disable=no\-member
    ...
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
تمامی تخطی‌ها در یک \fIبلوک\fP\&. برای نمونه، هر شاخهٔ مجزا از یک دستور
\fBif\fP یک بلوک جداگانه در نظر گرفته می‌شود، همان‌طور که در مثال زیر آمده است:
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def meth5(self):
    # pylint: disable=no\-member
    # no error
    print(self.bla)
    if self.blop:
        # pylint: enable=no\-member
        # enable all no\-members for this block
        print(self.blip)
    else:
        # This is affected by the scope disable
        print(self.blip)
    # pylint: enable=no\-member
    print(self.blip)
    if self.blop:
        # pylint: disable=no\-member
        # disable all no\-members for this block
        print(self.blip)
    else:
        # This emits a violation
        print(self.blip)
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
اگر تخطی در خط آغازین یک بلوک رخ دهد، تنها بر همان خط اعمال می‌شود
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
if self.blop: # pylint: disable=no\-member; applies only to this line
    # Here we get an error
    print(self.blip)
else:
    # error
    print(self.blip)
.EE
.UNINDENT
.UNINDENT
.sp
در اینجا مثالی آورده شده است که تمام این قواعد را یک‌جا نشان می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dq\(dq\(dqpylint option block\-disable\(dq\(dq\(dq

__revision__ = None

class Foo(object):
    \(dq\(dq\(dqblock\-disable test\(dq\(dq\(dq

    def __init__(self):
        pass

    def meth1(self, arg):
        \(dq\(dq\(dqthis issues a message\(dq\(dq\(dq
        print(self)

    def meth2(self, arg):
        \(dq\(dq\(dqand this one not\(dq\(dq\(dq
        # pylint: disable=unused\-argument
        print(self\e
              + \(dqfoo\(dq)

    def meth3(self):
        \(dq\(dq\(dqtest one line disabling\(dq\(dq\(dq
        # no error
        print(self.bla) # pylint: disable=no\-member
        # error
        print(self.blop)

    def meth4(self):
        \(dq\(dq\(dqtest re\-enabling\(dq\(dq\(dq
        # pylint: disable=no\-member
        # no error
        print(self.bla)
        print(self.blop)
        # pylint: enable=no\-member
        # error
        print(self.blip)

    def meth5(self):
        \(dq\(dq\(dqtest IF sub\-block re\-enabling\(dq\(dq\(dq
        # pylint: disable=no\-member
        # no error
        print(self.bla)
        if self.blop:
            # pylint: enable=no\-member
            # error
            print(self.blip)
        else:
            # no error
            print(self.blip)
        # no error
        print(self.blip)

    def meth6(self):
        \(dq\(dq\(dqtest TRY/EXCEPT sub\-block re\-enabling\(dq\(dq\(dq
        # pylint: disable=no\-member
        # no error
        print(self.bla)
        try:
            # pylint: enable=no\-member
            # error
            print(self.blip)
        except UndefinedName: # pylint: disable=undefined\-variable
            # no error
            print(self.blip)
        # no error
        print(self.blip)

    def meth7(self):
        \(dq\(dq\(dqtest one line block opening disabling\(dq\(dq\(dq
        if self.blop: # pylint: disable=no\-member
            # error
            print(self.blip)
        else:
            # error
            print(self.blip)
        # error
        print(self.blip)

    def meth8(self):
        \(dq\(dq\(dqtest late disabling\(dq\(dq\(dq
        # error
        print(self.blip)
        # pylint: disable=no\-member
        # no error
        print(self.bla)
        print(self.blop)

    def meth9(self):
        \(dq\(dq\(dqtest next line disabling\(dq\(dq\(dq
        # no error
        # pylint: disable\-next=no\-member
        print(self.bla)
        # error
        print(self.blop)
.EE
.UNINDENT
.UNINDENT.SS تشخیص غیرفعال‌سازی‌های بلااستفاده
.sp
همان‌طور که pylint بهبود می‌یابد و موارد مثبت کاذب (false positives) برطرف می‌شوند، غیرفعال‌سازی‌هایی که بی‌استفاده شده‌اند می‌توانند انباشته شده و کد را نامرتب کنند. به منظور پاک‌سازی آن‌ها، می‌توانید هشدار \fBuseless\-suppression\fP را فعال کنید.
.SS دسته‌بندی‌های پیام‌ها
.sp
ابزار Pylint می‌تواند پیام‌های گوناگونی صادر کند. این پیام‌ها بر اساس دسته‌های متناظر با کدهای خروج کدگذاری‌شده با بیت (bit\-encoded) طبقه‌بندی می‌شوند:
.INDENT 0.0
.IP \(bu 2
Fatal \%<#\:fatal-category> (1)
.IP \(bu 2
Error \%<#\:error-category> (2)
.IP \(bu 2
Warning \%<#\:warning-category> (4)
.IP \(bu 2
Convention \%<#\:convention-category> (8)
.IP \(bu 2
Refactor \%<#\:refactor-category> (16)
.IP \(bu 2
Information \%<#\:information-category> (NA)
.UNINDENT
.sp
نمای کلی این پیام‌ها را می‌توان در بخش Messages overview \%<#\:messages-overview> یافت.
.SS غیرفعال‌سازی پیام‌ها
.sp
ابزار \fBpylint\fP سازوکار پیشرفته‌ای برای کنترل پیام‌های بررسی‌های خود دارد و امکان فعال یا غیرفعال کردن پیام‌ها را چه از خط فرمان، چه از فایل پیکربندی و همچنین از داخل خود کد فراهم می‌کند.
.sp
برای جزئیات بیشتر Messages control \%<#\:message-control> را ببینید.
.SS پیکربندی
.sp
ابزار Pylint بسیار پیکربندی‌پذیر است. گزینه‌های فراوانی برای برآورده کردن نیازهای پروژه‌های گوناگون و بررسی‌های پرشماری برای فعال‌سازی در صورت سازگاری با شیوه نگارش شما وجود دارد.
.sp
می‌توانید یک فایل پیکربندی نمونه را با \fB\-\-generate\-toml\-config\fP یا \fB\-\-generate\-rcfile\fP ایجاد کنید\&. هر گزینه‌ای که پیش از این در خط فرمان مشخص شده باشد، در این فایل گنجانده خواهد شد.
.sp
برای نمونه:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pylint \-\-disable=bare\-except,invalid\-name \-\-class\-rgx=\(aq[A\-Z][a\-z]+\(aq \-\-generate\-toml\-config
.EE
.UNINDENT
.UNINDENT
.sp
در عمل، اغلب بهتر است یک فایل پیکربندی حداقلی بسازید که تنها شامل بازنویسی‌های پیکربندی (overrides) باشد. برای سایر گزینه‌ها، Pylint از مقادیر پیش‌فرض خود استفاده خواهد کرد.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
سازوکارهای درونی که فایل‌های پیکربندی را می‌سازند، در صورتی که مقدار دیگری تعیین نشده باشد، به مقادیر پیش‌فرض بازمی‌گردند. این بدان معناست که برخی مقادیر به مفسری که برای ایجاد فایل استفاده شده است بستگی دارند؛ به‌ویژه \fBpy\-version\fP که پیش‌فرض آن مفسر کنونی است.
.UNINDENT
.UNINDENT
.SS بررسی‌کننده‌های استاندارد
.SS بررسی‌کننده \fBMain\fP
.SS \-\-analyse\-fallback\-blocks
.sp
\fIتحلیل بلوک‌های جایگزین وارد کردن (import fallback blocks). این گزینه می‌تواند برای پشتیبانی از کدهای سازگار با هر دو نسخه پایتون ۲ و ۳ استفاده شود، به این معنی که بلوک ممکن است کدی داشته باشد که فقط در یکی از مفسرها وجود دارد و هنگام تحلیل، منجر به موارد مثبت کاذب شود.\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP
.SS \-\-clear\-cache\-post\-run
.sp
\fIپاک‌سازی حافظه‌های موقت درون‌حافظه‌ای (in\-memory caches) پس از پایان بررسی کد (linting). در صورت اجرای pylint در حالتی شبیه به سرور مفید است.\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP
.SS \-\-confidence
.sp
\fIتنها نمایش هشدارهایی با سطوح اطمینان فهرست‌شده. برای نمایش همه، این مقدار را خالی بگذارید. سطوح معتبر: HIGH، CONTROL_FLOW، INFERENCE، INFERENCE_FAILURE، UNDEFINED.\fP
.sp
\fBپیش‌فرض:\fP  \fB[\(aqHIGH\(aq, \(aqCONTROL_FLOW\(aq, \(aqINFERENCE\(aq, \(aqINFERENCE_FAILURE\(aq, \(aqUNDEFINED\(aq]\fP.SS \-\-disable
.sp
\fIپیام، گزارش، دسته‌بندی یا بررسی‌کننده (checker) با شناسه‌(های) داده‌شده را غیرفعال می‌کند. می‌توانید چندین شناسه را با ویرگول (,) جدا کنید یا این گزینه را چندین بار به کار ببرید (تنها در خط فرمان، نه در فایل پیکربندی که در آن باید فقط یک بار بیاید). همچنین می‌توانید از \(dq\-\-disable=all\(dq برای غیرفعال‌سازی همه‌چیز در ابتدا و سپس فعال‌سازی مجدد بررسی‌های مشخص استفاده کنید. به عنوان مثال، اگر می‌خواهید تنها بررسی‌کننده شباهت‌ها را اجرا کنید، می‌توانید از \(dq\-\-disable=all \-\-enable=similarities\(dq بهره ببرید. اگر می‌خواهید تنها بررسی‌کننده کلاس‌ها اجرا شود اما هیچ پیامی در سطح Warning نمایش داده نشود، از \(dq\-\-disable=all \-\-enable=classes \-\-disable=W\(dq استفاده کنید.\fP
.sp
\fBپیش‌فرض:\fP  \fB()\fP
.SS \-\-enable
.sp
\fIپیام، گزارش، دسته‌بندی یا بررسی‌کننده با شناسه‌(های) داده‌شده را فعال می‌کند. می‌توانید چندین شناسه را با ویرگول (,) جدا کرده یا این گزینه را چندین بار درج کنید (تنها در خط فرمان، نه در فایل پیکربندی که در آن باید فقط یک بار بیاید). برای مثال‌ها گزینه \(dq\-\-disable\(dq را نیز ببینید.\fP
.sp
\fBپیش‌فرض:\fP  \fB()\fP
.SS \-\-evaluation
.sp
\fIعبارت پایتونی که باید امتیازی کمتر یا مساوی ۱۰ بازگرداند. شما به متغیرهای \(aqfatal\(aq، \(aqerror\(aq، \(aqwarning\(aq، \(aqrefactor\(aq، \(aqconvention\(aq و \(aqinfo\(aq که شامل تعداد پیام‌ها در هر دسته‌بندی هستند، و همچنین \(aqstatement\(aq که تعداد کل دستورهای تحلیل‌شده است دسترسی دارید. این امتیاز توسط گزارش ارزیابی سراسری (RP0004) استفاده می‌شود.\fP
.sp
\fBپیش‌فرض:\fP  \fBmax(0, 0 if fatal else 10.0 \- ((float(5 * error + warning + refactor + convention) / statement) * 10))\fP
.SS \-\-exit\-zero
.sp
\fIهمیشه یک کد وضعیت 0 (غیرخطا) بازمی‌گرداند، حتی اگر خطاهای lint پیدا شوند. این قابلیت اساساً در اسکریپت‌های یکپارچه‌سازی مداوم (CI) مفید است.\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP
.SS \-\-extension\-pkg\-allow\-list
.sp
\fIفهرستی جداشده با ویرگول از نام بسته‌ها یا ماژول‌هایی که افزونه‌های C ممکن است از آن‌ها بارگذاری شوند. افزونه‌ها در مفسر فعال پایتون بارگذاری می‌شوند و ممکن است کدهای دلخواه را اجرا کنند.\fP
.sp
\fBپیش‌فرض:\fP  \fB[]\fP
.SS \-\-extension\-pkg\-whitelist
.sp
\fIفهرستی جداشده با ویرگول از نام بسته‌ها یا ماژول‌هایی که افزونه‌های C ممکن است از آن‌ها بارگذاری شوند. افزونه‌ها در مفسر فعال پایتون بارگذاری می‌شوند و ممکن است کدهای دلخواه را اجرا کنند. (این نامی جایگزین برای extension\-pkg\-allow\-list جهت سازگاری با نسخه‌های پیشین است.)\fP
.sp
\fBپیش‌فرض:\fP  \fB[]\fP
.SS \-\-fail\-on
.sp
\fIاگر هر یک از این پیام‌ها/دسته‌بندی‌ها شناسایی شوند، کد خروج غیرصفر بازمی‌گرداند، حتی اگر امتیاز بالاتر از مقدار \-\-fail\-under باشد. نحو نگارش آن مشابه enable است. پیام‌های مشخص‌شده فعال می‌شوند، در حالی که دسته‌بندی‌ها تنها پیام‌های از پیش فعال‌شده را بررسی می‌کنند.\fP
.sp
\fBپیش‌فرض:\fP \fB\(dq\(dq\fP
.SS \-\-fail\-under
.sp
\fIآستانه امتیازی را مشخص می‌کند که پایین‌تر از آن، برنامه با خطا خارج خواهد شد.\fP
.sp
\fBپیش‌فرض:\fP  \fB10\fP
.SS \-\-from\-stdin
.sp
\fIورودی استاندارد (stdin) را به عنوان یک اسکریپت پایتون تفسیر می‌کند که نام فایل آن باید به عنوان آرگومان module_or_package فرستاده شود.\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP
.SS \-\-ignore
.sp
\fIفایل‌ها یا دایرکتوری‌هایی که باید نادیده گرفته شوند. این موارد باید نام پایه (base name) باشند، نه مسیر کامل.\fP
.sp
\fBپیش‌فرض:\fP  \fB(\(aqCVS\(aq,)\fP
.SS \-\-ignore\-paths
.sp
\fIافزودن فایل‌ها یا دایرکتوری‌های منطبق بر الگوهای عبارات منظم (regex) به فهرست نادیده‌گرفته‌شده‌ها (ignore\-list). عبارت منظم در برابر مسیرها سنجیده می‌شود و می‌تواند در قالب Posix یا Windows باشد. از آنجا که \(aq\e\(aq در سامانه‌های Windows نشان‌دهنده جداکننده دایرکتوری است، نمی‌تواند به عنوان نویسه گریز (escape character) استفاده شود.\fP
.sp
\fBپیش‌فرض:\fP  \fB[]\fP
.SS \-\-ignore\-patterns
.sp
\fIفایل‌ها یا دایرکتوری‌های منطبق بر الگوهای عبارات منظم نادیده گرفته می‌شوند. عبارت منظم با نام‌های پایه سنجیده می‌شود، نه مسیرها. مقدار پیش‌فرض، قفل‌های فایل Emacs را نادیده می‌گیرد.\fP
.sp
\fBپیش‌فرض:\fP  \fB(re.compile(\(aq^\e\e.#\(aq),)\fP
.SS \-\-ignored\-modules
.sp
\fIفهرستی از نام ماژول‌هایی که صفت‌های عضو آن‌ها نباید بررسی شود و وارد (import) نخواهند شد (برای ماژول‌ها/پروژه‌هایی که در آن‌ها فضاهای نام در زمان اجرا دستکاری می‌شوند و بنابراین صفت‌های عضو موجود از طریق تحلیل ایستا قابل استنتاج نیستند مفید است). این گزینه از نام‌های واجد شرایط (qualified) ماژول و همچنین تطبیق الگوی یونیکس پشتیبانی می‌کند.\fP
.sp
\fBپیش‌فرض:\fP  \fB()\fP
.SS \-\-jobs
.sp
\fIاستفاده از چند پردازش برای افزایش سرعت Pylint. مشخص کردن 0 باعث شناسایی خودکار تعداد پردازنده‌های در دسترس برای استفاده می‌شود و در Windows تعداد را محدود می‌کند تا از قفل شدن برنامه جلوگیری شود.\fP
.sp
\fBپیش‌فرض:\fP  \fB1\fP
.SS \-\-limit\-inference\-results
.sp
\fIمهار تعداد مقادیر استنتاج‌شده بالقوه هنگام استنتاج یک شیء منفرد. این کار می‌تواند به بهبود عملکرد هنگام کار با توابع بزرگ یا شرایط تودرتو و پیچیده کمک کند.\fP
.sp
\fBپیش‌فرض:\fP  \fB100\fP
.SS \-\-load\-plugins
.sp
\fIفهرستی از پلاگین‌ها (به صورت مقادیر جداشده با ویرگول از نام ماژول‌های پایتون) برای بارگذاری، معمولاً جهت ثبت بررسی‌کننده‌های اضافی.\fP
.sp
\fBپیش‌فرض:\fP  \fB()\fP.SS \-\-msg\-template
.sp
\fIقالب مورد استفاده برای نمایش پیام‌ها. این یک رشته قالب‌بندی سبک جدید پایتون (new\-style format string) است که برای قالب‌بندی اطلاعات پیام استفاده می‌شود. برای تمام جزئیات به مستندات مراجعه کنید.\fP
.sp
\fBپیش‌فرض:\fP \fB\(dq\(dq\fP
.SS \-\-output\-format
.sp
\fIتعیین قالب خروجی. قالب‌های موجود عبارتند از: \(aqtext\(aq، \(aqparseable\(aq، \(aqcolorized\(aq، \(aqjson2\(aq (قالب json بهبودیافته)، \(aqjson\(aq (قالب json قدیمی)، msvs (ویژوال استودیو) و \(aqgithub\(aq (GitHub actions). همچنین می‌توانید یک کلاس گزارش‌گر مشخص کنید، به عنوان مثال mypackage.mymodule.MyReporterClass.\fP
.sp
\fBپیش‌فرض:\fP  \fBtext\fP
.SS \-\-persistent
.sp
\fIذخیره (pickle) داده‌های جمع‌آوری‌شده برای مقایسه‌های بعدی.\fP
.sp
\fBپیش‌فرض:\fP  \fBTrue\fP
.SS \-\-prefer\-stubs
.sp
\fIارجاع واردسازی‌ها (imports) به استاب‌های pyi. در صورت موجود بودن. ممکن است پیام‌های no\-member را کاهش داده و پیام‌های not\-an\-iterable را افزایش دهد.\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP
.SS \-\-py\-version
.sp
\fIحداقل نسخه پایتون جهت استفاده در بررسی‌های وابسته به نسخه. پیش‌فرض، نسخه‌ای است که برای اجرای pylint استفاده شده است.\fP
.sp
\fBپیش‌فرض:\fP  \fBsys.version_info[:2]\fP
.SS \-\-recursive
.sp
\fIکشف و شناسایی ماژول‌ها و بسته‌های پایتون در زیردرخت سیستم فایل.\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP
.SS \-\-reports
.sp
\fIمشخص می‌کند که آیا یک گزارش کامل نمایش داده شود یا فقط پیام‌ها.\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP
.SS \-\-score
.sp
\fIفعال کردن امتیاز ارزیابی.\fP
.sp
\fBپیش‌فرض:\fP  \fBTrue\fP
.SS \-\-source\-roots
.sp
\fIافزودن مسیرها به فهرست ریشه‌های سورس (source roots). از الگوهای تطبیق مسیر (globbing) پشتیبانی می‌کند. ریشه سورس یک مسیر مطلق یا نسبی نسبت به دایرکتوری کاری فعلی است که برای تعیین فضای‌نام بسته (package namespace) برای ماژول‌های واقع در زیر آن ریشه استفاده می‌شود.\fP
.sp
\fBپیش‌فرض:\fP  \fB()\fP
.SS \-\-unsafe\-load\-any\-extension
.sp
\fIاجازه بارگذاری افزونه‌های دلخواه C. افزونه‌ها به درون مفسر فعال پایتون وارد شده (import) و ممکن است کدهای دلخواه را اجرا کنند.\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP
.sp
\fBنکته:\fP فقط \fBtool.pylint\fP الزامی است، عنوان بخش الزامی نیست. این‌ها مقادیر پیش‌فرض هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint.main]
analyse\-fallback\-blocks = false

clear\-cache\-post\-run = false

confidence = [\(dqHIGH\(dq, \(dqCONTROL_FLOW\(dq, \(dqINFERENCE\(dq, \(dqINFERENCE_FAILURE\(dq, \(dqUNDEFINED\(dq]

disable = [\(dqbad\-inline\-option\(dq, \(dqconsider\-using\-augmented\-assign\(dq, \(dqdeprecated\-pragma\(dq, \(dqfile\-ignored\(dq, \(dqlocally\-disabled\(dq, \(dqprefer\-typing\-namedtuple\(dq, \(dqraw\-checker\-failed\(dq, \(dqsuppressed\-message\(dq, \(dquse\-implicit\-booleaness\-not\-comparison\-to\-string\(dq, \(dquse\-implicit\-booleaness\-not\-comparison\-to\-zero\(dq, \(dquse\-symbolic\-message\-instead\(dq, \(dquseless\-suppression\(dq]

enable = []

evaluation = \(dqmax(0, 0 if fatal else 10.0 \- ((float(5 * error + warning + refactor + convention) / statement) * 10))\(dq

exit\-zero = false

extension\-pkg\-allow\-list = []

extension\-pkg\-whitelist = []

fail\-on = []

fail\-under = 10

from\-stdin = false

ignore = [\(dqCVS\(dq]

ignore\-paths = []

ignore\-patterns = [\(dq^\e\e.#\(dq]

ignored\-modules = []

jobs = 1

limit\-inference\-results = 100

load\-plugins = []

msg\-template = \(dq\(dq

# output\-format =

persistent = true

prefer\-stubs = false

py\-version = \(dqsys.version_info[:2]\(dq

recursive = false

reports = false

score = true

source\-roots = []

unsafe\-load\-any\-extension = false
.EE
.UNINDENT
.UNINDENT.SS \fBبررسی‌کننده پایه\fP \fB(Basic Checker)\fP
.SS \-\-argument\-naming\-style
.sp
\fIسبک نام‌گذاری منطبق با نام‌های صحیح آرگومان.\fP
.sp
\fBپیش‌فرض:\fP  \fBsnake_case\fP
.SS \-\-argument\-rgx
.sp
\fIعبارت باقاعده منطبق با نام‌های صحیح آرگومان. بر argument\-naming\-style اولویت دارد. در صورت خالی ماندن، نام‌های آرگومان با سبک نام‌گذاری تعیین‌شده بررسی خواهند شد.\fP
.sp
\fBپیش‌فرض:\fP  \fBNone\fP
.SS \-\-attr\-naming\-style
.sp
\fIسبک نام‌گذاری منطبق با نام‌های صحیح صفت‌ها.\fP
.sp
\fBپیش‌فرض:\fP  \fBsnake_case\fP
.SS \-\-attr\-rgx
.sp
\fIعبارت باقاعده منطبق با نام‌های صحیح صفت‌ها. بر attr\-naming\-style اولویت دارد. در صورت خالی ماندن، نام‌های صفت با سبک نام‌گذاری تعیین‌شده بررسی خواهند شد.\fP
.sp
\fBپیش‌فرض:\fP  \fBNone\fP
.SS \-\-bad\-names
.sp
\fIنام‌های نامناسب متغیر که همیشه باید رد شوند، جداشده با کاما.\fP
.sp
\fBپیش‌فرض:\fP  \fB(\(aqfoo\(aq, \(aqbar\(aq, \(aqbaz\(aq, \(aqtoto\(aq, \(aqtutu\(aq, \(aqtata\(aq)\fP
.SS \-\-bad\-names\-rgxs
.sp
\fIعبارت‌های باقاعده نام‌های نامناسب متغیر، جداشده با کاما. در صورتی که نام‌ها با هر عبارت باقاعده‌ای تطابق داشته باشند، همواره رد خواهند شد\fP
.sp
\fBپیش‌فرض:\fP \fB\(dq\(dq\fP
.SS \-\-class\-attribute\-naming\-style
.sp
\fIسبک نام‌گذاری منطبق با نام‌های صحیح صفت‌های کلاس.\fP
.sp
\fBپیش‌فرض:\fP  \fBany\fP
.SS \-\-class\-attribute\-rgx
.sp
\fIعبارت باقاعده منطبق با نام‌های صحیح صفت‌های کلاس. بر class\-attribute\-naming\-style اولویت دارد. در صورت خالی ماندن، نام‌های صفت کلاس با سبک نام‌گذاری تعیین‌شده بررسی خواهند شد.\fP
.sp
\fBپیش‌فرض:\fP  \fBNone\fP
.SS \-\-class\-const\-naming\-style
.sp
\fIسبک نام‌گذاری منطبق با نام‌های صحیح ثابت‌های کلاس.\fP
.sp
\fBپیش‌فرض:\fP  \fBUPPER_CASE\fP
.SS \-\-class\-const\-rgx
.sp
\fIعبارت باقاعده منطبق با نام‌های صحیح ثابت‌های کلاس. بر class\-const\-naming\-style اولویت دارد. در صورت خالی ماندن، نام‌های ثابت کلاس با سبک نام‌گذاری تعیین‌شده بررسی خواهند شد.\fP
.sp
\fBپیش‌فرض:\fP  \fBNone\fP
.SS \-\-class\-naming\-style
.sp
\fIسبک نام‌گذاری منطبق با نام‌های صحیح کلاس.\fP
.sp
\fBپیش‌فرض:\fP  \fBPascalCase\fP
.SS \-\-class\-rgx
.sp
\fIعبارت باقاعده منطبق با نام‌های صحیح کلاس. بر class\-naming\-style اولویت دارد. در صورت خالی ماندن، نام‌های کلاس با سبک نام‌گذاری تعیین‌شده بررسی خواهند شد.\fP
.sp
\fBپیش‌فرض:\fP  \fBNone\fP
.SS \-\-const\-naming\-style
.sp
\fIسبک نام‌گذاری منطبق با نام‌های صحیح ثابت‌ها.\fP
.sp
\fBپیش‌فرض:\fP  \fBUPPER_CASE\fP
.SS \-\-const\-rgx
.sp
\fIعبارت باقاعده منطبق با نام‌های صحیح ثابت‌ها. بر const\-naming\-style اولویت دارد. در صورت خالی ماندن، نام‌های ثابت با سبک نام‌گذاری تعیین‌شده بررسی خواهند شد.\fP
.sp
\fBپیش‌فرض:\fP  \fBNone\fP
.SS \-\-docstring\-min\-length
.sp
\fIحداقل طول خطوط برای توابع/کلاس‌هایی که نیازمند docstring هستند؛ موارد کوتاه‌تر معاف هستند.\fP
.sp
\fBپیش‌فرض:\fP  \fB\-1\fP
.SS \-\-function\-naming\-style
.sp
\fIسبک نام‌گذاری منطبق با نام‌های صحیح توابع.\fP
.sp
\fBپیش‌فرض:\fP  \fBsnake_case\fP.SS \-\-function\-rgx
.sp
\fIعبارت باقاعده منطبق بر نام‌های صحیح توابع. بر function\-naming\-style ارجحیت دارد. در صورت خالی ماندن، نام‌های توابع با سبک نام‌گذاری تعیین‌شده بررسی خواهند شد.\fP
.sp
\fBپیش‌فرض:\fP  \fBNone\fP
.SS \-\-good\-names
.sp
\fIنام‌های متغیر مناسب که همواره باید پذیرفته شوند، جداشده با کاما.\fP
.sp
\fBپیش‌فرض:\fP  \fB(\(aqi\(aq, \(aqj\(aq, \(aqk\(aq, \(aqex\(aq, \(aqRun\(aq, \(aq_\(aq)\fP
.SS \-\-good\-names\-rgxs
.sp
\fIعبارت‌های باقاعده نام‌های متغیر مناسب، جداشده با کاما. در صورتی که نام‌ها با هر یک از عبارت‌های باقاعده مطابقت داشته باشند، همواره پذیرفته خواهند شد.\fP
.sp
\fBپیش‌فرض:\fP \fB\(dq\(dq\fP
.SS \-\-include\-naming\-hint
.sp
\fIگنجاندن یک راهنما برای قالب نام‌گذاری صحیح همراه با invalid\-name.\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP
.SS \-\-inlinevar\-naming\-style
.sp
\fIسبک نام‌گذاری منطبق بر نام‌های صحیح تکرار درون‌خطی (inline iteration).\fP
.sp
\fBپیش‌فرض:\fP  \fBany\fP
.SS \-\-inlinevar\-rgx
.sp
\fIعبارت باقاعده منطبق بر نام‌های صحیح تکرار درون‌خطی. بر inlinevar\-naming\-style ارجحیت دارد. در صورت خالی ماندن، نام‌های تکرار درون‌خطی با سبک نام‌گذاری تعیین‌شده بررسی خواهند شد.\fP
.sp
\fBپیش‌فرض:\fP  \fBNone\fP
.SS \-\-method\-naming\-style
.sp
\fIسبک نام‌گذاری منطبق بر نام‌های صحیح متدها.\fP
.sp
\fBپیش‌فرض:\fP  \fBsnake_case\fP
.SS \-\-method\-rgx
.sp
\fIعبارت باقاعده منطبق بر نام‌های صحیح متدها. بر method\-naming\-style ارجحیت دارد. در صورت خالی ماندن، نام‌های متدها با سبک نام‌گذاری تعیین‌شده بررسی خواهند شد.\fP
.sp
\fBپیش‌فرض:\fP  \fBNone\fP
.SS \-\-module\-naming\-style
.sp
\fIسبک نام‌گذاری منطبق بر نام‌های صحیح ماژول‌ها.\fP
.sp
\fBپیش‌فرض:\fP  \fBsnake_case\fP
.SS \-\-module\-rgx
.sp
\fIعبارت باقاعده منطبق بر نام‌های صحیح ماژول‌ها. بر module\-naming\-style ارجحیت دارد. در صورت خالی ماندن، نام‌های ماژول‌ها با سبک نام‌گذاری تعیین‌شده بررسی خواهند شد.\fP
.sp
\fBپیش‌فرض:\fP  \fBNone\fP
.SS \-\-name\-group
.sp
\fIمجموعه‌هایی از نام‌ها که با دو‌نقطه از هم جدا شده‌اند و هنگامی که عبارت‌های باقاعده نام، چندین سبک را مجاز می‌دانند، سبک نام‌گذاری یکدیگر را تعیین می‌کنند.\fP
.sp
\fBپیش‌فرض:\fP  \fB()\fP
.SS \-\-no\-docstring\-rgx
.sp
\fIعبارت باقاعده‌ای که تنها باید با نام‌های توابع یا کلاس‌هایی مطابقت داشته باشد که نیازی به docstring ندارند.\fP
.sp
\fBپیش‌فرض:\fP  \fBre.compile(\(aq^_\(aq)\fP
.SS \-\-paramspec\-rgx
.sp
\fIعبارت باقاعده منطبق بر نام‌های صحیح متغیرهای مشخصات پارامتر (parameter specification). در صورت خالی ماندن، نام‌های متغیر مشخصات پارامتر با سبک نام‌گذاری تعیین‌شده بررسی خواهند شد.\fP
.sp
\fBپیش‌فرض:\fP  \fBNone\fP
.SS \-\-property\-classes
.sp
\fIفهرستی از دکوراتورها که ویژگی (property) تولید می‌کنند، مانند abc.abstractproperty. برای ثبت دکوراتورهای دیگری که ویژگی‌های معتبر ایجاد می‌کنند به این فهرست اضافه کنید. این دکوراتورها فقط برای invalid\-name در نظر گرفته می‌شوند.\fP
.sp
\fBپیش‌فرض:\fP  \fB(\(aqabc.abstractproperty\(aq,)\fP
.SS \-\-typealias\-rgx
.sp
\fIعبارت باقاعده منطبق بر نام‌های صحیح نام‌های مستعار نوع (type alias). در صورت خالی ماندن، نام‌های مستعار نوع با سبک نام‌گذاری تعیین‌شده بررسی خواهند شد.\fP
.sp
\fBپیش‌فرض:\fP  \fBNone\fP
.SS \-\-typevar\-rgx
.sp
\fIعبارت باقاعده منطبق بر نام‌های صحیح متغیرهای نوع (type variable). در صورت خالی ماندن، نام‌های متغیرهای نوع با سبک نام‌گذاری تعیین‌شده بررسی خواهند شد.\fP
.sp
\fBپیش‌فرض:\fP  \fBNone\fP.SS \-\-typevartuple\-rgx
.sp
\fIعبارت باقاعده برای تطبیق با نام‌های درست چندتایی متغیر نوع (type variable tuple). اگر خالی رها شود، نام‌های چندتایی متغیر نوع با سبک نام‌گذاری تعیین‌شده بررسی خواهند شد.\fP
.sp
\fBپیش‌فرض:\fP  \fBNone\fP
.SS \-\-variable\-naming\-style
.sp
\fIسبک نام‌گذاری منطبق با نام‌های درست متغیر.\fP
.sp
\fBپیش‌فرض:\fP  \fBsnake_case\fP
.SS \-\-variable\-rgx
.sp
\fIعبارت باقاعده برای تطبیق با نام‌های درست متغیر. بر variable\-naming\-style ارجحیت دارد. اگر خالی رها شود، نام‌های متغیر با سبک نام‌گذاری تعیین‌شده بررسی خواهند شد.\fP
.sp
\fBپیش‌فرض:\fP  \fBNone\fP
.sp
\fBنکته:\fP تنها \fBtool.pylint\fP الزامی است، عنوان بخش الزامی نیست. این‌ها مقادیر پیش‌فرض هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint.basic]
# Possible choices: [\(aqsnake_case\(aq, \(aqcamelCase\(aq, \(aqPascalCase\(aq, \(aqUPPER_CASE\(aq, \(aqany\(aq]
argument\-naming\-style = \(dqsnake_case\(dq

# argument\-rgx =

# Possible choices: [\(aqsnake_case\(aq, \(aqcamelCase\(aq, \(aqPascalCase\(aq, \(aqUPPER_CASE\(aq, \(aqany\(aq]
attr\-naming\-style = \(dqsnake_case\(dq

# attr\-rgx =

bad\-names = [\(dqfoo\(dq, \(dqbar\(dq, \(dqbaz\(dq, \(dqtoto\(dq, \(dqtutu\(dq, \(dqtata\(dq]

bad\-names\-rgxs = []

# Possible choices: [\(aqsnake_case\(aq, \(aqcamelCase\(aq, \(aqPascalCase\(aq, \(aqUPPER_CASE\(aq, \(aqany\(aq]
class\-attribute\-naming\-style = \(dqany\(dq

# class\-attribute\-rgx =

# Possible choices: [\(aqsnake_case\(aq, \(aqcamelCase\(aq, \(aqPascalCase\(aq, \(aqUPPER_CASE\(aq, \(aqany\(aq]
class\-const\-naming\-style = \(dqUPPER_CASE\(dq

# class\-const\-rgx =

# Possible choices: [\(aqsnake_case\(aq, \(aqcamelCase\(aq, \(aqPascalCase\(aq, \(aqUPPER_CASE\(aq, \(aqany\(aq]
class\-naming\-style = \(dqPascalCase\(dq

# class\-rgx =

# Possible choices: [\(aqsnake_case\(aq, \(aqcamelCase\(aq, \(aqPascalCase\(aq, \(aqUPPER_CASE\(aq, \(aqany\(aq]
const\-naming\-style = \(dqUPPER_CASE\(dq

# const\-rgx =

docstring\-min\-length = \-1

# Possible choices: [\(aqsnake_case\(aq, \(aqcamelCase\(aq, \(aqPascalCase\(aq, \(aqUPPER_CASE\(aq, \(aqany\(aq]
function\-naming\-style = \(dqsnake_case\(dq

# function\-rgx =

good\-names = [\(dqi\(dq, \(dqj\(dq, \(dqk\(dq, \(dqex\(dq, \(dqRun\(dq, \(dq_\(dq]

good\-names\-rgxs = []

include\-naming\-hint = false

# Possible choices: [\(aqsnake_case\(aq, \(aqcamelCase\(aq, \(aqPascalCase\(aq, \(aqUPPER_CASE\(aq, \(aqany\(aq]
inlinevar\-naming\-style = \(dqany\(dq

# inlinevar\-rgx =

# Possible choices: [\(aqsnake_case\(aq, \(aqcamelCase\(aq, \(aqPascalCase\(aq, \(aqUPPER_CASE\(aq, \(aqany\(aq]
method\-naming\-style = \(dqsnake_case\(dq

# method\-rgx =

# Possible choices: [\(aqsnake_case\(aq, \(aqcamelCase\(aq, \(aqPascalCase\(aq, \(aqUPPER_CASE\(aq, \(aqany\(aq]
module\-naming\-style = \(dqsnake_case\(dq

# module\-rgx =

name\-group = []

no\-docstring\-rgx = \(dq^_\(dq

# paramspec\-rgx =

property\-classes = [\(dqabc.abstractproperty\(dq]

# typealias\-rgx =

# typevar\-rgx =

# typevartuple\-rgx =

# Possible choices: [\(aqsnake_case\(aq, \(aqcamelCase\(aq, \(aqPascalCase\(aq, \(aqUPPER_CASE\(aq, \(aqany\(aq]
variable\-naming\-style = \(dqsnake_case\(dq

# variable\-rgx =
.EE
.UNINDENT
.UNINDENT.SS \fBبررسی‌کننده کلاس‌ها (Classes Checker)\fP
.SS \-\-check\-protected\-access\-in\-special\-methods
.sp
\fIهشدار درباره دسترسی به مشخصه‌های محافظت‌شده درون متدهای ویژه\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP
.SS \-\-defining\-attr\-methods
.sp
\fIفهرست نام‌های متدهایی که برای تعریف (یعنی مقداردهی) مشخصه‌های نمونه به کار می‌روند.\fP
.sp
\fBپیش‌فرض:\fP  \fB(\(aq__init__\(aq, \(aq__new__\(aq, \(aqsetUp\(aq, \(aqasyncSetUp\(aq, \(aq__post_init__\(aq)\fP
.SS \-\-exclude\-protected
.sp
\fIفهرست نام‌های اعضایی که باید از هشدار دسترسی محافظت‌شده مستثنی شوند.\fP
.sp
\fBپیش‌فرض:\fP  \fB(\(aq_asdict\(aq, \(aq_fields\(aq, \(aq_replace\(aq, \(aq_source\(aq, \(aq_make\(aq, \(aqos._exit\(aq)\fP
.SS \-\-valid\-classmethod\-first\-arg
.sp
\fIفهرست نام‌های معتبر برای آرگومان نخست در یک متد کلاس (classmethod).\fP
.sp
\fBپیش‌فرض:\fP  \fB(\(aqcls\(aq,)\fP
.SS \-\-valid\-metaclass\-classmethod\-first\-arg
.sp
\fIفهرست نام‌های معتبر برای آرگومان نخست در متد کلاس یک متاکلاس.\fP
.sp
\fBپیش‌فرض:\fP  \fB(\(aqmcs\(aq,)\fP
.sp
\fBنکته:\fP تنها \fBtool.pylint\fP الزامی است و عنوان بخش لازم نیست. این‌ها مقادیر پیش‌فرض هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint.classes]
check\-protected\-access\-in\-special\-methods = false

defining\-attr\-methods = [\(dq__init__\(dq, \(dq__new__\(dq, \(dqsetUp\(dq, \(dqasyncSetUp\(dq, \(dq__post_init__\(dq]

exclude\-protected = [\(dq_asdict\(dq, \(dq_fields\(dq, \(dq_replace\(dq, \(dq_source\(dq, \(dq_make\(dq, \(dqos._exit\(dq]

valid\-classmethod\-first\-arg = [\(dqcls\(dq]

valid\-metaclass\-classmethod\-first\-arg = [\(dqmcs\(dq]
.EE
.UNINDENT
.UNINDENT
.SS \fBبررسی‌کننده طراحی (Design Checker)\fP
.SS \-\-exclude\-too\-few\-public\-methods
.sp
\fIفهرست عبارت‌های باقاعده از نام‌های اجداد کلاس برای نادیده‌گرفتن هنگام شمارش متدهای عمومی (مشاهده R0903)\fP
.sp
\fBپیش‌فرض:\fP  \fB[]\fP
.SS \-\-ignored\-parents
.sp
\fIفهرست نام‌های کامل کلاس‌ها برای نادیده‌گرفتن هنگام شمارش والدین کلاس (مشاهده R0901)\fP
.sp
\fBپیش‌فرض:\fP  \fB()\fP
.SS \-\-max\-args
.sp
\fIحداکثر تعداد آرگومان‌ها برای تابع / متد.\fP
.sp
\fBپیش‌فرض:\fP  \fB5\fP
.SS \-\-max\-attributes
.sp
\fIحداکثر تعداد مشخصه‌ها برای یک کلاس (مشاهده R0902).\fP
.sp
\fBپیش‌فرض:\fP  \fB7\fP
.SS \-\-max\-bool\-expr
.sp
\fIحداکثر تعداد عبارت‌های بولی در یک دستور if (مشاهده R0916).\fP
.sp
\fBپیش‌فرض:\fP  \fB5\fP
.SS \-\-max\-branches
.sp
\fIحداکثر تعداد شاخه‌ها برای بدنه تابع / متد.\fP
.sp
\fBپیش‌فرض:\fP  \fB12\fP
.SS \-\-max\-complexity
.sp
\fIآستانه پیچیدگی سیکلوماتیک McCabe\fP
.sp
\fBپیش‌فرض:\fP  \fB10\fP.SS \-\-max\-locals
.sp
\fIحداکثر تعداد متغیرهای محلی برای بدنه تابع / متد.\fP
.sp
\fBپیش‌فرض:\fP  \fB15\fP
.SS \-\-max\-parents
.sp
\fIحداکثر تعداد والدها برای یک کلاس (R0901 را ببینید).\fP
.sp
\fBپیش‌فرض:\fP  \fB7\fP
.SS \-\-max\-positional\-arguments
.sp
\fIحداکثر تعداد آرگومان‌های مکانی برای تابع / متد.\fP
.sp
\fBپیش‌فرض:\fP  \fB5\fP
.SS \-\-max\-public\-methods
.sp
\fIحداکثر تعداد متدهای عمومی برای یک کلاس (R0904 را ببینید).\fP
.sp
\fBپیش‌فرض:\fP  \fB20\fP
.SS \-\-max\-returns
.sp
\fIحداکثر تعداد return / yield برای بدنه تابع / متد.\fP
.sp
\fBپیش‌فرض:\fP  \fB6\fP
.SS \-\-max\-statements
.sp
\fIحداکثر تعداد دستورات در بدنه تابع / متد.\fP
.sp
\fBپیش‌فرض:\fP  \fB50\fP
.SS \-\-min\-public\-methods
.sp
\fIحداقل تعداد متدهای عمومی برای یک کلاس (R0903 را ببینید).\fP
.sp
\fBپیش‌فرض:\fP  \fB2\fP
.sp
\fBنکته:\fP فقط \fBtool.pylint\fP الزامی است، عنوان بخش الزامی نیست. این‌ها مقادیر پیش‌فرض هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint.design]
exclude\-too\-few\-public\-methods = []

ignored\-parents = []

max\-args = 5

max\-attributes = 7

max\-bool\-expr = 5

max\-branches = 12

max\-complexity = 10

max\-locals = 15

max\-parents = 7

max\-positional\-arguments = 5

max\-public\-methods = 20

max\-returns = 6

max\-statements = 50

min\-public\-methods = 2
.EE
.UNINDENT
.UNINDENT
.SS \fBبررسی‌کننده استثناها\fP \fB(Exceptions Checker)\fP
.SS \-\-overgeneral\-exceptions
.sp
\fIاستثناهایی که هنگام گرفته‌شدن (catch)، یک هشدار صادر می‌کنند.\fP
.sp
\fBپیش‌فرض:\fP  \fB(\(aqbuiltins.BaseException\(aq, \(aqbuiltins.Exception\(aq)\fP
.sp
\fBنکته:\fP فقط \fBtool.pylint\fP الزامی است، عنوان بخش الزامی نیست. این‌ها مقادیر پیش‌فرض هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint.exceptions]
overgeneral\-exceptions = [\(dqbuiltins.BaseException\(dq, \(dqbuiltins.Exception\(dq]
.EE
.UNINDENT
.UNINDENT.SS بررسی‌کنندهٔ \fBFormat\fP (\fBFormat Checker\fP)
.SS \-\-expected\-line\-ending\-format
.sp
\fIقالب مورد انتظار برای پایان خط؛ برای نمونه خالی (هر پایان خطی)، LF یا CRLF.\fP
.sp
\fBپیش‌فرض:\fP \fB\(dq\(dq\fP
.SS \-\-ignore\-long\-lines
.sp
\fIعبارت باقاعده (Regexp) برای خطی که مجاز است از حد تعیین‌شده طولانی‌تر باشد.\fP
.sp
\fBپیش‌فرض:\fP  \fB^\es*(# )?<?https?://\eS+>?$\fP
.SS \-\-indent\-after\-paren
.sp
\fIتعداد فاصله‌های تورفتگی مورد نیاز درون یک خط معلق (hanging) یا ادامه‌دار.\fP
.sp
\fBپیش‌فرض:\fP  \fB4\fP
.SS \-\-indent\-string
.sp
\fIرشته‌ای که به عنوان واحد تورفتگی استفاده می‌شود. این مقدار معمولاً \(dq    \(dq (۴ فاصله) یا \(dqt\(dq (۱ تب) است.\fP
.sp
\fBپیش‌فرض:\fP  \(ga\(ga    \(ga\(ga
.SS \-\-max\-line\-length
.sp
\fIبیشینهٔ تعداد نویسه‌ها در یک خط منفرد. مقدار پیش‌فرض ۱۰۰ در Pylint بر اساس رهنمود PEP 8 است که بیان می‌کند تیم‌ها می‌توانند طول خط را تا ۹۹ نویسه انتخاب کنند.\fP
.sp
\fBپیش‌فرض:\fP  \fB100\fP
.SS \-\-max\-module\-lines
.sp
\fIبیشینهٔ تعداد خط‌ها در یک ماژول.\fP
.sp
\fBپیش‌فرض:\fP  \fB1000\fP
.SS \-\-single\-line\-class\-stmt
.sp
\fIاجازه دادن به قرارگیری بدنهٔ کلاس در همان خط اعلان، در صورتی که بدنه تنها شامل یک عبارت باشد.\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP
.SS \-\-single\-line\-if\-stmt
.sp
\fIاجازه دادن به قرارگیری بدنهٔ دستور if در همان خط شرط (test)، در صورتی که else وجود نداشته باشد.\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP
.sp
\fBنکته:\fP تنها \fBtool.pylint\fP الزامی است و عنوان بخش ضروری نیست. این‌ها مقادیر پیش‌فرض هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint.format]
# Possible choices: [\(aq\(aq, \(aqLF\(aq, \(aqCRLF\(aq]
expected\-line\-ending\-format = \(dq\(dq

ignore\-long\-lines = \(dq^\e\es*(# )?<?https?://\e\eS+>?$\(dq

indent\-after\-paren = 4

indent\-string = \(dq    \(dq

max\-line\-length = 100

max\-module\-lines = 1000

single\-line\-class\-stmt = false

single\-line\-if\-stmt = false
.EE
.UNINDENT
.UNINDENT
.SS بررسی‌کنندهٔ \fBImports\fP (\fBImports Checker\fP)
.SS \-\-allow\-any\-import\-level
.sp
\fIفهرستی از ماژول‌هایی که می‌توان آن‌ها را در هر سطحی، و نه فقط در بالاترین سطح (top level)، وارد (import) کرد.\fP
.sp
\fBپیش‌فرض:\fP  \fB()\fP
.SS \-\-allow\-reexport\-from\-package
.sp
\fIاجازه دادن به بازصادرات (re-export) صریح از طریق نام مستعار (alias) از __init__ یک بسته.\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP
.SS \-\-allow\-wildcard\-with\-all
.sp
\fIاجازه دادن به واردسازی‌های عامه‌نما (wildcard imports) از ماژول‌هایی که __all__ را تعریف کرده‌اند.\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP.SS \-\-deprecated\-modules
.sp
\fIماژول‌های منسوخ‌شده‌ای که نباید استفاده شوند، که با کاما از هم جدا شده‌اند.\fP
.sp
\fBپیش‌فرض:\fP  \fB()\fP
.SS \-\-ext\-import\-graph
.sp
\fIخروجی دادن یک نمودار (با فرمت .gv یا هر قالب تصویر پشتیبانی‌شده) از وابستگی‌های خارجی در فایل مشخص‌شده (گزارش RP0402 نباید غیرفعال باشد).\fP
.sp
\fBپیش‌فرض:\fP \fB\(dq\(dq\fP
.SS \-\-import\-graph
.sp
\fIخروجی دادن یک نمودار (با فرمت .gv یا هر قالب تصویر پشتیبانی‌شده) از تمامی وابستگی‌ها (یعنی داخلی و خارجی) در فایل مشخص‌شده (گزارش RP0402 نباید غیرفعال باشد).\fP
.sp
\fBپیش‌فرض:\fP \fB\(dq\(dq\fP
.SS \-\-int\-import\-graph
.sp
\fIخروجی دادن یک نمودار (با فرمت .gv یا هر قالب تصویر پشتیبانی‌شده) از وابستگی‌های داخلی در فایل مشخص‌شده (گزارش RP0402 نباید غیرفعال باشد).\fP
.sp
\fBپیش‌فرض:\fP \fB\(dq\(dq\fP
.SS \-\-known\-standard\-library
.sp
\fIاجبار ترتیب واردسازی (import) برای شناختن یک ماژول به عنوان بخشی از کتابخانه‌های استاندارد سازگاری.\fP
.sp
\fBپیش‌فرض:\fP  \fB()\fP
.SS \-\-known\-third\-party
.sp
\fIاجبار ترتیب واردسازی (import) برای شناختن یک ماژول به عنوان بخشی از یک کتابخانه شخص ثالث (third-party).\fP
.sp
\fBپیش‌فرض:\fP  \fB(\(aqenchant\(aq,)\fP
.SS \-\-preferred\-modules
.sp
\fIجفت‌هایی از ماژول‌ها و ماژول‌های ترجیحی، که با کاما از هم جدا شده‌اند.\fP
.sp
\fBپیش‌فرض:\fP  \fB()\fP
.sp
\fBنکته:\fP تنها \fBtool.pylint\fP الزامی است، عنوان بخش الزامی نیست. این‌ها مقادیر پیش‌فرض هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint.imports]
allow\-any\-import\-level = []

allow\-reexport\-from\-package = false

allow\-wildcard\-with\-all = false

deprecated\-modules = []

ext\-import\-graph = \(dq\(dq

import\-graph = \(dq\(dq

int\-import\-graph = \(dq\(dq

known\-standard\-library = []

known\-third\-party = [\(dqenchant\(dq]

preferred\-modules = []
.EE
.UNINDENT
.UNINDENT
.SS \fBبررسی‌کنندهٔ\fP \fBLogging\fP
.SS \-\-logging\-format\-style
.sp
\fIنوع قالب‌بندی رشته‌ای که متدهای logging انجام می‌دهند. \(gaold\(ga به معنای استفاده از قالب‌بندی % است، و \(ganew\(ga برای قالب‌بندی \(ga{}\(ga به کار می‌رود.\fP
.sp
\fBپیش‌فرض:\fP  \fBold\fP
.SS \-\-logging\-modules
.sp
\fIماژول‌های logging برای بررسی اینکه آرگومان‌های قالب رشته در قالب پارامترهای تابع logging باشند.\fP
.sp
\fBپیش‌فرض:\fP  \fB(\(aqlogging\(aq,)\fP
.sp
\fBنکته:\fP تنها \fBtool.pylint\fP الزامی است، عنوان بخش الزامی نیست. این‌ها مقادیر پیش‌فرض هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint.logging]
# Possible choices: [\(aqold\(aq, \(aqnew\(aq]
logging\-format\-style = \(dqold\(dq

logging\-modules = [\(dqlogging\(dq]
.EE
.UNINDENT
.UNINDENT.SS \fBبررسی‌کنندهٔ\fP \fBMethod_args\fP
.SS \-\-timeout\-methods
.sp
\fIفهرستی از نام‌های کامل (مانند library.method) که نیازمند پارامتر timeout هستند؛ مانند \(aqrequests.api.get,requests.api.post\(aq\fP
.sp
\fBپیش‌فرض:\fP  \fB(\(aqrequests.api.delete\(aq, \(aqrequests.api.get\(aq, \(aqrequests.api.head\(aq, \(aqrequests.api.options\(aq, \(aqrequests.api.patch\(aq, \(aqrequests.api.post\(aq, \(aqrequests.api.put\(aq, \(aqrequests.api.request\(aq)\fP
.sp
\fBنکته:\fP فقط \fBtool.pylint\fP الزامی است، عنوان بخش لازم نیست. این‌ها مقادیر پیش‌فرض هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint.method_args]
timeout\-methods = [\(dqrequests.api.delete\(dq, \(dqrequests.api.get\(dq, \(dqrequests.api.head\(dq, \(dqrequests.api.options\(dq, \(dqrequests.api.patch\(dq, \(dqrequests.api.post\(dq, \(dqrequests.api.put\(dq, \(dqrequests.api.request\(dq]
.EE
.UNINDENT
.UNINDENT
.SS \fBبررسی‌کنندهٔ\fP \fBMiscellaneous\fP
.SS \-\-check\-fixme\-in\-docstring
.sp
\fIآیا در docstringها به دنبال fixmeها جستجو شود یا خیر.\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP
.SS \-\-notes
.sp
\fIفهرستی از برچسب‌های یادداشت جهت در نظر گرفتن، جداشده با کاما.\fP
.sp
\fBپیش‌فرض:\fP  \fB(\(aqFIXME\(aq, \(aqXXX\(aq, \(aqTODO\(aq)\fP
.SS \-\-notes\-rgx
.sp
\fIعبارت باقاعده (Regex) برچسب‌های یادداشت جهت در نظر گرفتن.\fP
.sp
\fBپیش‌فرض:\fP \fB\(dq\(dq\fP
.sp
\fBنکته:\fP فقط \fBtool.pylint\fP الزامی است، عنوان بخش لازم نیست. این‌ها مقادیر پیش‌فرض هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint.miscellaneous]
check\-fixme\-in\-docstring = false

notes = [\(dqFIXME\(dq, \(dqXXX\(dq, \(dqTODO\(dq]

notes\-rgx = \(dq\(dq
.EE
.UNINDENT
.UNINDENT
.SS \fBبررسی‌کنندهٔ\fP \fBRefactoring\fP
.SS \-\-max\-nested\-blocks
.sp
\fIحداکثر تعداد بلوک‌های تو در تو برای بدنهٔ تابع / متد\fP
.sp
\fBپیش‌فرض:\fP  \fB5\fP
.SS \-\-never\-returning\-functions
.sp
\fIنام کامل توابعی که هرگز بازنمی‌گردند. هنگام بررسی inconsistent\-return\-statements، اگر تابعی فراخوانی شود که هرگز بازگشت ندارد، به عنوان یک دستور return صریح در نظر گرفته شده و هیچ پیامی چاپ نخواهد شد.\fP
.sp
\fBپیش‌فرض:\fP  \fB(\(aqsys.exit\(aq, \(aqargparse.parse_error\(aq)\fP
.SS \-\-suggest\-join\-with\-non\-empty\-separator
.sp
\fIصادر شدن هشدار \(aqconsider\-using\-join\(aq هنگامی که جداکنندهٔ مورد استفاده برای اتصال (join) غیرخالی باشد (منجر به اصلاحات مورد انتظار از این دست: \(ga\(ga\(dq\- \(dq + \(dq
\- \(dq.join(items)\(ga\(ga)\fP
.sp
\fBپیش‌فرض:\fP  \fBTrue\fP
.sp
\fBنکته:\fP فقط \fBtool.pylint\fP الزامی است، عنوان بخش لازم نیست. این‌ها مقادیر پیش‌فرض هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint.refactoring]
max\-nested\-blocks = 5

never\-returning\-functions = [\(dqsys.exit\(dq, \(dqargparse.parse_error\(dq]

suggest\-join\-with\-non\-empty\-separator = true
.EE
.UNINDENT
.UNINDENT.SS \fBبررسی‌کنندهٔ شباهت‌ها (Similarities Checker)\fP
.SS \-\-ignore\-comments
.sp
\fIکامنت‌ها از محاسبهٔ شباهت حذف می‌شوند\fP
.sp
\fBپیش‌فرض:\fP  \fBTrue\fP
.SS \-\-ignore\-docstrings
.sp
\fIرشته‌های مستندات (docstringها) از محاسبهٔ شباهت حذف می‌شوند\fP
.sp
\fBپیش‌فرض:\fP  \fBTrue\fP
.SS \-\-ignore\-imports
.sp
\fIواردکردن‌ها (imports) از محاسبهٔ شباهت حذف می‌شوند\fP
.sp
\fBپیش‌فرض:\fP  \fBTrue\fP
.SS \-\-ignore\-signatures
.sp
\fIامضاها (signatures) از محاسبهٔ شباهت حذف می‌شوند\fP
.sp
\fBپیش‌فرض:\fP  \fBTrue\fP
.SS \-\-min\-similarity\-lines
.sp
\fIحداقل تعداد خطوط برای یک شباهت.\fP
.sp
\fBپیش‌فرض:\fP  \fB4\fP
.sp
\fBنکته:\fP تنها \fBtool.pylint\fP الزامی است، عنوان بخش لازم نیست. این‌ها مقادیر پیش‌فرض هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint.similarities]
ignore\-comments = true

ignore\-docstrings = true

ignore\-imports = true

ignore\-signatures = true

min\-similarity\-lines = 4
.EE
.UNINDENT
.UNINDENT
.SS \fBبررسی‌کنندهٔ املا (Spelling Checker)\fP
.SS \-\-max\-spelling\-suggestions
.sp
\fIتعداد پیشنهادهای ارائه‌شده برای غلط‌های املایی را محدود می‌کند.\fP
.sp
\fBپیش‌فرض:\fP  \fB4\fP
.SS \-\-spelling\-dict
.sp
\fIنام لغت‌نامهٔ املایی. لغت‌نامه‌های موجود به نصب محلی enchant شما بستگی دارد.\fP
.sp
\fBپیش‌فرض:\fP \fB\(dq\(dq\fP
.SS \-\-spelling\-ignore\-comment\-directives
.sp
\fIفهرستی از کلمات جداشده با کاما که در صورت قرار گرفتن در ابتدای یک کامنت، باید به‌عنوان دستورالعمل (directive) در نظر گرفته شوند و بررسی نشوند.\fP
.sp
\fBپیش‌فرض:\fP  \fBfmt: on,fmt: off,noqa:,noqa,nosec,isort:skip,mypy:\fP
.SS \-\-spelling\-ignore\-words
.sp
\fIفهرستی از کلمات جداشده با کاما که نباید بررسی شوند.\fP
.sp
\fBپیش‌فرض:\fP \fB\(dq\(dq\fP
.SS \-\-spelling\-private\-dict\-file
.sp
\fIمسیری به فایلی که شامل لغت‌نامهٔ اختصاصی است؛ یک کلمه در هر خط.\fP
.sp
\fBپیش‌فرض:\fP \fB\(dq\(dq\fP
.SS \-\-spelling\-store\-unknown\-words
.sp
\fIتعیین می‌کند که آیا کلمات ناشناخته به جای صدور پیام، در لغت‌نامهٔ اختصاصی ذخیره شوند یا خیر (گزینهٔ \-\-spelling\-private\-dict\-file را ببینید).\fP
.sp
\fBپیش‌فرض:\fP  \fBn\fP
.sp
\fBنکته:\fP تنها \fBtool.pylint\fP الزامی است، عنوان بخش لازم نیست. این‌ها مقادیر پیش‌فرض هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint.spelling]
max\-spelling\-suggestions = 4

# Possible choices: Values from \(aqenchant.Broker().list_dicts()\(aq depending on your local enchant installation
spelling\-dict = \(dq\(dq

spelling\-ignore\-comment\-directives = \(dqfmt: on,fmt: off,noqa:,noqa,nosec,isort:skip,mypy:\(dq

spelling\-ignore\-words = \(dq\(dq

spelling\-private\-dict\-file = \(dq\(dq

spelling\-store\-unknown\-words = false
.EE
.UNINDENT
.UNINDENT.SS \fBبررسی‌کنندهٔ رشته (String Checker)\fP
.SS \-\-check\-quote\-consistency
.sp
\fIاین پرچم مشخص می‌کند که آیا در صورت استفادهٔ ناهمگون از نویسهٔ جداکنندهٔ نقل‌قول در یک پودمان، هشدار inconsistent\-quotes صادر شود یا خیر.\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP
.SS \-\-check\-str\-concat\-over\-line\-jumps
.sp
\fIاین پرچم مشخص می‌کند که آیا برای الحاق ضمنی رشته‌ها در دنباله‌هایی که در چندین سطر تعریف شده‌اند، هشدار implicit\-str\-concat صادر شود یا خیر.\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP
.sp
\fBنکته:\fP تنها بخش \fBtool.pylint\fP مورد نیاز است و عنوان بخش الزامی نیست. این مقادیر، مقادیر پیش‌فرض هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint.string]
check\-quote\-consistency = false

check\-str\-concat\-over\-line\-jumps = false
.EE
.UNINDENT
.UNINDENT
.SS \fBبررسی‌کنندهٔ بررسی نوع (Typecheck Checker)\fP
.SS \-\-contextmanager\-decorators
.sp
\fIفهرستی از دکوراتورهایی که مدیر زمینه (context manager) ایجاد می‌کنند، مانند contextlib.contextmanager. برای ثبت دکوراتورهای دیگری که مدیران زمینهٔ معتبر تولید می‌کنند، آن‌ها را به این فهرست اضافه کنید.\fP
.sp
\fBپیش‌فرض:\fP  \fB[\(aqcontextlib.contextmanager\(aq]\fP
.SS \-\-generated\-members
.sp
\fIفهرستی از اعضایی که به‌صورت پویا تنظیم شده و توسط سامانهٔ استنتاج pylint شناسایی نمی‌شوند، بنابراین هنگام دسترسی نباید خطای E1101 را فعال کنند. عبارات باقاعدهٔ پایتون پذیرفته می‌شوند.\fP
.sp
\fBپیش‌فرض:\fP  \fB()\fP
.SS \-\-ignore\-mixin\-members
.sp
\fIمشخص می‌کند که آیا اعضای مفقودی که در کلاس mixin مورد دسترسی قرار گرفته‌اند باید نادیده گرفته شوند یا خیر. کلاسی mixin در نظر گرفته می‌شود که نام آن با گزینهٔ mixin\-class\-rgx مطابقت داشته باشد.\fP
.sp
\fBپیش‌فرض:\fP  \fBTrue\fP
.SS \-\-ignore\-none
.sp
\fIمشخص می‌کند که آیا در صورت استنتاج None برای مالک صفت (attribute)، هشداری در مورد اعضای ناموجود صادر شود یا خیر.\fP
.sp
\fBپیش‌فرض:\fP  \fBTrue\fP
.SS \-\-ignore\-on\-opaque\-inference
.sp
\fIاین پرچم کنترل می‌کند که آیا pylint باید در صورت بازگردانده شدن یک شیء کدر (opaque) هنگام استنتاج، دربارهٔ no\-member و بررسی‌های مشابه هشدار دهد یا خیر. فرایند استنتاج می‌تواند هنگام ارزیابی یک شیء پایتون چندین نتیجهٔ محتمل ارائه دهد، اما ممکن است برخی شاخه‌ها ارزیابی نشوند که به استنتاج جزئی می‌انجامد. در چنین حالتی، ممکن است همچنان صدور هشدار no\-member و سایر بررسی‌ها برای باقی اشیاء استنتاج‌شده مفید باشد.\fP
.sp
\fBپیش‌فرض:\fP  \fBTrue\fP
.SS \-\-ignored\-checks\-for\-mixins
.sp
\fIفهرستی از نام‌های نمادین پیام‌ها که باید برای اعضای Mixin نادیده گرفته شوند.\fP
.sp
\fBپیش‌فرض:\fP  \fB[\(aqno\-member\(aq, \(aqnot\-async\-context\-manager\(aq, \(aqnot\-context\-manager\(aq, \(aqattribute\-defined\-outside\-init\(aq]\fP
.SS \-\-ignored\-classes
.sp
\fIفهرستی از نام‌های کلاس‌هایی که صفات عضو آن‌ها نباید بررسی شوند (مفید برای کلاس‌هایی با صفات تنظیم‌شده به‌صورت پویا). این گزینه از نام‌های واجد شرایط (qualified names) پشتیبانی می‌کند.\fP
.sp
\fBپیش‌فرض:\fP  \fB(\(aqoptparse.Values\(aq, \(aqthread._local\(aq, \(aq_thread._local\(aq, \(aqargparse.Namespace\(aq)\fP
.SS \-\-missing\-member\-hint
.sp
\fIهنگامی که نام یک عضو پیدا نمی‌شود، راهنمایی حاوی نام‌های احتمالی را نمایش می‌دهد. نحوهٔ یافتن این راهنما بر پایهٔ فاصلهٔ ویرایش (edit distance) است.\fP
.sp
\fBپیش‌فرض:\fP  \fBTrue\fP
.SS \-\-missing\-member\-hint\-distance
.sp
\fIحداکثر فاصلهٔ ویرایشی که یک نام می‌تواند داشته باشد تا به‌عنوان گزینه‌ای مشابه برای نام عضو مفقود در نظر گرفته شود.\fP
.sp
\fBپیش‌فرض:\fP  \fB1\fP
.SS \-\-missing\-member\-max\-choices
.sp
\fIتعداد کل نام‌های مشابهی که باید هنگام نمایش راهنما برای یک عضو مفقود مد نظر قرار گیرند.\fP
.sp
\fBپیش‌فرض:\fP  \fB1\fP
.SS \-\-mixin\-class\-rgx
.sp
\fIالگوی عبارت باقاعده (Regex) برای تعیین این‌که کدام کلاس‌ها mixin در نظر گرفته می‌شوند.\fP
.sp
\fBپیش‌فرض:\fP  \fB\&.*[Mm]ixin\fP.SS \-\-signature\-mutators
.sp
\fIفهرستی از دکوراتورهایی که امضای تابع تزیین‌شده را تغییر می‌دهند.\fP
.sp
\fBپیش‌فرض:\fP  \fB[]\fP
.sp
\fBنکته:\fP تنها \fBtool.pylint\fP الزامی است، عنوان بخش لازم نیست. این‌ها مقدارهای پیش‌فرض هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint.typecheck]
contextmanager\-decorators = [\(dqcontextlib.contextmanager\(dq]

generated\-members = []

ignore\-mixin\-members = true

ignore\-none = true

ignore\-on\-opaque\-inference = true

ignored\-checks\-for\-mixins = [\(dqno\-member\(dq, \(dqnot\-async\-context\-manager\(dq, \(dqnot\-context\-manager\(dq, \(dqattribute\-defined\-outside\-init\(dq]

ignored\-classes = [\(dqoptparse.Values\(dq, \(dqthread._local\(dq, \(dq_thread._local\(dq, \(dqargparse.Namespace\(dq]

missing\-member\-hint = true

missing\-member\-hint\-distance = 1

missing\-member\-max\-choices = 1

mixin\-class\-rgx = \(dq.*[Mm]ixin\(dq

signature\-mutators = []
.EE
.UNINDENT
.UNINDENT
.SS \fBبررسی‌کنندهٔ متغیرها (Variables Checker)\fP
.SS \-\-additional\-builtins
.sp
\fIفهرستی از نام‌های اضافی که فرض می‌شود در builtins تعریف شده‌اند. به یاد داشته باشید که در صورت امکان باید از تعریف builtins جدید خودداری کنید.\fP
.sp
\fBپیش‌فرض:\fP  \fB()\fP
.SS \-\-allow\-global\-unused\-variables
.sp
\fIمشخص می‌کند که آیا متغیرهای سراسری استفاده‌نشده باید به عنوان تخطی در نظر گرفته شوند یا خیر.\fP
.sp
\fBپیش‌فرض:\fP  \fBTrue\fP
.SS \-\-allowed\-redefined\-builtins
.sp
\fIفهرستی از نام‌هایی که مجازند بر builtins سایه بیندازند (آن‌ها را shadow کنند)\fP
.sp
\fBپیش‌فرض:\fP  \fB()\fP
.SS \-\-callbacks
.sp
\fIفهرستی از رشته‌ها که می‌توانند یک تابع بازخورد (callback) را بر اساس نام شناسایی کنند. نام یک callback باید با یکی از این رشته‌ها شروع شده یا پایان یابد.\fP
.sp
\fBپیش‌فرض:\fP  \fB(\(aqcb_\(aq, \(aq_cb\(aq)\fP
.SS \-\-dummy\-variables\-rgx
.sp
\fIیک عبارت باقاعده (regular expression) برای تطبیق با نام متغیرهای صوری (dummy)، یعنی متغیرهایی که انتظار نمی‌رود استفاده شوند.\fP
.sp
\fBپیش‌فرض:\fP  \fB_+$|(_[a\-zA\-Z0\-9_]*[a\-zA\-Z0\-9]+?$)|dummy|^ignored_|^unused_\fP
.SS \-\-ignored\-argument\-names
.sp
\fIنام‌های آرگومانی که با این عبارت مطابقت داشته باشند نادیده گرفته خواهند شد.\fP
.sp
\fBپیش‌فرض:\fP  \fBre.compile(\(aq_.*|^ignored_|^unused_\(aq)\fP
.SS \-\-init\-import
.sp
\fIمشخص می‌کند که آیا واردکردن‌های (import) استفاده‌نشده در فایل‌های __init__ باید بررسی شوند یا خیر.\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP
.SS \-\-redefining\-builtins\-modules
.sp
\fIفهرستی از نام‌های واجد شرایط ماژول‌ها (qualified module names) که می‌توانند اشیایی برای بازتعریف builtins داشته باشند.\fP
.sp
\fBپیش‌فرض:\fP  \fB(\(aqsix.moves\(aq, \(aqpast.builtins\(aq, \(aqfuture.builtins\(aq, \(aqbuiltins\(aq, \(aqio\(aq)\fP
.sp
\fBنکته:\fP تنها \fBtool.pylint\fP الزامی است، عنوان بخش لازم نیست. این‌ها مقدارهای پیش‌فرض هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint.variables]
additional\-builtins = []

allow\-global\-unused\-variables = true

allowed\-redefined\-builtins = []

callbacks = [\(dqcb_\(dq, \(dq_cb\(dq]

dummy\-variables\-rgx = \(dq_+$|(_[a\-zA\-Z0\-9_]*[a\-zA\-Z0\-9]+?$)|dummy|^ignored_|^unused_\(dq

ignored\-argument\-names = \(dq_.*|^ignored_|^unused_\(dq

init\-import = false

redefining\-builtins\-modules = [\(dqsix.moves\(dq, \(dqpast.builtins\(dq, \(dqfuture.builtins\(dq, \(dqbuiltins\(dq, \(dqio\(dq]
.EE
.UNINDENT
.UNINDENT.SS افزونه‌ها (Extensions)
.SS بررسی‌کنندهٔ \fBBroad_try_clause\fP
.SS \-\-max\-try\-statements
.sp
\fIحداکثر تعداد دستورهای مجاز در یک عبارت try\fP
.sp
\fBپیش‌فرض:\fP  \fB1\fP
.sp
\fBنکته:\fP تنها \fBtool.pylint\fP الزامی است، عنوان بخش لازم نیست. این‌ها مقادیر پیش‌فرض هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint.broad_try_clause]
max\-try\-statements = 1
.EE
.UNINDENT
.UNINDENT
.SS بررسی‌کنندهٔ \fBCode_style\fP
.SS \-\-max\-line\-length\-suggestions
.sp
\fIحداکثر طول خطی که همچنان برای آن پیشنهادها ارائه می‌شوند. برای جلوگیری از پیشنهادهای اختیاری که ممکن است توسط یک قالب‌بند کد (مانند black) شکسته شوند استفاده می‌شود. مقدار پیش‌فرض آن مطابق تنظیمات \(ga\(gamax\-line\-length\(ga\(ga خواهد بود.\fP
.sp
\fBپیش‌فرض:\fP  \fB0\fP
.sp
\fBنکته:\fP تنها \fBtool.pylint\fP الزامی است، عنوان بخش لازم نیست. این‌ها مقادیر پیش‌فرض هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint.code_style]
max\-line\-length\-suggestions = 0
.EE
.UNINDENT
.UNINDENT
.SS بررسی‌کنندهٔ \fBDeprecated_builtins\fP
.SS \-\-bad\-functions
.sp
\fIفهرستی از نام‌های توابع توکار (builtins) که نباید استفاده شوند، جداشده با کاما\fP
.sp
\fBپیش‌فرض:\fP  \fB[\(aqmap\(aq, \(aqfilter\(aq]\fP
.sp
\fBنکته:\fP تنها \fBtool.pylint\fP الزامی است، عنوان بخش لازم نیست. این‌ها مقادیر پیش‌فرض هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint.deprecated_builtins]
bad\-functions = [\(dqmap\(dq, \(dqfilter\(dq]
.EE
.UNINDENT
.UNINDENT
.SS بررسی‌کنندهٔ \fBDunder\fP
.SS \-\-good\-dunder\-names
.sp
\fIنام‌های dunder مناسبی که همیشه باید پذیرفته شوند.\fP
.sp
\fBپیش‌فرض:\fP  \fB[]\fP
.sp
\fBنکته:\fP تنها \fBtool.pylint\fP الزامی است، عنوان بخش لازم نیست. این‌ها مقادیر پیش‌فرض هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint.dunder]
good\-dunder\-names = []
.EE
.UNINDENT
.UNINDENT
.SS بررسی‌کنندهٔ \fBMagic\-value\fP
.SS \-\-valid\-magic\-values
.sp
\fIفهرستی از مقادیر جادویی معتبر که \(gamagic\-value\-compare\(ga آن‌ها را شناسایی نخواهد کرد. از اعداد صحیح، اعشاری و اعداد منفی پشتیبانی می‌کند؛ برای رشتهٔ خالی \(ga\(ga\(aq\(aq\(ga\(ga را وارد کنید، برای مقادیر دارای بک‌اسلش تنها از یک بک‌اسلش استفاده کنید، مانند n.\fP
.sp
\fBپیش‌فرض:\fP  \fB(0, \-1, 1, \(aq\(aq, \(aq__main__\(aq)\fP
.sp
\fBنکته:\fP تنها \fBtool.pylint\fP الزامی است، عنوان بخش لازم نیست. این‌ها مقادیر پیش‌فرض هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint.magic\-value]
valid\-magic\-values = [0, \-1, 1, \(dq\(dq, \(dq__main__\(dq]
.EE
.UNINDENT
.UNINDENT.SS بررسی‌کنندهٔ \fBParameter_documentation\fP
.SS \-\-accept\-no\-param\-doc
.sp
\fIاینکه آیا فقدان کامل مستندات پارامتر در docstring تابعی که دارای پارامتر است پذیرفته شود یا خیر.\fP
.sp
\fBپیش‌فرض:\fP  \fBTrue\fP
.SS \-\-accept\-no\-raise\-doc
.sp
\fIاینکه آیا فقدان کامل مستندات استثناها (raises) در docstring تابعی که استثنا پرتاب می‌کند پذیرفته شود یا خیر.\fP
.sp
\fBپیش‌فرض:\fP  \fBTrue\fP
.SS \-\-accept\-no\-return\-doc
.sp
\fIاینکه آیا فقدان کامل مستندات بازگشت (return) در docstring تابعی که عبارت بازگشتی دارد پذیرفته شود یا خیر.\fP
.sp
\fBپیش‌فرض:\fP  \fBTrue\fP
.SS \-\-accept\-no\-yields\-doc
.sp
\fIاینکه آیا فقدان کامل مستندات تولید مقادیر (yields) در docstring یک مولد (generator) پذیرفته شود یا خیر.\fP
.sp
\fBپیش‌فرض:\fP  \fBTrue\fP
.SS \-\-default\-docstring\-type
.sp
\fIاگر نوع docstring قابل حدس زدن نباشد، نوع مشخص‌شده برای docstring استفاده خواهد شد.\fP
.sp
\fBپیش‌فرض:\fP  \fBdefault\fP
.sp
\fBنکته:\fP فقط \fBtool.pylint\fP لازم است، عنوان بخش الزامی نیست. این مقادیر پیش‌فرض هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint.parameter_documentation]
accept\-no\-param\-doc = true

accept\-no\-raise\-doc = true

accept\-no\-return\-doc = true

accept\-no\-yields\-doc = true

# Possible choices: [\(aqsphinx\(aq, \(aqepytext\(aq, \(aqgoogle\(aq, \(aqnumpy\(aq, \(aqdefault\(aq]
default\-docstring\-type = \(dqdefault\(dq
.EE
.UNINDENT
.UNINDENT
.SS بررسی‌کنندهٔ \fBTyping\fP
.SS \-\-runtime\-typing
.sp
\fIاگر برنامه / کتابخانه نیازی به پشتیبانی از درون‌نگری زمان اجرای حاشیه‌نویسی‌های نوع (type annotations) \fBندارد\fP، روی \(ga\(gano\(ga\(ga تنظیم کنید. اگر از حاشیه‌نویسی‌های نوع \fBصرفاً\fP برای بررسی نوع یک برنامه استفاده می‌کنید، احتمالاً مشکلی نخواهید داشت. برای کتابخانه‌ها، ابتدا ارزیابی کنید که آیا برخی کاربران می‌خواهند در زمان اجرا به نکات نوع (type hints) دسترسی داشته باشند یا خیر، مثلاً از طریق \fBtyping.get_type_hints\fP\&. برای نسخه‌های پایتون 3.7 \- 3.9 اعمال می‌شود.\fP
.sp
\fBپیش‌فرض:\fP  \fBTrue\fP
.sp
\fBنکته:\fP فقط \fBtool.pylint\fP لازم است، عنوان بخش الزامی نیست. این مقادیر پیش‌فرض هستند.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
[tool.pylint.typing]
runtime\-typing = true
.EE
.UNINDENT
.UNINDENT
.SS بررسی‌کننده‌ها
.SS قابلیت‌های Pylint
.SS گزینه‌ها و سوئیچ‌های بررسی‌کننده‌های Pylint
.sp
بررسی‌کننده‌های Pylint می‌توانند سه دسته از امکانات را ارائه دهند:
.INDENT 0.0
.IP \(bu 2
گزینه‌هایی که اجرای آن‌ها را کنترل می‌کنند،
.IP \(bu 2
پیام‌هایی که می‌توانند صادر کنند،
.IP \(bu 2
گزارش‌هایی که می‌توانند تولید کنند.
.UNINDENT
.sp
در زیر فهرستی از تمام بررسی‌کننده‌ها و قابلیت‌های آن‌ها آمده است.
.SS بررسی‌کنندهٔ Async
.sp
نام دقیق این بررسی‌کننده \fBasync\fP است..SS پیام‌های بررسی‌کننده Async
.INDENT 0.0
.TP
.B yield\-inside\-async\-function (E1700)
\fIدستور Yield درون تابع async\fP
زمانی استفاده می‌شود که یک دستور \fIyield\fP یا \fIyield from\fP درون یک تابع async یافت شود. این پیام هنگام استفاده از Python < 3.5 نمی‌تواند صادر شود.
.TP
.B not\-async\-context\-manager (E1701)
\fIمدیر بافت ناهمگام \(aq%s\(aq متدهای __aenter__ و __aexit__ را پیاده‌سازی نمی‌کند.\fP
زمانی استفاده می‌شود که یک مدیر بافت ناهمگام با شیئی به کار رود که پروتکل مدیریت بافت ناهمگام را پیاده‌سازی نمی‌کند. این پیام هنگام استفاده از Python < 3.5 نمی‌تواند صادر شود.
.UNINDENT
.SS بررسی‌کننده Bad\-Chained\-Comparison
.sp
نام دقیق بررسی‌کننده \fBbad\-chained\-comparison\fP\& است.
.SS پیام‌های بررسی‌کننده Bad\-Chained\-Comparison
.INDENT 0.0
.TP
.B bad\-chained\-comparison (W3601)
\fIمقایسه زنجیره‌ای چندبخشی (%s) مشکوک با استفاده از عملگرهای ناسازگار از نظر معنایی (%s)\fP
زمانی استفاده می‌شود که یک مقایسه زنجیره‌ای وجود دارد که در آن یک عبارت، بخشی از دو مقایسه است که به گروه‌های معنایی متفاوتی تعلق دارند (\(dq<\(dq همان معنای \(dqis\(dq را نمی‌دهد، زنجیره‌سازی آن‌ها در عبارت \(dq0 < x is None\(dq احتمالاً یک اشتباه است).
.UNINDENT
.SS بررسی‌کننده Basic
.sp
نام دقیق بررسی‌کننده \fBbasic\fP\& است.
.sp
همچنین مستندات گزینه‌های بررسی‌کننده basic را ببینید: \%<#\:basic-options>
.SS پیام‌های بررسی‌کننده Basic
.INDENT 0.0
.TP
.B init\-is\-generator (E0100)
\fIمتد __init__ یک مولد (generator) است\fP
زمانی استفاده می‌شود که متد ویژه کلاسی __init__ به دلیل وجود yield در بدنه خود به یک مولد تبدیل شده باشد.
.TP
.B return\-in\-init (E0101)
\fIدستور صریح return در __init__\fP
زمانی استفاده می‌شود که متد ویژه کلاسی __init__ دارای یک مقدار بازگشتی صریح باشد.
.TP
.B function\-redefined (E0102)
\fIمورد %s از قبل در خط %s تعریف شده است\fP
زمانی استفاده می‌شود که یک تابع / کلاس / متد دوباره تعریف شود.
.TP
.B not\-in\-loop (E0103)
\fIدستور %r به‌درستی درون حلقه قرار نگرفته است\fP
زمانی استفاده می‌شود که کلمات کلیدی break یا continue خارج از یک حلقه به کار روند.
.TP
.B return\-outside\-function (E0104)
\fIدستور Return خارج از تابع\fP
زمانی استفاده می‌شود که یک دستور \(dqreturn\(dq در خارج از تابع یا متد یافت شود.
.TP
.B yield\-outside\-function (E0105)
\fIدستور Yield خارج از تابع\fP
زمانی استفاده می‌شود که یک دستور \(dqyield\(dq در خارج از تابع یا متد یافت شود.
.TP
.B return\-arg\-in\-generator (E0106)
\fIدستور Return همراه با آرگومان درون مولد\fP
زمانی استفاده می‌شود که یک دستور \(dqreturn\(dq همراه با آرگومان درون یک تابع یا متد مولد (مثلاً دارای چند دستور \(dqyield\(dq) پیدا شود. این پیام هنگام استفاده از Python >= 3.3 نمی‌تواند صادر شود.
.TP
.B nonexistent\-operator (E0107)
\fIاستفاده از عملگر ناموجود %s\fP
زمانی استفاده می‌شود که تلاش کنید از عملگرهای پیش‌افزایش یا پیش‌کاهش به سبک زبان C شامل \-\- و ++ استفاده کنید، در حالی که در Python وجود ندارند.
.TP
.B duplicate\-argument\-name (E0108)
\fIنام آرگومان تکراری %r در تعریف تابع\fP
نام‌های آرگومان تکراری در تعریف توابع خطای نحوی (SyntaxError) هستند.
.TP
.B abstract\-class\-instantiated (E0110)
\fIکلاس انتزاعی %r با متدهای انتزاعی نمونه‌سازی شده است\fP
زمانی استفاده می‌شود که از یک کلاس انتزاعی با متاکلاس \fIabc.ABCMeta\fP که دارای متدهای انتزاعی است، نمونه‌سازی شود.
.TP
.B bad\-reversed\-sequence (E0111)
\fIاولین آرگومان reversed() یک دنباله نیست\fP
زمانی استفاده می‌شود که اولین آرگومان تابع توکار reversed() یک دنباله نباشد (متدهای __reversed__، یا __getitem__ و __len__ را پیاده‌سازی نکرده باشد).
.TP
.B too\-many\-star\-expressions (E0112)
\fIبیش از یک عبارت ستاره‌دار در انتساب\fP
هنگامی صادر می‌شود که بیش از یک عبارت ستاره‌دار (\fI*x\fP) در انتساب وجود داشته باشد. این یک SyntaxError است.
.TP
.B invalid\-star\-assignment\-target (E0113)
\fIمقصد انتساب ستاره‌دار باید درون یک لیست یا تاپل باشد\fP
هنگامی صادر می‌شود که یک عبارت ستاره‌دار به عنوان مقصد انتساب ستاره‌دار استفاده شود.
.TP
.B star\-needs\-assignment\-target (E0114)
\fIعبارت ستاره‌دار فقط در مقصد انتساب قابل استفاده است\fP
هنگامی صادر می‌شود که از یک عبارت ستاره‌دار در مقصد انتساب استفاده نشده باشد.
.TP
.B nonlocal\-and\-global (E0115)
\fIنام %r هم nonlocal و هم global است\fP
هنگامی صادر می‌شود که یک نام، هم nonlocal و هم global باشد.
.TP
.B nonlocal\-without\-binding (E0117)
\fIنام nonlocal مربوط به %s بدون انتساب یافت شد\fP
هنگامی صادر می‌شود که یک متغیر nonlocal نام متناظری در دامنه‌های والد نداشته باشد.
.TP
.B used\-prior\-global\-declaration (E0118)
\fIنام %r قبل از اعلان global استفاده شده است\fP
هنگامی صادر می‌شود که یک نام پیش از اعلان global به کار رود، که این عمل از نسخه Python 3.6 منجر به خطا می‌شود. این پیام هنگام استفاده از Python < 3.6 نمی‌تواند صادر شود.
.TP
.B misplaced\-format\-function (E0119)
\fIتابع format روی str فراخوانی نشده است\fP
هنگامی صادر می‌شود که تابع format روی شیء str فراخوانی نشود؛ مثلاً اجرای print(\(dqvalue: {}\(dq).format(123) به جای print(\(dqvalue: {}\(dq.format(123)). این احتمالاً چیزی نبوده که کاربر مد نظر داشته است.
.TP
.B unreachable (W0101)
\fIکد دست‌نیافتنی\fP
زمانی استفاده می‌شود که مقداری کد پس از یک دستور \(dqreturn\(dq یا \(dqraise\(dq وجود داشته باشد که هرگز اجرا نخواهد شد.
.TP
.B dangerous\-default\-value (W0102)
\fIمقدار پیش‌فرض خطرناک %s به عنوان آرگومان\fP
زمانی استفاده می‌شود که یک مقدار تغییرپذیر (mutable) مانند list یا dictionary در مقدار پیش‌فرض یک آرگومان شناسایی شود.
.TP
.B pointless\-statement (W0104)
\fIبه نظر می‌رسد دستور هیچ تاثیری ندارد\fP
زمانی استفاده می‌شود که یک دستور هیچ اثری نداشته باشد (یا دست‌کم این‌گونه به نظر برسد).
.TP
.B pointless\-string\-statement (W0105)
\fIدستور رشته‌ای هیچ تاثیری ندارد\fP
زمانی استفاده می‌شود که از یک رشته به عنوان دستور استفاده شود (که طبیعتاً هیچ تاثیری ندارد). این یک مورد خاص از W0104 با پیام مستقل خود است تا در صورت استفاده از این رشته‌ها به عنوان مستندات به جای کامنت، بتوانید به آسانی آن را غیرفعال کنید.
.TP
.B expression\-not\-assigned (W0106)
\fIعبارت \(dq%s\(dq به چیزی منتسب نشده است\fP
زمانی استفاده می‌شود که عبارتی که فراخوانی تابع نیست، به چیزی منتسب نشود. احتمالاً هدف چیز دیگری بوده است.
.TP
.B unnecessary\-pass (W0107)
\fIدستور pass غیرضروری\fP
زمانی استفاده می‌شود که یک دستور \(dqpass\(dq بتواند بدون تغییر در رفتار کد حذف شود.
.TP
.B unnecessary\-lambda (W0108)
\fIعبارت Lambda ممکن است غیرضروری باشد\fP
زمانی استفاده می‌شود که بدنه یک عبارت lambda یک فراخوانی تابع با همان فهرست آرگومان‌های خودِ lambda باشد؛ چنین عبارات lambda در اکثر موارد، با تابعی که درون بدنه فراخوانی می‌شود قابل جایگزینی هستند.
.TP
.B duplicate\-key (W0109)
\fIکلید تکراری %r در دیکشنری\fP
زمانی استفاده می‌شود که یک عبارت دیکشنری، یک کلید یکسان را چندین بار مقید (bind) کند.
.TP
.B useless\-else\-on\-loop (W0120)
\fIبند else در حلقه‌ای بدون دستور break؛ بند else را حذف کرده و دندانه‌گذاری کدهای درون آن را بردارید\fP
حلقه‌ها تنها در صورتی باید بند else داشته باشند که امکان خروج زودهنگام از آن‌ها با دستور break وجود داشته باشد؛ در غیر این صورت دستورات زیر else باید در همان دامنه خودِ حلقه قرار گیرند.
.TP
.B exec\-used (W0122)
\fIاستفاده از exec\fP
هنگامی صادر می‌شود که از دستور \(aqexec\(aq استفاده شود. استفاده از این تابع برای ورودی کاربر خطرناک است و همچنین به‌طور کلی کندتر از کد واقعی است. این بدان معنا نیست که هرگز نباید از آن استفاده کنید، بلکه ابتدا باید گزینه‌های جایگزین را در نظر گرفته و توابع در دسترس را محدود کنید.
.TP
.B eval\-used (W0123)
\fIاستفاده از eval\fP
زمانی استفاده می‌شود که از تابع \(dqeval\(dq استفاده کنید، تا شما را از به کار بردن آن منصرف کند. برای ارزیابی ایمن رشته‌های حاوی عبارت‌های Python از منابع غیرقابل اعتماد، استفاده از \fIast.literal_eval\fP را در نظر داشته باشید.
.TP
.B confusing\-with\-statement (W0124)
\fIقرار گرفتن مدیر بافت دیگر پس از \(dqas\(dq شبیه به یک تاپل به نظر می‌رسد.\fP
هنگامی صادر می‌شود که یکی از اجزای دستور \fIwith\fP چندین مقدار برگرداند و از انتساب نام با \fIas\fP فقط برای بخشی از این مقادیر استفاده کند، مانند with ctx() as a, b. این امر می‌تواند گمراه‌کننده باشد، زیرا مشخص نیست که آیا مدیر بافت یک تاپل برمی‌گرداند یا اینکه گره فاقد انتساب نام، خودش یک مدیر بافت دیگر است..TP
.B using\-constant\-test (W0125)
\fIاستفاده از یک دستور شرطی با یک مقدار ثابت\fP
هنگامی صادر می‌شود که یک دستور شرطی (If یا if سه‌تایی) از یک مقدار ثابت
برای آزمون خود استفاده کند. این ممکن است آن چیزی نباشد که کاربر قصد انجامش را داشته است.
.TP
.B missing\-parentheses\-for\-call\-in\-test (W0126)
\fIاستفاده از عبارت شرطی با فراخوانی احتمالاً نادرست تابع یا متد به دلیل نبود پرانتز\fP
هنگامی صادر می‌شود که به نظر برسد یک عبارت شرطی (If یا if سه‌تایی) به دلیل نبود پرانتز،
یک تابع را به نادرستی فراخوانی می‌کند.
.TP
.B self\-assigning\-variable (W0127)
\fIانتساب متغیر %r به خودش\fP
هنگامی صادر می‌شود که تشخیص دهیم یک متغیر به خودش منتسب شده است.
.TP
.B redeclared\-assigned\-name (W0128)
\fIتعریف مجدد متغیر %r در انتساب\fP
هنگامی صادر می‌شود که تشخیص دهیم یک متغیر در همان انتساب دوباره تعریف شده است.
.TP
.B assert\-on\-string\-literal (W0129)
\fIدستور assert دارای یک رشته لیترال به عنوان آرگومان نخست خود است. این assert به صورت %s با شکست مواجه خواهد شد.\fP
زمانی استفاده می‌شود که یک دستور assert یک رشته لیترال را به عنوان آرگومان نخست خود داشته باشد،
که باعث می‌شود assert همیشه با موفقیت سپری شود (pass).
.TP
.B duplicate\-value (W0130)
\fIمقدار تکراری %r در مجموعه (set)\fP
این پیام زمانی صادر می‌شود که یک set شامل یک مقدار یکسان به تعداد دو یا چند بار باشد.
.TP
.B named\-expr\-without\-context (W0131)
\fIاستفاده از عبارت نام‌گذاری‌شده (named expression) بدون بافتار (context)\fP
هنگامی صادر می‌شود که از یک عبارت نام‌گذاری‌شده برای انجام یک انتساب معمولی در خارج از
بافتارهایی مانند if، for، while یا یک comprehension استفاده شده باشد.
.TP
.B pointless\-exception\-statement (W0133)
\fIدستور استثنا (exception) هیچ اثری ندارد\fP
زمانی به کار می‌رود که یک استثنا بدون اینکه منتسب شود، برانگیخته (raise) گردد، یا برای
استفاده بعدی در جای دیگر بازگردانده (return) شود، ایجاد گردد.
.TP
.B return\-in\-finally (W0134)
\fIدستور \(aqreturn\(aq توسط بند \(aqfinally\(aq سایه‌اندازی شده است.\fP
هنگامی صادر می‌شود که یک دستور \(aqreturn\(aq در یک بلوک \(aqfinally\(aq یافت شود. این کار
مقدار بازگشتی تابع را بازنویسی خواهد کرد و باید از آن اجتناب شود.
.TP
.B contextmanager\-generator\-missing\-cleanup (W0135)
\fIاز context استفاده‌شده در تابع %r خارج نخواهد شد.\fP
زمانی استفاده می‌شود که یک contextmanager درون یک تابع ژنراتور به کار رود و
پاک‌سازی (cleanup) مدیریت نشده باشد.
.TP
.B continue\-in\-finally (W0136)
\fIاستفاده از \(aqcontinue\(aq درون بند \(aqfinally\(aq توصیه نمی‌شود\fP
هنگامی صادر می‌شود که کلمه کلیدی \fIcontinue\fP در داخل یک بند finally یافت شود. این مورد
از پایتون ۳.۱۴ به بعد یک SyntaxWarning صادر خواهد کرد.
.TP
.B break\-in\-finally (W0137)
\fIاستفاده از \(aqbreak\(aq درون بند \(aqfinally\(aq توصیه نمی‌شود\fP
هنگامی صادر می‌شود که کلمه کلیدی \fIbreak\fP در داخل یک بند finally یافت شود. این مورد
از پایتون ۳.۱۴ به بعد یک SyntaxWarning صادر خواهد کرد.
.TP
.B comparison\-with\-callable (W0143)
\fIمقایسه با یک شیء فراخوان‌پذیر (callable)، آیا پرانتزها را جا انداخته‌اید؟\fP
این پیام زمانی صادر می‌شود که pylint تشخیص دهد مقایسه‌ای با یک شیء فراخوان‌پذیر
انجام شده است، که می‌تواند نشان دهد پرانتزها جا افتاده‌اند و منجر به رفتارهای ناخواسته
احتمالی می‌شود.
.TP
.B lost\-exception (W0150)
\fIدستور %s در بلوک finally ممکن است استثنا را ببلعد\fP
زمانی استفاده می‌شود که یک دستور break یا return در داخل بند finally از
یک بلوک try...finally یافت شود: استثناهای برانگیخته‌شده در بند try به‌جای
برانگیخته‌شدن دوباره (re\-raise)، بی‌صدا بلعیده خواهند شد.
.TP
.B nan\-comparison (W0177)
\fIمقایسه %s باید %s باشد\fP
زمانی استفاده می‌شود که یک عبارت با مقادیر NaN مانند numpy.NaN و
float(\(aqnan\(aq) مقایسه شود.
.TP
.B assert\-on\-tuple (W0199)
\fIدستور assert روی یک تاپل پر فراخوانی شده است. آیا منظورتان \(aqassert x,y\(aq بوده است؟\fP
فراخوانی assert روی یک تاپل در صورتی که تاپل خالی نباشد همیشه به درستی (true)،
و اگر خالی باشد همیشه به نادرستی (false) ارزیابی می‌شود.
.TP
.B literal\-comparison (R0123)
\fIدر \(aq%s\(aq، هنگام مقایسه لیترال‌های ثابت از \(aq%s\(aq استفاده کنید نه \(aq%s\(aq (\(aq%s\(aq)\fP
هنگام مقایسه یک شیء با یک لیترال استفاده می‌شود، که معمولاً کاری نیست که
بخواهید انجام دهید، زیرا در مجموع ممکن است با لیترالی متفاوت از آنچه مورد انتظار بود مقایسه شود.
.TP
.B comparison\-with\-itself (R0124)
\fIمقایسه زائد \- %s\fP
زمانی استفاده می‌شود که چیزی با خودش مقایسه شود.
.TP
.B comparison\-of\-constants (R0133)
\fIمقایسه میان مقادیر ثابت: \(dq%s %s %s\(dq دارای یک مقدار ثابت است\fP
هنگامی که دو لیترال با یکدیگر مقایسه می‌شوند، نتیجه یک مقدار ثابت است.
استفاده مستقیم از مقدار ثابت هم خوانایی بهتری دارد و هم عملکرد بهتری را ارائه می‌دهد.
مقداردهی اولیه \(aqTrue\(aq و \(aqFalse\(aq از این طریق، از زمان پایتون ۲.۳ دیگر الزامی نیست.
.TP
.B invalid\-name (C0103)
\fIنام %s با عنوان \(dq%s\(dq با %s مطابقت ندارد\fP
زمانی استفاده می‌شود که نام با قوانین نام‌گذاری مرتبط با نوع آن
(ثابت، متغیر، کلاس...) مطابقت نداشته باشد.
.TP
.B disallowed\-name (C0104)
\fIنام غیرمجاز \(dq%s\(dq\fP
زمانی استفاده می‌شود که نام با bad\-names یا bad\-names\-rgxs\- (نام‌های غیرمجاز) مطابقت داشته باشد.
.TP
.B typevar\-name\-incorrect\-variance (C0105)
\fIنام متغیر نوع وردایی (variance) را بازتاب نمی‌دهد%s\fP
هنگامی صادر می‌شود که نام یک TypeVar وردایی نوع خود را بازتاب ندهد. طبق
PEP8، توصیه می‌شود پسوندهای \(aq_co\(aq و \(aq_contra\(aq به ترتیب به متغیرهایی اضافه شوند
که برای اعلان رفتارهای هم‌وردا (covariant) یا پادوردا (contravariant) استفاده می‌شوند. متغیرهای ناوردا
(invariant یا پیش‌فرض) نیازی به پسوند ندارند. این پیام همچنین زمانی صادر می‌شود که
متغیرهای ناوردا دارای پسوند باشند.
.TP
.B empty\-docstring (C0112)
\fIdocstring خالی برای %s\fP
زمانی استفاده می‌شود که یک ماژول، تابع، کلاس یا متد دارای docstring خالی باشد (دیگر
خیلی ساده می‌شد ;).
.TP
.B missing\-module\-docstring (C0114)
\fIdocstring ماژول وجود ندارد\fP
زمانی استفاده می‌شود که یک ماژول فاقد docstring باشد. ماژول‌های خالی نیازی به
docstring ندارند.
.TP
.B missing\-class\-docstring (C0115)
\fIdocstring کلاس وجود ندارد\fP
زمانی استفاده می‌شود که یک کلاس فاقد docstring باشد. حتی یک کلاس خالی نیز باید
دارای docstring باشد.
.TP
.B missing\-function\-docstring (C0116)
\fIdocstring تابع یا متد وجود ندارد\fP
زمانی استفاده می‌شود که یک تابع یا متد فاقد docstring باشد. برخی متدهای خاص مانند
__init__ نیازی به docstring ندارند.
.TP
.B singleton\-comparison (C0121)
\fIمقایسه %s باید %s باشد\fP
زمانی استفاده می‌شود که یک عبارت با مقادیر یگانه (singleton) مانند True، False یا
None مقایسه شود.
.TP
.B unidiomatic\-typecheck (C0123)
\fIبرای بررسی نوع، به‌جای ()type از ()isinstance استفاده کنید.\fP
روش اصطلاحی (idiomatic) برای انجام بررسی صریح نوع در پایتون، استفاده از
isinstance(x, Y) به جای type(x) == Y یا type(x) is Y است. گرچه شرایط
غیرمعمولی نیز وجود دارد که این دو نتایج متفاوتی به دست می‌دهند.
.TP
.B typevar\-double\-variance (C0131)
\fITypeVar نمی‌تواند هم‌زمان هم covariant و هم contravariant باشد\fP
هنگامی صادر می‌شود که هر دو آرگومان کلمه‌کلیدی \(dqcovariant\(dq و \(dqcontravariant\(dq در
یک TypeVar روی \(dqTrue\(dq تنظیم شده باشند.
.TP
.B typevar\-name\-mismatch (C0132)
\fIنام TypeVar با عنوان \(dq%s\(dq با نام متغیر منتسب‌شده \(dq%s\(dq مطابقت ندارد\fP
هنگامی صادر می‌شود که یک TypeVar به متغیری منتسب شود که با آرگومان نام آن
مطابقت نداشته باشد.
.UNINDENT.SS گزارش‌های وارسی‌گر پایه (Basic checker Reports)
.INDENT 0.0
.TP
.B RP0101
آمار بر پایه نوع
.UNINDENT
.SS وارسی‌گر Classes (Classes checker)
.sp
نام دقیق این وارسی‌گر \fBclasses\fP است\&.
.sp
همچنین مستندات گزینه‌های وارسی‌گر classes را ببینید \%<#\:classes-options>
.SS پیام‌های وارسی‌گر Classes (Classes checker Messages)
.INDENT 0.0
.TP
.B method\-hidden (E0202)
\fIمشخصه‌ای که در %s سطر %s تعریف شده این متد را پنهان می‌کند\fP
هنگامی استفاده می‌شود که کلاسی متدی را تعریف کند که توسط یک مشخصهٔ نمونه
از یک کلاس نیاکان یا تنظیم‌شده توسط کد کلاینت، پنهان شده باشد.
.TP
.B access\-member\-before\-definition (E0203)
\fIدسترسی به عضو %r پیش از سطر تعریف آن %s\fP
هنگامی استفاده می‌شود که به یک عضو نمونه، پیش از مقداردهی واقعی آن دسترسی پیدا شود.
.TP
.B no\-method\-argument (E0211)
\fIمتد %r هیچ آرگومانی ندارد\fP
هنگامی استفاده می‌شود که برای متدی که باید نمونهٔ مقیدشده را به عنوان نخستین آرگومان
داشته باشد، هیچ آرگومانی تعریف نشده باشد.
.TP
.B no\-self\-argument (E0213)
\fIمتد %r باید \(dqself\(dq را به عنوان نخستین آرگومان داشته باشد\fP
هنگامی استفاده می‌شود که متدی آرگومانی متفاوت با \(dqself\(dq به عنوان نخستین آرگومان داشته باشد.
این مورد به عنوان خطا در نظر گرفته می‌شود زیرا چنان قرارداد رایجی است که
نباید آن را نقض کنید!
.TP
.B invalid\-slots\-object (E0236)
\fIشیء نامعتبر %r در __slots__، باید تنها شامل رشته‌های غیرخالی باشد\fP
هنگامی استفاده می‌شود که یک شیء نامعتبر (غیررشته‌ای) در __slots__ وجود داشته باشد.
.TP
.B assigning\-non\-slot (E0237)
\fIانتساب به مشخصهٔ %r که در slots کلاس تعریف نشده است\fP
هنگامی استفاده می‌شود که مقداری به یک مشخصه که در slots کلاس تعریف نشده است انتساب یابد.
.TP
.B invalid\-slots (E0238)
\fIشیء __slots__ نامعتبر است\fP
هنگامی استفاده می‌شود که __slots__ نامعتبر در کلاس یافت شود. تنها یک رشته،
یک تکرارپذیر یا یک دنباله مجاز است.
.TP
.B inherit\-non\-class (E0239)
\fIارث‌بری از %r، که یک کلاس نیست.\fP
هنگامی استفاده می‌شود که یک کلاس از چیزی که کلاس نیست ارث‌بری کند.
.TP
.B inconsistent\-mro (E0240)
\fIترتیب تفکیک متد (MRO) ناسازگار برای کلاس %r\fP
هنگامی استفاده می‌شود که یک کلاس ترتیب تفکیک متد ناسازگاری داشته باشد.
.TP
.B duplicate\-bases (E0241)
\fIکلاس‌های پایهٔ تکراری برای کلاس %r\fP
استفادهٔ مجدد و تکراری از کلاس‌های پایه در کلاس‌های مشتق‌شده موجب بروز TypeError می‌شود.
.TP
.B class\-variable\-slots\-conflict (E0242)
\fIمقدار %r در slots با متغیر کلاس تداخل دارد\fP
هنگامی استفاده می‌شود که مقداری در __slots__ با یک متغیر کلاس، ویژگی (property) یا
متد تداخل داشته باشد.
.TP
.B invalid\-class\-object (E0243)
\fIانتساب نامعتبر به \(aq__class__\(aq. باید یک تعریف کلاس باشد اما \(aq%s\(aq دریافت شد\fP
هنگامی استفاده می‌شود که یک شیء نامعتبر به ویژگی __class__ انتساب یابد. تنها یک کلاس
مجاز است.
.TP
.B invalid\-enum\-extension (E0244)
\fIتوسعه دادن کلاس شمارشی (Enum) ارث‌بری‌شدهٔ \(dq%s\(dq\fP
هنگامی استفاده می‌شود که یک کلاس تلاش کند کلاس شمارشی (Enum) ارث‌بری‌شده‌ای را توسعه دهد. انجام
این کار در زمان اجرا موجب بروز TypeError خواهد شد.
.TP
.B declare\-non\-slot (E0245)
\fIچنین نامی %r در __slots__ وجود ندارد\fP
هنگامی صادر می‌شود که یک یادداشت نوع (type annotation) در یک کلاس، در فهرست نام‌های
موجود در __slots__ غایب باشد و __slots__ نیز شامل یک مدخل __dict__ نباشد.
.TP
.B non\-iterator\-returned (E0301)
\fI__iter__ یک غیرتکرارگر برمی‌گرداند\fP
هنگامی استفاده می‌شود که متد __iter__ چیزی را برگرداند که یک تکرارپذیر نباشد (یعنی
فاقد متد \fI__next__\fP باشد)
.TP
.B unexpected\-special\-method\-signature (E0302)
\fIمتد خاص %r انتظار %s پارامتر را دارد، %d %s داده شده است\fP
هنگامی صادر می‌شود که یک متد خاص با تعداد نامعتبری از پارامترها تعریف شده باشد.
اگر تعداد آنها بسیار کم یا بسیار زیاد باشد، ممکن است متد اصلاً کار نکند.
.TP
.B invalid\-length\-returned (E0303)
\fI__len__ یک عدد صحیح غیرمنفی برنمی‌گرداند\fP
هنگامی استفاده می‌شود که متد __len__ چیزی برگرداند که یک عدد صحیح غیرمنفی
نباشد
.TP
.B invalid\-bool\-returned (E0304)
\fI__bool__ مقدار bool برنمی‌گرداند\fP
هنگامی استفاده می‌شود که متد __bool__ چیزی برگرداند که bool نباشد
.TP
.B invalid\-index\-returned (E0305)
\fI__index__ مقدار int برنمی‌گرداند\fP
هنگامی استفاده می‌شود که متد __index__ چیزی برگرداند که یک عدد صحیح نباشد
.TP
.B invalid\-repr\-returned (E0306)
\fI__repr__ مقدار str برنمی‌گرداند\fP
هنگامی استفاده می‌شود که متد __repr__ چیزی برگرداند که یک رشته نباشد
.TP
.B invalid\-str\-returned (E0307)
\fI__str__ مقدار str برنمی‌گرداند\fP
هنگامی استفاده می‌شود که متد __str__ چیزی برگرداند که یک رشته نباشد
.TP
.B invalid\-bytes\-returned (E0308)
\fI__bytes__ مقدار bytes برنمی‌گرداند\fP
هنگامی استفاده می‌شود که متد __bytes__ چیزی برگرداند که bytes نباشد
.TP
.B invalid\-hash\-returned (E0309)
\fI__hash__ مقدار int برنمی‌گرداند\fP
هنگامی استفاده می‌شود که متد __hash__ چیزی برگرداند که یک عدد صحیح نباشد
.TP
.B invalid\-length\-hint\-returned (E0310)
\fI__length_hint__ یک عدد صحیح غیرمنفی برنمی‌گرداند\fP
هنگامی استفاده می‌شود که متد __length_hint__ چیزی برگرداند که یک عدد
صحیح غیرمنفی نباشد
.TP
.B invalid\-format\-returned (E0311)
\fI__format__ مقدار str برنمی‌گرداند\fP
هنگامی استفاده می‌شود که متد __format__ چیزی برگرداند که یک رشته نباشد
.TP
.B invalid\-getnewargs\-returned (E0312)
\fI__getnewargs__ یک چندتایی (tuple) برنمی‌گرداند\fP
هنگامی استفاده می‌شود که متد __getnewargs__ چیزی برگرداند که یک تاپل نباشد
.TP
.B invalid\-getnewargs\-ex\-returned (E0313)
\fI__getnewargs_ex__ یک تاپل شامل (tuple, dict) برنمی‌گرداند\fP
هنگامی استفاده می‌شود که متد __getnewargs_ex__ چیزی برگرداند که به
فرم tuple(tuple, dict) نباشد
.TP
.B attribute\-defined\-outside\-init (W0201)
\fIمشخصهٔ %r بیرون از __init__ تعریف شده است\fP
هنگامی استفاده می‌شود که یک مشخصهٔ نمونه در خارج از متد __init__ تعریف شود.
.TP
.B bad\-staticmethod\-argument (W0211)
\fIمتد ایستا با %r به عنوان نخستین آرگومان\fP
هنگامی استفاده می‌شود که یک متد ایستا دارای \(dqself\(dq یا مقداری مشخص‌شده در گزینهٔ
valid\-classmethod\-first\-arg یا گزینهٔ valid\-metaclass\-classmethod\-first\-arg
به عنوان نخستین آرگومان باشد.
.TP
.B protected\-access (W0212)
\fIدسترسی به عضو محافظت‌شدهٔ %s از یک کلاس کلاینت\fP
هنگامی استفاده می‌شود که به یک عضو محافظت‌شده (یعنی عضو کلاسی با نامی که با یک
زیرخط آغاز می‌شود) در خارج از کلاس یا نوادگان کلاسی که در آن تعریف شده، دسترسی پیدا شود.
.TP
.B implicit\-flag\-alias (W0213)
\fIعضو پرچم %(overlap)s جایگاه‌های بیتی مشترکی با %(sources)s دارد\fP
هنگامی استفاده می‌شود که چندین مقدار عدد صحیح تعریف‌شده درون یک کلاس enum.IntFlag، در یک
جایگاه بیتی مشترک سهیم باشند.
.TP
.B arguments\-differ (W0221)
\fIمتد %s %s %r\fP
هنگامی استفاده می‌شود که متدی تعداد آرگومان متفاوتی نسبت به رابط پیاده‌سازی‌شده
یا متد بازنویسی‌شده داشته باشد. آرگومان‌های اضافی دارای مقدار پیش‌فرض
نادیده گرفته می‌شوند.
.TP
.B signature\-differs (W0222)
\fIامضا با متد %s %r متفاوت است\fP
هنگامی استفاده می‌شود که امضای متد با رابط پیاده‌سازی‌شده یا متد
بازنویسی‌شده متفاوت باشد.
.TP
.B abstract\-method (W0223)
\fIمتد %r در کلاس %r انتزاعی است اما در کلاس فرزند %r بازنویسی نشده است\fP
هنگامی استفاده می‌شود که یک متد انتزاعی (یعنی با صادر کردن NotImplementedError)
در یک کلاس واقعی (concrete) بازنویسی نشده باشد.
.TP
.B super\-init\-not\-called (W0231)
\fIمتد __init__ از کلاس پایهٔ %r فراخوانی نشده است\fP
هنگامی استفاده می‌شود که کلاس نیاکان دارای متد __init__ باشد که توسط
کلاس مشتق‌شده فراخوانی نشده است.
.TP
.B non\-parent\-init\-called (W0233)
\fIمتد __init__ از یک کلاس پایهٔ غیرمستقیم %r فراخوانی شده است\fP
هنگامی استفاده می‌شود که متد __init__ روی کلاسی فراخوانی شود که در میان نیاکان
مستقیم کلاسِ تحلیل‌شده قرار ندارد..TP
.B invalid\-overridden\-method (W0236)
\fIانتظار می‌رفت متد %r به‌صورت %r باشد، اما در عوض %r یافت شد\fP
زمانی استفاده می‌شود که تشخیص داده شود متدی به روشی بازنویسی شده است که با کلاس پایهٔ آن مطابقت ندارد و می‌تواند منجر به بروز باگ‌های احتمالی در زمان اجرا شود.
.TP
.B arguments\-renamed (W0237)
\fI%s %s متد %r\fP
زمانی استفاده می‌شود که نام پارامتر یک متد با نام آن در رابط (interface) پیاده‌سازی‌شده یا در یک متد بازنویسی‌شده متفاوت باشد.
.TP
.B unused\-private\-member (W0238)
\fIعضو خصوصی استفاده‌نشدهٔ \(ga%s.%s\(ga\fP
زمانی صادر می‌شود که یک عضو خصوصی از یک کلاس تعریف شده باشد اما مورد استفاده قرار نگیرد.
.TP
.B overridden\-final\-method (W0239)
\fIمتد %r متدی تعریف‌شده در کلاس %r را که با typing.final تزیین شده است بازنویسی می‌کند\fP
زمانی استفاده می‌شود که متدی تزیین‌شده با typing.final بازنویسی شده باشد.
.TP
.B subclassed\-final\-class (W0240)
\fIکلاس %r زیرکلاسی از یک کلاس تزیین‌شده با typing.final است: %r\fP
زمانی استفاده می‌شود که از کلاسی تزیین‌شده با typing.final زیرکلاس ساخته شده باشد.
.TP
.B redefined\-slots\-in\-subclass (W0244)
\fIاسلات‌های بازتعریف‌شدهٔ %r در زیرکلاس\fP
زمانی استفاده می‌شود که یک اسلات در یک زیرکلاس دوباره تعریف شده باشد.
.TP
.B super\-without\-brackets (W0245)
\fIفراخوانی super بدون پرانتز\fP
زمانی استفاده می‌شود که فراخوانی super فاقد پرانتز باشد و از این رو یک فراخوانی واقعی نبوده و طبق انتظار عمل نکند.
.TP
.B useless\-parent\-delegation (W0246)
\fIتفویض بیهوده به والد یا ()super در متد %r\fP
زمانی استفاده می‌شود که بتوان تشخیص داد یک متد بازنویسی‌شده بیهوده است و با تکیه بر تفویض به والد یا ()super همان کاری را انجام می‌دهد که متد دیگری از MRO انجام می‌دهد.
.TP
.B no\-classmethod\-decorator (R0202)
\fIاستفاده از دکوراتور را به‌جای فراخوانی classmethod در نظر بگیرید\fP
زمانی استفاده می‌شود که یک متد کلاسی بدون استفاده از ساختار دکوراتور تعریف شده باشد.
.TP
.B no\-staticmethod\-decorator (R0203)
\fIاستفاده از دکوراتور را به‌جای فراخوانی staticmethod در نظر بگیرید\fP
زمانی استفاده می‌شود که یک متد ایستا بدون استفاده از ساختار دکوراتور تعریف شده باشد.
.TP
.B useless\-object\-inheritance (R0205)
\fIکلاس %r از object ارث‌بری می‌کند، در python3 می‌توان آن را با اطمینان از پایه‌ها حذف کرد\fP
زمانی استفاده می‌شود که یک کلاس از object ارث‌بری کند، که در python3 ضمنی است، بنابراین می‌توان آن را با اطمینان از کلاس‌های پایه حذف کرد.
.TP
.B property\-with\-parameters (R0206)
\fIنمی‌توان برای ویژگی‌ها (properties) پارامتر تعریف کرد\fP
زمانی استفاده می‌شود که تشخیص داده شود یک ویژگی دارای پارامتر نیز هست، که بی‌فایده است زیرا ویژگی‌ها را نمی‌توان با آرگومان‌های اضافی فراخوانی کرد.
.TP
.B bad\-classmethod\-argument (C0202)
\fIمتد کلاسی %s باید %s را به عنوان آرگومان نخست داشته باشد\fP
زمانی استفاده می‌شود که نام آرگومان نخست یک متد کلاسی با مقدار مشخص‌شده در گزینهٔ valid\-classmethod\-first\-arg (پیش‌فرض \(dqcls\(dq) متفاوت باشد؛ رعایت این مورد برای تمایز آسان آن‌ها از متدهای معمولی نمونه توصیه می‌شود.
.TP
.B bad\-mcs\-method\-argument (C0203)
\fIمتد متاکلاس %s باید %s را به عنوان آرگومان نخست داشته باشد\fP
زمانی استفاده می‌شود که نام آرگومان نخست یک متد متاکلاس با مقدار مشخص‌شده در گزینهٔ valid\-classmethod\-first\-arg (پیش‌فرض \(dqcls\(dq) متفاوت باشد؛ رعایت این مورد برای تمایز آسان آن‌ها از متدهای معمولی نمونه توصیه می‌شود.
.TP
.B bad\-mcs\-classmethod\-argument (C0204)
\fIمتد کلاسی متاکلاس %s باید %s را به عنوان آرگومان نخست داشته باشد\fP
زمانی استفاده می‌شود که نام آرگومان نخست یک متد کلاسی متاکلاس با مقدار مشخص‌شده در گزینهٔ valid\-metaclass\-classmethod\-first\-arg (پیش‌فرض \(dqmcs\(dq) متفاوت باشد؛ رعایت این مورد برای تمایز آسان آن‌ها از متدهای معمولی نمونه توصیه می‌شود.
.TP
.B single\-string\-used\-for\-slots (C0205)
\fIویژگی __slots__ کلاس باید یک شیء پیمایش‌پذیر غیررشته‌ای باشد\fP
زمانی استفاده می‌شود که __slots__ کلاس به‌جای یک شیء پیمایش‌پذیر، یک رشتهٔ ساده باشد.
.TP
.B method\-check\-failed (F0202)
\fIناتوان در بررسی امضای متدها (%s / %s)\fP
زمانی استفاده می‌شود که Pylint به دلیلی غیرمنتظره قادر به بررسی سازگاری امضای متدها نبوده باشد. لطفاً در صورت مشاهدهٔ این مورد، آن را گزارش دهید.
.UNINDENT.SS بررسی‌کننده Dataclass (Dataclass checker)
.sp
نام دقیق این بررسی‌کننده \fBdataclass\fP است\&.
.SS پیام‌های بررسی‌کننده Dataclass (Dataclass checker Messages)
.INDENT 0.0
.TP
.B invalid\-field\-call (E3701)
\fIInvalid usage of field(), %s\fP
مشخص‌کنندهٔ dataclasses.field() تنها باید به عنوان مقدار یک انتساب درون یک dataclass، یا درون تابع make_dataclass() استفاده شود.
.UNINDENT
.SS بررسی‌کننده طراحی (Design checker)
.sp
نام دقیق این بررسی‌کننده \fBdesign\fP است\&.
.sp
همچنین مستندات گزینه‌های بررسی‌کنندهٔ design را ببینید: \%<#\:design-options>
.SS پیام‌های بررسی‌کننده طراحی (Design checker Messages)
.INDENT 0.0
.TP
.B too\-many\-ancestors (R0901)
\fIToo many ancestors (%s/%s)\fP
هنگامی استفاده می‌شود که کلاس بیش از حد کلاس‌های والد (اجداد) داشته باشد؛ تلاش کنید آن را کاهش دهید تا به کلاسی ساده‌تر (و در نتیجه با کاربرد آسان‌تر) دست یابید.
.TP
.B too\-many\-instance\-attributes (R0902)
\fIToo many instance attributes (%s/%s)\fP
هنگامی استفاده می‌شود که کلاس بیش از حد مشخصه‌های نمونه داشته باشد؛ تلاش کنید آن را کاهش دهید تا به کلاسی ساده‌تر (و در نتیجه با کاربرد آسان‌تر) دست یابید.
.TP
.B too\-few\-public\-methods (R0903)
\fIToo few public methods (%s/%s)\fP
هنگامی استفاده می‌شود که کلاس متدهای عمومی بسیار کمی دارد؛ بنابراین مطمئن شوید که واقعاً ارزشش را دارد.
.TP
.B too\-many\-public\-methods (R0904)
\fIToo many public methods (%s/%s)\fP
هنگامی استفاده می‌شود که کلاس متدهای عمومی بیش از حد داشته باشد؛ تلاش کنید آن را کاهش دهید تا به کلاسی ساده‌تر (و در نتیجه با کاربرد آسان‌تر) دست یابید.
.TP
.B too\-many\-return\-statements (R0911)
\fIToo many return statements (%s/%s)\fP
هنگامی استفاده می‌شود که یک تابع یا متد بیش از حد دستور بازگشت (return) داشته باشد که دنبال کردن آن را دشوار می‌کند.
.TP
.B too\-many\-branches (R0912)
\fIToo many branches (%s/%s)\fP
هنگامی استفاده می‌شود که یک تابع یا متد بیش از حد شاخه داشته باشد که دنبال کردن آن را دشوار می‌کند.
.TP
.B too\-many\-arguments (R0913)
\fIToo many arguments (%s/%s)\fP
هنگامی استفاده می‌شود که یک تابع یا متد بیش از حد آرگومان بپذیرد.
.TP
.B too\-many\-locals (R0914)
\fIToo many local variables (%s/%s)\fP
هنگامی استفاده می‌شود که یک تابع یا متد بیش از حد متغیر محلی داشته باشد.
.TP
.B too\-many\-statements (R0915)
\fIToo many statements (%s/%s)\fP
هنگامی استفاده می‌شود که یک تابع یا متد بیش از حد دستور داشته باشد. در این صورت باید آن را به توابع یا متدهای کوچک‌تر تقسیم کنید.
.TP
.B too\-many\-boolean\-expressions (R0916)
\fIToo many boolean expressions in if statement (%s/%s)\fP
هنگامی استفاده می‌شود که یک دستور if شامل عبارت‌های بولی بیش از حد باشد.
.TP
.B too\-many\-positional\-arguments (R0917)
\fIToo many positional arguments (%s/%s)\fP
هنگامی استفاده می‌شود که یک تابع بیش از حد آرگومان مکانی بپذیرد.
.UNINDENT
.SS بررسی‌کننده استثناها (Exceptions checker)
.sp
نام دقیق این بررسی‌کننده \fBexceptions\fP است\&.
.sp
همچنین مستندات گزینه‌های بررسی‌کنندهٔ exceptions را ببینید: \%<#\:exceptions-options>
.SS پیام‌های بررسی‌کننده استثناها (Exceptions checker Messages)
.INDENT 0.0
.TP
.B bad\-except\-order (E0701)
\fIBad except clauses order (%s)\fP
هنگامی استفاده می‌شود که بندهای except به ترتیب درست (از خاص‌ترین به عمومی‌ترین) قرار نگرفته باشند. اگر این ترتیب را اصلاح نکنید، ممکن است برخی استثناها توسط گردانندهٔ خاص‌تر گرفته نشوند.
.TP
.B raising\-bad\-type (E0702)
\fIRaising %s while only classes or instances are allowed\fP
هنگامی استفاده می‌شود که چیزی که نه یک کلاس و نه یک نمونه است برانگیخته (raise) شود (یعنی یک \fITypeError\fP برانگیخته خواهد شد).
.TP
.B misplaced\-bare\-raise (E0704)
\fIThe raise statement is not inside an except clause\fP
هنگامی استفاده می‌شود که یک دستور raise خالی درون یک بند except به کار نرفته باشد. این کار خطا ایجاد می‌کند، زیرا هیچ استثنای فعالی برای ایجاد مجدد (re-raise) وجود ندارد. یک استثنا بر این قاعده، raise خالی درون یک بند finally است که تا زمانی که استثنایی درون بلوک try ایجاد شده باشد ممکن است کار کند، اما با این وجود یک بوی بد کد (code smell) است و نباید به آن اتکا کرد.
.TP
.B bad\-exception\-cause (E0705)
\fIException cause set to something which is not an exception, nor None\fP
هنگامی استفاده می‌شود که از نحو \(dqraise ... from ...\(dq استفاده شود، در حالی که علت استثنا نه یک استثنا است و نه None.
.TP
.B raising\-non\-exception (E0710)
\fIRaising a class which doesn\(aqt inherit from BaseException\fP
هنگامی استفاده می‌شود که کلاسی برانگیخته (raise) شود که از BaseException ارث‌بری نمی‌کند.
.TP
.B notimplemented\-raised (E0711)
\fINotImplemented raised \- should raise NotImplementedError\fP
هنگامی استفاده می‌شود که به جای NotImplementedError مقدار NotImplemented برانگیخته (raise) شود.
.TP
.B catching\-non\-exception (E0712)
\fICatching an exception which doesn\(aqt inherit from Exception: %s\fP
هنگامی استفاده می‌شود که کلاسی که از Exception ارث‌بری نمی‌کند به عنوان استثنا در یک بند except استفاده شود.
.TP
.B bare\-except (W0702)
\fINo exception type(s) specified\fP
یک بند خالی \fBexcept:\fP استثناهای \fBSystemExit\fP و \fBKeyboardInterrupt\fP را دریافت خواهد کرد که این کار متوقف کردن برنامه با \fBControl\-C\fP را دشوارتر ساخته و می‌تواند مشکلات دیگر را پنهان کند. اگر می‌خواهید تمام استثناهایی را که بیانگر خطاهای برنامه هستند دریافت کنید، از \fBexcept Exception:\fP استفاده نمایید (\fBexcept\fP خالی معادل \fBexcept BaseException:\fP است).
.TP
.B duplicate\-except (W0705)
\fICatching previously caught exception type %s\fP
هنگامی استفاده می‌شود که یک except نوعی را دریافت کند که پیش‌تر توسط یک گردانندهٔ قبلی گرفته شده است.
.TP
.B try\-except\-raise (W0706)
\fIThe except handler raises immediately\fP
هنگامی استفاده می‌شود که یک گردانندهٔ except از raise به عنوان اولین یا تنها عملگر خود استفاده کند. این کار بیهوده است زیرا بلافاصله استثنا را دوباره برمی‌انگیزد. عملگر raise یا کل بلوک try\-except\-raise را حذف کنید!
.TP
.B raise\-missing\-from (W0707)
\fIConsider explicitly re\-raising using %s\(aq%s from %s\(aq\fP
زنجیره‌سازی استثناها (exception chaining) در Python ردپای پشتهٔ (traceback) استثنای فعلی و همچنین استثنای اصلی را نشان می‌دهد. هنگامی که پس از دریافت یک استثنا، استثنای جدیدی برمی‌انگیزید، محتمل است که استثنای دوم بسته‌بندی مجدد و مناسب‌تری از استثنای اول باشد. در چنین مواردی، \fIraise from\fP پیوند بهتری را بین دو traceback در خطای نهایی برقرار می‌کند.
.TP
.B binary\-op\-exception (W0711)
\fIException to catch is the result of a binary \(dq%s\(dq operation\fP
هنگامی استفاده می‌شود که استثنای مورد نظر برای دریافت، به فرم \(dqexcept A or B:\(dq باشد. اگر قصد دریافت چندین استثنا را دارید، آن را به صورت \(dqexcept (A, B):\(dq بازنویسی کنید.
.TP
.B raising\-format\-tuple (W0715)
\fIException arguments suggest string formatting might be intended\fP
هنگامی استفاده می‌شود که چندین آرگومان به سازندهٔ استثنا ارسال شود که نخستین آن‌ها یک لیترال رشته‌ای حاوی مواردی است که به نظر می‌رسد جایگزین‌هایی برای قالب‌بندی باشند.
.TP
.B wrong\-exception\-operation (W0716)
\fIInvalid exception operation. %s\fP
هنگامی استفاده می‌شود که عملیاتی روی یک استثنا انجام شود، اما آن عملیات برای استثنای مد نظر معتبر نباشد. معمولاً هنگام وجود عملیات دودویی میان استثناها در گرداننده‌های except صادر می‌شود.
.TP
.B broad\-exception\-caught (W0718)
\fICatching too general exception %s\fP
اگر از یک بند سادهٔ \fBexcept Exception:\fP استفاده کنید، ممکن است در نهایت استثناهایی غیر از مواردی که انتظارش را دارید دریافت کنید. این کار می‌تواند باگ‌ها را مخفی کند یا با پنهان کردن خطاهای غیرمرتبط، اشکال‌زدایی برنامه‌ها را دشوارتر سازد.
.TP
.B broad\-exception\-raised (W0719)
\fIRaising too general exception: %s\fP
برانگیختن استثناهایی که بیش از حد عمومی هستند، شما را وادار می‌کند تا استثناها را نیز به صورت عمومی دریافت کنید. این امر شما را ناچار به استفاده از یک بند سادهٔ \fBexcept Exception:\fP خواهد کرد؛ آن‌گاه ممکن است در نهایت استثناهایی به جز موارد مورد نظرتان را دریافت کنید. این کار می‌تواند باگ‌ها را مخفی کند یا با پنهان کردن خطاهای غیرمرتبط، اشکال‌زدایی برنامه‌ها را دشوارتر سازد.
.UNINDENT.SS بررسی‌کننده قالب‌بندی (Format checker)
.sp
نام دقیق این بررسی‌کننده \fBformat\fP است\&.
.sp
همچنین مستندات گزینه‌های بررسی‌کننده format را ببینید: \%<#\:format-options>
.SS پیام‌های بررسی‌کننده قالب‌بندی (Format checker Messages)
.INDENT 0.0
.TP
.B unnecessary\-semicolon (W0301)
\fIنقطه‌ویرگول غیرضروری\fP
زمانی استفاده می‌شود که یک دستور با نقطه‌ویرگول (\(dq;\(dq) پایان یابد، که نیازی به آن نیست
(این python است، نه C ;).
.TP
.B bad\-indentation (W0311)
\fIدندانه‌گذاری نادرست. مقدار %s %s یافت شد، مورد انتظار: %s\fP
زمانی استفاده می‌شود که تعداد غیرمنتظره‌ای از نویسه‌های تب یا فاصله‌های دندانه‌گذاری
یافت شود.
.TP
.B line\-too\-long (C0301)
\fIخط بسیار طولانی (%s/%s)\fP
زمانی استفاده می‌شود که یک خط از تعداد معینی نویسه طولانی‌تر باشد.
.TP
.B too\-many\-lines (C0302)
\fIخطوط بیش از حد در پودمان (%s/%s)\fP
زمانی استفاده می‌شود که یک پودمان خطوط بسیار زیادی داشته باشد و خوانایی آن کاهش یابد.
.TP
.B trailing\-whitespace (C0303)
\fIفاصله‌های خالی انتهای خط\fP
زمانی استفاده می‌شود که بین پایان خط و نویسه خط جدید، فاصله خالی وجود داشته باشد.
.TP
.B missing\-final\-newline (C0304)
\fIخط جدید پایانی وجود ندارد\fP
زمانی استفاده می‌شود که آخرین خط یک فایل فاقد خط جدید باشد.
.TP
.B trailing\-newlines (C0305)
\fIخط‌های جدید انتهایی\fP
زمانی استفاده می‌شود که خطوط خالی اضافی در انتهای فایل وجود داشته باشد.
.TP
.B multiple\-statements (C0321)
\fIبیش از یک دستور در یک خط\fP
زمانی استفاده می‌شود که بیش از یک دستور در یک خط یافت شود.
.TP
.B superfluous\-parens (C0325)
\fIپرانتزهای غیرضروری پس از کلیدواژه %r\fP
زمانی استفاده می‌شود که یک قلم تنها درون پرانتز پس از کلیدواژه‌های if، for یا دیگر کلیدواژه‌ها قرار گیرد.
.TP
.B mixed\-line\-endings (C0327)
\fIپایان خط‌های ترکیبی LF و CRLF\fP
زمانی استفاده می‌شود که نشانه‌های خط جدید ترکیبی (LF و CRLF) در یک فایل وجود داشته باشد.
.TP
.B unexpected\-line\-ending\-format (C0328)
\fIقالب پایان خط غیرمنتظره. مقدار \(aq%s\(aq وجود دارد در حالی که باید \(aq%s\(aq باشد.\fP
زمانی استفاده می‌شود که پایان خط با مقدار مورد انتظار متفاوت باشد.
.UNINDENT
.SS بررسی‌کننده واردسازی‌ها (Imports checker)
.sp
نام دقیق این بررسی‌کننده \fBimports\fP است\&.
.sp
همچنین مستندات گزینه‌های بررسی‌کننده imports را ببینید: \%<#\:imports-options>
.SS پیام‌های بررسی‌کننده واردسازی‌ها (Imports checker Messages)
.INDENT 0.0
.TP
.B import\-error (E0401)
\fIناتوان در واردسازی %s\fP
زمانی استفاده می‌شود که pylint نتوانسته باشد یک پودمان را وارد کند.
.TP
.B relative\-beyond\-top\-level (E0402)
\fIتلاش برای واردسازی نسبی فراتر از بالاترین سطح بسته\fP
زمانی استفاده می‌شود که یک واردسازی نسبی تلاش کند به سطوحی فراتر از بسته
جاری دسترسی یابد.
.TP
.B wildcard\-import (W0401)
\fIواردسازی با نویسه عمومی %s\fP
زمانی استفاده می‌شود که \fIfrom module import *\fP شناسایی شود.
.TP
.B reimported (W0404)
\fIواردسازی دوباره %r (واردشده در خط %s)\fP
زمانی استفاده می‌شود که یک پودمان بیش از یک بار وارد شود.
.TP
.B import\-self (W0406)
\fIواردسازی پودمان توسط خودش\fP
زمانی استفاده می‌شود که یک پودمان خودش را وارد کند.
.TP
.B preferred\-module (W0407)
\fIترجیح واردسازی %r به‌جای %r\fP
زمانی استفاده می‌شود که برای پودمان واردشده یک پودمان جایگزین ترجیحی وجود داشته باشد.
.TP
.B misplaced\-future (W0410)
\fIواردسازی __future__ نخستین دستور غیر docstring نیست\fP
در Python 2.5 و بالاتر الزامی است که واردسازی __future__ نخستین دستور غیر
docstring در پودمان باشد.
.TP
.B shadowed\-import (W0416)
\fIواردسازی پوشانده‌شده %r (واردشده در خط %s)\fP
زمانی استفاده می‌شود که یک پودمان با نام مستعاری مشخص شود که واردسازی دیگری را می‌پوشاند.
.TP
.B deprecated\-module (W4901)
\fIپودمان منسوخ‌شده %r\fP
پودمانی که به عنوان منسوخ‌شده علامت‌گذاری شده، وارد شده است.
.TP
.B cyclic\-import (R0401)
\fIواردسازی چرخه‌ای (%s)\fP
زمانی استفاده می‌شود که یک واردسازی چرخه‌ای میان دو یا چند پودمان شناسایی شود.
.TP
.B consider\-using\-from\-import (R0402)
\fIبه‌جای آن از \(aqfrom %s import %s\(aq استفاده کنید\fP
زمانی صادر می‌شود که یک زیرپودمان از یک بسته وارد شده و با همان نام مستعار
نام‌گذاری شود؛ برای نمونه به‌جای \fBimport concurrent.futures as futures\fP از \fBfrom
concurrent import futures\fP استفاده کنید\&.
.TP
.B multiple\-imports (C0410)
\fIچندین واردسازی در یک خط (%s)\fP
زمانی استفاده می‌شود که دستور import که چندین پودمان را وارد می‌کند شناسایی شود.
.TP
.B wrong\-import\-order (C0411)
\fI%s باید پیش از %s قرار گیرد\fP
زمانی استفاده می‌شود که ترتیب واردسازی‌های PEP8 رعایت نشده باشد (ابتدا واردسازی‌های استاندارد، سپس
کتابخانه‌های شخص ثالث، و در نهایت واردسازی‌های محلی).
.TP
.B ungrouped\-imports (C0412)
\fIواردسازی‌ها از بسته %s گروه‌بندی نشده‌اند\fP
زمانی استفاده می‌شود که واردسازی‌ها بر اساس بسته‌ها گروه‌بندی نشده باشند.
.TP
.B wrong\-import\-position (C0413)
\fIواردسازی \(dq%s\(dq باید در بالای پودمان قرار گیرد\fP
زمانی استفاده می‌شود که کدها و واردسازی‌ها با یکدیگر آمیخته شده باشند.
.TP
.B useless\-import\-alias (C0414)
\fIنام مستعار واردسازی نام بسته اصلی را تغییر نمی‌دهد\fP
زمانی استفاده می‌شود که نام مستعار واردسازی با بسته اصلی یکسان باشد؛ برای نمونه، استفاده از import
numpy as numpy به‌جای import numpy as np.
.TP
.B import\-outside\-toplevel (C0415)
\fIواردسازی خارج از بالاترین سطح (%s)\fP
زمانی استفاده می‌شود که دستور واردسازی در جایی غیر از بالاترین سطح (toplevel)
پودمان به کار رفته باشد. این واردسازی را به بالای فایل منتقل کنید.
.UNINDENT.SS گزارش‌های بررسی‌کننده Imports
.INDENT 0.0
.TP
.B RP0401
وابستگی‌های خارجی
.TP
.B RP0402
گراف وابستگی‌های ماژول‌ها
.UNINDENT
.SS بررسی‌کننده Lambda\-Expressions
.sp
نام دقیق بررسی‌کننده \fBlambda\-expressions\fP است\&.
.SS پیام‌های بررسی‌کننده Lambda\-Expressions
.INDENT 0.0
.TP
.B unnecessary\-lambda\-assignment (C3001)
\fIعبارت لامبدا به یک متغیر نسبت داده شده است. در عوض تابعی را با کلیدواژه \(dqdef\(dq تعریف کنید.\fP
هنگامی استفاده می‌شود که یک عبارت لامبدا به جای تعریف تابعی استاندارد با کلیدواژه \(dqdef\(dq، به یک متغیر نسبت داده شود.
.TP
.B unnecessary\-direct\-lambda\-call (C3002)
\fIعبارت لامبدا مستقیماً فراخوانی شده است. به جای آن عبارت را به‌صورت درون‌خطی اجرا کنید.\fP
هنگامی استفاده می‌شود که یک عبارت لامبدا به جای اجرای درون‌خطی (inline) محتوای آن، به‌طور مستقیم فراخوانی شود.
.UNINDENT
.SS بررسی‌کننده Logging
.sp
نام دقیق بررسی‌کننده \fBlogging\fP است\&.
.sp
همچنین مستندات گزینه‌های بررسی‌کننده logging را ببینید: \%<#\:logging-options>
.SS پیام‌های بررسی‌کننده Logging
.INDENT 0.0
.TP
.B logging\-unsupported\-format (E1200)
\fIکاراکتر قالب‌بندی لاگ‌گیری پشتیبانی‌نشده %r (%#02x) در اندیس %d\fP
هنگامی استفاده می‌شود که یک نویسه قالب‌بندی پشتیبانی‌نشده در رشته قالب یک عبارت لاگ‌گیری به کار رود.
.TP
.B logging\-format\-truncated (E1201)
\fIرشته قالب لاگ‌گیری در میانه مشخص‌کننده تبدیل پایان یافته است\fP
هنگامی استفاده می‌شود که رشته قالب عبارت لاگ‌گیری پیش از پایان مشخص‌کننده تبدیل خاتمه یابد.
.TP
.B logging\-too\-many\-args (E1205)
\fIآرگومان‌های بیش از حد برای رشته قالب لاگ‌گیری\fP
هنگامی استفاده می‌شود که آرگومان‌های بیش از اندازه‌ای به رشته قالب لاگ‌گیری داده شود.
.TP
.B logging\-too\-few\-args (E1206)
\fIنبود آرگومان‌های کافی برای رشته قالب لاگ‌گیری\fP
هنگامی استفاده می‌شود که آرگومان‌های بسیار کمی به رشته قالب لاگ‌گیری داده شود.
.TP
.B logging\-not\-lazy (W1201)
\fIاستفاده از قالب‌بندی %s در توابع لاگ‌گیری\fP
هنگامی استفاده می‌شود که عبارت لاگ‌گیری شکلی مانند \(dqlogging.<logging
method>(format_string % (format_args...))\(dq داشته باشد. در عوض از نوع دیگری از قالب‌بندی رشته
استفاده کنید. می‌توانید از قالب‌بندی % استفاده کنید اما با ارسال پارامترها به عنوان آرگومان،
جای‌گذاری (interpolation) را به تابع لاگ‌گیری بسپارید. اگر logging\-fstring\-
interpolation غیرفعال باشد، می‌توانید از قالب‌بندی fstring استفاده کنید. اگر logging\-
format\-interpolation غیرفعال باشد، می‌توانید از str.format استفاده کنید.
.TP
.B logging\-format\-interpolation (W1202)
\fIاستفاده از قالب‌بندی %s در توابع لاگ‌گیری\fP
هنگامی استفاده می‌شود که عبارت لاگ‌گیری شکلی مانند \(dqlogging.<logging
method>(format_string.format(format_args...))\(dq داشته باشد. در عوض از نوع دیگری از قالب‌بندی رشته
استفاده کنید. می‌توانید از قالب‌بندی % استفاده کنید اما با ارسال پارامترها به عنوان آرگومان،
جای‌گذاری (interpolation) را به تابع لاگ‌گیری بسپارید. اگر logging\-fstring\-
interpolation غیرفعال باشد، می‌توانید از قالب‌بندی fstring استفاده کنید. اگر logging\-
not\-lazy غیرفعال باشد، می‌توانید به‌صورت عادی از قالب‌بندی % استفاده کنید.
.TP
.B logging\-fstring\-interpolation (W1203)
\fIاستفاده از قالب‌بندی %s در توابع لاگ‌گیری\fP
هنگامی استفاده می‌شود که عبارت لاگ‌گیری شکلی مانند \(dqlogging.<logging
method>(f\(dq...\(dq)\(dq داشته باشد. در عوض از نوع دیگری از قالب‌بندی رشته استفاده کنید. می‌توانید از %
برای قالب‌بندی استفاده کنید اما با ارسال پارامترها به عنوان آرگومان، جای‌گذاری را به تابع لاگ‌گیری
بسپارید. اگر logging\-format\-interpolation غیرفعال باشد، می‌توانید از str.format
استفاده کنید. اگر logging\-not\-lazy غیرفعال باشد، می‌توانید به‌صورت عادی از قالب‌بندی
% استفاده کنید.
.UNINDENT
.SS بررسی‌کننده دستورهای Match
.sp
نام دقیق بررسی‌کننده \fBmatch_statements\fP است\&..SS پیام‌های بررسی‌کنندهٔ دستورهای Match
.INDENT 0.0
.TP
.B bare\-name\-capture\-pattern (E1901)
\fIالگوی تصاحب نام \(gacase %s\(ga باعث غیرقابل‌دسترس شدن الگوهای بعدی می‌شود. برای رفع این مشکل از یک نام نقطه‌دار (مانند یک enum) استفاده کنید.\fP
زمانی صادر می‌شود که یک الگوی تصاحب نام در دستور match استفاده شده و دستورهای case دیگری پس از آن آمده باشند.
.TP
.B invalid\-match\-args\-definition (E1902)
\fI\(ga__match_args__\(ga باید یک تاپل از رشته‌ها باشد.\fP
زمانی صادر می‌شود که \fI__match_args__\fP تاپلی از رشته‌های لازم برای match نباشد.
.TP
.B too\-many\-positional\-sub\-patterns (E1903)
\fI%s انتظار %d زیرالگوی موقعیتی دارد (%d داده شده است)\fP
زمانی صادر می‌شود که تعداد زیرالگوهای موقعیتی از تعداد مجاز مشخص‌شده در \fI__match_args__\fP فراتر رود.
.TP
.B multiple\-class\-sub\-patterns (E1904)
\fIچندین زیرالگو برای ویژگی %s مشخص شده است\fP
زمانی صادر می‌شود که بیش از یک زیرالگو برای یک ویژگی مشخص در الگوی کلاس وجود داشته باشد.
.TP
.B match\-class\-bind\-self (R1905)
\fIبه‌جای آن از \(aq%s() as %s\(aq استفاده کنید\fP
الگوهای کلاس match زمانی سریع‌تر اجرا می‌شوند که انتساب نام برای کل الگو صورت گیرد و از هرگونه جست‌وجو برای \fI__match_args__\fP صرف‌نظر شود.
.TP
.B match\-class\-positional\-attributes (R1906)
\fIبه‌جای ویژگی‌های موقعیتی از ویژگی‌های کلیدواژه‌ای استفاده کنید (%s)\fP
ویژگی‌های کلیدواژه‌ای صریح‌تر و اندکی سریع‌تر هستند، زیرا CPython می‌تواند از جست‌وجوی \fI__match_args__\fP صرف‌نظر کند.
.UNINDENT
.SS بررسی‌کنندهٔ آرگومان‌های متد (Method Args)
.sp
نام دقیق این بررسی‌کننده \fBmethod_args\fP است.
.sp
همچنین مستندات گزینه‌های بررسی‌کنندهٔ method_args را ببینید: \%<#\:method-args-options>
.SS پیام‌های بررسی‌کنندهٔ آرگومان‌های متد (Method Args)
.INDENT 0.0
.TP
.B positional\-only\-arguments\-expected (E3102)
\fIبه \(ga%s()\(ga تعدادی آرگومان فقط‌موقعیتی به‌صورت آرگومان کلیدواژه‌ای داده شده است: %s\fP
زمانی صادر می‌شود که آرگومان‌های فقط‌موقعیتی به‌صورت آرگومان‌های کلیدواژه‌ای ارسال شده باشند. کلیدواژه‌ها را برای آرگومان‌های مربوطه در فراخوانی تابع حذف کنید.
.TP
.B missing\-timeout (W3101)
\fIنبود آرگومان timeout برای متد \(aq%s\(aq می‌تواند برنامهٔ شما را به طور نامحدود متوقف کند\fP
زمانی استفاده می‌شود که متدی برای جلوگیری از انتظار طولانی‌مدت به پارامتر \(aqtimeout\(aq نیاز داشته باشد. اگر هیچ مهلت زمانی به‌طور صریح مشخص نشود، مقدار پیش‌فرض استفاده خواهد شد. برای نمونه در \(aqrequests\(aq، برنامه هرگز منقضی نخواهد شد (یعنی تا ابد قفل می‌شود).
.UNINDENT
.SS بررسی‌کنندهٔ سنجه‌ها (Metrics)
.sp
نام دقیق این بررسی‌کننده \fBmetrics\fP است.
.SS گزارش‌های بررسی‌کنندهٔ سنجه‌ها (Metrics)
.INDENT 0.0
.TP
.B RP0701
سنجه‌های خام
.UNINDENT
.SS بررسی‌کنندهٔ متفرقه (Miscellaneous)
.sp
نام دقیق این بررسی‌کننده \fBmiscellaneous\fP است.
.sp
همچنین مستندات گزینه‌های بررسی‌کنندهٔ miscellaneous را ببینید: \%<#\:miscellaneous-options>
.SS پیام‌های بررسی‌کنندهٔ متفرقه (Miscellaneous)
.INDENT 0.0
.TP
.B fixme (W0511)
زمانی استفاده می‌شود که یادداشت هشداری مانند FIXME یا XXX تشخیص داده شود.
.TP
.B use\-symbolic\-message\-instead (I0023)
زمانی استفاده می‌شود که پیامی با استفاده از شناسه (id) فعال یا غیرفعال شود.
.UNINDENT
.SS بررسی‌کنندهٔ پیمایش تغییریافته (Modified Iteration)
.sp
نام دقیق این بررسی‌کننده \fBmodified_iteration\fP است.
.SS پیام‌های بررسی‌کنندهٔ پیمایش تغییریافته (Modified Iteration)
.INDENT 0.0
.TP
.B modified\-iterating\-dict (E4702)
\fIdict در حال پیمایش \(aq%s\(aq در بدنهٔ حلقهٔ for در حال تغییر است، به‌جای آن یک رونوشت از آن را پیمایش کنید.\fP
زمانی صادر می‌شود که مواردی به دیکشنری (dict) در حال پیمایش اضافه یا از آن حذف شوند. انجام این کار خطای RuntimeError ایجاد می‌کند.
.TP
.B modified\-iterating\-set (E4703)
\fIset در حال پیمایش \(aq%s\(aq در بدنهٔ حلقهٔ for در حال تغییر است، به‌جای آن یک رونوشت از آن را پیمایش کنید.\fP
زمانی صادر می‌شود که مواردی به مجموعه (set) در حال پیمایش اضافه یا از آن حذف شوند. انجام این کار خطای RuntimeError ایجاد می‌کند.
.TP
.B modified\-iterating\-list (W4701)
\fIlist در حال پیمایش \(aq%s\(aq در بدنهٔ حلقهٔ for در حال تغییر است، پیمایش روی یک رونوشت از آن را در نظر بگیرید.\fP
زمانی صادر می‌شود که مواردی به لیست (list) در حال پیمایش اضافه یا از آن حذف شوند. انجام این کار می‌تواند به رفتار غیرمنتظره منجر شود؛ به همین دلیل بهتر است از یک رونوشت از لیست استفاده شود.
.UNINDENT.SS بازبین Nested Min Max (Nested Min Max checker)
.sp
نام دقیق بازبین \fBnested_min_max\fP است\&.
.SS پیام‌های بازبین Nested Min Max (Nested Min Max checker Messages)
.INDENT 0.0
.TP
.B nested\-min\-max (W3301)
\fIاز فراخوانی تو‌درتوی \(aq%s\(aq استفاده نکنید؛ می‌توان به‌جای آن از \(aq%s\(aq استفاده کرد\fP
فراخوانی‌های تو‌درتوی \fBmin(1, min(2, 3))\fP را می‌توان به‌صورت \fBmin(1, 2, 3)\fP بازنویسی کرد\&.
.UNINDENT
.SS بازبین Newstyle (Newstyle checker)
.sp
نام دقیق بازبین \fBnewstyle\fP است\&.
.SS پیام‌های بازبین Newstyle (Newstyle checker Messages)
.INDENT 0.0
.TP
.B bad\-super\-call (E1003)
\fIآرگومان نخست نادرست %r به super() داده شده است\fP
زمانی استفاده می‌شود که آرگومانی غیر از کلاس فعلی به‌عنوان نخستین آرگومان به تابع توکار super داده شود.
.UNINDENT
.SS بازبین Nonascii-Checker (Nonascii-Checker checker)
.sp
نام دقیق بازبین \fBnonascii\-checker\fP است\&.
.SS پیام‌های بازبین Nonascii-Checker (Nonascii-Checker checker Messages)
.INDENT 0.0
.TP
.B non\-ascii\-file\-name (W2402)
\fIنام %s با عنوان \(dq%s\(dq شامل یک نویسه غیر ASCII است.\fP
در Python 3.5، استاندارد PEP 3131 شناسه‌های غیر ASCII را مجاز می‌داند، اما نام فایل‌های غیر ASCII را نه. از Python 3.5 به بعد، با وجود اینکه Python از فایل‌های UTF\-8 پشتیبانی می‌کند، برخی از ویرایشگرها یا ابزارها این‌گونه نیستند.
.TP
.B non\-ascii\-name (C2401)
\fIنام %s با عنوان \(dq%s\(dq شامل یک نویسه غیر ASCII است، تغییر نام آن را در نظر بگیرید.\fP
زمانی استفاده می‌شود که نام دست‌کم دارای یک نویسه یونیکد غیر ASCII باشد. برای پیش‌زمینه‌ای دربارهٔ اینکه چرا این موضوع می‌تواند نامطلوب باشد،
\%<https://\:peps\:.python\:.org/\:pep-0672/#\:confusing-features> را ببینید. اگر شیوه‌نامه برنامه‌نویسی شما مشخص کرده است که به زبان انگلیسی کدنویسی می‌کنید، نباید نیازی به نویسه‌های غیر ASCII در نام‌های Python باشد. در غیر این صورت می‌توانید به‌سادگی این بررسی را غیرفعال کنید.
.TP
.B non\-ascii\-module\-import (C2403)
\fIنام %s با عنوان \(dq%s\(dq شامل یک نویسه غیر ASCII است، برای وارد کردن از یک نام مستعار صرفاً ASCII استفاده کنید.\fP
زمانی استفاده می‌شود که نام دست‌کم دارای یک نویسه یونیکد غیر ASCII باشد. برای پیش‌زمینه‌ای درباره اینکه چرا این موضوع می‌تواند نامطلوب باشد،
\%<https://\:peps\:.python\:.org/\:pep-0672/#\:confusing-features> را ببینید. اگر شیوه‌نامه برنامه‌نویسی شما مشخص کرده است که به زبان انگلیسی کدنویسی می‌کنید، نباید نیازی به نویسه‌های غیر ASCII در نام‌های Python باشد. در غیر این صورت می‌توانید به‌سادگی این بررسی را غیرفعال کنید.
.UNINDENT
.SS بازبین Refactoring (Refactoring checker)
.sp
نام دقیق بازبین \fBrefactoring\fP است\&.
.sp
همچنین مستندات گزینه‌های بازبین refactoring را در \%<#\:refactoring-options> ببینید
.SS پیام‌های بازبین Refactoring (Refactoring checker Messages)
.INDENT 0.0
.TP
.B consider\-merging\-isinstance (R1701)
\fIادغام این فراخوانی‌های isinstance به isinstance(%s, (%s)) را در نظر بگیرید\fP
زمانی استفاده می‌شود که چندین فراخوانی پیاپی isinstance را بتوان در یکی ادغام کرد.
.TP
.B too\-many\-nested\-blocks (R1702)
\fIبلوک‌های تو‌درتوی بیش از حد مجاز (%s/%s)\fP
زمانی استفاده می‌شود که یک تابع یا متد دارای بلوک‌های تو‌درتوی بسیار زیادی باشد. این امر درک و نگهداری کد را دشوارتر می‌کند.
.TP
.B simplifiable\-if\-statement (R1703)
\fIدستور if می‌تواند با %s جایگزین شود\fP
زمانی استفاده می‌شود که یک دستور if را بتوان با \(aqbool(test)\(aq جایگزین کرد.
.TP
.B redefined\-argument\-from\-local (R1704)
\fIبازتعریف آرگومان با نام محلی %r\fP
زمانی استفاده می‌شود که یک نام محلی در حال بازتعریف یک آرگومان باشد، که می‌تواند نشان‌دهنده یک خطای احتمالی باشد. این موضوع تنها برای تعداد اندکی از عملیات انتساب نام در نظر گرفته می‌شود، مانند تکرار حلقه for، انتساب در دستور with و انتساب در مدیریت‌کننده استثنا (exception handler).
.TP
.B no\-else\-return (R1705)
\fIعبارت غیرضروری \(dq%s\(dq پس از \(dqreturn\(dq، %s\fP
به‌منظور مشخص کردن یک بلوک کد غیرضروری پس از یک if یا یک try/except حاوی دستور return استفاده می‌شود. بدین ترتیب، هنگامی که پس از زنجیره‌ای از ifها که همگی حاوی دستور return هستند به یک else برخورد کند، هشدار خواهد داد.
.TP
.B consider\-using\-ternary (R1706)
\fIاستفاده از عبارت شرطی سه‌گانه (%s) را در نظر بگیرید\fP
زمانی استفاده می‌شود که یکی از ساختارهای نحوی سه‌گانه شناخته‌شده پیش از Python 2.5 استفاده شده باشد.
.TP
.B trailing\-comma\-tuple (R1707)
\fIغیرمجاز بودن چندتایی (tuple) با کامای پایانی\fP
در Python، یک tuple در واقع با نماد کاما ایجاد می‌شود، نه با پرانتزها. متأسفانه ممکن است با قرار دادن نابجای یک کامای پایانی ناخواسته یک tuple ایجاد شود که می‌تواند منجر به بروز باگ‌های عجیب بالقوه در کد شما گردد. همواره باید صریحاً از پرانتزها برای ایجاد tuple استفاده کنید.
.TP
.B stop\-iteration\-return (R1708)
\fIاستثنای StopIteration را در مولد ایجاد نکنید، به‌جای آن از دستور return استفاده کنید\fP
طبق PEP 479، ایجاد استثنای StopIteration با دستور raise برای پایان دادن به حلقه یک مولد (generator) ممکن است به باگ‌هایی منجر شود که یافتن آن‌ها دشوار است. این PEP مشخص می‌کند که raise StopIteration باید با یک دستور return ساده جایگزین گردد
.TP
.B simplify\-boolean\-expression (R1709)
\fIعبارت بولی می‌تواند به %s ساده شود\fP
زمانی صادر می‌شود که ساختار نحوی سه‌گانه زائد مربوط به نسخه‌های پیش از Python 2.5 به کار رفته باشد.
.TP
.B inconsistent\-return\-statements (R1710)
\fIیا تمام دستورهای return در یک تابع باید یک عبارت را برگردانند، یا هیچ‌کدام نباید برگردانند.\fP
طبق PEP 8، اگر هر دستور return عبارتی را بازگرداند، تمام دستورهای return دیگری که مقداری برنمی‌گردانند باید صریحاً این موضوع را به‌صورت return None قید کنند، و یک دستور صریح return باید در انتهای تابع (در صورت دردسترس بودن مسیر اجرا) وجود داشته باشد
.TP
.B useless\-return (R1711)
\fIدستور return بی‌فایده در انتهای تابع یا متد\fP
زمانی صادر می‌شود که یک دستور تکی \(dqreturn\(dq یا \(dqreturn None\(dq در پایان تعریف تابع یا متد یافت شود. این دستور را می‌توان با خیال راحت حذف کرد چرا که Python به‌طور ضمنی مقدار None را برمی‌گرداند
.TP
.B consider\-swap\-variables (R1712)
\fIاستفاده از باز کردن چندتایی (tuple unpacking) را برای جابه‌جایی متغیرها در نظر بگیرید\fP
برای جابه‌جا کردن متغیرها نیازی به استفاده از یک متغیر کمکی موقت ندارید. استفاده از \(dqtuple unpacking\(dq برای جابه‌جایی مستقیم متغیرها مقصود کد را واضح‌تر می‌سازد.
.TP
.B consider\-using\-join (R1713)
\fIاستفاده از str.join(sequence) را برای الحاق رشته‌ها از یک شیء تکرارپذیر در نظر بگیرید\fP
استفاده از str.join(sequence) در مقایسه با تکرار با حلقه for سریع‌تر است، حافظه کمتری مصرف می‌کند و خوانایی را افزایش می‌دهد.
.TP
.B consider\-using\-in (R1714)
\fIادغام این مقایسه‌ها با \(aqin\(aq را با استفاده از \(aq%s %sin (%s)\(aq در نظر بگیرید. در صورتی که عناصر هش‌پذیر هستند، در عوض از یک مجموعه (set) استفاده کنید.\fP
برای بررسی اینکه آیا یک متغیر با یکی از چندین مقدار برابر است یا خیر، مقادیر را در یک set یا tuple ترکیب کرده و به‌جای بررسی برابری با تک‌تک مقادیر، بررسی کنید که آیا متغیر درون آن قرار دارد (\(dqin\(dq) یا خیر. این کار سریع‌تر است و کدنویسی کمتری دارد.
.TP
.B consider\-using\-get (R1715)
\fIاستفاده از dict.get را برای گرفتن مقادیر از یک فرهنگ‌لغت (dict) در صورت وجود کلید یا مقدار پیش‌فرض در صورت نبود آن در نظر بگیرید\fP
استفاده از تابع توکار dict.get برای دریافت یک مقدار از دیکشنری در صورت وجود کلید یا یک مقدار پیش‌فرض در صورت عدم وجود، ساده‌تر است و روشی اصطلاحی‌تر (idiomatic) به شمار می‌رود، اگرچه گاهی اندکی کندتر است
.TP
.B chained\-comparison (R1716)
\fIساده‌سازی مقایسه زنجیره‌ای میان عملوندها\fP
این پیام زمانی صادر می‌شود که pylint با یک عملیات بولی مانند \(dqa < b and b < c\(dq مواجه شود و پیشنهاد بازنویسی آن را به‌صورت \(dqa < b < c\(dq ارائه دهد
.TP
.B consider\-using\-dict\-comprehension (R1717)
\fIاستفاده از ساخت دیکشنری با درک مطلب (dict comprehension) را در نظر بگیرید\fP
زمانی صادر می‌شود که ایجاد یک دیکشنری با استفاده از فراخوانی dict() و یک لیست موقت تشخیص داده شود. اگرچه از نظر نحوی مشکلی در این کد وجود ندارد، اما خواندن آن دشوار است و می‌تواند به یک dict comprehension ساده شود. همچنین سریع‌تر است زیرا نیازی به ایجاد یک لیست موقت دیگر ندارید
.TP
.B consider\-using\-set\-comprehension (R1718)
\fIاستفاده از ساخت مجموعه با درک مطلب (set comprehension) را در نظر بگیرید\fP
اگرچه از نظر نحوی مشکلی در این کد وجود ندارد، اما خواندن آن دشوار است و می‌تواند به یک set comprehension ساده شود. همچنین سریع‌تر است چرا که نیازی به ایجاد یک لیست موقت دیگر ندارید
.TP
.B simplifiable\-if\-expression (R1719)
\fIعبارت if می‌تواند با %s جایگزین شود\fP
زمانی استفاده می‌شود که یک عبارت if بتواند با \(aqbool(test)\(aq یا در صورت ضمنی بودن تبدیل نوع بولی صرفاً با \(aqtest\(aq جایگزین شود.
.TP
.B no\-else\-raise (R1720)
\fIعبارت غیرضروری \(dq%s\(dq پس از \(dqraise\(dq، %s\fP
به‌منظور مشخص کردن یک بلوک کد غیرضروری پس از یک if یا try/except حاوی دستور raise استفاده می‌شود. بدین ترتیب، هنگامی که پس از زنجیره‌ای از ifها که همگی حاوی دستور raise هستند به یک else برخورد کند، هشدار خواهد داد.
.TP
.B unnecessary\-comprehension (R1721)
\fIاستفاده غیرضروری از درک مطلب (comprehension)، به‌جای آن از %s استفاده کنید.\fP
به‌جای استفاده از یک comprehension همانی، استفاده از سازنده list، dict یا set را در نظر بگیرید. این کار سریع‌تر و ساده‌تر است.
.TP
.B consider\-using\-sys\-exit (R1722)
\fIاستفاده از \(aqsys.exit\(aq را به‌جای آن در نظر بگیرید\fP
برخلاف \(aqexit()\(aq یا \(aqquit()\(aq، فراخوانی \(aqsys.exit\(aq متکی به در دسترس بودن ماژول site نیست (زیرا ماژول \(aqsys\(aq همواره در دسترس است)..TP
.B no\-else\-break (R1723)
\fI\(dq%s\(dq غیرضروری پس از \(dqbreak\(dq، %s\fP
برای مشخص کردن یک بلوک کد غیرضروری پس از یک if حاوی دستور break به کار می‌رود. به این ترتیب، هنگامی که پس از زنجیره‌ای از دستورهای if که همگی دارای دستور break هستند با یک else مواجه شود، هشدار خواهد داد.
.TP
.B no\-else\-continue (R1724)
\fI\(dq%s\(dq غیرضروری پس از \(dqcontinue\(dq، %s\fP
برای مشخص کردن یک بلوک کد غیرضروری پس از یک if حاوی دستور continue به کار می‌رود. به این ترتیب، هنگامی که پس از زنجیره‌ای از دستورهای if که همگی دارای دستور continue هستند با یک else مواجه شود، هشدار خواهد داد.
.TP
.B super\-with\-arguments (R1725)
\fIاستفاده از ()super به سبک Python 3 بدون آرگومان را در نظر بگیرید\fP
هنگام فراخوانی تابع درونی ()super با کلاس و نمونهٔ فعلی صادر می‌شود.
در Python 3 این آرگومان‌ها پیش‌فرض هستند و می‌توان آن‌ها را حذف کرد.
.TP
.B simplifiable\-condition (R1726)
\fIشرط بولی \(dq%s\(dq ممکن است به \(dq%s\(dq ساده شود\fP
هنگامی صادر می‌شود که یک شرط بولی امکان ساده‌سازی داشته باشد.
.TP
.B condition\-evals\-to\-constant (R1727)
\fIشرط بولی \(aq%s\(aq همواره به \(aq%s\(aq ارزیابی می‌شود\fP
هنگامی صادر می‌شود که یک شرط بولی بتواند به یک مقدار ثابت ساده‌سازی شود.
.TP
.B consider\-using\-generator (R1728)
\fIاستفاده از یک generator را به جای \(aq%s(%s)\(aq در نظر بگیرید\fP
اگر ظرف (container) شما می‌تواند بزرگ باشد، استفاده از یک generator کارایی بهتری به همراه خواهد داشت.
.TP
.B use\-a\-generator (R1729)
\fIبه جای \(aq%s(%s)\(aq از یک generator استفاده کنید\fP
استفاده از comprehension درون \(aqany\(aq، \(aqall\(aq، \(aqmax\(aq، \(aqmin\(aq یا \(aqsum\(aq غیرضروری است. یک
generator کافی و سریع‌تر خواهد بود.
.TP
.B consider\-using\-min\-builtin (R1730)
\fIاستفاده از \(aq%s\(aq را به جای بلوک غیرضروری if در نظر بگیرید\fP
استفاده از تابع درونی min به جای یک عبارت شرطی، خوانایی و ایجاز کد را بهبود می‌بخشد.
.TP
.B consider\-using\-max\-builtin (R1731)
\fIاستفاده از \(aq%s\(aq را به جای بلوک غیرضروری if در نظر بگیرید\fP
استفاده از تابع درونی max به جای یک عبارت شرطی، خوانایی و ایجاز کد را بهبود می‌بخشد.
.TP
.B consider\-using\-with (R1732)
\fIاستفاده از \(aqwith\(aq را برای عملیات تخصیص منابع در نظر بگیرید\fP
هنگامی صادر می‌شود که یک انتساب یا فراخوانی تخصیص‌دهندهٔ منابع بتواند با یک
بلوک \(aqwith\(aq جایگزین شود. با استفاده از \(aqwith\(aq آزادسازی منابع تخصیص‌یافته
حتی در صورت بروز یک استثنا (exception) تضمین می‌شود.
.TP
.B unnecessary\-dict\-index\-lookup (R1733)
\fIجستجوی اندیس دیکشنری غیرضروری است، در عوض از \(aq%s\(aq استفاده کنید\fP
هنگام پیمایش روی آیتم‌های دیکشنری (جفت‌های کلید\-مقدار) و دسترسی به مقدار از طریق
جستجوی اندیس صادر می‌شود. می‌توان در عوض مستقیماً به مقدار دسترسی داشت.
.TP
.B use\-list\-literal (R1734)
\fIاستفاده از [] را به جای ()list در نظر بگیرید\fP
هنگام استفاده از ()list برای ایجاد یک لیست خالی به جای لیترال [] صادر می‌شود.
لیترال سریع‌تر است زیرا از یک فراخوانی تابع اضافی جلوگیری می‌کند.
.TP
.B use\-dict\-literal (R1735)
\fIاستفاده از \(aq%s\(aq را به جای فراخوانی \(aqdict\(aq در نظر بگیرید.\fP
هنگام استفاده از ()dict برای ایجاد یک دیکشنری به جای لیترال \(aq{ ...
}\(aq صادر می‌شود. لیترال سریع‌تر است زیرا از یک فراخوانی تابع اضافی جلوگیری می‌کند.
.TP
.B unnecessary\-list\-index\-lookup (R1736)
\fIجستجوی اندیس لیست غیرضروری است، در عوض از \(aq%s\(aq استفاده کنید\fP
هنگام پیمایش روی یک شمارش (enumeration) و دسترسی به مقدار از طریق جستجوی
اندیس صادر می‌شود. می‌توان در عوض مستقیماً به مقدار دسترسی داشت.
.TP
.B use\-yield\-from (R1737)
\fIبه جای بازگرداندن تک‌تک عناصر با yield، مستقیماً از \(aqyield from\(aq استفاده کنید\fP
بازگرداندن مستقیم مقادیر از تکرارکننده (iterator) با yield نسبت به yield کردن تک‌تک عناصر در حلقه،
سریع‌تر است و بدون شک کد تمیزتری ایجاد می‌کند.
.TP
.B unnecessary\-negation (C0117)
\fIتغییر دادن \(dq%s\(dq به \(dq%s\(dq را در نظر بگیرید\fP
زمانی به کار می‌رود که یک عبارت بولی حاوی نقیض غیرضروری باشد؛ برای مثال زمانی که دو
عملگر نقیض یکدیگر را خنثی می‌کنند.
.TP
.B consider\-using\-enumerate (C0200)
\fIاستفاده از enumerate را به جای پیمایش با range و len در نظر بگیرید\fP
هنگام مواجهه با کدی که با range و len پیمایش می‌کند صادر می‌شود. چنین کدی
می‌تواند با استفاده از تابع درونی enumerate ساده‌سازی شود.
.TP
.B consider\-iterating\-dictionary (C0201)
\fIپیمایش مستقیم دیکشنری را به جای فراخوانی ()keys.\& در نظر بگیرید\fP
هنگامی صادر می‌شود که کلیدهای یک دیکشنری از طریق متد \fB\&.keys()\fP پیمایش شوند
یا زمانی که \fB\&.keys()\fP برای بررسی عضویت به کار رود. پیمایش خود دیکشنری
کافی است: \fBfor key in dictionary\fP\&. برای
بررسی‌های عضویت، عبارت \fBif key in dictionary\fP سریع‌تر است.
.TP
.B consider\-using\-dict\-items (C0206)
\fIپیمایش با ()items.\& را در نظر بگیرید\fP
هنگام پیمایش روی کلیدهای یک دیکشنری و دسترسی به مقدار از طریق جستجوی اندیس صادر
می‌شود. با پیمایش با استفاده از متد ()items. دیکشنری، می‌توان هم به کلید و هم به مقدار دسترسی داشت.
.TP
.B use\-maxsplit\-arg (C0207)
\fIدر عوض از %s استفاده کنید\fP
هنگام دسترسی تنها به عنصر اول یا آخر ()str.split صادر می‌شود.
عنصر اول و آخر را می‌توان در عوض با استفاده از [0](str.split(sep, maxsplit=1
یا [1\-]str.rsplit(sep, maxsplit=1) به دست آورد.
.TP
.B use\-sequence\-for\-iteration (C0208)
\fIهنگام پیمایش روی مقادیر از یک نوع دنباله استفاده کنید\fP
هنگام پیمایش روی مقادیر، نوع‌های دنباله (مانند \fBlists\fP، \fBtuples\fP و
\fBranges\fP) کارآمدتر از \fBsets\fP هستند\&.
.TP
.B consider\-using\-f\-string (C0209)
\fIقالب‌بندی یک رشتهٔ عادی که می‌تواند یک f\-string باشد\fP
زمانی به کار می‌رود که رشته‌ای تشخیص داده شود که با ()format یا % قالب‌بندی می‌شود در
حالی که می‌تواند یک f\-string باشد. استفاده از f\-string ترجیح داده می‌شود. نیازمند
Python 3.6 و \fBpy\-version >= 3.6\fP است\&.
.TP
.B use\-implicit\-booleaness\-not\-len (C1802)
\fIبرای تعیین خالی بودن دنباله، از \(galen(SEQUENCE)\(ga بدون مقایسه استفاده نکنید\fP
دنباله‌های خالی در یک بافتار بولی نادرست (false) تلقی می‌شوند. می‌توانید یا
فراخوانی \(aqlen\(aq را حذف کنید (\fBif not x\fP) یا طول را در برابر یک
مقدار اسکالر بسنجید (\fBif len(x) > 1\fP).
.TP
.B use\-implicit\-booleaness\-not\-comparison (C1803)
\fIاگر صرفاً یک دنباله باشد، \(dq%s\(dq می‌تواند به \(dq%s\(dq ساده شود، چرا که یک %s خالی falsey است\fP
دنباله‌های خالی در یک بافتار بولی نادرست (false) تلقی می‌شوند. پیروی کورکورانه از این
بررسی در پایگاه‌های کدی با نوع‌بندی ضعیف (weakly typed) می‌تواند مشکلاتی ایجاد کند که اشکال‌زدایی آن‌ها دشوار است. اگر
مقدار بتواند چیز دیگری باشد که falsey است اما دنباله نیست (برای
مثال \fBNone\fP، یک رشتهٔ خالی، یا \fB0\fP)، کد معادل نخواهد بود.
.TP
.B use\-implicit\-booleaness\-not\-comparison\-to\-string (C1804)
\fIاگر صرفاً یک رشته باشد، \(dq%s\(dq می‌تواند به \(dq%s\(dq ساده شود، چرا که یک رشتهٔ خالی falsey است\fP
رشته‌های خالی در یک بافتار بولی نادرست (false) تلقی می‌شوند. پیروی کورکورانه از این بررسی
در پایگاه‌های کدی با نوع‌بندی ضعیف می‌تواند مشکلاتی ایجاد کند که اشکال‌زدایی آن‌ها دشوار است. اگر
مقدار بتواند چیز دیگری باشد که falsey است اما رشته نیست (برای مثال
\fBNone\fP، یک دنبالهٔ خالی، یا \fB0\fP)، کد معادل نخواهد بود.
.TP
.B use\-implicit\-booleaness\-not\-comparison\-to\-zero (C1805)
\fIاگر صرفاً یک int باشد، \(dq%s\(dq می‌تواند به \(dq%s\(dq ساده شود، چرا که 0 falsey است\fP
مقدار 0 در یک بافتار بولی نادرست (false) تلقی می‌شود. پیروی کورکورانه از این بررسی در
پایگاه‌های کدی با نوع‌بندی ضعیف می‌تواند مشکلاتی ایجاد کند که اشکال‌زدایی آن‌ها دشوار است. اگر مقدار بتواند
چیز دیگری باشد که falsey است اما int نیست (برای مثال \fBNone\fP، یک رشتهٔ
خالی، یا یک دنبالهٔ خالی)، کد معادل نخواهد بود.
.UNINDENT.SS بازرس شباهت‌ها (Similarities checker)
.sp
نام دقیق این بازرس \fBsimilarities\fP است\&.
.sp
همچنین مستندات گزینه‌های بازرس شباهت‌ها را ببینید \%<#\:similarities-options>
.SS پیام‌های بازرس شباهت‌ها (Similarities checker Messages)
.INDENT 0.0
.TP
.B duplicate\-code (R0801)
\fIخطوط مشابه در %s فایل\fP
نشان می‌دهد که مجموعه‌ای از خطوط مشابه میان چندین فایل شناسایی شده است.
این مورد معمولاً بدین معناست که برای جلوگیری از این تکرار، کد باید بازنویسی و بازآرایی (refactor) شود.
.UNINDENT
.SS گزارش‌های بازرس شباهت‌ها (Similarities checker Reports)
.INDENT 0.0
.TP
.B RP0801
هم‌پوشانی و تکرار (Duplication)
.UNINDENT
.SS بازرس املا (Spelling checker)
.sp
نام دقیق این بازرس \fBspelling\fP است\&.
.sp
همچنین مستندات گزینه‌های بازرس املا را ببینید \%<#\:spelling-options>
.SS پیام‌های بازرس املا (Spelling checker Messages)
.INDENT 0.0
.TP
.B wrong\-spelling\-in\-comment (C0401)
\fIاملای نادرست کلمه \(aq%s\(aq در یک کامنت:\fP
زمانی استفاده می‌شود که کلمه‌ای در کامنت به درستی نوشته نشده باشد.
.TP
.B wrong\-spelling\-in\-docstring (C0402)
\fIاملای نادرست کلمه \(aq%s\(aq در یک docstring:\fP
زمانی استفاده می‌شود که کلمه‌ای در docstring به درستی نوشته نشده باشد.
.TP
.B invalid\-characters\-in\-docstring (C0403)
\fIنویسه‌های نامعتبر %r در یک docstring\fP
زمانی استفاده می‌شود که یک کلمه در docstring نتواند توسط enchant بررسی شود.
.UNINDENT
.SS بازرس کتابخانه استاندارد (Stdlib checker)
.sp
نام دقیق این بازرس \fBstdlib\fP است\&.
.SS پیام‌های بازرس کتابخانه استاندارد (Stdlib checker Messages)
.INDENT 0.0
.TP
.B invalid\-envvar\-value (E1507)
\fI%s از آرگومانی با نوع %s پشتیبانی نمی‌کند\fP
توابع دستکاری متغیرهای محیطی تنها از آرگومان‌های با نوع رشته (str) پشتیبانی می‌کنند. ببینید
\%<https://\:docs\:.python\:.org/\:3/\:library/\:os\:.html#\:os\:.getenv>\&.
.TP
.B singledispatch\-method (E1519)
\fIدکوراتور singledispatch نباید برای متدها استفاده شود، به جای آن از singledispatchmethod استفاده کنید.\fP
دکوراتور singledispatch باید توابع را تزیین کند نه متدهای کلاس یا نمونه را. برای این موارد از
singledispatchmethod استفاده کنید.
.TP
.B singledispatchmethod\-function (E1520)
\fIدکوراتور singledispatchmethod نباید برای توابع استفاده شود، به جای آن از singledispatch استفاده کنید.\fP
دکوراتور singledispatchmethod باید متدهای کلاس یا نمونه را تزیین کند نه توابع را.
برای این موارد از singledispatch استفاده کنید.
.TP
.B bad\-open\-mode (W1501)
\fI\(dq%s\(dq حالت معتبری برای open نیست.\fP
پایتون از حالت‌های r، w، a[, x] به همراه گزینه‌های b، + و U (تنها با r) پشتیبانی می‌کند.
ببینید \%<https://\:docs\:.python\:.org/\:3/\:library/\:functions\:.html#\:open>
.TP
.B boolean\-datetime (W1502)
\fIاستفاده از datetime.time در بافتار بولی (boolean).\fP
استفاده از datetime.time در یک بافتار بولی می‌تواند زمانی که ساعت مشخص‌شده با نیمه‌شب UTC منطبق باشد،
باگ‌های پنهانی ایجاد کند. این رفتار در Python 3.5 برطرف شد. برای اطلاعات بیشتر ببینید
\%<https://\:bugs\:.python\:.org/\:issue13936>. هنگام استفاده از Python >= 3.5 این پیام
صادر نمی‌شود.
.TP
.B redundant\-unittest\-assert (W1503)
\fIاستفاده زائد از %s با مقدار ثابت %r\fP
آرگومان نخست assertTrue و assertFalse یک شرط است. اگر یک مقدار ثابت به عنوان پارامتر
ارسال شود، آن شرط همواره صادق خواهد بود. در این حالت باید یک هشدار صادر شود.
.TP
.B bad\-thread\-instantiation (W1506)
\fIکلاس threading.Thread به تابع target نیاز دارد\fP
این هشدار زمانی صادر می‌شود که یک نمونه از کلاس threading.Thread بدون ارسال تابع هدف به عنوان
یک kwarg یا به عنوان آرگومان دوم ایجاد شود. به‌طور پیش‌فرض، نخستین پارامتر، پارامتر group است نه
پارامتر target.
.TP
.B shallow\-copy\-environ (W1507)
\fIاستفاده از copy.copy(os.environ). به جای آن از os.environ.copy() استفاده کنید.\fP
شیء os.environ یک شیء dict نیست بلکه یک شیء پروکسی (proxy) است؛ بنابراین کپی سطحی (shallow copy)
همچنان بر شیء اصلی اثر می‌گذارد. برای ارجاع ببینید \%<https://\:bugs\:.python\:.org/\:issue15373>.
.TP
.B invalid\-envvar\-default (W1508)
\fIنوع پیش‌فرض %s برابر با %s است. انتظار می‌رفت str یا None باشد.\fP
توابع دستکاری متغیرهای محیطی مقادیر None یا str بازمی‌گردانند. ارسال هر نوع متفاوتی
به عنوان مقدار پیش‌فرض می‌تواند باعث ایجاد باگ شود. ببینید
\%<https://\:docs\:.python\:.org/\:3/\:library/\:os\:.html#\:os\:.getenv>\&.
.TP
.B subprocess\-popen\-preexec\-fn (W1509)
\fIاستفاده از کلمه کلیدی preexec_fn که ممکن است در حضور ریسه‌ها (threads) ناامن باشد\fP
استفاده از پارامتر preexec_fn در صورت حضور ریسه‌ها (threads) در برنامه شما ایمن نیست.
فرآیند فرزند ممکن است پیش از فراخوانی exec دچار بن‌بست (deadlock) شود. اگر ناچار به استفاده
از آن هستید، آن را بسیار ساده و سبک نگه دارید! تعداد کتابخانه‌هایی را که فراخوانی می‌کنید به حداقل برسانید.
ببینید \%<https://\:docs\:.python\:.org/\:3/\:library/\:subprocess\:.html#\:popen-constructor>
.TP
.B subprocess\-run\-check (W1510)
\fIاستفاده از \(aqsubprocess.run\(aq بدون تعیین صریح مقدار برای \(aqcheck\(aq.\fP
کلمه کلیدی \fBcheck\fP به‌طور پیش‌فرض روی False تنظیم شده است. این بدان معناست که فرآیند
اجراشده توسط \fBsubprocess.run\fP می‌تواند با یک کد خروج غیر صفر پایان یابد و در سکوت
شکست بخورد. بهتر است آن را به‌طور صریح تنظیم کنید تا رفتار مدیریت خطا کاملاً مشخص باشد.
.TP
.B unspecified\-encoding (W1514)
\fIاستفاده از open بدون تعیین صریح یک کدگذاری (encoding)\fP
بهتر است هنگام باز کردن اسناد، یک کدگذاری (encoding) را مشخص کنید. استفاده ضمنی از مقدار
پیش‌فرض سیستم می‌تواند در سایر سیستم‌های عامل مشکلاتی ایجاد کند. ببینید
\%<https://\:peps\:.python\:.org/\:pep-0597> این پیام هنگام استفاده از Python >= 3.15 صادر نمی‌شود.
.TP
.B forgotten\-debug\-statement (W1515)
\fIباقی گذاشتن توابع ایجادکننده نقاط توقف (breakpoints) در کد محیط عملیاتی (production) توصیه نمی‌شود\fP
فراخوانی‌های breakpoint()، sys.breakpointhook() و pdb.set_trace() باید از کدی که فعالانه در
حال اشکال‌زدایی نیست حذف شوند.
.TP
.B method\-cache\-max\-size\-none (W1518)
\fIدستور \(aqlru_cache(maxsize=None)\(aq یا \(aqcache\(aq تمام آرگومان‌های متد از جمله \(aqself\(aq را تا ابد زنده نگه می‌دارد\fP
با تزیین یک متد توسط lru_cache یا cache، آرگومان \(aqself\(aq به تابع پیوند می‌خورد و
بنابراین هرگز توسط زباله‌روب (garbage collector) جمع‌آوری نمی‌شود. مگر اینکه نمونه شما هرگز نیازی
به جمع‌آوری زباله نداشته باشد (تک‌نمونه یا singleton)، توصیه می‌شود برای جلوگیری از این الگو
کد را بازآرایی کرده یا یک maxsize به حافظه موقت (cache) اضافه کنید. مقدار پیش‌فرض برای maxsize برابر با ۱۲۸ است.
.TP
.B deprecated\-method (W4902)
\fIاستفاده از متد منسوخ‌شده %s()\fP
این متد به عنوان منسوخ‌شده (deprecated) نشانه‌گذاری شده است و در آینده حذف خواهد شد.
.TP
.B deprecated\-argument (W4903)
\fIاستفاده از آرگومان منسوخ‌شده %s در متد %s()\fP
این آرگومان به عنوان منسوخ‌شده (deprecated) نشانه‌گذاری شده است و در آینده حذف خواهد شد.
.TP
.B deprecated\-class (W4904)
\fIاستفاده از کلاس منسوخ‌شده %s از ماژول %s\fP
این کلاس به عنوان منسوخ‌شده (deprecated) نشانه‌گذاری شده است و در آینده حذف خواهد شد.
.TP
.B deprecated\-decorator (W4905)
\fIاستفاده از دکوراتور منسوخ‌شده %s()\fP
این دکوراتور به عنوان منسوخ‌شده (deprecated) نشانه‌گذاری شده است و در آینده حذف خواهد شد.
.TP
.B deprecated\-attribute (W4906)
\fIاستفاده از ویژگی (attribute) منسوخ‌شده %r\fP
این ویژگی به عنوان منسوخ‌شده (deprecated) نشانه‌گذاری شده است و در آینده حذف خواهد شد.
.UNINDENT.SS بازبین رشته (String checker)
.sp
نام دقیق این بازبین \fBstring\fP\& است.
.sp
همچنین مستندات گزینه‌های بازبین رشته را ببینید: \%<#\:string-options>
.SS پیام‌های بازبین رشته (String checker Messages)
.INDENT 0.0
.TP
.B bad\-format\-character (E1300)
\fIنویسه قالب‌بندی پشتیبانی‌نشده %r (%#02x) در اندیس %d\fP
زمانی استفاده می‌شود که یک نویسه قالب‌بندی پشتیبانی‌نشده در یک رشته قالب‌بندی به کار رفته باشد.
.TP
.B truncated\-format\-string (E1301)
\fIرشته قالب‌بندی در میانه مشخص‌کننده تبدیل پایان می‌یابد\fP
زمانی استفاده می‌شود که یک رشته قالب‌بندی پیش از پایان یک مشخص‌کننده
تبدیل خاتمه یابد.
.TP
.B mixed\-format\-string (E1302)
\fIترکیب مشخص‌کننده‌های تبدیل نام‌دار و بی‌نام در رشته قالب‌بندی\fP
زمانی استفاده می‌شود که یک رشته قالب‌بندی شامل هر دو نوع مشخص‌کننده تبدیل نام‌دار (مانند \(aq%(foo)d\(aq) و بی‌نام
(مانند \(aq%d\(aq) باشد. این پیام همچنین زمانی استفاده می‌شود که یک مشخص‌کننده تبدیل نام‌دار
حاوی * برای حداقل عرض فیلد و/یا دقت باشد.
.TP
.B format\-needs\-mapping (E1303)
\fIبرای رشته قالب‌بندی نگاشت انتظار می‌رفت، نه %s\fP
زمانی استفاده می‌شود که یک رشته قالب‌بندی که از مشخص‌کننده‌های تبدیل نام‌دار استفاده می‌کند با
آرگومانی به کار رود که یک نگاشت نیست.
.TP
.B missing\-format\-string\-key (E1304)
\fIکلید %r در دیکشنری رشته قالب‌بندی وجود ندارد\fP
زمانی استفاده می‌شود که یک رشته قالب‌بندی که از مشخص‌کننده‌های تبدیل نام‌دار استفاده می‌کند با
دیکشنری‌ای به کار رود که شامل تمام کلیدهای مورد نیاز رشته قالب‌بندی نیست.
.TP
.B too\-many\-format\-args (E1305)
\fIآرگومان‌های بیش از حد برای رشته قالب‌بندی\fP
زمانی استفاده می‌شود که به یک رشته قالب‌بندی که از مشخص‌کننده‌های تبدیل بی‌نام استفاده می‌کند،
بیش از حد آرگومان داده شود.
.TP
.B too\-few\-format\-args (E1306)
\fIآرگومان‌های ناکافی برای رشته قالب‌بندی\fP
زمانی استفاده می‌شود که به یک رشته قالب‌بندی که از مشخص‌کننده‌های تبدیل بی‌نام استفاده می‌کند،
آرگومان‌های بسیار کمی داده شود.
.TP
.B bad\-string\-format\-type (E1307)
\fIآرگومان %r با نوع قالب %r همخوانی ندارد\fP
زمانی استفاده می‌شود که نوع مورد نیاز رشته قالب‌بندی برای نوع واقعی آرگومان
مناسب نباشد.
.TP
.B bad\-str\-strip\-call (E1310)
\fIآرگومان مشکوک در فراخوانی %s.%s\fP
آرگومان ارسال‌شده به فراخوانی str.{l,r,}strip حاوی یک نویسه تکراری است،
.TP
.B bad\-format\-string\-key (W1300)
\fIکلید دیکشنری رشته قالب‌بندی باید یک رشته باشد، نه %s\fP
زمانی استفاده می‌شود که یک رشته قالب‌بندی که از مشخص‌کننده‌های تبدیل نام‌دار استفاده می‌کند با
دیکشنری‌ای به کار رود که تمام کلیدهای آن رشته نیستند.
.TP
.B unused\-format\-string\-key (W1301)
\fIکلید استفاده‌نشده %r در دیکشنری رشته قالب‌بندی\fP
زمانی استفاده می‌شود که یک رشته قالب‌بندی که از مشخص‌کننده‌های تبدیل نام‌دار استفاده می‌کند با
دیکشنری‌ای به کار رود که شامل کلیدهایی است که مورد نیاز رشته قالب‌بندی نیستند.
.TP
.B bad\-format\-string (W1302)
\fIرشته قالب‌بندی نامعتبر\fP
زمانی استفاده می‌شود که یک رشته قالب‌بندی PEP 3101 نامعتبر باشد.
.TP
.B missing\-format\-argument\-key (W1303)
\fIآرگومان کلیدواژه‌ای %r برای رشته قالب‌بندی یافت نشد\fP
زمانی استفاده می‌شود که یک رشته قالب‌بندی PEP 3101 که از فیلدهای نام‌دار استفاده می‌کند، یک
یا چند کلیدواژه الزامی را دریافت نکند.
.TP
.B unused\-format\-string\-argument (W1304)
\fIآرگومان قالب‌بندی استفاده‌نشده %r\fP
زمانی استفاده می‌شود که یک رشته قالب‌بندی PEP 3101 که از فیلدهای نام‌دار استفاده می‌کند با
آرگومانی به کار رود که مورد نیاز رشته قالب‌بندی نیست.
.TP
.B format\-combined\-specification (W1305)
\fIرشته قالب‌بندی شامل هر دو نوع شماره‌گذاری خودکار فیلد و تعیین دستی فیلد است\fP
زمانی استفاده می‌شود که یک رشته قالب‌بندی PEP 3101 شامل هر دو نوع شماره‌گذاری خودکار فیلد
(مانند \(aq{}\(aq) و تعیین دستی فیلد (مانند \(aq{0}\(aq) باشد.
.TP
.B missing\-format\-attribute (W1306)
\fIصفت قالب‌بندی %r در مشخص‌کننده قالب %r وجود ندارد\fP
زمانی استفاده می‌شود که یک رشته قالب‌بندی PEP 3101 از مشخص‌کننده صفت ({0.length}) استفاده کند،
اما آرگومان ارسال‌شده برای قالب‌بندی فاقد آن صفت باشد.
.TP
.B invalid\-format\-index (W1307)
\fIاستفاده از کلید جستجوی نامعتبر %r در مشخص‌کننده قالب %r\fP
زمانی استفاده می‌شود که یک رشته قالب‌بندی PEP 3101 از مشخص‌کننده جستجو ({a[1]}) استفاده کند، اما
آرگومان ارسال‌شده برای قالب‌بندی فاقد آن کلید بوده یا آن را به عنوان یک صفت
نداشته باشد.
.TP
.B duplicate\-string\-formatting\-argument (W1308)
\fIآرگومان قالب‌بندی رشته تکراری %r، ارسال به عنوان آرگومان نام‌دار را مد نظر قرار دهید\fP
زمانی استفاده می‌شود که تشخیص دهیم قالب‌بندی رشته به جای استفاده از آرگومان‌های رشته‌ای نام‌دار،
در حال تکرار یک آرگومان است.
.TP
.B f\-string\-without\-interpolation (W1309)
\fIاستفاده از f\-string که هیچ متغیر درون‌یابی‌شده‌ای ندارد\fP
زمانی استفاده می‌شود که یک f\-string شناسایی شود که از هیچ متغیر
درون‌یابی استفاده نمی‌کند، که در این حالت می‌تواند یا یک رشته معمولی باشد یا یک باگ در
کد.
.TP
.B format\-string\-without\-interpolation (W1310)
\fIاستفاده از قالب‌بندی برای رشته‌ای که هیچ متغیر درون‌یابی‌شده‌ای ندارد\fP
زمانی استفاده می‌شود که رشته‌ای شناسایی شود که فاقد هرگونه متغیر درون‌یابی است،
که در این حالت می‌تواند یا یک رشته معمولی بدون قالب‌بندی باشد یا یک باگ در
کد.
.TP
.B anomalous\-backslash\-in\-string (W1401)
\fIبک‌اسلش غیرعادی در رشته: \(aq%s\(aq. ممکن است پیشوند r برای این ثابت رشته‌ای جا افتاده باشد.\fP
زمانی استفاده می‌شود که یک بک‌اسلش در یک رشته لفظی قرار دارد اما به عنوان نویسه گریز به کار نرفته است.
.TP
.B anomalous\-unicode\-escape\-in\-string (W1402)
\fIگریز یونیکد غیرعادی در رشته بایتی: \(aq%s\(aq. ممکن است پیشوند r یا u برای این ثابت رشته‌ای جا افتاده باشد.\fP
زمانی استفاده می‌شود که با گریزی مانند u در یک رشته بایتی مواجه شویم در حالی که در آنجا
هیچ تأثیری ندارد.
.TP
.B implicit\-str\-concat (W1404)
\fIالحاق ضمنی رشته در %s مشاهده شد\fP
رشته‌های لفظی در تعریف یک شیء تکرارپذیر لفظی به صورت ضمنی الحاق شده‌اند
: شاید یک کاما جا افتاده باشد؟
.TP
.B inconsistent\-quotes (W1405)
\fIجداکننده نقل‌قول %s با بقیه فایل ناسازگار است\fP
جداکننده‌های نقل‌قول در سرتاسر یک ماژول به صورت یکنواخت استفاده نشده‌اند (با
در نظر گرفتن استثناهایی جهت پرهیز از نویسه‌های گریز غیرضروری).
.TP
.B redundant\-u\-string\-prefix (W1406)
\fIپیشوند u برای رشته‌ها در Python >=3.0 دیگر ضروری نیست\fP
زمانی استفاده می‌شود که رشته‌ای با پیشوند u شناسایی شود. این پیشوندها
در Python 2 برای مشخص کردن این که یک رشته یونیکد است لازم بودند، اما از Python 3.0
رشته‌ها به صورت پیش‌فرض یونیکد هستند.
.UNINDENT.SS بررسی‌کننده Threading
.sp
نام دقیق این بررسی‌کننده \fBthreading\fP\& است.
.SS پیام‌های بررسی‌کننده Threading
.INDENT 0.0
.TP
.B useless\-with\-lock (W2101)
\fIایجاد مستقیم \(aq%s()\(aq در \(aqwith\(aq هیچ تأثیری ندارد\fP
هنگامی استفاده می‌شود که یک نمونه قفل جدید با استفاده از دستور with ایجاد شود که هیچ تأثیری ندارد. در عوض، باید از یک نمونه موجود برای گرفتن قفل استفاده شود.
.UNINDENT
.SS بررسی‌کننده Typecheck
.sp
نام دقیق این بررسی‌کننده \fBtypecheck\fP\& است.
.sp
همچنین مستندات گزینه‌های بررسی‌کننده typecheck را ببینید \%<#\:typecheck-options>
.SS پیام‌های بررسی‌کننده Typecheck
.INDENT 0.0
.TP
.B no\-member (E1101)
\fI%s %r دارای عضو %r نیست%s\fP
هنگامی استفاده می‌شود که به عضوی ناموجود از یک متغیر دسترسی پیدا شود.
.TP
.B not\-callable (E1102)
\fI%s قابل فراخوانی نیست\fP
هنگامی استفاده می‌شود که شیء فراخوانی‌شده، به‌عنوان شیئی غیرقابل‌فراخوانی استنتاج شده باشد.
.TP
.B assignment\-from\-no\-return (E1111)
\fIانتساب نتیجه فراخوانی تابعی که هیچ بازگشتی ندارد\fP
هنگامی استفاده می‌شود که انتسابی بر روی فراخوانی یک تابع انجام شود اما تابع استنتاج‌شده هیچ چیزی بازنگرداند.
.TP
.B no\-value\-for\-parameter (E1120)
\fIمقداری برای آرگومان %s در فراخوانی %s داده نشده است\fP
هنگامی استفاده می‌شود که یک فراخوانی تابع، آرگومان‌های کمتری از حد لازم ارسال کند.
.TP
.B too\-many\-function\-args (E1121)
\fIتعداد بیش از حد آرگومان‌های موضعی برای فراخوانی %s\fP
هنگامی استفاده می‌شود که یک فراخوانی تابع، بیش از حد آرگومان موضعی ارسال کند.
.TP
.B unexpected\-keyword\-arg (E1123)
\fIآرگومان کلیدواژه‌ای غیرمنتظره %r در فراخوانی %s\fP
هنگامی استفاده می‌شود که در فراخوانی یک تابع، آرگومان کلیدواژه‌ای ارسال شود که با هیچ‌یک از نام‌های پارامترهای تابع مطابقت ندارد.
.TP
.B redundant\-keyword\-arg (E1124)
\fIآرگومان %r در فراخوانی %s هم با موقعیت و هم با کلیدواژه ارسال شده است\fP
هنگامی استفاده می‌شود که فراخوانی یک تابع منجر به انتساب چندین مقدار به یک پارامتر تابع شود؛ یک مقدار از طریق آرگومان موضعی و مقدار دیگر از طریق آرگومان کلیدواژه‌ای.
.TP
.B missing\-kwoa (E1125)
\fIآرگومان کلیدواژه‌ای اجباری %r در فراخوانی %s وجود ندارد\fP
هنگامی استفاده می‌شود که یک فراخوانی تابع، یک آرگومان الزامیِ صرفاً کلیدواژه‌ای را ارسال نکند.
.TP
.B invalid\-sequence\-index (E1126)
\fIاندیس توالی از نوع int،‏ slice یا نمونه‌ای دارای __index__ نیست\fP
هنگامی استفاده می‌شود که یک نوع توالی با نوعی نامعتبر اندیس‌گذاری شود. انواع معتبر عبارتند از intها، sliceها و اشیایی با متد __index__.
.TP
.B invalid\-slice\-index (E1127)
\fIاندیس برش از نوع int،‏ None یا نمونه‌ای دارای __index__ نیست\fP
هنگامی استفاده می‌شود که اندیس برش یک عدد صحیح، None یا شیئی با متد __index__ نباشد.
.TP
.B assignment\-from\-none (E1128)
\fIانتساب نتیجه فراخوانی یک تابع، در حالی که تابع None بازمی‌گرداند\fP
هنگامی استفاده می‌شود که انتسابی بر روی فراخوانی یک تابع انجام شود اما تابع استنتاج‌شده چیزی جز None بازنگرداند.
.TP
.B not\-context\-manager (E1129)
\fIمدیر بافت \(aq%s\(aq متدهای __enter__ و __exit__ را پیاده‌سازی نکرده است.\fP
هنگامی استفاده می‌شود که یک نمونه در دستور with، پروتکل مدیر بافت (__enter__/__exit__) را پیاده‌سازی نکرده باشد.
.TP
.B invalid\-unary\-operand\-type (E1130)
هنگامی صادر می‌شود که یک عملوند یگانی روی شیئی استفاده شود که از این نوع عملیات پشتیبانی نمی‌کند.
.TP
.B unsupported\-binary\-operation (E1131)
هنگامی صادر می‌شود که یک عملیات حسابی دودویی بین دو عملوند پشتیبانی نشود.
.TP
.B repeated\-keyword (E1132)
\fIچندین مقدار برای آرگومان کلیدواژه‌ای %r در فراخوانی تابع دریافت شد\fP
هنگامی صادر می‌شود که یک فراخوانی تابع چندین مقدار برای یک کلیدواژه دریافت کند.
.TP
.B not\-an\-iterable (E1133)
\fIمقدار غیرقابل‌پیمایش %s در یک بافت پیمایشی استفاده شده است\fP
هنگامی استفاده می‌شود که یک مقدار غیرقابل‌پیمایش در جایی که انتظار شیء قابل‌پیمایش می‌رود به کار رود.
.TP
.B not\-a\-mapping (E1134)
\fIمقدار غیرنگاشتی %s در یک بافت نگاشتی استفاده شده است\fP
هنگامی استفاده می‌شود که یک مقدار غیرنگاشتی در جایی که انتظار یک نگاشت می‌رود به کار رود.
.TP
.B unsupported\-membership\-test (E1135)
\fIمقدار \(aq%s\(aq از آزمون عضویت پشتیبانی نمی‌کند\fP
هنگامی صادر می‌شود که یک نمونه در عبارت آزمون عضویت، پروتکل عضویت (__contains__/__iter__/__getitem__) را پیاده‌سازی نکرده باشد.
.TP
.B unsubscriptable\-object (E1136)
\fIمقدار \(aq%s\(aq اندیس‌پذیر نیست\fP
هنگامی صادر می‌شود که یک مقدار اندیس‌گذاری‌شده از اندیس‌پذیری پشتیبانی نکند (یعنی متد __getitem__ یا برای یک کلاس متد __class_getitem__ را تعریف نکرده باشد).
.TP
.B unsupported\-assignment\-operation (E1137)
\fI%r از انتساب آیتم پشتیبانی نمی‌کند\fP
هنگامی صادر می‌شود که یک شیء از انتساب آیتم پشتیبانی نکند (یعنی متد __setitem__ را تعریف نکرده باشد).
.TP
.B unsupported\-delete\-operation (E1138)
\fI%r از حذف آیتم پشتیبانی نمی‌کند\fP
هنگامی صادر می‌شود که یک شیء از حذف آیتم پشتیبانی نکند (یعنی متد __delitem__ را تعریف نکرده باشد).
.TP
.B invalid\-metaclass (E1139)
\fIمتاکلاس نامعتبر %r استفاده شده است\fP
هنگامی صادر می‌شود که بتوان تشخیص داد یک کلاس چیزی را به عنوان متاکلاس استفاده می‌کند که برای استفاده به عنوان متاکلاس نامعتبر است.
.TP
.B dict\-iter\-missing\-items (E1141)
\fIباز کردن دیکشنری در پیمایش بدون فراخوانی .items()\fP
هنگامی صادر می‌شود که تلاشی برای پیمایش یک dict بدون فراخوانی .items() صورت گیرد.
.TP
.B await\-outside\-async (E1142)
\fI\(aqawait\(aq باید درون یک تابع async استفاده شود\fP
هنگامی صادر می‌شود که await خارج از یک تابع async استفاده شود.
.TP
.B unhashable\-member (E1143)
\fI\(aq%s\(aq هش‌ناپذیر است و نمی‌تواند به‌عنوان یک %s در یک %s استفاده شود\fP
هنگامی صادر می‌شود که یک کلید dict یا عضو set هش‌پذیر نباشد (یعنی متد __hash__ را تعریف نکرده باشد).
.TP
.B invalid\-slice\-step (E1144)
\fIگام برش نمی‌تواند ۰ باشد\fP
هنگامی استفاده می‌شود که گام یک برش ۰ باشد و شیء متد سفارشی __getitem__ را پیاده‌سازی نکرده باشد.
.TP
.B async\-context\-manager\-with\-regular\-with (E1145)
\fIمدیر بافت \(aq%s\(aq ناهمگام است و باید با \(aqasync with\(aq استفاده شود.\fP
هنگامی استفاده می‌شود که یک مدیر بافت ناهمگام به جای \(aqasync with\(aq با دستور معمولی \(aqwith\(aq استفاده شود.
.TP
.B keyword\-arg\-before\-vararg (W1113)
\fIآرگومان کلیدواژه‌ای قبل از فهرست آرگومان‌های موضعی متغیر در تعریف تابع %s\fP
هنگام تعریف یک آرگومان کلیدواژه‌ای قبل از آرگومان‌های موضعی متغیر، در صورتی که متد با آرگومان‌های کلیدواژه‌ای فراخوانی شود، ممکن است چندین مقدار برای پارامتر مذکور ارسال گردد.
.TP
.B arguments\-out\-of\-order (W1114)
\fIبه نظر می‌رسد ترتیب آرگومان‌های موضعی نامرتب است\fP
هنگامی صادر می‌شود که نام‌های آرگومان‌های فراخواننده کاملاً با نام‌های پارامترها در امضای تابع مطابقت داشته باشند اما ترتیب یکسانی نداشته باشند.
.TP
.B non\-str\-assignment\-to\-dunder\-name (W1115)
\fIمقدار غیررشته‌ای به __name__ انتساب داده شده است\fP
هنگامی صادر می‌شود که یک مقدار غیررشته‌ای به __name__ انتساب یابد.
.TP
.B isinstance\-second\-argument\-not\-valid\-type (W1116)
\fIآرگومان دوم isinstance یک نوع نیست\fP
هنگامی صادر می‌شود که آرگومان دوم در فراخوانی isinstance یک نوع (type) نباشد.
.TP
.B kwarg\-superseded\-by\-positional\-arg (W1117)
\fI%r در %r گنجانده خواهد شد زیرا پارامتری صرفاً موضعی با این نام از قبل وجود دارد\fP
هنگامی صادر می‌شود که تابعی با یک آرگومان کلیدواژه‌ای فراخوانی شود که همنام با یک پارامتر صرفاً موضعی است و تابع دارای یک دیکشنری از پارامترهای متغیر کلیدواژه‌ای باشد.
.TP
.B c\-extension\-no\-member (I1101)
\fI%s %r دارای عضو %r نیست%s، اما کد منبع در دسترس نیست. اگر می‌خواهید تحلیل بر اساس درون‌نگری اشیاء زنده در زمان اجرا انجام شود، افزودن این ماژول به extension\-pkg\-allow\-list را در نظر بگیرید.\fP
هنگامی استفاده می‌شود که به عضوی ناموجود از یک افزونه C دسترسی پیدا شود. به دلیل در دسترس نبودن کد منبع، تحلیل ایستا غیرممکن است، اما می‌تواند با درون‌نگری اشیاء زنده در زمان اجرا انجام شود.
.UNINDENT.SS بررسی‌کننده Unicode Checker
.sp
نام دقیق این بررسی‌کننده \fBunicode_checker\fP است\&.
.SS پیام‌های بررسی‌کننده Unicode Checker
.INDENT 0.0
.TP
.B invalid\-unicode\-codec (E2501)
\fIکدک‌های UTF\-16 و UTF\-32 سازگاری عقبروی ندارند. در عوض از UTF\-8 استفاده کنید\fP
برای سازگاری، به‌جای UTF\-16/UTF\-32 از UTF\-8 استفاده کنید. همچنین برای تاریخچهٔ این موضوع به
\%<https://\:bugs\:.python\:.org/\:issue1503789>
مراجعه کنید، و برای برخی از مشکلات احتمالی هنگام استفاده از UTF\-16 به عنوان مثال، به
\%<https://\:softwareengineering\:.stackexchange\:.com/\:questions/\:102205>
نگاه کنید.
.TP
.B bidirectional\-unicode (E2502)
\fIشامل نویسه‌های کنترلی است که می‌توانند اجازه دهند کد مبهم، متفاوت از آنچه نمایش داده می‌شود اجرا شود\fP
نویسه‌های یونی‌کد دوجهته (bidirectional unicode) معمولاً نویسه‌های نمایش‌داده‌نشده‌ای هستند که برای نمایش درست خطوط راست‌به‌چپ (RTL) (یعنی چینی، ژاپنی، عربی، عبری و\&...) لازم‌اند. بنابراین آیا می‌توانید به این کد اعتماد کنید؟ آیا مطمئن هستید که در تمام ویرایشگرها به درستی نمایش داده می‌شود؟ اگر شما آن را ننوشته‌اید یا زبان شما RTL نیست، این نویسه‌های خاص را حذف کنید؛ زیرا می‌توانند برای فریب دادن شما جهت اجرای کدی به کار روند که کاری متفاوت از ظاهرش انجام می‌دهد. اطلاعات بیشتر:
\%<https://\:en\:.wikipedia\:.org/\:wiki/\:Bidirectional_text>
\%<https://\:trojansource\:.codes>
.TP
.B invalid\-character\-backspace (E2510)
\fIنویسهٔ backspace نامعتبر و بدون گریز، در عوض از \(dqb\(dq استفاده کنید.\fP
مکان‌نما را به عقب بازمی‌گرداند، بنابراین نویسهٔ پس از آن، روی نویسهٔ قبلی بازنویسی می‌شود.
.TP
.B invalid\-character\-carriage\-return (E2511)
\fIنویسهٔ carriage\-return نامعتبر و بدون گریز، در عوض از \(dqr\(dq استفاده کنید.\fP
مکان‌نما را به ابتدای خط می‌برد؛ نویسه‌های بعدی ابتدای خط را بازنویسی می‌کنند.
.TP
.B invalid\-character\-sub (E2512)
\fIنویسهٔ sub نامعتبر و بدون گریز، در عوض از \(dqx1A\(dq استفاده کنید.\fP
کلید Ctrl+Z یا \(dqEnd of text\(dq در Windows. برخی برنامه‌ها (مانند type) باقی‌ماندهٔ فایل پس از آن را نادیده می‌گیرند.
.TP
.B invalid\-character\-esc (E2513)
\fIنویسهٔ esc نامعتبر و بدون گریز، در عوض از \(dqx1B\(dq استفاده کنید.\fP
معمولاً کدهای گریز (escape codes) را آغاز می‌کند که امکان کنترل دلخواه ترمینال را فراهم می‌سازند.
.TP
.B invalid\-character\-nul (E2514)
\fIنویسهٔ nul نامعتبر و بدون گریز، در عوض از \(dq0\(dq استفاده کنید.\fP
غالباً در python به معنای پایان ورودی است.
.TP
.B invalid\-character\-zero\-width\-space (E2515)
\fIنویسهٔ zero\-width\-space نامعتبر و بدون گریز، در عوض از \(dqu200B\(dq استفاده کنید.\fP
نویسهٔ فاصلهٔ نامرئی می‌تواند اجرای واقعی کد را پنهان کند.
.TP
.B bad\-file\-encoding (C2503)
\fIPEP8 کدگذاری UTF\-8 را برای فایل‌های Python توصیه می‌کند\fP
استاندارد PEP8 کدگذاری پیش‌فرض UTF\-8 را برای فایل‌های Python توصیه می‌کند. ببینید:
\%<https://\:peps\:.python\:.org/\:pep-0008/#\:source-file-encoding>
.UNINDENT
.SS بررسی‌کننده Unnecessary\-Dunder\-Call
.sp
نام دقیق این بررسی‌کننده \fBunnecessary\-dunder\-call\fP است\&.
.SS پیام‌های بررسی‌کننده Unnecessary\-Dunder\-Call
.INDENT 0.0
.TP
.B unnecessary\-dunder\-call (C2801)
\fIفراخوانی غیرضروری متد داندر (dunder) %s. %s.\fP
زمانی استفاده می‌شود که یک متد dunder به‌جای استفاده از تابع/متد/عملگر متناظر، به صورت دستی فراخوانی شود.
.UNINDENT
.SS بررسی‌کننده Unnecessary Ellipsis
.sp
نام دقیق این بررسی‌کننده \fBunnecessary_ellipsis\fP است\&.
.SS پیام‌های بررسی‌کننده Unnecessary Ellipsis
.INDENT 0.0
.TP
.B unnecessary\-ellipsis (W2301)
\fIثابت سه نقطه (ellipsis) غیرضروری\fP
زمانی استفاده می‌شود که با ثابت ellipsis مواجه شده و امکان اجتناب از آن وجود دارد. یک خط کد متشکل از یک ellipsis غیرضروری است اگر یک docstring در خط قبلی وجود داشته باشد یا دستوری در همان حوزه (scope) موجود باشد.
.UNINDENT.SS بازبین نسخه‌های پشتیبانی‌نشده (Unsupported Version)
.sp
نام دقیق این بازبین \fBunsupported_version\fP است\&.
.SS پیام‌های بازبین نسخه‌های پشتیبانی‌نشده (Unsupported Version)
.INDENT 0.0
.TP
.B using\-f\-string\-in\-unsupported\-version (W2601)
\fIرشته‌های f\-string توسط همه نسخه‌های موجود در تنظیم py\-version پشتیبانی نمی‌شوند\fP
زمانی استفاده می‌شود که py\-version تعیین‌شده توسط کاربر کمتر از 3.6 باشد و pylint با یک f\-string مواجه شود.
.TP
.B using\-final\-decorator\-in\-unsupported\-version (W2602)
\fIقابلیت typing.final توسط همه نسخه‌های موجود در تنظیم py\-version پشتیبانی نمی‌شود\fP
زمانی استفاده می‌شود که py\-version تعیین‌شده توسط کاربر کمتر از 3.8 باشد و pylint با دکوراتور \fBtyping.final\fP مواجه شود.
.TP
.B using\-exception\-groups\-in\-unsupported\-version (W2603)
\fIگروه‌های استثنا (Exception groups) توسط همه نسخه‌های موجود در تنظیم py\-version پشتیبانی نمی‌شوند\fP
زمانی استفاده می‌شود که py\-version تعیین‌شده توسط کاربر کمتر از 3.11 باشد و pylint با \fBexcept*\fP یا \fIExceptionGroup\(ga\fP مواجه شود\&.
.TP
.B using\-generic\-type\-syntax\-in\-unsupported\-version (W2604)
\fIنحو نوع عمومی (Generic type syntax براساس PEP 695) توسط همه نسخه‌های موجود در تنظیم py\-version پشتیبانی نمی‌شود\fP
زمانی استفاده می‌شود که py\-version تعیین‌شده توسط کاربر کمتر از 3.12 باشد و pylint با نحو نوع عمومی مواجه شود.
.TP
.B using\-assignment\-expression\-in\-unsupported\-version (W2605)
\fIعبارت انتساب (Assignment expression) توسط همه نسخه‌های موجود در تنظیم py\-version پشتیبانی نمی‌شود\fP
زمانی استفاده می‌شود که py\-version تعیین‌شده توسط کاربر کمتر از 3.8 باشد و pylint با عملگر عبارت انتساب (walrus) مواجه شود.
.TP
.B using\-positional\-only\-args\-in\-unsupported\-version (W2606)
\fIآرگومان‌های فقط‌موقعیتی (Positional\-only) توسط همه نسخه‌های موجود در تنظیم py\-version پشتیبانی نمی‌شوند\fP
زمانی استفاده می‌شود که py\-version تعیین‌شده توسط کاربر کمتر از 3.8 باشد و pylint با آرگومان‌های فقط‌موقعیتی مواجه شود.
.UNINDENT
.SS بازبین متغیرها (Variables)
.sp
نام دقیق این بازبین \fBvariables\fP است\&.
.sp
همچنین مستندات گزینه‌های بازبین variables را ببینید \%<#\:variables-options>
.SS پیام‌های بازبین متغیرها (Variables)
.INDENT 0.0
.TP
.B used\-before\-assignment (E0601)
\fIاستفاده از متغیر %r پیش از مقداردهی\fP
زمانی صادر می‌شود که به یک متغیر محلی پیش از مقداردهی آن دسترسی پیدا شود. فرض می‌شود که مقداردهی‌ها در بلوک‌های try هنگام ارزیابی بلوک‌های مرتبط except/finally رخ نداده‌اند. همچنین فرض می‌شود مقداردهی‌ها در بلوک‌های except هنگام ارزیابی دستورات خارج از بلوک رخ نداده‌اند، مگر زمانی که بلوک try مرتبط حاوی دستور return باشد.
.TP
.B undefined\-variable (E0602)
\fIمتغیر تعریف‌نشده %r\fP
زمانی استفاده می‌شود که به یک متغیر تعریف‌نشده دسترسی پیدا شود.
.TP
.B undefined\-all\-variable (E0603)
\fIنام متغیر تعریف‌نشده %r در __all__\fP
زمانی استفاده می‌شود که در __all__ به نام یک متغیر تعریف‌نشده ارجاع داده شود.
.TP
.B invalid\-all\-object (E0604)
\fIشیء نامعتبر %r در __all__، باید تنها شامل رشته‌ها باشد\fP
زمانی استفاده می‌شود که یک شیء نامعتبر (غیررشته‌ای) در __all__ قرار گیرد.
.TP
.B invalid\-all\-format (E0605)
\fIقالب نامعتبر برای __all__، باید چندتایی (tuple) یا لیست باشد\fP
زمانی استفاده می‌شود که __all__ قالب نامعتبری داشته باشد.
.TP
.B possibly\-used\-before\-assignment (E0606)
\fIاحتمال استفاده از متغیر %r پیش از مقداردهی\fP
زمانی صادر می‌شود که به یک متغیر محلی پیش از مقداردهی آن در هر دو شاخه یک ساختار شرطی if/else دسترسی پیدا شود.
.TP
.B no\-name\-in\-module (E0611)
\fIنام %r در ماژول %r وجود ندارد\fP
زمانی استفاده می‌شود که نامی در یک ماژول پیدا نشود.
.TP
.B unpacking\-non\-sequence (E0633)
\fIتلاش برای بازکردن (unpack) یک شیء غیردنباله‌ای%s\fP
زمانی استفاده می‌شود که چیزی که یک توالی (sequence) نیست در یک انتساب بازکردن استفاده شود.
.TP
.B potential\-index\-error (E0643)
\fIاندیس نامعتبر برای طول شیء تکرارپذیر\fP
زمانی صادر می‌شود که یک اندیسِ استفاده‌شده روی یک شیء تکرارپذیر (iterable)، فراتر از طول آن شیء برود.
.TP
.B global\-variable\-undefined (W0601)
\fIمتغیر سراسری %r در سطح ماژول تعریف نشده است\fP
زمانی استفاده می‌شود که متغیری از طریق دستور \(dqglobal\(dq مشخص شود اما آن متغیر در حوزه (scope) ماژول تعریف نشده باشد.
.TP
.B global\-variable\-not\-assigned (W0602)
\fIاستفاده از global برای %r اما هیچ مقداردهی انجام نشده است\fP
هنگامی که متغیری در حوزه سراسری تعریف شده و در حوزه‌ای درونی تغییر داده می‌شود، کلیدواژه \(aqglobal\(aq در حوزه درونی تنها در صورتی لازم است که یک عملیات مقداردهی در آن حوزه درونی انجام شود.
.TP
.B global\-statement (W0603)
\fIاستفاده از دستور global\fP
زمانی استفاده می‌شود که از دستور \(dqglobal\(dq برای به‌روزرسانی یک متغیر سراسری استفاده کنید. Pylint استفاده از آن را توصیه نمی‌کند؛ این به این معنی نیست که نمی‌توانید از آن استفاده کنید!
.TP
.B global\-at\-module\-level (W0604)
\fIاستفاده از دستور global در سطح ماژول\fP
زمانی استفاده می‌شود که از دستور \(dqglobal\(dq در سطح ماژول استفاده کنید، چرا که هیچ تأثیری ندارد.
.TP
.B unused\-import (W0611)
\fIمورد استفاده‌نشده %s\fP
زمانی استفاده می‌شود که یک ماژول یا متغیر واردشده (imported) مورد استفاده قرار نگیرد.
.TP
.B unused\-variable (W0612)
\fIمتغیر استفاده‌نشده %r\fP
زمانی استفاده می‌شود که یک متغیر تعریف شده باشد اما استفاده نشود.
.TP
.B unused\-argument (W0613)
\fIآرگومان استفاده‌نشده %r\fP
زمانی استفاده می‌شود که آرگومان یک تابع یا متد مورد استفاده قرار نگیرد.
.TP
.B unused\-wildcard\-import (W0614)
\fIمورد(های) واردشده استفاده‌نشده %s از واردسازی عمومی (wildcard) متعلق به %s\fP
زمانی استفاده می‌شود که یک ماژول یا متغیر واردشده از طریق شیوه واردسازی \fI\(aqfrom X import *\(aq\fP مورد استفاده قرار نگیرد.
.TP
.B redefined\-outer\-name (W0621)
\fIتعریف مجدد نام %r از حوزه بیرونی (خط %s)\fP
زمانی استفاده می‌شود که نام یک متغیر، نام تعریف‌شده در یک حوزه بیرونی یا گرداننده except را بپوشاند.
.TP
.B redefined\-builtin (W0622)
\fIتعریف مجدد شناسه توکار %r\fP
زمانی استفاده می‌شود که یک متغیر یا تابع، یک شناسه توکار (built\-in) را بازنویسی کند.
.TP
.B undefined\-loop\-variable (W0631)
\fIاستفاده از متغیر حلقه احتمالاً تعریف‌نشده %r\fP
زمانی استفاده می‌شود که یک متغیر حلقه (یعنی متغیری که توسط حلقه for، تعریف فشرده لیست یا عبارت مولد تعریف شده) در خارج از حلقه استفاده شود.
.TP
.B unbalanced\-tuple\-unpacking (W0632)
\fIاحتمال بازکردن نامتوازن چندتایی با دنباله %s: سمت چپ دارای %d برچسب%s و سمت راست دارای %d مقدار%s است\fP
زمانی استفاده می‌شود که در انتساب، بازکردن نامتوازن چندتایی (tuple) رخ دهد.
.TP
.B cell\-var\-from\-loop (W0640)
\fIمتغیر سلولی %s در حلقه تعریف شده است\fP
متغیری که در یک بستار (closure) استفاده شده، در یک حلقه تعریف شده است. این امر باعث می‌شود که تمام بستارها از مقدار یکسانی برای متغیر محصورشده استفاده کنند.
.TP
.B possibly\-unused\-variable (W0641)
\fIمتغیر احتمالاً استفاده‌نشده %r\fP
زمانی استفاده می‌شود که متغیری تعریف شده باشد اما ممکن است استفاده نشود. این احتمال از این واقعیت ناشی می‌شود که تابع locals() ممکن است استفاده شده باشد، که می‌تواند متغیر مذکور را مصرف کند یا نکند.
.TP
.B self\-cls\-assignment (W0642)
\fIمقداردهی نامعتبر به %s در متد\fP
مقداردهی نامعتبر به self یا cls به ترتیب در متد نمونه یا کلاسی.
.TP
.B unbalanced\-dict\-unpacking (W0644)
\fIاحتمال بازکردن نامتوازن دیکشنری با %s: سمت چپ دارای %d برچسب%s و سمت راست دارای %d مقدار%s است\fP
زمانی استفاده می‌شود که در انتساب یا در حلقه for، بازکردن نامتوازن دیکشنری رخ دهد.
.UNINDENT.SS بررسی‌کننده‌های اختیاری
.sp
ابزار Pylint افزونه‌های اختیاری زیر را ارائه می‌دهد:
.INDENT 0.0
.IP \(bu 2
بررسی‌کننده Deprecated Builtins
.IP \(bu 2
بررسی‌کننده Broad Try Clause
.IP \(bu 2
بررسی‌کننده Else If Used
.IP \(bu 2
بررسی‌کننده Code Style
.IP \(bu 2
بررسی‌کننده Comparison\-Placement
.IP \(bu 2
بررسی‌کننده Confusing Elif
.IP \(bu 2
بررسی‌کننده Consider Refactoring Into While
.IP \(bu 2
بررسی‌کننده Consider Ternary Expression
.IP \(bu 2
بررسی‌کننده Dict\-Init\-Mutate
.IP \(bu 2
بررسی‌کننده Parameter Documentation
.IP \(bu 2
بررسی‌کننده Docstyle
.IP \(bu 2
بررسی‌کننده Dunder
.IP \(bu 2
بررسی‌کننده Empty\-Comment
.IP \(bu 2
بررسی‌کننده Eq\-Without\-Hash
.IP \(bu 2
بررسی‌کننده Consider\-Using\-Any\-Or\-All
.IP \(bu 2
بررسی‌کننده Magic\-Value
.IP \(bu 2
بررسی‌کننده Design
.IP \(bu 2
بررسی‌کننده No Self Use
.IP \(bu 2
بررسی‌کننده Overlap\-Except
.IP \(bu 2
بررسی‌کننده Import\-Private\-Name
.IP \(bu 2
بررسی‌کننده Redefined\-Loop\-Name
.IP \(bu 2
بررسی‌کننده Multiple Types
.IP \(bu 2
بررسی‌کننده Set Membership
.IP \(bu 2
بررسی‌کننده Typing
.IP \(bu 2
بررسی‌کننده While Used
.UNINDENT
.sp
شما می‌توانید هر یک یا تمام این افزونه‌ها را با افزودن یک خط \fBload\-plugins\fP به بخش \fBMAIN\fP در فایل \fB\&.pylintrc\fP خود فعال کنید، برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
load\-plugins=pylint.extensions.docparams,pylint.extensions.docstyle
.EE
.UNINDENT
.UNINDENT
.SS بررسی‌کننده Broad Try Clause
.sp
این بررسی‌کننده توسط \fBpylint.extensions.broad_try_clause\fP ارائه می‌شود\&.
نام دقیق این بررسی‌کننده \fBbroad_try_clause\fP است\&.
.sp
همچنین مستندات گزینه‌های بررسی‌کننده broad_try_clause را ببینید \%<#\:broad-try-clause-options>
.SS پیام‌های بررسی‌کننده Broad Try Clause
.INDENT 0.0
.TP
.B too\-many\-try\-statements (W0717)
بند try شامل دستورهای بسیار زیادی است.
.UNINDENT
.SS بررسی‌کننده Code Style
.sp
این بررسی‌کننده توسط \fBpylint.extensions.code_style\fP ارائه می‌شود\&.
نام دقیق این بررسی‌کننده \fBcode_style\fP است\&..SS مستندات بررسی‌کننده Code Style
.sp
بررسی‌کننده‌هایی که می‌توانند یکدستی کد را بهبود ببخشند.
به همین دلیل، آن‌ها لزوماً بهبودی در عملکرد ایجاد نمی‌کنند و
اغلب اوقات سلیقه‌ای هستند.
.sp
همچنین مستندات گزینه‌های بررسی‌کننده code_style را در \%<#\:code-style-options> ببینید.
.SS پیام‌های بررسی‌کننده Code Style
.INDENT 0.0
.TP
.B consider\-using\-namedtuple\-or\-dataclass (R6101)
\fIاستفاده از namedtuple یا dataclass را برای مقادیر دیکشنری در نظر بگیرید\fP
هنگامی صادر می‌شود که مقادیر دیکشنری بتوانند با نمونه‌های namedtuple یا dataclass
جایگزین شوند.
.TP
.B consider\-using\-tuple (R6102)
\fIاستفاده از یک tuple درجا به‌جای list را در نظر بگیرید\fP
صرفاً برای یکدستی شیوه‌نگارش! هنگامی صادر می‌شود که یک \fBlist\fP تعریف‌شده به‌صورت درجا بتواند
با یک \fBtuple\fP جایگزین شود\&. به دلیل بهینه‌سازی‌های CPython، این کار هیچ
مزیت عملکردی ندارد.
.TP
.B consider\-using\-assignment\-expr (R6103)
\fIبه‌جای آن از \(aq%s\(aq استفاده کنید\fP
هنگامی صادر می‌شود که یک انتساب if بلافاصله توسط یک دستور if دنبال شود و
هر دو بتوانند با استفاده از عبارت انتساب \fB:=\fP ترکیب شوند\&. نیازمند
Python 3.8 و \fBpy\-version >= 3.8\fP است\&.
.TP
.B consider\-using\-augmented\-assign (R6104)
\fIاز \(aq%s\(aq برای انجام مستقیم انتساب افزوده استفاده کنید\fP
هنگامی صادر می‌شود که یک انتساب به همان شیئی ارجاع دهد که در حال تخصیص
به آن است. این مورد می‌تواند به یک انتساب افزوده تغییر یابد. به‌طور پیش‌فرض غیرفعال است!
.TP
.B prefer\-typing\-namedtuple (R6105)
\fI\(aqtyping.NamedTuple\(aq را به \(aqcollections.namedtuple\(aq ترجیح دهید\fP
\(aqtyping.NamedTuple\(aq از کلیدواژه شناخته‌شده \(aqclass\(aq به همراه type\-hintها برای
خوانایی بهتر استفاده می‌کند (همچنین سریع‌تر است زیرا از یک فراخوانی درونی exec جلوگیری می‌کند). به‌طور
پیش‌فرض غیرفعال است!
.TP
.B consider\-math\-not\-float (R6106)
\fIاستفاده از %smath.%s را به‌جای %s در نظر بگیرید\fP
استفاده از math.inf یا math.nan امکان بهره‌مندی از تعیین نوع (typing) را فراهم می‌کند و
تا ۴ برابر سریع‌تر از فراخوانی float است (پس از درون‌ریزی اولیه math). این بررسی
همچنین خطاهای نگارشی در فراخوانی‌های float را به‌عنوان یک اثر جانبی شناسایی می‌کند.
.UNINDENT
.SS بررسی‌کننده Comparison\-Placement
.sp
این بررسی‌کننده توسط \fBpylint.extensions.comparison_placement\fP ارائه می‌شود\&.
نام دقیق بررسی‌کننده \fBcomparison\-placement\fP است\&.
.SS پیام‌های بررسی‌کننده Comparison\-Placement
.INDENT 0.0
.TP
.B misplaced\-comparison\-constant (C2201)
\fIمقایسه باید به صورت %s باشد\fP
هنگامی استفاده می‌شود که مقدار ثابت در سمت چپ یک مقایسه قرار گیرد. معمولاً
از نظر بیان منظور، قرار دادن آن در سمت راست مقایسه
واضح‌تر است.
.UNINDENT
.SS بررسی‌کننده Confusing Elif
.sp
این بررسی‌کننده توسط \fBpylint.extensions.confusing_elif\fP ارائه می‌شود\&.
نام دقیق بررسی‌کننده \fBconfusing_elif\fP است\&.
.SS پیام‌های بررسی‌کننده Confusing Elif
.INDENT 0.0
.TP
.B confusing\-consecutive\-elif (R5601)
\fIelifهای متوالی با سطح تورفتگی متفاوت؛ ایجاد یک تابع را برای جداسازی elif داخلی در نظر بگیرید\fP
هنگامی استفاده می‌شود که یک دستور elif بلافاصله پس از یک بلوک دارای تورفتگی بیاید که
خودش با if یا elif پایان یافته است. ممکن است مشخص نباشد که تورفتگی دستور elif
از روی قصد برداشته شده یا به اشتباه. استخراج دستور if دارای تورفتگی در
یک تابع مجزا می‌تواند از سردرگمی جلوگیری کرده و مانع بروز خطا شود.
.UNINDENT
.SS بررسی‌کننده Consider\-Using\-Any\-Or\-All
.sp
این بررسی‌کننده توسط \fBpylint.extensions.for_any_all\fP ارائه می‌شود\&.
نام دقیق بررسی‌کننده \fBconsider\-using\-any\-or\-all\fP است\&.
.SS پیام‌های بررسی‌کننده Consider\-Using\-Any\-Or\-All
.INDENT 0.0
.TP
.B consider\-using\-any\-or\-all (C0501)
\fIحلقه \(gafor\(ga می‌تواند \(ga%s\(ga باشد\fP
یک حلقه for که شرطی را بررسی می‌کند و مقدار bool برمی‌گرداند، می‌تواند با
any یا all جایگزین شود.
.UNINDENT.SS بررسی‌کننده Consider Refactoring Into While
.sp
این بررسی‌کننده توسط \fBpylint.extensions.consider_refactoring_into_while_condition\fP ارائه می‌شود\&.
نام دقیق بررسی‌کننده \fBconsider_refactoring_into_while\fP است\&.
.SS پیام‌های بررسی‌کننده Consider Refactoring Into While
.INDENT 0.0
.TP
.B consider\-refactoring\-into\-while\-condition (R3501)
\fIاستفاده از \(aqwhile %s\(aq به جای \(aqwhile %s:\(aq، یک \(aqif\(aq و یک \(aqbreak\(aq را مد نظر قرار دهید\fP
هنگامی صادر می‌شود که حلقهٔ \fIwhile True:\fP استفاده شده باشد و اولین دستور آن یک شرط break
باشد. اگر بررسی معکوس شده و به دستور \fBwhile\fP منتقل شود، ساختار \fBif / break\fP را
می‌توان حذف کرد.
.UNINDENT
.SS بررسی‌کننده Consider Ternary Expression
.sp
این بررسی‌کننده توسط \fBpylint.extensions.consider_ternary_expression\fP ارائه می‌شود\&.
نام دقیق بررسی‌کننده \fBconsider_ternary_expression\fP است\&.
.SS پیام‌های بررسی‌کننده Consider Ternary Expression
.INDENT 0.0
.TP
.B consider\-ternary\-expression (W0160)
\fIبازنویسی به عنوان یک عبارت سه‌تایی را مد نظر قرار دهید\fP
دستورهای انتساب متعددی که در بلوک‌های if/else پراکنده شده‌اند را می‌توان با یک
انتساب واحد و عبارت سه‌تایی بازنویسی کرد.
.UNINDENT
.SS بررسی‌کننده Deprecated Builtins
.sp
این بررسی‌کننده توسط \fBpylint.extensions.bad_builtin\fP ارائه می‌شود\&.
نام دقیق بررسی‌کننده \fBdeprecated_builtins\fP است\&.
.SS مستندات بررسی‌کننده Deprecated Builtins
.sp
این بخش پیش‌تر بررسی‌کنندهٔ اصلی \fBbad\-builtin\fP بود، اما به جای آن به یک
افزونه منتقل شد. از آن می‌توان برای یافتن توابع توکارِ ممنوع‌شده، مانند
\fBmap\fP یا \fBfilter\fP که جایگزین‌های دیگری برای آن‌ها وجود دارد، استفاده کرد.
.sp
اگر می‌خواهید کنترل کنید که این بررسی‌کننده در مورد کدام توابع توکار باید هشدار دهد،
می‌توانید از گزینهٔ \fBbad\-functions\fP استفاده کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ pylint a.py \-\-load\-plugins=pylint.extensions.bad_builtin \-\-bad\-functions=apply,reduce
\&...
.EE
.UNINDENT
.UNINDENT
.sp
همچنین مستندات گزینه‌های بررسی‌کنندهٔ deprecated_builtins را ببینید \%<#\:deprecated-builtins-options>
.SS پیام‌های بررسی‌کننده Deprecated Builtins
.INDENT 0.0
.TP
.B bad\-builtin (W0141)
\fIاز تابع توکار %s استفاده شده است\fP
هنگامی به کار می‌رود که یک تابع توکار غیرمجاز استفاده شود (گزینهٔ bad\-function
را ببینید). توابع غیرمجاز معمول مواردی مانند map یا filter هستند که امروزه پایتون
جایگزین‌های تمیزتری مانند فهم لیست (list comprehension) را برای آن‌ها ارائه می‌دهد.
.UNINDENT
.SS بررسی‌کننده Design
.sp
این بررسی‌کننده توسط \fBpylint.extensions.mccabe\fP ارائه می‌شود\&.
نام دقیق بررسی‌کننده \fBdesign\fP است\&.
.SS مستندات بررسی‌کننده Design
.sp
اکنون می‌توانید از این افزونه برای یافتن مشکلات پیچیدگی در پایگاه کد خود استفاده کنید.
.sp
آن را از طریق \fBpylint \-\-load\-plugins=pylint.extensions.mccabe\fP فعال کنید\&. این کار
هشدار جدیدی به نام \fBtoo\-complex\fP معرفی می‌کند که وقتی پیچیدگی یک بلوک کد بالاتر از
یک مقدار از پیش تعیین‌شده باشد صادر می‌شود؛ این مقدار را می‌توان از طریق گزینهٔ
\fBmax\-complexity\fP کنترل کرد، مانند این مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ cat a.py
def f10():
    \(dq\(dq\(dqMcCabe rating: 11\(dq\(dq\(dq
    myint = 2
    if myint == 5:
        return myint
    elif myint == 6:
        return myint
    elif myint == 7:
        return myint
    elif myint == 8:
        return myint
    elif myint == 9:
        return myint
    elif myint == 10:
        if myint == 8:
            while True:
                return True
        elif myint == 8:
            with myint:
                return 8
    else:
        if myint == 2:
            return myint
        return myint
    return myint
$ pylint a.py \-\-load\-plugins=pylint.extensions.mccabe
R:1: \(aqf10\(aq is too complex. The McCabe rating is 11 (too\-complex)
$ pylint a.py \-\-load\-plugins=pylint.extensions.mccabe \-\-max\-complexity=50
$
.EE
.UNINDENT
.UNINDENT
.sp
همچنین مستندات گزینه‌های بررسی‌کنندهٔ design را ببینید \%<#\:design-options>.SS پیام‌های بررسی‌کنندهٔ Design
.INDENT 0.0
.TP
.B too\-complex (R1260)
\fI%s بیش از حد پیچیده است. امتیاز مک‌کیب %d است\fP
زمانی استفاده می‌شود که یک متد یا تابع بر اساس پیچیدگی سیکلوماتیک مک‌کیب (McCabe) بیش از حد پیچیده باشد.
.UNINDENT
.SS بررسی‌کنندهٔ Dict\-Init\-Mutate
.sp
این بررسی‌کننده توسط \fBpylint.extensions.dict_init_mutate\fP\& ارائه می‌شود.
نام دقیق بررسی‌کننده \fBdict\-init\-mutate\fP\& است.
.SS پیام‌های بررسی‌کنندهٔ Dict\-Init\-Mutate
.INDENT 0.0
.TP
.B dict\-init\-mutate (C3401)
\fIهنگام مقداردهی اولیه دیکشنری، تمام کلید/مقدارهای شناخته‌شده را تعریف کنید.\fP
دیکشنری‌ها را می‌توان با یک دستور واحد با استفاده از نحو لیترال دیکشنری مقداردهی اولیه کرد.
.UNINDENT
.SS بررسی‌کنندهٔ Docstyle
.sp
این بررسی‌کننده توسط \fBpylint.extensions.docstyle\fP\& ارائه می‌شود.
نام دقیق بررسی‌کننده \fBdocstyle\fP\& است.
.SS پیام‌های بررسی‌کنندهٔ Docstyle
.INDENT 0.0
.TP
.B bad\-docstring\-quotes (C0198)
\fIعلامت‌های نقل‌قول داک‌استرینگ نادرست در %s، مقدار مورد انتظار \(dq\(dq\(dq بود ولی %s داده شد\fP
زمانی استفاده می‌شود که یک داک‌استرینگ (docstring) سه علامت نقل‌قول دوتایی نداشته باشد.
.TP
.B docstring\-first\-line\-empty (C0199)
\fIخط اول در داک‌استرینگ %s خالی است\fP
زمانی استفاده می‌شود که یک خط خالی در ابتدای یک داک‌استرینگ یافت شود.
.UNINDENT
.SS بررسی‌کنندهٔ Dunder
.sp
این بررسی‌کننده توسط \fBpylint.extensions.dunder\fP\& ارائه می‌شود.
نام دقیق بررسی‌کننده \fBdunder\fP\& است.
.sp
همچنین مستندات گزینه‌های بررسی‌کنندهٔ dunder را ببینید: \%<#\:dunder-options>
.SS پیام‌های بررسی‌کنندهٔ Dunder
.INDENT 0.0
.TP
.B bad\-dunder\-name (W3201)
\fIنام متد داندر %s نادرست است یا غلط املایی دارد.\fP
زمانی استفاده می‌شود که نام یک متد داندر (dunder method) دارای غلط املایی باشد یا با نامی خارج از فهرست از پیش تعریف‌شدهٔ نام‌های داندر تعریف شده باشد.
.UNINDENT
.SS بررسی‌کنندهٔ Else If Used
.sp
این بررسی‌کننده توسط \fBpylint.extensions.check_elif\fP\& ارائه می‌شود.
نام دقیق بررسی‌کننده \fBelse_if_used\fP\& است.
.SS پیام‌های بررسی‌کنندهٔ Else If Used
.INDENT 0.0
.TP
.B else\-if\-used (R5501)
\fIبرای حذف یک سطح تورفتگی، استفاده از \(dqelif\(dq را به جای \(dqelse\(dq و سپس \(dqif\(dq در نظر بگیرید\fP
زمانی استفاده می‌شود که بلافاصله پس از یک دستور else دستور if بیاید و شامل دستورهای نامرتبط با آن نباشد.
.UNINDENT
.SS بررسی‌کنندهٔ Empty\-Comment
.sp
این بررسی‌کننده توسط \fBpylint.extensions.empty_comment\fP\& ارائه می‌شود.
نام دقیق بررسی‌کننده \fBempty\-comment\fP\& است.
.SS پیام‌های بررسی‌کنندهٔ Empty\-Comment
.INDENT 0.0
.TP
.B empty\-comment (R2044)
\fIخط با کامنت خالی\fP
زمانی استفاده می‌شود که نماد # در خطی ظاهر شود که پس از آن توضیح (کامنت) واقعی نیامده باشد.
.UNINDENT
.SS بررسی‌کنندهٔ Eq\-Without\-Hash
.sp
این بررسی‌کننده توسط \fBpylint.extensions.eq_without_hash\fP\& ارائه می‌شود.
نام دقیق بررسی‌کننده \fBeq\-without\-hash\fP\& است.
.SS پیام‌های بررسی‌کنندهٔ Eq\-Without\-Hash
.INDENT 0.0
.TP
.B eq\-without\-hash (W1641)
\fIپیاده‌سازی __eq__ بدون پیاده‌سازی همزمان __hash__\fP
زمانی استفاده می‌شود که یک کلاس __eq__ را پیاده‌سازی کند اما __hash__ را خیر. در صورتی که اشیاء متد __eq__ را پیاده‌سازی کرده باشند، مقدار None را به عنوان پیاده‌سازی پیش‌فرض __hash__ خود دریافت خواهند کرد.
.UNINDENT.SS بررسی‌کننده Import\-Private\-Name
.sp
این بررسی‌کننده توسط \fBpylint.extensions.private_import\fP ارائه می‌شود\&.
نام دقیق این بررسی‌کننده \fBimport\-private\-name\fP است\&.
.SS پیام‌های بررسی‌کننده Import\-Private\-Name
.INDENT 0.0
.TP
.B import\-private\-name (C2701)
\fIImported private %s (%s)\fP
زمانی استفاده می‌شود که یک ماژول یا شیء خصوصی با پیشوند _ وارد شود. راهنمای
PEP8 در مورد قراردادهای نام‌گذاری بیان می‌کند که مشخصه‌های عمومی با زیرخط آغازین
باید خصوصی در نظر گرفته شوند.
.UNINDENT
.SS بررسی‌کننده Magic\-Value
.sp
این بررسی‌کننده توسط \fBpylint.extensions.magic_value\fP ارائه می‌شود\&.
نام دقیق این بررسی‌کننده \fBmagic\-value\fP است\&.
.sp
همچنین مستندات گزینه‌های بررسی‌کننده magic\-value را ببینید \%<#\:magic-value-options>
.SS پیام‌های بررسی‌کننده Magic\-Value
.INDENT 0.0
.TP
.B magic\-value\-comparison (R2004)
\fIConsider using a named constant or an enum instead of \(aq%s\(aq.\fP
استفاده از ثابت‌های نام‌دار به جای مقادیر جادویی به بهبود خوانایی و
نگه‌داری‌پذیری کد شما کمک می‌کند؛ سعی کنید در مقایسه‌ها از آن‌ها اجتناب کنید.
.UNINDENT
.SS بررسی‌کننده Multiple Types
.sp
این بررسی‌کننده توسط \fBpylint.extensions.redefined_variable_type\fP ارائه می‌شود\&.
نام دقیق این بررسی‌کننده \fBmultiple_types\fP است\&.
.SS پیام‌های بررسی‌کننده Multiple Types
.INDENT 0.0
.TP
.B redefined\-variable\-type (R0204)
\fIRedefinition of %s type from %s to %s\fP
زمانی استفاده می‌شود که نوع یک متغیر درون یک متد یا تابع تغییر کند.
.UNINDENT
.SS بررسی‌کننده No Self Use
.sp
این بررسی‌کننده توسط \fBpylint.extensions.no_self_use\fP ارائه می‌شود\&.
نام دقیق این بررسی‌کننده \fBno_self_use\fP است\&.
.SS پیام‌های بررسی‌کننده No Self Use
.INDENT 0.0
.TP
.B no\-self\-use (R6301)
\fIMethod could be a function\fP
زمانی استفاده می‌شود که یک متد از نمونه مقید (bound instance) خود استفاده نمی‌کند،
و بنابراین می‌تواند به صورت یک تابع نوشته شود.
.UNINDENT
.SS بررسی‌کننده Overlap\-Except
.sp
این بررسی‌کننده توسط \fBpylint.extensions.overlapping_exceptions\fP ارائه می‌شود\&.
نام دقیق این بررسی‌کننده \fBoverlap\-except\fP است\&.
.SS پیام‌های بررسی‌کننده Overlap\-Except
.INDENT 0.0
.TP
.B overlapping\-except (W0714)
\fIOverlapping exceptions (%s)\fP
زمانی استفاده می‌شود که استثناها در گرداننده (handler) هم‌پوشانی داشته یا یکسان باشند.
.UNINDENT
.SS بررسی‌کننده Parameter Documentation
.sp
این بررسی‌کننده توسط \fBpylint.extensions.docparams\fP ارائه می‌شود\&.
نام دقیق این بررسی‌کننده \fBparameter_documentation\fP است\&.
.SS مستندات بررسی‌کننده Parameter Documentation
.sp
اگر پارامترهای توابع، متدها و سازنده‌ها و نوع آن‌ها را به‌صورت روشمند در کد خود
مستندسازی می‌کنید، این جزء اختیاری ممکن است برای شما مفید باشد. سبک‌های
Sphinx، Google و Numpy پشتیبانی می‌شوند.
(برای چند مثال، \%<https://\:pypi\:.org/\:project/\:sphinxcontrib-napoleon> را ببینید.)
.sp
می‌توانید این بررسی‌کننده را با افزودن خط زیر:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
load\-plugins=pylint.extensions.docparams
.EE
.UNINDENT
.UNINDENT
.sp
به بخش \fBMAIN\fP در فایل \fB\&.pylintrc\fP خود فعال کنید\&.
.sp
این بررسی‌کننده تأیید می‌کند که تمام رشته‌های مستندات (docstrings) توابع، متدها و سازنده‌ها
شامل مستندسازی موارد زیر باشند:
.INDENT 0.0
.IP \(bu 2
پارامترها و نوع آن‌ها
.IP \(bu 2
مقدار بازگشتی و نوع آن
.IP \(bu 2
استثناهای صادرشده (raised)
.UNINDENT
.sp
و می‌تواند رشته‌های مستندات را در قالب‌های زیر مدیریت کند:
.INDENT 0.0
.IP \(bu 2
سبک Sphinx (\fBparam\fP، \fBtype\fP، \fBreturn\fP، \fBrtype\fP،
\fBraise\fP / \fBexcept\fP):
.INDENT 2.0
.INDENT 3.5
.sp
.EX
def function_foo(x, y, z):
    \(aq\(aq\(aqfunction foo ...

    :param x: bla x
    :type x: int

    :param y: bla y
    :type y: float

    :param int z: bla z

    :return: sum
    :rtype: float

    :raises OSError: bla
    \(aq\(aq\(aq
    return x + y + z
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یا سبک Google (\fBArgs:\fP، \fBReturns:\fP، \fBRaises:\fP):
.INDENT 2.0
.INDENT 3.5
.sp
.EX
def function_foo(x, y, z):
    \(aq\(aq\(aqfunction foo ...

    Args:
        x (int): bla x
        y (float): bla y

        z (int): bla z

    Returns:
        float: sum

    Raises:
        OSError: bla
    \(aq\(aq\(aq
    return x + y + z
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یا سبک Numpy (\fBParameters\fP، \fBReturns\fP، \fBRaises\fP):
.INDENT 2.0
.INDENT 3.5
.sp
.EX
def function_foo(x, y, z):
    \(aq\(aq\(aqfunction foo ...

    Parameters
    \-\-\-\-\-\-\-\-\-\-
    x: int
        bla x
    y: float
        bla y

    z: int
        bla z

    Returns
    \-\-\-\-\-\-\-
    float
        sum

    Raises
    \-\-\-\-\-\-
    OSError
        bla
    \(aq\(aq\(aq
    return x + y + z
.EE
.UNINDENT
.UNINDENT
.UNINDENT.sp
شما از \fBنبود مستندات پارامتر\fP و همچنین \fBناهماهنگی‌های نام‌گذاری\fP میان امضا و مستندات مطلع خواهید شد؛ مواردی که اغلب هنگام تغییر نام خودکار پارامترها در کد رخ می‌دهند اما در مستندات اعمال نمی‌شوند.
\fBنکته:\fP به‌طور پیش‌فرض، docstringهای متدهای خصوصی (private) و جادویی (magic) بررسی نمی‌شوند. برای تغییر این رفتار (برای نمونه، جهت بررسی \fB__init__\fP نیز) مقدار \fBno\-docstring\-rgx=^(?!__init__$)_\fP را به بخش \fBBASIC\fP در فایل \fB\&.pylintrc\fP خود بیفزایید.
.sp
پارامترهای سازنده (Constructor) را می‌توان در docstring کلاس یا در docstring متد \fB__init__\fP مستند کرد، اما نه در هر دوی آن‌ها:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class ClassFoo(object):
    \(aq\(aq\(aqSphinx style docstring foo

    :param float x: bla x

    :param y: bla y
    :type y: int
    \(aq\(aq\(aq
    def __init__(self, x, y):
        pass

class ClassBar(object):
    def __init__(self, x, y):
        \(aq\(aq\(aqGoogle style docstring bar

        Args:
            x (float): bla x
            y (int): bla y
        \(aq\(aq\(aq
        pass
.EE
.UNINDENT
.UNINDENT
.sp
در برخی موارد، الزام به مستندسازی تمام پارامترها ممکن است دردسرساز باشد؛ برای نمونه زمانی که بسیاری از توابع یا متدهای شما صرفاً از یک \fBرابط مشترک\fP پیروی می‌کنند. برای رفع این دشواری، چنانچه یکی از عبارت‌های زیر در docstring یافت شود، بازبین (checker) نبود مستندات پارامتر را می‌پذیرد:
.INDENT 0.0
.IP \(bu 2
For the other parameters, see
.IP \(bu 2
For the parameters, see
.UNINDENT
.sp
(با فاصله‌گذاری اختیاری میان کلمات). لطفاً پیوندی به docstring تعریف‌کننده رابط (مانند متد یک کلاس والد) را پس از \(dqsee\(dq اضافه کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def callback(x, y, z):
    \(aq\(aq\(aqSphinx style docstring for callback ...

    :param x: bla x
    :type x: int

    For the other parameters, see
    :class:\(gaMyFrameworkUsingAndDefiningCallback\(ga
    \(aq\(aq\(aq
    return x + y + z

def callback(x, y, z):
    \(aq\(aq\(aqGoogle style docstring for callback ...

    Args:
        x (int): bla x

    For the other parameters, see
    :class:\(gaMyFrameworkUsingAndDefiningCallback\(ga
    \(aq\(aq\(aq
    return x + y + z
.EE
.UNINDENT
.UNINDENT
.sp
ناهماهنگی‌های نام‌گذاری در پارامترهای موجود و مستندات نوع (type) آن‌ها همچنان شناسایی می‌شوند.
.sp
همچنین مستندات گزینه‌های بازبین parameter_documentation را ببینید \%<#\:parameter-documentation-options>.SS پیام‌های بررسی‌کننده Parameter Documentation
.INDENT 0.0
.TP
.B multiple\-constructor\-doc (W9005)
\fI\(dq%s\(dq دارای پارامترهای سازنده مستندشده در کلاس و __init__ است\fP
لطفاً اعلان‌های پارامتر را در کلاس یا سازنده حذف کنید.
.TP
.B missing\-raises\-doc (W9006)
\fIپرتاب شدن \(dq%s\(dq مستند نشده است\fP
لطفاً برای تمام انواع استثناهای پرتاب‌شده، استثناها را مستند کنید.
.TP
.B redundant\-returns\-doc (W9008)
\fIمستندات بازگشت (returns) زائد است\fP
لطفاً مستندات return/rtype را از این متد حذف کنید.
.TP
.B redundant\-yields\-doc (W9010)
\fIمستندات yields زائد است\fP
لطفاً مستندات yields را از این متد حذف کنید.
.TP
.B missing\-return\-doc (W9011)
\fIمستندات بازگشت (return) وجود ندارد\fP
لطفاً مستنداتی درباره آنچه این متد بازمی‌گرداند اضافه کنید.
.TP
.B missing\-return\-type\-doc (W9012)
\fIمستندات نوع بازگشتی وجود ندارد\fP
لطفاً نوع بازگردانده‌شده توسط این متد را مستند کنید.
.TP
.B missing\-yield\-doc (W9013)
\fIمستندات yield وجود ندارد\fP
لطفاً مستنداتی درباره آنچه این مولد (generator) تولید می‌کند اضافه کنید.
.TP
.B missing\-yield\-type\-doc (W9014)
\fIمستندات نوع yield وجود ندارد\fP
لطفاً نوع تولیدشده (yielded) توسط این متد را مستند کنید.
.TP
.B missing\-param\-doc (W9015)
\fI\(dq%s\(dq در مستندات پارامترها وجود ندارد\fP
لطفاً اعلان‌های پارامتر را برای همه پارامترها اضافه کنید.
.TP
.B missing\-type\-doc (W9016)
\fI\(dq%s\(dq در مستندات نوع پارامتر وجود ندارد\fP
لطفاً اعلان‌های نوع پارامتر را برای همه پارامترها اضافه کنید.
.TP
.B differing\-param\-doc (W9017)
\fI\(dq%s\(dq در مستندات پارامتر مغایرت دارد\fP
لطفاً نام‌های پارامترها را در اعلان‌ها بررسی کنید.
.TP
.B differing\-type\-doc (W9018)
\fI\(dq%s\(dq در مستندات نوع پارامتر مغایرت دارد\fP
لطفاً نام‌های پارامترها را در اعلان‌های نوع بررسی کنید.
.TP
.B useless\-param\-doc (W9019)
\fIمستندات بی‌استفاده برای پارامتر نادیده‌گرفته‌شده \(dq%s\(dq\fP
لطفاً مستندات پارامتر نادیده‌گرفته‌شده را حذف کنید.
.TP
.B useless\-type\-doc (W9020)
\fIمستندات نوع بی‌استفاده برای پارامتر نادیده‌گرفته‌شده \(dq%s\(dq\fP
لطفاً مستندات نوع پارامتر نادیده‌گرفته‌شده را حذف کنید.
.TP
.B missing\-any\-param\-doc (W9021)
\fIهیچ مستنداتی در \(dq%s\(dq وجود ندارد\fP
لطفاً مستندات پارامتر و/یا نوع را اضافه کنید.
.UNINDENT
.SS بررسی‌کننده Redefined\-Loop\-Name
.sp
این بررسی‌کننده توسط \fBpylint.extensions.redefined_loop_name\fP\& ارائه می‌شود.
نام دقیق این بررسی‌کننده \fBredefined\-loop\-name\fP\& است.
.SS پیام‌های بررسی‌کننده Redefined\-Loop\-Name
.INDENT 0.0
.TP
.B redefined\-loop\-name (W2901)
\fIتعریف دوباره %r از حلقه (خط %s)\fP
زمانی استفاده می‌شود که متغیر حلقه در بدنهٔ حلقه بازنویسی شود.
.UNINDENT
.SS بررسی‌کننده Set Membership
.sp
این بررسی‌کننده توسط \fBpylint.extensions.set_membership\fP\& ارائه می‌شود.
نام دقیق این بررسی‌کننده \fBset_membership\fP\& است.
.SS پیام‌های بررسی‌کننده Set Membership
.INDENT 0.0
.TP
.B use\-set\-for\-membership (R6201)
\fIاستفاده از set را برای آزمون عضویت در نظر بگیرید\fP
آزمون‌های عضویت زمانی که روی یک ساختار داده بهینه‌شده برای جستجو مانند \fBsets\fP\& انجام شوند، کارآمدتر هستند.
.UNINDENT.SS بررسی‌کننده Typing
.sp
این بررسی‌کننده توسط \fBpylint.extensions.typing\fP ارائه می‌شود\&.
نام دقیق بررسی‌کننده \fBtyping\fP است\&.
.SS مستندات بررسی‌کننده Typing
.sp
یافتن مشکلات مرتبط با نشانه‌گذاری‌های نوع (type annotations)\&.
.sp
همچنین مستندات گزینه‌های بررسی‌کننده typing را ببینید \%<#\:typing-options>
.SS پیام‌های بررسی‌کننده Typing
.INDENT 0.0
.TP
.B broken\-noreturn (E6004)
\fI\(aqNoReturn\(aq درون نوع‌های مرکب در نسخه‌های 3.7.0 / 3.7.1 دچار مشکل است\fP
استفاده از \fBtyping.NoReturn\fP درون نوع‌های مرکب در پایتون 3.7.0 و 3.7.1 دچار مشکل است. در صورتی که به درون‌نگری زمان اجرا (runtime introspection) وابسته نیستید، به جای آن از نشانه‌گذاری رشته‌ای استفاده کنید. برای نمونه: \fBCallable[..., \(aqNoReturn\(aq]\fP\&.
\%<https://\:bugs\:.python\:.org/\:issue34921>
.TP
.B broken\-collections\-callable (E6005)
\fI\(aqcollections.abc.Callable\(aq درون Optional و Union در نسخه‌های 3.9.0 / 3.9.1 دچار مشکل است (به جای آن از \(aqtyping.Callable\(aq استفاده کنید)\fP
استفاده از \fBcollections.abc.Callable\fP درون Optional و Union در پایتون 3.9.0 و 3.9.1 دچار ایراد است. برای این موارد در عوض از \fBtyping.Callable\fP استفاده کنید\&.
\%<https://\:bugs\:.python\:.org/\:issue42965>
.TP
.B deprecated\-typing\-alias (W6001)
\fI\(aq%s\(aq منسوخ شده است، به جای آن از \(aq%s\(aq استفاده کنید\fP
هنگامی صادر می‌شود که از یک نام مستعار منسوخ‌شدهٔ نوع‌بندی استفاده شده باشد.
.TP
.B consider\-using\-alias (R6002)
\fI\(aq%s\(aq در PY39 منسوخ خواهد شد، استفاده از \(aq%s\(aq را به جای آن در نظر بگیرید%s\fP
تنها در صورتی صادر می‌شود که \(aqruntime\-typing=no\(aq باشد و یک نام مستعار منسوخ‌شدهٔ نوع‌بندی در زمینهٔ نشانه‌گذاری نوع در پایتون 3.7 یا 3.8 به کار رفته باشد.
.TP
.B consider\-alternative\-union\-syntax (R6003)
\fIاستفاده از نحو جایگزین اجتماع را به جای \(aq%s\(aq در نظر بگیرید%s\fP
هنگامی صادر می‌شود که \fBtyping.Union\fP یا \fBtyping.Optional\fP به جای نحو خلاصه‌شدهٔ اجتماع به کار رود. برای نمونه، \fBUnion[int, float]\fP به جای \fBint | float\fP\&. استفاده از نحو خلاصه‌شده برای اجتماع‌ها با توصیه‌های نوع‌بندی پایتون همخوانی دارد، نیاز به وارد کردن ماژول‌ها را رفع می‌کند و مانع از سردرگمی در امضای توابع می‌شود.
.TP
.B redundant\-typehint\-argument (R6006)
\fIنوع \(ga%s\(ga بیش از یک بار در نشانه‌گذاری نوع اجتماع به کار رفته است. راهنماهای نوع اضافی را حذف کنید.\fP
آرگومان‌های نوع تکراری توسط ابزار \fImypy\fP نادیده گرفته خواهند شد، بنابراین برای جلوگیری از سردرگمی باید حذف شوند.
.TP
.B unnecessary\-default\-type\-args (R6007)
\fIنوع \(ga%s\(ga دارای آرگومان‌های نوع پیش‌فرض غیرضروری است. آن را به \(ga%s\(ga تغییر دهید.\fP
هنگامی صادر می‌شود که نوع‌ها دارای آرگومان‌های نوع پیش‌فرضی باشند که می‌توان از آن‌ها صرف‌نظر کرد. به‌طور عمده برای \fItyping.Generator\fP و \fItyping.AsyncGenerator\fP کاربرد دارد\&.
.UNINDENT
.SS بررسی‌کننده While Used
.sp
این بررسی‌کننده توسط \fBpylint.extensions.while_used\fP ارائه می‌شود\&.
نام دقیق بررسی‌کننده \fBwhile_used\fP است\&.
.SS پیام‌های بررسی‌کننده While Used
.INDENT 0.0
.TP
.B while\-used (W0149)
\fIاستفاده از حلقهٔ \(gawhile\(ga\fP
حلقه‌های نامحدود \fIwhile\fP اغلب می‌توانند به صورت حلقه‌های محدود \fIfor\fP بازنویسی شوند. مواردی همچون حلقه‌های رویداد (event loops)، شنونده‌ها (listeners) و غیره می‌توانند استثنا باشند.
.UNINDENT
.SS رابط برنامه‌نویسی (API)
.sp
به لطف رابط‌های برنامه‌نویسی، می‌توانید \fBPylint\fP، \fBsymilar\fP و \fBpyreverse\fP را از برنامه‌های پایتون دیگر فراخوانی کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from pylint import run_pylint, run_pyreverse, run_symilar

run_pylint(\(dq\-\-disable=C\(dq, \(dqmyfile.py\(dq)
run_pyreverse(...)
run_symilar(...)
.EE
.UNINDENT
.UNINDENT.SS Pylint
.SS همانند اجرا از طریق خط فرمان
.sp
می‌توانید از تابع \fBrun_pylint\fP استفاده کنید، که همان تابعی است
که توسط خط فرمان (با استفاده از \fBsys.argv\fP) فراخوانی می‌شود. می‌توانید
آرگومان‌ها را خودتان مشخص کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from pylint import run_pylint

run_pylint(argv=[\(dq\-\-disable=line\-too\-long\(dq, \(dqmyfile.py\(dq])
.EE
.UNINDENT
.UNINDENT
.SS دریافت نتیجه در یک جریان
.sp
همچنین اگر می‌خواهید کاری انجام دهید که تنها با استفاده از گزینه‌های
خط فرمان pylint امکان‌پذیر نیست، می‌توانید مستقیماً از \fBpylint.lint.Run\fP استفاده کنید.
در اینجا یک مثال پایه آورده شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from pylint.lint import Run

Run(argv=[\(dq\-\-disable=line\-too\-long\(dq, \(dqmyfile.py\(dq])
.EE
.UNINDENT
.UNINDENT
.sp
با \fBRun\fP می‌توان pylint را به‌صورت برنامه‌نویسی‌شده به همراه یک
گزارشگر (reporter) که با یک جریان سفارشی مقداردهی اولیه شده است، فراخوانی کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from io import StringIO

from pylint.lint import Run
from pylint.reporters.text import TextReporter

pylint_output = StringIO()  # Custom open stream
reporter = TextReporter(pylint_output)
Run([\(dqtest_file.py\(dq], reporter=reporter, exit=False)
print(pylint_output.getvalue())  # Retrieve and print the text report
.EE
.UNINDENT
.UNINDENT
.sp
گزارشگر می‌تواند هر شیء جریانی را به‌عنوان پارامتر بپذیرد. در این مثال،
جریان به یک فایل خروجی می‌دهد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from pylint.lint import Run
from pylint.reporters.text import TextReporter

with open(\(dqreport.out\(dq, \(dqw\(dq) as f:
    reporter = TextReporter(f)
    Run([\(dqtest_file.py\(dq], reporter=reporter, exit=False)
.EE
.UNINDENT
.UNINDENT
.sp
این قابلیت برای دریافت خروجی pylint در یک جریان باز جهت انتقال
به برنامه‌ای دیگر مفید خواهد بود.
.sp
اگر برنامهٔ شما انتظار دارد که فایل‌های تحت بررسی (lint) ممکن است
بین دفعات اجرا ویرایش شوند، لازم است حافظهٔ پنهان استنتاج (inference cache) در pylint را پاک کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from pylint.lint import pylinter
pylinter.MANAGER.clear_cache()
.EE
.UNINDENT
.UNINDENT.SS راهنماهای گام‌به‌گام (How To Guides)
.SS نحوه نوشتن یک بررسی‌کننده (How to Write a Checker)
.sp
می‌توانید چند نمونه ساده را در توزیع بیابید
(custom.py \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:examples/\:custom\:.py>
،
custom_raw.py \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:examples/\:custom_raw\:.py>
و
deprecation_checker.py \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:examples/\:deprecation_checker\:.py>).
.sp
سه نوع بررسی‌کننده (checker) وجود دارد:
.INDENT 0.0
.IP \(bu 2
بررسی‌کننده‌های خام (Raw checkers)، که هر ماژول را به‌صورت یک جریان خام فایل تحلیل می‌کنند.
.IP \(bu 2
بررسی‌کننده‌های توکن (Token checkers)، که یک فایل را با استفاده از فهرست توکن‌های نمایش‌دهنده کد منبع در فایل تحلیل می‌کنند.
.IP \(bu 2
بررسی‌کننده‌های AST، که روی نمایش AST از ماژول کار می‌کنند.
.UNINDENT
.sp
نمایش AST توسط کتابخانه \fBastroid\fP ارائه می‌شود.
\fBastroid\fP اطلاعات و متدهای بیشتری را نسبت به \fBast\fP در کتابخانه استاندارد اضافه می‌کند
تا پیمایش درخت و درون‌نگری (introspection) کد آسان‌تر شود.
.SS نوشتن یک بررسی‌کننده AST (Writing an AST Checker)
.sp
بیایید یک بررسی‌کننده پیاده‌سازی کنیم تا مطمئن شویم همه گره‌های \fBreturn\fP در یک تابع،
یک مقدار ثابت (constant) یکتا برمی‌گردانند.
ابتدا باید ساختار اولیه و کدهای پایه (boilerplate) ضروری را تکمیل کنیم:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import astroid
from astroid import nodes
from typing import TYPE_CHECKING, Optional

from pylint.checkers import BaseChecker

if TYPE_CHECKING:
    from pylint.lint import PyLinter


class UniqueReturnChecker(BaseChecker):

    name = \(dqunique\-returns\(dq
    msgs = {
        \(dqW0001\(dq: (
            \(dqReturns a non\-unique constant.\(dq,
            \(dqnon\-unique\-returns\(dq,
            \(dqAll constants returned in a function should be unique.\(dq,
        ),
    }
    options = (
        (
            \(dqignore\-ints\(dq,
            {
                \(dqdefault\(dq: False,
                \(dqtype\(dq: \(dqyn\(dq,
                \(dqmetavar\(dq: \(dq<y or n>\(dq,
                \(dqhelp\(dq: \(dqAllow returning non\-unique integers\(dq,
            },
        ),
    )
.EE
.UNINDENT
.UNINDENT
.sp
تاکنون مؤلفه‌های ضروری زیر را برای بررسی‌کننده خود تعریف کرده‌ایم:
.INDENT 0.0
.IP \(bu 2
.INDENT 2.0
.TP
.B یک نام (name). نام برای ایجاد یک بخش پیکربندی ویژه
برای بررسی‌کننده، در زمانی که گزینه‌ها ارائه شده باشند، استفاده می‌شود.
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B دیکشنری پیام‌ها (message dictionary). هر بررسی‌کننده برای یافتن مشکلات
در کد شما استفاده می‌شود؛ این مشکلات از طریق \fBپیام‌ها (messages)\fP\& به کاربر نمایش داده می‌شوند.
دیکشنری پیام باید مشخص کند که بررسی‌کننده چه پیام‌هایی را صادر خواهد کرد.
برای جزئیات مربوط به تعریف یک پیام جدید، بخش Defining a Message را ببینید.
.UNINDENT
.UNINDENT
.sp
ما همچنین یک مؤلفه اختیاری از بررسی‌کننده را تعریف کرده‌ایم.
فهرست گزینه‌ها (options) هرگونه گزینه قابل پیکربندی توسط کاربر را تعریف می‌کند.
این فهرست قالب زیر را دارد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
options = (
    (\(dqoption\-symbol\(dq, {\(dqargparse\-like\-kwarg\(dq: \(dqvalue\(dq}),
)
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
عبارت \fBoption\-symbol\fP یک نام یکتا برای گزینه است.
این نام در خط فرمان و در فایل‌های پیکربندی استفاده می‌شود.
خط فاصله (hyphen) هنگام استفاده در بررسی‌کننده با یک زیرخط (underscore) جایگزین می‌شود،
مشابه نحوه استفاده از \fBargparse.Namespace\fP:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
if not self.linter.config.ignore_ints:
    ...
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.sp
سپس، زمان ورود به یک تابع و خروج از آن را ردیابی خواهیم کرد.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def __init__(self, linter: Optional[\(dqPyLinter\(dq] = None) \-> None:
    super().__init__(linter)
    self._function_stack = []

def visit_functiondef(self, node: nodes.FunctionDef) \-> None:
    self._function_stack.append([])

def leave_functiondef(self, node: nodes.FunctionDef) \-> None:
    self._function_stack.pop()
.EE
.UNINDENT
.UNINDENT
.sp
در سازنده (constructor)، پشته‌ای را مقداردهی اولیه می‌کنیم تا فهرستی از گره‌های return را
برای هر تابع نگه‌داری کند.
یک بررسی‌کننده AST یک بازدیدکننده (visitor) است و باید متدهای
\fBvisit_<lowered class name>\fP یا \fBleave_<lowered class name>\fP
را برای گره‌هایی که به آن‌ها نیاز دارد پیاده‌سازی کند.
در این حالت، ما متدهای \fBvisit_functiondef\fP و \fBleave_functiondef\fP را پیاده‌سازی کرده‌ایم
تا فهرست جدیدی از گره‌های return را برای این تابع اضافه کنیم،
و هنگامی که از تابع خارج می‌شویم، فهرست گره‌های return را حذف کنیم.
.sp
در نهایت، بررسی را پیاده‌سازی خواهیم کرد.
یک تابع \fBvisit_return\fP تعریف می‌کنیم،
که با یک گره \fB\&.astroid.nodes.Return\fP فراخوانی می‌شود.
.sp
باید بتوانیم مشخص کنیم که یک گره
\fB\&.astroid.nodes.Return\fP چه ویژگی‌هایی (attributes) در دسترس دارد.
می‌توانیم از \fBastroid.extract_node\fP برای این کار استفاده کنیم:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
>>> node = astroid.extract_node(\(dqreturn 5\(dq)
>>> node
<Return l.1 at 0x7efe62196390>
>>> help(node)
>>> node.value
<Const.int l.1 at 0x7efe62196ef0>
.EE
.UNINDENT
.UNINDENT
.sp
همچنین می‌توانیم یک مثال کامل‌تر بسازیم:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
>>> node_a, node_b = astroid.extract_node(\(dq\(dq\(dq
\&... def test():
\&...     if True:
\&...         return 5 #@
\&...     return 5 #@
\&... \(dq\(dq\(dq)
>>> node_a.value
<Const.int l.4 at 0x7efe621a74e0>
>>> node_a.value.value
5
>>> node_a.value.value == node_b.value.value
True
.EE
.UNINDENT
.UNINDENT.sp
برای \fBastroid.extract_node\fP، می‌توانید از \fB#@\fP در انتهای یک خط استفاده کنید تا مشخص نمایید کدام دستورها به گره‌ها استخراج شوند.
.sp
برای اطلاعات بیشتر دربارهٔ \fBastroid.extract_node\fP،
مستندات astroid را در \%<https://pylint.readthedocs.io/projects/astroid/en/latest>\& مشاهده کنید.
.sp
حال که می‌دانیم چگونه از گره astroid استفاده کنیم، می‌توانیم بررسی خود را پیاده‌سازی کنیم.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def visit_return(self, node: nodes.Return) \-> None:
    if not isinstance(node.value, nodes.Const):
        return
    for other_return in self._function_stack[\-1]:
        if node.value.value == other_return.value.value and not (
            self.linter.config.ignore_ints and node.value.pytype() == int
        ):
            self.add_message(\(dqnon\-unique\-returns\(dq, node=node)

    self._function_stack[\-1].append(node)
.EE
.UNINDENT
.UNINDENT
.sp
هنگامی که محرز شد کد منبع در بررسی ما مردود شده است،
از \fB~.BaseChecker.add_message\fP برای ارسال پیام شکست خود استفاده می‌کنیم.
.sp
در نهایت، باید بررسی‌کننده را در pylint ثبت کنیم.
تابع \fBregister\fP را به سطح بالایی فایل اضافه کنید.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def register(linter: \(dqPyLinter\(dq) \-> None:
    \(dq\(dq\(dqThis required method auto registers the checker during initialization.
    :param linter: The linter to register the checker to.
    \(dq\(dq\(dq
    linter.register_checker(UniqueReturnChecker(linter))
.EE
.UNINDENT
.UNINDENT
.sp
اکنون آماده‌ایم تا بررسی‌کنندهٔ خود را اشکال‌زدایی و آزمایش کنیم!
.SS اشکال‌زدایی یک بررسی‌کننده (Debugging a Checker)
.sp
رسیدن به نقطه‌ای که بتوانیم از \fBpdb\fP استفاده کنیم بسیار ساده است.
ما به یک مورد آزمایشی کوچک نیاز خواهیم داشت.
کد زیر را درون یک فایل Python قرار دهید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def test():
    if True:
        return 5
    return 5

def test2():
    if True:
        return 1
    return 5
.EE
.UNINDENT
.UNINDENT
.sp
پس از قرار دادن pdb درون بررسی‌کنندهٔ خود و نصب آن،
می‌توانیم pylint را تنها با بررسی‌کنندهٔ خود اجرا کنیم:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ pylint \-\-load\-plugins=my_plugin \-\-disable=all \-\-enable=non\-unique\-returns test.py
(Pdb)
.EE
.UNINDENT
.UNINDENT
.sp
اکنون می‌توانیم بررسی‌کنندهٔ خود را اشکال‌زدایی کنیم!
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBmy_plugin\fP به ماژولی به نام \fBmy_plugin.py\fP اشاره دارد.
روش ارجح برای در دسترس قرار دادن این افزونه برای pylint،
نصب آن به عنوان یک بسته است. این کار را می‌توان از طریق یک نمایهٔ بسته مانند
\fBPyPI\fP یا با نصب آن از یک منبع محلی مانند \fBpip install\fP انجام داد.
.sp
همچنین، ماژول افزونه می‌تواند با قرار دادن دایرکتوری والد این ماژول
در متغیر محیطی \fBPYTHONPATH\fP، در دسترس pylint قرار گیرد.
.sp
اگر پیکربندی pylint شما دارای یک \fBinit\-hook\fP باشد که
\fBsys.path\fP را برای شامل کردن دایرکتوری والد ماژول تغییر دهد، این
روش نیز کار خواهد کرد؛ اما تنها در صورتی که یکی از این دو حالت برقرار باشد:
.INDENT 0.0
.IP \(bu 2
هم \fBinit\-hook\fP و هم فهرست \fBload\-plugins\fP هر دو
در یک فایل پیکربندی تعریف شده باشند، یا...
.IP \(bu 2
\fBinit\-hook\fP به عنوان یک آرگومان خط فرمان ارسال شود و
فهرست \fBload\-plugins\fP در فایل پیکربندی قرار داشته باشد
.UNINDENT
.sp
بنابراین، اگر \fBinit\-hook\fP را در یک فایل پیکربندی مشخص کنید اما نام ماژول
را از طریق \fB\-\-load\-plugins\fP در خط فرمان ارسال نمایید، نمی‌توانید با تغییر \fBsys.path\fP
یک افزونه سفارشی را بارگذاری کنید. زیرا pylint افزونه‌های مشخص‌شده در خط
فرمان را پیش از بارگذاری هرگونه پیکربندی از منابع دیگر، بارگذاری می‌کند.
.UNINDENT
.UNINDENT.SS "تعریف یک پیام (Defining a Message)"
.sp
پیام Pylint با استفاده از ساختار زیر تعریف می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
msgs = {
    \(dqE0401\(dq: ( # message id
     \(dqUnable to import %s\(dq, # template of displayed message
     \(dqimport\-error\(dq, # message symbol
     \(dqUsed when pylint has been unable to import a module.\(dq,  # Message description
     { # Additional parameters:
          # message control support for the old names of the messages:
         \(dqold_names\(dq: [(\(dqF0401\(dq, \(dqold\-import\-error\(dq)]
         \(dqminversion\(dq: (3, 5), # No check under this version
         \(dqmaxversion\(dq: (3, 7), # No check above this version
     },
 ),
.EE
.UNINDENT
.UNINDENT
.sp
سپس پیام با استفاده از پارامتر \fBargs\fP در متد \fBadd_message\fP قالب‌بندی می‌شود؛ یعنی در
\fBself.add_message(\(dqimport\-error\(dq, args=module_we_cant_import, node=importnode)\fP، مقدار درون \fBmodule_we_cant_import\fP، برای نمونه \fBpatglib\fP، جای‌گذاری شده و نتیجه نهایی به این صورت خواهد بود:
\fBUnable to import patglib\fP
.INDENT 0.0
.IP \(bu 2
شناسه پیام (\fBmessage\-id\fP) باید یک عدد ۴ رقمی باشد
که یک \fBmessage category\fP (دسته‌بندی پیام) به عنوان پیشوند به آن اضافه شده است.
دسته‌بندی‌های متعددی برای پیام‌ها وجود دارد
که عبارتند از \fBC\fP، \fBW\fP، \fBE\fP، \fBF\fP، \fBR\fP،
و به ترتیب نشان‌دهنده \fBConvention\fP (قراردادها)، \fBWarning\fP (هشدار)، \fBError\fP (خطا)، \fBFatal\fP (خطای مهلک) و \fBRefactoring\fP (بازآفرینی کد) هستند.
این ۴ رقم نباید با بررسی‌کننده‌های موجود تداخل داشته باشند
و ۲ رقم اول باید در سراسر بررسی‌کننده یکدست باشند (به استثنای پیام‌های مشترک).
استفاده از ۵۱\-۹۹ به عنوان ۲ رقم اول برای بررسی‌کننده‌های سفارشی ایمن است زیرا این محدوده برای آن‌ها رزرو شده است.
.IP \(bu 2
عبارت \fBdisplayed\-message\fP برای نمایش پیام به کاربر
پس از انتشار آن به کار می‌رود.
.IP \(bu 2
شناسه نمادین \fBmessage\-symbol\fP یک نام مستعار برای شناسه پیام است
و در هر جایی که شناسه پیام قابل استفاده باشد، می‌توان از آن نیز استفاده کرد.
.IP \(bu 2
توضیحات \fBmessage\-help\fP هنگام فراخوانی دستور \fBpylint \-\-help\-msg\fP نمایش داده می‌شود.
.UNINDENT
.sp
پیام می‌تواند به صورت اختیاری شامل گزینه‌های اضافی زیر باشد:
.INDENT 0.0
.IP \(bu 2
گزینه \fBold_names\fP امکان تغییر شناسه پیام یا نماد یک پیام را بدون از کار انداختن کنترل پیام مورد استفاده کاربران روی پیام‌های قدیمی فراهم می‌کند. این گزینه به صورت فهرستی
از چندتایی‌ها به شکل (\fBmessage\-id\fP, \fBold\-message\-symbol\fP) مشخص می‌شود؛ مانند \fB{\(dqold_names\(dq: [(\(dqF0401\(dq, \(dqold\-import\-error\(dq)]}\fP\&.
تناظر میان نماد و شناسه پیام باید یکتا باشد؛ بنابراین اگر شناسه پیام را تغییر می‌دهید، نماد نیز باید تغییر کند و معمولاً می‌توانید از پیشوند \fBold\-\fP برای این کار استفاده کنید.
.IP \(bu 2
گزینه‌های \fBminversion\fP یا \fBmaxversion\fP حداقل یا حداکثر نسخه پایتون
مرتبط با این پیام را مشخص می‌کنند. مقدار این گزینه به صورت یک چندتایی با شماره نسخه اصلی به عنوان
عدد اول و شماره نسخه فرعی به عنوان عدد دوم مشخص می‌شود؛ مانند \fB{\(dqminversion\(dq: (3, 5)}\fP\&.
.IP \(bu 2
گزینه \fBshared\fP امکان به اشتراک گذاشتن پیام میان چندین بررسی‌کننده را فعال می‌کند. همان‌طور که پیش‌تر
اشاره شد، در حالت عادی پیام‌ها نمی‌توانند بین چند بررسی‌کننده به اشتراک گذاشته شوند.
برای مجاز کردن اشتراک پیام میان چند بررسی‌کننده، گزینه \fBshared\fP باید
روی \fBTrue\fP تنظیم شود.
.UNINDENT
.SS "موازی‌سازی یک بررسی‌کننده (Parallelize a Checker)"
.sp
کلاس \fBBaseChecker\fP دارای دو متد به نام‌های \fBget_map_data\fP و \fBreduce_map_data\fP است که
امکان موازی‌سازی بررسی‌ها را هنگام استفاده از گزینه \fB\-j\fP فراهم می‌کنند. اگر یک بررسی‌کننده
واقعاً به تجمیع و کاهش داده‌ها (reduce) نیاز داشته باشد، باید متد \fBget_map_data\fP را طوری تعریف کند که
مقداری غیر از \fBNone\fP برگرداند و اجازه دهد متد \fBreduce_map_data\fP آن، فهرستی
از نوع‌های بازگردانده‌شده توسط \fBget_map_data\fP را مدیریت و پردازش کند.
.sp
یک نمونه از این مورد را می‌توان در \fBpylint/checkers/similar.py\fP مشاهده کرد.
.SS "آزمایش یک بررسی‌کننده (Testing a Checker)"
.sp
ابزار Pylint برای توسعه مبتنی بر آزمایش (TDD) بسیار مناسب است.
می‌توانید قالب کلی بررسی‌کننده را پیاده‌سازی کنید،
همه موارد آزمایشی (test cases) خود را بنویسید و بررسی کنید که شکست می‌خورند،
سپس بررسی‌کننده را پیاده‌سازی کنید،
و در نهایت بررسی کنید که تمام موارد آزمایشی شما به درستی کار می‌کنند.
.sp
ابزار Pylint کلاس \fBpylint.testutils.CheckerTestCase\fP را
برای ساده‌سازی ایجاد موارد آزمایشی ارائه می‌دهد.
می‌توانیم از کد نمونه‌ای که برای اشکال‌زدایی به کار بردیم به عنوان موارد آزمایشی استفاده کنیم.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import astroid
import my_plugin
import pylint.testutils


class TestUniqueReturnChecker(pylint.testutils.CheckerTestCase):
    CHECKER_CLASS = my_plugin.UniqueReturnChecker

    def test_finds_non_unique_ints(self):
        func_node, return_node_a, return_node_b = astroid.extract_node(\(dq\(dq\(dq
        def test(): #@
            if True:
                return 5 #@
            return 5 #@
        \(dq\(dq\(dq)

        self.checker.visit_functiondef(func_node)
        self.checker.visit_return(return_node_a)
        with self.assertAddsMessages(
            pylint.testutils.MessageTest(
                msg_id=\(dqnon\-unique\-returns\(dq,
                node=return_node_b,
            ),
        ):
            self.checker.visit_return(return_node_b)

    def test_ignores_unique_ints(self):
        func_node, return_node_a, return_node_b = astroid.extract_node(\(dq\(dq\(dq
        def test(): #@
            if True:
                return 1 #@
            return 5 #@
        \(dq\(dq\(dq)

        with self.assertNoMessages():
            self.checker.visit_functiondef(func_node)
            self.checker.visit_return(return_node_a)
            self.checker.visit_return(return_node_b)
.EE
.UNINDENT
.UNINDENT
.sp
یک بار دیگر از متد \fBastroid.extract_node\fP برای
ساخت موارد آزمایشی خود استفاده می‌کنیم.
کلاس \fBpylint.testutils.CheckerTestCase\fP لینتر و بررسی‌کننده را برای ما ایجاد کرده است؛
ما صرفاً با استفاده از گره‌های مورد نظرمان،
پیمایش درخت AST را شبیه‌سازی می‌کنیم..SS نحوه نوشتن یک افزونه Pylint
.sp
ابزار Pylint از نوشتن دو نوع افزونه پشتیبانی می‌کند.
نخست، مفهوم \fBcheckers\fP وجود دارد
که می‌توان از آن برای یافتن مشکلات در کد استفاده کرد.
دوم، مفهوم \fBtransform plugin\fP نیز وجود دارد
که روشی را ارائه می‌دهد که از طریق آن استنتاج و
قابلیت‌های Pylint می‌تواند بهبود یافته و برای یک ماژول،
کتابخانه یا چارچوب خاص سفارشی‌سازی شود.
.sp
به‌طور کلی، یک افزونه ماژولی است که باید تابعی به نام \fBregister\fP داشته باشد
که نمونه‌ای از \fBpylint.lint.PyLinter\fP را به‌عنوان ورودی دریافت می‌کند.
.sp
یک افزونه می‌تواند به‌صورت اختیاری تابعی با نام \fBload_configuration\fP تعریف کند
که نمونه‌ای از \fBpylint.lint.PyLinter\fP را به‌عنوان ورودی می‌گیرد. این
تابع پس از اینکه Pylint پیکربندی را از فایل پیکربندی
و رابط خط فرمان بارگیری کرد، فراخوانی می‌شود. این تابع باید پیکربندی‌های
اضافی مربوط به افزونه را در Pylint بارگذاری کند.
.sp
بنابراین یک افزونه پایه hello\-world را می‌توان به این صورت پیاده‌سازی کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# Inside hello_plugin.py
from typing import TYPE_CHECKING

import astroid

if TYPE_CHECKING:
    from pylint.lint import PyLinter


def register(linter: \(dqPyLinter\(dq) \-> None:
  \(dq\(dq\(dqThis required method auto registers the checker during initialization.

  :param linter: The linter to register the checker to.
  \(dq\(dq\(dq
  print(\(aqHello world\(aq)
.EE
.UNINDENT
.UNINDENT
.sp
می‌توانیم این افزونه را با قرار دادن این ماژول در PYTHONPATH و فراخوانی
\fBpylint\fP به صورت زیر اجرا کنیم:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ pylint \-E \-\-load\-plugins hello_plugin foo.py
Hello world
.EE
.UNINDENT
.UNINDENT
.sp
می‌توانیم افزونه hello\-world را با استفاده از تابع \fBload_configuration\fP
برای نادیده گرفتن برخی نام‌های خاص گسترش دهیم:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# Inside hello_plugin.py
from typing import TYPE_CHECKING

import astroid

if TYPE_CHECKING:
    from pylint.lint import PyLinter


def register(linter: \(dqPyLinter\(dq) \-> None:
  \(dq\(dq\(dqThis required method auto registers the checker during initialization.

  :param linter: The linter to register the checker to.
  \(dq\(dq\(dq
  print(\(aqHello world\(aq)

def load_configuration(linter):

  name_checker = get_checker(linter, NameChecker)
  # We consider as good names of variables Hello and World
  name_checker.config.good_names += (\(aqHello\(aq, \(aqWorld\(aq)

  # We ignore bin directory
  linter.config.black_list += (\(aqbin\(aq,)
.EE
.UNINDENT
.UNINDENT
.sp
بسته به اینکه به یک \fBtransform plugin\fP یا یک \fBchecker\fP نیاز داریم، ممکن است
این مقدار کافی نباشد. برای مورد اول، این کار برای اعلام ماژول به‌عنوان یک افزونه کافی است،
اما در مورد دوم، باید checker خود را با فراخوانی دستور زیر در داخل
تابع \fBregister\fP، در شیء linter ثبت کنیم:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
linter.register_checker(OurChecker(linter))
.EE
.UNINDENT
.UNINDENT
.sp
برای اطلاعات بیشتر درباره نوشتن یک checker به بخش «نحوه نوشتن یک Checker» مراجعه کنید: \%<#\:write-a-checker>\&..SS پلاگین‌های تبدیل (Transform plugins)
.SS چرا یک پلاگین بنویسیم؟ (Why write a plugin?)
.sp
ابزار Pylint یک ابزار تحلیل ایستا است و Python زبانی با نوع‌بندی پویا می‌باشد.
بنابراین مواردی پیش خواهد آمد که Pylint نمی‌تواند فایل‌ها را به‌درستی تحلیل کند (این مشکل
در زبان‌هایی با نوع‌بندی ایستا نیز در صورت استفاده از بازتاب یا ارزیابی پویا می‌تواند
رخ دهد).
.sp
پلاگین‌ها روشی هستند برای اینکه به Pylint بگوییم چگونه با چنین مواردی برخورد کند،
زیرا تنها کاربر می‌داند چه کاری باید انجام شود. آن‌ها معمولاً در سطح AST عمل می‌کنند
و با دستکاری یا اصلاح آن، درک کد را برای Pylint ساده‌تر می‌سازند.
.SS مثال (Example)
.sp
بیایید Pylint را روی یک ماژول از سورس‌کد Python اجرا کنیم: warnings.py \%<https://\:hg\:.python\:.org/\:cpython/\:file/\:2\:.7/\:Lib/\:warnings\:.py> و ببینیم چه اتفاقی می‌افتد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
amitdev$ pylint \-E Lib/warnings.py
E:297,36: Instance of \(aqWarningMessage\(aq has no \(aqmessage\(aq member (no\-member)
E:298,36: Instance of \(aqWarningMessage\(aq has no \(aqfilename\(aq member (no\-member)
E:298,51: Instance of \(aqWarningMessage\(aq has no \(aqlineno\(aq member (no\-member)
E:298,64: Instance of \(aqWarningMessage\(aq has no \(aqline\(aq member (no\-member)
.EE
.UNINDENT
.UNINDENT
.sp
آیا به یک خطای واقعی برخوردیم؟ بیایید کد را باز کرده و نگاهی به کلاس \fBWarningMessage\fP بیندازیم:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class WarningMessage(object):

  \(dq\(dq\(dqHolds the result of a single showwarning() call.\(dq\(dq\(dq

  _WARNING_DETAILS = (\(dqmessage\(dq, \(dqcategory\(dq, \(dqfilename\(dq, \(dqlineno\(dq, \(dqfile\(dq,
                      \(dqline\(dq)

  def __init__(self, message, category, filename, lineno, file=None,
                  line=None):
    local_values = locals()
    for attr in self._WARNING_DETAILS:
      setattr(self, attr, local_values[attr])
    self._category_name = category.__name__ if category else None

  def __str__(self):
    ...
.EE
.UNINDENT
.UNINDENT
.sp
آهان، فیلدها (\fBmessage\fP، \fBcategory\fP و غیره) به‌صورت ایستا روی کلاس تعریف نشده‌اند.
در عوض، آن‌ها با استفاده از \fBsetattr\fP اضافه شده‌اند. Pylint برای درک این ساختار با
مشکل مواجه خواهد شد.
.SS ورود پلاگین (Enter Plugin)
.sp
می‌توانیم یک پلاگین تبدیل بنویسیم تا به Pylint یاد بدهد که چگونه این کلاس را به‌درستی تحلیل کند.
.sp
یک راه برای رفع این مورد با پلاگین، تبدیل کلاس \fBWarningMessage\fP است؛ از طریق تنظیم
ویژگی‌ها به‌گونه‌ای که Pylint بتواند آن‌ها را ببیند. این کار با ثبت یک تابع تبدیل
انجام می‌شود. ما می‌توانیم هر گره‌ای را در AST تجزیه‌شده مانند Module، Class، Function و
غیره تغییر دهیم. در این سناریو، ما باید یک کلاس را تبدیل کنیم. این کار به این شکل انجام می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
from typing import TYPE_CHECKING

import astroid

if TYPE_CHECKING:
    from pylint.lint import PyLinter


def register(linter: \(dqPyLinter\(dq) \-> None:
  \(dq\(dq\(dqThis required method auto registers the checker during initialization.

  :param linter: The linter to register the checker to.
  \(dq\(dq\(dq
  pass

def transform(cls):
  if cls.name == \(aqWarningMessage\(aq:
    import warnings
    for f in warnings.WarningMessage._WARNING_DETAILS:
      cls.locals[f] = [astroid.ClassDef(f, None)]

astroid.MANAGER.register_transform(astroid.ClassDef, transform)
.EE
.UNINDENT
.UNINDENT
.sp
بیایید پلاگین را با هم مرور کنیم. ابتدا، باید یک تبدیل کلاس را ثبت کنیم که از طریق تابع
\fBregister_transform\fP در \fBMANAGER\fP انجام می‌شود. این تابع نوع گره و تابع تبدیل را
به عنوان پارامتر می‌پذیرد. ما نیاز داریم یک کلاس را تغییر دهیم، بنابراین از \fBastroid.ClassDef\fP
استفاده می‌کنیم. همچنین یک تابع \fBtransform\fP را پاس می‌دهیم که فرآیند تبدیل واقعی را انجام می‌دهد.
.sp
تابع \fBtransform\fP نیز ساده است. اگر کلاس مورد نظر \fBWarningMessage\fP باشد، صفت‌ها را به
locals آن اضافه می‌کنیم (ما نگران نوع صفات نیستیم، بنابراین تنظیم آن‌ها به عنوان class کفایت
می‌کند؛ هرچند می‌توانستیم آن‌ها را به هر نوع دلخواهی تنظیم کنیم). کار تمام است.
.sp
نکته: نیازی نیست هیچ کاری در تابع \fBregister\fP پلاگین انجام دهیم، زیرا چیزی را در خود
linter دستکاری نمی‌کنیم.
.sp
بیایید Pylint را به همراه این پلاگین اجرا کنیم و نتیجه را ببینیم:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
amitdev$ pylint \-E \-\-load\-plugins warning_plugin Lib/warnings.py
amitdev$
.EE
.UNINDENT
.UNINDENT
.sp
اکنون تمام هشدارهای مثبت کاذب (false positives) مربوط به \fBWarningMessage\fP برطرف شده‌اند.
این فقط یک مثال بود؛ هرگونه تبدیل کدی را می‌توان توسط پلاگین‌ها پیاده‌سازی کرد.
.sp
برای دیدن نمونه‌های واقعی از پلاگین‌های تبدیل، astroid/brain \%<https://\:github\:.com/\:pylint-dev/\:astroid/\:tree/\:main/\:astroid/\:brain> را بررسی کنید..SS مرجع فنی
.SS راه‌اندازی و کلاس Linter
.sp
دو کلاس اصلی در \fBpylint.lint\fP عبارتند از
\fB\&.pylint.lint.Run\fP و \fB\&.pylint.lint.PyLinter\fP\&.
.sp
شیء \fB\&.pylint.lint.Run\fP مسئول راه‌اندازی pylint است.
این شیء بررسی‌های اولیه‌ای روی گزینه‌های خط فرمان داده‌شده انجام می‌دهد تا
قلاب (hook) اولیه را برای اجرا پیدا کند،
فایل پیکربندی مورد استفاده را بیابد،
و مشخص کند چه افزایه‌هایی تعیین شده‌اند.
سپس می‌تواند نمونهٔ اصلی \fB\&.pylint.lint.PyLinter\fP را ایجاد کرده
و آن را با فایل پیکربندی و افزایه‌هایی که هنگام پیش‌پردازش گزینه‌های خط فرمان شناسایی شده‌اند مقداردهی اولیه کند.
در نهایت شیء \fB\&.pylint.lint.Run\fP هرگونه linter فرزند را
برای کارهای موازی اجرا کرده و فرایند بررسی کد (linting) را آغاز می‌نماید.
.sp
شیء \fB\&.pylint.lint.PyLinter\fP مسئول هماهنگ‌سازی فرایند
بررسی کد است.
این شیء پیکربندی را تجزیه کرده و آن را برای بررسی‌کننده‌ها و سایر افزایه‌ها فراهم می‌کند،
پیام‌های صادرشده توسط بررسی‌کننده‌ها را پردازش می‌نماید،
گزارش‌دهی خروجی را مدیریت می‌کند،
و بررسی‌کننده‌ها را راه‌اندازی می‌کند.
.SS بررسی‌کننده‌ها (Checkers)
.sp
تمام بررسی‌کننده‌های پیش‌فرض pylint در \fBpylint.checkers\fP وجود دارند.
بخش عمدهٔ هوش pylint در این قسمت قرار دارد.
بیشتر بررسی‌کننده‌ها مبتنی بر AST هستند و بنابراین از \fBastroid\fP استفاده می‌کنند.
ماژول \fBpylint.checkers.utils\fP تعداد زیادی متد کمکی برای
کار با \fBastroid\fP فراهم می‌کند.
.SS مشارکت در pylint
.sp
راهنمای مشارکت‌کنندگان در صورتی که بخواهید در خود pylint مشارکت کنید به شما کمک خواهد کرد.
.SS مشارکت
.SS یافتن کاری برای انجام دادن
.sp
می‌خواهید در pylint مشارکت کنید؟ کارهای زیادی وجود دارد که می‌توانید انجام دهید.
در اینجا فهرستی از پیوندها بر اساس آنچه که می‌خواهید انجام دهید آمده است:
.INDENT 0.0
.IP \(bu 2
پرسیدن سؤال در دیسکورد \%<https://\:discord\:.com/\:invite/\:qYxpadCgkx>، یا در گیت‌هاب \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:new/\:choose>
.IP \(bu 2
باز کردن یک issue در \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:new?\:assignees=&\:labels=Needs+triage+%3Ainbox_tray%3A&\:template=BUG-REPORT\:.yml>
.IP \(bu 2
بهبود مستندات \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues?\:q=is%3Aopen+is%3Aissue+label%3A%22Documentation+%3Agreen_book%3A%22>
.IP \(bu 2
بهبود پیام‌های خطا \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues?\:q=is%3Aopen%20is%3Aissue%20project%3Apylint-dev%2Fpylint%2F4>
.IP \(bu 2
بازآفرینی باگ‌ها و تأیید معتبر بودن issueها \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues?\:q=is%3Aopen+is%3Aissue+label%3A%22Needs+reproduction+%3Amag%3A%22%2C%22Cannot+reproduce+%F0%9F%A4%B7%22>
.IP \(bu 2
بررسی یا اشکال‌زدایی مسائل پیچیده \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues?\:q=is%3Aopen+is%3Aissue+label%3A%22Needs+investigation+%F0%9F%94%AC%22>
.IP \(bu 2
طراحی یا مشخص‌سازی یک راه‌حل \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues?\:q=is%3Aopen+is%3Aissue+label%3A%22Needs+design+proposal+%3Alock%3A%22%2C%22Needs+specification+%3Aclosed_lock_with_key%3A%22>
.IP \(bu 2
ارائهٔ دیدگاه دربارهٔ بحث‌های جاری \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues?\:q=is%3Aopen+is%3Aissue+label%3A%22Needs+decision+%3Alock%3A%22>
.IP \(bu 2
رفع باگ‌ها و کرش‌ها \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues?\:q=is%3Aopen+is%3Aissue+label%3A%22Bug+%3Abeetle%3A%22%2C%22Crash+%F0%9F%92%A5%22>
.IP \(bu 2
رفع مثبت‌های کاذب (False Positives) \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues?\:q=is%3Aopen+is%3Aissue+label%3A%22False+Positive+%F0%9F%A6%9F%22>
.IP \(bu 2
ایجاد قابلیت‌های جدید یا رفع منفی‌های کاذب (False Negatives) \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues?\:q=is%3Aopen+is%3Aissue+label%3A%22False+Negative+%F0%9F%A6%8B%22%2C%22Enhancement+%E2%9C%A8%22>
.IP \(bu 2
بازبینی pull requestها \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:pulls?\:q=is%3Aopen+is%3Apr+label%3A%22Needs+review+%F0%9F%94%8D%22>
.UNINDENT
.sp
اگر یکی از نگه‌دارندگان pylint هستید، این موارد نیز وجود دارد:
.INDENT 0.0
.IP \(bu 2
تریاژ و اولویت‌بندی issueها \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues?\:q=is%3Aopen+is%3Aissue+label%3A%22Needs+triage+%3Ainbox_tray%3A%22>
.IP \(bu 2
برچسب‌گذاری issueهایی که هنوز برچسب اقدام‌پذیری ندارند \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues?\:q=is%3Aopen+is%3Aissue+-label%3A%22Needs+astroid+Brain+%F0%9F%A7%A0%22+-label%3A%22Needs+astroid+update%22+-label%3A%22Needs+backport%22+-label%3A%22Needs+decision+%3Alock%3A%22+-label%3A%22Needs+investigation+%F0%9F%94%AC%22+-label%3A%22Needs+PR%22+-label%3A%22Needs+reproduction+%3Amag%3A%22+-label%3A%22Needs+review+%F0%9F%94%8D%22+-label%3A%22Needs+triage+%3Ainbox_tray%3A%22+-label%3A%22Waiting+on+author%22+-label%3A%22Work+in+progress%22+-label%3AMaintenance+sort%3Aupdated-desc+-label%3A%22Needs+specification+%3Aclosed_lock_with_key%3A%22+-label%3A%22Needs+design+proposal+%3Alock%3A%22>
.IP \(bu 2
آماده‌سازی انتشار وصلهٔ بعدی \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues?\:q=is%3Aopen+is%3Aissue+label%3A%22Needs+backport%22>
.IP \(bu 2
بررسی وضعیت pull requestهای راکد و قدیمی \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:pulls?\:q=is%3Aopen+is%3Apr+label%3A%22Work+in+progress%22%2C%22Needs+astroid+update%22%2C%22Waiting+on+author%22>
.UNINDENT
.SS ایجاد یک Pull Request
.sp
تغییری برای Pylint در نظر دارید؟ در ادامه چند مرحله آورده شده است که باید انجام دهید تا مطمئن شوید وصلهٔ شما پذیرفته می‌شود:
.INDENT 0.0
.IP \(bu 2
باید حداقل از Python 3.8 برای توسعهٔ Pylint استفاده کنید چرا که به شما دسترسی به جدیدترین تجزیه‌کنندهٔ \fBast\fP را می‌دهد و برخی قلاب‌های pre\-commit از python 3.7 پشتیبانی نمی‌کنند.
.IP \(bu 2
وابستگی‌های توسعه را نصب کنید؛ نصب مشارکت‌کننده \%<#\:contributor-install>\& را ببینید.
.IP \(bu 2
از مجموعه آزمون‌های ما استفاده کرده و آزمون‌های جدید بنویسید؛ آزمودن pylint \%<#\:contributor-testing>\& را ببینید.
.UNINDENT
.INDENT 0.0
.IP \(bu 2
اگر تغییر شما غیرجزئی است، آن را مستندسازی کنید:
.INDENT 2.0
.IP \(bu 2
در صورتی که نیازی نباشد تغییر در changelog ذکر شود، ممکن است نگه‌دارنده به issue برچسب \fBskip\-news\fP بزند.
.IP \(bu 2
در غیر این صورت، یک قطعه خبری با دستور \fBtowncrier create <IssueNumber>.<type>\fP ایجاد کنید که در changelog گنجانده خواهد شد. \fB<type>\fP می‌تواند یکی از انواع تعریف‌شده در \fI\&./towncrier.toml\fP باشد.
در صورت نیاز می‌توانید جزئیات بیشتری بنویسید یا مثال‌هایی از نحوهٔ کارکرد تغییر جدید ارائه دهید.
.IP \(bu 2
تولید مستندات با دستور \fBtox \-e docs\fP انجام می‌شود.
.UNINDENT
.IP \(bu 2
یک pull request از طریق GitHub ارسال کنید (برای اطلاعات بیشتر در مورد این موضوع، دربارهٔ pull requestها \%<https://\:support\:.github\:.com/\:features/\:pull-requests> را ببینید).
.IP \(bu 2
پیام‌های کامیت جامع و/یا شرح مناسبی از آنچه PR انجام می‌دهد بنویسید.
در صورتی که چنین issueای وجود دارد، تغییر خود را به یک issue در سامانهٔ رهگیری مرتبط کنید (برای اطلاعات بیشتر در این باره، بستن issueها از طریق پیام‌های کامیت \%<https://\:github\:.blog/\:2013-01-22-closing-issues-via-commit-messages> در مستندات GitHub را ببینید).
.IP \(bu 2
تغییرات را کوچک نگه دارید؛ تغییرات مورد توافق همگان را از موارد سلیقه‌ای و مناقشه‌برانگیز جدا کنید.
.INDENT 2.0
.IP \(bu 2
اگر تغییر نیازمند آن است، در گشودن چندین PR تردید نکنید. اگر بازبینی تغییر شما چنان بزرگ باشد که مستلزم برنامه‌ریزی و اختصاص زمانی طولانی برای بررسی باشد، به احتمال بسیار زیاد راکد خواهد شد.
.IP \(bu 2
نگه‌دارندگان ممکن است روزانه چندین بازهٔ ۵ تا ۱۰ دقیقه‌ای برای بازبینی داشته باشند—مثلاً در حین انتظار برای جوش آمدن قوری‌شان، یا منتظر ماندن برای آرام شدن شریک زندگی‌شان پس از یک شوخی خنده‌دار خورهٔ رایانه—اما در بهترین حالت شاید تنها یک ساعت کامل در هفته زمان بازبینی داشته باشند.
.UNINDENT
.IP \(bu 2
اگر هنگام مشارکت از چندین ایمیل یا چندین نام استفاده کرده‌اید، ایمیل‌ها و نام مورد نظر خود را در فایل \fBscript/.contributors_aliases.json\fP اضافه کنید.
.UNINDENT.SS نکاتی برای شروع توسعه Pylint
.INDENT 0.0
.IP \(bu 2
«مرجع فنی» \%<#\:technical-reference>\& را مطالعه کنید. این بخش مرور کوتاهی بر پایه‌کد pylint ارائه می‌دهد و به شما کمک می‌کند تا محل اعمال تغییرات لازم برای آنچه قصد پیاده‌سازی‌اش را دارید، شناسایی کنید.
.IP \(bu 2
تابع \fBastroid.extract_node\fP دوست شماست. بیشتر بررسی‌کننده‌ها مبتنی بر AST هستند، بنابراین احتمالاً نیاز به تعامل با \fBastroid\fP خواهید داشت. یک مثال کوتاه از نحوه استفاده از \fBastroid.extract_node\fP در اینجا \%<#\:astroid-extract-node>\& آورده شده است.
.IP \(bu 2
هنگام رفع اشکال یک بررسی خاص، پیام هشدار را در کد جستجو کنید تا متوجه شوید این هشدار در کجا صادر می‌شود و در نتیجه منطق آن کد کجاست.
.IP \(bu 2
هنگام افزودن یک کلاس بررسی‌کننده جدید، می‌توانید از اسکریپت \fBget_unused_message_id_category.py\fP در پوشه \fB\&./script\fP استفاده کنید تا شناسه پیامی را دریافت نمایید که توسط هیچ‌یک از بررسی‌کننده‌های دیگر استفاده نشده است.
.UNINDENT
.SS ساخت مستندات
.sp
می‌توانید از makefile موجود در پوشه doc برای ساخت مستندات استفاده کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ make \-C doc/ install\-dependencies
$ make \-C doc/ html
.EE
.UNINDENT
.UNINDENT
.sp
برای سرعت بیشتر، ما از فایل‌های تولیدشده مجدداً استفاده می‌کنیم؛ هر زمان که مایل بودید از ابتدا شروع کنید از \fBmake clean\fP یا \fBtox \-e docs\fP استفاده کنید.
.SS چگونه نسخه مقصد را انتخاب کنیم؟
.sp
بسته به نوع تغییری که ایجاد می‌کنید، انتخاب کنید:
.INDENT 0.0
.IP \(bu 2
در \fBانتشار وصله‌ای (patch release)\fP (\fB1.2.3\fP)، ما فقط مثبت‌های کاذب و خرابی‌ها را رفع می‌کنیم.
.UNINDENT
.INDENT 0.0
.IP \(bu 2
در \fBانتشارهای فرعی (minor releases)\fP (\fB1.2.0\fP)، بررسی‌هایی اضافه یا حذف می‌کنیم، پشتیبانی از مفسرهای python که از پایان دوره پشتیبانی گذشته‌اند را متوقف می‌کنیم، نسخه‌های اصلی/فرعی astroid را ارتقا می‌دهیم و منفی‌های کاذب را رفع می‌کنیم.
.UNINDENT
.INDENT 0.0
.IP \(bu 2
در \fBانتشارهای اصلی (major releases)\fP (\fB1.0.0\fP) سایر موارد را تغییر می‌دهیم (گزینه‌های pylint، خروجی json، رابط برنامه‌نویسی توسعه‌دهنده...) در حالی که همچنان تلاش می‌کنیم ایجاد اختلال به حداقل برسد.
.UNINDENT
.SS آزمایش pylint
.sp
نرم‌افزار Pylint به‌خوبی آزمایش شده و پوشش کد بالایی دارد. مشارکت‌های جدید تا زمانی که شامل آزمون‌ها نباشند پذیرفته نمی‌شوند.
.SS نصب برای مشارکت‌کنندگان
.SS نصب اولیه
.sp
توسعه Pylint با استفاده از سیستم کنترل نسخه توزیع‌شده git \%<https://\:git-scm\:.com> انجام می‌شود.
.sp
می‌توانید Pylint را با این دستور کلون کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
git clone https://github.com/pylint\-dev/pylint
.EE
.UNINDENT
.UNINDENT
.sp
پیش از شروع آزمایش کد خود، باید بسته کد منبع را به‌صورت محلی نصب کنید. فرض کنید همین حالا با دستور قبلی \fBgit clone\fP مخزن pylint را کلون کرده‌اید. برای آماده‌سازی محیط آزمایش، یک ترمینال باز کرده و دستورات زیر را اجرا کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cd pylint
python3 \-m venv venv
source venv/bin/activate
pip install \-r requirements_test_min.txt
pip install \-e .
.EE
.UNINDENT
.UNINDENT
.sp
این کار تضمین می‌کند که محیط آزمایشی شما مشابه محیط آزمایشی Pylint در GitHub باشد.
.sp
\fBاختیاری\fP (زیرا در صورت باز کردن یک درخواست ادغام، اصلاح خودکار وجود دارد): ما قلاب‌های پیش از کامیت (pre\-commit hooks) داریم که قالب‌بندی خودکار را پیش از هر کامیت برای شما انجام می‌دهند. برای فعال‌سازی آن، دستور \fBpre\-commit install\fP را در پوشه ریشه \fBpylint\fP اجرا کنید..SS نصب Astroid
.sp
اگر در حال آزمایش تغییرات جدید در astroid هستید، باید astroid را نیز از \%<https://\:github\:.com/\:pylint-dev/\:astroid> کلون کرده و آن را در کنار pylint به‌صورت قابل ویرایش (editable) به این شیوه نصب کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# فرض کنید در دایرکتوری pylint هستید
git clone https://github.com/pylint\-dev/astroid.git
python3 \-m pip install \-e astroid/
.EE
.UNINDENT
.UNINDENT
.sp
اکنون در pylint از نسخه محلی astroid استفاده می‌کنید و می‌توانید نسخه آن را با git کنترل کنید، برای مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
cd astroid/
git switch my\-astroid\-dev\-branch
.EE
.UNINDENT
.UNINDENT
.SS اجرای آزمون‌ها
.SS pytest
.sp
از آنجا که برای اجرای آزمون‌ها از pytest استفاده می‌کنیم، خودتان نیز می‌توانید آن را به‌صورت مستقل اجرا کنید.
با این حال توصیه می‌کنیم از دستور tox استفاده کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pytest tests/ \-k test_functional
.EE
.UNINDENT
.UNINDENT
.sp
می‌توانید مستقیماً از pytest استفاده کنید. اگر می‌خواهید با pytest و نسخه محلی python خود، آزمون‌ها را روی بخش خاصی از کد اجرا کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
python3 \-m pytest
.EE
.UNINDENT
.UNINDENT
.sp
تمام موارد موجود در tests/message همراه با پوشش کد (coverage) برای کد مربوطه (نیازمند pytest\-cov \%<https://\:pypi\:.org/\:project/\:pytest-cov>):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
python3 \-m pytest tests/message/ \-\-cov=pylint.message
coverage html
.EE
.UNINDENT
.UNINDENT
.sp
فقط آزمون عملکردی \(dqmissing_kwoa_py3\(dq:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
python3 \-m pytest \(dqtests/test_functional.py::test_functional[missing_kwoa_py3]\(dq
.EE
.UNINDENT
.UNINDENT
.SS tox
.sp
همچنین می‌توانید \fIبه‌صورت اختیاری\fP tox را نصب کرده و آزمون‌ها را با استفاده از بسته tox اجرا کنید، مانند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
python \-m tox
python \-m tox \-epy313 # فقط برای مجموعه Python 3.13
python \-m tox \-epylint # برای اجرای Pylint روی کد منبع Pylint
python \-m tox \-eformatting # برای اجرای بررسی‌های قالب‌بندی روی کد منبع Pylint
.EE
.UNINDENT
.UNINDENT
.sp
معمولاً ایده خوبی است که tox را با گزینه \fB\-\-recreate\fP\& اجرا کنید. این پرچم به tox دستور می‌دهد که قبل از اجرای آزمون‌ها، تمام وابستگی‌ها را دوباره بارگیری کند. این امر زمانی می‌تواند مهم باشد که نسخه جدیدی از astroid \%<https://\:github\:.com/\:pylint-dev/\:astroid> یا هر یک از وابستگی‌های دیگر منتشر شده باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
python \-m tox \-\-recreate # کل محیط tox دوباره ایجاد خواهد شد
python \-m tox \-\-recreate \-e py310 # محیط tox مربوط به python 3.10 دوباره ایجاد خواهد شد
.EE
.UNINDENT
.UNINDENT
.sp
برای اجرای تنها یک مجموعه‌آزمون خاص، از یک الگو برای نام فایل آزمون (\fBبدون\fP پسوند \fB\&.py\fP) استفاده کنید، مانند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
python \-m tox \-e py310 \-\- \-k test_functional
python \-m tox \-e py310 \-\- \-k  \e*func\e*
python \-m tox \-\-recreate \-e py310 \-\- \-k test_functional # همراه با بازسازی محیط
.EE
.UNINDENT
.UNINDENT.SS آزمون‌های پرایمر (Primer tests)
.sp
برنامه Pylint همچنین از آنچه ما آزمون‌های \fBprimer\fP می‌نامیم استفاده می‌کند. این‌ها آزمون‌هایی هستند که به صورت خودکار در یکپارچه‌سازی مداوم (Continuous Integration) ما اجرا می‌شوند و بررسی می‌کنند که آیا تغییرات در Pylint منجر به کرش یا خطاهای مهلک در \fBstdlib\fP می‌شود یا خیر، و همچنین با ارسال diff در مقایسه با خروجی فعلی \fBpylint\fP به صورت یک یادداشت (comment)، تأثیر یک pull request را بر تحلیل کدهای (linting) مجموعه‌ای از مخازن خارجی ارزیابی می‌کنند.
.sp
برای اجرای آزمون primer برای \fBstdlib\fP، که تنها کرش‌ها و خطاهای مهلک را بررسی می‌کند، می‌توانید گزینه \fB\-\-primer\-stdlib\fP را به دستور pytest اضافه کنید. به عنوان مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pytest \-m primer_stdlib \-\-primer\-stdlib
.EE
.UNINDENT
.UNINDENT
.sp
برای تولید خروجی ایجاد شده در یکپارچه‌سازی مداوم جهت بررسی linting مخازن خارجی، این دستورها را اجرا کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
python tests/primer/__main__.py prepare \-\-clone
python tests/primer/__main__.py run \-\-type=pr
.EE
.UNINDENT
.UNINDENT
.sp
برای شبیه‌سازی کامل فرآیند در یکپارچه‌سازی مداوم، سپس باید شاخه \fBmain\fP را checkout کرده و این دستورها را اجرا نمایید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
python tests/primer/__main__.py run \-\-type=main
python tests/primer/__main__.py compare
.EE
.UNINDENT
.UNINDENT
.sp
فهرست مخازن بر اساس سه معیار ایجاد شده است: ۱) پروژه‌ها باید از طیف متنوعی از ویژگی‌های زبان استفاده کنند، ۲) پروژه‌ها باید به خوبی نگهداری شوند و ۳) پروژه‌ها نباید پایه‌کدی بیش از حد تکراری داشته باشند. این امر تعادل مناسبی را بین سرعت CI ما و یافتن باگ‌های بالقوه تضمین می‌کند.
.sp
می‌توانید آخرین فهرست مخازن و هر کد مرتبط با این آزمون‌ها را در دایرکتوری \fBtests/primer\fP پیدا کنید.
.SS نوشتن آزمون‌ها (Writing tests)
.sp
برنامه Pylint از سه نوع آزمون استفاده می‌کند: آزمون‌های واحد (unittests)، آزمون‌های عملکردی (functional tests) و آزمون‌های primer.
.INDENT 0.0
.IP \(bu 2
آزمون‌های واحد (unittests) را می‌توان در \fBpylint/tests\fP یافت\&. مگر اینکه روی بخش‌های درونی pylint کار کنید، احتمالاً نیازی به نوشتن آن‌ها نخواهید داشت.
.IP \(bu 2
آزمون‌های عملکردی سراسری (Global functional tests) در \fBpylint/tests/functional\fP قرار دارند\&. آن‌ها عمدتاً برای آزمایش این که آیا Pylint پیام‌های درستی صادر می‌کند یا خیر به کار می‌روند.
.IP \(bu 2
آزمون‌های عملکردی پیکربندی را می‌توان در \fBpylint/tests/config/functional\fP یافت\&. آن‌ها برای آزمایش نحوه بارگذاری پیکربندی Pylint استفاده می‌شوند.
.IP \(bu 2
در آزمون‌های primer \%<#\:primer-tests> می‌توانید یک مخزن خارجی جدید را برای بررسی پیشنهاد دهید، اما در بیشتر مواقع کاری برای انجام دادن وجود ندارد.
.UNINDENT
.SS آزمون‌های واحد (Unittest tests)
.sp
بیشتر آزمون‌های دیگر در دایرکتوری \(aq/pylint/test\(aq قرار دارند. این آزمون‌های واحد را می‌توان برای آزمایش تقریباً تمام قابلیت‌های درون Pylint استفاده کرد. یک گام مناسب پیش از نوشتن هر آزمون واحد جدید، نگاه کردن به آزمون‌هایی است که کارکرد مشابهی را آزمایش می‌کنند. این کار اغلب می‌تواند به نوشتن آزمون‌های جدید کمک کند.
.sp
اگر آزمون جدید شما به هرگونه فایل اضافی نیاز دارد، می‌توانید آن‌ها را در دایرکتوری \fB/pylint/test/regrtest_data\fP قرار دهید. این دایرکتوری محلی است که ما برای ذخیره داده‌های مورد نیاز برای آزمون‌های واحد استفاده می‌کنیم.
.SS آزمون‌های عملکردی (Functional tests)
.sp
این آزمون‌ها در \fB/pylint/test/functional\fP قرار دارند و از چندین بخش تشکیل شده‌اند. ابتدا، هر فایل پایتون به عنوان یک مورد آزمون (test case) در نظر گرفته می‌شود و باید با یک فایل \fB\&.txt\fP با همان نام همراه باشد. فایل \fB\&.txt\fP حاوی پیام‌های \fBpylint\fP است که انتظار می‌رود توسط فایل آزمون مربوطه صادر شوند.
.sp
در فایل آزمون \fB\&.py\fP شما، هر خطی که قرار است Pylint برای آن پیامی صادر کند، باید با یک کامنت مطابق با الگوی \fB# [message_symbol]\fP نشانه‌گذاری شود، مانند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
a, b, c = 1 # [unbalanced\-tuple\-unpacking]
.EE
.UNINDENT
.UNINDENT
.sp
اگر چندین پیام برای یک خط مورد انتظار باشد، می‌توان از این نحو استفاده کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
a, b, c = 1.test # [unbalanced\-tuple\-unpacking, no\-member]
.EE
.UNINDENT
.UNINDENT
.sp
همچنین می‌توانید برای مدیریت موارد خاص از \fB# +n: [\fP استفاده کنید که در آن \fBn\fP یک عدد صحیح است؛ برای مثال در مواردی که نحو معمولی بالا خط را بیش از حد طولانی می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
A = 5
# +1: [singleton\-comparison]
B = A == None  # The test will look for the \(gasingleton\-comparison\(ga message in this line
.EE
.UNINDENT
.UNINDENT
.sp
اگر به کنترل ویژه‌ای روی پیکربندی Pylint نیاز دارید، می‌توانید یک فایل \fB\&.rc\fP نیز ایجاد کنید که می‌تواند بخش‌هایی از پیکربندی Pylint را تنظیم کند.
فایل \fB\&.rc\fP همچنین می‌تواند شامل بخشی به نام \fB[testoptions]\fP برای ارسال گزینه‌ها به اجراکننده آزمون عملکردی باشد. در حال حاضر گزینه‌های زیر پشتیبانی می‌شوند:
.INDENT 0.0
.IP \(bu 2
\(dqmin_pyver\(dq: حداقل نسخه پایتون مورد نیاز برای اجرای آزمون
.IP \(bu 2
\(dqmax_pyver\(dq: نسخه پایتونی که از آن به بعد آزمون اجرا نخواهد شد. اگر آخرین نسخه پشتیبانی‌شده 3.9 است، این تنظیم باید روی 3.10 قرار گیرد.
.IP \(bu 2
\(dqmin_pyver_end_position\(dq: حداقل نسخه پایتون مورد نیاز برای بررسی ویژگی‌های end_line و end_column پیام
.IP \(bu 2
\(dqrequires\(dq: بسته‌هایی که نصب محلی آن‌ها برای اجرای آزمون الزامی است
.IP \(bu 2
\(dqexcept_implementations\(dq: فهرستی از پیاده‌سازی‌های پایتون که آزمون نباید روی آن‌ها اجرا شود
.IP \(bu 2
\(dqexclude_platforms\(dq: فهرستی از سیستم‌های عاملی که آزمون نباید روی آن‌ها اجرا شود
.UNINDENT
.sp
\fBخروجی متفاوت برای نسخه‌های مختلف پایتون\fP
.sp
گاهی اوقات نتیجه linting می‌تواند بین نسخه‌های مختلف پایتون تغییر کند. در این موارد، خطاها را می‌توان به عنوان شرطی علامت‌گذاری کرد. عملگرهای پشتیبانی‌شده عبارتند از \fB<\fP، \fB<=\fP، \fB>\fP و \fB>=\fP\&.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def some_func() \-> X:  # <3.14:[undefined\-variable]
  ...

# It can also be combined with offsets
# +1:<3.14:[undefined\-variable]
def some_other_func() \-> X:
  ...

class X: ...
.EE
.UNINDENT
.UNINDENT
.sp
از آنجا که پیام‌های خروجی متفاوت هستند، افزودن دو فایل جداگانه برای آن الزامی است. ابتدا فایل \fB<test\-file\-name>.314.txt\fP، که شامل پیام‌های خروجی برای \fB>=3.14\fP خواهد بود، یعنی در اینجا باید خالی باشد. دوم فایل \fB<test\-file\-name>.txt\fP، که پیش‌فرض برای سایر نسخه‌های پایتون خواهد بود.
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
این قابلیت تنها زمانی کار می‌کند که خود کد در تمام نسخه‌های پایتون مورد آزمایش، قابل تجزیه (parsable) باشد. برای نحوهای جدید (new syntax)، به جای آن از \fBmin_pyver\fP / \fBmax_pyver\fP استفاده کنید.
.UNINDENT
.UNINDENT
.sp
\fBمحل قرارگیری فایل‌های آزمون عملکردی\fP
.sp
برای بررسی‌کننده‌های موجود، موارد آزمون جدید ترجیحاً باید به فایل آزمون موجود ضمیمه شوند. برای بررسی‌کننده‌های جدید، باید یک فایل جدید به نام \fBnew_checker_message.py\fP ایجاد شود (به استفاده از زیرخط‌ها توجه کنید). سپس این فایل باید در زیردایرکتوری \fBtest/functional/n\fP قرار گیرد.
.sp
چند نکته دیگر:
.INDENT 0.0
.IP \(bu 2
اگر بررسی‌کننده بخشی از یک افزونه است، آزمون باید در \fBtest/functional/ext/extension_name\fP قرار گیرد
.IP \(bu 2
اگر آزمون یک آزمون رگرسیون (regression test) است، باید در \fBtest/r/regression\fP یا \fBtest/r/regression_02\fP قرار گیرد\&. نام فایل باید با \fBregression_\fP شروع شود\&.
.IP \(bu 2
برای برخی از زیردایرکتوری‌ها، مانند \fBtest/functional/u\fP، زیردایرکتوری‌های دیگری نیز وجود دارد (\fBtest/functional/u/use\fP). لطفاً بررسی کنید که آیا فایل آزمون شما باید در یکی از این دایرکتوری‌ها قرار گیرد یا خیر. اگر نام زیردایرکتوری با کلمه قبل از اولین زیرخط در نام فایل آزمون شما مطابقت داشته باشد، باید در آنجا قرار داده شود.
.UNINDENT.sp
ساختار پوشه‌ها هنگام اجرای مجموعه آزمون الزامی است، بنابراین ممکن است هدایت شوید تا فایل را در زیردایرکتوری دیگری قرار دهید.
.sp
\fBاجرا و به‌روزرسانی آزمون‌های کارکردی\fP
.sp
در طول توسعه، گاهی مفید است که برای دریافت بازخورد سریع‌تر، تمام آزمون‌های کارکردی را در محیط فعلی خود اجرا کنید. این دستور را از دایرکتوری ریشه Pylint اجرا کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
python tests/test_functional.py
.EE
.UNINDENT
.UNINDENT
.sp
می‌توانید از تمام گزینه‌هایی که برای pytest \%<https://\:docs\:.pytest\:.org/\:en/\:latest> استفاده می‌کنید بهره ببرید، برای مثال \fB\-k \(dqtest_functional[len_checks]\(dq\fP\&.
علاوه بر این، در صورت نیاز می‌توان فایل txt. حاوی پیام‌های مورد انتظار را بر اساس خروجی فعلی با الحاق \fB\-\-update\-functional\-output\fP به خط فرمان بازتولید کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
python tests/test_functional.py \-\-update\-functional\-output \-k \(dqtest_functional[len_checks]\(dq
.EE
.UNINDENT
.UNINDENT
.SS آزمون‌های کارکردی برای پیکربندی‌ها (Functional tests for configurations)
.sp
برای آزمایش روش‌های مختلف پیکربندی Pylint، یک چارچوب آزمون کارکردی کوچک نیز برای فایل‌های پیکربندی وجود دارد. این آزمون‌ها را می‌توان در دایرکتوری \(aq/pylint/test/config\(aq یافت.
.sp
برای ایجاد یک آزمون جدید، یک فایل جدید با نامی استفاده‌نشده در دایرکتوری مربوط به آن نوع فایل پیکربندی ایجاد کنید. سپس یک فایل \fBfilename.result.json\fP اضافه کنید که در آن \(aqfilename\(aq هم‌نام فایل پیکربندی شما باشد. این فایل باید ثبت کند که پیکربندی \fBدر مقایسه با پیکربندی استاندارد\fP چگونه باید باشد\&.
.sp
برای مثال، اگر پیکربندی باید یک هشدار را به فهرست پیام‌های غیرفعال‌شده اضافه کند و شما پیکربندی \fBjob\fP را به جای مقدار پیش‌فرض ۱ روی ۱۰ تنظیم کرده‌اید، فایل \fB\&.json\fP باید شامل موارد زیر باشد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqfunctional_append\(dq: {
    \(dqdisable\(dq: [[\(dqa\-message\-to\-be\-added\(dq],]
}
\(dqjobs\(dq: 10,
.EE
.UNINDENT
.UNINDENT
.sp
مشابهاً اگر پیامی باید حذف شود، می‌توانید عبارت زیر را به فایل \fB\&.json\fP اضافه کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
\(dqfunctional_remove\(dq: {
    \(dqdisable\(dq: [[\(dqa\-message\-to\-be\-removed\(dq],]
}
.EE
.UNINDENT
.UNINDENT
.sp
اگر پیکربندی نادرست باشد و باید منجر به از کار افتادن (crash) یا انتشار هشدار شود، می‌توانید این موضوع را با افزودن یک فایل \fB\&.out\fP مشخص کنید. این فایل باید نامی با الگوی \fBname_of_configuration_testfile.error_code.out\fP داشته باشد\&. بنابراین، اگر آزمون شما \fBbad_configuration.toml\fP نام دارد و باید با کد خروج ۲ پایان یابد، فایل \fB\&.out\fP باید \fBbad_configuration.2.out\fP نام‌گذاری شود\&. محتوای فایل \fB\&.out\fP باید الگویی شبیه به خروجی عادی Pylint داشته باشد. توجه داشته باشید که نام ماژول باید \fB{abspath}\fP و نام فایل باید \fB{relpath}\fP باشد\&.
.SS پروفایل‌سازی و تحلیل کارایی (Profiling and performance analysis)
.SS تحلیل کارایی برای Pylint (Performance analysis for Pylint)
.sp
برای تحلیل کارایی Pylint پیشنهاد می‌کنیم از ماژول \fBcProfile\fP از \fBstdlib\fP استفاده کنید\&. این ماژول در کنار ماژول \fBpstats\fP تمامی ابزارهای لازم برای پروفایل‌سازی یک اجرای Pylint و مشاهده مدت زمان اجرای هر تابع را در اختیارتان قرار می‌دهد.
.sp
مستندات هر دو ماژول در cProfile \%<https://\:docs\:.python\:.org/\:3/\:library/\:profile\:.html> در دسترس است\&.
.sp
برای پروفایل‌سازی اجرای Pylint روی خودش، می‌توانید از کد زیر استفاده کرده و آن را از دایرکتوری اصلی اجرا کنید. توجه داشته باشید که \fBcProfile\fP سندی به نام \fBstats\fP ایجاد می‌کند که سپس توسط \fBpstats\fP خوانده می‌شود\&. خروجی خوانا برای انسان توسط \fBpstats\fP در \fB\&./profiler_stats\fP ذخیره خواهد شد\&. این خروجی بر اساس \fBزمان تجمعی (cumulative time)\fP مرتب خواهد شد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import cProfile
import pstats
import sys

sys.argv = [\(dqpylint\(dq, \(dqpylint\(dq]
cProfile.run(\(dqfrom pylint import __main__\(dq, \(dqstats\(dq)

with open(\(dqprofiler_stats\(dq, \(dqw\(dq, encoding=\(dqutf\-8\(dq) as file:
    stats = pstats.Stats(\(dqstats\(dq, stream=file)
    stats.sort_stats(\(dqcumtime\(dq)
    stats.print_stats()
.EE
.UNINDENT
.UNINDENT
.sp
همچنین می‌توانید با مرتب‌سازی یا محدود کردن خروجی، با شیء stats کار کنید. به عنوان مثال، برای چاپ توابع فقط از ماژول \fBpylint\fP و مرتب‌سازی بر اساس زمان تجمعی می‌توانید از دستور زیر استفاده کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import cProfile
import pstats
import sys

sys.argv = [\(dqpylint\(dq, \(dqpylint\(dq]
cProfile.run(\(dqfrom pylint import __main__\(dq, \(dqstats\(dq)

with open(\(dqprofiler_stats\(dq, \(dqw\(dq, encoding=\(dqutf\-8\(dq) as file:
    stats = pstats.Stats(\(dqstats\(dq, stream=file)
    stats.sort_stats(\(dqcumtime\(dq)
    stats.print_stats(\(dqpylint/pylint\(dq)
.EE
.UNINDENT
.UNINDENT
.sp
در نهایت، برای پروفایل‌سازی یک اجرا روی ماژول یا کد اختصاصی خود، می‌توانید از کد زیر استفاده کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import cProfile
import pstats
import sys

sys.argv = [\(dqpylint\(dq, \(dqyour_dir/your_file\(dq]
cProfile.run(\(dqfrom pylint import __main__\(dq, \(dqstats\(dq)

with open(\(dqprofiler_stats\(dq, \(dqw\(dq, encoding=\(dqutf\-8\(dq) as file:
    stats = pstats.Stats(\(dqstats\(dq, stream=file)
    stats.sort_stats(\(dqcumtime\(dq)
    stats.print_stats()
.EE
.UNINDENT
.UNINDENT
.sp
مستندات ماژول \fBpstats\fP سایر قابلیت‌ها را برای تعامل با خروجی پروفایل‌سازی بررسی می‌کند..SS تحلیل کارایی یک بررسی‌کننده مشخص
.sp
برای تحلیل کارایی یک بررسی‌کننده (checker) مشخص در Pylint می‌توانیم از خروجی خوانا برای انسان که توسط \fBpstats\fP تولید شده است استفاده کنیم\&.
.sp
اگر در فایل \fBprofiler_stats\fP نام فایل بررسی‌کننده را جستجو کنید، تمام فراخوانی‌های توابع درون آن بررسی‌کننده را خواهید یافت. فرض کنید می‌خواهیم متد \fBvisit_importfrom\fP از بررسی‌کننده \fBvariables\fP را بررسی کنیم:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ncalls  tottime  percall  cumtime  percall filename:lineno(function)
622    0.006    0.000    8.039    0.013 /MY_PROGRAMMING_DIR/pylint/pylint/checkers/variables.py:1445(visit_importfrom)
.EE
.UNINDENT
.UNINDENT
.sp
خط قبلی به ما می‌گوید که این متد در طول پروفایل‌گیری ۶۲۲ بار فراخوانی شده و در مجموع ۶ میلی‌ثانیه درون خود تابع بوده‌ایم. زمان به ازای هر فراخوانی کمتر از یک میلی‌ثانیه است (0.006 / 622) و بنابراین 0 نمایش داده شده است.
.sp
اغلب زمان تجمعی (به ازای هر فراخوانی) برای شما جالب‌تر است. این مورد به زمان صرف‌شده درون تابع و هر یک از توابعی که توسط آن فراخوانی شده‌اند یا توابعی که آن‌ها فراخوانی کرده‌اند (و غیره) اشاره دارد. در مثال ما، اجرای متد \fBvisit_importfrom\fP و تمام توابع فرزند آن کمی بیش از ۸ ثانیه طول کشیده است، با زمان اجرای 0.013 میلی‌ثانیه به ازای هر فراخوانی.
.sp
همچنین می‌توانید \fBprofiler_stats\fP را برای یک تابع مشخص که می‌خواهید ارزیابی کنید جستجو نمایید. برای مثال \fB_analyse_fallback_blocks\fP، تابعی که توسط \fBvisit_importfrom\fP در بررسی‌کننده \fBvariables\fP فراخوانی می‌شود. این امر امکان تحلیل دقیق‌تر توابع مشخص را فراهم می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
ncalls  tottime  percall  cumtime  percall filename:lineno(function)
1    0.000    0.000    0.000    0.000 /MY_PROGRAMMING_DIR/pylint/pylint/checkers/variables.py:1511(_analyse_fallback_blocks)
.EE
.UNINDENT
.UNINDENT
.SS تجزیه آمارهای پروفایلر با ابزارهای دیگر
.sp
اغلب ممکن است بخواهید یک نمایش بصری از آمارهای پروفایل‌گیری خود ایجاد کنید. ابزاری مناسب برای این کار gprof2dot \%<https://\:github\:.com/\:jrfonseca/\:gprof2dot>\& است. این ابزار می‌تواند یک فایل \fB\&.dot\fP از آمارهای پروفایل‌گیری ایجادشده توسط \fBcProfile\fP و \fBpstats\fP بسازد. سپس می‌توانید فایل \fB\&.dot\fP را با یکی از چندین مبدل موجود به‌صورت آنلاین، به یک فایل \fB\&.png\fP تبدیل کنید.
.sp
می‌توانید مستندات gprof2dot \%<https://\:github\:.com/\:jrfonseca/\:gprof2dot> را برای دستورالعمل‌های نصب متناسب با محیط خاص خود مطالعه کنید.
.sp
گزینه دیگر snakeviz \%<https://\:jiffyclub\:.github\:.io/\:snakeviz>\& خواهد بود.
.SS یکپارچه‌سازی با OSS\-Fuzz
.SS نمای کلی پلتفرم
.sp
سرویس OSS\-Fuzz \%<https://\:google\:.github\:.io/\:oss-fuzz> پلتفرم فازینگ رایگان گوگل برای نرم‌افزارهای متن‌باز است. این ابزار هدف‌های فازینگ astroid را اجرا می‌کند تا به شناسایی مشکلات پایداری که می‌توانند astroid و Pylint را تحت تأثیر قرار دهند کمک کند.
.sp
گوگل گزارش‌های ساخت عمومی \%<https://\:oss-fuzz-build-logs\:.storage\:.googleapis\:.com/\:index\:.html#\:astroid> و آمارهای فازینگ \%<https://\:introspector\:.oss-fuzz\:.com/\:project-profile?\:project=astroid> را ارائه می‌دهد، اما بیشتر جزئیات مربوط به گزارش‌های باگ و موارد آزمون فازینگ‌شده نیازمند دسترسی تأییدشده هستند.
.SS دریافت دسترسی
.sp
فایل‌های پیکربندی یکپارچه‌سازی با OSS\-Fuzz را می‌توان در مخزن OSS\-Fuzz \%<https://\:github\:.com/\:google/\:oss-fuzz/\:tree/\:master/\:projects/\:astroid>\& پیدا کرد. فایل \fBproject.yaml\fP تعیین می‌کند چه کسانی به گزارش‌های باگ و موارد آزمون دسترسی دارند. اگر مایلید به این فهرست اضافه شوید به نگه‌دارنده‌ها پیام دهید (توجه: برای دسترسی، داشتن یک حساب گوگل الزامی است).
.SS پیشرفت فازینگ
.sp
پس از دریافت دسترسی به OSS\-Fuzz، می‌توانید با حساب گوگل خود به \%<https://\:oss-fuzz\:.com> وارد شوید تا داشبورد پیشرفت فازینگ astroid را مشاهده کنید.
.SS موارد آزمون
.sp
این داشبورد حاوی پیوندی به صفحه موارد آزمون \%<https://\:oss-fuzz\:.com/\:testcases?\:project=astroid&\:open=yes> است که تمام مواردی را که در حال حاضر باعث بروز باگ در astroid می‌شوند فهرست می‌کند.
.sp
هر مورد آزمون دارای صفحه‌ای اختصاصی با پیوندهایی برای مشاهده و بارگیری مورد آزمون کمینه‌شده جهت بازتولید شکست است. هر صفحه مورد آزمون همچنین حاوی یک stacktrace برای شکست رخ‌داده و آماری در مورد میزان تکرار مواجهه با آن شکست در حین فازینگ است.
.SS بازتولید یک شکست
.sp
شما می‌توانید یک مورد آزمون کمینه‌شده را دریافت کرده و آن را به‌صورت محلی اجرا کنید تا یک شکست را روی سیستم خود اشکال‌زدایی نمایید. برای مثال، برای بازتولید یک شکست با هدف فازینگ \fBfuzz_parse\fP، می‌توانید دستورهای زیر را اجرا کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
mkdir fuzzing\-repro
cd fuzzing\-repro

# Note: Atheris doesn\(aqt support Python 3.12+ yet:
# https://github.com/google/atheris/issues/82
uv venv \-\-python 3.11
source .venv/bin/activate

git clone https://github.com/pylint\-dev/astroid.git
cd astroid

uv pip install atheris==2.3.0
uv pip install \-\-editable .

# Save the minimized testcase as \(gaminimized.py\(ga in the astroid directory

cat << EOF > ./run_fuzz_parse.py

import astroid
import atheris

with open(\(aqminimized.py\(aq, \(aqrb\(aq) as f:
    fdp = atheris.FuzzedDataProvider(f.read())

code = fdp.ConsumeUnicodeNoSurrogates(fdp.ConsumeIntInRange(0, 4096))
astroid.builder.parse(code)
EOF

python ./run_fuzz_parse.py
.EE
.UNINDENT
.UNINDENT
.sp
اگر شکست به‌صورت محلی بازتولید نشد، می‌توانید بازتولید مشکل را درون یک کانتینر OSS\-Fuzz امتحان کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
git clone https://github.com/google/oss\-fuzz.git
cd oss\-fuzz

python infra/helper.py build_image astroid
python infra/helper.py build_fuzzers astroid
python infra/helper.py reproduce astroid fuzz_parse minimized.py
.EE
.UNINDENT
.UNINDENT
.sp
برخی از شکست‌ها ممکن است به دلیل تفاوت در نسخه‌های پایتون بین پلتفرم OSS\-Fuzz و محیط محلی شما، تنها در یک کانتینر OSS\-Fuzz قابل بازتولید باشند..SS "پوشش کد (Code coverage)"
.sp
داشبورد همچنین به داده‌های پوشش کد برای اهداف فازینگ (fuzz targets) منفرد و داده‌های ترکیبی پوشش
کد برای تمام اهداف پیوند دارد (برای مشاهدهٔ داده‌های ترکیبی روی پیوند \(dqTOTAL COVERAGE\(dq کلیک کنید).
.sp
داده‌های پوشش ترکیبی برای شناسایی شکاف‌های پوشش، داده‌های ناکافی مجموعه‌داده (corpus) و
نامزدهای بالقوه برای اهداف فازینگ آینده مفید است.
.SS "گزارش باگ‌ها (Bug reports)"
.sp
گزارش‌های باگ برای خرابی‌های جدید به‌طور خودکار در ردیاب باگ OSS\-Fuzz با
برچسب astroid ثبت می‌شوند \%<https://\:issues\:.oss-fuzz\:.com/\:issues?\:q=project:astroid%20status:open>\&.
اطمینان حاصل کنید که برای مشاهدهٔ تمام مسائل (issues) موجود، وارد سیستم شده‌اید.
.SS "نگهداری ساخت (Build maintenance)"
.sp
گوگل اهداف فازینگ کامپایل‌شده را روی ماشین‌های مجازی Google Compute Engine اجرا می‌کند. این معماری نیازمند این است که هر
پروژه یک \fBDockerfile\fP و اسکریپت \fBbuild.sh\fP برای دانلود کد، پیکربندی
وابستگی‌ها، کامپایل اهداف فازینگ و بسته‌بندی فایل‌های corpus ارائه دهد.
.sp
فایل‌های ساخت و کد اهداف فازینگ مربوط به astroid را می‌توان در
مخزن OSS\-Fuzz یافت \%<https://\:github\:.com/\:google/\:oss-fuzz/\:blob/\:master/\:projects/\:astroid>\&.
.sp
اگر وابستگی‌ها تغییر کنند یا اهداف فازینگ جدیدی اضافه شوند، ممکن است لازم باشد فایل‌های ساخت را تغییر دهید
و یک ایمیج Docker جدید برای OSS\-Fuzz بسازید.
.SS "ساخت یک ایمیج (Building an image)"
.sp
دستورهای زیر را برای ساخت ایمیج OSS\-Fuzz و اهداف فازینگ astroid اجرا کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
git clone https://github.com/google/oss\-fuzz.git
cd oss\-fuzz

python infra/helper.py build_image astroid
python infra/helper.py build_fuzzers astroid
.EE
.UNINDENT
.UNINDENT
.sp
هرگونه تغییری که در فایل‌های ساخت ایجاد می‌کنید باید در قالب pull request به مخزن OSS\-Fuzz ارسال شود.
.SS "اشکال‌زدایی شکست‌های ساخت (Debugging build failures)"
.sp
می‌توانید شکست‌های ساخت در مرحلهٔ \fBbuild_fuzzers\fP را با ایجاد یک کانتینر و
اجرای دستی دستور \fBcompile\fP اشکال‌زدایی کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
# Create a container for building fuzz targets
python infra/helper.py shell astroid

# Run this command inside the container to build the fuzz targets
compile
.EE
.UNINDENT
.UNINDENT
.sp
اسکریپت \fBbuild.sh\fP در مسیر \fB/src/build.sh\fP داخل کانتینر قرار خواهد داشت.
.SS "پیوندهای سریع (Quick links)"
.INDENT 0.0
.IP \(bu 2
داشبورد OSS\-Fuzz \%<https://\:oss-fuzz\:.com>
.IP \(bu 2
فایل‌های پیکربندی، اسکریپت‌های ساخت و اهداف فازینگ OSS\-Fuzz برای astroid \%<https://\:github\:.com/\:google/\:oss-fuzz/\:tree/\:master/\:projects/\:astroid>
.IP \(bu 2
تمام باگ‌های باز OSS\-Fuzz برای astroid \%<https://\:issues\:.oss-fuzz\:.com/\:issues?\:q=project:astroid%20status:open>
.IP \(bu 2
مستندات OSS\-Fuzz گوگل \%<https://\:google\:.github\:.io/\:oss-fuzz>
.UNINDENT
.SS "انتشار یک نسخه pylint (Releasing a pylint version)"
.sp
خب، می‌خواهید نسخهٔ \fBX.Y.Z\fP از pylint را منتشر کنید؟
.SS "انتشار یک نسخه اصلی یا فرعی (Releasing a major or minor version)"
.sp
\fBپیش از انتشار یک نسخه اصلی یا فرعی، بررسی کنید آیا کامیت‌های
منتشرنشده‌ای در شاخهٔ نگهداری (maintenance) وجود دارد یا خیر. اگر چنین است، ابتدا یک آخرین
نسخهٔ وصله (patch) را منتشر کنید. ببینید: \(ga\(gaReleasing a patch version\(ga\(ga.\fP
.INDENT 0.0
.IP \(bu 2
بخش \fBSummary \-\- Release highlights\fP را در \fBdoc/whatsnew\fP بنویسید و
تاریخ انتشار را ارتقا دهید.
.IP \(bu 2
وابستگی‌های انتشار را نصب کنید:
\fBpip3 install \-r requirements_test.txt\fP\&. این دستور نسخهٔ دقیق
\fBastroid\fP مورد استفاده توسط CI را تثبیت می‌کند (به \fBrequirements_test_min.txt\fP مراجعه کنید).
پیش از اجرای \fBtbump\fP اطمینان حاصل کنید که همین نسخهٔ تثبیت‌شده نصب است:
یک نسخهٔ متفاوت از \fBastroid\fP خروجی متفاوتی در آزمون‌های عملکردی تولید می‌کند
که سپس در انتشار ثبت (commit) شده و CI را از کار می‌اندازد.
.IP \(bu 2
نسخه را ارتقا داده و با استفاده از دستور زیر منتشر کنید:
\fBtbump X.Y.0 \-\-no\-push \-\-no\-tag\fP\&. (به عنوان مثال:
\fBtbump 2.4.0 \-\-no\-push \-\-no\-tag\fP)
.IP \(bu 2
کامیت ایجادشده را با \fBgit show\fP بررسی کرده و در صورت نیاز
آن را اصلاح (amend) کنید.
.IP \(bu 2
شاخهٔ \fBmain\fP را با \fBtbump\fP به یک نسخهٔ توسعه (dev) انتقال دهید:
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.sp
.EX
tbump X.Y+1.0\-dev0 \-\-no\-tag \-\-no\-push  # You can interrupt after the first step
git commit \-am \(dqUpgrade the version to x.y+1.0\-dev0 following x.y.0 release\(dq
.EE
.UNINDENT
.UNINDENT
.sp
به عنوان مثال:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
tbump 2.5.0\-dev0 \-\-no\-tag \-\-no\-push
git commit \-am \(dqUpgrade the version to 2.5.0\-dev0 following 2.4.0 release\(dq
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
دستور tbump یک سند جدید \fBWhat\(aqs new in Pylint X.Y+1\fP ایجاد خواهد کرد.
آن را به \fBdoc/whatsnew/3/index.rst\fP اضافه کنید. نگاهی به مثال‌های موجود در \fBdoc/whatsnew\fP بیندازید.
آن را با \fBgit commit \-a \-\-amend\fP ثبت (commit) کنید.
.IP \(bu 2
به یک شاخهٔ انتشار push کنید.
.IP \(bu 2
یک درخواست ادغام (merge request) با دو کامیت باز کنید (هیچ‌کس نمی‌تواند مستقیماً روی
\fBmain\fP ارسال (push) انجام دهد)
.IP \(bu 2
پس از ادغام، کامیت‌های ادغام‌شده را روی \fBmain\fP دریافت کرده و اولین کامیت را
(نسخه باید \fBX.Y.Z\fP باشد) به عنوان \fBvX.Y.Z\fP برچسب‌گذاری (tag) کنید (برای
مثال: \fBv2.4.0\fP)
.IP \(bu 2
تگ را push کنید.
.IP \(bu 2
نسخه را در GitHub با همان نام تگ منتشر کنید و لاگ تغییرات (changelog) مناسب را
در توضیحات کپی و جای‌گذاری نمایید. این کار انتشار PyPI را راه‌اندازی (trigger) می‌کند.
.IP \(bu 2
یک شاخهٔ \fBmaintenance/X.Y.x\fP ایجاد کنید (برای مثال: \fBmaintenance/2.4.x\fP
از تگ \fBv2.4.0\fP).
.IP \(bu 2
الگوی شاخه‌های محافظت‌شده را در تنظیمات زیر
\fBBranches\fP / \fBBranch protection rules\fP به‌روز کنید. (برای مثال:
\fBmaintenance/2.4*\fP به جای \fBmaintenance/2.3*\fP\&). پیکربندی‌های زیادی در این
تنظیمات انجام شده است، آن‌ها را از ابتدا دوباره ایجاد نکنید.
.IP \(bu 2
شاخهٔ \fBmaintenance/X.Y\-1.x\fP را حذف کنید. (برای مثال:
\fBmaintenance/2.3.x\fP)
.IP \(bu 2
تمام مسائل (issues) \fIبسته‌شدهٔ\fP دارای برچسب \fBbackport maintenance/X.Y\-1.x\fP را انتخاب
کرده و به آن‌ها برچسب \fBbackported\fP بزنید، سپس برچسب
\fBbackport maintenance/X.Y\-1.x\fP را به
\fBbackport maintenance/X.Y.x\fP تغییر نام دهید (برای مثال تغییر نام
\fBbackport maintenance/2.3.x\fP به \fBbackport maintenance/2.4.x\fP)
.IP \(bu 2
نقطهٔ عطف (milestone) فعلی را ببندید و موارد جدید را ایجاد کنید (برای مثال:
بستن \fB2.4.0\fP، ایجاد \fB2.4.1\fP و \fB2.6.0\fP)
.IP \(bu 2
تمام نسخه‌های وصله را برای انتشار فرعی پیشین در
readthedocs \%<https://\:readthedocs\:.org/\:projects/\:pylint/\:versions>
به جز آخرین مورد پنهان و غیرفعال کنید. (برای مثال: پنهان کردن \fBv2.4.0\fP، \fBv2.4.1\fP،
\fBv2.4.2\fP و تنها نگه‌داشتن \fBv2.4.3\fP)
.UNINDENT.SS بک‌پورت کردن یک اصلاح از \fBmain\fP به شاخه نگهداری (maintenance)
.sp
هر زمان که یک PR روی \fBmain\fP باید در یک انتشار وصله (patch release) روی
شاخه نگهداری کنونی منتشر شود:
.INDENT 0.0
.IP \(bu 2
به PR برچسب \fBbackport maintenance/X.Y\-1.x\fP بزنید\&. (برای مثال
\fBbackport maintenance/2.3.x\fP)
.IP \(bu 2
پیش از ادغام، PR را squash کنید (یا در صورتی که فقط یک کامیت وجود دارد، rebase کنید)
.IP \(bu 2
(اگر cherry\-pick خودکار دارای تداخل بود)
.INDENT 2.0
.IP \(bu 2
برچسب \fBNeeds backport\fP را اضافه کرده و آن را دستی انجام دهید.
.IP \(bu 2
همچنین می‌توانید به عنوان گزینه جایگزین:
.INDENT 2.0
.IP \(bu 2
پیش از انجام دستی cherry\-pick مربوط به PR اصلی، تغییراتی را که موجب تداخل
شده‌اند (در صورتی که ویژگی جدیدی نیستند) cherry\-pick کنید.
.IP \(bu 2
تصمیم بگیرید که برای انتشار PR تا نسخه فرعی (minor) بعدی صبر کنید
.IP \(bu 2
در هر صورت، milestoneهای PR اصلی و PR تازه cherry\-pick شده را متناسب با واقعیت به‌روزرسانی کنید.
.UNINDENT
.UNINDENT
.IP \(bu 2
یک نسخه وصله (patch version) منتشر کنید
.UNINDENT
.SS انتشار یک نسخه وصله (patch version)
.sp
زمانی نسخه‌های وصله را منتشر می‌کنیم که یک خرابی (crash) یا باگ در شاخه اصلی برطرف شده
و به شاخه نگهداری cherry\-pick شده باشد.
.INDENT 0.0
.IP \(bu 2
وابستگی‌های انتشار را نصب کنید:
\fBpip3 install \-r requirements_test.txt\fP\&. این کار دقیقاً نسخه
\fBastroid\fP مورد استفاده توسط CI را تثبیت (pin) می‌کند (نگاه کنید به \fBrequirements_test_min.txt\fP).
پیش از اجرای \fBtbump\fP مطمئن شوید این نسخه تثبیت‌شده همان نسخه‌ای است که نصب شده:
یک نسخه متفاوت از \fBastroid\fP خروجی‌های متفاوتی در آزمون‌های کارکردی تولید می‌کند
که سپس در انتشار کامیت شده و CI را دچار شکست می‌کند.
.IP \(bu 2
نسخه را با استفاده از \fBtbump X.Y\-1.Z \-\-no\-push\fP ارتقا داده و منتشر کنید\&.
(برای مثال: \fBtbump 2.3.5 \-\-no\-push\fP)
.IP \(bu 2
نتیجه را به صورت بصری با \fBgit show\fP بررسی کنید\&.
.IP \(bu 2
یک درخواست ادغام از \fBrelease\-X.Y\-1.Z\(aq\fP در \fBmaintenance/X.Y.x\fP
(برای مثال: \fBrelease\-2.3.5\-branch\fP در \fBmaintenance/2.3.x\fP) باز کنید تا
آزمون‌های CI برای این شاخه اجرا شوند.
.IP \(bu 2
تگ را ایجاد کرده و push کنید.
.IP \(bu 2
نسخه را با همان نام تگ در GitHub منتشر کرده و changelog را از مستندات
تولیدشده توسط ReadtheDoc از پایپ‌لاین pull request در توضیحات کپی و جای‌گذاری کنید.
این کار انتشار PyPI را آغاز می‌کند.
.IP \(bu 2
شاخه \fBmaintenance/X.Y.x\fP را روی شاخه اصلی ادغام کنید. شاخه اصلی
باید حاوی changelog برای \fBX.Y\-1.Z+1\fP باشد (برای مثال
\fBv2.3.6\fP). این ادغام لازم است تا \fBpre\-commit autoupdate\fP
برای pylint کار کند.
.IP \(bu 2
تداخل‌های نسخه را به درستی برطرف کنید، یا پیش از push کردن روی شاخه اصلی، نسخه را به \fBX.Y.0\-devZ\fP
(برای مثال: \fB2.4.0\-dev6\fP) ارتقا دهید
.IP \(bu 2
نقطه عطف (milestone) کنونی را ببندید و یک مورد جدید ایجاد کنید (برای مثال:
بستن \fB2.3.5\fP، ایجاد \fB2.3.6\fP)
.UNINDENT
.SS مدیریت milestoneها
.sp
مواردی (issues) را که انجام نشده‌اند به milestone بعدی منتقل می‌کنیم و تنها در صورتی
انتشار را متوقف (block) می‌کنیم که issueهای بازی با برچسب \fBblocker\fP وجود داشته باشند\&.
.SS راهبری (Governance)
.SS چگونه بخشی از پروژه شویم؟
.SS چگونه یک مشارکت‌کننده شویم؟
.INDENT 0.0
.IP \(bu 2
منشور اخلاقی را رعایت کنید
.IP \(bu 2
پیش از درخواست کمک، خودتان جستجو کنید
.IP \(bu 2
یک issue باز کنید
.IP \(bu 2
یک issue را بررسی کرده و یافته‌های خود را گزارش دهید
.IP \(bu 2
اگر احساس می‌کنید تغییری مورد توافق همگان است، مستقیماً یک درخواست ادغام باز کنید
.UNINDENT
.sp
گزارش دادن یک باگ، خود به تنهایی به معنای مشارکت‌کننده بودن است..SS چگونه یک triager شویم؟
.INDENT 0.0
.IP \(bu 2
یک افزونه pylint ایجاد کنید، سپس آن را به سازمان گیت‌هاب \(aqpylint\-dev\(aq انتقال دهید.
.UNINDENT
.sp
یا:
.INDENT 0.0
.IP \(bu 2
در بیش از ۳ انتشار به‌طور مستمر مشارکت داشته باشید.
.IP \(bu 2
بیش از حد متعصب نباشید، از مرام‌نامه اخلاقی (code of conduct) بدون تحمیل بار روانی بر نگهدارندگان پیروی کنید. این بدان معنا نیست که اختلاف‌نظر ناممکن است، بلکه صرفاً استدلال‌ها باید فنی و منطقی باقی بمانند تا گفتگو محترمانه و سازنده باشد.
.IP \(bu 2
یکی از نگهدارندگان بدون آنکه خودتان درخواست کرده باشید، پیشنهاد دهد که triager شوید
.IP \(bu 2
تأیید به اتفاق آرا یا موافقت خنثی (بدون مخالفت) را از نگهدارندگان فعلی به دست آورید.
.UNINDENT
.SS چگونه یک نگهدارنده (maintainer) شویم؟
.INDENT 0.0
.IP \(bu 2
مسئولیت بخشی از کد را بر عهده بگیرید که در حال حاضر به خوبی نگهداری نمی‌شود یا خودتان شخصاً در آن مشارکت داشته‌اید (اگر احساس کنیم نمی‌توانیم چیزی را بدون بازبینی شما ادغام کنیم، به‌زودی قادر خواهید بود خودتان آن‌ها را ادغام کنید).
.UNINDENT
.sp
یا:
.INDENT 0.0
.IP \(bu 2
دو درخواست ادغام (merge request) بزرگِ کد را در طول چندین انتشار ارائه دهید (برای مثال یک checker در نسخه 2.13 و باگ متعاقب آن پس از انتشار، و یک رفع باگ پیچیده در 2.14). در غیر این صورت، مشارکت مستمر در بیش از ۳ انتشار همراه با مهارت‌های فنی و فردی عالی.
.IP \(bu 2
ارزیابی گزارش‌ها (triage) به مدت چندین ماه (بستن موارد تکراری، مرتب‌سازی مسائل، پاسخ به پرسش‌ها...).
.IP \(bu 2
یکی از مدیران (admin) بدون آنکه خودتان درخواست کرده باشید، پیشنهاد دهد که maintainer شوید
.IP \(bu 2
تأیید به اتفاق آرا یا موافقت خنثی را از نگهدارندگان فعلی به دست آورید.
.UNINDENT
.SS چگونه یک مدیر (admin) شویم؟
.INDENT 0.0
.IP \(bu 2
با چندصد کامیت در یک دوره زمانی طولانی همراه با مهارت‌های ارتباطی عالی و کیفیت کد بالا مشارکت کنید.
.IP \(bu 2
نگهداری از pylint به مدت چندین سال (بازبینی کد، تریاژ و وظایف نگهداری).
.IP \(bu 2
در این مقطع، احتمالاً باید مدیر دیگری پروژه را ترک کرده باشد یا برای سال‌ها غیرفعال شده باشد.
.IP \(bu 2
یکی از مدیران بدون آنکه خودتان درخواست کرده باشید، پیشنهاد دهد که admin شوید.
.IP \(bu 2
تأیید به اتفاق آرا یا موافقت خنثی را از مدیران فعلی به دست آورید.
.UNINDENT
.SS تصمیم‌گیری‌ها چگونه انجام می‌شوند؟
.sp
از همگان انتظار می‌رود از مرام‌نامه اخلاقی پیروی کنند. pylint یک عمل‌سالاری (do\-ocracy) / مردم‌سالاری است.
شما مجاز نیستید به صرف مشارکت زیاد، رفتار نامناسبی داشته باشید. اما اگر قرار نیست در آینده کارهای نگهداری را انجام دهید، ممکن است نظرات معتبر شما توسط کسانی که تحت تأثیر آن قرار می‌گیرند در نظر گرفته نشود.
.SS اصول بنیادین توسعه pylint چیستند؟
.sp
عمومی:
.INDENT 0.0
.IP \(bu 2
ما درستی (صحت) را بر عملکرد ترجیح می‌دهیم، زیرا pylint در وهله اول به‌خاطر عملکردش استفاده نمی‌شود. کارایی همچنان مهم است و باید از همان آغاز مد نظر قرار گیرد.
.IP \(bu 2
سپس اگر دستیابی به درستی ناممکن باشد، منفی‌های کاذب را بر مثبت‌های کاذب ترجیح می‌دهیم.
.IP \(bu 2
ما تلاش می‌کنیم پیکربندی را معقول نگه داریم، اما اگر نیاز به اتخاذ تصمیم دشواری باشد، یک گزینه اضافه می‌کنیم تا pylint (پس از پیکربندی) با شرایط گوناگون سازگار شود (multiple sizes fit all).
.UNINDENT
.sp
مکان افزودن یک checker یا پیام جدید:
.INDENT 0.0
.IP \(bu 2
پیام‌های خطا (مواردی که در صورت اجرا منجر به خطا خواهند شد) باید بررسی‌های توکار (builtin) باشند که به‌طور پیش‌فرض فعال هستند
.IP \(bu 2
پیام‌هایی که حتی اندکی سلیقه‌ای (opinionated) هستند، باید اختیاری (opt\-in) باشند (به عنوان افزونه اضافه شوند \%<#\:plugins>)
.IP \(bu 2
ما از بررسی‌های سلیقه‌ای (مانند while checker) رویگردان نیستیم، اما چیزی به نام «بیش از حد سلیقه‌ای» وجود دارد؛ اگر چیزی بیش از حد سلیقه‌ای باشد باید یک افزونه خارجی pylint باشد \%<#\:plugins>\&.
.UNINDENT.SS اختلافات چگونه مدیریت می‌شوند؟
.sp
هنگامی که درباره موضوعی توافق نظر وجود نداشته باشد، کاربران، نگه‌دارندگان و مدیران تا رسیدن به توافق گفتگو می‌کنند.
.sp
بسته به دشواری گفتگو و اهمیت تصمیم‌گیری سریع، تصمیم می‌تواند به روش‌های زیر اتخاذ شود:
.INDENT 0.0
.IP \(bu 2
به‌صورت متفق‌القول میان شرکت‌کنندگان در گفتگو، مشارکت‌کنندگان و نگه‌دارندگان (ترجیحاً)
.IP \(bu 2
با نظرسنجی از شرکت‌کنندگان در گفتگو با استفاده از ایموجی در issue و سپس اعمال نظر اکثریت، در صورتی که هیچ نگه‌دارنده‌ای نظر سرسختانه‌ای در مورد موضوع نداشته باشد.
.IP \(bu 2
با نظر اکثریت مدیران، در صورتی که هیچ مدیری نظر سرسختانه‌ای در مورد موضوع نداشته باشد.
.IP \(bu 2
با نظرسنجی از همه کاربران در یک issue جدید که برای چندین ماه سنجاق (pin) خواهد شد، پیش از تصمیم‌گیری، در صورتی که دو مدیر نظرات متضاد و سرسختانه‌ای نسبت به موضوع داشته باشند. هنگامی که نتیجه مشخص شد، تصمیم اکثریت دیگر جای بحث نخواهد داشت.
.UNINDENT
.SS Pyreverse
.sp
\fBpyreverse\fP ابزاری قدرتمند است که از کدهای Python شما نمودارهای UML ایجاد می‌کند. این ابزار به شما در مصورسازی موارد زیر کمک می‌کند:
.INDENT 0.0
.IP \(bu 2
وابستگی‌ها و ساختار بسته‌ها
.IP \(bu 2
سلسله‌مراتب و روابط کلاس‌ها
.IP \(bu 2
سازمان‌دهی متدها و خصوصیات
.UNINDENT
.SS قالب‌های خروجی
.sp
\fBpyreverse\fP از چندین قالب خروجی پشتیبانی می‌کند:
.INDENT 0.0
.IP \(bu 2
.INDENT 2.0
.TP
.B قالب‌های بومی (Native):
.INDENT 7.0
.IP \(bu 2
\fB\&.dot\fP/\fB\&.gv\fP (Graphviz)
.IP \(bu 2
\fB\&.puml\fP/\fB\&.plantuml\fP (PlantUML)
.IP \(bu 2
\fB\&.mmd\fP/\fB\&.html\fP (MermaidJS)
.UNINDENT
.UNINDENT
.IP \(bu 2
.INDENT 2.0
.TP
.B قالب‌های اضافی (نیازمند نصب Graphviz):
.INDENT 7.0
.IP \(bu 2
تمامی قالب‌های خروجی Graphviz در \%<https://\:graphviz\:.org/\:docs/\:outputs> (مانند PNG، SVG، PDF و غیره)
.IP \(bu 2
\fBpyreverse\fP ابتدا یک فایل موقت \fB\&.gv\fP ایجاد می‌کند که سپس برای تولید تصویر نهایی به Graphviz ارسال می‌شود
.UNINDENT
.UNINDENT
.UNINDENT
.SS شروع به کار
.sp
راهنمای Usage \%<> را برای آگاهی از گزینه‌های موجود بررسی کنید، یا به Example Output \%<> برای مشاهده نمودارهای نمونه و موارد استفاده معمول مراجعه نمایید.
.SS نحوه استفاده
.sp
دستور \fBpyreverse\fP از طریق خط فرمان با نحو (syntax) زیر اجرا می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pyreverse [options] <packages>
.EE
.UNINDENT
.UNINDENT
.sp
که در آن \fB<packages>\fP یک یا چند بسته یا ماژول Python برای تحلیل است.
.sp
گزینه‌های موجود در دسته‌بندی‌های زیر سازمان‌دهی شده‌اند:
.INDENT 0.0
.IP \(bu 2
فیلترسازی و محدوده \- کنترل این‌که کدام کلاس‌ها و روابط در نمودارهای شما ظاهر شوند
.IP \(bu 2
گزینه‌های نمایش \- سفارشی‌سازی ظاهر بصری شامل رنگ‌ها و برچسب‌ها
.IP \(bu 2
کنترل خروجی \- انتخاب قالب‌های خروجی و تنظیم دایرکتوری مقصد
.IP \(bu 2
پیکربندی پروژه \- تعیین تنظیمات پروژه مانند ریشه‌های سورس و فایل‌های نادیده‌گرفته‌شده
.UNINDENT.SS فیلترسازی و دامنه (Filtering and Scope)
.SS \-\-all\-ancestors
.sp
\fIنمایش تمام نیاکان (اجداد) همهٔ کلاس‌ها در <projects>.\fP
.sp
\fBپیش‌فرض:\fP  \fBNone\fP
.SS \-\-all\-associated
.sp
\fIنمایش تمام کلاس‌های مرتبط با کلاس‌های هدف، شامل وابستگی‌های غیرمستقیم.\fP
.sp
\fBپیش‌فرض:\fP  \fBNone\fP
.SS \-\-class
.sp
\fIایجاد یک نمودار کلاس با تمام کلاس‌های مرتبط با <class>؛ این گزینه به‌طور پیش‌فرض از گزینه‌های \-ASmy استفاده می‌کند.\fP
.sp
\fBپیش‌فرض:\fP  \fBNone\fP
.SS \-\-filter\-mode
.sp
\fIفیلتر کردن ویژگی‌ها و توابع مطابق با <mode>. حالت‌های معتبر عبارتند از:
\(aqPUB_ONLY\(aq فیلتر کردن تمام ویژگی‌های غیرعمومی [پیش‌فرض]، معادل PRIVATE+SPECIAL
\(aqALL\(aq بدون فیلتر
\(aqSPECIAL\(aq فیلتر کردن توابع خاص پایتون به جز سازنده (constructor)
\(aqOTHER\(aq فیلتر کردن ویژگی‌های محافظت‌شده و خصوصی\fP
.sp
\fBپیش‌فرض:\fP  \fBPUB_ONLY\fP
.SS \-\-max\-depth
.sp
\fIحداکثر عمق بسته‌ها/پیمانه‌ها برای گنجاندن در نمودار، نسبت به عمیق‌ترین بستهٔ مشخص‌شده. عمق ۰ تنها بسته‌ها/پیمانه‌های مشخص‌شده را نشان می‌دهد، در حالی که ۱ فرزندان بی‌واسطهٔ آن‌ها را در بر می‌گیرد و به همین ترتیب. هنگام مشخص کردن بسته‌های تو در تو، عمق از عمیق‌ترین سطح بسته محاسبه می‌شود. در صورت عدم تعیین، تمام بسته‌ها/پیمانه‌ها در سلسله‌مراتب نمایش داده می‌شوند.\fP
.sp
\fBپیش‌فرض:\fP  \fBNone\fP
.SS \-\-show\-ancestors
.sp
\fIنمایش <ancestor> نسل از کلاس‌های نیا که در <projects> نیستند.\fP
.sp
\fBپیش‌فرض:\fP  \fBNone\fP
.SS \-\-show\-associated
.sp
\fIنمایش <association_level> سطح از کلاس‌های مرتبط که در <projects> نیستند.\fP
.sp
\fBپیش‌فرض:\fP  \fBNone\fP
.SS \-\-show\-builtin
.sp
\fIگنجاندن اشیاء توکار (builtin) در نمایش کلاس‌ها.\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP
.SS \-\-show\-stdlib
.sp
\fIگنجاندن اشیاء کتابخانهٔ استاندارد در نمایش کلاس‌ها.\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP
.SS گزینه‌های نمایش (Display Options)
.SS \-\-color\-palette
.sp
\fIفهرستی از رنگ‌ها جداشده با ویرگول برای رنگ‌آمیزی بر اساس عمق بسته.\fP
.sp
\fBپیش‌فرض:\fP  \fB(\(aq#77AADD\(aq, \(aq#99DDFF\(aq, \(aq#44BB99\(aq, \(aq#BBCC33\(aq, \(aq#AAAA00\(aq, \(aq#EEDD88\(aq, \(aq#EE8866\(aq, \(aq#FFAABB\(aq, \(aq#DDDDDD\(aq)\fP
.SS \-\-colorized
.sp
\fIاستفاده از خروجی رنگی. کلاس‌ها/پیمانه‌های متعلق به یک بسته رنگ یکسانی دریافت می‌کنند.\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP
.SS \-\-max\-color\-depth
.sp
\fIاستفاده از رنگ‌های جداگانه تا عمق بستهٔ <depth>. در اعماق بیشتر مجدداً از رنگ‌ها استفاده خواهد شد.\fP
.sp
\fBپیش‌فرض:\fP  \fB2\fP
.SS \-\-module\-names
.sp
\fIگنجاندن نام پیمانه در نمایش کلاس‌ها.\fP
.sp
\fBپیش‌فرض:\fP  \fBNone\fP
.SS \-\-no\-standalone
.sp
\fIتنها نمایش گره‌های دارای اتصال.\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP
.SS \-\-only\-classnames
.sp
\fIعدم نمایش ویژگی‌ها و متدها در کادرهای کلاس؛ این گزینه مقادیر \-f را غیرفعال می‌کند.\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP.SS کنترل خروجی (Output Control)
.SS \-\-output
.sp
\fIدر صورت در دسترس بودن قالب، یک فایل خروجی *.<format> ایجاد می‌کند. قالب‌های در دسترس عبارتند از: .dot، .puml، .plantuml، .mmd، .html. برای هر قالب دیگری تلاش می‌شود با استفاده از ابزار خط فرمان \(aqdot\(aq ایجاد گردد، که نیازمند نصب graphviz است. در این حالت، این قالب‌های اضافی در دسترس خواهند بود (ببینید: \(gaقالب‌های خروجی Graphviz <https://graphviz.org/docs/outputs>\(ga_).\fP
.sp
\fBپیش‌فرض:\fP  \fBdot\fP
.SS \-\-output\-directory
.sp
\fIمسیر دایرکتوری خروجی را تنظیم می‌کند.\fP
.sp
\fBپیش‌فرض:\fP \fB\(dq\(dq\fP
.SS پیکربندی پروژه (Project Configuration)
.SS \-\-ignore
.sp
\fIفایل‌ها یا دایرکتوری‌هایی که باید نادیده گرفته شوند. این موارد باید نام پایه باشند، نه مسیر.\fP
.sp
\fBپیش‌فرض:\fP  \fB(\(aqCVS\(aq,)\fP
.SS \-\-project
.sp
\fIنام پروژه را تعیین می‌کند. این نام بعداً به انتهای نام فایل‌های خروجی افزوده خواهد شد.\fP
.sp
\fBپیش‌فرض:\fP \fB\(dq\(dq\fP
.SS \-\-source\-roots
.sp
\fIمسیرهایی را به فهرست ریشه‌های سورس (source roots) اضافه می‌کند. از الگوهای تطبیق (globbing) پشتیبانی می‌کند. ریشه سورس، یک مسیر مطلق یا مسیری نسبت به دایرکتوری کاری فعلی است که برای تعیین فضای نام بسته برای ماژول‌های مستقر ذیل ریشه سورس به کار می‌رود.\fP
.sp
\fBپیش‌فرض:\fP  \fB()\fP
.SS \-\-verbose
.sp
\fIخروجی pyreverse را پرجزئیات‌تر (verbose) می‌کند. عمدتاً برای اشکال‌زدایی مفید است.\fP
.sp
\fBپیش‌فرض:\fP  \fBFalse\fP
.SS نمونه خروجی (Example Output)
.sp
نمودارهای نمونه تولیدشده با قالب خروجی \fB\&.puml\fP در زیر نشان داده شده‌اند.
.SS نمودار بسته (Package Diagram)
[تصویر: نمودار بسته تولیدشده توسط pyreverse]
[تصویر]
.SS نمودار کلاس (Class Diagram)
[تصویر: نمودار کلاس تولیدشده توسط pyreverse]
[تصویر]
.SS ایجاد نمودار کلاس برای کلاس‌های خاص (Creating Class Diagrams for Specific Classes)
.sp
در بسیاری از موارد، ایجاد یک نمودار واحد که همه کلاس‌های موجود در پروژه را به تصویر بکشد، به نموداری غول‌پیکر و دشوار برای مدیریت منجر می‌شود.
در حالی که محدود کردن مسیر ورودی به یک بسته یا ماژول منفرد می‌تواند تا حد زیادی به کوچک‌تر کردن دامنه کمک کند، گزینه \fB\-c\fP
روش دیگری برای ایجاد نمودار کلاس با تمرکز بر یک کلاس منفرد و وابستگی‌های همکار آن (collaborators) ارائه می‌دهد.
برای مثال، اجرای:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pyreverse \-ASmy \-c pylint.checkers.classes.ClassChecker pylint
.EE
.UNINDENT
.UNINDENT
.sp
نمودارهای کامل کلاس و بسته را برای \fBpylint\fP تولید می‌کند، اما علاوه بر آن فایلی با نام \fBpylint.checkers.classes.ClassChecker.dot\fP را نیز ایجاد خواهد کرد:
[تصویر: نمودار بسته تولیدشده توسط pyreverse]
[تصویر]
.SS Symilar
.sp
اسکریپت کنسولی \fBsymilar\fP بلوک‌های متنی کپی‌پیست‌شده را در مجموعه‌ای از فایل‌ها پیدا می‌کند. این ابزار یک رابط خط فرمان اختصاصی برای بررسی پیام \fBduplicate\-code\fP ارائه می‌دهد.
.sp
می‌توان آن را به این صورت فراخوانی کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
symilar [\-d|\-\-duplicates min_duplicated_lines] [\-i|\-\-ignore\-comments] [\-\-ignore\-docstrings] [\-\-ignore\-imports] [\-\-ignore\-signatures] file1...
.EE
.UNINDENT
.UNINDENT
.sp
تمامی فایل‌هایی که باید بررسی شوند، باید به صورت صریح مشخص گردند، مانند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
symilar foo.py, bar.py, subpackage/spam.py, subpackage/eggs.py
.EE
.UNINDENT
.UNINDENT
.sp
\fBsymilar\fP خروجی‌ای مشابه زیر تولید می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
17 similar lines in 2 files
==tests/data/clientmodule_test.py:3
==tests/data/suppliermodule_test.py:12
  class Ancestor:
      \(dq\(dq\(dq Ancestor method \(dq\(dq\(dq
      cls_member = DoNothing()

      def __init__(self, value):
          local_variable = 0
          self.attr = \(aqthis method shouldn\e\(aqt have a docstring\(aq
          self.__value = value

      def get_value(self):
          \(dq\(dq\(dq nice docstring ;\-) \(dq\(dq\(dq
          return self.__value

      def set_value(self, value):
          self.__value = value
          return \(aqthis method shouldn\e\(aqt have a docstring\(aq
TOTAL lines=58 duplicates=17 percent=29.31
.EE
.UNINDENT
.UNINDENT.SS 4.x
.sp
این فهرست کامل تغییرات در نسخه‌های فرعی pylint 4.x بر اساس دسته‌بندی است.
.SS تازه‌های Pylint 4.0
.sp
:انتشار: 4.0
:تاریخ: 2025\-10\-12
.SS خلاصه \-\- نکات برجسته انتشار
.INDENT 0.0
.IP \(bu 2
اکنون Pylint از Python 3.14 پشتیبانی می‌کند.
.IP \(bu 2
موتور استنتاج Pylint (\fBastroid\fP) اکنون بسیار دقیق‌تر شده و مفهوم بولی ضمنی (implicit booleanness) و عبارت‌های سه‌تایی را درک می‌کند. (با تشکر از @zenlyj!)
.UNINDENT
.sp
این مثال را در نظر بگیرید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
class Result:
    errors: dict | None = None

result = Result()
if result.errors:
    result.errors[field_key]
    # inference engine understands result.errors cannot be None
    # pylint no longer raises unsubscriptable\-object
.EE
.UNINDENT
.UNINDENT
.sp
نسخه مورد نیاز \fBastroid\fP اکنون 4.0.0 است. برای اطلاع از اصلاحات، ویژگی‌ها و بهبودهای عملکردی بیشتر که به pylint مربوط می‌شوند، تغییرات astroid را در
\%<https://\:pylint\:.readthedocs\:.io/\:projects/\:astroid/\:en/\:latest/\:changelog\:.html#\:what-s-new-in-astroid-4-0-0>
ببینید.
.INDENT 0.0
.IP \(bu 2
رسیدگی به \fBinvalid\-name\fP در سطح ماژول ناقص بود. اکنون ثوابت سطح ماژول که مقداردهی مجدد می‌شوند به عنوان متغیر در نظر گرفته شده و به جای \fB\-\-const\-rgx\fP\& با \fB\-\-variable\-rgx\fP بررسی می‌شوند. لیست‌ها، مجموعه‌ها و اشیای سطح ماژول می‌توانند با هر یک از این دو regex تطابق یافته و تأیید شوند.
.UNINDENT
.sp
در اینجا، \fBLIMIT\fP دوباره مقداردهی شده است، بنابراین pylint فقط از \fB\-\-variable\-rgx\fP استفاده می‌کند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
LIMIT = 500  # [invalid\-name]
if sometimes:
    LIMIT = 1  # [invalid\-name]
.EE
.UNINDENT
.UNINDENT
.sp
اگر این وضعیت مطلوب نیست، با استفاده از انتساب \fIانحصاری\fP (exclusive) بازنویسی کنید تا مشخص باشد این مقداردهی تنها یک‌بار انجام می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
if sometimes:
    LIMIT = 1
else:
    LIMIT = 500  # exclusive assignment: uses const regex, no warning
.EE
.UNINDENT
.UNINDENT
.sp
لیست‌ها، مجموعه‌ها و اشیاء حتی در صورت مقداردهی مجدد، همچنان با هر یک از \fBconst\-rgx\fP یا \fBvariable\-rgx\fP پذیرفته می‌شوند، اما دیگر به طور کامل نادیده گرفته نمی‌شوند:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
MY_LIST = []
my_list = []
My_List = []  # [invalid\-name]
.EE
.UNINDENT
.UNINDENT
.sp
به یاد داشته باشید که
عبارات باقاعده \%<https://\:pylint\:.readthedocs\:.io/\:en/\:latest/\:user_guide/\:messages/\:convention/\:invalid-name\:.html>
و
فهرست‌های مجاز \%<https://\:pylint\:.readthedocs\:.io/\:en/\:latest/\:user_guide/\:configuration/\:all-options\:.html#\:good-names>
را مطابق سلیقه خود تنظیم کنید..SS در Pylint 4.0.7 چه مواردی جدید است؟
.sp
تاریخ انتشار: 2026\-08\-09
.SS هشدارهای کاذب برطرف‌شده
.INDENT 0.0
.IP \(bu 2
رفع یک هشدار کاذب برای \fBinvalid\-name\fP هنگامی که به یک متغیر در سطح ماژول، نمونه‌ای از یک زیرکلاس \fBTypedDict\fP انتساب داده می‌شود. چنین نامی یک مقدار است، نه تعریف نوع؛ بنابراین اکنون به جای \fBclass\-rgx\fP در برابر عبارت باقاعدهٔ ثابت یا متغیر بررسی می‌شود\&.
.sp
بسته شدن #11231 (#11231 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11231>)
.UNINDENT
.SS سایر باگ‌های برطرف‌شده
.INDENT 0.0
.IP \(bu 2
رفع یک خرابی در بررسی \fBbad\-open\-mode\fP هنگامی که آرگومان \fBmode\fP در \fBopen\fP برابر با ثابت \fBNotImplemented\fP است (Python >= 3.14)\&.
.sp
بسته شدن #11099 (#11099 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11099>)
.IP \(bu 2
رفع یک خرابی در بررسی‌های \fBnot\-context\-manager\fP و \fBnot\-async\-context\-manager\fP هنگامی که مدیر بافت (context manager) به مقداری بدون نام استنتاج می‌شود، مانند \fBslice\fP بازگردانده‌شده توسط \fBwith slice(...)\fP / \fBasync with slice(...)\fP\&.
.sp
بسته شدن #11102 (#11102 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11102>)
.IP \(bu 2
رفع یک هشدار کاذب برای \fBnested\-min\-max\fP (\fBW3301\fP) هنگامی که فراخوانی درونی \fBmin\fP/\fBmax\fP دارای یک آرگومان کلیدواژه‌ای مانند \fBkey=\fP باشد\&. مسطح‌سازی فراخوانی باعث حذف آرگومان کلیدواژه‌ای و تغییر نتیجه می‌شد، بنابراین فراخوانی‌های تو در تویی که فراخوانی درونی آن‌ها دارای آرگومان کلیدواژه‌ای است دیگر علامت‌گذاری نمی‌شوند\&.
.sp
بسته شدن #11130 (#11130 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11130>)
.IP \(bu 2
رفع یک پیشنهاد نادرست از \fBnested\-min\-max\fP (\fBW3301\fP): هنگام بازنویسی یک \fBmin\fP/\fBmax\fP تو در تو به یک فراخوانی بازشده (splat call)، آرگومان‌های بعد از فراخوانی بازشده به‌صورت ناخواسته حذف می‌شدند و در نتیجه کد پیشنهادی حاصل را تغییر می‌داد\&.
.sp
بسته شدن #11134 (#11134 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11134>)
.IP \(bu 2
رفع یک هشدار کاذب برای \fBtoo\-many\-locals\fP (\fBR0914\fP): پارامترهای نوع PEP 695، یعنی \fBT1\fP و \fBT2\fP در امضای عمومی \fBdef f[T1, T2]\fP، به عنوان متغیرهای محلی شمرده می‌شدند\&. آن‌ها ساختارهای سیستم نوع هستند، نه متغیرهای محلی زمان اجرا، و اکنون از شمارش متغیرهای محلی مستثنی شده‌اند\&.
.sp
بسته شدن #11136 (#11136 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11136>)
.IP \(bu 2
رفع صدور پیشنهاد مخدوش توسط \fIliteral\-comparison\fP (\fIR0123\fP) برای شناسه‌هایی که حاوی \fBis\fP هستند (برای مثال \fBaxis is 5\fP به صورت \fBax== == 5\fP تبدیل می‌شد)\&. پیشنهاد اکنون از عملوندها و عملگر بازسازی می‌شود\&.
.sp
بسته شدن #11146 (#11146 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11146>)
.IP \(bu 2
رفع هشدارهای کاذب در \fIbad\-string\-format\-type\fP (\fIE1307\fP) برای قالب‌بندی‌های معتبر \fB%\fP: اعمال \fB%i\fP/\fB%u\fP روی یک float (هر دو مانند \fB%d\fP برش می‌دهند) و اعمال \fB%a\fP روی هر نوع غیر int (\fB%a\fP مانند \fB%s\fP/\fB%r\fP مستقل از نوع است)\&.
.sp
بسته شدن #11147 (#11147 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11147>)
.IP \(bu 2
رفع یک هشدار کاذب برای useless\-parent\-delegation / W0246 \%<#\:useless-parent-delegation> هنگامی که یک بازنویسی (override) مقدار پیش‌فرض یک پارامتر فقط ترتیبی (positional\-only) را تغییر می‌دهد\&.
.sp
بسته شدن #11148 (#11148 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11148>)
.IP \(bu 2
رفع یک خرابی در \fBcomparison\-with\-callable\fP هنگام مقایسه یک تابع lambda که به عنوان یک مشخصه کلاس (class attribute) منتسب شده است\&.
.sp
بسته شدن #11175 (#11175 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11175>)
.IP \(bu 2
پیام \fBtoo\-many\-lines\fP ممکن بود در خطی گزارش شود که پراگمای \fB# pylint: disable=too\-many\-lines\fP در ماژول تحلیل‌شده قبلی قرار داشت\&. موقعیت پراگماها اکنون بین ماژول‌ها بازنشانی می‌شود، بنابراین پیام صرف‌نظر از اینکه چه فایل‌هایی پیش‌تر تحلیل شده‌اند، در خط ۱ (یا در پراگمای خود ماژول فعلی) گزارش می‌شود\&.
.sp
ارجاع به #11191 (#11191 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11191>)
.IP \(bu 2
رفع یک خرابی هنگامی که یک فراخوانی، دیکشنری‌ای را که کلیدهای آن ثابت‌های رشته‌ای نیستند باز (unpack) می‌کند، مانند \fBcopy.copy(**{\-1: 1})\fP\&.
.sp
بسته شدن #11222 (#11222 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11222>)
.UNINDENT
.SS در Pylint 4.0.6 چه مواردی جدید است؟
.sp
تاریخ انتشار: 2026\-06\-14
.SS هشدارهای کاذب برطرف‌شده
.INDENT 0.0
.IP \(bu 2
پیام \fBimplicit\-str\-concat\fP دیگر برای الحاق ضمنی یک رشته خام (raw) با یک رشته غیرخام صادر نمی‌شود (مانند \fBr\(dq\ed\(dq \(dq\en\(dq\fP)\&. چنین لیترال‌هایی نمی‌توانند در یک رشته واحد ادغام شوند، بنابراین الحاق عامدانه بوده است و ناشی از ویرگول فراموش‌شده نیست\&.
.sp
بسته شدن #6663 (#6663 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6663>)
.IP \(bu 2
رفع یک هشدار کاذب برای \fBinvalid\-name\fP (C0103) که در آن مقدار پیش‌فرض \fBtypevar\-rgx\fP، نام‌های \fBTypeVar\fP حاوی ارقام مانند \fBEc2T\fP را رد می‌کرد\&.
.sp
بسته شدن #8499 (#8499 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8499>)
.IP \(bu 2
رفع یک هشدار کاذب برای \fBtoo\-many\-arguments\fP در متدهای (غیرایستا) و classmethodها\&.
.sp
بسته شدن #8675 (#8675 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8675>)
.IP \(bu 2
رفع یک هشدار کاذب برای \fBno\-member\fP هنگامی که یک مقدار به چند نوع ممکن استنتاج می‌شود و حداقل یکی از آن‌ها یک \fB__getattr__\fP پویا تعریف می‌کند\&.
.sp
بسته شدن #9833 (#9833 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9833>)
.IP \(bu 2
رفع یک هشدار کاذب برای \fBfunction\-redefined\fP (E0102) هنگام استفاده مجدد از نام‌هایی که با \fBdummy\-variables\-rgx\fP مطابقت دارند (مانند \fB_\fP)، که برای تعاریف گام‌های \fBpytest\-bdd\fP متداول است\&. این تغییر رفتار نسخه پیش از pylint 4.0.0 را بازمی‌گرداند؛ در نتیجه منفی کاذب برطرف‌شده در #9894 مجدداً برای توابعی که نامشان با \fBdummy\-variables\-rgx\fP مطابقت دارد معرفی می‌شود\&.
.sp
بسته شدن #10665 (#10665 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10665>)
.IP \(bu 2
رفع هشدار کاذب \fBundefined\-variable\fP هنگامی که نامی که به عنوان آرگومان \fBmetaclass\fP در یک کلاس تو در تو استفاده شده است، بعداً در ماژول دوباره مورد ارجاع قرار می‌گیرد\&.
.sp
بسته شدن #10823 (#10823 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10823>)
.IP \(bu 2
رفع یک هشدار کاذب برای \fBunused\-variable\fP که در آن متغیرهای سراسری مطابق با \fBdummy\-variables\-rgx\fP هنگام غیرفعال بودن \fBallow\-global\-unused\-variables\fP همچنان به عنوان استفاده‌نشده گزارش می‌شدند\&.
.sp
بسته شدن #10890 (#10890 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10890>)
.IP \(bu 2
رفع یک هشدار کاذب برای \fBbad\-dunder\-name\fP هنگامی که یک مشخصه \fB__suppress_context__\fP تعریف‌شده توسط کاربر روی زیرکلاس‌های استثنا وجود دارد\&.
.sp
بسته شدن #10960 (#10960 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10960>)
.IP \(bu 2
رفع هشدار کاذب \fBused\-before\-assignment\fP برای نام‌هایی که توسط \fBfrom X import *\fP در تمام شاخه‌های یک زنجیره \fBif\fP/\fBelif\fP/\fBelse\fP مقید (bound) شده‌اند\&.
.sp
ارجاع به #10980 (#10980 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10980>)
.IP \(bu 2
بررسی امضای __call__ فرامعرف (metaclass) هنگام ارزیابی آرگومان‌های فراخوانی یک کلاس\&.
.sp
بسته شدن #11032 (#11032 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11032>)
.IP \(bu 2
رفع هشدار کاذب \fBmethod\-hidden\fP هنگامی که \fBcached_property\fP مستقیماً با \fBfrom functools import cached_property\fP وارد می‌شود\&.
.sp
ارجاع به #11037 (#11037 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11037>)
.UNINDENT.SS "سایر رفع باگ‌ها (Other Bug Fixes)"
.INDENT 0.0
.IP \(bu 2
اصلاح پیشنهاد \fBunnecessary\-comprehension\fP برای ساختار درک دیکشنری (dict comprehension) که مستقیماً روی یک دیکشنری پیمایش می‌کند، مانند \fB{a: b for a, b in d}\fP\&. از آنجا که پیمایش روی یک دیکشنری کلیدهای آن را برمی‌گرداند، این پیشنهاد اکنون به جای \fBdict(d)\fP نادرست (که صرفاً از \fBd\fP رونوشت می‌گرفت)، به صورت \fBdict(d.keys())\fP ارائه می‌شود\&.
.sp
بسته شد #8256 (#8256 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8256>)
.IP \(bu 2
رفع خرابی در \fBconsider\-using\-enumerate\fP زمانی که هدف حلقهٔ \fBfor\fP یک صفت (مانند \fBfor self.idx in range(len(x))\fP) باشد و نه یک نام متغیر ساده.
.sp
بسته شد #10099 (#10099 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10099>)
.IP \(bu 2
رفع خرابی هنگام بررسی \fBattribute\-defined\-outside\-init\fP روی کلاس‌هایی که از یک کلاس پایه که pylint قادر به تحلیل کامل آن نیست، ارث‌بری می‌کنند.
.sp
بسته شد #10892 (#10892 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10892>)
.IP \(bu 2
رفع بازنویسی خاموش مقدار صریح \fBcol_offset=0\fP (یا هر مقدار صفر دیگر برای \fBline\fP/\fBend_lineno\fP/\fBend_col_offset\fP) با مقدار گرهٔ AST توسط \fBadd_message\fP\&. تابع کمکی داخلی \fB_add_one_message\fP از بررسی ارزیابی نادرست (\fBif not col_offset:\fP) برای تشخیص آرگومان حذف‌شده استفاده می‌کرد که به‌اشتباه یک مقدار معتبر \fB0\fP را همانند \fBNone\fP در نظر می‌گرفت\&. اکنون از بررسی همسانی با \fBNone\fP استفاده می‌کند\&.
.sp
ارجاع: #11020 (#11020 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11020>)
.IP \(bu 2
رفع خرابی در بررسی‌کنندهٔ نام‌ها هنگام ارسال یک مقدار غیرثابت به عنوان آرگومان \fBcovariant\fP یا \fBcontravariant\fP برای یک \fBTypeVar\fP\&.
.sp
بسته شد #11022 (#11022 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11022>)
.IP \(bu 2
رفع خرابی در بررسی‌کنندهٔ متغیرها زمانی که یک نام به متد \fB__init__\fP ایجادشده توسط dataclass حل می‌شود که فاقد شماره خط است.
.sp
بسته شد #11023 (#11023 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11023>)
.IP \(bu 2
رفع خرابی در بررسی‌کنندهٔ متغیرها هنگامی که \fBNotImplemented\fP به عنوان شرط یک دستور \fBif\fP استفاده می‌شود، که در پایتون ۳.۱۴ در یک بستر بولی منجر به صدور خطای \fBTypeError\fP می‌شد.
.sp
بسته شد #11025 (#11025 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11025>)
.IP \(bu 2
جلوگیری از خرابی در بررسی‌کنندهٔ مقدار بولی ضمنی (implicit booleaness) برای فراخوانی‌های بدون آرگومان \fBlen()\fP.
.sp
بسته شد #11028 (#11028 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11028>)
.IP \(bu 2
رفع خرابی در بررسی‌کنندهٔ متغیرها زمانی که یک کلاس، متاکلاسی را اعلان می‌کند که زنجیرهٔ دسترسی به صفت آن به یک نام منتهی نمی‌شود (مانند
\fBclass C(metaclass=None._)\fP).
در ابتدا به عنوان \fBpylint\-dev/astroid#3066\fP گزارش شده بود\&.
.sp
ارجاع: #11031 (#11031 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11031>)
.IP \(bu 2
رفع خرابی در بررسی‌کنندهٔ نام‌ها زمانی که انتساب زنجیره‌ای یک مقدار \fBTypeAlias\fP
دارای مقصدی غیر از نام باشد، مانند یک \fBSubscript\fP (برای مثال
\fBa[0] = b = TypeAlias\fP).
.sp
بسته شد #11056 (#11056 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11056>)
.IP \(bu 2
رفع خرابی در بررسی‌کنندهٔ منسوخ‌شدگی‌ها هنگامی که \fB__import__\fP با یک
آرگومان ثابت غیررشته‌ای فراخوانی می‌شود (برای مثال \fB__import__(1)\fP).
.sp
بسته شد #11059 (#11059 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11059>)
.IP \(bu 2
جلوگیری از خرابی هنگام ناموفق بودن استنتاج عضو enum در حین بررسی زیرکلاس‌های enum.
.sp
بسته شد #11069 (#11069 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11069>)
.IP \(bu 2
جلوگیری از خرابی در تحلیل \fBunexpected\-keyword\-arg\fP زمانی که
\fBinfer_call_result()\fP در هنگام بازرسی امضای بازگشتی دکوراتور، خطای \fBInferenceError\fP پرتاب می‌کند.
.sp
بسته شد #11070 (#11070 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11070>)
.IP \(bu 2
رفع خرابی در بررسی‌کنندهٔ نوع (typecheck) زمانی که یک کلاس از یک شیء غیرکلاس
(برای مثال یک تابع) به عنوان آرگومان \fBmetaclass=\fP خود استفاده می‌کند.
.sp
بسته شد #11071 (#11071 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11071>)
.IP \(bu 2
مجاز شدن ارقام در نام‌های ParamSpec و TypeVarTuple برای بررسی \fIinvalid\-name\fP.
.sp
الگوهای پیش‌فرض \fIparamspec\-rgx\fP و \fItypevartuple\-rgx\fP نام‌های حاوی
ارقام (مانند \fBEc2P\fP، \fBS3Ts\fP) را رد می‌کردند و هشدار کاذب \fBinvalid\-name\fP
(C0103) صادر می‌نمودند. اکنون برای سازگاری با الگوهای
\fBtypevar\fP و \fBtypealias\fP، وجود ارقام در بخش‌های با حروف کوچک مجاز شده است.
.sp
بسته شد #11090 (#11090 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:11090>)
.UNINDENT.SS "بهبودهای عملکرد (Performance Improvements)"
.INDENT 0.0
.IP \(bu 2
بررسی‌کنندهٔ duplicate\-code دیگر زمانی که پیام آن (R0801) غیرفعال است اجرا نمی‌شود، حتی اگر \fBreports=yes\fP تنظیم شده باشد. پیش‌تر، گزارش این بررسی‌کننده (RP0801) باعث می‌شد که محاسبهٔ سنگین شباهت در هر صورت اجرا شود.
.sp
بستن #3443 (#3443 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3443>)
.UNINDENT
.SS "چه مواردی در Pylint 4.0.5 جدید است؟ (What\(aqs new in Pylint 4.0.5?)"
.sp
تاریخ انتشار: 2026\-02\-20
.SS "مثبت‌های کاذب برطرف‌شده (False Positives Fixed)"
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب possibly\-used\-before\-assignment هنگام استفاده از self.fail() در آزمون‌ها.
.sp
بستن #10743 (#10743 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10743>)
.IP \(bu 2
رفع مثبت کاذب برای \fBlogging\-unsupported\-format\fP هنگامی که هیچ آرگومانی به توابع logging ارائه نشده است.
.sp
طبق مستندات logging در Python، هنگامی که هیچ آرگومانی ارسال نشود هیچ قالب‌بندی‌ای صورت نمی‌گیرد، بنابراین رشته‌هایی مانند \fBlogging.error(\(dq%test\(dq)\fP معتبر هستند.
.sp
بستن #10752 (#10752 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10752>)
.IP \(bu 2
رفع مثبت کاذب برای \fBinvalid\-name\fP در جایی که یک فیلد dataclass با نوع \fBFinal\fP
به‌جای regex مربوط به \fBclass_attribute\fP، با regex مربوط به \fBclass_const\fP ارزیابی می‌شد.
.sp
بستن #10790 (#10790 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10790>)
.IP \(bu 2
جلوگیری از صدور \fIunspecified\-encoding\fP (W1514) هنگامی که \fIpy\-version\fP برابر 3.15+ است.
.sp
ارجاع به #10791 (#10791 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10791>)
.UNINDENT
.SS "سایر رفع اشکال‌ها (Other Bug Fixes)"
.INDENT 0.0
.IP \(bu 2
رفع نادیده گرفته شدن پیکربندی \fI\-\-known_third_party\fP\&.
.sp
بستن #10801 (#10801 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10801>)
.IP \(bu 2
رفع نگاشت پویای رنگ برای پیام‌های \(dqfail\-on\(dq هنگام استفاده از چند قالب reporter/خروجی.
.sp
بستن #10825 (#10825 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10825>)
.IP \(bu 2
وابستگی به isort اکنون روی <9 تنظیم شده است که امکان استفاده از isort 8 را فراهم می‌کند.
.sp
بستن #10857 (#10857 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10857>)
.UNINDENT
.SS "چه مواردی در Pylint 4.0.4 جدید است؟ (What\(aqs new in Pylint 4.0.4?)"
.sp
تاریخ انتشار: 2025\-11\-30
.SS "مثبت‌های کاذب برطرف‌شده (False Positives Fixed)"
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب برای \fBinvalid\-name\fP هنگامی که ثابت‌های سطح ماژول در صورت وجود یک صفت هم‌نام در سطح کلاس، به نادرست به عنوان متغیر دسته‌بندی می‌شدند.
.sp
بستن #10719 (#10719 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10719>)
.IP \(bu 2
رفع مثبت کاذب برای \fBinvalid\-name\fP بر روی یک نام با حروف بزرگ (UPPER_CASED) درون یک شاخهٔ \fBif\fP که شیئی را انتساب می‌دهد.
.sp
بستن #10745 (#10745 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10745>)
.UNINDENT
.SS "چه مواردی در Pylint 4.0.3 جدید است؟ (What\(aqs new in Pylint 4.0.3?)"
.sp
تاریخ انتشار: 2025\-11\-13
.SS "مثبت‌های کاذب برطرف‌شده (False Positives Fixed)"
.INDENT 0.0
.IP \(bu 2
افزودن متدهای dunder کلاس Enum شامل \fB_generate_next_value_\fP، \fB_missing_\fP، \fB_numeric_repr_\fP، \fB_add_alias_\fP و \fB_add_value_alias_\fP به فهرستی که به \fB\-\-good\-dunder\-names\fP ارسال می‌شود.
.sp
بستن #10435 (#10435 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10435>)
.IP \(bu 2
رفع مثبت کاذب برای \fBinvalid\-name\fP با \fBtyping.Annotated\fP\&.
.sp
بستن #10696 (#10696 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10696>)
.IP \(bu 2
رفع مثبت کاذب برای \fBf\-string\-without\-interpolation\fP با رشته‌های الگو
هنگام استفاده از مشخصات قالب (format spec).
.sp
بستن #10702 (#10702 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10702>)
.IP \(bu 2
رفع مثبت کاذب هنگامی که یک صفت کلاس با حروف بزرگ (UPPER_CASED) در صورت تعیین نوع با \fBFinal\fP خطای
\fBinvalid\-name\fP صادر می‌کرد.
.sp
بستن #10711 (#10711 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10711>)
.IP \(bu 2
رفع مثبت کاذب برای \fBunbalanced\-tuple\-unpacking\fP هنگامی که یک تاپل به یک فراخوانی تابع انتساب داده می‌شود و ساختار مقدار بازگشتی تابع مبهم است.
.sp
بستن #10721 (#10721 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10721>)
.UNINDENT.SS سایر باگ‌های رفع‌شده (Other Bug Fixes)
.INDENT 0.0
.IP \(bu 2
گزینهٔ \(aqignore\(aq دوباره طبق انتظار کار می‌کند.
.sp
بسته‌شده در #10669 (#10669 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10669>)
.IP \(bu 2
رفع کرش برای \fBconsider\-using\-assignment\-expr\fP هنگامی که حاشیه‌نویسی متغیر بدون انتساب به عنوان عبارت آزمون \fBif\fP استفاده می‌شود.
.sp
بسته‌شده در #10707 (#10707 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10707>)
.IP \(bu 2
رفع کرش برای \fBprefer\-typing\-namedtuple\fP و \fBconsider\-math\-not\-float\fP هنگام فراخوانی یک شیء \fBslice\fP.
.sp
بسته‌شده در #10708 (#10708 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10708>)
.UNINDENT
.SS چه مواردی در Pylint 4.0.2 جدید است؟
.sp
تاریخ انتشار: 2025\-10\-20
.SS موارد مثبت کاذب رفع‌شده (False Positives Fixed)
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب برای invalid\-name / C0103 \%<#\:invalid-name> روی یک ثابت در سطح ماژول که تا حدی غیرقابل استنتاج است.
.sp
بسته‌شده در #10652 (#10652 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10652>)
.IP \(bu 2
رفع یک مثبت کاذب برای invalid\-name / C0103 \%<#\:invalid-name> روی انتساب‌های انحصاری در سطح ماژول متشکل از سه شاخه یا بیشتر. تا زمان انجام بازآرایی بیشتر برای حذف این منفی کاذب، خطای disallowed\-name / C0104 \%<#\:disallowed-name> روی نام‌های سطح ماژول که قابل استنتاج نیستند صادر نخواهد شد.
.sp
بسته‌شده در #10664 (#10664 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10664>)
.IP \(bu 2
رفع مثبت کاذب برای invalid\-name / C0103 \%<#\:invalid-name> در نمونه‌های \fBTypedDict\fP.
.sp
بسته‌شده در #10672 (#10672 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10672>)
.UNINDENT
.SS چه مواردی در Pylint 4.0.1 جدید است؟
.sp
تاریخ انتشار: 2025\-10\-14
.SS موارد مثبت کاذب رفع‌شده (False Positives Fixed)
.INDENT 0.0
.IP \(bu 2
مستثنی کردن \fB__all__\fP و \fB__future__.annotations\fP از بررسی \fBunused\-variable\fP\&.
.sp
بسته‌شده در #10019 (#10019 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10019>)
.IP \(bu 2
رفع مثبت کاذب برای \fBbare\-name\-capture\-pattern\fP در صورت استفاده از case guard.
.sp
بسته‌شده در #10647 (#10647 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10647>)
.IP \(bu 2
بررسی enumهای ایجادشده با نحو تابعی \fBEnum()\fP جهت مطابقت با \fB\-\-class\-rgx\fP برای بررسی invalid\-name / C0103 \%<#\:invalid-name>، همانند سایر enumها.
.sp
بسته‌شده در #10660 (#10660 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10660>)
.UNINDENT
.SS چه مواردی در Pylint 4.0.0 جدید است؟
.sp
تاریخ انتشار: 2025\-10\-12
.SS تغییرات ساختارشکن (Breaking Changes)
.INDENT 0.0
.IP \(bu 2
بررسی \fBinvalid\-name\fP اکنون بین ثابت‌های در سطح ماژول که تنها یک بار انتساب یافته‌اند و آن‌هایی که مجدداً مقداردهی شده‌اند تمایز قائل می‌شود و برای دومی \fB\-\-variable\-rgx\fP را اعمال می‌کند. مقادیری غیر از لیترال‌ها (فهرست‌ها، مجموعه‌ها، اشیاء) می‌توانند با هر دو عبارت منظمِ ثابت یا متغیر تطابق داشته باشند (برای مثال \(dqLOGGER\(dq یا \(dqlogger\(dq اما نه \(dqLoGgEr\(dq).
.sp
به یاد داشته باشید که می‌توان \fB\-\-good\-names\fP یا \fB\-\-good\-names\-rgxs\fP را برای مجاز دانستن صریح نام‌های مناسب مشخص کرد.
.sp
بسته‌شده در #3585 (#3585 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3585>)
.IP \(bu 2
آرگومان بلااستفادهٔ \fBpylintrc\fP در \fBPyLinter.__init__()\fP منسوخ شده و حذف خواهد شد.
.sp
ارجاع به #6052 (#6052 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6052>)
.IP \(bu 2
بلوک‌های کد کامنت‌شده مانند \fB#    bar() # TODO: remove dead code\fP دیگر هشدار \fBfixme\fP را صادر نخواهند کرد\&.
.sp
ارجاع به #9255 (#9255 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9255>)
.IP \(bu 2
کلاس \fBRun\fP در \fBpyreverse\fP تغییر یافت تا دیگر \fBsys.exit()\fP را در \fB__init__\fP خود فراخوانی نکند\&. اکنون باید \fBRun(args).run()\fP را فراخوانی کنید که در عوض کد وضعیت خروج را برمی‌گرداند. داشتن کلاسی که همیشه استثنای \fBSystemExit\fP ایجاد می‌کرد، یک باگ تلقی می‌شد.
.sp
استفادهٔ عادی از pyreverse از طریق خط فرمان تحت تأثیر این تغییر قرار نخواهد گرفت.
.sp
ارجاع به #9689 (#9689 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9689>)
.IP \(bu 2
گزینهٔ \fBsuggestion\-mode\fP حذف شد، زیرا pylint اکنون همیشه به جای پیام‌های خطای مثبت کاذب، راهنمایی‌های کاربرپسند صادر می‌کند. در صورت تعریف شدن در فایل پیکربندی، باید آن را حذف کنید.
.sp
ارجاع به #9962 (#9962 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9962>)
.IP \(bu 2
ماژول بررسی‌کنندهٔ \fBasync.py\fP به \fBasync_checker.py\fP تغییر نام یافته است، زیرا \fBasync\fP یک کلیدواژهٔ پایتون است و نمی‌توان آن را مستقیماً وارد کرد (import). این تغییر امکان آزمون بهتر و گسترش‌پذیری کارایی بررسی‌کنندهٔ async را فراهم می‌سازد.
.sp
ارجاع به #10071 (#10071 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10071>)
.IP \(bu 2
شناسهٔ پیام (message-id) در \fBcontinue\-in\-finally\fP از \fBE0116\fP به \fBW0136\fP تغییر یافت\&. این هشدار اکنون برای تمام نسخه‌های پایتون صادر می‌شود، زیرا در پایتون 3.14 موجب ایجاد هشدار نحو (syntax warning) خواهد شد. سند PEP 765 \- Disallow return/break/continue that exit a finally block \%<https://\:peps\:.python\:.org/\:pep-0765>\& را ببینید.
.sp
ارجاع به #10480 (#10480 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10480>)
.IP \(bu 2
پشتیبانی از نام مستعار \fBnmp.NaN\fP برای \fBnumpy.NaN\fP در \(aqnan\-comparison / W0177 \%<#\:nan-comparison>\(aq حذف شد. به جای آن از \fBnp\fP یا \fBnumpy\fP استفاده کنید.
.sp
ارجاع به #10583 (#10583 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10583>)
.IP \(bu 2
نسخهٔ مورد نیاز برای \fBisort\fP به 5.0.0=< ارتقا یافته است. سازگاری داخلی برای نسخه‌های قدیمی‌تر \fBisort\fP که از طریق \fBpylint.utils.IsortDriver\fP ارائه می‌شد، حذف گردیده است.
.sp
ارجاع به #10637 (#10637 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10637>)
.UNINDENT.SS "ویژگی‌های جدید (New Features)"
.INDENT 0.0
.IP \(bu 2
.INDENT 2.0
.TP
.B \fBcomparison\-of\-constants\fP اکنون به‌جای قالب‌بندی مجدد از مقادیر گره، از یونیکد حاصل از ast استفاده می‌کند تا از
برخی قالب‌بندی‌های نادرست ناشی از محدودیت \fButf\-8\fP جلوگیری شود. این پیام اکنون به‌جای \fB\(aq\fP از \fB\(dq\fP استفاده می‌کند تا با خروجی ast در python سازگاری بهتری داشته باشد.
.UNINDENT
.sp
Refs #8736 (#8736 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8736>)
.IP \(bu 2
بهبود pyreverse برای تشخیص درست بین انواع روابط UML (ارتباط/association، تجمیع/aggregation، ترکیب/composition) بر پایه معناشناسی مالکیت شیء. یادداشت‌های نوع بدون مقداردهی اولیه اکنون به عنوان association، مقداردهی‌های پارامتر به عنوان aggregation و نمونه‌سازی شیء به عنوان composition در نظر گرفته می‌شوند.
.sp
Closes #9045
Closes #9267 (#9045 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9045>)
.IP \(bu 2
بررسی \fBfixme\fP اکنون می‌تواند با استفاده از \fBcheck\-fixme\-in\-docstring = true\fP در بخش \fB[tool.pylint.miscellaneous]\fP، علاوه بر کامنت‌ها در docstringها نیز جستجو کند.
.sp
Closes #9255 (#9255 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9255>)
.IP \(bu 2
بررسی‌های \fBuse\-implicit\-booleaness\-not\-x\fP اکنون میان مقایسه‌های استفاده‌شده در زمینه‌های بولی و مواردی که این‌گونه نیستند تمایز قائل می‌شوند، که امکان ارائه پیشنهادهای بازسازی کد (refactoring) دقیق‌تری را فراهم می‌سازد.
.sp
Closes #9353 (#9353 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9353>)
.IP \(bu 2
گزینه verbose اکنون نام فایل‌های بررسی‌شده را در خروجی نمایش می‌دهد. پیش از این، این گزینه تنها تعداد فایل‌های بررسی‌شده و نادیده‌گرفته‌شده را شامل می‌شد.
.sp
Closes #9357 (#9357 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9357>)
.IP \(bu 2
گزارش‌دهنده رنگی (colorized reporter) اکنون پیام‌ها یا دسته‌بندی‌هایی را که به عنوان \fBfail\-on\fP پیکربندی شده‌اند با رنگ قرمز معکوس (red inverse) نمایش می‌دهد. این امر یافتن سریع خطاهایی را که باعث شکست کارهای CI ابزار pylint می‌شوند، آسان‌تر می‌کند.
.sp
Closes #9898 (#9898 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9898>)
.IP \(bu 2
بهبود پشتیبانی از دکوراتور @property در pyreverse برای نمایش صحیح نوع‌های بازگشتی مشخصه‌های نشانه‌گذاری‌شده هنگام تولید نمودارهای کلاس.
.sp
Closes #10057 (#10057 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10057>)
.IP \(bu 2
افزودن گزینه \-\-max\-depth به pyreverse برای کنترل پیچیدگی نمودار. عمق 0 تنها بسته‌های سطح بالا را نشان می‌دهد، 1 یک سطح از زیربسته‌ها را نمایش می‌دهد و غیره. این ویژگی با محدود کردن عمق بسته‌ها و کلاس‌های نمایش‌داده‌شده، به مدیریت مصورسازی پایگاه‌های کد بزرگ کمک می‌کند.
.sp
Refs #10077 (#10077 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10077>)
.IP \(bu 2
مدیریت ارزیابی معوق نشانه‌گذاری‌ها (deferred evaluation of annotations) در Python 3.14.
.sp
Closes #10149 (#10149 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10149>)
.IP \(bu 2
بهبود pyreverse برای تشخیص صحیح تجمیع‌ها (aggregations) در عبارت‌های جامع (comprehensions شامل list، dict، set و generator).
.sp
Closes #10236 (#10236 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10236>)
.IP \(bu 2
\fBpyreverse\fP: افزودن پشتیبانی از خروجی رنگی هنگام استفاده از قالب‌های خروجی \fBmmd\fP (MermaidJS) و \fBhtml\fP\&.
.sp
Closes #10242 (#10242 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10242>)
.IP \(bu 2
اکنون از pypy 3.11 به‌طور رسمی پشتیبانی می‌شود.
.sp
Refs #10287 (#10287 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10287>)
.IP \(bu 2
افزودن پشتیبانی از Python 3.14.
.sp
Refs #10467 (#10467 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10467>)
.IP \(bu 2
افزودن شیوه‌های نام‌گذاری برای \fBParamSpec\fP و \fBTypeVarTuple\fP که با سبک \fBTypeVar\fP همخوانی دارد.
.sp
Refs #10541 (#10541 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10541>)
.UNINDENT
.SS "بررسی‌های جدید (New Checks)"
.INDENT 0.0
.IP \(bu 2
افزودن بررسی‌کننده \fBmatch\-statements\fP و پیام زیر:
\fBbare\-name\-capture\-pattern\fP\&.
این بررسی هنگامی که یک الگوی گرفتن نام (name capture pattern) در دستور match به‌کار رود و باعث غیرقابل‌دسترس شدن سایر الگوها شود، یک پیام خطا صادر می‌کند.
این کد در زمان اجرا یک SyntaxError است.
.sp
Closes #7128 (#7128 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7128>)
.IP \(bu 2
افزودن بررسی جدید \fBasync\-context\-manager\-with\-regular\-with\fP برای تشخیص مدیران زمینه ناهمگام (async context managers) که به‌جای \fBasync with\fP با دستورات معمولی \fBwith\fP استفاده شده‌اند\&.
.sp
Refs #10408 (#10408 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10408>)
.IP \(bu 2
افزودن هشدار \fBbreak\-in\-finally\fP. استفاده از \fBbreak\fP درون بند \fBfinally\fP
در Python 3.14 یک هشدار نحوی ایجاد خواهد کرد.
سند PEP 765 \- Disallow return/break/continue that exit a finally block \%<https://\:peps\:.python\:.org/\:pep-0765>\& را ببینید.
.sp
Refs #10480 (#10480 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10480>)
.IP \(bu 2
افزودن بررسی‌های جدید برای استفاده‌های نادرست از الگوهای کلاس در \fBmatch\fP \%<https://\:docs\:.python\:.org/\:3/\:reference/\:compound_stmts\:.html#\:match>\&.
.INDENT 2.0
.IP \(bu 2
پیام invalid\-match\-args\-definition / E1902 \%<#\:invalid-match-args-definition> در صورتی که \fBobject.__match_args__\fP \%<https://\:docs\:.python\:.org/\:3/\:reference/\:datamodel\:.html#\:object\:.__match_args__> یک چندتایی (tuple) از رشته‌ها نباشد، صادر می‌شود.
.IP \(bu 2
پیام too\-many\-positional\-sub\-patterns / E1903 \%<#\:too-many-positional-sub-patterns> اگر تعداد زیرالگوهای موضعی بیشتر از مقدار مشخص‌شده در \fBobject.__match_args__\fP \%<https://\:docs\:.python\:.org/\:3/\:reference/\:datamodel\:.html#\:object\:.__match_args__> باشد، صادر می‌شود\&.
.IP \(bu 2
پیام multiple\-class\-sub\-patterns / E1904 \%<#\:multiple-class-sub-patterns> اگر چند زیرالگو برای یک ویژگی (attribute) یکسان وجود داشته باشد، صادر می‌شود.
.UNINDENT
.sp
Refs #10559 (#10559 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10559>)
.IP \(bu 2
افزودن بررسی‌های تکمیلی برای استفاده‌های غیربهینه از الگوهای کلاس در \fBmatch\fP \%<https://\:docs\:.python\:.org/\:3/\:reference/\:compound_stmts\:.html#\:match>\&.
.INDENT 2.0
.IP \(bu 2
پیام match\-class\-bind\-self / R1905 \%<#\:match-class-bind-self> زمانی صادر می‌شود که به‌جای
استفاده از الگوی \fBas\fP، نامی به \fBself\fP متصل شده باشد.
.IP \(bu 2
پیام match\-class\-positional\-attributes / R1906 \%<#\:match-class-positional-attributes> زمانی صادر می‌شود که یک الگوی کلاس دارای مشخصه‌های موضعی باشد
در حالی که امکان استفاده از کلمات کلیدی وجود داشته است.
.UNINDENT
.sp
Refs #10587 (#10587 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10587>)
.IP \(bu 2
افزودن پیام \fBconsider\-math\-not\-float\fP. فراخوانی‌های \fBfloat(\(dqnan\(dq)\fP و \fBfloat(\(dqinf\(dq)\fP به‌اندازه
۴ برابر کندتر از همتایان خود یعنی \fBmath.inf\fP و \fBmath.nan\fP هستند (بدون در نظر گرفتن
زمان وارد کردن اولیه math) و همچنین هنگام استفاده از mypy دارای نوع مناسبی نیستند.
این بررسی همچنین به عنوان یک مزیت جانبی، اشتباهات تایپی در فراخوانی‌های float را شناسایی می‌کند.
.sp
برای کارکرد این بررسی، باید بررسی‌کننده Code Style \%<#\:pylint-extensions-code-style> فعال باشد.
.sp
Refs #10621 (#10621 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10621>)
.UNINDENT.SS مثبت‌های کاذب برطرف‌شده (False Positives Fixed)
.INDENT 0.0
.IP \(bu 2
رفع یک مثبت کاذب برای \fBused\-before\-assignment\fP هنگامی که متغیر تعریف‌شده درون یک \fBif\fP و از طریق یک عبارت نام‌گذاری‌شده (عملگر walrus)، بعداً تحت محافظت همان شرط \fBif\fP استفاده می‌شود.
.sp
Closes #10061 (#10061 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10061>)
.IP \(bu 2
رفع no\-name\-in\-module / E0611 \%<#\:no-name-in-module> برای اعضای \fBconcurrent.futures\fP با Python 3.14.
.sp
Closes #10632 (#10632 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10632>)
.UNINDENT
.SS منفی‌های کاذب برطرف‌شده (False Negatives Fixed)
.INDENT 0.0
.IP \(bu 2
رفع منفی کاذب برای \fBused\-before\-assignment\fP هنگامی که یک واردسازی \fBTYPE_CHECKING\fP پیش از استفاده نادرست، به‌عنوان یادداشت نوع (type annotation) استفاده شده باشد.
.sp
Refs #8893 (#8893 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8893>)
.IP \(bu 2
موارد match اکنون به‌عنوان یال در گراف McCabe شمارش می‌شوند و بر همین اساس پیچیدگی را افزایش می‌دهند.
.sp
Refs #9667 (#9667 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9667>)
.IP \(bu 2
بررسی ثابت‌های در سطح ماژول دارای یادداشت نوع برای \fBinvalid\-name\fP\&.
به یاد داشته باشید که \fBconst\-naming\-style\fP یا \fBconst\-rgx\fP را مطابق سلیقه خود تنظیم کنید.
.sp
Closes #9770 (#9770 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9770>)
.IP \(bu 2
رفع منفی کاذب در مواردی که function\-redefined (E0102) برای توابعی با زیرخط آغازین گزارش نمی‌شد.
.sp
Closes #9894 (#9894 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9894>)
.IP \(bu 2
اکنون یک خطای \fBlogging\-too\-few\-args\fP برای رشته قالب‌بندی بدون هیچ آرگومان درون‌یابی صادر می‌شود (یعنی برای مواردی مانند \fBlogging.debug(\(dqAwaiting process %s\(dq)\fP یا \fBlogging.debug(\(dqAwaiting process {pid}\(dq)\fP). پیش از این برای چنین مواردی خطایی صادر نمی‌شد.
.sp
Closes #9999 (#9999 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9999>)
.IP \(bu 2
رفع منفی کاذب برای \fBused\-before\-assignment\fP هنگامی که تابعی درون یک بلوک محافظت‌شده با \fBTYPE_CHECKING\fP تعریف شده و بعداً استفاده می‌شود.
.sp
Closes #10028 (#10028 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10028>)
.IP \(bu 2
رفع یک منفی کاذب برای \fBpossibly\-used\-before\-assignment\fP هنگامی که متغیری به‌صورت شرطی تعریف شده و بعداً به یک متغیر دارای یادداشت نوع تخصیص داده می‌شود.
.sp
Closes #10421 (#10421 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10421>)
.IP \(bu 2
رفع منفی کاذب برای \fBdeprecated\-module\fP هنگامی که متد \fB__import__\fP به‌جای دستور \fBimport\fP استفاده می‌شود.
.sp
Refs #10453 (#10453 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10453>)
.IP \(bu 2
شمارش موارد match برای بررسی \fBtoo\-many\-branches\fP\&.
.sp
Refs #10542 (#10542 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10542>)
.IP \(bu 2
رفع منفی کاذب در مواردی که unused\-import / W0611 \%<#\:unused-import> برای نام‌های ارجاع‌داده‌شده در دستور قبلیِ \fBglobal\fP گزارش نمی‌شد.
.sp
Refs #10633 (#10633 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10633>)
.UNINDENT
.SS سایر رفع اشکال‌ها (Other Bug Fixes)
.INDENT 0.0
.IP \(bu 2
هنگام نمایش یونیکدهای دارای جانشین (surrogates) (یا سایر خطاهای احتمالی \fBUnicodeEncodeError\fP)،
ابزار pylint اکنون به‌جای فروپاشی، نویسه \(aq?\(aq را نمایش می‌دهد (با استفاده از \fBencode(encoding=\(dqutf\-8\(dq, errors=\(dqreplace\(dq)\fP).
کلاس‌های آزمون‌های کارکردی نیز برای رسیدگی به این مورد به‌روزرسانی شده‌اند.
.sp
Closes #8736. (#8736 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8736>)
.IP \(bu 2
رفع اشکال در unidiomatic\-typecheck که تنها سمت چپ را بررسی می‌کرد.
.sp
Closes #10217 (#10217 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10217>)
.IP \(bu 2
رفع فروپاشی ناشی از رشته‌های قالب‌بندی ناصحیح هنگام استفاده از \fB\&.format\fP با آرگومان‌های کلیدواژه‌ای.
.sp
Closes #10282 (#10282 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10282>)
.IP \(bu 2
رفع مثبت کاذب \fBinconsistent\-return\-statements\fP هنگام استفاده از توابع \fBquit()\fP یا \fBexit()\fP\&.
.sp
Closes #10508 (#10508 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10508>)
.IP \(bu 2
رفع فروپاشی در nested\-min\-max / W3301 \%<#\:nested-min-max> هنگام استفاده مستقیم از \fBbuiltins.min\fP یا \fBbuiltins.max\fP به‌جای \fBmin\fP یا \fBmax\fP\&.
.sp
Closes #10626 (#10626 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10626>)
.IP \(bu 2
رفع یک فروپاشی در unnecessary\-dict\-index\-lookup / R1733 \%<#\:unnecessary-dict-index-lookup> هنگامی که نمایه یک فهرست شمارش‌شده (enumerated list) درون یک حلقه for حذف می‌شد.
.sp
Closes #10627 (#10627 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10627>)
.UNINDENT.SS سایر تغییرات (Other Changes)
.INDENT 0.0
.IP \(bu 2
حذف پشتیبانی از راه‌اندازی pylint با Python 3.9.
کدهایی که از Python 3.9 پشتیبانی می‌کنند همچنان می‌توانند با تنظیم \fB\-\-py\-version=3.9\fP تحلیل (lint) شوند.
.sp
ارجاع به #10405 (#10405 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10405>)
.UNINDENT
.SS تغییرات داخلی (Internal Changes)
.INDENT 0.0
.IP \(bu 2
اصلاح چارچوب آزمون جهت امکان‌پذیر ساختن خروجی‌های آزمون متفاوت برای نسخه‌های مختلف Python.
.sp
ارجاع به #10382 (#10382 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10382>)
.UNINDENT
.SS 3.x
.sp
این فهرست کامل تغییرات در نسخه‌های فرعی (minor) pylint 3.x بر اساس دسته‌بندی است.
.SS تازه‌های Pylint 3.3 (What\(aqs New in Pylint 3.3)
.sp
:انتشار: 3.3
:تاریخ: 2024\-09\-20
.SS خلاصه \-\- نکات برجسته انتشار (Summary \-\- Release highlights)
.SS تازه‌های Pylint 3.3.9 (What\(aqs new in Pylint 3.3.9?)
.sp
تاریخ انتشار: 2025\-10\-05
.SS موارد مثبت کاذب رفع‌شده (False Positives Fixed)
.INDENT 0.0
.IP \(bu 2
رفع مورد used\-before\-assignment / E0601 \%<#\:used-before-assignment> برای نام‌های مستعار نوع (type aliases) و پارامترهای PEP 695.
.sp
بسته شد: #9815 (#9815 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9815>)
.IP \(bu 2
توابع منسوخ‌نشده در \fBimportlib.resources\fP دیگر به عنوان منسوخ علامت‌گذاری نمی‌شوند.
.sp
بسته شد: #10593 (#10593 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10593>)
.IP \(bu 2
رفع مثبت کاذب \fBinconsistent\-return\-statements\fP هنگام استفاده از توابع \fBquit()\fP یا \fBexit()\fP.
.sp
بسته شد: #10508 (#10508 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10508>)
.IP \(bu 2
رفع مثبت کاذب \fBundefined\-variable\fP (E0602) برای الگوهای سایه‌اندازی متغیر در حلقه for مانند \fBfor item in item:\fP زمانی که متغیر از پیش تعریف شده باشد.
.sp
بسته شد: #10562 (#10562 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10562>)
.UNINDENT
.SS رفع سایر باگ‌ها (Other Bug Fixes)
.INDENT 0.0
.IP \(bu 2
رفع خرابی (crash) در \fBunnecessary\-list\-index\-lookup\fP هنگام آغاز شمارش با استفاده از منفی طول یک پیمایش‌پذیر (iterable) درون یک dict comprehension، در وضعیتی که فراخوانی len تنها در همین dict comprehension انجام شده بود و نه در جای دیگر. همچنین رویکرد تغییر کرد تا در تمام حالات به جز موارد ساده از استنتاج (inference) استفاده شود، تا نیازی نباشد خرابی‌ها را یکی‌یکی برای عبارت‌های با پیچیدگی دلخواه در enumerate رفع کنیم.
.sp
بسته شد: #10510 (#10510 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10510>)
.UNINDENT
.SS تازه‌های Pylint 3.3.8 (What\(aqs new in Pylint 3.3.8?)
.sp
تاریخ انتشار: 2025\-08\-09
.sp
این انتشار وصله‌ای (patch release) شامل یک رفع مشکل استثنایی برای یک مورد منفی کاذب (false negative) است.
برای جزئیات، ببینید: \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:pull/\:10482#\:issuecomment-3164514082>
.SS موارد مثبت کاذب رفع‌شده (False Positives Fixed)
.INDENT 0.0
.IP \(bu 2
رفع موارد مثبت کاذب برای possibly\-used\-before\-assignment / E0606 \%<#\:possibly-used-before-assignment> زمانی که متغیرها به طور جامع درون یک بلوک \fBmatch\fP \%<https://\:docs\:.python\:.org/\:3/\:reference/\:compound_stmts\:.html#\:match> مقداردهی شده باشند.
.sp
بسته شد: #9668 (#9668 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9668>)
.IP \(bu 2
رفع مثبت کاذب برای missing\-raises\-doc / W9006 \%<#\:missing-raises-doc> و missing\-yield\-doc / W9013 \%<#\:missing-yield-doc> هنگامی که طول متد کمتر از docstring\-min\-length باشد.
.sp
ارجاع به #10104 (#10104 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10104>)
.IP \(bu 2
رفع یک مورد مثبت کاذب برای unused\-variable / W0612 \%<#\:unused-variable> زمانی که چندین گرداننده except نام یکسانی را تحت یک بلوک try مقید (bind) می‌کنند.
.sp
بسته شد: #10426 (#10426 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10426>)
.UNINDENT
.SS موارد منفی کاذب رفع‌شده (False Negatives Fixed)
.INDENT 0.0
.IP \(bu 2
رفع منفی کاذب برای used\-before\-assignment / E0601 \%<#\:used-before-assignment> همراه با \fBfrom __future__ import annotations\fP در تعاریف توابع.
.sp
ارجاع به #10482 (#10482 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10482>)
.UNINDENT.SS "سایر رفع باگ‌ها"
.INDENT 0.0
.IP \(bu 2
رفع باگی در Pyreverse که در آن تجمع‌ها (aggregations) و رابطه‌ها (associations) صرف‌نظر از \-\-filter\-mode انتخاب‌شده (مانند PUB_ONLY، ALL و غیره) در نمودارها گنجانده می‌شدند.
.sp
بستن #10373 (#10373 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10373>)
.IP \(bu 2
رفع رندر شدن نادرست دو خط زیرین (double underscore) به‌صورت پررنگ (bold) در خروجی Mermaid در pyreverse.
.sp
بستن #10402 (#10402 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10402>)
.UNINDENT
.SS "تازه‌های Pylint 3.3.7"
.sp
تاریخ انتشار: 2025\-05\-04
.SS "رفع مثبت‌های کاذب"
.INDENT 0.0
.IP \(bu 2
مقایسه بین دو فراخوانی \fItype()\fP دیگر هشدار unidiomatic\-typecheck / C0123 \%<#\:unidiomatic-typecheck> را ایجاد نخواهد کرد؛ این رفتار با آنچه پیش‌تر فقط برای \fB==\fP اعمال می‌شد هماهنگ است.
.sp
بستن #10161 (#10161 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10161>)
.UNINDENT
.SS "سایر رفع باگ‌ها"
.INDENT 0.0
.IP \(bu 2
رفع خرابی (crash) هنگام وارد کردن (import) دکوراتور کلاسی که وجود نداشت و پس از تعریف کلاس، با یکی از ویژگی‌های کلاس (class attribute) هم‌نام بود.
.sp
بستن #10105 (#10105 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10105>)
.IP \(bu 2
رفع خرابی (crash) ناشی از رشته‌های قالب‌بندی نامعتبر هنگام استفاده از \fI\&.format\fP با آرگومان‌های کلیدواژه‌ای.
.sp
بستن #10282 (#10282 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10282>)
.IP \(bu 2
استفاده از یک برش (slice) به عنوان دکوراتور کلاس اکنون به جای خرابی (crash)، پیام not\-callable / E1102 \%<#\:not-callable> را صادر می‌کند. بسیاری از بررسی‌های مربوط به دکوراتورها (بیش از آنکه بتوان فهرست کرد)، در صورتی که دکوراتور نتواند فوراً به یک تابع یا تعریف کلاس استنتاج شود، میان‌بُر زده می‌شوند.
.sp
بستن #10334 (#10334 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10334>)
.UNINDENT
.SS "سایر تغییرات"
.INDENT 0.0
.IP \(bu 2
الگوریتم مورد استفاده برای پیشنهادات no\-member / E1101 \%<#\:no-member> اکنون کارآمدتر شده و هنگامی که امتیاز فاصله بالاتر از آستانه باشد، محاسبه را متوقف می‌کند.
.sp
ارجاع به #10277 (#10277 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10277>)
.UNINDENT
.SS "تازه‌های Pylint 3.3.6"
.sp
تاریخ انتشار: 2025\-03\-20
.SS "رفع مثبت‌های کاذب"
.INDENT 0.0
.IP \(bu 2
رفع یک مثبت کاذب برای used\-before\-assignment / E0601 \%<#\:used-before-assignment> هنگامی که نوع بازگشتی مشخص‌شده برای یک تابع درونی، کلاسی تعریف‌شده در سطح ماژول (module scope) باشد.
.sp
بستن #9391 (#9391 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9391>)
.UNINDENT
.SS "تازه‌های Pylint 3.3.5"
.sp
تاریخ انتشار: 2025\-03\-09
.SS "رفع مثبت‌های کاذب"
.INDENT 0.0
.IP \(bu 2
رفع مثبت‌های کاذب برای use\-implicit\-booleaness\-not\-comparison / C1803 \%<#\:use-implicit-booleaness-not-comparison>، use\-implicit\-booleaness\-not\-comparison\-to\-string / C1804 \%<#\:use-implicit-booleaness-not-comparison-to-string>
و use\-implicit\-booleaness\-not\-comparison\-to\-zero / C1805 \%<#\:use-implicit-booleaness-not-comparison-to-zero> هنگام بررسی مقایسه‌های زنجیره‌ای.
.sp
بستن #10065 (#10065 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10065>)
.IP \(bu 2
رفع یک مثبت کاذب برای invalid\-getnewargs\-ex\-returned / E0313 \%<#\:invalid-getnewargs-ex-returned> هنگامی که tuple یا dict به یک نام منتسب شده باشد.
.sp
بستن #10208 (#10208 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10208>)
.IP \(bu 2
حذف \fBgetopt\fP \%<https://\:docs\:.python\:.org/\:3/\:library/\:getopt\:.html#\:module-getopt> و \fBoptparse\fP \%<https://\:docs\:.python\:.org/\:3/\:library/\:optparse\:.html#\:module-optparse> از فهرست ماژول‌های منسوخ‌شده.
.sp
بستن #10211 (#10211 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10211>)
.UNINDENT
.SS "سایر رفع باگ‌ها"
.INDENT 0.0
.IP \(bu 2
رفع مشکلی که در آن وارد کردن شرطی x.y باعث ایجاد مثبت کاذب possibly\-used\-before\-assignment / E0606 \%<#\:possibly-used-before-assignment>\& می‌شد.
.sp
بستن #10081 (#10081 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10081>)
.IP \(bu 2
رفع خرابی (crash) زمانی که در مدیریت‌کننده except چیزی به جز کلاس یافت شود.
.sp
بستن #10106 (#10106 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10106>)
.IP \(bu 2
رفع صدور پیام خطای invalid\-name / C0103 \%<#\:invalid-name> هنگام استفاده از camelCase برای متدهای خصوصی دارای دو خط زیرین آغازین.
.sp
بستن #10189 (#10189 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10189>)
.UNINDENT.SS سایر تغییرات
.INDENT 0.0
.IP \(bu 2
بارگذاری فایل‌های انتشار در PyPI از طریق Trusted Publishing.
.sp
بستن #10256 (#10256 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10256>)
.UNINDENT
.SS چه مواردی در Pylint 3.3.4 جدید است؟
.sp
تاریخ انتشار: 2025\-01\-28
.SS رفع سایر باگ‌ها
.INDENT 0.0
.IP \(bu 2
رفع اشکال در محاسبه تعداد \(dqskipped files\(dq؛ در روش پیشین عددی دلخواه نمایش داده می‌شد.
.sp
بستن #10073 (#10073 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10073>)
.IP \(bu 2
رفع کرشی که هنگام اجرای pylint درون یک کانتینر روی میزبانی با cgroupsv2 و دارای محدودیت در مصرف CPU رخ می‌داد.
.sp
بستن #10103 (#10103 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10103>)
.IP \(bu 2
تعدیل نیازمندی‌های isort تا pylint بتواند از isort 6 بهره‌مند شود.
.sp
بستن #10203 (#10203 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10203>)
.UNINDENT
.SS چه مواردی در Pylint 3.3.3 جدید است؟
.sp
تاریخ انتشار: 2024\-12\-23
.SS رفع مثبت‌های کاذب
.INDENT 0.0
.IP \(bu 2
رفع مثبت‌های کاذب برای undefined\-variable / E0602 \%<#\:undefined-variable> در کلاس‌هایی که از نحو انواع جنریک در Python 3.12 استفاده می‌کنند.
.sp
بستن #9335 (#9335 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9335>)
.IP \(bu 2
رفع یک مثبت کاذب برای use\-implicit\-booleaness\-not\-len / C1802 \%<#\:use-implicit-booleaness-not-len>\&. نباید هیچ هشدار lint برای مولدها صادر شود (\fBlen()\fP \%<https://\:docs\:.python\:.org/\:3/\:library/\:functions\:.html#\:len> برای مولدها تعریف نشده است).
.sp
ارجاع به #10100 (#10100 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10100>)
.UNINDENT
.SS رفع سایر باگ‌ها
.INDENT 0.0
.IP \(bu 2
رفع خطای \fBUnable to import \(aqcollections.abc\(aq (import\-error)\fP در Python 3.13.1.
.sp
بستن #10112 (#10112 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10112>)
.UNINDENT
.SS چه مواردی در Pylint 3.3.2 جدید است؟
.sp
تاریخ انتشار: 2024\-12\-01
.SS رفع مثبت‌های کاذب
.INDENT 0.0
.IP \(bu 2
رفع یک مثبت کاذب برای potential\-index\-error / E0643 \%<#\:potential-index-error> هنگامی که یک تکرارپذیر (iterable) اندیس‌گذاری‌شده حاوی عنصری ستاره‌دار است که به بیش از یک مورد ارزیابی می‌شود.
.sp
بستن #10076 (#10076 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10076>)
.UNINDENT
.SS رفع سایر باگ‌ها
.INDENT 0.0
.IP \(bu 2
رفع اشکال در کارکرد گزینه \-\-source\-root هنگامی که فایل‌های منبع در یک زیردایرکتوری از ریشه منبع قرار دارند (مثلاً هنگام استفاده از ساختار /src).
.sp
بستن #10026 (#10026 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:10026>)
.UNINDENT
.SS چه مواردی در Pylint 3.3.1 جدید است؟
.sp
تاریخ انتشار: 2024\-09\-24
.SS رفع مثبت‌های کاذب
.INDENT 0.0
.IP \(bu 2
رفع پس‌رفتی (regression) که باعث می‌شد برخی f\-strings به عنوان رشته استنتاج نشوند.
.sp
بستن #9947 (#9947 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9947>)
.UNINDENT
.SS چه مواردی در Pylint 3.3.0 جدید است؟
.sp
تاریخ انتشار: 2024\-09\-20
.SS تغییراتی که نیازمند اقدام کاربر هستند
.INDENT 0.0
.IP \(bu 2
ما \fBsymilar\fP را از getopt به argparse منتقل کردیم، بنابراین خروجی خطا و راهنما (به شکلی بهتر) تغییر یافته است. خروج برنامه اکنون به جای این‌که گاه با ۱ و گاه با ۲ باشد، با کد ۲ انجام می‌شود. خروجی خطا دیگر توسط اجراکننده (runner) ضبط نمی‌شود. همچنین دیگر امکان تعیین مقدار برای گزینه‌های بولی وجود ندارد (برای نمونه، \fB\-\-ignore\-comments 1\fP باید به \fB\-\-ignore\-comments\fP تبدیل شود).
.sp
ارجاع به #9731 (#9731 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9731>)
.UNINDENT.SS ویژگی‌های جدید
.INDENT 0.0
.IP \(bu 2
افزودن خطای جدید declare\-non\-slot / E0245 \%<#\:declare-non-slot> که زمانی گزارش می‌شود که یک کلاس دارای عضو \fI__slots__\fP بوده و یک راهنمای نوع (type hint) در کلاس، در \fI__slots__\fP موجود نباشد\&.
.sp
ارجاع به #9499 (#9499 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9499>)
.UNINDENT
.SS بررسی‌های جدید
.INDENT 0.0
.IP \(bu 2
افزودن too\-many\-positional\-arguments / R0917 \%<#\:too-many-positional-arguments> برای امکان تمایز بین پیکربندیِ تعداد بیش از حد
کل آرگومان‌ها (همراه با پارامترهای keyword\-only تعیین‌شده پس از \fI*\fP) از پیکربندی
تعداد بیش از حد آرگومان‌های positional\-or\-keyword یا positional\-only\&.
.sp
به عنوان بخشی از ارزیابی این‌که آیا این بررسی برای پروژهٔ شما مناسب است یا خیر، مطمئن شوید که
مقدار \fI\-\-max\-positional\-arguments\fP را تنظیم کنید\&.
.sp
بستن #9099 (#9099 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9099>)
.IP \(bu 2
افزودن using\-exception\-groups\-in\-unsupported\-version / W2603 \%<#\:using-exception-groups-in-unsupported-version> و
using\-generic\-type\-syntax\-in\-unsupported\-version / W2604 \%<#\:using-generic-type-syntax-in-unsupported-version> برای موارد استفاده از ویژگی‌های پایتون 3.11+ یا
3.12+ در نسخه‌های پشتیبانی‌شدهٔ پایین‌تر که با \fB\-\-py\-version\fP ارائه شده‌اند\&.
.sp
بستن #9791 (#9791 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9791>)
.IP \(bu 2
افزودن using\-assignment\-expression\-in\-unsupported\-version / W2605 \%<#\:using-assignment-expression-in-unsupported-version> برای موارد استفاده از \fB:=\fP (عملگر والروس / walrus)
در نسخه‌های پایتون پایین‌تر از 3.8 ارائه‌شده با \fB\-\-py\-version\fP\&.
.sp
بستن #9820 (#9820 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9820>)
.IP \(bu 2
افزودن using\-positional\-only\-args\-in\-unsupported\-version / W2606 \%<#\:using-positional-only-args-in-unsupported-version> برای موارد استفاده از آرگومان‌های positional\-only در
نسخه‌های پایتون پایین‌تر از 3.8 ارائه‌شده با \fB\-\-py\-version\fP\&.
.sp
بستن #9823 (#9823 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9823>)
.IP \(bu 2
افزودن unnecessary\-default\-type\-args / R6007 \%<#\:unnecessary-default-type-args> به افزونهٔ \fBtyping\fP برای تشخیص استفاده
از آرگومان‌های نوع پیش‌فرض غیرضروری برای \fBtyping.Generator\fP \%<https://\:docs\:.python\:.org/\:3/\:library/\:typing\:.html#\:typing\:.Generator> و \fBtyping.AsyncGenerator\fP \%<https://\:docs\:.python\:.org/\:3/\:library/\:typing\:.html#\:typing\:.AsyncGenerator>\&.
.sp
ارجاع به #9938 (#9938 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9938>)
.UNINDENT
.SS منفی‌های کاذب رفع‌شده
.INDENT 0.0
.IP \(bu 2
رفع محاسبهٔ تابع بازنگرداننده (never\-returning): افزون بر \fBtyping.NoReturn\fP \%<https://\:docs\:.python\:.org/\:3/\:library/\:typing\:.html#\:typing\:.NoReturn>، عبارت \fBtyping.Never\fP \%<https://\:docs\:.python\:.org/\:3/\:library/\:typing\:.html#\:typing\:.Never> نیز پشتیبانی می‌شود، و اولویت به گزینهٔ صریح \fI\-\-never\-returning\-functions\fP داده شده است\&.
.sp
بستن #7565. (#7565 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7565>)
.IP \(bu 2
رفع یک مورد منفی کاذب برای await\-outside\-async / E1142 \%<#\:await-outside-async> زمانی که await درون Lambda قرار دارد\&.
.sp
ارجاع به #9653 (#9653 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9653>)
.IP \(bu 2
رفع یک مورد منفی کاذب برای duplicate\-argument\-name / E0108 \%<#\:duplicate-argument-name> با گنجاندن آرگومان‌های \fBpositional\-only\fP، \fB*args\fP و \fB**kwargs\fP در این بررسی\&.
.sp
بستن #9669 (#9669 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9669>)
.IP \(bu 2
رفع منفی کاذب برای multiple\-statements / C0321 \%<#\:multiple-statements> در حالتی که چندین دستور در خطوط \fBelse\fP \%<https://\:docs\:.python\:.org/\:3/\:reference/\:compound_stmts\:.html#\:else> و \fBfinally\fP \%<https://\:docs\:.python\:.org/\:3/\:reference/\:compound_stmts\:.html#\:finally> از بلوک \fBtry\fP \%<https://\:docs\:.python\:.org/\:3/\:reference/\:compound_stmts\:.html#\:try> وجود داشته باشند\&.
.sp
ارجاع به #9759 (#9759 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9759>)
.IP \(bu 2
رفع موارد منفی کاذب هنگامی که :py:func::\fIisinstance\fP دقیقاً دو آرگومان ندارد\&.
اکنون pylint برای فراخوانی‌های \fBisinstance()\fP \%<https://\:docs\:.python\:.org/\:3/\:library/\:functions\:.html#\:isinstance>، به تناسب خطای too\-many\-function\-args / E1121 \%<#\:too-many-function-args> یا no\-value\-for\-parameter / E1120 \%<#\:no-value-for-parameter> را صادر می‌کند\&.
.sp
بستن #9847 (#9847 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9847>)
.UNINDENT
.SS رفع سایر باگ‌ها
.INDENT 0.0
.IP \(bu 2
استفاده از \fI\-\-enable\fP به همراه \fI\-\-disable=all\fP اکنون در صورت به‌کارگیری یک msg code ناشناخته، خطا ایجاد می‌کند\&. پیام‌های داخلی \fIpylint\fP دیگر تحت تأثیر \fI\-\-disable=all\fP قرار نمی‌گیرند\&.
.sp
بستن #9403 (#9403 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9403>)
.IP \(bu 2
عبارت‌های باقاعدهٔ غیرقابل کامپایل برای مسیرها در پیکربندی یا آرگومان‌های داده‌شده به pylint دیگر موجب کرش کردن برنامه نخواهند شد، بلکه
یک خطای argparse صادر کرده و در عوض پیام خطای حاصل از \fBre.compile\fP را نمایش می‌دهند\&.
.sp
بستن #9680 (#9680 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9680>)
.IP \(bu 2
رفع باگی که در آن فایل \fBtox.ini\fP حاوی پیکربندی pylint، در صورت موجود بودن در دایرکتوری جاری، نادیده گرفته می‌شد\&.
.sp
فایل‌های \fB\&.cfg\fP و \fB\&.ini\fP حاوی پیکربندی \fBPylint\fP اکنون می‌توانند از بخشی به نام \fB[pylint]\fP استفاده کنند\&. این بهبود بر حالتی تأثیر می‌گذارد که این نوع فایل‌ها در صورت موجود بودن و عدم ارجاع صریح با استفاده از گزینهٔ \fB\-\-rcfile\fP، به عنوان پیش‌فرض مورد استفاده قرار می‌گیرند\&.
.sp
بستن #9727 (#9727 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9727>)
.IP \(bu 2
بهبود شناسایی فایل‌ها برای دایرکتوری‌هایی که بسته‌های پایتون نیستند\&.
.sp
بستن #9764 (#9764 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9764>)
.UNINDENT.SS سایر تغییرات
.INDENT 0.0
.IP \(bu 2
حذف پشتیبانی از اجرای pylint با Python 3.8.
کدی که از Python 3.8 پشتیبانی می‌کند همچنان می‌تواند با تنظیم \fB\-\-py\-version=3.8\fP تحلیل (lint) شود.
.sp
ارجاع به #9774 (#9774 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9774>)
.IP \(bu 2
افزودن پشتیبانی از Python 3.13.
.sp
ارجاع به #9852 (#9852 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9852>)
.UNINDENT
.SS تغییرات داخلی
.INDENT 0.0
.IP \(bu 2
تمام متغیرها، کلاس‌ها، توابع و نام‌های فایلی که شامل واژهٔ \(aqsimilar\(aq بودند، در حالی که در واقع به \(aqsymilar\(aq (برنامهٔ مستقل برای بررسی duplicate\-code / R0801 \%<#\:duplicate-code>) اشاره داشتند، به \(aqsymilar\(aq تغییر نام داده شدند.
.sp
بستن #9734 (#9734 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9734>)
.IP \(bu 2
حذف کدهای مربوط به کلاس‌های سبک قدیم (Python 2) و حذف بررسی برای کلاس‌های سبک جدید؛ چرا که در Python 3 همه چیز سبک جدید (new\-style) است. مستندات بررسی‌کنندهٔ استثناها برای حذف ارجاع به کلاس سبک جدید به‌روزرسانی شد.
.sp
ارجاع به #9925 (#9925 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9925>)
.UNINDENT
.SS تغییرات جدید در Pylint 3.2
.INDENT 0.0
.TP
.B انتشار
3.2
.TP
.B تاریخ
اعلام خواهد شد (TBA)
.UNINDENT
.SS خلاصه \-\- نکات برجسته انتشار
.SS تغییرات جدید در Pylint 3.2.7؟
.sp
تاریخ انتشار: 2024\-08\-31
.SS هشدارهای مثبت کاذب برطرف‌شده
.INDENT 0.0
.IP \(bu 2
رفع هشدار مثبت کاذب \fIunreachable\fP برای توابع coroutine با نوع بازگشتی \fINoReturn\fP\&.
.sp
بستن #9840. (#9840 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9840>)
.UNINDENT
.SS سایر رفع اشکالات
.INDENT 0.0
.IP \(bu 2
رفع crash در بررسی‌کنندهٔ بازآفرینی کد (refactoring checker) هنگام فراخوانی یک lambda که به عنوان یک متد مقید (bound) شده است.
.sp
بستن #9865 (#9865 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9865>)
.IP \(bu 2
رفع crash در \fBundefined\-loop\-variable\fP هنگام ارائهٔ آرگومان \fBiterable\fP به \fBenumerate()\fP\&.
.sp
بستن #9875 (#9875 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9875>)
.IP \(bu 2
رفع خطای مربوط به عدم قطعیت در پیام خطا در حالتی که نام یک ماژول با ماژولی دیگر در یک فضای نام (namespace) جداگانه یکسان باشد.
.sp
ارجاع به #9883 (#9883 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9883>)
.UNINDENT
.SS تغییرات جدید در Pylint 3.2.6؟
.sp
تاریخ انتشار: 2024\-07\-21
.SS هشدارهای مثبت کاذب برطرف‌شده
.INDENT 0.0
.IP \(bu 2
خاموش‌سازی هشدارهای مثبت کاذب برای \fIunexpected\-keyword\-arg\fP هنگامی که pylint نمی‌تواند تشخیص دهد کدام‌یک از دو یا چند کلاس با تعریف پویا در حال نمونه‌سازی (instantiate) است.
.sp
بستن #9672 (#9672 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9672>)
.IP \(bu 2
رفع هشدار مثبت کاذب برای \fBmissing\-param\-doc\fP در جایی که انتظار می‌رفت متدی که با \fBtyping.overload\fP تزیین شده است، دارای یک docstring برای مشخص کردن پارامترهایش باشد.
.sp
بستن #9739 (#9739 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9739>)
.IP \(bu 2
رفع یک پس‌رفت (regression) که باعث صدور هشدار \fBinvalid\-name\fP برای صفات کلاسی می‌شد که صرفاً نام‌های نامعتبر یک کلاس والد (ancestor) را بازنویسی (override) می‌کردند.
.sp
بستن #9765 (#9765 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9765>)
.IP \(bu 2
رفتار یکسان با \fIassert_never()\fP هنگامی که از \fItyping_extensions\fP وارد (import) می‌شود.
.sp
بستن #9780 (#9780 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9780>)
.IP \(bu 2
رفع هشدار مثبت کاذب برای \fIconsider\-using\-min\-max\-builtin\fP هنگامی که مقصد انتساب یک صفت (attribute) است.
.sp
ارجاع به #9800 (#9800 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9800>)
.UNINDENT.SS سایر رفع باگ‌ها
.INDENT 0.0
.IP \(bu 2
رفع خطای \fIAssertionError\fP ناشی از ویژگی‌هایی (property) که توابع جزئی (partial functions) بازمی‌گردانند.
.sp
بسته شد #9214 (#9214 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9214>)
.IP \(bu 2
رفع کرش هنگامی که یک زیرکلاس \fB__slots__\fP را گسترش می‌دهد.
.sp
بسته شد #9814 (#9814 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9814>)
.UNINDENT
.SS تازه‌های Pylint 3.2.5
.sp
تاریخ انتشار: 2024\-06\-28
.SS سایر رفع باگ‌ها
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب \fBunreachable\-code\fP هنگام استفاده از \fBtyping.Any\fP به‌عنوان نوع بازگشتی در python 3.8؛ با این حال \fBtyping.NoReturn\fP دیگر برای python 3.8 در نظر گرفته نمی‌شود.
.sp
بسته شد #9751 (#9751 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9751>)
.UNINDENT
.SS تازه‌های Pylint 3.2.4
.sp
تاریخ انتشار: 2024\-06\-26
.SS رفع مثبت‌های کاذب
.INDENT 0.0
.IP \(bu 2
جلوگیری از صدور \fBpossibly\-used\-before\-assignment\fP هنگام اتکا به نام‌هایی که صرفاً احتمالاً در بلوک‌های شرطیِ محافظت‌شده توسط توابع دارای حاشیه‌نویسی \fBtyping.Never\fP یا \fBtyping.NoReturn\fP تعریف نشده‌اند.
.sp
بسته شد #9674 (#9674 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9674>)
.UNINDENT
.SS سایر رفع باگ‌ها
.INDENT 0.0
.IP \(bu 2
رفع کرش هنگامی که شماره خط (lineno) متغیری که به‌عنوان حاشیه‌نویسی استفاده شده بود برای \fBundefined\-variable\fP در دسترس نبود.
.sp
بسته شد #8866 (#8866 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8866>)
.IP \(bu 2
رفع کرش هنگامی که مقدار \fBstart\fP در یک \fBenumerate\fP غیرثابت و استنتاج آن غیرممکن بود (مانند \(ga\(gaenumerate(apples, start=int(random_apple_index)\(ga\(ga) برای \fBunnecessary\-list\-index\-lookup\fP\&.
.sp
بسته شد #9078 (#9078 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9078>)
.IP \(bu 2
رفع کرش در \fBsymilar\fP هنگامی که گزینه کوتاه \fB\-d\fP یا \fB\-i\fP به‌درستی شناخته نمی‌شد. هنوز انجام \fB\-d=1\fP غیرممکن است (باید از \fB\-d 1\fP استفاده کنید).
.sp
بسته شد #9343 (#9343 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9343>)
.UNINDENT
.SS تازه‌های Pylint 3.2.3
.sp
تاریخ انتشار: 2024\-06\-06
.SS رفع مثبت‌های کاذب
.INDENT 0.0
.IP \(bu 2
کلاس‌هایی که تنها یک سه‌نقطه (\fB\&...\fP) در بدنهٔ خود دارند، در صورت تک‌خطی بودن (مطابق با شیوه‌نامهٔ ۲۰۲۴ ابزار black) دیگر هشدار multiple\-statements / C0321 \%<#\:multiple-statements>\(aq را برنمی‌انگیزند.
.sp
بسته شد #9398 (#9398 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9398>)
.IP \(bu 2
رفع مثبت کاذب برای \fBredefined\-outer\-name\fP هنگامی که نامی در یک بلوک مدیریت استثنا تعریف شده که با یک متغیر محلیِ تعریف‌شده در بدنهٔ تابع هم‌نام است.
.sp
بسته شد #9671 (#9671 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9671>)
.IP \(bu 2
رفع مثبت کاذب برای \fBuse\-yield\-from\fP هنگام استفاده از مقدار بازگشتیِ اتمِ \fByield\fP\&.
.sp
بسته شد #9696 (#9696 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9696>)
.UNINDENT
.SS تازه‌های Pylint 3.2.2
.sp
تاریخ انتشار: 2024\-05\-20
.SS رفع مثبت‌های کاذب
.INDENT 0.0
.IP \(bu 2
رفع چندین مثبت کاذب برای نحو کلاس جامع (generic class syntax) که در Python 3.12 (PEP 695) اضافه شده است.
.sp
بسته شد #9406 (#9406 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9406>)
.IP \(bu 2
مستثنی کردن مدیر زمینه (context manager) بدون پاک‌سازی از بررسی‌های \fBcontextmanager\-generator\-missing\-cleanup\fP\&.
.sp
بسته شد #9625 (#9625 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9625>)
.UNINDENT.SS در Pylint 3.2.1 چه مواردی جدید است؟
.sp
تاریخ انتشار: 2024\-05\-18
.SS مثبت‌های کاذب رفع‌شده
.INDENT 0.0
.IP \(bu 2
مستثنی کردن شاخه‌های if/else حاوی توابع پایان‌دهنده (مانند \fIsys.exit()\fP)
از بررسی‌های \fIpossibly\-used\-before\-assignment\fP.
.sp
بسته شد #9627 (#9627 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9627>)
.IP \(bu 2
عدم صدور هشدارهای \fBtypevar\-name\-incorrect\-variance\fP برای TypeVarهای سبک PEP 695.
تغییرپذیری (variance) به‌طور خودکار توسط بررسی‌کننده نوع استنتاج می‌شود.
افزودن پسوند \fB_co\fP یا \fB_contra\fP می‌تواند به استدلال در مورد TypeVar کمک کند.
.sp
ارجاع به #9638 (#9638 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9638>)
.IP \(bu 2
رفع یک مثبت کاذب برای \fIpossibly\-used\-before\-assignment\fP هنگام استفاده از
\fItyping.assert_never()\fP (نسخه 3.11+) برای نشان دادن جامعیت (exhaustiveness).
.sp
بسته شد #9643 (#9643 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9643>)
.UNINDENT
.SS سایر رفع باگ‌ها
.INDENT 0.0
.IP \(bu 2
رفع یک منفی کاذب برای \fB\-\-ignore\-patterns\fP هنگامی که دایرکتوری مورد بررسی با نقطه (\fB\&.\fP) مشخص شده و همه فایل‌ها نادیده گرفته می‌شوند، به جای اینکه فقط فایل‌هایی که نامشان با نقطه آغاز می‌شود نادیده گرفته شوند.
.sp
بسته شد #9273 (#9273 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9273>)
.IP \(bu 2
بازگرداندن بخش \(dqerrors / warnings by module\(dq به خروجی گزارش (با \fI\-ry\fP).
.sp
بسته شد #9145 (#9145 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9145>)
.IP \(bu 2
هشدار \fBtrailing\-comma\-tuple\fP اکنون پس از حذف یک بهینه‌سازی بیش‌ازحد، در صورتی که به‌صورت سراسری غیرفعال ولی از طریق کنترل محلی پیام فعال شده باشد، باید به‌درستی صادر شود.
.sp
ارجاع به #9608. (#9608 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9608>)
.IP \(bu 2
افزودن گزینه \fI\-\-prefer\-stubs=yes\fP برای فعال‌سازی اختیاری قابلیت astroid 3.2
که فایل‌های خرد (stub) \fI\&.pyi\fP را به فایل‌های همنام \fI\&.py\fP ترجیح می‌دهد. این کار
پتانسیل کاهش خطاهای \fIno\-member\fP را دارد، اما به قیمت خطاهای بیشتری
مانند \fInot\-an\-iterable\fP از بدنه توابعی که به صورت \fI\&...\fP ظاهر می‌شوند تمام می‌شود.
.sp
پیش‌فرض \fIno\fP است\&.
.sp
بسته شد #9626
بسته شد #9623 (#9626 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9626>)
.UNINDENT
.SS تغییرات داخلی
.INDENT 0.0
.IP \(bu 2
به‌روزرسانی نسخه astroid به 3.2.1. این کار برخی گزارش‌های \fBRecursionError\fP را حل کرده
و همچنین ویژگی \fIprefer .pyi stubs\fP را در astroid 3.2.0 با گزینه پیش‌گفته \fB\-\-prefer\-stubs=y\fP
به‌صورت اختیاری (\fIopt\-in\fP) درمی‌آورد.
.sp
ارجاع به #9139 (#9139 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9139>)
.UNINDENT
.SS در Pylint 3.2.0 چه مواردی جدید است؟
.sp
تاریخ انتشار: 2024\-05\-14
.SS قابلیت‌های جدید
.INDENT 0.0
.IP \(bu 2
درک \fIsix.PY2\fP و \fIsix.PY3\fP برای وارد کردن‌های شرطی (conditional imports).
.sp
بسته شد #3501 (#3501 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3501>)
.IP \(bu 2
یک گزارشگر جدید \fIgithub\fP اضافه شده است. این گزارشگر خروجی \fIpylint\fP را در قالبی بازمی‌گرداند که
Github می‌تواند برای حاشیه‌نویسی خودکار کد از آن استفاده کند. از آن با \fIpylint \-\-output\-format=github\fP در Github Workflows خود استفاده کنید.
.sp
بسته شد #9443. (#9443 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9443>)
.UNINDENT
.SS بررسی‌های جدید
.INDENT 0.0
.IP \(bu 2
افزودن بررسی \fBpossibly\-used\-before\-assignment\fP هنگام اتکا به نام‌ها پس از ساختار شرطی
\fBif/else\fP، در حالتی که یکی از شاخه‌ها نتواند نام را تعریف کند، استثنا ایجاد کند (raise)، یا مقداری بازگرداند (return).
.sp
بسته شد #1727 (#1727 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:1727>)
.IP \(bu 2
بررسی مولدهایی (generators) که از contextmanagerهایی استفاده می‌کنند که پاک‌سازی را به‌درستی انجام نمی‌دهند.
هدف این بررسی، آگاهی‌بخشی در مواردی است که یک مولد به‌طور کامل مصرف (exhaust) نمی‌شود و contextmanager به‌درستی پاک‌سازی نمی‌گردد.
یک contextmanager باید مقداری غیرثابت تولید کند (yield) و پاک‌سازی را برای GeneratorExit انجام ندهد.
مولدِ استفاده‌کننده باید تلاش کند تا از مقدار زمینه تولیدشده با \fIwith x() as y\fP استفاده کند و نه صرفاً با \fIwith x()\fP\&.
.sp
بسته شد #2832 (#2832 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:2832>)
.UNINDENT.SS "منفی‌های کاذب برطرف‌شده (False Negatives Fixed)"
.INDENT 0.0
.IP \(bu 2
گره‌های If و Try اکنون برای دستورهای return بلااستفاده نیز بررسی می‌شوند.
.sp
بسته شدن #9449. (#9449 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9449>)
.IP \(bu 2
رفع منفی کاذب برای \fBproperty\-with\-parameters\fP در مواردی که پارامترها به صورت \fBpositional\-only\fP، \fBkeyword\-only\fP، \fBvariadic positional\fP یا \fBvariadic keyword\fP هستند\&.
.sp
بسته شدن #9584 (#9584 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9584>)
.UNINDENT
.SS "مثبت‌های کاذب برطرف‌شده (False Positives Fixed)"
.sp
اکنون pylint مقادیر بازگشتی دکوراتور \fB@overload\fP را بهتر درک می‌کند.
.sp
بسته شدن #4696 (#4696 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:4696>)
ارجاع به #9606 (#9606 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9606>)
.SS "بهبودهای کارایی (Performance Improvements)"
.INDENT 0.0
.IP \(bu 2
ماژول‌های نادیده‌گرفته‌شده اکنون به‌جای اینکه ابتدا بررسی و سپس نادیده گرفته شوند، دیگر اصلاً بررسی نمی‌شوند. این امر باید سرعت تحلیل پایگاه‌کدهای بزرگی را که دارای ماژول‌های نادیده‌گرفته‌شده هستند، افزایش دهد.
.sp
بسته شدن #9442 (#9442 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9442>) (#9442 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9442>)
.IP \(bu 2
منطق ImportChecker اصلاح شده است تا در صورت امکان از context files اجتناب کند. این تغییر، کش‌کردن جستجوهای ماژول را در astroid ممکن ساخته و زمان اجرا را کاهش می‌دهد.
.sp
ارجاع به #9310. (#9310 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9310>)
.IP \(bu 2
بررسی داخلی برای فعال بودن یا نبودن \fBtrailing\-comma\-tuple\fP برای یک فایل، اکنون به‌جای اینکه برای هر نشانه (token) یک بار انجام شود، یک بار به ازای هر فایل انجام می‌شود.
.sp
ارجاع به #9608. (#9608 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9608>)
.UNINDENT
.SS "تازه‌های Pylint 3.1 (What\(aqs New in Pylint 3.1)"
.INDENT 0.0
.TP
.B انتشار
3.1
.TP
.B تاریخ
2024\-02\-25
.UNINDENT
.SS "خلاصه \-\- نکات برجسته انتشار (Summary \-\- Release highlights)"
.sp
دو بررسی جدید \-\- \fBuse\-yield\-from\fP، \fBdeprecated\-attribute\fP \-\-
و تعدادی رفع اشکال.
.SS "تازه‌های Pylint 3.1.1 (What\(aqs new in Pylint 3.1.1)؟"
.sp
تاریخ انتشار: 2024\-05\-13
.SS "مثبت‌های کاذب برطرف‌شده (False Positives Fixed)"
.INDENT 0.0
.IP \(bu 2
در نظر گرفتن \fIattrs.define\fP و \fIattrs.frozen\fP به‌عنوان دکوراتورهای dataclass در بررسی \fItoo\-few\-public\-methods\fP\&.
.sp
بسته شدن #9345 (#9345 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9345>)
.IP \(bu 2
رفع یک مثبت کاذب در \fBsingledispatchmethod\-function\fP هنگامی که یک متد هم با \fBfunctools.singledispatchmethod\fP و هم با \fBstaticmethod\fP تزیین شده باشد\&.
.sp
بسته شدن #9531 (#9531 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9531>)
.IP \(bu 2
رفع یک مثبت کاذب برای \fBconsider\-using\-dict\-items\fP هنگام پیمایش با استفاده از \fBkeys()\fP و سپس حذف یک مورد با استفاده از کلید برای جستجو (lookup)\&.
.sp
بسته شدن #9554 (#9554 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9554>)
.UNINDENT
.SS "تازه‌های Pylint 3.1.0 (What\(aqs new in Pylint 3.1.0)؟"
.sp
تاریخ انتشار: 2024\-02\-25
.SS "قابلیت‌های جدید (New Features)"
.INDENT 0.0
.IP \(bu 2
صرف‌نظر کردن از بررسی \fBconsider\-using\-join\fP برای جداکننده‌های غیرخالی در صورتی که گزینه \fBsuggest\-join\-with\-non\-empty\-separator\fP روی \fBno\fP تنظیم شده باشد\&.
.sp
بسته شدن #8701 (#8701 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8701>)
.IP \(bu 2
شناسایی فایل‌های \fB\&.pyi\fP هنگام بررسی کد (linting)\&.
.sp
این فایل‌ها را می‌توان با استفاده از تنظیمات \fBignore\-patterns\fP نادیده گرفت.
.sp
بسته شدن #9097 (#9097 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9097>)
.IP \(bu 2
بررسی گره‌های \fBTypeAlias\fP و \fBTypeVar\fP (PEP 695) برای \fBinvalid\-name\fP\&.
.sp
ارجاع به #9196 (#9196 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9196>)
.IP \(bu 2
پشتیبانی از یافتن فایل‌های خارجی toml با نام‌های pylintrc.toml و .pylintrc.toml.
.sp
بسته شدن #9228 (#9228 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9228>)
.IP \(bu 2
بررسی فراخوانی متدهای \fI\&.clear\fP، \fI\&.discard\fP، \fI\&.pop\fP و \fIremove\fP روی یک مجموعه (set) در حین پیمایش آن\&.
.sp
بسته شدن #9334 (#9334 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9334>)
.UNINDENT.SS "بررسی‌های جدید (New Checks)"
.INDENT 0.0
.IP \(bu 2
پیام جدید \fIuse\-yield\-from\fP به بازبین بازآرایی (refactoring checker) افزوده شد. این پیام زمانی صادر می‌شود که بتوان ساختار yielding در یک حلقه را با \fIyield from\fP جایگزین کرد.
.sp
بسته شدن #9229. (#9229 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9229>)
.IP \(bu 2
پیام \fBdeprecated\-attribute\fP برای بررسی ویژگی‌های منسوخ‌شده در کتابخانه استاندارد (stdlib) افزوده شد.
.sp
بسته شدن #8855 (#8855 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8855>)
.UNINDENT
.SS "رفع موارد مثبت کاذب (False Positives Fixed)"
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب برای \fBinherit\-non\-class\fP در Protocolهای عمومی (generic).
.sp
بسته شدن #9106 (#9106 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9106>)
.IP \(bu 2
معاف شدن \fBTypedDict\fP از بسته \fBtyping_extensions\fP از بررسی‌های \fBtoo\-many\-ancestor\fP.
.sp
ارجاع به #9167 (#9167 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9167>)
.UNINDENT
.SS "رفع موارد منفی کاذب (False Negatives Fixed)"
.INDENT 0.0
.IP \(bu 2
گسترش پیام‌های broad\-exception\-raised / W0719 \%<#\:broad-exception-raised> و broad\-exception\-caught / W0718 \%<#\:broad-exception-caught> به دستور *except.
.sp
بسته شدن #8827 (#8827 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8827>)
.IP \(bu 2
رفع یک مورد منفی کاذب برای بلوک‌های غیرضروری if که از ترتیبی از آرگومان‌ها متفاوت از مقدار مورد انتظار استفاده می‌کردند.
.sp
بسته شدن #8947. (#8947 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8947>)
.UNINDENT
.SS "سایر رفع اشکال‌ها (Other Bug Fixes)"
.INDENT 0.0
.IP \(bu 2
بهبود پیام ارائه‌شده برای بررسی wrong\-import\-order / C0411 \%<#\:wrong-import-order>. به جای دستور واردکردن (\(dqimport x\(dq)، اکنون پیام مشخص می‌کند که کدام واردکردن خارج از ترتیب است و چه مواردی باید پس از آن قرار گیرند. همان‌طور که در گزارش اشکال مطرح شده بود، این تغییر به‌ویژه زمانی مفید است که چندین واردکردن در یک خط قرار دارند و از قرارداد PEP8 پیروی نمی‌کنند.
.sp
پیامْ موارد واردکردن را به صورت زیر گزارش خواهد کرد:
برای \(dqimport X\(dq، پیام \(dq(standard/third party/first party/local) import X\(dq گزارش می‌شود
برای \(dqimport X.Y\(dq و \(dqfrom X import Y\(dq، پیام \(dq(standard/third party/first party/local) import X.Y\(dq گزارش می‌شود
دسته‌بندی واردکردن به این منظور مشخص شده است تا دلیل صدور پیام توسط pylint توضیح داده شود و توسعه‌دهنده برای نحوه رفع مشکل راهنمایی گردد.
.sp
بسته شدن #8808 (#8808 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8808>)
.UNINDENT
.SS "سایر تغییرات (Other Changes)"
.INDENT 0.0
.IP \(bu 2
چاپ تعداد فایل‌های بررسی‌شده در حالت پرگو (verbose).
.sp
بسته شدن #8935 (#8935 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8935>)
.IP \(bu 2
رفع خرابی (crash) هنگامی که یک کلاس enum که با دکوراتور \fBdataclasses.dataclass\fP تزیین شده است تعریف می‌شود.
.sp
بسته شدن #9100 (#9100 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9100>)
.UNINDENT
.SS "تغییرات داخلی (Internal Changes)"
.INDENT 0.0
.IP \(bu 2
به‌روزرسانی نسخه astroid به 3.1.0.
.sp
ارجاع به #9457 (#9457 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9457>)
.UNINDENT
.SS "تازه‌های Pylint 3.0 (What\(aqs New in Pylint 3.0)"
.INDENT 0.0
.TP
.B انتشار (Release)
3.0.0
.TP
.B تاریخ (Date)
2023\-10\-02
.UNINDENT
.SS "خلاصه \-\- نکات برجسته انتشار (Summary \-\- Release highlights)"
.sp
ابزار Pylint اکنون به‌طور رسمی از python 3.12 پشتیبانی می‌کند.
.sp
این نسخه اصلی که مدت‌ها در انتظار آن بودیم، علاوه بر اعمال تغییرات ساختارشکن (breaking changes) ضروری و منسوخ‌سازی‌هایی که از مدت‌ها پیش اعلام شده بود، بهبودهای مهمی در قابلیت استفاده و کارایی به همراه دارد. همچنین مستندسازی هر پیام به همراه مثال در آستانه تکمیل است.
.sp
نسخه موردنیاز \fBastroid\fP اکنون 3.0.0 است. برای اطلاع از رفع اشکال‌ها، ویژگی‌ها و بهبودهای کارایی مضاعف قابل اعمال روی pylint، به یادداشت‌های تغییرات astroid در \%<https://\:pylint\:.readthedocs\:.io/\:projects/\:astroid/\:en/\:latest/\:changelog\:.html#\:what-s-new-in-astroid-3-0-0> مراجعه کنید.
.sp
کد پروژه اکنون به طور کامل با اعلان نوع مشخص شده است (fully typed). پیام \fBinvalid\-name\fP دیگر به‌طور پیش‌فرض حداقل طول ۳ نویسه را بررسی نمی‌کند. وابستگی‌هایی مانند wrapt یا setuptools حذف شدند.
.sp
یک گزارش‌گر جدید به نام \fBjson2\fP اضافه شده است. این گزارش‌گر خروجی غنی‌تری ارائه می‌دهد که تجزیه آن ساده‌تر است و اطلاعات بیشتری فراهم می‌کند؛ در ادامه یک نمونه خروجی آمده است:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
{
    \(dqmessages\(dq: [
        {
            \(dqtype\(dq: \(dqconvention\(dq,
            \(dqsymbol\(dq: \(dqline\-too\-long\(dq,
            \(dqmessage\(dq: \(dqLine too long (1/2)\(dq,
            \(dqmessageId\(dq: \(dqC0301\(dq,
            \(dqconfidence\(dq: \(dqHIGH\(dq,
            \(dqmodule\(dq: \(dq0123\(dq,
            \(dqobj\(dq: \(dq\(dq,
            \(dqline\(dq: 1,
            \(dqcolumn\(dq: 0,
            \(dqendLine\(dq: 1,
            \(dqendColumn\(dq: 4,
            \(dqpath\(dq: \(dq0123\(dq,
            \(dqabsolutePath\(dq: \(dq0123\(dq
        }
    ],
    \(dqstatistics\(dq: {
        \(dqmessageTypeCount\(dq: {
            \(dqfatal\(dq: 0,
            \(dqerror\(dq: 0,
            \(dqwarning\(dq: 0,
            \(dqrefactor\(dq: 0,
            \(dqconvention\(dq: 1,
            \(dqinfo\(dq: 0
        },
        \(dqmodulesLinted\(dq: 1,
        \(dqscore\(dq: 5.0
    }
}
.EE
.UNINDENT
.UNINDENT.SS تازه‌های Pylint 3.0.4 چیست؟
.sp
تاریخ انتشار: 2024\-02\-23
.SS هشدارهای نادرست برطرف‌شده (False Positives Fixed)
.INDENT 0.0
.IP \(bu 2
هشدار \fBused\-before\-assignment\fP دیگر هنگام استفاده از یک نام در حلقه و وابستگی به انتساب قبلی آن نام در یک بلوک \fBexcept\fP جفت‌شده با \fBelse: continue\fP صادر نمی‌شود\&.
.sp
بستن #6804 (#6804 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6804>)
.IP \(bu 2
جلوگیری از هشدارهای نادرست برای \fBno\-member\fP مربوط به ویژگی‌های تابع که توسط دکوراتورها فراهم شده‌اند\&.
.sp
بستن #9246 (#9246 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9246>)
.IP \(bu 2
رفع هشدار نادرست nested\-min\-max / W3301 \%<#\:nested-min-max> برای لیست‌های تو در تو\&.
.sp
بستن #9307 (#9307 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9307>)
.IP \(bu 2
رفع هشدار نادرست برای \fBused\-before\-assignment\fP در بلوک \fBfinally\fP هنگامی که انتساب‌ها هم در بلوک \fBtry\fP و هم در هر یک از گرداننده‌های استثنا صورت گرفته باشند\&.
.sp
بستن #9451 (#9451 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9451>)
.UNINDENT
.SS سایر باگ‌های برطرف‌شده (Other Bug Fixes)
.INDENT 0.0
.IP \(bu 2
گرفتن خطای نادرست ValueError با عنوان \fB\(dqgenerator already executing\(dq\fP برای Python 3.12.0 \- 3.12.2\&.
این مورد در بالادست (upstream) در Python 3.12.3 برطرف شده است\&.
.sp
بستن #9138 (#9138 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9138>)
.UNINDENT
.SS تازه‌های Pylint 3.0.3 چیست؟
.sp
تاریخ انتشار: 2023\-12\-11
.SS هشدارهای نادرست برطرف‌شده (False Positives Fixed)
.INDENT 0.0
.IP \(bu 2
رفع هشدار نادرست برای \fBunnecessary\-lambda\fP هنگامی که فراخوانی دارای آرگومان‌های کلیدواژه‌ای است اما تابع lambda فاقد آن است\&.
.sp
بستن #9148 (#9148 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9148>)
.IP \(bu 2
رفع پیشنهاد نادرست برای رونوشت سطحی (shallow copy) در unnecessary\-comprehension / R1721 \%<#\:unnecessary-comprehension>
.sp
نمونه‌ای از پیشنهاد:
#pylint: disable=:ref:\fImissing\-module\-docstring\fP
a = [1, 2, 3]
b = [x for x in a]
b[0] = 0
print(a) # [1, 2, 3]
.sp
پس از تغییر b = [x for x in a] به b = a بر پایهٔ این پیشنهاد، اسکریپت اکنون مقدار [0, 2, 3] را چاپ می‌کند\&. پیشنهاد درست برای حفظ رفتار اصلی باید استفاده از list(a) باشد\&.
.sp
بستن #9172 (#9172 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9172>)
.IP \(bu 2
رفع هشدارهای نادرست برای \fBundefined\-variable\fP و \fBunused\-argument\fP برای کلاس‌ها و توابعی که از نحو نوع جنریک در Python 3.12 استفاده می‌کنند\&.
.sp
بستن #9193 (#9193 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9193>)
.IP \(bu 2
رفع هشدار نادرست \fBpointless\-string\-statement\fP برای رشته‌های مستندات (docstrings) در نام‌های مستعار نوع (type aliases) در Python 3.12\&.
.sp
بستن #9268 (#9268 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9268>)
.IP \(bu 2
رفع هشدار نادرست برای \fBinvalid\-exception\-operation\fP هنگام الحاق تاپل‌هایی از انواع استثنا\&.
.sp
بستن #9288 (#9288 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9288>)
.UNINDENT
.SS سایر باگ‌های برطرف‌شده (Other Bug Fixes)
.INDENT 0.0
.IP \(bu 2
رفع باگی که در آن pylint در صورت وجود فایل \fI__init__.py\fP در یک دایرکتوری، قادر به پیمایش بازگشتی در آن دایرکتوری نبود\&.
.sp
بستن #9210 (#9210 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9210>)
.UNINDENT.SS تازه‌های Pylint 3.0.2
.sp
تاریخ انتشار: 2023\-10\-22
.SS رفع موارد مثبت کاذب
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب \fBused\-before\-assignment\fP برای نحو نوع‌های جنریک (PEP 695، Python 3.12).
.sp
بسته‌شده در #9110 (#9110 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9110>)
.UNINDENT
.SS سایر رفع اشکال‌ها
.INDENT 0.0
.IP \(bu 2
گریز دادن (escape) نمادهای خاص و خطوط جدید در پیام‌ها.
.sp
بسته‌شده در #7874 (#7874 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7874>)
.IP \(bu 2
اصلاح پیشنهاد برای \fBnested\-min\-max\fP در عبارت‌های دارای عملگرهای جمعی، و جامع‌سازهای فهرست و دیکشنری (list and dict comprehensions).
.sp
بسته‌شده در #8524 (#8524 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8524>)
.IP \(bu 2
اصلاح نادیده گرفتن واردکردن‌های شرطی با \fBignore\-imports=y\fP\&.
.sp
بسته‌شده در #8914 (#8914 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8914>)
.IP \(bu 2
صدور \fBinconsistent\-quotes\fP برای f\-stringها در مفسر 3.12 تنها در صورتی که نسخه‌های پیش از 3.12 هدف باشند.
.sp
بسته‌شده در #9113 (#9113 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9113>)
.UNINDENT
.SS تازه‌های Pylint 3.0.1
.sp
تاریخ انتشار: 2023\-10\-05
.SS رفع موارد مثبت کاذب
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب برای \fBinherit\-non\-class\fP در Protocolهای نوع عام (generic Protocols).
.sp
بسته‌شده در #9106 (#9106 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9106>)
.UNINDENT
.SS سایر تغییرات
.INDENT 0.0
.IP \(bu 2
رفع یک فروپاشی (crash) هنگام تعریف کلاس enum که هم‌زمان با دکوراتور \fBdataclasses.dataclass\fP تزیین شده است.
.sp
بسته‌شده در #9100 (#9100 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9100>)
.UNINDENT
.SS تازه‌های Pylint 3.0.0
.sp
تاریخ انتشار: 2023\-10\-02
.SS تغییرات ناسازگار (Breaking Changes)
.INDENT 0.0
.IP \(bu 2
فعال‌سازی یا غیرفعال‌سازی پیام‌های مجزا اکنون حتی در صورتی که به دنبال آن‌ها \fB\-\-enable=all\fP یا \fBdisable=all\fP در همان فایل پیکربندی (یا در خط فرمان) بیاید، اِعمال خواهد شد.
.sp
این بدان معناست که در مثال زیر، پیام‌های \fBfixme\fP اکنون صادر خواهند شد:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
pylint my_module \-\-enable=fixme \-\-disable=all
.EE
.UNINDENT
.UNINDENT
.sp
برای بازگشت به رفتار پیشین، گزینهٔ زائد قبلی را حذف کنید.
.sp
بسته‌شده در #3696 (#3696 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3696>)
.IP \(bu 2
حذف پشتیبانی از اجرای pylint با Python 3.7.
کدی که از Python 3.7 پشتیبانی می‌کند کماکان با تنظیم \fB\-\-py\-version=3.7\fP قابل تحلیل و ارزیابی است.
.sp
ارجاع به #6306 (#6306 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6306>)
.IP \(bu 2
غیرفعال‌سازی‌های قرار داده شده در یک بلوک \fBtry\fP اکنون روی بلوک \fBexcept\fP نیز اِعمال می‌شوند.
پیش از این، این اتفاق تنها در صورت حضور یک بند \fBelse\fP رخ می‌داد.
.sp
ارجاع به #7767 (#7767 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7767>)
.IP \(bu 2
اکنون \fIpyreverse\fP از یک پالت رنگی پیش‌فرض جدید استفاده می‌کند که برای افراد مبتلا به کوررنگی مناسب‌تر است.
طرح رنگ از یادداشت‌های Paul Tol در \%<https://\:personal\:.sron\:.nl/\:~pault>\& برگرفته شده است.
اگر رنگ‌های دیگری را ترجیح می‌دهید، می‌توانید از گزینهٔ \fI\-\-color\-palette\fP برای مشخص کردن رنگ‌های سفارشی استفاده کنید.
.sp
بسته‌شده در #8251 (#8251 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8251>)
.IP \(bu 2
تمام موارد مرتبط با ساختار \fB__implements__\fP حذف شد. این ساختار بر پایهٔ PEP245 بود
که در سال ۲۰۰۱ پیشنهاد و در سال ۲۰۰۶ رد شد.
.sp
قابلیت pyreverse برای در نظر گرفتن \fB__implements__\fP هنگام تولید نمودارها نیز حذف گردید.
.sp
ارجاع به #8404 (#8404 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8404>)
.IP \(bu 2
\fBpyreverse\fP: پشتیبانی از قالب خروجی \fB\&.vcg\fP ‏(Visualization of Compiler Graphs) کنار گذاشته شد.
.sp
بسته‌شده در #8416 (#8416 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8416>)
.IP \(bu 2
هشدار مربوط به یافت شدن دایرکتوری قدیمی و اکنون بلااستفادهٔ حافظهٔ پنهان pylint ‏(pylint.d) حذف شد. دایرکتوری حافظهٔ پنهان در
بخش FAQ \%<https://\:pylint\:.readthedocs\:.io/\:en/\:latest/\:faq\:.html#\:where-is-the-persistent-data-stored-to-compare-between-successive-runs>\& مستند شده است.
.sp
ارجاع به #8462 (#8462 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8462>)
.IP \(bu 2
پس از یک دورهٔ منسوخ‌سازی (deprecation)، \fBpylint.config.PYLINTRC\fP حذف شد.
به‌جای آن از مولد \fBpylint.config.find_default_config_files\fP استفاده کنید.
.sp
بسته‌شده در #8862 (#8862 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8862>)
.UNINDENT.SS "تغییرات نیازمند اقدام کاربر (Changes requiring user actions)"
.INDENT 0.0
.IP \(bu 2
پیام \fBinvalid\-name\fP به‌طور پیش‌فرض دیگر حداقل طول ۳ نویسه را بررسی نمی‌کند.
(این مورد یک درهم‌آمیختگیِ ناگفته میان دغدغه‌های مربوط به بزرگی و کوچکی حروف (casing)
و طول نام بود و کاربران مرتباً گزارش می‌دادند که این رفتار غافلگیرکننده است.)
.sp
اگر همچنان بررسی حداقل طول مد نظر باشد، می‌توان آن را به دو روش بازگرداند:
.INDENT 2.0
.IP \(bu 2
اگر دریافت پیام \fBdisallowed\-name\fP (به‌جای
\fBinvalid\-name\fP) برای شما کافی است، صرفاً گزینهٔ \fBbad\-names\-rgxs=\(dq^..?$\(dq\fP را اضافه کنید
که نام‌های دارای ۱ تا ۲ نویسه را رد می‌کند. (اطمینان حاصل کنید که
\fBdisallowed\-name\fP را فعال کرده باشید\&.)
.IP \(bu 2
اگر ترجیح می‌دهید پیام \fBinvalid\-name\fP صادر شود، یا مایلید
کنترل دقیق‌تری بر شرایط صدور پیام‌ها داشته باشید
(کلاس‌ها در برابر متدها و غیره)، از گزینه‌های عبارت منظم (regex) شرح داده شده
در اینجا استفاده کنید: \%<https://\:pylint\:.readthedocs\:.io/\:en/\:stable/\:user_guide/\:configuration/\:all-options\:.html#\:main-checker>\&.
(به‌ویژه به گزینه‌های غیرفعال‌شده (کامنت‌شده) در «پیکربندی نمونه» ارائه‌شده در پایین آن بخش توجه فرمایید.) عبارات منظم پیشین را می‌توان در
درخواست ادغام (pull request) به نشانی \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:pull/\:8813>
که الزامات طول را حذف کرده است، یافت.
.UNINDENT
.sp
بسته شد #2018 (#2018 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:2018>)
.IP \(bu 2
بررسی‌کنندهٔ مقایسه با رشتهٔ خالی (\fBpylint.extensions.emptystring\fP) و بررسی‌کنندهٔ مقایسه با
صفر (\fBpylint.extensions.compare\-to\-zero\fP) حذف شده‌اند و بررسی‌های آن‌ها اکنون
بخشی از بررسی‌کنندهٔ مقادیر بولی ضمنی (implicit booleaness) است:
.INDENT 2.0
.IP \(bu 2
نام \fBcompare\-to\-zero\fP به \fBuse\-implicit\-booleaness\-not\-comparison\-to\-zero\fP و
نام \fBcompare\-to\-empty\-string\fP به \fBuse\-implicit\-booleaness\-not\-comparison\-to\-string\fP
تغییر یافت و اکنون باید به‌صورت صریح فعال شوند.
.IP \(bu 2
افزونه‌های \fBpylint.extensions.emptystring\fP و \fBpylint.extensions.compare\-to\-zero\fP
دیگر وجود ندارند و باید از گزینهٔ \fBload\-plugins\fP حذف شوند.
.IP \(bu 2
پیام‌های مربوط به مقادیر بولی ضمنی واضح‌تر و کاربردی‌تر شده‌اند.
این کار امکان شفاف‌سازی شباهت‌های آن‌ها را فراهم کرده و با توجه به این‌که بیشتر شرایط
لازم برای صادر شدن آن‌ها مشترک است، عملکرد بهتری را ارائه خواهد داد.
.UNINDENT
.sp
بسته شد #6871 (#6871 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6871>)
.IP \(bu 2
ابزار epylint حذف شد. این ابزار اکنون در این نشانی نگه‌داری می‌شود: \%<https://\:github\:.com/\:emacsorphanage/\:pylint>\&.
.sp
ارجاع به #7737 (#7737 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7737>)
.IP \(bu 2
گزینهٔ \fBovergeneral\-exceptions\fP اکنون فقط نام‌های کاملاً واجد شرایط (fully qualified names)
را در نظر می‌گیرد (\fBbuiltins.Exception\fP و نه \fBException\fP). اگر این گزینه
را بازنویسی کرده بودید، اکنون باید از نام کاملاً واجد شرایط استفاده کنید.
.sp
هنوز یک هشدار صادر می‌شود، اما در نسخهٔ 3.1.0 حذف خواهد شد.
.sp
ارجاع به #8411 (#8411 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8411>)
.IP \(bu 2
پس از یک دورهٔ منسوخ‌سازی (deprecation)، دیگر امکان استفاده از \fBMASTER\fP
یا \fBmaster\fP به‌عنوان بخش پیکربندی در \fBsetup.cfg\fP یا \fBtox.ini\fP وجود ندارد\&. شروع
نکردن عنوان بخش با نام ابزار، شیوهٔ نامناسبی است. لطفاً به‌جای آن از \fBpylint.main\fP استفاده کنید.
.sp
ارجاع به #8465 (#8465 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8465>)
.IP \(bu 2
اکنون هنگام اجرای Pyreverse، آمار بسته چاپ می‌شود و یک پرچم \fB\-\-verbose\fP برای دریافت خروجی اصلی همراه با ماژول‌های تجزیه‌شده اضافه شده است. اگر می‌خواهید خروجی قبلی را حفظ کنید، ممکن است لازم باشد گزینهٔ verbose را فعال نمایید.
.sp
بسته شد #8973 (#8973 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8973>)
.UNINDENT
.SS "قابلیت‌های جدید (New Features)"
.INDENT 0.0
.IP \(bu 2
یک گزارش‌گر جدید \fBjson2\fP اضافه شده است. این گزارش‌گر خروجی غنی‌تری ارائه می‌دهد که
تجزیهٔ آن آسان‌تر است و اطلاعات بیشتری فراهم می‌کند.
.sp
در مقایسه با \fBjson\fP، تنها تغییرات این است که پیام‌ها اکنون ذیل کلید \fB\(dqmessages\(dq\fP
قرار دارند و \fB\(dqmessage\-id\(dq\fP اکنون از شیوهٔ نگارش camelCase پیروی کرده و به
\fB\(dqmessageId\(dq\fP تغییر نام یافته است\&.
گزارش‌گر جدید همچنین «امتیاز» (\(dqscore\(dq) ماژول‌های تحلیل‌شده را بر اساس تعریف ارائه‌شده در
گزینهٔ \fBevaluation\fP گزارش می‌دهد و آماری را در رابطه با ماژول‌های بررسی‌شده فراهم می‌کند.
.sp
از آن‌جا که نگه‌داری گزارش‌گر \fBjson\fP متوقف خواهد شد، کاربران را تشویق می‌کنیم تا از گزارش‌گر
جدید استفاده نمایند.
.sp
بسته شد #4741 (#4741 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:4741>)
.IP \(bu 2
در نمودارهای وابستگی بسته‌های Pyreverse، زمانی که یک ماژول، ماژول دیگری را صرفاً برای بررسی نوع (type\-checking) وارد (import) کند، نمایش داده می‌شود.
.sp
بسته شد #8112 (#8112 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8112>)
.IP \(bu 2
گزینهٔ جدید (\fB\-\-show\-stdlib\fP، \fB\-L\fP) به \fBpyreverse\fP اضافه شد\&.
این گزینه رفتاری مشابه \fB\-\-show\-builtin\fP دارد، بدین صورت که ماژول‌های کتابخانهٔ
استاندارد اکنون به‌طور پیش‌فرض گنجانده نمی‌شوند، و با فعال‌سازی این گزینه گنجانده خواهند شد.
.sp
بسته شد #8181 (#8181 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8181>)
.IP \(bu 2
گزینه‌ای به Pyreverse برای مستثنی کردن گره‌های منفرد و مستقل از نمودارها با \fI\-\-no\-standalone\fP اضافه شد\&.
.sp
بسته شد #8476 (#8476 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8476>)
.UNINDENT.SS "بررسی‌های جدید (New Checks)"
.INDENT 0.0
.IP \(bu 2
افزودن ماژول \fBDataclassChecker\fP و بررسی‌کنندهٔ \fBinvalid\-field\-call\fP جهت بررسی استفاده‌های نامعتبر از dataclasses.field()\&.
.sp
ارجاع به #5159 (#5159 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5159>)
.IP \(bu 2
افزودن \fBreturn\-in\-finally\fP برای صدور پیام در صورتی که یک عبارت return درون بند finally یافت شود.
.sp
بستن #8260 (#8260 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8260>)
.IP \(bu 2
افزودن پیام جدید \fBkwarg\-superseded\-by\-positional\-arg\fP برای هشدار زمانی که تابعی با یک آرگومان کلیدواژه‌ای فراخوانی می‌شود که نام یکسانی با یک پارامتر فقط\-موضعی (positional\-only) دارد و تابع شامل یک دیکشنری پارامتر متغیر کلیدواژه‌ای است. اضافه شدن آرگومان کلیدواژه‌ای به دیکشنری پارامترهای متغیر کلیدواژه‌ای ممکن است رفتاری غیرمنتظره باشد.
.sp
بستن #8558 (#8558 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8558>)
.UNINDENT
.SS "افزونه‌ها (Extensions)"
.INDENT 0.0
.IP \(bu 2
افزودن پیام جدید \fBprefer\-typing\-namedtuple\fP به \fBCodeStyleChecker\fP برای پیشنهاد بازنویسی فراخوانی‌های \fBcollections.namedtuple\fP به‌صورت کلاس‌هایی که از \fBtyping.NamedTuple\fP ارث‌بری می‌کنند در Python 3.6+.\&
.sp
برای فعال‌سازی و صدور این پیام، به \fBload\-plugins=pylint.extensions.code_style\fP و \fBenable=prefer\-typing\-namedtuple\fP نیاز است.
.sp
بستن #8660 (#8660 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8660>)
.UNINDENT
.SS "موارد مثبت کاذب رفع‌شده (False Positives Fixed)"
.INDENT 0.0
.IP \(bu 2
گسترش مفهوم \(dqابهام تابع\(dq (function ambiguity) در \fBsafe_infer()\fP از تفاوت در تعداد آرگومان‌های تابع، به تفاوت در مجموعهٔ نام‌های آرگومان.
.sp
رفع موارد مثبت کاذب در \fBtensorflow\fP\&.
.sp
بستن #3613 (#3613 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3613>)
.IP \(bu 2
رفع مثبت کاذب \fIunused\-argument\fP هنگامی که \fI__new__\fP از همهٔ آرگومان‌های \fI__init__\fP استفاده نمی‌کند.
.sp
بستن #3670 (#3670 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3670>)
.IP \(bu 2
رفع یک مثبت کاذب برای \fBinvalid\-name\fP هنگامی که یک متغیر کلاس دارای یادداشت نوع (type\-annotated) در کلاس \fBenum.Enum\fP هیچ مقدار تخصیص‌یافته‌ای ندارد.
.sp
ارجاع به #7402 (#7402 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7402>)
.IP \(bu 2
رفع مثبت کاذب \fBunused\-import\fP برای استفاده از \fBsix.with_metaclass\fP\&.
.sp
بستن #7506 (#7506 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7506>)
.IP \(bu 2
رفع موارد منفی کاذب و مثبت کاذب برای \fBtoo\-many\-try\-statements\fP،
\fBtoo\-complex\fP و \fBtoo\-many\-branches\fP از طریق شمارش صحیح دستورهای
زیرمجموعهٔ یک \fBtry\fP\&.
.sp
ارجاع به #7767 (#7767 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7767>)
.IP \(bu 2
هنگام بررسی بازگشایی نامتوازن دیکشنری در حلقه‌های for، اکنون Pylint بررسی می‌کند که آیا طول هر مقدار برای بازگشایی با تعداد مقصدهای بازگشایی مطابقت دارد یا خیر. پیش‌تر، Pylint تعداد مقادیر را برای تکرار حلقه می‌سنجید که موجب ایجاد یک هشدار نادرست unbalanced\-dict\-unpacking / W0644 \%<#\:unbalanced-dict-unpacking> می‌شد.
.sp
بستن #8156 (#8156 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8156>)
.IP \(bu 2
رفع مثبت کاذب برای \fBused\-before\-assignment\fP هنگامی که استفاده و مقداردهی با شرط یکسانی در دستورهای مختلف محافظت شده‌اند.
.sp
بستن #8167 (#8167 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8167>)
.IP \(bu 2
افزودن \fBasyncSetUp\fP به فهرست پیش‌فرض \fBdefining\-attr\-methods\fP برای ساکت کردن هشدار \fBattribute\-defined\-outside\-init\fP هنگام استفاده از \fBunittest.IsolatedAsyncioTestCase\fP\&.
.sp
ارجاع به #8403 (#8403 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8403>)
.IP \(bu 2
هشدار \fIlogging\-not\-lazy\fP دیگر برای آرگومان‌های رشته‌ای که به صراحت به یکدیگر متصل شده‌اند، صادر نمی‌شود.
.sp
بستن #8410 (#8410 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8410>)
.IP \(bu 2
رفع مثبت کاذب برای isinstance\-second\-argument\-not\-valid\-type / W1116 \%<#\:isinstance-second-argument-not-valid-type> هنگامی که نوع‌های اجتماع شامل None باشند.
.sp
بستن #8424 (#8424 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8424>)
.IP \(bu 2
هشدار \fBinvalid\-name\fP اکنون اجازهٔ استفاده از اعداد صحیح را در نام‌های \fBtypealias\fP می‌دهد:
\- اکنون معتبر: \fBGood2Name\fP، \fBGoodName2\fP\&.
\- همچنان نامعتبر: \fB_1BadName\fP\&.
.sp
بستن #8485 (#8485 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8485>)
.IP \(bu 2
دیگر \fBUnion\fP به عنوان یادداشت نوع، در بررسی‌های نام‌گذاری به عنوان نام مستعار نوع در نظر گرفته نمی‌شود.
.sp
بستن #8487 (#8487 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8487>)
.IP \(bu 2
هشدار \fBunnecessary\-lambda\fP دیگر برای لامبداهایی که از پارامترهای خود در بدنه‌شان استفاده می‌کنند (به جز در آرگومان‌های نهایی) اخطار نمی‌دهد؛ مانند:
\fBlambda foo: (bar if foo else baz)(foo)\fP\&.
.sp
بستن #8496 (#8496 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8496>)
.IP \(bu 2
اصلاح \fIunused\-import\fP به‌گونه‌ای که گزینهٔ \fIdummy\-variables\-rgx\fP را رعایت کند.
.sp
بستن #8500 (#8500 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8500>)
.IP \(bu 2
متغیرهای دارای نوع \fIUnion\fP بدون تخصیص مقدار، دیگر به عنوان \fITypeAlias\fP در نظر گرفته نمی‌شوند.
.sp
بستن #8540 (#8540 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8540>)
.IP \(bu 2
مجاز دانستن رشته‌های متصل‌شدهٔ ضمنی درون پرانتز هنگامی که \fIcheck\-str\-concat\-over\-line\-jumps\fP فعال است.
.sp
بستن #8552. (#8552 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8552>)
.IP \(bu 2
رفع مثبت کاذب برای \fBpositional\-only\-arguments\-expected\fP هنگامی که یک تابع، هم شامل یک پارامتر فقط\-موضعی دارای مقدار پیش‌فرض و هم شامل \fB**kwargs\fP است.
.sp
بستن #8555 (#8555 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8555>)
.IP \(bu 2
رفع مثبت کاذب برای \fBkeyword\-arg\-before\-vararg\fP هنگامی که یک پارامتر فقط\-موضعی دارای مقدار پیش‌فرض قبل از \fB*args\fP قرار می‌گیرد.
.sp
بستن #8570 (#8570 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8570>)
.IP \(bu 2
رفع مثبت کاذب برای \fBarguments\-differ\fP هنگام بازنویسی متد \fI__init_subclass__\fP\&.
.sp
بستن #8919 (#8919 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8919>)
.IP \(bu 2
رفع مثبت کاذب برای \fBno\-value\-for\-parameter\fP هنگامی که یک staticmethod در بدنهٔ کلاس فراخوانی می‌شود.
.sp
بستن #9036 (#9036 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9036>)
.UNINDENT.SS "رفع موارد منفی کاذب (False Negatives Fixed)"
.INDENT 0.0
.IP \(bu 2
صدور خطای \fBused\-before\-assignment\fP هنگام فراخوانی توابع در سطح ماژول پیش از تعریف آن‌ها.
.sp
بسته شد #1144 (#1144 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:1144>)
.IP \(bu 2
اعمال \fBinfer_kwarg_from_call()\fP روی بررسی‌های بیشتر
.sp
این تغییر بیشتر موارد منفی کاذب را برای بررسی‌های مختلف برطرف می‌کند،
به‌جز یک مورد مثبت کاذب برای \fBuse\-maxsplit\-arg\fP\&.
.sp
بسته شد #7761 (#7761 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7761>)
.IP \(bu 2
متغیرهای \fITypeAlias\fP تعریف‌شده در توابع اکنون از نظر خطاهای \fIinvalid\-name\fP بررسی می‌شوند.
.sp
بسته شد #8536 (#8536 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8536>)
.IP \(bu 2
رفع منفی کاذب برای \fBno\-value\-for\-parameter\fP هنگامی که تابعی با امضای شامل هر دو پارامتر فقط\-موقعیتی \fBname\fP و همچنین \fB*kwargs\fP، با یک آرگومان کلیدواژه‌ای برای \fBname\fP فراخوانی می‌شود.
.sp
بسته شد #8559 (#8559 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8559>)
.IP \(bu 2
رفع یک منفی کاذب برای \fBtoo\-many\-arguments\fP با در نظر گرفتن پارامترهای فقط\-موقعیتی و فقط\-کلیدواژه‌ای.
.sp
بسته شد #8667 (#8667 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8667>)
.IP \(bu 2
صدور خطای \fBassignment\-from\-no\-return\fP برای فراخوانی متدهای توکار مانند \fBdict.update()\fP\&.
فراخوانی‌های \fBlist.sort()\fP اکنون جهت سازگاری، به جای \fBassignment\-from\-none\fP
خطای \fBassignment\-from\-no\-return\fP را ایجاد می‌کنند.
.sp
بسته شد #8714
بسته شد #8810 (#8714 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8714>)
.IP \(bu 2
پیام \fBconsider\-using\-augmented\-assign\fP اکنون برای دیکشنری‌ها و لیست‌ها نیز اعمال می‌شود.
.sp
بسته شد #8959. (#8959 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8959>)
.UNINDENT
.SS "سایر رفع باگ‌ها (Other Bug Fixes)"
.INDENT 0.0
.IP \(bu 2
پشتیبانی از پیام \fBduplicate\-code\fP هنگام اجرای موازی با \fB\-\-jobs\fP\&.
.sp
بسته شد #374 (#374 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:374>)
.IP \(bu 2
پشتیبانی از پیام \fBcyclic\-import\fP هنگام اجرای موازی با \fB\-\-jobs\fP\&.
.sp
بسته شد #4171 (#4171 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:4171>)
.IP \(bu 2
اکنون می‌توان از \fB\-\-jobs\fP همراه با \fB\-\-load\-plugins\fP استفاده کرد.
.sp
این قابلیت در astroid 2.5.0 دچار پس‌رفت شده بود.
.sp
بسته شد #4874 (#4874 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:4874>)
.IP \(bu 2
افزونهٔ docparams کامنت‌های نوع (type comments) را به عنوان مستندات نوع در نظر می‌گیرد.
.sp
بسته شد #6287 (#6287 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6287>)
.IP \(bu 2
هنگام تجزیهٔ فهرست‌های جداشده با کاما از عبارت‌های باقاعده در پیکربندی، کاماهای
درون آکولادها نادیده گرفته می‌شوند، زیرا آن‌ها نشان‌دهندهٔ سورها (quantifiers) هستند، نه جداکنندهٔ
میان عبارات.
.sp
بسته شد #7229 (#7229 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7229>)
.IP \(bu 2
گزینهٔ \fBignored\-modules\fP اکنون به درستی برای \fBno\-name\-in\-module\fP لحاظ خواهد شد.
.sp
بسته شد #7578 (#7578 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7578>)
.IP \(bu 2
مقدار \fBsys.argv\fP اکنون همیشه به درستی به عنوان مقداری غیرقابل استنتاج در نظر گرفته می‌شود (به جای
استفاده از مقادیر واقعی ارائه‌شده به pylint).
.sp
بسته شد #7710 (#7710 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7710>)
.IP \(bu 2
جلوگیری از هشدارهای تکراری برای نام‌های استثنای نامشخص (unqualified) در تنظیمات \fBovergeneral\-exceptions\fP
هنگام اجرا با \fB\-\-jobs\fP\&.
.sp
بسته شد #7774 (#7774 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7774>)
.IP \(bu 2
فیلدهای کلاس در نمودارهای Pyreverse بیش از یک بار نمایش داده نمی‌شوند.
.sp
بسته شد #8189 (#8189 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8189>)
.IP \(bu 2
رفع منفی کاذب \fBused\-before\-assignment\fP هنگامی که واردکردن‌های (imports) مربوط به TYPE_CHECKING
در چندین حوزه (scope) استفاده می‌شوند.
.sp
بسته شد #8198 (#8198 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8198>)
.IP \(bu 2
گزینهٔ \fB\-\-clear\-cache\-post\-run\fP اکنون حافظه‌های موقت LRU را نیز برای ابزارهای کمکی pylint
که دارای ارجاعاتی به گره‌های AST هستند، پاک‌سازی می‌کند.
.sp
بسته شد #8361 (#8361 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8361>)
.IP \(bu 2
رفع فروپاشی (crash) هنگام استفاده از \fBTYPE_CHECKING\fP بدون واردکردن آن.
.sp
بسته شد #8434 (#8434 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8434>)
.IP \(bu 2
رفع یک مثبت کاذب \fBused\-before\-assignment\fP هنگامی که واردکردن‌ها
زیر شاخهٔ else if مربوط به \fBTYPE_CHECKING\fP انجام شده باشند.
.sp
بسته شد #8437 (#8437 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8437>)
.IP \(bu 2
رفع یک پس‌رفت در \fBpreferred\-modules\fP که در آن به جای تطابق کامل لازم، از یک تطابق جزئی استفاده می‌شد.
.sp
بسته شد #8453 (#8453 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8453>)
.IP \(bu 2
رفع یک فروپاشی در pyreverse هنگامی که از نویسه‌های \(dq/\(dq در نام فایل خروجی استفاده می‌شود؛ مانند pyreverse \-o png \-p name/ path/to/project.
.sp
بسته شد #8504 (#8504 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8504>)
.IP \(bu 2
عدم نمایش تکراری فلش‌ها در نمودارهای Pyreverse.
.sp
بسته شد #8522 (#8522 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8522>)
.IP \(bu 2
بهبود خروجی پیام \fBconsider\-using\-generator\fP برای فراخوانی‌های \fBmin()\fP همراه با کلیدواژهٔ \fBdefault\fP\&.
.sp
بسته شد #8563 (#8563 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8563>)
.IP \(bu 2
رفع فروپاشی هنگام تولید فایل پیکربندی: \fBtomlkit.exceptions.TOMLKitError: Can\(aqt add a table to a dotted key\fP
ناشی از tomlkit نسخهٔ \fBv0.11.8\fP\&.
.sp
بسته شد #8632 (#8632 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8632>)
.IP \(bu 2
رفع خطای شکست خط در خروجی dot نرم‌افزار Pyreverse.
.sp
بسته شد #8671 (#8671 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8671>)
.IP \(bu 2
رفع یک مثبت کاذب برای \fBmethod\-hidden\fP هنگام استفاده از دکوراتور \fBcached_property\fP\&.
.sp
بسته شد #8753 (#8753 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8753>)
.IP \(bu 2
متدهای داندر (dunder) تعریف‌شده در lambda، در صورتی که نتوان آن‌ها را با فراخوانی غیرداندر جایگزین کرد، دیگر پیام \fBunnecessary\-dunder\-call\fP را صادر نمی‌کنند.
.sp
بسته شد #8769 (#8769 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8769>)
.IP \(bu 2
عدم نمایش حاشیه‌نویسی‌های نوع تکراری در نمودارهای Pyreverse.
.sp
بسته شد #8888 (#8888 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8888>)
.IP \(bu 2
رفع مشکل هشینگ ناهماهنگ در \fIBaseChecker\fP که باعث می‌شد برخی گزارش‌ها صادر نشوند.
.sp
بسته شد #9001 (#9001 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9001>)
.IP \(bu 2
عدم افزودن \fIOptional\fP به حاشیه‌نویسی‌های \fI|\fP همراه با \fINone\fP در نمودارهای Pyreverse.
.sp
بسته شد #9014 (#9014 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9014>)
.IP \(bu 2
نرم‌افزار Pyreverse دیگر چندین فلش ارتباط کلاس را نمایش نمی‌دهد، بلکه تنها قوی‌ترین آن‌ها را نشان می‌دهد.
.sp
ارجاع به #9045 (#9045 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9045>)
.IP \(bu 2
جلوگیری از بین رفتن داده‌ها در آمار linter برای پیام‌های مربوط
به خود linter (مانند \fBunknown\-option\-value\fP)، که مشکلات مربوط به امتیاز (score)،
گزینهٔ fail\-on و موارد مشابه را برطرف می‌کند.
.sp
بسته شد #9059 (#9059 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9059>)
.IP \(bu 2
رفع فروپاشی در بررسی‌کنندهٔ بازآفرینی کد (refactoring checker) هنگامی که عملوند یکانی با یک متغیر در حلقهٔ for استفاده می‌شود.
.sp
بسته شد #9074 (#9074 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9074>)
.UNINDENT.SS "سایر تغییرات (Other Changes)"
.INDENT 0.0
.IP \(bu 2
اکنون Pylint حاشیه‌نویسی‌های نوع (type annotations) خود را ارائه می‌دهد.
.sp
بسته شدن #5488 و #2079 (#5488 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5488>)
.IP \(bu 2
جست‌وجوی بازگشتی برای \fBpyproject.toml\fP در دایرکتوری‌های والد تا ریشهٔ پروژه یا ریشهٔ سیستم‌فایل.
.sp
ارجاع به #7163، بسته شدن #3289 (#7163 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7163>)
.IP \(bu 2
تمام کدهای مربوط به تجزیهٔ پیکربندی optparse حذف شده‌اند.
.sp
ارجاع به #8405 (#8405 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8405>)
.IP \(bu 2
اکنون Pylint از python 3.12 پشتیبانی می‌کند.
.sp
ارجاع به #8718 (#8718 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8718>)
.IP \(bu 2
افزودن یک فایل CITATION.cff به ریشهٔ مخزن شامل فراداده‌های لازم برای استناد به Pylint.
.sp
بسته شدن #8760 (#8760 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8760>)
.IP \(bu 2
تغییر نام خطای \(dqunneeded\-not / C0113 \%<#\:unneeded-not>\(dq به \(dqunnecessary_negation\(dq برای وضوح بیشتر.
.sp
بسته شدن #8789 (#8789 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8789>)
.UNINDENT
.SS "تغییرات داخلی (Internal Changes)"
.INDENT 0.0
.IP \(bu 2
تابع \fBget_message_definition\fP از API پایه‌ای بازبین (checker) حذف شد. می‌توانید از طریق \fBMessageStore\fP\& به تعاریف پیام‌ها دسترسی داشته باشید.
.sp
ارجاع به #8401 (#8401 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8401>)
.IP \(bu 2
تمام موارد مربوط به سازهٔ \fB__implements__\fP حذف شدند. این ساختار بر اساس PEP245 بود که در سال ۲۰۰۱ پیشنهاد و در سال ۲۰۰۶ رد شد.
.sp
تمام کلاس‌هایی که از \fBInterface\fP در \fBpylint.interfaces\fP ارث‌بری می‌کردند حذف شدند.
کلاس \fBChecker\fP تنها باید از \fBBaseChecker\fP یا هر یک از دیگر انواع checker در \fBpylint.checkers\fP ارث‌بری کند. \fBReporter\fP نیز تنها باید از \fBBaseReporter\fP ارث‌بری نماید.
.sp
ارجاع به #8404 (#8404 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8404>)
.IP \(bu 2
اکنون ارسال \fBmodname\fP و \fBmsg_store\fP در \fBFileState\fP الزامی است.
تابع \fBcollect_block_lines\fP نیز حذف شده است. مقدار \fBPylinter.current_name\fP دیگر نمی‌تواند null باشد.
.sp
ارجاع به #8407 (#8407 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8407>)
.IP \(bu 2
متد \fBReporter.set_output\fP به نفع \fBreporter.out = stream\fP حذف شد.
.sp
ارجاع به #8408 (#8408 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8408>)
.IP \(bu 2
تعدادی از توابع و کلاس‌های کمکی (utility) قدیمی حذف شده‌اند:
.sp
\fBMapReduceMixin\fP: برای اینکه یک بازبین (checker) داده‌های نقشه را ادغام (reduce) کند، کافی است \fBget_map_data\fP و \fBreduce_map_data\fP را پیاده‌سازی کنید.
.sp
\fBis_inside_lambda\fP: از \fButils.get_node_first_ancestor_of_type(x, nodes.Lambda)\fP استفاده کنید.
.sp
\fBcheck_messages\fP: از \fButils.only_required_for_messages\fP استفاده کنید.
.sp
\fBis_class_subscriptable_pep585_with_postponed_evaluation_enabled\fP: از \fBis_postponed_evaluation_enabled(node)\fP و \fBis_node_in_type_annotation_context(node)\fP استفاده کنید.
.sp
\fBget_python_path\fP: این فرض که همواره یک فایل __init__.py وجود دارد از نسخهٔ python 3.3 به بعد درست نبوده و به‌ویژه با PEP 420 مشکل ایجاد می‌کند. از \fBdiscover_package_path\fP استفاده کرده و ریشه(های) سورس را به آن ارسال کنید.
.sp
\fBfix_import_path\fP: از \fBaugmented_sys_path\fP استفاده کنید و مدخل‌های اضافی \fBsys.path\fP را که از \fBdiscover_package_path\fP دریافت شده‌اند به عنوان آرگومان به آن بفرستید.
.sp
\fBget_global_option\fP: از \fBchecker.linter.config\fP برای دریافت تمام گزینه‌های سراسری استفاده کنید.
.sp
اشیاء خصوصی مرتبط نیز حذف شده‌اند.
.sp
ارجاع به #8409 (#8409 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8409>)
.IP \(bu 2
اکنون \fBcolorize_ansi\fP تنها یک شیء \fBMessageStyle\fP را می‌پذیرد.
.sp
ارجاع به #8412 (#8412 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8412>)
.IP \(bu 2
پس از یک دوره منسوخ‌سازی، اکنون \fBPylinter.check\fP تنها با توالی‌هایی از رشته‌ها کار می‌کند، نه رشته‌های تکی.
.sp
ارجاع به #8463 (#8463 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8463>)
.IP \(bu 2
پس از یک دوره منسوخ‌سازی، \fBColorizedTextReporter\fP تنها \fBColorMappingDict\fP را می‌پذیرد.
.sp
ارجاع به #8464 (#8464 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8464>)
.IP \(bu 2
پس از یک دوره منسوخ‌سازی، مقادیر \fBend_line\fP و \fBend_col_offset\fP در \fBMessageTest\fP باید در آزمون‌های عملکردی دقیق باشند (برای python 3.8 یا بالاتر در cpython، و برای python 3.9 یا بالاتر در pypy).
.sp
ارجاع به #8466 (#8466 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8466>)
.IP \(bu 2
پس از یک دوره منسوخ‌سازی، آرگومان \fBdo_exit\fP از کلاس \fBRun\fP (و کلاس \fB_Run\fP در testutils) حذف شد.
.sp
ارجاع به #8472 (#8472 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8472>)
.IP \(bu 2
پس از یک دوره منسوخ‌سازی، اکنون آرگومان \fBpy_version\fP در تابع \fBMessageDefinition.may_be_emitted\fP الزامی است. محتمل‌ترین راهکار در صورتی که نیاز به استفادهٔ ادامه‌دار از این تابع دارید، استفاده از \(aqlinter.config.py_version\(aq، یا استفاده از \(aqMessageDefinition.is_message_enabled\(aq به‌جای آن است.
.sp
ارجاع به #8473 (#8473 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8473>)
.IP \(bu 2
پس از یک دوره منسوخ‌سازی، کلاس \fBOutputLine\fP اکنون همواره نیازمند تعداد صحیح آرگومان‌ها است. برای دستیابی آسان به این هدف، خروجی عملکردی را می‌توان به‌صورت خودکار بازتولید کرد.
.sp
ارجاع به #8474 (#8474 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8474>)
.IP \(bu 2
پس از یک دوره منسوخ‌سازی، توابع \fBis_typing_guard\fP، \fBis_node_in_typing_guarded_import_block\fP و \fBis_node_in_guarded_import_block\fP از \fBpylint.utils\fP حذف شدند: به‌جای آن‌ها از ترکیب \fBis_sys_guard\fP و \fBin_type_checking_block\fP استفاده کنید.
.sp
ارجاع به #8475 (#8475 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8475>)
.IP \(bu 2
پس از یک دوره منسوخ‌سازی، آرگومان \fBlocation\fP در کلاس \fBMessage\fP اکنون باید یک \fBMessageLocationTuple\fP\& باشد.
.sp
ارجاع به #8477 (#8477 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8477>)
.IP \(bu 2
پس از یک دوره منسوخ‌سازی، تابع \fBcheck_single_file\fP از \fBPylinter\fP با \fBPylinter.check_single_file_item\fP\& جایگزین شده است.
.sp
ارجاع به #8478 (#8478 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8478>)
.UNINDENT.SS بهبودهای کارایی
.INDENT 0.0
.IP \(bu 2
\fBpylint\fP پس از بهبودهایی در \fBastroid\fP که استفادهٔ بهتری از حافظهٔ موقت استنتاج (inference cache) می‌کند، (دست‌کم) حدود ۵٪ سریع‌تر اجرا می‌شود.
.sp
ارجاع: pylint\-dev/astroid#529 (#529 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:529>)
.IP \(bu 2
.INDENT 2.0
.IP \(bu 2
بهینه‌سازی \fBis_trailing_comma()\fP\&.
.IP \(bu 2
ذخیره‌سازی موقت (Cache) برای \fBclass_is_abstract()\fP\&.
.UNINDENT
.sp
ارجاع: #1954 (#1954 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:1954>)
.IP \(bu 2
خروج فوری در صورتی که همهٔ پیام‌ها غیرفعال شده باشند.
.sp
بسته شد: #8715 (#8715 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8715>)
.UNINDENT
.SS 2.x
.sp
از زمان آغاز pylint تا نگارش 2.14.0 (شامل آن)، سیاههٔ تغییراتی وجود داشت که دربردارندهٔ \fIتمام\fP
تغییرات غیربدیهی Pylint بود؛ از جمله تغییراتی که برای کاربر ملموس نبودند،
یعنی تغییراتی که تنها در صورتی ممکن بود برای شما جالب باشند که توسعه‌دهنده‌ای باشید
که روی pylint یا افزایه‌های pylint کار می‌کند یا یک تاریخ‌نگار متن‌باز باشید.
.sp
از pylint 1.6.0 تا 2.14.0، علاوه بر سیاههٔ کامل تغییرات، خلاصه‌ای از تغییرات
(عمدتاً ملموس برای کاربر) نیز وجود داشت.
.SS تازه‌های Pylint 2.17
.INDENT 0.0
.TP
.B انتشار
2.17
.TP
.B تاریخ
2023\-03\-08
.UNINDENT
.SS خلاصه \-\- نکات برجستهٔ انتشار
.sp
نگارش 2.17 یک انتشار کوچک است و نخستین نگارشی به شمار می‌رود که با افزودن گره‌های TryStar،
به‌طور رسمی از python 3.11 پشتیبانی می‌کند.
.sp
همچنان دو بررسی پیش‌فرض جدید وجود دارد: \fBbad\-chained\-comparison\fP و
\fBimplicit\-flag\-alias\fP، که یکی از آن‌ها پیش‌تر باگی شناسایی‌نشده را در sentry برطرف کرده است.
.sp
به لطف تلاش جامعهٔ کاربری، مستندات ما تقریباً کامل شده است و اکنون
همهٔ پیام‌ها باید دارای مستندات مناسبی باشند. یک تشکر بزرگ از
تمام کسانی که مشارکت کردند!
.sp
انتشار بعدی \fB3.0.0\fP خواهد بود که تغییرات ساختارشکن (breaking changes) به همراه دارد
و موارد منسوخی را که از مدت‌ها پیش اعلام شده بودند اجرایی می‌کند. پیش از انتشار رسمی،
نسخه‌های بتای متعددی عرضه خواهد شد؛ همگان می‌توانند این نسخه‌های بتا را آزمایش کنند
تا مشکلات را پیش از انتشار نهایی شناسایی کنیم.
.SS تازه‌های Pylint 2.17.7
.sp
تاریخ انتشار: 2023\-09\-30
.SS مثبت‌های کاذب رفع‌شده
.INDENT 0.0
.IP \(bu 2
رفع یک پس‌رفت در pylint 2.17.6 / astroid 2.15.7 که موجب صدور
پیام‌های گوناگون برای کدهای شامل \fBTypeVar\fP می‌شد.
.sp
بسته شد: #9069 (#9069 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9069>)
.UNINDENT
.SS سایر باگ‌های برطرف‌شده
.INDENT 0.0
.IP \(bu 2
رفع خرابی در بررسی‌کنندهٔ بازآفرینی کد (refactoring checker) هنگامی که عملوند یگانی همراه با متغیر در حلقهٔ for استفاده شود.
.sp
بسته شد: #9074 (#9074 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9074>)
.UNINDENT
.SS تازه‌های Pylint 2.17.6
.sp
تاریخ انتشار: 2023\-09\-24
.SS سایر باگ‌های برطرف‌شده
.INDENT 0.0
.IP \(bu 2
هنگام تجزیهٔ فهرست‌های جداشده با کاما از عبارت‌های باقاعده در پیکربندی،
کاماهای درون آکولاد نادیده گرفته می‌شوند، زیرا آن‌ها نشان‌دهندهٔ کمیت‌سنج‌ها هستند
نه جداکنندهٔ میان عبارت‌ها.
.sp
بسته شد: #7229 (#7229 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7229>)
.IP \(bu 2
متغیر \fBsys.argv\fP اکنون همیشه به درستی غیرقابل استنتاج تلقی می‌شود
(به جای استفاده از مقادیر واقعی داده‌شده به pylint).
.sp
بسته شد: #7710 (#7710 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7710>)
.IP \(bu 2
عدم نمایش فیلدهای کلاس بیش از یک بار در نمودارهای Pyreverse.
.sp
بسته شد: #8189 (#8189 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8189>)
.IP \(bu 2
عدم نمایش پیکان‌ها بیش از یک بار در نمودارهای Pyreverse.
.sp
بسته شد: #8522 (#8522 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8522>)
.IP \(bu 2
عدم نمایش یادداشت‌های نوع (type annotations) تکراری در نمودارهای Pyreverse.
.sp
بسته شد: #8888 (#8888 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8888>)
.IP \(bu 2
عدم افزودن \fIOptional\fP به حاشیه‌نویسی‌های \fI|\fP با \fINone\fP در نمودارهای Pyreverse.
.sp
بسته شد: #9014 (#9014 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:9014>)
.UNINDENT.SS موارد جدید در Pylint 2.17.5
.sp
تاریخ انتشار: 2023\-07\-26
.SS رفع موارد مثبت کاذب
.INDENT 0.0
.IP \(bu 2
رفع یک مثبت کاذب برای \fBunused\-variable\fP زمانی که یک import در بلوک
\fBif TYPE_CHECKING:\fP وجود داشته و \fBallow\-global\-unused\-variables\fP در پیکربندی
روی \fBno\fP تنظیم شده باشد.
.sp
بستن #8696 (#8696 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8696>)
.IP \(bu 2
رفع موارد مثبت کاذب تولیدشده هنگام ارسال آرگومان‌ها به صورت \fB**kwargs\fP به
فراخوانی‌های IO مانند ()open.
.sp
بستن #8719 (#8719 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8719>)
.IP \(bu 2
رفع یک مورد مثبت کاذب که در آن pylint فراخوانی‌های متد دارای حاشیه‌نویسی
\fBNoReturn\fP را در حین بررسی \fBinconsistent\-return\-statements\fP نادیده می‌گرفت.
.sp
بستن #8747 (#8747 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8747>)
.IP \(bu 2
معاف کردن والدینی که تنها دارای حاشیه‌نویسی نوع هستند از پیام
\fBinvalid\-enum\-extension\fP.
.sp
بستن #8830 (#8830 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8830>)
.UNINDENT
.SS رفع سایر باگ‌ها
.INDENT 0.0
.IP \(bu 2
رفع خرابی هنگامی که یک فراخوانی به \fBsuper()\fP پس از یک عملگر (مانند
\fBnot\fP) قرار می‌گرفت.
.sp
بستن #8554 (#8554 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8554>)
.IP \(bu 2
رفع خرابی بررسی‌کنندهٔ \fBmodified\-while\-iterating\fP هنگام حذف اعضای
یک dict بازگردانده‌شده از یک فراخوانی.
.sp
بستن #8598 (#8598 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8598>)
.IP \(bu 2
رفع خرابی در بررسی \fBinvalid\-metaclass\fP هنگامی که یک metaclass دارای
پایه‌های تکراری بود.
.sp
بستن #8698 (#8698 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8698>)
.IP \(bu 2
اجتناب از هشدار \fBconsider\-using\-f\-string\fP در modulo با وجود براکت در الگو.
.sp
بستن #8720. (#8720 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8720>)
.IP \(bu 2
رفع خرابی هنگامی که \fB__all__\fP وجود دارد اما قابل استنتاج نیست.
.sp
بستن #8740 (#8740 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8740>)
.IP \(bu 2
رفع خرابی هنگامی که یک متغیر به یک مشخصهٔ کلاس با نام یکسان انتساب داده می‌شود.
.sp
بستن #8754 (#8754 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8754>)
.IP \(bu 2
رفع خرابی هنگام فراخوانی \fBcopy.copy()\fP بدون آرگومان.
.sp
بستن #8774 (#8774 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8774>)
.UNINDENT
.SS سایر تغییرات
.INDENT 0.0
.IP \(bu 2
رفع خرابی هنگامی که یک \fBnonlocal\fP در سطح ماژول تعریف شده باشد.
.sp
بستن #8735 (#8735 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8735>)
.UNINDENT
.SS موارد جدید در Pylint 2.17.4
.sp
تاریخ انتشار: 2023\-05\-06
.SS رفع موارد مثبت کاذب
.INDENT 0.0
.IP \(bu 2
رفع یک مورد مثبت کاذب برای \fBbad\-dunder\-name\fP زمانی که متد \fB__index__\fP تعریف‌شده
توسط کاربر وجود دارد.
.sp
بستن #8613 (#8613 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8613>)
.UNINDENT
.SS رفع سایر باگ‌ها
.INDENT 0.0
.IP \(bu 2
\fBpyreverse\fP: فراردهی نویسه خط عمودی (|) در برچسب‌های حاشیه‌نویسی تولیدشده توسط
چاپگر DOT اضافه شد تا اطمینان حاصل شود به عنوان جداکننده فیلد در گره‌های
مبتنی بر رکورد در نظر گرفته نمی‌شود.
.sp
بستن #8603 (#8603 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8603>)
.IP \(bu 2
رفع خرابی هنگام تولید فایل پیکربندی:
\fBtomlkit.exceptions.TOMLKitError: Can\(aqt add a table to a dotted key\fP
ناشی از tomlkit نسخه \fBv0.11.8\fP\&.
.sp
بستن #8632 (#8632 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8632>)
.UNINDENT.SS تازه‌های Pylint 2.17.3
.sp
تاریخ انتشار: 2023\-04\-24
.SS مثبت‌های کاذب رفع‌شده
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب \fIunused\-argument\fP هنگامی که \fI__new__\fP از تمام آرگومان‌های
\fI__init__\fP استفاده نمی‌کند\&.
.sp
بسته شد #3670 (#3670 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3670>)
.IP \(bu 2
رفع مثبت کاذب \fBunused\-import\fP برای استفاده از \fBsix.with_metaclass\fP\&.
.sp
بسته شد #7506 (#7506 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7506>)
.IP \(bu 2
پیام \fIlogging\-not\-lazy\fP دیگر برای آرگومان‌های رشته‌ای صریحاً الحاق‌شده صادر
نمی‌شود\&.
.sp
بسته شد #8410 (#8410 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8410>)
.IP \(bu 2
رفع مثبت کاذب برای isinstance\-second\-argument\-not\-valid\-type / W1116 \%<#\:isinstance-second-argument-not-valid-type> هنگامی که انواع union
شامل None هستند\&.
.sp
بسته شد #8424 (#8424 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8424>)
.IP \(bu 2
اصلاح \fIunused\-import\fP به‌طوری که گزینهٔ \fIdummy\-variables\-rgx\fP را رعایت کند\&.
.sp
بسته شد #8500 (#8500 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8500>)
.IP \(bu 2
متغیرهای با نوع \fIUnion\fP بدون انتساب، دیگر به عنوان
\fITypeAlias\fP در نظر گرفته نمی‌شوند\&.
.sp
بسته شد #8540 (#8540 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8540>)
.IP \(bu 2
رفع مثبت کاذب برای \fBpositional\-only\-arguments\-expected\fP هنگامی که یک تابع
هم شامل یک پارامتر positional\-only با مقدار پیش‌فرض، و هم شامل
\fB**kwargs\fP باشد\&.
.sp
بسته شد #8555 (#8555 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8555>)
.IP \(bu 2
رفع مثبت کاذب برای \fBkeyword\-arg\-before\-vararg\fP هنگامی که یک پارامتر positional\-only
با یک مقدار پیش‌فرض، پیش از \fB*args\fP قرار می‌گیرد\&.
.sp
بسته شد #8570 (#8570 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8570>)
.UNINDENT
.SS سایر اشکالات رفع‌شده
.INDENT 0.0
.IP \(bu 2
بهبود خروجی پیام \fBconsider\-using\-generator\fP برای فراخوانی‌های \fBmin()\fP
با کلمه کلیدی \fBdefault\fP\&.
.sp
بسته شد #8563 (#8563 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8563>)
.UNINDENT
.SS تازه‌های Pylint 2.17.2
.sp
تاریخ انتشار: 2023\-04\-03
.SS مثبت‌های کاذب رفع‌شده
.INDENT 0.0
.IP \(bu 2
\fBinvalid\-name\fP اکنون اعداد صحیح را در نام‌های \fBtypealias\fP مجاز می‌داند:
\- اکنون معتبر: \fBGood2Name\fP، \fBGoodName2\fP\&.
\- همچنان نامعتبر: \fB_1BadName\fP\&.
.sp
بسته شد #8485 (#8485 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8485>)
.IP \(bu 2
دیگر \fBUnion\fP به عنوان type annotation برای بررسی‌های نام‌گذاری به منزلهٔ type alias
در نظر گرفته نمی‌شود\&.
.sp
بسته شد #8487 (#8487 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8487>)
.IP \(bu 2
\fBunnecessary\-lambda\fP دیگر در مورد توابع لامبدایی که از پارامترهای خود در بدنه
(به غیر از آرگومان‌های نهایی) استفاده می‌کنند هشدار نمی‌دهد؛ مانند:
\fBlambda foo: (bar if foo else baz)(foo)\fP\&.
.sp
بسته شد #8496 (#8496 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8496>)
.UNINDENT
.SS سایر اشکالات رفع‌شده
.INDENT 0.0
.IP \(bu 2
رفع خرابی در pyreverse هنگامی که از نویسه‌های \(dq/\(dq در نام فایل خروجی استفاده می‌شود؛
مانند pyreverse \-o png \-p name/ path/to/project\&.
.sp
بسته شد #8504 (#8504 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8504>)
.UNINDENT.SS چه چیزهایی در Pylint 2.17.1 جدید است؟
.sp
تاریخ انتشار: 2023\-03\-22
.SS رفع مثبت‌های کاذب (False Positives)
.INDENT 0.0
.IP \(bu 2
افزودن \fBasyncSetUp\fP به فهرست پیش‌فرض \fBdefining\-attr\-methods\fP برای فرونشاندن
هشدار \fBattribute\-defined\-outside\-init\fP هنگام استفاده از
\fBunittest.IsolatedAsyncioTestCase\fP\&.
.sp
ارجاع #8403 (#8403 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8403>)
.UNINDENT
.SS سایر باگ‌های برطرف‌شده
.INDENT 0.0
.IP \(bu 2
گزینهٔ \fB\-\-clear\-cache\-post\-run\fP اکنون حافظه‌های موقت LRU را برای ابزارهای pylint
که ارجاعاتی به گره‌های AST نگه می‌دارند نیز پاکسازی می‌کند.
.sp
بستن #8361 (#8361 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8361>)
.IP \(bu 2
رفع یک فروپاشی هنگامی که از \fBTYPE_CHECKING\fP بدون درون‌ریزی آن استفاده می‌شود.
.sp
بستن #8434 (#8434 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8434>)
.IP \(bu 2
رفع یک پس‌رفت در \fBpreferred\-modules\fP که در آن به جای تطابق کامل لازم،
از تطابق جزئی استفاده می‌شد.
.sp
بستن #8453 (#8453 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8453>)
.UNINDENT
.SS تغییرات داخلی
.INDENT 0.0
.IP \(bu 2
ابزارهای زیر به نفع تابع پایدارتر
\fBin_type_checking_block\fP
منسوخ شده‌اند و در pylint 3.0 حذف خواهند شد:
.INDENT 2.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fBis_node_in_guarded_import_block\fP
.IP \(bu 2
\fBis_node_in_typing_guarded_import_block\fP
.IP \(bu 2
\fBis_typing_guard\fP
.UNINDENT
.UNINDENT
.UNINDENT
.sp
تابع \fBis_sys_guard\fP که بخشی از
\fBis_node_in_guarded_import_block\fP بود،
همچنان در دسترس است\&.
.sp
ارجاع #8433 (#8433 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8433>)
.UNINDENT
.SS چه چیزهایی در Pylint 2.17.0 جدید است؟
.sp
تاریخ انتشار: 2023\-03\-08
.SS ویژگی‌های جدید
.INDENT 0.0
.IP \(bu 2
ابزار \fIpyreverse\fP اکنون با گزینهٔ \fI\-\-color\-palette\fP
از پالت‌های رنگی سفارشی پشتیبانی می‌کند.
.sp
بستن #6738 (#6738 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6738>)
.IP \(bu 2
افزودن بررسی \fBinvalid\-name\fP برای نام‌های \fBTypeAlias\fP\&.
.sp
بستن #7081. (#7081 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7081>)
.IP \(bu 2
پذیرش مقادیری به شکل \fB<class name>.<attribute name>\fP برای
فهرست \fBexclude\-protected\fP\&.
.sp
بستن #7343 (#7343 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7343>)
.IP \(bu 2
افزودن گزینهٔ \fI\-\-version\fP به \fIpyreverse\fP\&.
.sp
ارجاع #7851 (#7851 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7851>)
.IP \(bu 2
افزودن قابلیت جدید با پیکربندی preferred\-modules برای تشخیص
زیرپیمانه‌ها.
.sp
ارجاع #7957 (#7957 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7957>)
.IP \(bu 2
پشتیبانی از بسته‌های فضای نام ضمنی (PEP 420).
.sp
بستن #8154 (#8154 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8154>)
.IP \(bu 2
افزودن پشتیبانی از الگوهای تطبیق مسیر (globbing) برای \fB\-\-source\-roots\fP\&.
.sp
بستن #8290 (#8290 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8290>)
.IP \(bu 2
پشتیبانی از الگوهای تطبیق مسیر هنگام تعیین فایل/دایرکتوری/پیمانه مورد نظر برای تحلیل (lint).
.sp
بستن #8310 (#8310 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8310>)
.IP \(bu 2
اکنون pylint از گره‌های \fBTryStar\fP در Python 3.11 پشتیبانی می‌کند و باید به‌طور کامل
با Python 3.11 سازگار باشد.
.sp
بستن #8387 (#8387 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8387>)
.UNINDENT.SS "بررسی‌های جدید (New Checks)"
.INDENT 0.0
.IP \(bu 2
افزودن بررسی \fBbad\-chained\-comparison\fP که هنگامی که یک مقایسهٔ زنجیره‌ای وجود دارد که در آن یک عبارت از نظر معنایی با دیگری ناسازگار است، یک هشدار صادر می‌کند.
.sp
بستن #6559 (#6559 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6559>)
.IP \(bu 2
افزودن بررسی \fBimplicit\-flag\-alias\fP که هنگامی که یک کلاس مشتق‌شده از \fBenum.IntFlag\fP مقادیر صحیح متمایزی تخصیص می‌دهد که در موقعیت‌های بیتی مشترک سهیم هستند، یک هشدار صادر می‌کند.
.sp
ارجاع به #8102 (#8102 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8102>)
.UNINDENT
.SS "رفع موارد مثبت کاذب (False Positives Fixed)"
.INDENT 0.0
.IP \(bu 2
رفع چندین مورد مثبت کاذب برای توابعی که مستقیماً از حالت‌های تطبیق الگوی ساختاری (structural pattern matching) مقدار بازمی‌گردانند.
.sp
بستن #5288 (#5288 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5288>)
.IP \(bu 2
رفع مثبت کاذب برای \fBused\-before\-assignment\fP هنگامی که \fBtyping.TYPE_CHECKING\fP همراه با بلوک‌های if/elif/else استفاده می‌شود.
.sp
بستن #7574 (#7574 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7574>)
.IP \(bu 2
رفع مثبت کاذب برای isinstance\-second\-argument\-not\-valid\-type / W1116 \%<#\:isinstance-second-argument-not-valid-type> با انواع اجتماع (union types).
.sp
بستن #8205 (#8205 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8205>)
.IP \(bu 2
رفع مثبت کاذب برای \fBused\-before\-assignment\fP در مورد عبارات نام‌گذاری‌شده‌ای که پس از عنصر اول در یک list،‏ tuple یا set ظاهر می‌شوند.
.sp
بستن #8252 (#8252 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8252>)
.IP \(bu 2
رفع مثبت کاذب برای \fBwrong\-spelling\-in\-comment\fP در مورد نام‌های کلاس در یک کامنت نوعِ python 2.
.sp
بستن #8370 (#8370 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8370>)
.UNINDENT
.SS "رفع موارد منفی کاذب (False Negatives Fixed)"
.INDENT 0.0
.IP \(bu 2
رفع یک منفی کاذب برای missing\-parentheses\-for\-call\-in\-test / W0126 \%<#\:missing-parentheses-for-call-in-test>\(aq هنگامی که استنتاج برای بخش داخلی فراخوانی با شکست مواجه می‌شد، چرا که برای گزارش صحیح خطا به آن اطلاعات نیازی نبود.
.sp
ارجاع به #8185 (#8185 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8185>)
.IP \(bu 2
رفع منفی کاذب برای inconsistent\-returns در حلقه‌های while.
.sp
بستن #8280 (#8280 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8280>)
.UNINDENT
.SS "سایر رفع باگ‌ها (Other Bug Fixes)"
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب \fBused\-before\-assignment\fP هنگامی که عملگر والروس (walrus operator) همراه با یک عملگر سه‌تایی در مقداردهی اولیه کلید/مقدار دیکشنری استفاده می‌شود.
.sp
بستن #8125 (#8125 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8125>)
.IP \(bu 2
رفع مثبت کاذب \fBno\-name\-in\-module\fP که هنگام تعریف متغیری همنام با یکی از زیرماژول‌های بسته رخ می‌داد.
.sp
بستن #8148 (#8148 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8148>)
.IP \(bu 2
رفع یک فروپاشی (crash) در مفسر python < 3.9 پس از یک به‌روزرسانی ناموفق typing.
.sp
بستن #8161 (#8161 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8161>)
.IP \(bu 2
اصلاح پیام پیشنهادی \fBnested\-min\-max\fP برای نشان دادن امکان باز کردن (splat) شیءهای تکرارپذیر (iterable).
.sp
بستن #8168 (#8168 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8168>)
.IP \(bu 2
رفع یک فروپاشی که هنگام منفی کردن یک صفت کلاس در آرگومان start یک enumerate رخ می‌داد.
.sp
بستن #8207 (#8207 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8207>)
.IP \(bu 2
جلوگیری از صدور \fBinvalid\-name\fP برای خطی که در آن دستور \fBglobal\fP اعلان شده است.
.sp
بستن #8307 (#8307 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8307>)
.UNINDENT.SS سایر تغییرات
.INDENT 0.0
.IP \(bu 2
به‌روزرسانی توضیحات مربوط به \fBglobal\-variable\-not\-assigned\fP و افزودن سطح اطمینان (confidence).
.sp
بستن #5073 (#5073 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5073>)
.IP \(bu 2
مدل حاکمیت و مسیر تبدیل شدن به یک نگه‌دارنده (maintainer) در راستای تلاش ما برای تضمین امنیت زنجیره تأمین نرم‌افزاری که pylint در آن گنجانده شده، مستندسازی شده است.
.sp
ارجاع به #8329 (#8329 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8329>)
.UNINDENT
.SS تازه‌های Pylint 2.16
.INDENT 0.0
.TP
.B انتشار
2.16
.TP
.B تاریخ
2023\-02\-01
.UNINDENT
.SS خلاصه \-\- نکات برجسته انتشار
.sp
در نسخه 2.16.0، درک تجمیع (aggregation) و ترکیب (composition) را در \fBpyreverse\fP و همچنین روشی برای پاک‌سازی حافظه موقت (cache) میان اجراها در حالت سرور (در اصل برای یکپارچه‌سازی با VS Code) اضافه کردیم. جدا از رفع اشکال‌ها، تعداد زیادی بررسی‌ جدید و افزونه‌های تازه‌ای که مدت‌ها درخواست می‌شدند نیز پیاده‌سازی شده‌اند.
.sp
اگر می‌خواهید از تمامی بررسی‌های جدید بهره‌مند شوید، افزونه‌های زیر را بارگذاری کنید:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pylint.extensions.dict_init_mutate,
pylint.extensions.dunder,
pylint.extensions.typing,
pylint.extensions.magic_value,
.EE
.UNINDENT
.UNINDENT
.sp
ما همچنان از هرگونه مشارکت جامعه برای کمک به بازبینی، ادغام و افزودن مثال‌های خوب/بد به مستندات در
<\%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5953>>\(ga_ استقبال می‌کنیم. این کار بدون داشتن هیچ دانشی از \fBpylint\fP یا \fBastroid\fP قابل انجام است، بنابراین اگر می‌خواهید بدون تجربه قبلی با کد ما در توسعه \fBpylint\fP یا پروژه‌های متن‌باز مشارکت کنید، این یک نقطه ورود عالی است!
.sp
در نهایت، @clavedeluna و @nickdrozd به جمع مسئولان تریاژ (triagers) پیوستند؛ به تیم خوش آمدید!
.SS تازه‌های Pylint 2.16.4؟
.sp
تاریخ انتشار: 2023\-03\-06
.SS رفع موارد مثبت کاذب
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب برای isinstance\-second\-argument\-not\-valid\-type / W1116 \%<#\:isinstance-second-argument-not-valid-type> در انواع union.
.sp
بستن #8205 (#8205 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8205>)
.UNINDENT
.SS تازه‌های Pylint 2.16.3؟
.sp
تاریخ انتشار: 2023\-03\-03
.SS رفع موارد مثبت کاذب
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب برای \fBwrong\-spelling\-in\-comment\fP با نام‌های کلاس در یک کامنت نوع (type comment) مربوط به python 2.
.sp
بستن #8370 (#8370 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8370>)
.UNINDENT
.SS سایر رفع اشکال‌ها
.INDENT 0.0
.IP \(bu 2
جلوگیری از صدور \fBinvalid\-name\fP برای خطی که دستور \fBglobal\fP در آن اعلان شده است.
.sp
بستن #8307 (#8307 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8307>)
.UNINDENT.SS چه مواردی در Pylint 2.16.2 جدید است؟
.sp
تاریخ انتشار: 2023\-02\-13
.SS قابلیت‌های جدید
.INDENT 0.0
.IP \(bu 2
افزودن گزینهٔ \fI\-\-version\fP به \fIpyreverse\fP\&.
.sp
ارجاع: #7851 (#7851 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7851>)
.UNINDENT
.SS مثبت‌های کاذب برطرف‌شده
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب برای \fBused\-before\-assignment\fP هنگامی که
\fBtyping.TYPE_CHECKING\fP به همراه بلوک‌های if/elif/else استفاده می‌شود.
.sp
بستن #7574 (#7574 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7574>)
.IP \(bu 2
رفع مثبت کاذب برای \fBused\-before\-assignment\fP برای عبارت‌های نام‌گذاری‌شده
که پس از نخستین عنصر در یک list، tuple یا set قرار می‌گیرند.
.sp
بستن #8252 (#8252 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8252>)
.UNINDENT
.SS سایر رفع اشکال‌ها
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب \fBused\-before\-assignment\fP هنگامی که عملگر walrus
به همراه یک عملگر سه‌تایی در مقداردهی اولیه کلید/مقدار دیکشنری استفاده می‌شود.
.sp
بستن #8125 (#8125 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8125>)
.IP \(bu 2
رفع مثبت کاذب \fBno\-name\-in\-module\fP که هنگام تعریف یک متغیر
توسط یک بسته با نامی یکسان با یکی از زیرماژول‌های آن صادر می‌شد.
.sp
بستن #8148 (#8148 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8148>)
.IP \(bu 2
اصلاح پیام پیشنهادی \fBnested\-min\-max\fP جهت اشاره به اینکه امکان باز کردن (splat)
اشیاء تکرارپذیر (iterables) وجود دارد.
.sp
بستن #8168 (#8168 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8168>)
.IP \(bu 2
رفع یک فروپاشی که هنگام منفی شدن یک صفت کلاس در آرگومان start
از enumerate رخ می‌داد.
.sp
بستن #8207 (#8207 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8207>)
.UNINDENT
.SS چه مواردی در Pylint 2.16.1 جدید است؟
.sp
تاریخ انتشار: 2023\-02\-02
.SS سایر رفع اشکال‌ها
.INDENT 0.0
.IP \(bu 2
رفع یک فروپاشی برای مفسر python نسخهٔ کمتر از 3.9 به‌دنبال یک به‌روزرسانی
ناموفق typing.
.sp
بستن #8161 (#8161 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8161>)
.UNINDENT
.SS چه مواردی در Pylint 2.16.0 جدید است؟
.sp
تاریخ انتشار: 2023\-02\-01
.SS تغییرات نیازمند اقدام کاربر
.INDENT 0.0
.IP \(bu 2
گزینهٔ \fBaccept\-no\-raise\-doc\fP مربوط به \fBmissing\-raises\-doc\fP اکنون
همواره به‌درستی اعمال خواهد شد.
.sp
هنگامی که هیچ استثنایی مستند نشده و accept\-no\-raise\-doc برابر با true باشد، Pylint دیگر خطای missing\-raises\-doc / W9006 \%<#\:missing-raises-doc> (W9006) را ایجاد نخواهد کرد (مورد #7208).
اگر انتظار داشتید در این حالت خطاهای missing\-raises\-doc / W9006 \%<#\:missing-raises-doc>
صادر شوند، اکنون باید \fBaccept\-no\-raise\-doc=no\fP را در پیکربندی خود
اضافه کنید تا همان رفتار حفظ شود.
.sp
بستن #7208 (#7208 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7208>)
.UNINDENT
.SS قابلیت‌های جدید
.INDENT 0.0
.IP \(bu 2
قالب خروجی \fBno\-header\fP اضافه شد. در صورت فعال شدن با
\fB\-\-output\-format=no\-header\fP، نام ماژول در خروجی
گنجانده نخواهد شد.
.sp
بستن #5362 (#5362 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5362>)
.IP \(bu 2
گزینهٔ پیکربندی \fBclear\-cache\-post\-run\fP جهت پشتیبانی از استفاده‌های
شبه‌سرور اضافه شد.
اگر انتظار دارید فایل‌های تحلیل‌شده بین اجراها تغییر کنند، از این پرچم استفاده کنید.
.sp
ارجاع: #5401 (#5401 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5401>)
.IP \(bu 2
افزودن گزینهٔ \fB\-\-allow\-reexport\-from\-package\fP برای تنظیم بررسی
\fBuseless\-import\-alias\fP تا در صورتی که یک نام از یک بسته
دوباره صادر (re-export) شود، هشداری صادر نکند.
.sp
بستن #6006 (#6006 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6006>)
.IP \(bu 2
به‌روزرسانی \fBpyreverse\fP برای تمایز قائل شدن میان تجمیع‌ها (aggregations) و ترکیب‌ها (compositions).
ابزار \fBpyreverse\fP بررسی می‌کند که آیا یک شیء از طریق پارامترهای متد (از طریق راهنماهای نوع یا type hints)
یک Instance است یا Call، تا تصمیم بگیرد که آیا یک ترکیب است یا تجمیع.
.sp
ارجاع: #6543 (#6543 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6543>)
.UNINDENT.SS "بررسی‌های جدید (New Checks)"
.INDENT 0.0
.IP \(bu 2
افزودن بررسی \fBpointless\-exception\-statement\fP که هنگام ایجاد یک
\fBException\fP بدون انتساب، raise یا بازگردانده (return) شدن آن، هشدار صادر می‌کند.
.sp
Refs #3110 (#3110 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3110>)
.IP \(bu 2
افزودن پیام \fBshadowed\-import\fP برای importهای دارای نام مستعار (aliased imports).
.sp
Closes #4836 (#4836 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:4836>)
.IP \(bu 2
افزودن بررسی جدیدی به نام \fBunbalanced\-dict\-unpacking\fP برای بررسی
باز کردن نامتوازن دیکشنری (dict unpacking)
در انتساب‌ها و حلقه‌های for.
.sp
Closes #5797 (#5797 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5797>)
.IP \(bu 2
افزودن بررسی‌کننده جدید \fBpositional\-only\-arguments\-expected\fP برای بررسی
مواردی که
آرگومان‌های فقط-موقعیتی (positional\-only) به صورت آرگومان‌های کلیدواژه‌ای ارسال شده‌اند.
.sp
Closes #6489 (#6489 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6489>)
.IP \(bu 2
افزودن \fBsingledispatch\-method\fP که اطلاع می‌دهد \fB@singledispatch\fP باید
توابع را تزیین (decorate) کند، نه متدهای کلاس یا نمونه (instance).
افزودن \fBsingledispatchmethod\-function\fP که اطلاع می‌دهد
\fB@singledispatchmethod\fP باید متدهای کلاس یا نمونه را تزیین کند، نه
توابع را.
.sp
Closes #6917 (#6917 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6917>)
.IP \(bu 2
تغییر نام \fBbroad\-except\fP به \fBbroad\-exception\-caught\fP و افزودن بررسی‌کننده جدید
\fBbroad\-exception\-raised\fP
که در صورت raise شدن استثناهای عمومی \fBBaseException\fP یا \fBException\fP هشدار می‌دهد.
.sp
Closes #7494 (#7494 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7494>)
.IP \(bu 2
افزودن \fBnested\-min\-max\fP که مواردی مانند \fBmin(1, min(2, 3))\fP را جهت ساده‌سازی به
\fBmin(1, 2, 3)\fP مشخص می‌کند.\&
.sp
Closes #7546 (#7546 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7546>)
.IP \(bu 2
گسترش \fBuse\-dict\-literal\fP تا هنگام فراخوانی \fBdict()\fP با ارسال
آرگومان‌های کلیدواژه‌ای نیز هشدار دهد.
.sp
Closes #7690 (#7690 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7690>)
.IP \(bu 2
افزودن بررسی \fBnamed\-expr\-without\-context\fP برای صدور هشدار در صورتی که یک
عبارت نام‌گذاری‌شده (named expression) خارج از زمینه‌هایی مانند \fBif\fP، \fBfor\fP، \fBwhile\fP یا
یک comprehension استفاده شود.
.sp
Refs #7760 (#7760 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7760>)
.IP \(bu 2
افزودن بررسی \fBinvalid\-slice\-step\fP برای هشدار در مورد مقدار گام برش برابر با \fB0\fP
برای دنباله‌های توکار (builtin) متداول.
.sp
Refs #7762 (#7762 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7762>)
.IP \(bu 2
افزودن بررسی \fBconsider\-refactoring\-into\-while\-condition\fP جهت پیشنهاد
بازآفرینی (refactoring) هنگامی که
یک حلقه while با شرط ثابت تعریف شده و نخستین دستور آن یک عبارت \fBif\fP
بلافاصله برای بررسی شرط \fBbreak\fP باشد.
.sp
Closes #8015 (#8015 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8015>)
.UNINDENT
.SS "افزونه‌ها (Extensions)"
.INDENT 0.0
.IP \(bu 2
افزودن بررسی‌کننده افزونه جدید \fBdict\-init\-mutate\fP که تغییر دادن (mutating) یک
دیکشنری را بلافاصله
پس از ایجاد آن مشخص می‌کند.
.sp
Closes #2876 (#2876 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:2876>)
.IP \(bu 2
افزودن بررسی افزونه \fBbad\-dunder\-name\fP که متدهای داندر (dunder) نامعتبر یا دارای غلط املایی را مشخص می‌کند.
می‌توانید از گزینه \fBgood\-dunder\-names\fP برای مجاز کردن نام‌های داندر مشخص استفاده کنید.
.sp
Closes #3038 (#3038 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3038>)
.IP \(bu 2
افزودن بررسی \fBconsider\-using\-augmented\-assign\fP برای افزونه \fBCodeStyle\fP
که مواردی مانند \fBx = x + 1\fP را جهت ساده‌سازی به \fBx += 1\fP مشخص می‌کند.\&
این بررسی به‌طور پیش‌فرض غیرفعال است. برای استفاده از آن، افزونه سبک کد را
با \fBload\-plugins=pylint.extensions.code_style\fP بارگذاری کرده و
\fBconsider\-using\-augmented\-assign\fP را به گزینه \fBenable\fP اضافه کنید.
.sp
Closes #3391 (#3391 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3391>)
.IP \(bu 2
افزودن بررسی‌کننده پلاگین \fBmagic\-number\fP برای مقایسه با مقادیر ثابت به‌جای
ثابت‌های نام‌گذاری‌شده یا enumها.
می‌توانید از آن با \fB\-\-load\-plugins=pylint.extensions.magic_value\fP استفاده کنید.\&
.sp
Closes #7281 (#7281 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7281>)
.IP \(bu 2
افزودن پیام \fBredundant\-typehint\-argument\fP برای پلاگین \fItyping\fP جهت اعلان typehintهای
انتساب تکراری.
برای فعال‌سازی این پیام، پلاگین را با دستور زیر فعال کنید:
\fB\-\-load\-plugins=pylint.extensions.typing\fP\&.
.sp
Closes #7636 (#7636 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7636>)
.UNINDENT.SS موارد مثبت کاذب رفع‌شده (False Positives Fixed)
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب برای \fBunused\-variable\fP و \fBunused\-import\fP هنگامی که یک نام
تنها در یک یادداشت نوع لیترال رشته‌ای استفاده شده باشد.
.sp
بستن #3299 (#3299 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3299>)
.IP \(bu 2
مستندسازی یک مثبت کاذب شناخته‌شده برای \fBuseless\-suppression\fP هنگام غیرفعال‌سازی
\fBline\-too\-long\fP در ماژولی که فقط حاوی کامنت است و کدی ندارد.
.sp
بستن #3368 (#3368 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3368>)
.IP \(bu 2
هشدار \fBtrailing\-whitespaces\fP دیگر درون رشته‌ها گزارش نمی‌شود.
.sp
بستن #3822 (#3822 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3822>)
.IP \(bu 2
رفع مثبت کاذب برای \fBglobal\-variable\-not\-assigned\fP هنگامی که یک متغیر
سراسری از طریق یک گره \fBImportFrom\fP مجدداً مقداردهی می‌شود.
.sp
بستن #4809 (#4809 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:4809>)
.IP \(bu 2
رفع مثبت کاذب برای \fBuse\-maxsplit\-arg\fP با متد split سفارشی.
.sp
بستن #4857 (#4857 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:4857>)
.IP \(bu 2
رفع مثبت کاذب \fBlogging\-fstring\-interpolation\fP صادرشده هنگام لاگ‌گیری و
f\-string با قالب‌بندی \fB%s\fP.
.sp
بستن #4984 (#4984 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:4984>)
.IP \(bu 2
رفع مثبت کاذب برای \fBused\-before\-assignment\fP در انطباق الگو (pattern matching)
همراه با یک محافظ (guard).
.sp
بستن #5327 (#5327 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5327>)
.IP \(bu 2
رفع \fBuse\-sequence\-for\-iteration\fP هنگام باز کردن بسته‌بندی یک مجموعه (set) با \fB*\fP\&.
.sp
بستن #5788 (#5788 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5788>)
.IP \(bu 2
رفع مثبت کاذب \fBdeprecated\-method\fP زمانی که نام مستعار یک متد، مشابه
نام متد منسوخ‌شده باشد.
.sp
بستن #5886 (#5886 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5886>)
.IP \(bu 2
رفع مثبت کاذب \fBassigning\-non\-slot\fP هنگامی که یک صفت کلاس مجدداً مقداردهی می‌شود.
.sp
بستن #6001 (#6001 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6001>)
.IP \(bu 2
رفع مثبت کاذب برای \fBtoo\-many\-function\-args\fP هنگامی که فراخوانی یک تابع درون کلاسی که
تابع در آن تعریف شده، به یک صفت کلاس نسبت داده می‌شود.
.sp
بستن #6592 (#6592 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6592>)
.IP \(bu 2
رفع مثبت کاذب \fBabstract\-method\fP در کلاس‌های Protocol.
.sp
بستن #7209 (#7209 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7209>)
.IP \(bu 2
اکنون Pylint آرگومان کلیدواژه‌ای \fBkw_only\fP را برای \fBdataclass\fP تشخیص می‌دهد.
.sp
بستن #7290، بستن #6550، بستن #5857 (#7290 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7290>)
.IP \(bu 2
رفع مثبت کاذب برای \fBundefined\-loop\-variable\fP در حلقه‌های \fBfor\-else\fP که از تابعی با
یادداشت نوع بازگشتی \fBNoReturn\fP یا \fBNever\fP استفاده می‌کنند.
.sp
بستن #7311 (#7311 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7311>)
.IP \(bu 2
رفع \fBused\-before\-assignment\fP برای توابع/کلاس‌های تعریف‌شده درون محافظ بررسی نوع (type checking guard).
.sp
بستن #7368 (#7368 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7368>)
.IP \(bu 2
رفع مثبت کاذب برای \fBunhashable\-member\fP هنگام ایجاد زیرکلاس از \fBdict\fP و
استفاده از آن زیرکلاس به‌عنوان کلید دیکشنری.
.sp
بستن #7501 (#7501 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7501>)
.IP \(bu 2
اصلاح پیام برای \fBunnecessary\-dunder\-call\fP برای \fB__aiter__\fP و
\fB__aneext__\fP\&. همچنین
تنها زمانی هشدار صادر شود که \fBpy\-version\fP >= 3.10 باشد.
.sp
بستن #7529 (#7529 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7529>)
.IP \(bu 2
رفع مثبت کاذب \fBused\-before\-assignment\fP هنگامی که شاخه else تابع
\fBsys.exit\fP یا توابع پایان‌دهنده مشابه را فراخوانی می‌کند.
.sp
بستن #7563 (#7563 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7563>)
.IP \(bu 2
رفع مثبت کاذب برای \fBused\-before\-assignment\fP برای درون‌ریزی‌های محافظت‌شده با
\fBtyping.TYPE_CHECKING\fP که بعداً در یادداشت‌های متغیر استفاده می‌شوند.
.sp
بستن #7609 (#7609 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7609>)
.IP \(bu 2
رفع مثبت کاذب برای \fBsimplify\-boolean\-expression\fP هنگامی که مقادیر چندگانه‌ای
برای یک مقدار ثابت استنتاج می‌شود.
.sp
بستن #7626 (#7626 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7626>)
.IP \(bu 2
اگر \fBenumerate\fP با \fBstart\fP فراخوانی شود،
\fBunnecessary\-list\-index\-lookup\fP دیگر به اشتباه صادر نخواهد شد.
.sp
بستن #7682 (#7682 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7682>)
.IP \(bu 2
عدم صدور هشدار درباره \fBstop\-iteration\-return\fP هنگام استفاده از \fBnext()\fP روی
\fBitertools.cycle\fP\&.
.sp
بستن #7765 (#7765 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7765>)
.IP \(bu 2
رفع مثبت کاذب \fBused\-before\-assignment\fP هنگامی که عملگر والروس
در یک عملگر سه‌گانه استفاده می‌شود.
.sp
بستن #7779 (#7779 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7779>)
.IP \(bu 2
رفع مثبت کاذب \fBmissing\-param\-doc\fP زمانی که پارامتر تابع دارای
یک زیرخط اسکیپ‌شده باشد.
.sp
بستن #7827 (#7827 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7827>)
.IP \(bu 2
رفع مثبت کاذب \fBmethod\-cache\-max\-size\-none\fP برای متدهایی که
از \fBEnum\fP به ارث می‌رسند.
.sp
بستن #7857 (#7857 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7857>)
.IP \(bu 2
\fBmultiple\-statements\fP دیگر برای کدهای توخالی تابع (stubs) که از
\fB\&...\fP درون‌خطی استفاده می‌کنند، فعال نمی‌شود.
.sp
بستن #7860 (#7860 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7860>)
.IP \(bu 2
رفع یک مثبت کاذب برای \fBused\-before\-assignment\fP زمانی که نامی محافظت‌شده با
\fBif TYPE_CHECKING:\fP به عنوان یادداشت نوع در بدنه تابع استفاده شود و
بعداً در همان دامنه مجدداً درون‌ریزی گردد.
.sp
بستن #7882 (#7882 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7882>)
.IP \(bu 2
جلوگیری از \fBused\-before\-assignment\fP هنگامی که درون‌ریزی‌های محافظت‌شده با \fBif
TYPE_CHECKING\fP
در زمان استفاده دوباره محافظت شوند.
.sp
بستن #7979 (#7979 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7979>)
.IP \(bu 2
رفع مثبت کاذب برای \fBtry\-except\-raise\fP با چندین استثنا در یک
دستور except در صورتی که استثناها در فضای نام متفاوتی باشند.
.sp
بستن #8051 (#8051 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8051>)
.IP \(bu 2
رفع خطاهای \fBinvalid\-name\fP برای \fBtyping_extension.TypeVar\fP\&.
.sp
ارجاع به #8089 (#8089 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8089>)
.IP \(bu 2
رفع مثبت کاذب \fBno\-kwoa\fP برای مدیران زمینه (context managers).
.sp
بستن #8100 (#8100 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8100>)
.IP \(bu 2
رفع یک مثبت کاذب برای \fBredefined\-variable\-type\fP هنگام وجود
متدهای \fBasync\fP\&.
.sp
بستن #8120 (#8120 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8120>)
.UNINDENT.SS "رفع موارد منفی کاذب (False Negatives Fixed)"
.INDENT 0.0
.IP \(bu 2
کد پس از فراخوانی \fBquit\fP، \fBexit\fP، \fBsys.exit\fP یا \fBos._exit\fP
به‌عنوان \fIunreachable\fP (غیرقابل‌دسترس) علامت‌گذاری خواهد شد\&.
.sp
ارجاع به #519 (#519 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:519>)
.IP \(bu 2
صدور هشدار \fBused\-before\-assignment\fP هنگامی که آرگومان‌های تابع درون یک
تابع درونی مجدداً تعریف شده و پیش از انتساب، در آنجا مورد دسترسی قرار گیرند.
.sp
بستن #2374 (#2374 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:2374>)
.IP \(bu 2
رفع یک مورد منفی کاذب برای \fBunused\-import\fP هنگامی که یک ماژول از یک import در
یک نوع‌نوشت (type annotation) استفاده می‌کرد که در ماژول دیگری نیز استفاده شده بود.
.sp
بستن #4150 (#4150 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:4150>)
.IP \(bu 2
علامت‌گذاری \fBsuperfluous\-parens\fP در صورت استفاده از پرانتز هنگام
الحاق رشته‌ها (string concatenation).
.sp
بستن #4792 (#4792 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:4792>)
.IP \(bu 2
صدور هشدار \fBused\-before\-assignment\fP هنگام اتکا به نام‌هایی که تنها تحت
شروطی تعریف شده‌اند که همواره نادرست (false) ارزیابی می‌شوند.
.sp
بستن #4913 (#4913 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:4913>)
.IP \(bu 2
هشدار \fBconsider\-using\-join\fP اکنون می‌تواند برای جداکننده‌های رشته‌ای غیرخالی نیز صادر شود.
.sp
بستن #6639 (#6639 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6639>)
.IP \(bu 2
صدور پیام \fBused\-before\-assignment\fP برای واردسازی‌های بیشترِ محافظت‌شده توسط
\fBTYPE_CHECKING\fP
.sp
پیش از این، این پیام تنها برای واردسازی‌هایی صادر می‌شد که مستقیماً تحت
\fBTYPE_CHECKING\fP محافظت شده بودند، و نه مواردی که با عمق دو شاخهٔ \fBif\fP محافظت شده بودند
یا هنگامی که \fBTYPE_CHECKING\fP
از \fBtyping\fP تحت یک نام مستعار (alias) وارد شده بود.
.sp
بستن #7539 (#7539 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7539>)
.IP \(bu 2
رفع یک منفی کاذب برای \fBunused\-import\fP هنگامی که یک ثابت درون
\fBtyping.Annotated\fP به‌عنوان ارجاع به یک import در نظر گرفته می‌شد.
.sp
بستن #7547 (#7547 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7547>)
.IP \(bu 2
پیام \fBconsider\-using\-any\-or\-all\fP اکنون در مواردی صادر می‌شود که یک مقدار
بولی مقداردهی اولیه شده، در طول حلقه مجدداً مقداردهی شده و بلافاصله بازگردانده (return) شود.
.sp
بستن #7699 (#7699 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7699>)
.IP \(bu 2
گسترش \fBinvalid\-slice\-index\fP برای صدور یک هشدار در صورت استفاده از اندیس‌های برش نامعتبر
با دنباله‌های رشته‌ای و بایتی، و اشیاء range.
.sp
ارجاع به #7762 (#7762 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7762>)
.IP \(bu 2
رفع منفی کاذب \fBunnecessary\-list\-index\-lookup\fP هنگامی که \fBenumerate\fP
با \fBiterable\fP به‌عنوان یک آرگومان کلیدواژه‌ای (kwarg) فراخوانی شود.
.sp
بستن #7770 (#7770 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7770>)
.IP \(bu 2
پیام \fBno\-else\-return\fP یا \fBno\-else\-raise\fP در صورتی صادر خواهد شد که بلوک \fBexcept\fP
همواره با return یا raise پایان یابد.
.sp
بستن #7788 (#7788 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7788>)
.IP \(bu 2
رفع منفی کاذب \fBdangerous\-default\-value\fP هنگام استفاده از \fB*\fP.
.sp
بستن #7818 (#7818 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7818>)
.IP \(bu 2
هشدار \fBconsider\-using\-with\fP اکنون برای \fBpathlib.Path.open\fP نیز فعال می‌شود\&.
.sp
بستن #7964 (#7964 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7964>)
.UNINDENT
.SS "سایر رفع اشکال‌ها (Other Bug Fixes)"
.INDENT 0.0
.IP \(bu 2
رفع اشکال در تشخیص \fBunused\-variable\fP هنگام پیمایش روی متغیر.
.sp
بستن #3044 (#3044 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3044>)
.IP \(bu 2
رفع اشکال در پویش نام‌های درون آرگومان‌های \fBtyping.Literal\fP\&.
برای جزئیات به \%<https://\:peps\:.python\:.org/\:pep-0586/#\:literals-enums-and-forward-references>
مراجعه کنید.
.sp
ارجاع به #3299 (#3299 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3299>)
.IP \(bu 2
به‌روزرسانی بررسی \fBdisallowed\-name\fP برای علامت‌گذاری متغیرهای سطح ماژول.
.sp
بستن #3701 (#3701 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3701>)
.IP \(bu 2
در صورت متوقف‌شدن یک پردازش موازی، Pylint دیگر دچار بن‌بست (deadlock) نشده و در عوض بلافاصله
با شکست مواجه خواهد شد.
.sp
بستن #3899 (#3899 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3899>)
.IP \(bu 2
رفع مشکل بررسی فایل‌های نادیده‌گرفته‌شده (ignored files) هنگامی که از طریق \fBstdin\fP ارسال شوند.
.sp
بستن #4354 (#4354 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:4354>)
.IP \(bu 2
رفع منفی کاذب \fBno\-member\fP هنگامی که انتساب افزوده (augmented assign) به‌صورت دستی و
بدون \fB+=\fP انجام شود\&.
.sp
بستن #4562 (#4562 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:4562>)
.IP \(bu 2
هرگونه assertion روی یک تاپل مقداردار (غیرخالی) اکنون هشدار \fBassert\-on\-tuple\fP
را دریافت خواهد کرد.
.sp
بستن #4655 (#4655 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:4655>)
.IP \(bu 2
پیام‌های \fBmissing\-return\-doc\fP، \fBmissing\-raises\-doc\fP و \fBmissing\-yields\-doc\fP
اکنون گزینهٔ \fBno\-docstring\-rgx\fP را رعایت می‌کنند.
.sp
بستن #4743 (#4743 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:4743>)
.IP \(bu 2
به‌روزرسانی پیام راهنمای \fBreimported\fP برای شفافیت بیشتر.
.sp
بستن #4836 (#4836 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:4836>)
.IP \(bu 2
در صورت استفاده از عملیات‌های بیتی (bitwise)، پیام \fBconsider\-iterating\-dictionary\fP
دیگر صادر نخواهد شد.
.sp
بستن #5478 (#5478 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5478>)
.IP \(bu 2
استفاده از آکولادهای سفارشی در \fBmsg\-template\fP اکنون به‌درستی کار خواهد کرد.
.sp
بستن #5636 (#5636 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5636>)
.IP \(bu 2
ابزار Pylint اکنون موارد تکراری داده‌شده به آن را پیش از ارزیابی فیلتر می‌کند. خروجی
باید یکسان باشد، چه یک فایل چندین بار داده/یافت شده باشد یا خیر.
.sp
بستن #6242، #4053 (#6242 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6242>)
.IP \(bu 2
حذف فراخوانی متد داندر \fB__index__\fP از بررسی \fBunnecessary\-dunder\-call\fP.
.sp
بستن #6795 (#6795 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6795>)
.IP \(bu 2
اصلاح پردازش \fB\-\-\fP به‌عنوان جداکنندهٔ میان آرگومان‌های مکانی و پرچم‌ها.
این مورد در واقع در نسخهٔ 2.14.5 برطرف نشده بود.
.sp
بستن #7003، ارجاع به #7096 (#7003 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7003>)
.IP \(bu 2
جلوگیری از فروپاشی (crash) در هنگام رخ دادن \fBOSError\fP در فرایند یافتن فایل پیکربندی.
.sp
بستن #7169 (#7169 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7169>)
.IP \(bu 2
پیام‌های ارسال‌شده به گزارشگر اکنون رونوشت می‌شوند تا یک گزارشگر نتواند
پیام ارسال‌شده به سایر گزارشگرها را تغییر دهد.
.sp
بستن #7214 (#7214 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7214>)
.IP \(bu 2
اصلاح مشکلی که در آن افزونه‌های سفارشیِ مشخص‌شده از خط فرمان می‌توانستند بدون خطا
و در سکوت با شکست مواجه شوند.
.sp
به‌طور خاص، اگر یک افزونه متکی به گزینهٔ \fBinit\-hook\fP برای تغییر دادن \fBsys.path\fP
پیش از واردسازی آن باشد، این مورد اکنون پیام \fBbad\-plugin\-value\fP را صادر می‌کند. پیش از این
تغییر، ثبت افزونه برای استفاده بی‌صدا با شکست مواجه می‌شد، اما هرگونه پیکربندی
بارگذاری می‌گردید که می‌توانست اثرات ناخواسته‌ای داشته باشد.
.sp
رفع بخشی از #7264. (#7264 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7264>)
.IP \(bu 2
به‌روزرسانی بررسی‌کنندهٔ \fBmodified_iterating\fP برای رفع فروپاشی با حلقه‌های \fBfor\fP روی
لیست خالی.
.sp
بستن #7380 (#7380 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7380>)
.IP \(bu 2
به‌روزرسانی متن پیام‌های \fBarguments\-differ\fP و \fBarguments\-renamed\fP جهت شفاف‌سازی
شیء بازنویسی‌کننده (overriding).
.sp
بستن #7390 (#7390 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7390>)
.IP \(bu 2
محدودهٔ اعمال \fBdisable\-next\fP اکنون به‌درستی تنها به خط بعدی محدود می‌شود.
.sp
بستن #7401 (#7401 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7401>)
.UNINDENT.IP \(bu 2
رفع فروپاشی در بررسی‌کنندهٔ \fBunhashable\-member\fP هنگام استفاده از یک \fBlambda\fP به عنوان
کلید dict.
.sp
بستن #7453 (#7453 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7453>)
.IP \(bu 2
افزودن \fBmailcap\fP به فهرست ماژول‌های منسوخ‌شده.
.sp
بستن #7457 (#7457 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7457>)
.IP \(bu 2
رفع فروپاشی در بررسی‌کنندهٔ \fBmodified\-iterating\-dict\fP شامل
صفت‌های نمونه (instance attributes).
.sp
بستن #7461 (#7461 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7461>)
.IP \(bu 2
بررسی‌کنندهٔ \fBinvalid\-class\-object\fP دیگر هنگام انتساب به \fB__class__\fP در کنار
متغیری دیگر، دچار فروپاشی نمی‌شود.
.sp
بستن #7467 (#7467 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7467>)
.IP \(bu 2
گزینهٔ \fB\-\-help\-msg\fP اکنون دوباره فهرستی از شناسه‌های پیام جداشده با کاما را می‌پذیرد.
.sp
بستن #7471 (#7471 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7471>)
.IP \(bu 2
امکان مشخص‌کردن استثناهای غیرتوکار در گزینهٔ \fBovergeneral\-exception\fP
با استفاده از نام کامل استثنا (qualified name).
.sp
بستن #7495 (#7495 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7495>)
.IP \(bu 2
گزارش \fBno\-self\-argument\fP به جای \fBno\-method\-argument\fP برای متدهایی
با آرگومان‌های متغیر (variadic arguments).
.sp
بستن #7507 (#7507 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7507>)
.IP \(bu 2
رفع مشکلی که در آن \fBsyntax\-error\fP نمی‌توانست برای فایل‌های دارای
کدگذاری نامعتبر ایجاد شود.
.sp
بستن #7522 (#7522 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7522>)
.IP \(bu 2
رفع مثبت کاذب برای \fBredefined\-outer\-name\fP هنگام نام مستعار دادن به \fBtyping\fP
مثلاً به صورت \fBt\fP و محافظت از importها زیر \fBt.TYPE_CHECKING\fP\&.
.sp
بستن #7524 (#7524 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7524>)
.IP \(bu 2
رفع فروپاشی در بررسی‌کنندهٔ \fBmodified_iterating\fP هنگام پیمایش روی مجموعه‌ای (set)
که به عنوان صفت کلاس تعریف شده است.
.sp
بستن #7528 (#7528 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7528>)
.IP \(bu 2
استفاده از \fBpy\-version\fP برای تعیین اینکه آیا پیامی باید برای پیام‌های
تعریف‌شده با \fBmax\-version\fP یا \fBmin\-version\fP صادر شود یا خیر\&.
.sp
بستن #7569 (#7569 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7569>)
.IP \(bu 2
بهبود بررسی \fBbad\-thread\-instantiation\fP جهت هشدار در صورتی که \fBtarget\fP به عنوان یک آرگومان کلیدواژه‌ای
یا به عنوان آرگومان دوم ارسال نشده باشد.
.sp
بستن #7570 (#7570 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7570>)
.IP \(bu 2
رفع حالت خاصی از متد سفارشی با نام \fBnext\fP که موجب بروز خطای astroid می‌شد.
.sp
بستن #7610 (#7610 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7610>)
.IP \(bu 2
رفع فروپاشی در چندپردازشی (multi\-processing) که مانع از استفاده از بیش از ۱ ریسه (thread) در
MacOS می‌شد.
.sp
اشیاء ماژول و خطاهای بازگردانده‌شده که توسط بارگذار افزونهٔ linter ذخیره شده بودند،
نمی‌توانند به طور قابل اطمینان pickle شوند. این بدان معناست که \fBdill\fP هنگام
تلاش برای سریال‌سازی شیء linter جهت استفاده در چندپردازشی، خطایی ایجاد می‌کرد.
.sp
بستن #7635. (#7635 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7635>)
.IP \(bu 2
رفع فروپاشی‌ای که هنگام تجزیهٔ فایل‌هایی با کدگذاری غیرمنتظره که با \(aqutf\(aq شروع می‌شدند مانند
\fButf13\fP رخ می‌داد\&.
.sp
بستن #7661 (#7661 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7661>)
.IP \(bu 2
رفع فروپاشی هنگامی که یک کلاس فرزند با یک متد \fB__init__\fP از یک
کلاس والد دارای صفت کلاس \fB__init__\fP ارث‌بری می‌کند.
.sp
بستن #7742 (#7742 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7742>)
.IP \(bu 2
اصلاح مقدار پیکربندی پیش‌فرض \fBvalid\-metaclass\-classmethod\-first\-arg\fP از \(dqcls\(dq
به \(dqmcs\(dq
که موجب بروز هر دو مورد مثبت کاذب و منفی کاذب می‌شد.
.sp
بستن #7782 (#7782 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7782>)
.IP \(bu 2
رفع فروپاشی در بررسی \fBunnecessary_list_index_lookup\fP هنگام استفاده از
\fBenumerate\fP همراه با \fBstart\fP و یک صفت کلاس.
.sp
بستن #7821 (#7821 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7821>)
.IP \(bu 2
رفع فروپاشی در \fBstop\-iteration\-return\fP هنگامی که تابع توکار \fBnext\fP
بدون آرگومان فراخوانی شود.
.sp
بستن #7828 (#7828 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7828>)
.IP \(bu 2
هنگامی که pylint به دلیل ارائهٔ آرگومان‌های نادرست خارج می‌شود، کد خروج اکنون
مقدار مورد انتظار \fB32\fP خواهد بود\&.
.sp
ارجاع به #7931 (#7931 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7931>)
.IP \(bu 2
رفع استثنای \fBModuleNotFound\fP هنگام اجرای pylint روی یک پروژهٔ Django
با افزونهٔ فعال \fBpylint_django\fP\&.
.sp
بستن #7938 (#7938 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7938>)
.IP \(bu 2
رفع فروپاشی هنگام استنتاج یک مقدار و استفاده از qname آن روی یک برش (slice) که
به نادرستی فراخوانی شده بود.
.sp
بستن #8067 (#8067 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8067>)
.IP \(bu 2
استفاده از عبارت باقاعدهٔ (regex) بهتر برای بررسی صفت‌های خصوصی.
.sp
ارجاع به #8081 (#8081 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8081>)
.IP \(bu 2
رفع مشکل نحو جدید Union در ماژول typing در زمینهٔ زمان اجرا برای Python 3.10+\&.
.sp
بستن #8119 (#8119 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8119>)
.UNINDENT.SS "سایر تغییرات (Other Changes)"
.INDENT 0.0
.IP \(bu 2
اکنون Pylint پشتیبانی اولیه‌ای از Python 3.11 فراهم می‌کند.
.sp
بسته شدن #5920 (#5920 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5920>)
.IP \(bu 2
به‌روزرسانی پیام برای \fBabstract\-method\fP جهت گنجاندن نام کلاس فرزند.
.sp
بسته شدن #7124 (#7124 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7124>)
.IP \(bu 2
به‌روزرسانی چاپگرهای dot و plantuml در Pyreverse برای تشخیص انتزاعی بودن متدهای کلاس و نمایش آن‌ها با قلم مورب (italic).
برای چاپگر dot، برچسب به‌روز شد تا از نحو شبه\-HTML استفاده کند.
.sp
بسته شدن #7346 (#7346 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7346>)
.IP \(bu 2
افزونه‌ی \fBdocparams\fP اکنون مشخص کردن نوع (typing) در رشته‌های مستندات سبک Numpy را به عنوان \(dqمستندسازی\(dq برای پیام \fBmissing\-param\-doc\fP در نظر می‌گیرد.
.sp
ارجاع به #7398 (#7398 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7398>)
.IP \(bu 2
هشدارهای منسوخ‌شدگی (\fBDeprecationWarnings\fP) مرتبط اکنون با \fBstacklevel=2\fP صادر می‌شوند، بنابراین محل فراخوانی در پیام پیوست شده است.
.sp
بسته شدن #7463 (#7463 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7463>)
.IP \(bu 2
افزودن گزینه \fBminimal\fP به \fBpylint\-config\fP و مولد toml آن.
.sp
بسته شدن #7485 (#7485 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7485>)
.IP \(bu 2
افزودن نام متد به پیام‌های خطای \fBno\-method\-argument\fP و \fBno\-self\-argument\fP\&.
.sp
بسته شدن #7507 (#7507 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7507>)
.IP \(bu 2
جلوگیری از باقی ماندن حافظه موقت (cache) نصب pip در تصویر Docker.
.sp
ارجاع به #7544 (#7544 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7544>)
.IP \(bu 2
افزودن یک آرگومان فقط‌کلیدواژه‌ای \fBcompare_constants\fP به \fBsafe_infer\fP\&.
.sp
ارجاع به #7626 (#7626 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7626>)
.IP \(bu 2
افزودن گزینه \fBdefault_enabled\fP به دیکشنری پیام‌های اختیاری. گزینه‌ای برای غیرفعال کردن یک پیام بررسی‌کننده به صورت پیش‌فرض فراهم می‌کند.
جهت استفاده از یک پیام غیرفعال، کاربر باید آن را به صراحت با افزودن پیام به گزینه \fBenable\fP فعال کند.
.sp
ارجاع به #7629 (#7629 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7629>)
.IP \(bu 2
مرتب‌سازی خروجی \fB\-\-generated\-rcfile\fP\&.
.sp
ارجاع به #7655 (#7655 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7655>)
.IP \(bu 2
ابزار epylint اکنون منسوخ شده است و در pylint 3.0.0 حذف خواهد شد. تمام فایل‌های مرتبط با emacs و flymake حذف شدند و پشتیبانی آن‌ها از این پس در یک مخزن خارجی انجام خواهد گرفت:
\%<https://\:github\:.com/\:emacsorphanage/\:pylint>\&.
.sp
بسته شدن #7737 (#7737 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7737>)
.IP \(bu 2
افزودن آزمون برای قابلیت‌های پیکربندی موجود preferred\-modules.
.sp
ارجاع به #7957 (#7957 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7957>)
.UNINDENT
.SS "تغییرات داخلی (Internal Changes)"
.INDENT 0.0
.IP \(bu 2
افزودن و اصلاح آزمون‌های رگرسیون برای بارگذاری افزونه‌ها.
.sp
این کار آزمون‌هایی را که بارگذاری افزونه‌های سفارشیِ متأثر از هرگونه تغییر ایجادشده در \fBsys.path\fP هنگام اجرای یک \fBinit\-hook\fP را پوشش می‌دهند، تقویت می‌کند.
با توجه به قرارداد موجود مبنی بر مجاز بودن بارگذاری افزونه‌ها از طریق تغییر مسیر به این شیوه، اکنون این آخرین بخش از کار مورد نیاز برای بستن مسئله GitHub #7264 است.
.sp
بسته شدن #7264 (#7264 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7264>)
.UNINDENT.SS "تازه‌های Pylint 2.15 (What\(aqs New in Pylint 2.15)"
.INDENT 0.0
.TP
.B انتشار (Release)
2.15
.TP
.B تاریخ (Date)
2022\-08\-26
.UNINDENT
.SS "خلاصه \-\- نکات برجسته انتشار (Summary \-\- Release highlights)"
.sp
در pylint 2.15.0، ما یک بررسی جدید به نام \fBmissing\-timeout\fP اضافه کردیم تا درباره مقادیر پیش‌فرض زمان انتظار (timeout) که می‌توانند باعث معلق ماندن و توقف نامحدود برنامه شوند، هشدار دهد.
.sp
ما نحوه مدیریت بسته‌های فضای نام (namespace packages) را در \fBpylint\fP بهبود دادیم. اکنون بسته‌های بیشتری باید بدون نیاز به توسل به گزینه \fB\-\-recursive=y\fP بررسی و لینت شوند.
.sp
ما همچنان از هرگونه مشارکت جامعه کاربری برای بازبینی، یکپارچه‌سازی و افزودن نمونه‌های خوب/بد به مستندات
<\%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5953>>\(ga_ استقبال می‌کنیم. این کار بدون داشتن هرگونه دانش درباره \fBpylint\fP یا \fBastroid\fP قابل انجام است، بنابراین اگر می‌خواهید بدون تجربه قبلی با کد ما در \fBpylint\fP یا دنیای متن‌باز مشارکت کنید، این یک نقطه ورود عالی است!
.sp
از نظر ساختار داخلی، با تشکر از DudeNr33، شیوه تولید یادداشت‌های انتشار را تغییر دادیم. دیگر نیازی به رفع تعارض‌ها در گزارش تغییرات (changelog) نخواهد بود و همه مشارکت‌کنندگان از این بابت خرسند خواهند بود.
.sp
‏Marc Byrne به جمع نگه‌دارندگان پیوست، به تیم خوش آمدید!
.SS "تازه‌های Pylint 2.15.10 (What\(aqs new in Pylint 2.15.10?)"
.sp
تاریخ انتشار: 2023\-01\-09
.SS "رفع مثبت‌های کاذب (False Positives Fixed)"
.INDENT 0.0
.IP \(bu 2
رفع \fBuse\-sequence\-for\-iteration\fP هنگام باز کردن (unpacking) یک مجموعه (set) با \fB*\fP\&.
.sp
بسته شدن #5788 (#5788 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5788>)
.IP \(bu 2
رفع مثبت کاذب \fBassigning\-non\-slot\fP هنگامی که یک صفت کلاس مجدداً انتساب می‌یابد.
.sp
بسته شدن #6001 (#6001 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6001>)
.IP \(bu 2
رفع مثبت کاذب \fBused\-before\-assignment\fP هنگامی که عملگر والروس (walrus operator) در یک عملگر سه‌تایی استفاده می‌شود.
.sp
بسته شدن #7779 (#7779 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7779>)
.IP \(bu 2
جلوگیری از \fBused\-before\-assignment\fP هنگامی که واردات‌های محافظت‌شده با \fBif TYPE_CHECKING\fP در زمان استفاده نیز مجدداً محافظت شده‌اند.
.sp
بسته شدن #7979 (#7979 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7979>)
.UNINDENT
.SS "سایر رفع باگ‌ها (Other Bug Fixes)"
.INDENT 0.0
.IP \(bu 2
استفاده از آکولادهای سفارشی در \fBmsg\-template\fP اکنون به درستی کار خواهد کرد.
.sp
بسته شدن #5636 (#5636 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5636>)
.UNINDENT
.SS "تازه‌های Pylint 2.15.9 (What\(aqs new in Pylint 2.15.9?)"
.sp
تاریخ انتشار: 2022\-12\-17
.SS "رفع مثبت‌های کاذب (False Positives Fixed)"
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب برای \fBused\-before\-assignment\fP در تطبیق الگو (pattern matching) همراه با گارد (guard).
.sp
بسته شدن #5327 (#5327 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5327>)
.UNINDENT
.SS "سایر رفع باگ‌ها (Other Bug Fixes)"
.INDENT 0.0
.IP \(bu 2
چنانچه یک کار موازی متوقف (kill) شود، Pylint دیگر دچار بن‌بست (deadlock) نخواهد شد و در عوض بلافاصله با خطا پایان می‌یابد.
.sp
بسته شدن #3899 (#3899 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3899>)
.IP \(bu 2
هنگامی که pylint به دلیل ارائه آرگومان‌های نامعتبر خارج می‌شود، وضعیت خروج اکنون مقدار مورد انتظار \fB32\fP خواهد بود.
.sp
مرجع #7931 (#7931 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7931>)
.IP \(bu 2
رفع استثنای \fBModuleNotFound\fP هنگام اجرای pylint روی یک پروژه Django با افزونه فعال \fBpylint_django\fP.
.sp
بسته شدن #7938 (#7938 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7938>)
.UNINDENT.SS چه مواردی در Pylint 2.15.8 جدید است؟
.sp
تاریخ انتشار: 2022\-12\-05
.SS مثبت‌های کاذب برطرف‌شده
.INDENT 0.0
.IP \(bu 2
مستندسازی یک مثبت کاذب شناخته‌شده برای \fBuseless\-suppression\fP هنگام غیرفعال‌سازی
\fBline\-too\-long\fP در ماژولی که فقط دارای کامنت بوده و کدی ندارد.
.sp
بستن #3368 (#3368 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3368>)
.IP \(bu 2
رفع مثبت کاذب \fBlogging\-fstring\-interpolation\fP که هنگام لاگ کردن با
f\-string حاوی قالب‌بندی \fB%s\fP رخ می‌داد.
.sp
بستن #4984 (#4984 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:4984>)
.IP \(bu 2
رفع مثبت کاذب \fBabstract\-method\fP در کلاس‌های Protocol.
.sp
بستن #7209 (#7209 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7209>)
.IP \(bu 2
رفع مثبت کاذب \fBmissing\-param\-doc\fP هنگامی که پارامتر تابع دارای یک
خط زیرین گریز داده‌شده (escaped underscore) باشد.
.sp
بستن #7827 (#7827 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7827>)
.IP \(bu 2
هشدار \fBmultiple\-statements\fP دیگر برای stubهای تابعی که از
\fB\&...\fP درون‌خطی استفاده می‌کنند فعال نمی‌شود.
.sp
بستن #7860 (#7860 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7860>)
.UNINDENT
.SS چه مواردی در Pylint 2.15.7 جدید است؟
.sp
تاریخ انتشار: 2022\-11\-27
.SS مثبت‌های کاذب برطرف‌شده
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب \fBdeprecated\-method\fP هنگامی که نام مستعار یک متد شبیه
به نام متد منسوخ‌شده است.
.sp
بستن #5886 (#5886 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5886>)
.IP \(bu 2
رفع یک مثبت کاذب برای \fBused\-before\-assignment\fP در مورد واردسازی‌های محافظت‌شده توسط
\fBtyping.TYPE_CHECKING\fP که بعداً در حاشیه‌نویسی متغیرها استفاده شده‌اند.
.sp
بستن #7609 (#7609 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7609>)
.UNINDENT
.SS سایر اشکالات برطرف‌شده
.INDENT 0.0
.IP \(bu 2
اکنون Pylint موارد تکراری ارائه‌شده به آن را پیش از انجام ارزیابی فیلتر می‌کند.
خروجی باید یکسان باشد، چه یک فایل چندین بار داده/شناسایی شده باشد چه نباشد.
.sp
بستن #6242, #4053 (#6242 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6242>)
.IP \(bu 2
رفع خرابی و توقف ناگهانی در \fBstop\-iteration\-return\fP هنگامی که تابع توکار
\fBnext\fP بدون آرگومان فراخوانی شود.
.sp
بستن #7828 (#7828 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7828>)
.UNINDENT
.SS چه مواردی در Pylint 2.15.6 جدید است؟
.sp
تاریخ انتشار: 2022\-11\-19
.SS مثبت‌های کاذب برطرف‌شده
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب برای \fBunhashable\-member\fP هنگام ایجاد زیرکلاس از \fBdict\fP
و استفاده از آن زیرکلاس به عنوان کلید دیکشنری.
.sp
بستن #7501 (#7501 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7501>)
.IP \(bu 2
اگر \fBenumerate\fP همراه با \fBstart\fP فراخوانی شود، هشدار
\fBunnecessary\-list\-index\-lookup\fP به اشتباه صادر نخواهد شد.
.sp
بستن #7682 (#7682 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7682>)
.IP \(bu 2
عدم نمایش هشدار درباره \fBstop\-iteration\-return\fP هنگام استفاده از \fBnext()\fP
روی \fBitertools.cycle\fP\&.
.sp
بستن #7765 (#7765 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7765>)
.UNINDENT.SS سایر رفع باگ‌ها
.INDENT 0.0
.IP \(bu 2
پیام‌های ارسال‌شده به گزارشگر اکنون رونوشت می‌شوند تا یک گزارشگر نتواند پیامی را که برای سایر گزارشگران ارسال شده تغییر دهد.
.sp
بسته شد #7214 (#7214 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7214>)
.IP \(bu 2
رفع حالت خاصی که در آن یک متد سفارشی با نام \fBnext\fP خطای astroid ایجاد می‌کرد.
.sp
بسته شد #7610 (#7610 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7610>)
.IP \(bu 2
رفع کرش رخ‌داده هنگام تجزیه فایل‌هایی با کدگذاری‌های غیرمنتظره که با \(aqutf\(aq شروع می‌شوند، مانند \fButf13\fP\&.
.sp
بسته شد #7661 (#7661 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7661>)
.IP \(bu 2
رفع کرش هنگامی که یک کلاس فرزند با متد \fB__init__\fP از یک کلاس والد دارای ویژگی کلاس \fB__init__\fP ارث‌بری می‌کند.
.sp
بسته شد #7742 (#7742 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7742>)
.UNINDENT
.SS تازه‌های Pylint 2.15.5
.sp
تاریخ انتشار: 2022\-10\-21
.SS رفع موارد مثبت کاذب
.INDENT 0.0
.IP \(bu 2
رفع یک مورد مثبت کاذب برای \fBsimplify\-boolean\-expression\fP هنگامی که چندین مقدار برای یک مقدار ثابت استنتاج می‌شود.
.sp
بسته شد #7626 (#7626 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7626>)
.UNINDENT
.SS سایر رفع باگ‌ها
.INDENT 0.0
.IP \(bu 2
حذف فراخوانی متد داندر \fB__index__\fP از بررسی \fBunnecessary\-dunder\-call\fP\&.
.sp
بسته شد #6795 (#6795 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6795>)
.IP \(bu 2
رفع کرش در چندپردازشی (multi\-processing) که مانع از استفاده از بیش از ۱ رشته (thread) در MacOS می‌شد.
.sp
اشیاء ماژول و خطاهای بازگردانده‌شده‌ای که توسط بارگذار افزونهٔ linter حافظه‌پنهان شده بودند، به طور قابل اعتمادی قابل pickle شدن نبودند. این بدان معناست که \fBdill\fP هنگام تلاش برای سریال‌سازی شیء linter جهت استفاده در چندپردازشی، خطا صادر می‌کرد.
.sp
بسته شد #7635. (#7635 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7635>)
.UNINDENT
.SS سایر تغییرات
.INDENT 0.0
.IP \(bu 2
افزودن آرگومان فقط‌کلیدواژه‌ای \fBcompare_constants\fP به \fBsafe_infer\fP\&.
.sp
ارجاع به #7626 (#7626 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7626>)
.IP \(bu 2
مرتب‌سازی خروجی \fB\-\-generated\-rcfile\fP\&.
.sp
ارجاع به #7655 (#7655 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7655>)
.UNINDENT
.SS تازه‌های Pylint 2.15.4
.sp
تاریخ انتشار: 2022\-10\-10
.SS رفع موارد مثبت کاذب
.INDENT 0.0
.IP \(bu 2
اصلاح پیام برای \fBunnecessary\-dunder\-call\fP در مورد \fB__aiter__\fP و \fB__anext__\fP\&. همچنین انتشار هشدار فقط زمانی انجام می‌شود که \fBpy\-version\fP >= 3.10 باشد.
.sp
بسته شد #7529 (#7529 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7529>)
.UNINDENT
.SS سایر رفع باگ‌ها
.INDENT 0.0
.IP \(bu 2
رفع باگ در تشخیص \fBunused\-variable\fP هنگام پیمایش روی متغیر.
.sp
بسته شد #3044 (#3044 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3044>)
.IP \(bu 2
رفع مدیریت \fB\-\-\fP به عنوان جداکننده میان آرگومان‌های مکانی و پرچم‌ها. این مشکل در عمل در 2.14.5 رفع نشده بود.
.sp
بسته شد #7003، ارجاع به #7096 (#7003 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7003>)
.IP \(bu 2
گزارش \fBno\-self\-argument\fP به جای \fBno\-method\-argument\fP برای متدهایی با آرگومان‌های متغیر (variadic).
.sp
بسته شد #7507 (#7507 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7507>)
.IP \(bu 2
رفع مشکلی که در آن \fBsyntax\-error\fP برای فایل‌هایی با کدگذاری نامعتبر صادر نمی‌شد.
.sp
بسته شد #7522 (#7522 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7522>)
.IP \(bu 2
رفع مثبت کاذب برای \fBredefined\-outer\-name\fP هنگام تعریف نام مستعار برای \fBtyping\fP (مثلاً به صورت \fBt\fP) و محافظت از وارد کردن‌ها تحت \fBt.TYPE_CHECKING\fP\&.
.sp
بسته شد #7524 (#7524 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7524>)
.IP \(bu 2
رفع کرش بازبین \fBmodified_iterating\fP هنگام پیمایش روی یک set تعریف‌شده به عنوان ویژگی کلاس.
.sp
بسته شد #7528 (#7528 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7528>)
.IP \(bu 2
رفع باگ در پویش نام‌های درون آرگومان‌های \fBtyping.Literal\fP\&. برای جزئیات به \%<https://\:peps\:.python\:.org/\:pep-0586/#\:literals-enums-and-forward-references> مراجعه کنید.
.sp
ارجاع به #3299 (#3299 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3299>)
.UNINDENT.SS سایر تغییرات
.INDENT 0.0
.IP \(bu 2
افزودن نام متد به پیام‌های خطای \fBno\-method\-argument\fP و
\fBno\-self\-argument\fP\&.
.sp
بسته شد: #7507 (#7507 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7507>)
.UNINDENT
.SS چه مواردی در Pylint 2.15.3 جدید است؟
.sp
تاریخ انتشار: 2022\-09\-19
.INDENT 0.0
.IP \(bu 2
رفع کرش در بررسی‌کننده \fBunhashable\-member\fP هنگام استفاده از \fBlambda\fP به‌عنوان کلید \fBdict\fP.
.sp
بسته شد: #7453 (#7453 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7453>)
.IP \(bu 2
رفع کرش در بررسی‌کننده \fBmodified\-iterating\-dict\fP در ارتباط با صفت‌های نمونه (instance attributes).
.sp
بسته شد: #7461 (#7461 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7461>)
.IP \(bu 2
بررسی‌کننده \fBinvalid\-class\-object\fP دیگر هنگامی که \fB__class__\fP در کنار متغیری دیگر انتساب داده می‌شود، دچار کرش نمی‌شود.
.sp
بسته شد: #7467 (#7467 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7467>)
.IP \(bu 2
رفع مثبت کاذب برای \fBglobal\-variable\-not\-assigned\fP هنگامی که یک متغیر سراسری از طریق یک گره \fBImportFrom\fP دوباره انتساب می‌یابد.
.sp
بسته شد: #4809 (#4809 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:4809>)
.IP \(bu 2
رفع مثبت کاذب برای \fBundefined\-loop\-variable\fP در حلقه‌های \fBfor\-else\fP که از تابعی با یادداشت نوع بازگشتی (return type annotation) \fBNoReturn\fP یا \fBNever\fP استفاده می‌کنند\&.
.sp
بسته شد: #7311 (#7311 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7311>)
.IP \(bu 2
گزینه \fB\-\-help\-msg\fP اکنون مجدداً فهرستی از شناسه‌های پیامِ جداشده با کاما را می‌پذیرد.
.sp
بسته شد: #7471 (#7471 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7471>)
.UNINDENT
.SS چه مواردی در Pylint 2.15.2 جدید است؟
.sp
تاریخ انتشار: 2022\-09\-07
.INDENT 0.0
.IP \(bu 2
رفع مشکلی که در آن افزونه‌های سفارشی مشخص‌شده از طریق خط فرمان ممکن بود بی‌صدا با شکست روبه‌رو شوند.
.sp
به‌طور مشخص، اگر یک افزونه برای وارد شدن (import) متکی به تغییر \fBsys.path\fP توسط گزینه \fBinit\-hook\fP باشد، اکنون یک پیام \fBbad\-plugin\-value\fP صادر خواهد شد. پیش از این تغییر، ثبت افزونه برای استفاده بی‌صدا با شکست مواجه می‌شد، اما هرگونه پیکربندی بارگیری می‌شد که می‌توانست اثرات ناخواسته‌ای داشته باشد.
.sp
رفع بخشی از #7264. (#7264 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7264>)
.IP \(bu 2
رفع هشدار \fBused\-before\-assignment\fP برای توابع/کلاس‌های تعریف‌شده در گارد بررسی نوع (type checking guard).
.sp
بسته شد: #7368 (#7368 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7368>)
.IP \(bu 2
به‌روزرسانی بررسی‌کننده \fBmodified_iterating\fP برای رفع کرش در حلقه‌های \fBfor\fP روی فهرست‌های خالی.
.sp
بسته شد: #7380 (#7380 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7380>)
.IP \(bu 2
افزونه \fBdocparams\fP اکنون اطلاعات نوع در docstringهای به سبک Numpy را به‌عنوان \(dqمستندسازی\(dq برای پیام \fBmissing\-param\-doc\fP در نظر می‌گیرد.
.sp
ارجاع به #7398 (#7398 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7398>)
.IP \(bu 2
رفع مثبت کاذب برای \fBunused\-variable\fP و \fBunused\-import\fP زمانی که یک نام تنها در یادداشت نوع رشته‌ای تحت‌اللفظی (string literal type annotation) به کار رفته است.
.sp
بسته شد: #3299 (#3299 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3299>)
.IP \(bu 2
رفع مثبت کاذب برای \fBtoo\-many\-function\-args\fP هنگامی که فراخوانی یک تابع به صفت کلاسی در درون کلاسی که تابع در آن تعریف شده، انتساب داده می‌شود.
.sp
بسته شد: #6592 (#6592 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6592>)
.IP \(bu 2
رفع مشکل تحلیل (lint) فایل‌های نادیده‌گرفته‌شده هنگامی که از طریق \fBstdin\fP ارسال می‌شوند.
.sp
بسته شد: #4354 (#4354 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:4354>)
.IP \(bu 2
پیام‌های \fBmissing\-return\-doc\fP، \fBmissing\-raises\-doc\fP و \fBmissing\-yields\-doc\fP اکنون از گزینه \fBno\-docstring\-rgx\fP پیروی می‌کنند.
.sp
بسته شد: #4743 (#4743 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:4743>)
.IP \(bu 2
عدم کرش در صورت مواجهه با \fBOSError\fP در فرایند کشف فایل پیکربندی.
.sp
بسته شد: #7169 (#7169 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7169>)
.IP \(bu 2
دستور \fBdisable\-next\fP اکنون به‌درستی تنها به سطر بعدی محدود شده است.
.sp
بسته شد: #7401 (#7401 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7401>)
.IP \(bu 2
به‌روزرسانی بررسی‌کننده \fBmodified_iterating\fP برای رفع کرش در حلقه‌های \fBfor\fP روی فهرست‌های خالی.
.sp
بسته شد: #7380 (#7380 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7380>)
.UNINDENT.SS چه مواردی در Pylint 2.15.1 جدید است؟
.sp
تاریخ انتشار: 2022\-09\-06
.sp
این یک \(dqانتشار فقط در GitHub\(dq است؛ این نسخه به اشتباه با عنوان \fB2.16.0\-dev\fP در pypi منتشر شد. با \fB2.15.2\fP جایگزین شد\&.
.SS چه مواردی در Pylint 2.15.0 جدید است؟
.SS بررسی‌های جدید (New Checks)
.INDENT 0.0
.IP \(bu 2
بررسی‌کننده جدید \fBmissing\-timeout\fP برای هشدار درباره مقادیر پیش‌فرض وقفه (timeout) که ممکن است باعث معلق ماندن نامحدود برنامه شوند، اضافه شد.
.sp
ارجاع: #6780 (#6780 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6780>)
.UNINDENT
.SS رفع مثبت‌های کاذب (False Positives Fixed)
.INDENT 0.0
.IP \(bu 2
عدم گزارش \fBsuper\-init\-not\-called\fP برای متدهای انتزاعی \fB__init__\fP\&.
.sp
بستن #3975 (#3975 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3975>)
.IP \(bu 2
عدم گزارش \fBunsupported\-binary\-operation\fP در Python <= 3.9 هنگام استفاده از عملگر \fB|\fP با انواع داده، در صورتی که یک متاکلاس متدهای \fB__or__\fP یا \fB__ror__\fP را به نحو مقتضی سربارگذاری کرده باشد.
.sp
بستن #4951 (#4951 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:4951>)
.IP \(bu 2
عدم گزارش \fBno\-value\-for\-parameter\fP برای فیلدهای dataclasses حاشیه‌نویسی‌شده با \fBKW_ONLY\fP\&.
.sp
بستن #5767 (#5767 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5767>)
.IP \(bu 2
اصلاح استنتاج \fBEnums\fP هنگامی که تحت یک نام مستعار (alias) وارد می‌شوند.
.sp
بستن #5776 (#5776 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5776>)
.IP \(bu 2
جلوگیری از مثبت‌های کاذب هنگام دسترسی به \fBPurePath.parents\fP از طریق اندیس (نه برش) در Python 3.10+.
.sp
بستن #5832 (#5832 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5832>)
.IP \(bu 2
بررسی \fBunnecessary\-list\-index\-lookup\fP اکنون برای اجتناب از مثبت‌های کاذب بالقوه، محافظه‌کارانه‌تر عمل می‌کند.
.sp
بستن #6896 (#6896 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6896>)
.IP \(bu 2
رفع صدور مضاعف \fBtrailing\-whitespace\fP برای رشته‌های مستندسازی (docstrings) چندخطی.
.sp
بستن #6936 (#6936 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6936>)
.IP \(bu 2
بررسی \fBimport\-error\fP اکنون به درستی حفاظ‌های \fBcontextlib.suppress\fP را روی دستورات import بررسی می‌کند.
.sp
بستن #7270 (#7270 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7270>)
.IP \(bu 2
رفع مثبت کاذب برای \fIno\-self\-argument\fP/\fIno\-method\-argument\fP هنگامی که یک staticmethod روی یک تابع اعمال شده اما از نام متفاوتی استفاده می‌کند.
.sp
بستن #7300 (#7300 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7300>)
.IP \(bu 2
رفع \fIundefined\-loop\-variable\fP با دستورات \fIbreak\fP و \fIcontinue\fP در بلوک‌های \fIelse\fP\&.
.sp
ارجاع: #7311 (#7311 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7311>)
.IP \(bu 2
بهبود عبارت باقاعده (regex) پیش‌فرض برای نام TypeVar. عدم مجاز بودن نام‌هایی با پیشوند \fBT\fP\&.
به عنوان مثال، استفاده از \fBAnyStrT\fP به جای \fBTAnyStr\fP\&.
.sp
ارجاع: #7322 (\fI#7322 <https://github.com/pylint\-dev/pylint/issues/7322>\(ga_\fP)
.UNINDENT
.SS رفع منفی‌های کاذب (False Negatives Fixed)
.INDENT 0.0
.IP \(bu 2
صدور \fBused\-before\-assignment\fP هنگام اتکا به نامی که بعداً در همان تابع دوباره وارد (reimport) شده است.
.sp
بستن #4624 (#4624 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:4624>)
.IP \(bu 2
صدور \fBused\-before\-assignment\fP برای عبارات نام‌گذاری‌شده خودارجاع (\fB:=\fP) فاقد انتساب قبلی.
.sp
بستن #5653 (#5653 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5653>)
.IP \(bu 2
صدور \fBused\-before\-assignment\fP برای انتساب‌های خودارجاع تحت شرایط if.
.sp
بستن #6643 (#6643 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6643>)
.IP \(bu 2
صدور \fBmodified\-iterating\-list\fP و پیام‌های مشابه برای dictها و setها هنگام پیمایش مقادیر لیتِرال (literals)، یا هنگام استفاده از کلمه کلیدی \fBdel\fP\&.
.sp
بستن #6648 (#6648 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6648>)
.IP \(bu 2
صدور \fBused\-before\-assignment\fP هنگام فراخوانی توابع تو در تو قبل از انتساب.
.sp
بستن #6812 (#6812 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6812>)
.IP \(bu 2
صدور \fBnonlocal\-without\-binding\fP هنگامی که یک نام nonlocal در نقطه‌ای بعدی در همان دامنه (scope) انتساب داده شده باشد.
.sp
بستن #6883 (#6883 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6883>)
.IP \(bu 2
صدور \fBusing\-constant\-test\fP هنگام آزمایش مقدار درستی (truth value) یک متغیر یا نتیجه فراخوانی حاوی یک ژنراتور (generator).
.sp
بستن #6909 (#6909 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6909>)
.IP \(bu 2
تغییر نام \fBunhashable\-dict\-key\fP به \fBunhashable\-member\fP و صدور آن هنگام ایجاد setها و dictها، نه فقط هنگام دسترسی به dictها.
.sp
بستن #7034، بستن #7055 (#7034 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7034>)
.UNINDENT.SS سایر رفع باگ‌ها (Other Bug Fixes)
.INDENT 0.0
.IP \(bu 2
رفع خطای بررسی کُد (lint) بسته‌های دارای \fB__init__.py\fP واقع در دایرکتوری‌های فاقد \fB__init__.py\fP\&.
.sp
بسته شد #1667 (#1667 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:1667>)
.IP \(bu 2
رفع فروپاشی مربوط به syntax\-error / E0001 \%<#\:syntax-error> که هنگام تعیین کدگذاری \fButf\-9\fP برای یک فایل به درستی مدیریت نمی‌شد\&.
.sp
بسته شد #3860 (#3860 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3860>)
.IP \(bu 2
رفع فروپاشی در بررسی \fBnot\-callable\fP در مواردی که پیرامون ارسال نادرست یک نمونه به \fB__new__()\fP ابهام وجود دارد\&.
.sp
بسته شد #7109 (#7109 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7109>)
.IP \(bu 2
رفع فروپاشی هنگام پرتاب استثنای \fIre.error\fP توسط گزینهٔ regex\&.
.sp
بسته شد #7202 (#7202 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7202>)
.IP \(bu 2
رفع خطای \fIundefined\-loop\-variable\fP از عملگر walrus در آزمون comprehension\&.
.sp
بسته شد #7222 (#7222 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7222>)
.IP \(bu 2
بررسی \fI<cwd>\fP پیش از حذف نخستین مورد از \fIsys.path\fP در \fImodify_sys_path\fP\&.
.sp
بسته شد #7231 (#7231 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7231>)
.IP \(bu 2
رفع آلودگی sys.path در حالت موازی\&.
.sp
بسته شد #7246 (#7246 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7246>)
.IP \(bu 2
جلوگیری از \fIuseless\-parent\-delegation\fP هنگام واگذاری به یک توکار (builtin) نوشته‌شده به زبان C (مانند \fIException.__init__\fP) با آرگومان‌های غیر self\&.
.sp
بسته شد #7319 (#7319 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7319>)
.UNINDENT
.SS سایر تغییرات (Other Changes)
.INDENT 0.0
.IP \(bu 2
نام \fBbad\-exception\-context\fP به \fBbad\-exception\-cause\fP تغییر یافت، زیرا این مورد به علت (cause) مربوط است نه به زمینه (context)\&.
.sp
بسته شد #3694 (#3694 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:3694>)
.IP \(bu 2
پیام مربوط به \fBliteral\-comparison\fP اکنون در مورد مشکل و راه‌حل آن صریح‌تر است\&.
.sp
بسته شد #5237 (#5237 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5237>)
.IP \(bu 2
نام \fBuseless\-super\-delegation\fP به منظور جامع‌تر بودن به \fBuseless\-parent\-delegation\fP تغییر یافت\&.
.sp
بسته شد #6953 (#6953 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6953>)
.IP \(bu 2
ابزار Pylint اکنون از \fBtowncrier\fP برای ایجاد گزارش تغییرات (changelog) استفاده می‌کند\&.
.sp
ارجاع #6974 (#6974 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6974>)
.IP \(bu 2
به‌روزرسانی \fBastroid\fP به نسخهٔ 2.12\&.
.sp
ارجاع #7153 (#7153 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7153>)
.IP \(bu 2
رفع فروپاشی هنگام اعلان یک \fI__slots__\fP با حاشیه‌نویسی نوع (type-annotated) و بدون مقدار\&.
.sp
بسته شد #7280 (#7280 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7280>)
.UNINDENT
.SS تغییرات داخلی (Internal Changes)
.INDENT 0.0
.IP \(bu 2
رفع مشکلی که در آن هنگام غیرقابل تجزیه بودن خروجی فعلی، به‌روزرسانی خروجی آزمون‌های کاربردی (functional tests) ناممکن بود. اکنون به‌جای اعلام خطا، یک پیام هشدار صادر شده و آزمون کاربردی با یک مقدار پیش‌فرض رد می‌شود\&.
.sp
ارجاع #6891 (#6891 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6891>)
.IP \(bu 2
اکنون \fBpylint.testutils.primer\fP یک API خصوصی است\&.
.sp
ارجاع #6905 (#6905 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6905>)
.IP \(bu 2
ما شیوهٔ مدیریت داخلی changelog را با استفاده از towncrier تغییر دادیم. اگر شما از مشارکت‌کنندگان هستید، دیگر نیازی به رفع تداخل‌های ادغام (merge conflicts) در changelog نخواهید داشت\&.
.sp
بسته شد #6974 (#6974 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:6974>)
.IP \(bu 2
ابزار Pylint اکنون از Scorecards برای پیاده‌سازی توصیه‌های امنیتی OpenSSF \%<https://\:openssf\:.org>\& استفاده می‌کند. این کار به منظور امن‌سازی زنجیرهٔ تأمین با ترکیبی از ابزارهای خودکار و بهترین شیوه‌ها (best practices) صورت گرفته است که بیشتر آن‌ها قبلاً نیز پیاده‌سازی شده بودند\&.
.sp
ارجاع #7267 (#7267 \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:7267>)
.UNINDENT.SS تازه‌های Pylint 2.14
.sp
از آغاز pylint تا نگارش 2.14.0 (شامل خود آن)، ما گزارش تغییراتی داشتیم که شامل \fIتمام\fP
تغییرات غیربدیهی Pylint بود؛ از جمله تغییراتی که
مربوط به کاربر نهایی نبودند، یعنی تغییراتی که تنها در صورتی ممکن بود برای شما جذاب باشند که توسعه‌دهنده‌ای
باشید که روی pylint یا افزونه‌های pylint کار می‌کند یا یک تاریخ‌نگار پروژه‌های متن‌باز.
.sp
از pylint 1.6.0 تا 2.14.0، علاوه بر گزارش تغییرات کامل، خلاصه‌ای
از تغییرات (عمدتاً مربوط به کاربران) نیز وجود داشت.
.SS خلاصه \-\- نکات برجستهٔ انتشار
.sp
با نگارش 2.14، ابزار \fBpylint\fP تنها از Python نسخهٔ 3.7.2 و بالاتر پشتیبانی می‌کند.
.sp
ما چندین بررسی جدید معرفی کردیم که از میان آن‌ها می‌توان به \fBduplicate\-value\fP برای مجموعه‌ها،
\fBcomparison\-of\-constants\fP و بررسی‌های مربوط به lambda اشاره کرد. ما \fBno\-init\fP را حذف کرده و
\fBno\-self\-use\fP را اختیاری کردیم زیرا بیش از حد سلیقه‌ای بودند. همچنین گزینه‌ای
برای تولید یک پیکربندی toml اضافه کردیم: \fB\-\-generate\-toml\-config\fP\&.
.sp
ما با سپاس از Daniël van Noord، از \fBoptparse\fP به \fBargparse\fP مهاجرت کرده و مدیریت پیکربندی
را بازآفرینی کردیم. در سمت کاربر، این امر باید خروجی دستور
\fB\-\-help\fP را تغییر دهد و برخی ناهماهنگی‌ها و باگ‌ها ناپدید شوند. رفتار میان
گزینه‌های تنظیم‌شده در یک فایل پیکربندی در مقایسه با خط فرمان سازگارتر خواهد بود. برای ما نیز،
این کار نگهداری این بخش از کد را در آینده آسان‌تر می‌سازد.
.sp
در نتیجهٔ این بازآفرینی، موارد منسوخ‌شدهٔ داخلی زیادی وجود دارد. اگر نگه‌دارندهٔ کتابخانه‌ای
هستید که به pylint وابسته است، لطفاً با فعال‌سازی هشدارهای منسوخ‌شدگی
بررسی کنید که برای pylint 3.0 آماده‌اید یا خیر.
.sp
ما به یکپارچه‌سازی \fBpylint\-error\fP ادامه دادیم و اکنون به ۳۳٪ رسیده‌ایم! ما همچنان از هرگونه مشارکت جامعه
برای کمک به بازبینی، ادغام و افزودن نمونه‌های خوب/بد <\%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5953>>\(ga_ استقبال می‌کنیم. این کار باید بدون نیاز
به هیچ دانشی از \fBpylint\fP یا \fBastroid\fP قابل انجام باشد، بنابراین اگر می‌خواهید
بدون تجربهٔ قبلی با کد ما، در \fBpylint\fP یا پروژه‌های متن‌باز مشارکت کنید، این یک نقطهٔ ورود عالی است!
.SS بررسی‌کننده‌های جدید
.INDENT 0.0
.IP \(bu 2
بررسی‌کنندهٔ جدید \fBcomparison\-of\-constants\fP اضافه شد.
.sp
بسته شدن #6076
.IP \(bu 2
بررسی‌کنندهٔ جدید \fBtypevar\-name\-mismatch\fP اضافه شد: TypeVar باید به متغیری با همان نام آرگومان name خود تخصیص یابد.
.sp
بسته شدن #5224
.IP \(bu 2
\fBinvalid\-enum\-extension\fP: زمانی استفاده می‌شود که یک کلاس تلاش کند یک کلاس به ارث‌برده‌شده از Enum را گسترش دهد.
.sp
بسته شدن #5501
.IP \(bu 2
بررسی‌کنندهٔ جدید \fBtypevar\-double\-variance\fP اضافه شد: آرگومان‌های کلیدی \(dqcovariant\(dq و \(dqcontravariant\(dq
نمی‌توانند در یک TypeVar هم‌زمان روی \(dqTrue\(dq تنظیم شوند.
.sp
بسته شدن #5895
.IP \(bu 2
بررسی جدید \fBunnecessary\-dunder\-call\fP برای فراخوانی‌های غیرضروری متدهای dunder اضافه شد.
.sp
بسته شدن #5936
.IP \(bu 2
\fBunnecessary\-lambda\-assignment\fP: عبارت lambda به یک متغیر تخصیص یافته است.
به‌جای آن با استفاده از کلمه کلیدی \(dqdef\(dq یک تابع تعریف کنید.
\fBunnecessary\-direct\-lambda\-call\fP: عبارت lambda به‌طور مستقیم فراخوانی شده است.
به‌جای آن عبارت را به‌صورت درون‌خطی اجرا کنید.
.sp
بسته شدن #5976
.IP \(bu 2
\fBpotential\-index\-error\fP: زمانی صادر می‌شود که اندیس یک لیست یا تاپل از طول آن بیشتر شود.
این بررسی‌کننده در حال حاضر بسیار محافظه‌کارانه عمل می‌کند تا از موارد مثبت کاذب جلوگیری شود. ما از
پیشنهادها برای بهبود استقبال می‌کنیم.
.sp
بسته شدن #578
.IP \(bu 2
بررسی‌کنندهٔ جدید \fBunnecessary\-list\-index\-lookup\fP برای اندیس‌گذاری در یک لیست هنگام
پیمایش روی \fBenumerate()\fP اضافه شد.
.sp
بسته شدن #4525
.IP \(bu 2
پیام جدیدی با نام \fBduplicate\-value\fP اضافه شد که مقادیر تکراری درون مجموعه‌ها را شناسایی می‌کند.
.sp
بسته شدن #5880
.IP \(bu 2
بررسی‌کنندهٔ \fBsuper\-without\-brackets\fP اضافه شد، زمانی صادر می‌شود که یک فراخوانی super فاقد براکت‌های خود باشد.
.sp
بسته شدن #4008
.UNINDENT.SS بررسی‌کننده‌های حذف‌شده (Removed checkers)
.INDENT 0.0
.IP \(bu 2
هشدار \fBno\-init\fP (W0232) حذف شده است. نداشتن \fB__init__\fP در یک کلاس اشکالی ندارد.
.sp
بستن #2409
.IP \(bu 2
پیام \fBassign\-to\-new\-keyword\fP حذف شد زیرا دیگر هیچ کلیدواژهٔ جدیدی در نسخه‌های
پشتیبانی‌شدهٔ Python وجود ندارد.
.sp
بستن #4683
.IP \(bu 2
بررسی \fBno\-self\-use\fP به یک افزونهٔ اختیاری منتقل شد.
اکنون باید این بررسی را صریحاً با استفاده از
\fBload\-plugins=pylint.extensions.no_self_use\fP\& فعال کنید.
.sp
بستن #5502
.UNINDENT
.SS افزونه‌ها (Extensions)
.INDENT 0.0
.IP \(bu 2
\fBRedefinedLoopNameChecker\fP
.INDENT 2.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
افزودن افزونهٔ اختیاری \fBredefined\-loop\-name\fP برای صدور پیام هنگام بازتعریف یک متغیر
در بدنهٔ حلقه.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
بستن #5072
.UNINDENT
.UNINDENT
.IP \(bu 2
\fBDocStringStyleChecker\fP
.INDENT 2.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
فعال‌سازی مجدد بررسی‌کنندهٔ \fBbad\-docstring\-quotes\fP برای Python <= 3.7.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
بستن #6087
.UNINDENT
.UNINDENT
.IP \(bu 2
\fBNoSelfUseChecker\fP
.INDENT 2.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
افزودن بررسی \fBno\-self\-use\fP که پیش‌تر به‌طور پیش‌فرض فعال بود.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
بستن #5502
.UNINDENT
.UNINDENT
.UNINDENT
.SS تغییرات دیگر (Other Changes)
.INDENT 0.0
.IP \(bu 2
نادیده گرفتن خط زیرین (_) به عنوان یک متغیر محلی برای \fBtoo\-many\-locals\fP آغاز شد.
.sp
بستن #6488
.IP \(bu 2
اکنون \fBPylint\fP می‌تواند با یک نیازمندی اضافی (extra\-require) به نام \fBspelling\fP نصب شود (\fBpip install pylint[spelling]\fP).
این کار \fBpyenchant\fP را به وابستگی‌های pylint اضافه می‌کند. شما همچنان باید نیازمندی‌های
\fBpyenchant\fP (کتابخانهٔ \fBenchant\fP و هرگونه لغت‌نامه) را خودتان نصب کنید. همچنین باید
گزینهٔ \fBspelling\-dict\fP را تنظیم نمایید.
.sp
ارجاع به #6462
.IP \(bu 2
بهبود نگارش متن پیام \fBdeprecated\-module\fP
.sp
بستن #6169
.IP \(bu 2
برای اجرای \fBPylint\fP اکنون به Python 3.7.2 یا جدیدتر نیاز است.
.sp
بستن #4301
.IP \(bu 2
تلاش بیشتری صورت گرفت تا خطاهای ناشی از کتابخانهٔ \fBastroid\fP
مجدداً به صورت \fBAstroidError\fP ایجاد شوند (reraise)، با این اثر که pylint به جای
صرفاً \fBfatal\fP، پیام \fBastroid\-error\fP را صادر می‌کند. صرف‌نظر از این، لطفاً هرگونه مشکلی از این دست را که با آن مواجه می‌شوید گزارش دهید!
.IP \(bu 2
ما تشخیص کامنت‌های درون‌خطی غیرفعال‌سازی (disable) و فعال‌سازی (enable) را بهبود داده‌ایم. اکنون
غیرفعال‌سازی درون‌خطی \fBbad\-option\-value\fP ممکن است (تا زمانی که قبل از
ایجاد مقدار نامعتبر گزینه غیرفعال شود، یعنی \fBdisable=bad\-option\-value,bad\-message\fP نه \fBdisable=bad\-message,bad\-option\-value\fP ) و همچنین برخی پیام‌های دیگر که
پیش‌تر پشتیبانی نمی‌شدند.
.sp
بستن #3312
.IP \(bu 2
نام بررسی‌کنندهٔ اصلی اکنون به جای \fBmaster\fP برابر با \fBmain\fP است. از آنجا که نام بخش‌ها اختیاری است، نیازی به به‌روزرسانی پیکربندی نیست.
.sp
بستن #5467
.IP \(bu 2
به‌روزرسانی پیام \fBinvalid\-slots\-object\fP برای نمایش شیء نامعتبر به جای مقدار استنتاج‌شدهٔ آن.
.sp
بستن #6101
.IP \(bu 2
رفع یک فروپاشی (crash) در بررسی‌کنندهٔ \fBnot\-an\-iterable\fP مربوط به چند عبارت ستاره‌دار
درون یک فراخوانی.
.sp
بستن #6372
.IP \(bu 2
رفع یک فروپاشی در بررسی‌کنندهٔ \fBunused\-private\-member\fP مربوط به صفت‌های خصوصی زنجیره‌ای.
.sp
بستن #6709
.IP \(bu 2
غیرفعال‌سازی غلط‌یابی املایی نام قوانین mypy در دستورالعمل‌های نادیده‌گیری (ignore).
.sp
بستن #5929
.IP \(bu 2
پیام \fBimplicit\-str\-concat\fP اکنون در فراخوانی‌هایی مانند \fBopen(\(dqmyfile.txt\(dq \(dqa+b\(dq)\fP نیز صادر خواهد شد.
.sp
بستن #6441
.IP \(bu 2
رفع عدم رعایت غیرفعال‌سازی‌های درون‌خطی برای \fBfixme\fP که در آخرین سطر
یک ماژول رخ می‌داد هنگامی که pylint با \fB\-\-enable=fixme\fP اجرا می‌شد.
.IP \(bu 2
حذف گزینهٔ معیوب \fBgenerate\-man\fP\&.
.sp
بستن #5283
بستن #1887
.IP \(bu 2
رفع مشکل در فعال‌سازی \fBdeprecated\-module\fP پس از یک \fBdisable=all\fP
با قرار دادن \fBImportsChecker\fP به عنوان تنها مسئول صدور \fBdeprecated\-module\fP به جای
تقسیم مسئولیت با \fBStdlibChecker\fP\&. (این امر می‌توانست منجر به پیام‌های تکراری شود.)
.IP \(bu 2
افزودن گزینهٔ \fBgenerate\-toml\-config\fP\&.
.sp
ارجاع به #5462
.IP \(bu 2
پیام \fBbad\-option\-value\fP زمانی صادر خواهد شد که یک مقدار پیکربندی یا فراخوانی خط فرمان
شامل یک پیام ناشناخته باشد.
.sp
بستن #4324
.IP \(bu 2
افزودن پیام \fBunrecognized\-option\fP؛ در صورت مواجهه با هرگونه گزینهٔ ناشناخته صادر می‌شود.
.sp
بستن #5259
.IP \(bu 2
رفع منفی کاذب (false negative) برای \fBbad\-string\-format\-type\fP در صورتی که مقدار قالب‌بندی شونده
به عنوان متغیری حاوی یک مقدار ثابت ارسال شود.
.IP \(bu 2
مفهوم اولویت بررسی‌کننده (checker priority) حذف شده است.
.IP \(bu 2
نام بررسی‌کنندهٔ \fBcache\-max\-size\-none\fP به \fBmethod\-cache\-max\-size\-none\fP تغییر یافت.
.sp
بستن #5670
.IP \(bu 2
بررسی‌کنندهٔ \fBmethod\-cache\-max\-size\-none\fP اکنون \fBfunctools.cache\fP را نیز بررسی خواهد کرد.
.sp
بستن #5670
.IP \(bu 2
کلاس‌های \fBBaseChecker\fP اکنون نیازمند ارسال آرگومان \fBlinter\fP هستند.
.IP \(bu 2
دکوراتور \fBset_config_directly\fP حذف شده است.
.IP \(bu 2
عدم گزارش \fBuseless\-super\-delegation\fP برای متد \fB__hash__\fP در کلاس‌هایی که همچنین متد \fB__eq__\fP را بازنویسی (override) می‌کنند.
.sp
بستن #3934
.IP \(bu 2
رفع صدور نادرست \fBuseless\-suppression\fP در بررسی‌کنندهٔ \fBwrong\-import\-position\fP\&.
.sp
بستن #5219
.IP \(bu 2
رفع مثبت کاذب (false positive) برای \fBno\-member\fP در Enums با اعضای تعریف‌شده توسط خود کلاس.
.sp
بستن #5138.IP \(bu 2
رفع منفی کاذب (false negative) برای \fBno\-member\fP هنگام تلاش برای انتساب یک صفت نمونه به خودش بدون هرگونه انتساب قبلی.
.sp
بسته شدن #1555
.IP \(bu 2
تغییر نوع پیام از \fBredefined\-outer\-name\fP به \fBredefined\-loop\-name\fP (افزونهٔ اختیاری) برای تعریف‌های مجدد متغیرهای حلقهٔ بیرونی توسط حلقه‌های درونی.
.sp
بسته شدن #5608
.IP \(bu 2
اکنون بررسی‌کنندهٔ تشابه به‌طور پیش‌فرض واردکردن‌ها (imports) و امضای توابع را هنگام محاسبهٔ تکرار نادیده می‌گیرد. اگر می‌خواهید رفتار پیشین را حفظ کنید، \fBignore\-imports\fP و \fBignore\-signatures\fP را روی \fBFalse\fP تنظیم کنید\&.
.IP \(bu 2
اکنون Pylint مسیر کاربر (یعنی تبدیل \fB~\fP به \fBhome/yusef/\fP) و متغیرهای محیطی (یعنی تبدیل \fBhome/$USER/$project\fP به \fBhome/yusef/pylint\fP برای \fBUSER=yusef\fP و \fBproject=pylint\fP) را برای گزینه‌های \fBoutput\-directory\fP، \fBimport\-graph\fP، \fBext\-import\-graph\fP و \fBint\-import\-graph\fP از pyreverse و همچنین گزینهٔ \fBspelling\-private\-dict\-file\fP از غلط‌یاب املایی بسط می‌دهد.
.sp
ارجاع به #6493
.IP \(bu 2
عدم صدور \fBunsubscriptable\-object\fP برای حاشیه‌نویسی‌های رشته‌ای.
Pylint بررسی نمی‌کند که آیا کلاس فقط در type stubها به‌صورت generic تعریف شده است یا خیر.
.sp
بسته شدن #4369 و #6523
.IP \(bu 2
رفع خطای خرابی pyreverse با پیام \fBRuntimeError: dictionary changed size during iteration\fP
.sp
ارجاع به #6612
.IP \(bu 2
رفع نحو حاشیه‌نویسی‌های نوع بازگشتی در نمودارهای MermaidJS تولیدشده با \fBpyreverse\fP\&.
.sp
بسته شدن #6467
.IP \(bu 2
رفع حاشیه‌نویسی‌های نوع برای صفت‌های کلاس و نمونه با استفاده از نحو جایگزین union در نمودارهای \fBpyreverse\fP\&.
.IP \(bu 2
رفع اشکالی که در آن پیام خطای متنی ساده در stdout نوشته شده و باعث نامعتبر شدن قالب‌های خروجی می‌شد.
.sp
بسته شدن #6597
.IP \(bu 2
بررسی‌کنندهٔ بازآفرینی کد اکنون برای \fBmax()\fP، \fBmin()\fP و \fBsum()\fP نیز پیام‌های \(aqconsider\-using\-a\-generator\(aq را صادر می‌کند\&.
.sp
ارجاع به #6595
.IP \(bu 2
به‌روزرسانی محدوده‌ها برای پیام‌های خطای \fBusing\-constant\-test\fP و \fBmissing\-parentheses\-for\-call\-in\-test\fP\&.
.IP \(bu 2
عدم صدور \fBno\-member\fP در درون حاشیه‌نویسی‌های نوع همراه با \fBfrom __future__ import annotations\fP\&.
.sp
بسته شدن #6594
.IP \(bu 2
رفع مثبت کاذب (false positive) برای \fBunexpected\-special\-method\-signature\fP در متدهای \fB__init_subclass__\fP دارای یک یا چند آرگومان.
.sp
بسته شدن #6644
.UNINDENT
.SS "موارد منسوخ‌شده (Deprecations)"
.INDENT 0.0
.IP \(bu 2
گزینهٔ \fBignore\-mixin\-members\fP منسوخ شده است. اکنون باید از گزینهٔ جدید \fBignored\-checks\-for\-mixins\fP استفاده کنید.
.sp
بسته شدن #5205
.IP \(bu 2
قابلیت \fBinterfaces.implements\fP منسوخ شده است و در نسخهٔ 3.0 حذف خواهد شد. لطفاً به جای \fB__implements__\fP از الگوهای استاندارد وراثت استفاده کنید\&.
.sp
ارجاع به #2287
.IP \(bu 2
تمام کلاس‌های \fBInterface\fP در \fBpylint.interfaces\fP منسوخ شده‌اند. می‌توانید از کلاس‌های عادی متناظر مشتق‌گیری کنید تا همان رفتار را به دست آورید. قابلیت \fB__implements__\fP بر اساس یک PEP ردشده از سال ۲۰۰۱ بود:
\%<https://\:peps\:.python\:.org/\:pep-0245>
.sp
بسته شدن #2287
.IP \(bu 2
کلاس \fBMapReduceMixin\fP منسوخ شده است. اکنون \fBBaseChecker\fP متدهای \fBget_map_data\fP و \fBreduce_map_data\fP را پیاده‌سازی می‌کند\&. اگر یک بررسی‌کننده واقعاً نیاز به کاهش دادن (reduce) داده‌ها دارد، باید \fBget_map_data\fP را به‌گونه‌ای تعریف کند که مقداری غیر از \fBNone\fP برگرداند و مدیریت فهرستی از انواع بازگردانده‌شده توسط \fBget_map_data\fP را به \fBreduce_map_data\fP خود بسپارد\&.
نمونه‌ای از این مورد را می‌توان با بررسی \fBpylint/checkers/similar.py\fP مشاهده کرد\&.
.IP \(bu 2
صفت \fBconfig\fP در \fBBaseChecker\fP منسوخ شده است. می‌توانید به جای شیء مختص به بررسی‌کننده، از \fBchecker.linter.config\fP برای دسترسی به شیء پیکربندی سراسری استفاده کنید.
.sp
ارجاع به #5392
.IP \(bu 2
صفت \fBlevel\fP در \fBBaseChecker\fP منسوخ شده است: اکنون همه‌چیز همواره در \fB\-\-help\fP نمایش داده می‌شود.
.sp
ارجاع به #5392
.IP \(bu 2
متد \fBset_option\fP در \fBBaseChecker\fP منسوخ شده است. می‌توانید به جای شیء مختص به بررسی‌کننده، از \fBchecker.linter.set_option\fP برای تنظیم یک گزینه بر روی شیء پیکربندی سراسری استفاده کنید.
.sp
ارجاع به #5392
.IP \(bu 2
صفت \fBoptions_providers\fP در \fBArgumentsManager\fP منسوخ شده است.
.sp
ارجاع به #5392
.IP \(bu 2
رفع ذخیره‌سازی فایل‌های دادهٔ دائمی (persistent) در محیط‌هایی که پوشهٔ حافظهٔ نهان (cache) کاربر و فایل بررسی‌شده در درایوهای متفاوتی قرار دارند.
.sp
بسته شدن #6394
.IP \(bu 2
بررسی‌کنندهٔ \fBmethod\-cache\-max\-size\-none\fP اکنون \fBfunctools.cache\fP را نیز بررسی خواهد کرد\&.
.IP \(bu 2
صفت \fBconfig\fP در \fBPyLinter\fP اکنون به جای \fBoptparse.Values\fP از نوع \fBargparse.Namespace\fP است\&.
.sp
ارجاع به #5392
.IP \(bu 2
کلاس \fBUnsupportedAction\fP منسوخ شده است.
.sp
ارجاع به #5392
.IP \(bu 2
کلاس \fBOptionsManagerMixIn\fP منسوخ شده است.
.sp
ارجاع به #5392
.IP \(bu 2
کلاس \fBOptionParser\fP منسوخ شده است.
.sp
ارجاع به #5392
.IP \(bu 2
کلاس \fBOption\fP منسوخ شده است.
.sp
ارجاع به #5392
.IP \(bu 2
کلاس \fBOptionsProviderMixIn\fP منسوخ شده است.
.sp
ارجاع به #5392
.IP \(bu 2
کلاس \fBConfigurationMixIn\fP منسوخ شده است.
.IP \(bu 2
صفت \fBoption_groups\fP در \fBPyLinter\fP منسوخ شده است.
.sp
ارجاع به #5392
.IP \(bu 2
متد \fBget_global_config\fP منسوخ شده است. اکنون می‌توانید از \fBchecker.linter.config\fP به تمام گزینه‌های سراسری دسترسی داشته باشید\&.
.sp
ارجاع به #5392
.IP \(bu 2
کلاس \fBArgumentsManager\fP جایگزین \fBOptionsManagerMixIn\fP شده است\&. \fBArgumentsManager\fP یک API خصوصی در نظر گرفته می‌شود و بیشتر متدهایی که در \fBOptionsManagerMixIn\fP عمومی بودند اکنون منسوخ شده‌اند و در نسخه‌های آینده حذف خواهند شد.
.sp
ارجاع به #5392
.IP \(bu 2
کلاس \fBArgumentsProvider\fP جایگزین \fBOptionsProviderMixIn\fP شده است\&. \fBArgumentsProvider\fP یک API خصوصی در نظر گرفته می‌شود و بیشتر متدهایی که در \fBOptionsProviderMixIn\fP عمومی بودند اکنون منسوخ شده‌اند و در نسخه‌های آینده حذف خواهند شد.
.sp
ارجاع به #5392
.IP \(bu 2
کلاس \fBpylint.pyreverse.ASTWalker\fP حذف شده است، چرا که تنها به‌صورت درونی توسط یک کلاس فرزند منفرد مورد استفاده قرار می‌گرفت.
.sp
ارجاع به #6712
.IP \(bu 2
در \fBpyreverse\fP: حل و نمایش رابط‌های پیاده‌سازی‌شده که با صفت \fB__implements__\fP تعریف می‌شوند منسوخ شده است و در نسخهٔ 3.0 حذف خواهد شد.
.sp
ارجاع به #6713
.IP \(bu 2
تابع \fBis_class_subscriptable_pep585_with_postponed_evaluation_enabled\fP منسوخ شده است.
به جای آن از \fBis_postponed_evaluation_enabled(node) and is_node_in_type_annotation_context(node)\fP
استفاده کنید.
.sp
ارجاع به #6536
.UNINDENT.SS تغییرات کامل (Full changelog)
.SS تازه‌های Pylint 2.14.5
.sp
تاریخ انتشار: 2022\-07\-17
.INDENT 0.0
.IP \(bu 2
رفع خرابی در بررسی \fBundefined\-loop\-variable\fP هنگامی که از \fBenumerate()\fP در یک عبارت سه‌تایی استفاده می‌شود.
.sp
بستن #7131
.IP \(bu 2
رفع مشکل کار با \fB\-\-\fP به عنوان جداکننده میان آرگومان‌های مکانی و پرچم‌ها.
.sp
بستن #7003
.IP \(bu 2
رفع مشکل غیرفعال‌سازی \fBfixme\fP و تعامل آن با \fBuseless\-suppression\fP\&.
.IP \(bu 2
مجاز شدن فهرست‌هایی از مقادیر پیش‌فرض در مستندسازی پارامترها برای سبک \fBNumpy\fP\&.
.sp
بستن #4035
.UNINDENT
.SS تازه‌های Pylint 2.14.4
.sp
تاریخ انتشار: 2022\-06\-29
.INDENT 0.0
.IP \(bu 2
بررسی \fBdiffering\-param\-doc\fP توسط آرگومان‌های فقط-مکانی فعال می‌شد.
.sp
بستن #6950
.IP \(bu 2
رفع مشکلی که در آن پویش بازگشتی دایرکتوری \fI\&.\fP با \fB\-\-ignore\-path=^path/to/dir\fP دایرکتوری \fIpath/to/dir\fP را نادیده نمی‌گرفت.
.sp
بستن #6964
.IP \(bu 2
رفع پس‌رفتی که اجازه نقل‌قول شدن \fBinit\-hooks\fP در فایل‌های گزینه‌ها را نمی‌داد.
.sp
بستن #7006
.IP \(bu 2
رفع مثبت کاذب در \fBmodified\-iterating\-dict\fP هنگام به‌روزرسانی یک کلید موجود.
.sp
بستن #6179
.IP \(bu 2
رفع مشکلی که در آن ماشین‌های چند-هسته‌ای ویندوز (بیش از حدود ۶۰ پردازنده منطقی) هنگام استفاده از تعداد پیش‌فرض کارها دچار توقف (hang) می‌شدند.
.sp
بستن #6965
.IP \(bu 2
رفع مشکلی در شناسایی فایل‌های \fBsetup.cfg\fP\&.
تنها فایل‌های \fB\&.cfg\fP که دقیقاً \fBsetup.cfg\fP نام دارند نیاز به نام بخش‌هایی دارند که با \fBpylint.\fP آغاز می‌شوند.
.sp
بستن #3630
.IP \(bu 2
عدم گزارش \fBimport\-private\-name\fP برای واردسازی‌های نسبی.
.sp
بستن #7078
.UNINDENT
.SS تازه‌های Pylint 2.14.3
.sp
تاریخ انتشار: 2022\-06\-18
.INDENT 0.0
.IP \(bu 2
رفع دو مورد مثبت کاذب در \fBbad\-super\-call\fP برای فراخوانی‌هایی که به یک والد غیرمستقیم ارجاع می‌دهند.
.sp
بستن #4922، بستن #2903
.IP \(bu 2
رفع مثبت کاذب در \fBuseless\-super\-delegation\fP برای زیرکلاس‌هایی که تعداد پارامترها را در برابر والدی که از آرگومان متغیر (variadic) استفاده می‌کند مشخص می‌کنند.
.sp
بستن #2270
.IP \(bu 2
امکان نادیده‌گیری \fBundefined\-loop\-variable\fP و \fBundefined\-variable\fP بدون برانگیختن \fBuseless\-suppression\fP\&.
.IP \(bu 2
رفع مثبت کاذب در \fBundefined\-variable\fP برای \fB__class__\fP در متدهای درونی.
.sp
بستن #4032
.UNINDENT
.SS تازه‌های Pylint 2.14.2
.sp
تاریخ انتشار: 2022\-06\-15
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب در \fBunused\-variable\fP هنگامی که یک تابع شیئی از نوع \fBargparse.Namespace\fP را برمی‌گرداند.
.sp
بستن #6895
.IP \(bu 2
جلوگیری از صدور پیام یکسان \fBundefined\-loop\-variable\fP دو بار در همان خط.
.IP \(bu 2
عدم بروز خرابی اگر \fBlint.run._query_cpu()\fP درون یک Kubernetes Pod اجرا شود که تنها کسری از یک هسته CPU به آن اختصاص یافته است؛ در این حالت با یک فرایند اجرا خواهد شد.
.sp
بستن #6902
.IP \(bu 2
رفع مثبت کاذب در \fBconsider\-using\-f\-string\fP اگر سمت چپ \fB%\fP یک رشته نباشد.
.sp
بستن #6689
.IP \(bu 2
رفع مثبت کاذب در \fBunnecessary\-list\-index\-lookup\fP و \fBunnecessary\-dict\-index\-lookup\fP هنگامی که اندیس (subscript) در بدنه یک حلقه تو در تو به‌روزرسانی می‌شود.
.sp
بستن #6818
.IP \(bu 2
رفع مشکلی در گزینه‌های چندخطی \fBinit\-hook\fP که پایان خط‌ها را ثبت نمی‌کردند.
.sp
بستن #6888
.IP \(bu 2
رفع مثبت کاذب در \fBused\-before\-assignment\fP هنگامی که یک بلوک try مقداری را بازمی‌گرداند اما کنترل‌کننده except نامی را از طریق حاشیه‌نویسی نوع (type annotation) تعریف می‌کند.
.IP \(bu 2
گزینه \fB\-\-errors\-only\fP دیگر پیام‌هایی را که قبلاً غیرفعال شده بودند فعال نمی‌کند. این گزینه بدون این‌که به‌طور شفاف مستند شده باشد مانند \(dqارسال \fIتمام\fP و تنها پیام‌های خطا\(dq عمل می‌کرد.
.sp
بستن #6811
.UNINDENT.SS تازه‌های Pylint 2.14.1
.sp
تاریخ انتشار: 2022\-06\-06
.INDENT 0.0
.IP \(bu 2
جلوگیری از گزارش \fBunnecessary\-dict\-index\-lookup\fP یا \fBunnecessary\-list\-index\-lookup\fP
هنگامی که جستجوی اندیس، بخشی از یک انتساب ساختارشکنی (destructuring assignment) باشد.
.sp
بسته شد: #6788
.IP \(bu 2
رفع مشکل تجزیهٔ گزینه‌های نامرتبط در \fBtox.ini\fP\&.
.sp
بسته شد: #6800
.IP \(bu 2
رفع کرش هنگام ارزیابی متدهای \fB__new__()\fP که یک عبارت فراخوانی بازمی‌گردانند.
.sp
بسته شد: #6805
.IP \(bu 2
جلوگیری از کرش در صورتی که دایرکتوری خانگی کاربر پیدا نشود.
.sp
بسته شد: #6802
.IP \(bu 2
رفع موارد مثبت کاذب برای \fBunused\-import\fP هنگام ایجاد نام مستعار برای \fBtyping\fP (برای نمونه به صورت \fBt\fP)
و محافظت از وارد کردن‌ها ذیل \fBt.TYPE_CHECKING\fP\&.
.sp
بسته شد: #3846
.IP \(bu 2
رفع یک پس‌رفت مثبت کاذب مربوط به نگارش 2.13 برای \fBused\-before\-assignment\fP در حالتی که تکیه بر نام
تعریف‌شده فقط در یک بلوک \fBexcept\fP ایمن است، زیرا بلوک \fBelse\fP مقدار بازگردانده است.
.sp
بسته شد: #6790
.IP \(bu 2
رفع مشکل استفاده از اختصارات برای برخی از گزینه‌های ویژه در خط فرمان.
.sp
بسته شد: #6810
.IP \(bu 2
رفع کرش در افزونهٔ اختیاری \fBpylint.extensions.private_import\fP\&.
.sp
بسته شد: #6624
.IP \(bu 2
پیام \fBbad\-option\-value\fP (E0012) اکنون به عنوان هشدار \fBunknown\-option\-value\fP (W0012) صادر می‌شود. پیام‌های حذف‌شده‌ای که دیگر
در pylint وجود ندارند، اکنون به جای \fBbad\-option\-value\fP باعث صدور \fBuseless\-option\-value\fP (R0022) می‌شوند. این امر تفکیک
بین اشتباهات تایپی واقعی و پیکربندی‌های قابل پاک‌سازی را ممکن می‌سازد. دستورات غیرفعال‌سازی پیشین برای
\fBbad\-option\-value\fP همچنان برای هر دو پیام جدید کار خواهند کرد.
.sp
ارجاع: #6794
.UNINDENT
.SS تازه‌های Pylint 2.14.0
.sp
تاریخ انتشار: 2022\-06\-01
.INDENT 0.0
.IP \(bu 2
بررسی‌کنندهٔ بازآفرینی کد (refactoring checker) اکنون پیام‌های consider\-using\-generator / R1728 \%<#\:consider-using-generator>\(aq را برای
\fBmax()\fP، \fBmin()\fP و \fBsum()\fP نیز صادر می‌کند.
.sp
ارجاع: #6595
.IP \(bu 2
تشخیص کامنت‌های درون‌خطی غیرفعال‌سازی و فعال‌سازی بهبود یافته است. اکنون
غیرفعال کردن درون‌خطی \fBbad\-option\-value\fP (به شرط آنکه پیش از ایجاد مقدار نادرستِ گزینه غیرفعال شود،
یعنی \fBdisable=bad\-option\-value,bad\-message\fP نه \fBdisable=bad\-message,bad\-option\-value\fP) و همچنین برخی پیام‌های دیگر که پیش‌تر پشتیبانی نمی‌شدند ممکن شده است.
.sp
بسته شد: #3312
.IP \(bu 2
رفع کرش در بررسی‌کنندهٔ \fBunused\-private\-member\fP شامل صفت‌های خصوصی زنجیره‌ای.
.sp
بسته شد: #6709
.IP \(bu 2
بررسی‌کنندهٔ جدید \fBcomparison\-of\-constants\fP اضافه شد.
.sp
بسته شد: #6076
.IP \(bu 2
کلاس \fBpylint.pyreverse.ASTWalker\fP حذف شد، زیرا تنها به صورت درونی توسط یک کلاس فرزند استفاده می‌شد.
.sp
ارجاع: #6712
.IP \(bu 2
در \fBpyreverse\fP: تحلیل و نمایش رابط‌های پیاده‌سازی‌شده که توسط صفت \fB__implements__\fP
تعریف شده‌اند منسوخ شده است و در نسخهٔ 3.0 حذف خواهد شد.
.sp
ارجاع: #6713
.IP \(bu 2
اصلاح ساختار نحو حاشیه‌نویسی نوع بازگشتی در نمودارهای MermaidJS تولیدشده با \fBpyreverse\fP\&.
.sp
بسته شد: #6467
.IP \(bu 2
اصلاح حاشیه‌نویسی نوع برای صفت‌های کلاس و نمونه با استفاده از نحو جایگزین union در نمودارهای \fBpyreverse\fP\&.
.IP \(bu 2
رفع مثبت کاذب \fBunexpected\-special\-method\-signature\fP برای متدهای \fB__init_subclass__\fP دارای یک یا چند آرگومان.
.sp
بسته شد: #6644
.IP \(bu 2
نادیده گرفتن خط زیرین (underscore) به عنوان یک متغیر محلی در بررسی‌کنندهٔ \fBtoo\-many\-locals\fP آغاز شد.
.sp
بسته شد: #6488
.IP \(bu 2
بهبود متن پیام \fBdeprecated\-module\fP
.sp
بسته شد: #6169
.IP \(bu 2
اکنون \fBPylint\fP برای اجرا به Python نسخهٔ 3.7.2 یا جدیدتر نیاز دارد.
.sp
بسته شد: #4301
.IP \(bu 2
کلاس‌های \fBBaseChecker\fP اکنون نیازمند ارسال آرگومان \fBlinter\fP هستند.
.IP \(bu 2
رفع مشکل در نظر نگرفتن غیرفعال‌سازی‌های درون‌خطی برای \fBfixme\fP در آخرین خط
یک ماژول هنگامی که pylint با گزینهٔ \fB\-\-enable=fixme\fP اجرا شده باشد.
.IP \(bu 2
به‌روزرسانی پیام \fBinvalid\-slots\-object\fP برای نمایش شیء نامعتبر به جای مقدار استنتاج‌شدهٔ آن.
.sp
بسته شد: #6101
.IP \(bu 2
نام بررسی‌کنندهٔ اصلی اکنون به جای \fBmaster\fP برابر \fBmain\fP است. نیازی به به‌روزرسانی پیکربندی نیست زیرا نام بخش‌ها اختیاری است.
.sp
بسته شد: #5467
.IP \(bu 2
عدم گزارش \fBuseless\-super\-delegation\fP برای متد \fB__hash__\fP در کلاس‌هایی که متد \fB__eq__\fP را نیز بازنویسی (override) می‌کنند.
.sp
بسته شد: #3934
.IP \(bu 2
بررسی‌کنندهٔ جدید \fBtypevar\-name\-mismatch\fP اضافه شد: TypeVar باید به متغیری با نام یکسان با آرگومان name آن منتسب شود.
.sp
بسته شد: #5224
.IP \(bu 2
اکنون pylint را می‌توان با یک پیش‌نیاز اضافی (extra\-require) به نام \fBspelling\fP نصب کرد (\fBpip install pylint[spelling]\fP).
این کار \fBpyenchant\fP را به وابستگی‌های pylint اضافه می‌کند. با این حال همچنان باید پیش‌نیازهای
\fBpyenchant\fP (کتابخانهٔ \fBenchant\fP و واژه‌نامه‌ها) را خودتان نصب کنید. همچنین لازم
است گزینهٔ \fBspelling\-dict\fP را تنظیم نمایید.
.sp
ارجاع: #6462
.IP \(bu 2
حذف پیام \fBassign\-to\-new\-keyword\fP به دلیل اینکه دیگر کلیدواژهٔ جدیدی در نسخه‌های
پشتیبانی‌شدهٔ Python وجود ندارد.
.sp
بسته شد: #4683
.IP \(bu 2
رفع کرش در بررسی‌کنندهٔ \fBnot\-an\-iterable\fP شامل چندین عبارت ستاره‌دار در داخل
یک فراخوانی.
.sp
بسته شد: #6372
.IP \(bu 2
رفع کرش در افزونهٔ \fBdocparams\fP شامل پرتاب کردن (raise) نتیجهٔ یک تابع.
.IP \(bu 2
رفع مشکل فعال نشدن \fBdeprecated\-module\fP پس از \fBdisable=all\fP
با محول کردن مسئولیت انحصاری صدور \fBdeprecated\-module\fP به \fBImportsChecker\fP به جای
تقسیم مسئولیت با \fBStdlibChecker\fP\&. (این وضعیت پیش‌تر می‌توانست باعث پیام‌های تکراری شود.)
.IP \(bu 2
هشدار \fBno\-init\fP (W0232) حذف شده است. نداشتن متد \fB__init__\fP در یک کلاس بلامانع است.
.sp
بسته شد: #2409
.IP \(bu 2
صفت \fBconfig\fP در \fBBaseChecker\fP منسوخ شده است. می‌توانید از \fBchecker.linter.config\fP
برای دسترسی به شیء پیکربندی سراسری به جای یک شیء مختص به بررسی‌کننده استفاده کنید.
.sp
ارجاع: #5392
.IP \(bu 2
صفت \fBlevel\fP در \fBBaseChecker\fP منسوخ شده است: اکنون همه‌چیز همواره
در \fB\-\-help\fP نمایش داده می‌شود.
.sp
ارجاع: #5392
.IP \(bu 2
صفت \fBoptions_providers\fP در \fBArgumentsManager\fP منسوخ شده است.
.sp
ارجاع: #5392
.IP \(bu 2
صفت \fBoption_groups\fP در \fBPyLinter\fP منسوخ شده است.
.sp
ارجاع: #5392
.IP \(bu 2
تمام کلاس‌های \fBInterface\fP در \fBpylint.interfaces\fP منسوخ شده‌اند. برای دستیابی به رفتاری
یکسان می‌توانید از کلاس‌های عادی متناظر زیرکلاس بسازید. قابلیت \fB__implements__\fP
بر پایهٔ یک PEP ردشده از سال 2001 بود:
\%<https://\:peps\:.python\:.org/\:pep-0245>
.sp
بسته شد: #2287
.IP \(bu 2
متد \fBset_option\fP در \fBBaseChecker\fP منسوخ شده است. می‌توانید از \fBchecker.linter.set_option\fP
برای تنظیم یک گزینه روی شیء پیکربندی سراسری به جای شیء مختص به بررسی‌کننده استفاده کنید.
.sp
ارجاع: #5392
.IP \(bu 2
پیام \fBimplicit\-str\-concat\fP اکنون در فراخوانی‌هایی مانند \fBopen(\(dqmyfile.txt\(dq \(dqa+b\(dq)\fP نیز صادر خواهد شد..sp
بستن #6441
.IP \(bu 2
ویژگی \fBconfig\fP در \fBPyLinter\fP اکنون به جای \fBoptparse.Values\fP از نوع \fBargparse.Namespace\fP است\&.
.sp
ارجاع به #5392
.IP \(bu 2
کلاس \fBMapReduceMixin\fP منسوخ شده است. اکنون \fBBaseChecker\fP متدهای \fBget_map_data\fP و
\fBreduce_map_data\fP را پیاده‌سازی می‌کند\&. اگر یک بررسی‌کننده نیاز واقعی به کاهش (reduce) داده‌ها داشته باشد، باید \fBget_map_data\fP
را طوری تعریف کند که مقداری غیر از \fBNone\fP برگرداند و مدیریت فهرستی از انواع داده‌های بازگردانده شده توسط \fBget_map_data\fP را به متد \fBreduce_map_data\fP خود بسپارد\&.
نمونه‌ای از این مورد را می‌توان در \fBpylint/checkers/similar.py\fP مشاهده کرد\&.
.IP \(bu 2
کلاس \fBUnsupportedAction\fP منسوخ شده است.
.sp
ارجاع به #5392
.IP \(bu 2
کلاس \fBOptionsManagerMixIn\fP منسوخ شده است.
.sp
ارجاع به #5392
.IP \(bu 2
کلاس \fBOptionParser\fP منسوخ شده است.
.sp
ارجاع به #5392
.IP \(bu 2
کلاس \fBOption\fP منسوخ شده است.
.sp
ارجاع به #5392
.IP \(bu 2
کلاس \fBOptionsProviderMixIn\fP منسوخ شده است.
.sp
ارجاع به #5392
.IP \(bu 2
کلاس \fBConfigurationMixIn\fP منسوخ شده است.
.sp
ارجاع به #5392
.IP \(bu 2
متد \fBget_global_config\fP منسوخ شده است. اکنون می‌توانید از طریق
\fBchecker.linter.config\fP به تمام گزینه‌های سراسری دسترسی داشته باشید\&.
.sp
ارجاع به #5392
.IP \(bu 2
کلاس \fBOptionsManagerMixIn\fP با \fBArgumentsManager\fP جایگزین شده است\&. کلاس \fBArgumentsManager\fP یک API خصوصی
در نظر گرفته می‌شود و بیشتر متدهایی که در \fBOptionsManagerMixIn\fP عمومی بودند اکنون منسوخ شده‌اند و
در نگارش‌های آینده حذف خواهند شد.
.sp
ارجاع به #5392
.IP \(bu 2
کلاس \fBOptionsProviderMixIn\fP با \fBArgumentsProvider\fP جایگزین شده است\&. کلاس \fBArgumentsProvider\fP یک API خصوصی
در نظر گرفته می‌شود و بیشتر متدهایی که در \fBOptionsProviderMixIn\fP عمومی بودند اکنون منسوخ شده‌اند و
در نگارش‌های آینده حذف خواهند شد.
.sp
ارجاع به #5392
.IP \(bu 2
قابلیت \fBinterfaces.implements\fP منسوخ شده است و در نسخهٔ 3.0 حذف خواهد شد. لطفاً به جای \fB__implements__\fP
از الگوهای وراثت استاندارد استفاده کنید\&.
.sp
ارجاع به #2287
.IP \(bu 2
پیام \fBinvalid\-enum\-extension\fP: زمانی استفاده می‌شود که یک کلاس تلاش کند یک کلاس Enum به ارث برده شده را گسترش دهد.
.sp
بستن #5501
.IP \(bu 2
پیام \fBunrecognized\-option\fP اضافه شد. در صورت مواجهه با هرگونه گزینهٔ ناشناخته ایجاد می‌شود.
.sp
بستن #5259
.IP \(bu 2
بررسی‌کنندهٔ جدید \fBtypevar\-double\-variance\fP اضافه شد: آرگومان‌های کلیدواژه‌ای \(dqcovariant\(dq و \(dqcontravariant\(dq
نمی‌توانند هم‌زمان در یک TypeVar بر روی \(dqTrue\(dq تنظیم شوند.
.sp
بستن #5895
.IP \(bu 2
فعال‌سازی مجدد بررسی‌کنندهٔ \fBbad\-docstring\-quotes\fP برای نسخهٔ Python <= 3.7.
.sp
بستن #6087
.IP \(bu 2
گزینهٔ معیوب \fBgenerate\-man\fP حذف شد.
.sp
بستن #5283
بستن #1887
.IP \(bu 2
رفع منفی کاذب برای \fBbad\-string\-format\-type\fP در صورتی که مقدار فرمت‌بندی‌شونده به عنوان متغیری حاوی یک مقدار ثابت
ارسال شده باشد.
.IP \(bu 2
افزودن بررسی جدید \fBunnecessary\-dunder\-call\fP برای فراخوانی‌های غیرضروری متدهای داندر (dunder).
.sp
بستن #5936
بستن #6074
.IP \(bu 2
بررسی‌کنندهٔ \fBcache\-max\-size\-none\fP به \fBmethod\-cache\-max\-size\-none\fP تغییر نام یافت\&.
.sp
بستن #5670
.IP \(bu 2
بررسی‌کنندهٔ \fBmethod\-cache\-max\-size\-none\fP اکنون \fBfunctools.cache\fP را نیز بررسی خواهد کرد\&.
.sp
بستن #5670
.IP \(bu 2
پیام \fBunnecessary\-lambda\-assignment\fP: عبارت لامبدا به یک متغیر نسبت داده شده است.
به جای آن تابع را با استفاده از کلیدواژهٔ \(dqdef\(dq تعریف کنید.
پیام \fBunnecessary\-direct\-lambda\-call\fP: عبارت لامبدا مستقیماً فراخوانی شده است.
به جای آن عبارت را به صورت درون‌خطی اجرا کنید.
.sp
بستن #5976
.IP \(bu 2
پیام \fBpotential\-index\-error\fP: هنگامی که اندیس یک لیست یا تاپل از طول آن بیشتر شود، صادر می‌شود.
این بررسی‌کننده در حال حاضر برای جلوگیری از مثبت‌های کاذب کاملاً محتاط عمل می‌کند. از پیشنهادها
برای بهبود آن استقبال می‌کنیم.
.sp
بستن #578
.IP \(bu 2
افزونهٔ اختیاری \fBredefined\-loop\-name\fP برای ارسال پیام در هنگام بازتعریف متغیر حلقه
در بدنهٔ حلقه اضافه شد.
.sp
بستن #5072
.IP \(bu 2
تغییر نوع پیام از \fBredefined\-outer\-name\fP به \fBredefined\-loop\-name\fP
(افزونهٔ اختیاری) برای بازتعریف متغیرهای حلقهٔ بیرونی توسط حلقه‌های درونی.
.sp
بستن #5608
.IP \(bu 2
گزینهٔ \fBignore\-mixin\-members\fP منسوخ شده است. اکنون باید از گزینهٔ جدید
\fBignored\-checks\-for\-mixins\fP استفاده کنید.
.sp
بستن #5205
.IP \(bu 2
پیام \fBbad\-option\-value\fP هر زمان که مقدار پیکربندی یا فراخوانی خط فرمان
شامل پیامی ناشناخته باشد، صادر خواهد شد.
.sp
بستن #4324
.IP \(bu 2
جلوگیری از گزارش \fBsuperfluous\-parens\fP در عبارت‌هایی که از عملگر \fBis not\fP استفاده می‌کنند.
.sp
بستن #5930
.IP \(bu 2
بررسی‌کنندهٔ \fBsuper\-without\-brackets\fP اضافه شد؛ هنگامی صادر می‌شود که پرانتزهای یک فراخوانی super جا افتاده باشد.
.sp
بستن #4008
.IP \(bu 2
گزینهٔ \fBgenerate\-toml\-config\fP اضافه شد.
.sp
ارجاع به #5462
.IP \(bu 2
بررسی‌کنندهٔ جدید \fBunnecessary\-list\-index\-lookup\fP برای اندیس‌گذاری روی یک لیست در زمان
پیمایش با استفاده از \fBenumerate()\fP اضافه شد\&.
.sp
بستن #4525
.IP \(bu 2
رفع صدور نادرست \fBuseless\-suppression\fP در بررسی‌کنندهٔ \fBwrong\-import\-position\fP\&.
.sp
بستن #5219
.IP \(bu 2
رفع مثبت کاذب \fBno\-member\fP برای Enumهایی با اعضای تعریف‌شده توسط خود کلاس.
.sp
بستن #5138
.IP \(bu 2
رفع منفی کاذب برای \fBno\-member\fP در هنگام تلاش برای انتساب یک صفت نمونه
به خودش بدون هیچ انتساب قبلی.
.sp
بستن #1555
.IP \(bu 2
مفهوم اولویت بررسی‌کننده‌ها (checker priority) حذف شد.
.IP \(bu 2
افزودن گزینهٔ جدید خط فرمان \fB\-\-minimal\-messages\-config\fP برای \fBpytest\fP، که تمام
پیام‌های نامربوط را در حین اجرای آزمون‌های کارکردی غیرفعال می‌کند.
.IP \(bu 2
پیام \fBduplicate\-argument\-name\fP اکنون برای هر مجموعه از آرگومان‌های تکراری تنها یک بار صادر می‌شود.
.IP \(bu 2
رفع اشکالی که در آن فعال‌سازی مجزای گزینهٔ \fBawait\-outside\-async\fP ممکن نبود.
.IP \(bu 2
دکوراتور \fBset_config_directly\fP حذف شد.
.IP \(bu 2
پیام جدیدی با نام \fBduplicate\-value\fP اضافه شد که مقادیر تکراری درون مجموعه‌ها (sets) را شناسایی می‌کند.
.sp
بستن #5880
.IP \(bu 2
اکنون Pylint مسیر کاربر (یعنی \fB~\fP به \fBhome/yusef/\fP) و متغیرهای محیطی (یعنی \fBhome/$USER/$project\fP
به \fBhome/yusef/pylint\fP برای \fBUSER=yusef\fP و \fBproject=pylint\fP) را برای گزینه‌های \fBoutput\-directory\fP،
\fBimport\-graph\fP، \fBext\-import\-graph\fP و \fBint\-import\-graph\fP در pyreverse و همچنین گزینهٔ \fBspelling\-private\-dict\-file\fP
در بررسی‌کنندهٔ املا بسط می‌دهد..sp
Refs #6493
.IP \(bu 2
افزونهٔ \fBNoSelfUseChecker\fP ایجاد شد و بررسی \fBno\-self\-use\fP به آن منتقل گردید.
اکنون باید این بررسی را به‌طور صریح با استفاده از
\fBload\-plugins=pylint.extensions.no_self_use\fP فعال کنید.
.sp
Closes #5502
.IP \(bu 2
رفع مشکل ذخیره‌سازی فایل‌های داده‌های مانا (persistent) در محیط‌هایی که دایرکتوری کش کاربر
و فایل تحلیل‌شده روی درایو متفاوتی قرار دارند.
.sp
Closes #6394
.IP \(bu 2
عدم صدور \fBunsubscriptable\-object\fP برای حاشیه‌نویسی‌های رشته‌ای (string annotations).
پایتون‌پیلینت (Pylint) دیگر بررسی نمی‌کند که آیا کلاس فقط در خردک‌های نوع (type stubs) جنریک است یا خیر.
.sp
Closes #4369 and #6523
.IP \(bu 2
رفع کرش pyreverse با خطای \fBRuntimeError: dictionary changed size during iteration\fP
.sp
Refs #6612
.IP \(bu 2
رفع باگی که در آن پیام خطای متنی ساده به stdout ارسال می‌شد و قالب‌های خروجی را نامعتبر می‌کرد.
.sp
Closes #6597
.IP \(bu 2
تابع \fBis_class_subscriptable_pep585_with_postponed_evaluation_enabled\fP منسوخ شده است.
به جای آن از \fBis_postponed_evaluation_enabled(node) and is_node_in_type_annotation_context(node)\fP
استفاده کنید.
.sp
Refs #6536
.IP \(bu 2
به‌روزرسانی محدوده‌های پیام خطای \fBusing\-constant\-test\fP و \fBmissing\-parentheses\-for\-call\-in\-test\fP\&.
.IP \(bu 2
عدم صدور \fBno\-member\fP درون حاشیه‌نویسی‌های نوع با
\fBfrom __future__ import annotations\fP\&.
.sp
Closes #6594
.UNINDENT
.SS "تازه‌های Pylint 2.13 (What\(aqs New in Pylint 2.13)"
.sp
از آغاز pylint تا نگارش 2.14.0 (شامل آن)، ما گزارش تغییراتی (changelog) داشتیم که حاوی \fIتمام\fP
تغییرات غیرجزئی در Pylint بود، از جمله تغییراتی که برای کاربر ملموس نبودند؛
یعنی تغییراتی که ممکن است تنها برای توسعه‌دهنده‌ای که روی pylint یا پلاگین‌های آن کار می‌کند یا یک تاریخ‌نگار دنیای متن‌باز جالب باشد.
.sp
از pylint 1.6.0 تا 2.14.0، علاوه بر گزارش تغییرات کامل، خلاصه‌ای از
تغییرات (عمدتاً کاربرمحور) نیز ارائه می‌شد.
.SS "خلاصه \-\- نکات برجسته انتشار (Summary \-\- Release highlights)"
.sp
در نگارش 2.13، ما بررسی جدیدی را برای مقابله با مسائل امنیتی یونیکد (unicode) معرفی کردیم. علاوه بر آن، کارهای زیادی
درون بررسی‌کنندهٔ یونیکد توسط @CarliJoy انجام شد. همچنین در میان سایر موارد، یک بررسی جدید هنگام وارد کردن (import) نام خصوصی
و بررسی دیگری برای سه‌نقطهٔ (ellipsis) غیرضروری اضافه کردیم.
.sp
ما مشکلات دیرینه‌ای در رابطه با کدهای تکراری که امکان غیرفعال‌سازی نداشتند و شماره خطوطی
که در برخی مواقع دقیق نبودند را رفع کردیم، و قابلیت بررسی (lint) تمام فایل‌های یک دایرکتوری را بدون نیاز
به مشخص کردن تک‌تک آن‌ها اضافه نمودیم؛ یکی از مورد انتظارترین موارد مخزن. با تشکر از @matusvalo !
.sp
به لطف @jacobtylerwalls بسیاری از مشکلات مربوط به \fBundefined\-variables\fP و \fBused\-before\-assignment\fP برطرف شدند.
.sp
ما ادغام مستندات \fBpylint\-error\fP، ایجادشده توسط @vald\-phoenix، توسعه‌دهنده‌ای اهل هلینیانی (Hlyniane) در اوکراین را
آغاز کردیم. امیدواریم با وجود شرایط فعلی اوضاع او خوب باشد. استقرار مستندات راه‌اندازی شده اما هنوز کارهای زیادی برای انجام دادن باقی مانده است؛
بنابراین از هرگونه مشارکت جامعه برای کمک به بازبینی، ادغام و افزودن مثال‌های خوب/بد در \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:5953>\&
استقبال می‌کنیم. این کار بدون نیاز به هیچ دانشی از pylint یا astroid قابل انجام است، بنابراین اگر می‌خواهید بدون صرف وقت
برای یادگیری سازوکارهای درونی در pylint مشارکت کنید، این یک نقطه ورود عالی است.
.sp
این انتشار آخرین نسخه‌ای است که از مفسرهای پایین‌تر از 3.7.2 پشتیبانی می‌کند؛ پایان عمر پایتون 3.6 در دسامبر 2021 فرا رسید.
.SS "بررسی‌کننده‌های جدید (New checkers)"
.INDENT 0.0
.IP \(bu 2
افزودن چندین بررسی‌کننده (checker) برای رسیدگی به مسائل امنیتی یونیکد
(برای جزئیات به Trojan Sources \%<https://\:trojansource\:.codes> و
PEP 672 \%<https://\:peps\:.python\:.org/\:pep-0672> مراجعه کنید) که با خوانایی
کد نیز مرتبط هستند. به‌طور مشخص، بررسی‌های زیر اضافه شدند:
.INDENT 2.0
.IP \(bu 2
بررسی‌کنندهٔ \fBbad\-file\-encoding\fP بررسی می‌کند که فایل بر اساس پیشنهاد
PEP8 \%<https://\:peps\:.python\:.org/\:pep-0008/#\:source-file-encoding>\& با فرمت UTF\-8 کدگذاری شده باشد.
در حال حاضر UTF\-16 و UTF\-32 توسط پایتون \%<https://\:bugs\:.python\:.org/\:issue1503789> پشتیبانی نمی‌شوند.
در صورت تغییر این وضعیت، \fBinvalid\-unicode\-codec\fP بررسی می‌کند که از آن‌ها استفاده نشود،
تا سازگاری رو به عقب حفظ شود.
.IP \(bu 2
بررسی‌کنندهٔ \fBbidirectional\-unicode\fP نویسه‌های یونیکد دوجهته (bidirectional) را بررسی می‌کند
که می‌توانند باعث شوند اجرای کد با آنچه کاربر انتظار دارد متفاوت باشد.
.IP \(bu 2
بررسی‌کننده‌های \fBinvalid\-character\-backspace\fP، \fBinvalid\-character\-carriage\-return\fP،
\fBinvalid\-character\-sub\fP، \fBinvalid\-character\-esc\fP،
\fBinvalid\-character\-zero\-width\-space\fP و \fBinvalid\-character\-nul\fP
برای بررسی نویسه‌های گریز‌نخوردهٔ (unescaped) بالقوه آسیب‌رسان.
.UNINDENT
.sp
Closes #5281
.IP \(bu 2
بررسی‌کنندهٔ \fBunnecessary\-ellipsis\fP: زمانی صادر می‌شود که ثابت سه‌نقطه (ellipsis) به‌طور غیرضروری استفاده شود.
.sp
Closes #5460
.IP \(bu 2
افزودن بررسی‌کنندهٔ جدید \fBtypevar\-name\-missing\-variance\fP\&. زمانی صادر می‌شود که یک
\fBTypeVar\fP هم‌وردا (covariant) یا پادوردا (contravariant) به‌ترتیب به \fB_co\fP یا \fB_contra\fP ختم نشود، یا
زمانی که یک \fBTypeVar\fP هیچ‌کدام از این دو نباشد اما دارای پسوند باشد.
.IP \(bu 2
افزودن \fBmodified\-iterating\-list\fP، \fBmodified\-iterating\-dict\fP و \fBmodified\-iterating\-set\fP؛
زمانی صادر می‌شوند که مواردی به‌ترتیب به یک لیست، دیکشنری یا
مجموعه‌ای که در حال پیمایش است افزوده یا از آن حذف شوند.
.sp
Closes #5348
.IP \(bu 2
افزودن بررسی‌کنندهٔ \fBredefined\-slots\-in\-subclass\fP: زمانی صادر می‌شود که یک slot در یک زیرکلاس (subclass) بازتعریف شود.
.sp
Closes #5617
.IP \(bu 2
.INDENT 2.0
.TP
.B بازنویسی بررسی‌کنندهٔ \fBnon\-ascii\-name\fP\&.
اکنون اطمینان حاصل می‌کند که __all__ نام‌های پایتون ASCII هستند و همچنین نام‌های
واردشده (\fBnon\-ascii\-module\-import\fP) و نام فایل‌ها (\fBnon\-ascii\-file\-name\fP) را
به‌درستی بررسی کرده و هشدارهای جدید مربوطه را صادر می‌کند.
.sp
نویسه‌های غیر ASCII می‌توانند هوموگلیف (نویسه‌های هم‌شکل) باشند و تایپ کردن آن‌ها
با صفحه‌کلید غیرتخصصی دشوار است.
بخش Confusable Characters را در PEP 672 \%<https://\:peps\:.python\:.org/\:pep-0672/#\:confusable-characters-in-identifiers> ببینید.
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
افزودن بررسی‌کنندهٔ \fBcache\-max\-size\-none\fP که استفاده از \fBfunctools.lru_cache\fP
را روی متدهای کلاس با مقدار \fBmaxsize\fP برابر با \fBNone\fP بررسی می‌کند. این کار توصیه نمی‌شود
زیرا با جلوگیری دائمی از جمع‌آوری زباله (garbage collection) برای نمونه، باعث ایجاد نشت حافظه می‌شود.
.sp
Closes #5670
Closes #6180
.UNINDENT.SS "بررسی‌کننده‌های حذف‌شده (Removed checkers)"
.INDENT 0.0
.IP \(bu 2
افزونه‌ی منسوخ‌شده‌ی \fBcheck_docs\fP حذف شد. می‌توانید برای بهره‌گیری از بررسی‌هایی که پیش‌تر در \fBcheck_docs\fP گنجانده شده بودند، از بررسی‌کننده‌ی \fBdocparams\fP استفاده کنید\&.
.sp
Closes #5322
.UNINDENT
.SS "افزونه‌ها (Extensions)"
.INDENT 0.0
.IP \(bu 2
افزونه‌ی جدید \fBimport\-private\-name\fP: وارد کردن (import) بسته‌ها و شیءهای خصوصی خارجی (دارای پیشوند \fB_\fP) را مشخص می‌کند. این افزونه با استفاده از \fBload\-plugins=pylint.extensions.private_import\fP قابل بارگذاری است\&.
.sp
Closes #5463
.IP \(bu 2
دستور Pyreverse \- افزودن خروجی در قالب mermaid\-js و html که یک نمودار mermaid js به همراه کدهای پایه‌ای (boilerplate) html است
.IP \(bu 2
\fBTypingChecker\fP
.INDENT 2.0
.IP \(bu 2
بررسی جدید \fBbroken\-noreturn\fP برای تشخیص استفاده‌های معیوب از \fBtyping.NoReturn\fP در صورتی که \fBpy\-version\fP روی پایتون \fB3.7.1\fP یا پایین‌تر تنظیم شده باشد، اضافه شد.
\%<https://\:bugs\:.python\:.org/\:issue34921>
.IP \(bu 2
بررسی جدید \fBbroken\-collections\-callable\fP برای تشخیص استفاده‌های معیوب از \fBcollections.abc.Callable\fP در صورتی که \fBpy\-version\fP روی پایتون \fB3.9.1\fP یا پایین‌تر تنظیم شده باشد، اضافه شد.
\%<https://\:bugs\:.python\:.org/\:issue42965>
.UNINDENT
.IP \(bu 2
\fBDocstringParameterChecker\fP
.INDENT 2.0
.IP \(bu 2
دسته‌بندی نادرست docstring به سبک Numpy به‌جای سبک Google برای docstringهایی که دارای مستندات property setter بودند، برطرف شد.
دسته‌بندی docstring اکنون به‌جای ترتیب آزمودن سبک‌های docstring، بر اساس بیشترین تعداد بخش‌های منطبق‌شده انجام می‌شود.
.UNINDENT
.IP \(bu 2
\fBDocStringStyleChecker\fP
.INDENT 2.0
.INDENT 3.5
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
غیرفعال‌سازی بررسی‌کننده‌ی \fBbad\-docstring\-quotes\fP برای پایتون <= 3.7؛ زیرا در این نسخه‌ها شماره خطوط برای توابع و کلاس‌های دکوریت‌شده (decorated) قابل اعتماد نبوده و با این بررسی‌کننده تداخل ایجاد می‌کند.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
Closes #3077
.UNINDENT
.UNINDENT
.UNINDENT
.SS "سایر تغییرات (Other Changes)"
.INDENT 0.0
.IP \(bu 2
گنجاندن \fBtesting_pylintrc\fP در توزیع‌های مبدأ (source) و wheel.
.sp
Closes #6028
.IP \(bu 2
رفع مثبت کاذب برای \fBunused\-import\fP هنگام غیرفعال‌سازی هم‌زمانِ \fBused\-before\-assignment\fP و \fBundefined\-variable\fP\&.
.sp
Closes #6089
.IP \(bu 2
رفع مثبت کاذب برای \fBunnecessary\-ellipsis\fP هنگام استفاده از سه نقطه (ellipsis) به‌عنوان یک آرگومان پیش‌فرض.
.sp
Closes #5973
.IP \(bu 2
افزودن متدهای dunder جاافتاده به بررسی \fBunexpected\-special\-method\-signature\fP.
.IP \(bu 2
عدم صدور \fBno\-member\fP در حلقه‌های for که به \fBself\fP ارجاع می‌دهند، در صورتی که عملگر دودویی آغازگر حلقه‌ی for از یک \fBself\fP محصورشده در تاپل‌ها یا لیست‌ها استفاده کند.
.sp
Refs pylint\-dev/astroid#1360
Closes #4826
.IP \(bu 2
رفع مشکل تطبیق گزینه‌های \fB\-\-notes\fP که به یک نویسه‌ی غیرکلمه‌ای ختم می‌شوند.
.sp
Closes #5840
.IP \(bu 2
شماره‌گذاری خطوط برای پیام‌های مربوط به آرگومان‌های تابع اکنون دقیق‌تر شده است. این امر ممکن است نیازمند انتقال برخی از دستورهای غیرفعال‌سازی پیام به موقعیت‌های به‌روزرسانی‌شده باشد.
.IP \(bu 2
.INDENT 2.0
.TP
.B شناسه‌های پیام \fBusing\-f\-string\-in\-unsupported\-version\fP و \fBusing\-final\-decorator\-in\-unsupported\-version\fP
از \fBW1601\fP و \fBW1602\fP به \fBW2601\fP و \fBW2602\fP تغییر نام یافتند\&. غیرفعال‌سازی‌هایی که از این شناسه‌ها استفاده می‌کنند از کار خواهند افتاد.
این کار به‌منظور بازگرداندن سازگاری با msgidهای از قبل موجود برای \fBapply\-builtin\fP و
\fBbasestring\-builtin\fP از بررسی‌کننده‌ی اکنون حذف‌شده‌ی python 3K+ انجام شده است. اکنون بررسی جدیدی وجود دارد که اطمینان حاصل می‌کند از
msgidها یا نمادهای موجود از بررسی‌کننده‌های حذف‌شده استفاده نشود.
.UNINDENT
.sp
Closes #5729
.IP \(bu 2
افزودن گزینه‌ی \fB\-\-recursive\fP برای امکان کشف بازگشتی تمام ماژول‌ها و بسته‌ها در زیردرخت (subtree). اجرای pylint با
گزینه‌ی \fB\-\-recursive=y\fP تمام فایل‌های \fB\&.py\fP و بسته‌های کشف‌شده در زیردرخت دایرکتوریِ ارائه‌شده
به‌عنوان پارامتر به pylint را بررسی خواهد کرد.
.sp
Closes #352
.IP \(bu 2
موقعیت پیام‌ها برای تعاریف کلاس و تابع به‌روزرسانی شد تا دیگر کل تعریف را در بر نگیرد.
تنها \fBdef\fP یا \fBclass\fP به همراه نام کلاس/تابع پوشش داده می‌شوند.
.sp
Closes #5466
.IP \(bu 2
بازگرداندن بررسی‌هایی از بررسی‌کننده‌ی python3 که هنوز برای python 3 مفید هستند
(\fBeq\-without\-hash\fP). این بررسی اکنون در افزونه‌ی اختیاری \fBpylint.extensions.eq_without_hash\fP
قرار دارد.
.sp
Closes #5025
.IP \(bu 2
رفع منفی کاذب (false\-negative) برای بررسی‌کننده‌ی \fBassignment\-from\-none\fP با متد ()list.sort.
.sp
Closes #5722
.IP \(bu 2
رفع مثبت کاذب \fBunused\-private\-member\fP هنگام دسترسی به متدهای خصوصی از طریق \fBproperty\fP\&.
.sp
Closes #4756
.IP \(bu 2
رفع خرابی (crash) ناشی از \fBarguments\-differ\fP و \fBarguments\-renamed\fP هنگامی که متدها
خارج از بالاترین سطح یک کلاس تعریف شده بودند.
.sp
Closes #5648
.IP \(bu 2
پیام‌های هشدار بهتر برای else یا elif بی‌استفاده هنگامی که یک تابع زودتر بازمی‌گردد (early return).
.sp
Closes #5614
.IP \(bu 2
علامت‌های ستاره دیگر در مستندسازی پارامتر به سبک Sphinx و Google برای
\fBmissing\-param\-doc\fP الزامی نبوده و به‌درستی تجزیه می‌شوند.
.sp
Closes #5815
Closes #5406
.IP \(bu 2
رفع خطای \fBAstroidError\fP در نسخه‌ی 2.13.0 که توسط بررسی‌کننده‌ی \fB\(gaduplicate\-code\(ga\fP با فعال بودن
\fBignore\-imports\fP یا \fBignore\-signatures\fP رخ می‌داد.
.sp
Closes #6301
.IP \(bu 2
استفاده از بسته‌ی \fBtomli\fP به‌جای \fBtoml\fP برای تجزیه‌ی فایل‌های \fB\&.toml\fP.
.sp
Closes #5885
.IP \(bu 2
رفع مثبت کاذب \fBconsider\-using\-dict\-comprehension\fP هنگام ایجاد یک dict با استفاده
از فهرستی از تاپل‌ها که در آن کلید و مقدار هر دو وابسته به یک شرط تغییر می‌کنند.
.sp
Closes #5588
.IP \(bu 2
هنگام اجرا در حالت موازی، \fBpylint\fP اکنون داده‌های ارسالی به زیرفرایندها (subprocesses) را با
بسته‌ی \fBdill\fP پیکل (pickle) می‌کند. از این رو بسته‌ی \fBdill\fP به‌عنوان یک وابستگی اضافه شده است.
.IP \(bu 2
رفع مثبت کاذب برای \fBglobal\-variable\-undefined\fP هنگامی که \fBglobal\fP با نام یک کلاس استفاده می‌شود
.sp
Closes #3088
.IP \(bu 2
رفع خرابی (crash) در propertyها و متدهای کلاس به ارث‌رسیده هنگام مقایسه‌ی برابری آن‌ها
با یک dict خالی.
.sp
Closes #5646
.IP \(bu 2
به‌طور پیش‌فرض، pylint دیگر فایل‌هایی را که با \fB\&.#\fP شروع می‌شوند در نظر نمی‌گیرد. این فایل‌ها قفل‌های
فایل Emacs در نظر گرفته می‌شوند \%<https://\:www\:.gnu\:.org/\:software/\:emacs/\:manual/\:html_node/\:elisp/\:File-Locks\:.html>\&. این رفتار را می‌توان با بازتعریف
گزینه‌ی \fBignore\-patterns\fP به حالت قبل بازگرداند.
.sp
Closes #367
.UNINDENT
.INDENT 0.0
.IP \(bu 2
رفع \fBsuper\-init\-not\-called\fP هنگامی که والد یا \fBself\fP یک \fBProtocol\fP باشد
.sp
Closes #4790
.IP \(bu 2
الگوی گزارش مشکل (issue template) برای خرابی‌ها اکنون برای خرابی‌هایی که پیش‌تر تحت پوشش
این سازوکار نبودند نیز ایجاد می‌شود.
.sp
Closes #5668.IP \(bu 2
مشکلی در astroid که در آن symlinkها در نظر گرفته نمی‌شدند، برطرف شد.
.sp
Closes #1470
Closes #3499
Closes #4302
Closes #4798
Closes #5081
.IP \(bu 2
رفع منفی کاذب برای \fBundefined\-variable\fP و پیام‌های متغیر مرتبط، هنگامی که همان متغیر تعریف‌نشده به‌عنوان type annotation استفاده شده و چندین بار فراخوانی می‌شود، یا به‌عنوان آرگومان پیش‌فرض یک تابع به کار می‌رود.
.sp
Closes #5399
.IP \(bu 2
ارسال \fBused\-before\-assignment\fP به جای \fBundefined\-variable\fP هنگام تلاش برای دسترسی به type annotationهای استفاده‌نشده.
.sp
Closes #5713
.IP \(bu 2
رفع مشکلی که در آن \fBungrouped\-imports\fP بدون ایجاد \fBuseless\-suppression\fP قابل غیرفعال‌سازی نبود.
.sp
Refs #2366
.IP \(bu 2
رفع خرابی (crash) در گره‌های \fB__init__\fP زمانی که صفت مورد نظر قبلاً به دلیل محدودیت اندازه حافظه موقت (cache) غیرقابل استنتاج بود. این محدودیت می‌تواند زمانی رخ دهد که الگوی وراثت یک کلاس (و در نتیجه صفت \fB__init__\fP) بسیار بزرگ باشد.
.sp
Closes #5679
.IP \(bu 2
رفع پردازش بسیار طولانی خطوط بلند حاوی کاما.
.sp
Closes #5483
.IP \(bu 2
رفع مثبت کاذب \fBsuper\-init\-not\-called\fP برای کلاس‌هایی که \fBinit\fP خود را از والد به ارث می‌برند.
.sp
Closes #4941
.IP \(bu 2
رفع مثبت‌های کاذب برای \fBused\-before\-assignment\fP ناشی از استفاده از named expressions در شرط عملگر سه‌گانه و استفاده از آن عبارت به‌عنوان آرگومان فراخوانی.
.sp
Closes #5177, #5212
.IP \(bu 2
رفع خرابی همراه با خطای بازگشت (recursion error) برای استنتاج صفت‌های کلاسی که به خود کلاس ارجاع می‌دادند.
.sp
Closes #5408
Refs pylint\-dev/astroid#1392
.IP \(bu 2
رفع مثبت کاذب برای \fBunused\-argument\fP زمانی که یک متد بازنویسی‌شده در یک زیرکلاس هیچ عملیاتی با مقدار یک آرگومان keyword\-only انجام نمی‌دهد.
.sp
Closes #5771
Refs pylint\-dev/astroid#1382
.IP \(bu 2
بهینه‌سازی تجزیه (parsing) خطوط طولانی زمانی که \fBmissing\-final\-newline\fP فعال است.
.sp
Closes #5724
.IP \(bu 2
رفع مثبت کاذب برای \fBused\-before\-assignment\fP ناشی از تعریف کلاس تودرتو درون تابعی که از یک کلاس تعریف‌شده در خارج از تابع ارث‌بری می‌کند.
.sp
Closes #4590
.IP \(bu 2
رفع مثبت کاذب \fBunnecessary_dict_index_lookup\fP هنگام حذف یک مدخل از دیکشنری.
.sp
Closes #4716
.IP \(bu 2
رفع مثبت کاذب برای \fBused\-before\-assignment\fP زمانی که نام یک گرداننده except با شرطی در یک comprehension فیلترشده یکسان است.
.sp
Closes #5817
.IP \(bu 2
رفع خرابی در بررسی‌کننده \fBunused\-private\-member\fP هنگام تحلیل کدی که از \fBtype(self)\fP در متدهای متصل (bound methods) استفاده می‌کند.
.sp
Closes #5569
.IP \(bu 2
رفع خرابی در بررسی‌کننده \fBunnecessary\-dict\-index\-lookup\fP اگر خروجی \fBitems()\fP به یک تاپل تک‌عضوی (1\-tuple) منتسب شود.
.sp
Closes #5504
.IP \(bu 2
رفع خرابی در انتساب‌های slots و انتساب‌های دارای نوع‌نویسی (annotated assignments).
.sp
Closes #5479
.IP \(bu 2
رفع خرابی در بررسی‌کننده \fBunspecified\-encoding\fP هنگام ارسال \fBNone\fP به آرگومان \fBmode\fP در فراخوانی \fBopen()\fP\&.
.sp
Closes #5731
.IP \(bu 2
رفع خرابی مربوط به \fBNewType\fP نام‌گذاری‌شده با یک f\-string.
.sp
Closes #5770
Refs pylint\-dev/astroid#1400
.IP \(bu 2
بهبود پیام \fBbad\-open\-mode\fP هنگام ارسال \fBNone\fP به آرگومان \fBmode\fP در فراخوانی \fBopen()\fP\&.
.sp
Closes #5733
.IP \(bu 2
رفع منفی کاذب برای \fBconsider\-iterating\-dictionary\fP هنگام بررسی‌های عضویت در قالب تکرارپذیرها یا بررسی‌های \fBnot in\fP\&.
.sp
Closes #5323
.IP \(bu 2
امکان غیرفعال‌سازی \fBduplicate\-code\fP با یک کامنت غیرفعال‌سازی هنگام اجرا از طریق pylint.
.sp
Closes #214
.IP \(bu 2
رفع مثبت کاذب برای \fBundefined\-variable\fP زمانی که صفت‌های کلاس \fBnamedtuple\fP به‌عنوان return annotation استفاده می‌شوند.
.sp
Closes #5568
.IP \(bu 2
افزودن سطح اطمینان \fBCONTROL_FLOW\fP برای هشدارهایی که به فرضیات مربوط به جریان کنترل متکی هستند.
.IP \(bu 2
اکنون \fBused\-before\-assignment\fP در نظر می‌گیرد که انتساب‌ها در یک بلوک try ممکن است هنگام اجرای بلوک‌های except یا finally رخ نداده باشند.
.sp
Closes #85, #2615
.IP \(bu 2
رفع منفی کاذب برای \fBused\-before\-assignment\fP زمانی که یک عبارت شرطی یا context manager پیش از دستور try مداخله کرده و احتمال شکست آن را نشان می‌داد.
.sp
Closes #4045
.IP \(bu 2
رفع منفی کاذب برای \fBused\-before\-assignment\fP در بلوک‌های finally چنانچه گرداننده except، انتسابی را که ممکن بود در بلوک try با شکست مواجه شود، تعریف نکرده باشد.
.IP \(bu 2
رفع یک مثبت کاذب برای \fBassigning\-non\-slot\fP زمانی که کلاس دارای slots، متد \fB__setattr__\fP را تعریف کرده باشد.
.sp
Closes #3793
.IP \(bu 2
رفع یک مثبت کاذب برای \fBinvalid\-class\-object\fP زمانی که شیء منتسب‌شده به صفت \fB__class__\fP غیرقابل استنتاج باشد.
.IP \(bu 2
افزودن نیازمندی اضافی \fBtestutil\fP به بسته‌بندی، چرا که \fBgitpython\fP نباید همیشه جزو وابستگی‌ها باشد اما همچنان برای استفاده از کد کمکی primer در \fBpylint.testutil\fP مورد نیاز است. می‌توانید آن را با \fBpip install pylint[testutil]\fP نصب کنید.
.sp
Closes #5486
.IP \(bu 2
رفع یک مثبت کاذب برای \fBused\-before\-assignment\fP زمانی که یک named expression به‌عنوان نخستین مقدار در یک ظرف (container) ظاهر شود.
.sp
Closes #5112
.IP \(bu 2
رفع مثبت کاذب برای \fBused\-before\-assignment\fP در صورت وجود type annotation خودارجاع در عبارات شرطی درون متدهای کلاس.
.sp
Closes #5499
.IP \(bu 2
اکنون \fBused\-before\-assignment\fP فرض می‌کند که انتساب‌ها در بلوک‌های except ممکن است رخ نداده باشند و بر این اساس هشدار می‌دهد.
.sp
Closes #4761
.IP \(bu 2
هنگام ارزیابی عبارات پس از یک بلوک except، چنانچه بلوک try متناظر شامل دستور return باشد، \fBused\-before\-assignment\fP فرض می‌کند که انتساب‌ها در بلوک‌های except انجام گرفته‌اند.
.sp
Closes #5500
.IP \(bu 2
رفع یک منفی کاذب برای \fBused\-before\-assignment\fP زمانی که برخی از گرداننده‌های except (و نه همه آن‌ها) نامی را تعریف کرده بودند که پس از بلوک except مورد اتکا بود، در حالی که بلوک try متناظر حاوی دستور return بود.
.sp
Closes #5524
.IP \(bu 2
هنگام ارزیابی عبارات در بند \fBelse\fP یک حلقه، چنانچه گرداننده‌های except تنها روش‌های به پایان رسیدن حلقه بدون خروج زودهنگام (break) باشند، \fBused\-before\-assignment\fP فرض می‌کند که انتساب‌ها در بلوک‌های except انجام گرفته‌اند..sp
بسته شد #5683
.IP \(bu 2
اکنون \fBused\-before\-assignment\fP نام‌ها را در بلوک‌های try بررسی می‌کند.
.IP \(bu 2
رفع مثبت کاذب در \fBused\-before\-assignment\fP برای عبارت‌های انتساب
در دستورهای lambda.
.sp
بسته شد #5360، #3877
.IP \(bu 2
بهبود بررسی \fBinvalid\-name\fP برای نام‌های \fBTypeVar\fP\&.
الگوی پذیرفته‌شده را می‌توان با \fB\-\-typevar\-rgx\fP سفارشی‌سازی کرد.
.sp
بسته شد #3401
.IP \(bu 2
رفع یک مثبت کاذب (مربوط به نسخهٔ در حال توسعهٔ منتشرنشده) برای
\fBused\-before\-assignment\fP مرتبط با تشابه نام‌ها میان comprehensionهای فیلترشده
و انتساب‌ها در بلوک‌های except.
.sp
بسته شد #5586
.IP \(bu 2
رفع خرابی در list comprehensionهایی که از \fBtype\fP به عنوان نام متغیر درونی استفاده می‌کردند.
.sp
بسته شد #5461
.IP \(bu 2
رفع خرابی در بررسی‌کنندهٔ \fBuse\-maxsplit\-arg\fP هنگام ارائهٔ کلیدواژه‌ایِ آرگومان \fBsep\fP
به \fBstr.split()\fP\&.
.sp
بسته شد #5737
.IP \(bu 2
رفع مثبت کاذب برای \fBunused\-variable\fP در مورد متغیر comprehension که با
یک یادداشت نوع در دامنهٔ بیرونی مطابقت دارد.
.sp
بسته شد #5326
.IP \(bu 2
رفع منفی کاذب برای \fBundefined\-variable\fP در مورد متغیری که چندین بار در یک
comprehension هم‌نام با یادداشت نوعِ استفاده‌نشده در دامنهٔ بیرونی به کار رفته است.
.sp
بسته شد #5654
.IP \(bu 2
الزام پایتون \fB3.6.2\fP برای اجرای pylint.
.sp
بسته شد #5065
.IP \(bu 2
رفع خرابی هنگام مواجهه با دکوراتورهای غیرقابل استنتاج در پایتون 3.6 و 3.7
.IP \(bu 2
صدور \fBredefined\-outer\-name\fP هنگامی که یک مدیریت‌کنندهٔ except تودرتو بر یک مورد بیرونی سایه‌اندازی می‌کند.
.sp
بسته شد #4434
بسته شد #5370
.IP \(bu 2
اکنون می‌توان \fBencoding\fP را به عنوان یک آرگومان موضعی به فراخوانی‌های بازکنندهٔ فایل ارسال کرد،
بدون آنکه \fBunspecified\-encoding\fP صادر شود.
.sp
بسته شد #5638
.IP \(bu 2
خطاهای مهلک (fatal) اکنون صرف‌نظر از اینکه ماژول بررسی‌شده
حاوی دستوری باشد یا خیر، امتیاز 0.0 را برمی‌گردانند
.sp
بسته شد #5451
.IP \(bu 2
متغیر \fBfatal\fP به متغیرهای مجاز در عبارت‌های ارزیابی امتیاز اضافه شد.
.IP \(bu 2
ارزیابی پیش‌فرض امتیاز اکنون از کف 0 استفاده می‌کند.
.sp
بسته شد #2399
.IP \(bu 2
رفع مثبت کاذب \fBcomparison\-with\-callable\fP برای فراخوان‌پذیرهایی (callables) که استثنا صادر می‌کنند، مانند
ثابت‌های typing.
.sp
بسته شد #5557
.IP \(bu 2
هنگام فراخوانی \fBpylint\fP، \fBepylint\fP، \fBsymilar\fP یا \fBpyreverse\fP با وارد کردن (import) آن‌ها در یک فایل پایتون،
می‌توان اکنون علاوه بر دستکاری \fBsys.argv\fP، کلمه کلیدی \fBargv\fP را نیز ارسال کرد.
.sp
بسته شد #5320
.IP \(bu 2
کلاس \fBPyLinter\fP اکنون در صورت عدم ارائهٔ گزارشگر، با یک \fBTextReporter\fP
به عنوان گزارشگر خود مقداردهی اولیه خواهد شد.
.IP \(bu 2
رفع مثبت کاذب \fBnot\-callable\fP برای ویژگی‌هایی که نام مستعار \fBNamedTuple\fP هستند
.sp
رفع بخشی از #1730
.IP \(bu 2
بخش \fBtestutils\fP برای unittestها اکنون \fBend_lineno\fP و \fBend_column\fP را می‌پذیرد. تست‌های
فاقد این موارد باعث صدور \fBDeprecationWarning\fP خواهند شد.
.IP \(bu 2
هشدار \fBarguments\-differ\fP دیگر از تعریف مجدد متدها با پارامترهای اضافی
که دارای مقادیر پیش‌فرض هستند ایرادی نخواهد گرفت.
.sp
بسته شد #1556، #5338
.IP \(bu 2
غیرفعال‌سازی‌های مربوط به \fBdeprecated\-module\fP و هشدارهای مشابه برای ویژگی‌های stdlib که در نسخه‌های
جدیدتر پایتون منسوخ شده‌اند، هنگام تحلیل کد با مفسرهای قدیمی‌تر پایتون که این ویژگی‌ها هنوز در آن‌ها منسوخ نشده‌اند،
دیگر \fBuseless\-suppression\fP صادر نمی‌کنند.
.IP \(bu 2
وارد کردن ماژول منسوخ‌شدهٔ stdlib یعنی \fBxml.etree.cElementTree\fP اکنون \fBdeprecated_module\fP را صادر می‌کند.
.sp
بسته شد #5862
.IP \(bu 2
وارد کردن ماژول منسوخ‌شدهٔ stdlib یعنی \fBdistutils\fP در پایتون 3.10+ اکنون \fBdeprecated_module\fP را صادر می‌کند.
.IP \(bu 2
رفع مثبت کاذب \fBunexpected\-keyword\-arg\fP برای دکوراتورها.
.sp
بسته شد #258
.IP \(bu 2
بررسی‌کنندهٔ \fBmissing\-raises\-doc\fP اکنون سلسله‌مراتب کلاسی استثناهای پرتاب‌شده را بررسی می‌کند
.INDENT 2.0
.INDENT 3.5
.sp
.EX
def my_function():
  \(dq\(dq\(dqMy function.

  Raises:
    Exception: if something fails
  \(dq\(dq\(dq
  raise ValueError
.EE
.UNINDENT
.UNINDENT
.sp
بسته شد #4955
.IP \(bu 2
رفع مثبت کاذب برای \fBunused\-variable\fP هنگامی که یک نام \fBnonlocal\fP به عنوان بخشی از یک انتساب چندنامی مقداردهی می‌شود.
.sp
بسته شد #3781
.IP \(bu 2
رفع مثبت کاذب \- مجاز دانستن بازگشایی (unpacking) متغیر \fBself\fP در زیرکلاسی از \fBtyping.NamedTuple\fP\&.
.sp
بسته شد #5312
.IP \(bu 2
رفع منفی کاذب \fBunpacking\-non\-sequence\fP زمانی که مقدار یک لیست خالی است.
.sp
بسته شد #5707
.IP \(bu 2
رفع مثبت کاذب برای \fBglobal\-variable\-not\-assigned\fP هنگامی که از دستور \fBdel\fP استفاده می‌شود
.sp
بسته شد #5333
.IP \(bu 2
اصلاح راهنمایی‌های نوع در نمودارهای کلاسی تولیدشده توسط pyreverse برای متدهای کلاس و متدهایی که None برمی‌گردانند.
.IP \(bu 2
ارائهٔ پیام خطای بهتر در صورت استفاده از قالب‌های پروندهٔ پشتیبانی‌نشده با \fBpyreverse\fP\&.
.sp
بسته شد #5950
.IP \(bu 2
رفع مثبت کاذب برای \fBunused\-argument\fP هنگامی که یک نام \fBnonlocal\fP در یک تابع
تودرتو به کار می‌رود که بدون فراخوانی توسط والدش بازگردانده می‌شود.
.sp
بسته شد #5187
.IP \(bu 2
جلوگیری از صدور \fBraising\-bad\-type\fP هنگامی که ابهام در استنتاج نوع متغیر
پرتاب‌شده وجود دارد.
.sp
بسته شد #2793
.IP \(bu 2
رفع مثبت کاذب برای \fBsuperfluous\-parens\fP در الگوهایی مانند
\(dqreturn (a or b) in iterable\(dq.
.sp
بسته شد #5803
.IP \(bu 2
رفع خرابی در بررسی‌کنندهٔ \fBunsupported\-membership\-test\fP هنگام انتساب
چندین مقدار ثابت به ویژگی‌های کلاس از جمله \fB__iter__\fP از طریق بازگشایی (unpacking).
.sp
بسته شد #6366
.IP \(bu 2
رفع مثبت کاذب برای \fBused\-before\-assignment\fP در انتساب‌هایی که از طریق
اعلان‌های nonlocal پس از یک یادداشت نوع قبلی رخ می‌دهند.
.sp
بسته شد #5394
.IP \(bu 2
رفع مثبت کاذب برای \fBunused\-variable\fP زمانی که به یک مورد توکار (builtin) مشخص‌شده در
\fB\-\-additional\-builtins\fP یک یادداشت نوع اختصاص داده می‌شود.
.sp
بسته شد #6388
.IP \(bu 2
رفع مثبت کاذب برای nonexistent\-operator / E0107 \%<#\:nonexistent-operator>\(aq هنگامی که \(aq\-\(aqهای تکراری
از یکدیگر جدا شده‌اند (برای مثال با پرانتز).
.sp
بسته شد #5769.IP \(bu 2
رفع مثبت کاذب برای \fBundefined\-loop\-variable\fP هنگامی که بخش \fBelse\fP از یک حلقهٔ
\fBfor\fP استثنا ایجاد می‌کند یا بازمی‌گردد.
.sp
بستن #5971
.IP \(bu 2
صادر کردن \fBnot\-callable\fP تنها زمانی که تمام مقادیر استنتاج‌شدهٔ یک ویژگی فراخوانی‌پذیر نباشند.
.sp
بستن #5931
.IP \(bu 2
رفع مثبت کاذب برای \fBunused\-variable\fP برای کلاس‌های درون توابع
و مواردی که یک متاکلاس از طریق یک فراخوانی ارائه شده است.
.sp
بستن #4020
.IP \(bu 2
اجتناب از گزارش \fBsuperfluous\-parens\fP در عبارت‌هایی که از عملگر \fBis not\fP استفاده می‌کنند.
.sp
بستن #5930
.IP \(bu 2
رفع مثبت کاذب برای \fBundefined\-loop\-variable\fP برای متغیری که در یک lambda
درون نخستین حلقه از چندین حلقه استفاده شده است.
.sp
بستن #6419
.IP \(bu 2
رفع مثبت کاذب برای \fBunsubscriptable\-object\fP در Python 3.8 و پیش از آن برای
دستورهای محافظت‌شده با \fBif TYPE_CHECKING\fP\&.
.sp
بستن #3979
.IP \(bu 2
رفع خرابی هنگام دسترسی به \fB__code__\fP و انتساب آن به یک متغیر.
.sp
بستن #6539
.IP \(bu 2
رفع خرابی هنگام ارزیابی (linting) فایلی که یک عدد صحیح را به عنوان \fBmode=\fP به
\fBopen\fP ارسال می‌کند.
.sp
بستن #6414
.IP \(bu 2
رفع مثبت‌های کاذب برای \fBno\-name\-in\-module\fP و \fBimport\-error\fP برای \fBnumpy.distutils\fP
و \fBpydantic\fP\&.
.sp
بستن #6497
.IP \(bu 2
رفع خرابی \fBIndexError\fP در متد \fBuninferable_final_decorators\fP\&.
.sp
مرتبط با #6531
.IP \(bu 2
رفع خرابی در \fBunnecessary\-dict\-index\-lookup\fP هنگام اندیس‌گذاری یک صفت.
.sp
بستن #6557
.IP \(bu 2
رفع مثبت کاذب برای \fBundefined\-loop\-variable\fP هنگام استفاده از \fBenumerate()\fP\&.
.sp
بستن #6593
.UNINDENT
.SS "گزارش کامل تغییرات (Full changelog)"
.SS "تازه‌های Pylint 2.13.9 (What\(aqs New in Pylint 2.13.9?)"
.sp
تاریخ انتشار: 2022\-05\-13
.INDENT 0.0
.IP \(bu 2
رعایت گزینه‌های پیکربندی نادیده‌گیری با \fB\-\-recursive=y\fP\&.
.sp
بستن #6471
.IP \(bu 2
رفع مثبت‌های کاذب برای \fBno\-name\-in\-module\fP و \fBimport\-error\fP برای \fBnumpy.distutils\fP و \fBpydantic\fP\&.
.sp
بستن #6497
.IP \(bu 2
رفع خرابی \fBIndexError\fP در متد \fBuninferable_final_decorators\fP\&.
.sp
مرتبط با #6531
.IP \(bu 2
رفع خرابی در \fBunnecessary\-dict\-index\-lookup\fP هنگام اندیس‌گذاری یک صفت.
.sp
بستن #6557
.IP \(bu 2
رفع خرابی هنگام دسترسی به \fB__code__\fP و انتساب آن به یک متغیر.
.sp
بستن #6539
.IP \(bu 2
رفع مثبت کاذب برای \fBundefined\-loop\-variable\fP هنگام استفاده از \fBenumerate()\fP\&.
.sp
بستن #6593
.UNINDENT.SS تازه‌های Pylint 2.13.8 (What\(aqs New in Pylint 2.13.8?)
.sp
تاریخ انتشار: 2022\-05\-02
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب برای \fBundefined\-loop\-variable\fP برای متغیری که درون یک lambda
در اولین حلقه از چندین حلقه استفاده شده است.
.sp
بسته شد #6419
.IP \(bu 2
رفع کرش هنگام لینت کردن فایلی که یک مقدار صحیح \fBmode=\fP را به
\fBopen\fP ارسال می‌کند.
.sp
بسته شد #6414
.IP \(bu 2
جلوگیری از گزارش \fBsuperfluous\-parens\fP در عبارت‌هایی که از عملگر \fBis not\fP استفاده می‌کنند.
.sp
بسته شد #5930
.IP \(bu 2
رفع مثبت کاذب برای \fBundefined\-loop\-variable\fP هنگامی که بخش \fBelse\fP از یک حلقهٔ
\fBfor\fP استثنا صادر می‌کند (raise) یا مقداری را بازمی‌گرداند (return).
.sp
بسته شد #5971
.IP \(bu 2
رفع مثبت کاذب برای \fBunused\-variable\fP برای کلاس‌های درون توابع
و در مواردی که یک metaclass از طریق یک فراخوانی ارائه شده است.
.sp
بسته شد #4020
.IP \(bu 2
رفع مثبت کاذب برای \fBunsubscriptable\-object\fP در پایتون 3.8 و پایین‌تر برای
دستورهای محافظت‌شده با \fBif TYPE_CHECKING\fP\&.
.sp
بسته شد #3979
.UNINDENT
.SS تازه‌های Pylint 2.13.7 (What\(aqs New in Pylint 2.13.7?)
.sp
تاریخ انتشار: 2022\-04\-20
.INDENT 0.0
.IP \(bu 2
رفع کرش ناشی از استفاده از پیکربندی جدید نسخهٔ 2.14.0 در کدهای 2.13.x.
.sp
بسته شد #6408
.UNINDENT
.SS تازه‌های Pylint 2.13.6 (What\(aqs New in Pylint 2.13.6?)
.sp
تاریخ انتشار: 2022\-04\-20
.INDENT 0.0
.IP \(bu 2
رفع کرش در بررسی‌کنندهٔ \fBunsupported\-membership\-test\fP هنگام انتساب
چندین مقدار ثابت به خصوصیات کلاس از جمله \fB__iter__\fP از طریق تجزیه (unpacking).
.sp
بسته شد #6366
.IP \(bu 2
در مستندسازی پارامترها به سبک Sphinx و Google، دیگر نیازی به ستاره‌ها برای
\fBmissing\-param\-doc\fP نیست و آن‌ها به درستی تجزیه می‌شوند.
.sp
بسته شد #5815
بسته شد #5406
.IP \(bu 2
رفع مثبت کاذب برای \fBunused\-variable\fP هنگامی که به یک شناسهٔ توکارِ مشخص‌شده در
\fB\-\-additional\-builtins\fP، یک نشانه‌گذاری نوع (type annotation) اختصاص داده شده باشد.
.sp
بسته شد #6388
.IP \(bu 2
رفع خطای \fBAstroidError\fP در 2.13.0 که توسط بررسی‌کنندهٔ \fBduplicate\-code\fP در هنگام
فعال بودن \fBignore\-imports\fP یا \fBignore\-signatures\fP رخ می‌داد.
.sp
بسته شد #6301
.UNINDENT
.SS تازه‌های Pylint 2.13.5 (What\(aqs New in Pylint 2.13.5?)
.sp
تاریخ انتشار: 2022\-04\-06
.INDENT 0.0
.IP \(bu 2
رفع پسرفت مثبت کاذب در 2.13.0 برای \fBused\-before\-assignment\fP در مورد
هم‌نامی میان انتساب متغیرها در بلوک‌های try/except و متغیرها در
اندیس‌ها (subscripts) در comprehensionها.
.sp
بسته شد #6069
بسته شد #6136
.IP \(bu 2
بررسی‌کنندهٔ \fBlru\-cache\-decorating\-method\fP به \fBcache\-max\-size\-none\fP تغییر نام یافت و
تنها زمانی صادر خواهد شد که \fBmaxsize\fP برابر با \fBNone\fP باشد.
.sp
بسته شد #6180
.IP \(bu 2
رفع مثبت کاذب برای \fBunused\-import\fP هنگام غیرفعال کردن هم‌زمان \fBused\-before\-assignment\fP و \fBundefined\-variable\fP\&.
.sp
بسته شد #6089
.IP \(bu 2
محدود کردن دامنهٔ بررسی‌کنندهٔ \fBunnecessary\-ellipsis\fP به:
* توابع و کلاس‌هایی که شامل هر دو مورد docstring و ellipsis باشند.
* بدنه‌ای که شامل یک گرهٔ \fBnodes.Expr\fP از نوع ellipsis و حداقل یک دستور دیگر باشد.
.IP \(bu 2
رفع مثبت کاذب برای \fBused\-before\-assignment\fP برای انتساب‌هایی که از طریق
اعلان‌های nonlocal پس از یک نشانه‌گذاری نوع قبلی صورت می‌گیرند.
.sp
بسته شد #5394
.IP \(bu 2
رفع کرش برای \fBredefined\-slots\-in\-subclass\fP هنگامی که نوع slot یک مقدار ثابت (const) یا یک رشته نباشد.
.sp
بسته شد #6100
.IP \(bu 2
ارسال \fBnot\-callable\fP تنها زمانی که هیچ‌یک از مقادیر استنتاج‌شده برای یک ویژگی (property) قابل فراخوانی نباشند.
.sp
بسته شد #5931
.IP \(bu 2
رفع یک منفی کاذب برای \fBsubclassed\-final\-class\fP هنگامی که مجموعه‌ای از پیام‌های دیگر غیرفعال شده بودند.
.UNINDENT.SS چه مواردی در Pylint 2.13.4 جدید است؟
.sp
تاریخ انتشار: 2022\-03\-31
.INDENT 0.0
.IP \(bu 2
رفع پس‌رفت مثبت کاذب در 2.13.0 برای \fBused\-before\-assignment\fP در مواردی که
بین انتساب متغیرها در بلوک‌های try/except و متغیرها در فیلتر یک
comprehension تشابه اسمی وجود داشت.
.sp
بستن #6035
.IP \(bu 2
گنجاندن \fBtesting_pylintrc\fP در توزیع‌های سورس و wheel.
.sp
بستن #6028
.IP \(bu 2
رفع کرش در بررسی‌کنندهٔ \fBsuper\-init\-not\-called\fP هنگام استفاده از \fBctypes.Union\fP\&.
.sp
بستن #6027
.IP \(bu 2
رفع کرش در بررسی‌کنندهٔ \fBunnecessary\-ellipsis\fP هنگامی که از سه‌نقطه (ellipsis) درون یک ظرف (container) یا عبارت lambda استفاده می‌شود.
.sp
بستن #6036
بستن #6037
بستن #6048
.UNINDENT
.SS چه مواردی در Pylint 2.13.3 جدید است؟
.sp
تاریخ انتشار: 2022\-03\-29
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب برای \fBunnecessary\-ellipsis\fP هنگام استفاده از سه‌نقطه (ellipsis) به عنوان آرگومان پیش‌فرض.
.sp
بستن #5973
.IP \(bu 2
رفع کرش مربوط به بازگشایی نامتوازن تاپل (unbalanced tuple unpacking).
.sp
بستن #5998
.IP \(bu 2
رفع مثبت کاذب برای nonexistent\-operator / E0107 \%<#\:nonexistent-operator>\(aq هنگامی که نویسه‌های تکراری \(aq\-\(aq
از هم جدا شده‌اند (مثلاً با پرانتز).
.sp
بستن #5769
.UNINDENT
.SS چه مواردی در Pylint 2.13.2 جدید است؟
.sp
تاریخ انتشار: 2022\-03\-27
.INDENT 0.0
.IP \(bu 2
رفع کرش هنگام ایجاد زیرکلاس از یک \fBnamedtuple\fP\&.
.sp
بستن #5982
.IP \(bu 2
رفع مثبت کاذب برای \fBsuperfluous\-parens\fP در الگوهایی مانند
\(dqreturn (a or b) in iterable\(dq.
.sp
بستن #5803
.IP \(bu 2
رفع پس‌رفت منفی کاذب در نسخه 2.13.0 که در آن \fBprotected\-access\fP برای
توابع صادر نمی‌شد.
.sp
بستن #5989
.IP \(bu 2
پیام‌های خطای بهتر در صورت کرش، هنگامی که pylint قادر به نوشتن الگوی گزارش مشکل نیست.
.sp
ارجاع به #5987
.UNINDENT
.SS چه مواردی در Pylint 2.13.1 جدید است؟
.sp
تاریخ انتشار: 2022\-03\-26
.INDENT 0.0
.IP \(bu 2
رفع یک پس‌رفت در نسخه 2.13.0 که در آن برای استفاده از یک متغیر nonlocal در
یک بلوک try، هشدار \fBused\-before\-assignment\fP صادر می‌شد.
.sp
بستن #5965
.IP \(bu 2
جلوگیری از صدور \fBraising\-bad\-type\fP هنگامی که در استنتاج نوع
متغیری که raise می‌شود ابهام وجود دارد.
.sp
بستن #2793
.IP \(bu 2
کمی انعطاف‌پذیرتر کردن الگوی پیش‌فرض نام TypeVar برای مجاز دانستن نام‌هایی با چندین
نویسهٔ بزرگ؛ مانند \fBHVACModeT\fP یا \fBIPAddressT\fP\&.
.sp
بستن #5981
.IP \(bu 2
رفع مثبت کاذب برای \fBunused\-argument\fP هنگامی که یک نام \fBnonlocal\fP در
تابعی تودرتو استفاده شده که بدون فراخوانی توسط والد خود، بازگردانده می‌شود.
.sp
بستن #5187
.IP \(bu 2
رفع کرش برنامه برای \fBmodified_iterating\-list/set/dict\fP هنگامی که لیست/دیکشنری/مجموعهٔ
در حال پیمایش، یک فراخوانی تابع باشد.
.sp
بستن #5969
.IP \(bu 2
عدم صدور خطاهای \fBbroken\-noreturn\fP و \fBbroken\-collections\-callable\fP
درون بلوک‌های \fBif TYPE_CHECKING\fP\&.
.UNINDENT.SS تازه‌های Pylint 2.13.0 (What\(aqs New in Pylint 2.13.0?)
.sp
تاریخ انتشار: ۲۰۲۲\-۰۳\-۲۴
.INDENT 0.0
.IP \(bu 2
افزودن متدهای داندر (dunder) فراموش‌شده به بررسی \fBunexpected\-special\-method\-signature\fP.
.IP \(bu 2
عدم صدور مجدد \fBno\-member\fP در حلقه‌های for که به \fBself\fP ارجاع دارند، در صورتی که عملیات دودویی آغازکنندهٔ حلقه از یک \fBself\fP کپسوله‌شده در تاپل‌ها یا لیست‌ها استفاده کند.
.sp
Refs pylint\-dev/astroid#1360
Closes #4826
.IP \(bu 2
نمایش پیام خطای بهتر در صورت استفاده از قالب‌های پروندهٔ پشتیبانی‌نشده به همراه \fBpyreverse\fP\&.
.sp
Closes #5950
.IP \(bu 2
اصلاح اعلان نوع (type hinting) در نمودارهای pyreverse برای classmethodها و staticmethodها.
.IP \(bu 2
اصلاح اعلان نوع در نمودارهای pyreverse برای متدهایی که \fBNone\fP برمی‌گردانند.
.IP \(bu 2
اصلاح تطبیق گزینه‌های \fB\-\-notes\fP که به یک نویسهٔ غیرکلمه‌ای ختم می‌شوند.
.sp
Closes #5840
.IP \(bu 2
به‌روزرسانی موقعیت پیام‌ها برای تعاریف کلاس و تابع تا دیگر کل تعریف را در بر نگیرد. اکنون تنها \fBdef\fP یا \fBclass\fP به‌علاوهٔ نام کلاس/تابع پوشش داده می‌شوند.
.sp
Closes #5466
.IP \(bu 2
.INDENT 2.0
.TP
.B شناسه پیام‌های (msgids) \fBusing\-f\-string\-in\-unsupported\-version\fP و \fBusing\-final\-decorator\-in\-unsupported\-version\fP
از \fBW1601\fP و \fBW1602\fP به \fBW2601\fP و \fBW2602\fP تغییر نام یافتند\&. غیرفعال‌سازی با استفاده از این msgidها از کار خواهد افتاد. این کار به منظور برقراری مجدد سازگاری با msgidهای از پیش موجود برای \fBapply\-builtin\fP و \fBbasestring\-builtin\fP از بررسی‌کنندهٔ حذف‌شدهٔ python 3K+ انجام شده است. اکنون بررسی جدیدی وجود دارد تا از msgidها یا نمادهای بررسی‌کننده‌های حذف‌شده استفاده نشود.
.UNINDENT
.sp
Closes #5729
.IP \(bu 2
شماره‌گذاری خطوط برای پیام‌های مربوط به آرگومان‌های توابع اکنون دقیق‌تر شده است. این تغییر ممکن است مستلزم انتقال برخی غیرفعال‌سازی‌های پیام به موقعیت‌های جدید باشد.
.IP \(bu 2
افزودن گزینهٔ \fB\-\-recursive\fP برای امکان‌پذیر ساختن پویش بازگشتی همهٔ ماژول‌ها و بسته‌ها در زیردرخت. اجرای pylint با گزینهٔ \fB\-\-recursive=y\fP همهٔ فایل‌های \fB\&.py\fP کشف‌شده و بسته‌های یافت‌شده در زیردرخت دایرکتوری ارائه‌شده به عنوان پارامتر به pylint را بررسی خواهد کرد.
.sp
Closes #352
.IP \(bu 2
افزودن پیام‌های \fBmodified\-iterating\-list\fP، \fBmodified\-iterating\-dict\fP و \fBmodified\-iterating\-set\fP، که به ترتیب هنگام اضافه یا حذف شدن عناصر از یک لیست، دیکشنری یا مجموعه‌ای که در حال پیمایش است صادر می‌شوند.
.sp
Closes #5348
.IP \(bu 2
رفع منفی کاذب (false\-negative) برای بررسی‌کنندهٔ \fBassignment\-from\-none\fP هنگام استفاده از متد list.sort().
.sp
Closes #5722
.IP \(bu 2
افزونهٔ جدید \fBimport\-private\-name\fP: نشان دادن درون‌ریزی بسته‌ها و شیءهای خصوصی خارجی (دارای پیشوند \fB_\fP). این افزونه با استفاده از \fBload\-plugins=pylint.extensions.private_import\fP قابل بارگیری است\&.
.sp
Closes #5463
.IP \(bu 2
رفع فروپاشی ناشی از \fBarguments\-differ\fP و \fBarguments\-renamed\fP هنگامی که متدها خارج از سطح بالای یک کلاس تعریف شده بودند.
.sp
Closes #5648
.IP \(bu 2
حذف افزونهٔ منسوخ‌شدهٔ \fBcheck_docs\fP. می‌توانید برای دسترسی به بررسی‌هایی که پیش‌تر در \fBcheck_docs\fP گنجانده شده بودند، از بررسی‌کنندهٔ \fBdocparams\fP استفاده کنید\&.
.sp
Closes #5322
.IP \(bu 2
افزودن نیازمندی اختیاری \fBtestutil\fP به بسته‌بندی؛ از آنجا که \fBgitpython\fP نباید همواره یک وابستگی باشد اما همچنان برای استفاده از کد کمکی primer در \fBpylint.testutil\fP لازم است. می‌توانید آن را با \fBpip install pylint[testutil]\fP نصب کنید\&.
.sp
Closes #5486
.IP \(bu 2
بازگردانی بررسی‌های مربوط به بررسی‌کنندهٔ python3 که هنوز برای پایتون ۳ مفید هستند (\fBeq\-without\-hash\fP). این مورد اکنون در افزونهٔ اختیاری \fBpylint.extensions.eq_without_hash\fP قرار دارد.
.sp
Closes #5025
.IP \(bu 2
رفع مشکلی که در آن \fBungrouped\-imports\fP بدون ایجاد \fBuseless\-suppression\fP قابل غیرفعال‌سازی نبود\&.
.sp
Refs #2366
.IP \(bu 2
افزودن چندین بررسی‌کننده برای مقابله با مسائل امنیتی یونی‌کد (برای جزئیات به Trojan Sources \%<https://\:trojansource\:.codes> و PEP 672 \%<https://\:peps\:.python\:.org/\:pep-0672> مراجعه کنید) که خوانایی کد را نیز تحت تأثیر قرار می‌دهند. به‌طور خاص، بررسی‌های زیر اضافه شدند:
.INDENT 2.0
.IP \(bu 2
بررسی‌کنندهٔ \fBbad\-file\-encoding\fP بررسی می‌کند که پرونده طبق پیشنهاد PEP8 \%<https://\:peps\:.python\:.org/\:pep-0008/#\:source-file-encoding> با کدگذاری UTF\-8 ذخیره شده باشد\&. کدگذاری‌های UTF\-16 و UTF\-32 در حال حاضر توسط پایتون \%<https://\:bugs\:.python\:.org/\:issue1503789> پشتیبانی نمی‌شوند. در صورت تغییر این وضعیت، \fBinvalid\-unicode\-codec\fP اطمینان حاصل می‌کند که برای حفظ سازگاری رو به عقب، از آن‌ها استفاده نشود.
.IP \(bu 2
بررسی‌کنندهٔ \fBbidirectional\-unicode\fP نویسه‌های دوسویهٔ یونی‌کد را بررسی می‌کند که می‌توانند باعث شوند نحوهٔ اجرای کد با آنچه کاربر انتظار دارد متفاوت باشد.
.IP \(bu 2
بررسی‌های \fBinvalid\-character\-backspace\fP، \fBinvalid\-character\-carriage\-return\fP، \fBinvalid\-character\-sub\fP، \fBinvalid\-character\-esc\fP، \fBinvalid\-character\-zero\-width\-space\fP و \fBinvalid\-character\-nul\fP برای بررسی نویسه‌های بدون گریز (unescaped) بالقوه آسیب‌رسان.
.UNINDENT
.sp
Closes #5281
.IP \(bu 2
استفاده از بستهٔ \fBtomli\fP به جای \fBtoml\fP برای تجزیهٔ فایل‌های \fB\&.toml\fP.
.sp
Closes #5885
.IP \(bu 2
رفع مثبت کاذب \- مجاز دانستن باز کردن (unpacking) متغیر \fBself\fP در زیرکلاس‌هایی از \fBtyping.NamedTuple\fP\&.
.sp
Closes #5312
.IP \(bu 2
رفع منفی کاذب \fBunpacking\-non\-sequence\fP هنگامی که مقدار یک لیست خالی است.
.sp
Closes #5707
.IP \(bu 2
پیام‌های هشدار بهتر برای else یا elif بی‌اثر هنگامی که یک تابع زودتر از موعد مقدار بازمی‌گرداند.
.sp
Closes #5614
.IP \(bu 2
رفع مثبت کاذب \fBconsider\-using\-dict\-comprehension\fP هنگام ایجاد دیکشنری با فهرستی از تاپل‌ها که در آن هم کلید و هم مقدار بر اساس یک شرط یکسان تغییر می‌کنند.
.sp
Closes #5588
.IP \(bu 2
رفع مثبت کاذب برای \fBglobal\-variable\-undefined\fP هنگامی که \fBglobal\fP همراه با نام یک کلاس استفاده می‌شود.
.sp
Closes #3088
.IP \(bu 2
رفع مثبت کاذب برای \fBunused\-variable\fP هنگامی که یک نام \fBnonlocal\fP به عنوان بخشی از یک انتساب چندنامی (multi\-name assignment) مقداردهی می‌شود.
.sp
Closes #3781
.IP \(bu 2
رفع فروپاشی در بررسی‌کنندهٔ \fBunspecified\-encoding\fP هنگام ارسال \fBNone\fP به آرگومان \fBmode\fP در فراخوانی تابع \fBopen()\fP.
.sp
Closes #5731
.IP \(bu 2
رفع فروپاشی مرتبط با \fBNewType\fP که با یک f\-string نام‌گذاری شده بود.
.sp
Closes #5770
Ref pylint\-dev/astroid#1400
.IP \(bu 2
بهبود پیام \fBbad\-open\-mode\fP هنگام ارسال \fBNone\fP به آرگومان \fBmode\fP در فراخوانی تابع \fBopen()\fP.
.sp
Closes #5733
.IP \(bu 2
افزودن بررسی‌کنندهٔ \fBlru\-cache\-decorating\-method\fP برای بررسی استفاده از \fBfunctools.lru_cache\fP روی متدهای کلاس. این کار توصیه نمی‌شود چرا که با ممانعت دائمی از جمع‌آوری زبالهٔ نمونه (garbage collection)، باعث نشت حافظه می‌گردد.
.sp
Closes #5670
.IP \(bu 2
رفع فروپاشی همراه با خطای بازگشت (recursion error) هنگام استنتاج صفت‌های کلاسی که به خود کلاس ارجاع داشتند.
.sp
Closes #5408
Ref pylint\-dev/astroid#1392
.IP \(bu 2
رفع مثبت کاذب برای \fBunused\-argument\fP هنگامی که یک متد بازنویسی‌شده در زیرکلاس، کاری با مقدار یک آرگومان صرفاً کلیدواژه‌ای انجام نمی‌دهد.
.sp
Closes #5771
Ref pylint\-dev/astroid#1382
.IP \(bu 2
الگوی گزارش مشکل (issue template) فروپاشی اکنون برای خرابی‌هایی که پیش‌تر تحت پوشش این سازوکار نبودند ایجاد می‌شود..sp
بستن #5668
.IP \(bu 2
.INDENT 2.0
.TP
.B بازنویسی بررسی‌کننده برای \fBnon\-ascii\-name\fP\&.
اکنون اطمینان حاصل می‌کند که تمام نام‌های پایتون ASCII هستند و همچنین نام‌های واردات (\fBnon\-ascii\-module\-import\fP) و همچنین نام فایل‌ها (\fBnon\-ascii\-file\-name\fP) را به درستی بررسی کرده و هشدارهای جدید مربوط به آن‌ها را صادر می‌کند.
.sp
نویسه‌های غیر ASCII می‌توانند هوموگلیف (نویسه‌های هم‌شکل) باشند و وارد کردن آن‌ها با صفحه‌کلید غیرتخصصی دشوار باشد.
بخش نویسه‌های گیج‌کننده (Confusable Characters) را در PEP 672 ببینید: \%<https://\:peps\:.python\:.org/\:pep-0672/#\:confusable-characters-in-identifiers>
.UNINDENT
.IP \(bu 2
هنگام اجرا در حالت موازی، \fBpylint\fP اکنون داده‌های منتقل‌شده به زیرفرایندها را با بسته‌ی \fBdill\fP سریال‌سازی (pickle) می‌کند. بنابراین بسته \fBdill\fP به عنوان یک وابستگی افزوده شده است.
.IP \(bu 2
مشکلی در astroid که در آن پیوندهای نمادین (symlinks) در نظر گرفته نمی‌شدند، برطرف شد
.sp
بستن #1470
بستن #3499
بستن #4302
بستن #4798
بستن #5081
.IP \(bu 2
رفع فروپاشی (crash) در بررسی‌کننده \fBunused\-private\-member\fP هنگام تحلیل کدهایی که از \fBtype(self)\fP در متدهای متصل (bound methods) استفاده می‌کنند.
.sp
بستن #5569
.IP \(bu 2
بهینه‌سازی تجزیه خطوط طولانی زمانی که \fBmissing\-final\-newline\fP فعال است.
.sp
بستن #5724
.IP \(bu 2
رفع مثبت‌های کاذب برای \fBused\-before\-assignment\fP ناشی از استفاده از عبارت‌های نام‌گذاری‌شده در شرط عملگر سه‌تایی و استفاده از آن عبارت به عنوان آرگومان فراخوانی.
.sp
بستن #5177, #5212
.IP \(bu 2
رفع مثبت کاذب برای \fBundefined\-variable\fP هنگامی که مشخصه‌های کلاس \fBnamedtuple\fP به عنوان حاشیه‌نویسی بازگشت استفاده می‌شوند.
.sp
بستن #5568
.IP \(bu 2
رفع منفی کاذب برای \fBundefined\-variable\fP و پیام‌های متغیر مرتبط، زمانی که همان متغیر تعریف‌نشده به عنوان حاشیه‌نویسی نوع استفاده شده و چندین بار به آن دسترسی پیدا می‌شود، یا به عنوان آرگومان پیش‌فرض یک تابع به کار می‌رود.
.sp
بستن #5399
.IP \(bu 2
Pyreverse \- افزودن خروجی در قالب mermaidjs
.IP \(bu 2
صدور \fBused\-before\-assignment\fP به جای \fBundefined\-variable\fP هنگام تلاش برای دسترسی به حاشیه‌نویسی‌های نوع استفاده‌نشده.
.sp
بستن #5713
.IP \(bu 2
افزودن سطح اطمینان \fBCONTROL_FLOW\fP برای هشدارهایی که به فرضیاتی درباره جریان کنترل (control flow) متکی هستند.
.IP \(bu 2
\fBused\-before\-assignment\fP اکنون این احتمال را در نظر می‌گیرد که ممکن است هنگام اجرای بلوک‌های except یا finally، انتساب‌ها در بلوک try رخ نداده باشند.
.sp
بستن #85, #2615
.IP \(bu 2
رفع منفی کاذب برای \fBused\-before\-assignment\fP هنگامی که یک عبارت شرطی یا مدیر زمینه (context manager) پیش از دستور try مداخله می‌کرد و نشان می‌داد ممکن است با شکست مواجه شود.
.sp
بستن #4045
.IP \(bu 2
رفع منفی کاذب برای \fBused\-before\-assignment\fP در بلوک‌های finally چنانچه یک کنترل‌کننده except انتسابی را که ممکن بود در بلوک try شکست خورده باشد، تعریف نکرده بود.
.IP \(bu 2
رفع پردازش بسیار طولانی خطوط بلند حاوی ویرگول (\(aq,\(aq).
.sp
بستن #5483
.IP \(bu 2
رفع فروپاشی در مشخصه‌ها (properties) و متدهای کلاسی به ارث‌رسیده هنگام مقایسه برابری آن‌ها با یک دیکشنری خالی.
.sp
بستن #5646
.IP \(bu 2
رفع یک مثبت کاذب برای \fBassigning\-non\-slot\fP هنگامی که کلاس دارای اسلات \fB__setattr__\fP را تعریف کرده بود.
.sp
بستن #3793
.IP \(bu 2
رفع یک مثبت کاذب برای \fBinvalid\-class\-object\fP هنگامی که شیء در حال انتساب به مشخصه \fB__class__\fP غیرقابل استنتاج باشد.
.IP \(bu 2
رفع مثبت کاذب برای \fBused\-before\-assignment\fP در حاشیه‌نویسی نوع خودارجاعی در دستورهای شرطی درون متدهای کلاس.
.sp
بستن #5499
.IP \(bu 2
افزودن بررسی‌کننده \fBredefined\-slots\-in\-subclass\fP: زمانی صادر می‌شود که یک slot در یک زیرکلاس بازتعریف شود.
.sp
بستن #5617
.IP \(bu 2
رفع مثبت کاذب برای \fBglobal\-variable\-not\-assigned\fP هنگام استفاده از دستور \fBdel\fP
.sp
بستن #5333
.IP \(bu 2
به طور پیش‌فرض، pylint دیگر فایل‌هایی را که با \fB\&.#\fP شروع می‌شوند در نظر نمی‌گیرد. این فایل‌ها به عنوان \fBقفل‌های فایل Emacs\fP در نظر گرفته می‌شوند. ببینید:
\%<https://\:www\:.gnu\:.org/\:software/\:emacs/\:manual/\:html_node/\:elisp/\:File-Locks\:.html>\&.
این رفتار را می‌توان با بازتعریف گزینه \fBignore\-patterns\fP تغییر داد.
.sp
بستن #367
.IP \(bu 2
رفع یک مثبت کاذب برای \fBused\-before\-assignment\fP هنگامی که یک عبارت نام‌گذاری‌شده به عنوان اولین مقدار در یک ظرف (container) ظاهر می‌شود.
.sp
بستن #5112
.IP \(bu 2
\fBused\-before\-assignment\fP اکنون فرض می‌کند که انتساب‌ها در بلوک‌های except ممکن است رخ نداده باشند و بر این اساس هشدار می‌دهد.
.sp
بستن #4761
.IP \(bu 2
هنگام ارزیابی دستورهای بعد از یک بلوک except، \fBused\-before\-assignment\fP فرض می‌کند که در صورت وجود دستور return در بلوک try مربوطه، انتساب‌های درون بلوک‌های except انجام شده‌اند.
.sp
بستن #5500
.IP \(bu 2
رفع یک منفی کاذب برای \fBused\-before\-assignment\fP زمانی که برخی از کنترل‌کننده‌های except (و نه همه آن‌ها) نامی را تعریف کرده بودند که بعد از یک بلوک except به آن اتکا شده بود در حالی که بلوک try مربوطه حاوی یک دستور return بود.
.sp
بستن #5524
.IP \(bu 2
هنگام ارزیابی دستورها در بند \fBelse\fP یک حلقه، \fBused\-before\-assignment\fP فرض می‌کند که اگر کنترل‌کننده‌های except تنها راه‌های اتمام حلقه بدون خروج زودهنگام (break) باشند، انتساب‌های درون بلوک‌های except انجام شده‌اند.
.sp
بستن #5683
.IP \(bu 2
\fBused\-before\-assignment\fP اکنون نام‌ها را در بلوک‌های try بررسی می‌کند.
.IP \(bu 2
رفع مثبت کاذب در \fBused\-before\-assignment\fP برای عبارت‌های انتساب در دستورهای lambda.
.sp
بستن #5360, #3877
.IP \(bu 2
رفع یک مثبت کاذب (مربوط به نسخه توسعه‌یافته منتشرنشده) برای \fBused\-before\-assignment\fP شامل نام‌های همسان میان comprehensionهای فیلترشده و انتساب‌ها در بلوک‌های except.
.sp
بستن #5586
.IP \(bu 2
رفع فروپاشی در انتساب‌های slots و انتساب‌های حاشیه‌نویسی‌شده.
.sp
بستن #5479
.IP \(bu 2
رفع فروپاشی در list comprehensionهایی که از \fBtype\fP به عنوان نام متغیر درونی استفاده می‌کردند.
.sp
بستن #5461
.IP \(bu 2
رفع فروپاشی در بررسی‌کننده \fBuse\-maxsplit\-arg\fP هنگام ارائه آرگومان \fBsep\fP به \fBstr.split()\fP از طریق کلیدواژه.
.sp
بستن #5737
.IP \(bu 2
رفع مثبت کاذب برای \fBunused\-variable\fP برای متغیر comprehension که با حاشیه‌نویسی نوع در حوزه بیرونی مطابقت داشت.
.sp
بستن #5326
.IP \(bu 2
رفع منفی کاذب برای \fBundefined\-variable\fP برای متغیری که چندین بار در یک comprehension استفاده شده و با یک حاشیه‌نویسی نوع استفاده‌نشده در حوزه بیرونی مطابقت دارد.
.sp
بستن #5654
.IP \(bu 2
برخی از فایل‌ها در \fBpylint.testutils\fP منسوخ شده‌اند. در آینده وارد کردن‌ها (imports) باید مستقیماً از فضای نام \fBpylint.testutils.functional\fP انجام شوند..IP \(bu 2
رفع مثبت‌های کاذب برای \fBno\-value\-for\-parameter\fP هنگام استفاده از آرگومان‌های مکانی با تعداد متغیر.
.sp
بسته شدن #5416
.IP \(bu 2
تابع \fBsafe_infer\fP دیگر در صورت دریافت دو تعریف تابع با تعداد آرگومان‌های متفاوت، استنتاجی انجام نمی‌دهد.
.sp
بسته شدن #3675
.IP \(bu 2
رفع مثبت کاذب \fBcomparison\-with\-callable\fP برای فراخوان‌پذیرهایی که استثنا پرتاب می‌کنند، مانند ثابت‌های typing.
.sp
بسته شدن #5557
.IP \(bu 2
رفع خرابی در گره‌های \fB__init__\fP زمانی که ویژگی به دلیل محدودیت اندازه حافظه موقت (cache limit size) از قبل غیرقابل‌استنتاج بود. این محدودیت می‌تواند هنگامی رخ دهد که الگوی وراثت یک کلاس (و در نتیجه ویژگی \fB__init__\fP آن) بسیار بزرگ باشد.
.sp
بسته شدن #5679
.IP \(bu 2
رفع مثبت کاذب برای \fBused\-before\-assignment\fP ناشی از تعریف کلاسی تو‌در‌تو درون یک تابع که از کلاسی تعریف‌شده در خارج تابع ارث‌بری می‌کند.
.sp
بسته شدن #4590
.IP \(bu 2
رفع مثبت کاذب \fBunnecessary_dict_index_lookup\fP هنگام حذف یک مدخل از دیکشنری.
.sp
بسته شدن #4716
.IP \(bu 2
رفع مثبت کاذب برای \fBused\-before\-assignment\fP هنگامی که یک گردانندهٔ except نام مشترکی با یک شرط در یک comprehension فیلترشده دارد.
.sp
بسته شدن #5817
.IP \(bu 2
رفع خرابی در بررسی‌کنندهٔ \fBunnecessary\-dict\-index\-lookup\fP در صورتی که خروجی \fBitems()\fP به یک تاپل تک‌عنصری (1\-tuple) انتساب داده شود.
.sp
بسته شدن #5504
.IP \(bu 2
هنگام فراخوانی \fBpylint\fP، \fBepylint\fP، \fBsymilar\fP یا \fBpyreverse\fP با وارد کردن (import) آن‌ها در یک فایل پایتون، اکنون علاوه بر وصله‌کردن \fBsys.argv\fP، می‌توانید کلمه‌کلیدی \fBargv\fP را نیز ارسال کنید\&.
.sp
بسته شدن #5320
.IP \(bu 2
کلاس \fBPyLinter\fP اکنون در صورت عدم ارائهٔ گزارشگر، با یک \fBTextReporter\fP به عنوان گزارشگر خود راه‌اندازی می‌شود.
.IP \(bu 2
رفع \fBsuper\-init\-not\-called\fP زمانی که والد یا \fBself\fP یک \fBProtocol\fP باشد.
.sp
بسته شدن #4790
.IP \(bu 2
رفع مثبت کاذب \fBnot\-callable\fP برای ویژگی‌هایی که نام مستعار \fBNamedTuple\fP هستند.
.sp
رفع بخشی از #1730
.IP \(bu 2
ارسال \fBredefined\-outer\-name\fP زمانی که یک گردانندهٔ except تودرتو، گردانندهٔ بیرونی را می‌پوشاند.
.sp
بسته شدن #4434
بسته شدن #5370
.IP \(bu 2
رفع مثبت کاذب \fBsuper\-init\-not\-called\fP برای کلاس‌هایی که متد \fBinit\fP خود را از یک والد به ارث می‌برند.
.sp
بسته شدن #4941
.IP \(bu 2
اکنون می‌توان \fBencoding\fP را به عنوان یک آرگومان مکانی به فراخوانی‌های بازکنندهٔ فایل ارسال کرد بدون اینکه \fBunspecified\-encoding\fP فعال شود\&.
.sp
بسته شدن #5638
.IP \(bu 2
خطاهای مهلک (fatal) اکنون صرف‌نظر از اینکه پودمان بازبینی‌شده حاوی دستوری باشد یا خیر، امتیاز 0.0 صادر می‌کنند.
.sp
بسته شدن #5451
.IP \(bu 2
متغیر \fBfatal\fP به متغیرهای مجاز در عبارت‌های ارزیابی امتیاز افزوده شد.
.IP \(bu 2
ارزیابی پیش‌فرض امتیاز اکنون از کف 0 استفاده می‌کند.
.sp
بسته شدن #2399
.IP \(bu 2
رفع منفی کاذب برای \fBconsider\-iterating\-dictionary\fP در حین بررسی‌های عضویتِ محصور در اشیای تکرارپذیر (iterables) یا بررسی‌های \fBnot in\fP.
.sp
بسته شدن #5323
.IP \(bu 2
رفع خرابی ناشی از دکوراتورهای غیرقابل‌استنتاج در Python 3.6 و 3.7.
.IP \(bu 2
افزودن بررسی‌کنندهٔ \fBunnecessary\-ellipsis\fP: زمانی صادر می‌شود که ثابت سه‌نقطه (ellipsis) به‌طور غیرضروری استفاده شود.
.sp
بسته شدن #5460
.IP \(bu 2
غیرفعال‌سازی بررسی‌کنندهٔ \fBbad\-docstring\-quotes\fP برای Python <= 3.7، زیرا در این نسخه‌ها شماره خطوط توابع و کلاس‌های دکوره‌شده قابل‌اعتماد نیست که این امر در عملکرد بررسی‌کننده اختلال ایجاد می‌کند.
.sp
بسته شدن #3077
.IP \(bu 2
رفع طبقه‌بندی نادرست docstringهای سبک Numpy به عنوان docstringهای سبک Google برای docstringهای حاوی مستندات setter ویژگی (property).
طبقه‌بندی docstring اکنون بر اساس بیشترین تعداد بخش‌های مطابقت‌یافته انجام می‌شود، نه بر اساس ترتیبی که سبک‌های docstring بررسی می‌شدند.
.IP \(bu 2
رفع تشخیص \fBarguments\-differ\fP هنگامی که متدهای ایستای ابرکلاس فاقد دکوراتور \fB@staticmethod\fP بودند.
.sp
بسته شدن #5371
.IP \(bu 2
\fBTypingChecker\fP
.INDENT 2.0
.IP \(bu 2
افزودن بررسی جدید \fBbroken\-noreturn\fP برای تشخیص استفاده‌های معیوب از \fBtyping.NoReturn\fP در صورتی که \fBpy\-version\fP روی Python \fB3.7.1\fP یا پایین‌تر تنظیم شده باشد.
\%<https://\:bugs\:.python\:.org/\:issue34921>
.IP \(bu 2
افزودن بررسی جدید \fBbroken\-collections\-callable\fP برای تشخیص استفاده‌های معیوب از \fBcollections.abc.Callable\fP در صورتی که \fBpy\-version\fP روی Python \fB3.9.1\fP یا پایین‌تر تنظیم شده باشد.
\%<https://\:bugs\:.python\:.org/\:issue42965>
.UNINDENT
.IP \(bu 2
بخش \fBtestutils\fP برای آزمون‌های واحد (unittests) اکنون \fBend_lineno\fP و \fBend_column\fP را می‌پذیرد\&. آزمون‌های فاقد این موارد موجب صدور \fBDeprecationWarning\fP خواهند شد\&.
.IP \(bu 2
\fBarguments\-differ\fP دیگر از بازتعریف متدهایی با پارامترهای اضافی دارای مقادیر پیش‌فرض ایراد نمی‌گیرد.
.sp
بسته شدن #1556، #5338
.IP \(bu 2
رفع مثبت کاذب \fBunexpected\-keyword\-arg\fP برای دکوراتورها.
.sp
بسته شدن #258
.IP \(bu 2
وارد کردن پودمان منسوخ کتابخانه استاندارد \fBxml.etree.cElementTree\fP اکنون \fBdeprecated_module\fP را صادر می‌کند\&.
.sp
بسته شدن #5862
.IP \(bu 2
دستورهای غیرفعال‌سازی برای \fBdeprecated\-module\fP و هشدارهای مشابه مربوط به ویژگی‌های کتابخانه استاندارد که در نسخه‌های جدیدتر پایتون منسوخ شده‌اند، هنگام تحلیل با مفسرهای قدیمی‌تر پایتون که آن ویژگی‌ها در آن‌ها هنوز منسوخ نشده‌اند، دیگر باعث برانگیخته شدن \fBuseless\-suppression\fP نمی‌شوند.
.IP \(bu 2
وارد کردن پودمان منسوخ کتابخانه استاندارد \fBdistutils\fP اکنون در Python 3.10+ هشدار \fBdeprecated_module\fP را صادر می‌کند.
.IP \(bu 2
بررسی‌کنندهٔ \fBmissing\-raises\-doc\fP اکنون سلسله‌مراتب کلاسیِ استثناهای پرتاب‌شده را بررسی می‌کند
.INDENT 2.0
.INDENT 3.5
.sp
.EX
def my_function():
  \(dq\(dq\(dqMy function.

  Raises:
    Exception: if something fails
  \(dq\(dq\(dq
  raise ValueError
.EE
.UNINDENT
.UNINDENT
.sp
بسته شدن #4955
.IP \(bu 2
غیرفعال‌سازی بررسی املای نام قوانین mypy در دستورالعمل‌های ignore.
.sp
بسته شدن #5929
.IP \(bu 2
امکان غیرفعال‌سازی \fBduplicate\-code\fP با استفاده از یک توضیح (comment) غیرفعال‌سازی هنگام اجرا از طریق pylint.
.sp
بسته شدن #214
.IP \(bu 2
بهبود بررسی \fBinvalid\-name\fP برای نام‌های \fBTypeVar\fP.
الگوی پذیرفته‌شده را می‌توان با \fB\-\-typevar\-rgx\fP سفارشی‌سازی کرد\&.
.sp
بسته شدن #3401
.IP \(bu 2
افزودن بررسی‌کنندهٔ جدید \fBtypevar\-name\-missing\-variance\fP\&. زمانی صادر می‌شود که یک \fBTypeVar\fP هم‌وردا (covariant) یا پادوردا (contravariant) به‌ترتیب با \fB_co\fP یا \fB_contra\fP خاتمه نیابد یا زمانی که یک \fBTypeVar\fP هیچ‌یک از این دو نباشد اما دارای پسوند باشد.
.IP \(bu 2
امکان استفاده از انتشار 0.7.x بسته mccabe.
.sp
بسته شدن #5878.IP \(bu 2
رفع مثبت کاذب \fBunused\-private\-member\fP هنگام دسترسی به متدهای خصوصی از طریق \fBproperty\fP\&.
.sp
بسته شدن #4756
.UNINDENT
.SS "تازه‌های Pylint 2.12 (What\(aqs New in Pylint 2.12)"
.sp
از آغاز کار pylint تا نسخهٔ 2.14.0 (شامل این نسخه)، ما گزارش تغییراتی داشتیم که شامل \fIتمام\fP
تغییرات غیرجزئی Pylint می‌شد؛ از جمله تغییراتی که
کاربر با آن‌ها مواجه نمی‌شد، یعنی تغییراتی که ممکن بود تنها در صورتی برای شما جالب باشد که توسعه‌دهنده‌ای
باشید که روی pylint یا افزونه‌های pylint کار می‌کند یا یک تاریخ‌نگار پروژه‌های متن‌باز.
.sp
از pylint نسخهٔ 1.6.0 تا 2.14.0، علاوه بر گزارش تغییرات کامل، خلاصه‌ای از
تغییرات (عمدتاً مرتبط با کاربر) نیز وجود داشت.
.SS "خلاصه \-\- نکات برجسته نسخه (Summary \-\- Release highlights)"
.sp
در نسخهٔ 2.12، ما گزینهٔ جدید \fBpy\-version\fP را معرفی کردیم که امکان تحلیل کد را برای نسخه‌ای از python
فراهم می‌کند که ممکن است با مفسر فعلی python شما متفاوت باشد. این ویژگی بر همهٔ بررسی‌کننده‌ها اثر نمی‌گذارد اما
به عنوان مثال اجازه می‌دهد بوی بد کد پایتون 3.5 (استفاده از f\-stringها) را هنگام استفاده از pylint با پایتون 3.6 بررسی کنید.
حداقل نسخه برای اجرای pylint اکنون 3.6.2 است، در حالی که آخرین نسخهٔ کارآمد برای پایتون 3.6.0
و 3.6.1، نسخهٔ pylint 2.9.3 بود.
.sp
علاوه بر رفع تعداد زیادی از مثبت‌های کاذب و باگ‌ها، بررسی‌های پیش‌فرض جدیدی را نیز اضافه کردیم، مانند
\fBuse\-implicit\-booleaness\-not\-comparison\fP، \fBoverridden\-final\-method\fP و \fBuseless\-with\-lock\fP\&.
همچنین بررسی بهتری برای پیکربندی‌های TOML افزوده شده است.
.sp
در نهایت، علاوه بر اطلاعاتی که از قبل در مورد خط شروع و ستون شروع داشتیم،
اطلاعات جدیدی دربارهٔ خط پایان و ستون پایان پیام‌ها معرفی کردیم. این کار
امکان داشتن نشانه‌های بصری دقیق‌تری را در IDEهایی مانند افزونهٔ pylint برای vs\-code فراهم می‌کند. حالت پیش‌فرض
به منظور حفظ سازگاری دست‌نخورده باقی خواهد ماند، اما با افزودن \fBend_line\fP
و \fBend_column\fP به گزینهٔ \fB\-\-msg\-template\fP قابل دریافت است. برای نتیجهٔ بهتر از python 3.8 به بالا استفاده کنید.
.sp
بررسی‌کننده برای Yoda conditions اکنون یک افزونه است؛ اگر به این بررسی اتکا
داشته‌اید، ممکن است بخواهید آن را فعال کنید. همچنین یک بررسی‌کنندهٔ افزونه جدید به نام \fBconsider\-using\-any\-or\-all\fP وجود دارد که
حلقه‌های for قابل جایگزینی با any یا all را تشخیص می‌دهد؛ این ویژگی تماماً توسط @areveny مشارکت شده است،
به تیم خوش آمدید!
.SS "بررسی‌کننده‌های جدید (New checkers)"
.INDENT 0.0
.IP \(bu 2
بررسی‌کنندهٔ \fBmissing\-any\-param\-doc\fP اضافه شد که وقتی تابعی نه برای پارامترها و نه برای نوع پارامترها مستندسازی
نداشته باشد فعال می‌شود. پارامترهای فاقد مستندات اکنون به درستی شناسایی می‌شوند. اگر \fBmissing\-param\-doc\fP
و \fBmissing\-type\-doc\fP غیرفعال شده بودند، ممکن است هشداری به طور غیرمنتظره ظاهر شود، زیرا پیام جدید
\fBmissing\-any\-param\-doc\fP به جای آن‌ها صادر خواهد شد.
.sp
بسته شدن #3799
.UNINDENT
.SS "typing.final"
.INDENT 0.0
.IP \(bu 2
افزودن \fBoverridden\-final\-method\fP: هنگامی صادر می‌شود که متدی که با \fBtyping.final\fP نشانه‌گذاری شده، رونویسی (override) شود
.IP \(bu 2
افزودن \fBsubclassed\-final\-class\fP: هنگامی صادر می‌شود که از کلاسی که با \fBtyping.final\fP نشانه‌گذاری شده، زیرکلاس ایجاد شود
.sp
بسته شدن #3197
.IP \(bu 2
ایجاد کلاس بررسی‌کننده جدید \fBUnsupportedVersionChecker\fP که شامل بررسی‌هایی برای قابلیت‌های
پشتیبانی‌نشده توسط تمام نسخه‌های مشخص‌شده با \fBpy\-version\fP است\&.
.INDENT 2.0
.IP \(bu 2
افزودن بررسی‌کنندهٔ \fBusing\-f\-string\-in\-unsupported\-version\fP. زمانی صادر می‌شود که \fBpy\-version\fP
روی نسخه‌ای تنظیم شده باشد که از f\-stringها پشتیبانی نمی‌کند (< 3.6)
.UNINDENT
.IP \(bu 2
افزودن بررسی‌کنندهٔ جدید \fBuse\-implicit\-booleaness\-not\-comparison\fP: زمانی صادر می‌شود که
از مقایسه لیترال مجموعه‌ها برای بررسی خالی بودن استفاده شود.
.sp
بسته شدن #4774
.IP \(bu 2
افزودن بررسی‌کنندهٔ \fBusing\-final\-decorator\-in\-unsupported\-version\fP. زمانی صادر می‌شود که \fBpy\-version\fP
روی نسخه‌ای تنظیم شده باشد که از typing.final پشتیبانی نمی‌کند (< 3.8)
.IP \(bu 2
افزودن بررسی‌کنندهٔ جدید \fBuseless\-with\-lock\fP برای یافتن استفاده‌های نادرست از عبارت with و قفل‌های ماژول threading.
زمانی صادر می‌شود که \fBwith threading.Lock():\fP به جای \fBwith lock_instance:\fP استفاده شود\&.
.sp
بسته شدن #5208
.IP \(bu 2
بررسی‌کنندهٔ جدید \fBbad\-configuration\-section\fP اضافه شد که برای گزینه‌های نابجا
در فضای نام سطح بالایی pylint در پیکربندی toml هشدار صادر می‌کند. دیکشنری‌های سطح بالا یا گزینه‌های تعریف‌شده
در بخش اشتباه همچنان بدون هیچ هشداری نادیده گرفته خواهند شد، که این موضوع در یک مورد پیگیری دنبال می‌شود.
.sp
پیگیری در #5259
.IP \(bu 2
کلاس \fBMessageTest\fP از \fBtestutil\fP مربوط به unittest اکنون مستلزم آن است که صفت \fBconfidence\fP
با مقدار مورد انتظار مطابقت داشته باشد. در صورت مشخص نشدن، روی \fBUNDEFINED\fP تنظیم می‌شود\&.
.IP \(bu 2
تابع \fBadd_message\fP از \fBtestutil\fP مربوط به unittest اکنون پارامتر \fBcol_offset\fP را پردازش کرده
و امکان بررسی آن را در برابر خروجی واقعی در یک آزمون فراهم می‌کند.
.UNINDENT.SS "افزونه‌ها (Extensions)"
.INDENT 0.0
.IP \(bu 2
افزونه اختیاری \fBconsider\-using\-any\-or\-all\fP افزوده شد: زمانی صادر می‌شود که یک حلقه \fBfor\fP فقط مقدار بولی تولید کند و بتوان آن را با استفاده از یک مولد (generator) با \fBany\fP یا \fBall\fP جایگزین کرد. همچنین در صورت مختصر بودن، عبارت any/all مناسب را پیشنهاد می‌دهد.
.sp
بسته شدن #5008
.IP \(bu 2
انتقال \fBmisplaced\-comparison\-constant\fP به افزونه اختصاصی خود \fBcomparison_placement\fP\&. این بازبین دارای سوگیری (opinionated) بود و اکنون دیگر یک پیش‌فرض نیست. می‌توان آن را با افزودن \fBpylint.extensions.comparison_placement\fP به \fBload\-plugins\fP در پیکربندی خود دوباره فعال کرد.
.sp
بسته شدن #1064
.UNINDENT
.SS "سایر تغییرات (Other Changes)"
.INDENT 0.0
.IP \(bu 2
اصلاح پیام \fBinstall graphiz\fP که برای قالب خروجی puml مورد نیاز نیست.
.IP \(bu 2
\fBpylint\fP دیگر هنگام بررسی عبارت‌های انتساب درون دستورهای if دچار فروپاشی (crash) نمی‌شود.
.sp
بسته شدن #5178
.IP \(bu 2
افزودن گزینه پیکربندی \fBexclude\-too\-few\-public\-methods\fP جهت اجازه به مستثنی کردن کلاس‌ها از بازبین \fBmin\-public\-methods\fP\&.
.sp
بسته شدن #3370
.IP \(bu 2
اصلاح \fBaccept\-no\-yields\-doc\fP و \fBaccept\-no\-return\-doc\fP که در زمان درست بودنِ بخشی از یک docstring، اجازه مفقود بودن مستندات \fByield\fP یا \fBreturn\fP را نمی‌دادند.
.sp
بسته شدن #5223
.IP \(bu 2
اصلاح \fBsimplify\-boolean\-expression\fP هنگامی که شرط می‌تواند به عنوان False استنتاج شود.
.sp
بسته شدن #5200
.IP \(bu 2
رفع استثنا هنگامی که pyreverse یک \fBproperty function\fP از یک کلاس را تجزیه می‌کند.
.IP \(bu 2
بهبود و هموارسازی پیام \fBunused\-wildcard\-import\fP
.sp
بسته شدن #3859
.IP \(bu 2
در بازبین طول، نام \fBlen\-as\-condition\fP جهت سازگاری با \fBuse\-implicit\-booleaness\-not\-comparison\fP\& به \fBuse\-implicit\-booleaness\-not\-len\fP تغییر یافت.
.IP \(bu 2
اصلاح \fBprotected\-access\fP برای دسترسی به صفت‌ها و متدهای کلاس‌های درونی
.sp
بسته شدن #3066
.IP \(bu 2
به‌روزرسانی بازبین \fBliteral\-comparison\(ga\fP جهت نادیده گرفتن مقادیر لفظی تاپل (tuple literals)
.sp
بسته شدن #3031
.IP \(bu 2
بخش تابعی \fBtestutils\fP اکنون \fBend_lineno\fP و \fBend_column\fP را می‌پذیرد. فایل‌های خروجی موردانتظار که فاقد این موارد باشند، یک \fBDeprecationWarning\fP را فعال می‌کنند. فایل‌های خروجی موردانتظار را می‌توان به آسانی با دستور \fBpython tests/test_functional.py \-\-update\-functional\-output\fP به‌روزرسانی کرد.
.IP \(bu 2
بخش تابعی \fBtestutils\fP اکنون تمایز بین سطح اطمینان \fBHIGH\fP و \fBUNDEFINED\fP را به درستی بررسی می‌کند. فایل‌های خروجی موردانتظار بدون سطوح تعریف‌شده \fBconfidence\fP اکنون یک \fBDeprecationWarning\fP صادر می‌کنند. فایل‌های خروجی موردانتظار را می‌توان به سادگی با دستور \fBpython tests/test_functional.py \-\-update\-functional\-output\fP به‌روزرسانی کرد.
.IP \(bu 2
اجراکننده آزمون تابعی اکنون از گزینه \fBmin_pyver_end_position\fP برای کنترل اینکه صفت‌های \fBend_lineno\fP و \fBend_column\fP روی کدام نسخه‌های پایتون بررسی شوند، پشتیبانی می‌کند. مقدار پیش‌فرض 3.8 است.
.IP \(bu 2
\fBundefined\-variable\fP اکنون متغیرهایی را که فقط یک حاشیه‌نویسی نوع (type annotation) دریافت کرده و هرگز مقداری به آن‌ها انتساب داده نمی‌شود، به درستی نشانه‌گذاری می‌کند.
.sp
بسته شدن #5140
.IP \(bu 2
\fBundefined\-variable\fP اکنون شماره‌گذاری خطوط و ترتیب کلاس‌های به‌کاررفته در اعلان‌های metaclass را به درستی در نظر می‌گیرد.
.sp
بسته شدن #4031
.IP \(bu 2
\fBused\-before\-assignment\fP اکنون ارجاع به کلاس‌ها به عنوان حاشیه‌نویسی نوع یا مقادیر پیش‌فرض در متدهای سطح اول را به درستی لحاظ می‌کند.
.sp
بسته شدن #3771
.IP \(bu 2
\fBundefined\-variable\fP و \fBunused\-variable\fP اکنون برای عبارت‌های انتساب در مقادیر پیش‌فرض توابع به درستی فعال می‌شوند.
.sp
مرجع: #3688
.IP \(bu 2
\fBself\-cls\-assignment\fP اکنون انتساب‌های تاپل (tuple assignment) را نیز در نظر می‌گیرد.
.IP \(bu 2
\fBundefined\-variable\fP اکنون برای عبارت‌های انتساب در دستورهای if ... else به درستی فعال می‌شود. این مورد شامل شکل پایه‌ای از استنتاج جریان کنترل برای دستورهای if ... else با استفاده از مقادیر بولی ثابت است.
.sp
بسته شدن #3688
.IP \(bu 2
رفع فروپاشی در \fBunused\-private\-member\fP هنگام بررسی اعضای خصوصی روی \fB__class__\fP
.sp
بسته شدن #5261
.IP \(bu 2
رفع صدور دوگانه \fBnot\-callable\fP روی \fBproperties\fP قابل استنتاج
.sp
بسته شدن #4426
.IP \(bu 2
پشتیبانی از پیکربندی الگوی کلاس‌های mixin از طریق \fBmixin\-class\-rgx\fP
.IP \(bu 2
نرمال‌سازی ورودی گزینه \fBignore\-paths\fP جهت پشتیبانی هم‌زمان از مسیرهای Posix و Windows
.sp
بسته شدن #5194
.IP \(bu 2
\fBmissing\-param\-doc\fP اکنون ستاره‌ها را برای پارامترهای با طول متغیر و پارامترهای کلیدواژه‌ای به درستی تجزیه می‌کند.
.sp
بسته شدن #3733
.IP \(bu 2
\fBmissing\-param\-doc\fP اکنون مستندات پارامتر به سبک Numpy بدون نوع‌بندی صریح را به درستی پردازش می‌کند.
.sp
بسته شدن #5222
.IP \(bu 2
پارامتر \fB\-\-jobs\fP اکنون در صورتی که سیستم‌عامل میزبان دارای پیاده‌سازی کارآمد سمافور مشترک نباشد، به مقدار 1 بازمی‌گردد.
.sp
بسته شدن #5216
.IP \(bu 2
فروپاشی‌ها هنگام مواجهه با یک لیست در پیکربندی toml دیگر رخ نمی‌دهند.
.sp
بسته شدن #4580
.IP \(bu 2
رفع فروپاشی برای \fBprotected\-access\fP در پیمایش کلاس (بیرونی)
.IP \(bu 2
رفع مثبت کاذب در \fBuseless\-super\-delegation\fP هنگامی که آرگومان کلیدواژه‌ای پیش‌فرض یک متغیر است.
.IP \(bu 2
غیرحساس کردن اعتبارسنج yn به بزرگی و کوچکی حروف، جهت اجازه دادن به \fBTrue\fP و \fBFalse\fP در فایل‌های پیکربندی.
.IP \(bu 2
آخرین نسخه سازگار با پایتون \(aq3.6.0\(aq و \(aq3.6.1\(aq، نسخه \(aq2.9.3\(aq از pylint است. ما در آن زمان هنگام افزودن تایپینگ ناسازگار متوجه این موضوع نشدیم و تمام نسخه‌های پس از آن برای این مفسر خراب هستند. اطلاعات فراداده 2.12.0 امکان بارگیری pylint را روی آن مفسرها خواهد داد اما نصب با شکست مواجه می‌شود و اعلام می‌کند که به جای آن \(aq2.9.3\(aq را نصب کنید. نسخه 2.12.1 از pylint به python >= 3.6.2 نیاز خواهد داشت.
.sp
بسته شدن #5171
پیگیری در #5065
.IP \(bu 2
افزوده شدن گزینه خط فرمان \fB\-\-enable\-all\-extensions\fP\&. این گزینه تمامی افزونه‌های موجود را که با اجرای \fB\-\-list\-extensions\fP قابل فهرست شدن هستند، بارگیری می‌کند.
.IP \(bu 2
اکنون توصیه می‌شود که توسعه \fBpylint\fP روی \fBPython\fP نسخه 3.8 یا بالاتر انجام شود. این کار امکان استفاده از جدیدترین تجزیه‌کننده \fBast\fP را فراهم می‌سازد.
.IP \(bu 2
تمامی کارهای استاندارد در CI مربوط به \fBpylint\fP اکنون به طور پیش‌فرض روی \fBPython\fP 3.8 اجرا می‌شوند. ما همچنان از پایتون 3.6 و 3.7 پشتیبانی می‌کنیم و آزمون‌ها را برای آن مفسرها اجرا می‌نماییم.
.IP \(bu 2
رفع فروپاشی در فراخوانی‌های \fBopen()\fP هنگامی که آرگومان \fBmode\fP یک رشته ساده نباشد.
.sp
رفع بخشی از #5321
.IP \(bu 2
افزودن امکان اضافه کردن \fBend_line\fP و \fBend_column\fP به گزینه \fB\-\-msg\-template\fP\&. با گزارشگر استاندارد \fBTextReporter\fP، این کار شماره خط و ستون انتهای یک گره را به خروجی Pylint اضافه می‌کند. اگر این شماره‌ها ناشناخته باشند، با یک رشته خالی نمایش داده می‌شوند.
.IP \(bu 2
معرفی آزمون‌های primer و یک چارچوب آزمون‌های پیکربندی. کلاس‌های کمکی موجود در \fBpylint/testutil/\fP هنوز ناپایدار هستند و ممکن است در آینده نزدیک دستخوش تغییر شوند.
.sp
بسته شدن #4412 #5287
.IP \(bu 2
افزودن کلیدهای \fBendLine\fP و \fBendColumn\fP به خروجی \fBJSONReporter\fP\&.
.sp
بسته شدن #5380
.IP \(bu 2
رفع منفی کاذب برای \fBconsider\-iterating\-dictionary\fP در طول بررسی‌های عضویتِ کپسوله‌شده در تکرارپذیرها یا بررسی‌های \fBnot in\fP
.sp
بسته شدن #5323
.UNINDENT.SS گزارش کامل تغییرات (Full changelog)
.SS چه مواردی در Pylint 2.12.2 جدید است؟
.sp
تاریخ انتشار: 2021\-11\-25
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب برای \fBunused\-import\fP در مواردی که همه‌چیز درون typing guards به‌درستی تحلیل نمی‌شد.
.IP \(bu 2
رفع پس‌رفتِ مثبت کاذب برای \fBused\-before\-assignment\fP در متغیرهای نوع‌دار در بدنهٔ متدهای کلاسی که به همان کلاس ارجاع دارند
.sp
بسته شدن #5342
.IP \(bu 2
مشخص شد که گزینهٔ \fBignore\-paths\fP مقدار \(dq\(dq را به جای نویسهٔ گریز عبارت باقاعده، جداکنندهٔ مسیر دایرکتوری در ویندوز در نظر می‌گیرد.
.IP \(bu 2
رفع فروپاشی گزینهٔ \fBignore\-paths\fP هنگام فراخوانی این گزینه از طریق خط فرمان.
.sp
بسته شدن #5437
.IP \(bu 2
رفع مدیریت docstringهای پارامترها به سبک Sphinx دارای ستاره. این موارد باید با افزودن یک \(dq\(dq در ابتدا، گریز داده شوند.
.sp
بسته شدن #5406
.IP \(bu 2
افزودن کلیدهای \fBendLine\fP و \fBendColumn\fP به خروجی \fBJSONReporter\fP\&.
.sp
بسته شدن #5380
.IP \(bu 2
رفع مدیریت مشخصات پارامتر به سبک Google در مواردی که توضیحات در خط پس از نام پارامتر قرار دارند. این موارد هشدارهای مثبت کاذب برای \fBmissing\-param\-doc\fP ایجاد می‌کردند.
.sp
بسته شدن #5452
.IP \(bu 2
رفع منفی کاذب برای \fBconsider\-iterating\-dictionary\fP هنگام بررسی‌های عضویت قرارگرفته درون تکرارپذیرها یا بررسی‌های \fBnot in\fP
.sp
بسته شدن #5323
.IP \(bu 2
بررسی‌کنندهٔ \fBunused\-import\fP اکنون همهٔ اجداد (ancestors) را برای typing guards بررسی می‌کند
.sp
بسته شدن #5316
.UNINDENT
.SS چه مواردی در Pylint 2.12.1 جدید است؟
.sp
تاریخ انتشار: 2021\-11\-25
.INDENT 0.0
.IP \(bu 2
الزام پایتون \fB3.6.2\fP برای اجرای pylint.
.sp
بسته شدن #5065
.UNINDENT
.SS چه مواردی در Pylint 2.12.0 جدید است؟
.sp
تاریخ انتشار: 2021\-11\-24
.INDENT 0.0
.IP \(bu 2
ارتقای astroid به نسخهٔ 2.9.0
.sp
بسته شدن #4982
.IP \(bu 2
افزودن قابلیت اضافه کردن \fBend_line\fP و \fBend_column\fP به گزینهٔ \fB\-\-msg\-template\fP.
در \fBTextReporter\fP استاندارد، این کار شمارهٔ خط و ستون پایان یک گره را به خروجی Pylint اضافه می‌کند.
در صورت نامشخص بودن این اعداد، با یک رشتهٔ خالی نمایش داده می‌شوند.
.IP \(bu 2
معرفی آزمون‌های primer و یک چارچوب آزمون‌های پیکربندی. کلاس‌های کمکی موجود در
\fBpylint/testutil/\fP هنوز ناپایدارند و ممکن است در آینده‌ای نزدیک تغییر کنند.
.sp
بسته شدن #4412 #5287
.IP \(bu 2
رفع پیام \fBinstall graphiz\fP که برای قالب خروجی puml مورد نیاز نیست.
.IP \(bu 2
کلاس \fBMessageTest\fP از ماژول \fBtestutil\fP برای unittest اکنون مستلزم آن است که مشخصهٔ \fBconfidence\fP
با مقدار مورد انتظار مطابقت داشته باشد. اگر مقداری مشخص نشده باشد، روی \fBUNDEFINED\fP تنظیم می‌شود.
.IP \(bu 2
تابع \fBadd_message\fP از ماژول \fBtestutil\fP برای unittest اکنون پارامتر \fBcol_offset\fP را مدیریت کرده
و امکان بررسی آن را در برابر خروجی واقعی در یک آزمون فراهم می‌کند.
.IP \(bu 2
رفع فروپاشی در افزونه‌های \fBcheck_elif\fP در جایی که یک if شناسایی‌نشده در یک comprehension با یک دستور if درون f\-string
منجر به خطای خارج از محدوده می‌شد. بررسی‌کننده دیگر به شمارش دستورهای if تکیه نمی‌کند و در عوض از مکان‌های شناخته‌شدهٔ
دستورهای if استفاده می‌کند. دیگر نباید در دستورهای if با تجزیهٔ نادرست دچار فروپاشی شود.
.IP \(bu 2
رفع \fBsimplify\-boolean\-expression\fP در مواردی که شرط می‌تواند به عنوان False استنتاج شود.
.sp
بسته شدن #5200
.IP \(bu 2
رفع استثنا هنگام تجزیهٔ \fBproperty function\fP یک کلاس توسط pyreverse.
.IP \(bu 2
بخش آزمون‌های تابعیِ \fBtestutils\fP اکنون \fBend_lineno\fP و \fBend_column\fP را می‌پذیرد. فایل‌های خروجی
مورد انتظار بدون این مشخصه‌ها، یک \fBDeprecationWarning\fP ایجاد خواهند کرد. فایل‌های خروجی مورد انتظار را می‌توان به‌راحتی
با دستور \fBpython tests/test_functional.py \-\-update\-functional\-output\fP به‌روزرسانی کرد.
.IP \(bu 2
بخش آزمون‌های تابعیِ \fBtestutils\fP اکنون تمایز بین سطوح اطمینان \fBHIGH\fP و
\fBUNDEFINED\fP را به‌درستی بررسی می‌کند. فایل‌های خروجی مورد انتظار بدون سطوح تعریف‌شدهٔ \fBconfidence\fP اکنون یک
\fBDeprecationWarning\fP ایجاد خواهند کرد. فایل‌های خروجی مورد انتظار را می‌توان به‌راحتی با دستور
\fBpython tests/test_functional.py \-\-update\-functional\-output\fP به‌روزرسانی کرد.
.IP \(bu 2
اجراکنندهٔ آزمون‌های تابعی اکنون از گزینهٔ \fBmin_pyver_end_position\fP برای کنترل اینکه مشخصه‌های
\fBend_lineno\fP و \fBend_column\fP در کدام نسخه‌های پایتون باید بررسی شوند، پشتیبانی می‌کند. مقدار پیش‌فرض 3.8 است.
.IP \(bu 2
رفع مشکل \fBaccept\-no\-yields\-doc\fP و \fBaccept\-no\-return\-doc\fP که هنگام درست بودنِ بخشی از یک docstring،
نبودِ مستندات \fByield\fP یا \fBreturn\fP را مجاز نمی‌دانستند
.sp
بسته شدن #5223
.IP \(bu 2
افزودن یک افزونهٔ اختیاری \fBconsider\-using\-any\-or\-all\fP: زمانی صادر می‌شود که یک حلقهٔ \fBfor\fP فقط مقدار
بولی (boolean) تولید کرده و بتوان آن را با استفاده از یک مولد (generator) با \fBany\fP یا \fBall\fP جایگزین کرد. همچنین یک
دستور مناسب any یا all را پیشنهاد می‌دهد.
.sp
بسته شدن #5008
.IP \(bu 2
تشخیص صحیح پارامترهای بدون مستندات و افزودن پیام جدیدی با نام \fBmissing\-any\-param\-doc\fP
.sp
بسته شدن #3799
.IP \(bu 2
افزودن بررسی‌کننده‌های \fBoverridden\-final\-method\fP و \fBsubclassed\-final\-class\fP
.sp
بسته شدن #3197
.IP \(bu 2
رفع \fBprotected\-access\fP برای دسترسی به مشخصه‌ها و متدهای کلاس‌های درونی
.sp
بسته شدن #3066
.IP \(bu 2
افزودن پشتیبانی از \fBModuleNotFoundError\fP (\fBimport\-error\fP و \fBno\-name\-in\-module\fP).
کلاس \fBModuleNotFoundError\fP از \fBImportError\fP ارث‌بری می‌کند و در پایتون \fB3.6\fP اضافه شده است
.IP \(bu 2
بررسی‌کنندهٔ \fBundefined\-variable\fP اکنون متغیرهایی را که فقط حاشیه‌نویسی نوع دریافت کرده‌اند
و هرگز مقداری به آن‌ها انتساب داده نشده است، به‌درستی پرچم‌گذاری می‌کند
.sp
بسته شدن #5140
.IP \(bu 2
بررسی‌کنندهٔ \fBundefined\-variable\fP اکنون شماره‌گذاری خطوط و ترتیب کلاس‌های به‌کاررفته در اعلان‌های metaclass را به‌درستی در نظر می‌گیرد
.sp
بسته شدن #4031
.IP \(bu 2
بررسی‌کنندهٔ \fBused\-before\-assignment\fP اکنون ارجاع به کلاس‌ها به عنوان حاشیه‌نویسی نوع
یا مقادیر پیش‌فرض در متدهای سطح اول را به‌درستی در نظر می‌گیرد
.sp
بسته شدن #3771
.IP \(bu 2
بررسی‌کننده‌های \fBundefined\-variable\fP و \fBunused\-variable\fP اکنون برای عبارت‌های انتساب
در مقادیر پیش‌فرض توابع به‌درستی فعال می‌شوند
.sp
ارجاع به #3688
.IP \(bu 2
بررسی‌کنندهٔ \fBundefined\-variable\fP اکنون برای عبارت‌های انتساب در دستورهای if ... else به‌درستی فعال می‌شود
این شامل شکل پایه‌ای از استنتاج جریان کنترل (control flow inference) برای دستورهای if ... else با مقادیر بولی ثابت است
.sp
بسته شدن #3688
.IP \(bu 2
افزودن گزینهٔ خط فرمان \fB\-\-enable\-all\-extensions\fP. این گزینه تمام افزونه‌های دردسترس را که
می‌توان با اجرای \fB\-\-list\-extensions\fP فهرست کرد، بارگذاری می‌کند
.IP \(bu 2
رفع اشکال واردسازی بسته‌های namespace با واردسازی‌های نسبی (relative imports)
.sp
بسته شدن #2967 و #5131
.IP \(bu 2
بهبود و یکپارچه‌سازی پیام \fBunused\-wildcard\-import\fP
.sp
بسته شدن #3859
.IP \(bu 2
در بررسی‌کنندهٔ طول، \fBlen\-as\-condition\fP جهت سازگاری با
\fBuse\-implicit\-booleaness\-not\-comparison\fP به \fBuse\-implicit\-booleaness\-not\-len\fP تغییر نام یافت.
.IP \(bu 2
ایجاد کلاس بررسی‌کنندهٔ جدید \fBUnsupportedVersionChecker\fP که شامل بررسی قابلیت‌هایی است
که توسط تمام نسخه‌های مشخص‌شده در \fBpy\-version\fP پشتیبانی نمی‌شوند.
.INDENT 2.0
.IP \(bu 2
افزودن بررسی‌کنندهٔ \fBusing\-f\-string\-in\-unsupported\-version\fP. زمانی صادر می‌شود که \fBpy\-version\fP
روی نسخه‌ای تنظیم شده باشد که از f\-string پشتیبانی نمی‌کند (< 3.6)
.UNINDENT.IP \(bu 2
رفع مثبت کاذب \fBuseless\-super\-delegation\fP هنگامی که آرگومان کلیدواژه‌ای پیش‌فرض یک متغیر است.
.IP \(bu 2
صدور صحیح \fBduplicate\-key\fP هنگامی که اعضای Enum کلیدهای تکراری دیکشنری هستند
.sp
بسته شد: #5150
.IP \(bu 2
استفاده از تنظیم \fBpy\-version\fP برای بررسی نحو جایگزین union (PEP 604)،
به‌جای نسخه مفسر Python.
.IP \(bu 2
زیرکلاس‌های \fBdict\fP توسط بررسی‌کننده \fBbad\-reversed\-sequence\fP به‌عنوان قابل‌معکوس‌سازی در نظر گرفته می‌شوند
(از Python 3.8 به بعد).
.sp
بسته شد: #4981
.IP \(bu 2
پشتیبانی از پیکربندی الگوی کلاس‌های mixin از طریق \fBmixin\-class\-rgx\fP
.IP \(bu 2
افزوده شدن بررسی‌کننده جدید \fBuse\-implicit\-booleaness\-not\-comparison\fP: زمانی صادر می‌شود که
از مقایسه لیترال مجموعه برای بررسی خالی بودن استفاده شده باشد.
.sp
بسته شد: #4774
.IP \(bu 2
اکنون \fBmissing\-param\-doc\fP ستاره‌ها را برای پارامترهای با طول متغیر و
کلیدواژه‌ای به‌درستی تجزیه می‌کند
.sp
بسته شد: #3733
.IP \(bu 2
اکنون \fBmissing\-param\-doc\fP مستندسازی پارامترهای Numpy بدون
نوع‌بندی صریح را به‌درستی مدیریت می‌کند
.sp
بسته شد: #5222
.IP \(bu 2
دیگر \fBpylint\fP هنگام بررسی عبارت‌های انتساب در دستورهای if دچار فروپاشی نمی‌شود
.sp
بسته شد: #5178
.IP \(bu 2
به‌روزرسانی بررسی‌کننده \fBliteral\-comparison\(ga\fP برای نادیده‌گرفتن لیترال‌های تاپل
.sp
بسته شد: #3031
.IP \(bu 2
نرمال‌سازی ورودی گزینه \fBignore\-paths\fP برای مجاز کردن هر دو نوع مسیرهای Posix و
Windows
.sp
بسته شد: #5194
.IP \(bu 2
رفع صدور تکراری \fBnot\-callable\fP برای \fBproperties\fP قابل‌استنتاج
.sp
بسته شد: #4426
.IP \(bu 2
اکنون \fBself\-cls\-assignment\fP انتساب تاپل را نیز در نظر می‌گیرد
.IP \(bu 2
رفع ناتوانی \fBmissing\-function\-docstring\fP در بررسی \fB__init__\fP و سایر
متدهای جادویی حتی در صورت تنظیم بودن گزینه \fBno\-docstring\-rgx\fP برای انجام آن
.IP \(bu 2
افزوده شدن بررسی‌کننده \fBusing\-final\-decorator\-in\-unsupported\-version\fP. زمانی صادر می‌شود که \fBpy\-version\fP
روی نسخه‌ای تنظیم شده باشد که از \fBtyping.final\fP پشتیبانی نمی‌کند (< 3.8)
.IP \(bu 2
افزوده شدن گزینه پیکربندی \fBexclude\-too\-few\-public\-methods\fP برای امکان مستثنی‌کردن
کلاس‌ها از بررسی‌کننده \fBmin\-public\-methods\fP.
.sp
بسته شد: #3370
.IP \(bu 2
در صورت عدم وجود پیاده‌سازی فعال سمافور اشتراکی در سیستم‌عامل میزبان، پارامتر \fB\-\-jobs\fP
اکنون به ۱ بازمی‌گردد.
.sp
بسته شد: #5216
.IP \(bu 2
رفع فروپاشی در \fBunused\-private\-member\fP هنگام بررسی اعضای خصوصی روی \fB__class__\fP
.sp
بسته شد: #5261
.IP \(bu 2
دیگر هنگام مواجهه با یک لیست در پیکربندی toml فروپاشی رخ نمی‌دهد.
.sp
بسته شد: #4580
.IP \(bu 2
انتقال \fBmisplaced\-comparison\-constant\fP به افزونه اختصاصی خود \fBcomparison_placement\fP\&.
این بررسی‌کننده سلیقه‌ای بود و اکنون دیگر پیش‌فرض نیست. می‌توان آن را با افزودن
\fBpylint.extensions.comparison_placement\fP به \fBload\-plugins\fP در پیکربندی خود مجدداً فعال کرد.
.sp
بسته شد: #1064
.IP \(bu 2
بررسی‌کننده جدید \fBbad\-configuration\-section\fP افزوده شد که برای گزینه‌های نابجا
در فضای‌نام سطح‌بالای pylint برای پیکربندی toml اخطار صادر می‌کند. دیکشنری‌های سطح‌بالا یا گزینه‌های تعریف‌شده
در بخش‌های نادرست همچنان بدون اعلان نادیده گرفته می‌شوند، که این موضوع در یک مورد
پیگیری دنبال می‌شود.
.sp
پیگیری در #5259
.IP \(bu 2
رفع فروپاشی در \fBprotected\-access\fP هنگام پیمایش کلاس (بیرونی)
.IP \(bu 2
افزوده شدن بررسی‌کننده جدید \fBuseless\-with\-lock\fP برای یافتن استفاده نادرست از دستور with و قفل‌های ماژول threading.
زمانی صادر می‌شود که \fBwith threading.Lock():\fP به‌جای \fBwith lock_instance:\fP\& استفاده شود.
.sp
بسته شد: #5208
.IP \(bu 2
غیرحساس کردن اعتبارسنج yn به بزرگی و کوچکی حروف، جهت مجاز شمردن \fBTrue\fP و \fBFalse\fP در فایل‌های پیکربندی.
.IP \(bu 2
رفع فروپاشی در فراخوانی‌های \fBopen()\fP هنگامی که آرگومان \fBmode\fP یک رشته ساده نباشد.
.sp
رفع بخشی از #5321
.IP \(bu 2
وراثت از کلاسی که \fB__class_getitem__\fP را پیاده‌سازی کرده است دیگر منجر به صدور \fBinherit\-non\-class\fP\& نمی‌شود.
.IP \(bu 2
در Pyreverse \- افزودن دایرکتوری ریشه پروژه به sys.path
.sp
بسته شد: #2479
.IP \(bu 2
عدم صدور \fBconsider\-using\-f\-string\fP در صورتی که \fBpy\-version\fP روی Python < \fB3.6\fP\& تنظیم شده باشد.
\fBf\-strings\fP در Python \fB3.6\fP اضافه شد
.sp
بسته شد: #5019
.IP \(bu 2
رفع پس‌رفت در \fBunspecified\-encoding\fP با \fBpathlib.Path.read_text()\fP
.sp
بسته شد: #5029
.IP \(bu 2
عدم صدور \fBconsider\-using\-f\-string\fP در صورتی که متغیرهای درون‌یابی‌شونده شامل بک‌اسلش باشند
.IP \(bu 2
رفع مثبت کاذب در \fBcell\-var\-from\-loop\fP هنگامی که متغیر به‌عنوان مقدار پیش‌فرض
یک پارامتر فقط\-کلیدواژه‌ای استفاده می‌شود.
.sp
بسته شد: #5012
.IP \(bu 2
رفع مثبت کاذب \fBundefined\-variable\fP با \fBLambda\fP، \fBIfExp\fP و
عبارت انتساب.
.IP \(bu 2
رفع مثبت کاذب \fBuseless\-suppression\fP برای \fBwrong\-import\-order\fP
.sp
بسته شد: #2366
.IP \(bu 2
رفع مشکل وابستگی \fBtoml\fP
.sp
بسته شد: #5066
.IP \(bu 2
رفع مثبت کاذب \fBuseless\-suppression\fP برای \fBline\-too\-long\fP
.sp
بسته شد: #4212
.IP \(bu 2
رفع عدم بررسی پارامترهای متدهای بازنویسی‌شده از \fBobject\fP پایه در \fBinvalid\-name\fP
.sp
بسته شد: #3614
.IP \(bu 2
رفع فروپاشی در \fBconsider\-using\-f\-string\fP در صورتی که \fBformat\fP فراخوانی نشود
.sp
بسته شد: #5058
.IP \(bu 2
رفع فروپاشی با \fBAssignAttr\fP در بلوک‌های \fBif TYPE_CHECKING\fP.
.sp
بسته شد: #5111
.IP \(bu 2
بهبود اطلاعات گره برای \fBinvalid\-name\fP در آرگومان تابع.
.IP \(bu 2
جلوگیری از فراخوانی بررسی‌کننده‌های نوع بازگشتی روی توابعی که بدنه آن‌ها سه‌نقطه (ellipses) است
.sp
بسته شد: #4736
.IP \(bu 2
افزودن توابع کمکی \fBis_sys_guard\fP و \fBis_typing_guard\fP از astroid
به \fBpylint.checkers.utils\fP\&.
.IP \(bu 2
رفع پس‌رفت در استنتاج ClassDef
.sp
بسته شد: #5030
بسته شد: #5036
.IP \(bu 2
رفع پس‌رفت در استنتاج گره Compare
.sp
بسته شد: #5048
.IP \(bu 2
رفع مثبت کاذب \fBisinstance\-second\-argument\-not\-valid\-type\fP با \fBtyping.Callable\fP\&.
.sp
بسته شد: #3507
بسته شد: #5087
.IP \(bu 2
اکنون توصیه می‌شود که توسعه \fBpylint\fP روی \fBPython\fP نسخه 3.8 یا بالاتر انجام شود. این کار
امکان استفاده از جدیدترین تجزیه‌کننده \fBast\fP را فراهم می‌سازد.
.IP \(bu 2
اکنون همه وظایف استاندارد در CI مربوط به \fBpylint\fP به‌طور پیش‌فرض روی \fBPython\fP 3.8 اجرا می‌شوند. ما همچنان
از python نسخه 3.6 و 3.7 پشتیبانی می‌کنیم و آزمون‌ها را برای آن مفسرها اجرا می‌نماییم.
.IP \(bu 2
\fBTypingChecker\fP
.INDENT 2.0.IP \(bu 2
رفع منفی کاذب برای \fBdeprecated\-typing\-alias\fP و \fBconsider\-using\-alias\fP
همراه با \fBtyping.Type\fP + \fBtyping.Callable\fP\&.
.UNINDENT
.UNINDENT
.SS تازه‌های Pylint 2.11
.sp
از آغاز به کار pylint تا نسخه 2.14.0 (شامل آن)، یک گزارش تغییرات (changelog) داشتیم که دربردارندهٔ \fIتمام\fP
تغییرات غیربدیهی Pylint بود، از جمله تغییراتی که
برای کاربر ملموس نبودند؛ یعنی تغییراتی که تنها اگر توسعه‌دهندهٔ فعال
روی pylint یا افزونه‌های pylint یا یک تاریخ‌نگار متن‌باز بودید برایتان جذابیت داشت.
.sp
از نسخه 1.6.0 تا 2.14.0 در pylint، افزون بر گزارش تغییرات کامل، خلاصه‌ای
از تغییرات (عمدتاً کاربرمحور) نیز وجود داشت.
.SS خلاصه \-\- نکات برجسته انتشار
.sp
در نسخه 2.11، یک بررسی‌کننده (checker) پیش‌فرض جدید اضافه کردیم که استفاده از f\-string را پیشنهاد می‌کند،
زیرا در حال حاضر کارآمدترین روش برای قالب‌بندی رشته‌ها است. می‌توانید از
pyupgrade \%<https://\:github\:.com/\:asottile/\:pyupgrade>، ruff \%<https://\:docs\:.astral\:.sh/\:ruff> یا flynt \%<https://\:github\:.com/\:ikamensh/\:flynt> برای مهاجرت خودکار ساختارهای قدیمی \fB%\fP و \fBformat()\fP خود استفاده کنید.
.sp
ما افزونهٔ جدید \fBSetMembershipChecker\fP را اضافه کردیم که استفاده از
set را برای آزمون عضویت پیشنهاد می‌کند، زیرا عملکرد بهتری نسبت به لیست‌ها یا تاپل‌ها دارد.
همچنین بهبودهایی در \fBCodeStyleChecker\fP اعمال شد؛ اگر هنوز از آن استفاده نمی‌کنید
حتماً نگاهی به آن بیندازید.
.sp
برخی باگ‌های دیرینه، مثبت‌های کاذب، یا منفی‌های کاذب را برطرف کردیم و
گزینه‌های کوچک و کاربردی برای راحتی کار مانند \fBmin\-similarity\-lines\fP اضافه کردیم که
در صورت تنظیم روی 0، بررسی کدهای تکراری را غیرفعال می‌کند.
.sp
در پشت صحنه، کدهای هر دو پروژه pylint و astroid به‌طور فزاینده‌ای مجهز به تعیین نوع (type hint) شده‌اند،
که اگر از آن‌ها به‌عنوان کتابخانه استفاده می‌کنید برایتان مفید خواهد بود. برای اینکه
این نوع‌گذاری جدید منطقی‌تر و ساده‌تر بماند، برخی از توابع یا انواع را منسوخ (deprecate) کرده‌ایم
که در نسخهٔ اصلی (major) بعدی حذف خواهند شد. این تلاشی پیوسته و ادامه‌دار است.
.sp
بررسی آیندهٔ \fBpossible\-forgotten\-f\-prefix\fP همچنان مثبت‌های کاذب بسیار زیادی داشت،
و انتشار آن مجدداً به تعویق افتاد. اگر مایلید دانش فنی یا موردی برای استفاده ارائه دهید،
موضوع possible\-forgotten\-f\-prefix در \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:pull/\:4787> را بررسی کنید :)
.SS بررسی‌کننده‌های جدید
.INDENT 0.0
.IP \(bu 2
افزوده شدن \fBconsider\-using\-f\-string\fP: زمانی صادر می‌شود که از .format() یا \(aq%\(aq برای قالب‌بندی یک رشته استفاده شود.
.sp
بسته شدن #3592
.UNINDENT
.SS بررسی‌کننده‌های حذف‌شده
.INDENT 0.0
.IP \(bu 2
بررسی‌کننده حالت انتقال به python3 و گزینهٔ \fBpy3k\fP آن حذف شدند. همچنان می‌توانید آن را در نسخه‌های قدیمی‌تر pylint
پیدا کنید.
.UNINDENT
.SS افزونه‌ها
.INDENT 0.0
.IP \(bu 2
افزوده شدن افزونه جدید \fBSetMembershipChecker\fP همراه با بررسی \fBuse\-set\-for\-membership\fP:
زمانی صادر می‌شود که از یک \fBlist\fP یا \fBtuple\fP تعریف‌شده در جا برای آزمون عضویت استفاده شود. \fBsets\fP برای این کار بهینه‌تر هستند.
.sp
بسته شدن #4776
.UNINDENT
.SS بررسی‌کننده CodeStyleChecker
.INDENT 0.0
.IP \(bu 2
افزوده شدن \fBconsider\-using\-assignment\-expr\fP: زمانی صادر می‌شود که یک مقداردهی بلافاصله پس از یک عبارت if بیاید
و هر دو بتوانند با استفاده از یک عبارت انتساب \fB:=\fP ترکیب شوند. نیازمند Python 3.8 است.
.sp
بسته شدن #4862
.UNINDENT
.SS سایر تغییرات
.INDENT 0.0
.IP \(bu 2
افزوده شدن کلید پیکربندی \fBpy\-version\fP (در بخش \fB[MAIN]\fP). برای بررسی‌های وابسته به نسخه استفاده می‌شود.
به صورت پیش‌فرض روی هر نسخهٔ پایتونی که pylint با آن اجرا می‌شود تنظیم خواهد شد.
.IP \(bu 2
پیام \fBinvalid\-name\fP اکنون هنگام استفاده از چندین عبارت باقاعده (regex) برای سبک نام‌گذاری، با جزئیات بیشتری نمایش داده می‌شود.
.IP \(bu 2
رفع مثبت کاذب برای \fBconsider\-using\-with\fP اگر یک context manager در
مسیرهای مختلف جریان کنترل (مانند عبارت if\-else) به یک متغیر نسبت داده شود.
.sp
بسته شدن #4751
.IP \(bu 2
رفع مثبت کاذب برای \fBfunction\-redefined\fP در نشانه‌گذاری‌های ساده نوع (type annotations)
.sp
بسته شدن #4936
.IP \(bu 2
رفع مثبت کاذب برای \fBprotected\-access\fP در صورتی که یک عضو محافظت‌شده در اعلان نوع (type hints) تعاریف توابع استفاده شده باشد
.IP \(bu 2
رفع مثبت کاذب \fBdict\-iter\-missing\-items\fP برای دیکشنری‌هایی که تنها از چندتایی‌ها (tuples) به عنوان کلید استفاده می‌کنند
.sp
بسته شدن #3282
.IP \(bu 2
بررسی‌کنندهٔ \fBunspecified\-encoding\fP اکنون فراخوانی‌های \fBpathlib.Path().read_text()\fP
و \fBpathlib.Path().write_text()\fP را نیز بررسی می‌کند
.sp
بسته شدن #4945
.IP \(bu 2
رفع مثبت کاذب \fBsuperfluous\-parens\fP برای تاپل‌های ایجادشده با تاپل‌های درونی
.sp
بسته شدن #4907
.IP \(bu 2
رفع مثبت کاذب \fBunused\-private\-member\fP هنگام دسترسی به مشخصه‌ها در یک کلاس با استفاده از \fBcls\fP
.sp
بسته شدن #4849
.IP \(bu 2
گسترش بررسی \fBconsider\-using\-in\fP برای پشتیبانی از دسترسی به مشخصه‌ها (attribute access).
.IP \(bu 2
تنظیم \fBmin\-similarity\-lines\fP روی 0 اکنون باعث می‌شود بررسی‌کنندهٔ تشابه از بررسی کدهای تکراری صرف‌نظر کند
.sp
بسته شدن #4901
.IP \(bu 2
رفع باگی که در آن در صورت عدم وجود دایرکتوری والد حافظهٔ نهان (cache)، pylint خطایی اعلام می‌کرد
.sp
بسته شدن #4900
.IP \(bu 2
بررسی‌کنندهٔ \fBglobal\-variable\-not\-assigned\fP اکنون متغیرهای سراسری را که هرگز در یک
حوزهٔ محلی دوباره مقداردهی نمی‌شوند شناسایی کرده و توابع (دوباره مقداردهی‌شده) را ثبت می‌کند
.sp
بسته شدن #1375
بسته شدن #330
.IP \(bu 2
بررسی‌کنندهٔ \fBconsider\-iterating\-dictionary\fP اکنون بررسی‌های عضویت را نیز مد نظر قرار می‌دهد
.sp
بسته شدن #4069
.UNINDENT.SS گزارش کامل تغییرات (Full changelog)
.SS چه چیزهایی در Pylint 2.11.1 جدید است؟
.sp
تاریخ انتشار: 2021\-09\-16
.INDENT 0.0
.IP \(bu 2
بررسی‌کننده \fBunspecified\-encoding\fP اکنون کدگذاریِ \fBpathlib.Path()\fP را به‌درستی بررسی می‌کند
.sp
بسته شدن #5017
.UNINDENT
.SS چه چیزهایی در Pylint 2.11.0 جدید است؟
.sp
تاریخ انتشار: 2021\-09\-16
.INDENT 0.0
.IP \(bu 2
بررسی‌کننده حالت مهاجرت به python3 و گزینه \fBpy3k\fP آن حذف شدند. همچنان می‌توانید آن را در نسخه‌های قدیمی‌تر pylint پیدا کنید.
.IP \(bu 2
اکنون هنگام raise کردن یک رشته، \fBraising\-bad\-type\fP به‌درستی صادر می‌شود
.IP \(bu 2
افزونه جدید \fBSetMembershipChecker\fP همراه با بررسی \fBuse\-set\-for\-membership\fP اضافه شد:
هنگام استفاده از یک \fBlist\fP یا \fBtuple\fP تعریف‌شده به‌صورت درجا (in\-place) برای آزمودن عضویت صادر می‌شود. ساختارهای \fBsets\fP برای این کار بهینه‌تر هستند.
.sp
بسته شدن #4776
.IP \(bu 2
کلید پیکربندی \fBpy\-version\fP (در بخش \fB[MASTER]\fP) اضافه شد. برای بررسی‌های وابسته به نسخه استفاده می‌شود.
به‌طور پیش‌فرض با هر نسخه Python که pylint با آن اجرا شود تنظیم خواهد شد.
.IP \(bu 2
\fBCodeStyleChecker\fP: بررسی \fBconsider\-using\-assignment\-expr\fP اضافه شد: هنگامی صادر می‌شود که یک انتساب بلافاصله با یک دستور if دنبال شود
و هر دو بتوانند با استفاده از عبارت انتساب (assignment expression) \fB:=\fP\& ترکیب شوند. نیازمند Python 3.8 است
.sp
بسته شدن #4862
.IP \(bu 2
بررسی \fBconsider\-using\-f\-string\fP اضافه شد: هنگامی صادر می‌شود که از ()format. یا \(aq%\(aq برای قالب‌بندی رشته استفاده شود.
.sp
بسته شدن #3592
.IP \(bu 2
رفع مثبت کاذب برای \fBconsider\-using\-with\fP اگر یک مدیر زمینه (context manager) به یک
متغیر در مسیرهای مختلف جریان کنترل (مانند عبارت if\-else) نسبت داده شده باشد.
.sp
بسته شدن #4751
.IP \(bu 2
پروتکل https اکنون در مستندات ترجیح داده شده است و \%<http://\:pylint\:.pycqa\:.org> به‌درستی به \%<https://\:pylint\:.pycqa\:.org> تغییر مسیر می‌دهد
.sp
بسته شدن #3802
.IP \(bu 2
رفع مثبت کاذب برای \fBfunction\-redefined\fP برای یادداشت‌های نوع (type annotations) ساده
.sp
بسته شدن #4936
.IP \(bu 2
رفع مثبت کاذب برای \fBprotected\-access\fP در صورتی که یک عضو محافظت‌شده در اعلان‌های نوع (type hints) تعاریف توابع استفاده شده باشد
.IP \(bu 2
رفع مثبت کاذب \fBdict\-iter\-missing\-items\fP برای دیکشنری‌هایی که تنها از تاپل‌ها به عنوان کلید استفاده می‌کنند
.sp
بسته شدن #3282
.IP \(bu 2
بررسی‌کننده \fBunspecified\-encoding\fP اکنون فراخوانی‌های \fBpathlib.Path().read_text()\fP
و \fBpathlib.Path().write_text()\fP را نیز بررسی می‌کند
.sp
بسته شدن #4945
.IP \(bu 2
رفع مثبت کاذب \fBsuperfluous\-parens\fP برای تاپل‌های ایجادشده با تاپل‌های درونی
.sp
بسته شدن #4907
.IP \(bu 2
رفع مثبت کاذب \fBunused\-private\-member\fP برای دسترسی به ویژگی‌ها در یک کلاس با استفاده از \fBcls\fP
.sp
بسته شدن #4849
.IP \(bu 2
رفع مثبت کاذب \fBunused\-private\-member\fP برای staticmethodهای خصوصی که در classmethodها مورد دسترسی قرار گرفته‌اند.
.sp
بسته شدن #4849
.IP \(bu 2
گسترش بررسی \fBconsider\-using\-in\fP برای کارکرد در دسترسی به ویژگی‌ها.
.IP \(bu 2
تنظیم \fBmin\-similarity\-lines\fP روی 0 اکنون باعث می‌شود بررسی‌کننده شباهت، بررسی کد تکراری را متوقف کند
.sp
بسته شدن #4901
.IP \(bu 2
رفع باگی که در آن pylint در صورت عدم وجود دایرکتوری والد حافظه موقت (cache) خطا می‌داد
.sp
بسته شدن #4900
.IP \(bu 2
بررسی‌کننده \fBglobal\-variable\-not\-assigned\fP اکنون متغیرهای سراسری را که هرگز در یک حوزه محلی (local scope)
مجدداً مقداردهی نشده‌اند و همچنین توابع (مقداردهی مجدد شده) را شناسایی می‌کند
.sp
بسته شدن #1375
بسته شدن #330
.IP \(bu 2
رفع مثبت‌های کاذب برای invalid\-all\-format / E0605 \%<#\:invalid-all-format> که در زمان اجرا list یا tuple هستند
.sp
بسته شدن #4711
.IP \(bu 2
رفع مشکل \fBno\-self\-use\fP و \fBdocparams extension\fP برای توابع و متدهای async.
.IP \(bu 2
افزودن مستندات برای \fBpyreverse\fP و \fBsymilar\fP
.sp
بسته شدن #4616
.IP \(bu 2
پیام‌های غیرنمادین با حروف بزرگ و کوچک نادرست اکنون به‌درستی \fBuse\-symbolic\-message\-instead\fP را فعال می‌کنند
.sp
بسته شدن #5000
.IP \(bu 2
بررسی‌کننده \fBconsider\-iterating\-dictionary\fP اکنون بررسی‌های عضویت را نیز مد نظر قرار می‌دهد
.sp
بسته شدن #4069
.IP \(bu 2
پیام \fBinvalid\-name\fP هنگام استفاده از چندین regex برای شیوه نام‌گذاری اکنون دارای جزئیات بیشتری است.
.UNINDENT.SS "تازه‌های Pylint 2.10 (What\(aqs New In Pylint 2.10)"
.sp
از آغاز pylint تا نگارش 2.14.0 (شامل آن)، ما یک گزارش تغییرات داشتیم که شامل \fIتمام\fP
تغییرات غیربدیهی Pylint بود؛ از جمله تغییراتی که برای کاربران
نهایی نبودند، یعنی تغییراتی که تنها در صورتی ممکن است برایتان جذاب باشند که توسعه‌دهنده‌ای
باشید که روی pylint یا افزایه‌های pylint کار می‌کند یا یک تاریخ‌نگار منبع‌باز باشید.
.sp
از نگارش 1.6.0 تا 2.14.0 پایتون‌لینت (pylint)، علاوه بر گزارش کامل تغییرات، خلاصه‌ای
از تغییرات (عمدتاً تغییرات مربوط به کاربران) نیز ارائه می‌شد.
.SS "خلاصه \-\- نکات برجسته انتشار (Summary \-\- Release highlights)"
.sp
در نسخه 2.10، چندین بررسی پیش‌فرض جدید مانند \fBunspecified\-encoding\fP، \fBforgotten\-debug\-statement\fP یا
\fBuse\-dict\-literal\fP\& اضافه کرده‌ایم. همچنین چند بررسی اختیاری و سلیقه‌ای نیز وجود دارد. اکنون می‌توانید استفاده از حلقه while را ممنوع کنید یا
عشق انحصاری خود به عبارات سه‌تایی (ternary expressions) را علناً ابراز نمایید. قول می‌دهیم اگر
این موارد را به پیکربندی خود اضافه کنید، ساعت‌ها بحث و گفتگوی سرگرم‌کننده با کل اعضای تیمتان خواهید داشت.
.sp
ما همچنین برخی از باگ‌های دیرینه، موارد مثبت کاذب، یا گزینه‌های جاافتاده مانند \fBignore\-signature\fP را برطرف کرده‌ایم که
اکنون روی امضای توابع درونی نیز اعمال می‌شود.
.sp
گزینه جدیدی برای غیرفعال کردن خط بعدی به نام \fBdisable\-next\fP اضافه شده است. همچنین امکان صادر کردن
نمودارهای رنگی و نمودار plantuml با استفاده از pyreverse فراهم شده است. متغیر \fBPYLINT_HOME\fP در صورت تنظیم نشدن، اکنون به \fBXDG_CACHE_HOME\fP اشاره می‌کند.
.sp
کارایی بررسی‌کننده شباهت بهبود یافته و چندین اصلاح جزئی نیز برای بهبود عملکرد انجام شده است.
.sp
ما در طول نگارش 2.11 به کار روی بهبود کارایی ادامه خواهیم داد. همچنین بررسی جدید
\fBpossible\-forgotten\-f\-prefix\fP را که در زمان انتشار مثبت‌های کاذب بسیار زیادی داشت نهایی خواهیم کرد.
اگر می‌خواهید اطلاعات یا مورد کاربردی ارائه دهید، مسئله مربوط به possible\-forgotten\-f\-prefix را در \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:pull/\:4787> بررسی کنید :)
.SS "بررسی‌کننده‌های جدید (New checkers)"
.INDENT 0.0
.IP \(bu 2
افزوده شدن \fBunspecified\-encoding\fP: زمانی صادر می‌شود که ()open بدون مشخص کردن یک کدگذاری (encoding) فراخوانی شود
.sp
بسته شدن #3826
.IP \(bu 2
افزوده شدن \fBuse\-list\-literal\fP: زمانی صادر می‌شود که \fBlist()\fP بدون هیچ آرگومانی به جای استفاده از \fB[]\fP فراخوانی شود
.sp
بسته شدن #4365
.IP \(bu 2
افزوده شدن \fBuse\-dict\-literal\fP: زمانی صادر می‌شود که \fBdict()\fP بدون هیچ آرگومانی به جای استفاده از \fB{}\fP فراخوانی شود
.sp
بسته شدن #4365
.IP \(bu 2
افزوده شدن \fBforgotten\-debug\-statement\fP: زمانی صادر می‌شود که فراخوانی‌های \fBbreakpoint\fP، \fBpdb.set_trace\fP یا \fBsys.breakpointhook\fP یافت شوند
.sp
بسته شدن #3692
.IP \(bu 2
افزوده شدن \fBuse\-sequence\-for\-iteration\fP: زمانی صادر می‌شود که پیمایش روی یک \fBset\fP تعریف‌شده به صورت درجا (in\-place) انجام گیرد\&.
.IP \(bu 2
افزوده شدن بررسی‌کننده \fBformat\-string\-without\-interpolation\fP: زمانی صادر می‌شود که قالب‌بندی روی یک رشته بدون وجود متغیری برای جایگزینی اعمال شود
.sp
بسته شدن #4042
.IP \(bu 2
افزوده شدن بررسی‌کننده \fBredundant\-u\-string\-prefix\fP: زمانی صادر می‌شود که پیشوند u به یک رشته اضافه شده باشد
.sp
بسته شدن #4102
.UNINDENT
.SS "افزونه‌ها (Extensions)"
.INDENT 0.0
.IP \(bu 2
\fBCodeStyleChecker\fP
.INDENT 2.0
.IP \(bu 2
محدود کردن صدور \fBconsider\-using\-tuple\fP تنها برای \fBlists\fP تعریف‌شده به صورت درجا (in\-place)\&.
.IP \(bu 2
صدور \fBconsider\-using\-tuple\fP حتی اگر لیست شامل یک عبارت ستاره‌دار (\fBstarred\fP) باشد.
.UNINDENT
.IP \(bu 2
افزوده شدن افزونه اختیاری \fBconsider\-ternary\-expression\fP: هرگاه در هر دو شاخه یک بلوک if/else به یک متغیر مقداردهی شود، صادر می‌شود.
.sp
بسته شدن # 4366
.IP \(bu 2
افزوده شدن افزونه اختیاری \fBwhile\-used\fP: هرگاه یک حلقه \fBwhile\fP استفاده شود صادر می‌شود.
.sp
بسته شدن # 4367
.UNINDENT
.SS "سایر تغییرات (Other Changes)"
.INDENT 0.0
.IP \(bu 2
ابزار pyreverse اکنون با استفاده از گزینه \fBcolorized\fP اجازه تولید نمودارهای رنگی تولیدشده را می‌دهد.
.IP \(bu 2
ابزار Pyreverse \- افزودن خروجی در قالب PlantUML
.IP \(bu 2
در صورتی که یک مدیر زمینه (context manager) از یک تابع بازگردانده شود، دیگر \fBconsider\-using\-with\fP فعال نمی‌شود.
.IP \(bu 2
هنگامی که فایلی مشکل‌دار باشد، pylint دیگر با یک ردگیری خطا (traceback) دچار فروپاشی (crash) نمی‌شود.
در عوض، یک فایل متنی الگو برای باز کردن یک مسئله در سامانه ردیابی باگ ایجاد می‌کند.
بدین ترتیب به جای ناممکن شدن فرآیند، بررسی کد (linting) می‌تواند برای سایر فایل‌های بدون مشکل ادامه یابد.
.IP \(bu 2
ابزار Pyreverse \- نمایش روابط ساختاری "has\-a" کلاس‌ها که از type\-hints استنتاج شده‌اند
.IP \(bu 2
کارایی بررسی‌کننده Similarity بهبود یافته است.
.IP \(bu 2
افزوده شدن \fBtime.clock\fP به توابع/متدهای منسوخ‌شده برای python 3.3
.IP \(bu 2
افزوده شدن گزینه \fBignored\-parents\fP به بررسی‌کننده طراحی جهت نادیده گرفتن
کلاس‌های مشخص از بررسی \fBtoo\-many\-ancestors\fP (کد R0901).
.IP \(bu 2
در صورت محافظت شدن در پس یک دستور if، خطای \fBno\-member\fP صادر نشود.
.sp
ارجاع به #1162
بسته شدن #1990
بسته شدن #4168
.IP \(bu 2
رفع موارد مثبت کاذب برای \fBsuperfluous\-parens\fP با عملگر والروس (walrus)، عملگر سه‌تایی و درون درک لیست (list comprehension).
.sp
بسته شدن #2818
بسته شدن #3249
بسته شدن #3608
بسته شدن #4346
.IP \(bu 2
بازسازی ساختار \fB\-\-list\-msgs\fP و \fB\-\-list\-msgs\-enabled\fP: هر دو گزینه اکنون نشان می‌دهند که آیا پیام‌ها با مفسر فعلی قابل انتشار هستند یا خیر.
.sp
بسته شدن #4778
.IP \(bu 2
رفع منفی کاذب برای \fBused\-before\-assignment\fP در زمانی که متغیر درون یک مدیریت‌کننده استثنا (exception handler)
مقداردهی شده، اما خارج از آن مدیریت‌کننده استفاده شده است.
.sp
بسته شدن #626
.IP \(bu 2
افزوده شدن گزینه \fBdisable\-next\fP: اجازه استفاده از \fI# pylint: disable\-next=msgid\fP را جهت غیرفعال کردن یک پیام برای خط بعدی می‌دهد
.sp
بسته شدن #1682
.IP \(bu 2
اصلاح بررسی‌کننده \fBcell\-var\-from\-loop\fP: مدیریت متغیرهای cell در ساخت‌های comprehensions درون توابع،
و عبارات آرگومان‌های پیش‌فرض توابع. همچنین مدیریت سایه‌اندازی پایه‌ای متغیرها (variable shadowing).
.sp
بسته شدن #2846
بسته شدن #3107
.IP \(bu 2
رفع باگ در بررسی‌کننده \fBcell\-var\-from\-loop\fP: در صورتی که هر دو گزینه
\fBunused\-variable\fP و \fBused\-before\-assignment\fP غیرفعال باشند، دیگر موارد منفی کاذب رخ نمی‌دهد.
.IP \(bu 2
با فعال بودن گزینه \(dqignore\-signatures\(dq در similarities، امضای متدهای کلاس نیز همانند امضای توابع نادیده گرفته می‌شوند
.sp
بسته شدن #4653
.UNINDENT.SS گزارش کامل تغییرات
.SS تازه‌های Pylint 2.10.2
.sp
تاریخ انتشار: 2021\-08\-21
.INDENT 0.0
.IP \(bu 2
اکنون از platformdirs به‌جای appdirs استفاده می‌شود زیرا بسته اخیر دیگر نگهداری نمی‌شود.
.sp
بسته شد #4886
.IP \(bu 2
رفع فروپاشی در بررسی‌کننده‌ای که هنگام شکست در استنتاج روی \fBcopy.copy\fP خطای \fBshallow\-copy\-environ\fP را ایجاد می‌کرد
.sp
بسته شد #4891
.UNINDENT
.SS تازه‌های Pylint 2.10.1
.sp
تاریخ انتشار: 2021\-08\-20
.INDENT 0.0
.IP \(bu 2
ابزار pylint هنگامی که PYLINT_HOME وجود ندارد، دچار فروپاشی نمی‌شود.
.sp
بسته شد #4883
.UNINDENT
.SS تازه‌های Pylint 2.10.0
.sp
تاریخ انتشار: 2021\-08\-20
.INDENT 0.0
.IP \(bu 2
‏pyreverse: افزودن گزینه‌ای برای تولید خروجی رنگی.
.sp
بسته شد #4488
.IP \(bu 2
‏pyreverse: افزودن خروجی در قالب PlantUML.
.sp
بسته شد #4498
.IP \(bu 2
در صورتی که یک مدیر بافت (context manager) از تابعی بازگردانده شود، \fBconsider\-using\-with\fP دیگر فعال نمی‌شود.
.sp
بسته شد #4748
.IP \(bu 2
ابزار pylint هنگام مواجهه با یک فایل مشکل‌دار، دیگر با traceback دچار فروپاشی نمی‌شود. در عوض، یک فایل متنی الگو برای ثبت گزارش خطا در سامانه پیگیری اشکالات ایجاد می‌کند. به این ترتیب تحلیل و بررسی کد (linting) می‌تواند به‌جای متوقف شدن، برای سایر فایل‌های بدون مشکل ادامه یابد.
.IP \(bu 2
‏pyreverse: نمایش روابط «شامل بودن» (has\-a) کلاس‌ها که از type\-hint استنتاج شده‌اند
.sp
بسته شد #4744
.IP \(bu 2
رفع فروپاشی هنگام وارد کردن (import) فراتر از بسته سطح بالا در زمان ساخت پیام \fBimport\-error\fP
.sp
بسته شد #4775
.IP \(bu 2
افزودن گزینه \fBignored\-parents\fP به بررسی‌کننده طراحی جهت نادیده گرفتن کلاس‌های مشخص از بررسی \fBtoo\-many\-ancestors\fP (کد R0901).
.sp
رفع بخشی از #3057
.IP \(bu 2
افزودن \fBunspecified\-encoding\fP: زمانی صادر می‌شود که open() بدون مشخص کردن کدگذاری (encoding) فراخوانی شود
.sp
بسته شد #3826
.IP \(bu 2
بهبود کارایی بررسی‌کننده شباهت (Similarity checker). رفع مشکل استفاده هم‌زمان از \fB\-\-min\-similarity\-lines\fP با \fB\-\-jobs\fP\&.
.sp
بسته شد #4120
بسته شد #4118
.IP \(bu 2
عدم صدور خطای \fBno\-member\fP در صورتی که توسط عبارت if محافظت شده باشد.
.sp
ارجاع به #1162
بسته شد #1990
بسته شد #4168
.IP \(bu 2
مقدار پیش‌فرض برای \fBPYLINTHOME\fP اکنون استاندارد \fBXDG_CACHE_HOME\fP است و pylint اکنون از \fBappdirs\fP استفاده می‌کند.
.sp
بسته شد #3878
.IP \(bu 2
افزودن \fBuse\-list\-literal\fP: زمانی صادر می‌شود که \fBlist()\fP بدون هیچ آرگومانی به‌جای استفاده از \fB[]\fP فراخوانی شود
.sp
بسته شد #4365
.IP \(bu 2
افزودن \fBuse\-dict\-literal\fP: زمانی صادر می‌شود که \fBdict()\fP بدون هیچ آرگومانی به‌جای استفاده از \fB{}\fP فراخوانی شود
.sp
بسته شد #4365
.IP \(bu 2
افزودن افزونه اختیاری \fBconsider\-ternary\-expression\fP: زمانی صادر می‌شود که یک متغیر در هر دو شاخه یک بلوک if/else مقداردهی شود.
.sp
بسته شد #4366
.IP \(bu 2
افزودن افزونه اختیاری \fBwhile\-used\fP: هر زمان که یک حلقه \fBwhile\fP استفاده شود، صادر می‌شود.
.sp
بسته شد #4367
.IP \(bu 2
افزودن \fBforgotten\-debug\-statement\fP: زمانی صادر می‌شود که فراخوانی‌های \fBbreakpoint\fP، \fBpdb.set_trace\fP یا \fBsys.breakpointhook\fP یافت شوند
.sp
بسته شد #3692
.IP \(bu 2
رفع مثبت کاذب در \fBunused\-private\-member\fP هنگام استفاده از توابع تودرتو درون یک کلاس
.sp
بسته شد #4673
.IP \(bu 2
رفع فروپاشی در \fBunused\-private\-member\fP که با مشخصه‌های تودرتو رخ می‌داد.
.sp
بسته شد #4755
.IP \(bu 2
رفع مثبت کاذب در \fBunused\-private\-member\fP برای نام‌های کلاس
.sp
بسته شد #4681
.IP \(bu 2
رفع مثبت‌های کاذب در \fBsuperfluous\-parens\fP با عملگر walrus، عملگر سه‌تایی و درون تعاریف فشرده لیست (list comprehension).
.sp
بسته شد #2818
بسته شد #3249
بسته شد #3608
بسته شد #4346
.IP \(bu 2
افزودن بررسی‌کننده \fBformat\-string\-without\-interpolation\fP: زمانی صادر می‌شود که قالب‌بندی روی یک رشته بدون وجود هیچ متغیری برای جایگزینی اعمال شود
.sp
بسته شد #4042
.IP \(bu 2
بازآرایی گزینه‌های \fB\-\-list\-msgs\fP و \fB\-\-list\-msgs\-enabled\fP: اکنون هر دو گزینه نشان می‌دهند که آیا پیام‌ها با مفسر فعلی قابل صدور هستند یا خیر.
.sp
بسته شد #4778
.IP \(bu 2
رفع منفی کاذب در \fBused\-before\-assignment\fP هنگامی که متغیر درون یک مدیر استثنا (exception handler) مقداردهی شده، اما بیرون از آن استفاده شده است.
.sp
بسته شد #626
.IP \(bu 2
افزودن گزینه \fBdisable\-next\fP: امکان استفاده از \fI# pylint: disable\-next=msgid\fP را برای غیرفعال کردن یک پیام در خط بعدی فراهم می‌کند
.sp
بسته شد #1682
.IP \(bu 2
افزودن بررسی‌کننده \fBredundant\-u\-string\-prefix\fP: زمانی صادر می‌شود که پیشوند u به یک رشته اضافه شده باشد
.sp
بسته شد #4102
.IP \(bu 2
اصلاح بررسی‌کننده \fBcell\-var\-from\-loop\fP: مدیریت متغیرهای سلولی در تعاریف فشرده (comprehensions) درون توابع و عبارات آرگومان‌های پیش‌فرض توابع. همچنین مدیریت سایه‌اندازی پایه‌ای متغیرها (variable shadowing).
.sp
بسته شد #2846
بسته شد #3107
.IP \(bu 2
رفع اشکال در بررسی‌کننده \fBcell\-var\-from\-loop\fP: در حالتی که هر دو گزینه \fBunused\-variable\fP و \fBused\-before\-assignment\fP غیرفعال باشند، دیگر موارد منفی کاذب رخ نمی‌دهد.
.IP \(bu 2
رفع مثبت کاذب در \fBinvalid\-all\-format\fP در صورت استفاده از توابع توکار list یا tuple
.sp
بسته شد #4711
.IP \(bu 2
فایل‌های پیکربندی اکنون می‌توانند حاوی متغیرهای محیطی باشند
.sp
بسته شد #3839
.IP \(bu 2
رفع مثبت کاذب در \fBused\-before\-assignment\fP همراه با یک عبارت انتساب در یک گره \fBReturn\fP
.sp
بسته شد #4828
.IP \(bu 2
افزودن \fBuse\-sequence\-for\-iteration\fP: زمانی صادر می‌شود که روی یک \fBset\fP تعریف‌شده به صورت برخط (in\-place) پیمایش انجام شود.
.IP \(bu 2
\fBCodeStyleChecker\fP
.INDENT 2.0
.IP \(bu 2
محدود کردن صدور \fBconsider\-using\-tuple\fP تنها برای \fBlists\fP تعریف‌شده به صورت برخط (in\-place).
.IP \(bu 2
صدور \fBconsider\-using\-tuple\fP حتی در صورتی که لیست حاوی یک عبارت ستاره‌دار (\fBstarred\fP) باشد.
.UNINDENT
.IP \(bu 2
نادیده گرفتن خطوط دکوراتورها توسط بررسی‌کننده شباهت‌ها زمانی که پرچم ignore signatures فعال است
.sp
بسته شد #4839
.IP \(bu 2
مجاز بودن مقادیر \fBtrue\fP و \fBfalse\fP در \fBpylintrc\fP برای سازگاری بهتر با پیکربندی \fBtoml\fP\&.
.IP \(bu 2
با فعال بودن گزینه شباهت‌های \(dqignore\-signatures\(dq، امضای متدهای کلاس به همان شیوه توابع نادیده گرفته می‌شوند
.sp
بسته شد #4653
.IP \(bu 2
بهبود کارایی هنگام استنتاج گره‌های \fBCall\fP با بهره‌گیری از حافظه پنهان (caching)..IP \(bu 2
بهبود پیام خطا برای invalid\-metaclass / E1139 \%<#\:invalid-metaclass> هنگامی که گره (node) یک Instance است.
.UNINDENT
.SS تازه‌های Pylint 2.9
.sp
از آغاز کار pylint تا نسخهٔ 2.14.0 (شامل آن)، گزارش تغییراتی (changelog) داشتیم که شامل \fIتمام\fP
تغییرات غیرجزئی Pylint می‌شد؛ از جمله تغییراتی که برای کاربران نهایی ملموس نبودند،
یعنی تغییراتی که شاید تنها اگر توسعه‌دهندهٔ pylint یا افزونه‌های آن بودید، یا یک تاریخ‌نگار منبع‌باز، برایتان جذابیت داشتند.
.sp
از pylint 1.6.0 تا 2.14.0، علاوه بر گزارش تغییرات کامل، خلاصه‌ای از تغییرات (عمدتاً کاربرمحور) نیز ارائه می‌شد.
.SS خلاصه \-\- نکات برجستهٔ این انتشار
.sp
اکنون Pylint با python 3.10 سازگار است.
.sp
بررسی‌های جدید زیادی اضافه شده‌اند؛ برخی هشدارهای کارایی غیرسلیقه‌ای مانند \fBuse\-maxsplit\-arg\fP،
برخی هشدارهای شیوه‌نامهٔ نگارشِ مورد توافق همگانی مانند
\fBunnecessary\-dict\-index\-lookup\fP یا بررسی‌های جدید برای موارد منسوخ‌شده (deprecation).
.sp
هدف ما کاهش هشدارهای اضافی (noise) pylint برای کاربرانی است که برای نخستین‌بار از آن استفاده می‌کنند و اختیاری کردن برخی از
بررسی‌های جدید گامی در همین راستا است. بدین منظور، یک بررسی‌کنندهٔ اختیاریِ شیوه‌نامهٔ کد ایجاد کرده‌ایم که می‌توان
آن را با استفاده از \fBpylint.extensions.code_style\fP از طریق گزینهٔ \fBload\-plugins\fP بارگذاری کرد.
بیش از هر زمان دیگر، اگر به عنوان یک کاربر باتجربه خواهان دریافت بیشترین تعداد بررسی‌های ممکن هستید،
باید فهرست افزونه‌های pylint را بررسی کنید: \%<https://\:pylint\:.readthedocs\:.io/\:en/\:latest/\:user_guide/\:checkers/\:extensions\:.html#\:optional-checkers>\&.
.SS بررسی‌کننده‌های جدید
.INDENT 0.0
.IP \(bu 2
\fBdeprecated\-decorator\fP: هنگامی صادر می‌شود که از یک دکوراتور منسوخ‌شده استفاده شود.
.IP \(bu 2
\fBconsider\-using\-dict\-items\fP: هنگامی صادر می‌شود که روی کلیدهای دیکشنری پیمایش صورت گیرد و سپس
در بدنهٔ حلقه با همان کلید به دیکشنری نمایه (index) زده شود.
.IP \(bu 2
\fBuse\-maxsplit\-arg\fP: هنگامی صادر می‌شود که تنها به اولین یا آخرین
عنصر از \fBstr.split()\fP دسترسی پیدا شود.
.IP \(bu 2
گزینهٔ \fBignore_signatures\fP به بررسی‌کنندهٔ شباهت اضافه شده است. این گزینه امکان می‌دهد موارد مثبت کاذب در زمانی که چندین تابع پارامترهای یکسانی دارند کاهش یابد.
.IP \(bu 2
\fBunnecessary\-dict\-index\-lookup\fP: هنگامی صادر می‌شود که روی آیتم‌های دیکشنری
(جفت‌های کلید\-مقدار) پیمایش صورت گیرد و دسترسی به مقدار از طریق جستجوی نمایه انجام شود.
.IP \(bu 2
\fBconsider\-using\-from\-import\fP: هنگامی صادر می‌شود که یک زیرپیمانه/عضو از یک بسته وارد (import) شده و با همان نام نام‌گذاری مستعار (alias) شود.
.IP \(bu 2
بررسی‌کنندهٔ جدید \fBunused\-private\-member\fP: هنگامی صادر می‌شود که یک عضو خصوصی (یعنی عضوی که با \fB__\fP آغاز می‌شود) در یک کلاس تعریف شده اما استفاده نشود.
.IP \(bu 2
بررسی‌کنندهٔ جدید \fBinvalid\-class\-object\fP: هنگامی صادر می‌شود که مقداری غیر از کلاس به مشخصهٔ \fB__class__\fP نسبت داده شود.
.IP \(bu 2
\fBinvalid\-all\-format\fP: هنگامی صادر می‌شود که \fB__all__\fP قالبی نامعتبر داشته باشد،
یعنی یک \fBtuple\fP یا \fBlist\fP نباشد.
.IP \(bu 2
بررسی‌کنندهٔ جدید \fBawait\-outside\-async\fP: هنگامی صادر می‌شود که await در خارج از یک تابع async استفاده شود.
.IP \(bu 2
افزودن افزونهٔ جدید \fBCodeStyleChecker\fP\&. این افزونه شامل بررسی‌کننده‌هایی است که می‌توانند
یکدستی کد را بهبود بخشند. از این رو لزوماً مزیتی در کارایی ارائه نمی‌دهند
و در بسیاری از موارد سلیقه‌ای (opinionated) هستند.
.INDENT 2.0
.IP \(bu 2
\fBconsider\-using\-tuple\fP: هنگامی صادر می‌شود که یک لیست یا مجموعهٔ تعریف‌شده به‌صورت درجا بتواند با یک چندتایی (tuple) جایگزین شود.
.IP \(bu 2
\fBconsider\-using\-namedtuple\-or\-dataclass\fP: هنگامی صادر می‌شود که مقادیر دیکشنری
بتوانند با نمونه‌هایی از namedtuple یا dataclass جایگزین شوند.
.UNINDENT
.UNINDENT
.SS تغییرات دیگر
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب \fBconsider\-using\-with\fP (R1732) در صورتی که یک شرط سه‌گانه همراه با \fBwith\fP استفاده شده باشد.
.IP \(bu 2
رفع مثبت کاذب \fBconsider\-using\-with\fP (R1732) در صورتی که \fBcontextlib.ExitStack\fP وظیفهٔ فراخوانی متد \fB__exit__\fP را بر عهده داشته باشد.
.IP \(bu 2
افزودن یادداشت‌های نوع به فایل‌های dot در pyreverse.
.IP \(bu 2
برچسب‌های Pylint اکنون به قالب استاندارد \fBvX.Y.Z\fP هستند و دیگر به صورت \fBpylint\-X.Y.Z\fP نخواهند بود.
.IP \(bu 2
رفع مثبت کاذب \fBtoo\-many\-ancestors\fP هنگام ارث‌بری از کلاس‌های توکار،
به‌ویژه از پیمانهٔ \fBcollections.abc\fP.
.IP \(bu 2
پیام‌های خروجی برای خطای \fBarguments\-differ\fP بر اساس حالت‌های مختلف خطا سفارشی‌سازی شده‌اند.
.IP \(bu 2
گزینهٔ جدید \fB\-\-fail\-on=<msg ids>\fP برای بازگرداندن کدهای خروج غیرصفر صرف‌نظر از مقدار \fBfail\-under\fP.
.IP \(bu 2
خطای جدیدی به نام \fBarguments\-renamed\fP ایجاد شده است که هرگونه تغییر در نام پارامترهای
توابع بازنویسی‌شده (overridden) را شناسایی می‌کند. این خطا با هدف جداسازی کارایی \fBarguments\-differ\fP پیاده‌سازی شده است.
.IP \(bu 2
رفع ناسازگاری با Python 3.6.0 ناشی از استفاده از \fBtyping.Counter\fP و \fBtyping.NoReturn\fP.
.IP \(bu 2
امکان استفاده از فهرست جداشده با کاما در \fBoutput\-format\fP و جداسازی فایل‌های خروجی برای
هر قالب تعیین‌شده. هر فایل خروجی را می‌توان بعد از یک دونقطه تعیین کرد، برای مثال: \fB\-\-output\-format=json:myfile.json,colorized\fP
.IP \(bu 2
بررسی‌کنندهٔ \fBusing\-constant\-test\fP اکنون شرط‌های ثابتی را که شامل لیترال‌های لیست مانند
\fB[]\fP و \fB[1, 2, 3]\fP هستند شناسایی می‌کند.
.IP \(bu 2
دستور پیکربندی \fBignore\-paths\fP افزوده شد. الگوهای عبارات باقاعده (regex) تعریف‌شده با مسیر فایل تطبیق داده می‌شوند.
.IP \(bu 2
افزودن پشتیبانی از مقادیر ممیز شناور هنگام تجزیهٔ پیکربندی از pyproject.toml.
.IP \(bu 2
رفع مثبت کاذب \fBuseless\-type\-doc\fP در آرگومان نادیده‌گرفته‌شده با استفاده از \fBpylint.extensions.docparams\fP هنگامی که تابع با استفاده از pep484 دارای نوع تعیین‌شده بود اما نوع در داخل docstring ذکر نشده بود.
.IP \(bu 2
رفع عدم پشتیبانی از شناسایی نام‌های مستعار منسوخ‌شده برای توابع/متدهای موجود.
.IP \(bu 2
افزودن توابع/متدهای منسوخ‌شدهٔ گوناگون برای python 3.10، 3.7، 3.6 و 3.3.
.IP \(bu 2
عدم صدور مجدد \fBconsider\-using\-with\fP برای \fBThreadPoolExecutor\fP و \fBProcessPoolExecutor\fP
به دلیل این‌که کاربردهای موجهی بدون بلوک \fBwith\fP دارند.
.IP \(bu 2
رفع خرابی هنگامی که یک شیء قابل‌فراخوانی (callable) که یک مدیر زمینه برمی‌گرداند به یک آیتم از لیست یا دیکشنری اختصاص داده می‌شد.
.UNINDENT.SS فهرست کامل تغییرات
.SS چه مواردی در Pylint 2.9.6 جدید است؟
.sp
تاریخ انتشار: 2021\-07\-28
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب \fBundefined\-variable\fP هنگامی که نام متغیر در دکوراتور
با آرگومان تابع مطابقت دارد
.sp
بستن #3791
.UNINDENT
.SS چه مواردی در Pylint 2.9.5 جدید است؟
.sp
تاریخ انتشار: 2021\-07\-21
.INDENT 0.0
.IP \(bu 2
رفع یک خرابی هنگامی که خطای \(aqTypeError object does not support
item assignment\(aq در کدی که تجزیه می‌شود وجود داشته باشد.
.sp
بستن #4439
.IP \(bu 2
رفع خرابی در صورتی که یک شیء قابل فراخوانی با مقدار بازگشتی context manager، به یک آیتم از list یا dict انتساب داده می‌شد
.sp
بستن #4732
.IP \(bu 2
رفع یک خرابی هنگامی که یک AttributeInferenceError در زمان عدم موفقیت
در استنتاج نام واقعی یک import در astroid به‌درستی مدیریت نمی‌شد.
.sp
بستن #4692
.UNINDENT
.SS چه مواردی در Pylint 2.9.4 جدید است؟
.sp
تاریخ انتشار: 2021\-07\-20
.INDENT 0.0
.IP \(bu 2
افزودن \fBtime.clock\fP به توابع/متدهای منسوخ‌شده برای python 3.3
.IP \(bu 2
رفع باگی که در آن \-\-fail\-on حتی در صورت وجود اشکال مشخص‌شده، می‌توانست کد خروج صفر را بازگرداند
.sp
بستن #4296
بستن #3363
.IP \(bu 2
رفع شکست سخت هنگام مدیریت صفت ناموجود در کلاسی با پایه‌های تکراری
.sp
بستن #4687
.IP \(bu 2
رفع مثبت کاذب \fBconsider\-using\-with\fP (R1732) در صورتی که یک عبارت شرطی سه‌گانه همراه با \fBwith\fP استفاده شود
.sp
بستن #4676
.IP \(bu 2
رفع مثبت کاذب \fBdeprecated\-module\fP هنگامی که یک import نسبی از نام ماژول منسوخ‌شده استفاده می‌کند.
.sp
بستن #4629
.IP \(bu 2
رفع مثبت کاذب \fBconsider\-using\-with\fP (R1732) در صورتی که \fBcontextlib.ExitStack\fP وظیفه فراخوانی متد \fB__exit__\fP را به عهده داشته باشد
.sp
بستن #4654
.IP \(bu 2
رفع یک مثبت کاذب برای \fBunused\-private\-member\fP هنگام تغییر دادن یک صفت خصوصی
با \fBcls\fP
.sp
بستن #4657
.IP \(bu 2
رفع نادیده گرفته شدن توابع خالی توسط بررسی‌کننده تشابه‌ها با فعال بودن گزینه \(dqignore\-signatures\(dq
.sp
بستن #4652
.IP \(bu 2
رفع مثبت کاذب \fBuse\-maxsplit\-arg\fP هنگامی که اندیس در
یک حلقه افزایش می‌یابد
.sp
بستن #4664
.IP \(bu 2
عدم صدور پیام \fBcyclic\-import\fP در صورتی که import توسط \fBtyping.TYPE_CHECKING\fP محافظت شده باشد\&.
.sp
بستن #3525
.IP \(bu 2
رفع مثبت کاذب \fBnot\-callable\fP با نحو جایگزین \fBTypedDict\fP
.sp
بستن #4715
.IP \(bu 2
شفاف‌سازی مستندات برای consider\-using\-from\-import / R0402 \%<#\:consider-using-from-import>
.IP \(bu 2
عدم صدور هشدار \fBunreachable\fP برای توابع مولد خالی
.sp
بستن #4698
.IP \(bu 2
عدم صدور \fBimport\-error\fP، \fBno\-name\-in\-module\fP و \fBungrouped\-imports\fP
برای importهایی که توسط \fBsys.version_info\fP یا \fBtyping.TYPE_CHECKING\fP محافظت شده‌اند\&.
.sp
بستن #3285
بستن #3382
.IP \(bu 2
رفع \fBinvalid\-overridden\-method\fP در خصوصیت‌های تو در تو
.sp
بستن #4368
.IP \(bu 2
رفع مثبت کاذب \fBunused\-private\-member\fP هنگام استفاده از \fB__new__\fP در یک کلاس
.sp
بستن #4668
.IP \(bu 2
عدم صدور پیام \fBconsider\-using\-with\fP برای \fBThreadPoolExecutor\fP و \fBProcessPoolExecutor\fP
زیرا آن‌ها کاربردهای معتبری بدون بلوک \fBwith\fP دارند.
.sp
بستن #4689
.IP \(bu 2
رفع خرابی هنگام استنتاج متغیرهای انتساب‌یافته در الگوهای match
.sp
بستن #4685
.IP \(bu 2
رفع یک خرابی هنگامی که در زمان استنتاج یک تابع معیوب در یک context manager،
استثنای StopIteration برانگیخته می‌شد.
.sp
بستن #4723
.UNINDENT.SS چه مواردی در Pylint 2.9.3 جدید است؟
.sp
تاریخ انتشار: 2021\-07\-01
.INDENT 0.0
.IP \(bu 2
رفع خطای فروپاشی هنگام تحلیل تابع خالی دارای docstring در بررسی‌کنندهٔ \fBsimilarity\fP\&.
.sp
بسته شدن #4648
.IP \(bu 2
بررسی‌کنندهٔ \fBsimilarity\fP دیگر سه فاصلهٔ خالی انتهایی را برای خط‌های خالی در گزارش خود اضافه نمی‌کند.
.UNINDENT
.SS چه مواردی در Pylint 2.9.2 جدید است؟
.sp
تاریخ انتشار: 2021\-07\-01
.INDENT 0.0
.IP \(bu 2
رفع خطای فروپاشی هنگام تحلیل کدی که از \fBtype(self)\fP برای دسترسی به یک ویژگی کلاس در بررسی‌کنندهٔ \fBunused\-private\-member\fP استفاده می‌کرد.
.sp
بسته شدن #4638
.IP \(bu 2
رفع مثبت کاذب در \fBunused\-private\-member\fP هنگام دسترسی به یک متغیر خصوصی با \fBself\fP\&.
.sp
بسته شدن #4644
.IP \(bu 2
رفع مثبت کاذب در \fBunnecessary\-dict\-index\-lookup\fP و \fBconsider\-using\-dict\-items\fP برای جستجوهای نمایهٔ دیکشنری که دوباره مقداردهی شده‌اند.
.sp
بسته شدن #4630
.UNINDENT
.SS چه مواردی در Pylint 2.9.1 جدید است؟
.sp
تاریخ انتشار: 2021\-06\-30
.INDENT 0.0
.IP \(bu 2
ارتقای astroid به نسخهٔ 2.6.2
.sp
بسته شدن #4631
بسته شدن #4633
.UNINDENT
.SS چه مواردی در Pylint 2.9.0 جدید است؟
.sp
تاریخ انتشار: 2021\-06\-29
.INDENT 0.0
.IP \(bu 2
اکنون از Python 3.10 پشتیبانی می‌شود.
.IP \(bu 2
افزودن حاشیه‌نویسی‌های نوع به فایل‌های dot در pyreverse\&.
.sp
بسته شدن #1548
.IP \(bu 2
رفع عدم پشتیبانی از شناسایی نام‌های مستعار منسوخ‌شده برای توابع/متدهای موجود.
.sp
بسته شدن #4618
.IP \(bu 2
بستهٔ astroid به نسخهٔ 2.6.1 ارتقا یافت.
.IP \(bu 2
افزودن توابع/متدهای منسوخ‌شدهٔ گوناگون برای python 3.10، 3.7، 3.6 و 3.3\&.
.IP \(bu 2
رفع مثبت کاذب \fBuseless\-type\-doc\fP برای آرگومان نادیده‌گرفته‌شده هنگام استفاده از \fBpylint.extensions.docparams\fP در شرایطی که نوع تابع با pep484 تعیین شده بود اما نه در داخل docstring\&.
.sp
بسته شدن #4117
بسته شدن #4593
.IP \(bu 2
بستهٔ \fBsetuptools_scm\fP حذف شده و با \fBtbump\fP جایگزین شد تا وابستگی‌های پنهان زمان اجرا به setuptools حذف گردند.
.IP \(bu 2
رفع خطای فروپاشی هنگامی که یک تابع آزمون با \fB@pytest.fixture\fP تزیین شده و astroid نمی‌تواند نام دکوراتور را هنگام استفاده از \fBopen\fP بدون \fBwith\fP استنتاج کند.
.sp
بسته شدن #4612
.IP \(bu 2
افزودن \fBdeprecated\-decorator\fP: زمانی که از یک دکوراتور منسوخ‌شده استفاده شود صادر می‌شود.
.sp
بسته شدن #4429
.IP \(bu 2
افزودن رفتار \fBignore\-paths\fP\&. الگوهای regex تعریف‌شده با مسیر کامل فایل تطبیق داده می‌شوند.
.sp
بسته شدن #2541
.IP \(bu 2
رفع منفی کاذب برای \fBconsider\-using\-with\fP در صورتی که فراخوانی‌هایی مانند \fBopen()\fP خارج از عبارات انتساب استفاده می‌شدند.
.IP \(bu 2
هشدار مربوط به \fBarguments\-differ\fP اکنون تفاوت شناسایی‌شده را با ذکر نام آرگومان یا آرگومان‌های تغییریافته و نوع تغییر رخ‌داده به‌طور صریح مشخص می‌کند.
.IP \(bu 2
سرکوب \fBconsider\-using\-with\fP درون مدیران زمینه (context managers).
.sp
بسته شدن #4430
.IP \(bu 2
افزودن گزینهٔ \fB\-\-fail\-on\fP برای بازگرداندن کدهای خروج غیرصفر، صرف‌نظر از مقدار \fB\-\-fail\-under\fP\&.
.IP \(bu 2
چندتایی numversion دوباره حاوی اعداد صحیح است تا مشکل چندین افزونهٔ pylint که به آن وابسته بودند رفع شود.
.sp
بسته شدن #4420
.IP \(bu 2
رفع مثبت کاذب \fBtoo\-many\-ancestors\fP هنگام ارث‌بری از کلاس‌های توکار، به‌ویژه از ماژول \fBcollections.abc\fP\&.
.sp
بسته شدن #4166
بسته شدن #4415
.IP \(bu 2
بررسی ماژول‌های منسوخ‌شدهٔ کتابخانهٔ استاندارد (Stdlib) به بررسی‌کنندهٔ stdlib منتقل شد. ماژول‌های منسوخ‌شدهٔ جدید اضافه شدند.
.IP \(bu 2
رفع صدور مثبت کاذب \fBno\-member\fP برای ویژگی‌های انتزاعی.
.IP \(bu 2
ایجاد پیام خطای جدیدی به نام \fBarguments\-renamed\fP که هرگونه تغییر در نام پارامترهای توابع بازنویسی‌شده را شناسایی می‌کند.
.sp
بسته شدن #3536
.IP \(bu 2
بررسی‌کنندهٔ جدید \fBconsider\-using\-dict\-items\fP\&. هنگامی صادر می‌شود که روی کلیدهای دیکشنری پیمایش صورت گیرد و سپس به همان دیکشنری با آن کلید در بدنهٔ حلقه نمایه داده شود.
.sp
بسته شدن #3389
.IP \(bu 2
عدم صدور \fBimport\-error\fP اگر وارد کردن ماژول پشت عبارت \fBif sys.version_info >= (x, x)\fP محافظت شده باشد.
.IP \(bu 2
رفع ناسازگاری با Python 3.6.0 ناشی از استفاده از \fBtyping.Counter\fP و \fBtyping.NoReturn\fP\&.
.sp
بسته شدن #4412
.IP \(bu 2
بررسی‌کنندهٔ جدید \fBuse\-maxsplit\-arg\fP\&. هنگامی صادر می‌شود که تنها به اولین یا آخرین عنصر \fBstr.split()\fP دسترسی پیدا شود.
.sp
بسته شدن #4440
.IP \(bu 2
افزودن ignore_signatures به بررسی‌کنندهٔ کدهای تکراری.
.sp
بسته شدن #3619
.IP \(bu 2
رفع خطاهای مستندات در بند \(dqBlock disables\(dq از راهنمای کاربر.
.IP \(bu 2
بررسی‌کنندهٔ جدید \fBunnecessary\-dict\-index\-lookup\fP\&. زمانی صادر می‌شود که روی آیتم‌های دیکشنری (جفت‌های کلید\-مقدار) پیمایش انجام شده و به مقدار از طریق جستجوی نمایه دسترسی پیدا شود.
.sp
بسته شدن #4470
.IP \(bu 2
بررسی‌کنندهٔ جدید \(ga\(gaconsider\-using\-from\-import\(ga\(ga\&. هنگامی که یک زیرماژول/عضو از یک بسته وارد شده و با همان نام مستعارگذاری شود، صادر می‌شود.
.sp
بسته شدن #2309
.IP \(bu 2
پشتیبانی از فهرست جداشده با کاما در \fBoutput\-format\fP و فایل‌های خروجی جداگانه برای هر قالب مشخص‌شده.
.sp
بسته شدن #1798
.IP \(bu 2
توانمندسازی \fBusing\-constant\-test\fP در تشخیص آزمون‌های ثابت متشکل از لیترال‌های لیست مانند \fB[]\fP و \fB[1, 2, 3]\fP\&.
.IP \(bu 2
بهبود پیام خطای بررسی‌کنندهٔ \fBunnecessary\-comprehension\fP با ارائهٔ پیشنهاد کد.
.sp
بسته شدن #4499
.IP \(bu 2
بررسی‌کنندهٔ جدید \fBunused\-private\-member\fP\&. هنگامی صادر می‌شود که یک عضو خصوصی (یعنی عضوی که با \fB__\fP شروع می‌شود) از یک کلاس تعریف شده اما استفاده نشده باشد.
.sp
بسته شدن #4483
.IP \(bu 2
رفع منفی کاذب در \fBconsider\-using\-enumerate\fP هنگام پیمایش روی یک ویژگی.
.sp
بسته شدن #3657
.IP \(bu 2
بررسی‌کنندهٔ جدید \fBinvalid\-class\-object\fP\&. هنگامی صادر می‌شود که یک غیرکلاس به ویژگی \fB__class__\fP منتسب گردد.
.sp
بسته شدن #585
.IP \(bu 2
رفع خطای فروپاشی هنگام عدم امکان بارگیری یک افزونه از پیکربندی، و ایجاد خطای bad\-plugin\-value / E0013 \%<#\:bad-plugin-value>\(aq به‌جای آن.
.sp
بسته شدن #4555
.IP \(bu 2
افزودن پشتیبانی از مقادیر ممیز شناور هنگام تجزیهٔ پیکربندی از pyproject.toml\&.
.sp
بسته شدن #4518.IP \(bu 2
\fBinvalid\-length\-returned\fP، در پی ارتقایی در astroid اکنون هنگامی که اصلاً چیزی بازگردانده نمی‌شود نیز کار می‌کند.
.IP \(bu 2
\fBlogging\-format\-interpolation\fP و \fBlogging\-not\-lazy\fP، در پی ارتقایی در astroid اکنون روی کلاس لاگر ایجادشده از یک import تغییرنام‌یافتهٔ logging کار می‌کنند.
.IP \(bu 2
رفع مثبت کاذب \fBno\-member\fP با کلاس پایهٔ جنریک (generic)
.sp
بسته شد: pylint\-dev/astroid#942
.IP \(bu 2
رفع مثبت کاذب \fBassigning\-non\-slot\fP با کلاسی پایه که از \fBtyping.Generic\fP ارث‌بری می‌کند
.sp
بسته شد: #4509
بسته شد: pylint\-dev/astroid#999
.IP \(bu 2
وارسی‌کنندهٔ جدید \fBinvalid\-all\-format\fP\&. زمانی صادر می‌شود که \fB__all__\fP قالب نامعتبری داشته باشد، یعنی یک \fBtuple\fP یا \fBlist\fP نباشد.
.IP \(bu 2
رفع مثبت کاذب \fBunused\-variable\fP و \fBundefined\-variable\fP با تطبیق الگو (Pattern Matching) در Python 3.10
.IP \(bu 2
وارسی‌کنندهٔ جدید \fBawait\-outside\-async\fP\&. زمانی صادر می‌شود که await بیرون از یک تابع async استفاده شود.
.IP \(bu 2
شفاف‌سازی مستندات برای افزونهٔ \fBtyping\fP\&.
.sp
بسته شد: #4545
.IP \(bu 2
افزودن افزونهٔ جدید \fBCodeStyleChecker\fP\&. این افزونه شامل وارسی‌کننده‌هایی است که می‌توانند یکدستی کد را بهبود بخشند. از این رو لزوماً مزیتی در کارایی ایجاد نمی‌کنند و اغلب اوقات سلیقه‌ای (opinionated) هستند.
.IP \(bu 2
وارسی‌کنندهٔ جدید \fBconsider\-using\-tuple\fP\&. زمانی صادر می‌شود که بتوان یک لیست یا مجموعهٔ تعریف‌شده درجا (in\-place) را با یک tuple جایگزین کرد.
.IP \(bu 2
وارسی‌کنندهٔ جدید \fBconsider\-using\-namedtuple\-or\-dataclass\fP\&. زمانی صادر می‌شود که مقادیر دیکشنری را بتوان با نمونه‌های namedtuple یا dataclass جایگزین کرد.
.IP \(bu 2
رفع خطایی که هنگام استفاده از \fBslice\fP به عنوان زیرنویس (subscript) برای dict رخ می‌داد.
.IP \(bu 2
کاهش مثبت‌های کاذب در استنتاج ویژگی‌های \fB\&.value\fP و \fB\&.name\fP در زیرکلاس‌های \fBEnum\fP، در پی ارتقایی در astroid
.sp
بسته شد: #1932
بسته شد: #2062
.IP \(bu 2
رفع اشکال مربوط به \fBcached_property\fP که هنگام بازنویسی (override) یک \fBproperty\fP موجب خطای \fBinvalid\-overridden\-method\fP می‌شد.
.sp
بسته شد: #4023
.IP \(bu 2
رفع مثبت کاذب \fBunused\-import\fP برای ماژول‌های واردشده‌ای که در جستجوی صفت‌ها در کامنت‌های نوع (type comments) به آن‌ها ارجاع داده شده است.
.sp
بسته شد: #4603
.UNINDENT
.SS "تازه‌های Pylint 2.8"
.sp
از آغاز pylint تا نسخهٔ 2.14.0 (شامل این نسخه)، سیاهه‌تغییراتی داشتیم که دربردارندهٔ \fIتمام\fP تغییرات غیرجزئی Pylint بود؛ از جمله تغییراتی که رو به کاربر نبودند، یعنی تغییراتی که تنها در صورتی برای شما جالب بودند که توسعه‌دهنده‌ای باشید که روی pylint یا افزونه‌های pylint کار می‌کند یا تاریخ‌نگار پروژه‌های متن‌باز باشید.
.sp
از pylint 1.6.0 تا 2.14.0، علاوه بر سیاهه‌تغییرات کامل، خلاصه‌ای از تغییرات (عمدتاً رو به کاربر) نیز وجود داشت.
.SS "خلاصه \-\- نکات برجستهٔ انتشار"
.SS "تغییرات ساختارشکن"
.INDENT 0.0
.IP \(bu 2
وابستگی اضافی \(aqdoc\(aq (extra\-require) حذف شده است. \fI__pkginfo__\(ga\fP دیگر شامل متاداده‌های بسته نیست (به‌جز \fBnumversion\fP، تا نسخهٔ 3.0). متاداده‌ها از این طریق قابل دسترسی هستند:
.UNINDENT
.sp
\fB\(gapython
from importlib import metadata
metadata.metadata(\(aqpylint\(aq)
\(ga\fP
این روش را به import کردن از \fB__pkginfo__\fP ترجیح دهید.
.SS "وارسی‌کننده‌های جدید"
.INDENT 0.0
.IP \(bu 2
پیام بازآرایی جدید \fBconsider\-using\-with\fP\&. این پیام زمانی صادر می‌شود که توابع یا متدهای تخصیص‌دهندهٔ منابع در کتابخانهٔ استاندارد (مانند \fBopen()\fP یا \fBthreading.Lock.acquire()\fP) که می‌توانند به عنوان context manager استفاده شوند، بدون بلوک \fBwith\fP فراخوانی شوند.
.IP \(bu 2
افزودن وارسی \fBdeprecated\-argument\fP برای آرگومان‌های منسوخ‌شده.
.IP \(bu 2
افزودن افزونهٔ جدید \fBConfusingConsecutiveElifChecker\fP\&. این وارسی‌کنندهٔ اختیاری در صورتی که دستورهای if/elif با سطوح تورفتگی متفاوت مستقیماً پشت سر هم بیایند، یک پیام بازآرایی (R5601 \fBconfusing\-consecutive\-elif\fP) صادر می‌کند.
.IP \(bu 2
افزودن وارسی \fBconsider\-using\-min\-max\-builtin\fP برای دستورهای if که می‌توانند با min یا max توکار پایتون جایگزین شوند.
.IP \(bu 2
افزودن افزونهٔ جدید \fBTypingChecker\fP\&. این وارسی‌کنندهٔ اختیاری می‌تواند استفاده از نام‌های مستعار منسوخ‌شدهٔ typing را شناسایی کرده و در صورت امکان استفاده از نحو جایگزین union را پیشنهاد کند. (برای نمونه، \(aqtyping.Dict\(aq می‌تواند با \(aqdict\(aq، و \(aqtyping.Unions\(aq با \(aq|\(aq جایگزین شود، و غیره.) اگر قصد استفاده از آن را دارید، حتماً گزینه‌های پیکربندی را بررسی کنید!
.IP \(bu 2
افزودن وارسی \fBdeprecated\-class\fP برای کلاس‌های منسوخ‌شده.
.UNINDENT.SS سایر تغییرات
.INDENT 0.0
.IP \(bu 2
گزینهٔ جدید \fB\-\-output=<file>\fP برای ذخیرهٔ نتیجه در یک فایل به جای چاپ در stdout.
.sp
بستن #1070
.IP \(bu 2
کاهش استفاده از اصطلاحات فهرست سیاه/فهرست سفید (blacklist/whitelist). به‌ویژه، \fBextension\-pkg\-allow\-list\fP
جایگزینی برای \fBextension\-pkg\-whitelist\fP است و پیام \fBblacklisted\-name\fP اکنون به عنوان
\fBdisallowed\-name\fP صادر می‌شود\&. نام‌های قبلی برای حفظ سازگاری عقبروی همچنان پذیرفته می‌شوند.
.IP \(bu 2
بسته‌بندی اکنون منحصراً از طریق setuptools انجام می‌شود. پوشه‌های \fBdoc\fP، \fBtests\fP، \fBman\fP، \fBelisp\fP و فایل \fBChangelog\fP دیگر
بسته‌بندی نمی‌شوند \- که حجم بسته را تا ۷۵٪ کاهش می‌دهد.
.IP \(bu 2
به‌روزرسانی \fBastroid\fP به 2.5.4
.IP \(bu 2
نام فایل COPYING برای استانداردسازی به LICENSE تغییر یافت.
.UNINDENT
.SS گزارش کامل تغییرات
.SS تازه‌های Pylint 2.8.3
.sp
تاریخ انتشار: 2021\-05\-31
.INDENT 0.0
.IP \(bu 2
نسخهٔ Astroid برای شاخهٔ 2.8 بر روی 2.5.6 ثابت (pinned) شده است.
.sp
ارجاع به #4527
.UNINDENT
.SS تازه‌های Pylint 2.8.2
.sp
تاریخ انتشار: 2021\-04\-26
.INDENT 0.0
.IP \(bu 2
نگه‌داشتن \fB__pkginfo__.numversion\fP به صورت یک تاپل (tuple) برای جلوگیری از شکستن pylint\-django.
.sp
بستن #4405
.IP \(bu 2
ابزار scm_setuptools به بسته‌بندی اضافه شده است.
.IP \(bu 2
برچسب‌های Pylint اکنون به شکل استاندارد \fBvX.Y.Z\fP هستند و دیگر به صورت \fBpylint\-X.Y.Z\fP نخواهند بود.
.IP \(bu 2
پیام هشدار جدید \fBdeprecated\-class\fP\&. این پیام هنگام درون‌ریزی (import) یا فراخوانی کلاس‌های منسوخ‌شدهٔ
کتابخانهٔ استاندارد صادر می‌شود (مانند \fBcollections.Iterable\fP که در Python 3.10 حذف خواهد شد).
.sp
بستن #4388
.UNINDENT
.SS تازه‌های Pylint 2.8.1
.sp
تاریخ انتشار: 2021\-04\-25
.INDENT 0.0
.IP \(bu 2
بازگرداندن موقت numversion در \fB__pkginfo__\fP به دلیل ایجاد شکست در عملکرد Pylama، و بازگردانی (revert) تغییر ناسازگار و غیرضروری
\fBpylint.version\fP\&.
.sp
بستن #4399
.UNINDENT
.SS تازه‌های Pylint 2.8.0
.sp
تاریخ انتشار: 2021\-04\-24
.INDENT 0.0
.IP \(bu 2
پیام بازآرایی (refactoring) جدید \fBconsider\-using\-with\fP\&. این پیام هنگامی صادر می‌شود که توابع یا متدهای تخصیص منابع در
کتابخانهٔ استاندارد (مانند \fBopen()\fP یا \fBthreading.Lock.acquire()\fP) که قابلیت استفاده به عنوان مدیر زمینه (context manager) را دارند، بدون
یک بلوک \fBwith\fP فراخوانی شوند.
.sp
بستن #3413
.IP \(bu 2
رفع موارد مثبت کاذب در متغیرهای استفاده‌نشده درون توابع دکوراتور
.sp
بستن #4252
.IP \(bu 2
افزودن افزونهٔ جدید \fBConfusingConsecutiveElifChecker\fP\&. این بررسی‌کنندهٔ اختیاری در صورتی که دستورهای if/elif با سطوح تورفتگی متفاوت بلافاصله پشت سر هم بیایند، یک پیام بازآرایی (R5601 \fBconfusing\-consecutive\-elif\fP) صادر می‌کند.
.IP \(bu 2
گزینهٔ جدید \fB\-\-output=<file>\fP برای ذخیرهٔ خروجی در یک فایل به جای چاپ در stdout.
.sp
بستن #1070
.IP \(bu 2
استفاده از یک پیام تجویزی (prescriptive) برای \fBunidiomatic\-typecheck\fP
.sp
بستن #3891
.IP \(bu 2
اعمال \fBconst\-naming\-style\fP بر روی ثابت‌های ماژول که با
\fBtyping.Final\fP حاشیه‌نویسی شده‌اند
.IP \(bu 2
بسته‌بندی اکنون منحصراً از طریق setuptools انجام می‌شود. پوشه‌های \fBdoc\fP، \fBtests\fP، \fBman\fP، \fBelisp\fP و فایل \fBChangelog\fP دیگر
بسته‌بندی نمی‌شوند \- که اندازهٔ بسته را تا ۷۵٪ کاهش می‌دهد.
.IP \(bu 2
بسته‌بندی دبیان اکنون (به‌طور رسمی) در \%<https://\:salsa\:.debian\:.org/\:python-team/\:packages/\:pylint>\& انجام می‌شود.
.IP \(bu 2
وابستگی اختیاری \(aqdoc\(aq (extra\-require) حذف شده است.
.IP \(bu 2
اکنون \fB__pkginfo__\fP فقط شامل \fB__version__\fP است (که از طریق \fBpylint.__version__\fP نیز در دسترس است)؛ سایر فراداده‌ها همچنان
از طریق دستور \fBfrom importlib import metadata;metadata.metadata(\(aqpylint\(aq)\fP در دسترس هستند\&.
.IP \(bu 2
نام فایل COPYING برای استانداردسازی به LICENSE تغییر یافت.
.IP \(bu 2
رفع مثبت کاذب \fBused\-before\-assignment\fP در مقادیر بازگشتی تابع.
.sp
بستن #4301
.IP \(bu 2
به‌روزرسانی \fBastroid\fP به 2.5.3
.sp
بستن #2822، #4206، #4284
.IP \(bu 2
افزودن بررسی \fBconsider\-using\-min\-max\-builtin\fP برای دستورهای if که می‌توانند با توابع توکار min یا max پایتون جایگزین شوند
.sp
بستن #3406
.IP \(bu 2
عدم فعال‌سازی خودکار ارزیابی به تعویق افتادهٔ حاشیه‌نویسی‌های نوع با Python 3.10
.IP \(bu 2
به‌روزرسانی \fBastroid\fP به 2.5.4
.IP \(bu 2
افزودن افزونهٔ جدید \fBTypingChecker\fP\&. این بررسی‌کنندهٔ اختیاری می‌تواند استفاده از نام‌های مستعار منسوخ‌شدهٔ typing را شناسایی کرده
و در صورت امکان استفاده از نحو جایگزین union را پیشنهاد دهد.
(برای مثال، \(aqtyping.Dict\(aq می‌تواند با \(aqdict\(aq، و \(aqtyping.Unions\(aq با \(aq|\(aq جایگزین شود، و غیره.)
در صورت تمایل به استفاده، حتماً گزینه‌های پیکربندی آن را بررسی کنید!
.IP \(bu 2
فعال‌سازی مجدد شمارش‌های قدیمی در حالت گزارش (report mode).
.sp
بستن #3819
.IP \(bu 2
هنگام تشخیص \fBinconsistent\-return\-statements\fP، عبارت \fBassert False\fP به عنوان یک گره بازگشتی (return node) در نظر گرفته می‌شود.
.sp
بستن #4019
.IP \(bu 2
اگر امتیاز دقیقاً برابر با \fBconfig.fail_under\fP باشد، اجرا با شکست مواجه نخواهد شد\&.
.IP \(bu 2
توابعی که هیچ‌گاه مقداری برنمی‌گردانند می‌توانند \fBNoReturn\fP را به عنوان نوع راهنما (type hint) اعلان کنند تا
\fBinconsistent\-return\-statements\fP صادر نشود.
.sp
بستن #4122، #4188
.IP \(bu 2
بهبود بررسی‌های دسترسی حفاظت‌شده (protected access) برای مجاز دانستن دسترسی در متدهای کلاس
.sp
بستن #1159
.IP \(bu 2
رفع مشکل مربوط به نحو PEP 585 و استفاده از \fBcollections.abc.Set\fP
.IP \(bu 2
رفع مشکلی که باعث می‌شد متغیرهای کلاس دارای حاشیه‌نویسی \fBtyping.ClassVar\fP به عنوان
ثابت‌های کلاس شناسایی شوند. اکنون، متغیرهای کلاسی که با
\fBtyping.Final\fP حاشیه‌نویسی شده‌اند به این صورت شناسایی می‌شوند.
.sp
بستن #4277
.IP \(bu 2
یکپارچه‌سازی مداوم با Read the Docs اضافه شده است.
.sp
بستن #3850
.IP \(bu 2
عدم نمایش \fBDuplicateBasesError\fP هنگام دسترسی به مشخصه‌ها (attributes)
.IP \(bu 2
رفع خرابی برنامه هنگام بررسی \fBsetup.cfg\fP برای پیکربندی pylint در صورت وجود نویسه‌های غیر اسکی (non\-ascii)
.sp
بستن #4328
.IP \(bu 2
امکان نادیده گرفتن کدهای محصور در بک‌تیک توسط غلط‌یاب املایی
.sp
بستن #4319
.IP \(bu 2
امکان نادیده گرفتن دستورالعمل‌های ابزارهای پایتون (مانند black، flake8، zimports، isort، mypy، bandit و pycharm) در ابتدای توضیحات توسط غلط‌یاب املایی
.sp
بستن #4320
.IP \(bu 2
رفع مشکلی که باعث ایجاد خطا در pylint مربوط به Emacs هنگام استفاده با tramp می‌شد
.IP \(bu 2
بهبود بررسی نحو نامعتبر PEP 585 در داخل توابع
در صورت فعال بودن ارزیابی به تعویق افتادهٔ حاشیه‌نویسی‌های نوع
.IP \(bu 2
بهبود بررسی نحو نامعتبر PEP 585 به عنوان آرگومان‌های پیش‌فرض تابع
.UNINDENT.SS تازه‌های Pylint 2.7
.sp
از آغاز pylint تا نگارش 2.14.0 (شامل آن)، سیاههٔ تغییراتی وجود داشت که شامل \fIتمام\fP
تغییرات غیرجزئی Pylint می‌شد؛ از جمله تغییراتی که رو به کاربر
نبودند، یعنی تغییراتی که ممکن است تنها اگر توسعه‌دهنده‌ای باشید که
روی pylint یا افزونه‌های pylint کار می‌کنید، یا تاریخ‌نگار نرم‌افزارهای متن‌باز هستید برایتان جالب باشند.
.sp
از pylint 1.6.0 تا 2.14.0، علاوه بر سیاههٔ کامل تغییرات، خلاصه‌ای
از تغییرات (عمدتاً رو به کاربر) نیز ارائه می‌شد.
.SS خلاصه \-\- نکات برجستهٔ انتشار
.INDENT 0.0
.IP \(bu 2
اکنون Python 3.6+ الزامی است.
.IP \(bu 2
حذف پیام‌های تکراری هنگام استفاده از چندین job.
.IP \(bu 2
پشتیبانی از قابلیت‌های جدید typing ارائه‌شده توسط mypy 0.8
.IP \(bu 2
کاهش تعداد هشدارهای کاذب (false positive) به طور کلی
.IP \(bu 2
کاهش وقوع بازگشت‌های واقعاً عمیق که از محدودیت سیستم فراتر می‌رفتند (برای اصلاح مربوط به pandas، گزارش #3836 را ببینید)
.UNINDENT
.SS بررسی‌کننده‌های جدید
.INDENT 0.0
.IP \(bu 2
افزودن بررسی \fBnan\-comparison\fP برای مقایسهٔ مقادیر NaN
.IP \(bu 2
افزودن پشتیبانی از \fBignored\-argument\-names\fP در DocstringParameterChecker و
افزودن پیام‌های \fBuseless\-param\-doc\fP و \fBuseless\-type\-doc\fP.
.IP \(bu 2
افزودن بررسی \fBempty\-comment\fP برای کامنت‌های خالی.
.IP \(bu 2
افزودن بررسی \fBsimplifiable\-condition\fP برای مقادیر ثابت اضافی در شرط‌های شامل and/or.
.IP \(bu 2
افزودن بررسی \fBcondition\-evals\-to\-constant\fP برای شرط‌های شامل and/or که به یک مقدار ثابت ارزیابی می‌شوند.
.IP \(bu 2
افزودن بررسی \fBconsider\-using\-generator\fP برای استفاده از ساختار list comprehension درون توابع \fBany\fP یا \fBall\fP.
.UNINDENT
.SS تغییرات دیگر
.INDENT 0.0
.IP \(bu 2
رفع هشدار کاذب برای \fBbuiltin\-not\-iterating\fP زمانی که \fBzip\fP یا \fBmap\fP شیء پیمایش‌پذیر (iterable) دریافت می‌کند
.IP \(bu 2
رفع مشکل خاموش شدن استخر پردازش موازی (multiprocessing pool) در linter که هنگام اجرای موازی با سایر افزونه‌های pytest هشدار ایجاد می‌کرد.
.IP \(bu 2
اکنون بر اساس \fBinvalid\-name\fP\& نام‌گذاری Enumها با حروف بزرگ (UPPER_CASE) الزامی است.
.IP \(bu 2
رفع اشکالی که هنگام استفاده از \fB\-\-jobs 2\fP یا بیشتر منجر به تولید پیام‌های تکراری می‌شد.
.IP \(bu 2
افزودن گزینهٔ \fBcheck\-protected\-access\-in\-special\-methods\fP در ClassChecker برای فعال/غیرفعال کردن
صدور پیام \fBprotected\-access\fP برای صفت‌های با پیشوند تک‌زیرخط در متدهای ویژه.
.IP \(bu 2
اکنون در صورتی که یکی از شاخه‌های دستور \fBtry/except\fP به طور صریح مقداری را بازنگرداند،
در حالی که دیگری بازمی‌گرداند، پیام \fBinconsistent\-return\-statements\fP صادر می‌شود.
.IP \(bu 2
رفع هشدار کاذب برای پیام \fBuseless\-super\-delegation\fP هنگامی که آرگومان کلیدواژه‌ای پیش‌فرض یک دیکشنری است.
.IP \(bu 2
رفع عبارت‌های باقاعدهٔ آسیب‌پذیر در \fBpyreverse\fP\&. ابهامات عبارت‌های باقاعدهٔ آسیب‌پذیر رفع شده و تطبیق آن‌ها ایمن‌تر و سریع‌تر شده است.
.IP \(bu 2
اکنون \fBlen\-as\-conditions\fP تنها برای کلاس‌هایی فعال می‌شود که مستقیماً از list، dict یا set ارث‌بری کرده و تابع \fB__bool__\fP را پیاده‌سازی نکرده‌اند، یا برای مولدهایی مانند range یا ساختارهای list/dict/set comprehension. این امر هشدارهای کاذب را برای سایر کلاس‌ها مانند DataFrame در pandas یا Array در numpy کاهش می‌دهد.
.IP \(bu 2
رفع مشکل در تشخیص کدهای تکراری برای \-\-jobs=2+
.IP \(bu 2
گزینهٔ جدید \fBallowed\-redefined\-builtins\fP نام متغیرهایی را که مجاز به سایه‌اندازی (shadowing) روی شناسه‌های توکار (builtins) هستند مشخص می‌کند.
.IP \(bu 2
بهبود بررسی‌های دسترسی محافظت‌شده (protected access) برای مجاز شمردن دسترسی در متدهای کلاس
.UNINDENT
.SS سیاههٔ کامل تغییرات
.SS تازه‌های Pylint 2.7.4
.sp
تاریخ انتشار: 2021\-03\-30
.INDENT 0.0
.IP \(bu 2
رفع مشکلی که در آن msgidهای غیرفعال‌شده نادیده گرفته نمی‌شدند
.sp
بسته شدن #4265
.IP \(bu 2
رفع مشکل مربوط به ثابت‌های کلاسی دارای حاشیه‌نویسی نوع (annotated)
.sp
بسته شدن #4264
.UNINDENT.SS تازه‌های Pylint 2.7.3؟
.sp
تاریخ انتشار: 2021\-03\-29
.INDENT 0.0
.IP \(bu 2
افزودن منطق برای بررسی صفت‌های منسوخ‌شده در DeprecationMixin.
.IP \(bu 2
کاهش استفاده از واژگان فهرست سیاه/فهرست سفید (blacklist/whitelist). به طور ویژه، \fBextension\-pkg\-allow\-list\fP جایگزینی برای \fBextension\-pkg\-whitelist\fP است و پیام \fBblacklisted\-name\fP اکنون به عنوان \fBdisallowed\-name\fP صادر می‌شود\&. نام‌های پیشین برای حفظ سازگاری رو به عقب همچنان پذیرفته می‌شوند.
.IP \(bu 2
انتقال بررسی‌کننده منسوخ‌شده به \fBDeprecatedMixin\fP
.sp
بستن #4086
.IP \(bu 2
ارتقای نسخه \fBastroid\fP به \fB2.5.2\fP
.IP \(bu 2
رفع مثبت کاذب برای \fBmethod\-hidden\fP هنگام استفاده از صفت و متد خصوصی
.sp
بستن #3936
.IP \(bu 2
قابلیت \fBuse\-symbolic\-message\-instead\fP اکنون روی پیام‌های قدیمی مانند \fBC0111\fP (\fBmissing\-docstring\fP) نیز کار می‌کند.
.IP \(bu 2
حذف چاپ ناخواسته در خروجی استاندارد (stdout) از \fB_emit_no_member\fP
.IP \(bu 2
افزودن یک گزینه خط فرمان برای تعیین دایرکتوری خروجی pyreverse
.sp
بستن #4159
.IP \(bu 2
رفع مشکل مربوط به Enumها و \fBclass\-attribute\-naming\-style=snake_case\fP
.sp
بستن #4149
.IP \(bu 2
افزودن گزینه \fBallowed\-redefined\-builtins\fP برای تنظیم دقیق بررسی \fBredefined\-builtin\fP.
.sp
بستن #3263
.IP \(bu 2
رفع مشکل هنگام اجرا با \fBpython \-m pylint\fP
.sp
بستن #4161
.IP \(bu 2
معاف کردن \fBtyping.TypedDict\fP از بررسی \fBtoo\-few\-public\-methods\fP.
.sp
بستن #4180
.IP \(bu 2
رفع مثبت کاذب \fBno\-member\fP برای حاشیه‌نویسی‌های نوع فاقد مقدار پیش‌فرض.
.sp
بستن #3167
.IP \(bu 2
افزودن \fB\-\-class\-const\-naming\-style\fP برای ثابت‌های Enum و متغیرهای کلاس مشخص‌شده با \fBtyping.ClassVar\fP
.sp
بستن #4181
.IP \(bu 2
رفع خطای astroid.Inference برای متغیرهای تعریف‌نشده همراه با \fBlen()\(ga\fP
.sp
بستن #4215
.IP \(bu 2
رفع شماره ستون در پیام‌های هشدار FIXME
.sp
بستن #4218
.IP \(bu 2
بهبود مدیریت عبارت‌های انتساب (assignment expressions) و مدیریت بهتر حالت‌های مرزی
.sp
بستن #3763، #4238
.IP \(bu 2
بهبود بررسی اشتراک‌پذیر بودن کلاس (subscriptable) بر اساس PEP585
.IP \(bu 2
رفع مستندات و نحوه مدیریت نام فایل در \-\-import\-graph
.IP \(bu 2
رفع مثبت کاذب برای \fBunused\-import\fP روی آرگومان‌های کلیدواژه‌ای کلاس
.sp
بستن #3202
.IP \(bu 2
رفع پس‌رفت در پلاگین‌های روی PYTHONPATH در صورتی که دومی دایرکتوری کاری جاری (cwd) باشد
.sp
بستن #4252
.UNINDENT
.SS تازه‌های Pylint 2.7.2؟
.sp
تاریخ انتشار: 2021\-02\-28
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب در \fBEnum.__members__.items()\fP، \fBEnum.__members__.values\fP و \fBEnum.__members__.keys\fP
.sp
بستن #4123
.IP \(bu 2
پاک‌سازی صحیح ورودی‌های خطرناک sys.path (نه تنها اولین مورد)
.sp
بستن #3636
.IP \(bu 2
بهبودهای جریان کاری و بسته‌بندی
.UNINDENT.SS "تازه‌های Pylint 2.7.1 (What\(aqs New in Pylint 2.7.1?)"
.sp
تاریخ انتشار: 2021\-02\-23
.INDENT 0.0
.IP \(bu 2
در دسترس قرار دادن \fBUnittestLinter\fP در pylint.testutils
.IP \(bu 2
عدم بررسی دایرکتوری‌هایی که با \(aq.\(aq شروع می‌شوند هنگام استفاده از register_plugins
.sp
بسته شدن #4119
.UNINDENT
.SS "تازه‌های Pylint 2.7.0 (What\(aqs New in Pylint 2.7.0?)"
.sp
تاریخ انتشار: 2021\-02\-21
.INDENT 0.0
.IP \(bu 2
معرفی DeprecationMixin برای بررسی‌های قابل استفاده مجدد منسوخ‌سازی (deprecation).
.sp
بسته شدن #4049
.IP \(bu 2
رفع مثبت کاذب برای \fBbuiltin\-not\-iterating\fP هنگامی که \fBmap\fP یک تکرارپذیر (iterable) دریافت می‌کند
.sp
بسته شدن #4078
.IP \(bu 2
اکنون Python 3.6+ الزامی است.
.IP \(bu 2
رفع مثبت کاذب برای \fBbuiltin\-not\-iterating\fP هنگامی که \fBzip\fP یک تکرارپذیر (iterable) دریافت می‌کند
.IP \(bu 2
افزودن بررسی \fBnan\-comparison\fP برای مقایسه‌های NaN
.IP \(bu 2
رفع باگ برای شماره خط پیام empty\-comment.
.sp
بسته شدن #4009
.IP \(bu 2
صدور \fBbad\-reversed\-sequence\fP برای دیکشنری‌ها تنها در نسخه‌های پیش از py3.8
.sp
بسته شدن #3940
.IP \(bu 2
مدیریت دکوراتورهای کلاسی اعمال‌شده روی توابع.
.sp
بسته شدن #3882
.IP \(bu 2
افزودن بررسی برای کامنت‌های خالی
.IP \(bu 2
رفع ایراد جزئی در مستندات contribute.rst
.IP \(bu 2
اکنون بر اساس \fBinvalid\-name\fP\& نام‌گذاری Enumها با حروف بزرگ UPPER_CASE الزامی است.
.sp
بسته شدن #3834
.IP \(bu 2
افزودن بررسی‌های جاافتاده برای توابع منسوخ‌شده.
.IP \(bu 2
ارزیابی به تعویق افتاده حاشیه‌نویسی‌ها (annotations) اکنون به طور پیش‌فرض در صورت بالاتر بودن نسخه پایتون از 3.10 شناسایی می‌شود
.sp
بسته شدن #3992
.IP \(bu 2
اصلاح متادیتای ستون برای بررسی‌های anomalous backslash
.IP \(bu 2
پایان پشتیبانی از Python 3.5
.IP \(bu 2
افزودن پشتیبانی از pep585 با ارزیابی به تعویق افتاده
.sp
بسته شدن #3320
.IP \(bu 2
بررسی نحو جایگزین union \- سند PEP 604
.sp
بسته شدن #4065
.IP \(bu 2
رفع چندین مورد مثبت کاذب در عبارات انتساب (assignment expressions)
.sp
بسته شدن #3347, #3953, #3865, #3275
.IP \(bu 2
رفع مثبت کاذب TypedDict inherit\-non\-class در Python 3.9+
.sp
بسته شدن #1927
.IP \(bu 2
رفع مشکل نحو تو در توی PEP 585
.IP \(bu 2
رفع مشکل نحو تو در توی PEP 604
.IP \(bu 2
رفع کرش در \fBundefined\-variable\fP ناشی از صفت‌های زنجیره‌ای در metaclass
.sp
بسته شدن #3742
.IP \(bu 2
رفع مثبت کاذب برای \fBnot\-async\-context\-manager\fP هنگامی که از \fBcontextlib.asynccontextmanager\fP استفاده می‌شود
.sp
بسته شدن #3862
.IP \(bu 2
اصلاح خاموش شدن استخر چندپردازشی (multiprocessing pool) تحلیل‌گر کد (که هنگام اجرا به صورت موازی با سایر افزونه‌های pytest هشدار صادر می‌کرد)
.sp
بسته شدن #3779
.IP \(bu 2
رفع صدور مثبت کاذب \fBno\-self\-use\fP و \fBunused\-argument\fP برای متدهای انواع ساختاری جنریک (\fIProtocol[T]\fP)
.sp
بسته شدن #3885
.IP \(bu 2
رفع باگی که هنگام استفاده از \fB\-\-jobs 2\fP یا بیشتر منجر به پیام‌های تکراری می‌شد.
.sp
بسته شدن #3584
.IP \(bu 2
افزودن گزینه \fBcheck\-protected\-access\-in\-special\-methods\fP در ClassChecker برای فعال/غیرفعال کردن صدور پیام \fBprotected\-access\fP برای صفت‌های با پیشوند تک‌زیرخط در متدهای ویژه.
.sp
بسته شدن #3120
.IP \(bu 2
رفع عبارات منظم آسیب‌پذیر در \fBpyreverse\fP
.sp
بسته شدن #3811
.IP \(bu 2
پیام \fBinconsistent\-return\-statements\fP اکنون در صورتی صادر می‌شود که یکی از دستورهای \fBtry/except\fP برخلاف دیگری به طور صریح مقداری را برنگرداند.
.sp
بسته شدن #3468
.IP \(bu 2
رفع مثبت کاذب \fBuseless\-super\-delegation\fP هنگامی که آرگومان کلیدواژه‌ای پیش‌فرض یک دیکشنری است.
.sp
بسته شدن #3773
.IP \(bu 2
رفع کرش هنگامی که فایل پیکربندی مشخص‌شده وجود ندارد
.IP \(bu 2
افزودن پشتیبانی از \fBignored\-argument\-names\fP در DocstringParameterChecker و افزودن پیام‌های \fBuseless\-param\-doc\fP و \fBuseless\-type\-doc\fP\&.
.sp
بسته شدن #3800
.IP \(bu 2
اعمال سازگار docparams در زمانی که docstring وجود ندارد
.sp
بسته شدن #2738
.IP \(bu 2
رفع مثبت کاذب \fBduplicate\-code\fP هنگامی که خطوط تنها حاوی فاصله‌های خالی و نویسه‌های غیرالفبایی\-عددی هستند (مانند پرانتز، کروشه، کاما و غیره)
.IP \(bu 2
بهبود پیام تحلیل کد برای \fBsingleton\-comparison\fP با مقادیر بولی
.IP \(bu 2
رفع کرش غلط‌یاب املایی در خطوط دندانه‌دار docstring که شبیه کامنت‌های # هستند
.sp
بسته شدن #3786
.IP \(bu 2
رفع خطای AttributeError در checkers/refactoring.py
.IP \(bu 2
بهبود فیلتر املایی دستورالعمل‌های sphinx
.IP \(bu 2
رفع باگ در ارزیابی به تعویق افتاده هنگام استفاده از نام‌های مستعار برای حاشیه‌نویسی‌ها.
.sp
بسته شدن #3798
.IP \(bu 2
رفع ایرادات جزئی در مستندات
.IP \(bu 2
بهبود عملکرد بررسی طول خط.
.IP \(bu 2
حذف منسوخ‌سازی نادرست \fBinspect.getfullargspec\fP
.IP \(bu 2
رفع مثبت کاذب \fBsignature\-differs\fP برای توابعی با آرگومان‌های متغیر (variadics)
.sp
بسته شدن #3737
.IP \(bu 2
رفع کرش در \fBconsider\-using\-enumerate\fP هنگام مواجهه با \fBrange()\fP بدون آرگومان
.sp
بسته شدن #3735
.IP \(bu 2
بررسی \fBlen\-as\-conditions\fP اکنون فقط برای کلاس‌هایی فعال می‌شود که مستقیماً از list، dict یا set ارث‌بری کرده و تابع \fB__bool__\fP را پیاده‌سازی نکرده‌اند، یا از مولدهایی نظیر range یا درک‌های list/dict/set مشتق شده‌اند. این امر باید موارد مثبت کاذب را برای سایر کلاس‌ها، مانند DataFrame در pandas یا Array در numpy کاهش دهد.
.sp
بسته شدن #1879
.IP \(bu 2
رفع مشکل کار نکردن duplicate\-errors با \-j2+
.sp
بسته شدن #3314
.IP \(bu 2
گزینه \fBgenerated\-members\fP اکنون با نام کامل (qualified name) اعضا مطابقت داده می‌شود
.sp
بسته شدن #2498
.IP \(bu 2
افزودن بررسی برای تابع bool به \fBlen\-as\-condition\fP
.IP \(bu 2
افزودن بررسی \fBsimplifiable\-condition\fP برای مقادیر ثابت غیرضروری در شرط‌های با استفاده از and/or.
.IP \(bu 2
افزودن بررسی \fBcondition\-evals\-to\-constant\fP برای شرط‌های با استفاده از and/or که حاصل آن‌ها به یک مقدار ثابت ارزیابی می‌شود.
.sp
بسته شدن #3407
.IP \(bu 2
تغییر setup.py برای کار با distlib \%<https://\:pypi\:.org/\:project/\:distlib>
.UNINDENT.sp
بسته شد: #3555
.IP \(bu 2
بررسی جدید: \fBconsider\-using\-generator\fP
.sp
این بررسی زمانی هشدار می‌دهد که یک comprehension در داخل یک تابع \fBany\fP یا \fBall\fP استفاده شده باشد،
زیرا غیرضروری است و باید به جای آن از یک generator استفاده شود.
استفاده از generator کد کمتری برده و بسیار سریع‌تر خواهد بود.
.sp
بسته شد: #3165
.IP \(bu 2
افزودن Github Actions جهت جایگزینی Travis و AppVeyor در آینده
.UNINDENT
.SS تغییرات جدید در Pylint 2.6
.sp
از ابتدای pylint تا نسخه 2.14.0، ما یک گزارش تغییرات (changelog) داشتیم که شامل \fIتمام\fP
تغییرات غیرجزئی در Pylint بود، از جمله تغییراتی که
کاربر با آن‌ها مواجه نمی‌شد؛ یعنی تغییراتی که ممکن است تنها در صورتی برای شما جالب باشد که توسعه‌دهنده‌ای
باشید که روی pylint یا افزونه‌های pylint کار می‌کنید، یا تاریخ‌نگار پروژه‌های منبع‌باز باشید.
.sp
از pylint 1.6.0 تا 2.14.0، علاوه بر گزارش کامل تغییرات، خلاصه‌ای
از تغییرات (عمدتاً مربوط به کاربران) نیز وجود داشت.
.SS خلاصه \-\- نکات برجسته انتشار
.INDENT 0.0
.IP \(bu 2
بررسی‌های \fBbad\-continuation\fP و \fBbad\-whitespace\fP حذف شده‌اند. ابزار \fBblack\fP یا یک قالب‌بند دیگر می‌تواند بهتر از Pylint در این مورد به شما کمک کند
.IP \(bu 2
پشتیبانی از isort 5 اضافه شد
.UNINDENT
.SS بازبین‌های جدید
.INDENT 0.0
.IP \(bu 2
افزودن بررسی \fBsuper\-with\-arguments\fP برای علامت‌گذاری موارد فراخوانی super به سبک Python 2.
.IP \(bu 2
افزودن بررسی \fBraise\-missing\-from\fP برای استثناهایی که باید علت (cause) داشته باشند.
.UNINDENT
.SS سایر تغییرات
.INDENT 0.0
.IP \(bu 2
بررسی‌های \fBbad\-continuation\fP و \fBbad\-whitespace\fP حذف شده‌اند. ابزار \fBblack\fP یا یک قالب‌بند دیگر می‌تواند بهتر از Pylint در این زمینه به شما کمک کند
.IP \(bu 2
گزینه \fBno\-space\-check\fP حذف شده است؛ دیگر نمی‌توان با استفاده از گزینه‌های هوشمندانه، خط خالی را مانند یک \fBtrailing\-whitespace\fP در نظر گرفت.
.IP \(bu 2
بررسی \fBmixed\-indentation\fP حذف شده است؛ دیگر مفید نیست زیرا TabError مستقیماً در python3 گنجانده شده است
.IP \(bu 2
رفع مثبت کاذب در superfluous\-parens / C0325 \%<#\:superfluous-parens> برای عملگر walrus
.IP \(bu 2
افزودن پشتیبانی از هر دو نسخه isort 4 و isort 5. اگر isort 4 را در نیازمندی‌های پروژه خود قفل (pin) کرده‌اید، تغییری ایجاد نمی‌شود. با این حال اگر از isort 5 استفاده می‌کنید، توجه داشته باشید که گزینه \fBknown\-standard\-library\fP در isort 4 و isort 5 یکسان تفسیر نمی‌شود (برای جزئیات بیشتر به \fIراهنمای مهاجرت در مستندات isort\fP (دیگر در دسترس نیست) مراجعه کنید). برای حفظ سازگاری اکثر کاربران pylint، گزینه \fBknown\-standard\-library\fP در pylint اکنون به \fBextra\-standard\-library\fP در isort 5 نگاشت می‌شود. اگر واقعاً آنچه را می‌خواهید که \fBknown\-standard\-library\fP اکنون در isort 5 ارائه می‌دهد، باید بررسی \fBwrong\-import\-order\fP را در pylint غیرفعال کرده و isort را به صورت دستی با یک فایل پیکربندی مناسب isort اجرا کنید.
.UNINDENT
.SS گزارش کامل تغییرات
.SS تغییرات جدید در Pylint 2.6.1؟
.sp
تاریخ انتشار: 2021\-02\-16
.INDENT 0.0
.IP \(bu 2
نسخه Astroid برابر < 2.5 تعیین شده است
.sp
بسته شد: #4093
.UNINDENT
.SS تغییرات جدید در Pylint 2.6.0؟
.sp
تاریخ انتشار: 2020\-08\-20
.INDENT 0.0
.IP \(bu 2
رفع باگ‌های مختلف مربوط به حوزه (scope) در بازبین \fBundefined\-variable\fP
.sp
بسته شد: #1082، #3434، #3461
.IP \(bu 2
بررسی‌های bad\-continuation و bad\-whitespace حذف شده‌اند، ابزار black یا یک قالب‌بند دیگر می‌تواند در این مورد بهتر از Pylint به شما کمک کند
.sp
بسته شد: #246، #289، #638، #747، #1148، #1179، #1943، #2041، #2301، #2304، #2944، #3565
.IP \(bu 2
گزینه no\-space\-check حذف شده است. دیگر نمی‌توان با استفاده از گزینه‌های هوشمندانه، خط خالی را مانند یک \fBtrailing\-whitespace\fP در نظر گرفت
.sp
بسته شد: #1368
.IP \(bu 2
هنگام مواجهه با توابع overload، خطای \fBmissing\-kwoa\fP دیگر صادر نمی‌شود
.sp
بسته شد: #3655
.IP \(bu 2
بررسی mixed\-indentation حذف شده است؛ دیگر مفید نیست زیرا TabError مستقیماً در python3 گنجانده شده است
.sp
بسته شد: #2984 #3573
.IP \(bu 2
افزودن بررسی \fBsuper\-with\-arguments\fP برای علامت‌گذاری موارد فراخوانی super به سبک Python 2.
.IP \(bu 2
افزودن یک FAQ با شرح این که برای جلوگیری از تکرار پیام‌ها با سایر linterهای محبوب، کدام پیام‌ها باید غیرفعال شوند
.IP \(bu 2
رفع مثبت کاذب در superfluous\-parens / C0325 \%<#\:superfluous-parens> برای عملگر walrus
.sp
بسته شد: #3383
.IP \(bu 2
رفع اشکال عدم پذیرش اعداد ممیز شناور در \fBfail\-under\fP
.IP \(bu 2
رفع اشکالی که در آن \fBignore\-docstrings\fP تمام خطوط موجود در یک ماژول را نادیده می‌گرفت
.IP \(bu 2
رفع پیکربندی \fBpre\-commit\fP که می‌توانست منجر به خطوط تکراری کشف‌نشده در کد شود
.IP \(bu 2
رفع یک فروپاشی در حالت موازی هنگامی که مسیر فایل ماژول تعیین نشده است
.sp
بسته شد: #3564
.IP \(bu 2
افزودن بررسی \fBraise\-missing\-from\fP برای استثناهایی که باید یک علت (cause) داشته باشند.
.IP \(bu 2
پشتیبانی از هر دو نسخه isort 4 و isort 5. اگر isort 4 را در نیازمندی‌های پروژه خود قفل کرده‌اید، تغییری ایجاد نمی‌شود. با این حال اگر از isort 5 استفاده می‌کنید، توجه داشته باشید که گزینه \fBknown\-standard\-library\fP در isort 4 و isort 5 یکسان تفسیر نمی‌شود (برای جزئیات بیشتر به راهنمای مهاجرت در مستندات isort مراجعه کنید). برای حفظ سازگاری اکثر کاربران pylint، گزینه \fBknown\-standard\-library\fP در pylint اکنون به \fBextra\-standard\-library\fP در isort 5 نگاشت می‌شود. اگر واقعاً آنچه را می‌خواهید که \fBknown\-standard\-library\fP اکنون در isort 5 معنی می‌دهد، باید بررسی \fBwrong\-import\-order\fP را در pylint غیرفعال کرده و isort را به صورت دستی با یک فایل پیکربندی مناسب isort اجرا کنید.
.sp
بسته شد: #3722
.IP \(bu 2
رفع یک فروپاشی ناشی از عدم محافظت در برابر \fBInferenceError\fP هنگام فراخوانی \fBinfer_call_result\fP
.sp
بسته شد: #3690
.IP \(bu 2
رفع یک فروپاشی در حالت موازی هنگامی که مسیر فایل ماژول تعیین نشده است
.sp
بسته شد: #3564
.UNINDENT.SS تازه‌های Pylint 2.5
.sp
از آغاز pylint تا نسخهٔ 2.14.0 (شامل آن)، ما یک گزارش تغییرات داشتیم که حاوی \fIتمام\fP
تغییرات غیرجزئی Pylint بود، از جمله تغییراتی که
مربوط به سمت کاربر نبودند؛ یعنی تغییراتی که تنها در صورتی ممکن است برای شما جالب باشد که توسعه‌دهنده‌ای
باشید که روی pylint یا افزونه‌های آن کار می‌کند، یا یک تاریخ‌نگار منبع‌باز باشید.
.sp
از pylint 1.6.0 تا 2.14.0، علاوه‌بر گزارش کامل تغییرات، خلاصه‌ای
از تغییرات (عمدتاً سمت کاربر) نیز وجود داشت.
.SS خلاصه \-\- نکات برجستهٔ انتشار
.SS بررسی‌کننده‌های جدید
.INDENT 0.0
.IP \(bu 2
بررسی جدید \fBisinstance\-second\-argument\-not\-valid\-type\fP اضافه شد.
.INDENT 2.0
.INDENT 3.5
این بررسی هر زمان که \fBpylint\fP فراخوانی تابع \fBisinstance\fP را با آرگومان دومی
که یک type نیست بیابد، صادر می‌شود. چنین کدی احتمالاً
ناخواسته است زیرا باعث پرتاب خطای TypeError در زمان اجرا خواهد شد.
.UNINDENT
.UNINDENT
.IP \(bu 2
بررسی جدید \fBassert\-on\-string\-literal\fP اضافه شد.
.INDENT 2.0
.INDENT 3.5
این بررسی هر زمان که \fBpylint\fP یک دستور assert با یک رشتهٔ لفظی (string literal)
به عنوان آرگومان نخست پیدا کند صادر می‌شود. چنین دستورهای assert
احتمالاً ناخواسته هستند زیرا همواره موفقیت‌آمیز خواهند بود.
.UNINDENT
.UNINDENT
.IP \(bu 2
بررسی جدید \fBf\-string\-without\-interpolation\fP اضافه شد.
.INDENT 2.0
.INDENT 3.5
این بررسی هر زمان که \fBpylint\fP استفاده از یک f\-string فاقد
هرگونه مقدار درون‌یابی‌شده را تشخیص دهد صادر می‌شود، بدین معنی
که f\-string می‌تواند یک رشتهٔ معمولی باشد.
.UNINDENT
.UNINDENT
.IP \(bu 2
چندین بررسی برای انواع بازگشتی نامعتبر توابع پروتکل اضافه شدند:
.INDENT 2.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fBinvalid\-bool\-returned\fP: تابع \fB__bool__\fP مقدار bool بازنگرداند
.IP \(bu 2
\fBinvalid\-index\-returned\fP: تابع \fB__index__\fP مقدار integer بازنگرداند
.IP \(bu 2
\fBinvalid\-repr\-returned)\fP: تابع \fB__repr__\fP مقدار string بازنگرداند
.IP \(bu 2
\fBinvalid\-str\-returned)\fP: تابع \fB__str__\fP مقدار string بازنگرداند
.IP \(bu 2
\fBinvalid\-bytes\-returned)\fP: تابع \fB__bytes__\fP مقدار string بازنگرداند
.IP \(bu 2
\fBinvalid\-hash\-returned)\fP: تابع \fB__hash__\fP مقدار integer بازنگرداند
.IP \(bu 2
\fBinvalid\-length\-hint\-returned)\fP: تابع \fB__length_hint__\fP یک integer غیرمنفی بازنگرداند
.IP \(bu 2
\fBinvalid\-format\-returned)\fP: تابع \fB__format__\fP مقدار string بازنگرداند
.IP \(bu 2
\fBinvalid\-getnewargs\-returned)\fP: تابع \fB__getnewargs__\fP مقدار tuple بازنگرداند
.IP \(bu 2
\fBinvalid\-getnewargs\-ex\-returned)\fP: تابع \fB__getnewargs_ex__\fP یک tuple به فرم (tuple, dict) بازنگرداند
.UNINDENT
.UNINDENT
.UNINDENT
.IP \(bu 2
بررسی جدید \fBinconsistent\-quotes\fP اضافه شد.
.INDENT 2.0
.INDENT 3.5
این بررسی زمانی صادر می‌شود که جداکننده‌های نقل‌قول (\fB\(dq\fP و \fB\(aq\fP) به‌طور
یکنواخت در سرتاسر یک ماژول استفاده نشوند. این بررسی اجازه می‌دهد تا از گریزدهی (escaping)
غیرضروری اجتناب شود؛ برای مثال، \fB\(dqDon\(aqt error\(dq\fP در ماژولی که در سایر موارد
رشته‌ها با نقل‌قول تکی مشخص می‌شوند مجاز است تا نیازی به گریز دادن نقل‌قول تکی در \fBDon\(aqt\fP نباشد.
.UNINDENT
.UNINDENT
.IP \(bu 2
بررسی جدید \fBnon\-str\-assignment\-to\-dunder\-name\fP برای اطمینان از این‌که فقط مقادیر string به ویژگی‌های \fB__name__\fP انتساب داده می‌شوند، اضافه شد.
.UNINDENT.SS سایر تغییرات (Other Changes)
.INDENT 0.0
.IP \(bu 2
پیکربندی می‌تواند از یک فایل setup.cfg یا pyproject.toml در دایرکتوری جاری خوانده شود.
یک فایل setup.cfg باید نام بخش‌های pylintrc را با \fBpylint.\fP پیشوندگذاری کند، برای نمونه \fB[pylint.MESSAGES CONTROL]\fP\&.
یک فایل pyproject.toml باید نام بخش‌ها را با \fBtool.pylint.\fP پیشوندگذاری کند، برای نمونه \fB[tool.pylint.\(aqMESSAGES CONTROL\(aq]\fP\&.
این فایل‌ها همچنین می‌توانند از خط فرمان مشخص و ارسال شوند.
.IP \(bu 2
افزودن گزینه‌های جدید \fBgood\-names\-rgx\fP و \fBbad\-names\-rgx\fP برای مجاز کردن یا ممنوع ساختن نام‌ها از طریق عبارت‌های منظم (regular expressions)
.sp
برای فراهم ساختن مدیریت بهتر نام‌های مجاز/غیرمجاز، دو گزینهٔ پیکربندی جدید اضافه کردیم: good\-names\-rgxs: فهرستی از عبارت‌های منظم جداشده با کاما، که اگر نامی با آن‌ها تطابق یابد از بررسی نام‌گذاری معاف می‌شود. bad\-names\-rgxs: فهرستی از عبارت‌های منظم جداشده با کاما، که در صورت تطابق یک نام با آن‌ها، همواره به‌عنوان نام غیرمجاز علامت‌گذاری خواهد شد.
.IP \(bu 2
انواع تغییرپذیر (mutable) از \fBcollections.*\fP اکنون به‌عنوان مقادیر پیش‌فرض خطرناک علامت‌گذاری می‌شوند.
.IP \(bu 2
افزودن پرچم جدید \fB\-\-fail\-under\fP جهت تنظیم آستانهٔ امتیازی که کمتر از آن آزمون‌های کلی رد می‌شوند. اگر امتیاز بالاتر از آستانهٔ fail\-under باشد، pylint با مقدار ۰ برای مشخص کردن نبود خطا به SystemExit خاتمه می‌دهد.
.IP \(bu 2
افزودن گزینهٔ جدید \fBnotes\-rgx\fP برای انعطاف‌پذیرتر کردن هشدارهای fixme. اکنون می‌توان از هر دو گزینهٔ \fBnotes\fP یا \fBnotes\-rgx\fP برای شناسایی هشدارهای fixme استفاده کرد.
.IP \(bu 2
نویسه‌های غیر ASCII اکنون توسط \fBinvalid\-name\fP مجاز شمرده می‌شوند.
.IP \(bu 2
دستور \fBpylint\fP دیگر برای موارد غیرثابت (non\-constants) یافت‌شده در سطح ماژول، خطای \fBinvalid\-name\fP صادر نمی‌کند.
.sp
برنامهٔ Pylint همهٔ متغیرهای سطح ماژول را ثابت فرض می‌کرد، که این موضوع در الزامات واقعی PEP 8 نیست.
.IP \(bu 2
بررسی جدیدی با نام \fBnon\-ascii\-name\fP برای شناسایی شناسه‌های دارای نویسه‌های غیر ASCII اضافه شد.
.IP \(bu 2
توابع overloaded در سیستم تایپینگ دیگر بررسی‌های \fBno\-self\-use\fP، \fBunused\-argument\fP، \fBmissing\-docstring\fP و موارد مشابهی که توابع overloaded را توابع عادی تلقی می‌کردند، تحریک نمی‌کنند.
.IP \(bu 2
دیگر نمی‌توان \fBpython \-m pylint\fP را وادار به وارد کردن (import) فایل‌ها از دایرکتوری محلی کرد.
.IP \(bu 2
دستور جدید \fB\-\-list\-extensions\fP اضافه شد.
.sp
این دستور تمام افزونه‌های موجود در \fBpylint.extensions\fP را فهرست می‌کند.
.IP \(bu 2
موارد مثبت کاذب (false positives) متعددی برطرف شده‌اند که می‌توانید جزئیات بیشتر را در فایل‌های Changelog مطالعه کنید.
.IP \(bu 2
انواع متعددی از قالب‌بندی رشته در توابع logging مجاز هستند.
.UNINDENT
.sp
پیام \fBlogging\-fstring\-interpolation\fP بازگردانده شده است تا امکان استفاده از چندین نوع قالب‌بندی رشته فراهم شود.
نوع قالب‌بندی مورد استفاده به‌جای گزینهٔ logging\-format\-style، از طریق فعال و غیرفعال کردن پیام‌ها تعیین می‌گردد.
مقدار fstr برای گزینهٔ logging\-format\-style نامعتبر است.
.SS گزارش کامل تغییرات (Full changelog)
.SS چه مواردی در Pylint 2.5.3 جدید است؟ (What\(aqs New in Pylint 2.5.3?)
.sp
تاریخ انتشار: 2020\-06\-8
.INDENT 0.0
.IP \(bu 2
رفع پس‌رفتی که در آن کامنت‌های غیرفعال‌سازی (disable) دارای نام بررسی‌کننده به همراه اعداد، به‌درستی تجزیه نمی‌شدند
.sp
بستن #3666
.IP \(bu 2
مدیریت صحیح ویژگی‌های انتزاعی (abstract properties) توسط \fBproperty\-with\-parameters\fP
.sp
بستن #3600
.IP \(bu 2
پیام \fBcontinue\-in\-finally\fP دیگر روی Python 3.8 که اکنون در آن معتبر است، صادر نمی‌شود
.sp
بستن #3612
.IP \(bu 2
رفع پس‌رفتی که در آن پیام‌های دارای خط تیره به‌طور کامل تجزیه نمی‌شدند
.sp
بستن #3604
.IP \(bu 2
در یک فایل پیکربندی TOML، اکنون می‌توان به‌جای رشته‌ها از انواع غنی (غیر رشته‌ای) مانند list، integer یا boolean استفاده کرد. برای نمونه، اکنون می‌توان یک \fIlist\fP از شناسه‌های پیام را برای فعال‌سازی به‌شکل زیر تعریف کرد:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
enable = [
    \(dquse\-symbolic\-message\-instead\(dq,
    \(dquseless\-suppression\(dq,
]
.EE
.UNINDENT
.UNINDENT
.sp
بستن #3538
.IP \(bu 2
رفع پس‌رفتی که در آن امتیاز با چندین کار (jobs) هم‌روند گزارش نمی‌شد
.sp
بستن #3547
.IP \(bu 2
محافظت در برابر خطای \fBAttributeError\fP هنگام بررسی \fBcell\-var\-from\-loop\fP
.sp
بستن #3646
.UNINDENT.SS تازه‌های Pylint 2.5.2
.sp
تاریخ انتشار: 2020\-05\-05
.INDENT 0.0
.IP \(bu 2
\fBpylint.Run\fP پارامتر \fBdo_exit\fP را به عنوان یک پارامتر منسوخ می‌پذیرد
.sp
بستن #3590
.UNINDENT
.SS تازه‌های Pylint 2.5.1
.sp
تاریخ انتشار: 2020\-05\-05
.INDENT 0.0
.IP \(bu 2
رفع خرابی در جستجوی \fBmethod\-hidden\fP برای کلاس‌های پایه ناشناخته
.sp
بستن #3527
.IP \(bu 2
بازگرداندن پارامتر \fBexit\fP در pylint.Run به \fBdo_exit\fP
.sp
این مورد چند انتشار پیش سهواً به \fBdo_exit\fP تغییر یافته بود\&.
.sp
بستن #3533
.IP \(bu 2
تشخیص چندآرگومانی (variadic) در \fBno\-value\-for\-parameter\fP برای دستورهای انتساب بهبود یافته است
.sp
بستن #3563
.IP \(bu 2
امکان شناسایی صحیح فایل‌های بسته (package) هنگام استفاده از چندین پردازش (multiple jobs)
.sp
بستن #3524
.IP \(bu 2
امکان ارزیابی (linting) دایرکتوری‌های فاقد \fB__init__.py\fP که یک پس‌رفت در نسخه 2.5 بود.
.sp
بستن #3528
.UNINDENT
.SS تازه‌های Pylint 2.5.0
.sp
تاریخ انتشار: 2020\-04\-27
.INDENT 0.0
.IP \(bu 2
رفع منفی کاذب در \fBundefined\-variable\fP هنگام استفاده از مشخصه کلاس در ساختارهای درک (comprehension).
.sp
بستن #3494
.IP \(bu 2
رفع مثبت کاذب در \fBundefined\-variable\fP هنگام استفاده از مشخصه کلاس در دکوراتور یا به عنوان راهنمای نوع (type hint).
.sp
بستن #511
بستن #1976
.IP \(bu 2
حذف نشانه‌گذاری HTML (HTML quoting) پیام‌ها در خروجی JSON.
.sp
بستن #2769
.IP \(bu 2
تنظیم قاعده \fBinvalid\-name\fP برای کار با شناسه‌های غیر ASCII و افزودن قاعده \fBnon\-ascii\-name\fP.
.sp
بستن #2725
.IP \(bu 2
آرگومان‌های فقط‌موضعی (positional\-only) برای \fBuseless\-super\-delegation\fP لحاظ می‌شوند
.IP \(bu 2
هشدار \fBunidiomatic\-typecheck\fP دیگر برای عملگرهای \fBin\fP و \fBnot in\fP صادر نمی‌شود
.sp
بستن #3337
.IP \(bu 2
یادداشت‌های نوع (annotations) آرگومان‌های فقط‌موضعی برای \fBunused\-import\fP لحاظ می‌شوند
.sp
بستن #3462
.IP \(bu 2
افزودن دستوری برای فهرست کردن افزونه‌های موجود.
.IP \(bu 2
امکان پردازش صحیح متغیرهای استفاده‌شده هنگام فعال یا غیرفعال بودن بررسی‌های مختلف
.sp
بستن #3445
.IP \(bu 2
اصلاح قاعده dangerous\-default\-value / W0102 \%<#\:dangerous-default-value> جهت در نظر گرفتن مقادیر پیش‌فرض آرگومان‌های کلیدواژه‌ای
.sp
بستن #3373
.IP \(bu 2
رفع مثبت کاذب در \fBself\-assigning\-variable\fP هنگام باز کردن تاپل (tuple unpacking).
.sp
بستن #3433
.IP \(bu 2
هشدار \fBno\-self\-use\fP دیگر برای کدهای خرد نوع‌بندی (typing stubs) صادر نمی‌شود.
.sp
بستن #3439
.IP \(bu 2
رفع مثبت کاذب در \fBundefined\-variable\fP هنگام استفاده از \fB__class__\fP
.sp
بستن #3090
.IP \(bu 2
صدور \fBinvalid\-name\fP برای متغیرهای تعریف‌شده در حلقه‌ها در سطح ماژول.
.sp
بستن #2695
.IP \(bu 2
افزودن بررسی برای مواردی که آرگومان دوم در \fBisinstance\fP یک نوع (type) نیست.
.sp
بستن #3308
.IP \(bu 2
افزودن گزینه \(aqnotes\-rgx\(aq جهت استفاده در بررسی fixme.
.sp
بستن #2874
.IP \(bu 2
بررسی \fBfunction\-redefined\fP توابعی را که به صورت شرطی بازتعریف شده‌اند، مستثنی می‌کند.
.sp
بستن #2410
.IP \(bu 2
توابع \fBtyping.overload\fP از بررسی‌های رشته مستندات (docstring) مستثنی شدند
.sp
بستن #3350
.IP \(bu 2
صدور \fBinvalid\-overridden\-method\fP برای بازنویسی‌های نامناسب async def.
.sp
بستن #3355
.IP \(bu 2
جلوگیری از وارد کردن (import) کد کاربر توسط \fBpython \-m pylint ...\fP
.sp
دستور \fBpython \-m pylint ...\fP دایرکتوری کاری فعلی را به عنوان نخستین عنصر
\fBsys.path\fP\& اضافه می‌کند. این امر یک رخنه امنیتی بالقوه ایجاد می‌کند که در آن \fBpylint\fP تا زمانی
که کد در ماژول‌هایی هم‌نام با stdlib یا ماژول‌های خود pylint قرار داشته باشد، کدهای
سطح کاربر را وارد خواهد کرد.
.sp
بستن #3386
.IP \(bu 2
افزودن گزینه \fBdummy\-variables\-rgx\fP برای بررسی \fB_redeclared\-assigned\-name\fP.
.sp
بستن #3341
.IP \(bu 2
اصلاح ایجاد گراف برای مسیرهای نسبی
.IP \(bu 2
افزودن بررسی برای دستورهای assert روی مقادیر رشته‌ای ثابت (string literals).
.sp
بستن #3284
.IP \(bu 2
عملگر \fBnot in\fP برای برخی از بررسی‌کننده‌های انتقال به Python 3 به عنوان یک زمینه تکرار (iterating context) در نظر گرفته می‌شود.
.IP \(bu 2
بررسی جدید \fBinconsistent\-quotes\fP اضافه شد.
.IP \(bu 2
افزودن بررسی برای انتساب مقدار غیررشته‌ای به مشخصه __name__.
.sp
بستن #583
.IP \(bu 2
متدهای \fB__pow__\fP، \fB__imatmul__\fP، \fB__trunc__\fP، \fB__floor__\fP و \fB__ceil__\fP به عنوان نام‌های متد خاص شناخته می‌شوند.
.sp
بستن #3281
.IP \(bu 2
افزودن خطاها برای توابع پروتکل هنگام تشخیص انواع بازگشتی نامعتبر.
E0304 (invalid\-bool\-returned / E0304 \%<#\:invalid-bool-returned>): __bool__ یک مقدار bool بازنگرداند
E0305 (invalid\-index\-returned / E0305 \%<#\:invalid-index-returned>): __index__ یک عدد صحیح بازنگرداند
E0306 (invalid\-repr\-returned / E0306 \%<#\:invalid-repr-returned>): __repr__ یک رشته بازنگرداند
E0307 (invalid\-str\-returned / E0307 \%<#\:invalid-str-returned>): __str__ یک رشته بازنگرداند
E0308 (invalid\-bytes\-returned / E0308 \%<#\:invalid-bytes-returned>): __bytes__ یک رشته بازنگرداند
E0309 (invalid\-hash\-returned / E0309 \%<#\:invalid-hash-returned>): __hash__ یک عدد صحیح بازنگرداند
E0310 (invalid\-length\-hint\-returned / E0310 \%<#\:invalid-length-hint-returned>): __length_hint__ یک عدد صحیح غیرمنفی بازنگرداند
E0311 (invalid\-format\-returned / E0311 \%<#\:invalid-format-returned>): __format__ یک رشته بازنگرداند
E0312 (invalid\-getnewargs\-returned / E0312 \%<#\:invalid-getnewargs-returned>): __getnewargs__ یک تاپل بازنگرداند
E0313 (invalid\-getnewargs\-ex\-returned / E0313 \%<#\:invalid-getnewargs-ex-returned>): __getnewargs_ex__ یک تاپل به شکل (tuple, dict) بازنگرداند
.sp
بستن #560
.IP \(bu 2
بررسی‌های \fBmissing\-*\-docstring\fP می‌توانند انتساب‌های \fB__doc__\fP را جستجو کنند.
.sp
بستن #3301
.IP \(bu 2
قاعده \fBundefined\-variable\fP اکنون می‌تواند تکرارپذیرهای تعریف‌نشده حلقه را بیابد
.sp
بستن #498
.IP \(bu 2
تابع \fBsafe_infer\fP تا زمانی که تمام مسیرها نوع یکسانی داشته باشند، می‌تواند یک مقدار را استنتاج کند.
.sp
بستن #2503
.IP \(bu 2
افزودن پرچم \-\-fail\-under <score> که در فایل .pylintrc نیز قابل پیکربندی است. اگر امتیاز نهایی بیشتر از امتیاز تعیین‌شده باشد، یک موفقیت تلقی شده و pylint با کد خروج 0 خاتمه می‌یابد. در غیر این صورت، یک شکست تلقی شده و pylint با کد خروج فعلی خود بر اساس پیام‌های صادرشده خارج می‌شود.
.sp
بستن #2242
.IP \(bu 2
عدم صدور \fBline\-too\-long\fP برای خطوط چندگانه زمانی که یادداشت \fBdisable=line\-too\-long\fP در انتهای آن‌ها قرار دارد
.sp
بستن #2957
.IP \(bu 2
رفع یک \fBAttributeError\fP ناشی از مدیریت نادرست استنتاج \fBdataclasses\fP در \fBpyreverse\fP.sp
بسته شد #3256
.IP \(bu 2
معاف نکردن except بدون نوع (bare except) از بررسی‌های \fBundefined\-variable\fP و موارد مشابه
.sp
اگر گره‌ای درون یک \fBTryExcept\fP قرار داشت، \fBpylint\fP هنگام تصمیم‌گیری برای صدور یا عدم صدور پیام از گردانندهٔ except راهنمایی می‌گرفت.
پیش‌تر با except بدون نوع مانند یک نادیده‌گیری تمام‌عیار رفتار می‌شد، در حالی که تنها استثناهای متناظر باید به آن روش مدیریت شوند (مانند \fBNameError\fP یا \fBImportError\fP).
.sp
بسته شد #3235
.IP \(bu 2
عدم صدور \fBassignment\-from\-no\-return\fP هنگامی که یک تابع صرفاً یک استثنا برمی‌انگیزد (raise می‌کند)
.sp
بسته شد #3218
.IP \(bu 2
مجاز شمردن نام‌های مستعار واردسازی (import aliases) برای معافیت از \fBimport\-error\fP هنگام استفاده در حاشیه‌نویسی‌های نوع (type annotations).
.sp
بسته شد #3178
.IP \(bu 2
معاف شدن \fBEllipsis\(ga از \(ga\(gamultiple\-statements\fP برای سربارگذاری توابع (function overloads).
.sp
بسته شد #3224
.IP \(bu 2
عدم صدور \fBinvalid\-name\fP برای متغیرهای غیرثابت یافت‌شده در سطح ماژول.
.sp
نرم‌افزار Pylint عبارت زیر از PEP\-8 را بیش از حد تعمیم داده بود و تمام متغیرهای سطح ماژول را به عنوان ثابت در نظر می‌گرفت، که این منظورِ این عبارت نبود:
.sp
\fIثابت‌ها معمولاً در سطح ماژول تعریف می‌شوند و با حروف تمام‌بزرگ که با خط زیرین کلمات را جدا می‌کند نوشته می‌شوند.\fP
.sp
بسته شد #3111
بسته شد #3132
.IP \(bu 2
اجازه صدور \fBimplicit\-str\-concat\-in\-sequence\fP برای الحاق مجاورتی رشته‌ها (string juxtaposition)
.sp
بسته شد #3030
.IP \(bu 2
نام \fBimplicit\-str\-concat\-in\-sequence\fP به \fBimplicit\-str\-concat\fP تغییر یافت
.IP \(bu 2
گزارشگر \fBjson\fP دیگر \fBredirect_stdout\fP\& را دور نمی‌زند.
.sp
بسته شد #3227
.IP \(bu 2
انتقال \fBNoFileError\fP، \fBOutputLine\fP، \fBFunctionalTestReporter\fP،
\fBFunctionalTestFile\fP، \fBLintModuleTest\fP و متدهای مرتبط از
\fBtest_functional.py\fP به \fBpylint.testutils\fP جهت تسهیل آزمون
افزونه‌های شخص ثالث pylint.
.IP \(bu 2
امکان خواندن پیکربندی از یک فایل setup.cfg یا pyproject.toml.
.sp
بسته شد #617
.IP \(bu 2
رفع مثبت کاذب در exception\-escape هنگام استفاده از مولدها (generators)
.sp
بسته شد #3128
.IP \(bu 2
تابع \fBinspect.getargvalues\fP دیگر به عنوان منسوخ علامت‌گذاری نمی‌شود.
.IP \(bu 2
بررسی جدید \fBf\-string\-without\-interpolation\fP اضافه شد
.sp
بسته شد #3190
.IP \(bu 2
نشانه‌گذاری ابزارهای تغییرپذیر \fBcollections.*\fP به عنوان مقادیر پیش‌فرض خطرناک
.sp
بسته شد #3183
.IP \(bu 2
پشتیبانی افزونهٔ \fBdocparams\fP از انواع چندگانه در بخش‌های raises.
.sp
همچنین در تمام بخش‌های معتبر، می‌توان چندین نوع را با کاما از هم جدا کرد.
.sp
بسته شد #2729
.IP \(bu 2
امکان تحلیل موازی کد (linting) هنگام اجرا تحت Prospector
.IP \(bu 2
رفع مثبت‌های کاذب \fBmethod\-hidden\fP هنگامی که یک زیرکلاس متدی را که پنهان می‌شود تعریف می‌کند.
.sp
بسته شد #414
.IP \(bu 2
حالت انتقال به پایتون ۳ در بیشتر پایگاه‌های کد ۳۰ تا ۵۰ درصد سریع‌تر شده است
.IP \(bu 2
حالت انتقال به پایتون ۳ دیگر خطاهای نحوی (syntax errors) را نادیده نمی‌گیرد
.sp
بسته شد #2956
.IP \(bu 2
ارسال شیء واقعی PyLinter به زیرفرآیندها جهت امکان استفاده از کلاس‌های
سفارشی PyLinter.
.sp
شیء PyLinter (و تمام اعضای آن به جز reporter) باید از فرآیند pickling
پشتیبانی کند تا بتوان شیء PyLinter را به فرایندهای کارگر (worker) منتقل کرد.
.IP \(bu 2
پاک‌سازی setup.py
.sp
الزام‌آور کردن pytest\-runner تنها در صورت اجرای آزمون‌ها، مشابه با McCabe.
.sp
پاک‌سازی فایل setup.py و رفع تعدادی از هشدارهای مربوط به آن.
.IP \(bu 2
مدیریت SyntaxError در فایل‌هایی که از طریق گزینهٔ \fB\-\-from\-stdin\fP ارسال می‌شوند
.sp
اگر فایلی که از ورودی استاندارد (stdin) خوانده می‌شود حاوی syntaxerror باشد،
Pylint دیگر traceback نمایش نمی‌دهد.
.IP \(bu 2
اصلاح سبک حروف بزرگ برای عدم اجازه به ۳ یا بیشتر حرف بزرگ که در ادامه حرف کوچک داشته باشند.
.IP \(bu 2
رفع مثبت‌های کاذب \fBundefined\-variable\fP و \fBunused\-import\fP
هنگام استفاده از یک متاکلاس از طریق یک مشخصه (attribute).
.sp
بسته شد #1603
.IP \(bu 2
صدور \fBunused\-argument\fP برای توابعی که قبل از برانگیختن استثنا، تنها بخشی از فهرست آرگومان‌های خود را استفاده می‌کنند.
.sp
بسته شد #3246
.IP \(bu 2
اصلاح افزونهٔ \fBbroad_try_clause\fP برای بررسی دستورهای try/finally و
بررسی دستورهای تودرتو (به عنوان مثال، درون یک دستور \fBif\fP).
.IP \(bu 2
شناسایی کلاس‌هایی که به‌طور صریح از \fBabc.ABC\fP ارث‌بری دارند یا دارای
متاکلاس \fBabc.ABCMeta\fP هستند به عنوان کلاس انتزاعی. این امر مانع از فعال شدن هشدار W0223 توسط آن‌ها می‌شود.
.sp
بسته شد #3098
.IP \(bu 2
رفع حساسیت بیش از حد \fBarguments\-differ\fP هنگامی که تابع بازنویسی‌شده از آرگومان‌های متغیر (variadics) استفاده می‌کند
.sp
در صورتی که تابع بازنویس‌کننده در امضای خود آرگومان‌های متغیر ترتیبی (positional) یا
کلیدواژه‌ای (keyword) ارائه دهد که بتوانند به‌طور معقول همه پارامترهای داده‌شده توسط
تابع بازنویسی‌شده را بپذیرند و انتقال دهند، هیچ پیامی صادر نمی‌شود.
.sp
بسته شد #1482
بسته شد #1553
.IP \(bu 2
انواع مختلف قالب‌بندی رشته‌ها در توابع لاگ‌گیری (logging) مجاز است.
.sp
پیام \fBlogging\-fstring\-interpolation\fP مجدداً بازگردانده شده است تا امکان
استفاده از چندین نوع قالب‌بندی رشته فراهم شود.
.sp
بسته شد #3361
.UNINDENT.SS تازه‌های Pylint 2.4
.sp
از ابتدای pylint تا نسخهٔ 2.14.0 (به‌همراه آن)، یک گزارش تغییرات (changelog) وجود داشت که دربردارندهٔ \fIتمام\fP تغییرات غیربدیهی در Pylint بود؛ از جمله تغییراتی که مربوط به سمت کاربر نبودند، یعنی تغییراتی که تنها اگر توسعه‌دهندهٔ فعال روی pylint یا افزونه‌های آن و یا تاریخ‌نگار متن‌باز باشید ممکن است برایتان جذاب باشد.
.sp
از pylint 1.6.0 تا 2.14.0، علاوه بر گزارش تغییرات کامل، خلاصه‌ای از تغییرات (عمدتاً سمت کاربر) نیز وجود داشت.
.SS خلاصه \-\- نکات برجستهٔ انتشار
.SS بررسی‌کننده‌های جدید
.INDENT 0.0
.IP \(bu 2
\fBimport\-outside\-toplevel\fP
.sp
این بررسی زمانی هشدار می‌دهد که ماژول‌ها از جایی غیر از بالاترین سطح ماژول (toplevel)، مثلاً درون یک تابع یا کلاس وارد (import) شوند.
.IP \(bu 2
بررسی جدیدی افزوده شد: \fBconsider\-using\-sys\-exit\fP
.sp
این بررسی زمانی صادر می‌شود که تشخیص داده شود به جای sys.exit() که روش ترجیحی برای خروج از برنامه است، quit() یا exit() فراخوانی شده است.
.sp
بسته شد #2925
.IP \(bu 2
بررسی جدیدی افزوده شد: \fBarguments\-out\-of\-order\fP
.sp
این بررسی زمانی هشدار می‌دهد که آرگومان‌هایی با نام‌های منطبق با امضای تابع داشته باشید، اما آن‌ها را با ترتیبی متفاوت به تابع ارسال کنید.
.sp
بسته شد #2975
.IP \(bu 2
بررسی‌های جدیدی افزوده شدند: \fBno\-else\-break\fP و \fBno\-else\-continue\fP
.sp
این بررسی‌ها بلوک‌های غیرضروری \fBelse\fP و \fBelif\fP را پس از دستورهای \fBbreak\fP و \fBcontinue\fP مشخص می‌کنند.
.sp
بسته شد #2327
.IP \(bu 2
بررسی \fBunnecessary\-comprehension\fP افزوده شد که ساخت‌های درک (comprehension) غیرضروری را تشخیص می‌دهد.
.sp
این بررسی زمانی صادر می‌شود که \fBpylint\fP ساخت‌های list-comprehension، set-comprehension یا dict-comprehension غیرضروری را پیدا کند که می‌توان آن‌ها را با سازنده‌های list، set یا dict بازنویسی کرد.
.sp
بسته شد #2905
.IP \(bu 2
بررسی جدیدی افزوده شد: \fBinvalid\-overridden\-method\fP
.sp
این بررسی زمانی صادر می‌شود که تشخیص داده شود یک متد به عنوان property یا یک property به عنوان متد بازنویسی (override) شده است. این موضوع می‌تواند نشان‌دهندهٔ باگی در کد برنامه باشد که خطای زمان اجرا (runtime error) ایجاد می‌کند.
.sp
بسته شد #2670
.IP \(bu 2
بررسی جدیدی افزوده شد: \fBredeclared\-assigned\-name\fP
.sp
این بررسی زمانی صادر می‌شود که \fBpylint\fP تشخیص دهد یک نام در همان انتساب یک یا چند بار مقداردهی شده است که نشان‌دهندهٔ یک باگ احتمالی است.
.sp
بسته شد #2898
.IP \(bu 2
بررسی جدیدی افزوده شد: \fBself\-assigning\-variable\fP
.sp
این بررسی زمانی صادر می‌شود که متغیر به خودش منتسب شود، که ممکن است نشان‌دهندهٔ یک باگ احتمالی در کد برنامه باشد.
.sp
برای مثال، کد زیر این هشدار را ایجاد می‌کند:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
def new_a(attr, attr2):
  a_inst = Aclass()
  a_inst.attr2 = attr2
  # should be: a_inst.attr = attr, but have a typo
  attr = attr
  return a_inst
.EE
.UNINDENT
.UNINDENT
.sp
بسته شد #2930
.IP \(bu 2
بررسی جدید \fBproperty\-with\-parameters\fP افزوده شد که داشتن بیش از یک آرگومان در یک property را تشخیص می‌دهد.
.sp
بسته شد #3006
.IP \(bu 2
بررسی \fBsubprocess\-run\-check\fP برای مدیریت subprocess.run بدون تعیین صریح کلمهٔ کلیدی \fBcheck\fP افزوده شد.
.sp
بسته شد #2848
.IP \(bu 2
پیام بررسی جدید \fBdict\-iter\-missing\-items\fP افزوده شد.
این پیام هنگام تلاش برای پیمایش روی یک dict در یک حلقهٔ for بدون فراخوانی متد .items() آن صادر می‌شود.
.sp
بسته شد #2761
.IP \(bu 2
پیام بررسی جدید \fBmissing\-parentheses\-for\-call\-in\-test\fP افزوده شد.
این پیام در صورتی صادر می‌شود که فراخوانی یک تابع درون یک آزمون (test) انجام شود اما پرانتزهای آن جا افتاده باشد.
.IP \(bu 2
بررسی جدید \fBclass\-variable\-slots\-conflict\fP افزوده شد.
.sp
این بررسی زمانی صادر می‌شود که \fBpylint\fP متغیر کلاسی را بیابد که با یک نام slot تداخل دارد، که در زمان اجرا موجب برانگیختن \fBValueError\fP می‌شود.
.sp
برای مثال، کد زیر موجب بروز خطا می‌شود:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
class A:
    __slots__ = (\(aqfirst\(aq, \(aqsecond\(aq)
    first = 1
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
بررسی جدید \fBpreferred\-module\fP افزوده شد.
.sp
این بررسی زمانی صادر می‌شود که \fBpylint\fP ماژول واردشده‌ای را پیدا کند که جایگزین ترجیح‌داده‌شده‌ای برای آن در \fBpreferred\-modules\fP فهرست شده است.
.sp
برای نمونه، می‌توانید ماژول‌های ترجیحی را به صورت \fBxml:defusedxml,json:ujson\fP تنظیم کنید تا \fBpylint\fP استفاده از \fBdefusedxml\fP به جای \fBxml\fP و \fBujson\fP را به جای \fBjson\fP پیشنهاد دهد.
.IP \(bu 2
افزونهٔ جدید \fBbroad_try_clause\fP اضافه شد.
.sp
این افزونه حداکثر تعداد قابل‌پیکربندی از دستورها را در درون یک بند try اعمال می‌کند. این امر اعمال رهنمودهای PEP 8 را دربارهٔ دستورهای try / except و حجم کد درون بند try تسهیل می‌کند.
.sp
می‌توانید این افزونه را با استفاده از \fB\-\-load\-plugins=pylint.extensions.broad_try_clause\fP فعال کنید و تعداد دستورها را در یک عبارت try با استفاده از \fB\-\-max\-try\-statements\fP پیکربندی نمایید.
.UNINDENT.SS "سایر تغییرات (Other Changes)"
.INDENT 0.0
.IP \(bu 2
عدم صدور \fBprotected\-access\fP زمانی که یک مشخصه با پیشوند تک خط زیرین درون یک متد ویژه استفاده می‌شود
.sp
بستن مسئله #1802
.IP \(bu 2
اکنون \fBlen\-as\-condition\fP تنها زمانی فعال می‌شود که فراخوانی \fBlen(x)\fP بدون یک مقایسه صریح انجام شده باشد.
.sp
پیام و توضیحات مربوط به این بررسی‌کننده برای انعکاس این رفتار جدید تغییر کرده است؛ با درخواست صریح مبنی بر این که یا بر نادرست (false) ارزیابی شدن دنباله‌های خالی تکیه شود یا طول دنباله با یک مقدار عددی (اسکالر) مقایسه گردد.
.sp
OK:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
if len(x) == 0:
  pass

while not len(x) == 0:
  pass

assert len(x) > 5, message
.EE
.UNINDENT
.UNINDENT
.sp
KO:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
if not len(x):
  pass

while len(x) and other_cond:
  pass

assert len(x), message
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
اکنون در صورتی که پرچم \fB\-\-from\-stdin\fP در خط فرمان استفاده شود، فایل از stdin خوانده می‌شود. علاوه بر پرچم \fB\-\-from\-stdin\fP، باید نام یک فایل (تکی) نیز در خط فرمان مشخص شود که برای گزارش مورد نیاز است.
.IP \(bu 2
بررسی‌کننده برای وارد کردن‌های گروه‌بندی‌نشده (ungrouped imports) اکنون آسان‌گیرتر شده است.
.UNINDENT
.sp
اکنون موارد وارد کردن (import) می‌توانند بر اساس شیوه وارد کردن به‌صورت الفبایی مرتب شوند. این امر \fBpylint\fP را با \fBisort\fP سازگار می‌کند.
.sp
موارد وارد کردن زیر دیگر خطای \fBungrouped\-imports\fP را فعال نمی‌کنند
.INDENT 0.0
.INDENT 3.5
.sp
.EX
import unittest
import zipfile
from unittest import TestCase
from unittest.mock import MagicMock
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
بررسی‌کننده برای مستندات بازگشتی ناموجود (missing return documentation) اکنون انعطاف‌پذیرتر است.
.UNINDENT
.sp
مورد زیر دیگر خطای \fBmissing\-return\-doc\fP را فعال نمی‌کند
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def my_func(self):
    \(dq\(dq\(dqThis is a docstring.

    Returns
    \-\-\-\-\-\-\-
    :obj:\(galist\(ga of :obj:\(gastr\(ga
        List of strings
    \(dq\(dq\(dq
    return [\(dqhi\(dq, \(dqbye\(dq] #@
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
گزینهٔ خط فرمان و پیکربندی \fBsignature\-mutators\fP اضافه شد.
.UNINDENT
.sp
با این گزینه، کاربران می‌توانند نادیده گرفتن خطاهای \fBtoo\-many\-function\-args\fP، \fBunexpected\-keyword\-arg\fP
و \fBno\-value\-for\-parameter\fP را برای توابعی که با تزیین‌کننده‌های تغییردهندهٔ امضای تابع تزیین شده‌اند، انتخاب کنند.
.sp
برای نمونه، یک آزمون ممکن است بخواهد از hypothesis استفاده کند.
اضافه کردن \fBhypothesis.extra.numpy.arrays\fP به \fBsignature_mutators\fP
به این معنا خواهد بود که \fBno\-value\-for\-parameter\fP برای قطعه کد زیر ایجاد نمی‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
@given(img=arrays(dtype=np.float32, shape=(3, 3, 3, 3)))
def test_image(img):
    ...
.EE
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
امکان استفاده از f\-strings به عنوان یک روش معتبر قالب‌بندی رشته‌های لاگ‌گیری (logging) فراهم شد.
.UNINDENT
.sp
بررسی‌کنندهٔ \fBlogging\-fstring\-\-interpolation\fP در
\fBlogging\-format\-interpolation\fP ادغام شده است تا گزینهٔ \fBlogging\-format\-style\fP
بتواند معتبر بودن سبک قالب‌بندی رشته لاگ را کنترل کند.
برای فعال‌سازی این قابلیت، مقدار جدید \fBfstr\fP برای گزینهٔ \fBlogging\-format\-style\fP
معتبر است.
.INDENT 0.0
.IP \(bu 2
دستور \fB\-\-list\-msgs\-enabled\fP اضافه شد.
.UNINDENT
.sp
هنگام فعال یا غیرفعال کردن چندین پیام و گروه در یک فایل پیکربندی،
ممکن است مشخص نباشد که در عمل کدام پیام‌ها فعال و کدام غیرفعال هستند.
این دستور جدید فهرست نهایی و حل‌وفصل‌شدهٔ پیام‌های فعال/غیرفعال را تولید می‌کند
که بر اساس نماد مرتب شده‌اند، اما شناسه (ID) آن‌ها نیز برای استفاده با \fB\-\-help\-msg\fP\& ارائه می‌شود..SS تغییرات کامل (Full changelog)
.SS چه مواردی در Pylint 2.4.4 جدید است؟
.sp
تاریخ انتشار: 2019\-11\-13
.INDENT 0.0
.IP \(bu 2
معاف شدن تمام نام‌های یافت‌شده در حاشیه‌نویسی‌های نوع (type annotations) از \fBunused\-import\fP
.sp
کد پیشین فرض می‌کرد که تنها نام‌های \fBtyping\fP باید معاف شوند، اما لازم است این کار برای سایر نام‌های موجود در کامنت‌های نوع نیز انجام شود.
.sp
بستن #3112
.IP \(bu 2
تسهیل شناسایی وارد کردن نوع (type import) برای نام‌هایی که از ماژول \fBtyping\fP نمی‌آیند
.sp
بستن #3191
.UNINDENT
.SS چه مواردی در Pylint 2.4.3 جدید است؟
.sp
تاریخ انتشار: 2019\-10\-18
.INDENT 0.0
.IP \(bu 2
رفع اشکال \fBunnecessary\-comprehension\fP در comprehensionهایی که دارای بسته‌بندی مجدد (repacking) مضاعف عناصر هستند.
.sp
بستن #3148
.IP \(bu 2
پیام \fBimport\-outside\-toplevel\fP برای گره‌های \fBImportFrom\fP نیز صادر می‌شود.
.sp
بستن #3175
.IP \(bu 2
عدم صدور \fBno\-method\-argument\fP برای توابعی که صرفاً از آرگومان‌های مکانی (positional-only) استفاده می‌کنند.
.sp
بستن #3161
.IP \(bu 2
پیام \fBconsider\-using\-sys\-exit\fP در صورت وارد شدن \fBexit\fP در حوزه محلی، دیگر صادر نمی‌شود.
.sp
بستن #3147
.IP \(bu 2
بررسی \fBinvalid\-overridden\-method\fP اکنون \fBabc.abstractproperty\fP را نیز در نظر می‌گیرد.
.sp
بستن #3150
.IP \(bu 2
رفع مشکل ایجاد نادرست هشدار \fBmissing\-yield\-type\-doc\fP هنگامی که یک مولد (generator) نوع yield را مستند نکرده اما دارای حاشیه‌نویسی نوع است.
.sp
بستن #3185
.IP \(bu 2
توابع \fBtyping.overload\fP از بررسی \fBtoo\-many\-function\-args\fP معاف شدند.
.sp
بستن #3170
.UNINDENT
.SS چه مواردی در Pylint 2.4.2 جدید است؟
.sp
تاریخ انتشار: 2019\-09\-30
.INDENT 0.0
.IP \(bu 2
گزینه \fBignored\-modules\fP می‌تواند زیرماژول‌ها را نیز نادیده بگیرد.
.sp
بستن #3135
.IP \(bu 2
بررسی \fBself\-assigning\-variable\fP انتساب‌های سطح کلاس را نادیده می‌گیرد.
.sp
بستن #2930
.IP \(bu 2
در صورت وارد کردن \fBexit()\fP از \fBsys\fP، از صدور \fBconsider\-using\-sys\-exit\fP صرف‌نظر می‌شود.
.sp
بستن #3145
.IP \(bu 2
معافیت انتساب‌های دارای حاشیه‌نویسی بدون متغیر از بررسی \fBclass\-variable\-slots\-conflict\fP
.sp
بستن #3141
.IP \(bu 2
اصلاح \fButils.is_error\fP برای در نظر گرفتن توابعی که خروج زودهنگام (return early) دارند.
.sp
این تغییر یک خطای منفی کاذب (false negative) را در \fBunused\-variable\fP برطرف می‌کند؛ در حالتی که یک تابع در آخرین دستور خود استثنایی صادر می‌کرد اما همچنان متغیرهای استفاده‌نشده‌ای در بدنه داشت، این هشدار پیش‌تر فعال نمی‌شد.
.sp
بستن #3028
.UNINDENT.SS تازه‌های Pylint 2.4.1 (What\(aqs New in Pylint 2.4.1?)
.sp
تاریخ انتشار: 2019\-09\-25
.INDENT 0.0
.IP \(bu 2
مستثنی کردن تعاریف بررسی نوع (type checking) که در هر دو بند از یک محافظ بررسی نوع (type checking guard) تعریف شده‌اند.
.sp
بسته شدن گزارش #3127
.IP \(bu 2
مستثنی کردن تعاریف بررسی نوع درون محافظ بررسی نوع.
.sp
در کامیت a7f236528bb3758886b97285a56f3f9ce5b13a99 پشتیبانی اولیه‌ای برای صدور هشدار \fBused\-before\-assignment\fP در صورتی که یک متغیر تنها درون یک محافظ بررسی نوع (با استفاده از متغیر \fBTYPE_CHECKING\fP از ماژول \fItyping\fP) تعریف شده باشد اضافه شد.
متأسفانه این مورد، استفاده از واردات (import) بررسی نوع را در داخل خودِ محافظ پوشش نداده بود، که موجب ایجاد خطاهای کاذب used\-before\-assignment / E0601 \%<#\:used-before-assignment> می‌شد.
.sp
بسته شدن گزارش #3119
.IP \(bu 2
الزام به astroid >= 2.3 جهت جلوگیری از هرگونه مشکل ناسازگاری.
.UNINDENT
.SS تازه‌های Pylint 2.4.0 (What\(aqs New in Pylint 2.4.0?)
.sp
تاریخ انتشار: 2019\-09\-24
.INDENT 0.0
.IP \(bu 2
بررسی جدید: \fBimport\-outside\-toplevel\fP
.sp
این بررسی زمانی هشدار می‌دهد که ماژول‌ها از جایی غیر از بالاترین سطح ماژول (toplevel)، مثلاً درون یک تابع یا کلاس وارد (import) شوند.
.IP \(bu 2
مدیریت ابهام در استنتاج (inference ambiguity) برای \fBinvalid\-format\-index\fP
.sp
بسته شدن گزارش #2752
.IP \(bu 2
حذف بررسی‌های مخصوص Python 2 مانند \fBrelative\-import\fP، \fBinvalid\-encoded\-data\fP و \fBmissing\-super\-argument\fP\&.
.IP \(bu 2
پشتیبانی از ارجاعات رو به جلو (forward references) برای بررسی \fBfunction\-redefined\fP.
.sp
بسته شدن گزارش #2540
.IP \(bu 2
مدیریت تعریف‌های مجدد در واردات (import) بررسی نوع.
.sp
بسته شدن گزارش #2834
.IP \(bu 2
افزودن بررسی جدید، \fBconsider\-using\-sys\-exit\fP
.sp
این بررسی زمانی صادر می‌شود که فراخوانی quit() یا exit() به جای sys.exit() شناسایی شود؛ در حالی که sys.exit() روش ترجیحی برای خروج از برنامه است.
.sp
بسته شدن گزارش #2925
.IP \(bu 2
بررسی \fBuseless\-suppression\fP اکنون نادیده‌گیری‌های \fBcyclic\-import\fP را نادیده می‌گیرد؛ زیرا به دلیل ناقص بودن بافتار (context) در هنگام بررسی، ممکن بود منجر به موارد مثبت کاذب شود.
.sp
بسته شدن گزارش #3064
.IP \(bu 2
افزودن بررسی‌های جدید، \fBno\-else\-break\fP و \fBno\-else\-continue\fP
.sp
این بررسی‌ها بلوک‌های غیرضروری \fBelse\fP و \fBelif\fP پس از دستورهای \fBbreak\fP و \fBcontinue\fP را مشخص می‌کنند.
.sp
بسته شدن گزارش #2327
.IP \(bu 2
عدم صدور \fBprotected\-access\fP هنگامی که مشخصه‌ای با پیشوند تک زیرخط (underscore) درون یک متد خاص استفاده شده باشد.
.sp
بسته شدن گزارش #1802
.IP \(bu 2
اصلاح مقادیر \(dqstatement\(dq در گزارش‌های آماری PyLinter بر اساس ماژول.
.IP \(bu 2
افزودن بررسی جدید، \fBinvalid\-overridden\-method\fP
.sp
این بررسی زمانی صادر می‌شود که بازنویسی (override) یک متد به عنوان property یا یک property به عنوان متد تشخیص داده شود. این حالت می‌تواند نشان‌دهندهٔ باگی در کد برنامه باشد که خطای زمان اجرا ایجاد می‌کند.
.sp
بسته شدن گزارش #2670
.IP \(bu 2
افزودن بررسی جدید، \fBarguments\-out\-of\-order\fP
.sp
این بررسی زمانی هشدار می‌دهد که نام آرگومان‌ها با امضای تابع مطابقت دارد ولی با ترتیبی متفاوت به تابع ارسال می‌شوند.
.sp
بسته شدن گزارش #2975
.IP \(bu 2
افزودن بررسی جدید، \fBredeclared\-assigned\-name\fP
.sp
این بررسی زمانی صادر می‌شود که \fBpylint\fP تشخیص دهد یک نام یک یا چند بار در یک انتساب یکسان مقداردهی شده است که نشان‌دهندهٔ یک باگ بالقوه است.
.sp
بسته شدن گزارش #2898
.IP \(bu 2
نادیده گرفتن فراخوانی‌های lambda با آرگومان‌های متغیر (variadic) بدون بافتار (context).
.sp
استنتاج آرگومان‌های موضعی متغیر و آرگومان‌های کلیدواژه‌ای منجر به تاپل‌ها (Tuples) و دیکشنری‌های (Dicts) خالی می‌شود که می‌تواند در برخی موارد منجر به مثبت‌های کاذب در رابطه با no\-value\-for\-parameter / E1120 \%<#\:no-value-for-parameter>\& گردد.
برای جلوگیری از این امر، تا زمانی که از انتشار بافتار فراخوانی (call context propagation) پشتیبانی شود، در صورت شناسایی چنین مواردی آن‌ها را نادیده می‌گیریم.
ما قبلاً این کار را برای فراخوانی توابع انجام داده بودیم، اما اصلاح قبلی \fBlambdas\fP را در نظر نگرفته بود.
.sp
بسته شدن گزارش #2918
.IP \(bu 2
افزودن بررسی جدید، \fBself\-assigning\-variable\fP\&. این بررسی زمانی صادر می‌شود که تشخیص داده شود یک متغیر به خودش منتسب شده است، که ممکن است نشان‌دهندهٔ باگی بالقوه در کد برنامه باشد.
.sp
بسته شدن گزارش #2930
.IP \(bu 2
افزودن بررسی جدید، \fBproperty\-with\-parameters\fP\&.
.sp
این بررسی زمانی صادر می‌شود که تشخیص داده شود یک property تعریف‌شده دارای پارامترهایی است که بی‌استفاده هستند.
.sp
بسته شدن گزارش #3006
.IP \(bu 2
مستثنی کردن کلاس‌های پروتکل (protocol classes) از چندین بررسی.
.sp
بسته شدن گزارش #3002.
.IP \(bu 2
افزودن بررسی \fBunnecessary\-comprehension\fP برای تشخیص comprehensionهای غیرضروری.
.sp
این بررسی زمانی صادر می‌شود که \fBpylint\fP عبارت‌های list\-، set\- یا dict\-comprehension غیرضروری را بیابد که می‌توانند با سازنده‌های list\-، set\- یا dict بازنویسی شوند.
.sp
بسته شدن گزارش #2905
.IP \(bu 2
مستثنی کردن متغیرهای نمونه (instance) و کلاسِ PEP 526 از بررسی \fBno\-member\fP\&.
.sp
بسته شدن گزارش #2945
.IP \(bu 2
مستثنی کردن \fBattrs\fP از بررسی \fBtoo\-few\-public\-methods\fP.
.sp
بسته شدن گزارش #2988.
.IP \(bu 2
صدور \fBunused\-import\fP برای نام‌های واردات صحیح در محدوده‌های (scopes) تابع.
.sp
بسته شدن گزارش #2928
.IP \(bu 2
پایان پشتیبانی از Python 3.4.
.IP \(bu 2
عدم فعال‌سازی \fBassignment\-from\-no\-return\fP برای متدهای ناهمگام (async).
.sp
بسته شدن گزارش #2902
.IP \(bu 2
عدم صدور \fBattribute\-defined\-outside\-init\fP برای متغیرهای تعریف‌شده در setterها.
.sp
بسته شدن گزارش #409
.IP \(bu 2
گزارش شماره ستون برای خطاهای نحوی (Syntax errors).
.sp
بسته شدن گزارش #2914
.IP \(bu 2
پشتیبانی از واردات نام کامل (fully qualified) از typing برای حاشیه‌نویسی نوع (type annotations).
.sp
بسته شدن گزارش #2915
.IP \(bu 2
مستثنی کردن \fB__dict__\fP از \fBattribute\-defined\-outside\-init\fP
.IP \(bu 2
اصلاح نشانگر بررسی املا زمانی که خطا بیش از یک بار در همان خط رخ می‌دهد.
.sp
بسته شدن گزارش #2895
.IP \(bu 2
رفع خطای منجر به خرابی (crash) زمانی که والد شیء فراخوانی‌شده قابل تعیین نیست.
.IP \(bu 2
مجاز دانستن of در \fBGoogleDocstring.re_multiple_type\fP
.IP \(bu 2
افزودن \fBsubprocess\-run\-check\fP برای مدیریت subprocess.run بدون تعیین صریح کلیدواژهٔ \fBcheck\fP.
.sp
بسته شدن گزارش #2848
.IP \(bu 2
هنگامی که دستگیره‌های except لخت (bare except handlers) قابل استنتاج نیستند، نادیده گرفتن \fBtry\-except\-raise\fP
.sp
بسته شدن گزارش #2853.IP \(bu 2
مدیریت موارد بیشتری از \fBunnecessary\-lambda\fP هنگام کار با kwargs اضافی در فراخوانی‌های محصورشده (wrapped calls)
.sp
بستن #2845
.IP \(bu 2
بهبود مدیریت ارزیابی به تعویق‌افتادهٔ یادداشت‌ها (postponed evaluation of annotations)
.sp
بستن #2847
.IP \(bu 2
پشتیبانی از ارزیابی به تعویق‌افتادهٔ یادداشت‌ها برای یادداشت‌های متغیرها.
.sp
بستن #2838
.IP \(bu 2
در صورتی که فایل اجرایی جاری یک مفسر پایتون نباشد، \fBepylint.py_run\fP به‌طور پیش‌فرض از \fBpython\fP استفاده می‌کند.
.sp
بستن #2837
.IP \(bu 2
نادیده گرفتن docstringهای خام هنگام اجرای بررسی‌کنندهٔ Similarities با گزینهٔ \fBignore\-docstrings=yes\fP
.IP \(bu 2
رفع خرابی و کرش هنگام فراخوانی \fBinherit_from_std_ex\fP روی کلاسی که نیاکان خودش است
.sp
بستن #2680
.IP \(bu 2
افزودن یک بررسی جدید که اگر فراخوانی تابعی درون یک آزمون به کار رود اما فاقد پرانتز باشد، به کاربر هشدار می‌دهد.
.sp
بستن #2658
.IP \(bu 2
بررسی \fBlen\-as\-condition\fP اکنون تنها زمانی فعال می‌شود که فراخوانی \fBlen(x)\fP بدون مقایسه‌ای صریح انجام شده باشد
.sp
پیام و توضیحات ارائه‌شده همراه با این بررسی‌کننده برای بازتاب این رفتار جدید تغییر کرده است؛ با درخواست صریح مبنی بر این‌که یا به نادرست بودن (false) دنباله‌های خالی تکیه شود یا طول با یک مقدار اسکالر مقایسه گردد.
.sp
بستن #2684
.IP \(bu 2
افزودن بررسی‌کنندهٔ \fBpreferred\-module\fP که در صورت وجود یک ماژول جایگزین مناسب که باید استفاده شود، اطلاع می‌دهد.
.sp
این بررسی زمانی صادر می‌شود که \fBpylint\fP یک ماژول واردشده را بیابد که جایگزین ترجیحی آن در \fBpreferred\-modules\fP فهرست شده است.
.IP \(bu 2
عدم صدور \fBassigning\-non\-slot\fP برای کلاس‌هایی با کلاس‌های پایهٔ ناشناخته.
.sp
بستن #2807
.IP \(bu 2
عدم صدور \fBold\-division\fP برای گره‌های غیر Const.
.sp
بستن #2808
.IP \(bu 2
افزودن آرگومان‌های متد به نویسندهٔ dot برای pyreverse.
.sp
بستن #2139
.IP \(bu 2
پشتیبانی از تحلیل کد (linting) فایل از طریق stdin.
.sp
محیط‌های توسعه یکپارچه (IDEها) ممکن است از پشتیبانی بررسی کد از یک فایل درون‌حافظه‌ای بهره‌مند شوند.
.sp
بستن #1187
.IP \(bu 2
افزودن بررسی جدید \fBclass\-variable\-slots\-conflict\fP
.sp
این بررسی هنگامی صادر می‌شود که \fBpylint\fP متغیر کلاسی را بیابد که با یک نام slot تداخل دارد؛ چیزی که در زمان اجرا موجب برانگیختن خطای \fBValueError\fP می‌شود.
.IP \(bu 2
افزودن بررسی جدید: dict\-iter\-missing\-items / E1141 \%<#\:dict-iter-missing-items> (E1141)
.sp
بستن #2761
.IP \(bu 2
رفع مشکل نام pylint در خروجی python \-m pylint \-\-version
.sp
بستن #2764
.IP \(bu 2
تغییر مجوز اقلام لوگو و نشان‌ها به مجوز CC BY\-SA 4.0.
.IP \(bu 2
صرف‌نظر کردن از عبارت‌های \fBif\fP از f\-stringها برای بررسی‌کنندهٔ \fBcheck_elif\fP
.sp
بستن #2816
.IP \(bu 2
کد C0412 (ungrouped\-import) اکنون با isort سازگار است.
.sp
بستن #2806
.IP \(bu 2
افزودن افزونه‌ای جدید برای تشخیص کد بیش از اندازه در یک بند try
.sp
بستن #2877
.IP \(bu 2
گزینهٔ \fBsignature\-mutators\fP اضافه شد.
با این گزینه، کاربران می‌توانند نادیده‌گرفتن هشدارهای \fBtoo\-many\-function\-args\fP، \fBunexpected\-keyword\-arg\fP
و \fBno\-value\-for\-parameter\fP را برای توابعی که با دکوراتورهای تغییردهندهٔ امضای تابع تزئین شده‌اند، انتخاب کنند.
.sp
بستن #259
.IP \(bu 2
رفع نادیده‌گرفته‌شدن کامنت pragma در خط فیزیکی مستقل، هنگامی که بخشی از یک خط منطقی به همراه خط فیزیکی پیشین بود.
.sp
بستن #199
.IP \(bu 2
رفع مثبت کاذب \fBundefined\-loop\-variable\fP برای تابعی که درون حلقه تعریف شده و از متغیر تعریف‌شده در همان حلقه استفاده می‌کند.
.sp
بستن #202
.IP \(bu 2
رفع صدور هشدارهای \fBunused\-argument\fP و \fBfunction\-redefined\fP برای توابعی که با \fBtyping.overload\fP تزئین شده‌اند.
.sp
بستن #1581
.IP \(bu 2
رفع مثبت کاذب در \fBconsider\-using\-dict\-comprehension\fP برای ساختارهایی که نمی‌توانند به یک comprehension تبدیل شوند
.sp
بستن #2963
.IP \(bu 2
افزودن \fB__post_init__\fP به \fBdefining\-attr\-methods\fP به منظور جلوگیری از \fBattribute\-defined\-outside\-init\fP در dataclassها.
.sp
بستن #2581
.IP \(bu 2
تغییر توضیحات W0199 برای استفاده از عبارت 2\-item\-tuple به جای 2\-uple.
.IP \(bu 2
مجاز کردن \fB\&.\fP به عنوان پیشوند برای تفکیک نام Sphinx.
.IP \(bu 2
بررسی‌کننده‌ها اکنون باید رابطهٔ یک‌به‌یک را میان \(dqmsgid\(dq (مانند: C1234) و \(dqsymbol\(dq (مانند: human\-readable\-symbol) حفظ کنند
.IP \(bu 2
در بررسی‌کننده‌ها، یک old_names اکنون می‌تواند برای چندین پیام جدید استفاده شود و pylint اکنون کمی سریع‌تر شده است
.sp
این بدان معناست که اگر یک old_names جزئی برای تعریف پیام تعریف کنید، یک استثنا به شما اعلام خواهد کرد که باید شناسهٔ مرتبط را تغییر نام دهید.
.IP \(bu 2
امکان انتخاب f\-stringها به عنوان روشی معتبر برای قالب‌بندی رشته‌های ثبت گزارش (logging).
.sp
بستن #2395
.IP \(bu 2
افزودن دستور \fB\-\-list\-msgs\-enabled\fP برای فهرست کردن تمام پیام‌های فعال و غیرفعال با توجه به فایل RC جاری و آرگومان‌های خط فرمان.
.UNINDENT.SS "تازه‌های Pylint 2.3"
.sp
از آغاز pylint تا نگارش 2.14.0 به‌طور کامل، گزارش تغییراتی وجود داشت که شامل \fIتمام\fP
تغییرات غیرجزئی در Pylint می‌شد؛ از جمله تغییراتی که
کاربر با آن‌ها مواجه نمی‌شد؛ یعنی تغییراتی که ممکن بود تنها برای توسعه‌دهندگانی که
روی pylint یا پلاگین‌های آن کار می‌کنند یا تاریخ‌نگاران متن‌باز جالب باشند.
.sp
از نگارش 1.6.0 تا 2.14.0 در pylint، علاوه بر گزارش کامل تغییرات، خلاصه‌ای
از تغییرات (عمدتاً مرتبط با کاربر) نیز وجود داشت.
.SS "خلاصه \-\- نکات برجسته انتشار"
.INDENT 0.0
.IP \(bu 2
این انتشار، عملکرد سری 2.X را پس از افت کارایی رخ‌داده در چند نگارش پیشین بهبود می‌بخشد.
.UNINDENT
.SS "وارسی‌کننده‌های جدید"
.INDENT 0.0
.IP \(bu 2
پیام بررسی جدید \fBwrong\-exception\-operation\fP اضافه شد\&.
این پیام زمانی صادر می‌شود که عملیاتی روی یک استثنا انجام شود، اما آن عملیات
برای استثنای مذکور معتبر نباشد. معمولاً هنگام وجود
عملیات دوتایی میان استثناها در گرداننده‌های except صادر می‌شود.
.sp
بستن #2494
.IP \(bu 2
هشدار جدید \fBno\-else\-raise\fP مشابه \fBno\-else\-return\fP اضافه شد
.sp
بستن #2558
.IP \(bu 2
گزینه جدید \fBcheck\-str\-concat\-over\-line\-jumps\fP برای بررسی
\fBimplicit\-str\-concat\-in\-sequence\fP در چندین خط اضافه شد.
.UNINDENT
.SS "سایر تغییرات"
.sp
شمار فراوانی رفع اشکال و بهبود در این انتشار گنجانده شده است، که در اینجا به چند مورد از آن‌ها اشاره می‌شود.
برای مشاهده تمام تغییرات، گزارش کامل تغییرات را بررسی کنید.
.INDENT 0.0
.IP \(bu 2
دیگر هشدارهای بررسی \fB*\-not\-iterating\fP برای توابع توکاری که توسط \fBitertools\fP مصرف می‌شوند صادر نمی‌شود
.IP \(bu 2
برخی موارد مثبت کاذب برای \fBno\-self\-argument\fP و \fBunsubscriptable\-object\fP
هنگام استفاده از \fB__class_getitem__\fP (جدید در Python 3.7) برطرف شد
.IP \(bu 2
اکنون \fBpylint\fP از \fBEllipsis\fP به‌عنوان هم‌معنی برای دستورهای \fBpass\fP پشتیبانی می‌کند.
.IP \(bu 2
هشدار \fBfixme\fP تنها روی کامنت‌ها فعال می‌شود.
.IP \(bu 2
دستور \fBpylint\fP باز کردن بسته‌بندی با ستاره (starred unpacking) را از بررسی‌های Python 3 مربوط به \fB*\-not\-iterating\fP معاف می‌کند.
.IP \(bu 2
وارسی‌کننده \fBcompare\-to\-zero\fP اکنون با بررسی برابری و همانی، سخت‌گیری کمتری اعمال می‌کند.
.UNINDENT
.sp
\fI\(ga\(gayield from\(ga\(ga از بررسی‌های \(ga\(ga\fP\-not\-iterating\(ga\(ga در Python 3 معاف شد.
.INDENT 0.0
.IP \(bu 2
یک مورد مثبت کاذب در \fBnot\-async\-context\-manager\fP ناشی از عدم درک
\fBcontextlib.asynccontextmanager\fP برطرف شد.
.IP \(bu 2
وارسی‌کننده \fBbad\-reversed\-sequence\fP برای در نظر گرفتن اشیای بیشتری که می‌توانند \fB__reversed__\fP را تعریف کنند بازنویسی شد\&.
.IP \(bu 2
اکنون در صورت فقدان یک عضو در enumها، هشدار \fBno\-member\fP صادر می‌شود.
.IP \(bu 2
پلاگین‌ها اکنون می‌توانند از قلاب \fBload_configuration()\fP استفاده کنند.
این قلاب پس از بارگیری پیکربندی اجرا می‌شود تا از رونویسی پیکربندی
ویژه پلاگین از طریق پیکربندی مبتنی بر کاربر جلوگیری شود.
.IP \(bu 2
یک گزینه خط فرمان جدید با نام \fBlist\-groups\fP برای فهرست کردن تمام گروه‌های وارسی که
\fBpylint\fP می‌شناسد اضافه شده است. این گزینه برای آگاهی از اینکه چه گروه‌هایی را می‌توان به‌صورت
جداگانه فعال یا غیرفعال کرد مفید است.
.UNINDENT
.SS "گزارش کامل تغییرات"
.SS "تازه‌های Pylint 2.3.0"
.sp
تاریخ انتشار: 2019\-02\-27
.INDENT 0.0
.IP \(bu 2
محافظت در برابر \fBNonDeducibleTypeHierarchy\fP هنگام فراخوانی \fBis_subtype\fP نیمه‌خصوصی
.sp
تابع \fBastroid.helpers.is_subtype\fP زمانی که نتواند کلاس‌های پایه نوع‌های داده‌شده را استنتاج کند
\fBNonDeducibleTypeHierarchy\fP را صادر می‌کند؛ اما این کار در بافتار خودش منطقی است، چرا که
این متد بیشتر برای آگاه ساختن فرآیند استنتاج از سلسله‌مراتب کلاس‌ها استفاده می‌شود.
اما برای خود \fBpylint\fP چندان منطقی نیست، به همین دلیل ما این استثنا را در اینجا مدیریت
می‌کنیم و نه در \fBastroid\fP
.sp
بستن pylint\-dev/astroid#644
.IP \(bu 2
یک گزینه خط فرمان جدید با نام \fBlist\-groups\fP برای فهرست کردن تمام گروه‌های وارسی که \fBpylint\fP می‌شناسد اضافه شد.
.IP \(bu 2
امکان استفاده از \fBBaseException\fP برای صدور \fBbroad\-except\fP، دقیقاً مانند \fBException\fP فراهم شد\&.
.sp
بستن #2741
.IP \(bu 2
رفع یک مورد کرش که برای \fBbad\-str\-strip\-call\fP زمانی که \fBstrip()\fP مقدار \fBNone\fP را دریافت می‌کرد رخ می‌داد
.sp
بستن #2743
.IP \(bu 2
عدم صدور بررسی‌های \fB*\-not\-iterating\fP برای توابع توکاری که توسط \fBitertools\fP مصرف می‌شوند
.sp
بستن #2731
.IP \(bu 2
رفع خرابی ناشی از تکرار روی \fBUninferable\fP در یک بررسی قالب‌بندی رشته.
.sp
بستن #2727
.IP \(bu 2
رفع موارد مثبت کاذب برای \fBno\-self\-argument\fP و \fBunsubscriptable\-object\fP هنگام استفاده از \fB__class_getitem__\fP (جدید در Python 3.7)
.sp
بستن #2416
.IP \(bu 2
پشتیبانی از \fBEllipsis\fP به‌عنوان هم‌معنی برای دستورهای \fBpass\fP.
.sp
بستن #2718
.IP \(bu 2
فعال شدن \fBfixme\fP فقط روی کامنت‌ها.
.sp
بستن #2321
.IP \(bu 2
رفع یک مورد مثبت کاذب برای انتساب‌های \fBunused\-variable\fP و \fBnonlocal\fP
.sp
بستن #2671
.IP \(bu 2
افزودن قلاب \fBload_configuration()\fP برای پلاگین‌ها
.sp
قلاب اختیاری جدیدی برای پلاگین‌ها افزوده شد: \fBload_configuration()\fP\&.
این قلاب پس از بارگیری پیکربندی اجرا می‌شود تا از
رونویسی پیکربندی ویژه پلاگین از طریق پیکربندی مبتنی بر کاربر جلوگیری شود.
.sp
بستن #2635
.IP \(bu 2
رفع مثبت کاذب در missing\-raises\-doc / W9006 \%<#\:missing-raises-doc> (W9006)
.sp
بستن #1502
.IP \(bu 2
معاف کردن باز کردن با ستاره از بررسی‌های Python 3 مربوط به \fB*\-not\-iterating\fP
.sp
بستن #2651
.IP \(bu 2
کاهش حساسیت \fBcompare\-to\-zero\fP از طریق بررسی برابری و همانی
.sp
بستن #2645
.IP \(bu 2
افزودن هشدار \fBno\-else\-raise\fP (R1720)
.sp
بستن #2558
.IP \(bu 2
معاف کردن \fByield from\fP از بررسی‌های Python 3 مربوط به \fB*\-not\-iterating\fP.
.sp
بستن #2643
.IP \(bu 2
رفع صدور نادرست هشدارهای \fBno\-else\-return\fP (R1705)
.sp
مشکلی برطرف شد که در آن دستورهای \fBif\fP دارای دستورهای تو در توی \fBif\fP
در مواردی به نادرستی با \fBno\-else\-return\fP نشانه‌گذاری می‌شدند و در
موارد دیگر با \fBno\-else\-return\fP نشانه‌گذاری نمی‌شدند. آزمون‌هایی
برای اعتبارسنجی اضافه شدند و فایل‌های مبدأ pylint برای رفع
هشدارهای تازه آشکارشده به‌روزرسانی شدند.
.IP \(bu 2
رفع مثبت کاذب با \fBnot\-async\-context\-manager\fP ناشی از عدم درک \fBcontextlib.asynccontextmanager\fP
.sp
بستن #2440
.IP \(bu 2
بازنویسی \fBbad\-reversed\-sequence\fP برای پشتیبانی از اشیای بیشتری که می‌توانند \fB__reversed__\fP را تعریف کنند
.sp
یکی از این اشیا یک کلاس enum است که برای آن \fB__reversed__\fP هر یک از اعضای enum را برمی‌گرداند.
به این ترتیب، وارسی برای \fBbad\-reversed\-sequence\fP در هنگام بررسی وجود \fB__reversed__\fP نباید تفاوتی میان کلاس‌ها
و نمونه‌ها قائل شود.
.sp
بستن #2598
.IP \(bu 2
افزودن \fBwrong\-exception\-operation\fP
.sp
زمانی استفاده می‌شود که عملیاتی روی یک استثنا انجام شود، اما آن عملیات
برای استثنای مربوطه معتبر نباشد. معمولاً هنگام وجود
عملیات دوتایی میان استثناها در گرداننده‌های except صادر می‌شود.
.sp
بستن #2494
.IP \(bu 2
صدور \fBno\-member\fP برای enumها هنگامی که فاقد یک عضو باشند
.sp
پیش از این، این کار را انجام نمی‌دادیم زیرا پیاده‌سازی \fB__getattr__\fP
را روی کلاس \fBEnum\fP شناسایی می‌کردیم
(و این بررسی برای کلاس‌های دارای \fB__getattr__\fP نادیده گرفته می‌شود)،
اما این وضعیت برای Enumها مناسب است، با توجه به اینکه آن‌ها به روشی سفارشی‌شده
در astroid استنتاج می‌شوند.
.UNINDENT.sp
بستن #2565
.IP \(bu 2
تعمیم \fBchained\-comparison\fP
.sp
نسخه پیشین به اشتباه \fIa < b < c and b < d\fP را تشخیص می‌داد و موفق به تشخیص \fIa < b < c and c < d\fP نمی‌شد\&.
.IP \(bu 2
جلوگیری از حذف __main__ هنگام استفاده از چندین پردازش (multiple jobs)
.sp
بستن #2689
.IP \(bu 2
افزودن گزینه جدید \(aqcheck\-str\-concat\-over\-line\-jumps\(aq برای بررسی implicit\-str\-concat\-in\-sequence / W1403 \%<#\:implicit-str-concat-in-sequence>\(aq
.IP \(bu 2
اصلاحاتی برای تحلیل‌گر قالب وقایع‌نگاری (logging) سبک جدید.
.sp
تعداد آرگومان‌ها به درستی مدیریت نمی‌شد که منجر به موفقیت همیشگی بررسی می‌شد.
.IP \(bu 2
رفع مثبت کاذب \fBnot\-callable\fP برای ویژگی‌های (properties) غیرقابل استنتاج.
.IP \(bu 2
رفع مثبت کاذب \fBuseless\-else\-on\-loop\fP در صورتی که break در عمق else یک حلقه درونی باشد.
.IP \(bu 2
بهبودهای جزئی در متن راهنمای چند گزینه.
.UNINDENT
.SS تازه‌های Pylint 2.2
.sp
از ابتدای pylint تا نسخه 2.14.0 (شامل آن)، ما گزارش تغییراتی داشتیم که شامل \fIتمام\fP تغییرات غیرجزئی Pylint بود، از جمله تغییراتی که برای کاربران نهایی نبودند؛ یعنی تغییراتی که تنها اگر توسعه‌دهنده‌ای باشید که روی pylint یا افزونه‌های pylint کار می‌کنید یا یک تاریخ‌نگار متن‌باز هستید ممکن است برایتان جالب باشد.
.sp
از pylint 1.6.0 تا 2.14.0، علاوه بر گزارش تغییرات کامل، خلاصه‌ای از تغییرات (عمدتاً کاربرمحور) نیز وجود داشت.
.SS خلاصه \-\- نکات برجسته انتشار
.SS بررسی‌کننده‌های جدید
.INDENT 0.0
.IP \(bu 2
بررسی‌کننده رشته اکنون عدم تطابق نوع در رشته قالب‌بندی را گزارش می‌کند.
.IP \(bu 2
بررسی‌کننده \fBduplicate\-string\-formatting\-argument\fP برای تشخیص آرگومان‌های تکراری قالب‌بندی رشته اضافه شد که باید به جای آن به عنوان آرگومان‌های نام‌دار ارسال شوند.
.IP \(bu 2
گزینه \fBlogging\-format\-style\fP یک گزینه جدید برای بررسی‌کننده وقایع‌نگاری جهت استفاده از رشته‌های قالب‌بندی به سبک ()str.format در فراخوانی‌های لاگر است.
.sp
این گزینه دو حالت را می‌پذیرد: \fB\-\-logging\-format\-style=old\fP برای استفاده از قالب‌بندی به سبک \fI%\fP، که پیش‌فرض در نظر گرفته شده است، و \fB\-\-logging\-format\-style=new\fP برای استفاده از قالب‌بندی به سبک \fI{}\fP\&.
.IP \(bu 2
بررسی‌کننده \fBimplicit\-str\-concat\-in\-sequence\fP الحاق رشته‌ها را درون لیست‌ها، مجموعه‌ها و تاپل‌ها تشخیص می‌دهد.
.sp
نمونه کدی که چنین هشداری تولید می‌کند:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
woops = (\(aqa\(aq, \(aqb\(aq \(aqc\(aq)
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.SS سایر تغییرات
.INDENT 0.0
.IP \(bu 2
بررسی‌کننده \fBtry\-except\-raise\fP اکنون سلسله‌مراتب وراثت چندسطحی را برای استثناها به درستی مدیریت می‌کند.
.sp
بستن #2484
.IP \(bu 2
نادیده گرفتن موارد import x.y.z as z برای بررسی‌کننده \fBuseless\-import\-alias\fP\&.
.IP \(bu 2
هشدار \fBunnecessary\-pass\fP اکنون در صورتی که یک تابع یا کلاس تنها شامل docstring و دستور pass باشد نیز صادر می‌شود؛ چرا که در این حالت، docstring برای تعریف خالی کفایت می‌کند.
.IP \(bu 2
رفع مثبت کاذب \fBundefined\-variable\fP و \fBused\-before\-assignment\fP هنگام استفاده از کلمه کلیدی nonlocal\&.
.IP \(bu 2
رفع رخ دادن استثناها در \fBcheckers.utils.is_subclass_of\fP هنگامی که یکی از پارامترها ClassDef نباشد.
.IP \(bu 2
ابزار \fBpylint\fP اکنون هنگام بررسی \fBraising\-non\-exception\fP، آخرین مقدار را از میان مقادیر استنتاج‌شده استثنای برانگیخته‌شده انتخاب می‌کند. این موضوع هنگام استفاده مجدد از یک نام متغیر برای چند نوع مختلف کمک می‌کند، چرا که پیش‌تر \fBpylint\fP تنها نخستین مقدار استنتاج‌شده را انتخاب می‌کرد که منجر به مثبت‌های کاذب نادرست می‌شد.
.sp
بستن #2431
.IP \(bu 2
ابزار \fBpylint\fP پیش‌تر هنگام بررسی هم‌روال‌های ساخته‌شده با \fBasyncio.coroutine\fP خطای \fBnot\-an\-iterable\fP صادر می‌کرد. این مورد دیگر رخ نمی‌دهد زیرا هم‌روال‌ها به صورت صریح مدیریت می‌شوند.
.sp
بستن #996
.IP \(bu 2
ابزار \fBpylint\fP در صورت وجود import استفاده‌نشده در تابع، خطای \fBunused\-variable\fP صادر می‌کرد. اکنون به جای \fBunused\-variable\fP، خطای \fBunused\-import\fP صادر می‌شود.
.sp
بستن #2421
.UNINDENT.SS تاریخچه کامل تغییرات (Full changelog)
.SS چه مواردی در Pylint 2.2.2 جدید است؟
.sp
تاریخ انتشار: 2018\-11\-28
.INDENT 0.0
.IP \(bu 2
تغییر \fBlogging\-format\-style\fP به‌طوری که به‌جای شناسه‌های متناظر پایتونی، از شناسه نام استفاده کند
.sp
این کار برای بی‌نیاز کردن کاربران از فکر کردن درباره گریز (escape) دادن مقدار پیش‌فرض \fBlogging\-format\-style\fP در فایل پیکربندی تولیدشده است. همچنین ابزارهای تحلیل پیکربندی ما هنگام تشخیص \fBchoices\fP به‌طور کامل از مقادیر گریز داده‌شده پشتیبانی نمی‌کنند، بنابراین این موضوع نیازمند ترفندهای مختلفی برای دور زدن آن می‌بود.
.sp
بسته شدن #2614
.UNINDENT
.SS چه مواردی در Pylint 2.2.1 جدید است؟
.sp
تاریخ انتشار: 2018\-11\-27
.INDENT 0.0
.IP \(bu 2
رفع خرابی ناشی از \fBimplicit\-str\-concat\-in\-sequence\fP و نویسه‌های چندبایتی.
.sp
بسته شدن #2610
.UNINDENT
.SS چه مواردی در Pylint 2.2 جدید است؟
.sp
تاریخ انتشار: 2018\-11\-25
.INDENT 0.0
.IP \(bu 2
در نظر گرفتن اشیاء \fBrange()\fP برای \fBundefined\-loop\-variable\fP که از تکرار حلقه نشت می‌کند.
.sp
بسته شدن #2533
.IP \(bu 2
\fBdeprecated\-method\fP می‌تواند از نام مشخصه برای شناسایی یک متد منسوخ‌شده استفاده کند
.UNINDENT
.INDENT 0.0
.INDENT 3.5
پیش از این ما از نام کاملاً مشخص‌شده (fully qualified name) استفاده می‌کردیم (که هنوز هم استفاده می‌کنیم)، اما نام کاملاً مشخص‌شده برای برخی نام‌های مستعار منسوخ‌شده‌ی \fBunittest\fP به یک تابع منسوخ‌سازی عمومی منتهی می‌شود. به‌جای اتکا به آن، اکنون به نام مشخصه نیز اتکا می‌کنیم، که باید برخی موارد مثبت کاذب را برطرف کند.
.INDENT 0.0
.INDENT 3.5
بسته شدن #1653
بسته شدن #1946
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
رفع ناسازگاری با تغییرات اعمال‌شده در توکن‌ساز stdlib.
.IP \(bu 2
\fBpylint\fP اشتیاق کمتری برای مصرف کل خط جهت پراگماها (pragmas) نشان می‌دهد
.sp
بسته شدن #2485
.IP \(bu 2
دریافت تعداد صحیح پردازنده‌ها (CPUs) برای محیط‌های مجازی‌سازی‌شده یا کانتینری.
.sp
بسته شدن #2519
.IP \(bu 2
بازگرداندن مجدد \fBunbalanced\-tuple\-unpacking\fP به وضعیت هشدار.
.UNINDENT
.INDENT 0.0
.INDENT 3.5
این مورد تا چند سال پیش یک هشدار بود، تا اینکه به یک خطا تبدیل شد. اما این بررسی ممکن است در برخی موارد پیشنهاد نادرستی ارائه دهد، به‌عنوان مثال هنگام بررسی در برابر \fBsys.argv\fP که در زمان تحلیل ایستا نمی‌توان آن را دانست. با توجه به اینکه ممکن است به داده‌های ناشناخته‌ی احتمالی وابسته باشد، بهتر است به‌صورت یک هشدار باقی بماند.
.INDENT 0.0
.INDENT 3.5
بسته شدن #2522
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
حذف پیشنهاد استفاده از \fBenumerate\fP هنگام تعریف \fB__iter__\fP (C0200)
.sp
بسته شدن #2477
.IP \(bu 2
صدور \fBtoo\-many\-starred\-assignment\fP فقط زمانی که تعداد گره‌های Starred به‌ازای عناصر انتساب باشد
.sp
بسته شدن #2513
.IP \(bu 2
بررسی‌کننده \fBtry\-except\-raise\fP اکنون سلسله‌مراتب وراثت چندسطحی را برای استثناها به‌درستی مدیریت می‌کند.
.sp
بسته شدن #2484
.IP \(bu 2
افزودن یک بررسی جدید، \fBsimplifiable\-if\-expression\fP برای عبارت‌هایی مانند \fBTrue if cond else False\fP\&.
.sp
بسته شدن #2487
.IP \(bu 2
\fBtoo\-few\-public\-methods\fP برای \fBtyping.NamedTuple\fP گزارش نمی‌شود
.sp
بسته شدن #2459
.IP \(bu 2
\fB\(gatoo\-few\-public\-methods\fP برای dataclassهایی که با گزینه‌ها ایجاد شده‌اند گزارش نمی‌شود.
.sp
بسته شدن #2488
.IP \(bu 2
حذف ماژول‌های اشتباه از \(aqbad\-python3\-import\(aq.
.sp
بسته شدن #2453
.IP \(bu 2
گزارش‌دهنده \fBjson\fP در صورتی که هیچ پیامی صادر نشود، یک فهرست خالی چاپ می‌کند
.sp
بسته شدن #2446
.IP \(bu 2
افزودن یک بررسی جدید، \fBduplicate\-string\-formatting\-argument\fP
.UNINDENT
.INDENT 0.0
.INDENT 3.5
این بررسی جدید هر زمان که یک آرگومان تکراری در قالب‌بندی رشته یافت شود، صادر می‌شود.
.INDENT 0.0
.INDENT 3.5
بسته شدن #497
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
\fBassignment\-from\-no\-return\fP برای کوروتین‌ها صادر نمی‌شود.
.sp
بسته شدن #1715
.IP \(bu 2
گزارش عدم تطابق نوع در رشته قالب‌بندی.
.IP \(bu 2
\fBconsider\-using\-ternary\fP و \fBsimplified\-boolean\-expression\fP دیگر برای بررسی‌های مبتنی بر دنباله صادر نمی‌شوند
.sp
بسته شدن #2473
.IP \(bu 2
مدیریت \fBAstroidSyntaxError\fP هنگام تلاش برای وارد کردن یک ماژول.
.sp
بسته شدن #2313
.IP \(bu 2
اجازه دادن به بازتعریف \fB__module__\fP در سطح کلاس.
.sp
بسته شدن #2451
.IP \(bu 2
قبلاً \fBpylint\fP اگر یک import استفاده‌نشده در تابع یافت می‌شد، خطای \fBunused\-variable\fP صادر می‌کرد. اکنون به‌جای \fBunused\-variable\fP، خطای \fBunused\-import\fP صادر می‌شود.
.sp
بسته شدن #2421
.IP \(bu 2
مدیریت asyncio.coroutine هنگام بررسی \fBnot\-an\-iterable\fP.
.sp
بسته شدن #996
.IP \(bu 2
بررسی \fBlocally\-enabled\fP حذف شده است.
.sp
بسته شدن #2442
.IP \(bu 2
استنتاج متدهای آراسته‌شده (decorated methods) هنگام بررسی method\-hidden
.sp
بسته شدن #2369
.IP \(bu 2
انتخاب آخرین مقدار از مقادیر استنتاج‌شده هنگام جست‌وجو برای \fBraising\-non\-exception\fP
.sp
بسته شدن #2431
.IP \(bu 2
گسترش محافظ TYPE_CHECKING به نام TYPE_CHECKING نیز، علاوه بر مشخصه‌ی آن
.sp
بسته شدن #2411
.IP \(bu 2
نادیده گرفتن موارد import x.y.z as z برای بررسی‌کننده \fBuseless\-import\-alias\fP\&.
.sp
بسته شدن #2309
.IP \(bu 2
رفع مثبت کاذب در \fBundefined\-variable\fP و \fBused\-before\-assignment\fP هنگام استفاده از کلیدواژه nonlocal.
.sp
بسته شدن #2049
.IP \(bu 2
متوقف کردن استثنای \fBprotected\-access\fP برای مشخصه‌های ناموجود کلاس
.IP \(bu 2
عدم صدور \fBassignment\-from\-no\-return\fP برای گره‌های توابع آراسته‌شده.sp
بسته شد: #2385
.IP \(bu 2
اکنون پیام \fBunnecessary\-pass\fP زمانی که یک تابع یا کلاس تنها شامل docstring و دستور pass باشد نیز صادر می‌شود.
.sp
در پایتون، توابع ساختگی (stubbed) معمولاً بدنه‌ای دارند که فقط حاوی یک دستور \fBpass\fP است،
که نشان می‌دهد تابع هیچ کاری انجام نمی‌دهد. با این حال، یک تابع ساختگی می‌تواند تنها یک
docstring نیز داشته باشد، و تابعی با docstring و بدون بدنه نیز هیچ کاری انجام نمی‌دهد.
.sp
بسته شد: #2208
.IP \(bu 2
پیام \fBduplicate\-argument\-name\fP برای بیش از یک آرگومان تکراری در هر تابع صادر می‌شود
.sp
بسته شد: #1712
.IP \(bu 2
اجازه دادن به سطوح تورفتگی دوگانه برای تمایزپذیری بهتر تورفتگی‌ها
.sp
بسته شد: #741
.IP \(bu 2
در نظر گرفتن تاپل‌ها در مدیریت‌کننده استثنا برای \fBtry\-except\-raise\fP\&.
.sp
بسته شد: #2389
.IP \(bu 2
اصلاح بررسی astroid.ClassDef در checkers.utils.is_subclass_of
.IP \(bu 2
رفع نادیده گرفته شدن واردسازی‌های عام (wildcard imports) توسط بازرس واردسازی
.IP \(bu 2
اصلاح اشکال در تمایز بین خارجی/داخلی در گراف واردسازی
.IP \(bu 2
اصلاح نادیده‌نگرفتن \fB__init__.py\fP در بررسی واردسازی‌های عام
.sp
بسته شد: #2430
.IP \(bu 2
افزودن گزینه جدید \fBlogging_format_style\fP به بازرس لاگ‌گیری
.IP \(bu 2
اصلاح \-\-ignore\-imports برای پشتیبانی و فهم واردسازی‌های چندخطی
.sp
بسته شد: #1422
بسته شد: #2019
.IP \(bu 2
افزودن بررسی جدید \(aqimplicit\-str\-concat\-in\-sequence\(aq برای تشخیص الحاق رشته‌ها درون لیست‌ها، مجموعه‌ها و تاپل‌ها.
.IP \(bu 2
هشدار \fBliteral\-comparison\fP اکنون برای مقادیر مستقیم 0 و 1 نیز صادر می‌شود.
.UNINDENT
.SS "تازه‌های Pylint 2.1 (What\(aqs New In Pylint 2.1)"
.sp
از آغاز pylint تا نسخه 2.14.0 (شامل آن)، ما یک گزارش تغییرات داشتیم که شامل \fIتمام\fP
تغییرات غیرجزئی در Pylint می‌شد، از جمله تغییراتی که
رو به کاربر نبودند، یعنی تغییراتی که تنها در صورتی ممکن بود برایتان جالب باشند که توسعه‌دهنده‌ای
باشید که روی pylint یا افزونه‌های pylint کار می‌کند، یا یک تاریخ‌نگار پروژه‌های متن‌باز باشید.
.sp
از pylint 1.6.0 تا 2.14.0، علاوه بر گزارش تغییرات کامل، خلاصه‌ای از تغییرات
(عمدتاً مرتبط با کاربر) نیز وجود داشت.
.SS "خلاصه \-\- نکات برجسته انتشار (Summary \-\- Release highlights)"
.INDENT 0.0
.IP \(bu 2
این انتشار عمدتاً شامل رفع اشکالاتی است که پس از عرضه 2.0 پیدا شده‌اند.
.UNINDENT
.SS "بازرس‌های جدید (New checkers)"
.INDENT 0.0
.IP \(bu 2
یک بررسی جدید افزوده شد: \fBmisplaced\-format\-function\fP\&.
.sp
این پیام زمانی صادر می‌شود که pylint تشخیص دهد تابع format روی شیئی غیر از str فراخوانی شده است.
این حالت می‌تواند به دلیل قرارگیری نادرست پرانتز بسته رخ دهد، مانند:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
print(\(aqvalue: {}\(aq).format(123) # bad

print(\(aqvalue: {}\(aq.format(123)) # good
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.SS "سایر تغییرات (Other Changes)"
.INDENT 0.0
.IP \(bu 2
بررسی \fBtry\-except\-raise\fP در راستای مسئله #2323، از سطح خطا به هشدار تنزل یافت.
.IP \(bu 2
مدیریت صحیح نام جدید پیاده‌سازی پایتونی ماژول \fBabc\fP.
.sp
در پایتون 3.7، ماژول \fBabc\fP هم دارای پیاده‌سازی C و هم پیاده‌سازی پایتون است،
اما پیاده‌سازی پایتونی نام فایلی متفاوت با آنچه \fBpylint\fP انتظار داشت دارد
که باعث سردرگمی برخی از بررسی‌ها می‌شد.
.IP \(bu 2
ماژول‌های دارای \fB__getattr__\fP به طور پیش‌فرض از \fBno\-member\fP معاف هستند
.sp
راه ساده‌ای برای تشخیص اینکه آیا یک ماژول عضو خاصی دارد وجود ندارد، هنگامی که
آن ماژول از \fB__getattr__\fP استفاده می‌کند؛ قابلیتی که به تازگی به پایتون 3.7 اضافه شده است.
در عوض، ما جانب احتیاط را رعایت می‌کنیم، همانند کاری که برای کلاس‌ها انجام می‌دهیم،
و از بررسی آن ماژول‌ها صرف‌نظر می‌کنیم.
.IP \(bu 2
بررسی \fBinvalid name\fP دیگر برای نام‌های توابع و مشخصه‌هایی که طولانی‌تر
از ۳۰ کاراکتر باشند فعال نمی‌شود. حد بالا کاملاً حذف شد.
.IP \(bu 2
رفع مثبت کاذب در \fBundefined\-variable\fP برای نام کلاس‌های خودارجاع در عبارات lambda
.IP \(bu 2
بررسی \fBno\-else\-return\fP نوع شاخه‌ای را که باعث ایجاد خطا شده است نیز مشخص می‌کند.
.IP \(bu 2
اصلاح رفتار ناسازگار برای bad\-continuation در خط نخست فایل.
.IP \(bu 2
رفع باگی که در آن \fBpylint\fP قادر نبود پیام‌های مشخصی را در خط پایانی از طریق
گزینه غیرفعال‌سازی سراسری غیرفعال کند.
.IP \(bu 2
ابزار \fBpylint\fP دیگر در حالتی که تنها یک عبارت منفرد بیابد که خود \fBreturn\fP است، \fBuseless\-return\fP را صادر نمی‌کند
.sp
ما همچنان می‌خواهیم هنگامی که قرار است تابعی یک مقدار اختیاری را بازگرداند،
صراحت حفظ شود؛ حتی با اینکه \fBpass\fP می‌تواند کار کند، اما به اندازه کافی صریح
نیست و ممکن است تابع طوری به نظر برسد که انگار پیاده‌سازی آن فراموش شده است.
.IP \(bu 2
رفع باگی که در آن \fBpylint\fP هنگام ناتوانی در استنتاج مقدار یک آرگومان برای \fBnext()\fP دچار فروپاشی می‌شد
.IP \(bu 2
ابزار \fBpylint\fP هنگام مواجهه با تکرارکننده‌های ناهمگام (async iterators) دیگر \fBnot\-an\-iterable\fP را صادر نمی‌کند.
.IP \(bu 2
ابزار \fBpylint\fP امکان تعیین نوع پیش‌فرض docstring را برای مواقعی که بازرسی قادر به حدس زدن نوع نیست، به دست آورد
.sp
برای این منظور، گزینه خط فرمان \fB\-\-default\-docstring\-type\fP افزوده شد.
.UNINDENT.SS گزارش کامل تغییرات
.SS چه مواردی در Pylint 2.1.1 جدید است؟
.sp
تاریخ انتشار: 2018\-08\-07
.INDENT 0.0
.IP \(bu 2
رفع خرابی pylint ناشی از عدم مدیریت صحیح ویژگی کلاس در \fBmisplaced\-format\-function\fP.
.sp
بسته شد #2384
.IP \(bu 2
عدم صدور *\-builtin برای بررسی‌های توکار (builtin) در Python 3 زمانی که مورد توکار درون یک try\-except استفاده شده باشد
.sp
بسته شد #2228
.IP \(bu 2
عدم صدور \fBsimplifiable\-if\-statement\fP هنگام کار با اندیس‌ها (subscripts)
.UNINDENT
.SS چه مواردی در Pylint 2.1 جدید است؟
.sp
تاریخ انتشار: 2018\-08\-01
.INDENT 0.0
.IP \(bu 2
پیام \fBtrailing\-comma\-tuple\fP برای دستورهای \fByield\fP نیز صادر می‌شود.
.sp
بسته شد #2363
.IP \(bu 2
تنها دریافت آرگومان‌های تابع دامنه برای \fBredefined\-argument\-from\-local\fP
.sp
بسته شد #2364
.IP \(bu 2
افزودن بررسی \fBmisplaced\-format\-function\fP که در صورت استفاده از تابع format روی شیئی غیر از str صادر می‌شود.
.sp
بسته شد #2200
.IP \(bu 2
\fBchain.from_iterable\fP دیگر هنگام کار با مقادیر و کلیدهای dict، پیام \fIdict\-{}\-not\-iterating\fP را صادر نمی‌کند
.IP \(bu 2
تنزل پیام \fBtry\-except\-raise\fP از یک خطا به یک هشدار (E0705 \-> W0706)
.sp
بسته شد #2323
.IP \(bu 2
مدیریت صحیح نام جدید پیاده‌سازی پایتونی ماژول \fBabc\fP.
.sp
بسته شد pylint\-dev/astroid#2288
.IP \(bu 2
ماژول‌های دارای \fB__getattr__\fP به‌طور پیش‌فرض از \fBno\-member\fP معاف هستند
.sp
راه ساده‌ای وجود ندارد تا مشخص شود آیا یک ماژول دارای عضو خاصی هست یا خیر، هنگامی که ماژول مذکور از \fB__getattr__\fP استفاده می‌کند (که قابلیتی تازه در Python 3.7 است).
در عوض، همان کاری را که برای کلاس‌ها انجام می‌دهیم به عنوان راه‌حل امن در نظر گرفته و از بررسی این ماژول‌ها صرف‌نظر می‌کنیم.
.sp
بسته شد #2331
.IP \(bu 2
رفع پیام مثبت کاذب \fBinvalid name\fP هنگامی که نام متد یا ویژگی بیشتر از 30 نویسه باشد.
.sp
بسته شد #2047
.IP \(bu 2
گنجاندن نوع شاخه بعدی در \fBno\-else\-return\fP
.sp
بسته شد #2295
.IP \(bu 2
رفع رفتار ناسازگار برای bad\-continuation در سطر اول فایل
.sp
بسته شد #2281
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
رفع ناتوانی در غیرفعال‌سازی برخی پیام‌ها در سطر آخر از طریق گزینه غیرفعال‌سازی سراسری (global disable)
.UNINDENT
.INDENT 0.0
.INDENT 3.5
بسته شد #2278
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
عدم صدور \fBuseless\-return\fP هنگامی که تنها یک دستور وجود دارد که خودِ بازگشت (return) است
.sp
ما همچنان می‌خواهیم زمانی که تابعی قرار است یک مقدار اختیاری را بازگرداند، صریح باشد؛ هرچند \fBpass\fP نیز کار می‌کند، اما به‌اندازه کافی صریح نیست و ممکن است تابع چنین به نظر برسد که فاقد پیاده‌سازی است.
.sp
بسته شد #2300
.IP \(bu 2
رفع مثبت کاذب undefined\-variable / E0602 \%<#\:undefined-variable> برای نام کلاس‌های خودارجاع در lambdaها
.sp
بسته شد #704
.IP \(bu 2
عدم خرابی زمانی که \fBpylint\fP قادر به استنتاج مقدار یک آرگومان برای \fBnext()\fP نیست
.sp
بسته شد #2316
.IP \(bu 2
عدم صدور \fBnot\-an\-iterable\fP هنگام کار با تکرارکننده‌های ناهمگام (async iterators).
.sp
اما صدور آن در صورت استفاده از پروتکل تکرار معمول در برابر تکرارکننده‌های ناهمگام.
.sp
بسته شد #2311
.IP \(bu 2
امکان مشخص کردن نوع docstring پیش‌فرض برای زمانی که بررسی نتواند نوع را حدس بزند
.sp
بسته شد #1169
.UNINDENT.SS "تازه‌های Pylint 2.0 (What\(aqs New In Pylint 2.0)"
.sp
از آغاز pylint تا نسخهٔ 2.14.0 (شامل آن)، سیاههٔ تغییراتی (changelog) داشتیم که دربردارندهٔ \fIتمام\fP
تغییرات غیرجزئی Pylint بود؛ از جمله تغییراتی که
برای کاربران نهایی نبودند، یعنی تغییراتی که تنها در صورتی برای شما جالب بودند که توسعه‌دهنده‌ای
باشید که روی pylint یا افزونه‌های pylint کار می‌کنید، یا تاریخ‌نگار پروژه‌های متن‌باز باشید.
.sp
از pylint 1.6.0 تا 2.14.0، علاوه بر سیاههٔ کامل تغییرات، خلاصه‌ای از
تغییرات (عمدتاً برای کاربران نهایی) نیز وجود داشت.
.SS "خلاصه \-\- نکات برجسته انتشار (Summary \-\- Release highlights)"
.INDENT 0.0
.IP \(bu 2
پشتیبانی از Python 2 پایان یافت. این انتشار تنها روی Python 3.4+ کار خواهد کرد.
.sp
اگر نیاز به استفاده از \fBpylint\fP با Python 2 دارید، می‌توانید از Pylint 1.9+ استفاده کنید. ما تا
سال ۲۰۲۰ که Python 2 رسماً به پایان عمر (EOL) می‌رسد، به انتشار نسخه‌های رفع باگ ادامه خواهیم داد.
\fBpylint\fP قابلیت تحلیل فایل‌های Python 2 را به دست خواهد آورد، اما ممکن است برخی از بررسی‌ها کار نکنند
زیرا فرض می‌کنند که محیط اجرای آن‌ها Python 2 است.
.IP \(bu 2
با توجه به حذف پشتیبانی از Python 2، حالت انتقال به Python 3 (که با \fB\-\-py3k\fP فعال می‌شود) اکنون
می‌تواند با Python 3 نیز اجرا شود.
.sp
حالت انتقال در گذشته روی Python 3 بی‌اثر (no\-op) بود، اما اکنون وقتی مفسر در حال اجرا Python 3 است،
بسیاری از پیام‌ها می‌توانند صادر شوند. تنها پیام‌هایی صادر نخواهند شد که به نحو (syntax) خاصی وابسته
باشند که مختص به Python 2 است، برای مثال \fBprint\fP به عنوان یک عبارت (statement).
.UNINDENT
.SS "بررسی‌کننده‌های جدید (New checkers)"
.INDENT 0.0
.IP \(bu 2
یک بررسی جدید افزوده شد: \fBuseless\-object\-inheritance\fP\&.
.sp
این پیام بازسازی کد (refactoring) زمانی صادر می‌شود که pylint تشخیص دهد یک کلاس از object ارث‌بری می‌کند،
که زاید است زیرا در Python 3، هر کلاسی به طور ضمنی از object ارث‌بری می‌کند.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
class A(object):
    pass

class A:    # better
    pass
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی جدید افزوده شد: \fBcomparison\-with\-callable\fP\&.
.sp
این پیام بازسازی کد زمانی صادر می‌شود که pylint تشخیص دهد مقایسه‌ای با یک فراخوان‌پذیر (callable) انجام
شده است؛ امری که ممکن است نشان‌دهندهٔ از قلم افتادن پرانتزها باشد و به رفتارهای ناخواسته
منجر گردد.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
def foo():
    return None

def goo():
    return None

if foo == 786:  # bad
    pass

if foo() == 786:    # good
    pass
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی جدید افزوده شد: \fBchained\-comparison\fP\&.
.sp
این پیام بازسازی کد اگر یک عملیات بولی را بتوان با زنجیره‌ای کردن برخی از عملیات آن ساده‌تر کرد،
صادر می‌شود. مثال زیر را بررسی کنید:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
if a < b and b < c:
    pass

if a < b < c:   # better
    pass
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی جدید افزوده شد: \fBuseless\-import\-alias\fP\&.
.sp
این پیام بازسازی کد زمانی صادر می‌شود که نام مستعار واردسازی (import alias)، نام بستهٔ اصلی را تغییر ندهد.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
import numpy as numpy # bad
import numpy as np # good
from collection import OrderedDict as OrderedDict # bad
from collection import OrderedDict as ordered_dict # good
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی جدید افزوده شد: \fBcomparison\-with\-itself\fP\&.
.sp
این پیام بازسازی کد زمانی صادر می‌شود که یک متغیر با خودش مقایسه شود.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
if variable == variable:  # bad
    pass
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی جدید افزوده شد: \fBconsider\-using\-in\fP\&.
.sp
این پیام بازسازی کد زمانی صادر می‌شود که یک متغیر به جای استفاده از بررسی سریع‌تر و اصطلاحی‌تر \(dqin\(dq،
با چندین مقدار متوالی که با or پیوند خورده‌اند مقایسه شود.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
if variable == 1 or variable == 2 or variable == 3:  # bad
    pass

if variable in (1, 2, 3):  # good
    pass
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی جدید افزوده شد: \fBconsider\-using\-get\fP\&.
.sp
این پیام بازسازی کد زمانی صادر می‌شود که بررسی وجود یک کلید در دیکشنری و دریافت مقدار آن در صورت وجود
(و به‌صورت اختیاری یک مقدار پیش‌فرض در صورت عدم وجود) به‌صورت دستی انجام گیرد،
به جای اینکه از روش اصطلاحی‌تر dict.get استفاده شود.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
if \(aqkey\(aq in dictionary:  # bad
    variable = dictionary[\(aqkey\(aq]
else:
    variable = \(aqdefault\(aq

variable = dictionary.get(\(aqkey\(aq, \(aqdefault\(aq)  # good
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی جدید افزوده شد: \fBconsider\-using\-join\fP\&.
.sp
این پیام بازسازی کد زمانی صادر می‌شود که برای پیوند دادن رشته‌ها از یک حلقهٔ for روی یک پیمایش‌پذیر (iterable) استفاده
شود، به جای str.join(sequence) که سریع‌تر است، حافظهٔ کمتری مصرف می‌کند و روش اصطلاحی‌تری به شمار می‌رود.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
result = \(aq\(aq  # bad
for number in [\(aq1\(aq, \(aq2\(aq, \(aq3\(aq]:
    result += number

result = \(aq\(aq.join([\(aq1\(aq, \(aq2\(aq, \(aq3\(aq])  # good
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
پیام جدید \fBuseless\-return\fP هنگامی که تابع یا متد با عبارت \(dqreturn\(dq یا
\(dqreturn None\(dq خاتمه یابد و این تنها عبارت return در بدنه باشد.
.IP \(bu 2
پیام جدید \fBuse\-symbolic\-message\-instead\fP هنگامی که یک پیام به جای نماد (symbol)،
با شناسه (id) فعال یا غیرفعال شود.
استفاده از نماد صریح‌تر است و به‌خاطرسپاری آن آسان‌تر خواهد بود.
.IP \(bu 2
یک بررسی جدید افزوده شد: \fBconsider\-swap\-variables\fP\&.
.sp
این پیام بازسازی کد زمانی صادر می‌شود که برای جابه‌جایی مقادیر دو متغیر، از یک متغیر موقت
به جای رویکرد کوتاه‌تر و اصطلاحی‌تر با استفاده از tuple\-unpacking استفاده شود..sp
به جای یک متغیر موقت، باید از نحو تک‌خطی به همراه کاما استفاده شود.
.sp
برای جزئیات، این سند راهنمای نگارش \%<https://\:docs\:.python-guide\:.org/\:writing/\:style> یا ارائه \fIswap values presentation\fP در Pycon 2007 را ببینید.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
temp = a  # the wrong way
a = b
b = temp

a, b = b, a  # the right way
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
دو بررسی جدید، \fBinvalid\-envvar\-value\fP و \fBinvalid\-envvar\-default\fP اضافه شدند.
.sp
مورد نخست هر زمان که pylint تشخیص دهد توابع دستکاری متغیر محیطی از نوعی غیر از رشته استفاده می‌کنند فعال می‌شود، در حالی که مورد دوم هر زمان که توابع مذکور از یک متغیر پیش‌فرض با نوعی متفاوت از نوع مورد انتظار استفاده کنند، صادر می‌گردد.
.IP \(bu 2
یک بررسی جدید اضافه شد: \fBsubprocess\-popen\-preexec\-fn\fP،
.sp
این پیام بازآرایی زمانی صادر می‌شود که هنگام ایجاد نمونه‌های subprocess.Popen از آرگومان کلیدواژه‌ای preexec_fn استفاده شود، که ممکن است استفاده از آن در حضور ریسه‌ها (threads) ناامن باشد.
.sp
برای جزئیات کامل هشدار، subprocess.Popen \%<https://\:docs\:.python\:.org/\:3/\:library/\:subprocess\:.html#\:popen-constructor>
را ببینید.
.IP \(bu 2
پیام جدید \fBtry\-except\-raise\fP زمانی صادر می‌شود که یک بلوک مدیریت except دارای دستور \fBraise\fP خالی به عنوان نخستین عملگر خود باشد، یا نوع استثنای برانگیخته‌شده همان استثنایی باشد که در حال مدیریت است.
.IP \(bu 2
بررسی جدید \fBpossibly\-unused\-variable\fP اضافه شد.
.UNINDENT
.INDENT 0.0
.INDENT 3.5
این مورد شبیه به \fBunused\-variable\fP است؛ با این تفاوت که زمانی صادر می‌شود که یک فراخوانی locals() در حوزه متغیر استفاده‌نشده شناسایی شود. فراخوانی \fBlocals()\fP می‌تواند با مصرف تمام مقادیر موجود تا نقطه فراخوانی، به‌طور بالقوه از متغیر مذکور استفاده کند. این بررسی جدید امکان غیرفعال کردن این خطا را زمانی که کاربر عمداً از \fBlocals()\fP برای مصرف همه‌چیز استفاده می‌کند، فراهم می‌سازد.
.sp
برای نمونه، کد زیر اکنون این خطای جدید را ایجاد خواهد کرد:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
def func():
    some_value = some_call()
    return locals()
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
بررسی جدید \fBunhashable\-dict\-key\fP برای تشخیص جستجوها در dict با استفاده از کلیدهای غیرقابل درهم‌سازی (unhashable) مانند لیست‌ها یا دیکشنری‌ها اضافه شد.
.IP \(bu 2
بررسی هشدار جدید \fBself\-cls\-assignment\fP اضافه شد.
.sp
این بررسی در صورتی که به نخستین آرگومان یک متد نمونه/کلاس مقداری انتساب یابد، هشدار می‌دهد
.INDENT 2.0
.INDENT 3.5
.sp
.EX
class Foo(object):
    def foo(self, bar):
        self = bar
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
گزینه حالت پرگو (verbose mode) جدید \fB\-\-verbose\fP برای نمایش خروجی‌های اضافی غیرمرتبط با بررسی‌کننده‌ها. به‌طور پیش‌فرض غیرفعال است.
.IP \(bu 2
دو بررسی جدید برای پیشنهاد استفاده از ساختارهای ادراک دیکشنری و مجموعه (dict and set comprehensions) در صورت امکان اضافه شدند.
.sp
این دو بررسی مثال‌های زیر را نشانه‌گذاری خواهند کرد:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
dict([(k, v) for (k, v) in ...]) # better as {k: v for k, v in ...}
set([k for k in ...]) # better as {k for k in ...}
.EE
.UNINDENT
.UNINDENT
.UNINDENT.SS سایر تغییرات
.INDENT 0.0
.IP \(bu 2
چندین بهبود کارایی اعمال‌شده در \fBastroid\fP باید باعث شود که
\fBpylint\fP نیز کمی سریع‌تر شود.
.sp
ما پرچم جدیدی به نام \fBmax_inferable_values\fP را در \fBastroid.MANAGER\fP اضافه کردیم تا
حداکثر تعداد مقادیری را که \fBastroid\fP می‌تواند هنگام استنتاج مقادیر استنتاج کند، محدود سازد. این تغییر باید کارایی را هنگام کار با چارچوب‌های بزرگ
مانند \fBdjango\fP بهبود بخشد\&.
همچنین می‌توانید این رفتار را با \fBpylint \-\-limit\-inference\-results\fP کنترل کنید.
.sp
ما همچنین نحوه عملکرد متدهای \fBnodes_of_class\fP و \fBget_children\fP را بازنویسی کردیم که
باید منجر به افزایش کارایی برای چندین بررسی شود.
.IP \(bu 2
رفع پیام مثبت کاذب \fBinconsistent\-return\-statements\fP زمانی که استثنا درون
یک دستور else رخ می‌دهد.
.IP \(bu 2
عدم هشدار برای \fBmissing\-type\-doc\fP و/یا \fBmissing\-return\-type\-doc\fP، در صورتی که یادداشت‌های نوع (type annotations)
روی امضای تابع برای یک پارامتر و/یا نوع بازگشتی وجود داشته باشد.
.IP \(bu 2
رفع پیام مثبت کاذب \fBinconsistent\-return\-statements\fP زمانی که دستور if
درون try/except قرار دارد.
.IP \(bu 2
رفع پیام مثبت کاذب \fBinconsistent\-return\-statements\fP هنگام
استفاده از حلقه‌های \fBwhile\fP.
.IP \(bu 2
رفع صدور پیام مثبت کاذب \fBno\-member\fP برای کلاسی با
ویژگی‌های \(dqخصوصی\(dq که نام آن‌ها درهم‌سازی (mangled) شده است.
.IP \(bu 2
رفع مثبت کاذب‌های \fBunused\-argument\fP با متغیر سایه‌اندازی‌شده در comprehension دیکشنری.
.IP \(bu 2
رفع مثبت کاذب \fBinconsistent\-return\-statements\fP هنگامی که
توابع بدون بازگشت استفاده می‌شوند (مانند sys.exit).
.IP \(bu 2
رفع پیام مثبت کاذب \fBinconsistent\-return\-statements\fP زمانی که یک
تابع زیر یک دستور if تعریف شده باشد.
.IP \(bu 2
رفع پیام مثبت کاذب \fBinconsistent\-return\-statements\fP با
جلوگیری از استنتاج بیهوده استثنا در صورتی که استثنا مدیریت نشده باشد.
.IP \(bu 2
رفع مثبت کاذب \fBundefined\-variable\fP برای آرگومان lambda در تعاریف کلاس.
.IP \(bu 2
فرونشانی پیام‌های مثبت کاذب \fBnot\-callable\fP ناشی از توصیف‌گرهای خاص staticmethod.
.IP \(bu 2
گسترش \fBignored\-argument\-names\fP برای دربرگرفتن آرگومان‌های ستاره‌دار و آرگومان‌های کلیدواژه‌ای.
.IP \(bu 2
بررسی \fBsingleton\-comparison\fP شرایط بولی بهتری را برای شروط منفی پیشنهاد خواهد کرد.
.IP \(bu 2
بررسی \fBundefined\-loop\-variable\fP قبل از صدور، اشیاء پیمایش‌شده‌ی غیرخالی را در نظر می‌گیرد.
.sp
به عنوان مثال، اگر پیمایش‌پذیر حلقه خالی نباشد، این بررسی دیگر صادر نخواهد شد.
.IP \(bu 2
کلاس‌های Enum دیگر \fBtoo\-few\-methods\fP را فعال نمی‌کنند.
.IP \(bu 2
متدهای ویژه اکنون در شمارش متدهای \fBtoo\-few\-methods\fP لحاظ می‌شوند،
و بخشی از API عمومی در نظر گرفته می‌شوند.
آن‌ها همچنان در تعداد متدها برای \fBtoo\-many\-methods\fP\& شمرده نمی‌شوند.
.IP \(bu 2
افزونه \fBdocparams\fP به متدهای انتزاعی اجازه می‌دهد مستندات مقادیر بازگشتی را ثبت کنند
حتی اگر پیاده‌سازی پیش‌فرض مقداری بازنگرداند.
آن‌ها همچنین دیگر نیازی به مستندسازی بالا بردن خطای \fBNotImplementedError.\fP ندارند.
.IP \(bu 2
صرف‌نظر کردن از بررسی وارد کردن سراسری (wildcard import) برای \fB__init__.py\fP\&.
.IP \(bu 2
عدم هشدار useless\-super\-delegation / W0235 \%<#\:useless-super-delegation>\(aq در صورتی که متد زیرکلاس دارای یادداشت‌های نوع متفاوتی باشد.
.IP \(bu 2
عدم هشدار مبنی بر این که یک متغیر سراسری استفاده نشده است در صورتی که با یک import تعریف شده باشد
.INDENT 2.0
.INDENT 3.5
.sp
.EX
def func():
    global sys
    import sys
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
افزودن پشتیبانی پایه برای ارزیابی به تعویق افتاده یادداشت‌های توابع.
.sp
اگر \fBpylint\fP عبارت واردسازی مربوطه \fBfrom __future__ import annotations\fP را شناسایی کند،
پیام‌های \fBused\-before\-assignment\fP و \fBundefined\-variable\fP را در مواردی
که ناشی از یادداشت‌ها باشد صادر نخواهد کرد.
.sp
جزئیات بیشتر درباره ارزیابی به تعویق افتاده یادداشت‌ها را می‌توان در
PEP 563 \%<https://\:peps\:.python\:.org/\:pep-0563>\& خواند.
.IP \(bu 2
یک گزینه خط فرمان جدید افزوده شد، \fB\-\-exit\-zero\fP، برای استفاده در اسکریپت‌های یکپارچه‌سازی مداوم (CI)
که در صورت بازگرداندن کد وضعیت غیرصفر توسط دستور متوقف می‌شوند. اگر این
گزینه مشخص شود و Pylint با موفقیت اجرا شود، صرف‌نظر از تعداد مشکلات شناسایی‌شده،
با کد 0 خارج خواهد شد.
.sp
خطاهای پیکربندی، خطاهای تجزیه، و فراخوانی Pylint با گزینه‌های خط فرمان
نامعتبر همچنان کد خطای غیرصفر بازمی‌گردانند، حتی اگر
\fB\-\-exit\-zero\fP مشخص شده باشد.
.IP \(bu 2
عدم صدور مجدد \fBunused\-import\fP برای واردسازی‌های typing استفاده‌شده در توضیحات نوع (type comments). به عنوان نمونه،
در مثال زیر pylint پیش‌تر ایراد می‌گرفت که \fBAny\fP و \fBList\fP استفاده نشده‌اند،
در حالی که باید از نظر یک بررسی‌کننده نوع، استفاده‌شده تلقی شوند.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
from typing import Any, List
a = 1 # type: List[Any]
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
رفع مثبت کاذب \fBline\-too\-long\fP برای خطوط کامنت در انتهای ماژول.
.IP \(bu 2
رفع صدور \fBuseless\-super\-delegation\fP هنگام تغییر مقدار پیش‌فرض آرگومان‌های کلیدواژه‌ای.
.IP \(bu 2
پشتیبانی از \fBtyping.TYPE_CHECKING\fP برای خطاهای \fI:ref:\(gaunused\-import\(ga\fP
.sp
هنگامی که ماژول‌ها تحت محافظت \fBtyping.TYPE_CHECKING\fP وارد می‌شوند، \fBpylint\fP
دیگر \fI:ref:\(gaunused\-import\(ga\fP\& را صادر نخواهد کرد.
.IP \(bu 2
رفع مثبت کاذب \fBunused\-variable\fP در آرگومان‌های پیش‌فرض lambda.
.IP \(bu 2
بررسی \fBassignment\-from\-no\-return\fP متدها را نیز همانند توابع در نظر می‌گیرد.
.sp
اگر متدی داشته باشید که مقداری بازنمی‌گرداند، اما بعداً مقداری را به یک
فراخوانی از آن متد تخصیص دهید (بنابراین در اصل \fBNone\fP خواهد بود)،
آن‌گاه \fBpylint\fP خطای \fBassignment\-from\-no\-return\fP را صادر خواهد کرد.
.IP \(bu 2
یک پرچم جدید افزوده شد، \fB\-\-ignore\-none\fP که رفتار \fBno\-member\fP
را با توجه به مقادیر \fBNone\fP کنترل می‌کند.
.sp
پیش‌تر اگر \fBpylint\fP استنتاج می‌کرد که مالک دسترسی به صفت یک مقدار \fBNone\fP است،
\fBno\-member\fP را صادر نمی‌کرد. در برخی موارد، این مسئله می‌تواند عملاً
باعث باگ شود، بنابراین اگر می‌خواهید مقادیر \fBNone\fP نیز بررسی شوند،
گزینه \fB\-\-ignore\-none=n\fP را به pylint ارسال کنید.
.IP \(bu 2
رفع مثبت کاذب \fBbad\-continuation\fP برای دستورات with.
.IP \(bu 2
رفع پیام مثبت کاذب \fBbad\-whitespace\fP برای یادداشت‌های نوع
حاوی علامت سه‌نقطه (ellipses).
.IP \(bu 2
رفع مثبت کاذب \fBundefined\-variable\fP برای lambdaهای تودرتو.
.UNINDENT.SS گزارش کامل تغییرات (Full changelog)
.SS موارد جدید در Pylint 2.0 (What\(aqs New in Pylint 2.0?)
.sp
تاریخ انتشار: 2018\-07\-15
.INDENT 0.0
.IP \(bu 2
اگر هرگونه کنترل‌کنندهٔ کلاس استثنای والد وجود داشته باشد، \fBtry\-except\-raise\fP نباید صادر شود.
.sp
بسته شد: #2284
.IP \(bu 2
پیام \fBtrailing\-comma\-tuple\fP می‌تواند برای دستورهای \fBreturn\fP نیز صادر شود.
.sp
بسته شد: #2269
.IP \(bu 2
رفع مثبت کاذب پیام \fBinconsistent\-return\-statements\fP هنگامی که یک استثنا درون یک دستور else صادر می‌شود.
.sp
بسته شد: #1782
.IP \(bu 2
گره‌های \fBImportFrom\fP به درستی از نام کامل برای بررسی‌های مرتب‌سازی وارد کردن (import sorting) استفاده می‌کنند.
.sp
بسته شد: #2181
.IP \(bu 2
دستور [].extend و عملیات توکار مشابه با بررسی‌کنندهٔ انتقال به پایتون ۳ دیگر \fIdict\-*\-not\-iterating\fP را صادر نمی‌کنند.
.sp
بسته شد: #2187
.IP \(bu 2
افزودن بررسی \fBconsider\-using\-dict\-comprehension\fP که اگر برای مقداردهی اولیه دیکشنری از شیوهٔ قدیمی با list comprehension استفاده شود، صادر می‌شود.
.IP \(bu 2
افزودن بررسی \fBconsider\-using\-set\-comprehension\fP که اگر برای مقداردهی اولیه مجموعه از شیوهٔ قدیمی با list comprehension استفاده شود، صادر می‌شود.
.IP \(bu 2
پیام \fBlogging\-not\-lazy\fP هر زمان که pylint استنتاج کند که یک رشته با عملگر جمع ساخته شده است، صادر می‌شود.
.sp
بسته شد: #2193
.IP \(bu 2
افزودن بررسی \fBchained\-comparison\fP که در صورتی صادر می‌شود که یک عملیات بولی بتواند با زنجیره‌ای کردن برخی از عملیات‌هایش ساده‌سازی شود؛
مانند \(dqa < b and b < c\(dq که می‌تواند به صورت \(dqa < b < c\(dq ساده شود.
.sp
بسته شد: #2032
.IP \(bu 2
افزودن بررسی \fBconsider\-using\-in\fP برای مقایسهٔ یک متغیر با مقادیر متعدد با استفاده از \(dq==\(dq و \(dqor\(dq به جای بررسی اینکه آیا متغیر در یک تاپل از آن مقادیر وجود دارد (\(dqin\(dq).
.IP \(bu 2
عبارت \fBin\fP برای برخی از بررسی‌کننده‌های انتقال به پایتون ۳ به عنوان یک بافت پیمایشی در نظر گرفته می‌شود.
.sp
بسته شد: #2186
.IP \(bu 2
افزودن پرچم \fB\-\-ignore\-none\fP برای کنترل اینکه آیا pylint باید دربارهٔ \fBno\-member\fP در جایی که مالک None است هشدار دهد یا خیر.
.IP \(bu 2
رفع مثبت کاذب مربوط به \fBtoo\-many\-arguments\fP و متدهای مقید \fB__get__\fP.
.sp
بسته شد: #2172
.IP \(bu 2
پارامتر \fBmcs\fP به عنوان اولین پارامتر متد \fB__new__\fP در متاکلاس با \fBcls\fP جایگزین شد.
.sp
بسته شد: #2028
.IP \(bu 2
پیام \fBassignment\-from\-no\-return\fP متدها را نیز در نظر می‌گیرد.
.sp
بسته شد: #2081
.IP \(bu 2
پشتیبانی از typing.TYPE_CHECKING برای خطاهای \fI:ref:\(gaunused\-import\(ga\fP.
.sp
بسته شد: #1948
.IP \(bu 2
کلاس‌های استنتاج‌شده در سطح تابع در صورتی که با عبارت منظم متغیر همخوانی نداشته باشند، دیگر \fBinvalid\-name\fP را صادر نمی‌کنند.
.sp
بسته شد: #1049
.IP \(bu 2
افزودن پشتیبانی اولیه برای ارزیابی به تعویق افتادهٔ یادداشت‌های نوع تابع (function annotations).
.sp
بسته شد: #2069
.IP \(bu 2
رفع یک باگ در \fBmissing\-kwoa\fP و پارامترهای با طول متغیر (variadics).
.sp
بسته شد: #1111
.IP \(bu 2
بررسی \fBsimplifiable\-if\-statement\fP تنها هنگام انتساب به مقصدهای یکسان در نظر گرفته می‌شود.
.sp
بسته شد: #1984
.IP \(bu 2
آزمودن موارد بیشتر در \fBlen\-as\-condition\fP، مانند \fBlen() < 1\fP یا \fBlen <= 0\fP.
.IP \(bu 2
رفع صدور مثبت کاذب پیام \fBline\-too\-long\fP برای خطوط توضیحات (کامنت) در انتهای یک ماژول.
.sp
بسته شد: #1950
.IP \(bu 2
رفع مثبت کاذب \fBbad\-continuation\fP برای دستورهای with.
.sp
بسته شد: #461
.IP \(bu 2
عدم صدور هشدار برای \fBstop\-iteration\-return\fP هنگام استفاده از \fBnext()\fP بر روی \fBitertools.count\fP.
.sp
بسته شد: #2158
.IP \(bu 2
افزودن بررسی \fBconsider\-using\-get\fP برای استفادهٔ غیر اصولی از دریافت مقدار/مقدار پیش‌فرض یک کلید از دیکشنری.
.sp
بسته شد: #2076
.IP \(bu 2
پیام invalid\-slice\-index / E1127 \%<#\:invalid-slice-index> هنگامی که برش (slice) به عنوان اندیس برای یک شیء پیچیده استفاده شود، صادر نمی‌شود.
.sp
ما تنها از شمار اندکی از اشیای شناخته‌شده (مانند list، set و موارد مشابه) برای تعیین اینکه آیا باید invalid\-slice\-index / E1127 \%<#\:invalid-slice-index> در هنگام استفاده از برش برای اندیس‌گذاری یک شیء صادر شود یا خیر، استفاده می‌کنیم.
.IP \(bu 2
عدم صدور پیام \fBunused\-import\fP برای وارد کردن‌های typing که در توضیحات نوع (type comments) به کار رفته‌اند.
.IP \(bu 2
افزودن بررسی جدید useless\-import\-alias / C0414 \%<#\:useless-import-alias>\(aq.
.sp
بسته شد: #2052
.IP \(bu 2
افزودن \fBcomparison\-with\-callable\fP برای هشدار دادن در مورد مقایسه با فراخوانی‌پذیرِ خام (bare callable)، بدون فراخوانی آن.
.sp
بسته شد: #2082
.IP \(bu 2
عدم صدور هشدار برای \fBmissing\-type\-doc\fP و/یا \fBmissing\-return\-type\-doc\fP، در صورتی که یادداشت‌های نوع روی امضای تابع برای یک پارامتر و/یا نوع بازگشتی وجود داشته باشد.
.sp
بسته شد: #2083
.IP \(bu 2
افزودن گزینهٔ \fB\-\-exit\-zero\fP برای اسکریپت‌های یکپارچه‌سازی مداوم (CI) به منظور فراخوانی آسان‌تر Pylint در محیط‌هایی که در صورت بازگرداندن کد وضعیت غیر صفر (خطا) توسط یک برنامه، متوقف می‌شوند.
.sp
بسته شد: #2042
.IP \(bu 2
هشدار در صورتی که به اولین آرگومان یک متد نمونه/کلاس مقداری انتساب داده شود.
.sp
بسته شد: #977
.IP \(bu 2
بررسی جدید \fBcomparison\-with\-itself\fP جهت بررسی مقایسه بین مقادیر یکسان.
.sp
بسته شد: #2051
.IP \(bu 2
افزودن هشدار جدید، logging\-fstring\-interpolation / W1203 \%<#\:logging-fstring-interpolation>\(aq، که هنگام استفاده از f\-string در فراخوانی‌های توابع لاگ‌گیری صادر می‌شود.
.sp
بسته شد: #1998
.IP \(bu 2
عدم نمایش useless\-super\-delegation / W0235 \%<#\:useless-super-delegation>\(aq در صورتی که متد زیرکلاس یادداشت‌های نوع متفاوتی داشته باشد.
.sp
بسته شد: #1923
.IP \(bu 2
افزودن بررسی \fBunhashable\-dict\-key\fP.
.sp
بسته شد: #586
.IP \(bu 2
عدم صدور هشدار در مورد استفاده نشدن یک متغیر سراسری در صورتی که از طریق یک import تعریف شده باشد.
.sp
بسته شد: #1453
.IP \(bu 2
نادیده گرفتن بررسی وارد کردن عمومی (wildcard import) برای \fB__init__.py\fP\&.
.sp
بسته شد: #2026
.IP \(bu 2
حالت انتقال به پایتون ۳ اکنون می‌تواند با پایتون ۳ نیز اجرا شود.
.IP \(bu 2
پیام \fBtoo\-few\-public\-methods\fP برای dataclassها صادر نمی‌شود.
.sp
بسته شد: #1793
.IP \(bu 2
گزینهٔ جدید حالت پرگو (verbose mode) که با پرچم خط فرمان \fB\-\-verbose\fP فعال می‌شود، برای نمایش خروجی‌های اضافی غیرمرتبط با بررسی‌کننده‌ها. این گزینه به طور پیش‌فرض غیرفعال است.
.sp
بسته شد: #1863
.IP \(bu 2
بررسی \fBundefined\-loop\-variable\fP پیش از صدور، اشیای پیمایش‌شدهٔ غیرخالی را در نظر می‌گیرد.
.sp
بسته شد: #2039
.IP \(bu 2
افزودن پشتیبانی از نام‌های اختیاری مقدار بازگشتی در numpydoc.
.sp
بسته شد: #2030
.IP \(bu 2
پیام \fBsingleton\-comparison\fP بررسی‌های منفی را نیز در نظر می‌گیرد..sp
بسته شدن #2037
.IP \(bu 2
افزودن بررسی \fBconsider\-using\-in\fP برای مقایسه یک متغیر با چندین
مقدار با استفاده از \(dq==\(dq و \(dqor\(dqs به جای بررسی قرار داشتن
متغیر \(dqin\(dq در تاپلی از آن مقادیر.
.sp
بسته شدن #1977
.IP \(bu 2
اکنون defaultdict و زیرکلاس‌های dict در بررسی‌های dict\-iter\-* مدیریت می‌شوند
.sp
بسته شدن #2005
.IP \(bu 2
پیام \fBlogging\-format\-interpolation\fP همچنین در صورت استفاده از f\-strings به جای نحو % صادر می‌شود.
.sp
بسته شدن #1788
.IP \(bu 2
عدم فعال‌سازی misplaced\-bare\-raise / E0704 \%<#\:misplaced-bare-raise> هنگامی که raise در یک بند finally قرار دارد
.sp
بسته شدن #1924
.IP \(bu 2
افزودن بررسی جدید، \fBpossibly\-unused\-variable\fP\&.
.sp
این بررسی مشابه \fBunused\-variable\fP است، با این تفاوت که تنها زمانی
صادر می‌شود که یک فراخوانی ()locals در حوزه متغیر استفاده‌نشده شناسایی شود.
فراخوانی \fBlocals()\fP می‌تواند با مصرف تمام مقادیر موجود تا نقطه فراخوانی،
به طور بالقوه از متغیر مذکور استفاده کند. این بررسی جدید امکان غیرفعال کردن این
خطا را در زمانی فراهم می‌کند که کاربر عمداً از \fBlocals()\fP برای مصرف همه‌چیز
استفاده کرده باشد.
.sp
بسته شدن #1909.
.IP \(bu 2
بررسی \fBno\-else\-return\fP حالت‌های متعددی را در نظر می‌گیرد
.INDENT 2.0
.INDENT 3.5
این بررسی کمی بیش از حد محدودکننده بود زیرا گره‌های return را در گره orelse.
بررسی می‌کرد. با این حال در آن نقطه می‌توان عبارت if را بازآفرینی کرد تا
orelse را نداشته باشد. این امر تشخیص سایر حالت‌ها را بهبود می‌بخشد، برای
نمونه اکنون گره‌های TryExcept را که بخشی از شاخه else. هستند تشخیص می‌دهد.
.UNINDENT
.UNINDENT
.sp
بسته شدن #1852
.IP \(bu 2
افزودن دو بررسی جدید، \fBinvalid\-envvar\-value\fP و \fBinvalid\-envvar\-default\fP\&.
.sp
مورد اول زمانی فعال می‌شود که pylint تشخیص دهد توابع دستکاری متغیرهای محیطی
از نوعی غیر از رشته‌ها استفاده می‌کنند، در حالی که مورد دوم هنگامی صادر می‌شود
که توابع مذکور از یک متغیر پیش‌فرض با نوعی متفاوت از نوع مورد انتظار استفاده کنند.
.IP \(bu 2
افزودن بررسی \fBconsider\-using\-join\fP برای الحاق رشته‌ها با استفاده از str.join(sequence)
.sp
بسته شدن #1952
.IP \(bu 2
افزودن بررسی \fBconsider\-swap\-variables\fP برای جابه‌جایی متغیرها با بسته‌گشایی تاپل (tuple unpacking)
.sp
بسته شدن #1922
.IP \(bu 2
افزودن بررسی‌کننده جدید \fBtry\-except\-raise\fP که اگر بلوک گرداننده except دارای
عبارت \fBraise\fP به عنوان اولین عملگر خود باشد به کاربر هشدار می‌دهد. این هشدار
زمانی نمایش داده می‌شود که یک عبارت raise خالی (bare raise) وجود داشته باشد که
عملاً استثنای دریافت‌شده را دوباره برمی‌انگیزد، یا نوع استثنای برانگیخته‌شده
مشابه استثنایی باشد که در حال مدیریت است.
.IP \(bu 2
عدم بروز خرابی با رشته‌های نامعتبر هنگام بررسی \fBlogging\-format\-interpolation\fP
.sp
بسته شدن #1944
.IP \(bu 2
معاف کردن \fB__doc__\fP از فعال‌سازی هشدار \fBredefined\-builtin\fP
.sp
از \fB__doc__\fP می‌توان برای تعیین یک docstring برای یک ماژول بدون
ارسال آن به عنوان رشته نخستین عبارت استفاده کرد.
.IP \(bu 2
رفع مثبت کاذب bad\-whitespace ناشی از آرگومان‌های تابع دارای مقادیر پیش‌فرض
و حاشیه‌نویسی‌ها (annotations)
.sp
بسته شدن #1831
.IP \(bu 2
رفع مثبت کاذب stop\-iteration\-return / R1708 \%<#\:stop-iteration-return> هنگامی که تابع توکار next در یک مولد دارای مقدار پیش‌فرض است
.sp
بسته شدن #1830
.IP \(bu 2
رفع صدور پیام مثبت کاذب \fBno\-member\fP برای کلاسی با ویژگی‌های \(dqخصوصی\(dq که نام آن‌ها درهم‌سازی (mangled) شده است.
.sp
بسته شدن #1643
.IP \(bu 2
رفع خرابی رخ‌داده هنگام عدم مدیریت صحیح \fBUninferable\fP در \fBstop\-iteration\-return\fP
.sp
بسته شدن #1779
.IP \(bu 2
استفاده از گره مناسب برای دریافت نام توابع بازتعریف‌شده (#1792)
.sp
بسته شدن #1774
.IP \(bu 2
عدم بروز خرابی هنگام مواجهه با raiseهای خالی در حین بررسی بازگشت‌های ناسازگار
.sp
بسته شدن #1773
.IP \(bu 2
رفع پیام مثبت کاذب \fBinconsistent\-return\-statements\fP زمانی که عبارت if درون try/except قرار دارد.
.sp
بسته شدن #1770
.IP \(bu 2
رفع پیام مثبت کاذب \fBinconsistent\-return\-statements\fP هنگام استفاده از حلقه‌های while.
.sp
بسته شدن #1772
.IP \(bu 2
تصحیح شماره ستون برای قواعد فاصله‌گذاری (whitespace).
.sp
پیش از این شماره ستون روی 0 گیر کرده بود
.sp
بسته شدن #1649
.IP \(bu 2
رفع موارد مثبت کاذب \fBunused\-argument\fP با متغیر سایه‌اندازی‌شده
در درک دیکشنری (dictionary comprehension).
.sp
بسته شدن #1731
.IP \(bu 2
رفع پیام مثبت کاذب \fBinconsistent\-return\-statements\fP هنگام استفاده
از توابعی که هرگز بازنمی‌گردند (مانند sys.exit).
.sp
بسته شدن #1771
.IP \(bu 2
رفع خطا هنگام بررسی این‌که آیا تابع استثنا است یا خیر، همانند \fBbad\-exception\-context\fP\&.
.IP \(bu 2
رفع پیام مثبت کاذب \fBinconsistent\-return\-statements\fP هنگامی که یک
تابع زیر یک عبارت if تعریف شده است.
.sp
بسته شدن #1794
.IP \(bu 2
پیام جدید \fBuseless\-return\fP هنگامی که تابع یا متد با عبارت \(dqreturn\(dq یا
\(dqreturn None\(dq پایان می‌یابد و این تنها عبارت return در بدنه است.
.IP \(bu 2
رفع پیام مثبت کاذب \fBinconsistent\-return\-statements\fP با اجتناب از
استنتاج بیهوده استثنا در صورتی که استثنا مدیریت نشده باشد.
.sp
بسته شدن #1794 (بخش دوم)
.IP \(bu 2
رفع بررسی نادرست نمونه‌سازی thread هنگامی که تابع هدف در args ارائه شده باشد.
.sp
بسته شدن #1840
.IP \(bu 2
رفع مثبت کاذب هنگامی که یک بخش Attributes در numpy پس از بخش Parameters
قرار می‌گیرد
.sp
بسته شدن #1867
.IP \(bu 2
رفع مسیر نادرست فایل هنگامی که مسیر مطلق فایل شامل چندین رشته \fBpath_strip_prefix\fP باشد.
.sp
بسته شدن #1120
.IP \(bu 2
رفع مثبت کاذب undefined\-variable / E0602 \%<#\:undefined-variable> برای آرگومان lambda در تعاریف کلاس
.sp
بسته شدن #1824
.IP \(bu 2
افزودن یک بررسی‌کننده جدید که در صورت فعال یا غیرفعال شدن برخی پیام‌ها با
شناسه (id) به جای نماد (symbol) به کاربر هشدار می‌دهد.
.sp
بسته شدن #1599
.IP \(bu 2
خنثی‌سازی پیام‌های مثبت کاذب \fBnot\-callable\fP ناشی از توصیف‌گرهای خاص
staticmethod
.sp
بسته شدن #1699
.IP \(bu 2
رفع نحوه مدیریت دندانه‌داری با تب‌ها (tabs)
.sp
بسته شدن #1148
.IP \(bu 2
رفع خطای مثبت کاذب \fBbad\-continuation\fP
.sp
بسته شدن #638
.IP \(bu 2
رفع مثبت کاذب unused\-variable / W0612 \%<#\:unused-variable> در آرگومان‌های پیش‌فرض lambda
.sp
بسته شدن #1921
بسته شدن #1552
بسته شدن #1099
بسته شدن #210
.IP \(bu 2
به‌روزرسانی قالب پیش‌فرض گزارش برای دربرداشتن مسیرهایی که در برخی پایانه‌ها (مانند iTerm) قابل کلیک هستند..IP \(bu 2
رفع رفتار def درون‌خطی در بررسی‌کننده \fBtoo\-many\-statements\fP
.sp
حل مسئله #1978
.IP \(bu 2
رفع بروز \fBKeyError\fP هنگام استفاده از docparams و مستندسازی NotImplementedError.
.sp
حل مسئله #2102
.IP \(bu 2
رفع بروز method\-hidden / E0202 \%<#\:method-hidden>\(aq هنگام انتساب به یک property یا data descriptor.
.IP \(bu 2
رفع صدور \fBuseless\-super\-delegation\fP هنگام تغییر مقدار پیش‌فرض آرگومان‌های کلیدواژه‌ای.
.sp
حل مسئله #2022
.IP \(bu 2
گسترش ignored\-argument\-names برای در برگرفتن آرگومان‌های ستاره‌دار و آرگومان‌های کلیدواژه‌ای
.sp
حل مسئله #2214
.IP \(bu 2
رفع مثبت کاذب undefined\-variable / E0602 \%<#\:undefined-variable> در یک lambda تو در تو
.sp
حل مسئله #760
.IP \(bu 2
رفع پیام مثبت کاذب \fBbad\-whitespace\fP برای typing annotations حاوی چندنقطه (...)
.sp
حل مسئله 1992
.IP \(bu 2
تفکیک \(dqmissing\-docstrings\(dq به بخش‌های \(dqmodule\(dq، \(dqclass\(dq و \(dqfunction\(dq
.sp
برای کارکرد این مورد، امکان وجود چندین پیام با نام قدیمی یکسان فراهم شد.
.sp
حل مسئله #1164
.UNINDENT
.SS 1.x
.sp
از آغاز pylint تا نسخه 2.14.0 (شامل آن)، ما گزارش تغییراتی (changelog) داشتیم که دربردارنده \fIتمام\fP تغییرات غیربدیهی Pylint بود، از جمله تغییراتی که برای کاربران نهایی ملموس نبودند؛ یعنی تغییراتی که تنها در صورتی برای شما جذاب بودند که توسعه‌دهنده‌ای باشید که روی pylint یا افزونه‌های pylint کار می‌کنید، یا یک تاریخ‌نگار متن‌باز باشید.
.sp
از pylint 1.6.0 تا 2.14.0، علاوه بر گزارش تغییرات کامل، خلاصه‌ای از تغییرات (عمدتاً برای کاربران نهایی) نیز وجود داشت.
.SS تازه‌های Pylint 1.9 (What\(aqs New In Pylint 1.9)
.sp
از آغاز pylint تا نسخه 2.14.0 (شامل آن)، ما گزارش تغییراتی (changelog) داشتیم که دربردارنده \fIتمام\fP تغییرات غیربدیهی Pylint بود، از جمله تغییراتی که برای کاربران نهایی ملموس نبودند؛ یعنی تغییراتی که تنها در صورتی برای شما جذاب بودند که توسعه‌دهنده‌ای باشید که روی pylint یا افزونه‌های pylint کار می‌کنید، یا یک تاریخ‌نگار متن‌باز باشید.
.sp
از pylint 1.6.0 تا 2.14.0، علاوه بر گزارش تغییرات کامل، خلاصه‌ای از تغییرات (عمدتاً برای کاربران نهایی) نیز وجود داشت.
.SS خلاصه \-\- نکات برجسته انتشار (Summary \-\- Release highlights)
.INDENT 0.0
.IP \(bu 2
تاکنون موردی وجود ندارد
.UNINDENT
.SS بررسی‌کننده‌های جدید (New checkers)
.INDENT 0.0
.IP \(bu 2
یک بررسی‌کننده جدید Python 3 برای هشدار درباره تابع حذف‌شده \fBoperator.div\fP اضافه شد.
.IP \(bu 2
یک بررسی‌کننده جدید Python 3 برای هشدار درباره دسترسی به توابعی اضافه شد که از ماژول urllib به زیربسته‌های مربوطه مانند \fBurllib.request\fP\& منتقل شده‌اند.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
from urllib import urlencode
.EE
.UNINDENT
.UNINDENT
.sp
در عوض کد قبلی باید از \fBurllib.parse\fP یا \fBsix.moves\fP برای وارد کردن ماژول به شیوه‌ای سازگار با Python 2 و Python 3 استفاده کند:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
from six.moves.urllib.parse import urlencode
.EE
.UNINDENT
.UNINDENT
.sp
برای اینکه این مورد در Python 3 نیز کار کند، لطفاً از کتابخانه \fBsix\fP استفاده کنید:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
six.reraise(Exception, \(dqvalue\(dq, tb)
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی جدید برای هشدار درباره استفاده از رشته‌های لفظی خام یونیکد (unicode raw string literals) اضافه شد. این مورد در Python 3 یک خطای نحو (syntax error) است:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
a = ur\(aq...\(aq
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
بررسی جدید \fBdeprecated\-sys\-function\fP اضافه شد که هنگام دسترسی به اعضای حذف‌شده \fBsys\fP صادر می‌شود.
.IP \(bu 2
بررسی \fBxreadlines\-attribute\fP اضافه شد که هنگام دسترسی به صفت \fBxreadlines()\fP روی یک شیء فایل صادر می‌شود.
.IP \(bu 2
دو بررسی جدید برای پورت کردن به Python 3 اضافه شد: \fBexception\-escape\fP و \fBcomprehension\-escape\fP
.sp
این دو بررسی زمانی صادر می‌شوند که pylint تشخیص دهد متغیر تعریف‌شده در بلوک‌های مذکور، خارج از بلوک داده‌شده استفاده شده است. در Python 3 این مقادیر حذف می‌شوند.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
try:
  1/0
except ZeroDivisionError as exc:
   ...
print(exc) # This will raise a NameError on Python 3

[i for i in some_iterator if some_condition(i)]
print(i) # This will raise a NameError on Python 3
.EE
.UNINDENT
.UNINDENT
.UNINDENT.SS سایر تغییرات
.INDENT 0.0
.IP \(bu 2
اکنون \fBdefaultdict\fP و زیرکلاس‌های \fBdict\fP برای بررسی‌های \fIdict\-iter\-*\fP مدیریت می‌شوند. بدین معنی که کد زیر اکنون هنگام دسترسی به \fBiteritems\fP و موارد مشابه، اخطار صادر خواهد کرد:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
some_dict = defaultdict(list)
\&...
some_dict.iterkeys()
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
کلاس‌های Enum دیگر موجب فعال شدن \fBtoo\-few\-methods\fP نمی‌شوند
.IP \(bu 2
متدهای خاص اکنون در شمارش \fBtoo\-few\-methods\fP لحاظ می‌شوند،
و بخشی از API عمومی در نظر گرفته می‌شوند.
آن‌ها همچنان در شمارش تعداد متدها برای
\fBtoo\-many\-methods\fP\& شمرده نمی‌شوند.
.IP \(bu 2
افزونه docparams به متدهای انتزاعی اجازه می‌دهد مستندات مقادیر بازگشتی را ثبت کنند، حتی
اگر پیاده‌سازی پیش‌فرض مقداری را بازنگرداند.
آن‌ها همچنین دیگر نیازی به مستندسازی پرتاب NotImplementedError ندارند.
.UNINDENT
.SS گزارش کامل تغییرات
.SS چه چیزهایی در Pylint 1.9 جدید است؟
.sp
تاریخ انتشار: 2018\-05\-15
.INDENT 0.0
.IP \(bu 2
دو بررسی جدید انتقال به Python 3 اضافه شد: \fBexception\-escape\fP و \fBcomprehension\-escape\fP
.sp
این دو مورد هر زمان که pylint تشخیص دهد متغیر تعریف‌شده در بلوک‌های مذکور در خارج از آن بلوک استفاده شده است، صادر می‌شوند. در Python 3 این مقادیر حذف می‌شوند.
.IP \(bu 2
یک بررسی جدید \fBdeprecated\-sys\-function\fP اضافه شد، که هنگام دسترسی به اعضای حذف‌شده sys صادر می‌شود.
.IP \(bu 2
بررسی \fBxreadlines\-attribute\fP اضافه شد، که هنگام دسترسی به ویژگی \fBxreadlines()\fP صادر می‌شود.
.IP \(bu 2
حالت انتقال به Python 3 اکنون با خود Python 3 نیز قابل اجرا است.
.IP \(bu 2
افزونه docparams به متدهای انتزاعی اجازه می‌دهد آنچه را که پیاده‌سازی‌های بازنویسی‌کننده باید بازگردانند مستند کنند، و بدون نیاز به مستندسازی، خطای NotImplementedError را اعلام نمایند.
.sp
بسته شدن #2044
.IP \(bu 2
متدهای خاص در شمارش \fBtoo\-few\-methods\fP لحاظ نمی‌شوند،
و بخشی از API عمومی در نظر گرفته می‌شوند.
.IP \(bu 2
کلاس‌های Enum موجب ایجاد \fBtoo\-few\-methods\fP نمی‌شوند
.sp
بسته شدن #605
.IP \(bu 2
بررسی جدیدی برای Python 2/3 جهت دسترسی به \fBoperator.div\fP اضافه شد، که در Python 3 حذف شده است
.sp
بسته شدن #1936
.IP \(bu 2
بررسی جدیدی برای Python 2/3 جهت دسترسی به توابع حذف‌شده urllib اضافه شد
.sp
بسته شدن #1997
.UNINDENT
.SS چه چیزهایی در Pylint 1.8 جدید است
.sp
از آغاز pylint تا نسخه 2.14.0 (شامل آن)، ما گزارش تغییراتی داشتیم که شامل \fIتمام\fP
تغییرات غیربدیهی Pylint بود، از جمله تغییراتی که
رو به کاربر نبودند، یعنی تغییراتی که ممکن است فقط در صورتی برای شما جالب باشند که توسعه‌دهنده‌ای
باشید که روی pylint یا افزونه‌های pylint کار می‌کنید، یا تاریخ‌نگار پروژه‌های منبع‌باز باشید.
.sp
از pylint 1.6.0 تا 2.14.0، علاوه بر گزارش تغییرات کامل، خلاصه‌ای
از تغییرات (عمدتاً رو به کاربر) نیز وجود داشت.
.SS خلاصه \-\- نکات برجسته انتشار
.INDENT 0.0
.IP \(bu 2
تاکنون موردی نیست
.UNINDENT.SS بررسی‌کننده‌های جدید
.INDENT 0.0
.IP \(bu 2
یک بررسی جدید افزوده شد، \fBshallow\-copy\-environ\fP\&.
.sp
این پیام هشدار زمانی صادر می‌شود که یک کپی سطحی از os.environ ایجاد شود.
کپی سطحی از os.environ آن‌طور که افراد انتظار دارند کار نمی‌کند. os.environ یک شیء dict نیست، بلکه یک شیء واسط (proxy object) است؛ بنابراین هر تغییری که در کپی اعمال شود ممکن است اثرات غیرمنتظره‌ای روی os.environ بگذارد.
.sp
به جای متد copy.copy(os.environ)، باید از os.environ.copy() استفاده شود.
.sp
برای جزئیات بیشتر \%<https://\:bugs\:.python\:.org/\:issue15373> را ببینید.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
import copy
import os
wrong_env_copy = copy.copy(os.environ)  # will emit pylint warning
wrong_env_copy[\(aqENV_VAR\(aq] = \(aqnew_value\(aq  # changes os.environ
assert os.environ[\(aqENV_VAR\(aq] == \(aqnew_value\(aq

good_env_copy = dict(os.environ)  # the right way
good_env_copy[\(aqENV_VAR\(aq] = \(aqdifferent_value\(aq  # doesn\(aqt change os.environ
assert os.environ[\(aqENV_VAR\(aq] == \(aqnew_value\(aq
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی جدید افزوده شد، \fBkeyword\-arg\-before\-vararg\fP\&.
.sp
این پیام هشدار زمانی صادر می‌شود که تابعی با یک آرگومان کلیدواژه‌ای قبل از آرگومان‌های موضعی با طول متغیر (*args) تعریف شده باشد.
این امر در صورتی که مقدار آرگومان کلیدواژه‌ای در فراخوانی تابع مشخص نشود (با این فرض که مقدار پیش‌فرض تعریف‌شده در نظر گرفته می‌شود)، ممکن است منجر به تغییر لیست args گردد.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
def foo(a, b=3, *args):
    print(a, b, args)

# Case1: a=0, b=2, args=(4,5)
foo(0,2,4,5) # 0 2 (4,5) ==> Observed values are same as expected values

# Case2: a=0, b=<default_value>, args=(4,5)
foo(0,4,5) # 0 4 (5,) ==> args list got modified as well as the observed value of b

# Case3: Syntax Error if tried as follows
foo(0,b=2,4,5) # syntax error
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی جدید افزوده شد، \fBsimplify\-boolean\-expression\fP\&.
.sp
این پیام زمانی صادر می‌شود که بررسی \fBconsider\-using\-ternary\fP به دلیل نادرست بودن یک عنصر به‌ظاهر درست (truthy) در بافت منطقی (boolean context)، کدی غیرمعادل تولید کند.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
value = condition and False or other_value
.EE
.UNINDENT
.UNINDENT
.sp
این ساختار معیوب می‌تواند به این شکل ساده‌سازی شود:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
value = other_value
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی جدید افزوده شد، \fBbad\-thread\-instantiation\fP\&.
.sp
این پیام زمانی صادر می‌شود که کلاس threading.Thread آرگومان target را دریافت نکند، بلکه فقط یک آرگومان دریافت کند که به‌طور پیش‌فرض همان پارامتر group است.
.sp
در مثال زیر، نمونه‌سازی با شکست مواجه می‌شود که قطعاً مطلوب نیست:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
import threading
threading.Thread(lambda: print(1)) # Oups, this is the group parameter
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی‌کننده جدید Python 3 برای هشدار در مورد دسترسی به توابعی که از ماژول itertools حذف شده‌اند افزوده شد: \fBizip\fP، \fBimap\fP، \fBiflter\fP، \fBizip_longest\fP و \fBifilterfalse\fP\&.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
from itertools import izip
print(list(izip([1, 2], [3])))
.EE
.UNINDENT
.UNINDENT
.sp
در عوض از \fBsix.moves\fP برای وارد کردن یک تابع سازگار با Python 2 و Python 3 استفاده کنید:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
from six.moves import zip
print(list(zip([1, 2], [3])))
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی‌کننده جدید Python 3 برای هشدار در مورد دسترسی به فیلدهای منسوخ‌شده از ماژول types مانند \fBListType\fP یا \fBIntType\fP افزوده شد.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
from types import ListType
print(isinstance([], ListType))
.EE
.UNINDENT
.UNINDENT
.sp
در عوض از اعلان‌های موجود در فضای نام builtin استفاده کنید:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
print(isinstance([], list))
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی‌کننده جدید Python 3 برای هشدار در مورد اعلان متد \fBnext\fP افزوده شد که در Python 2 پروتکل \fBIterator\fP را پیاده‌سازی می‌کرد، اما اکنون در Python 3 یک متد عادی است.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
class Foo(object):
    def next(self):
        return 42
.EE
.UNINDENT
.UNINDENT
.sp
در عوض متد \fB__next__\fP را پیاده‌سازی کنید و از \fBsix.Iterator\fP به عنوان کلاس پایه بهره ببرید یا برای \fB__next__\fP نام مستعار \fBnext\fP را قرار دهید:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
class Foo(object):
    def __next__(self):
        return 42
    next = __next__
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
سه بررسی‌کننده جدید Python 3 برای هشدار در مورد استفاده از متدهای دیکشنری در بافت‌های غیرتکرارشونده افزوده شدند.
.sp
برای نمونه، موارد زیر در Python 3 تکرارکننده (iterator) بازمی‌گردانند:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
\&.. code\-block:: python
.EE
.UNINDENT
.UNINDENT
.INDENT 2.0
.INDENT 3.5
d = {}
d.keys()[0]
d.items()[0]
d.values() + d.keys()
.UNINDENT
.UNINDENT.IP \(bu 2
یک بررسی جدید برای انتقال به Python 3 اضافه شد: \fBnon\-ascii\-bytes\-literals\fP
.sp
این پیام هر زمان که تشخیص داده شود یک رشتهٔ بایت حاوی نویسه‌های غیر ASCII است صادر می‌شود، که در Python 3 منجر به یک SyntaxError خواهد شد.
.IP \(bu 2
یک هشدار جدید، \fBraising\-format\-tuple\fP، مواردی را شناسایی می‌کند که در آن‌ها احتمالاً هدف پرتاب یک استثنا با رشتهٔ پیام قالب‌بندی‌شده بوده است، اما کد واقعی قالب‌بندی را از قلم انداخته و در عوض رشتهٔ الگو و پارامترهای مقدار را به عنوان آرگومان‌های جداگانه به سازندهٔ استثنا فرستاده است. بنابراین مواردی مانند این را شناسایی می‌کند:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
raise SomeError(\(aqmessage about %s\(aq, foo)
raise SomeError(\(aqmessage about {}\(aq, foo)
.EE
.UNINDENT
.UNINDENT
.sp
که احتمالاً منظور به جای آن این بوده است:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
raise SomeError(\(aqmessage about %s\(aq % foo)
raise SomeError(\(aqmessage about {}\(aq.format(foo))
.EE
.UNINDENT
.UNINDENT
.sp
این هشدار را می‌توان در پروژه‌هایی که عمداً از قالب‌بندی تنبل (lazy formatting) پیام‌ها در تمام مدیریت‌کننده‌های استثنای رو به کاربر استفاده می‌کنند نادیده گرفت.
.IP \(bu 2
پیرو توصیه‌های PEP479 \%<https://\:peps\:.python\:.org/\:pep-0479>، یک بررسی‌کنندهٔ جدید برای Python 3.0 جهت هشدار دربارهٔ پرتاب \fBStopIteration\fP درون یک generator اضافه شد. پرتاب \fBStopIteration\fP درون generator ممکن است به دلیل فراخوانی مستقیم \fBraise StopIteration\fP باشد:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
def gen_stopiter():
    yield 1
    yield 2
    yield 3
    raise StopIteration
.EE
.UNINDENT
.UNINDENT
.sp
در عوض از یک دستور سادهٔ \fBreturn\fP استفاده کنید:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
def gen_stopiter():
    yield 1
    yield 2
    yield 3
    return
.EE
.UNINDENT
.UNINDENT
.sp
پرتاب \fBStopIteration\fP ممکن است به دلیل فراخوانی تابع \fBnext\fP با یک generator به عنوان آرگومان نیز رخ دهد:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
def gen_next_raises_stopiter():
    g = gen_ok()
    while True:
        yield next(g)
.EE
.UNINDENT
.UNINDENT
.sp
در این حالت، فراخوانی \fBnext\fP را با یک بلوک try/except احاطه کنید:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
def gen_next_raises_stopiter():
    g = gen_ok()
    while True:
        try:
            yield next(g)
        except StopIteration:
            return
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
بررسی مربوط به پرتاب StopIteration درون generator در صورتی که استثنای پرتاب‌شده از StopIteration ارث‌بری کرده باشد نیز معتبر است.
.sp
Closes #1385
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.UNINDENT
.UNINDENT
.INDENT 0.0
.IP \(bu 2
یک بررسی‌کنندهٔ جدید Python برای هشدار دربارهٔ استفاده از عملگر \fB+\fP درون فراخوانی متدهای logging هنگامی که یکی از عملوندها یک رشتهٔ لفظی (literal string) باشد اضافه شد:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
import logging
var = \(dq123\(dq
logging.log(logging.INFO, \(dqVar: \(dq + var)
.EE
.UNINDENT
.UNINDENT
.sp
در عوض از رشتهٔ قالب‌بندی‌شده و آرگومان‌های مکانی استفاده کنید:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
import logging
var = \(dq123\(dq
logging.log(logging.INFO, \(dqVar: %s\(dq, var)
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی‌کنندهٔ جدید Python برای هشدار دربارهٔ \fBinconsistent\-return\-statements\fP\& اضافه شد. یک تابع یا متد در صورتی دارای عبارت‌های بازگشتی ناسازگار است که مقادیر صریح و ضمنی را هم‌زمان بازگرداند:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
def mix_implicit_explicit_returns(arg):
    if arg < 10:
        return True
    elif arg < 20:
        return
.EE
.UNINDENT
.UNINDENT
.sp
طبق PEP8 \%<https://\:peps\:.python\:.org/\:pep-0008>، اگر هر عبارت بازگشتی مقداری را بازگرداند، تمام عبارت‌های بازگشتی دیگری که هیچ مقداری بازنمی‌گردانند باید صراحتاً به صورت return None قید شوند، و یک عبارت بازگشتی صریح باید در انتهای تابع (در صورت دسترسی‌پذیر بودن) موجود باشد.
بنابراین، تابع قبلی باید به این شکل نوشته شود:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
def mix_implicit_explicit_returns(arg):
    if arg < 10:
        return True
    elif arg < 20:
        return None
.EE
.UNINDENT
.UNINDENT
.sp
Closes #1267
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.UNINDENT
.UNINDENT.SS "سایر تغییرات (Other Changes)"
.INDENT 0.0
.IP \(bu 2
اصلاح رشته‌ی u\(aq\(aq در پیام superfluous\-parens / C0325 \%<#\:superfluous-parens>.
.IP \(bu 2
گزینه‌های پیکربندی بررسی‌کننده‌ی نام نامعتبر به طور چشمگیری بازطراحی شده‌اند.
قواعد از پیش تعریف‌شده‌ای برای شیوه‌های نام‌گذاری رایج معرفی شد. برای
راه‌اندازی‌های معمول، می‌توان گزینه‌های کاربرپسندی مانند \fB\-\-function\-naming\-style=camelCase\fP را
به جای عبارات منظم دست‌نویس به کار برد. پیکربندی پیش‌فرض linter
شیوه‌ی نام‌گذاری سازگار با PEP8 را اعمال می‌کند. برای جزئیات به مستندات مراجعه کنید.
.IP \(bu 2
ایجاد (raise) استثنای معنادار در صورت انتخاب کلاس reporter (قالب خروجی) نامعتبر.
.IP \(bu 2
افزونه‌ی docparams اکنون اجازه می‌دهد docstring یک ویژگی (property)، هم خود
ویژگی و هم setter را مستند کند. بنابراین setterها نیز می‌توانند بدون docstring باشند.
.IP \(bu 2
افزونه‌ی docparams اکنون نحو نوع ویژگی (property type syntax) را درک می‌کند.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
class Foo(object):
    @property
    def foo(self):
        \(dq\(dq\(dqMy Sphinx style docstring description.

        :type: int
        \(dq\(dq\(dq
        return 10
.EE
.UNINDENT
.UNINDENT
.INDENT 2.0
.INDENT 3.5
.sp
.EX
class Foo(object):
    @property
    def foo(self):
        \(dq\(dq\(dqint: My Numpy and Google docstring style description.\(dq\(dq\(dq
        return 10
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
در صورت استفاده از \fB\-\-output\-format=json\fP، دیکشنری بازگردانده‌شده شامل یک جفت کلید\-مقدار جدید است.
کلید \fBmessage\-id\fP و مقدار آن شناسه پیام است.
.IP \(bu 2
بررسی‌کننده‌ی املا دارای پارامتر پیکربندی جدید \fBmax\-spelling\-suggestions\fP است که
بر حداکثر تعداد پیشنهادهای گنجانده‌شده در پیام ارسالی تأثیر می‌گذارد.
.IP \(bu 2
بررسی \fB:ref:\(gainvalid\-name\(ga\fP شامل نام قالبی است که باعث بروز خطا شده است.
.sp
برای کد مشخص‌شده، \fBpylint\fP پیش از این \fBinvalid\-name\fP را به صورت \fBInvalid constant name var\fP صادر می‌کرد،
بدون اینکه مشخص کند چرا \fBvar\fP نام مناسبی نیست.
.sp
با این تغییر، اکنون مشخص‌تر است که برای پذیرفته‌شدن یک نام بر اساس قالب متناظر آن،
چه چیزی باید اصلاح شود.
.IP \(bu 2
پرچم پیکربندی جدیدی با نام \fBsuggestion\-mode\fP معرفی شد. با فعال بودن آن، pylint
تلاش می‌کند به جای خطاهای بی‌مورد در برخی سناریوهای شناخته‌شده مثبت کاذب، پیشنهادهای کاربرپسند
ارائه دهد. این پرچم به طور پیش‌فرض فعال است.
.IP \(bu 2
پیام \fBsuperfluous\-parens\fP دیگر به اشتباه برای گزاره‌های منطقی شامل عملگر \fBin\fP
صادر نمی‌شود (برای نمونه‌ای از آنچه قبلاً مثبت کاذب بود، مثال زیر را ببینید).
.INDENT 2.0
.INDENT 3.5
.sp
.EX
foo = None
if \(aqbar\(aq in (foo or {}):
  pass
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
تعریف مجدد تابع dummy اکنون ممکن است. در صورت بازتعریف توابع dummy،
پیام \fBfunction\-redefined\fP دیگر صادر نخواهد شد.
.IP \(bu 2
هنگامی که \fBArgs\fP و \fBKeyword Args\fP در Google docstring ترکیب شده باشند،
پیام‌های \fBmissing\-param\-doc\fP و \fBmissing\-type\-doc\fP دیگر صادر نمی‌شوند.
.IP \(bu 2
رفع مثبت کاذب پیام \fBuseless\-super\-delegation\fP هنگامی که
مقادیر پیش‌فرض پارامترها با مقادیر استفاده‌شده در کلاس پایه متفاوت است.
.IP \(bu 2
رفع مثبت کاذب پیام \fBuseless\-else\-on\-loop\fP هنگامی که دستورات break
به صورت عمیق در حلقه تودرتو شده‌اند.
.IP \(bu 2
بررسی‌کننده‌ی مهاجرت به Python 3 دیگر به ازای هر فایل چندین پیام \fBno\-absolute\-import\fP صادر نمی‌کند.
.IP \(bu 2
بررسی‌کننده‌ی مهاجرت به Python 3 بررسی‌کننده‌های غیرفعال‌شده در فایل پیکربندی را رعایت می‌کند.
.IP \(bu 2
ماژول‌ها، کلاس‌ها، یا متدهایی که شامل دستورهای مرکب فراتر از \fBdocstring\-min\-length\fP هستند،
اکنون به درستی پیام \fBmissing\-docstring\fP را صادر می‌کنند.
.IP \(bu 2
رفع عدم صدور پیام \fBwrong\-import\-order\fP هنگام ترتیب‌بندی کتابخانه‌های داخلی (first party) و شخص ثالث (third party).
با این اصلاح، pylint ماژول‌های داخلی و شخص ثالث را هنگام بررسی ترتیب import تفکیک می‌کند.
.IP \(bu 2
رفع نادیده گرفته‌شدن دستورالعمل‌های \fBpylint disable=fixme\fP برای کامنت‌های پس از
آخرین دستور در یک فایل.
.IP \(bu 2
رفع غیرفعال‌شدن پیام \fBline\-too\-long\fP توسط دستورالعمل نادرست disable.
دستورالعمل \fBdisable=fixme\fP دیگر صدور پیام \fBline\-too\-long\fP را
برای خطوط کامنت طولانی غیرفعال نمی‌کند.
.IP \(bu 2
اگر rcfile مشخص‌شده در خط فرمان وجود نداشته باشد، یک استثنای IOError
ایجاد (raise) می‌شود.
.IP \(bu 2
اصلاح محدوده‌ی نادرست دستورالعمل \fBdisable=\fP پس از یک خط کامنت‌شده.
به عنوان مثال، هنگامی که یک دستورالعمل \fBdisable=line\-too\-long\fP در پایان یک
خط کامنت طولانی قرار دارد، دیگر صدور پیام \fBline\-too\-long\fP را
برای خطوط پس از آن غیرفعال نمی‌کند.
.UNINDENT.SS گزارش کامل تغییرات (Full changelog)
.SS تازه‌های Pylint 1.8.1
.sp
تاریخ انتشار: 2017\-12\-15
.INDENT 0.0
.IP \(bu 2
شماره نسخه نادرست در __pkginfo__.
.UNINDENT
.SS تازه‌های Pylint 1.8
.sp
تاریخ انتشار: 2017\-12\-15
.INDENT 0.0
.IP \(bu 2
رعایت disable=... در فایل پیکربندی هنگام اجرا با \-\-py3k.
.IP \(bu 2
هشدار جدید \fBshallow\-copy\-environ\fP افزوده شد
.sp
کپی سطحی (Shallow copy) از os.environ آن‌طور که افراد انتظار دارند کار نمی‌کند. os.environ
یک شیء dict نیست بلکه یک شیء پراکسی است، بنابراین هر تغییری که روی نسخهٔ
کپی‌شده ایجاد شود ممکن است اثرات غیرمنتظره‌ای روی os.environ بگذارد.
.sp
به جای متد copy.copy(os.environ) باید از os.environ.copy()
استفاده شود.
.sp
برای جزئیات \%<https://\:bugs\:.python\:.org/\:issue15373> را ببینید.
.sp
بستن #1301
.IP \(bu 2
عدم نمایش چندبارهٔ هشدار no\-absolute\-import برای هر فایل.
.IP \(bu 2
.INDENT 2.0
.TP
.B بررسی بازآرایی \fBtrailing\-comma\-tuple\fP اکنون به انتساب‌هایی با
بیش از یک عنصر (مانند لیست‌ها) تعمیم داده شده است
.UNINDENT
.sp
بستن #1713
.IP \(bu 2
اصلاح رشتهٔ u\(aq\(aq در پیام superfluous\-parens / C0325 \%<#\:superfluous-parens>
.sp
بستن #1420
.IP \(bu 2
پیام \fBabstract\-class\-instantiated\fP اکنون برای همهٔ مسیرهای استنتاج صادر می‌شود.
.sp
بستن #1673
.IP \(bu 2
افزودن مجموعه‌ای از شیوه‌های نام‌گذاری پیش‌تعریف‌شده برای تسهیل پیکربندی
بررسی قراردادهای نام‌گذاری.
.sp
بستن #1013
.IP \(bu 2
افزودن یک بررسی جدید، \fBkeyword\-arg\-before\-vararg\fP
.sp
این پیام برای تعریف توابعی صادر می‌شود که در آن‌ها آرگومان‌های کلیدواژه‌ای
پیش از آرگومان‌های موقعیتی متغیر (*args) قرار گرفته‌اند.
.sp
این امر ممکن است در صورتی که مقدار آرگومان کلیدواژه‌ای در فراخوانی تابع مشخص نشود،
با این فرض که مقدار پیش‌فرض ارائه‌شده در تعریف را خواهد گرفت، به تغییر
فهرست args منجر شود.
.IP \(bu 2
بررسی \fBinvalid\-name\fP شامل نام الگویی است که باعث بروز خطا شده است
.sp
بستن #1176
.IP \(bu 2
استفاده از پرچم \-j فرآیندهای لینتر فرزند بیشتری از حد نیاز را اجرا نخواهد کرد.
.sp
بستن #1614
.IP \(bu 2
رفع یک مورد مثبت کاذب در bad\-python3\-import برای واردسازی‌های نسبی
.sp
بستن #1608
.IP \(bu 2
افزودن یک بررسی جدید برای پایتون ۳، \fBnon\-ascii\-bytes\-literals\fP
.sp
بستن #1545
.IP \(bu 2
افزودن چند بررسی جدید در پایتون ۳ برای دسترسی به متدهای dict در بسترهای غیرقابل‌پیمایش (non\-iterable)
.IP \(bu 2
بررسی‌های پروتکل (not\-a\-mapping / E1134 \%<#\:not-a-mapping>، not\-an\-iterable / E1133 \%<#\:not-an-iterable> و موارد مشابه) برای کلاس‌های دارای getattr پویا صادر نمی‌شوند
.IP \(bu 2
افزودن یک هشدار جدید، bad\-thread\-instantiation / W1506 \%<#\:bad-thread-instantiation>\(aq
.sp
این پیام زمانی صادر می‌شود که کلاس threading.Thread آرگومان target را
دریافت نکند، اما فقط یک آرگومان دریافت کند که به طور پیش‌فرض
پارامتر group است.
.sp
بستن #1327
.IP \(bu 2
در حالت غیرساکت (non\-quiet)، مسیر مطلق فایل پیکربندی استفاده‌شده در
خطای استاندارد ثبت می‌شود.
.sp
بستن #1519
.IP \(bu 2
ایجاد استثنای معنادار در صورت انتخاب کلاس گزارش‌گر (reporter) نامعتبر
.sp
هنگامی که یک کلاس گزارش‌گر ناشناخته به عنوان گزارش‌گر Pylint انتخاب شود،
پیام خطای معناداری به جای یک \fBImportError\fP یا \fBAttributeError\fP
خامِ مربوط به پیدا نشدن ماژول یا کلاس گزارش‌گر ایجاد می‌شود.
.sp
بستن #1388
.IP \(bu 2
افزودن یک بررسی جدید در پایتون ۳ برای دسترسی به توابع حذف‌شده از itertools
مانند \fBizip\fP یا \fBifilterfalse\fP
.IP \(bu 2
افزودن یک بررسی جدید در پایتون ۳ برای دسترسی به فیلدهای حذف‌شده از ماژول types
مانند \fBUnicodeType\fP یا \fBXRangeType\fP
.IP \(bu 2
افزودن یک بررسی جدید در پایتون ۳ برای اعلان متد \fBnext\fP که در پایتون ۲
به عنوان یک iterator در نظر گرفته می‌شد اما در پایتون ۳ یک تابع عادی است.
.IP \(bu 2
افزودن یک جفت کلید\-مقدار جدید در خروجی json. کلید \fBmessage\-id\fP
و مقدار آن شناسهٔ پیام است.
.sp
بستن #1512
.IP \(bu 2
افزودن یک بررسی جدید در پایتون 3.0 برای بالا انداختن StopIteration درون یک generator.
بررسی بالا انداختن StopIteration درون مولد همچنین در صورتی که استثنای
ایجادشده از StopIteration ارث‌بری کرده باشد معتبر است.
.sp
بستن #1385
.IP \(bu 2
افزودن هشدار جدید، \fBraising\-format\-tuple\fP، برای تشخیص ساخت استثنا
با چند آرگومان به جای قالب‌بندی رشتهٔ پیام.
.IP \(bu 2
افزودن یک بررسی جدید برای متدهایی از ماژول logging که رشته‌ها را با عملگر + متصل می‌کنند
.sp
بستن #1479
.IP \(bu 2
افزودن پارامتری برای محدود کردن تعداد پیشنهادات در بررسی‌کننده‌های غلط‌یاب املایی
.IP \(bu 2
رفع یک حالت خاص در بررسی‌کنندهٔ \fBconsider\-using\-ternary\fP.
.sp
هنگامی که شیء \fBA\fP مورد استفاده در \fBX and A or B\fP در بستر بولی دارای مقدار نادرست (falsy) بود،
Pylint به اشتباه یک پیشنهاد بر پایه عملگر سه‌گانه صادر می‌کرد که معادل آن نبود.
پس از این تغییر، پیام به درستی برای این حالت صادر نمی‌شود.
.sp
بستن #1559
.IP \(bu 2
افزودن پرچم پیکربندی \fBsuggestion\-mode\fP. هنگامی که این پرچم فعال باشد،
به جای پیام خطای نامفهوم برای ویژگی‌های فراخوانی‌شده در c\-extensions،
پیام اطلاعاتی صادر می‌شود.
.sp
بستن #1466
.IP \(bu 2
رفع پیام مثبت کاذب \fBuseless\-super\-delegation\fP هنگامی که
مقادیر پیش‌فرض پارامترها با مقادیر استفاده‌شده در کلاس پایه متفاوت باشند.
.sp
بستن #1085
.IP \(bu 2
غیرفعال‌سازی wrong\-import\-order / C0411 \%<#\:wrong-import-order>\(aq، wrong\-import\-position / C0413 \%<#\:wrong-import-position>\(aq یا
ungrouped\-imports / C0412 \%<#\:ungrouped-imports>\(aq برای یک خط مشخص، اکنون از
ایجاد تخلف توسط آن خط در خطوط بعدی جلوگیری می‌کند.
.sp
بستن #1336
.IP \(bu 2
افزودن یک بررسی جدید پایتون برای دستورهای بازگشت (return) ناسازگار درون متد یا تابع.
.sp
بستن #1267
.IP \(bu 2
رفع مثبت کاذب \fBsuperfluous\-parens\fP مربوط به مدیریت عبارت‌های منطقی
شامل عملگر \fBin\fP.
.sp
بستن #574
.IP \(bu 2
پیام \fBfunction\-redefined\fP دیگر برای توابع و
متدهایی که نام آن‌ها با عبارت باقاعدهٔ نام متغیر ساختگی (dummy) مطابقت دارد، صادر نمی‌شود.
.sp
بستن #1369
.IP \(bu 2
رفع مثبت‌های کاذب در \fBmissing\-param\-doc\fP و \fBmissing\-type\-doc\fP هنگام
ترکیب \fBArgs\fP و \fBKeyword Args\fP در docstring به سبک Google.
.sp
بستن #1409
.UNINDENT
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
رفع منفی‌های کاذب (false negatives) در \fBmissing\-docstring\fP هنگامی که ماژول‌ها، کلاس‌ها، یا متدها
شامل دستورهای مرکبی هستند که از \fBdocstring\-min\-length\fP فراتر می‌روند
.UNINDENT
.UNINDENT
.UNINDENT
.INDENT 0.0.IP \(bu 2
رفع مثبت‌های کاذب \fBuseless\-else\-on\-loop\fP هنگامی که دستورهای break به‌صورت عمیق درون حلقه تو در تو شده‌اند.
.sp
بسته شد #1661
.IP \(bu 2
رفع عدم صدور پیام \fBwrong\-import\-order\fP در ترتیب کتابخانه‌های داخلی (first party) و شخص ثالث (third party). با این اصلاح، pylint هنگام بررسی ترتیب وارد کردن (import)، ماژول‌های شخص ثالث و داخلی را متمایز می‌کند.
.sp
بسته شد #1702
.IP \(bu 2
رفع نادیده گرفته شدن دستورالعمل‌های \fBpylint disable=fixme\fP برای کامنت‌های پس از آخرین عبارت در یک فایل.
.sp
بسته شد #1681
.IP \(bu 2
رفع غیرفعال‌سازی پیام \fBline\-too\-long\fP توسط دستورالعمل غیرفعال‌سازی اشتباه. دستورالعمل \fBdisable=fixme\fP دیگر صدور پیام \fBline\-too\-long\fP را برای خطوط طولانی کامنت‌شده غیرفعال نمی‌کند.
.sp
بسته شد #1741
.IP \(bu 2
اگر rcfile مشخص‌شده در خط فرمان وجود نداشته باشد، یک استثنای IOError ایجاد می‌شود.
.sp
بسته شد #1747
.IP \(bu 2
رفع حوزه اثر (scope) نادرست دستورالعمل \fBdisable=\fP پس از یک خط کامنت‌شده. برای نمونه هنگامی که یک دستورالعمل \fBdisable=line\-too\-long\fP در انتهای یک خط کامنت‌شده طولانی قرار دارد، دیگر صدور پیام \fBline\-too\-long\fP را برای خطوط پس از آن غیرفعال نمی‌کند.
.sp
بسته شد #1742
.UNINDENT
.SS موارد جدید در Pylint 1.7
.sp
از ابتدای pylint تا نسخه 2.14.0 (شامل آن)، یک گزارش تغییرات (changelog) داشتیم که دربردارنده \fIتمام\fP تغییرات مهم Pylint بود، از جمله تغییراتی که مربوط به کاربر نهایی نبود؛ یعنی تغییراتی که ممکن است تنها در صورتی برای شما جالب باشد که توسعه‌دهنده‌ای باشید که روی pylint یا افزونه‌های pylint کار می‌کند یا یک تاریخ‌نگار منبع‌باز باشید.
.sp
از pylint 1.6.0 تا 2.14.0، علاوه بر گزارش تغییرات کامل، خلاصه‌ای از تغییرات (عمدتاً مربوط به کاربر) نیز وجود داشت.
.SS خلاصه \-\- نکات برجسته انتشار
.SS بررسی‌کننده‌های جدید
.INDENT 0.0
.IP \(bu 2
بررسی \fBsingle\-string\-used\-for\-slots\fP اضافه شد، که هرگاه کلاسی از یک رشته منفرد به عنوان مقدار slot استفاده کند به کار می‌رود. اگرچه این مورد از نظر فنی فی‌نفسه مشکلی ندارد، اما ممکن است کاربران را هنگام دستکاری مقدار slots به عنوان یک شیء پیمایش‌پذیر (iterable) به اشتباه بیندازد، که این امر به نوبه خود منجر به پیمایش روی نویسه‌های مقدار slot می‌شود. برای سرراست‌تر بودن، همواره سعی کنید از یک نگه‌دارنده (container) مانند یک list یا یک tuple برای تعریف مقادیر slot استفاده کنید.
.IP \(bu 2
ما یک بررسی جدید اضافه کردیم، \fBliteral\-comparison\fP، که هرگاه \fBpylint\fP بتواند مقایسه با یک لیترال (literal) را تشخیص دهد به کار می‌رود. این معمولاً چیزی نیست که می‌خواهیم و به‌طور بالقوه خطازاست. برای نمونه، در مثال ارائه‌شده، اولین مقایسه رشته مقدار true برمی‌گرداند، زیرا رشته‌های کوچک‌تر توسط مفسر اینترن (intern) می‌شوند، در حالی که برای رشته‌های بزرگ‌تر مقدار False برمی‌گرداند:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
mystring = \(dqok\(dq
if mystring is \(dqok\(dq: # Returns true
   ...

mystring = \(dqa\(dq * 1000
if mystring is (\(dqa\(dq * 1000): # This will return False
   ...
.EE
.UNINDENT
.UNINDENT
.sp
به جای استفاده از عملگر \fBis\fP، باید از عملگر \fB==\fP برای این مورد استفاده کنید.
.IP \(bu 2
ما یک پیام بازآرایی (refactoring) جدید اضافه کردیم، \fBconsider\-merging\-isinstance\fP، که هرگاه تشخیص دهیم فراخوانی‌های پیاپی \fIisinstance\fP را می‌توان با یکدیگر ادغام کرد صادر می‌شود.
برای نمونه، در این مثال می‌توانیم دو فراخوانی اول \fIisinstance\fP را ادغام کنیم:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
# $ cat a.py
if isinstance(x, int) or isinstance(x, float):
    pass
if isinstance(x, (int, float)) or isinstance(x, str):
    pass
# $ pylint a.py
# R:  1, 0: Consider merging these isinstance calls to isinstance(x, (float, int)) (consider\-merging\-isinstance)
# R:  3, 0: Consider merging these isinstance calls to isinstance(x, (int, float, str)) (consider\-merging\-isinstance)
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی خطای جدید اضافه شد، \fBinvalid\-metaclass\fP، که هرگاه \fIpylint\fP تشخیص دهد کلاسی معین از یک فراکلاس (metaclass) استفاده می‌کند که برای هدف آن کلاس نامعتبر است، به کار می‌رود. این موضوع معمولاً می‌تواند نشان‌دهنده مشکلی در کد باشد، تا کاری که عمداً انجام شده باشد.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
# Needs to inherit from *type* in order to be valid
class SomeClass(object):
    ...

class MyClass(metaclass=SomeClass):
    pass
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک هشدار جدید اضافه شد، \fBuseless\-super\-delegation\fP، که هرگاه تشخیص دهیم یک متد بازنویسی‌شده (overridden) بی‌استفاده است و با اتکا به واگذاری \fIsuper()\fP دقیقاً همان کار متد دیگری از MRO را انجام می‌دهد، به کار می‌رود.
.sp
برای نمونه، در این مثال دو متد اول بی‌استفاده هستند، زیرا دقیقاً همان کار متدهای کلاس‌های پایه را انجام می‌دهند، در حالی که دو متد بعدی این‌گونه نیستند، چون عملیات بیشتری را با آرگومان‌های ارائه‌شده انجام می‌دهند.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
class Impl(Base):

    def __init__(self, param1, param2):
        super(Impl, self).__init__(param1, param2)

    def useless(self, first, second):
        return super(Impl, self).useless(first, second)

    def not_useless(self, first, **kwargs):
        debug = kwargs.pop(\(aqdebug\(aq, False)
        if debug:
            ...
        return super(Impl, self).not_useless(first, **kwargs)

    def not_useless_1(self, first, *args):
        return super(Impl, self).not_useless_1(first + some_value, *args)
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک هشدار جدید اضافه شد، \fBlen\-as\-condition\fP، که هرگاه تشخیص دهیم یک شرط به نادرستی از \fBlen(SEQUENCE)\fP استفاده می‌کند، به کار می‌رود. به جای آن می‌توان از \fBif SEQUENCE\fP یا \fBif not SEQUENCE\fP\& استفاده کرد.
.sp
برای نمونه، همه مثال‌های زیر:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
if len(S):
  pass

if not len(S):
  pass

if len(S) > 0:
  pass

if len(S) != 0:
  pass

if len(S) == 0:
  pass
.EE
.UNINDENT
.UNINDENT
.sp
می‌توانند به روشی طبیعی‌تر نوشته شوند:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
if S:
  pass

if not S:
  pass
.EE
.UNINDENT
.UNINDENT.sp
برای اطلاعات بیشتر به \%<https://\:peps\:.python\:.org/\:pep-0008/#\:programming-recommendations>
مراجعه کنید.
.IP \(bu 2
افزونه‌ی جدیدی به نام \fBemptystring.py\fP اضافه شده است که مقایسه با
ثابت‌های رشته‌ی خالی را تشخیص می‌دهد. این افزونه به صورت پیش‌فرض غیرفعال
است. برای نمونه، مثال‌های زیر:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
if S != \(dq\(dq:
  pass

if S == \(aq\(aq:
  pass
.EE
.UNINDENT
.UNINDENT
.sp
می‌توانند به شیوه‌ای طبیعی‌تر نوشته شوند:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
if S:
  pass

if not S:
  pass
.EE
.UNINDENT
.UNINDENT
.sp
یک استثنا برای این مورد زمانی است که رشته‌ی خالی مقداری مجاز باشد که معنای آن
متفاوت با \fBNone\fP در نظر گرفته می‌شود. به عنوان مثال، معنای آن می‌تواند این باشد که
کاربر هیچ گزینه‌ی اضافی انتخاب نکرده است در مقابل اینکه کاربر هنوز انتخابی انجام نداده است!
.sp
می‌توانید این بررسی‌کننده را با افزودن خط زیر:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
load\-plugins=pylint.extensions.emptystring
.EE
.UNINDENT
.UNINDENT
.sp
به بخش \fBMAIN\fP در فایل \fB\&.pylintrc\fP خود، یا با استفاده از دستور زیر فعال کنید:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
$ pylint a.py \-\-load\-plugins=pylint.extensions.emptystring
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
افزونه‌ی جدیدی به نام \fBcomparetozero.py\fP اضافه شده است که مقایسه‌ی
اعداد صحیح با صفر را تشخیص می‌دهد. این افزونه به صورت پیش‌فرض غیرفعال است.
برای نمونه، مثال‌های زیر:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
if X != 0:
  pass

if X == 0:
  pass
.EE
.UNINDENT
.UNINDENT
.sp
می‌توانند به شیوه‌ای طبیعی‌تر نوشته شوند:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
if X:
  pass

if not X:
  pass
.EE
.UNINDENT
.UNINDENT
.sp
یک استثنا برای این مورد زمانی است که صفر مقداری مجاز باشد که معنای آن
متفاوت با \fBNone\fP در نظر گرفته می‌شود. برای مثال، این معنا می‌تواند این باشد که
\fBNone\fP یعنی بدون محدودیت، در حالی که \fB0\fP به این معناست که محدودیت صفر است!
.sp
می‌توانید این بررسی‌کننده را با افزودن خط زیر:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
load\-plugins=pylint.extensions.comparetozero
.EE
.UNINDENT
.UNINDENT
.sp
به بخش \fBMAIN\fP در فایل \fB\&.pylintrc\fP خود، یا با استفاده از دستور زیر فعال کنید:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
$ pylint a.py \-\-load\-plugins=pylint.extensions.comparetozero
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
شرایط خطای جدیدی برای \fBbad\-super\-call\fP اضافه کرده‌ایم که اکنون
استفاده از الگوهای \fBsuper(type(self), self)\fP و \fBsuper(self.__class__, self)\fP
را تشخیص می‌دهد. این موارد می‌توانند منجر به حلقه‌ی بازگشتی در کلاس‌های مشتق‌شده شوند. این مشکل
تنها زمانی آشکار می‌شود که کلاسی را بازنویسی کنید که از این فراخوانی‌های نادرست
\fBsuper()\fP استفاده می‌کند.
.sp
برای نمونه، \fBDerived.__init__()\fP به درستی \fBBase.__init__\fP را فراخوانی می‌کند.
در این نقطه، مقدار \fBtype(self)\fP برابر با \fBDerived\fP خواهد بود و فراخوانی دوباره
به سمت \fBBase.__init__\fP رفته و وارد یک حلقه‌ی بازگشتی می‌شویم.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
class Base(object):
    def __init__(self, param1, param2):
        super(type(self), self).__init__(param1, param2)

class Derived(Base):
    def __init__(self, param1, param2):
        super(Derived, self).__init__(param1, param2)
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
هشدارهای \fBmissing\-returns\-doc\fP و \fBmissing\-yields\-doc\fP هر کدام
با دو هشدار جدید، یعنی \fBmissing\-[return|yield]\-doc\fP و
\fBmissing\-[return|yield]\-type\-doc\fP جایگزین شده‌اند. تفکیک این موارد
به هشدارهای جداگانه به کاربر اجازه می‌دهد تا بسته به اینکه شیوه‌نامه‌ی مستندسازی‌اش به
توضیحات متنی return/yield تابع، مشخص کردن نوع‌های return/yield، یا هر دو
نیاز دارد، گزینه‌ی مناسب را برگزیند.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
# This will raise missing\-return\-type\-doc but not missing\-return\-doc
def my_sphinx_style_func(self):
    \(dq\(dq\(dqThis is a Sphinx\-style docstring.

    :returns: Always False
    \(dq\(dq\(dq
    return False

# This will raise missing\-return\-doc but not missing\-return\-type\-doc
def my_google_style_func(self):
    \(dq\(dq\(dqThis is a Google\-style docstring.

    Returns:
        bool:
    \(dq\(dq\(dq
    return False
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی بازسازی کد جدید به نام \fBredefined\-argument\-from\-local\fP اضافه شده است؛
این اخطار زمانی صادر می‌شود که \fBpylint\fP تشخیص دهد در برخی موارد مستعد خطا، یک آرگومان تابع
به صورت محلی بازتعریف شده است. برای نمونه در قطعه‌کد زیر یک باگ وجود دارد،
زیرا با توجه به مقایسه‌ی یک شیء با ویژگی‌های خودش، این بررسی هرگز مقدار \fBTrue\fP
را برنمی‌گرداند.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
def test(resource):
    for resource in resources:
        # The \(ga\(gafor\(ga\(ga is reusing \(ga\(garesource\(ga\(ga, which means that the following
        # \(ga\(garesource\(ga\(ga is not what we wanted to check against.
        if resource.resource_type == resource:
           call_resource(resource)
.EE
.UNINDENT
.UNINDENT.sp
جاهای دیگری که این بررسی زیر نظر می‌گیرد عبارتند از مقیدسازی‌های نام در دستور \fIwith\fP و مقیدسازی نام گردانندهٔ except.
.IP \(bu 2
یک بررسی بازآفرینی کد (refactoring) جدید اضافه شد، \fBno\-else\-return\fP، که زمانی که pylint با یک else پس از زنجیره‌ای از شرط‌های if مواجه شود که همگی حاوی عبارت return هستند، صادر می‌شود.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
def foo1(x, y, z):
    if x:
        return y
    else:  # This is unnecessary here.
        return z
.EE
.UNINDENT
.UNINDENT
.sp
می‌توان این مورد را با حذف عبارت \fBelse\fP اصلاح کرد.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
def foo1(x, y, z):
    if x:
        return y
    return z
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی جدید برای Python 3 اضافه شد، \fBeq\-without\-hash\fP، که کلاس‌هایی را که \fB__eq__\fP را پیاده‌سازی می‌کنند ملزم می‌سازد \fIهمچنین\fP \fB__hash__\fP را پیاده‌سازی کنند\&. رفتار کلاس‌هایی که \fB__eq__\fP را پیاده‌سازی می‌کنند اما فاقد \fB__hash__\fP هستند در Python 3 تغییر یافته است؛ در Python 2 چنین کلاس‌هایی \fBobject.__hash__\fP را به‌عنوان پیاده‌سازی پیش‌فرض دریافت می‌کردند. در Python 3، کلاس‌های مذکور \fBNone\fP را به‌عنوان پیاده‌سازی خود دریافت می‌کنند که باعث می‌شود قابلیت هش‌شدن را از دست بدهند (unhashable شوند).
.INDENT 2.0
.INDENT 3.5
.sp
.EX
class JustEq(object):
   def __init__(self, x):
     self.x = x

   def __eq__(self, other):
     return self.x == other.x

class Neither(object):
  def __init__(self, x):
    self.x = x

class HashAndEq(object):
   def __init__(self, x):
     self.x = x

   def __eq__(self, other):
     return self.x == other.x

   def __hash__(self):
     return hash(self.x)

{Neither(1), Neither(2)}  # OK in Python 2 and Python 3
{HashAndEq(1), HashAndEq(2)}  # OK in Python 2 and Python 3
{JustEq(1), JustEq(2)}  # Works in Python 2, throws in Python 3
.EE
.UNINDENT
.UNINDENT
.sp
به‌طور کلی، این یک شیوهٔ نامناسب است که انگیزهٔ این تغییر رفتار شد.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
as_set = {JustEq(1), JustEq(2)}
print(JustEq(1) in as_set)  # prints False
print(JustEq(1) in list(as_set))  # prints True
.EE
.UNINDENT
.UNINDENT
.sp
به منظور رفع این خطا و پرهیز از تفاوت‌های رفتاری میان Python 2 و Python 3، کلاس‌ها یا باید صریحاً \fB__hash__\fP را روی \fBNone\fP تنظیم کنند یا یک تابع هش‌گذاری پیاده‌سازی نمایند.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
class JustEq(object):
   def __init__(self, x):
     self.x = x

   def __eq__(self, other):
     return self.x == other.x

   __hash__ = None

{JustEq(1), JustEq(2)}  # Now throws an exception in both Python 2 and Python 3.
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
۳ بررسی‌کنندهٔ جدید برای Python 3 اضافه شد: \fBdiv\-method\fP، \fBidiv\-method\fP و \fBrdiv\-method\fP\&. متدهای جادویی \fB__div__\fP و \fB__idiv__\fP در Python 3 به نفع \fB__truediv__\fP منسوخ و کنار گذاشته شده‌اند\&. کلاس‌هایی که \fB__div__\fP را پیاده‌سازی می‌کنند و هنوز باید از طریق کدهای Python 2 که از \fBfrom __future__ import division\fP استفاده نمی‌کنند به کار گرفته شوند، باید \fB__truediv__\fP را پیاده‌سازی کرده و \fB__div__\fP را به عنوان نام مستعار (alias) آن پیاده‌سازی تنظیم کنند.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
from __future__ import division

class DivisibleThing(object):
   def __init__(self, x):
     self.x = x

   def __truediv__(self, other):
     return DivisibleThing(self.x / other.x)

   __div__ = __truediv__
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی‌کنندهٔ جدید برای Python 3 اضافه شد تا دربارهٔ دسترسی به مشخصهٔ \fBmessage\fP در Exceptions هشدار دهد. مشخصهٔ message در Python 2.7 منسوخ شد و در Python 3 حذف گردید. برای اطلاعات بیشتر \%<https://\:peps\:.python\:.org/\:pep-0352/#\:retracted-ideas> را ببینید.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
try:
  raise Exception(\(dqOh No!!\(dq)
except Exception as e:
  print(e.message)
.EE
.UNINDENT
.UNINDENT
.sp
به جای اتکا به مشخصهٔ \fBmessage\fP، باید به‌طور صریح استثنا را به یک رشته تبدیل کنید:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
try:
  raise Exception(\(dqOh No!!\(dq)
except Exception as e:
  print(str(e))
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی‌کنندهٔ جدید برای Python 3 اضافه شد تا دربارهٔ استفاده از \fBencode\fP یا \fBdecode\fP روی رشته‌ها با کدک‌های غیرمتنی هشدار دهد. این بررسی همچنین فراخوانی‌های \fBopen\fP با آرگومان کلیدواژه‌ای \fBencoding\fP را نیز بررسی می‌کند\&. برای اطلاعات بیشتر \%<https://\:docs\:.python\:.org/\:3/\:whatsnew/\:3\:.4\:.html#\:improvements-to-codec-handling> را ببینید.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
\(aqhello world\(aq.encode(\(aqhex\(aq)
.EE
.UNINDENT
.UNINDENT
.sp
به جای استفاده از متد \fBencode\fP برای کدک‌های غیرمتنی، از ماژول \fBcodecs\fP استفاده کنید.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
import codecs
codecs.encode(\(aqhello world\(aq, \(aqhex\(aq)
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک هشدار جدید اضافه شد، \fBoverlapping\-except\fP، که زمانی صادر می‌شود که یک گردانندهٔ except دو استثنا را مدیریت کند که با یکدیگر \fIهم‌پوشانی\fP دارند\&. این بدان معناست که یکی از استثناها والد (کلاس پایهٔ) استثنای دیگر است یا صرفاً یک نام مستعار برای آن است..sp
به‌عنوان مثال، در Python 3.3+‎، نام IOError یک نام مستعار برای OSError است. علاوه بر این، socket.error نیز نام مستعاری برای OSError است. هدف، یافتن مواردی شبیه به نمونه زیر است:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
import socket
try:
    pass
except (ConnectionError, IOError, OSError, socket.error):
    pass
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی‌کننده جدید Python 3 برای هشدار درباره دسترسی به \fBsys.maxint\fP\& اضافه شد. این مشخصه در Python 3 به نفع \fBsys.maxsize\fP\& حذف شد.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
import sys
print(sys.maxint)
.EE
.UNINDENT
.UNINDENT
.sp
به جای استفاده از \fBsys.maxint\fP، از \fBsys.maxsize\fP استفاده کنید
.INDENT 2.0
.INDENT 3.5
.sp
.EX
import sys
print(sys.maxsize)
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی‌کننده جدید Python 3 اضافه شد تا درباره وارد کردن (import) ماژول‌هایی که جابه‌جا شده یا از کتابخانه استاندارد حذف شده‌اند هشدار دهد.
.sp
یکی از اقدامات عمده در Python 3، سازمان‌دهی مجدد کتابخانه استاندارد برای حذف ماژول‌های قدیمی یا منسوخ‌شده و بازسازمان‌دهی برخی از ماژول‌های موجود بود. در نتیجه، تقریباً ۱۰۰ ماژول که در Python 2 وجود داشتند، دیگر در Python 3 وجود ندارند. برای اطلاعات بیشتر به \%<https://\:peps\:.python\:.org/\:pep-3108> و \%<https://\:peps\:.python\:.org/\:pep-0004> مراجعه کنید. پیشنهادهایی درباره نحوه مدیریت این موضوع در pythonhosted.org/six/#module\-six.moves (پیوند نامعتبر) یا python3porting.com/stdlib.html (پیوند نامعتبر) ارائه شده بود.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
from cStringIO import StringIO
.EE
.UNINDENT
.UNINDENT
.sp
به جای وارد کردن مستقیم ماژول منسوخ‌شده، از \fBsix.moves\fP یا یک import شرطی استفاده کنید.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
from six.moves import cStringIO as StringIO

if sys.version_info[0] >= 3:
    from io import StringIO
else:
    from cStringIO import StringIO
.EE
.UNINDENT
.UNINDENT
.sp
این بررسی‌کننده فرض می‌کند هر وارد کردنی که درون یک شرط یا یک بلوک \fBtry/except\fP انجام شود، معتبر است.
.IP \(bu 2
یک بررسی‌کننده جدید Python 3 اضافه شد تا درباره دسترسی به توابع منسوخ‌شده در ماژول string هشدار دهد. در Python 3 توابعی که از کلاس توکار (builtin) \fBstr\fP تکرار شده بودند حذف شدند. برای اطلاعات بیشتر به \%<https://\:docs\:.python\:.org/\:2/\:library/\:string\:.html#\:deprecated-string-functions> مراجعه کنید.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
import string
print(string.upper(\(aqhello world!\(aq))
.EE
.UNINDENT
.UNINDENT
.sp
به جای استفاده از \fBstring.upper\fP، متد \fBupper\fP را مستقیماً روی شیء رشته فراخوانی کنید.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
\(dqhello world!\(dq.upper()
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی‌کننده جدید Python 3 اضافه شد تا درباره فراخوانی \fBstr.translate\fP با پارامتر حذف‌شده \fBdeletechars\fP هشدار دهد. تابع \fBstr.translate\fP معمولاً به عنوان راهکاری برای حذف کاراکترها از یک رشته استفاده می‌شود.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
\(aqhello world\(aq.translate(None, \(aqlow\(aq)
.EE
.UNINDENT
.UNINDENT
.sp
متأسفانه، روش استانداردی برای نوشتن این فراخوانی به گونه‌ای که با هر دو نسخه ۲ و ۳ سازگار باشد وجود ندارد. اگر این کد در مسیر حیاتی (critical path) برنامه شما قرار ندارد و استفاده از \fBtranslate\fP یک بهینه‌سازی زودهنگام بوده است، استفاده از \fBre.sub\fP را به عنوان جایگزین در نظر بگیرید:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
import re
chars_to_remove = re.compile(\(aq[low]\(aq)
chars_to_remove.sub(\(aq\(aq, \(aqhello world\(aq)
.EE
.UNINDENT
.UNINDENT
.sp
اگر این کد در مسیر حیاتی برنامه شما قرار دارد و باید تا حد امکان سریع باشد، تعریف یک متد کمکی وابسته به نسخه Python را در نظر بگیرید.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
if six.PY3:
    def _remove_characters(text, deletechars):
        return text.translate({ord(x): None for x in deletechars})
else:
    def _remove_characters(text, deletechars):
        return text.translate(None, deletechars)
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی بازآرایی کد (refactoring) جدید به نام \fBconsider\-using\-ternary\fP اضافه شد؛ این هشدار زمانی صادر می‌شود که pylint ساختارهایی را شناسایی کند که پیش از معرفی عبارت سه‌تایی در Python 2.5، برای شبیه‌سازی آن استفاده می‌شدند.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
value = condition and truth_value or false_value
.EE
.UNINDENT
.UNINDENT
.sp
این هشدار را می‌توان با استفاده از ساختار استاندارد سه‌تایی برطرف کرد:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
value = truth_value if condition else false_value
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی بازآرایی کد جدید به نام \fBtrailing\-comma\-tuple\fP اضافه شد؛ این هشدار زمانی صادر می‌شود که pylint یک تاپل تک‌عنصری را پیدا کند که در اثر یک ویرگول اضافی و سرگردان ایجاد شده است. این مورد می‌تواند نشان‌دهنده یک مشکل احتمالی در کد باشد و توصیه می‌شود به جای تکیه بر خود ویرگول، از پرانتز برای تأکید بر ساخت تاپل استفاده شود.
.sp
هشدار برای چنین ساختاری صادر می‌شود:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
a = 1,
.EE
.UNINDENT
.UNINDENT
.sp
این هشدار را می‌توان با افزودن پرانتز برطرف کرد:
.INDENT 2.0
.INDENT 3.5.sp
.EX
a = (1, )
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
دو بررسی جدید برای تشخیص عملیات پشتیبانی‌نشده روی یک نمونه اضافه شد: \fBunsupported\-assignment\-operation\fP و \fBunsupported\-delete\-operation\fP\&.
مورد اول زمانی صادر می‌شود که یک شیء از انتساب آیتم پشتیبانی نکند، در حالی که مورد دوم زمانی صادر می‌شود که شیء از حذف آیتم پشتیبانی نکند:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
class A:
    pass
instance = A()
instance[4] = 4 # unsupported\-assignment\-operation
del instance[4] # unsupported\-delete\-operation
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
یک بررسی جدید اضافه شد، \fBrelative\-beyond\-top\-level\fP، که زمانی صادر می‌شود که یک واردسازی نسبی تلاش کند به سطوحی فراتر از بالاترین سطح بستهٔ جاری دسترسی یابد.
.IP \(bu 2
یک بررسی جدید اضافه شد، \fBtrailing\-newlines\fP، که زمانی صادر می‌شود که یک فایل دارای خطوط جدید اضافی در انتها باشد.
.IP \(bu 2
بررسی \fBinvalid\-length\-returned\fP اضافه شد، که وقتی پیاده‌سازی \fB__len__\fP یک عدد صحیح غیرمنفی برنگرداند صادر می‌شود.
.IP \(bu 2
یک افزونه جدید به نام \fBpylint.extensions.mccabe\fP وجود دارد که می‌تواند برای محاسبهٔ پیچیدگی مک‌کیب (McCabe) کلاس‌ها و توابع استفاده شود.
.sp
می‌توانید این افزونه را از طریق \fB\-\-load\-plugins=pylint.extensions.mccabe\fP فعال کنید.
.IP \(bu 2
یک بررسی جدید اضافه شد، \fBused\-prior\-global\-declaration\fP\&. این بررسی زمانی صادر می‌شود که یک نام پیش از اعلان سراسری (global) استفاده شده باشد، که در Python 3.6 منجر به SyntaxError می‌شود.
.IP \(bu 2
یک پیام جدید اضافه شد، \fBassign\-to\-new\-keyword\fP\&. این پیام زمانی صادر می‌شود که نام استفاده‌شده در انتشار آیندهٔ Python تبدیل به یک کلمهٔ کلیدی شود. انتساب به کلمات کلیدی پس از تغییر به نسخهٔ جدیدتر مفسر منجر به \fBSyntaxError\fP خواهد شد.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
# While it\(aqs correct in Python 2.x, it raises a SyntaxError in Python 3.x
True = 1
False = 0

# Same as above, but it\(aqll be a SyntaxError starting from Python 3.7
async = \(dqasync\(dq
await = \(dqawait\(dq
.EE
.UNINDENT
.UNINDENT
.UNINDENT
.SS "سایر تغییرات (Other Changes)"
.INDENT 0.0
.IP \(bu 2
اگر اشیاء استنتاج مبهم (opaque inference) در نتایج استنتاج وجود داشته باشند، به‌طور پیش‌فرض \fBno\-member\fP صادر نمی‌شود
.sp
این رفتار توسط پرچم جدید \fB\-\-ignore\-on\-opaque\-inference\fP کنترل می‌شود که به‌طور پیش‌فرض True است. استنتاج می‌تواند در حین ارزیابی یک شیء Python چندین نتیجهٔ بالقوه برگرداند، اما ممکن است برخی شاخه‌ها ارزیابی نشوند که منجر به استنتاج ناقص می‌شود. در این حالت، ممکن است همچنان صادر کردن no\-member / E1101 \%<#\:no-member> و سایر بررسی‌ها برای بقیهٔ اشیاء استنتاج‌شده مفید باشد.
.IP \(bu 2
بسته‌های فضای نام (Namespace packages) اکنون توسط pylint پشتیبانی می‌شوند. این شامل هر دو نوع بسته‌های فضای نام صریح و بسته‌های فضای نام ضمنی است که در Python 3 از طریق PEP 420 پشتیبانی می‌شوند.
.IP \(bu 2
گزینهٔ جدیدی اضافه شد: \fB\-\-analyse\-fallback\-block\fP\&.
.sp
این گزینه می‌تواند برای پشتیبانی از کدهای بلوک واردسازی سازگار با هر دو نسخهٔ Python 2 و 3 استفاده شود؛ بدین معنی که بلوک واردسازی ممکن است کدی داشته باشد که فقط در یکی از مفسرها وجود دارد و هنگام تحلیل منجر به مثبت کاذب (false positive) می‌شود. به‌طور پیش‌فرض، مقدار این گزینه false است؛ می‌توانید تحلیل هر دو شاخه را با استفاده از این پرچم فعال کنید.
.IP \(bu 2
گزینهٔ \fBignored\-argument\-names\fP اکنون برای نادیده گرفتن آرگومان‌ها در بررسی unused\-variable / W0612 \%<#\:unused-variable> استفاده می‌شود.
.sp
این گزینه قبلاً برای نادیده گرفتن آرگومان‌ها هنگام محاسبهٔ تعداد صحیح آرگومان‌هایی که یک تابع باید داشته باشد استفاده می‌شد، اما برای مدیریت آرگومان‌ها با توجه به بررسی unused\-variable / W0612 \%<#\:unused-variable>، به جای آن از dummy\-variables\-rgx استفاده می‌شد. اکنون، ignored\-argument\-names علاوه بر کاربرد اصلی خود، برای نادیده گرفتن آرگومان‌های منطبق با الگو برای بررسی unused\-variable / W0612 \%<#\:unused-variable> نیز استفاده می‌شود. این قابلیت کنترل بهتری بر روی اینکه چه مواردی باید نادیده گرفته شوند و چگونه، ارائه می‌دهد.
همچنین، همین گزینه از بررسی‌کنندهٔ design به بررسی‌کنندهٔ variables منتقل شد، که بدان معنی است که گزینه اکنون زیر بخش \fB[VARIABLES]\fP در فایل پیکربندی قرار می‌گیرد.
.IP \(bu 2
گزینهٔ جدیدی اضافه شد، \fBredefining\-builtins\-modules\fP، برای کنترل ماژول‌هایی که می‌توانند توابع و مقادیر درونی (builtins) را بازتعریف کنند، مانند six.moves و future.builtins.
.IP \(bu 2
گزینهٔ جدیدی اضافه شد، \fBignore\-patterns\fP، که برای ایجاد یک فهرست نادیده‌گیری از دایرکتوری‌ها و فایل‌های منطبق بر الگوهای regex استفاده می‌شود، مشابه گزینهٔ \fBignore\fP.
.IP \(bu 2
گزارش‌ها (reports) اکنون به‌طور پیش‌فرض غیرفعال هستند، همچنین هشدارهای دسته‌بندی اطلاعاتی (information category).
.IP \(bu 2
بررسی \fBarguments\-differ\fP بازنویسی شد تا پارامترهای فقط-کلیدواژه‌ای (keyword-only) و متغیرها (variadics) را در نظر بگیرد.
.sp
اکنون این بررسی در مورد حذف یا افزودن قابلیت‌ها به یک متد، از طریق معرفی متغیرهای موضعی یا کلیدواژه‌ای نیز هشدار می‌دهد. به عنوان مثال، \fIpylint\fP اکنون در این موارد هشدار می‌دهد:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
class Parent(object):

    def foo(self, first, second):
        ...

    def bar(self, **kwargs):
        ...

    def baz(self, *, first):
        ...

class Child(Parent):

    # Why subclassing in the first place?
    def foo(self, *args, **kwargs):
        # mutate args or kwargs.
        super(Child, self).foo(*args, **kwargs)

    def bar(self, first=None, second=None, **kwargs):
        ...
        # The overridden method adds two new parameters,
        # which can also be passed as positional arguments,
        # breaking the contract of the parent\(aqs method.

    def baz(self, first):
        ...
        # Not keyword\-only
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
بررسی \fBredefined\-outer\-name\fP اکنون در صورتی که متغیر هدفِ یک حلقهٔ تودرتو با حلقهٔ بیرونی یکسان باشد نیز صادر می‌شود.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
for i, j in [(1, 2), (3, 4)]:
    for j in range(i):
        print(j)
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
محدودیت تعداد نویسه‌ها برای نام‌های متد و توابعی که با \fB_\fP شروع می‌شوند کاهش یافت\&. این موضوع اجازه می‌دهد تا افراد بتوانند نام‌های توصیفی طولانی‌تری برای متدها و توابعی با حوزهٔ اثر (scope) کوتاه‌تر (که خصوصی تلقی می‌شوند) استفاده کنند. همین ایده برای نام‌های متغیرها نیز با یک قاعدهٔ معکوس اعمال می‌شود: شما نام‌های توصیفی طولانی را برای متغیرهایی با حوزهٔ اثر بزرگ‌تر، مانند متغیرهای سراسری (globals) می‌خواهید.
.IP \(bu 2
افزودن کلاس استثنای \fBInvalidMessageError\fP و جایگزینی \fBassert\fP در pylint.utils با \fBraise InvalidMessageError\fP\&.
.IP \(bu 2
کلاس‌های \fBUnknownMessageError\fP (قبلاً \fBUnknownMessage\fP) و \fBEmptyReportError\fP (قبلاً \fBEmptyReport\fP) اکنون توسط زیرماژول جدید \fBpylint.exceptions\fP به جای \fBpylint.utils\fP ارائه می‌شوند.
.IP \(bu 2
اکنون از یادداشت‌های درون‌خطی (inline comments) برای مقادیر جدا شده با کاما در پیکربندی‌ها پشتیبانی می‌کنیم
.sp
به عنوان مثال، اکنون می‌توانید از علامت \fB#\fP برای درج یادداشت در مقادیر جدا شده با کاما استفاده کنید، همان‌طور که در زیر مشاهده می‌شود:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
disable=no\-member, # Don\(aqt care about it for now
        bad\-indentation, # No need for this
        import\-error
.EE
.UNINDENT
.UNINDENT.sp
البته، ترکیب توضیحات با مقادیر نیز کار می‌کند:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
disable=no\-member,
        # Don\(aqt care about it for now
        bad\-indentation # No need for this
.EE
.UNINDENT
.UNINDENT
.sp
این قابلیت با تنظیم مناسب پیشوندهای توضیحات درون‌خطی \%<https://\:docs\:.python\:.org/\:3/\:library/\:configparser\:.html#\:customizing-parser-behaviour> کار می‌کند.
.IP \(bu 2
افزودن پشتیبانی از docstring با فرمت epytext به افزونه docparams.
.IP \(bu 2
پشتیبانی از ارائه راهنمایی در صورت نیافتن عضو ناموجود اضافه شد.
.sp
برای مثال، با توجه به کد زیر، باید مشخص باشد که
برنامه‌نویس قصد استفاده از صفت \fBmail\fP را داشته است، نه
\fBemail\fP\&.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
class Contribution:
    def __init__(self, name, email, date):
        self.name = name
        self.mail = mail
        self.date = date

for c in contributions:
    print(c.email) # Oups
.EE
.UNINDENT
.UNINDENT
.sp
اکنون \fBpylint\fP هشدار خواهد داد که احتمال وجود یک خطای نگارشی وجود دارد
و نام‌های جدیدی را پیشنهاد می‌دهد که می‌توان به جای آن استفاده کرد.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
$ pylint a.py
E: 8,10: Instance of \(aqContribution\(aq has no \(aqemail\(aq member; maybe \(aqmail\(aq?
.EE
.UNINDENT
.UNINDENT
.sp
این رفتار از طریق گزینه \fB\-\-missing\-member\-hint\fP کنترل می‌شود.
گزینه‌های دیگری که همراه با این تغییر اضافه شده‌اند عبارتند از \fB\-\-missing\-member\-max\-choices\fP
برای انتخاب تعداد کل گزینه‌هایی که باید در این وضعیت ارائه شوند
و \fB\-\-missing\-member\-hint\-distance\fP که معیاری را برای محاسبه فاصله بین نام‌ها
مشخص می‌کند (این معیار بر اساس فاصله لون‌اشتاین (Levenshtein) است، به این معنی که
هرچه عدد کمتر باشد، الگوریتم سخت‌گیرتر خواهد بود).
.IP \(bu 2
متد \fBPyLinter.should_analyze_file\fP دارای یک پارامتر جدید به نام \fBis_argument\fP است
که مشخص می‌کند آیا مسیر داده‌شده یک آرگومان \fBpylint\fP است یا خیر.
.sp
متد \fBshould_analyze_file\fP هر زمان که \fBpylint\fP بخواهد تعیین کند
آیا یک فایل باید تحلیل شود یا خیر فراخوانی می‌شود که به طور پیش‌فرض روی فایل‌های
با پسوند \fB\&.py\fP تنظیم است، اما این تابع تنها زمانی فراخوانی می‌شود که فایل مذکور
به عنوان آرگومان خط فرمان به \fBpylint\fP ارسال نشده باشد. این معمولاً بدان معناست
که pylint یک فایل را حتی اگر پسوند متفاوتی داشته باشد، تا زمانی که فایل به طور صریح
در خط فرمان مشخص شده باشد تحلیل می‌کند. از آنجا که نمی‌توان \fBshould_analyze_file\fP را
برای مدیریت تمام حالت‌ها بازنویسی کرد، بررسی منشأ فایل‌ها به درون \fBshould_analyze_file\fP منتقل شد.
این یعنی اکنون می‌توانیم کدی مشابه این مثال بنویسیم تا هر فایلی را که دارای ویژگی مورد نظر است،
بدون در نظر گرفتن منشأ فایل (چه فایلی باشد که به عنوان آرگومان خط فرمان ارسال شده و چه بخشی از یک بسته باشد)،
نادیده بگیریم.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
from pylint.lint import Run, PyLinter

class CustomPyLinter(PyLinter):

     def should_analyze_file(self, modname, path, is_argument=False):
         if respect_condition(path):
             return False
         return super().should_analyze_file(modname, path, is_argument=is_argument)


class CustomRun(Run):
     LinterClass = CustomPyLinter

CustomRun(sys.argv[1:])
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
وارد کردن‌هایی که با زیرخط نام مستعار گرفته‌اند، هنگام بررسی برای موارد استفاده‌نشده نادیده گرفته می‌شوند.
.IP \(bu 2
موارد \fBbad\-builtin\fP و \fBredefined\-variable\-type\fP اکنون به افزونه تبدیل شده‌اند
و به طور پیش‌فرض غیرفعال هستند. آنها را می‌توان از طریق زیر فعال کرد:
\fB\-\-load\-plugins=pylint.extensions.redefined_variable_type,pylint.extensions.bad_builtin\fP
.INDENT 2.0
.IP \(bu 2
بررسی‌کننده وارد کردن‌ها از سوییچ جدید \fBallow\-wildcard\-with\-all\fP پشتیبانی می‌کند که
هنگام تعریف متغیر \fB__all__\fP در ماژول واردشده، هشدار مربوط به وارد کردن همگانی (wildcard import) را غیرفعال می‌کند.
.UNINDENT
.IP \(bu 2
اکنون \fBdiffering\-param\-doc\fP برای بخش مغایر از \fBmissing\-param\-doc\fP قدیمی،
و \fBdiffering\-type\-doc\fP برای بخش مغایر از \fBmissing\-type\-doc\fP قدیمی استفاده می‌شود\&.
.UNINDENT.SS "رفع باگ‌ها (Bug fixes)"
.INDENT 0.0
.IP \(bu 2
رفع یک مورد مثبت کاذب در \fBredundant\-returns\-doc\fP، که زمانی رخ می‌داد که تابع مستندشده به‌جای \fIreturn\fP از \fIyield\fP استفاده می‌کرد\&.
.IP \(bu 2
رفع یک مورد مثبت کاذب در \fBmissing\-param\-doc\fP و \fBmissing\-type\-doc\fP، که زمانی رخ می‌داد که docstring یک کلاس از رشته جادویی \fBFor the parameters, see\fP استفاده می‌کرد اما docstring متد \fB__init__\fP کلاس استفاده نمی‌کرد، یا برعکس.
.IP \(bu 2
استنتاج مناسب نوع استثنا برای \fBmissing\-raises\-doc\fP افزوده شد\&. اکنون:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
def my_func():
    \(dq\(dq\(dq\(dqMy function.\(dq\(dq\(dq
    ex = ValueError(\(aqfoo\(aq)
    raise ex
.EE
.UNINDENT
.UNINDENT
.sp
در میان سناریوهای دیگر، اکنون به‌جای \fB:raises ex:\fP به‌درستی برای نبود مستندسازیِ \fB:raises ValueError:\fP پرچم‌گذاری می‌شود.
.IP \(bu 2
رفع موارد مثبت کاذب در \fBmissing\-[raises|params|type]\-doc\fP به دلیل عدم شناسایی مترادف‌های کلیدواژه‌ای معتبری که توسط Sphinx پشتیبانی می‌شوند.
.IP \(bu 2
اعتبارسنجی دقیق‌تر در \fBMessagesStore.register_messages()\fP جهت تشخیص تداخل میان یک پیام جدید و هرگونه شناسه پیام (message id)، نماد (symbol) یا \fBold_names\fP موجود\&.
.IP \(bu 2
اکنون از داشتن پلاگین‌هایی که نام یکسانی به اشتراک می‌گذارند و هر یک گزینه‌هایی ارائه می‌دهند، پشتیبانی می‌شود.
.sp
یک پلاگین می‌تواند از نظر منطقی به چندین کلاس تقسیم شود، به‌طوری که هر کلاس قابلیت‌های مشخصی ارائه دهد و همگی تحت یک نام یکپارچه شوند. اما هنگامی که دو یا چند مورد از این کلاس‌ها گزینه‌هایی نیز اضافه می‌کردند، \fBpylint\fP دچار فروپاشی (crash) می‌شد، زیرا بخش اولیه‌ای را که با آن مواجه شده بود از قبل اضافه کرده بود. اکنون این موارد باید مطابق انتظار کار کنند.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
from pylint.checkers import BaseChecker


class DummyPlugin1(BaseChecker):
    name = \(aqdummy_plugin\(aq
    msgs = {\(aqI9061\(aq: (\(aqDummy short desc 01\(aq, \(aqdummy\-message\-01\(aq, \(aqDummy long desc\(aq)}
    options = (
        (\(aqdummy_option_1\(aq, {
            \(aqtype\(aq: \(aqstring\(aq,
            \(aqmetavar\(aq: \(aq<string>\(aq,
            \(aqhelp\(aq: \(aqDummy option 1\(aq,
        }),
    )


class DummyPlugin2(BaseChecker):
    name = \(aqdummy_plugin\(aq
    msgs = {\(aqI9060\(aq: (\(aqDummy short desc 02\(aq, \(aqdummy\-message\-02\(aq, \(aqDummy long desc\(aq)}
    options = (
        (\(aqdummy_option_2\(aq, {
            \(aqtype\(aq: \(aqstring\(aq,
            \(aqmetavar\(aq: \(aq<string>\(aq,
            \(aqhelp\(aq: \(aqDummy option 2\(aq,
        }),
    )


def register(linter):
    linter.register_checker(DummyPlugin1(linter))
    linter.register_checker(DummyPlugin2(linter))
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
برای پیاده‌سازی‌های singledispatch اخطار \fBunused\-argument\fP صادر نمی‌شود و برای چندین پیاده‌سازی با نام یکسان نیز هشداری درباره \fBfunction\-redefined\fP داده نمی‌شود.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
from functools import singledispatch

@singledispatch
def f(x):
    return 2*x

@f.register(str)
def _(x):
    return \-1

@f.register(int)
@f.register(float)
def _(x):
    return \-x
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
بررسی‌کننده \fBunused\-variable\fP قابلیت جدیدی برای هشدار درباره متغیرهای بلااستفاده در فضای نام سراسری ماژول دارد. از آنجا که متغیرهای سراسری در فضای نام ماژول ممکن است بخشی از API عمومی باشند، این بررسی به‌طور پیش‌فرض غیرفعال است. برای فعال کردن آن، گزینه \fBallow\-global\-unused\-variables\fP را روی false تنظیم کنید.
.IP \(bu 2
رفع یک پیام مثبت کاذب در \fBlogging\-format\-interpolation\fP، هنگامی که مشخصات قالب‌بندی در رشته قالب‌بندی‌شده استفاده می‌شوند. به‌طور کلی، این عملیات همیشه به قالب‌بندی سبک قدیمیِ مورد استفاده در ماژول logging قابل تبدیل نیستند.
.IP \(bu 2
کلید جدید \fBsingle\-line\-class\-stmt\fP برای مجاز کردن تعریف تک‌خطی بدنه خالی کلاس‌ها (همان‌طور که در مثال زیر دیده می‌شود) افزوده شد. با فعال بودن این گزینه، pylint پیام \fBmultiple\-statements\fP صادر نخواهد کرد.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
class MyError(Exception): pass
.EE
.UNINDENT
.UNINDENT
.INDENT 2.0
.IP \(bu 2
هنگامی که از عبارات ستاره‌دار در تاپل سمت راست (RHS tuple) استفاده می‌شود، خطاهای \fBtoo\-many\-format\-args\fP و \fBtoo\-few\-format\-args\fP به‌درستی صادر می‌شوند (یا در صورتی که تعداد دقیق عناصر در RHS قابل استنتاج نباشد، اصلاً صادر نمی‌شوند). برای مثال، بلوک کدی که در زیر نشان داده شده است به‌درستی تشخیص می‌دهد که تاپل استفاده‌شده در واقع دارای سه عنصر است، نه دو عنصر.
.UNINDENT
.INDENT 2.0
.INDENT 3.5
.sp
.EX
meat = [\(aqspam\(aq, \(aqham\(aq]
print(\(aq%s%s%s\(aq % (\(aqeggs\(aq, *meat))
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
بررسی‌کننده \fBcyclic\-import\fP از دستورهای محلی غیرفعال‌سازی پشتیبانی می‌کند. هنگامی که یکی از واردسازی‌های حلقه‌ای در دامنه‌ای انجام شده باشد که دستور غیرفعال‌سازی در آن فعال بوده است، این چرخه به‌عنوان تخلف گزارش نمی‌شود.
.UNINDENT.SS "تغییرات حذف‌شده (Removed Changes)"
.INDENT 0.0
.IP \(bu 2
ابزار \fBpylint\-gui\fP حذف شد، زیرا برای گنجانده شدن در \fIpylint\fP\& نامناسب تشخیص داده شد. این ابزار دارای چند باگ و ویژگی نامطلوب بود، کارایی و سهولت استفاده از آن پایین‌تر از حد استاندارد بود و از آنجا که توسعهٔ آن نادیده گرفته شده بود، تصمیم بر این شد که بدون آن ادامه دهیم.
.IP \(bu 2
گزارش‌گر HTML به‌همراه گزینهٔ \fB\-\-output\-format=html\fP حذف شد. این بخش اخیراً در Pylint به حاشیه رفته بود و عمدتاً نادیده گرفته می‌شد. از آنجا که اکنون گزارش‌گر JSON را داریم، می‌توان از آن به‌عنوان پایه‌ای برای ایجاد گزارش‌های HTML زیباتر از آنچه Pylint در حال حاضر تولید می‌کند، استفاده کرد. این مورد بخشی از تلاش‌ها برای پالایش کدهای زائد Pylint از طریق حذف ویژگی‌های کمتر استفاده‌شده است.
.IP \(bu 2
گزینهٔ \fB\-\-files\-output\fP حذف شد. اگرچه نمی‌توان عملکرد مشابه را به‌سادگی بازسازی کرد، اما برای مثال می‌توان از گزارش‌گر JSON به‌عنوان پایه‌ای برای تولید پیام‌ها به ازای هر فایل استفاده کرد.
.IP \(bu 2
گزینهٔ \fB\-\-required\-attributes\fP حذف شد.
.IP \(bu 2
گزینهٔ \fB\-\-ignore\-iface\-methods\fP حذف شد.
.IP \(bu 2
پرچم \fB\-\-optimize\-ast\fP حذف شد.
.sp
این گزینه در ابتدا برای مدیریت حالت‌های حاد (pathological cases) اضافه شده بود، مانند الحاق بیش از حد رشته‌ها با استفاده از عملگر جمع، که باعث می‌شد pylint هنگام تلاش برای تشخیص محتوای رشته دچار خطای بازگشتی (recursion error) شود. متأسفانه تصمیم گرفتیم این مشکل را نادیده بگیریم، چرا که این حالت حاد هنگام تجزیهٔ کد توسط پایتون نیز، پیش از رسیدن به مرحلهٔ زمان اجرا، رخ می‌داد و بنابراین تصمیم گرفتیم این خطا را به‌طور کامل حذف کنیم.
.IP \(bu 2
پارامتر \fIscript\fP در \fBepylint.py_run\fP حذف شد.
.sp
اکنون \fBepylint.py_run\fP همیشه از متد پایه‌ای \fBepylint.lint\fP از مفسر فعلی استفاده می‌کند. این کار از برخی مشکلات در زمان نصب بودن چندین نمونه از \fBpylint\fP جلوگیری می‌کند، که باعث می‌شد \fBepylint.py_run\fP اسکریپت متفاوتی از \fBepylint\fP را نسبت به آنچه مد نظر بود اجرا کند.
.UNINDENT
.SS "گزارش کامل تغییرات (Full changelog)"
.SS "موارد جدید در Pylint 1.7.1 (What\(aqs New in Pylint 1.7.1?)"
.sp
تاریخ انتشار: 2017\-04\-17
.INDENT 0.0
.IP \(bu 2
رفع یک مورد مثبت کاذب (false positive) که هنگام بازبرانگیختن یک استثنا رخ می‌داد.
.sp
بسته شدن #1419
.IP \(bu 2
رفع یک مورد مثبت کاذب در \fBdisallow\-trailing\-tuple\fP
.sp
این بررسی با راستی‌آزمایی خط‌های جدیدِ غیرپایان‌بخش (non\-terminating newlines) بهبود یافت که باید فراخوانی‌های تابع و تعاریف تابع را از این بررسی معاف کند.
.sp
بسته شدن #1424
.UNINDENT
.SS "موارد جدید در Pylint 1.7 (What\(aqs New in Pylint 1.7?)"
.sp
تاریخ انتشار: 2017\-04\-13
.INDENT 0.0
.IP \(bu 2
عدم صدور پیام‌های missing\-final\-newline / C0304 \%<#\:missing-final-newline> یا trailing\-whitespace / C0303 \%<#\:trailing-whitespace> برای نویسه‌های انتقال صفحه (formfeed / page break).
.sp
بسته شدن #1218 و #1219
.IP \(bu 2
عدم صدور پیش‌فرض پیام no\-member / E1101 \%<#\:no-member> در صورتی که شیءهای استنتاجیِ کدر (opaque inference objects) در نتایج استنتاج وجود داشته باشند.
.sp
این رفتار توسط پرچم جدید ignore\-on\-opaque\-inference کنترل می‌شود که به‌طور پیش‌فرض True است. فرایند استنتاج می‌تواند هنگام ارزیابی یک شیء پایتون چندین نتیجهٔ بالقوه برگرداند، اما ممکن است برخی شاخه‌ها ارزیابی نشوند که منجر به استنتاج جزئی می‌شود. در چنین حالتی، ممکن است همچنان صدور no\-member / E1101 \%<#\:no-member> و سایر بررسی‌ها برای بقیهٔ شیءهای استنتاج‌شده سودمند باشد.
.IP \(bu 2
افزودن پیام جدید \fBassign\-to\-new\-keyword\fP برای هشدار در مورد انتساب به نام‌هایی که در نگارش‌های آیندهٔ پایتون به کلمهٔ کلیدی تبدیل خواهند شد.
.sp
بسته شدن #1351
.IP \(bu 2
تفکیک بخش‌های \(aqmissing or differing\(aq در مستندسازی پارامترها به خطاهای جداگانه.
پیام differing\-param\-doc / W9017 \%<#\:differing-param-doc> بخش مغایرت را از پیام قدیمی missing\-param\-doc / W9015 \%<#\:missing-param-doc>\(aq پوشش می‌دهد، و differing\-type\-doc / W9018 \%<#\:differing-type-doc>\(aq بخش مغایرت نوع را از پیام قدیمی missing\-type\-doc / W9016 \%<#\:missing-type-doc>\(aq پوشش می‌دهد.
.sp
بسته شدن #1342
.IP \(bu 2
افزودن خطای جدید used\-prior\-global\-declaration / E0118 \%<#\:used-prior-global-declaration>\(aq که هنگام استفاده از یک نام پیش از اعلان global در یک تابع صادر می‌شود. این مورد در Python 3.6 باعث SyntaxError می‌شود.
.sp
بسته شدن #1257
.IP \(bu 2
بررسی‌های پروتکل (protocol checks) اکنون زمانی که یک متد خاص برابر با None تنظیم شده باشد پیام‌های خود را صادر می‌کنند.
.sp
بسته شدن #1263
.IP \(bu 2
تشخیص صحیح این موضوع که آیا نام واردشده (imported name) به همان نام در یک حوزهٔ دید (scope) دیگر انتساب داده شده است یا خیر.
.sp
بسته شدن #636، #848، #851 و #900
.IP \(bu 2
الزام قرار دادن یک فاصله برای حاشیه‌نویسی‌ها با راهنمای نوع (type hints)، مطابق با PEP 8.
.IP \(bu 2
بررسی trailing\-comma\-tuple / R1707 \%<#\:trailing-comma-tuple>\(aq اضافه شد.
.sp
این پیام هنگامی صادر می‌شود که pylint یک چندتایی (tuple) تک‌عنصری را پیدا کند که با یک کامای سرگردان ایجاد شده است. این موضوع می‌تواند نشان‌دهندهٔ یک مشکل بالقوه در کد باشد و توصیه می‌شود برای تأکید بر ساخت تاپل، به جای تکیه بر خودِ کاما از پرانتز استفاده شود.
.IP \(bu 2
عدم صدور not\-callable / E1102 \%<#\:not-callable> برای نمونه‌هایی با کلاس‌های پایهٔ ناشناخته (unknown bases).
.sp
بسته شدن #1213
.IP \(bu 2
رفتار یکسان با آرگومان‌های فقط کلیدواژه‌ای (keyword-only) مشابه آرگومان‌های مکانی (positional) در بررسی unused\-argument / W0613 \%<#\:unused-argument>.
.IP \(bu 2
عدم تلاش برای دسترسی به متغیرهای تعریف‌شده در یک حوزهٔ دید جداگانه هنگام بررسی \fBprotected\-access\fP.
.IP \(bu 2
افزودن بررسی جدید برای تشخیص استفادهٔ نادرست از len(SEQUENCE) در شرط‌های ارزیابی.
.IP \(bu 2
افزودن افزونهٔ جدید برای تشخیص مقایسه‌ها با مقادیر ثابت رشته‌ای خالی.
.IP \(bu 2
افزودن افزونهٔ جدید برای تشخیص مقایسهٔ اعداد صحیح با صفر.
.IP \(bu 2
افزودن شرایط خطای جدید برای bad\-super\-call / E1003 \%<#\:bad-super-call>\(aq
.sp
اکنون مواردی نظیر \fBsuper(type(self), self)\fP و \fBsuper(self.__class__, self)\fP را که می‌توانند منجر به حلقهٔ بازگشتی در کلاس‌های مشتق‌شده شوند تشخیص می‌دهد.
.IP \(bu 2
متد PyLinter.should_analyze_file یک پارامتر اختیاری جدید به نام \fBis_argument\fP دارد.
.sp
بسته شدن #1079
.IP \(bu 2
افزودن راهنماهای ویژگی (attribute hints) برای اعضای ناموجود.
.sp
بسته شدن #1035
.IP \(bu 2
افزودن یک هشدار جدید، redefined\-argument\-from\-local / R1704 \%<#\:redefined-argument-from-local>\(aq
.sp
بسته شدن #649
.IP \(bu 2
پشتیبانی از یادداشت‌های درون‌خطی (inline comments) برای مقادیر جداشده با کاما در فایل پیکربندی.
.sp
بسته شدن #1024
.IP \(bu 2
پارامتر \fIscript\fP در epylint.py_run حذف شد.
.IP \(bu 2
ابزار epylint.py_run اکنون از \fBshell=False\fP برای اجرای فرایند زیرین استفاده می‌کند.
.sp
بسته شدن #441
.IP \(bu 2
افزودن یک هشدار جدید، useless\-super\-delegation / W0235 \%<#\:useless-super-delegation>\(aq
.sp
بسته شدن 839.
.IP \(bu 2
افزودن خطای جدید invalid\-metaclass / E1139 \%<#\:invalid-metaclass>\(aq، که زمانی صادر می‌شود که تشخیص داده شود یک کلاس از یک متارده (metaclass) نامناسب استفاده می‌کند.
.sp
بسته شدن #579
.IP \(bu 2
افزودن یک پیام بازآرایی (refactoring) جدید، literal\-comparison / R0123 \%<#\:literal-comparison>\(aq.
.sp
بسته شدن #786
.IP \(bu 2
بررسی arguments\-differ / W0221 \%<#\:arguments-differ> اکنون kwonlyargs و آرگومان‌های متغیر (variadics) را در نظر می‌گیرد.
.sp
بسته شدن #983
.IP \(bu 2
حذف \-\-optimized\-ast
.sp
رفع بخشی از #975
.IP \(bu 2
حذف گزینهٔ \-\-files\-output
.sp
رفع بخشی از #975
.IP \(bu 2
حذف pylint\-gui از بسته.
.IP \(bu 2
حذف گزارش‌گر HTML
.sp
رفع بخشی از #975.IP \(bu 2
گزینه ignored\-argument\-names اکنون برای نادیده گرفتن آرگومان‌ها در بررسی unused\-variable / W0612 \%<#\:unused-variable> استفاده می‌شود.
.sp
این گزینه پیش‌تر برای نادیده گرفتن آرگومان‌ها هنگام محاسبه تعداد صحیح آرگومان‌هایی که یک تابع باید داشته باشد به کار می‌رفت، اما برای مدیریت آرگومان‌ها در رابطه با بررسی unused\-variable / W0612 \%<#\:unused-variable>، به جای آن از dummy\-variables\-rgx استفاده می‌شد. اکنون، ignored\-argument\-names هم برای هدف اصلی خود و هم برای نادیده گرفتن آرگومان‌های منطبق در بررسی unused\-variable / W0612 \%<#\:unused-variable> استفاده می‌شود. این قابلیت، کنترل بهتری را بر آنچه باید نادیده گرفته شود و نحوه آن فراهم می‌کند.
همچنین، همین گزینه از بررسی‌کننده طرح (design) به بررسی‌کننده متغیرها (variables) منتقل شد، بدان معنا که این گزینه اکنون زیر بخش \fB[VARIABLES]\fP در فایل پیکربندی ظاهر می‌شود.
.sp
بسته شدن #862.
.IP \(bu 2
رفع یک مثبت کاذب برای آرگومان‌های متغیر کلیدواژه‌ای در رابطه با آرگومان‌های فقط‌کلیدواژه‌ای.
.sp
اگر یک آرگومان فقط‌کلیدواژه‌ای برای یک تابع ضروری بود، اما آن تابع با آرگومان‌های متغیر کلیدواژه‌ای (**kwargs) فراخوانی می‌شد، یک هشدار مثبت کاذب missing\-kwoa / E1125 \%<#\:missing-kwoa> صادر می‌شد که اکنون برطرف شده است.
.sp
بسته شدن #934.
.IP \(bu 2
رفع برخی موارد مثبت کاذب در آرگومان‌های متغیر با اندازه نامشخص.
.sp
بسته شدن #878.
.IP \(bu 2
افزودن یک افزونه جدید، check_docstring، برای بررسی شیوه‌نامه‌های PEP 257.
.sp
بسته شدن #868.
.IP \(bu 2
فایل‌های پیکربندی با نشانگرهای BOM اکنون قابل خواندن هستند.
.sp
بسته شدن #864.
.IP \(bu 2
تابع epylint.py_run با استفاده از .communicate() به جای .wait() بر روی فایل‌های بزرگ دچار فروپاشی نمی‌شود.
.sp
بسته شدن #599.
.IP \(bu 2
غیرفعال‌سازی پیش‌فرض گزارش‌ها و نمایش امتیاز ارزیابی به‌طور پیش‌فرض
.sp
گزارش‌ها به‌طور پیش‌فرض غیرفعال شدند تا تعامل میان ابزار و کاربران ساده‌تر شود. امتیاز همچنان به‌طور پیش‌فرض نمایش داده می‌شود، به عنوان راهی برای سنجش دقیق زمان افزایش یا کاهش آن بر اثر تغییرات اعمال‌شده در کد.
.sp
ارجاع به #746.
.IP \(bu 2
غیرفعال‌سازی پیام‌های دسته‌بندی اطلاعات به‌طور پیش‌فرض. این گامی در جهت معقول‌تر کردن pylint است.
.sp
ارجاع به #746.
.IP \(bu 2
شناسایی موارد بیشتری به عنوان تکرارپذیرهای نامناسب برای __slots__ با توجه به الگوی invalid\-slots / E0238 \%<#\:invalid-slots>.
.sp
بسته شدن #775.
.IP \(bu 2
رشته‌های تورفتگی خالی رد می‌شوند.
.IP \(bu 2
افزودن خطای جدید relative\-beyond\-top\-level / E0402 \%<#\:relative-beyond-top-level>\(aq، که هنگام تلاش برای درون‌ریزی نسبی فراتر از بسته سطح بالا صادر می‌شود.
.sp
بسته شدن #588.
.IP \(bu 2
افزودن هشدار جدید unsupported\-assignment\-operation / E1137 \%<#\:unsupported-assignment-operation>\(aq، که هنگام تلاش برای انتساب عنصر روی شیئی که فاقد این قابلیت است صادر می‌شود.
.sp
بسته شدن #591.
.IP \(bu 2
افزودن هشدار جدید unsupported\-delete\-operation / E1138 \%<#\:unsupported-delete-operation>\(aq، که هنگام تلاش برای حذف عنصر روی شیئی که فاقد این قابلیت است صادر می‌شود.
.sp
بسته شدن #592.
.IP \(bu 2
رفع مثبت کاذب redundant\-returns\-doc / W9008 \%<#\:redundant-returns-doc>\(aq، که زمانی رخ می‌داد که تابع مستندشده به جای \fIreturn\fP از \fIyield\fP استفاده می‌کرد\&.
.sp
بسته شدن #984.
.IP \(bu 2
رفع موارد مثبت کاذب \(aqmissing\-[raises|params|type]\-doc\(aq به دلیل عدم شناسایی مترادف‌های کلیدواژه‌ای پشتیبانی‌شده توسط Sphinx.
.IP \(bu 2
افزودن پیام بازآفرینی جدید، consider\-merging\-isinstance / R1701 \%<#\:consider-merging-isinstance>\(aq، که هرگاه تشخیص داده شود فراخوانی‌های متوالی isinstance می‌توانند در یکدیگر ادغام شوند صادر می‌شود.
.sp
بسته شدن #968.
.IP \(bu 2
رفع مثبت کاذب missing\-param\-doc / W9015 \%<#\:missing-param-doc>\(aq و missing\-type\-doc / W9016 \%<#\:missing-type-doc>\(aq، که زمانی رخ می‌داد که رشته مستندات یک کلاس از رشته جادویی \(aqFor the parameters, see\(aq استفاده می‌کرد اما رشته مستندات __init__ کلاس از آن استفاده نمی‌کرد، یا برعکس.
.IP \(bu 2
پیام \fBredefined\-outer\-name\fP اکنون در صورتی که متغیر هدف یک حلقه تودرتو همانند متغیر هدف در یک حلقه بیرونی باشد نیز صادر می‌شود.
.sp
بسته شدن #911.
.IP \(bu 2
افزودن استنتاج مناسب نوع استثنا برای missing\-raises\-doc / W9006 \%<#\:missing-raises-doc>\(aq.
.IP \(bu 2
افزودن کلاس استثنای InvalidMessageError برای جایگزینی assertها در pylint.utils.
.IP \(bu 2
اعتبارسنجی دقیق‌تر در MessagesStore.register_messages() به منظور جلوگیری از بازنویسی تصادفی یک پیام توسط پیامی دیگر.
.IP \(bu 2
استثناهای InvalidMessageError، UnknownMessage و EmptyReport به زیرپیمانه جدید pylint.exceptions منتقل شدند.
.IP \(bu 2
نام‌های UnknownMessage و EmptyReport به UnknownMessageError و EmptyReportError تغییر یافتند.
.IP \(bu 2
هشدارهای \(aqmissing\-returns\-type\-doc\(aq و \(aqmissing\-yields\-type\-doc\(aq هرکدام به دو هشدار تفکیک شدند \- \(aqmissing\-[return|yield]\-doc\(aq و \(aqmissing\-[return|yield]\-type\-doc\(aq.
.IP \(bu 2
افزودن پشتیبانی از epytext به افزونه docparams.
.sp
بسته شدن #1029.
.IP \(bu 2
پشتیبانی از داشتن افزایه‌هایی با نام یکسان و با گزینه‌های تعریف‌شده
.sp
بسته شدن #1018.
.IP \(bu 2
مرتب‌سازی گزینه‌های پیکربندی درون یک بخش
.sp
بسته شدن #1087.
.IP \(bu 2
افزودن هشدار جدید پایتون ۳ پیرامون پیاده‌سازی \(aq__div__\(aq، \(aq__idiv__\(aq، یا \(aq__rdiv__\(aq زیرا این متدها در پایتون ۳ منسوخ شده‌اند.
.IP \(bu 2
افزودن هشدار جدید، overlapping\-except / W0714 \%<#\:overlapping-except>\(aq، که هنگامی صادر می‌شود که دو استثنا در یک بند except یکسان نام مستعار یکدیگر باشند یا یکی از استثناها والد دیگری باشد.
.IP \(bu 2
جلوگیری از فروپاشی در رشته‌های بدقالب هنگام بررسی خطاهای قالب‌بندی رشته.
.IP \(bu 2
افزودن هشدار جدید پایتون ۳ برای فراخوانی \(aqstr.encode\(aq یا \(aqstr.decode\(aq با کدگذاری غیرمتنی.
.IP \(bu 2
افزودن پیام جدید شیوه‌نامه کدنویسی، single\-string\-used\-for\-slots / C0205 \%<#\:single-string-used-for-slots>\(aq.
.sp
بسته شدن #1166.
.IP \(bu 2
افزودن بررسی جدید پایتون ۳ برای دسترسی به \(aqsys.maxint\(aq که در پایتون ۳ به نفع \(aqsys.maxsize\(aq حذف شده بود.
.IP \(bu 2
افزودن بررسی جدید پایتون ۳ برای درون‌ریزی‌های نامعتبر.
.IP \(bu 2
افزودن بررسی جدید پایتون ۳ برای دسترسی به توابع منسوخ‌شده رشته.
.IP \(bu 2
عدم هشدار درباره آرگومان‌های استفاده‌نشده یا بازتعریف شدن تابع در پیاده‌سازی‌های ثبت‌شده singledispatch.
.sp
بسته شدن #1032 و #1034.
.IP \(bu 2
افزودن پیام بازآفرینی no\-else\-return / R1705 \%<#\:no-else-return>\(aq.
.IP \(bu 2
بهبود بررسی‌کننده unused\-variable / W0612 \%<#\:unused-variable> برای هشدار دادن درباره متغیرهای استفاده‌نشده در حوزه پیمانه.
.sp
بسته شدن #919.
.IP \(bu 2
صرف‌نظر کردن از پیمانه‌های درون‌ریزی‌شده با نام _ هنگام بررسی درون‌ریزی‌های استفاده‌نشده.
.sp
بسته شدن #1190.
.IP \(bu 2
بهبود رسیدگی به کلاس‌های پایتون ۳ با فراکلاس‌های تعریف‌شده در حوزه‌های تودرتو.
.sp
بسته شدن #1177.
.IP \(bu 2
افزودن پیام بازآفرینی consider\-using\-ternary / R1706 \%<#\:consider-using-ternary>\(aq.
.sp
بسته شدن #1204.
.IP \(bu 2
رفع اشکال برای مثبت کاذب logging\-format\-interpolation\(ga هنگامی که مشخصات قالب در رشته قالب‌بندی‌شده استفاده شده باشند.
.sp
بسته شدن #572..IP \(bu 2
کلید جدید \fBsingle\-line\-class\-stmt\fP برای مجاز کردن اعلان تک‌خطی بدنه‌های خالی کلاس اضافه شد.
.sp
بسته‌شدن #738
.IP \(bu 2
دسترسی به مشخصه‌های محافظت‌شده در قالب \fBtype(self)._attribute\fP اکنون مجاز است.
.sp
بسته‌شدن #1031
.IP \(bu 2
امکان ویرایش msg\-template توسط کاربر هنگام فراخوانی Pylint از طریق یک اسکریپت Python فراهم شد.
.sp
بسته‌شدن #1269
.IP \(bu 2
بررسی‌کننده واردات (Imports checker) از کلید جدید \fBallow\-wildcard\-with\-all\fP پشتیبانی می‌کند که در صورت تعریف متغیر \fB__all__\fP در ماژول واردشده، هشدار واردسازی عمومی (wildcard import) را غیرفعال می‌سازد.
.sp
بسته‌شدن #831
.IP \(bu 2
هشدارهای \fBtoo\-many\-format\-args\fP و \fBtoo\-few\-format\-args\fP هنگامی که از عبارات ستاره‌دار در تاپل سمت راست (RHS) استفاده می‌شود، به درستی صادر می‌شوند.
.sp
بسته‌شدن #957
.IP \(bu 2
بررسی‌کننده \fBcyclic\-import\fP از بندهای غیرفعال‌سازی محلی پشتیبانی می‌کند. هنگامی که یکی از واردات‌های چرخه‌ای در محدوده‌ای انجام شده باشد که بند غیرفعال‌سازی در آن فعال بوده است، چرخه به عنوان تخلف گزارش نمی‌شود.
.sp
بسته‌شدن #59
.UNINDENT
.SS تازه‌های Pylint 1.6
.sp
از آغاز pylint تا pylint 2.14.0 (شامل این نسخه)، ما گزارش تغییراتی داشتیم که شامل \fIتمام\fP تغییرات غیرجزئی در Pylint بود؛ از جمله تغییراتی که برای کاربر ملموس نبودند، یعنی تغییراتی که تنها در صورتی ممکن بود برایتان جالب باشند که توسعه‌دهنده‌ای شاغل روی pylint یا افزونه‌های pylint، یا یک تاریخ‌نگار نرم‌افزار متن‌باز باشید.
.sp
از pylint 1.6.0 تا 2.14.0، علاوه بر گزارش تغییرات کامل، خلاصه‌ای از تغییرات (عمدتاً کاربرمحور) نیز وجود داشت.
.sp
شماره‌های تیکت می‌توانند مربوط به سیستم داخلی logilab بوده یا از bitbucket آمده باشند.
.SS خلاصه \-\- نکات برجسته انتشار
.sp
مورد مهمی وجود ندارد.
.SS بررسی‌کننده‌های جدید
.INDENT 0.0
.IP \(bu 2
یک بررسی توصیه‌ای جدید با نام \fBconsider\-iterating\-dictionary\fP اضافه کردیم که هنگام پیمایش یک دیکشنری با استفاده از \fB\&.keys()\fP صادر می‌شود.
.sp
برای نمونه، کد زیر این هشدار را صادر می‌کند، زیرا کلیدهای دیکشنری را می‌توان بدون فراخوانی صریح این متد پیمایش کرد.
.INDENT 2.0
.INDENT 3.5
.sp
.EX
for key in dictionary.keys():
    ...

# Can be refactored to:
for key in dictionary:
    ...
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
بررسی \fBtrailing\-newlines\fP اضافه شد، که هنگام وجود خطوط خالی انتهایی در یک فایل صادر می‌شود.
.IP \(bu 2
بررسی \fBinvalid\-length\-returned\fP اضافه شد، که هنگامی صادر می‌شود که متد ویژه \fB__len__\fP مقداری غیر از یک عدد نامنفی بازگرداند. برای نمونه، این مثال آن را فعال می‌کند:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
class Container(object):
    def __len__(self):
        return self._items # Oups, forgot to call len() over it.
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
افزودن یک بررسی جدید به افزونه \fIcheck_docs\fP برای جستجوی پارامترهای تکراری سازنده (constructor) در docstring سازنده کلاس یا در docstring کلاس.
.sp
بررسی \fBmultiple\-constructor\-doc\fP زمانی صادر می‌شود که پارامتر در هر دو مکان مستندسازی شده باشد.
.IP \(bu 2
ما یک پلاگین افزونه جدید به نام \fBpylint.extensions.mccabe\fP اضافه کردیم که می‌تواند برای هشدار دادن درباره پیچیدگی در کد مورد استفاده قرار گیرد.
.sp
می‌توانید آن را به این صورت فعال کنید:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
$ pylint module_or_project \-\-load\-plugins=pylint.extensions.mccabe
.EE
.UNINDENT
.UNINDENT
.sp
اطلاعات بیشتر را در بررسی‌کننده Design ببینید: \%<#\:pylint-extensions-mccabe>
.UNINDENT.SS "ویژگی‌های جدید (New features)"
.INDENT 0.0
.IP \(bu 2
اکنون \fBgenerated\-members\fP از نام‌های واجد شرایط (qualified names) از طریق عبارات باقاعده پشتیبانی می‌کند.
.sp
برای نمونه، جهت نادیده‌گرفتن تمامی خطاهای تولیدشده توسط مشخصه‌های \fBnumpy.core\fP، اکنون می‌توانیم بنویسیم:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
$ pylint a.py \-\-generated\-members=numpy.*
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
افزوده شدن امکان نادیده‌گرفتن فایل‌ها بر اساس تطابق regex، با گزینه جدید \fB\-\-ignore\-patterns\fP\&.
.sp
به جای دستکاری گزینه موجود \fBignore\fP، تصمیم گرفتیم یک گزینه جداگانه برای آن داشته باشیم. برای نمونه، جهت نادیده‌گرفتن تمامی فایل‌های آزمون، اکنون می‌توانیم استفاده کنیم از:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
$ pylint myproject \-\-ignore\-patterns=test.*?py
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
ما یک گزینه جدید به نام \fBredefining\-builtins\-modules\fP اضافه کردیم که برای تعیین ماژول‌هایی به کار می‌رود که مجاز به بازتعریف عناصر توکار (builtins) هستند.
دستور \fIpylint\fP در صورت بازتعریف یک شناسه توکار، مانند تعریف متغیری به نام \fBnext\fP، خطا صادر خواهد کرد. اما در برخی موارد، عناصر توکار ممکن است در صورتی که از جاهایی غیر از ماژول \fBbuiltins\fP وارد شوند بازتعریف گردند، مانند ماژول \fBsix.moves\fP که شامل توابع سازگار با نسخه‌های جدیدتر است:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
$ cat a.py
# Oups, now pylint emits a redefined\-builtin message.
from six.moves import open
$ pylint a.py \-\-redefining\-builtins\-modules=six.moves
.EE
.UNINDENT
.UNINDENT
.sp
مقادیر پیش‌فرض: \fBsix.moves,future.builtins\fP
.UNINDENT
.SS "رفع باگ‌ها (Bug fixes)"
.INDENT 0.0
.IP \(bu 2
رفع باگی که در آن بالاترین نام یک واردسازی واجد شرایط (qualified import) به عنوان متغیر استفاده‌نشده شناسایی می‌شد.
.IP \(bu 2
اگر شیء نمایه‌گذاری‌شده دارای کلاس‌های پایه ناشناخته‌ای باشد که Pylint نتواند آن‌ها را استنتاج کند، دیگر هشدار \fBinvalid\-sequence\-index\fP صادر نمی‌شود.
.UNINDENT
.SS "سایر تغییرات (Other Changes)"
.INDENT 0.0
.IP \(bu 2
بررسی \fBbad\-builtin\fP به یک افزونه منتقل شد.
.sp
این بررسی به توابع توکارِ استفاده‌شده‌ای که نباید استفاده می‌شدند ایراد می‌گرفت. برای مثال، \fBmap\fP و \fBfilter\fP در این دسته قرار می‌گرفتند، زیرا جایگزین‌های بهتری مانند ساخت لیست (list comprehension) قابل استفاده هستند. اما این بررسی آزاردهنده بود، چرا که استفاده از \fBmap\fP یا \fBfilter\fP می‌تواند موارد کاربرد خاص خود را داشته باشد؛ از این رو تصمیم گرفتیم آن را به عنوان یک بررسی در قالب افزونه منتقل کنیم.
اکنون می‌توان آن را از طریق \fB\-\-load\-plugins=pylint.extensions.bad_builtin\fP فعال کرد.
.IP \(bu 2
ما به صورت داخلی از بک‌پورت \fBconfigparser\fP برای Python 2 استفاده می‌کنیم.
.sp
این کار امکان قرار دادن کامنت درون مقادیر فهرستی در فایل پیکربندی را فراهم می‌سازد، مانند:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
disable=no\-member,
        # Don\(aqt like this check
        bad\-indentation
.EE
.UNINDENT
.UNINDENT
.IP \(bu 2
ما اکنون به صورت داخلی از بسته isort در \%<https://\:pypi\:.org/\:project/\:isort> استفاده می‌کنیم.
.sp
این کار بررسی \fB\(gawrong\-import\-order\fP را بهبود می‌بخشد، بنابراین اکنون خطاهای مثبت کاذب کمتری در رابطه با ترتیب واردسازی‌ها خواهیم داشت.
.IP \(bu 2
به طور پیش‌فرض، برای بلوک‌های واردسازی جایگزین (fallback import blocks) دیگر خطاهای \fBimport\-error\fP یا \fBno\-name\-in\-module\fP صادر نمی‌شود.
.sp
یک بلوک واردسازی جایگزین را می‌توان یک بلوک TryExcept دانست که در هر دو شاخه آن دستورات import وجود دارد، مانند:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
try:
    import urllib.request as request
except ImportError:
    import urllib2 as request
.EE
.UNINDENT
.UNINDENT
.sp
در حالتی که \fBpylint\fP نتواند یک import را از شاخه \fBexcept\fP پیدا کند، خطای \fBimport\-error\fP صادر می‌کند؛ اما این موضوع هنگام تلاش برای نوشتن کدی سازگار با هر دو نسخه Python خسته‌کننده می‌شود. به همین دلیل، ما به طور پیش‌فرض این بلوک‌ها را بررسی نمی‌کنیم، اما می‌توان این تحلیل را با استفاده از پرچم جدید \fB\-\-analyse\-fallback\-block\fP اجباری کرد.
.IP \(bu 2
پیام \fBreimported\fP هنگامی صادر می‌شود که یک نام یکسان از ماژول دیگری مجدداً وارد شود، مانند:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
from collections import deque, OrderedDict, deque
.EE
.UNINDENT
.UNINDENT
.UNINDENT.SS قابلیت‌های منسوخ‌شده (Deprecated features)
.INDENT 0.0
.IP \(bu 2
پشتیبانی از HTML منسوخ شد و در نهایت در Pylint 1.7.0 حذف خواهد شد.
.sp
این قابلیت اخیراً در Pylint به یک ویژگی درجه‌دو تبدیل شده بود که اغلب نادیده گرفته می‌شد و چندین باگ داشت. از آنجا که اکنون گزارش‌گر JSON را در اختیار داریم، می‌توان از آن به عنوان پایه‌ای برای خروجی‌های HTML زیباتر از آنچه Pylint در حال حاضر ارائه می‌دهد استفاده کرد.
.IP \(bu 2
گزینهٔ \fB\-\-files\-output\fP منسوخ شده است و در نهایت در Pylint 1.7.0 حذف خواهد شد.
.IP \(bu 2
گزینهٔ \fB\-\-optimize\-ast\fP منسوخ شده است و در نهایت در Pylint 1.7.0 حذف خواهد شد.
.sp
این گزینه در ابتدا برای رسیدگی به موارد حاد (pathological cases) اضافه شده بود، مانند الحاق بیش از حد رشته‌ها با استفاده از عملگر جمع، که باعث می‌شد pylint هنگام تلاش برای تحلیل اینکه رشته چه بوده است با خطای بازگشتی (recursion error) مواجه شود. متأسفانه تصمیم گرفتیم از این موضوع صرف‌نظر کنیم، زیرا این مورد حاد هنگام تجزیه (parse) کد توسط خود پایتون نیز، بدون اینکه واقعاً به مرحلهٔ زمان اجرا برسد، رخ می‌داد؛ از این رو در آینده این گزینه را حذف خواهیم کرد.
.IP \(bu 2
افزونهٔ \fBcheck_docs\fP اکنون منسوخ شده است. این افزونه همچنان تحت نام \fBdocparams\fP در دسترس است، بنابراین دستور زیر کار خواهد کرد:
.INDENT 2.0
.INDENT 3.5
.sp
.EX
$ pylint module_or_package \-\-load\-extensions=pylint.extensions.docparams
.EE
.UNINDENT
.UNINDENT
.sp
نام قدیمی همچنان برای سازگاری با گذشته حفظ شده است، اما در نهایت حذف خواهد شد.
.UNINDENT
.SS قابلیت‌های حذف‌شده (Removed features)
.INDENT 0.0
.IP \(bu 2
هنوز موردی وجود ندارد
.UNINDENT
.SS گزارش کامل تغییرات (Full changelog)
.SS تازه‌های Pylint 1.6.3
.sp
تاریخ انتشار: 2016\-07\-18
.INDENT 0.0
.IP \(bu 2
عدم فروپاشی (crash) هنگام استنتاج انواع استثناهای غیرقابل‌استنتاج برای افزونهٔ docparams
.sp
بسته شد #998
.UNINDENT
.SS تازه‌های Pylint 1.6.2
.sp
تاریخ انتشار: 2016\-07\-15
.INDENT 0.0
.IP \(bu 2
عدم فروپاشی هنگام چاپ راهنمای گزینه‌هایی با عبارات باقاعدهٔ پیش‌فرض
.sp
بسته شد #990
.IP \(bu 2
نسخه‌های تفکیک‌شده‌تر و دقیق‌تر برای ماژول‌های منسوخ‌شده.
.sp
بسته شد #991
.UNINDENT
.SS تازه‌های Pylint 1.6.1
.sp
تاریخ انتشار: 2016\-07\-07
.INDENT 0.0
.IP \(bu 2
استفاده از نشانگرهای محیطی (environment markers) برای پشتیبانی از وابستگی‌های شرطی.
.UNINDENT
.SS تازه‌های Pylint 1.6.0
.sp
تاریخ انتشار: 2016\-07\-03
.INDENT 0.0
.IP \(bu 2
افزودن یک افزونهٔ جدید، \fBpylint.extensions.mccabe\fP، برای هشدار در مورد پیچیدگی کد.
.IP \(bu 2
منسوخ شدن پشتیبانی از \-\-optimize\-ast
.sp
برطرف‌سازی بخشی از #975
.IP \(bu 2
منسوخ شدن پشتیبانی از خروجی HTML
.sp
برطرف‌سازی بخشی از #975
.IP \(bu 2
منسوخ شدن پشتیبانی از \-\-output\-files
.sp
برطرف‌سازی بخشی از #975
.IP \(bu 2
رفع خطای مستندات در افزونهٔ check_docs.
.sp
بسته شد #735
.IP \(bu 2
امکان پیکربندی فهرست دکوراتورهای تعریف‌کنندهٔ property.
.IP \(bu 2
رفع باگی که در آن نام سطح بالایی یک واردسازی واجد شرایط (qualified import) به عنوان متغیر استفاده‌نشده شناسایی می‌شد.
.sp
بسته شد #923
.IP \(bu 2
بررسی bad\-builtin / W0141 \%<#\:bad-builtin> اکنون به یک افزونه تبدیل شده است.
.IP \(bu 2
پشتیبانی generated\-members از نام‌های واجد شرایط از طریق عبارات باقاعده.
.sp
برای نمونه، می‌توان یک عبارت باقاعده مانند \-\-generated\-members=astroid.node_classes.* را برای نادیده گرفتن تمام خطاهای no\-member / E1101 \%<#\:no-member> که مانند \fBastroid.node_classes.missing.object\fP\& فراخوانی می‌شوند تعیین کرد.
.IP \(bu 2
افزودن امکان نادیده گرفتن فایل‌ها بر اساس تطابق با عبارات باقاعده از طریق گزینهٔ جدید \fB\-\-ignore\-patterns\fP. امکان مشخص کردن چندین الگوی نادیده‌گیری فراهم شده است. به جای دستکاری گزینهٔ موجود ignore، گزینهٔ جدیدی به نام ignore\-patterns اضافه شد.
.sp
بسته شد #156
.IP \(bu 2
افزودن خطای جدید trailing\-newlines / C0305 \%<#\:trailing-newlines>، که هنگام وجود خطوط خالی اضافه در انتهای فایل صادر می‌شود.
.sp
بسته شد #682
.IP \(bu 2
افزودن یک گزینهٔ جدید، \(aqredefining\-builtins\-modules\(aq، برای کنترل ماژول‌هایی که مجاز به بازتعریف شناسه‌های داخلی (builtins) هستند، مانند six.moves و future.builtins.
.sp
بسته شد #464
.IP \(bu 2
خطای \(aqreimported\(aq زمانی صادر می‌شود که یک نام یکسان از ماژول متفاوتی وارد (import) شود.
.sp
بسته شد #162
.IP \(bu 2
افزودن یک بررسی‌کنندهٔ توصیه‌ای جدید، consider\-iterating\-dictionary / C0201 \%<#\:consider-iterating-dictionary>، که هنگام پیمایش دیکشنری از طریق .keys() صادر می‌شود.
.sp
بسته شد #699
.IP \(bu 2
استفاده از نسخهٔ backport شدهٔ configparser برای Python 2
.sp
این تغییر مشکلی را که با کامنت‌های داخل مقادیر وجود داشت حل می‌کند؛ این مشکل در configparser مربوط به Python 3 برطرف شده است.
.sp
بسته شد #828
.IP \(bu 2
افزودن یک خطای جدید، invalid\-length\-returned / E0303 \%<#\:invalid-length-returned>، هنگامی که متد خاص \fB__len__\fP مقداری به جز یک عدد نامنفی بازگرداند.
.sp
بسته شد #557
.IP \(bu 2
تغییر سازوکار داخلی به استفاده از isort برای wrong\-import\-order / C0411 \%<#\:wrong-import-order>\&.
.sp
بسته شد #879
.IP \(bu 2
افزونهٔ check_docs می‌تواند پارامترهای سازنده را در __init__ پیدا کند.
.sp
بسته شد #887
.IP \(bu 2
عدم هشدار دربارهٔ invalid\-sequence\-index / E1126 \%<#\:invalid-sequence-index> در صورتی که شیء شاخص‌گذاری‌شده کلاس‌های پایهٔ ناشناخته داشته باشد.
.sp
بسته شد #867
.IP \(bu 2
عدم فروپاشی هنگام بررسی super\-init\-not\-called / W0231 \%<#\:super-init-not-called> برای متدی که درون یک بلوک if تعریف شده است.
.IP \(bu 2
عدم صدور خطاهای import\-error / E0401 \%<#\:import-error> یا no\-name\-in\-module / E0611 \%<#\:no-name-in-module> برای بلوک‌های واردسازی جایگزین (fallback import blocks) به صورت پیش‌فرض.
.sp
تا پیش از این، در صورت یافتن یک بلوک واردسازی جایگزین (یک بلوک TryExcept که شامل واردسازی‌های مربوط به Python 2 و 3 بود) این هشدارها صادر می‌شدند، اما این موضوع هنگام نوشتن کدهای سازگار با هر دو نسخه دست‌وپاگیر است. به همین دلیل، ما به طور پیش‌فرض این بلوک‌ها را بررسی نمی‌کنیم، اما می‌توان با استفاده از پرچم جدید \fB\-\-analyse\-fallback\-block\fP تحلیل آن‌ها را الزامی کرد.
.sp
بسته شد #769.
.UNINDENT
.sp
شماره‌های تیکت معمولاً می‌توانند داخلیِ Logilab یا مربوط به Bitbucket باشند. در آخرین نسخه، این شماره‌ها شامل ایشوهای GitHub نیز می‌شوند..SS تازه‌های Pylint 1.5
.SS تازه‌های Pylint 1.5.5؟
.sp
تاریخ انتشار: 2016\-03\-21
.INDENT 0.0
.IP \(bu 2
اجازه فراخوانی visit_importfrom از بررسی‌کننده مهاجرت به Python 3 هنگامی که همه چیز غیرفعال است داده شد.
.sp
به دلیل اینکه متد visit الگوهایی را که انتظار می‌رفت فعال باشند فیلتر می‌کرد،
هنگامی که همه چیز به جز یک الگو غیرفعال بود اجرا نمی‌شد، که منجر به هشدارهای
مثبت کاذب نابجا می‌گردید.
.sp
حل مشکل #852
.IP \(bu 2
عدم صدور هشدار unsubscriptable\-value برای کلاس‌هایی با کلاس‌های
پایه ناشناخته.
.sp
حل مشکل #776.
.IP \(bu 2
استفاده از یک OrderedDict برای ذخیره عناصر پیکربندی
.sp
این کار مشکلی مربوط به ترتیب غیرقابل پیش‌بینی عناصر disable / enable
در فایل پیکربندی را برطرف می‌کند. در موارد خاصی، عبارت disable پیش از
enable قرار می‌گرفت که باعث می‌شد دسته‌هایی از خطاها فعال شوند، حتی اگر هدف
غیرفعال کردن آن‌ها بود. بهترین مثال برای این وضعیت، هنگام اجرای چندین
فرآیند رخ می‌داد که هر یک از آن‌ها تنظیمات فعال‌سازی / غیرفعال‌سازی متفاوتی داشتند و بر خروجی اثر می‌گذاشتند.
.sp
حل مشکل #815
.IP \(bu 2
عدم در نظر گرفتن مدیریت‌کننده‌های except خالی (bare) و عمومی (broad) به عنوان نادیده‌گیرنده NameError،
AttributeError و استثناهای مشابه، در زمینه بررسی‌کننده‌های مربوط به
این موارد.
.sp
حل مشکل #826
.UNINDENT
.SS تازه‌های Pylint 1.5.4؟
.sp
تاریخ انتشار: 2016\-01\-15
.INDENT 0.0
.IP \(bu 2
ادغام StringMethodChecker با StringFormatChecker. این کار نقصی را رفع می‌کند
که در آن غیرفعال کردن تمام پیام‌ها و تنها فعال کردن شمار اندکی از
پیام‌های StringFormatChecker منجر به عدم نمایش هیچ پیامی
می‌شد.
.IP \(bu 2
عدم اعمال unneeded\-not / C0113 \%<#\:unneeded-not> روی مجموعه‌ها (sets).
.UNINDENT
.SS تازه‌های Pylint 1.5.3؟
.sp
تاریخ انتشار: 2016\-01\-11
.INDENT 0.0
.IP \(bu 2
مدیریت الگوی import fallback با توجه به wrong\-import\-order / C0411 \%<#\:wrong-import-order>\&.
.sp
حل مشکل #750
.IP \(bu 2
تفکیک نمایش گزارش‌ها از نمایش پیام‌ها
.sp
برخی گزارش‌دهنده‌ها (reporters) به جای نمایش پیام‌ها به محض در دسترس بودن،
آن‌ها را تجمیع می‌کنند. نمایش واقعی پیام‌ها در generate_reports تداخل یافته
بود. متأسفانه این رفتار ناپایدار بود و در مورد گزارش‌دهنده JSON، اگر
یک فایل دارای خطای نحوی (syntax) بود یا یافت نمی‌شد، پیام‌ها اصلاً
نمایش داده نمی‌شدند.
برای برطرف کردن این موضوع، پیام‌های تجمیع‌شده اکنون می‌توانند با
Reporter.display_message نمایش داده شوند، در حالی که گزارش‌ها با
display_reports نمایش می‌یابند.
.sp
حل مشکل #766
حل مشکل #765
.IP \(bu 2
نادیده گرفتن فراخوانی‌های تابع با آرگومان‌های متغیر (variadic) بدون زمینه (context).
.sp
استنتاج آرگومان‌های مکانی متغیر و آرگومان‌های کلیدواژه‌ای
منجر به تولید Tuples و Dicts خالی می‌شود، که می‌تواند در
برخی موارد به هشدارهای مثبت کاذب در رابطه با no\-value\-for\-parameter / E1120 \%<#\:no-value-for-parameter>\& بیانجامد.
برای جلوگیری از این امر، تا زمانی که پشتیبانی از انتشار زمینه فراخوانی (call context propagation)
فراهم شود، در صورت شناسایی چنین مواردی آن‌ها را نادیده می‌گیریم.
.sp
حل مشکل #722
.IP \(bu 2
رفتار با گره‌های AsyncFunctionDef مشابه گره‌های FunctionDef،
از طریق پیاده‌سازی visit_asyncfunctiondef بر مبنای
visit_functiondef.
.sp
حل مشکل #767
.IP \(bu 2
در نظر گرفتن kwonlyargs هنگام بررسی تعریف شدن آرگومان‌ها
توسط افزونه check_docs.
.sp
حل مشکل #745
.IP \(bu 2
توقف گزارش‌دهی unneeded\-not / C0113 \%<#\:unneeded-not> درون متدهای \fB__ne__\fP
.sp
حل مشکل #749
.UNINDENT.SS چه مواردی در Pylint 1.5.2 جدید است؟
.sp
تاریخ انتشار: 2015\-12\-21
.INDENT 0.0
.IP \(bu 2
عدم توقف غیرمنتظره (crash) در صورت نصب نبودن graphviz، و در عوض صدور یک هشدار برای آگاه کردن کاربر.
.sp
بسته شدن #168
.IP \(bu 2
پذیرش صرفاً توابع و متدها برای بررسی‌کننده deprecated\-method / W4902 \%<#\:deprecated-method>\&.
.sp
این امر از توقف غیرمنتظره‌ای که ممکن است هنگام نداشتن متد \&.qname() توسط یک شیء پس از استنتاج رخ دهد، جلوگیری می‌کند.
.IP \(bu 2
عدم صدور super\-on\-old\-class روی کلاس‌هایی با کلاس‌های پایه ناشناخته.
.sp
بسته شدن #721
.IP \(bu 2
مجاز بودن دستورها در بلوک‌های \fBif\fP یا \fBtry\fP حاوی واردسازی‌ها (imports).
.sp
بسته شدن #714
.UNINDENT
.SS چه مواردی در Pylint 1.5.1 جدید است؟
.sp
تاریخ انتشار: 2015\-12\-02
.INDENT 0.0
.IP \(bu 2
رفع توقف غیرمنتظره‌ای که هنگام مواجهه با متدهای قدیمی visit در ماژول‌های افزایه (plugin) رخ می‌داد.
.sp
بسته شدن #711
.IP \(bu 2
افزودن wrong\-import\-position / C0413 \%<#\:wrong-import-position> به آرگومان‌های دکوراتور check_messages برای ImportChecker.leave_module
این تغییر یک باگ نامتعارف را برطرف می‌کند که هنگام غیرفعال بودن ungrouped\-imports / C0412 \%<#\:ungrouped-imports> و wrong\-import\-order / C0411 \%<#\:wrong-import-order> در زمان اجرای pylint روی چندین فایل رخ می‌داد.
آنچه رخ می‌دهد این است که بدون وجود wrong\-import\-position / C0413 \%<#\:wrong-import-position> در check_messages، متد leave_module هرگز فراخوانی نمی‌شود؛ این بدان معناست که نخستین گرهٔ غیر\-import از فایل‌های دیگر ممکن است به فایل جاری نشت کند و منجر به صدور نادرست wrong\-import\-position / C0413 \%<#\:wrong-import-position> توسط pylint شود.
.IP \(bu 2
رفع توقف غیرمنتظره‌ای که هنگام مواجهه با متدهای قدیمی visit در ماژول‌های افزایه رخ می‌داد.
.sp
بسته شدن #711
.IP \(bu 2
عدم صدور import\-self / W0406 \%<#\:import-self> و cyclic\-import / R0401 \%<#\:cyclic-import> برای واردسازی‌های نسبی ماژول‌هایی با نام یکسان با خود بسته.
.sp
بسته شدن #708
بسته شدن #706.
.UNINDENT
.SS چه مواردی در Pylint 1.5.0 جدید است؟
.sp
تاریخ انتشار: 2015\-11\-29
.INDENT 0.0
.IP \(bu 2
افزودن چندین هشدار مربوط به واردسازی‌ها. هشدار wrong\-import\-order / C0411 \%<#\:wrong-import-order> زمانی صادر می‌شود که توصیه‌های PEP 8 در رابطه با واردسازی‌ها رعایت نشوند (بدین صورت که واردسازی‌های استاندارد باید ابتدا بیایند و سپس واردسازی‌های شخص ثالث و در انتها واردسازی‌های محلی). هشدار ungrouped\-imports / C0412 \%<#\:ungrouped-imports> زمانی صادر می‌شود که واردسازی‌های مربوط به یک بسته یا ماژول یکسان در کنار یکدیگر قرار نگرفته و در کد پراکنده باشند. هشدار wrong\-import\-position / C0413 \%<#\:wrong-import-position> زمانی صادر می‌شود که کد با واردسازی‌ها ترکیب شده باشد؛ توصیه می‌شود که واردسازی‌ها در بالای فایل قرار گیرند تا خوانندهٔ انسانی راحت‌تر متوجه وابستگی‌های یک ماژول شود.
.sp
بسته شدن #692
.IP \(bu 2
افزودن هشدار بازآرایی (refactoring) جدید، unneeded\-not / C0113 \%<#\:unneeded-not>، که زمانی صادر می‌شود که یک عبارت با عملگر not قابل ساده‌سازی باشد.
.sp
بسته شدن #670
.IP \(bu 2
افزودن هشدار بازآرایی جدید، simplifiable\-if\-statement / R1703 \%<#\:simplifiable-if-statement>، که زمانی استفاده می‌شود که بتوان یک دستور if را به ارزیابی بولی شرط آن تقلیل داد.
.sp
بسته شدن #698
.IP \(bu 2
افزودن هشدار بازآرایی جدید، too\-many\-boolean\-expressions / R0916 \%<#\:too-many-boolean-expressions>، که زمانی استفاده می‌شود که یک دستور if شامل تعداد بیش از حدی از عبارات بولی باشد که نگه‌داری کد را تضعیف کرده و درک آن را دشوارتر می‌سازد.
.sp
بسته شدن #677
.IP \(bu 2
متدهای ویژگی (property methods) در نمودارهای کلاس pyreverse به‌جای تابع به‌صورت صفت (attribute) نمایش داده می‌شوند.
.sp
بسته شدن #284
.IP \(bu 2
افزودن خطای بازآرایی جدید، too\-many\-nested\-blocks / R1702 \%<#\:too-many-nested-blocks>، که زمانی صادر می‌شود که یک تابع یا متد دارای تعداد بیش از حدی از بلوک‌های تودرتو باشد که خوانایی کد را کاهش داده و فهم آن را دشوارتر می‌سازد.
.sp
بسته شدن #668
.IP \(bu 2
افزودن خطای جدید، unsubscriptable\-object / E1136 \%<#\:unsubscriptable-object>، که زمانی صادر می‌شود که مقدار استفاده‌شده در عبارت اندیس‌گذاری (subscription) از قابلیت اندیس‌گذاری پشتیبانی نکند (یعنی متد __getitem__ را تعریف نکرده باشد).
.IP \(bu 2
عدم هشدار دربارهٔ کلاس‌های انتزاعی که نمونه‌سازی آن‌ها درون بدنهٔ خودشان انجام گرفته است.
.sp
بسته شدن #627
.IP \(bu 2
گزینه‌های منسوخ‌شده به‌طور پیش‌فرض در فایل پیکربندی تولیدشده قرار نمی‌گیرند.
.sp
بسته شدن #632
.IP \(bu 2
بررسی‌کننده non\-iterator\-returned / E0301 \%<#\:non-iterator-returned> می‌تواند کلاس‌هایی با فراماده‌های تکرارکننده (iterator\-metaclasses) را تشخیص دهد.
.sp
بسته شدن #679
.IP \(bu 2
افزودن خطای جدید، unsupported\-membership\-test / E1135 \%<#\:unsupported-membership-test>، که زمانی صادر می‌شود که مقدار سمت راست عملگر \(aqin\(aq از پروتکل آزمون عضویت پشتیبانی نکند (یعنی __contains__/__iter__/__getitem__ را تعریف نکرده باشد).
.IP \(bu 2
افزودن خطاهای جدید: not\-an\-iterable / E1133 \%<#\:not-an-iterable> که زمانی صادر می‌شود که یک مقدار غیرقابل‌پیمایش در زمینه‌ای نیازمند پیمایش (مانند starargs، دستور for، عبارات جامع (comprehensions) و غیره) استفاده شود، و not\-a\-mapping / E1134 \%<#\:not-a-mapping> که زمانی صادر می‌شود که یک مقدار غیرنگاشت در یک زمینهٔ نگاشتی به کار رود.
.sp
بسته شدن #563
.IP \(bu 2
عدم صدور هشدار توسط بررسی‌کننده no\-self\-use / R6301 \%<#\:no-self-use> در صورتی که فراخوانی \(aqsuper()\(aq درون متد وجود داشته باشد.
.sp
بسته شدن #667
.IP \(bu 2
افزودن بررسی‌کننده جهت شناسایی چندین واردسازی در یک خط.
.sp
بسته شدن #598
.IP \(bu 2
رفع مثبت کاذب (false positive) برای unused\-argument / W0613 \%<#\:unused-argument> هنگامی که از عملگر \(dq+=\(dq استفاده می‌شود.
.sp
بسته شدن #518
.IP \(bu 2
عدم صدور import\-error / E0401 \%<#\:import-error> برای ماژول‌های نادیده‌گرفته‌شده. PyLint برای هر واردسازی که خود یک ماژول در فهرست ignored\-modules بوده یا زیربسته‌ای از آن باشد، خطای واردسازی صادر نخواهد کرد.
.sp
بسته شدن #223
.IP \(bu 2
رفع مثبت کاذب unused\-import / W0611 \%<#\:unused-import> هنگامی که واردسازی در یک انتساب کلاس استفاده شده باشد.
.sp
بسته شدن #475
.IP \(bu 2
افزودن خطای جدید، not\-context\-manager / E1129 \%<#\:not-context-manager>، که زمانی صادر می‌شود که چیزی که متدهای __enter__ و __exit__ را پیاده‌سازی نکرده است در یک دستور with به کار رود.
.IP \(bu 2
افزودن هشدار جدید، confusing\-with\-statement / W0124 \%<#\:confusing-with-statement>، صادرشده توسط بررسی‌کننده پایه، زمانی که یک دستور with با ظاهر مبهم به کار رود.
برای مثال \fIwith open() as first, second\fP که شبیه یک انتساب تاپل به نظر می‌رسد اما در واقع ۲ مدیر زمینه (context manager) است.
.IP \(bu 2
افزودن هشدار جدید، duplicate\-except / W0705 \%<#\:duplicate-except>، که زمانی صادر می‌شود که یک مدیریت‌کنندهٔ استثنا، نوعی از استثنا را مدیریت کند که پیش‌تر مدیریت شده است.
.sp
بسته شدن #485
.IP \(bu 2
چندین هشدار به خطا ارتقا یافتند، چرا که می‌توانستند اشکالات بالقوه در کد را آشکار سازند. این هشدارها عبارتند از: assignment\-from\-none / E1128 \%<#\:assignment-from-none>،
unbalanced\-tuple\-unpacking / W0632 \%<#\:unbalanced-tuple-unpacking>، unpacking\-non\-sequence / E0633 \%<#\:unpacking-non-sequence>، non\-iterator\-returned / E0301 \%<#\:non-iterator-returned>\&.
.sp
بسته شدن #388
.IP \(bu 2
امکان پایان دادن به کنترل pragma با یک نقطه‌ویرگول. به این ترتیب، کاربران می‌توانند کنترل pragma را با ذکر دلیلی برای چرایی استفاده از آن ادامه دهند، مانند \fI# pylint: disable=old\-style\-class;reason=...\fP\&.
.sp
بسته شدن #449
.IP \(bu 2
اکنون می‌توان \-\-jobs را به همراه \-\-load\-plugins استفاده کرد.
.sp
بسته شدن #456
.UNINDENT.IP \(bu 2
بهبود عملکرد \-\-jobs هنگام کار صرفاً با نام یک بسته.
.sp
بسته شدن #479
.IP \(bu 2
عدم صدور unused\-wildcard\-import / W0614 \%<#\:unused-wildcard-import> هنگامی که نام واردشده از پودمان دیگری می‌آید و در واقع یک نام __future__ است.
.IP \(bu 2
گزارش‌گر رنگی اکنون روی Windows کار می‌کند.
.sp
بسته شدن #96.
.IP \(bu 2
حذف هشدار pointless\-except. این هشدار پیش‌تر به‌طور پیش‌فرض غیرفعال بود و چندان کاربردی نداشت.
.sp
بسته شدن #506.
.IP \(bu 2
رفع یک فروپاشی در Python 3 مربوط به بازبین رشته، که هنگام مواجهه با یک رشتهٔ bytes همراه با فراخوانی متد .format متوقف می‌شد.
.IP \(bu 2
عدم هشدار دربارهٔ no\-self\-use / R6301 \%<#\:no-self-use> برای ویژگی‌های توکار (builtin).
.IP \(bu 2
رفع مثبت کاذب برای bad\-reversed\-sequence / E0111 \%<#\:bad-reversed-sequence>، هنگامی که یک زیرکلاس از \fBdict\fP متد __reversed__ را ارائه می‌دهد.
.IP \(bu 2
تغییر مقدار پیش‌فرض no\-docstring\-rgx به‌طوری که missing\-docstring / C0111 \%<#\:missing-docstring> برای توابع خصوصی صادر نشود.
.IP \(bu 2
عدم صدور redefined\-outer\-name / W0621 \%<#\:redefined-outer-name> برای دستورالعمل‌های __future__.
.sp
بسته شدن #520.
.IP \(bu 2
ارائهٔ چند راهنمایی برای پیام bad\-builtin / W0141 \%<#\:bad-builtin>\&.
.sp
بسته شدن #522.
.IP \(bu 2
هنگام بررسی آرگومان‌های نامعتبر برای یک شیء قابل‌فراخوانی در typecheck.py، در صورتی که __new__ یافت‌شده از توکارها (builtins) باشد، متد __init__ جستجو می‌شود.
.sp
از آنجا که __new__ از توکارها می‌آید، اطلاعاتی دربارهٔ پارامترهای مورد انتظار خود ضمیمه نخواهد داشت، بنابراین این بررسی بی‌فایده خواهد بود. بازیابی __init__ در این حالت دست‌کم چند منفی کاذب را تشخیص خواهد داد.
.sp
بسته شدن #429.
.IP \(bu 2
عدم صدور no\-member / E1101 \%<#\:no-member> برای کلاس‌هایی با پایه‌های ناشناخته.
.sp
از آنجا که مشخص نیست آن پایه‌ها چه مواردی را ممکن است اضافه کنند، به‌سادگی در این حالت از خطا چشم‌پوشی می‌شود.
.IP \(bu 2
جستجو در فراکلاس ضمنی هنگام بررسی no\-member / E1101 \%<#\:no-member>، در صورتی که کلاس مورد نظر دارای فراکلاس ضمنی باشد؛ که این امر برای کلاس‌های سبک جدید (new style classes) برقرار است.
.sp
بسته شدن #438.
.IP \(bu 2
افزودن دو هشدار جدید، duplicate\-bases / E0241 \%<#\:duplicate-bases> و inconsistent\-mro / E0240 \%<#\:inconsistent-mro>\&.
.sp
هشدار duplicate\-bases / E0241 \%<#\:duplicate-bases> زمانی صادر می‌شود که یک کلاس پایه‌های یکسانی را بیش از یک بار در تعریف پایه‌های خود آورده باشد، در حالی که inconsistent\-mro / E0240 \%<#\:inconsistent-mro> زمانی صادر می‌شود که هیچ سلسله‌مراتب mro معقولی قابل تعیین نباشد.
.sp
بسته شدن #526.
.IP \(bu 2
حذف هشدار interface\-not\-implemented.
.sp
بسته شدن #532.
.IP \(bu 2
حذف سایر بررسی‌های واسط: interface\-is\-not\-class،‏ missing\-interface\-method و unresolved\-interface. دلیل این امر آن است که بهتر است به‌جای دوران قدیمی واسط‌های Zope، استفاده از ABCها توصیه شود. یکی از اثرات جانبی این تغییر این است که ignore\-iface\-methods به یک عملیات بی‌اثر (noop) تبدیل شده، منسوخ گردیده و در آینده حذف خواهد شد.
.IP \(bu 2
صدور هشدار منسوخ‌شدگی مناسب برای reporters.BaseReporter.add_message.
.sp
روش جایگزین، استفاده از handle_message است. متد add_message در Pylint 1.6 حذف خواهد شد.
.IP \(bu 2
افزودن پودمان جدید \(aqextensions\(aq برای بازبین‌های اختیاری به‌همراه دایرکتوری آزمون \(aqtest/extensions\(aq و فایل مستندات \(aqdoc/extensions.rst\(aq.
.IP \(bu 2
افزودن بازبین جدید \(aqextensions.check_docs\(aq که مستندسازی پارامترها را در سبک‌های Sphinx،‏ Google و Numpy بررسی می‌کند.
.IP \(bu 2
تشخیص موارد متغیر تعریف‌نشده، در جایی که \(dqتعریف\(dq متغیر تعریف‌نشده در یک عبارت del بوده است. اکنون به‌جای صدور used\-before\-assignment / E0601 \%<#\:used-before-assignment> که کاملاً گمراه‌کننده است، undefined\-variable / E0602 \%<#\:undefined-variable> صادر می‌شود.
.sp
بسته شدن #528.
.IP \(bu 2
عدم صدور attribute\-defined\-outside\-init / W0201 \%<#\:attribute-defined-outside-init> و access\-member\-before\-definition / E0203 \%<#\:access-member-before-definition> برای کلاس‌های mixin. خطاهای واقعی می‌توانند در کلاس‌های mixin رخ دهند، اما این موضوع توسط گزینهٔ ignore\-mixin\-members کنترل می‌شود.
.sp
بسته شدن #412.
.IP \(bu 2
بهبود تشخیص متغیرهای تعریف‌نشده و متغیرهای استفاده‌شده پیش از انتساب، برای متغیرهایی که به‌عنوان آرگومان‌های پیش‌فرض تابع به کار رفته‌اند، در حالی که متغیر نخستین بار در حوزهٔ کلاس تعریف شده است.
.sp
بسته شدن #342 و شمارهٔ #404.
.IP \(bu 2
افزودن یک هشدار جدید، unexpected\-special\-method\-signature / E0302 \%<#\:unexpected-special-method-signature>، که زمانی صادر می‌شود که یک متد خاص (dunder method) امضای مورد انتظار را نداشته باشد، که این موضوع می‌تواند منجر به خطاهای واقعی در کد برنامه شود.
.sp
بسته شدن #253.
.IP \(bu 2
حذف bad\-context\-manager / E0235 \%<#\:bad-context-manager> به دلیل گنجانده شدن unexpected\-special\-method\-signature / E0302 \%<#\:unexpected-special-method-signature>\&.
.IP \(bu 2
عدم صدور no\-name\-in\-module / E0611 \%<#\:no-name-in-module> در صورتی که وارد کردن توسط یک بند ImportError،‏ Exception یا یک عبارت except خالی محافظت شده باشد.
.IP \(bu 2
عدم صدور no\-member / E1101 \%<#\:no-member> اگر گره دسترسی به ویژگی توسط یک گردانندهٔ except که AttributeError یا Exception را مدیریت می‌کند یا یک except خالی است، محافظت شده باشد.
.IP \(bu 2
عدم صدور import\-error / E0401 \%<#\:import-error> در صورتی که وارد کردن توسط یک بند ImportError،‏ Exception یا یک عبارت except خالی محافظت شده باشد.
.IP \(bu 2
عدم صدور undefined\-variable / E0602 \%<#\:undefined-variable> اگر گره توسط یک بند NameError،‏ Exception یا عبارت except خالی محافظت شده باشد.
.IP \(bu 2
افزودن هشدار جدید، using\-constant\-test / W0125 \%<#\:using-constant-test>، که زمانی صادر می‌شود که یک عبارت شرطی (If, IfExp) از شرطی استفاده کند که همواره ثابت است؛ مانند اعداد، کلاس‌ها، توابع و غیره. این مورد به احتمال زیاد خطایی از جانب کاربر است.
.sp
بسته شدن #524.
.IP \(bu 2
عدم صدور raising\-non\-exception / E0710 \%<#\:raising-non-exception> زمانی که استثنا دارای پایه‌های ناشناخته است. پایه‌های واقعی آن مشخص نیستند و بهتر است فرض شود کاربر می‌داند چه می‌کند، تا اینکه پیامی صادر شود که ممکن است مثبت کاذب تلقی گردد.
.IP \(bu 2
جستجو برای فایل پیکربندی .pylintrc در پوشهٔ جاری در صورتی که pylintrc یافت نشود. برخلاف pylintrc، فایل‌های نقطه‌دار pylintrc در پوشه‌های والد پوشهٔ جاری جستجو نخواهند شد.
.IP \(bu 2
افزودن خطای جدید \(aqinvalid\-unary\-type\-operand\(aq، که زمانی صادر می‌شود که یک عملوند یکانی روی چیزی به کار رود که از آن عملیات پشتیبانی نمی‌کند (به‌عنوان مثال، استفاده از عملگر وارون‌سازی بیتی یکانی روی نمونه‌ای که __invert__ را پیاده‌سازی نکرده است).
.IP \(bu 2
در نظر گرفتن تفاوت‌های میان آرگومان‌های انواع مختلف توابع (classmethods،‏ staticmethods و properties) هنگام بررسی \fBarguments\-differ\fP\&.
.sp
بسته شدن #548.
.IP \(bu 2
بخش astroid.inspector به pylint.pyreverse منتقل شد، چرا که به آنجا تعلق دارد و نیازی به حضور آن در astroid نیست.
.IP \(bu 2
بخش astroid.utils.LocalsVisitor به pylint.pyreverse.LocalsVisitor منتقل شد.
.IP \(bu 2
تابع pylint.checkers.utils.excepts_import_error حذف شد. به‌جای آن از pylint.checkers.utils.error_of_type استفاده کنید.
.IP \(bu 2
عدم صدور undefined\-all\-variables برای گره‌هایی که قابل استنتاج نیستند (گره‌های YES).
.IP \(bu 2
پیام yield\-outside\-func برای \fByield from\fP نیز صادر می‌شود.
.IP \(bu 2
افزودن خطای جدید، too\-many\-star\-expressions / E0112 \%<#\:too-many-star-expressions>، که زمانی صادر می‌شود که بیش از یک عبارت ستاره‌دار (\fI*x\fP) در یک انتساب وجود داشته باشد. این هشدار تنها در Python 3 صادر می‌شود.
.IP \(bu 2
افزودن خطای جدید، invalid\-star\-assignment\-target / E0113 \%<#\:invalid-star-assignment-target>، که زمانی صادر می‌شود که یک عبارت ستاره‌دار (\fI*x\fP) به‌عنوان سمت چپ یک انتساب استفاده شود؛ مانند \fI*x = [1, 2]\fP\&. هرچند این مورد در Python 3 یک SyntaxError نیست.
.IP \(bu 2
تشخیص چند شیء که نمی‌توانند کلاس پایه باشند (bool،‏ slice،‏ range و memoryview که تا پیش از این تشخیص داده نمی‌شدند).
.IP \(bu 2
افزودن یک خطای جدید برای بازبین مهاجرت به Python 3، به نام \fBimport\-star\-module\-level\fP، که زمانی استفاده می‌شود که یک وارد کردن ستاره‌ای در حوزه‌ای غیر از سطح پودمان تشخیص داده شود؛ موردی که در Python 3 خطا محسوب می‌شود. استفاده از این حالت در Python 2 یک SyntaxWarning صادر خواهد کرد..IP \(bu 2
افزودن خطای جدید star\-needs\-assignment\-target / E0114 \%<#\:star-needs-assignment-target>، که در Python 3 هنگامی
صادر می‌شود که یک عبارت ستاره‌دار (\fI*x\fP) در مقصد انتساب استفاده نشده باشد. این خطا هنگام
تجزیهٔ AST در Python 3 تشخیص داده نمی‌شود، بنابراین نیازمند یک بررسی جداگانه است.
.IP \(bu 2
افزودن خطای جدید unsupported\-binary\-operation / E1131 \%<#\:unsupported-binary-operation>، که هنگامی صادر می‌شود
که یک عملیات محاسباتی دودویی بین دو شیء که از آن پشتیبانی نمی‌کنند
اجرا شود (برای مثال جمع یک عدد با یک رشته).
این خطا در حال حاضر غیرفعال است، چرا که موارد مثبت کاذب بسیار زیادی
تولید می‌کند، اما در اسرع وقت دوباره فعال خواهد شد.
.IP \(bu 2
قابلیت‌های جدید وارد شده از astroid به pyreverse: pyreverse.inspector.Project،‏
pyreverse.inspector.project_from_files و pyreverse.inspector.interfaces.
.sp
این موارد به دلیل عدم تعلق به astroid منتقل شدند.
.IP \(bu 2
فعال‌سازی misplaced\-future / W0410 \%<#\:misplaced-future> برای Python 3.
.sp
بسته شدن #580.
.IP \(bu 2
افزودن خطای جدید nonlocal\-and\-global / E0115 \%<#\:nonlocal-and-global>، که هنگامی صادر می‌شود که یک
نام در یک حوزهٔ یکسان، هم nonlocal و هم global تعریف شده باشد.
.sp
بسته شدن #581.
.IP \(bu 2
گزینهٔ ignored\-classes می‌تواند با نام‌های واجد شرایط (qualified names) کار کند (ignored\-classes=optparse.Values)
.sp
بسته شدن #297
.IP \(bu 2
گزینهٔ ignored\-modules علاوه بر تطبیق الگوی یونیکس برای نادیده‌گرفتن
بازگشتی، می‌تواند با نام‌های واجد شرایط نیز کار کند.
.sp
بسته شدن #244
.IP \(bu 2
بهبود تشخیص درون‌ریزی‌های نسبی در غیربسته‌ها (non\-packages)، و همچنین درون‌ریزی
ماژول‌های ناموجود با یک درون‌ریزی نسبی از یک بسته.
.IP \(bu 2
اگر تمام کلاس‌های پایهٔ یک کلاس مشخص نباشند، no\-init صادر نشود.
.sp
بسته شدن #604.
.IP \(bu 2
گزینهٔ \-\-no\-space\-check مقدار \fBempty\-line\fP را به عنوان یک گزینهٔ ممکن می‌پذیرد.
.sp
بسته شدن #541.
.IP \(bu 2
گزینهٔ \-\-generate\-rcfile به‌طور پیش‌فرض نمادهای خوانا برای انسان را برای
گزینهٔ \-\-disable تولید می‌کند.
.sp
بسته شدن #608.
.IP \(bu 2
بهبود بررسی‌کنندهٔ not\-in\-loop / E0103 \%<#\:not-in-loop> برای تشخیص صحیح موارد بیشتر.
.IP \(bu 2
افزودن خطای جدید continue\-in\-finally / W0136 \%<#\:continue-in-finally>، که هنگامی صادر
می‌شود که کلیدواژهٔ \fBcontinue\fP درون عبارت \fBfinally\fP یافت شود، که
یک SyntaxError است.
.IP \(bu 2
پرچم \-\-zope منسوخ شده و برای حذف در Pylint 1.6
برنامه‌ریزی شده است.
.sp
دلیل این حذف این است که این یک پرچم تخصصی بوده و برای مشکل اصلی
راه‌حل‌هایی وجود دارد:
استفاده از \-\-generated\-members همراه با اعضایی که هنگام استفاده از Zope
مشکل‌ساز می‌شوند، یا افزودن تبدیلات AST متناسب با پروژهٔ zope.
.sp
هم‌زمان، \-\-include\-ids و \-\-symbols نیز در Pylint 1.6
حذف خواهند شد.
.sp
بسته شدن #570.
.IP \(bu 2
پیام missing\-module\-attribute حذف شد و گزینهٔ خط فرمانی
متناظر با آن یعنی required\-attributes، برای حذف در Pylint 1.6
برنامه‌ریزی شده است.
.IP \(bu 2
پیام missing\-reversed\-argument حذف شد.
.sp
دلیل این امر آن است که این نوع خطاها باید توسط بررسی‌کنندهٔ نوع برای
\fIهمهٔ\fP توابع توکار (builtins) تشخیص داده شوند، نه به عنوان یک مورد خاص
برای تابع توکار reversed. این قابلیت به‌زودی در آینده فراهم خواهد شد.
.IP \(bu 2
پرچم \-\-comment منسوخ است و در Pylint 1.6 حذف خواهد شد.
.IP \(bu 2
پرچم \-\-profile منسوخ است و در Pylint 1.6 حذف خواهد شد.
.IP \(bu 2
افزودن خطای جدید misplaced\-bare\-raise / E0704 \%<#\:misplaced-bare-raise>\&.
.sp
این خطا هنگامی صادر می‌شود که یک raise خالی (bare raise) بیرون از یک عبارت except استفاده شده باشد.
این کار در صورتی که استثنای فعالی برای بالا انداختن مجدد وجود نداشته باشد، می‌تواند در Python منجر به RuntimeError شود.
اگرچه این کار در Python 2 به دلیل نشت استثنا به خارج از بلوک except کار می‌کند،
اما رفتاری است که کاربر نباید به آن وابسته باشد؛ چرا که برای خوانندهٔ کد مشخص نیست
چه استثنایی رخ خواهد داد و به هر حال با Python 3 نیز سازگار نخواهد بود.
.sp
بسته شدن #633.
.IP \(bu 2
انتقال ureports از logilab\-common به pylint.reporters.
.sp
با این تغییر، وابستگی به logilab\-common برطرف شد و تمام مؤلفه‌هایی
که از logilab\-common استفاده می‌شدند در Pylint قرار گرفتند.
این API باید به عنوان یک جزئیات پیاده‌سازی تلقی شود و ممکن است در آینده تغییر کند.
.sp
بسته شدن #621.
.IP \(bu 2
پیام \fBreimported\fP برای اشیایی که در همان خط دوباره درون‌ریزی شوند صادر می‌شود.
.sp
بسته شدن #639.
.IP \(bu 2
کوته‌نوشت‌ها و مخفف‌های گزینه‌های خط فرمان دیگر پشتیبانی نمی‌شوند.
.sp
استفاده از اختصارات برای گزینه‌های CLI هیچ‌گاه یک قابلیت برای pylint محسوب
نمی‌شد و تنها یک اثر جانبی ناشی از استفاده از optparse بود.
با توجه به این موضوع، استفاده از \-\-load\-plugin یا اختصارات دیگر به جای
\-\-load\-plugins عملاً هرگز کار نمی‌کرد، در حالی که خطایی نیز صادر نمی‌کرد.
.sp
بسته شدن #424.
.IP \(bu 2
افزودن خطای جدید nonlocal\-without\-binding / E0117 \%<#\:nonlocal-without-binding>
.sp
این خطا در Python 3 زمانی صادر می‌شود که یک نام nonlocal به هیچ متغیری
در حوزه‌های والد پیوند نیافته باشد.
.sp
بسته شدن #582.
.IP \(bu 2
.INDENT 2.0
.TP
.B deprecated\-module / W4901 \%<#\:deprecated-module> می‌تواند برای ماژول‌هایی که در دسترس
نیستند نیز نمایش داده شود.
.UNINDENT
.sp
بسته شدن #362.
.IP \(bu 2
اگر اعضای یک کلاس به‌درستی قابل استنتاج نباشند، نباید آن کلاس
انتزاعی (abstract) در نظر گرفته شود.
.sp
این تغییر، یک مورد مثبت کاذب مربوط به abstract\-class\-instantiated / E0110 \%<#\:abstract-class-instantiated>\& را برطرف می‌کند.
.sp
بسته شدن #648.
.IP \(bu 2
افزودن یک بررسی‌کنندهٔ جدید برای قابلیت‌های async که توسط PEP 492 اضافه شدند.
.IP \(bu 2
افزودن خطای جدید yield\-inside\-async\-function / E1700 \%<#\:yield-inside-async-function>، که در
Python 3.5 به بالا هنگامی صادر می‌شود که دستور \fByield\fP درون یک
تابع هم‌روال جدید (coroutine function براساس PEP 492) یافت شود.
.IP \(bu 2
افزودن خطای جدید not\-async\-context\-manager / E1701 \%<#\:not-async-context-manager>، که هنگامی
صادر می‌شود که یک بلوک مدیر زمینهٔ غیرهمگام با شیئی استفاده شود که از
این پروتکل پشتیبانی نمی‌کند (PEP 492).
.IP \(bu 2
افزودن هشدار قراردادی جدید singleton\-comparison / C0121 \%<#\:singleton-comparison>، که هنگام
مقایسه با True،‏ False یا None صادر می‌شود.
.IP \(bu 2
عدم صدور assigning\-non\-slot / E0237 \%<#\:assigning-non-slot> برای توصیف‌کننده‌ها (descriptors).
.sp
بسته شدن #652.
.IP \(bu 2
افزودن خطای جدید repeated\-keyword / E1132 \%<#\:repeated-keyword>، هنگامی که یک آرگومان کلیدواژه‌ای
چندین بار در یک فراخوانی تابع ارسال شود.
.sp
این مورد شبیه به redundant\-keyword\-arg / E1124 \%<#\:redundant-keyword-arg> است، اما اندکی تفاوت دارد
و نیاز است یک خطای جداگانه باشد.
.IP \(bu 2
گزینهٔ \-\-enable=all اکنون قابل استفاده است.
.sp
بسته شدن #142.
.IP \(bu 2
افزودن پیام قراردادی جدید misplaced\-comparison\-constant / C2201 \%<#\:misplaced-comparison-constant>،
که هنگامی صادر می‌شود که یک مقدار ثابت در سمت چپ یک مقایسه قرار گیرد،
مانند \(aq5 == func()\(aq. این مورد «شرط یودا» (Yoda condition) نیز نامیده می‌شود، چرا که
روال کد یادآور شخصیت سبز جنگ ستارگان است؛ شرایطی که معمولاً
در زبان‌هایی با قابلیت انتساب متغیر در عبارات شرطی دیده می‌شود.
.IP \(bu 2
افزودن پیام قراردادی جدید consider\-using\-enumerate / C0200 \%<#\:consider-using-enumerate>، که
هنگام مواجهه با کدی صادر می‌شود که از \fBrange\fP و \fBlen\fP برای پیمایش استفاده می‌کند.
.sp
بسته شدن #684.
.IP \(bu 2
افزودن دو پیام بازآرایی جدید، no\-classmethod\-decorator / R0202 \%<#\:no-classmethod-decorator> و
no\-staticmethod\-decorator / R0203 \%<#\:no-staticmethod-decorator>، که هنگامی صادر می‌شوند که یک متد ایستا یا یک
متد کلاس بدون استفاده از نحو دکوراتورها اعلان شده باشد..sp
بستن #675.
.UNINDENT
.SS تازه‌های Pylint 1.4
.SS تازه‌های Pylint 1.4.3
.sp
تاریخ انتشار: 2015\-03\-14
.INDENT 0.0
.IP \(bu 2
حذف سه هشدار: star\-args، abstract\-class\-little\-used،
abstract\-class\-not\-used. این هشدارها ارزش واقعی چندانی اضافه نمی‌کنند
و بر وجود خطا یا مشکلی در کد دلالت ندارند.
.IP \(bu 2
افزودن یک گزینهٔ جدید برای کنترل بهینه‌ساز peephole در astroid.
گزینهٔ \fB\-\-optimize\-ast\fP بهینه‌ساز peephole را کنترل خواهد کرد،
که برای بهینه‌سازی چند زیردرخت AST به کار می‌رود. مشکل فعلی حل‌شده
توسط بهینه‌ساز peephole زمانی رخ می‌دهد که چندین رشتهٔ متصل‌شده
با عملگر جمع (+) وجود داشته باشند. اگر تعداد چنین رشته‌هایی به اندازهٔ
کافی زیاد باشد، Pylint به دلیل معماری visitor خود با خطای حداکثر
عمق بازگشت (maximum recursion depth exceeded) مواجه خواهد شد.
بهینه‌ساز peephole در صورت امکان چنین فراخوانی‌هایی را به رشتهٔ حاصل
نهایی تبدیل می‌کند و این مسئله مشکلی را به وجود می‌آورد، زیرا متد
visit_binop دیگر فراخوانی نمی‌شود (در AST بهینه‌شده، این یک گره Const خواهد بود).
.UNINDENT
.SS تازه‌های Pylint 1.4.2
.sp
تاریخ انتشار: 2015\-03\-11
.INDENT 0.0
.IP \(bu 2
عدم الزام docstring برای ماژول‌های خالی.
.sp
بستن #261
.IP \(bu 2
رفع یک مثبت کاذب در هشدار رشته‌ای \fBtoo\-few\-format\-args\fP،
صادرشده زمانی که قالب رشته شامل یک آرگومان ترتیبی عادی (\(aq{0}\(aq)
ترکیب‌شده با یک آرگومان ترتیبی دارای دسترسی به ویژگی (\(aq{0.__class__}\(aq) بود.
.sp
بستن #463
.IP \(bu 2
در نظر گرفتن تمام متدهای نیاکان (ancestors) هنگام بررسی
too\-few\-public\-methods / R0903 \%<#\:too-few-public-methods>\&.
.sp
بستن #471
.IP \(bu 2
گرفتن خطاهای enchant و صدور invalid\-characters\-in\-docstring / C0403 \%<#\:invalid-characters-in-docstring>
هنگام بررسی خطاهای املایی.
.sp
بستن #469
.IP \(bu 2
استفاده از تمام گزاره‌های استنباط‌شده برای بررسی
super\-init\-not\-called / W0231 \%<#\:super-init-not-called>\&.
.sp
بستن #389
.IP \(bu 2
افزودن یک هشدار جدید، \(aqunichr\-builtin\(aq، صادرشده توسط بررسی‌کنندهٔ
مهاجرت به Python 3 هنگام یافتن تابع توکار unichr.
.sp
بستن #472
.IP \(bu 2
افزودن یک هشدار جدید، \(aqintern\-builtin\(aq، صادرشده توسط بررسی‌کنندهٔ
مهاجرت به Python 3 هنگام یافتن تابع توکار intern.
.sp
بستن #473
.IP \(bu 2
افزودن پشتیبانی از نصب‌های قابل‌ویرایش (editable installations).
.IP \(bu 2
خروجی HTML گزینهٔ \fB\-\-msg\-template\fP را می‌پذیرد. وصله توسط
Dan Goldsmith.
.IP \(bu 2
افزودن \(aqmap\-builtin\-not\-iterating\(aq (جایگزین \(aqimplicit\-map\-evaluation\(aq)،
\(aqzip\-builtin\-not\-iterating\(aq، \(aqrange\-builtin\-not\-iterating\(aq و
\(aqfilter\-builtin\-not\-iterating\(aq که هنگام عدم استفاده از تابع توکار
مربوطه در یک بافت پیمایشی توسط \fB\-\-py3k\fP صادر می‌شوند (معناشناسی
برگرفته از 2to3).
.IP \(bu 2
افزودن یک هشدار جدید، unidiomatic\-typecheck / C0123 \%<#\:unidiomatic-typecheck>، صادرشده زمانی که یک
بررسی صریح نوع به جای isinstance() از type() استفاده می‌کند. به عنوان مثال،
\fItype(x) == Y\fP به جای \fIisinstance(x, Y)\fP\&. وصله توسط Chris Rebert.
.sp
بستن #299
.IP \(bu 2
افزودن پشتیبانی از ترکیب حالت بررسی‌کنندهٔ Python 3 با پرچم \-\-jobs
(\-\-py3k و \-\-jobs).
.sp
بستن #467
.IP \(bu 2
افزودن یک هشدار جدید برای بررسی‌کنندهٔ مهاجرت به Python 3 به نام \(aqusing\-cmp\-argument\(aq،
صادرشده هنگام مواجهه با آرگومان \fBcmp\fP برای \fBlist.sort\fP یا \fBsorted builtin\fP.
.IP \(bu 2
جابجایی‌پذیر کردن پرچم \-\-py3k با پرچم \-E. همچنین این وصله
نشت پیام‌های خطای بررسی‌کنندهٔ Python 3 را هنگام فعال بودن حالت خطاها
برطرف می‌کند.
.sp
بستن #437
.UNINDENT.SS "تازه‌های Pylint 1.4.1 (What\(aqs New in Pylint 1.4.1?)"
.sp
تاریخ انتشار: 2015\-01\-16
.INDENT 0.0
.IP \(bu 2
جست‌وجو تنها در حوزهٔ تابع جاری برای bad\-super\-call / E1003 \%<#\:bad-super-call>\&.
.sp
بسته شدن #403
.IP \(bu 2
بررسی مقدار بازگشتی ویژگی‌ها هنگام بررسی not\-callable / E1102 \%<#\:not-callable>\&.
.sp
بسته شدن #406
.IP \(bu 2
هشدار دربارهٔ استفاده از توابع توکار input() یا round() برای Python 3.
.sp
بسته شدن #411
.IP \(bu 2
جست‌وجوی مناسب متدهای انتزاعی هنگام بررسی abstract\-class\-instantiated / E0110 \%<#\:abstract-class-instantiated>\&.
.sp
بسته شدن #401
.IP \(bu 2
استفاده از پیمایش mro برای یافتن متدهای انتزاعی.
.sp
بسته شدن #415
.IP \(bu 2
رفع مثبت کاذب در catching\-non\-exception / E0712 \%<#\:catching-non-exception> و تاپل‌های استثناها.
.IP \(bu 2
رفع منفی کاذب در raising\-non\-exception / E0710 \%<#\:raising-non-exception>، هنگامی که عبارت raise از زمینهٔ استثنایی غیرقابل استنتاج استفاده می‌کرد.
.IP \(bu 2
رفع مثبت کاذب در Python 2 برای raising\-bad\-type / E0702 \%<#\:raising-bad-type> هنگام raise کردن تاپل‌ها به صورت \(aqraise (ZeroDivisionError, None)\(aq.
.IP \(bu 2
رفع مثبت کاذب در invalid\-slots\-objects، هنگامی که مدخل slot یک رشتهٔ یونیکد در Python 2 بود.
.sp
بسته شدن #421
.IP \(bu 2
افزودن هشدار جدید، redundant\-unittest\-assert / W1503 \%<#\:redundant-unittest-assert>، که هنگام استفاده از متدهای assertTrue و assertFalse در unittest با مقدار ثابت به عنوان آرگومان صادر می‌شود. وصله توسط Vlad Temian.
.IP \(bu 2
افزودن یک گزارش‌گر JSON جدید، قابل استفاده از طریق پرچم \-f.
.IP \(bu 2
افزودن نام‌های متد برای هشدارهای signature\-differs / W0222 \%<#\:signature-differs> و \(aqargument\-differs\(aq.
.sp
بسته شدن #433
.IP \(bu 2
عدم کامپایل فایل‌های آزمون هنگام نصب.
.IP \(bu 2
رفع خرابی که هنگام استفاده از چندین پردازش (jobs) و در صورتی که فایل‌های داده‌شده به عنوان آرگومان اصلاً وجود نداشتند، رخ می‌داد.
.UNINDENT
.SS "تازه‌های Pylint 1.4.0 (What\(aqs New in Pylint 1.4.0?)"
.sp
تاریخ انتشار: 2014\-11\-23
.INDENT 0.0
.IP \(bu 2
افزودن گزینه‌های جدید برای کنترل بارگذاری افزونه‌های C. به‌طور پیش‌فرض، تنها افزونه‌های C موجود در stdlib برای بازرسی در مفسر فعال Python بارگذاری می‌شوند، چرا که می‌توانند در زمان وارد کردن (import)، کدهای دلخواه را اجرا کنند. گزینهٔ \fB\-\-extension\-pkg\-whitelist\fP می‌تواند برای مشخص کردن ماژول‌ها یا بسته‌هایی که بارگذاری آن‌ها ایمن است، استفاده شود.
.IP \(bu 2
تغییر مقدار پیش‌فرض max\-line\-length به ۱۰۰ به جای ۸۰.
.IP \(bu 2
حذف کلاس BaseRawChecker که مدتی بود تنها برای سازگاری با نسخه‌های پیشین باقی مانده بود.
.IP \(bu 2
عدم تلاش برای تحلیل قالب‌بندی رشته با اشیایی که از آرگومان‌های تابع می‌آیند.
.sp
بسته شدن #373
.IP \(bu 2
انتقال کد منبع به گونه‌ای که با Python 2/3 سازگار باشد. این کار نیاز به 2to3 را از بین می‌برد، اما پشتیبانی از Python 2.5 را متوقف می‌کند.
.IP \(bu 2
اکنون هر پیام با یک سطح اطمینان همراه است و می‌تواند بر اساس این سطح فیلتر شود. این قابلیت امکان فیلتر کردن تمام پیام‌هایی را فراهم می‌کند که حتی در صورت بروز شکست در استنتاج حین بررسی صادر شده بودند.
.IP \(bu 2
بهبود در نمایش پیام unused\-import / W0611 \%<#\:unused-import>.
.sp
بسته شدن #293
.IP \(bu 2
افزودن بررسی‌کنندهٔ جدید برای یافتن خطاهای املایی. پیام‌های جدید: wrong\-spelling\-in\-comment / C0401 \%<#\:wrong-spelling-in-comment>، wrong\-spelling\-in\-docstring / C0402 \%<#\:wrong-spelling-in-docstring>\&. گزینه‌های جدید: spelling\-dict، spelling\-ignore\-words.
.IP \(bu 2
افزودن گزینهٔ جدید \(aq\-j\(aq برای اجرای بررسی‌ها در زیرپردازش‌ها.
.IP \(bu 2
افزودن بررسی‌های جدید برای پایانه‌های خط در صورت مخلوط بودن (LF در برابر CRLF) یا در صورتی که مطابق انتظار نباشند. پیام‌های جدید: mixed\-line\-endings / C0327 \%<#\:mixed-line-endings>، unexpected\-line\-ending\-format / C0328 \%<#\:unexpected-line-ending-format>\&. گزینهٔ جدید: expected\-line\-ending\-format.
.IP \(bu 2
هشدار dangerous\-default\-value / W0102 \%<#\:dangerous-default-value> دیگر مقدار آرگومان‌ها را ارزیابی نمی‌کند، که می‌توانست منجر به پیام‌های خطای طولانی یا افشای داده‌های حساس شود.
.sp
بسته شدن #282
.IP \(bu 2
رفع مثبت کاذب در بررسی‌کنندهٔ قالب‌بندی رشته، هنگام مواجهه با رشته‌ای که تنها از آرگومان‌های مبتنی بر موقعیت استفاده می‌کند.
.sp
بسته شدن #285
.IP \(bu 2
رفع مثبت کاذب در بررسی‌کنندهٔ قالب‌بندی رشته، هنگام استفاده از بسته‌بندی آرگومان‌های کلیدواژه‌ای.
.sp
بسته شدن #288
.IP \(bu 2
مدیریت مناسب حوزهٔ سطح کلاس برای توابع لامبدا.
.IP \(bu 2
مدیریت too\-few\-format\-args / E1306 \%<#\:too-few-format-args> یا too\-many\-format\-args / E1305 \%<#\:too-many-format-args> برای رشته‌های قالب‌بندی دارای هر دو فیلد نام‌دار و موقعیتی.
.sp
بسته شدن #286
.IP \(bu 2
تحلیل تنها رشته‌ها توسط بررسی‌کنندهٔ قالب رشته.
.sp
بسته شدن #287
.IP \(bu 2
مدیریت مناسب فیلدهای تودرتوی رشتهٔ قالب.
.sp
بسته شدن #294
.IP \(bu 2
عدم صدور attribute\-defined\-outside\-init / W0201 \%<#\:attribute-defined-outside-init> در صورتی که مشخصه با فراخوانی یک تابع در یک متد تعریف‌کننده مقداردهی شده باشد.
.sp
بسته شدن #192
.IP \(bu 2
مدیریت مناسب رشته‌های قالب یونیکد برای Python 2.
.sp
بسته شدن #296
.IP \(bu 2
عدم صدور import\-error / E0401 \%<#\:import-error> در صورتی که یک import توسط یک try\-except که ImportError را مدیریت می‌کرد، محافظت شده باشد.
.IP \(bu 2
رفع مثبت کاذب unused\-import / W0611 \%<#\:unused-import>، هنگامی که خطا برای تمام اعضای واردشده با قالب \(aqfrom import\(aq صادر می‌شد.
.sp
بسته شدن #304
.IP \(bu 2
عدم صدور invalid\-name / C0103 \%<#\:invalid-name> هنگام انتساب یک نام در مدیریت‌کنندهٔ ImportError.
.sp
بسته شدن #302
.IP \(bu 2
عدم شمارش شاخه‌ها از توابع تودرتو.
.IP \(bu 2
رفع مثبت کاذب در too\-few\-format\-args / E1306 \%<#\:too-few-format-args>، هنگامی که رشته‌های قالب حاوی آرگومان‌های موقعیتی دستی تکراری بودند.
.sp
بسته شدن #310
.IP \(bu 2
مدیریت کامنت‌های بدون فاصله پس از علامت هش توسط عبارت باقاعدهٔ fixme.
.sp
بسته شدن #311
.IP \(bu 2
عدم صدور unused\-import / W0611 \%<#\:unused-import> هنگامی که یک شیء خاص وارد می‌شود (__all__، __doc__ و غیره).
.sp
بسته شدن #309
.IP \(bu 2
جست‌وجو در فراکلاس (metaclass)، در صورت تعریف، برای اعضایی که در کلاس جاری پیدا نشده‌اند.
.sp
بسته شدن #306
.IP \(bu 2
عدم صدور protected\-access / W0212 \%<#\:protected-access> در صورتی که به مشخصه با استفاده از یک ویژگی (property) تعریف‌شده در سطح کلاس دسترسی پیدا شود.
.IP \(bu 2
تشخیص فراخوانی‌های __init__ والد از طریق یک فراخوانی مقیدشدهٔ super().
.IP \(bu 2
بررسی اینکه یک کلاس پیش از صدور \(aqold\-style\-class\(aq برای Python 2، دارای فراکلاس صریحاً تعریف‌شده باشد.
.IP \(bu 2
صدور catching\-non\-exception / E0712 \%<#\:catching-non-exception> برای گره‌های غیرکلاسی.
.UNINDENT.sp
بسته شدن #303
.IP \(bu 2
ترتیب گزارش‌دهی یکدست و سازگار است.
.IP \(bu 2
افزودن هشدار جدید، boolean\-datetime / W1502 \%<#\:boolean-datetime>، که هنگام استفاده از نمونه‌ای
از \(aqdatetime.time\(aq در یک زمینه بولی صادر می‌شود.
.sp
بسته شدن #239
.IP \(bu 2
رفع یک از کار افتادگی (crash) که هنگام بررسی method\-hidden / E0202 \%<#\:method-hidden>،
زمانی که فریم والد چیزی غیر از یک تابع بود، رخ می‌داد.
.IP \(bu 2
تولید خروجی html برای فایل‌های مفقود.
.sp
بسته شدن #320
.IP \(bu 2
رفع مثبت کاذب در too\-many\-format\-args / E1305 \%<#\:too-many-format-args>، زمانی که رشته
قالب‌بندی حاوی ترکیبی از آرگومان‌های دسترسی به ویژگی و فیلدهای
دستی است.
.sp
بسته شدن #322
.IP \(bu 2
گسترش مواردی که در آن‌ها undefined\-variable / E0602 \%<#\:undefined-variable> و used\-before\-assignment / E0601 \%<#\:used-before-assignment>
قابل تشخیص هستند.
.sp
بسته شدن #291
.IP \(bu 2
افزودن پشتیبانی از سفارشی‌سازی شناسه‌های callback با افزودن گزینه خط فرمان
جدید \(aq\-\-callbacks\(aq.
.sp
بسته شدن #326
.IP \(bu 2
افزودن هشدار جدید، logging\-format\-interpolation / W1202 \%<#\:logging-format-interpolation>، که هنگام استفاده از درون‌یابی رشته‌ای .format()
درون فراخوانی توابع ثبت وقایع (logging) صادر می‌شود.
.IP \(bu 2
صادر نکردن unbalanced\-tuple\-unpacking / W0632 \%<#\:unbalanced-tuple-unpacking> هنگامی که سمت راست انتساب (rhs)
یک آرگومان با طول متغیر باشد.
.sp
بسته شدن #329
.IP \(bu 2
افزودن هشدار جدید، inherit\-non\-class / E0239 \%<#\:inherit-non-class>، که هنگام ارث‌بری یک کلاس
از چیزی که یک کلاس نیست صادر می‌شود.
.sp
بسته شدن #331
.IP \(bu 2
رفع مثبت کاذب دیگری در undefined\-variable / E0602 \%<#\:undefined-variable>، در جایی که متغیر
می‌تواند به عنوان یک انتساب کلاسی یافت شده و در حاشیه‌نویسی تابع (annotation) استفاده شود.
.sp
بسته شدن #342
.IP \(bu 2
مدیریت انتساب متد format رشته به یک متغیر.
.sp
بسته شدن #351
.IP \(bu 2
پشتیبانی از قالب بسته‌بندی wheel برای PyPi.
.sp
بسته شدن #334
.IP \(bu 2
بررسی اینکه شناسه‌های توکار (built-ins) مختلفی که در Python 3 وجود ندارند استفاده
نشوند: apply، basestring، buffer، cmp، coerce، execfile، file، long،
raw_input، reduce، StandardError، unicode، reload و xrange.
.IP \(bu 2
هشدار برای متدهای جادویی که به هیچ وجه در Python 3 استفاده نمی‌شوند:
__coerce__، __delslice__، __getslice__، __setslice__، __cmp__،
__oct__، __nonzero__ و __hex__.
.IP \(bu 2
عدم صدور assigning\-non\-slot / E0237 \%<#\:assigning-non-slot> هنگامی که انتساب برای یک ویژگی (property) است.
.sp
بسته شدن #359
.IP \(bu 2
رفع پس‌رفت: عبارت \(aq{path}\(aq دیگر در \(aq\-\-msg\-template\(aq پذیرفته نمی‌شد.
.IP \(bu 2
گزارش درصد تمامی پیام‌ها، نه فقط برای خطاها و هشدارها.
.sp
بسته شدن #319
.IP \(bu 2
هشدار too\-many\-public\-methods / R0904 \%<#\:too-many-public-methods> تنها برای متدهای تعریف‌شده در یک کلاس گزارش می‌شود،
نه نیاکان آن.
.sp
بسته شدن #248
.IP \(bu 2
پراگمای غیرفعال‌سازی too\-many\-lines / C0302 \%<#\:too-many-lines> می‌تواند در هر خطی قرار گیرد، نه فقط در خط
اول.
.sp
بسته شدن #321
.IP \(bu 2
هشدار در Python 2 هنگامی که یک دستور import بدون دستور متناظر
\fBfrom __future__ import absolute_import\fP\& یافت شود.
.IP \(bu 2
هشدار در Python 2 هنگامی که یک عملیات تقسیم غیرکف (non-floor) بدون
دستور متناظر \fBfrom __future__ import division\fP\& یافت شود.
.IP \(bu 2
افزودن گزینه جدید، \(aqexclude\-protected\(aq، برای مستثنی کردن اعضا
از هشدار protected\-access / W0212 \%<#\:protected-access>.
.sp
بسته شدن #48
.IP \(bu 2
هشدار در Python 2 هنگام استفاده از dict.iter*() و dict.view*()؛ هیچ‌کدام از این
متدها در Python 3 در دسترس نیستند.
.IP \(bu 2
هشدار در Python 2 هنگام فراخوانی متد next() یک شیء؛ Python 3 به جای آن از
__next__() استفاده می‌کند.
.IP \(bu 2
هشدار هنگام انتساب به __metaclass__ در حوزه کلاس؛ در Python 3 متارده
به عنوان آرگومانی برای دستور \(aqclass\(aq مشخص می‌شود.
.IP \(bu 2
هشدار هنگام باز کردن تاپل پارامترها (parameter tuple unpacking)؛ این عمل در
Python 3 پشتیبانی نمی‌شود.
.IP \(bu 2
هشدار abstract\-class\-instantiated / E0110 \%<#\:abstract-class-instantiated> برای Python 2 نیز صادر می‌شود.
این مورد پیش‌تر غیرفعال شده بود.
.IP \(bu 2
افزودن خطای \(aqlong\-suffix\(aq، که هنگام مواجهه با پسوند long
روی اعداد صادر می‌شود.
.IP \(bu 2
افزودن پشتیبانی برای غیرفعال کردن یک بازبین (checker)، با مشخص کردن ویژگی
\(aqenabled\(aq روی کلاس بازبین.
.IP \(bu 2
افزودن گزینه جدید خط فرمان، \-\-py3k، برای فعال‌سازی حالت انتقال به Python 3. این
حالت تمام بازبین‌های دیگر را غیرفعال کرده و برای ساختارهایی که در Python 3 نامعتبر
بوده یا حذف شده‌اند هشدار و خطا صادر می‌کند.
.IP \(bu 2
افزودن \(aqold\-octal\-literal\(aq به بازبین انتقال به Python 3، که هنگام
مواجهه با اعداد هشت‌هشتی با نحو قدیمی صادر می‌شود.
.IP \(bu 2
افزودن \(aqimplicit\-map\-evaluation\(aq به بازبین انتقال به Python 3، که
هنگام مواجهه با استفاده از تابع توکار map بدون ارزیابی صریح صادر می‌شود.
.UNINDENT.SS تازه‌های Pylint 1.3 (What\(aqs New In Pylint 1.3)
.sp
تاریخ انتشار: 2014\-07\-26
.INDENT 0.0
.IP \(bu 2
اجازه دادن به دندانه‌گذاری ادامه‌دار معلق برای رشته‌های متصل‌شده به‌صورت ضمنی.
.sp
بسته شدن شماره #232.
.IP \(bu 2
ابزار Pylint دوباره روی Python 2.5 کار می‌کند و آزمون‌های آن با موفقیت پاس می‌شوند.
.IP \(bu 2
رفع برخی موارد مثبت کاذب برای هشدارهای cellvar\-from\-loop.
.sp
بسته شدن شماره #233.
.IP \(bu 2
بازگرداندن گره‌های کلاس astroid جدید زمانی که موتور استنتاج تشخیص دهد نتیجه فراخوانی یک تابع روی یک نوع (مانند \fBtype\fP یا \fIabc.ABCMeta\fP) درخواست شده است.
.sp
بسته شدن شماره #205.
.IP \(bu 2
صدور خطای undefined\-variable / E0602 \%<#\:undefined-variable> برای نام‌های تعریف‌نشده هنگام استفاده از آرگومان \fBmetaclass=\fP در Python 3.
.IP \(bu 2
بررسی‌کننده‌ها اکنون اولویت را رعایت می‌کنند.
.sp
بسته شدن شماره #229
.IP \(bu 2
رفع یک مورد مثبت کاذب در رابطه با W0511.
.sp
بسته شدن شماره #149.
.IP \(bu 2
رفع مثبت کاذب unused\-import / W0611 \%<#\:unused-import> در metaclassهای Python 3.
.sp
بسته شدن شماره #143
.IP \(bu 2
عدم صدور هشدار bad\-format\-character / E1300 \%<#\:bad-format-character> هنگام مواجهه با قالب \(aqa\(aq در Python 3.
.IP \(bu 2
افزودن چندین بررسی برای قالب‌بندی پیشرفته رشته بر اساس PEP 3101:
bad\-format\-string / W1302 \%<#\:bad-format-string>، missing\-format\-argument\-key / W1303 \%<#\:missing-format-argument-key>،
unused\-format\-string\-argument / W1304 \%<#\:unused-format-string-argument>، format\-combined\-specification / W1305 \%<#\:format-combined-specification>،
missing\-format\-attribute / W1306 \%<#\:missing-format-attribute> و invalid\-format\-index / W1307 \%<#\:invalid-format-index>\&.
.IP \(bu 2
صدور خطاهای broad\-except / W0703 \%<#\:broad-except> و bare\-except / W0702 \%<#\:bare-except> حتی اگر تعداد مدیریت‌کننده‌های except غیر از ۱ باشد.
.sp
بسته شدن شماره #113
.IP \(bu 2
صدور خطای attribute\-defined\-outside\-init / W0201 \%<#\:attribute-defined-outside-init> برای تمامی موارد، نه فقط برای آخرین انتساب.
.sp
بسته شدن شماره #262
.IP \(bu 2
صدور خطای not\-callable / E1102 \%<#\:not-callable> هنگام فراخوانی خصوصیات (properties).
.sp
بسته شدن شماره #268.
.IP \(bu 2
رفع یک مورد مثبت کاذب در باز کردن نامتوازن مقادیر شیء پیمایش‌پذیر (iterable unpacking)، هنگام مواجهه با گره‌های ستاره‌دار.
.sp
بسته شدن شماره #273.
.IP \(bu 2
افزودن بررسی‌های جدید invalid\-slice\-index / E1127 \%<#\:invalid-slice-index> و invalid\-sequence\-index / E1126 \%<#\:invalid-sequence-index> برای اندیس‌های نامعتبر دنباله و برش.
.IP \(bu 2
افزودن هشدار assigning\-non\-slot / E0237 \%<#\:assigning-non-slot>، که انتساب به ویژگی‌های تعریف‌نشده در slots را شناسایی می‌کند.
.IP \(bu 2
عدم صدور خطای no\-name\-in\-module / E0611 \%<#\:no-name-in-module> برای ماژول‌های نادیده‌گرفته‌شده.
.sp
بسته شدن شماره #223.
.IP \(bu 2
رفع یک مورد مثبت کاذب در unused\-variable / W0612 \%<#\:unused-variable>، در مواردی که متغیر از طریق یک واردسازی (import) مقداردهی شده است.
.sp
بسته شدن شماره #196.
.IP \(bu 2
ترتیب تعریف برای کلاس‌ها، آرگومان‌های تابع و حاشیه‌نویسی‌ها (annotations) لحاظ می‌شود.
.sp
بسته شدن شماره #257.
.IP \(bu 2
عدم صدور unused\-variable / W0612 \%<#\:unused-variable> هنگام انتساب به یک متغیر nonlocal.
.sp
بسته شدن شماره #275.
.IP \(bu 2
جلوگیری از انتشار خطای ImportError از بررسی‌کننده import، که در برخی مواردِ مرتبط با بسته‌های فضای نام منجر به فروپاشی (crash) برنامه می‌شد.
.sp
بسته شدن شماره #203.
.IP \(bu 2
عدم صدور pointless\-string\-statement / W0105 \%<#\:pointless-string-statement> برای رشته‌های مستندات (docstrings) ویژگی‌ها.
.sp
بسته شدن شماره #193.
.IP \(bu 2
استفاده از حالت مناسب برای pickle هنگام باز کردن و نوشتن فایل آمار.
.sp
بسته شدن شماره #148.
.IP \(bu 2
عدم صدور پیام hidden\-method هنگامی که ویژگی دستکاری موقت (monkey\-patched) شده است؛ با انجام این کار مسئولیت عواقب آن با خودتان است.
.IP \(bu 2
صدور attribute\-defined\-outside\-init / W0201 \%<#\:attribute-defined-outside-init> فقط برای تعاریف درون همان ماژولِ کلاسِ مربوطه، برای جلوگیری از مخدوش شدن خروجی در برخی موارد.
.IP \(bu 2
عدم صدور unnecessary\-lambda / W0108 \%<#\:unnecessary-lambda> در صورتی که بدنه فراخوانی lambda شامل زنجیره‌سازی فراخوانی باشد.
.sp
بسته شدن شماره #243.
.IP \(bu 2
عدم صدور missing\-docstring / C0111 \%<#\:missing-docstring> زمانی که رشته مستندات اصلی از \fB\&.format\fP استفاده می‌کند.
.sp
بسته شدن شماره #281.
.UNINDENT.SS "تازه‌های Pylint 1.2 (What\(aqs New In Pylint 1.2)"
.sp
تاریخ انتشار: 2014\-04\-30
.INDENT 0.0
.IP \(bu 2
بازگرداندن قابلیت تعیین گزینه init\-hook از طریق فایل پیکربندی، که تصادفاً در نسخه 1.2.0 از کار افتاده بود.
.IP \(bu 2
افزودن یک هشدار جدید [bad\-continuation] برای خطوط ادامه‌داری که تورفتگی نادرست دارند.
.IP \(bu 2
صدور هشدار assignment\-from\-none / E1128 \%<#\:assignment-from-none> زمانی که تابع حاوی دستورهای return خالی است.
.sp
بسته شدن BitBucket #191
.IP \(bu 2
افزودن یک هشدار جدید برای بستار روی متغیرهایی که درون حلقه‌ها تعریف شده‌اند.
.sp
بسته شدن BitBucket #176
.IP \(bu 2
عدم صدور هشدار درباره نویسه‌های گریز u در رشته‌های لفظی، هنگام استفاده از رشته‌های لفظی یونیکد در Python 2.*.
.sp
بسته شدن BitBucket #151
.IP \(bu 2
گسترش بررسی‌های unbalanced\-tuple\-unpacking / W0632 \%<#\:unbalanced-tuple-unpacking> و unpacking\-non\-sequence / E0633 \%<#\:unpacking-non-sequence> به باز کردن ویژگی‌های نمونه نیز.
.IP \(bu 2
رفع بررسی صریح اسکریپت python (پسرفت در نسخه 1.2)
.sp
بسته شدن #219
.IP \(bu 2
بازگردانی \-\-init\-hook، که در نسخه 1.2.0 به‌طور تصادفی به \-\-init\-hooks تغییر نام داده شده بود
.sp
بسته شدن #211
.IP \(bu 2
افزودن هشدار \(aqindexing\-exception\(aq، که ایندکس کردن یک استثنا در Python 2 را تشخیص می‌دهد (رفتاری که در Python 3 حذف شده است).
.UNINDENT
.SS "تازه‌های Pylint 1.2.0؟ (What\(aqs New in Pylint 1.2.0?)"
.sp
تاریخ انتشار: 2014\-04\-18
.INDENT 0.0
.IP \(bu 2
ارسال مسیرهای جاری python به فرایند pylint هنگام فراخوانی از طریق epylint.
.sp
بسته شدن BitBucket #133.
.IP \(bu 2
بازگرداندن \-i / \-\-include\-ids و \-s / \-\-symbols به عنوان گزینه‌هایی که کاملاً نادیده گرفته می‌شوند.
.sp
بسته شدن BitBucket #180.
.IP \(bu 2
افزایش مواردی که در آن‌ها فراخوانی‌های logging شناسایی می‌شوند.
.sp
بسته شدن BitBucket #182.
.IP \(bu 2
بهبود پردازش pragma به منظور عدم شناسایی رشته‌های pylint:* در غیر از کامنت‌ها.
.sp
بسته شدن BitBucket #79.
.IP \(bu 2
عدم کرش با خطای UnknownMessage در صورت ظاهر شدن شناسه یا نام پیام ناشناخته در disable یا enable در پیکربندی. وصله توسط Cole Robinson.
.sp
بسته شدن BitBucket #170
.IP \(bu 2
افزودن هشدار جدید eval\-used / W0123 \%<#\:eval-used> برای بررسی استفاده از تابع توکار \fBeval\fP.
.IP \(bu 2
امکان‌پذیر کردن نمایش راهنمای نام‌گذاری برای نام‌های نامعتبر با تنظیم include\-naming\-hint. همچنین راهنماهای نام‌گذاری قابل پیکربندی شدند.
.sp
بسته شدن BitBucket #138
.IP \(bu 2
افزودن پشتیبانی از اعمال شیوه‌های نام‌گذاری چندگانه اما منسجم برای انواع مختلف نام در یک ماژول واحد؛ بر اساس وصله نوشته‌شده توسط \%<morbo@\:google\:.com>\&.
.IP \(bu 2
همچنین صدور هشدار در مورد docstringهای خالی در متدهای بازنویسی‌شده؛ با مشارکت \%<sebastianu@\:google\:.com>\&.
.IP \(bu 2
همچنین بازرسی آرگومان‌های فراخوانی متدهای سازنده، و صدور هشدارهای مربوطه؛ با مشارکت \%<sebastianu@\:google\:.com>\&.
.IP \(bu 2
افزودن گزینه پیکربندی جدید logging\-modules برای قابل تنظیم کردن فهرست نام‌های ماژول‌هایی که می‌توانند برای logging\-not\-lazy / W1201 \%<#\:logging-not-lazy> و موارد مشابه بررسی شوند؛ با مشارکت \%<morbo@\:google\:.com>\&.
.IP \(bu 2
اطمینان از اینکه init\-hooks پیش از سایر گزینه‌ها، به‌ویژه load\-plugins ارزیابی می‌شود
.sp
بسته شدن #166
.IP \(bu 2
پشتیبانی از Python 2.5 بازگردانده شد: رفع ایرادات جزئی که مانع از اجرای pylint روی python 2.5 می‌شدند.
.sp
بسته شدن BitBucket #50
بسته شدن BitBucket #62
.IP \(bu 2
عدم کرش کردن pylint هنگام جستجو برای used\-before\-assignment / E0601 \%<#\:used-before-assignment> در انتساب‌های مدیر بافت (context manager).
.sp
بسته شدن BitBucket #128
.IP \(bu 2
افزودن هشدار جدید، bad\-reversed\-sequence / E0111 \%<#\:bad-reversed-sequence>، برای بررسی اینکه تابع توکار reversed() یک توالی دریافت کند (پیاده‌سازی \fB__getitem__\fP و \fB__len__\fP، بدون اینکه یک dict یا زیرکلاسی از dict باشد) یا نمونه‌ای که \fB__reversed__\fP را پیاده‌سازی کرده است.\&
.IP \(bu 2
علامت‌گذاری \fBfile\fP به عنوان تابع نامناسب هنگام استفاده از python2
.sp
بسته شدن #8
.IP \(bu 2
افزودن هشدار جدید bad\-exception\-context / E0703 \%<#\:bad-exception-context>، برای بررسی اینکه \fBraise ... from ...\fP از یک بافت استثنای معتبر (None یا یک استثنا) استفاده کند.
.IP \(bu 2
بهبود بررسی used\-before\-assignment / E0601 \%<#\:used-before-assignment> برای شناسایی استفاده از \(aqnonlocal\(aq.
.IP \(bu 2
صدور undefined\-all\-variable / E0603 \%<#\:undefined-all-variable> در صورتی که متغیر __all__ یک بسته حاوی یک زیرماژول ناموجود باشد.
.sp
بسته شدن #126
.IP \(bu 2
افزودن یک هشدار جدید abstract\-class\-instantiated / E0110 \%<#\:abstract-class-instantiated> برای بررسی نمونه‌سازی از کلاس‌های انتزاعی ایجادشده با ماژول \fBabc\fP که دارای متدهای انتزاعی هستند.
.IP \(bu 2
عدم صدور هشدار درباره return\-arg\-in\-generator / E0106 \%<#\:return-arg-in-generator> در Python 3.3+.
.IP \(bu 2
عدم صدور هشدار درباره abstract\-method / W0223 \%<#\:abstract-method> زمانی که متد انتزاعی از طریق انتساب پیاده‌سازی شده است
.sp
بسته شدن #155
.IP \(bu 2
بهبود شناسایی وارد کردن چرخه‌ای (cyclic import) در بسته‌ها، وصله توسط Buck Golemon
.IP \(bu 2
افزودن هشدارهای جدید برای بررسی صحت __slots__ کلاس‌ها:
\fBinvalid\-slots\-object\fP و \fBinvalid\-slots\fP\&.
.IP \(bu 2
جستجو برای فایل rc در مسیر \fI~/.config/pylintrc\fP در صورتی که \fI~/.pylintrc\fP وجود نداشته باشد
.sp
بسته شدن #121
.IP \(bu 2
عدم ثبت بررسی‌کننده کلاس‌های سبک جدید (new style checker) با python >= 3
.IP \(bu 2
رفع مثبت کاذب unused\-import / W0611 \%<#\:unused-import> در انتساب‌های افزوده
.sp
بسته شدن #78
.IP \(bu 2
رفع منفی کاذب access\-member\-before\-definition / E0203 \%<#\:access-member-before-definition> در رابطه با انتساب‌های افزوده
.sp
بسته شدن #164
.IP \(bu 2
عدم تلاش برای تحلیل فایل‌های غیر پایتونی، مانند فایل‌های .so
.sp
بسته شدن #122
.UNINDENT.SS "تازه‌های Pylint 1.1"
.sp
تاریخ انتشار: 2013\-12\-22
.INDENT 0.0
.IP \(bu 2
افزودن بررسی جدید برای استفاده از رهنمودهای deprecated\-pragma / I0022 \%<#\:deprecated-pragma> شامل \(dqpylint:disable\-msg\(dq
یا \(dqpylint:enable\-msg\(dq که پیش‌تر به عنوان یک warn() عادی صادر می‌شد.
.IP \(bu 2
جلوگیری از خطای کاذب used\-before\-assignment / E0601 \%<#\:used-before-assignment> برای شناسه تعریف‌شده در گرداننده except
که در همان خط استفاده شده است.
.sp
بستن #111
.IP \(bu 2
ترکیب \(aqno\-space\-after\-operator\(aq، \(aqno\-space\-after\-comma\(aq و
\(aqno\-space\-before\-operator\(aq در یک هشدار جدید به نام \(aqbad\-whitespace\(aq.
.IP \(bu 2
افزودن هشدار جدید superfluous\-parens / C0325 \%<#\:superfluous-parens> برای پرانتزهای
غیرضروری پس از برخی کلیدواژه‌ها.
.IP \(bu 2
رفع یک کرش احتمالی در هشدار redefine\-in\-handler
در صورتی که نام بازتعریف‌شده یک گره تودرتوی getattr باشد.
.IP \(bu 2
افزودن گزینه‌ای جدید برای هشدار multi\-statement جهت
مجاز دانستن دستورهای if تک‌خطی.
.IP \(bu 2
افزودن خطای bad\-context\-manager / E0235 \%<#\:bad-context-manager> جهت بررسی اینکه متد
ویژه \(aq__exit__\(aq تعداد درستی از آرگومان‌ها را می‌پذیرد یا خیر.
.IP \(bu 2
اجرای pylint به عنوان یک ماژول پایتون با \(aqpython \-m pylint\(aq (توسط Anatoly Techtonik).
.IP \(bu 2
بررسی کلاس‌های غیر از استثنا در داخل بند except.
.IP \(bu 2
پشتیبانی epylint از گزینه‌هایی که پس از فایل برای تحلیل به pylint داده می‌شوند و
برخورداری از اعتبارسنجی اولیه ورودی؛ وصله‌ها توسط
felipeochoa و Brian Lane ارائه شده‌اند.
.sp
بستن BitBucket #53
بستن BitBucket #54
.IP \(bu 2
افزودن یک هشدار جدید، non\-iterator\-returned / E0301 \%<#\:non-iterator-returned>، برای مقادیر غیر تکرارکننده
بازگردانده‌شده توسط \(aq__iter__\(aq.
.IP \(bu 2
افزودن بررسی‌های جدید برای باز کردن غیردنباله‌ها در انتساب‌ها
(unpacking\-non\-sequence / E0633 \%<#\:unpacking-non-sequence>) و همچنین باز کردن نامتعادل تاپل
(unbalanced\-tuple\-unpacking / W0632 \%<#\:unbalanced-tuple-unpacking>).
.IP \(bu 2
هشدار useless\-else\-on\-loop / W0120 \%<#\:useless-else-on-loop> در صورتی که در بند
else از حلقه داخلی دستور break وجود داشته باشد صادر نمی‌شود.
.sp
بستن #117
.IP \(bu 2
عدم علامت‌گذاری \fBinput\fP به عنوان تابع نامناسب هنگام استفاده از python3.
.sp
بستن #110
.IP \(bu 2
هشدار badly\-implemented\-container در پیاده‌سازی فعلی خود مشکلات متعددی ایجاد کرد.
غیرفعال‌سازی آن تا زمانی که راه‌حل بهتری داشته باشیم.
.sp
ارجاع #112
.IP \(bu 2
استفاده از regexp صفت برای ویژگی‌ها در python3، مشابه python2
.IP \(bu 2
ایجاد دایرکتوری \fBPYLINTHOME\fP در صورت نیاز؛ این عملیات ممکن است با شکست مواجه شده و منجر به
هشدارهای کاذب هنگام وارد کردن pylint.config شود.
.IP \(bu 2
اصلاح setup.py تا pylint هنگام استفاده از python3 روی Windows به درستی نصب شود
.IP \(bu 2
اصلاحات و بهبودهای گوناگون در مستندات
.IP \(bu 2
رفع یک مورد مثبت کاذب trailing\-whitespace / C0303 \%<#\:trailing-whitespace> روی Windows
.sp
بستن #55
.UNINDENT
.SS "تازه‌های Pylint 1.0"
.sp
تاریخ انتشار: 2013\-08\-06
.INDENT 0.0
.IP \(bu 2
افزودن بررسی برای استفاده از تابع \(aqexec\(aq
.IP \(bu 2
گزینه جدید \-\-msg\-template برای کنترل خروجی، منسوخ کردن قالب‌های خروجی \(dqmsvc\(dq و
\(dqparseable\(dq و همچنین حذف گزینه‌های \fB\-\-include\-ids\fP و \fB\-\-symbols\fP
.IP \(bu 2
عدم صادر کردن [fixme] برای تک‌تک خطوط، در صورتی که مقدار پیکربندی \(aqnotes\(aq
خالی باشد اما [fixme] فعال باشد.
.IP \(bu 2
صادر کردن هشدار درباره خطوطی که از حد ستون فراتر می‌روند، هنگامی که
آن خطوط درون docstringهای چندخطی هستند.
.IP \(bu 2
عدم بررسی دوباره نام پارامترها با عبارت باقاعده برای پارامترها و
متغیرهای درون‌خطی.
.IP \(bu 2
افزودن هشدار جدید missing\-final\-newline / C0304 \%<#\:missing-final-newline> برای فایل‌هایی که
فاقد خط پایانی جدید (newline) هستند.
.IP \(bu 2
متدهایی که به عنوان ویژگی (property) تزیین شده‌اند، اکنون برای اهداف
بررسی نام به عنوان صفت (attribute) در نظر گرفته می‌شوند.
.IP \(bu 2
نام‌های اعضای کلاس نمونه مشتق‌شده دیگر بررسی نمی‌شوند.
.IP \(bu 2
نام‌ها در دستورات global اکنون در برابر عبارت باقاعده مربوط به
ثابت‌ها بررسی می‌شوند.
.IP \(bu 2
برای انتساب نام در سطح بالا، در صورتی که pylint بتواند تشخیص دهد مقدار
سمت راست یک کلاس است (مانند collections.namedtuple())، از عبارت باقاعده نام کلاس استفاده خواهد شد.
.IP \(bu 2
ساده‌سازی پیام invalid\-name / C0103 \%<#\:invalid-name>
.IP \(bu 2
افزودن هشدار جدید invalid\-encoded\-data (W0512) برای فایل‌هایی که
حاوی داده‌هایی هستند که نمی‌توان آنها را با کدگذاری مشخص‌شده یا
پیش‌فرض رمزگشایی کرد.
.IP \(bu 2
هشدار جدید bad\-open\-mode / W1501 \%<#\:bad-open-mode> برای فراخوانی‌های open (یا file) که
حالت‌های باز کردن نامعتبر را مشخص می‌کنند (پیاده‌سازی اولیه توسط Sasha Issayev).
.IP \(bu 2
هشدار جدید old\-style\-class (C1001) برای کلاس‌هایی که فاقد هرگونه
کلاس پایه هستند.
.IP \(bu 2
افزودن نوع نام جدید \(aqclass_attribute\(aq برای صفت‌های تعریف‌شده
در حوزه کلاس. به طور پیش‌فرض، هر دو نام ثابت و متغیر مجاز هستند.
.IP \(bu 2
هشدار جدید trailing\-whitespace / C0303 \%<#\:trailing-whitespace> که درباره
فاصله‌های خالی انتهایی هشدار می‌دهد.
.IP \(bu 2
افزودن هشدار جدید unpacking\-in\-except (W0712) درباره باز کردن
استثناها در گرداننده‌ها، که در Python 3 پشتیبانی نمی‌شود.
.IP \(bu 2
افزودن یک گزینه پیکربندی برای missing\-docstring / C0111 \%<#\:missing-docstring> جهت
مستثنی کردن اختیاری توابع/متدها/کلاس‌های کوتاه از
این بررسی.
.IP \(bu 2
افزودن نوع گره متخلف به missing\-docstring / C0111 \%<#\:missing-docstring>
و empty\-docstring / C0112 \%<#\:empty-docstring>\&.
.IP \(bu 2
کلاس‌های ابزاری جدید برای آزمون‌های واحد مجزا به ازای هر بررسی‌کننده در testutils.py
.IP \(bu 2
عدم هشدار درباره بازتعریف متغیرهایی که با عبارت باقاعده
ساختگی مطابقت دارند.
.IP \(bu 2
در نظر نگرفتن تمامی متغیرهای شروع‌شونده با _ به عنوان متغیرهای ساختگی،
بلکه فقط خودِ _ .
.IP \(bu 2
امکان پیکربندی هشدار line\-too\-long / C0301 \%<#\:line-too-long> با افزودن یک عبارت باقاعده برای خطوطی
که محدودیت طول نباید روی آنها اعمال شود
.IP \(bu 2
عدم هشدار درباره خط طولانی در صورتی که یک گزینه pylint disable
باعث افزایش طول آن فراتر از حد مجاز شود
.IP \(bu 2
عدم علامت‌گذاری نام‌ها در دستورات تودرتوی with به عنوان تعریف‌نشده.
.IP \(bu 2
افزودن هشدار جدید \(aqold\-raise\-syntax\(aq برای نحو منسوخ‌شده
raise Exception, args
.IP \(bu 2
پشتیبانی از PEP 3102 و پیام جدید missing\-kwoa / E1125 \%<#\:missing-kwoa> برای مفقود
بودن آرگومان کلیدواژه‌ای اجباری
.sp
بستن Logilab #107788
.IP \(bu 2
اصلاح املای گزینه max\-branchs، که اکنون max\-branches است
.IP \(bu 2
افزودن کلاس پایه و رابط جدید برای بررسی‌کننده‌هایی که به جای نحو
روی توکن‌ها کار می‌کنند و فایل ورودی را فقط یک بار توکن‌بندی می‌نمایند.
.IP \(bu 2
پیروی از تغییر نام astng به astroid
.IP \(bu 2
بررسی برای باز کردن نامتعادل در انتساب‌ها
.sp
بستن BitBucket #37
.IP \(bu 2
رفع مثبت کاذب incomplete\-protocol برای نگه‌دارنده‌های فقط‌خواندنی مانند tuple
.sp
بستن BitBucket #25
.IP \(bu 2
رفع مثبت کاذب E1003 در Python 3 برای super() بدون آرگومان
.sp
بستن BitBucket #16.IP \(bu 2
بازگرداندن مستندات به توزیع کد منبع
.sp
بستن BitBucket #6
.IP \(bu 2
epylint دیگر هنگام وجود خروجی حجیم روی stderr مربوط به pylint قفل نخواهد کرد
.sp
بستن BitBucket #15
.IP \(bu 2
رفع مشکل epylint با python3
.sp
بستن BitBucket #7
.IP \(bu 2
حذف ماژول string از فهرست پیش‌فرض ماژول‌های منسوخ‌شده
.sp
بستن BitBucket #3
.UNINDENT
.SS 0.x
.sp
از آغاز pylint تا pylint 2.14.0 (شامل آن)، تغییرنامه‌ای داشتیم که شامل \fIتمام\fP
تغییرات غیرجزئی در Pylint بود، از جمله تغییراتی که برای
کاربران ملموس نبودند؛ یعنی تغییراتی که تنها اگر توسعه‌دهنده‌ای باشید
که روی pylint یا افزونه‌های pylint کار می‌کنید، یا تاریخ‌نگار متن‌باز هستید، برایتان جالب خواهد بود.
.sp
شماره تیکت‌ها تقریباً همیشه داخلی Logilab هستند و برخی از bitbucket می‌آیند.
.SS در Pylint 0.28.0 چه چیزهایی جدید است؟
.sp
تاریخ انتشار: 2013\-04\-25
.INDENT 0.0
.IP \(bu 2
bitbucket #1: رفع کرش \(dqdictionary changed size during iteration\(dq
.IP \(bu 2
#74013: پیام هشدار جدید E1310[bad\-str\-strip\-call] هنگام فراخوانی متد
{l,r,}strip با نویسه‌های تکراری (وصله از Torsten Marek)
.IP \(bu 2
#123233: پیام جدید E0108[duplicate\-argument\-name] برای گزارش نام‌های
تکراری آرگومان
.IP \(bu 2
#81378: صدور W0120[useless\-else\-on\-loop] برای حلقه‌های بدون break
.IP \(bu 2
#124660: وابستگی‌های داخلی نباید در گزارش وابستگی‌های خارجی ظاهر
شوند
.IP \(bu 2
#124662: رفع خطای نام که هنگام گنجاندن نمادها در پیام‌های خروجی
باعث کرش می‌شد
.IP \(bu 2
#123285: اعمال پراگماهای هشدارهای متصل به خطوط، روی خطوط فیزیکی
کد منبع
.IP \(bu 2
#123259: عدم صدور E0105 برای عبارت‌های yield درون lambdaها
.IP \(bu 2
#123892: عدم وقوع کرش هنگام تلاش برای نمایش خطی از کد منبع که با
تنظیمات محلی (locale) فعلی قابل انکود نیست
.IP \(bu 2
ساده‌سازی بررسی مقادیر پیش‌فرض خطرناک با یکپارچه‌سازی آزمون‌ها برای تمام
لیترال‌های مرکب تغییرپذیر متفاوت.
.IP \(bu 2
بهبود توضیحات برای redundant\-keyword\-arg / E1124 \%<#\:redundant-keyword-arg>
.UNINDENT
.SS در Pylint 0.27.0 چه چیزهایی جدید است؟
.sp
تاریخ انتشار: 2013\-02\-26
.INDENT 0.0
.IP \(bu 2
#20693: جایگزینی pylint.el با نسخه Ian Eure (وصله از J.Kotta)
.IP \(bu 2
#105327: افزودن پشتیبانی از گزینه \-\-disable=all و منسوخ‌سازی
دستور درون‌خطی \(aqdisable\-all\(aq به نفع \(aqskip\-file\(aq (وصله از
A.Fayolle)
.IP \(bu 2
#110840: افزودن پیام‌های I0020 و I0021 برای گزارش پیام‌های سرکوب‌شده
و پراگماهای سرکوب بلااستفاده. (وصله از Torsten Marek)
.IP \(bu 2
#112728: افزودن هشدار E0604 برای اشیاء غیررشته‌ای در __all__
(وصله از Torsten Marek)
.IP \(bu 2
#120657: افزودن هشدار W0110/deprecated\-lambda هنگامی که یک map/filter
روی lambda می‌تواند comprehension باشد (وصله از Martin Pool)
.IP \(bu 2
#113231: بررسی‌کننده logging اکنون علاوه بر ماژول پایه logging،
نمونه‌های کلاس‌های Logger را نیز بررسی می‌کند. (وصله از Mike Bryant)
.IP \(bu 2
#111799: عدم هشدار درباره دنباله گریز هشت‌هشتی، اما هشدار درباره o
که در پایتون هشت‌هشتی نیست (وصله از Martin Pool)
.IP \(bu 2
#110839: اختصاص کلید <F5> به دکمه Run در pylint\-gui
.IP \(bu 2
#115580: رفع هشدار نادرست W0212 (دسترسی به عضو محافظت‌شده) هنگام فراخوانی super
(وصله از Martin Pool)
.IP \(bu 2
#110853: رفع کرش هنگامی که متد __init__ در یک کلاس پایه به جای تعریف مستقیم
تابع، از طریق انتساب ایجاد شده است (وصله از
Torsten Marek)
.IP \(bu 2
#110838: رفع کرش pylint\-gui هنگامی که include\-ids فعال است (وصله از
Omega Weapon)
.IP \(bu 2
#112667: رفع صدور هشدارهای reimport برای واردسازی‌های ترکیبی و گسترش
مورد آزمون (وصله از Torsten Marek)
.IP \(bu 2
#112698: رفع کرش مرتبط با ویژگی‌های __all__ غیرقابل استنتاج و
محتویات نامعتبر __all__ (وصله از Torsten Marek)
.IP \(bu 2
اصلاحات مربوط به Python 3:
.IP \(bu 2
.INDENT 2.0
.TP
.B #110213: رفع واردسازی بررسی‌کننده‌های خراب‌شده در python 3.3 که باعث
شکست \(dqNo such message id W0704\(dq می‌شد
.UNINDENT
.IP \(bu 2
#120635: بازتعریف تابع cmp استفاده‌شده در pylint.reporters
.IP \(bu 2
گنجاندن شناسه کامل هشدار برای I0020 و I0021 و اطمینان از تخلیه (flush)
هشدارها پس از هر ماژول، نه در انتهای اجرای pylint.
(وصله از Torsten Marek)
.IP \(bu 2
تغییر عبارت منظم برای گزینه‌های درون‌خطی به‌طوری که حتماً
باید قبل از آن یک # بیاید (وصله از Torsten Marek)
.IP \(bu 2
پیش‌بینی‌پذیر کردن خروجی dot برای نمودار واردسازی‌ها و عدم وابستگی آن
به ترتیب رشته‌ها در درهم‌سازی‌ها (hashes). (وصله از Torsten Marek)
.IP \(bu 2
افزودن قلاب‌ها برای راه‌اندازی مسیر واردسازی و انتقال تغییرات
sys.path مربوط به pylint به درون آن‌ها. (وصله از Torsten Marek)
.UNINDENT.SS چه چیزهایی در Pylint 0.26.0 جدید است؟
.sp
تاریخ انتشار: 2012\-10\-05
.INDENT 0.0
.IP \(bu 2
#106534: افزودن گزینه \-\-ignore\-imports به بررسی شباهت کد و ابزار خط فرمان \(aqsymilar\(aq (وصله توسط Ry4an Brase)
.IP \(bu 2
#104571: بررسی گریزهای غیرعادی بک‌اسلش، با معرفی پیام‌های جدید W1401 و W1402 (وصله توسط Martin Pool)
.IP \(bu 2
#100707: بررسی استفاده از boolop به عنوان کلاس استثنا، با معرفی پیام جدید W0711 (وصله توسط Tim Hatch)
.IP \(bu 2
#4014: بهبود بررسی اولین آرگومان‌های متدهای metaclass، با معرفی پیام جدید C0204 (وصله توسط \%<lothiraldan@\:gmail\:.com>، نهایی‌شده توسط sthenault)
.IP \(bu 2
#4685: بررسی سازگاری متغیر __all__ یک ماژول، با معرفی پیام جدید E0603
.IP \(bu 2
#105337: امکان استفاده از گزارشگر سفارشی در output\-format (وصله توسط Kevin Jing Qiu)
.IP \(bu 2
#104420: بررسی کامل بودن پروتکل و جلوگیری از مثبت کاذب در R0903 (وصله توسط Peter Hammond)
.IP \(bu 2
#100654: رفع خطای دستوری برای پیام W0332 (استفاده از \(aql\(aq به عنوان شناسه long int)
.IP \(bu 2
#103656: رفع مثبت کاذب W0231 برای عدم فراخوانی object.__init__ (وصله توسط \%<lothiraldan@\:gmail\:.com>)
.IP \(bu 2
#63424: رفع مشکل غیرفعال‌سازی گزارش شباهت با تغییر نام صحیح آن به RP0801
.IP \(bu 2
#103949: ایجاد یک نقطه ورود console_scripts برای استفاده توسط easy_install،‏ buildout و pip
.IP \(bu 2
رفع مشکل تداخل بین مفسری (دسترسی ناسازگار به __builtins__)
.IP \(bu 2
عدم گنجاندن فایل‌های آزمون در بسته انتشار؛ این فایل‌ها هنگام نصب با python3 باعث فروپاشی می‌شدند (#72022، #82417، #76910)
.UNINDENT
.SS چه چیزهایی در Pylint 0.25.2 جدید است؟
.sp
تاریخ انتشار: 2012\-07\-17
.INDENT 0.0
.IP \(bu 2
#93591: صدور صحیح هشدارها درباره متغیرهای رونویسی‌شده هنگامی که یک گرداننده except به جای یک نام واحد، شامل چندتایی (tuple) از نام‌ها باشد (وصله توسط \%<tmarek@\:google\:.com>)
.IP \(bu 2
#7394: عدم صدور W0212 (دسترسی به عضو محافظت‌شده) در انتساب‌ها (وصله توسط \%<lothiraldan@\:gmail\:.com>)
.IP \(bu 2
#18772: عدم بررسی سازگاری پروتوتایپ برای متدهای مَنگل‌شده (mangled) (وصله توسط \%<lothiraldan@\:gmail\:.com>)
.IP \(bu 2
#92911: صدور W0102 هنگامی که مجموعه (set) به عنوان آرگومان پیش‌فرض در توابع استفاده می‌شود (وصله توسط \%<tmarek@\:google\:.com>)
.IP \(bu 2
#77982: عدم صدور E0602 برای متغیرهای حلقه در تعاریف فشرده (comprehensions) که به عنوان مقادیر آرگومان درون یک دکوراتور استفاده شده‌اند (وصله توسط \%<tmarek@\:google\:.com>)
.IP \(bu 2
#89092: عدم صدور E0202 (پنهان کردن یک متد توسط ویژگی) روی متدهای @property
.IP \(bu 2
#92584: رفع فروپاشی pylint\-gui به دلیل تغییر در API داخلی
.IP \(bu 2
#87192: رفع فروپاشی هنگامی که دکوراتورها با بیش از یک نقطه مورد دسترسی قرار می‌گیرند (برای نمونه @a.b درست عمل می‌کند، اما @a.b.c دچار فروپاشی می‌شود)
.IP \(bu 2
#88914: رفع پردازش گزینه‌های \-\-generated\-members که هنگام استفاده از مجموعه‌ای از مقادیر regexp منجر به فروپاشی می‌شد
.IP \(bu 2
رفع فروپاشی‌های احتمالی ناشی از برانگیختن خطای InferenceError توسط utils.safe_infer
.UNINDENT
.SS چه چیزهایی در Pylint 0.25.1 جدید است؟
.sp
تاریخ انتشار: 2011\-12\-08
.INDENT 0.0
.IP \(bu 2
#81078: هشدار در صورتی که نام‌ها در گرداننده‌های استثنا، نام‌های موجود را رونویسی کنند (وصله توسط \%<tmarek@\:google\:.com>)
.IP \(bu 2
#81113: رفع مشکل نمایش پیام‌های W0702 با شماره خط نادرست (وصله توسط \%<tmarek@\:google\:.com>)
.IP \(bu 2
#50461، #52020، #51222: عدم صدور هشدار هنگام استفاده از قابلیت‌های property.setter/deleter پایتون 2.6 (وصله توسط \%<dneil@\:google\:.com>)
.IP \(bu 2
#9188، #4024: فعال نکردن W0631 در صورتی که یک متغیر حلقه در شاخه else از یک حلقه for مقداردهی شده باشد.
.UNINDENT.SS چه مواردی در Pylint 0.25.0 جدید است؟
.sp
تاریخ انتشار: 2011\-10\-7
.INDENT 0.0
.IP \(bu 2
#74742: پیکربندی‌پذیر کردن نام مجاز برای نخستین آرگومان متدهای کلاس
(وصله توسط Google)
.IP \(bu 2
#74087: رسیدگی به حالتی که در آن استنتاج یک ماژول YES برمی‌گرداند؛ این کار از برخی موارد \(dqTypeError: \(aq_Yes\(aq object does not support indexing\(dq جلوگیری می‌کند (وصله توسط Google)
.IP \(bu 2
#74745: پیکربندی‌پذیر کردن نام استثناهای \(dqبیش از حد کلی\(dq (وصله توسط Google)
.IP \(bu 2
#74747: بروز فروپاشی هنگام جستجوی یک صفت ویژه در حوزهٔ کلاس
(وصله توسط Google)
.IP \(bu 2
#76920: بروز فروپاشی در مواردی مانند \(dqpylint \-\-rcfile\(dq (وصله توسط Torsten Marek)
.IP \(bu 2
#77237: هشدار E0202 ممکن است بسیار گمراه‌کننده باشد
.IP \(bu 2
#73941: جدول پیام‌های گزارش HTML به درستی رندر نمی‌شود
.UNINDENT
.SS چه مواردی در Pylint 0.24.0 جدید است؟
.sp
تاریخ انتشار: 2011\-07\-18
.INDENT 0.0
.IP \(bu 2
#69738: افزودن پشتیبانی از عبارت‌های باقاعده برای \(dqgenerated\-members\(dq
.IP \(bu 2
شناسه‌های بررسی‌کننده‌های logging و string_format تغییر یافته است:
logging: 65 \-> 12، string_format: 99 \-> 13
همچنین افزودن مستنداتی مبنی بر این‌که شناسه‌های بازهٔ 1\-50 باید برای بررسی‌کننده‌های داخلی pylint رزرو شوند
.IP \(bu 2
#69993: بررسی‌های تکمیلی قالب رشته برای ماژول logging:
بررسی آرگومان‌های مفقود، آرگومان‌های بیش از حد، یا قالب‌های رشته‌ای نامعتبر در ماژول بررسی‌کنندهٔ logging. مشارکت توسط Daniel Arena
.IP \(bu 2
#69220: افزودن آفست ستون به گزارش‌ها. اگر یک گزارشگر سفارشی دارید، این تغییر ممکن است عملکرد آن را مختل کند زیرا بخش مکان اکنون یک مورد جدید برای ارائهٔ آفست ستون دریافت کرده است.
.IP \(bu 2
#60828: رفع مورد مثبت کاذب در بررسی reimport
.IP \(bu 2
#70495: شکست وارد کردن‌های مطلق (absolute imports) بسته به مسیر ماژول (وصله توسط Jacek Konieczny)
.IP \(bu 2
#22273: اصلاح مستندات گزینهٔ \-\-ignore جهت تطابق با واقعیت
.UNINDENT
.SS چه مواردی در Pylint 0.23.0 جدید است؟
.sp
تاریخ انتشار: 2011\-01\-11
.INDENT 0.0
.IP \(bu 2
به‌روزرسانی مستندات، افزودن صفحه‌های راهنما (man pages)
.IP \(bu 2
چندین بهبود در کارایی
.IP \(bu 2
نهایی‌سازی پشتیبانی از python3
.IP \(bu 2
هشدار جدید W0106 تحت عنوان \(aqExpression \(dq%s\(dq is assigned to nothing\(aq
.IP \(bu 2
حذف پیام‌های E0501 و E0502 دربارهٔ کدگذاری نادرست منبع: دیگر کاربردی ندارد زیرا برای نسخهٔ python >= 2.5 یک خطای نگارشی محسوب می‌شود و اکنون ما تنها از این نسخهٔ پایتون و بالاتر پشتیبانی می‌کنیم.
.IP \(bu 2
عدم صدور W0221 یا W0222 هنگامی که متدها آرگومان‌های متغیر دارند (مانند *arg و/یا **args). وصله ارسال‌شده توسط Charles Duffy.
.UNINDENT
.SS چه مواردی در Pylint 0.22.0 جدید است؟
.sp
تاریخ انتشار: 2010\-11\-15
.INDENT 0.0
.IP \(bu 2
نسخه‌های پایتون: پشتیبانی کمینه از python3.x؛ کنار گذاشتن پشتیبانی از نسخه‌های python < 2.5
.UNINDENT
.SS چه مواردی در Pylint 0.21.4 جدید است؟
.sp
تاریخ انتشار: 2010\-10\-27
.INDENT 0.0
.IP \(bu 2
رفع #48066: فروپاشی pylint هنگام تغییر مسیر خروجیِ حاوی نویسه‌های غیر ASCII
.IP \(bu 2
رفع #19799: خروج با وضعیت 2 در اجرای \(dqpylint \-blah\(dq
.IP \(bu 2
به‌روزرسانی مستندات
.UNINDENT.SS "تازه‌های Pylint 0.21.3"
.sp
تاریخ انتشار: 2010\-09\-28
.INDENT 0.0
.IP \(bu 2
بازگردانی سازگاری با python 2.3. به همراه logilab\-astng
0.21.3 و logilab\-common 0.52، این نسخه به احتمال بسیار زیاد آخرین
انتشاری خواهد بود که از python < 2.5 پشتیبانی می‌کند.
.UNINDENT
.SS "تازه‌های Pylint 0.21.2"
.sp
تاریخ انتشار: 2010\-08\-26
.INDENT 0.0
.IP \(bu 2
رفع اشکال #36193: پرتاب استثنا توسط بررسی‌کنندهٔ import در واردکردن‌های چرخه‌ای
.IP \(bu 2
رفع اشکال #28796: پسرفت در \-\-generated\-members ایجاد شده در pylint 0.20
.IP \(bu 2
پاک‌سازی و مرتب‌سازی برخی مستندات
.UNINDENT
.SS "تازه‌های Pylint 0.21.1"
.sp
تاریخ انتشار: 2010\-06\-04
.INDENT 0.0
.IP \(bu 2
رفع اشکال #28962: فروپاشی pylint با گزینه‌های جدید، به دلیل نبود داده‌های آماری هنگام
نوشتن گزارش Statistics by types
.IP \(bu 2
به‌روزرسانی صفحهٔ راهنما (man page) به شیوهٔ استفاده از خط فرمان 0.21 یا بالاتر (رفع اشکال دبیان #582494)
.UNINDENT
.SS "تازه‌های Pylint 0.21.0"
.sp
تاریخ انتشار: 2010\-05\-11
.INDENT 0.0
.IP \(bu 2
خط فرمان به‌روزرسانی شد (بسته شدن #9774، #9787، #9992، #22962):
.IP \(bu 2
تمامی گزینه‌های enable\-* / disable\-* در \-\-enable / \-\-disable ادغام شدند
.IP \(bu 2
تغییر ناسازگار با گذشته: نام کوتاه \-\-errors\-only به \-E تبدیل شد، و \-e به
\-\-enable اختصاص یافت
.IP \(bu 2
خروجی pylint \-\-help بسیار ساده‌تر شد؛ برای دریافت خروجی کامل،
گزینهٔ \-\-long\-help در دسترس است
.IP \(bu 2
بازنگری در gui، با تشکر از دانشجویان دانشگاه تورنتو (آن‌ها
مشارکت‌کنندگان فوق‌العاده‌ای در این نسخه بودند!)
.IP \(bu 2
رفع اشکال #21591: در صورت تنظیم reports بر روی \(aqno\(aq، گزارش‌دهندهٔ html هیچ خروجی‌ای تولید نمی‌کند
.IP \(bu 2
رفع اشکال #4581: عدم نمایش هشدار فقدان docstring (کد C0111) در صورت بازنویسی (override) یک متد
.IP \(bu 2
رفع اشکال #4683: شمارش دوبرابری نویسه‌های غیر ASCII در صورت کدگذاری utf8
.IP \(bu 2
رفع اشکال #9018: اهمیت یافتن ترتیب متدها هنگام استفاده از defining\-attr\-method
.IP \(bu 2
رفع اشکال #4595: عدم رخداد هشدار ویرگول بدون فاصلهٔ بعد از آن برای ویرگول انتهایی
در تعریف list/tuple/dict
.IP \(bu 2
رفع اشکال #22585: [وصله] رفع هشدارهای man برای صفحهٔ راهنمای pyreverse.1
.IP \(bu 2
رفع اشکال #20067: بروز خطای AttributeError: \(aqNoneType\(aq object has no attribute \(aqname\(aq با دستور with
.UNINDENT
.SS "تازه‌های Pylint 0.20.0"
.sp
تاریخ انتشار: 2010\-03\-01
.INDENT 0.0
.IP \(bu 2
رفع اشکال #19498: رفع اشکال فایل دسته‌ای ویندوز (windows batch file)
.IP \(bu 2
رفع اشکال #19339: پروندهٔ pylint.el : متغیر ناموجود py\-mod\-map
(بسته شدن گزارش باگ دبیان \- #475939)
.IP \(bu 2
پیاده‌سازی #18860: پیام جدید W0199 برای عبارت assert (a, b)
.IP \(bu 2
پیاده‌سازی #9776: پیام \(aqW0150\(aq، عبارات break یا return در بلوک finally ممکن است
استثنا را ببلعند (پنهان کنند).
.IP \(bu 2
رفع اشکال #9263: متدهای __init__ و __new__ برای آرگومان‌های استفاده‌نشده بررسی می‌شوند
.IP \(bu 2
رفع اشکال #20991: نادیده گرفته شدن تعاریف دامنهٔ کلاس (class scope) در یک genexpr
.IP \(bu 2
رفع اشکال #5975: عدم شناسایی کلاس واسط انتزاعی (Abstract intermediate class) به‌عنوان یک کلاس انتزاعی
.IP \(bu 2
رفع اشکال #5977: عبارات yield و return شمارنده‌های جداگانه دارند؛ عدم نمایش مجدد R0911
(Too many return statements) هنگامی که یک تابع عبارات yield زیادی دارد
.IP \(bu 2
پیاده‌سازی #5564: نادیده گرفتن آرگومان‌های تابع / متد با پیشوند \(dq_\(dq در
شمارش آرگومان‌ها / متغیرهای محلی.
.IP \(bu 2
پیاده‌سازی #9982: پیام خطای اختصاصی E0711 هنگام پرتاب NotImplemented
.IP \(bu 2
حذف گزینهٔ \-\-cache\-size
.UNINDENT.SS "تازه‌های Pylint 0.19.0"
.sp
تاریخ انتشار: 2009\-12\-18
.INDENT 0.0
.IP \(bu 2
پیاده‌سازی #18947 و #5561: بررسی‌کننده برای آرگومان‌های تابع
.IP \(bu 2
گنجاندن بررسی‌کننده قالب‌بندی رشته James Lingard
.IP \(bu 2
گنجاندن فهرست‌بندی ساده پیام‌ها (شناسه‌ها) توسط Vincent Ferotin (#9791)
.IP \(bu 2
گزینه \-\-errors\-only دیگر خطای مهلک را پنهان نمی‌کند
.IP \(bu 2
گنجاندن وصله‌های James Lingard برای ++/\-\- و کلید تکراری در دیکشنری‌ها
.IP \(bu 2
گنجاندن وصله‌های James Lingard برای بررسی‌کننده آرگومان‌های فراخوانی تابع
.IP \(bu 2
بهبود کد و مستندات Flymake ارائه‌شده توسط Derek Harland
.IP \(bu 2
بازطراحی ساختار و اصلاح بررسی‌کننده وارد کردن‌ها (imports)
.IP \(bu 2
اصلاح #18862: مثبت کاذب E0601 با توابع lambda
.IP \(bu 2
اصلاح #8764: مثبت کاذب وجود بیش از یک دستور در یک خط با try/except/finally
.IP \(bu 2
اصلاح #9215: خطای متغیر تعریف‌نشده کاذب در تابع lambda
.IP \(bu 2
اصلاح برای مثبت کاذب w0108 (توسط Nathaniel)
.IP \(bu 2
اصلاح test/fulltest.sh
.IP \(bu 2
#5821 افزودن تابع کمکی برای اجرای pylint در فرایندی دیگر (وصله ارائه‌شده توسط Vincent Ferotin)
.UNINDENT
.SS "تازه‌های Pylint 0.18.0"
.sp
تاریخ انتشار: 2009\-03\-25
.INDENT 0.0
.IP \(bu 2
تست‌ها با python 2.4، 2.5 و 2.6 موفق بودند؛ 2.3 تست نشده است
.IP \(bu 2
اصلاح #8687، مثبت کاذب W0613 در تابع درونی
.IP \(bu 2
اصلاح #8350، مثبت کاذب C0322 در رشته چندخطی
.IP \(bu 2
اصلاح #8332: تنظیم شماره خط E0501 به نخستین خطی که نویسه غیر ascii در آن یافت شده است
.IP \(bu 2
جلوگیری از برخی موارد منفی کاذب E0203 / E0602 از طریق تشخیص به‌ترتیب AttributeError / NameError
.IP \(bu 2
پیاده‌سازی #4037: عدم صدور W0142 (جادوی * یا **) هنگامی که صرفاً از آرگومان‌های \fI/*\fP ارسال شده‌اند
.IP \(bu 2
تکمیل #5573: فهرست کامل‌تری از متدهای خاص، همچنین نادیده گرفتن W0613 برای متدهای داخلی python
.IP \(bu 2
عدم نمایش پیش‌فرض پیام‌های اطلاعاتی
.IP \(bu 2
ادغام وصله‌های Yuen Ho Wong روی فایل‌های Emacs lisp
.UNINDENT
.SS "تازه‌های Pylint 0.17.0"
.sp
تاریخ انتشار: 2009\-03\-19
.INDENT 0.0
.IP \(bu 2
بررسی نقطه‌ویرگول: انتقال W0601 به W0301
.IP \(bu 2
حذف rpython: حذف تمام بررسی‌کننده‌ها، ماژول‌ها و تست‌های rpython
.IP \(bu 2
سازگاری با astng 0.18: پشتیبانی از رابط‌های تغییریافته ماژول _ast
.UNINDENT
.SS "تازه‌های Pylint 0.16.0"
.sp
تاریخ انتشار: 2009\-01\-28
.INDENT 0.0
.IP \(bu 2
تغییر گزینه‌های [en|dis]able\-msg\-cat: تنها پذیرش دسته‌بندی‌های پیام مشخص‌شده با حرف اولشان (مانند IRCWEF) بدون نیاز به کاما به عنوان جداکننده
.IP \(bu 2
افزودن اسکریپت epylint.bat برای رفع مشکل نصب در Windows
.IP \(bu 2
پشتیبانی از setuptools/easy_install
.IP \(bu 2
گنجاندن نسخه اصلاح‌شده وصله Maarten ter Huurne برای جلوگیری از هشدار W0613 روی آرگومان‌های متد بازنویسی‌شده
.IP \(bu 2
پیاده‌سازی #5575 (حذف پیام بیهوده W0704) با افزودن پیش‌فرض W0704 به پیام‌های نادیده‌گرفته‌شده
.IP \(bu 2
پیام جدید W0108، بررسی عبارات مشکوک lambda (ارائه‌شده توسط Nathaniel Manista)
.IP \(bu 2
اصلاح W0631، مثبت کاذب گزارش‌شده توسط Paul Hachmann
.IP \(bu 2
اصلاح #6951: مثبت کاذب با W0104
.IP \(bu 2
اصلاح #6949
.IP \(bu 2
وصله‌هایی از Mads Kiilerich:
.IP \(bu 2
پیاده‌سازی #4691، خروج pylint با وضعیت بازگشتی غیر صفر در صورت صدور هر پیامی غیر از Information
.IP \(bu 2
اصلاح #3711 و #5626 (باگ تحلیل نام با دکوراتور و اعضای کلاس)
.IP \(bu 2
اصلاح #6954
.UNINDENT.SS "تازه‌های Pylint 0.15.2"
.sp
تاریخ انتشار: 2008\-10\-13
.INDENT 0.0
.IP \(bu 2
رفع #5672: رفتار عجیب W0706 (حذف W0706)
.IP \(bu 2
رفع #5998: مستندات به نشانی اینترنتی نادرستی برای فهرست پستی اشاره می‌کرد
.IP \(bu 2
رفع #6022: عدم نمایش پیام خطا در صورت نام‌گذاری نادرست ماژول‌ها
.IP \(bu 2
رفع #6040: ابزار pytest فایل test/func_test.py را اجرا نمی‌کند
.UNINDENT
.SS "تازه‌های Pylint 0.15.1"
.sp
تاریخ انتشار: 2008\-09\-15
.INDENT 0.0
.IP \(bu 2
رفع #4910: مقادیر پیش‌فرض در صفحهٔ راهنما (manpage) وجود ندارند
.IP \(bu 2
رفع #5991: فایل‌های مفقود در بستهٔ tarball نگارش 0.15.0
.IP \(bu 2
رفع #5993: ابزار epylint باید با python 2.3 کار کند
.UNINDENT
.SS "تازه‌های Pylint 0.15.0"
.sp
تاریخ انتشار: 2008\-09\-10
.INDENT 0.0
.IP \(bu 2
گنجاندن بستهٔ pyreverse و قابلیت تولید نمودار کلاس
.IP \(bu 2
اعمال وصلهٔ Stefan Rank برای پشتیبانی از واردسازی نسبی (relative import) در نگارش 2.4
.IP \(bu 2
گنجاندن راهنمای آموزشی Robert Kirkpatrick و رفع اشتباهات نگارشی
.IP \(bu 2
رفع اشکال در فعال‌سازی مجدد پیام‌ها
.IP \(bu 2
رفع #2473: فراخوانی pylint بر روی __init__.py (امیدوارانه)
.IP \(bu 2
بررسی‌کنندهٔ typecheck: گزینهٔ acquired\-members به نفع گزینهٔ عمومی‌تر generated\-members کنار گذاشته شد. اگر گزینهٔ zope تنظیم شده باشد، رفتار برنامه اکنون افزودن برخی مقادیر پیش‌فرض به generated\-members است.
.IP \(bu 2
یکپارچه‌سازی با Flymake: افزودن bin/epylint و elisp/pylint\-flymake.el
.UNINDENT
.SS "تازه‌های Pylint 0.14.0"
.sp
تاریخ انتشار: 2008\-01\-14
.INDENT 0.0
.IP \(bu 2
رفع #3733: پیام‌ها بسته به ترتیب نام فایل‌ها ظاهر یا ناپدید می‌شوند
.IP \(bu 2
رفع #4026: فایل pylint.el باید compile را require کند
.IP \(bu 2
رفع اشکال در گزارشگر رنگی (colorized reporter)، گزارش‌شده توسط Dave Borowitz
.IP \(bu 2
اعمال وصلهٔ Stefan Rank برای جلوگیری از مثبت کاذب W0410 هنگام وجود چند عبارت واردسازی \(dqfrom __future__\(dq
.IP \(bu 2
پیاده‌سازی #4012: علامت‌گذاری بک‌تیک (back tick) به عنوان منسوخ‌شده (پیام جدید W0333)
.IP \(bu 2
گزینهٔ جدید ignored\-class در بررسی‌کنندهٔ typecheck جهت صرف‌نظر از بررسی اعضا بر اساس نام کلاس (وصله ارائه‌شده توسط Thomas W Barr)
.UNINDENT
.SS "تازه‌های Pylint 0.13.2"
.sp
تاریخ انتشار: 2007\-06\-07
.INDENT 0.0
.IP \(bu 2
اصلاح گزینهٔ disable\-checker به‌گونه‌ای که بررسی‌کنندهٔ rpython را (که به‌طور پیش‌فرض غیرفعال است) تصادفاً فعال نکند
.IP \(bu 2
افزودن یادداشتی دربارهٔ افزونهٔ gedit به مستندات
.UNINDENT
.SS "تازه‌های Pylint 0.13.1"
.sp
تاریخ انتشار: 2007\-03\-02
.INDENT 0.0
.IP \(bu 2
رفع مشکل بسته‌بندی نامشخص در نگارش 0.13.0 که منجر به مفقود شدن تعدادی از فایل‌ها در توزیع شده بود
.UNINDENT.SS چه مواردی در Pylint 0.13.0 تازه است؟ (What\(aqs New in Pylint 0.13.0?)
.sp
تاریخ انتشار: 2007\-02\-28
.INDENT 0.0
.IP \(bu 2
بررسی‌کننده جدید RPython (Restricted Python) برای همراهان PyPy یا افرادی که مایلند با استفاده از مترجم پروژه PyPy یک نسخه کامپایل‌شده از برنامه پایتون خود را داشته باشند. برای اطلاعات بیشتر درباره PyPy یا RPython از \%<https://\:www\:.pypy\:.org> (قبلاً codespeak.net/pypy/) دیدن کنید.
.IP \(bu 2
پیام‌های جدید E0104 و E0105 معرفی شدند تا به‌ترتیب درباره \(dqreturn\(dq و \(dqyield\(dq در خارج از تابع یا متد هشدار دهند.
.IP \(bu 2
پیام جدید E0106 هنگامی که \(dqyield\(dq و \(dqreturn something\(dq در یک تابع یا متد با هم ترکیب شده باشند.
.IP \(bu 2
پیام جدید W0107 برای دستور غیرضروری pass.
.IP \(bu 2
پیام جدید W0614 برای تمایز قائل شدن بین \fBimport X\fP استفاده‌نشده و \fIfrom X import *\fP استفاده‌نشده (#3209، وصله ارائه‌شده توسط Daniel Drake).
.IP \(bu 2
گنجاندن وصله Daniel Drake برای ارائه پیام متفاوت E1003 به‌جای E1001 در زمانی که یک عضو مفقود پیدا شده اما شکست در استنتاج شناسایی شده است.
.IP \(bu 2
گزارش‌گر msvs برای گزارش شماره خط به سبک Visual Studio (#3285).
.IP \(bu 2
امکان استفاده درون‌خطی از گزینه disable\-all (#3218، وصله ارائه‌شده توسط Daniel Drake).
.IP \(bu 2
گزینه \-\-init\-hook برای فراخوانی کدهای دلخواه لازم جهت تنظیم محیط (مانند sys.path) (#3156).
.IP \(bu 2
یک وصله دیگر از Daniel برای رفع مشکل تجزیه گزینه‌های خط فرمان؛ این قطعاً نسخه DDrake خواهد بود :)
.IP \(bu 2
رفع #3184: خرابی و کرش هنگام وجود \(dqreturn\(dq خارج از تابع.
.IP \(bu 2
رفع #3205: مثبت کاذب در W0704.
.IP \(bu 2
رفع #3123: مثبت کاذب در W0212 روی متد ایستا (static method).
.IP \(bu 2
رفع #2485: مثبت کاذب در W0222.
.IP \(bu 2
رفع #3259: هنگامی که پیامی صریحاً فعال می‌شود، بررسی شود که بررسی‌کننده صادرکننده آن نیز فعال باشد.
.UNINDENT
.SS چه مواردی در Pylint 0.12.2 تازه است؟ (What\(aqs New in Pylint 0.12.2?)
.sp
تاریخ انتشار: 2006\-11\-23
.INDENT 0.0
.IP \(bu 2
رفع #3143: باگ W0233 با اشیای YES.
.IP \(bu 2
رفع #3119: خطای تفاضل یک واحدی (Off\-by\-one) در شمارش خطوط یک فایل.
.IP \(bu 2
رفع #3117: تسهیل بازنویسی sys.stdout برای گزارش‌گرها.
.IP \(bu 2
رفع #2508: مثبت کاذب در E0601 با lambda.
.IP \(bu 2
رفع #3125: مثبت کاذب E1101 و تکرار پیام. فقط بخش آخر واقعاً رفع شده است زیرا مثبت کاذب اولیه به دلیل تنظیم پویای صفت‌ها در کلاس decimal.Context است.
.IP \(bu 2
رفع #3149: مثبت کاذب‌های E0101 و معرفی E0100 برای متدهای سازنده (__init__) مولد (generator).
.IP \(bu 2
رفع برخی موارد مثبت کاذب در بررسی‌کننده قالب‌بندی.
.UNINDENT
.SS چه مواردی در Pylint 0.12.1 تازه است؟ (What\(aqs New in Pylint 0.12.1?)
.sp
تاریخ انتشار: 2006\-09\-25
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب قالب‌بندی در python >= 2.4 با دستورهای چندخطی.
.IP \(bu 2
رفع برخی مشکلات نسخه 2.5.
.IP \(bu 2
رفع باگ حوزه دید عبارت مولد (generator expression) (وابسته به astng 0.16.1).
.IP \(bu 2
حذف الزام به استفاده از __revision__.
.UNINDENT.SS چه مواردی در Pylint 0.12.0 جدید است؟
.sp
تاریخ انتشار: 2006\-08\-10
.INDENT 0.0
.IP \(bu 2
تغییرات کاربردپذیری:
.INDENT 2.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
گزینه‌های parseable، html و color اکنون توسط یک گزینه واحد output\-format مدیریت می‌شوند
.IP \(bu 2
گزینه‌های enable\-<checkerid> و disable\-all اکنون توسط دو گزینه (مانعة‌الجمع) enable\-checker و disable\-checker مدیریت می‌شوند که فهرستی از نام‌های checker جداشده با ویرگول را به عنوان مقدار می‌گیرند
.IP \(bu 2
تغییر نام گزینه debug\-mode به errors\-only
.UNINDENT
.UNINDENT
.UNINDENT
.IP \(bu 2
آغاز نگارش کتابچه راهنمای مرجع کاربر
.IP \(bu 2
پیام جدید W0212 برای دسترسی به عضو حفاظت‌شده از کد کلاینت (بستن #14081)
.IP \(bu 2
پیام‌های جدید W0105 و W0106 برگرفته از W0104 (عبارت به نظر بی‌اثر می‌رسد) به ترتیب برای زمانی که عبارت در واقع یک رشته باشد (که گاهی به جای کامنت برای مستندسازی استفاده می‌شود) یا یک عبارت خالی ناشی از یک نقطه‌ویرگول بی‌فایده
.IP \(bu 2
دسته‌بندی مجدد W0302 به C0302
.IP \(bu 2
رفع مشکل به طوری که پیام‌های سراسری (global) دیگر به آخرین ماژول تحلیل‌شده مرتبط نمی‌شوند (بستن #10106)
.IP \(bu 2
رفع برخی باگ‌های مربوط به غیرفعال‌سازی محلی پیام‌ها
.IP \(bu 2
رفع مشکل cr/lf در هنگام تولید فایل rc در پلتفرم‌های ویندوز
.UNINDENT
.SS چه مواردی در Pylint 0.11.0 جدید است؟
.sp
تاریخ انتشار: 2006\-04\-19
.INDENT 0.0
.IP \(bu 2
رفع خرابی ناشی از بررسی‌کننده exceptions در برخی موارد
.IP \(bu 2
رفع برخی هشدارهای مثبت کاذب در E1101 برای متدهای انتزاعی یا کلاس‌هایی که __getattr__ را تعریف می‌کنند
.IP \(bu 2
راه‌حل موقت برای جلوگیری از خطای \(dq_socketobject\(dq has not \(dqconnect\(dq member. مشکل اصلی این است که astng قادر به فهم کدی که برای ساخت شیء socket.socket با استفاده از exec به کار رفته نیست
.IP \(bu 2
افزودن گزینه‌ای در بررسی‌کننده similarity برای نادیده گرفتن docstringها، که به طور پیش‌فرض فعال است
.IP \(bu 2
گنجاندن وصله از Benjamin Niemann برای فعال‌سازی/غیرفعال‌سازی پیام‌ها در سطح بلوک
.UNINDENT
.SS چه مواردی در Pylint 0.10.0 جدید است؟
.sp
تاریخ انتشار: 2006\-03\-06
.INDENT 0.0
.IP \(bu 2
هشدار: این انتشار شامل برخی تغییرات در پیکربندی است (پایین را ببینید)، بنابراین اگر از فایل‌های پیکربندی استفاده می‌کنید ممکن است نیاز به بررسی و به‌روزرسانی آن‌ها داشته باشید
.IP \(bu 2
این انتشار نیازمند نسخه 0.15 یا بالاتر astng است (که شما را از خرابی‌های زیاد pylint نجات خواهد داد...)
.IP \(bu 2
پیام W0705 به E0701 تغییر دسته‌بندی داده شد و اکنون مشکلات وراثت بیشتری را شناسایی می‌کند، و یک مورد مثبت کاذب که در آن عبارت except خالی پس از گرفتن یک Exception می‌آمد برطرف شد (بستن #10422)
.IP \(bu 2
پیام‌های E0212 و E0214 (متد متالکلاس/کلاس باید mcs/cls را به عنوان آرگومان اول داشته باشد) به C0202 و C0203 تغییر دسته‌بندی داده شدند، زیرا این قاعده به اندازه \(dqself\(dq برای متدهای نمونه (E0213) جاافتاده نیست
.IP \(bu 2
پیام W0224 به F0220 تغییر دسته‌بندی داده شد (ناتوانی در حل رابط‌های پیاده‌سازی‌شده توسط یک کلاس)
.IP \(bu 2
یک بررسی‌کننده typecheck جدید، با معرفی بررسی‌های زیر:
.INDENT 2.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
پیام E1101، دسترسی به عضو ناموجود (پیاده‌سازی #10430)، که نیاز به E0201 را برطرف کرده و بنابراین برخی گزینه‌ها از بررسی‌کننده classes به این بررسی‌کننده منتقل شده‌اند
.IP \(bu 2
پیام E1102، فراخوانی یک شیء غیرقابل فراخوانی
.IP \(bu 2
پیام‌های E1111 و W1111 زمانی که یک انتساب روی یک فراخوانی تابع انجام می‌شود اما تابع استنتاج‌شده مقدار None را برمی‌گرداند (پیاده‌سازی #10431)
.UNINDENT
.UNINDENT
.UNINDENT
.IP \(bu 2
تغییرات در بررسی‌کننده base:
.INDENT 2.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
بررسی نام صفت‌های سطح ماژول و نمونه (گزینه‌های پیکربندی جدید const\-rgx و attr\-rgx) (پیاده‌سازی #10209 و #10440)
.IP \(bu 2
متغیرهای list comprehension و عبارت‌های تولیدکننده (generator expression) عبارت باقاعده مخصوص خود را دارند (گزینه inlinevar\-rgx) (پیاده‌سازی #9146)
.IP \(bu 2
بررسی C0101 به همراه گزینه min\-name\-length آن حذف شده است (به هر حال این مورد می‌تواند در عبارت باقاعده تعیین شود...)
.IP \(bu 2
پیام‌های W0103 و W0121 اکنون توسط بررسی‌کننده variables مدیریت می‌شوند (W0103 اکنون W0603 است و W0604 به پیام‌های مختلف تقسیم شده است)
.IP \(bu 2
پیام‌های W0131 و W0132 به ترتیب به C0111 و C0112 تغییر دسته‌بندی داده شدند
.IP \(bu 2
پیام جدید W0104 برای عبارت بدون اثر
.UNINDENT
.UNINDENT
.UNINDENT
.IP \(bu 2
پشتیبانی از عبارت باقاعده برای dummy\-variables (گزینه dummy\-variables\-rgx جایگزین dummy\-variables می‌شود) (پیاده‌سازی #10027)
.IP \(bu 2
مدیریت بهتر عبارت global، پیام‌های W0602، W0603 و W0604 را ببینید (پیاده‌سازی #10344 و #10236)
.IP \(bu 2
گزینه \-\-debug\-mode، تمام بررسی‌کننده‌های فاقد پیام خطا را غیرفعال کرده و بقیه را برای نمایش صرفاً خطا فیلتر می‌کند
.IP \(bu 2
رفع برخی موارد مثبت کاذب در R0201 (متد می‌تواند یک تابع باشد)
.UNINDENT.SS چه مواردی در Pylint 0.9.0 جدید است؟
.sp
تاریخ انتشار: 2006\-01\-10
.INDENT 0.0
.IP \(bu 2
به‌روزرسانی‌های فراوان جهت هماهنگی با تغییرات API در astng 0.14؛ بنابراین پیش از استفاده از این نسخه pylint، بسته logilab\-astng نسخه 0.14 یا بالاتر را نصب کنید.
.IP \(bu 2
بررسی‌کننده شماره ۱۰! newstyle به جستجوی مشکلات مربوط به استفاده از کلاس‌های سبک قدیم / سبک جدید (old style / new style) می‌پردازد (بر پایه قابلیت تشخیص سبک جدید در astng 0.14).
.IP \(bu 2
گزینه جدید \(aqload\-plugins\(aq برای بارگذاری افزایه‌های جانبی pylint (قابل استفاده از خط فرمان یا از طریق فایل پیکربندی) (پیاده‌سازی #10031).
.IP \(bu 2
بررسی وجود فایل \(dqpylintrc\(dq در دایرکتوری کاری فعلی پیش از استفاده از فایل مشخص‌شده در متغیر محیطی PYLINTRC یا فایل‌های پیش‌فرض ~/.pylintrc و /etc/pylintrc.
.IP \(bu 2
رفع مثبت کاذب در W0706 (Identifier used to raise an exception is assigned...) و پرتاب مجدد نمونه استثنای دریافت‌شده.
.IP \(bu 2
رفع مثبت کاذب در E0611 (No name get in module blabla) هنگام دسترسی به __dict__ یک کلاس.
.IP \(bu 2
رفع چند مورد مثبت کاذب در E0203 (\(dqaccess to member before its definition\(dq).
.IP \(bu 2
رفع مثبت کاذب در E0214 (\(dqmetaclass method first argument should be mcs) هنگام استفاده از staticmethod بر روی یک metaclass.
.IP \(bu 2
رفع مشکل بسته‌بندی که در آن دایرکتوری test/regrtest_data وجود نداشت.
.IP \(bu 2
هشدار W0212 (method could be a function) در دسته‌بندی REFACTOR تحت عنوان R0201 بازطبقه‌بندی شد، و دیگر زمانی که یک متد، متد انتزاعیِ یک کلاس والد را رونویسی (override) می‌کند در نظر گرفته نمی‌شود.
.IP \(bu 2
گنجاندن نام ماژول در W0401 (wildcard import)، طبق پیشنهاد Amaury.
.IP \(bu 2
هنگام استفاده از \(aq\-\-parseable\(aq، در صورتی که مسیرها درون زیردایرکتوریِ دایرکتوری کاری فعلی باشند، به صورت نسبی نسبت به آن نوشته می‌شوند (#9789).
.IP \(bu 2
دستور \(aqpylint \-\-version\(aq نگارش‌های logilab\-astng و logilab\-common را نمایش می‌دهد.
.IP \(bu 2
اصلاح pylint.el جهت مدیریت نویسه فاصله در نام فایل‌ها.
.IP \(bu 2
اصلاحات متفرقه در سبک نگارش (lint style).
.UNINDENT
.SS چه مواردی در Pylint 0.8.1 جدید است؟
.sp
تاریخ انتشار: 2005\-11\-07
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب \(dqdeprecated module\(dq زمانی که کد، ماژولی را وارد (import) می‌کند که نام آن با نام یک ماژول منسوخ‌شده آغاز می‌شود (بستن #10061).
.IP \(bu 2
رفع مثبت کاذب \(dqmodule has no name __dict__\(dq (بستن #10039).
.IP \(bu 2
رفع مثبت کاذب \(dqaccess to undefined variable __path__\(dq (بستن #10065).
.IP \(bu 2
رفع مثبت کاذب \(dqexplicit return in __init__\(dq هنگامی که دستور return در واقع درون یک تابع داخلی قرار دارد (بستن #10075).
.UNINDENT
.SS چه مواردی در Pylint 0.8.0 جدید است؟
.sp
تاریخ انتشار: 2005\-10\-21
.INDENT 0.0
.IP \(bu 2
بررسی وجود نام‌های واردشده از یک ماژول در خود ماژول (E0611)، وصله ارائه‌شده توسط Amaury Forgeot d\(aqArc.
.IP \(bu 2
چاپ یک هشدار (W0212) برای متدهایی که می‌توانند یک تابع باشند (پیاده‌سازی #9100).
.IP \(bu 2
گزینه جدید \-\-defining\-attr\-methods در بررسی‌کننده کلاس‌ها.
.IP \(bu 2
گزینه جدید \-\-acquired\-members در بررسی‌کننده کلاس‌ها، مورد استفاده هنگام \-\-zope=yes جهت جلوگیری از مثبت کاذب در ویژگی‌های اکتسابی (که با این گزینه جدید فهرست می‌شوند) (بستن #8616).
.IP \(bu 2
تولید یک خطای E0602 به ازای هر بار استفاده از یک متغیر تعریف‌نشده (پیش‌تر، تنها یک خطا برای اولین استفاده ثبت می‌شد و نه برای موارد پس از آن) (پیاده‌سازی #1000).
.IP \(bu 2
امکان ذخیره‌سازی گزینه profile.
.IP \(bu 2
اصلاح فایل .bat در ویندوز، وصله ارائه‌شده توسط Amaury Forgeot d\(aqArc.
.IP \(bu 2
رفع یک مورد مثبت کاذب دیگر برای E0601 (access before definition) با حلقه‌های for مانند \(dqfor i in range(10): print i\(dq (آزمون func_noerror_defined_and_used_on_same_line).
.IP \(bu 2
رفع مثبت کاذب برای E0201 (undefined member) هنگام دسترسی به __name__ در یک شیء کلاس.
.IP \(bu 2
اصلاح ترتیب پیمایش بررسی‌کننده‌های astng.
.IP \(bu 2
رفع اشکال در بررسی‌کننده قالب‌بندی هنگام تجزیه فایلی از یک پلتفرم با نویسه‌های خط جدیدِ متفاوت (بستن #9239).
.IP \(bu 2
اصلاح عبارت باقاعده تشخیص کدگذاری (encoding).
.IP \(bu 2
اصلاح پردازش \-\-rcfile (پشتیبانی از \-\-rcfile=file، بستن #9590).
.UNINDENT.SS تازه‌های Pylint 0.7.0
.sp
تاریخ انتشار: 2005\-05\-27
.INDENT 0.0
.IP \(bu 2
هشدار: pylint دیگر یک زیربسته از logilab نیست. کاربران ممکن است نیاز داشته باشند دایرکتوری قدیمی logilab/pylint را به صورت دستی حذف کنند.
.IP \(bu 2
معرفی گزینه جدید \-\-additional\-builtins برای مدیریت توابع توکار (builtins) تعریف‌شده توسط کاربر
.IP \(bu 2
گزینه \-\-reports اکنون دارای نام مستعار کوتاه \-r است، و \-i برای \-\-include\-ids
.IP \(bu 2
رفع باگی در بررسی‌کننده متغیرها (variables checker) که ممکن بود هنگام تعریف و استفاده از متغیرها در یک دستور مشابه، موجب مثبت کاذب شود (تست func_noerror_defined_and_used_on_same_line)
.IP \(bu 2
این بار، رفع واقعی مشکل \(dqdisable\-msg در فایل پیکربندی\(dq، تستی به unittest_lint اضافه شد
.IP \(bu 2
رفع باگ در \-\-list\-messages و python \-OO
.IP \(bu 2
رفع احتمال مثبت کاذب برای W0201
.UNINDENT
.SS تازه‌های Pylint 0.6.4
.sp
تاریخ انتشار: 2005\-04\-14
.INDENT 0.0
.IP \(bu 2
امکان تجزیه فایل‌های بدون پسوند هنگامی که مسیری در خط فرمان مشخص شده است (تست noext)
.IP \(bu 2
عدم توقف در صورت ناتوانی در خواندن یک گزینه درون‌خطی (برای نمونه داخل یک ماژول)، تنها ایجاد یک پیام اطلاعاتی (تست func_i0010)
.IP \(bu 2
پیام جدید E0103 برای break یا continue در خارج از حلقه (بسته شدن #8883، تست func_continue_not_in_loop)
.IP \(bu 2
رفع باگ در بررسی‌کننده متغیرها که موجب عدم شناسایی برخی از خطاهای نام واقعی می‌شد (بسته شدن #8884، تست func_nameerror_on_string_substitution)
.IP \(bu 2
رفع باگ در بررسی‌کننده کلاس‌ها که در صورت انتساب \(dqobject\(dq در کلاسی که از آن ارث‌بری می‌کند باعث از کار افتادن pylint می‌شد (تست func_noerror_object_as_class_attribute)
.IP \(bu 2
رفع مشکل بررسی‌کننده کدهای مشابه (similar checker) هنگامی که گزینه‌های مربوطه در یک فایل پیکربندی تعریف شده‌اند
.IP \(bu 2
گزینه جدید \-\-generate\-man برای تولید صفحه راهنمای pylint (نیازمند جدیدترین نسخه logilab.common (>= 0.9.3))
.IP \(bu 2
بسته‌بندی صفحه راهنمای تولید‌شده
.UNINDENT
.SS تازه‌های Pylint 0.6.3
.sp
تاریخ انتشار: 2005\-02\-24
.INDENT 0.0
.IP \(bu 2
رفع مشکل حوزه دید (scope) که می‌توانست باعث مثبت کاذب و منفی صادق در E0602 شود
.IP \(bu 2
رفع مشکل برخی گزینه‌ها مانند disable\-msg که هنگام دریافت از فایل پیکربندی باعث ایجاد خطا می‌شدند
.UNINDENT
.SS تازه‌های Pylint 0.6.2
.sp
تاریخ انتشار: 2005\-02\-16
.INDENT 0.0
.IP \(bu 2
رفع مثبت کاذب در E0201 (\(dqدسترسی به عضو تعریف‌نشده\(dq) با فرامعمارها (metaclasses)
.IP \(bu 2
رفع مثبت کاذب در E0203 (\(dqدسترسی به عضو پیش از تعریف آن\(dq) هنگامی که ویژگی‌ها در یک کلاس والد تعریف شده‌اند
.IP \(bu 2
رفع مثبت کاذب در W0706 (\(dqشناسه مورد استفاده برای ایجاد استثنا منتسب‌شده به...\(dq)
.IP \(bu 2
اصلاح تفسیر \(dqt\(dq به عنوان مقدار متغیر پیکربندی indent\-string
.IP \(bu 2
اصلاح \-\-rcfile به گونه‌ای که \-\-rcfile=pylintrc نیز معتبر باشد (در نسخه‌های پیشین تنها \-\-rcfile pylintrc کار می‌کرد)
.IP \(bu 2
نمونه جدید بررسی‌کننده خام (raw checker) در دایرکتوری examples/
.UNINDENT.SS چه چیزهایی در Pylint 0.6.1 جدید است؟
.sp
تاریخ انتشار: 2005\-02\-04
.INDENT 0.0
.IP \(bu 2
گزینه جدید \-\-rcfile برای تعیین فایل پیکربندی بدون نیاز به متغیر محیطی PYLINTRC
.IP \(bu 2
افزودن یک ماژول نمونه برای بررسی‌کننده (checker) سفارشی pylint (دایرکتوری example/ را ببینید)
.IP \(bu 2
چندین اصلاح برای هماهنگی با تغییرات common 0.9.1 (با این حال همچنان باید با common 0.9.0 کار کند، اگرچه ارتقا توصیه می‌شود)
.UNINDENT
.SS چه چیزهایی در Pylint 0.6.0 جدید است؟
.sp
تاریخ انتشار: 2005\-01\-20
.INDENT 0.0
.IP \(bu 2
اصلاح مجدد حالت Emacs برای pylint
.IP \(bu 2
عدم نمایش traceback هنگام اجرای دستور ساده \(dqpylint\(dq
.IP \(bu 2
رفع باگی که ممکن بود هنگام تحلیل کلاس‌های والد موجب کرش شود
.IP \(bu 2
رفع مشکلات بررسی‌کننده قالب‌بندی (format checker): عدم توقف روی فایل‌های حاوی چندین CR، جلوگیری از مثبت کاذب خطاهای C0322، C0323 و C0324 در رشته‌های نقل‌قول سه‌گانه دارای علامت نقل‌قول در داخل خود
.IP \(bu 2
تشخیص صحیح دسترسی به عضوی که بعداً در متد __init__ تعریف شده است
.IP \(bu 2
وابستگی کنونی به common 0.8.1 برای حل مشکل تحلیل رابط‌ها (بستن #8606)
.IP \(bu 2
گزینه جدید \-\-list\-msgs برای توصیف بررسی‌کننده‌های موجود و پیام‌های آن‌ها
.IP \(bu 2
افزودن مستندات مخصوص ویندوز به فایل README، مشارکت از طرف Brian van den Broek
.IP \(bu 2
به‌روزرسانی doc/features.txt (این فایل اکنون با استفاده از گزینه \-\-list\-msgs تولید می‌شود)، مدخل‌های بیشتر در FAQ
.IP \(bu 2
بهبود پوشش آزمون‌ها
.UNINDENT
.SS چه چیزهایی در Pylint 0.5.0 جدید است؟
.sp
تاریخ انتشار: 2004\-10\-19
.INDENT 0.0
.IP \(bu 2
اجتناب از درون‌ریزی (import) ماژول‌های تحلیل‌شده!
.IP \(bu 2
دسته‌بندی‌های پیام جدید Refactor و Convention. برخی از هشدارها به این دسته‌بندی‌های جدید منتقل شدند
.IP \(bu 2
افزوده شدن \(dqsimilar\(dq، ابزاری برای یافتن خطوط کپی و جای‌گذاری شده کد، هم به صورت ابزار خط فرمان مستقل و هم یکپارچه‌شده به عنوان یک بررسی‌کننده در pylint
.IP \(bu 2
امکان گزارش وابستگی‌های درون‌ریزی توسط بررسی‌کننده imports به صورت یک گراف dot
.IP \(bu 2
بررسی‌کننده جدیدی که اغلب موارد تشخیص Refactor را گردآوری می‌کند (همراه با برخی معیارهای جدید)
.IP \(bu 2
امکان ذخیره گزینه‌های خط فرمان بیشتری در فایل پیکربندی
.IP \(bu 2
رفع باگ مربوط به تعداد کل / مستندسازی‌نشده متدها
.UNINDENT
.SS چه چیزهایی در Pylint 0.4.2 جدید است؟
.sp
تاریخ انتشار: 2004\-07\-08
.INDENT 0.0
.IP \(bu 2
اصلاح حالت Emacs برای pylint
.IP \(bu 2
اصلاح بررسی‌کننده‌های کلاس‌ها جهت مدیریت رابط‌های twisted
.UNINDENT
.SS چه چیزهایی در Pylint 0.4.1 جدید است؟
.sp
تاریخ انتشار: 2004\-05\-14
.INDENT 0.0
.IP \(bu 2
اصلاح اسکریپت setup.py برای پشتیبانی از bdist_winst (البته نصاب تولیدشده آزمایش نشده است...) همراه با فایل ضروری logilab/__init__.py
.IP \(bu 2
اصلاح قرارداد نام‌گذاری فایل طبق پیشنهاد Andreas Amoroso
.IP \(bu 2
رفع باگ عجیب کرش با نام‌های نامعتبر متدها
.UNINDENT.SS چه مواردی در Pylint 0.4.0 جدید است؟
.sp
تاریخ انتشار: 2004\-05\-10
.INDENT 0.0
.IP \(bu 2
اصلاح مسیر فایل همراه با \-\-parsable
.IP \(bu 2
گزینهٔ \-\-parsable به \-\-parseable تغییر نام یافت
.IP \(bu 2
افزودن وصله از Andreas Amoroso جهت ارسال پیام‌های خروجی به فایل به جای خروجی استاندارد
.IP \(bu 2
افزودن Run به فهرست نام‌های معتبر متغیر
.IP \(bu 2
اصلاح عبارت باقاعدهٔ نام‌های متغیر و بررسی نام‌های کلاس‌های محلی
.IP \(bu 2
مدیریت پایه‌ای فراکلاس‌ها (metaclasses)
.IP \(bu 2
اعمال no\-docstring\-rgx از این پس بر روی کلاس‌ها نیز
.IP \(bu 2
گزینه‌ای جدید برای مشخص کردن عبارت باقاعده‌ای متفاوت برای متدها نسبت به توابع
.IP \(bu 2
عدم نمایش گزارش ارزیابی هنگامی که هیچ دستوری تحلیل نشده است
.IP \(bu 2
رفع خرابی (crash) هنگام وجود کلاس تودرتو درون یک متد
.IP \(bu 2
اصلاح بررسی‌کنندهٔ قالب‌بندی جهت مدیریت رشته‌های با سه نقل‌قول و خطوط ترکیب کد و توضیح
.IP \(bu 2
استفاده از logilab.common.ureports برای چیدمان گزارش‌ها
.UNINDENT
.SS چه مواردی در Pylint 0.3.3 جدید است؟
.sp
تاریخ انتشار: 2004\-02\-17
.INDENT 0.0
.IP \(bu 2
افزودن یک خروجی متنی قابل تجزیه (parsable)، هنگام استفاده از گزینهٔ \-\-parsable
.IP \(bu 2
افزودن یک حالت Emacs با استفاده از این خروجی، موجود در پوشهٔ elisp توزیع
.IP \(bu 2
اصلاح برخی اشتباهات نگارشی در پیام‌ها
.IP \(bu 2
تغییر مقادیر گزینه include\-ids به yn، و مجاز کردن آن در فایل پیکربندی
.IP \(bu 2
جلوگیری از توقف ناگهانی به دلیل فایل‌های آمار آسیب‌دیده
.IP \(bu 2
رفع باگ در بررسی‌کنندهٔ قالب‌بندی که ممکن بود اجرای pylint را متوقف کند
.IP \(bu 2
ارائه اسکریپت‌هایی برای unix و windows جهت اجرای رابط گرافیکی حداقلی tk برای pylint
.UNINDENT
.SS چه مواردی در Pylint 0.3.2 جدید است؟
.sp
تاریخ انتشار: 2003\-12\-23
.INDENT 0.0
.IP \(bu 2
گریز دادن کدهای HTML در پیام‌های گزارشگر HTML (گزارش باگ توسط Juergen Hermann)
.IP \(bu 2
افزودن \(dqTODO\(dq به فهرست برچسب‌های یادداشت پیش‌فرض
.IP \(bu 2
افزودن \(dqrexec\(dq به فهرست ماژول‌های منسوخ‌شدهٔ پیش‌فرض
.IP \(bu 2
اصلاح اشتباهات نگارشی در برخی پیام‌ها
.UNINDENT
.SS چه مواردی در Pylint 0.3.1 جدید است؟
.sp
تاریخ انتشار: 2003\-12\-05
.INDENT 0.0
.IP \(bu 2
رفع باگ در بررسی‌کننده‌های قالب‌بندی و کلاس‌ها
.IP \(bu 2
حذف دستور print از بررسی‌کننده‌های وارد کردن (imports)
.IP \(bu 2
ارائه یک رابط کاربری گرافیکی ساده بر پایه tk، که در درجه اول برای کاربران windows مفید است
.UNINDENT.SS چه مواردی در Pylint 0.3.0 جدید است؟
.sp
تاریخ انتشار: 2003\-11\-20
.INDENT 0.0
.IP \(bu 2
بررسی‌کننده جدید استثناها، برای بررسی استثناهای رشته‌ای و عبارت‌های except خالی.
.IP \(bu 2
بررسی‌کننده واردسازی‌ها، وارد کردن مجدد ماژول‌ها را بررسی می‌کند.
.IP \(bu 2
بررسی‌کننده کلاس‌ها فراخوانی __init__ اجداد و بازنویسی نشدن متدهای انتزاعی را بررسی می‌کند. این بررسی‌کننده دیگر به واردسازی‌های استفاده‌نشده در فایل‌های __init__ ایرادی نمی‌گیرد و گزینه جدید ignore\-interface\-methods را ارائه می‌دهد که هنگام استفاده از پیاده‌سازی Interface در zope در پروژه‌تان مفید است.
.IP \(bu 2
بررسی‌کننده پایه، فراخوانی‌های غیرمجاز توابع توکار (کنترل‌شده توسط گزینه bad\-functions) و استفاده از * و ** را بررسی می‌کند.
.IP \(bu 2
بررسی‌کننده قالب‌بندی استفاده از <> و \(dql\(dq را به‌عنوان نشانگر long int بررسی می‌کند.
.IP \(bu 2
تغییرات عمده در API داخلی.
.IP \(bu 2
استفاده از بازنویسی astng بر پایه compiler.ast.
.IP \(bu 2
افزوده شدن شناسه یکتا برای پیام‌ها، طبق پیشنهاد Wolfgang Grafen.
.IP \(bu 2
افزوده شدن شناسه یکتا برای گزارش‌ها.
.IP \(bu 2
امکان دریافت چند ماژول یا فایل به‌عنوان آرگومان.
.IP \(bu 2
گزینه‌های جدید خط فرمان: \-\-disable\-msg، \-\-enable\-msg،
\-\-help\-msg، \-\-include\-ids، \-\-reports، \-\-disable\-report، \-\-cache\-size.
.IP \(bu 2
گزینه \-\-version نسخه مفسر python را نشان می‌دهد.
.IP \(bu 2
حذف برخی گزینه‌ها که اکنون با [en|dis]able\-msg یا
disable\-report جایگزین شده‌اند.
.IP \(bu 2
خواندن گزینه‌های disable\-msg و enable\-msg در فایل‌های مبدأ (باید در توضیحات بالای فایل و به شکل
\(dq# pylint: disable\-msg=W0402\(dq باشد).
.IP \(bu 2
پیام جدید برای ماژول‌هایی که خودشان را وارد می‌کنند به‌جای پیام \(dqcyclic
import\(dq.
.IP \(bu 2
رفع باگ مربوط به واردسازی‌های نسبی و چرخه‌ای.
.IP \(bu 2
رفع باگ در بررسی‌کننده واردسازی‌ها (چرخه‌ها همیشه شناسایی نمی‌شدند).
.IP \(bu 2
اصلاحات بیشتر در بررسی‌کننده قالب‌بندی: عدم بررسی توضیحات و docstring،
و بررسی نخستین خط پس از دندانه‌گذاری.
.IP \(bu 2
نام‌های مجاز/ممنوع اکنون بر تمام شناسه‌ها اعمال می‌شوند نه فقط متغیرها،
بنابراین گزینه پیکربندی از (good|bad)\-variable\-names به (good|bad)\-names تغییر یافت.
.IP \(bu 2
افزودن string، rexec و Bastion به فهرست پیش‌فرض ماژول‌های
منسوخ‌شده.
.IP \(bu 2
چاپ نکردن هشدار تعریف مجدد برای تابع/کلاس/متدِ تعریف‌شده
در شاخه‌های ناسازگار با هم (mutually exclusive).
.UNINDENT
.SS چه مواردی در Pylint 0.2.1 جدید است؟
.sp
تاریخ انتشار: 2003\-10\-10
.INDENT 0.0
.IP \(bu 2
افزوده شدن برخی مستندات و رفع چند غلط املایی.
.IP \(bu 2
تنظیم متغیر محیطی PYLINT_IMPORT به 1 در طول اجرای pylint.
.IP \(bu 2
بررسی وجود داشتن متغیرهای \(dqواردشده\(dq با استفاده از دستور global.
.IP \(bu 2
مشکلات دندانه‌گذاری اکنون به‌جای خطا به هشدار تبدیل شده‌اند.
.IP \(bu 2
اصلاح checkers.initialize برای تلاش جهت بارگذاری تمام فایل‌ها با پسوند شناخته‌شده python (وصله از wrobell).
.IP \(bu 2
اصلاح شماری از پیام‌ها.
.IP \(bu 2
اصلاح فایل پیکربندی نمونه.
.IP \(bu 2
اصلاح گزینه bad\-construction.
.IP \(bu 2
اصلاح بررسی‌کننده کدگذاری (encoding checker).
.IP \(bu 2
اصلاح بررسی‌کننده قالب‌بندی (format checker).
.UNINDENT.SS چه مواردی در Pylint 0.2.0 جدید است؟
.sp
تاریخ انتشار: 2003\-09\-12
.INDENT 0.0
.IP \(bu 2
بررسی‌کننده جدید برای کدگذاری منبع / FIXME (بر اساس pep 263)
.IP \(bu 2
گزینه جدید \-\-zope که واردسازی Zope را فعال می‌کند. برای بررسی کدهای محصولات Zope مفید است.
.IP \(bu 2
گزینه جدید \-\-comment که یادداشت ارزیابی نظر را فعال می‌کند (به طور پیش‌فرض غیرفعال است).
.IP \(bu 2
برطرف‌سازی انبوهی از باگ‌ها
.IP \(bu 2
زیرساخت آسان برای آزمون‌های کارکردی
.UNINDENT
.SS چه مواردی در Pylint 0.1.2 جدید است؟
.sp
تاریخ انتشار: 2003\-06\-18
.INDENT 0.0
.IP \(bu 2
انتشار رفع باگ
.IP \(bu 2
حذف وابستگی به pyreverse
.UNINDENT
.SS چه مواردی در Pylint 0.1.1 جدید است؟
.sp
تاریخ انتشار: 2003\-06\-01
.INDENT 0.0
.IP \(bu 2
قابلیت‌های بسیار بیشتر!
.UNINDENT
.SS چه مواردی در Pylint 0.1 جدید است؟
.sp
تاریخ انتشار: 2003\-05\-19
.INDENT 0.0
.IP \(bu 2
انتشار اولیه
.UNINDENT
.SS پرسش‌های متداول
.SS چگونه Pylint را نصب کنم؟
.sp
برای استفاده در خط فرمان، pylint به صورت زیر نصب می‌شود:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pip install pylint
.EE
.UNINDENT
.UNINDENT
.sp
یا اگر می‌خواهید املا را نیز با \fBenchant\fP بررسی کنید (ممکن است نیاز به نصب کتابخانه C مربوط به enchant داشته باشید \%<https://\:pyenchant\:.github\:.io/\:pyenchant/\:install\:.html#\:installing-the-enchant-c-library>):
.INDENT 0.0
.INDENT 3.5
.sp
.EX
pip install pylint[spelling]
.EE
.UNINDENT
.UNINDENT
.sp
این ابزار همچنین می‌تواند در اغلب ویرایشگرها یا IDEها ادغام شود. اطلاعات بیشتر را می‌توانید در مستندات بیابید \%<https://\:pylint\:.readthedocs\:.io/\:en/\:latest/\:user_guide/\:installation/\:index\:.html>\&.
.SS چگونه در Pylint مشارکت کنم؟
.sp
ما از انواع مشارکت‌ها استقبال می‌کنیم؛ مانند به‌روزرسانی مستندات، کدهای جدید، بررسی گزارش‌های مشکل برای موارد تکراری یا اعلام به ما جهت بستن آن‌ها، تأیید پابرجا بودن مشکلات، ایجاد گزارش مشکل در صورت یافتن باگ یا درخواست یک ویژگی جدید \%<https://\:pylint\:.readthedocs\:.io/\:en/\:latest/\:contact\:.html#\:bug-reports-feedback> و غیره. از هر مشارکتی بسیار قدردانی می‌شود!
.sp
لطفاً از منشور اخلاقی \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:blob/\:main/\:CODE_OF_CONDUCT\:.md> پیروی کرده و در صورتی که مایل به مشارکت در کد هستید، راهنمای مشارکت‌کنندگان \%<https://\:pylint\:.readthedocs\:.io/\:en/\:latest/\:development_guide/\:contribute\:.html> را بررسی کنید.
.SS آیا Pylint از طرح نسخه‌گذاری خاصی پیروی می‌کند؟
.sp
بخش ارتقای pylint را در راهنمای نصب ببینید \%<#\:upgrading-pylint>\&.
.SS چگونه نام متناظر با یک گزینه مشخص در خط فرمان را پیدا کنم؟
.sp
مستندات پیکربندی را ببینید \%<#\:all-configurations-options>\&..SS قالب فایل پیکربندی چیست؟
.sp
فایل پیکربندی می‌تواند یک فایل \fBini\fP یا \fBtoml\fP باشد. برای مشاهده فهرست کامل گزینه‌های ممکن \%<#\:all-options>\& را ببینید.
.SS چگونه یک پیام خاص را غیرفعال کنیم؟
.sp
برای جزئیات و مثال‌ها، بخش کنترل پیام‌ها \%<#\:message-control> را بخوانید.
.SS ‏Pylint به کد من از ۱۰ نمره منفی داد. این نمی‌تواند درست باشد!
.sp
پیش از Pylint 2.13.0، فرمول امتیازی که به‌صورت پیش‌فرض استفاده می‌شد کران پایینی
نداشت. فرمول امتیاز پیش‌فرض جدید عبارت است از:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
max(0, 0 if fatal else 10.0 \- ((float(5 * error + warning + refactor + convention) / statement) * 10))
.EE
.UNINDENT
.UNINDENT
.sp
اگر پروژه شما شامل یک فایل پیکربندی است که توسط نسخه قدیمی‌تری از
Pylint ایجاد شده است، می‌توانید \fBevaluation\fP را روی عبارت بالا تنظیم کنید تا رفتار
جدید را به دست آورید. همچنین، از آنجا که مقادیر منفی از نظر فنی همچنان پشتیبانی می‌شوند،
\fBevaluation\fP می‌تواند روی نسخه‌ای از عبارت بالا تنظیم شود که
حداقل صفر را اعمال نمی‌کند.
.SS چگونه از دریافت هشدارهای آرگومان استفاده‌نشده برای APIهایی که در کنترلم نیستند جلوگیری کنم؟
.sp
پیشوند نام callback را با \fIcb_\fP (مخفف callback) قرار دهید، مانند cb_onclick(...). با
انجام این کار، استفاده از آرگومان‌ها بررسی نخواهد شد. راه‌حل دیگر
استفاده از یکی از نام‌های تعریف‌شده در متغیر پیکربندی \(dqdummy\-variables\(dq
برای آرگومان‌های استفاده‌نشده است (به‌صورت پیش‌فرض \(dq_\(dq و \(dqdummy\(dq).
.SS چرا دسته‌ای از پیام‌ها به‌صورت پیش‌فرض غیرفعال هستند؟
.sp
یا به این دلیل که مستعد مثبت کاذب هستند، یا به این خاطر که بیش از حد سلیقه‌ای
هستند و نباید جزو پیام‌های پیش‌فرض قرار گیرند.
.sp
می‌توانید افزونه‌ای را که باید صراحتاً بارگذاری کنید در مرجع فنی \%<#\:optional-checkers>\& مشاهده کنید.
.SS می‌خواهم pylint را با هر بار فشردن کلید در محیط توسعه (IDE) اجرا کنم. چگونه این کار را انجام دهم؟
.sp
مجموعه کامل بررسی‌های Pylint هرگز آن‌قدر سریع نخواهد بود که با هر فشردن کلید اجرا شود.
با این حال، برخی از IDEها می‌توانند pylint را هنگام باز کردن یا ذخیره کردن فایل‌ها اجرا کنند.
برای مثال، افزونه مایکروسافت برای VS Code \%<https://\:github\:.com/\:microsoft/\:vscode-pylint#\:readme>\& را ببینید.
.sp
با این اوصاف، pylint بهترین عملکرد را برای بررسی هنگام ذخیره در پروژه‌های کوچک، کارهای
ادغام مداوم (CI)، یا قلاب \fBpre\-push\fP در گیت برای پروژه‌های بزرگ دارد. هرچه مخزن شما
بزرگ‌تر باشد، pylint کندتر خواهد بود.
.sp
اگر می‌خواهید pylint را برای این نوع کاربردها سریع‌تر کنید، می‌توانید از گزینه \fB\-\-errors\-only\fP
استفاده کنید که تمام بررسی‌های بازسازی (refactor)، قراردادها (convention) و هشدارها را حذف می‌کند. همچنین می‌توانید
بررسی‌هایی با پیچیدگی ذاتا بالا را که نیازمند تحلیل کل پایگاه کد هستند، مانند
\fBduplicate\-code\fP یا \fBcyclic\-import\fP غیرفعال کنید (این فهرست کامل نیست).
.SS چرا هنگام تلاش برای موازی‌سازی pylint به نتایج غیرقطعی می‌رسم؟
.sp
‏pylint باید تمام کد شما را به‌یک‌باره تحلیل کند تا مقادیر واقعی حاصل از فراخوانی‌ها را
به بهترین شکل استنتاج کند. اگر تنها بخشی از فایل‌ها ارائه شوند، ممکن است pylint
نوع یک مقدار خاص را تشخیص ندهد و استنتاج ضعیف‌تری برای آن زیرمجموعه تولید کند. موازی‌سازی
pylint ساده نیست؛ در صورتی که این موضوع برای شما اهمیت دارد، استفاده از گزینه \fB\-j\fP را توصیه نمی‌کنیم.
.SS در صورت استفاده از سایر لینترهای محبوب، برای جلوگیری از پیام‌های تکراری کدام پیام‌ها را غیرفعال کنم؟
.sp
‏pycodestyle \%<https://\:github\:.com/\:PyCQA/\:pycodestyle>: bad\-indentation, bare\-except, line\-too\-long, missing\-final\-newline, multiple\-statements, singleton\-comparison, trailing\-newlines, trailing\-whitespace, unnecessary\-negation, unnecessary\-semicolon, wrong\-import\-position
.sp
‏pyflakes \%<https://\:github\:.com/\:PyCQA/\:pyflakes>: undefined\-variable, unused\-import, unused\-variable
.sp
‏mccabe \%<https://\:github\:.com/\:PyCQA/\:mccabe>: too\-many\-branches
.sp
‏pydocstyle \%<https://\:github\:.com/\:PyCQA/\:pydocstyle>: missing\-module\-docstring, missing\-class\-docstring, missing\-function\-docstring
.sp
‏pep8\-naming \%<https://\:github\:.com/\:PyCQA/\:pep8-naming>: invalid\-name, bad\-classmethod\-argument, bad\-mcs\-classmethod\-argument, no\-self\-argument
.sp
‏isort \%<https://\:github\:.com/\:pycqa/\:isort> و flake8\-import\-order \%<https://\:github\:.com/\:PyCQA/\:flake8-import-order>: ungrouped\-imports, wrong\-import\-order
.SS چگونه از پیام‌های \(dqaccess to undefined member\(dq در کلاس‌های mixin خود جلوگیری کنم؟
.sp
باید پیام \fBno\-member\fP را به گزینه \fBignored\-checks\-for\-mixins\fP خود اضافه کنید
و نام کلاس mixin خود را با نامی که به \(dqMixin\(dq یا \(dqmixin\(dq ختم می‌شود (پیش‌فرض) نام‌گذاری کنید،
یا مقدار پیش‌فرض را با تغییر گزینه \fBmixin\-class\-rgx\fP عوض کنید.
.SS داده‌های پایدار برای مقایسه میان اجراهای پیاپی در کجا ذخیره می‌شوند؟
.sp
داده‌های تحلیل به‌صورت یک فایل pickle در دایرکتوری‌ای ذخیره می‌شوند که
محل آن با استفاده از قوانین زیر تعیین می‌شود:
.INDENT 0.0
.IP \(bu 2
مقدار متغیر محیطی PYLINTHOME در صورت تنظیم بودن
.IP \(bu 2
.INDENT 2.0
.TP
.B زیردایرکتوری \(dqpylint\(dq در XDG_CACHE_HOME کاربر در صورت تنظیم بودن این متغیر محیطی، در غیر این صورت
.INDENT 7.0
.IP \(bu 2
لینوکس: \(dq~/.cache/pylint\(dq
.IP \(bu 2
مک‌او‌اس: \(dq~/Library/Caches/pylint\(dq
.IP \(bu 2
ویندوز: \(dqC:Users<username>AppDataLocalpylint\(dq
.UNINDENT
.UNINDENT
.IP \(bu 2
دایرکتوری \(dq.pylint.d\(dq در دایرکتوری جاری
.UNINDENT.SS وب‌سایت pylint dot org چه ارتباطی با این پروژه دارد؟
.sp
از نظر تاریخی، pylint dot org به‌عنوان وب‌سایت اصلی Pylint عمل می‌کرد. با این حال،
ما دیگر به این دامنه دسترسی نداریم. مالکان فعلی با نمایش تبلیغات
در کنار مستندات قدیمی و بدون هیچ‌گونه مشارکتی در Pylint، در حال کسب درآمد
از آن هستند. برای مشاهدهٔ آخرین و رسمی‌ترین مستندات Pylint،
لطفاً به pylint.readthedocs.io در \%<https://\:pylint\:.readthedocs\:.io/\:en/\:stable>\& مراجعه کنید.
.sp
لطفاً برای جزئیات بیشتر، گزارش شمارهٔ 8934 را در \%<https://\:github\:.com/\:pylint-dev/\:pylint/\:issues/\:8934>
مشاهده کنید.
.SS ارتباط
.SS گزارش‌های باگ، بازخورد
.sp
فکر می‌کنید باگی در Pylint پیدا کرده‌اید؟ خوب، ممکن است همین‌طور باشد
چرا که Pylint و Python به‌شدت در حال توسعه هستند!
.sp
لطفاً وقت بگذارید و بررسی کنید که آیا این مورد از قبل در ردیاب مشکلات (issue tracker) در
\%<https://\:github\:.com/\:pylint-dev/\:pylint>
ثبت شده است یا خیر.
.sp
توجه داشته باشید که این مشکل ممکن است در یکی از وابستگی‌های اصلی Pylint، یعنی
astroid نیز گزارش شده باشد:
.INDENT 0.0
.IP \(bu 2
\%<https://\:github\:.com/\:pylint-dev/\:astroid>
.UNINDENT
.SS سرور Discord
.sp
می‌توانید با استفاده از سرور Discord دربارهٔ مشکل خود گفتگو کنید:
.sp
\%<https://\:discord\:.com/\:invite/\:Egy6P8AMB5>
.SS فهرست‌های پستی
.sp
فهرست پستی code\-quality با سایر ابزارهایی که هدف آن‌ها
بهبود کیفیت کدهای Python است به اشتراک گذاشته شده است.
.sp
می‌توانید در این فهرست پستی در
\%<https://\:mail\:.python\:.org/\:mailman3/\:lists/\:code-quality\:.python\:.org>
عضو شوید.
.sp
آرشیوها در
\%<https://\:mail\:.python\:.org/\:pipermail/\:code-quality>
در دسترس هستند.
.sp
آرشیوهای پیش از آوریل ۲۰۱۳ دیگر در دسترس نیستند. در
\%<https://\:mail\:.python\:.org/\:pipermail> این بخش تحت عنوان \fBpython\-projects\fP\& قرار داشت.
.SS پشتیبانی
[تصویر: Tidelift]
[تصویر]
.sp
پشتیبانی حرفه‌ای برای pylint به‌عنوان بخشی از اشتراک Tidelift
در \%<https://\:tidelift\:.com/\:subscription/\:pkg/\:pypi-pylint?\:utm_source=pypi-pylint&\:utm_medium=referral&\:utm_campaign=readme>\& در دسترس است. Tidelift به تیم‌های توسعهٔ نرم‌افزار یک منبع واحد برای
خرید و نگهداری نرم‌افزارهایشان با تضمین‌های سطح حرفه‌ای
از سوی کارشناسانی که آن را به بهترین شکل می‌شناسند ارائه می‌دهد، در حالی که به‌شکلی روان و یکپارچه با ابزارهای
موجود ادغام می‌شود.
.SH "نویسندگان (AUTHORS)"
Logilab و مشارکت‌کنندگان Pylint
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
2003-2026, Logilab و مشارکت‌کنندگان Pylint
.\" پایان صفحه مان تولید شده.