himalaya(1) General Commands Manual himalaya(1)

himalaya - واسط خط فرمان برای مدیریت رایانامه‌ها

himalaya [-c|--config] [-a|--account] [-b|--backend] [--json] [--log-level] [--log-file] [-h|--help] [-V|--version] [subcommands]

واسط خط فرمان برای مدیریت رایانامه‌ها.

نخستین بار است که اینجا هستید؟ `himalaya` را بدون هیچ دستوری اجرا کنید: این برنامه پیشنهاد ایجاد یک حساب کاربری کشف‌شده از نشانی رایانامه شما را می‌دهد، کاری که بعداً `himalaya configure` نیز دوباره انجام می‌دهد. هر آنچه که در کشف خودکار پوشش داده نشود، باید به صورت دستی نوشته شود.

مسیر پیش‌فرض فایل پیکربندی را بازنویسی می‌کند.

مسیرهای داده‌شده ابتدا توسط پوسته بسط یافته و سپس (در صورت امکان) متعارف‌سازی می‌شوند. مسیرهای دیگر با مسیر اول ادغام می‌شوند که این امکان را می‌دهد تا پیکربندی عمومی خود را از پیکربندی(های) خصوصی جدا کنید. همچنین می‌توان چندین مسیر را به‌طور هم‌زمان و با جداکننده `:` مانند `$PATH` در یک پوسته POSIX مشخص کرد.

حساب کاربری پیش‌فرض را بازنویسی می‌کند.

نام حساب کاربری متناظر با یک مدخل در جدول سطح ریشه در فایل پیکربندی TOML شما است.

یک بک‌اند خاص را برای دستورهای میان‌پروتکلی تحمیل می‌کند.

تنها توسط دستورهای اشتراکی (`mailboxes`، `envelopes`، `flags`، `messages`) استفاده می‌شود؛ زیرفرمان‌های مختص به هر پروتکل آن را نادیده می‌گیرند و همیشه از بک‌اند خودشان استفاده می‌کنند. با مقدار `auto` (پیش‌فرض)، دستور اشتراکی نخستین بک‌اند پیکربندی‌شده‌ای را که پشتیبانی می‌کند برمی‌گزیند؛ با یک مقدار صریح، فقط از همان بک‌اند استفاده می‌کند و اگر حساب کاربری بلوک پیکربندی متناظری نداشته باشد یا عملیات فاقد پیاده‌سازی برای آن باشد، با خطا متوقف می‌شود (مانند `--backend smtp mailboxes list`).

مقادیر ممکن:

  • auto
  • imap
  • jmap
  • gmail
  • msgraph
  • maildir
  • m2dir
  • pimdir
  • smtp
خروجی JSON را فعال می‌کند.

در صورت تعیین، خروجی دستور (داده‌ها یا خطاها) به عنوان یک رشته JSON نمایش داده می‌شود.

خروجی لاگ را بر اساس سطح فیلتر می‌کند.

در صورت حذف، متغیر محیطی `RUST_LOG` بررسی می‌شود (این متغیر از فیلترهای تفکیک‌شده بر اساس مقصد پشتیبانی می‌کند — مستندات `env_logger` را ببینید). در صورت تعیین، این پرچم مقدار `RUST_LOG` را به‌طور کامل بازنویسی می‌کند.

مقادیر ممکن:

  • off: بدون ثبت لاگ
  • error: فقط خطاها
  • warn: هشدارها و خطاها
  • info: پیام‌های اطلاعاتی و بالاتر
  • debug: پیام‌های اشکال‌زدایی و بالاتر
  • trace: پیام‌های ردگیری و بالاتر (پرحرف‌ترین حالت)
خروجی لاگ را به جای stderr به انتهای فایل ارائه‌شده الحاق می‌کند.

این ویژگی زمانی مفید است که پیام‌های تعاملی (که همیشه در stderr نوشته می‌شوند) ممکن است با خطوط لاگ درآمیزند. فایل در حالت الحاق باز شده و در صورت عدم وجود ایجاد می‌شود.

چاپ راهنما (برای دیدن خلاصه‌ای از راهنما از '-h' استفاده کنید)
چاپ نسخه

مدیریت صندوق‌های پستی با استفاده از API اشتراکی
مدیریت پاکت‌ها (envelopes) با استفاده از API اشتراکی
مدیریت پرچم‌ها با استفاده از API اشتراکی
مدیریت پیام‌ها با استفاده از API اشتراکی
مدیریت پیوست‌ها با استفاده از API اشتراکی
واسط برنامه‌نویسی مختص IMAP
واسط برنامه‌نویسی مختص JMAP
واسط برنامه‌نویسی مختص Gmail
واسط خط فرمان Microsoft Graph
واسط برنامه‌نویسی مختص Maildir
واسط برنامه‌نویسی مختص M2dir
واسط برنامه‌نویسی مختص SMTP
پیکربندی تعاملی یک حساب کاربری
مدیریت حساب‌های کاربری تعریف‌شده در فایل پیکربندی TOML
تولید اسکریپت تکمیل خودکار پوسته برای پوسته(های) مشخص‌شده در پوشه ارائه‌شده
تولید صفحات راهنما (man pages) در پوشه ارائه‌شده
تولید اسکیمای JSON (JSON Schema) خروجی JSON تمامی دستورها در پوشه ارائه‌شده
چاپ این پیام یا راهنمای زیرفرمان(های) ارائه‌شده

گزارش باگ‌ها به:
https://github.com/pimalaya/himalaya/issues

حمایت مالی:
https://pimalaya.org/sponsor

این برنامه بخشی از Pimalaya است؛ نرم‌افزاری آزاد که تماماً از طریق کمک‌های بلاعوض و هدایای مالی تأمین می‌شود. اگر آن را مفید می‌دانید، حمایت از توسعه آن را مد نظر داشته باشید.

vv2.1.0 +imap +m2dir +rustls-ring +pimdir +msgraph +jmap +gmail +maildir +smtp build: linux gnu x86_64 git: unknown, rev unknown

Clément DOUIN (soywod) <pimalaya.org@posteo.net>

himalaya 2.1.0