Posts of Инструменты программиста

Найти тяжёлый каталог с gdu и запретить удаление Если нужно разобраться, что занимает место в проекте, gdu покажет размеры каталогов и файлов. Для первичного осмотра можно сразу отключить удаление и получить текстовый отчёт по текущему каталогу: gdu -n --no-delete . Флаг -n выбирает неинтерактивный режим, --no-delete запрещает удаление. В интерактивном интерфейсе без этого ограничения есть клавиши удаления и очистки каталога, поэтому режим осмотра стоит выбрать заранее. По умолчанию gdu считает занятое место на диске. Видимый размер содержимого файла можно посмотреть отдельно с -a. Эти величины могут различаться. Прежде чем очищать самый большой каталог, проверьте, какие данные в нём лежат.

sccache и промахи кэша из-за пути к проекту Два CI-задания собирают один код, но checkout лежит в разных абсолютных каталогах. Для sccache это существенная разница: по умолчанию абсолютные пути должны совпадать, чтобы использовать сохранённый результат компиляции. В README описан SCCACHE_BASEDIRS. Он позволяет убрать выбранный префикс пути перед вычислением ключа кэша. В качестве базового каталога нужен абсолютный путь. Инструмент нормализует пути в исходнике после препроцессинга и подходящих аргументах компилятора, но не вырезает произвольные совпадения из любого текста. Это настройка для повторных сборок с разными корнями checkout. Она не делает любую компиляцию кэшируемой: например, у Rust не кэшируются инкрементальные сборки и crates, вызывающие системный линкер. Проверяйте попадания и промахи по статистике sccache.

Cosign: подпись образа нужно связать с ожидаемым автором Проверяя скачанный контейнерный образ через Cosign, заранее задайте, чью подпись вы готовы принять. В keyless-сценарии документация требует проверить и личность подписанта, и OIDC-провайдера. За личность отвечает --certificate-identity, за провайдера — --certificate-oidc-issuer. Проверяйте оба значения: просто найти подпись у образа недостаточно, если вам нужен артефакт конкретного проекта. Ожидаемые значения берите из доверенного процесса выпуска, а не из самого непроверенного файла. По умолчанию Cosign также сверяет digest образа с digest в подписанных данных. Это связывает подпись с конкретным содержимым. Успешная проверка подтверждает эти условия, но не подтверждает отсутствие уязвимостей в образе.

Проверить JSON-запрос до отправки с xh В xh есть режим --offline: клиент собирает HTTP-запрос и выводит его в терминал, не обращаясь к серверу. Удобно, когда нужно сначала проверить типы полей в JSON и заголовки. xh --ignore-stdin --offline POST https://example.com/users name=anna age:=24 --ignore-stdin отключает чтение тела из stdin. С name=anna в JSON попадёт строка, с age:=24 — число. Оператор == задаёт параметр query string, двоеточие — заголовок. В выводе можно проверить, куда попало каждое значение. После проверки уберите --offline и укажите свой тестовый адрес. В этом режиме вы проверяете только состав запроса. Ответ сервера и правила валидации API он не покажет. Синтаксис похож на HTTPie, однако xh поддерживает не все его возможности и не имеет системы плагинов.

chezmoi: проверить изменения dotfiles перед применением chezmoi хранит исходное состояние конфигурации отдельно от файлов в домашнем каталоге. Команда edit меняет управляемую копию. Изменения в домашнем каталоге нужно применять отдельно, поэтому их можно сначала просмотреть. Если chezmoi уже установлен и инициализирован, а нужные файлы добавлены под управление, выполните: chezmoi diff chezmoi -n -v apply Первая команда покажет различия, вторая подробно выведет действия без записи. Флаг -n включает dry run, -v — подробный вывод. Если изменений нет, diff может быть пустым. Обычный apply без -n уже меняет файлы. Переходите к нему после просмотра изменений. По умолчанию исходное состояние хранится в ~/.local/share/chezmoi. На карточке — исходное состояние и команды проверки.

Dive: почему удаление файла не уменьшило образ Удаление файла в новом слое Docker-образа не убирает его из предыдущего слоя. В Dive можно проследить, где файл появился, менялся или был удалён. Откройте свой существующий образ: dive <your-image-tag> Вместо заполнителя подставьте тег. Слева выберите слой, справа посмотрите дерево файлов на этом этапе сборки и отметки изменений. В демонстрации проекта видно, как переключение слоя меняет дерево и панель с деталями. Строки команд слоя показаны для разбора уже собранного образа. Dive помогает найти, где место может тратиться впустую, но сам не уменьшает образ. Его image efficiency — экспериментальная оценка, а не обещание достижимой экономии. В README инструмент отмечен как beta quality, поэтому выводы стоит проверять по составу слоёв, а не по одному проценту.

