.TH Foundry 1 "November 2025"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH "نام (NAME)"
foundry \- یک محیط توسعه خط فرمان

.SH "خلاصه دستور (SYNOPSIS)"
.B foundry
.RI [OPTION]...
.RI COMMAND
.RI [COMMAND\-OPTIONS]...
.br

.SH "توضیحات (DESCRIPTION)"
.B foundry
یک محیط توسعه و سامانه ساخت است که برای میزکار GNOME طراحی شده است.
این ابزار مدیریت پروژه، یکپارچه‌سازی خط لوله ساخت (build pipeline)، مدیریت SDK
و ابزارهای توسعه گوناگونی را برای ساخت برنامه‌ها و کتابخانه‌ها فراهم می‌کند.

.SH "دستورها (COMMANDS)"

.SS "دستورهای پروژه (Project Commands)"

.TP
.BR init
راه‌اندازی یک پروژه جدید در دایرکتوری جاری.

.SS "دستورهای محیط (Environment Commands)"

.TP
.BR enter
ورود به محیط پروژه در دایرکتوری جاری.

.TP
.BR devenv\ [--\ command]
ورود به محیط ساخت پروژه، مشابه با خط لوله ساخت (build pipeline).

.TP
.BR shell\ [--\ command]
راه‌اندازی یک شل در محیط پروژه یا اجرای command.

.SS "دستورهای فایل (File Commands)"

.TP
.BR guess\-language
تشخیص زبان برنامه‌نویسی یک فایل.

.TP
.BR grep
جستجوی فایل‌ها با استفاده از سازوکار جستجو و جایگزینی Foundry.

.TP
.BR symbol\-tree\ FILE
فهرست کردن نمادهای موجود در
.B FILE
به‌صورت درختی.

.TP
.BR find\-symbol\-at\ FILE\ LINE\ LINE_OFFSET
یافتن نماد در یک موقعیت مشخص در
.B FILE
در سطر
.B LINE
و آفست
.B LINE_OFFSET
(شروع هر دو از ۱).
از
.B --tree
برای چاپ نمادهای والد به‌صورت درختی استفاده کنید.

.TP
.BR ctags\ FILE
نمایه‌سازی
.B FILE
با استفاده از سرویس ctags و ارسال داده‌های ctags به stdout..SS "دستورات ساخت (Build Commands)"

.TP
.BR build
پایپ‌لاین ساخت فعلی را می‌سازد.

.TP
.BR run\ [--\ command]
یک دستور پروژه را در محیط زمان اجرا (runtime) اجرا می‌کند.

.SS "دستورات پایپ‌لاین (Pipeline Commands)"

.TP
.BR pipeline\ info
اطلاعات مربوط به پایپ‌لاین ساخت را نمایش می‌دهد.

.TP
.BR pipeline\ flags
فلگ‌های ساخت را برای پایپ‌لاین ساخت نمایش می‌دهد.

.TP
.BR pipeline\ targets
اهداف ساخت (targets) را برای پایپ‌لاین ساخت فهرست می‌کند.

.TP
.BR pipeline\ which
نشان می‌دهد کدام پایپ‌لاین فعال است.

.TP
.BR pipeline\ invalidate
حافظه موقت (کَش) پایپ‌لاین را باطل می‌کند.

.TP
.BR pipeline\ link\ PHASE\ PROJECT_DIRECTORY\ LINKED_PHASE
یک فضای کاری را به پایپ‌لاین ساخت پیوند می‌دهد. این مرحله در
.B PHASE
از پایپ‌لاین فعلی اجرا شده و پایپ‌لاین پیوندداده‌شده را در
.B LINKED_PHASE
اجرا می‌کند.

.TP
.BR pipeline\ unlink\ PHASE\ PROJECT_DIRECTORY
پیوند یک فضای کاری را از پایپ‌لاین ساخت لغو می‌کند. مدخل‌های منطبق با
.B PHASE
و
.B PROJECT_DIRECTORY
را از فضاهای کاری پیوندداده‌شده حذف می‌کند.

.SS "دستورات پیکربندی (Configuration Commands)"

.TP
.BR config\ list
پیکربندی‌های موجود را فهرست می‌کند.

.TP
.BR config\ switch
پیکربندی فعال را تغییر می‌دهد.

.SS "دستورات SDK (SDK Commands)"

.TP
.BR sdk\ list
کیت‌های توسعه (SDK) موجود را فهرست می‌کند.

.TP
.BR sdk\ install\ SDK_ID
یک SDK مشخص را نصب می‌کند.

.TP
.BR sdk\ switch\ SDK_ID
SDK فعال را برای پایپ‌لاین ساخت تغییر می‌دهد.
در صورت امکان، این کار پیکربندی فعلی شما را برای استفاده از SDK به‌روزرسانی می‌کند.

