Итоговый проект: CLI-менеджер задач

Раскладка из урока про структуру проекта переносится без изменений, и это лучшая проверка того, что она была не теорией. Модуль называется github.com/you/tasks; внутри main.go на тридцать строк, каталог cmd с одним файлом на команду — root.go, add.go, list.go, done.go, rm.go — плюс app.go с приёмником зависимостей, errors.go с ExitError и colors.go со стилями. Домен живёт в internal/tasks: модель Task, хранилище Store, сентинел ErrNotFound — и ни одного импорта cobra, домен не знает про терминал. Конфигурация — в internal/config, единственном пакете, где живёт viper. Связка — структура App: фабрики команд принимают её аргументом и замыкают на себя, команды тянут из неё Store и Config и не лезут в глобальные переменные. Если ваша раскладка после двадцати четырёх уроков получилась другой — это не провал: раскладка обслуживает проект, а не наоборот. Обоснование каждой полки — в уроке про структуру проекта.

Путь к данным решается одной функцией stdlib: os.UserConfigDir() возвращает ~/.config на Linux, ~/Library/Application Support на macOS и %AppData% на Windows, и хранилище ложится в подкаталог tasks рядом с config.yaml. Пуристы XDG отправят данные в ~/.local/share через os.UserHomeDir — по букве стандарта они правы, отделять данные от настроек положено; я сознательно беру UserConfigDir, потому что одна функция stdlib вместо ручной склейки путей для утилиты на триста строк — честная сделка, а не лень. Контракт Store прост: Load читает файл и молчит, если его нет, — первый запуск не ошибка, а пустой список; Save маршалит срез с отступами, создаёт каталог и пишет с правами 0o600, потому что в задачах бывают личные вещи. Про формат — спорное мнение: пока задач меньше нескольких сотен, JSON с MarshalIndent читается глазами и правится руками, и я не тяну SQLite в утилиту, которая обязана собираться за секунду; порог, когда плоский файл перестаёт поспевать, — тысячи записей и частичные обновления на каждый чих, тогда и переедем.

Команда add берёт ровно один аргумент — текст задачи — через Args: cobra.ExactArgs(1) и печатает строку вида добавлено: 3, чтобы номер был виден сразу же. Done и rm ищут запись по номеру; промах оборачивается fmt.Errorf с %w вокруг ErrNotFound, и main переводит это в код 1 — общий провал. Словарь кодов из урока про ошибки живёт в документации, а не в голове: 0 — успех, 1 — провал, 2 — ошибка использования вроде неизвестного статуса в --status, 3 — частичный успех, пригодится будущей команде sync. Rm опаснее остальных: в терминале он спрашивает подтверждение через диалог из урока про интерактивный ввод, в скриптах требует флаг --yes, а на отказ возвращает сентинел errDeclined — тест из урока про тестирование ловит его через errors.Is, не читая текст. На корне включён SilenceUsage: опечатка во флаге не должна вываливать страницу команд вслед за сообщением об ошибке — пользователь уже знает, где --help.

Семантика list — первое проектное решение, которое стоит проговорить вслух. По умолчанию команда показывает только открытые задачи: как git status молчит про чистые файлы, так и list не печатает закрытое — за статусом глаза ходят к тому, что осталось сделать. Флаг --status done покажет выполненное, --status todo повторит умолчание явно, --all снимает фильтр целиком. Значение --status валидируется до обращения к хранилищу: что-то кроме todo и done возвращает ExitError с кодом 2 — ошибка использования ловится на входе, а не после чтения файла. Вывод идёт через text/tabwriter: три колонки — номер, отметка, текст — выравниваются по самой широкой ячейке, и таблица не расползается на длинных заголовках. Цвет берётся из cmd/colors.go, где fatih/color объявляет okStyle и todoStyle один раз: галочка зелёная, точка серая, и это единственное место проекта, знающее про ANSI-байты. Библиотека сама проверяет isatty и NO_COLOR, а глобальный флаг --color со значениями auto, always и never из урока про цветной вывод управляет color.NoColor, когда автоматика угадала не то.

Версия в проекте занимает три строки исходника и одну команду сборки. В main объявлены var version = "dev" и commit, поле Version корня заполняется при старте — Cobra сама добавляет команду version и флаг --version с выводом tasks version dev. Релизная сборка подменяет значения линковщиком: go build -ldflags "-X 'main.version=v1.4.2' -X 'main.commit=9f3ac12'" — и утилита начинает отвечать честно. Отдельную команду version писать не нужно: всё уже сделала Cobra, шаблон вывода при желании меняется через SetVersionTemplate. Сигналы — вторая половина блока: NotifyContext превращает Ctrl+C в отмену контекста, ExecuteContext доставляет её каждой RunE, а defer stop() возвращает терминалу контроль после второго нажатия. Для менеджера задач это страховка про запас: add и list отрабатывают за миллисекунды, ловить в них нечего. Но привычка переносится без переделок: когда в задачах появится sync с сервером — она же даст коду 3 частичного успеха работу, — контекст уже будет протянут куда надо, и graceful shutdown сведётся к проверке ctx.Done() в цикле закачки.

Каркас из урока про тестирование доезжает до финала почти без изменений, с одной поправкой на DI: runCmd принимает App, потому что корень создаётся фабрикой NewRootCmd(app) на каждый вызов — персистентные флаги pflag не переползают между тестами. Хранилище в тестах указывает на t.TempDir(): каталог тестовый раннер удалит сам, и ни один тест не касается реальных задач пользователя. Сценарий пробегает полный жизненный цикл — add, list, done, list --status done — и на каждом шаге проверяет буфер через strings.Contains. Валидация --status ложится в табличный тест: пустой статус, todo, мусорное значение — три кейса с ожидаемыми wantErr и wantOut. Длинный вывод таблицы закрывают golden-файлы из cmd/testdata: эталон обновляется флагом -update осознанно, дифф читается в ревью как правка интерфейса. Прогон go test ./... требует живого Go с модулями проекта — песочница курса тестовый раннер и файловую систему не эмулирует, поэтому сборку и тесты вы делаете локально, в своём терминале.

Если чеклист зелёный — на диске лежит законченная утилита, а не учебный пример: с конфигом, цветами, кодами выхода, версией и тестами. Курс Cobra пройден целиком, и это видно по репозиторию — поздравляю. Идеи доработок лежат на поверхности: дедлайны у задач с подсветкой просроченных, поиск search по подстроке, экспорт в Markdown, синхронизация между машинами через git — она же оживит код 3 частичного успеха, а когда записей станет много, хранилище переедет в SQLite. Два направления уже ждут в соседних курсах. Первый — TUI-режим: тот же list, но интерактивной таблицей с курсором, поиском и статус-баром — это курс Bubble Tea, и ваш домен из internal/tasks переедет туда без единой правки, потому что не знает про терминал. Второй — структурные логи для sync и отладки: курс Zap покажет, как заменить fmt.Fprintln на уровни и поля. Обзор всех уроков — на странице Cobra. Соберите бинарник локально, положите в PATH — и пусть tasks живёт в вашем терминале.