TSPIN(1)                           tailspin                           TSPIN(1)

نام (NAME)
       tspin - ابزاری برای برجسته‌سازی فایل‌های لاگ

خلاصه دستور (SYNOPSIS)
       tspin [OPTION]... [FILE]...

توضیحات (DESCRIPTION)
       برنامه tailspin یک ابزار خط فرمانی برای برجسته‌سازی فایل‌های لاگ است.

گزینه‌ها (OPTIONS)
       -f, --follow
           دنبال کردن (tail) محتویات فایل.  هنگام استفاده از گزینه --exec
           همیشه فعال است.

       -p, --print
           چاپ خروجی در stdout به‌جای مشاهده محتویات در صفحه‌بند less.  در صورت
           استفاده از stdin همیشه فعال است.

       --theme PATH
           مشخص کردن مسیر فایل پوسته (theme) سفارشی.  در صورت تنظیم نشدن،
           پیش‌فرض XDG_CONFIG_HOME/tailspin/theme.toml یا
           ~/.config/tailspin/theme.toml است.  در ویندوز، پیش‌فرض
           %APPDATA%\tailspin\theme.toml است.  همچنین می‌تواند از طریق متغیر
           محیطی TAILSPIN_THEME تنظیم شود.

       -e, --exec COMMAND
           اجرای دستور و مشاهده خروجی در یک صفحه‌بند.  این دستور سیگنال وقفه
           (interrupt) را به دام می‌اندازد تا امکان لغو و ازسرگیری حالت
           دنبال‌کردن در داخل less فراهم باشد.

           مثال:

               tspin --exec 'kubectl logs -f pod_name'

       --highlight COLOR1:word1,word2,... COLOR2:word3,word4,...
           برجسته‌سازی کلمات ارائه‌شده که با کاما از هم جدا شده‌اند با رنگ
           مشخص‌شده.  رنگ‌های ممکن عبارتند از black، red، green، yellow، blue،
           magenta، cyan و white، که می‌توانند به‌صورت اختیاری پیشوند bright_
           داشته باشند (مانند bright_red).

           مثال:

               tspin logfile.txt --highlight red:error,fail --highlight green:success,ok

       --enable=[HIGHLIGHT_GROUP]
           غیرفعال کردن همه گروه‌های برجسته‌سازی به‌جز موارد مشخص‌شده.  فهرستی از
           گروه‌ها که با کاما از هم جدا شده‌اند.  نمی‌تواند همراه با
           --disable=[HIGHLIGHT_GROUP] استفاده شود.  گروه‌های ممکن: numbers،
           urls، emails، pointers، dates، durations، paths، quotes،
           key-value-pairs، uuids، ipv4، processes، json، keywords.

       --disable=[HIGHLIGHT_GROUP]
           غیرفعال کردن گروه‌های برجسته‌سازی مشخص‌شده.  فهرستی از گروه‌ها که با
           کاما از هم جدا شده‌اند.  نمی‌تواند همراه با
           --enable=[HIGHLIGHT_GROUP] استفاده شود.  گروه keywords کلمات کلیدی
           توکار (بولی‌ها، nullها، سطوح اهمیت لاگ و افعال رایج REST) را کنترل
           می‌کند؛ کلمات کلیدی موجود در فایل پیکربندی و گزینه --highlight همیشه
           اعمال می‌شوند.  گروه‌های ممکن: numbers، urls، emails، pointers،
           dates، durations، paths، quotes، key-value-pairs، uuids، ipv4،
           processes، json، keywords.

       --extras=[EXTRA]
           فعال‌سازی برجسته‌سازهای اضافی.  فهرستی از موارد اضافی که با کاما از
           هم جدا شده‌اند.  مقادیر ممکن: ipv6، jvm-stack-trace.  همچنین می‌تواند
           از طریق متغیر محیطی TAILSPIN_EXTRAS تنظیم شود.

       --pager COMMAND
           جایگزین کردن دستور صفحه‌بند پیش‌فرض استفاده‌شده توسط tspin.  دستور
           باید شامل رشته [FILE] باشد که در داخل برنامه با مسیر فایل جایگزین
           خواهد شد.

           مثال:

               tspin logfile.txt --pager "ov -f [FILE]"

       --completions SHELL
           چاپ کامل‌کننده‌های پوسته (shell completions) در stdout.  مقادیر ممکن:
           bash، elvish، fish، powershell، zsh.

       --generate-default-theme
           چاپ پوسته پیش‌فرض در قالب theme.toml در stdout.  تمام مقادیر در
           خروجی پیش‌فرض هستند: آن را در ~/.config/tailspin/theme.toml کپی کرده
           و سبک‌هایی را که مایل به بازنویسی آن‌ها هستید ویرایش کنید.

محیط (ENVIRONMENT)
       TAILSPIN_PAGER
           متغیر محیطی TAILSPIN_PAGER را برای بازنویسی صفحه‌بند پیش‌فرض تنظیم
           می‌کند.  معادل گزینه --pager است.  دستور باید شامل رشته [FILE] باشد
           که در داخل برنامه با مسیر فایل جایگزین خواهد شد.  برای مثال، "ov -f
           [FILE]".

       TAILSPIN_EXTRAS
           فهرستی از موارد اضافی جداشده با کاما برای فعال‌سازی به‌صورت پیش‌فرض.
           معادل گزینه --extras است.  برای مثال، "jvm-stack-trace" یا
           "ipv6,jvm-stack-trace".

       TAILSPIN_THEME
           مسیر فایل پوسته مورد استفاده.  معادل گزینه --theme است.

همچنین ببینید (SEE ALSO)
       less(1), tail(1)

درباره (ABOUT)
       Ben Sadeh (github.com/bensadeh/tailspin)

       تحت مجوز MIT منتشر شده است.

tailspin 7.0.0                    2026-07-14                          TSPIN(1)