.TP
.BR sdk\ shell\ SDK_ID
وارد یک پوسته (shell) در محیط SDK می‌شود.

.TP
.BR sdk\ which\ PROGRAM
محل قرارگیری برنامه را نشان می‌دهد.SS "دستورات وابستگی‌ها (Dependencies Commands)"

.TP
.BR dependencies\ list
فهرست کردن وابستگی‌های پروژه.

.TP
.BR dependencies\ update
به‌روزرسانی وابستگی‌های پروژه.
این دستور وابستگی‌ها را کامپایل و ساخت (build) نمی‌کند.
برای ساخت وابستگی‌ها از
.B foundry\ build
استفاده کنید.

.SS "دستورات دستگاه (Device Commands)"

.TP
.BR device\ list
فهرست کردن دستگاه‌های در دسترس.

.TP
.BR device\ switch
تغییر دستگاه هدف فعلی.

.SS "دستورات استقرار (Deployment Commands)"

.TP
.BR deploy
استقرار پروژه روی دستگاه فعال.

.SS "دستورات آزمون (Test Commands)"

.TP
.BR test\ list
فهرست کردن آزمون‌های واحد (unit tests) در دسترس.

.TP
.BR test\ run\ TEST_ID
اجرای یک آزمون واحد.

.SS "دستورات جست‌وجو (Search Commands)"

.TP
.BR search
استفاده از موتور جست‌وجوی سراسری برای جست‌وجو در کل پروژه.

.TP
.BR show\ FILE
باز کردن
.B FILE
در مرورگر فایل ترجیحی.

.SS "دستورات تنظیمات (Settings Commands)"

.TP
.BR settings\ get\ SCHEMA\ KEY
دریافت مقدار یک تنظیم با اعمال اولویت تنظیمات به ترتیب از بازنویسی‌های کاربر (user overrides)، تنظیمات پروژه، و تنظیمات سراسری برنامه.

.TP
.BR settings\ set\ SCHEMA\ KEY\ VALUE
تنظیم مقدار یک پیکربندی. از
.B --global
برای تعیین تنظیم به عنوان پیش‌فرض کاربر استفاده کنید.
از
.B --project
برای تعیین تنظیم به عنوان پیش‌فرض پروژه (شامل سایر کاربرانی که پروژه را کلون می‌کنند) استفاده کنید.
در غیر این صورت، این تنظیم تنها برای کاربر فعلی و در پروژه فعلی اعمال می‌شود.

.SS "دستورات اطلاعات محرمانه (Secret Commands)"

.TP
.BR secret\ get\-api\-key HOSTNAME SERVICE
دریافت یک کلید API از مخزن داده‌های محرمانه (secret store).
برای مثال:
.B foundry\ secret\ get\-api\-key gitlab.gnome.org gitlab

.TP
.BR secret\ check\-expires\-at HOSTNAME SERVICE
بررسی زمان انقضای کلید API برای یک سرویس در یک نام میزبان (hostname) مشخص.
تاریخ انقضا در منطقه زمانی محلی نمایش داده خواهد شد.

.TP
.BR secret\ rotate HOSTNAME SERVICE
چرخش و نوسازی (rotate) کلید API برای یک سرویس در یک نام میزبان مشخص.
کلید API با استفاده از یک افزونه ثبت‌شده برای چرخش کلید تغییر یافته و کلید جدید به‌صورت امن ذخیره خواهد شد.

.TP
.BR secret\ set\-api\-key HOSTNAME SERVICE API_KEY
ذخیره یک کلید API در مخزن داده‌های محرمانه (secret store)..SS "دستورهای عیب‌یابی (Diagnosis Commands)"

.TP
.BR diagnose\ FILE
تشخیص و عیب‌یابی مشکلات در
.B FILE

.SH "دستورهای شرطی (CONDITIONAL COMMANDS)"

دستورهای زیر تنها هنگامی در دسترس هستند که ویژگی‌های خاصی در زمان ساخت فعال شده باشند:

.SS دستورهای Git (نیازمند feature-git)

.TP
.BR clone
کلون کردن یک مخزن در یک دایرکتوری پروژهٔ جدید.

.SS دستورهای مستندات (نیازمند feature-docs)

.TP
.BR doc\ bundle\ install
نصب یک بستهٔ مستندات خاص.

.TP
.BR doc\ bundle\ list
فهرست کردن بسته‌های مستندات موجود.

.TP
.BR doc\ query\ KEYWORD
جستجو در مستندات.

.SS دستورهای Forge (نیازمند feature-forge)

.TP
.BR forge\ list
فهرست کردن یکپارچه‌سازی‌های forge موجود.

.TP
.BR forge\ issues\ list
فهرست کردن issueها از forge.

