Metadata-Version: 2.1
Name: balaboba
Version: 1.0.8
Summary: Wrapper for Yandex Balaboba
Home-page: https://github.com/monosans/balaboba
License: MIT
Keywords: yalm
Author: monosans
Author-email: hsyqixco@protonmail.com
Requires-Python: >=3.6,<4.0
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: Russian
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Dist: cloudscraper (>=1.2.58,<2.0.0)
Project-URL: Repository, https://github.com/monosans/balaboba
Description-Content-Type: text/markdown

# balaboba

Обёртка для [Яндекс Балабоба](https://yandex.ru/lab/yalm).

Асинхронная версия [здесь](https://github.com/monosans/aiobalaboba).

## Установка

```sh
python -m pip install balaboba
```

## Примеры использования

### Базовый пример

```python
from balaboba import balaboba

response = balaboba("Привет")
print(response)
```

Вывод: `Привет! Я рад тебя видеть на моём канале. Здесь ты сможешь встретить много интересных аниме, музыки, видео, и многого другого.`

### Варианты стилизации

Функции `balaboba` в качестве аргумента `intro` можно передать желаемый вариант стилизации. Номера всех вариантов стилизации есть в [докстринге](https://github.com/monosans/balaboba/blob/main/balaboba/_balaboba.py#L28). В примере используется 11-й вариант стилизации "Народные мудрости" ([полный код примера](https://github.com/monosans/balaboba/blob/main/examples/style.py)):

```python
response = balaboba("Привет", intro=11)
```

### Свой экземпляр cloudscraper.CloudScraper

Функции `balaboba` в качестве аргумента `session` можно передать экземпляр `cloudscraper.CloudScraper` ([полный код примера](https://github.com/monosans/balaboba/blob/main/examples/client_session.py)):

```python
from cloudscraper import create_scraper

with create_scraper() as session:
    response = balaboba("Привет", session=session)
```

Таким же образом можно передать экземпляр `requests.Session`, но эта возможность существует только для обратной совместимости.

## Дисклеймер с сайта

Нейросеть не знает, что говорит, и может сказать всякое — если что, не обижайтесь. Распространяя получившиеся тексты, помните об ответственности.

## License / Лицензия

[MIT](https://github.com/monosans/balaboba/blob/main/LICENSE)

