Metadata-Version: 2.1
Name: ya-music-rnd
Version: 1.1.0
Summary: Поиск случайного исполнителя на сайте яндекс музыки
Home-page: https://github.com/Genzo4/yandex_rnd
Author: Genzo
Author-email: genzo@bk.ru
License: MIT
Project-URL: Bug Tracker, https://github.com/Genzo4/yandex_rnd/issues
Keywords: yandex,music,yandex_rnd,ya_music_rnd,ya
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Natural Language :: English
Classifier: Natural Language :: Russian
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: urllib3

# yandex_rnd

![PyPI](https://img.shields.io/pypi/v/ya_music_rnd)
![PyPI - License](https://img.shields.io/pypi/l/ya_music_rnd)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/ya_music_rnd)

Поиск случайного исполнителя на сайте яндекс музыки (https://music.yandex.ru) и открытие его страницы в браузере. 

***

## Установка пакета

### Установка пакета с PyPi

```bash
$ pip install ya-music-rnd
```

### Установка пакета из исходного кода

Исходный код размещается на [GitHub](https://github.com/Genzo4/yandex_rnd).  
Скачайте его и установите пакет:

```bash
$ git clone https://github.com/Genzo4/yandex_rnd
$ cd yandex_rnd
$ pip install .
```

***

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

- ### Подключаем:
```python
from ya_music_rnd import YandexMusicRnd
```

- ### Создаём экземпляр
Создаём экземпляр YandexMusicRnd.
Можно указать дополнительные параметры:
- max_index - максимальный индекс для поиска. 
  Значение по умолчанию: 10000000
- open_url - открывать в браузере найденного исполнителя или нет.
  Значение по умолчанию: True
- max_iterations - количество максимальных итераций поиска.
  Значение по умолчанию: 60
- find_clear - искать "пустых" исполнителей (у них на странице нет ничего).
  Принимаемые значения: 'yes' - искать только пустые, 'no' - не искать пустые, 'all' - искать и те, и другие.
  Значение по умолчанию: 'no'
- find_have_albom - фильтр исполнителей по наличию альбомов.
  Принимаемые значения: 'yes', 'no', 'all'.
  Значение по умолчанию: 'all'
- find_have_similar - фильтр исполнителей по наличию похожих исполнителей.
  Принимаемые значения: 'yes', 'no', 'all'.
  Значение по умолчанию: 'all'
- find_have_clips - фильтр исполнителей по наличию клипов.
  Принимаемые значения: 'yes', 'no', 'all'.
  Значение по умолчанию: 'all'
- show_progress - показывать прогресс поиска.
  Значение по умолчанию: True 
- quiet - не выводить никаких сообщений на экран.
  Значение по умолчанию: False

```python
ya_rnd = YandexMusicRnd()
```

- ### Находим исполнителя

```python
site = ya_rnd.get_artist()  # возвращает URL найденного артиста
```

Пример использования модуля см. в файле main.py

***

# Yandex Music Rnd

На основе пакета ya_music_rnd сделана программа Yandex Music Rnd.
Готовые билды программы можно взять в релизах на сайте Github (https://github.com/Genzo4/yandex_rnd/releases)

- ### Билд под Windows
```cmd
pip install -r requirements_build.txt
pyinstaller -F -n ya_music_rnd -i favicon32.png main.py --version-file version.txt
```

Готовый исполняемый файл появляется в папке dist. 

Помощь по параметрам командной строки можно узнать выполнив:
```cmd
ya_music_rnd.exe -h
```

***

[Changelog](https://github.com/Genzo4/yandex_rnd/blob/main/CHANGELOG.md)
