Metadata-Version: 2.4
Name: thumbgener
Version: 0.1.6
Summary: Simple Python tool and library for generating stylish blog post thumbnails and covers
Author-email: Vlad Kudelko <vlad1kudelko@gmail.com>
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pillow>=12.2.0
Requires-Dist: typer>=0.24.2
Dynamic: license-file

# Thumbgener

`thumbgener` — это простой и удобный инструмент на Python для автоматической генерации стильных обложек (thumbnail) для статей, видео или постов в соцсетях.

Библиотека позволяет генерировать изображения как через командную строку (CLI), так и программно, интегрируя её в ваши скрипты.

![Lorem Ipsum](https://raw.githubusercontent.com/vlad1kudelko/thumbgener/main/imgs/lorem.webp)

## Особенности

- **Генерация "Blobs":** Создание абстрактных фонов с мягкими цветными каплями и размытием.
- **Умный перенос текста:** Автоматическое разбиение длинных заголовков на строки.
- **Встроенные шрифты:** Включает семейство шрифтов Ubuntu для корректного отображения текста "из коробки".
- **Гибкая настройка:** Управление размерами, отступами, шрифтами и цветами.

## Установка

```bash
pip install thumbgener
```

## Использование

### Как CLI инструмент

После установки вам будет доступна команда `thumbgener-cli`.

Пример создания обложки с "каплями":

```bash
thumbgener-cli "Lorem Ipsum is simply dummy text of the printing and typesetting industry" cover.webp
```

**Доступные параметры:**

- `title`: Текст заголовка (обязательно).
- `filename`: Имя выходного файла (обязательно).
- `--width`: Ширина изображения (default: 800).
- `--height`: Высота изображения (default: 400).
- `--padding`: Отступы от края обложки (default: 50).
- `--font-size` Размер шрифта (default: 50).
- `--line-padding` Межстрочный отступ (default: 10).

### Как библиотека в коде

Вы можете использовать в своих Python-скриптах:

```python
from thumbgener import ThumbgenerBlob

# Инициализация генератора
tg = ThumbgenerBlob(width=1200, height=630)

# Генерация и сохранение
tg.draw("Заголовок потрясающей статьи", "thumb.webp")
```

## Структура проекта

- `Thumbgener`: Базовый абстрактный класс для создания своих стилей.
- `ThumbgenerBlob`: Реализация стиля с цветными каплями и размытием.
- `fonts/`: Встроенные шрифты Ubuntu.

## Разработка

```bash
# Установка зависимостей для разработки
uv sync

# Запуск CLI локально
uv run thumbgener-cli --help
```

## Лицензия

Распространяется под лицензией MIT.