gron: найти путь к полю в незнакомом JSON Когда значение спрятано глубоко в ответе API, gron помогает найти его обычным текстовым поиском. Режим --json превращает документ в поток строк с путями и значениями. В примере проекта ищут поле likes: gron --json testdata/two.json | grep likes Так видно, к какой ветви относятся совпадения. Чтобы собрать найденную часть обратно в JSON, в документации используют тот же режим при обратном преобразовании: gron --json testdata/two.json | grep likes | gron --json --ungron Путь к файлу замените своим. Учитывайте, что grep сопоставляет текст: он может найти совпадение и в имени, и в значении. Для сложных преобразований нужна проверка структуры результата. Карточка показывает последовательность команд, без имитации запуска.

Lazydocker: выбрать контейнер и открыть его логи Когда нужно сопоставить состояние нескольких контейнеров с их логами, Lazydocker показывает это в одном терминальном интерфейсе. После установки и настройки доступа к Docker daemon запустите: lazydocker Выберите сервис слева: справа появятся его логи, состояние и другие доступные панели. Переключайтесь между сервисами, чтобы посмотреть логи нужного контейнера. Текущий README указывает требование Docker 29.0.0 или новее. Docker Compose нужен только для соответствующих сценариев. Интерфейс позволяет также перезапускать и удалять контейнеры, выполнять очистку. Учитывайте это при выборе действий в меню. На скриншоте — старый пример интерфейса из репозитория, показанные в нём версии образов не являются рекомендацией для установки.

Taplo: проверка TOML по синтаксису и схеме Taplo проверяет синтаксис TOML и такие ошибки, как повторное определение ключа. Для файла проекта запустите: taplo check foo.toml Имя файла замените своим. Без схемы Taplo проверяет сам документ, но не знает, какие ключи разрешены конкретным приложением. Синтаксически корректный файл всё ещё может содержать неверную настройку. Для проверки требований к структуре подключите подходящую JSON Schema Draft 4 через --schema. В документации адрес схемы дан как пример, поэтому нужен реальный адрес схемы вашего формата. Отдельно можно настроить каталог схем через --schema-catalog. Такую проверку можно запускать перед коммитом конфигурации.

Trippy: посмотреть ответы узлов по пути к серверу Trippy совмещает traceroute и ping: показывает узлы маршрута и обновляет статистику ответов каждого из них. В документации для запуска приведена команда: sudo trip example.com Подставьте свой адрес. Повышенные права обычно нужны для raw sockets. В таблице можно сопоставить отправленные и полученные пробы, задержку и долю ответов по узлам. На ролике из репозитория также видно, как меняются данные при выборе другого узла и цели. Это демонстрация версии 0.12.0. Строка No response или 100% в Loss% у промежуточного узла сама по себе не доказывает потерю прикладного трафика. Следующие узлы могут отвечать. Для диагностики сопоставьте несколько строк маршрута.

Posting 3 beta: оставить в JSON-ответе нужных пользователей В терминальном HTTP-клиенте Posting 3 можно искать текст в ответе, просматривать JSON как дерево и фильтровать его через JSONPath. Запросы сохраняются локально в YAML. В демонстрации проекта сначала ищут поле role, затем оставляют пользователей с ролью admin: $.users[[email protected]=="admin"] Выражение рассчитано на показанную структуру: массив users, в объектах которого есть поле role. В результате остаётся подходящий объект, а не просто подсвечивается строка. Для другого ответа путь и условие нужно изменить. JSONPath здесь не следует смешивать с синтаксисом jq. Posting 3 пока находится в beta. Ролик показывает именно эту ветку клиента. Значения времени и размера ответа в нём относятся к демонстрационному запросу, а не к замеру производительности.

procs: дерево родительских и дочерних процессов Если у процессов похожие команды, дерево помогает увидеть связи между ними. У procs есть режим дерева: procs --tree Он сортирует процессы по зависимостям и рисует ветви слева от строк. Так видно родительский процесс и его потомков. Для обновления вывода можно добавить --watch. Если передать текстовый аргумент, procs по умолчанию ищет его в полях USER и Command, а числовой аргумент — среди PID. Набор видимых данных зависит от прав и конфигурации. Скриншоты проекта сделаны с config/large.toml, поэтому чистая установка может показывать другие столбцы. Linux и Windows поддержаны, а macOS и FreeBSD в документации отмечены как экспериментальные. На карточке — схема связей без реальных PID.

