Клон утилиты cat(1) с поддержкой выделения синтаксиса и Git
Ключевые возможности •
Использование •
Установка •
Кастомизация •
Цели и альтернативы
[English]
[中文]
[日本語]
[한국어]
[Русский]
bat
поддерживает выделение синтаксиса для огромного количества языков программирования и разметки:
bat
использует git
, чтобы показать изменения в коде
(смотрите на левый сайдбар):
Вы можете использовать -A
/ --show-all
флаг, чтобы показать символы, которые невозможно напечатать:
bat
умеет перенаправлять вывод в less
, если вывод не помещается на экране полностью.
О... Вы также можете объединять файлы 😉. Когда
bat
обнаружит неинтерактивный терминал (например, когда вы перенаправляете вывод в файл или процесс), он будет работать как утилита cat
и выведет содержимое файлов как обычный текст (без подсветки синтаксиса).
Вывести единственный файл в терминале
> bat README.md
Отобразить сразу несколько файлов в терминале
> bat src/*.rs
Читаем из stdin и определяем синтаксис автоматически (внимание: это делается по заглавной строке файла, например, #!/bin/sh
)
> curl -s https://sh.rustup.rs | bat
Прочитать из stdin с явным указанием языка
> yaml2json .travis.yml | json_pp | bat -l json
Вывести и выделить неотображаемые символы
> bat -A /etc/hosts
Использование в качестве замены cat
bat > note.md # мгновенно создаем новый файл
bat header.md content.md footer.md > document.md
bat -n main.rs # показываем только количество строк
bat f - g # выводит 'f' в stdin, а потом 'g'.
Вы можете использовать флаг -exec
в find
, чтобы посмотреть превью всех файлов в bat
find … -exec bat {} +
Если вы используете fd
, применяйте для этого флаг -X
/--exec-batch
:
fd … -X bat
С помощью batgrep
, bat
может быть использован для вывода результата запроса ripgrep
batgrep needle src/
bat
может быть использован вместе с tail -f
, чтобы выводить содержимое файла с подсветкой синтаксиса в реальном времени.
tail -f /var/log/pacman.log | bat --paging=never -l log
Заметьте, что мы должны отключить пэйджинг, чтобы это заработало. Мы также явно указали синтаксис (-l log
), так как он не может быть автоматически определен в данном случае.
Вы можете использовать bat
с git show
, чтобы просмотреть старую версию файла с выделением синтаксиса:
git show v0.6.0:src/main.rs | bat -l rs
Обратите внимание, что выделение синтаксиса не работает в git diff
на данный момент. Если вам это нужно, посмотрите delta
.
Нумерация стро и отображение изменений затрудняет копирование содержимого файлов в буфер обмена.
Чтобы спроваиться с этим, используйте флаг -p
/--plain
или просто перенаправьте стандартный вывод в xclip
:
bat main.cpp | xclip
bat
обнаружит перенаправление вывода и выведет обычный текст без выделения синтаксиса.
bat
может быть использован в виде выделения цвета для man
, для этого установите переменную окружения
MANPAGER
:
export MANPAGER="sh -c 'col -bx | bat -l man -p'"
man 2 select
Возможно вам понадобится также установить MANROFFOPT="-c"
, если у вас есть проблемы с форматированием.
Если вы хотите сделать этой одной командой, вы можете использовать batman
.
Обратите внимание, что синтаксис manpage разрабатывается в этом репозитории и все еще находится в разработке.
Prettybat
— скрипт, который форматирует код и выводит его с помощью bat
.
... и другие дистрибутивы основанные на Debian.
bat
есть в репозиториях Ubuntu и
Debian и доступен начиная с Ubuntu Eoan 19.10. На Debian bat
пока что доступен только с нестабильной веткой "Sid".
Если ваша версия Ubuntu/Debian достаточно новая, вы можете установить bat
так:
apt install bat
Если вы установили bat
таким образом, то бинарный файл может быть установлен как batcat
вместо bat
(из-за конфликта имени с другим пакетом). Вы можете сделать симлинк или алиас bat -> batcat
, чтобы предотвратить подобные проблемы и в других дистрибутивах.
mkdir -p ~/.local/bin
ln -s /usr/bin/batcat ~/.local/bin/bat
... и другие дистрибутивы Linux основанные на Debian
Если пакет еще недоступен в вашем Ubuntu/Debian дистрибутиве или вы хотите установить самую последнюю версию bat
, то вы можете скачать самый последний deb
-пакет отсюда:
release page и установить так:
sudo dpkg -i bat_0.18.3_amd64.deb # измените архитектуру и версию
Вы можете установить bat
из официальных источников:
apk add bat
Вы можете установить bat
из официального источника:
pacman -S bat
Вы можете установить bat
из официального репозитория Fedora Modular.
dnf install bat
Вы можете установить bat
из официальных источников:
emerge sys-apps/bat
Вы можете установить bat
с помощью xbps-install
:
xbps-install -S bat
Вы можете установить bat
с помощью pkg
:
pkg install bat
или самому скомпилировать его:
cd /usr/ports/textproc/bat
make install
Вы можете установить bat
, используя nix package manager:
nix-env -i bat
Вы можете установить bat
с помощью zypper
:
zypper install bat
Вы можете установить bat
с помощью Homebrew:
brew install bat
Или же установить его с помощью MacPorts:
port install bat
Есть несколько способов установить bat
. Как только вы установили его, посмотрите на секцию "Использование bat
в Windows".
Вы можете установить bat
с помощью Chocolatey:
choco install bat
Вы можете установить bat
с помощью scoop:
scoop install bat
Для этого у вас должен быть установлен Visual C++ Redistributable.
Их вы можете скачать на странице релизов.
Для этого у вас должен быть установлен Visual C++ Redistributable.
Вы можете использовать Docker image, чтобы запустить bat
в контейнере:
docker pull danlynn/bat
alias bat='docker run -it --rm -e BAT_THEME -e BAT_STYLE -e BAT_TABS -v "$(pwd):/myapp" danlynn/bat'
Вы можете установить bat
с Ansible:
# Устанавливаем роль на устройстве
ansible-galaxy install aeimer.install_bat
---
# Playbook для установки bat
- host: all
roles:
- aeimer.install_bat
Этот способ должен сработать со следующими дистрибутивами:
- Debian/Ubuntu
- ARM (например Raspberry PI)
- Arch Linux
- Void Linux
- FreeBSD
- macOS
Перейдите на страницу релизов для
скомпилированных файлов bat
для различных платформ. Бинарные файлы со статической связкой так же доступны: выбирайте архив с musl
в имени.
Если вы желаете установить bat
из исходников, вам понадобится Rust 1.64.0 или выше. После этого используйте cargo
, чтобы все скомпилировать:
cargo install --locked bat
Используйте bat --list-themes
, чтобы вывести список всех доступных тем. Для выбора темы TwoDark
используйте bat
с флагом
--theme=TwoDark
или выставьте переменную окружения BAT_THEME
в TwoDark
. Используйте export BAT_THEME="TwoDark"
в конфигурационном файле вашей оболочки, чтобы изменить ее навсегда. Или же используйте конфигурационный файл bat
.
Если вы хотите просто просмотреть темы, используйте следующую команду (для этого вам понадобится fzf
):
bat --list-themes | fzf --preview="bat --theme={} --color=always /путь/к/файлу"
bat
отлично смотрится на темном фоне. Однако если ваш терминал использует светлую тему, то такие темы как GitHub
или OneHalfLight
будут смотреться куда лучше!
Вы также можете использовать новую тему, для этого перейдите в раздел добавления тем.
Вы можете использовать флаг --style
, чтобы изменять внешний вид вывода в bat
.
Например, вы можете использовать --style=numbers,changes
, чтобы показать только количество строк и изменений в Git. Установите переменную окружения BAT_STYLE
чтобы изменить это навсегда, или используйте конфиг файл bat
.
bat
использует syntect
для выделения синтаксиса. syntect
может читать
файл .sublime-syntax
и темы. Чтобы добавить новый синтаксис, сделайте следующее:
Создайте каталог с синтаксисом:
mkdir -p "$(bat --config-dir)/syntaxes"
cd "$(bat --config-dir)/syntaxes"
# Разместите файлы '.sublime-syntax'
# в каталоге (или субкаталогах), например:
git clone https://github.com/tellnobody1/sublime-purescript-syntax
Теперь используйте следующую команду, чтобы превратить эти файлы в бинарный кеш:
bat cache --build
Теперь вы можете использовать bat --list-languages
, чтобы проверить, доступны ли новые языки.
Если когда-нибудь вы заходите вернуться к настройкам по умолчанию, введите
bat cache --clear
Это работает похожим образом, так же как и добавление новых тем выделения синтаксиса
Во-первых, создайте каталог с новыми темами для синтаксиса:
mkdir -p "$(bat --config-dir)/themes"
cd "$(bat --config-dir)/themes"
# Загрузите тему в формате '.tmTheme':
git clone https://github.com/greggb/sublime-snazzy
# Обновите кеш
bat cache --build
Теперь используйте bat --list-themes
, чтобы проверить доступность новых тем.
bat
использует пейджер, указанный в переменной окружения PAGER
. Если она не задана, то используется less
.
Если вы желаете использовать другой пейджер, вы можете либо изменить переменную PAGER
, либо BAT_PAGER
чтобы перезаписать то, что указано в PAGER
.
Чтобы передать дополнительные аргументы вашему пейджеру, перечислите их в этой переменной:
export BAT_PAGER="less -RF"
Так же вы можете использовать файл конфигурации bat
(флаг --pager
).
Внимание: По умолчанию пейджером являетсяless
(без каких-либо аргументов),
bat
задаст следующие флаги для пейджера:
-R
/--RAW-CONTROL-CHARS
,
-F
/--quit-if-one-screen
и -X
/--no-init
. Последний флаг(-X
) используется только для less
, чья версия раньше 530.
Флаг -R
нужен чтобы корректно воспроизвести ANSI цвета. Второй флаг (-F
) говорит
less
чтобы тот сразу же завершился, если размер вывода меньше чем вертикальный размер терминала.
Это удобно для небольших файлов, так как вам не надо каждый раз нажимать q
, чтобы выйти из пейджера. Третий флаг (-X
) нужен для того, чтобы исправить баг с --quit-if-one-screen
в старых версиях less
. К сожалению, это блокирует возможность использования колеса мышки.
Если вы хотите все же его включить, вы можете добавить флаг -R
.
Для less
новее чем 530 оно должно работать из коробки.
Если вы используете темный режим в macOS, возможно вы захотите чтобы bat
использовал другую тему, основанную на теме вашей ОС. Следующий сниппет использует тему default
, когда у вас включен темный режим, и тему GitHub
, когда включен светлый.
alias cat="bat --theme=\$(defaults read -globalDomain AppleInterfaceStyle &> /dev/null && echo default || echo GitHub)"
bat
также может быть кастомизирован с помощью файла конфигурации. Его местоположение зависит от вашей ОС: чтобы посмотреть его путь, введите
bat --config-file
Также вы можете установить переменную окружения BAT_CONFIG_PATH
, чтобы изменить путь к файлу конфигурации.
export BAT_CONFIG_PATH="/path/to/bat.conf"
Файл конфигурации «по умолчанию» может быть создан с помощью флага --generate-config-file
.
bat --generate-config-file
Файл конфигурации - это всего лишь набор аргументов. Введите bat --help
, чтобы просмотреть список всех возможных флагов и аргументов. Также вы можете закомментировать строку с помощью #
.
Пример файла конфигурации:
# Установить тему "TwoDark"
--theme="TwoDark"
# Показывать количество строк, изменений в Git и заголовок файла
--style="numbers,changes,header"
# Использовать курсив (поддерживается не всеми терминалами)
--italic-text=always
# Использовать синтаксис C++ для всех Arduino .ino файлов
--map-syntax "*.ino:C++"
# Использовать синтаксик Git Ignore для всех файлов .ignore
--map-syntax ".ignore:Git Ignore"
bat
полностью работоспособен "из коробки", но для некоторых возможностей могут понадобиться дополнительные настройки.
Windows поддерживает только очень простой пейджер more
. Вы можете скачать установщик для less
с его сайта или через Chocolatey. Чтобы его использовать, скопируйте исполняемый файл в ваш PATH
или используйте переменную окружения. Пакет из Chocolatey установит все автоматически.
Windows 10 поддерживает цвета и в conhost.exe
(Command Prompt), и в PowerShell начиная с версии Windows
[v1511](https://ru.wikipedia.org/wiki/Windows_10#Обновления и поддержка), так же как и в bash. На ранних версиях Windows вы можете использовать
Cmder, в котором есть ConEmu.
Внимание: Версия less
в Git и MSYS2 воспроизводит цвета некорректно. Если у вас нет других пейджеров, мы можете отключить использование пейджеров с помощью флага --paging=never
или установить BAT_PAGER
равным пустой строке.
Из коробки bat
не поддерживает пути в стиле Unix (/cygdrive/*
). Когда указан абсолютный путь cygwin, bat
выдаст следующую ошибку: The system cannot find the path specified. (os error 3)
Она может быть решена добавлением следующей функции в .bash_profile
:
bat() {
local index
local args=("$@")
for index in $(seq 0 ${#args[@]}) ; do
case "${args[index]}" in
-*) continue;;
*) [ -e "${args[index]}" ] && args[index]="$(cygpath --windows "${args[index]}")";;
esac
done
command bat "${args[@]}"
}
bat
поддерживает терминалы с и без поддержки truecolor. Однако подсветка синтаксиса не оптимизирована для терминалов с 8-битными цветами, и рекомендуется использовать терминалы с поддержкой 24-битных цветов (terminator
, konsole
, iTerm2
, ...).
Смотрите эту статью для полного списка терминалов.
Удостовертесь, что переменная COLORTERM
равна truecolor
или
24bit
. Иначе bat
не сможет определить поддержку 24-битных цветов (и будет использовать 8-битные).
Используйте другую тему (bat --list-themes
выведет список всех установленных тем). Темы OneHalfDark
и
OneHalfLight
имеют более яркие номера строк и тексты.
bat
поддерживает UTF-8 и UTF-16. Файлы в других кодировках, возможно, придётся перекодировать, так как кодировка может быть распознана неверно. Используйте iconv
.
Пример: у вас есть PHP файл в кодировке Latin-1 (ISO-8859-1):
iconv -f ISO-8859-1 -t UTF-8 my-file.php | bat
Внимание: вам может понадобится флаг -l
/--language
, если bat
не сможет автоматически определить синтаксис.
# Рекурсивно клонирует все модули
git clone --recursive https://github.com/sharkdp/bat
# Компиляции в режиме разработки
cd bat
cargo build --bins
# Запуск тестов
cargo test
# Установка (релизная версия)
cargo install --locked
# Компилирование исполняего файла bat с другим синтаксисом и темами
bash assets/create.sh
cargo install --locked --force
Цели проекта bat
:
- Красивая и продвинутая подсветка синтаксиса.
- Интеграция с Git.
- Полноценная замена
cat
. - Дружелюбный интерфейс и аргументы.
Есть очень много альтернатив bat
. Смотрите этот документ для сравнения.
Copyright (c) 2018-2021 Разработчики bat.
bat
распостраняется под лицензями MIT License и Apache License 2.0 (на выбор пользователя).
Смотрите LICENSE-APACHE и LICENSE-MIT для более подробного ознакомления.