http://abramov.blog/Abramov blogru-ruhttp://abramov.blog/audit/Sun, 18 Jan 2026 00:00:00 +0000http://abramov.blog/audit/ Версия на английском: dev.to Audit-логирование почти всегда появляется позже, чем нужно. Сначала хватает обычных логов, потом внезапно становится важно понять, кто именно поменял статус заказа, почему у пользователя пропала роль или откуда взялись странные данные в системе. В большинстве проектов audit либо размазывается по бизнес-коду, либо пытается жить поверх обычного логгера без четкой модели. Я вынес эту задачу в отдельную библиотеку: audit. Репозиторий: https://github.com/w0rng/audit Что делает audit # Библиотека решает конкретную задачу: хранить историю изменений сущностей. На уровне модели это выглядит так: сущность идентифицируется строковым ключом (order:12345, user:42) каждое событие имеет автора, описание и timestamp изменения фиксируются по полям значения могут быть видимыми или скрытыми Никакой магии, рефлексии и автоматических diff. Все изменения описываются явно. Базовый сценарий # Простейший пример: жизненный цикл заказа. logger := audit.New() logger.Create( "order:12345", "john.doe", "Order created", map[string]audit.Value{ "status": audit.PlainValue("pending"), "total": audit.PlainValue(99.99), "payment_token": audit.HiddenValue(), }, ) Чувствительные данные явно помечаются как скрытые. Они участвуют в событии, но не попадают в логи в открытом виде. Дальнейшие изменения выглядят так же декларативно: logger.Update( "order:12345", "warehouse.system", "Order shipped", map[string]audit.Value{ "status": audit.PlainValue("shipped"), "tracking_number": audit.PlainValue("TRK123456789"), }, ) История изменений и события # Библиотека предоставляет два уровня чтения данных. Полная история изменений сущности: logs := logger.Logs("order:12345") Каждая запись содержит список полей с from и to, автора и описание. Для вышеупомянутых логов данные следующие: [ { "Fields": [ { "Field": "status", "From": null, "To": "pending" }, { "Field": "total", "From": null, "To": 99.99 }, { "Field": "payment_token", "From": "***", "To": "***" } ], "Description": "Order created", "Author": "john.doe", "Timestamp": "2026-01-18T17:06:29.126233926+07:00" }, { "Fields": [ { "Field": "status", "From": "pending", "To": "shipped" }, { "Field": "tracking_number", "From": null, "To": "TRK123456789" } ], "Description": "Order shipped", "Author": "warehouse.system", "Timestamp": "2026-01-18T17:06:29.126239744+07:00" } ] Если нужны более легковесные события, можно работать через Events и фильтровать их по полям: events := logger.Events("order:12345", "status") Это удобно для построения таймлайнов или агрегатов, например цепочки статусов заказа: [ { "Timestamp": "2026-01-18T17:06:53.12607001+07:00", "Action": "create", "Author": "john.doe", "Description": "Order created", "Payload": { "status": { "Data": "pending", "Hidden": false }} }, { "Timestamp": "2026-01-18T17:06:53.126075226+07:00", "Action": "update", "Author": "warehouse.system", "Description": "Order shipped", "Payload": { "status": { "Data": "shipped", "Hidden": false }} } ] Кастомное хранилище # audit не привязывается к способу хранения данных. Для этого используется интерфейс Storage. Пример простой реализации, которая сохраняет события в JSON-файл, есть в репозитории. Такое хранилище подключается через options pattern: storage := NewJSONFileStorage("audit_events.json") logger := audit.New(audit.WithStorage(storage)) Это может быть файл, база данных, Kafka или любой другой backend. Core-библиотека об этом не знает. Интеграция с slog # Отдельный пакет audit/slog позволяет подключить audit к стандартному log/slog. Handler извлекает audit-события из структурированных логов: handler := auditslog.NewHandler(auditLogger, auditslog.HandlerOptions{ Handler: slog.NewJSONHandler(os.Stdout, &slog.HandlerOptions{ Level: slog.LevelInfo, }), KeyExtractor: auditslog.AttrExtractor(auditslog.AttrEntity), ShouldAudit: func(record slog.Record) bool { return record.Level >= slog.LevelInfo }, }) Обычный лог автоматически становится audit-событием: slog.Info( "User account created", auditslog.AttrEntity, "user:123", auditslog.AttrAction, "create", auditslog.AttrAuthor, "admin", "email", "alice@example.com", "role", "editor", ) Если в записи нет entity или уровень не проходит фильтр, событие не попадет в audit. Плюс таких логов в том, что они будут видны и в системах сбора логов, и с ними можно работать как с аудит событиями через .Logs, .Events. Итог # audit это небольшой, изолированный слой для audit-логирования: явная модель данных контроль над чувствительными полями расширяемое хранилище нативная интеграция со slog Подходит для Go-сервисов, где audit важен как инфраструктурный слой, а не формальность.GoAuditLoggingSloghttp://abramov.blog/some-about-macos/Sat, 08 Mar 2025 21:45:01 +0700http://abramov.blog/some-about-macos/ Иконки для macos # Если нужно установить икноку для приложения/папки на macos, идем на этот сайт: macosicons Скачиваем иконку и перетаскиваем скаченный файл на иконку в свойствах приложения/папки: Очистить dns кэш на macos # sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder Очистка прав доступа на macos # Иногда бывает, что удаленное приложение остается в разделе «конфеденциальность» и удалить его оттуда не получается. Можно сбросить все права доступа и тогда оно пропадет: tccutil reset All ❗❗❗это удалит все разрешения для приложения Получить заряд macos в терминале # pmset -g batt | grep -Eo "\d+%" | cut -d% -f1 Открытие закладок в safari в новой вкладке # defaults write ~/Library/Preferences/com.apple.Safari TargetedClicksCreateTabs -bool true Хоткей копирования текущего url в сафари # 1. Создание AppleScript в Быстром действии # Открой Automator и выбери Быстрое действие. В верхней части окна рядом с пунктом Workflow receives («Рабочий процесс получает») выбери no input(«без ввода») и Safari в списке приложений. В панели слева в разделе Утилиты выбери и перетащи Запустить AppleScript в рабочую область. Замени текст скрипта на следующий: tell application "Safari" set theURL to URL of current tab of front window set the clipboard to theURL end tell Сохрани быстрое действие с именем, например, Copy URL to Clipboard. 2. Привязка комбинации клавиш к Быстрому действию # Открой System Settings («Системные настройки») и перейди в раздел Keyboard («Клавиатура»). Выбери Keyboard Shortcuts («Сочетания клавиш»), затем Quick Actions («Быстрые действия») в левом меню. Найди созданное быстрое действие Copy URL to Clipboard в списке и добавь к нему сочетание клавиш, например, Command + Shift + C. Теперь, при использовании этой комбинации клавиш в Safari, URL текущей страницы будет копироваться в буфер обмена, аналогично функции в Arc Browser. Если возник конфликт с существующим хоткеем # Открой System Settings («Системные настройки») и перейди в раздел Keyboard («Клавиатура»). Выбери вкладку Keyboard Shortcuts («Сочетания клавиш»). В левом меню выбери App Shortcuts («Сочетания клавиш приложений»). Нажми на кнопку + для добавления нового сочетания клавиш. В поле Application («Приложение») выбери Safari. В поле Menu Title («Название меню») введи точное название команды — Начать выбор элементов. В поле Keyboard Shortcut («Сочетание клавиш») назначь новое сочетание клавиш, которое не будет конфликтовать с твоей комбинацией Command + Shift + C, или оставь это поле пустым, чтобы отключить команду. Нажми Add («Добавить»).Macoshttp://abramov.blog/some-about-git/Sun, 05 Jan 2025 21:45:01 +0700http://abramov.blog/some-about-git/ Разделение настроек # У гита есть 2 вида настроек: локальные - определяются в .git/config глобальные - определяются либо в .config/git/config, либо в .gitconfig Если нужно сделать глобальные настройки для определнных репозиториев, можно воспользоваться диррективой includeIf. В глобальные настройки гита добавляем следующее: [includeIf "gitdir:~/Projects/work/"] path = ~/Projects/work/.gitconfig Теперь если мы находимся в дирректории work, будут подключены настройки спецефичные для данных проектов удалить файл из git repo # git filter-repo -f --index-filter 'git rm --cached --ignore-unmatch unwanted-file.txt' после этого надо пушить с форсом: git push --force -u origin main Перезапись автора коммитов # Перезапись с определенного коммита git rebase -r --root --exec "git commit --amend --no-edit --reset-author" Перезапись всех коммитов git rebase -r --root --exec "git commit --amend --no-edit --reset-author ❗ Если во время перезаписи будут происходить какие-то махинации с gitconfig, нужно автора прописать в локальные настройки Подсчет колличества строк в репозитории # git ls-files | xargs cloc Git home config # alias home='git --work-tree=$HOME --git-dir=$HOME/.cfg'Git