grpcurl: узнать, какие сервисы предоставляет gRPC-сервер Если на сервере включена reflection, grpcurl может получить описание API и перечислить сервисы без локальных файлов схемы. Для работающего сервера с TLS и reflection команда выглядит так: grpcurl localhost:8787 list Адрес здесь взят из документации, его нужно заменить адресом своего сервера. Если после адреса и list указать имя сервиса, утилита перечислит его методы. Это помогает разобраться с незнакомым API до вызова конкретного метода. Для локального сервера без TLS нужен -plaintext. Этот флаг полностью отключает TLS, а не только проверку сертификата. Если reflection недоступна, передайте .proto через -import-path и -proto либо готовый набор дескрипторов через -protoset. С локальной схемой list перечисляет определённые в ней сервисы без подключения к серверу.

Pueue: поставить длительные команды в очередь В Pueue команды выполняет фоновый процесс pueued, а клиент добавляет задания и показывает их состояние. Поэтому выполнение не привязано к открытому терминалу клиента. По умолчанию очередь запускает одно задание за раз. После установки запустите daemon и добавьте безопасное пробное задание из руководства: pueued -d pueue add sleep 60 pueue status В таблице появится задача и её статус. Вывод задания можно посмотреть через pueue log. Для реальной команды сначала проверьте, что она делает и как переданы аргументы. Без запущенного daemon очередь не работает. Сохранение её состояния также не означает, что прерванный процесс продолжится с той же инструкции после перезагрузки. Ролик показывает работу клиента из демонстрации проекта.

Ouch: посмотреть дерево архива до распаковки Чтобы узнать, лежат ли файлы внутри одной папки или сразу в корне архива, его необязательно распаковывать. У Ouch для этого есть подкоманда list: ouch list source-code.zip --tree Она показывает вложенные каталоги и файлы деревом. Так можно заранее проверить структуру и выбрать каталог для будущей распаковки. В команде подставьте имя своего архива. Если важны размеры, добавьте --show-size: это несжатый размер каждого файла, а не его вклад в размер архива. Формат определяется по расширению. Для RAR поддержаны чтение, просмотр списка и распаковка, но создавать RAR утилита не умеет. На карточке — сокращённый пример дерева из документации, а не результат проверки вашего файла.

Скиллов для AI-агентов становится всё больше, и уже непонятно, что где используется и как работает! Мы делаем Hollon AMS. В визуальном редакторе из скиллов собираются процессы, для них задаются общие правила, а разных AI-агентов можно подключить через MCP. Разработчик может прогонять сценарии и разбираться, где что сломалось. Тимлид или CTO видит, как устроены процессы, какие у них версии и что они дают по KPI. Это не только про разработку: подойдёт для любого процесса, который можно отдать AI-агенту. Попробовать можно в облаке, а для компаний есть возможность развёртывания в закрытом контуре. Попробуйте собрать первый процесс Если интересны готовые кейсы или хочется обсудить свой, пишите: [email protected]

csvlens: отфильтровать CSV прямо в терминале В csvlens можно открыть CSV, найти значение и оставить на экране только нужные строки. В официальном примере используется таблица с покемонами: csvlens Pokemon.csv Нажмите / и введите Flying, чтобы подсветить совпадения. Для фильтра строк нажмите & и введите Bug. Это разные действия: поиск сохраняет всю таблицу, а фильтр скрывает неподходящие строки. Клавиша * задаёт фильтр столбцов. Выражения в этих режимах — регулярные. Если файл разделён табуляцией, используйте -t. Для автоматического определения разделителя есть -d auto. csvlens работает как просмотрщик и не изменяет исходный CSV. Файл в команде замените своим.

gping: сравнить задержку до двух хостов на одном графике Чтобы сопоставить ping до двух адресов, передайте оба хоста одной команде gping: gping google.com facebook.com У каждого адреса появится своя линия. На графике видно, когда задержка выросла и совпали ли всплески у разных хостов. Флаг -b задаёт, сколько секунд истории помещается на экране. По умолчанию это 30 секунд. Адреса в примере можно заменить своими. Обычный режим измеряет ping, поэтому по нему нельзя судить о времени ответа HTTP или скорости скачивания. Утилита также умеет измерять длительность команд через --cmd, но это отдельный режим. В ролике показана демонстрация из репозитория, её числа не описывают вашу сеть.

