'\" 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 "nvchecker" "1" "2026-08-15" "2.22" .SH "نام (NAME)" nvchecker \- بررسی‌کننده انتشار نسخه جدید نرم‌افزارها .sp ابزار \fBnvchecker\fP (کوتاه‌شده‌ی \fInew version checker\fP) برای بررسی اینکه آیا نسخه جدیدی از یک نرم‌افزار منتشر شده است یا خیر به کار می‌رود. .sp این شاخه مربوط به نسخه 2.0 است. برای نسخه قدیمی 1.x، لطفاً به شاخه \fBv1.x\fP بروید. \% \% .SH "وابستگی‌ها (DEPENDENCIES)" .INDENT 0.0 .IP \(bu 2 Python 3.9+ .IP \(bu 2 کتابخانه‌های پایتون: structlog، platformdirs، tomli (روی پایتون < 3.11) .IP \(bu 2 یکی از این ترکیب‌های کتابخانه‌های پایتون (به ترتیب اولویت): .INDENT 2.0 .IP \(bu 2 tornado + pycurl .IP \(bu 2 aiohttp .IP \(bu 2 httpx با پشتیبانی از http2 (آزمایشی؛ تنها آخرین نسخه پشتیبانی می‌شود) .IP \(bu 2 tornado .UNINDENT .IP \(bu 2 تمام دستورهای استفاده‌شده در فایل‌های پیکربندی نسخه نرم‌افزار شما .UNINDENT .SH "نصب و اجرا (INSTALL AND RUN)" .sp برای نصب: .INDENT 0.0 .INDENT 3.5 .sp .EX pip3 install nvchecker .EE .UNINDENT .UNINDENT .sp برای استفاده از آخرین کد، می‌توانید این مخزن را نیز کلون کرده و اجرا کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX python3 setup.py install .EE .UNINDENT .UNINDENT .sp برای مشاهده گزینه‌های موجود: .INDENT 0.0 .INDENT 3.5 .sp .EX nvchecker \-\-help .EE .UNINDENT .UNINDENT .sp اجرا با یک یا چند فایل نسخه نرم‌افزار: .INDENT 0.0 .INDENT 3.5 .sp .EX nvchecker \-c config_file.toml .EE .UNINDENT .UNINDENT .sp یک فایل پیکربندی ساده می‌تواند به این صورت باشد: .INDENT 0.0 .INDENT 3.5 .sp .EX [nvchecker] source = \(dqgithub\(dq github = \(dqlilydjwg/nvchecker\(dq [python\-toml] source = \(dqpypi\(dq pypi = \(dqtoml\(dq .EE .UNINDENT .UNINDENT .sp معمولاً مایل خواهید بود تعدادی \(dqversion record files\(dq مشخص کنید؛ به ادامه مراجعه نمایید..SS گزارش‌گیری JSON (JSON logging) .sp با استفاده از \fB\-\-logger=json\fP یا \fB\-\-logger=both\fP، می‌توانید به یک گزارش ساختاریافته برای پردازش یا استفادهٔ برنامه‌نویسی‌شده دسترسی پیدا کنید. می‌توانید از \fB\-\-json\-log\-fd=FD\fP برای مشخص کردن توصیف‌گر فایل (file descriptor) جهت ارسال گزارش‌ها استفاده نمایید (دقت کنید که بافرینگ خطی انجام شود). گزینهٔ سطح گزارش‌گیری (\fB\-l\fP یا \fB\-\-logging\fP) روی این مورد تأثیری ندارد. .sp گزارش JSON به‌صورت یک رشتهٔ JSON در هر سطر است. رویدادها و فیلدهای مستندشدهٔ زیر پایدار هستند؛ موارد مستندنشده ممکن است بدون اطلاع قبلی تغییر کنند. .INDENT 0.0 .TP .B event=updated یک به‌روزرسانی شناسایی شده است. فیلدهای \fBname\fP، \fBrevision\fP، \fBold_version\fP و \fBversion\fP در دسترس هستند. \fBold_version\fP ممکن است \fBnull\fP باشد و \fBrevision\fP ممکن است وجود نداشته باشد. .TP .B event=up\-to\-date هیچ به‌روزرسانی‌ای وجود ندارد. فیلدهای \fBname\fP و \fBversion\fP در دسترس هستند. .TP .B event=no\-result هیچ نگارشی شناسایی نشد. ممکن است خطایی رخ داده باشد. فیلد \fBname\fP در دسترس است. .TP .B level=error خطایی رخ داده است. فیلدهای \fBname\fP و \fBexc_info\fP برای ارائهٔ اطلاعات بیشتر ممکن است در دسترس باشند. .UNINDENT .SS ارتقا از نگارش 1.x (Upgrade from 1.x version) .sp چندین تغییر ناسازگار با گذشته نسبت به نگارش قبلی 1.x وجود دارد. .INDENT 0.0 .IP 1. 3 نگارش 2.x برای اجرا به Python 3.7 یا بالاتر نیاز دارد. .IP 2. 3 نحو دستور کمی تغییر کرده است. لازم است از سوییچ \fB\-c\fP برای مشخص کردن فایل پیکربندی نگارش نرم‌افزار خود استفاده کنید (یا از مقدار پیش‌فرض استفاده نمایید). .IP 3. 3 قالب فایل پیکربندی از ini به toml \%\& تغییر یافته است. می‌توانید از اسکریپت \fBnvchecker\-ini2toml\fP برای تبدیل فایل‌های پیکربندی قدیمی خود استفاده کنید. با این حال، یادداشت‌ها (کامنت‌ها) و قالب‌بندی از دست خواهند رفت و ممکن است برخی گزینه‌ها به‌درستی تبدیل نشوند. .IP 4. 3 چندین گزینه تغییر نام یافته‌اند: \fBmax_concurrent\fP به \fBmax_concurrency\fP، و در نام تمام گزینه‌ها کاراکتر \fB\-\fP با \fB_\fP جایگزین شده است\&. .IP 5. 3 تمام جدول‌های پیکربندی نرم‌افزار، به جای اینکه منبع بر اساس نام گزینه‌های مورد استفاده تشخیص داده شود، به یک گزینهٔ \fBsource\fP برای تعیین منبع مورد استفاده نیاز دارند. این امر امکان شناسایی پلاگین‌های منبع اضافی را فراهم می‌کند. .IP 6. 3 فایل‌های رکورد نگارش به استفاده از قالب JSON تغییر یافته‌اند (قالب قدیمی هنگام نوشتن تبدیل خواهد شد). .IP 7. 3 منبع \fBvcs\fP حذف شده است. (در حال حاضر درون lilac \% در دسترس است.) یک منبع \fBgit\fP ارائه شده است. .IP 8. 3 گزینه‌های \fBinclude_tags_pattern\fP و \fBignored_tags\fP حذف شده‌اند. به جای آن‌ها از List Options استفاده کنید. .UNINDENT .SH "فایل‌های رکورد نگارش (VERSION RECORD FILES)" .sp فایل‌های رکورد نگارش مشخص می‌کنند که چه نگارشی از نرم‌افزار برای شما شناخته‌شده یا در دسترس است. آن‌ها یک شیء سادهٔ JSON هستند که نام نرم‌افزارها را به نگارش‌های شناخته‌شده نگاشت می‌کنند. .SS دستور \fBnvtake\fP .sp این دستور به مدیریت فایل‌های رکورد نگارش کمک می‌کند. این دستور فایل‌های رکورد نگارش قدیمی و جدید، و فهرستی از نام‌های ارائه‌شده در خط فرمان را می‌خواند. سپس نگارش‌های مربوط به آن نام‌ها را در فایل رکورد نگارش قدیمی به‌روزرسانی می‌کند. .sp این ابزار زمانی کاربرد دارد که برخی از نرم‌افزارهای به‌روزرسانی‌شده (نه همهٔ آن‌ها) را شناخته و پردازش کرده‌اید. به جای ویرایش دستی فایل، می‌توانید این موضوع را از طریق این دستور به nvchecker اعلام کنید. .sp اگر مکان فایل‌های رکورد نگارش را در فایل پیکربندی خود مشخص کنید، این دستور بیشترین کاربرد را خواهد داشت. برای نحوهٔ استفاده از فایل پیکربندی، بخش‌های بعدی را ببینید. .SS دستور \fBnvcmp\fP .sp این دستور فایل \fBnewver\fP را با فایل \fBoldver\fP مقایسه می‌کند و تفاوت‌ها را به‌عنوان به‌روزرسانی چاپ می‌کند، برای نمونه: .INDENT 0.0 .INDENT 3.5 .sp .EX $ nvcmp \-c sample_source.toml Sparkle Test App None \-> 2.0 test 0.0 \-> 0.1 .EE .UNINDENT .UNINDENT .SH "فایل‌های پیکربندی (CONFIGURATION FILES)" .sp فایل‌های منبع نگارش نرم‌افزار در قالب toml \% هستند. \fIنام کلید (key name)\fP همان نام نرم‌افزار است. فیلدهای زیر برای مشخص کردن چگونگی تعیین نگارش کنونی نرم‌افزار توسط nvchecker به کار می‌روند. .sp برای مشاهدهٔ یک نمونه، sample_source.toml \% را ببینید. .SS جدول پیکربندی (Configuration Table) .sp یک جدول ویژه به نام \fB__config__\fP برخی گزینه‌های پیکربندی را ارائه می‌دهد. .sp مسیرهای نسبی نسبت به فایل‌های منبع سنجیده می‌شوند، و \fB~\fP و متغیرهای محیطی بسط داده می‌شوند. .sp گزینه‌های پشتیبانی‌شده در حال حاضر عبارتند از: .INDENT 0.0 .TP .B oldver مشخص کردن فایل رکورد نگارش حاوی اطلاعات نگارش قدیمی. .TP .B newver مشخص کردن فایل رکورد نگارش جهت ذخیرهٔ اطلاعات نگارش جدید. .TP .B proxy پروکسی HTTP مورد استفاده. قالب آن به‌صورت \fBproto://host:port\fP است، مانند \fBhttp://localhost:8087\fP\&. پس‌آیندهای مختلف سطوح متفاوتی از پشتیبانی را برای این مورد دارند؛ برای نمونه با \fBpycurl\fP می‌توانید از پروکسی‌های \fBsocks5h://host:port\fP استفاده کنید. .TP .B max_concurrency بیشینهٔ تعداد کارهای هم‌روند. پیش‌فرض: 20. .TP .B http_timeout مدت‌زمان به ثانیه برای انتظار در درخواست‌های HTTP. پیش‌فرض: 20. .TP .B keyfile مشخص کردن یک فایل پیکربندی toml حاوی اطلاعات کلید (توکن). این فایل باید شامل یک جدول \fBkeys\fP باشد که نام کلیدها را به مقادیر کلید نگاشت می‌کند. برای اطلاع از نام کلید(های) مورد استفاده، به منبع مربوطه مراجعه کنید. .sp نمونهٔ \fBkeyfile.toml\fP: .INDENT 7.0 .INDENT 3.5 .sp .EX [keys] # https://github.com/settings/tokens # scope: repo \-> public_repo github = \(dqghp_\(dq .EE .UNINDENT .UNINDENT .UNINDENT.SS گزینه‌های عمومی (Global Options) .sp گزینه‌های زیر برای تمام منابع بررسی اعمال می‌شوند. می‌توانید از آن‌ها در هر مدخلی در فایل پیکربندی خود استفاده کنید. .INDENT 0.0 .TP .B prefix اگر رشته نسخه با این پیشوند آغاز شود، پیشوند حذف می‌شود. در غیر این صورت، رشته نسخه همان‌گونه که هست برگردانده می‌شود. .sp اگر هم \fBprefix\fP و هم \fBfrom_pattern\fP/\fBto_pattern\fP استفاده شوند، ابتدا \fBprefix\fP اعمال می‌شود. .TP .B from_pattern, to_pattern هر دو عبارت‌های باقاعده سازگار با Python هستند. اگر \fBfrom_pattern\fP در رشته نسخه یافت شود، با \fBto_pattern\fP جایگزین خواهد شد. .sp اگر \fBfrom_pattern\fP یافت نشود، رشته نسخه بدون تغییر باقی می‌ماند و هیچ خطایی صادر نمی‌شود. .TP .B missing_ok در صورتی که یک ماژول بررسی نسخه چیزی پیدا نکند، هشدارها و خطاها را نادیده می‌گیرد. همه منابع از این گزینه پشتیبانی نمی‌کنند. .TP .B proxy پروکسی HTTP مورد استفاده. قالب آن به صورت \fBproto://host:port\fP است، مانند \fBhttp://localhost:8087\fP\&. پشتیبان‌های مختلف سطوح متفاوتی از پشتیبانی را برای این مورد دارند، برای مثال با \fBpycurl\fP می‌توانید از پروکسی‌های \fBsocks5h://host:port\fP استفاده کنید. .sp برای نادیده گرفتن تنظیمات سراسری، مقدار آن را برابر با \fB\(dq\(dq\fP (رشته خالی) قرار دهید. .sp این گزینه تنها زمانی کار می‌کند که پیاده‌سازی منبع از کلاینت HTTP داخلی استفاده کند، و با منبع \fBaur\fP کار نمی‌کند زیرا به صورت دسته‌ای پردازش می‌شود (با این حال، پیکربندی سراسری پروکسی همچنان اعمال می‌گردد). .TP .B user_agent رشته user agent مورد استفاده برای درخواست‌های HTTP. .TP .B tries تعداد دفعات تلاش در هنگام وقوع خطای شبکه. پیش‌فرض \fB1\fP است. .sp این گزینه تنها زمانی کار می‌کند که پیاده‌سازی منبع از کلاینت HTTP داخلی استفاده کند. .TP .B httptoken یک توکن احراز هویت شخصی که برای دریافت نشانی وب با هدر \fBAuthorization\fP استفاده می‌شود. نوع توکن به احراز هویت مورد نیاز بستگی دارد. .INDENT 7.0 .IP \(bu 2 برای توکن Bearer تنظیم کنید: \fBBearer \fP .IP \(bu 2 برای توکن Basic تنظیم کنید: \fBBasic \fP .UNINDENT .sp در keyfile توکن \fBhttptoken_{name}\fP را اضافه کنید. .TP .B verify_cert تعیین بررسی یا عدم بررسی گواهی HTTPS. پیش‌فرض \fBtrue\fP است. .UNINDENT .SS گزینه‌های فهرست (List Options) .sp گزینه‌های زیر برای منابعی که یک فهرست برمی‌گردانند اعمال می‌شوند. برای بررسی پشتیبانی از آن‌ها، به جدول منابع مربوطه مراجعه کنید. .INDENT 0.0 .TP .B include_regex تنها رشته‌های نسخه‌ای را در نظر می‌گیرد که با عبارت باقاعده داده‌شده مطابقت داشته باشند. کل رشته باید با regex مطابقت داشته باشد. حتماً در صورت نیاز از \fB\&.*\fP استفاده کنید! .TP .B exclude_regex رشته‌های نسخه‌ای که با عبارت باقاعده داده‌شده مطابقت دارند را در نظر نمی‌گیرد. کل رشته باید با regex مطابقت داشته باشد. حتماً در صورت نیاز از \fB\&.*\fP استفاده کنید! اولویت این گزینه از \fBinclude_regex\fP بالاتر است؛ بدین معنا که اگر با این الگو مطابقت داشته باشد، حتی در صورت مطابقت با \fBinclude_regex\fP نیز مستثنی خواهد شد. .TP .B sort_version_key مرتب‌سازی رشته نسخه با استفاده از این تابع کلید. از بین \fBparse_version\fP، \fBvercmp\fP، \fBawesomeversion\fP و \fBportage\fP انتخاب کنید. مقدار پیش‌فرض \fBparse_version\fP است. \fBparse_version\fP از یک نسخه قدیمی \fBpkg_resources.parse_version\fP استفاده می‌کند. \fBvercmp\fP از \fBpyalpm.vercmp\fP استفاده می‌کند. \fBawesomeversion\fP از awesomeversion \%\& استفاده می‌کند. \fBportage\fP از \fBportage.versions.vercmp\fP استفاده می‌کند. .TP .B ignored رشته‌های نسخه‌ای که صریحاً نادیده گرفته می‌شوند و با فاصله از هم جدا شده‌اند. این گزینه می‌تواند برای جلوگیری از نسخه‌های نادرست شناخته‌شده مفید باشد، تا نسخه‌های جدیدتر توسط نسخه‌های قدیمی معیوب \(dqبازنویسی\(dq نشوند. .UNINDENT.SS جستجو در یک صفحه وب .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqregex\(dq .EE .UNINDENT .UNINDENT .sp جستجو در یک صفحه وب مشخص برای یافتن رشته نسخه. این نوع یافتن نسخه دارای فیلدهای زیر است: .INDENT 0.0 .TP .B url نشانی URL صفحه وب برای واکشی. .TP .B encoding (\fIاختیاری\fP) کدگذاری نویسه‌های صفحه وب، در صورتی که \fBlatin1\fP مناسب نباشد. .TP .B regex یک عبارت باقاعده برای یافتن رشته نسخه. .sp می‌تواند دارای صفر یا یک گروه تطبیق (capture group) باشد. گروه تطبیق یا کل تطابق، رشته نسخه در نظر گرفته می‌شود. .sp هنگامی که چندین رشته نسخه پیدا شود، بزرگ‌ترین مقدار از میان آن‌ها انتخاب می‌گردد. .TP .B post_data (\fIاختیاری\fP) در صورت وجود، به جای درخواست \fBGET\fP از یک درخواست \fBPOST\fP استفاده خواهد شد. این مقدار باید رشته‌ای شامل بدنه کامل درخواست باشد. کدگذاری رشته را می‌توان با استفاده از گزینه \fBpost_data_type\fP مشخص کرد. .TP .B post_data_type (\fIاختیاری\fP) مقدار \fBContent\-Type\fP بدنه درخواست (\fBpost_data\fP) را مشخص می‌کند. به‌طور پیش‌فرض، این مقدار \fBapplication/x\-www\-form\-urlencoded\fP\& است. .UNINDENT .sp این منبع از List Options پشتیبانی می‌کند\&. .SS جستجو در یک سرآیند HTTP .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqhttpheader\(dq .EE .UNINDENT .UNINDENT .sp ارسال یک درخواست HTTP و جستجو در یک سرآیند مشخص. .INDENT 0.0 .TP .B url نشانی URL درخواست HTTP. .TP .B header (\fIاختیاری\fP) سرآیندی که باید بررسی شود. مقدار پیش‌فرض \fBLocation\fP\& است. سرآیند مفید دیگر \fBContent\-Disposition\fP\& می‌باشد. .TP .B regex یک عبارت باقاعده برای یافتن رشته نسخه. .sp می‌تواند دارای صفر یا یک گروه تطبیق باشد. گروه تطبیق یا کل تطابق، رشته نسخه خواهد بود. .sp هنگامی که چندین رشته نسخه پیدا شود، بزرگ‌ترین مقدار از میان آن‌ها انتخاب می‌گردد. .TP .B method (\fIاختیاری\fP) متد HTTP مورد استفاده. پیش‌فرض \fBHEAD\fP\& است. .TP .B follow_redirects (\fIاختیاری\fP) تعیین اینکه آیا ریدایرکت‌های 3xx در HTTP دنبال شوند یا خیر. پیش‌فرض \fBfalse\fP\& است. اگر در حال بررسی سرآیند \fBLocation\fP هستید، نباید این مقدار را تغییر دهید. .UNINDENT .SS جستجو با یک تجزیه‌کننده HTML .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqhtmlparser\(dq .EE .UNINDENT .UNINDENT .sp ارسال یک درخواست HTTP و جستجو در بدنه با استفاده از یک xpath مشخص. .INDENT 0.0 .TP .B url نشانی URL درخواست HTTP. .TP .B xpath یک عبارت xpath برای یافتن رشته نسخه. .TP .B is_xml برای استفاده از یک تجزیه‌کننده XML به جای HTML، روی \fBtrue\fP تنظیم شود. .TP .B post_data (\fIاختیاری\fP) در صورت وجود، به جای \fBGET\fP از یک درخواست \fBPOST\fP استفاده خواهد شد. این مقدار باید رشته‌ای شامل بدنه کامل درخواست باشد. کدگذاری رشته را می‌توان با استفاده از گزینه \fBpost_data_type\fP مشخص کرد. .TP .B post_data_type (\fIاختیاری\fP) مقدار \fBContent\-Type\fP بدنه درخواست (\fBpost_data\fP) را مشخص می‌کند. به‌طور پیش‌فرض، این مقدار \fBapplication/x\-www\-form\-urlencoded\fP\& است. .UNINDENT .sp این منبع می‌تواند یک فید RSS را بدین صورت تجزیه کند: .INDENT 0.0 .INDENT 3.5 .sp .EX [ProxmoxVE] source = \(dqhtmlparser\(dq url = \(dqhttps://my.proxmox.com/en/announcements/tag/proxmox\-ve/rss\(dq xpath = \(dq//item/title\(dq is_xml = true from_pattern = \(aqProxmox VE ([\ed.]+) released!\(aq to_pattern = \(aq\e1\(aq .EE .UNINDENT .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 وابستگی اضافی \(dqlxml\(dq مورد نیاز است. می‌توانید از \fBpip install \(aqnvchecker[htmlparser]\(aq\fP\& استفاده کنید. .UNINDENT .UNINDENT.SS جستجو با یک تحلیل‌گر JSON (jq) .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqjq\(dq .EE .UNINDENT .UNINDENT .sp یک درخواست HTTP ارسال کرده و بدنهٔ آن را با یک فیلتر مشخص \fBjq\fP جستجو می‌کند. .INDENT 0.0 .TP .B url نشانی اینترنتی (URL) درخواست HTTP. .TP .B filter یک فیلتر \fBjq\fP که برای یافتن رشتهٔ نسخه استفاده می‌شود. .TP .B post_data (\fIاختیاری\fP) در صورت وجود، یک درخواست \fBPOST\fP (به جای \fBGET\fP) استفاده خواهد شد. مقدار باید رشته‌ای شامل بدنهٔ کامل درخواست باشد. کدگذاری این رشته را می‌توان با استفاده از گزینهٔ \fBpost_data_type\fP مشخص کرد. .TP .B post_data_type (\fIاختیاری\fP) مقدار \fBContent\-Type\fP بدنهٔ درخواست (\fBpost_data\fP) را تعیین می‌کند. مقدار پیش‌فرض، \fBapplication/json\fP\& است. .UNINDENT .sp این منبع از گزینه‌های فهرست (List Options) پشتیبانی می‌کند\&. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 وابستگی اضافی \(dqjq\(dq مورد نیاز است. .UNINDENT .UNINDENT .SS یافتن با یک دستور .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqcmd\(dq .EE .UNINDENT .UNINDENT .sp استفاده از یک خط فرمان شل برای دریافت نسخه. خروجی ابتدا پیراسته (strip) می‌شود، بنابراین نویسه‌های خط جدید انتهایی مشکلی ایجاد نمی‌کنند. .INDENT 0.0 .TP .B cmd خط فرمانی که باید استفاده شود. این دستور با شل استاندارد سیستم (یعنی \fB/bin/sh\fP) اجرا خواهد شد. .UNINDENT .SS بررسی AUR .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqaur\(dq .EE .UNINDENT .UNINDENT .sp بررسی مخزن کاربران آرچ \% برای به‌روزرسانی‌ها. تنظیمات پروکسی به‌ازای هر مورد برای این منبع کار نمی‌کند زیرا چندین مورد در یک درخواست دسته‌بندی می‌شوند. .INDENT 0.0 .TP .B aur نام بسته در AUR. در صورت خالی بودن، از نام نرم‌افزار (\fItable name\fP) استفاده می‌شود. .TP .B strip_release حذف بخش انتشار (release). .TP .B use_last_modified افزودن زمان آخرین تغییر به نسخه. .UNINDENT .SS بررسی GitHub .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqgithub\(dq .EE .UNINDENT .UNINDENT .sp بررسی GitHub \% برای به‌روزرسانی‌ها. نسخهٔ بازگردانده‌شده در قالب تاریخ \fB%Y%m%d.%H%M%S\fP است، مانند \fB20130701.012212\fP، مگر اینکه از \fBuse_latest_release\fP، \fBuse_max_tag\fP یا \fBuse_max_release\fP استفاده شود. موارد زیر را ببینید. .INDENT 0.0 .TP .B github مخزن github به همراه نام پدیدآورنده، مانند \fBlilydjwg/nvchecker\fP\&. .TP .B branch کدام شاخه دنبال شود؟ پیش‌فرض: شاخهٔ پیش‌فرض مخزن. .TP .B path تنها کامیت‌هایی بازگردانده می‌شوند که شامل این مسیر فایل باشند. .TP .B host نام میزبان (hostname) برای نمونهٔ میزبانی‌شدهٔ شخصی GitHub. .TP .B use_latest_release برای بررسی آخرین انتشار (release) در GitHub، این گزینه را روی \fBtrue\fP تنظیم کنید. .sp انتشارهای GitHub با برچسب‌های گیت یکسان نیستند. شما در صفحهٔ انتشارات برای چنین انتشارهایی نام‌های نسخهٔ بزرگ و توضیحات را مشاهده می‌کنید، مانند مورد zfsonlinux/zfs در \%، و موارد کوچکی مانند مورد nvchecker در \% صرفاً برچسب‌های گیت هستند که باید برای آن‌ها از \fBuse_max_tag\fP در زیر استفاده شود. .sp به جای تاریخ، نام برچسبِ انتشار را بازمی‌گرداند. (به دلایل تاریخی نام انتشار بازگردانده نمی‌شود. برای تغییر این رفتار، مورد زیر را ببینید.) .TP .B use_max_release برای بررسی بالاترین انتشار در GitHub، این گزینه را روی \fBtrue\fP تنظیم کنید. این گزینه بزرگ‌ترین مورد مرتب‌شده بر اساس گزینهٔ \fBsort_version_key\fP را بازمی‌گرداند. به جای تاریخ، نام برچسب بازگردانده خواهد شد. .TP .B use_release_name هنگامی که \fBuse_latest_release\fP یا \fBuse_max_release\fP برابر با \fBtrue\fP باشد، تنظیم این گزینه روی \fBtrue\fP باعث می‌شود nvchecker به جای نام برچسب، نام انتشار را بازگرداند. .TP .B include_prereleases هنگامی که \fBuse_latest_release\fP یا \fBuse_max_release\fP برابر با \fBtrue\fP باشد، این گزینه را روی \fBtrue\fP تنظیم کنید تا پیش‌انتشارها نیز لحاظ شوند. .sp این کار نام‌های انتشار (نه نام برچسب‌ها) را بازمی‌گرداند. .sp این گزینه به توکن نیاز دارد زیرا از رابط برنامه‌نویسی v4 GraphQL API استفاده می‌کند. .TP .B use_latest_tag برای بررسی آخرین برچسب در GitHub، این گزینه را روی \fBtrue\fP تنظیم کنید. .sp این گزینه به توکن نیاز دارد زیرا از رابط برنامه‌نویسی v4 GraphQL API استفاده می‌کند. .TP .B query هنگامی که \fBuse_latest_tag\fP برابر با \fBtrue\fP است، این گزینه یک پرس‌وجو برای برچسب تعیین می‌کند. روش تطبیق دقیق توسط GitHub مستندسازی نشده است. .TP .B use_max_tag برای بررسی بالاترین برچسب در GitHub، این گزینه را روی \fBtrue\fP تنظیم کنید. برخلاف \fBuse_max_release\fP، این گزینه هم برچسب‌های نشانه‌دار (annotated) و هم برچسب‌های سبک (lightweight) را شامل می‌شود و بزرگ‌ترین مورد مرتب‌شده با گزینهٔ \fBsort_version_key\fP را بازمی‌گرداند. به جای تاریخ، نام برچسب بازگردانده خواهد شد. .TP .B token یک توکن احراز هویت شخصی که برای فراخوانی API استفاده می‌شود. .UNINDENT .sp ممکن است برای استفاده از \fBuse_latest_tag\fP، \fBinclude_prereleases\fP یا ارسال درخواست‌های مکررتر نسبت به حالت ناشناس، به یک توکن احراز هویت نیاز باشد. .sp جهت تنظیم توکن احراز هویت، می‌توانید موارد زیر را پیکربندی کنید: .INDENT 0.0 .IP \(bu 2 گزینهٔ token .IP \(bu 2 یک ورودی در keyfile برای میزبان (مانند \fBgithub.com\fP) .IP \(bu 2 یک ورودی در فایل \fBnetrc\fP برای میزبان .UNINDENT .sp این منبع در صورت تنظیم بودن \fBuse_max_tag\fP یا \fBuse_max_release\fP از گزینه‌های فهرست (List Options) پشتیبانی می‌کند..SS "متاداده‌های RichResult (RichResult metadata)" .sp در صورت موجود بودن در پاسخ‌های دریافتی از GitHub API، این منبع فیلدهای اختیاری \fBRichResult\fP زیر را مقداردهی می‌کند. هیچ درخواست API اضافه‌ای صرفاً برای دریافت اطلاعات برچسب زمانی (timestamp) ارسال نمی‌شود. .TS box center; l|l|l. T{ حالت (Mode) T} T{ creation_time T} T{ revision_creation_time T} _ T{ کامیت/مسیر پیش‌فرض T} T{ .INDENT 0.0 .IP \(bu 2 .UNINDENT T} T{ برچسب زمانی کامیت T} _ T{ \fBuse_latest_release\fP T} T{ زمان انتشار نسخه (release) T} T{ .INDENT 0.0 .IP \(bu 2 .UNINDENT T} _ T{ \fBuse_max_release\fP T} T{ زمان انتشار نسخه (release) T} T{ .INDENT 0.0 .IP \(bu 2 .UNINDENT T} _ T{ \fBuse_latest_release\fP + T} T{ T} T{ T} _ T{ \fBinclude_prereleases\fP T} T{ زمان انتشار نسخه (release) T} T{ برچسب زمانی کامیت T} _ T{ \fBuse_latest_tag\fP T} T{ .INDENT 0.0 .IP \(bu 2 .UNINDENT T} T{ زمان ایجاد برچسب (annotated tags) یا برچسب زمانی کامیت (lightweight tags) T} _ T{ \fBuse_max_tag\fP T} T{ .INDENT 0.0 .IP \(bu 2 .UNINDENT T} T{ .INDENT 0.0 .IP \(bu 2 .UNINDENT T} .TE.SS بررسی Gitea .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqgitea\(dq .EE .UNINDENT .UNINDENT .sp Gitea \% را برای به‌روزرسانی‌ها بررسی می‌کند. نگارش بازگردانده شده در قالب تاریخ \fB%Y%m%d\fP است، به عنوان مثال \fB20130701\fP، مگر اینکه از \fBuse_max_tag\fP استفاده شده باشد. به بخش زیر مراجعه کنید. .INDENT 0.0 .TP .B gitea مخزن gitea به همراه نام نویسنده/مالک، مانند \fBgitea/tea\fP\&. .TP .B branch کدام شاخه دنبال شود؟ پیش‌فرض: شاخهٔ پیش‌فرض مخزن است. .TP .B use_max_tag این گزینه را روی \fBtrue\fP تنظیم کنید تا بیشترین تگ در Gitea بررسی شود. بزرگ‌ترین مورد مرتب‌شده بر اساس نسخهٔ قدیمی \fBpkg_resources.parse_version\fP بازگردانده خواهد شد. به جای تاریخ، نام تگ بازگردانده می‌شود. .TP .B use_latest_release این گزینه را روی \fBtrue\fP تنظیم کنید تا نام آخرین انتشار در gitea بررسی شود. .sp انتشارهای Gitea با تگ‌های git یکی نیستند. شما نام نگارش‌های بزرگ و توضیحات را در صفحهٔ انتشارات برای چنین مواردی خواهید دید، به عنوان مثال ciberandy/qiv در \%\&. .TP .B host نام میزبان (hostname) برای نمونهٔ میزبانی‌شده توسط خود (self\-hosted) از Gitea. .TP .B token توکن احراز هویت Gitea که برای فراخوانی API استفاده می‌شود. .UNINDENT .sp جهت تعیین توکن احراز هویت، می‌توانید موارد زیر را تنظیم کنید: .INDENT 0.0 .IP \(bu 2 گزینهٔ token .IP \(bu 2 یک مدخل در keyfile برای میزبان (مانند \fBgitea.com\fP) .IP \(bu 2 یک مدخل در فایل \fBnetrc\fP خود برای میزبان .UNINDENT .sp این منبع در صورت تنظیم بودن \fBuse_max_tag\fP، از List Options پشتیبانی می‌کند. .SS بررسی Gogs / Forgejo / Codeberg .sp لطفاً از منبع \(dqgitea\(dq در بالا استفاده کنید. Gitea یک انشعاب از Gogs \% است. Forgejo \% یک انشعاب از Gitea است. Codeberg یک ارائه‌دهندهٔ میزبانی کد است که از Forgejo استفاده می‌کند. آن‌ها از همان نقاط پایانی API مشترکی که nvchecker استفاده می‌کند بهره می‌برند. .sp همچنین می‌توانید منبع عمومی \(dqgit\(dq را نیز امتحان کنید. .SS بررسی BitBucket .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqbitbucket\(dq .EE .UNINDENT .UNINDENT .sp BitBucket \% را برای به‌روزرسانی‌ها بررسی می‌کند. نگارش بازگردانده شده در قالب تاریخ \fB%Y%m%d\fP است، مانند \fB20130701\fP، مگر اینکه از \fBuse_max_tag\fP استفاده شده باشد. به بخش زیر مراجعه کنید. .INDENT 0.0 .TP .B bitbucket مخزن bitbucket به همراه نام نویسنده/مالک، مانند \fBlilydjwg/dotvim\fP\&. .TP .B branch کدام شاخه دنبال شود؟ پیش‌فرض: شاخهٔ پیش‌فرض مخزن است. .TP .B use_max_tag این گزینه را روی \fBtrue\fP تنظیم کنید تا بیشترین تگ در BitBucket بررسی شود. بزرگ‌ترین مورد مرتب‌شده بر اساس نسخهٔ قدیمی \fBpkg_resources.parse_version\fP بازگردانده خواهد شد. به جای تاریخ، نام تگ بازگردانده می‌شود. .TP .B use_sorted_tags اگر روی \fBtrue\fP تنظیم شود، تگ‌ها بر اساس کلیدهای \fBquery\fP و \fBsort\fP پرس‌وجو و مرتب می‌شوند. به جای تاریخ، نام تگ بازگردانده خواهد شد. .TP .B query یک رشتهٔ پرس‌وجو برای پالایش تگ‌ها در صورت تنظیم بودن \fBuse_sorted_tags\fP (برای مشاهدهٔ مثال‌ها به اینجا \% مراجعه کنید). نیازی به گریز دادن (escape) این رشته نیست. .TP .B sort فیلدی که برای مرتب‌سازی تگ‌ها در صورت تنظیم بودن \fBuse_sorted_tags\fP استفاده می‌شود (برای مشاهدهٔ مثال‌ها به اینجا \% مراجعه کنید). پیش‌فرض \fB\-target.date\fP است (تگ‌ها را به ترتیب نزولی تاریخ مرتب می‌کند). .TP .B max_page چند صفحه برای بیشترین تگ جستجو شود؟ پیش‌فرض 3 است. این گزینه زمانی کار می‌کند که \fBuse_max_tag\fP تنظیم شده باشد. .UNINDENT .sp این منبع در صورت تنظیم بودن \fBuse_max_tag\fP یا \fBuse_sorted_tags\fP، از List Options پشتیبانی می‌کند..SS بررسی GitLab .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqgitlab\(dq .EE .UNINDENT .UNINDENT .sp بررسی GitLab \% برای به‌روزرسانی‌ها. نسخهٔ بازگردانده‌شده در قالب تاریخ \fB%Y%m%d\fP است، مانند \fB20130701\fP، مگر اینکه \fBuse_max_tag\fP استفاده شود. بخش زیر را ببینید. .INDENT 0.0 .TP .B gitlab مخزن gitlab، همراه با نویسنده، مانند \fBDeepin/deepin\-music\fP\&. .TP .B branch کدام شاخه ردیابی شود؟ .TP .B use_max_tag این گزینه را روی \fBtrue\fP تنظیم کنید تا بیشترین برچسب (max tag) در GitLab بررسی شود. بزرگ‌ترین مورد مرتب‌شده با \fBpkg_resources.parse_version\fP قدیمی بازگردانده می‌شود. به جای تاریخ، نام برچسب بازگردانده خواهد شد. .TP .B host نام میزبان (hostname) برای نمونهٔ خودمیزبان (self\-hosted) گیت‌لب. .TP .B token توکن احراز هویت GitLab مورد استفاده برای فراخوانی API. .UNINDENT .sp برای تنظیم یک توکن احراز هویت، می‌توانید موارد زیر را تنظیم کنید: .INDENT 0.0 .IP \(bu 2 گزینهٔ token .IP \(bu 2 یک مدخل در keyfile برای میزبان (مانند \fBgitlab.com\fP) .IP \(bu 2 یک مدخل در فایل \fBnetrc\fP خود برای میزبان .UNINDENT .sp این منبع در صورت تنظیم بودن \fBuse_max_tag\fP از List Options پشتیبانی می‌کند. .SS متادادهٔ RichResult .sp در صورت موجود بودن از پاسخ‌های فعلی API گیت‌لب، این منبع فیلدهای اختیاری \fBRichResult\fP زیر را پر می‌کند. هیچ درخواست API اضافی صرفاً برای بازیابی اطلاعات برچسب زمانی ارسال نمی‌شود. .TS box center; l|l|l. T{ حالت T} T{ \fBcreation_time\fP T} T{ \fBrevision_creation_time\fP T} _ T{ کامیت پیش‌فرض T} T{ .INDENT 0.0 .IP \(bu 2 .UNINDENT T} T{ برچسب زمانی کامیت T} _ T{ \fBuse_max_tag\fP T} T{ زمان ایجاد برچسب T} T{ برچسب زمانی کامیت T} .TE .SS بررسی PyPI .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqpypi\(dq .EE .UNINDENT .UNINDENT .sp بررسی PyPI \% برای به‌روزرسانی‌ها. انتشار‌های حذف‌شده (yanked) نادیده گرفته می‌شوند. .INDENT 0.0 .TP .B pypi نام استفاده‌شده در PyPI، مانند \fBPySide\fP\&. .TP .B use_pre_release مشخص می‌کند که آیا پیش‌انتشارها پذیرفته شوند یا خیر. مقدار پیش‌فرض false است. .UNINDENT .sp این منبع از List Options پشتیبانی می‌کند\&. .sp متادادهٔ RichResult: .TS box center; l|l|l. T{ حالت T} T{ \fBcreation_time\fP T} T{ \fBrevision_creation_time\fP T} _ T{ تمام نسخه‌ها T} T{ اولین زمان در دسترس برای بارگذاری فایل T} T{ .INDENT 0.0 .IP \(bu 2 .UNINDENT T} .TE .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 وابستگی اضافی \(dqpackaging\(dq مورد نیاز است. می‌توانید از دستور \fBpip install \(aqnvchecker[pypi]\(aq\fP استفاده کنید\&. .UNINDENT .UNINDENT.SS بررسی RubyGems .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqgems\(dq .EE .UNINDENT .UNINDENT .sp بررسی RubyGems \% برای به‌روزرسانی‌ها. .INDENT 0.0 .TP .B gems نام استفاده‌شده در RubyGems، مانند \fBsass\fP\&. .UNINDENT .sp این منبع از List Options پشتیبانی می‌کند\&. .SS بررسی NPM Registry .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqnpm\(dq .EE .UNINDENT .UNINDENT .sp بررسی NPM Registry \% برای به‌روزرسانی‌ها. .INDENT 0.0 .TP .B npm نام استفاده‌شده در NPM Registry، مانند \fBcoffee\-script\fP\&. .UNINDENT .sp برای پیکربندی این‌که از کدام مخزن پرس‌وجو شود، گزینه‌ای در افزونهٔ منبع در دسترس است. می‌توانید آن را به این صورت مشخص کنید: .INDENT 0.0 .INDENT 3.5 .sp .EX [__config__.source.npm] registry = \(dqhttps://registry.npm.taobao.org\(dq .EE .UNINDENT .UNINDENT .SS بررسی Hackage .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqhackage\(dq .EE .UNINDENT .UNINDENT .sp بررسی Hackage \% برای به‌روزرسانی‌ها. .INDENT 0.0 .TP .B hackage نام استفاده‌شده در Hackage، مانند \fBpandoc\fP\&. .UNINDENT .SS بررسی Maven .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqmaven\(dq .EE .UNINDENT .UNINDENT .sp بررسی یک مخزن Maven \% برای به‌روزرسانی‌ها. .INDENT 0.0 .TP .B repo نشانی (URL) مخزن مورد بررسی (پیش‌فرض: \fBhttps://repo1.maven.org/maven2\fP). .TP .B group شناسهٔ گروه (group) برای مختصات. .TP .B artifact شناسهٔ آرتیفکت (artifact) برای مختصات. .UNINDENT.SS بررسی CPAN .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqcpan\(dq .EE .UNINDENT .UNINDENT .sp بررسی MetaCPAN \% برای به‌روزرسانی‌ها. .INDENT 0.0 .TP .B cpan نام مورد استفاده در CPAN، مانند \fBYAML\fP\&. .UNINDENT .SS بررسی CRAN .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqcran\(dq .EE .UNINDENT .UNINDENT .sp بررسی CRAN \% برای به‌روزرسانی‌ها. .INDENT 0.0 .TP .B cran نام مورد استفاده در CRAN، مانند \fBxml2\fP\&. .UNINDENT .SS بررسی Packagist .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqpackagist\(dq .EE .UNINDENT .UNINDENT .sp بررسی Packagist \% برای به‌روزرسانی‌ها. .INDENT 0.0 .TP .B packagist نام مورد استفاده در Packagist، مانند \fBmonolog/monolog\fP\&. .UNINDENT .SS بررسی crates.io .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqcratesio\(dq .EE .UNINDENT .UNINDENT .sp بررسی crates.io \% برای به‌روزرسانی‌ها. انتشارهای پس‌گرفته‌شده (yanked) نادیده گرفته می‌شوند. .INDENT 0.0 .TP .B cratesio نام crate در crates.io، مانند \fBtokio\fP\&. .TP .B use_pre_release پذیرش یا عدم پذیرش پیش‌انتشار (pre release). مقدار پیش‌فرض false است. .UNINDENT .sp این منبع از List Options پشتیبانی می‌کند\&. .SS بررسی پایگاه‌داده محلی Pacman .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqpacman\(dq .EE .UNINDENT .UNINDENT .sp این مورد هنگامی استفاده می‌شود که \fBnvchecker\fP را روی یک سیستم Arch Linux اجرا می‌کنید و برنامه همیشه با یک بسته در مخازن پیکربندی‌شده شما برای Pacman \% همگام می‌ماند\&. .INDENT 0.0 .TP .B pacman نام بسته برای ارجاع به آن. .TP .B strip_release حذف بخش انتشار (release). .UNINDENT.SS بررسی بسته‌های رسمی Arch Linux .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqarchpkg\(dq .EE .UNINDENT .UNINDENT .sp این گزینه به شما امکان می‌دهد به‌روزرسانی بسته‌های رسمی Arch Linux را از طریق \%، بدون نیاز به pacman و پایگاه‌های داده محلی به‌روزرسانی‌شده‌ی Pacman، رهگیری کنید. .INDENT 0.0 .TP .B archpkg نام بسته Arch Linux. .TP .B strip_release حذف بخش انتشار (release)؛ تنها بخشی که پیش از \fB\-\fP\& می‌آید بازگردانده می‌شود. .TP .B provided به جای نسخه بسته، نسخه‌ای را که این بسته ارائه می‌دهد (provides) بازمی‌گرداند. مقدار آن همان مقداری است که بسته فراهم می‌کند و \fBstrip_release\fP نیز بر آن اعمال می‌شود. بیشترین کاربرد این مورد برای کتابخانه‌ها است. .UNINDENT .SS بررسی بسته‌های رسمی Debian Linux .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqdebianpkg\(dq .EE .UNINDENT .UNINDENT .sp این گزینه به شما امکان می‌دهد به‌روزرسانی بسته‌های رسمی Debian Linux را از طریق \%، بدون نیاز به apt و پایگاه داده محلی به‌روزرسانی‌شده‌ی APT، رهگیری کنید. .INDENT 0.0 .TP .B debianpkg نام بسته منبع (source package) در Debian Linux. .TP .B suite نام انتشار Debian (مانند jessie، wheezy و غیره؛ پیش‌فرض: sid). .TP .B strip_release حذف بخش انتشار (release). .UNINDENT .SS بررسی بسته‌های رسمی Ubuntu Linux .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqubuntupkg\(dq .EE .UNINDENT .UNINDENT .sp این گزینه به شما امکان می‌دهد به‌روزرسانی بسته‌های رسمی Ubuntu Linux را از طریق \%، بدون نیاز به apt و پایگاه داده محلی به‌روزرسانی‌شده‌ی APT، رهگیری کنید. .INDENT 0.0 .TP .B ubuntupkg نام بسته منبع (source package) در Ubuntu Linux. .TP .B suite نام انتشار Ubuntu (مانند xenial، zesty و غیره؛ پیش‌فرض: None، که به معنی عدم اعمال محدودیت روی suite است). .TP .B strip_release حذف بخش انتشار (release). .UNINDENT .SS بررسی Repology .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqrepology\(dq .EE .UNINDENT .UNINDENT .sp این گزینه به شما امکان می‌دهد به‌روزرسانی‌ها را از Repology \% (repology.org) رهگیری کنید. .INDENT 0.0 .TP .B repology نام \fBproject\fP جهت بررسی. .TP .B repo بررسی نسخه در این مخزن (repo). این فیلد الزامی است. .TP .B subrepo بررسی نسخه در این زیرمخزن (subrepo). این فیلد اختیاری است. در صورت حذف، از تمام subrepoها استعلام گرفته می‌شود. .UNINDENT .sp این منبع از List Options\& پشتیبانی می‌کند..SS "بررسی Anitya" .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqanitya\(dq .EE .UNINDENT .UNINDENT .sp این به شما امکان می‌دهد تا به‌روزرسانی‌ها را از Anitya \% (release\-monitoring.org) رهگیری کنید. .INDENT 0.0 .TP .B anitya به‌صورت \fBdistro/package\fP، که در آن \fBdistro\fP می‌تواند موارد متعددی مانند \(dqfedora\(dq، \(dqarch linux\(dq، \(dqgentoo\(dq و غیره باشد. \fBpackage\fP نام بسته در توزیع انتخاب‌شده است. .TP .B anitya_id شناسهٔ پروژه/بسته در anitya. .UNINDENT .sp توجه داشته باشید که باید یکی از anitya یا anitya_id مشخص شود؛ در صورتی که هر دو مشخص شده باشند، anitya_id ترجیح داده می‌شود. .SS "بررسی Android SDK" .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqandroid_sdk\(dq .EE .UNINDENT .UNINDENT .sp این به شما امکان می‌دهد تا به‌روزرسانی‌های بسته‌های Android SDK فهرست‌شده در \fBsdkmanager \-\-list\fP را رهگیری کنید\&. .INDENT 0.0 .TP .B android_sdk پیشوند مسیر بسته. این مقدار با مشخصهٔ \fBpath\fP در تمام گره‌های در یک فایل XML مانیفست SDK مطابقت داده می‌شود. نخستین تطابق برای مقایسهٔ نسخه‌ها استفاده می‌شود. .TP .B repo باید یکی از مقادیر \fBaddon\fP یا \fBpackage\fP باشد\&. بسته‌ها در \fBaddon2\-1.xml\fP از \fBaddon\fP و بسته‌ها در \fBrepository2\-1.xml\fP از \fBpackage\fP استفاده می‌کنند\&. .TP .B channel کانال هدف را از بین یکی از مقادیر \fBstable\fP، \fBbeta\fP، \fBdev\fP یا \fBcanary\fP انتخاب کنید\&. این گزینه همچنین فهرستی جداشده با کاما را برای گزینش از میان چند کانال می‌پذیرد. برای نمونه، تازه‌ترین نسخهٔ ناپایدار با \fBbeta,dev,canary\fP انتخاب می‌شود\&. پیش‌فرض \fBstable\fP است\&. .TP .B host_os سیستم‌عامل هدف برای بستهٔ رهگیری‌شده را از بین \fBlinux\fP، \fBmacosx\fP یا \fBwindows\fP انتخاب کنید\&. پیش‌فرض \fBlinux\fP است\&. برای بسته‌های مستقل از سیستم‌عامل (مانند JARهای جاوا)، از این فیلد صرف‌نظر می‌شود. .UNINDENT .sp این منبع از List Options پشتیبانی می‌کند\&. .SS "بررسی فریم‌ورک Sparkle" .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqsparkle\(dq .EE .UNINDENT .UNINDENT .sp این به شما امکان می‌دهد تا به‌روزرسانی‌های برنامه‌های macOS را که از فریم‌ورک Sparkle استفاده می‌کنند \% رهگیری کنید\&. .INDENT 0.0 .TP .B sparkle نشانی اینترنتی (URL) مربوط به appcast در sparkle. .TP .B release_notes_language زبان یادداشت‌های انتشار برای بازگرداندن در زمان در دسترس بودن یادداشت‌های محلی‌سازی‌شده (پیش‌فرض \fBen\fP برای انگلیسی است؛ یادداشت‌های انتشار محلی‌سازی‌نشده به‌عنوان رزرو/جایگزین استفاده می‌شوند). .UNINDENT .SS "بررسی Pagure" .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqpagure\(dq .EE .UNINDENT .UNINDENT .sp این به شما امکان می‌دهد تا به‌روزرسانی‌ها را از Pagure \% بررسی کنید\&. .INDENT 0.0 .TP .B pagure نام پروژه، به‌صورت اختیاری همراه با یک فضای نام (namespace). .TP .B host نام میزبان نمونهٔ جایگزین مانند src.fedoraproject.org. .UNINDENT .sp این منبع برچسب‌ها (tags) را بازمی‌گرداند و از List Options پشتیبانی می‌کند\&..SS بررسی مخزن APT .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqapt\(dq .EE .UNINDENT .UNINDENT .sp این گزینه امکان ردیابی به‌روزرسانی‌های یک مخزن دلخواه APT را بدون نیاز به apt و یک پایگاه داده محلی به‌روزشدهٔ APT فراهم می‌کند. .INDENT 0.0 .TP .B pkg نام بسته باینری APT. .TP .B srcpkg نام بسته منبع (سورس) APT. .TP .B mirror نشانی اینترنتی (URL) مخزن. .TP .B suite نام انتشار مخزن APT (مانند jessie، wheezy و غیره) .TP .B repo نام بخش مخزن APT (مانند main، contrib و غیره؛ پیش‌فرض main است) .TP .B arch معماری مخزن (i386، amd64 و غیره؛ پیش‌فرض amd64 است) .TP .B strip_release حذف بخش انتشار (release). .UNINDENT .sp توجه داشته باشید که باید یا pkg و یا srcpkg مشخص شود (نه هر دو)، در غیر این صورت از نام آیتم به‌عنوان pkg استفاده خواهد شد. .SS بررسی مخزن RPM .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqrpmrepo\(dq .EE .UNINDENT .UNINDENT .sp این گزینه امکان بررسی آخرین نگارش‌های بسته را در یک مخزن دلخواه RPM با قالب \fIrepomd\fP (مورد استفاده توسط مدیر بسته‌هایی مانند \fBdnf\fP در Fedora، RHEL، AlmaLinux و غیره یا \fBzypper\fP در openSUSE) بدون نیاز به ابزارهای محلی RPM فراهم می‌کند. .INDENT 0.0 .TP .B pkg نام بسته RPM (می‌توانید مانند سایر منابع از \fBrpmrepo\fP نیز استفاده کنید، اما برای شفافیت بیشتر \fBpkg\fP ترجیح داده می‌شود) .TP .B repo نشانی اینترنتی (URL) مخزن (اجباری است، فایل \fBrepodata/repomd.xml\fP باید در آنجا قرار داشته باشد) .TP .B arch معماری بسته RPM (\fBbinary\fP، \fBsrc\fP، \fBany\fP، \fBx86_64\fP، \fBaarch64\fP و غیره؛ پیش‌فرض \fBbinary\fP است) .UNINDENT .sp این منبع از List Options پشتیبانی می‌کند\&. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 وابستگی اضافی \fBlxml\fP مورد نیاز است. در نسخه‌های پایتون پیش از 3.14، به \fBzstandard\fP نیز نیاز است. می‌توانید آن‌ها را با دستور \fBpip install \(aqnvchecker[rpmrepo]\(aq\fP نصب کنید\&. .UNINDENT .UNINDENT .SS بررسی مخزن Git .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqgit\(dq .EE .UNINDENT .UNINDENT .sp این گزینه امکان بررسی برچسب‌ها (تگ‌ها) یا کامیت‌های یک شاخه در یک مخزن دلخواه git را فراهم می‌کند؛ همچنین برای سناریوهایی مانند پروژه‌های github که برچسب‌های بیش از حد زیادی دارند، مفید است. .INDENT 0.0 .TP .B git نشانی اینترنتی (URL) مخزن Git. .TP .B use_commit بازگرداندن هش کامیت به جای برچسب‌ها. .TP .B branch هنگامی که \fBuse_commit\fP درست (true) باشد، کامیت مربوط به شاخه مشخص‌شده را به جای شاخه پیش‌فرض بازمی‌گرداند. .UNINDENT .sp هنگامی که این منبع برچسب‌ها را بازمی‌گرداند (\fBuse_commit\fP درست نیست)، از List Options پشتیبانی می‌کند\&..SS بررسی مخزن Git بدون خط فرمان git با استفاده از pygit2 .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqgit_pygit2\(dq .EE .UNINDENT .UNINDENT .sp این منبع مشابه منبع \fBgit\fP است، اما به جای فراخوانی فایل اجرایی \fBgit\fP از pygit2/libgit2 استفاده می‌کند. این منبع در محیط‌هایی که بسته‌های پایتون قابل نصب هستند اما امکان اجرای باینری‌های خارجی وجود ندارد، مفید است. .INDENT 0.0 .TP .B git نشانی URL مخزن Git. .TP .B username نام کاربری برای احراز هویت HTTP. .TP .B password_key نام کلید مورد استفاده برای بازیابی گذرواژه یا توکن دسترسی از keyfile پیکربندی‌شده. .TP .B use_commit بازگرداندن هش کامیت به جای برچسب‌ها. .TP .B branch هنگامی که \fBuse_commit\fP درست (true) باشد، کامیت را روی شاخهٔ مشخص‌شده به جای شاخهٔ پیش‌فرض بازمی‌گرداند. .UNINDENT .sp مثال برای یک مخزن خصوصی GitHub: .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqgit_pygit2\(dq git = \(dqhttps://github.com/example/private\-repo.git\(dq username = \(dqx\-access\-token\(dq password_key = \(dqgithub\(dq .EE .UNINDENT .UNINDENT .sp هنگامی که این منبع برچسب‌ها را بازمی‌گرداند (\fBuse_commit\fP درست نیست)، از List Options پشتیبانی می‌کند\&. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 وابستگی اضافی \fBpygit2\fP مورد نیاز است. .UNINDENT .UNINDENT .SS بررسی مخزن Git بدون خط فرمان git با استفاده از Dulwich .IP "پیام سیستم: WARNING/2 (usage.rst:, line 1040)" خط زیر عنوان بسیار کوتاه است. .INDENT 0.0 .INDENT 3.5 .sp .EX Check Git repository without git CLI using Dulwich ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .EE .UNINDENT .UNINDENT .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqgit_dulwich\(dq .EE .UNINDENT .UNINDENT .sp این منبع مشابه منبع \fBgit\fP است، اما به جای فراخوانی فایل اجرایی \fBgit\fP از Dulwich استفاده می‌کند. این منبع در محیط‌هایی که بسته‌های پایتون قابل نصب هستند اما امکان اجرای باینری‌های خارجی وجود ندارد، مفید است. .sp این منبع در حال حاضر از متغیرهای محیطی پروکسی پشتیبانی نمی‌کند. .INDENT 0.0 .TP .B git نشانی URL مخزن Git. .TP .B username نام کاربری برای احراز هویت HTTP. .TP .B password_key نام کلید مورد استفاده برای بازیابی گذرواژه یا توکن دسترسی از keyfile پیکربندی‌شده. .TP .B use_commit بازگرداندن هش کامیت به جای برچسب‌ها. .TP .B branch هنگامی که \fBuse_commit\fP درست (true) باشد، کامیت را روی شاخهٔ مشخص‌شده به جای شاخهٔ پیش‌فرض بازمی‌گرداند. .UNINDENT .sp مثال برای یک مخزن خصوصی GitHub: .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqgit_dulwich\(dq git = \(dqhttps://github.com/example/private\-repo.git\(dq username = \(dqx\-access\-token\(dq password_key = \(dqgithub\(dq .EE .UNINDENT .UNINDENT .sp هنگامی که این منبع برچسب‌ها را بازمی‌گرداند (\fBuse_commit\fP درست نیست)، از List Options پشتیبانی می‌کند\&. .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 وابستگی اضافی \fBdulwich\fP مورد نیاز است. .UNINDENT .UNINDENT.SS بررسی مخزن Mercurial .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqmercurial\(dq .EE .UNINDENT .UNINDENT .sp این مورد امکان بررسی تگ‌های یک مخزن دلخواه mercurial (hg) را فراهم می‌کند. .INDENT 0.0 .TP .B mercurial نشانی (URL) مخزن Mercurial. .UNINDENT .sp این منبع تگ‌ها را برمی‌گرداند و از List Options پشتیبانی می‌کند\&. .SS بررسی رجیستری کانتینر .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqcontainer\(dq .EE .UNINDENT .UNINDENT .sp این مورد امکان بررسی تگ‌های ایمیج‌ها روی یک رجیستری کانتینر مانند Docker را فراهم می‌کند. .INDENT 0.0 .TP .B container مسیر (و تگ) ایمیج کانتینر. برای ایمیج‌های رسمی Docker، از فضای نام \fBlibrary/\fP استفاده کنید (مانند \fBlibrary/python\fP). .sp اگر تگی مشخص نشده باشد، آخرین تگ موجود (مرتب‌شده بر اساس نام تگ) را بررسی می‌کند، در غیر این صورت زمان به‌روزرسانی تگ را بررسی می‌کند. .TP .B registry میزبان رجیستری کانتینر. پیش‌فرض: \fBdocker.io\fP .UNINDENT .sp موارد \fBregistry\fP و \fBcontainer\fP میزبان و مسیری هستند که در دستور pull استفاده می‌شوند. توجه داشته باشید که دستور \fBdocker\fP اجازه می‌دهد بخش‌هایی از نام کانتینر حذف شوند، در حالی که این افزونه به نام کامل نیاز دارد. اگر بخش میزبان حذف شده است، از \fBdocker.io\fP استفاده کنید، و اگر اسلشی در مسیر وجود ندارد، \fBlibrary/\fP را به ابتدای مسیر اضافه نمایید. در اینجا چند مثال آورده شده است: .TS box center; l|l|l. T{ دستور pull T} T{ registry T} T{ container T} _ T{ docker pull quay.io/prometheus/node\-exporter T} T{ quay.io T} T{ prometheus/node\-exporter T} _ T{ docker pull quay.io/prometheus/node\-exporter:master T} T{ quay.io T} T{ prometheus/node\-exporter:master T} _ T{ docker pull openeuler/openeuler T} T{ docker.io T} T{ openeuler/openeuler T} _ T{ docker pull openeuler/openeuler:20.03\-lts T} T{ docker.io T} T{ openeuler/openeuler:20.03\-lts T} _ T{ docker pull python T} T{ docker.io T} T{ library/python T} _ T{ docker pull python:3.11 T} T{ docker.io T} T{ library/python:3.11 T} .TE .sp اگر تگی مشخص نشده باشد، این منبع تگ‌ها را برمی‌گرداند و از List Options پشتیبانی می‌کند\&..SS بررسی پایگاه‌داده ALPM .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqalpm\(dq .EE .UNINDENT .UNINDENT .sp بررسی به‌روزرسانی‌های بسته در یک پایگاه‌داده محلی ALPM. .INDENT 0.0 .TP .B alpm نام بسته. .TP .B repo نام مخزن بسته‌ای که بسته در آن قرار دارد. در صورت مشخص نشدن، nvchecker از مقدار \fBrepos\fP استفاده خواهد کرد؛ به بخش زیر مراجعه کنید. .TP .B repos آرایه‌ای از مخازن احتمالی که بسته ممکن است در آن‌ها قرار داشته باشد؛ nvchecker از نخستین مخزنی که حاوی بسته باشد استفاده خواهد کرد. در صورت مشخص نشدن، به ترتیب از \fBcore\fP، \fBextra\fP و \fBmultilib\fP استفاده خواهد شد. .TP .B dbpath مسیر دایرکتوری پایگاه‌داده ALPM. پیش‌فرض: \fB/var/lib/pacman\fP\&. باید پایگاه‌داده را خودتان به‌روزرسانی کنید. .TP .B strip_release حذف بخش انتشار (release)، تنها بخش پیش از \fB\-\fP برگردانده می‌شود. .TP .B provided به جای نسخه بسته، نسخه‌ای که این بسته ارائه می‌دهد برگردانده می‌شود. مقدار آن چیزی است که بسته فراهم می‌کند (provides) و \fBstrip_release\fP نیز اعمال می‌شود. این گزینه برای کتابخانه‌ها بهترین کاربرد را دارد. .UNINDENT .sp \fBنکته:\fP .INDENT 0.0 .INDENT 3.5 وابستگی اضافی \(dqpyalpm\(dq مورد نیاز است. .UNINDENT .UNINDENT .SS بررسی پایگاه‌داده فایل‌های ALPM .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqalpmfiles\(dq .EE .UNINDENT .UNINDENT .sp جستجوی فایل‌های بسته در یک پایگاه‌داده محلی فایل‌های ALPM. نیازی به نصب بودن بسته نیست. این گزینه می‌تواند برای بررسی نسخه‌های کتابخانه مشترک مفید باشد، در صورتی که بسته آن‌ها را در \fBprovides\fP خود فهرست نکرده باشد. .INDENT 0.0 .TP .B pkgname نام بسته. .TP .B filename عبارت باقاعده برای مسیر فایل. اگر شامل یک گروه منطبق باشد، آن گروه برگردانده می‌شود. در غیر این صورت، کل مسیر فایل برگردانده می‌شود. مسیرها دارای اسلش ابتدایی نیستند. برای نمونه، \fBusr/lib/libuv\e\e.so\e\e.([^.]+)\fP با نسخه اصلی (major) کتابخانه مشترک libuv مطابقت دارد. .TP .B repo نام مخزن بسته‌ای که بسته در آن قرار دارد. در صورت مشخص نشدن، تمام مخازن جستجو می‌شوند. .TP .B strip_dir حذف دایرکتوری از مسیر پیش از تطبیق. مقدار پیش‌فرض \fBfalse\fP است. .TP .B dbpath مسیر دایرکتوری پایگاه‌داده ALPM. پیش‌فرض: \fB/var/lib/pacman\fP\&. باید پایگاه‌داده را خودتان با دستور \fBpacman \-Fy\fP به‌روزرسانی کنید. .UNINDENT .sp این منبع دستور \fBpacman \-Flq ...\fP را اجرا می‌کند. برای پیکربندی تعداد نمونه‌های هم‌روند در حال اجرای pacman: .INDENT 0.0 .INDENT 3.5 .sp .EX [__config__.source.alpmfiles] concurrency = 2 .EE .UNINDENT .UNINDENT .sp مقدار پیش‌فرض \fB2\fP است. دستور \fBpacman \-Flq ...\fP حافظه زیادی مصرف می‌کند، بنابراین مراقب باشید. .SS بررسی Open Vsx .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqopenvsx\(dq .EE .UNINDENT .UNINDENT .sp بررسی Open Vsx \% برای به‌روزرسانی‌ها. .INDENT 0.0 .TP .B openvsx شناسه یکتای (Unique Identifier) افزونه در open\-vsx.org، برای نمونه \fBritwickdey.LiveServer\fP\&. .UNINDENT.SS بررسی Visual Studio Code Marketplace .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqvsmarketplace\(dq .EE .UNINDENT .UNINDENT .sp بررسی Visual Studio Code Marketplace \% برای دریافت به‌روزرسانی‌ها. .INDENT 0.0 .TP .B vsmarketplace شناسهٔ یکتای افزونه در marketplace.visualstudio.com/vscode، مانند \fBritwickdey.LiveServer\fP\&. .UNINDENT .SS بررسی بسته‌ها و ماژول‌های Go .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqgo\(dq .EE .UNINDENT .UNINDENT .sp بررسی بسته‌ها و ماژول‌های Go در \% برای دریافت به‌روزرسانی‌ها. .INDENT 0.0 .TP .B go نام بسته یا ماژول Go، مانند \fBgithub.com/caddyserver/caddy/v2/cmd\fP\&. .UNINDENT .SS بررسی مخزن opam .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqopam\(dq .EE .UNINDENT .UNINDENT .sp این منبع امکان بررسی آخرین نسخه‌های بسته در یک \fIمخزن opam \fP دلخواه را بدون نیاز به ابزار خط فرمان opam برای شما فراهم می‌کند. .INDENT 0.0 .TP .B pkg نام بستهٔ opam .TP .B repo نشانی اینترنتی (URL) مخزن (اختیاری؛ در صورت مشخص نشدن، از مخزن پیش‌فرض \fBhttps://opam.ocaml.org\fP استفاده می‌شود) .UNINDENT .sp این منبع از List Options پشتیبانی می‌کند\&. .SS بررسی Snapcraft .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqsnapcraft\(dq .EE .UNINDENT .UNINDENT .sp این منبع امکان بررسی آخرین نسخه‌های بسته در Snapcraft \% را فراهم می‌کند\&. .INDENT 0.0 .TP .B snap نام بستهٔ snap. .TP .B channel نام کانال. .UNINDENT .SS ترکیب نتایج سایر مدخل‌ها .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqcombiner\(dq .EE .UNINDENT .UNINDENT .sp این منبع می‌تواند نتایج حاصل از سایر مدخل‌ها را با یکدیگر ترکیب کند. .INDENT 0.0 .TP .B from فهرستی از نام مدخل‌هایی که باید منتظر نتایج آن‌ها ماند. .TP .B format یک رشتهٔ قالب‌بندی برای ترکیب نتایج در یک رشتهٔ نهایی. .UNINDENT .sp مثال: .INDENT 0.0 .INDENT 3.5 .sp .EX [entry\-1] source = \(dqcmd\(dq cmd = \(dqecho 1\(dq [entry\-2] source = \(dqcmd\(dq cmd = \(dqecho 2\(dq [entry\-3] source = \(dqcombiner\(dq from = [\(dqentry\-1\(dq, \(dqentry\-2\(dq] format = \(dq$1\-$2\(dq .EE .UNINDENT .UNINDENT.SS "به‌روزرسانی دستی" .INDENT 0.0 .INDENT 3.5 .sp .EX source = \(dqmanual\(dq .EE .UNINDENT .UNINDENT .sp این قابلیت به شما امکان می‌دهد نسخه را به‌صورت دستی مشخص کنید (شاید به این دلیل که می‌خواهید هر انتشار را پیش از رسیدن به اسکریپت تأیید کنید). .INDENT 0.0 .TP .B manual رشته نسخه. .UNINDENT .SS "گسترش" .sp امکان گسترش منابع پشتیبانی‌شده با نوشتن افزونه‌ها وجود دارد. برای مستندات به plugin مراجعه کنید. .\" End of generated man page.