veg.tools

Інструмент командного рядка

vlb — headless, придатний для скриптів вигляд того самого loadbook, що й застосунки: огляд кандидатів, прогноз рецепта, перелік ваших даних, запис серії. Суддя, а не вболівальник, у командному рядку.

vlb — це невелика програма командного рядка, що працює над тим самим loadbook, який використовують настільний та Apple-застосунки. Вона не замінює їх — це другий, придатний для скриптів вигляд, для користувачів терміналу й автоматизації. Вона безпечно поділяє живий файл даних застосунку, тож ви можете vlb log записати серію з терміналу, поки відкрито настільний застосунок, і кожен бачить записи іншого.

Для чого він

  • Автоматизація та CI. Кожен машиночитний вивід (--json) має стабільну, заморожену форму, тож скрипти можуть на неї покладатися — спрямуйте його одразу в jq.
  • Швидка робота з клавіатури. Зворотний оглядач кандидатів — за одну команду, без інтерфейсу.
  • Другий вигляд для досвідченого користувача того самого loadbook, що ведуть застосунки.

Дієслова читання

  • reverse — огляд комбінацій пороху й наважки під цільову швидкість (оглядач кандидатів).
  • predict — прямий прогноз одного рецепта: початкова швидкість зі своїм інтервалом, %MAP, заповнення гільзи та клас.
  • cartridges / bullets / powders — перелік вбудованого каталогу компонентів (точні назви, яких очікують інші дієслова).
  • loads — перелік ваших занесених рецептів.
  • ammo — перелік ваших набоїв та кількості рецептів у кожному, з цільовою швидкістю кожного.
  • strings — перелік серій пострілів рецепта з їхньою виміряною посерійною статистикою.

Додайте --json до будь-якого з них для машиночитного виводу. Швидкий приклад:

vlb reverse --cartridge "6.5 Creedmoor" \
  --bullet "Hornady 6.5mm 140 gr BTHP Match" --target-fps 2700

Єдине дієслово запису

log додає одну незмінну серію з хронографа до рецепта — введену вручну, вставлену або з CSV хронографа (ShotView, LabRadar, Garmin Xero, загальний). Він зберігає ваші необроблені швидкості точно так, як їх виміряно — лише додаванням, ніколи не перетворює й не видаляє (виключіть відрив позначкою, а не редагуванням) — і повертає виміряні середнє, SD та ES з їхніми інтервалами.

Та сама позиція чесності

vlb несе те саме суддівське обрамлення, що й застосунки — він ніколи не пом’якшує його заради командного рядка:

  • reverse оглядає кандидатів, він ніколи не рекомендує. Результати позначені як змодельовані гіпотези для перевірки, впорядковані за впевненістю моделі — «не за якістю». Ніде немає поля влучності, вузла чи «найкращого». Коли огляд повертається порожнім, він каже чому — куля чи патрон не збіглися, ціль зависока (over MAP) чи занизька (нижче за поріг заповнення) або фільтри надто суворі, — а --json несе це як додаткове поле empty_reason й таблицю diagnostics за причинами.
  • Тиск показано лише як відсоток від максимуму SAAMI — ніколи не зеленим, ніколи не «безпечно»; застереження over-MAP з’являється, коли змодельований верхній край перетинає межу.
  • Кожен прогноз несе інтервал і клас калібрування (Оцінений → Попередній → Калібрований до вашої зброї).
  • Ніщо не спрацьовує потайки вхолосу. Нерозв’язаний рецепт, комбінація поза каталогом чи вхідні дані, які не вдалося розібрати, завершуються з чесним повідомленням і нічого не записують.

Де він читає й пише

Типово vlb використовує файл даних застосунку — той самий, який читають і пишуть настільний та Apple-застосунки — тож це повноцінний другий вигляд ваших даних. Спрямуйте його деінде прапорцем --db <шлях> або змінною середовища $LOADBOOK_DB, зручно для чернеткових чи CI-запусків. Одночасне використання безпечне: термінал і настільний застосунок кожен бачить зафіксовані записи іншого.

Виконайте vlb --help (та vlb <команда> --help) для стислої вбудованої довідки з прикладами.