.TP
.BR forge\ merge\-requests\ list
فهرست کردن درخواست‌های ادغام (merge requests) از forge.

.TP
.BR forge\ project
نمایش اطلاعات دربارهٔ پروژهٔ forge.

.TP
.BR forge\ switch\ FORGE_ID
.TP
.BR forge\ switch\ \-\-clear
تعویض یکپارچه‌سازی فعال forge.
از
.B --clear
برای پاک‌سازی تنظیمات forge به‌جای تنظیم کردن آن استفاده کنید.

.TP
.BR forge\ user
نمایش اطلاعات دربارهٔ کاربر forge.

.SS دستورهای ویرایش متن (نیازمند feature-text)

.TP
.BR grep
جستجوی الگوهای متنی در فایل‌های منبع.

.SS دستورهای LLM (نیازمند feature-llm)

.TP
.BR llm\ list\-models
فهرست کردن مدل‌های زبانی موجود.

.TP
.BR llm\ list\-resources
فهرست کردن منابع موجود.

.TP
.BR llm\ list\-tools
فهرست کردن ابزارهای LLM موجود.

.TP
.BR llm\ complete
تکمیل متن با استفاده از یک مدل زبانی..SS دستورهای MCP (نیازمند feature-mcp)

.TP
.BR mcp
اجرای سرور MCP.
این سرور از طریق stdin/stdout و با استفاده از Model Context Protocol ارتباط برقرار می‌کند.

.SS دستورهای LSP (نیازمند feature-lsp)

.TP
.BR lsp\ list
فهرست کردن افزونه‌های سرور زبان (LSP) موجود.

.TP
.BR lsp\ prefer
تنظیم LSP ترجیحی برای یک زبان.

.TP
.BR lsp\ run
اجرای یک سرور زبان برای زبانی مشخص.

.SS دستورهای الگو (نیازمند feature-templates)

.TP
.BR template\ create
ایجاد یک پروژه جدید از روی یک الگو.

.TP
.BR template\ list
فهرست کردن الگوهای پروژه موجود.

.SS دستورهای کنترل نسخه (نیازمند feature-vcs)

.TP
.BR vcs\ blame
نمایش اطلاعات blame برای فایل‌ها.

.TP
.BR vcs\ fetch
دریافت تغییرات از مخازن دوردست (remote).

.TP
.BR vcs\ ignored
فهرست کردن فایل‌های نادیده‌گرفته‌شده.

.TP
.BR vcs\ list
فهرست کردن اطلاعات کنترل نسخه.

.TP
.BR vcs\ list\-branches
فهرست کردن شاخه‌های موجود در مخزن.

.TP
.BR vcs\ list\-files
فهرست کردن فایل‌های ردیابی‌شده توسط کنترل نسخه.

.TP
.BR vcs\ list\-remotes
فهرست کردن مخازن دوردست.

.TP
.BR vcs\ list\-tags
فهرست کردن برچسب‌ها (تگ‌ها) در مخزن.

.TP
.BR vcs\ log\ FILE
نمایش تاریخچه ثبت تغییرات (commit) برای FILE.

.TP
.BR vcs\ switch
تغییر شاخه‌ها یا checkoutها.

.SH "گزینه‌ها (OPTIONS)"

.TP
.BR \-\-shared
استفاده از حالت اشتراکی برای دستور.

.TP
.BR \-h ", " \-\-help
نمایش اطلاعات راهنما برای دستور..SH "مثال‌ها (EXAMPLES)"

راه‌اندازی یک پروژه جدید:
.RS
.B foundry init
.RE

ساخت پروژه:
.RS
.B foundry build
.RE

اجرای یک دستور پروژه:
.RS
.B foundry run
.RE

ورود به محیط ساخت:
.RS
.B foundry devenv
.RE

فهرست کردن SDKهای موجود:
.RS
.B foundry sdk list
.RE

نصب یک SDK:
.RS
.B foundry sdk install org.gnome.Sdk/x86_64/master
.RE

راه‌اندازی یک سرور زبان:
.RS
.B foundry lsp run python3
.RE

.SH "ویژگی‌ها (FEATURES)"
ممکن است Foundry با غیرفعال یا حذف شدن ویژگی‌های گوناگونی کامپایل شده باشد.
اگر ویژگی زیربنایی مربوطه در نسخهٔ Foundry شما کامپایل نشده باشد،
ممکن است برخی از دستورها در دسترس نباشند.

.SH "همچنین ببینید (SEE ALSO)"
برای اطلاعات بیشتر، وب‌سایت زیر را ببینید:
https://devsuite.app

.SH "گزارش باگ‌ها (BUGS)"
گزارش‌های اشکال را می‌توانید در نشانی زیر یافته یا ثبت کنید:
https://gitlab.gnome.org/chergert/foundry/issues