TSPIN(1) tailspin TSPIN(1)

tspin - ابزاری برای برجسته‌سازی فایل‌های لاگ

tspin [OPTION]... [FILE]...

برنامه tailspin یک ابزار خط فرمانی برای برجسته‌سازی فایل‌های لاگ است.

-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 کپی کرده و سبک‌هایی را که مایل به بازنویسی آن‌ها هستید ویرایش کنید.

TAILSPIN_PAGER

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

TAILSPIN_EXTRAS

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

TAILSPIN_THEME

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

less(1), tail(1)

Ben Sadeh (github.com/bensadeh/tailspin)

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

2026-07-14 tailspin 7.0.0