نام (NAME)

kitten-@-kitten - اجرای یک ابزار کیتن خاص از طریق پروتکل کنترلی kitty

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

kitten @ kitten kitten_name

توضیحات (DESCRIPTION)

اجرای یک کیتن (kitten) روی پنجره‌های مشخص‌شده (به‌طور پیش‌فرض پنجره فعال). پارامتر kitten_name می‌تواند نام یک کیتن توکار یا مسیر یک فایل پایتون حاوی کیتن سفارشی باشد. اگر از یک مسیر نسبی استفاده شود، در دایرکتوری پیکربندی kitty جستجو می‌شود. چنانچه کیتن از نوع بدون رابط کاربری (no_ui) باشد و متد پاسخگویی (handle response) آن یک رشته یا مقدار بولی برگرداند، در خروجی استاندارد (stdout) چاپ می‌شود.

گزینه‌ها (OPTIONS)

--match, -m

پنجره مورد نظر برای تطبیق. مشخصات تطبیق به صورت field:query هستند. در اینجا field می‌تواند یکی از موارد زیر باشد: id، title، pid، cwd، cmdline، num، env، var، state، neighbor، session و recent. مقدار query عبارت مورد نظر برای تطبیق است. عبارت‌ها می‌توانند یک عدد یا یک عبارت منظم باشند و می‌توان آن‌ها را با عملگرهای بولی ترکیب کرد.

مقدار ویژه all با تمام پنجره‌ها تطبیق می‌یابد.

برای فیلدهای عددی: id، pid، num و recent، عبارت به عنوان یک عدد تفسیر می‌شود و نه عبارت منظم. مقادیر منفی برای id از بالاترین شماره شناسه به پایین تطبیق می‌یابند؛ به‌ویژه، -1 نشان‌دهنده جدیدترین پنجره ایجاد‌شده است.

فیلد num به موقعیت پنجره در زبانه فعلی اشاره دارد که از صفر شروع شده و در جهت عقربه‌های ساعت شمارش می‌شود (این ترتیب مشابه ترتیبی است که پنجره‌ها توسط دستور kitten @ ls گزارش می‌شوند).

شناسه پنجره فعلی از طریق متغیر محیطی KITTY_WINDOW_ID در دسترس است.

فیلد recent به پنجره‌های اخیراً فعال در زبانه فعال فعلی اشاره دارد؛ به‌طوری‌که صفر پنجره فعال فعلی، یک پنجره فعال قبلی و به همین ترتیب است.

فیلد neighbor به همسایه پنجره فعال در جهت مشخص‌شده اشاره دارد که می‌تواند یکی از موارد زیر باشد: left، right، top یا bottom.

فیلد session با پنجره‌هایی که در نشست مشخص‌شده ایجاد شده‌اند تطبیق می‌یابد. از عبارت ^$ برای تطبیق با پنجره‌هایی که در هیچ نشستی ایجاد نشده‌اند، از . برای تطبیق با نشست فعال فعلی و از ~ برای تطبیق با نشست فعال فعلی یا آخرین نشست فعال در زمان نبود نشست فعال استفاده کنید.

هنگام استفاده از فیلد env برای تطبیق بر اساس متغیرهای محیطی، می‌توانید تنها نام متغیر محیطی یا نام و مقدار آن را مشخص کنید؛ برای مثال: env:MY_ENV_VAR=2.

به‌طور مشابه، فیلد var با متغیرهای کاربری تنظیم‌شده روی پنجره تطبیق می‌یابد. مانند فیلد env می‌توانید تنها نام یا نام و مقدار را مشخص کنید.

فیلد state با وضعیت پنجره تطبیق می‌یابد. وضعیت‌های پشتیبانی‌شده عبارتند از: active، focused، needs_attention، parent_active، parent_focused، focused_os_window، self و overlay_parent. پنجره‌های active پنجره‌هایی هستند که در زبانه والد خود فعال می‌باشند. تنها یک پنجره focused وجود دارد و پنجره‌ای است که رویدادهای صفحه‌کلید به آن تحویل داده می‌شود. اگر هیچ پنجره‌ای فوکوس نداشته باشد، با آخرین پنجره فوکوس‌شده تطبیق می‌یابد. مقدار focused_os_window با تمام پنجره‌های موجود در پنجره سیستم‌عامل با فوکوس فعلی تطبیق می‌یابد. مقدار self با پنجره‌ای که دستور کنترل از راه دور در آن اجرا می‌شود تطبیق می‌یابد. مقدار overlay_parent با پنجره‌ای تطبیق می‌یابد که زیر پنجره self قرار دارد (زمانی که پنجره self یک لایه روکش است).

توجه داشته باشید که می‌توانید از دستور kitten @ ls برای دریافت فهرستی از پنجره‌ها استفاده کنید.

--help, -h [=no]

نمایش راهنمای این دستور.

گزینه‌های سراسری (GLOBAL OPTIONS)

--to: نشانی نمونه kitty مورد نظر برای کنترل. متناظر با نشانی داده‌شده به نمونه kitty از طریق گزینه --listen-on یا تنظیم listen_on در kitty.conf است. در صورت مشخص نشدن، متغیر محیطی KITTY_LISTEN_ON بررسی می‌شود. اگر آن نیز یافت نشود، پیام‌ها به ترمینال کنترل‌کننده این فرآیند ارسال می‌شوند؛ یعنی تنها در صورتی کار خواهند کرد که این فرآیند درون یک پنجره kitty اجرا شود.
--password: رمز عبوری برای استفاده هنگام برقراری ارتباط با kitty. این باعث می‌شود kitty از کاربر برای انجام عمل مشخص‌شده اجازه بخواهد، مگر اینکه رمز عبور قبلاً پذیرفته شده باشد یا در kitty.conf از پیش پیکربندی شده باشد. برای استفاده از رمز عبور خالی، گزینه --use-password را روی always قرار دهید.
--password-file [=rc-pass]: فایلی که رمز عبور از آن خوانده می‌شود. فاصله‌های خالی انتهایی نادیده گرفته می‌شوند. مسیرهای نسبی از دایرکتوری پیکربندی kitty سنجیده می‌شوند. از - برای خواندن از STDIN استفاده کنید. از fd:num برای خواندن از توصیف‌گر فایل num استفاده کنید. در صورتی استفاده می‌شود که هیچ --password مشخص نشده باشد. پیش‌فرض بررسی فایل rc-pass در دایرکتوری پیکربندی kitty است.
--password-env [=KITTY_RC_PASSWORD]: نام متغیر محیطی برای خواندن رمز عبور از آن. در صورتی استفاده می‌شود که گزینه --password-file مشخص نشده باشد. پیش‌فرض بررسی متغیر محیطی KITTY_RC_PASSWORD است.
--use-password [=if-available]: اگر هیچ رمز عبوری در دسترس نباشد، kitty معمولاً فقط دستور کنترل از راه دور را بدون رمز عبور ارسال می‌کند. از این گزینه می‌توان برای اجبار به استفاده همیشگی یا هرگز استفاده نکردن از رمز عبور ارائه‌شده استفاده کرد. اگر روی always تنظیم شود و رمز عبوری ارائه نشده باشد، از رمز عبور خالی استفاده می‌شود.
انتخاب‌ها: if-available, always, never