نام (NAME)

pkgctl-version-setup - تشخیص خودکار و راه‌اندازی پیکربندی اولیه برای nvchecker

خلاصه دستور (SYNOPSIS)

pkgctl version setup [OPTIONS] [PKGBASE...]

توضیحات (DESCRIPTION)

این زیردستور با تحلیل آرایه منبع (source) مشخص‌شده در فایل PKGBUILD(1) یک بسته، ساخت یک فایل پیکربندی پایه‌ای nvchecker(1) را خودکارسازی می‌کند. این دستور پلتفرم‌ها و APIهای مختلف استفاده‌شده توسط منابع بسته (مانند GitHub، GitLab و PyPI) را به صورت هوشمند تشخیص داده و بر اساس بهترین حدس خود، یک پیکربندی .nvchecker.toml متناظر تولید می‌کند.

این ابزار به‌ویژه برای راه‌اندازی تنظیمات nvchecker(1) برای یک بسته بدون نیاز به نوشتن دستی فایل .nvchecker.toml بسیار سودمند است. همچنین فرآیند تنظیم بررسی نسخه‌ها را ساده می‌کند، به‌ویژه هنگام انتقال نظارت بر یک بسته از یک پلتفرم منبع به پلتفرمی دیگر یا آغاز بررسی نسخه برای یک بسته جدید.

اگر هیچ PKGBASE مشخص نشود، این دستور به‌طور پیش‌فرض از دایرکتوری کاری جاری استفاده می‌کند.

برای مشاهده فهرستی از منابع پشتیبانی‌شده و قالب‌های مورد انتظار نشانی اینترنتی (URL) آن‌ها، لطفاً به بخش منابع مراجعه کنید.

گزینه‌ها (OPTIONS)

-f, --force

بازنویسی پیکربندی موجود nvchecker(1)

--prefer-platform-api

ترجیح دادن API اختصاصی پلتفرم (GitHub/GitLab) به گیت در موارد پیچیده

--url URL

استخراج هدف بررسی از نشانی اینترنتی داده‌شده به جای ورودی‌های آرایه منبع

--no-check

عدم اجرای pkgctl-version-check(1) پس از راه‌اندازی

--no-upstream

ایجاد یک پیکربندی خالی برای بسته‌های فاقد منابع بالادست، مانند فرابسته‌ها (meta packages). این گزینه فقط باید برای موارد بدون بالادست استفاده شود؛ لطفاً برای منابع بالادستی که پیکربندی آن‌ها دشوار است، جهت راهنمایی با تیم توسعه‌دهندگان تماس بگیرید.

-h, --help

نمایش متن راهنما

منابع (SOURCES)

در اینجا پلتفرم‌ها و منابع پشتیبانی‌شده فعلی، به همراه نمونه‌هایی از قالب‌های نشانی اینترنتی (URL) که امکان تشخیص خودکار آن‌ها را به عنوان انواع منابع خاص فراهم می‌کنند، آورده شده است:

Git

• https://github.com/example/project

• https://gitlab.com/example/group/project

•git://git.foobar.org/example

•git+https://git.foobar.org/example

GitHub

• https://github.com/example/project

• https://github.com/example/project/archive/v1.0/project-v1.0.tar.gz

GitLab

• https://gitlab.com/example/group/project

• https://gitlab.archlinux.org/archlinux/devtools.git

• https://gitlab.archlinux.org/archlinux/devtools/-/releases/v1.1.0/downloads/devtools-v1.1.0.tar.gz

Hackage

• https://hackage.haskell.org/package/xmonad

• https://hackage.haskell.org/package/xmonad-0.18.0/xmonad-0.18.0.tar.gz

• https://hackage.haskell.org/packages/archive/xmonad/0.18.0/xmonad-0.18.0.tar.gz

NPM

• https://registry.npmjs.org/node-gyp/-/node-gyp-10.0.1.tgz

• https://www.npmjs.com/package/node-gyp

PyPI

• https://pypi.io/packages/source/p/pyflakes

• https://pypi.org/packages/source/b/bleach

• https://files.pythonhosted.org/packages/source/p/pyflakes

• https://pypi.org/project/SQLAlchemy

RubyGems

• https://rubygems.org/downloads/diff-lcs-1.5.1.gem

• https://rubygems.org/gems/diff-lcs

CPAN

• https://search.cpan.org/CPAN/authors/id/C/CO/COSIMO/Locale-PO-0.27.tar.gz

• https://cpan.metacpan.org/authors/id/C/CO/COSIMO/Locale-PO-0.27.tar.gz

crates.io

• https://static.crates.io/crates/shotgun/shotgun-1.0.crate

• https://crates.io/api/v1/crates/shotgun/1.0/download

• https://crates.io/crates/git-smash

مثال‌ها (EXAMPLES)

pkgctl version setup

منبع را از PKGBUILD(1) دایرکتوری جاری تشخیص داده و یک فایل .nvchecker.toml پایه را راه‌اندازی می‌کند.

pkgctl version setup --url https://github.com/example/project

یک فایل .nvchecker.toml برای PKGBUILD(1) جاری تولید می‌کند اما نشانی اینترنتی منبع را با پروژه مشخص‌شده در گیت‌هاب جایگزین می‌نماید.

همچنین ببینید (SEE ALSO)

pkgctl-version(1) pkgctl-version-check(1) nvchecker(1) PKGBUILD(5)

صفحه خانگی (HOMEPAGE)

https://gitlab.archlinux.org/archlinux/devtools

لطفاً باگ‌ها و درخواست‌های ویژگی جدید را در بخش ردیاب مشکلات (issue tracker) گزارش دهید. لطفاً تمام تلاش خود را برای ارائه یک نمونه آزمایشی قابل بازتولید جهت بازآفرینی باگ‌ها به کار گیرید.