62 lines
3.2 KiB
Markdown
62 lines
3.2 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`.
|