نام (NAME)

batgrep - جستجو در پروندهها از طریق ripgrep و نمایش نتایج با bat

توضیحات (DESCRIPTION)

جستجو در میان پرونده‌ها یا دایرکتوری‌ها برای یافتن عبارات باقاعده منطبق (یا رشته‌های ثابت با -F)، و چاپ خروجی با استفاده از bat برای تجربه‌ای آسان با قابلیت برجسته‌سازی نحوی (syntax highlighting).

روش استفاده (USAGE)

batgrep [گزینه‌ها] الگو [مسیر...]

گزینه‌ها (OPTIONS)

کوتاه	بلند	توضیحات

-i	--ignore-case	استفاده از جستجوی بدون حساسیت به حروف کوچک و بزرگ.
-s	--case-sensitive	استفاده از جستجوی حساس به حروف کوچک و بزرگ.
-S	--smart-case	استفاده از جستجوی هوشمند به بزرگی و کوچکی حروف (smart case).
-A	--after-context=[LINES]	نمایش n خط بعدی پس از خط منطبق.
-B	--before-context=[LINES]	نمایش n خط قبلی پیش از خط منطبق.
-C	--context=[LINES]	ترکیبی از --after-context و --before-context.
-p	--search-pattern	دستور به صفحه‌بند (pager) برای جستجوی PATTERN. صفحه‌بندهای پشتیبانی‌شده فعلی: less.
	--no-follow	عدم دنبال کردن پیوندهای نمادین (symlinks).
	--no-snip	تزیین snip نمایش داده نشود. این مورد هنگامی که --context=0 باشد یا نگارش bat --version کمتر از 0.12.x باشد، به طور خودکار فعال است.
	--no-highlight	برجسته نکردن خطوط منطبق. این مورد هنگامی که --context=0 باشد به طور خودکار فعال است.
	--color	اجبار خروجی رنگی.
	--no-color	غیرفعال‌سازی اجباری خروجی رنگی.
	--paging=["never"/"always"]	فعال/غیرفعال کردن صفحه‌بندی (paging).
	--pager=[PAGER]	تعیین صفحه‌بند مورد استفاده.
	--terminal-width=[COLS]	تولید خروجی برای عرض مشخص‌شده ترمینال.
	--no-separator	غیرفعال کردن چاپ جداکننده میان پرونده‌ها.
	--rga	استفاده از ripgrep-all به‌جای ripgrep.

گزینه‌های زیر مستقیماً به ripgrep فرستاده می‌شوند و توسط این اسکریپت پردازش نمی‌شوند.

کوتاه	بلند	یادداشت‌ها

-F	--fixed-strings
-U	--multiline
-P	--pcre2
-z	--search-zip
-w	--word-regexp
	--one-file-system
	--multiline-dotall
	--ignore / --no-ignore
	--crlf / --no-crlf
	--hidden / --no-hidden
-E	--encoding	این گزینه توسط bat پشتیبانی نمی‌شود، و ممکن است هنگام تلاش برای نمایش کدگذاری‌های پشتیبانی‌نشده اختلال ایجاد کند.
-g	--glob
-t	--type
-T	--type-not
-m	--max-count
	--max-depth
	--iglob
	--ignore-file

هشدارها و نکات (CAVEATS)

تفاوت‌ها با ripgrep:

- گزینه --follow به طور پیش‌فرض برای batgrep فعال است.

- تمام گزینه‌های ripgrep پشتیبانی نمی‌شوند.