actionlint: найти ошибку в workflow до запуска GitHub Actions В синтаксически корректном YAML может быть неверное имя параметра action или обращение к отсутствующему полю матрицы. actionlint находит такие ошибки статическим анализом. В примере проекта он замечает неизвестный input node_version и обращение к matrix.platform, которого нет в матрице. После установки запустите в репозитории: actionlint Утилита сама найдёт workflow и выведет диагностику с файлом, строкой и проблемным выражением. Для проверки shell- и Python-фрагментов есть интеграции с ShellCheck и pyflakes, если они доступны в окружении. Успешная проверка не гарантирует, что workflow выполнится: доступность сервисов и результат реального запуска она не проверяет.

Голое железо и root-доступ, ВМ со снапшотами по расписанию, Kubernetes с GitOps в проде или всё сразу. В фановом тесте от команды Deckhouse из таких ответов складывается один из 10 типов инфраструктуры. Укротитель давно научился жить с ВМ и Kubernetes рядом, но устал от двух центров управления. Соковыжималка запускает базы и ML прямо на железе, чтобы гипервизор не съедал производительность. Антиквар не трогает систему, которая работает с нулевых. А Повелителю облаков уютно до первого кругленького счёта. Грузчик и Коллекционер выпадают реже всех. Если достался один из них, ссылкой на результат точно стоит поделиться с командой. → Пройти тест и узнать свой тип

typos: проверить опечатки и оставить намеренные имена Фамилия Teh похожа на опечатку, но исправлять её на the было бы ошибкой. У typos для таких случаев есть словарь исключений в _typos.toml: [default.extend-words] teh = "teh" Сам инструмент сверяет слова в исходниках со списком известных опечаток. Поэтому незнакомое слово само по себе ещё не считается ошибкой. После установки пакета typos-cli запустите typos --diff в репозитории, чтобы увидеть предлагаемые изменения без записи файлов. Для применения есть отдельный флаг --write-changes. Если вариантов исправления несколько, typos сообщает о проблеме и оставляет выбор вам. Это удобная дополнительная проверка перед PR, но она не обнаружит все ошибки и не заменит вычитку русскоязычного текста.

lychee: проверить ссылки в README перед ревью Правка документации может выглядеть безупречно, пока кто-нибудь не откроет ссылку на удалённую страницу. lychee извлекает ссылки из Markdown и HTML и проверяет их доступность. Если утилита установлена, запустите в каталоге с вашим README: lychee --no-progress README.md Флаг --no-progress убирает прогресс-бар и удобен для журналов CI. Код выхода 2 означает, что хотя бы одна не исключённая ссылка не прошла проверку. Такой результат стоит разобрать: ограничения запросов, авторизация и тайм-ауты могут мешать автоматическому клиенту, даже когда страница существует. Проверка внешних адресов обращается к сайтам по сети. Режим --offline оставляет только локальные файлы. И отдельно проверьте смысл ссылок: доступная страница могла давно сменить содержание.

bottom: графики нагрузки и процессы в одном терминале Сборка тормозит, память растёт, а по одному списку процессов трудно увидеть, как менялась нагрузка. bottom собирает рядом графики CPU, RAM, swap и сетевого ввода-вывода, а также таблицу процессов. После установки программа запускается как btm. В таблице можно искать и сортировать процессы, есть древовидное представление. Нажмите ? внутри интерфейса, чтобы открыть справку по управлению. Так можно наблюдать систему, пока вы повторяете медленную операцию, и сопоставлять графики со списком процессов. Это отправная точка диагностики: монитор показывает нагрузку, но сам не назовёт строку кода, из-за которой растёт память. Перед установкой сверяйтесь со списком ОС и архитектур в README. Доступность отдельных показателей зависит от платформы и оборудования.

sd: сначала посмотреть замену, потом записать файл У sd важная особенность: если передать имя файла, замена по умолчанию записывается прямо в него. Для предварительного просмотра есть -p. Допустим, в вашем config.txt нужно заменить локальный адрес. Пример с условным адресом назначения: sd -p -F 'http://localhost:3000' 'https://api.example.com' config.txt Флаг -F включает буквальный поиск. Без него поисковая строка считается регулярным выражением. Это важно для адресов с точками и другими специальными символами. С -p вы увидите преобразованный текст в терминале, исходный файл останется прежним. Если результат подходит, повторите команду без -p и проверьте diff. sd заменяет текстовые совпадения, включая строки и комментарии. Для правки кода, где нужно учитывать структуру выражений, такого поиска может быть недостаточно.

