66 lines
3.8 KiB
Markdown
66 lines
3.8 KiB
Markdown
# Название проекта
|
||
|
||
Краткое описание проекта: сервис/утилита на Go для обработки данных с использованием встроенных словарей и шаблонов (`keywords`).
|
||
|
||
## Особенности архитектуры
|
||
|
||
В проекте используется стандартный пакет **`embed`** (Go 1.16+) для встраивания текстовых ресурсов (словаря `words.txt`) непосредственно в скомпилированный бинарный файл. Это позволяет распространять приложение в виде единого исполняемого файла без необходимости таскать за ним внешние директории со статикой.
|
||
|
||
## Структура проекта
|
||
|
||
```text
|
||
.
|
||
├── go.mod # Файл описания модуля и зависимостей
|
||
├── cmd/
|
||
│ ├── cleaner/
|
||
│ └── main.go # Точка входа в приложение (если применимо)
|
||
└── internal/ # Приватный код приложения
|
||
├── keywords/ # Бизнес-логика работы со словами
|
||
| ├── templates/ # Директория со статическими ресурсами и шаблонами
|
||
| │ ├── words.txt # Словарь удаляемых слов из названий файлов и папок
|
||
| │ └── trash.txt # Словарь имен удаляемых файлов
|
||
| └── keywords.go # Пакет работы с ключевыми словами
|
||
└── renamer/
|
||
└── keywords.go # Пакет переименовывателя
|
||
```
|
||
|
||
## Требования
|
||
|
||
* **Go** версии 1.16 или выше (рекомендуется актуальная стабильная версия).
|
||
|
||
## Установка и запуск
|
||
|
||
1. **Клонируйте репозиторий:**
|
||
```bash
|
||
git clone https://github.com
|
||
cd ваш-проект
|
||
```
|
||
|
||
2. **Загрузите зависимости (если есть):**
|
||
```bash
|
||
go mod download
|
||
```
|
||
|
||
3. **Запустите проект:**
|
||
```bash
|
||
go run .
|
||
```
|
||
|
||
## Сборка
|
||
|
||
Для компиляции в единый бинарный файл (все файлы из `templates/` будут автоматически вшиты внутрь):
|
||
|
||
```bash
|
||
go build -o app .
|
||
```
|
||
|
||
После сборки вы можете перенести файл `app` на любой сервер — папка `templates/` рядом с ним больше не потребуется.
|
||
|
||
## Работа с ресурсами (`templates/`)
|
||
|
||
Поскольку в Go директива `//go:embed` запрещает обращение к родительским директориям (`../`), доступ к файлам из вложенных пакетов (таких как `internal/keywords`) реализован через пакет `templates`:
|
||
|
||
* Все текстовые файлы хранятся в `/templates`.
|
||
* Файл `/templates/embed.go` считывает их на этапе компиляции и предоставляет через функции-геттеры (например, `templates.GetWords()`), что защищает данные от случайного изменения во время работы программы.
|
||
* При добавлении новых текстовых файлов в `templates/` необходимо также добавить соответствующую директиву `//go:embed` и функцию доступа в `templates/embed.go`.
|