doggo: какие MX-записи видит выбранный DNS-сервер После смены DNS-записей полезно явно выбрать сервер, к которому уходит запрос. В doggo домен, тип записи и адрес резолвера помещаются в одну команду: doggo MX github.com @9.9.9.9 Это пример из README: запрос MX-записей для github.com через 9.9.9.9. Подставьте свой домен, чтобы посмотреть его ответ. Утилита выводит записи в таблице, а флаг --json пригодится, если результат нужно обработать скриптом. Для такого запроса нужны установленный doggo и доступ к выбранному серверу. Один ответ показывает состояние у этого резолвера в момент проверки. Если проверяете распространение изменения, сопоставьте ответы нескольких серверов: успешный запрос к одному ещё не означает, что новые записи видны всем.

hyperfine: сравнить команды с прогревом и повторами Один удачный запуск ещё мало говорит о скорости команды: на время влияют кеши и соседние процессы. hyperfine повторяет измерения и показывает их разброс, а результаты можно сохранить в JSON. Короткий учебный пример для hyperfine 2.0 и Unix, где доступна команда sleep: hyperfine --warmup 3 --runs 10 --export-json timings.json 'sleep 0.1' 'sleep 0.2' Для каждой команды сначала пройдут три прогревочных запуска, затем десять измеряемых. Флаг --export-json запишет результаты в timings.json. В версии 2.0 для конвейеров и перенаправлений отдельно нужен -S. В рабочем замере замените обе sleep на варианты, выполняющие одинаковую задачу с одними входными данными. Прогрев нужен для сценария с тёплым кешем. Полученные числа описывают вашу машину и эти условия, поэтому переносить коэффициент ускорения на любой проект нельзя.

caffeinate не даёт macOS уснуть до завершения команды Запустили долгую сборку и отошли от ноутбука? В macOS есть встроенная утилита caffeinate, которая удерживает систему от автоматического сна из-за бездействия. Передайте ей нужную команду: caffeinate ./build.sh Защита действует, пока команда работает. После завершения обычный режим сна вернётся. Если процесс уже запущен, укажите его PID, например: caffeinate -w 12345 А вариант caffeinate -id ./build.sh дополнительно не даст погаснуть дисплею. Без аргументов утилита работает до остановки через Ctrl+C. В руководстве Адама Джонсона есть важное ограничение: закрытие крышки всё ещё может усыпить ноутбук. Блокировка экрана при этом не мешает задаче продолжать работу. #инструменты #macos #терминал

Azure Developer CLI ограничивает параллелизм по этапам развёртывания В проекте с несколькими сервисами одновременная сборка и публикация могут упираться в ресурсы машины или ограничения облака. В сентябрьских обновлениях Azure Developer CLI добавили отдельные ограничения параллелизма для этапов package, provision, publish и deploy. Теперь число одновременно выполняемых операций можно настраивать под каждый этап. Пригодится, например, когда сборку нескольких сервисов можно распараллелить, а создание ресурсов или публикацию нужно выполнять с меньшей нагрузкой. В azure.yaml также появились слои инфраструктуры и сервисов для организации сложных проектов. А azd init --template предупреждает, если репозиторий шаблона архивирован. Это возможности инструмента для развёртывания в Azure. В обзоре разобраны версии 1.33.0–1.34.2. #инструменты #azure #cli

Zed сравнивает каталоги в двух соседних панелях Нужно сопоставить две копии проекта или результат генерации файлов? В Zed 1.24.2 появился просмотр различий каталогов рядом друг с другом через zed --diff. Например, для двух локальных папок: zed --diff ./before ./after Так удобнее просматривать изменения сразу в нескольких файлах: исходная и новая версии открываются в соседних панелях. Ещё в релизе добавили создание Git-тегов из истории коммитов и Git Graph. Команда git: create tag at head ставит локальный тег на текущий коммит. Автоматической отправки тега на сервер нет. А поиск файлов теперь может подставлять текст, выделенный в редакторе или терминале. Мелочь, которая убирает копирование имени файла из сообщения об ошибке в строку поиска. #инструменты #zed #git

uv помогает подготовить окружение для тестов самого Django Нашли ошибку во фреймворке и хотите проверить исправление? У Django есть собственный набор тестов. Адам Джонсон показывает, как подготовить для него окружение через uv. В корне клонированного репозитория Django: uv venv uv pip install -e . -r tests/requirements/py3.txt Первая команда создаёт .venv, вторая устанавливает Django в редактируемом режиме и зависимости тестов. Изменения в исходниках фреймворка будут доступны без повторной установки пакета. Затем активируйте окружение, перейдите в tests и запустите runtests.py. Это подготовка к работе над самим Django; тесты вашего приложения запускаются отдельно. В статье также разобрана проблема сборки pylibmc. Его можно исключить из установки, но тогда зависящие от него тесты будут пропущены. #инструменты #python #django