# yandex_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)
Raw data
{
"_id": null,
"home_page": "https://github.com/Genzo4/yandex_rnd",
"name": "ya-music-rnd",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "yandex, music, yandex_rnd, ya_music_rnd, ya",
"author": "Genzo",
"author_email": "genzo@bk.ru",
"download_url": "https://files.pythonhosted.org/packages/c4/09/42a8953a96666f33e7f9f4c701a993198bee1ab6bbfa7607e7ec24aeefc8/ya_music_rnd-1.1.0.tar.gz",
"platform": null,
"description": "# yandex_rnd\r\n\r\n\r\n\r\n\r\n\r\n\u041f\u043e\u0438\u0441\u043a \u0441\u043b\u0443\u0447\u0430\u0439\u043d\u043e\u0433\u043e \u0438\u0441\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044f \u043d\u0430 \u0441\u0430\u0439\u0442\u0435 \u044f\u043d\u0434\u0435\u043a\u0441 \u043c\u0443\u0437\u044b\u043a\u0438 (https://music.yandex.ru) \u0438 \u043e\u0442\u043a\u0440\u044b\u0442\u0438\u0435 \u0435\u0433\u043e \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u044b \u0432 \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u0435. \r\n\r\n***\r\n\r\n## \u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430 \u043f\u0430\u043a\u0435\u0442\u0430\r\n\r\n### \u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430 \u043f\u0430\u043a\u0435\u0442\u0430 \u0441 PyPi\r\n\r\n```bash\r\n$ pip install ya-music-rnd\r\n```\r\n\r\n### \u0423\u0441\u0442\u0430\u043d\u043e\u0432\u043a\u0430 \u043f\u0430\u043a\u0435\u0442\u0430 \u0438\u0437 \u0438\u0441\u0445\u043e\u0434\u043d\u043e\u0433\u043e \u043a\u043e\u0434\u0430\r\n\r\n\u0418\u0441\u0445\u043e\u0434\u043d\u044b\u0439 \u043a\u043e\u0434 \u0440\u0430\u0437\u043c\u0435\u0449\u0430\u0435\u0442\u0441\u044f \u043d\u0430 [GitHub](https://github.com/Genzo4/yandex_rnd). \r\n\u0421\u043a\u0430\u0447\u0430\u0439\u0442\u0435 \u0435\u0433\u043e \u0438 \u0443\u0441\u0442\u0430\u043d\u043e\u0432\u0438\u0442\u0435 \u043f\u0430\u043a\u0435\u0442:\r\n\r\n```bash\r\n$ git clone https://github.com/Genzo4/yandex_rnd\r\n$ cd yandex_rnd\r\n$ pip install .\r\n```\r\n\r\n***\r\n\r\n## \u0418\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435 \u043f\u0430\u043a\u0435\u0442\u0430\r\n\r\n- ### \u041f\u043e\u0434\u043a\u043b\u044e\u0447\u0430\u0435\u043c:\r\n```python\r\nfrom ya_music_rnd import YandexMusicRnd\r\n```\r\n\r\n- ### \u0421\u043e\u0437\u0434\u0430\u0451\u043c \u044d\u043a\u0437\u0435\u043c\u043f\u043b\u044f\u0440\r\n\u0421\u043e\u0437\u0434\u0430\u0451\u043c \u044d\u043a\u0437\u0435\u043c\u043f\u043b\u044f\u0440 YandexMusicRnd.\r\n\u041c\u043e\u0436\u043d\u043e \u0443\u043a\u0430\u0437\u0430\u0442\u044c \u0434\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0435 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b:\r\n- max_index - \u043c\u0430\u043a\u0441\u0438\u043c\u0430\u043b\u044c\u043d\u044b\u0439 \u0438\u043d\u0434\u0435\u043a\u0441 \u0434\u043b\u044f \u043f\u043e\u0438\u0441\u043a\u0430. \r\n \u0417\u043d\u0430\u0447\u0435\u043d\u0438\u0435 \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e: 10000000\r\n- open_url - \u043e\u0442\u043a\u0440\u044b\u0432\u0430\u0442\u044c \u0432 \u0431\u0440\u0430\u0443\u0437\u0435\u0440\u0435 \u043d\u0430\u0439\u0434\u0435\u043d\u043d\u043e\u0433\u043e \u0438\u0441\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044f \u0438\u043b\u0438 \u043d\u0435\u0442.\r\n \u0417\u043d\u0430\u0447\u0435\u043d\u0438\u0435 \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e: True\r\n- max_iterations - \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e \u043c\u0430\u043a\u0441\u0438\u043c\u0430\u043b\u044c\u043d\u044b\u0445 \u0438\u0442\u0435\u0440\u0430\u0446\u0438\u0439 \u043f\u043e\u0438\u0441\u043a\u0430.\r\n \u0417\u043d\u0430\u0447\u0435\u043d\u0438\u0435 \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e: 60\r\n- find_clear - \u0438\u0441\u043a\u0430\u0442\u044c \"\u043f\u0443\u0441\u0442\u044b\u0445\" \u0438\u0441\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u0435\u0439 (\u0443 \u043d\u0438\u0445 \u043d\u0430 \u0441\u0442\u0440\u0430\u043d\u0438\u0446\u0435 \u043d\u0435\u0442 \u043d\u0438\u0447\u0435\u0433\u043e).\r\n \u041f\u0440\u0438\u043d\u0438\u043c\u0430\u0435\u043c\u044b\u0435 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f: 'yes' - \u0438\u0441\u043a\u0430\u0442\u044c \u0442\u043e\u043b\u044c\u043a\u043e \u043f\u0443\u0441\u0442\u044b\u0435, 'no' - \u043d\u0435 \u0438\u0441\u043a\u0430\u0442\u044c \u043f\u0443\u0441\u0442\u044b\u0435, 'all' - \u0438\u0441\u043a\u0430\u0442\u044c \u0438 \u0442\u0435, \u0438 \u0434\u0440\u0443\u0433\u0438\u0435.\r\n \u0417\u043d\u0430\u0447\u0435\u043d\u0438\u0435 \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e: 'no'\r\n- find_have_albom - \u0444\u0438\u043b\u044c\u0442\u0440 \u0438\u0441\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u0435\u0439 \u043f\u043e \u043d\u0430\u043b\u0438\u0447\u0438\u044e \u0430\u043b\u044c\u0431\u043e\u043c\u043e\u0432.\r\n \u041f\u0440\u0438\u043d\u0438\u043c\u0430\u0435\u043c\u044b\u0435 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f: 'yes', 'no', 'all'.\r\n \u0417\u043d\u0430\u0447\u0435\u043d\u0438\u0435 \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e: 'all'\r\n- find_have_similar - \u0444\u0438\u043b\u044c\u0442\u0440 \u0438\u0441\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u0435\u0439 \u043f\u043e \u043d\u0430\u043b\u0438\u0447\u0438\u044e \u043f\u043e\u0445\u043e\u0436\u0438\u0445 \u0438\u0441\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u0435\u0439.\r\n \u041f\u0440\u0438\u043d\u0438\u043c\u0430\u0435\u043c\u044b\u0435 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f: 'yes', 'no', 'all'.\r\n \u0417\u043d\u0430\u0447\u0435\u043d\u0438\u0435 \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e: 'all'\r\n- find_have_clips - \u0444\u0438\u043b\u044c\u0442\u0440 \u0438\u0441\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u0435\u0439 \u043f\u043e \u043d\u0430\u043b\u0438\u0447\u0438\u044e \u043a\u043b\u0438\u043f\u043e\u0432.\r\n \u041f\u0440\u0438\u043d\u0438\u043c\u0430\u0435\u043c\u044b\u0435 \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f: 'yes', 'no', 'all'.\r\n \u0417\u043d\u0430\u0447\u0435\u043d\u0438\u0435 \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e: 'all'\r\n- show_progress - \u043f\u043e\u043a\u0430\u0437\u044b\u0432\u0430\u0442\u044c \u043f\u0440\u043e\u0433\u0440\u0435\u0441\u0441 \u043f\u043e\u0438\u0441\u043a\u0430.\r\n \u0417\u043d\u0430\u0447\u0435\u043d\u0438\u0435 \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e: True \r\n- quiet - \u043d\u0435 \u0432\u044b\u0432\u043e\u0434\u0438\u0442\u044c \u043d\u0438\u043a\u0430\u043a\u0438\u0445 \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u0439 \u043d\u0430 \u044d\u043a\u0440\u0430\u043d.\r\n \u0417\u043d\u0430\u0447\u0435\u043d\u0438\u0435 \u043f\u043e \u0443\u043c\u043e\u043b\u0447\u0430\u043d\u0438\u044e: False\r\n\r\n```python\r\nya_rnd = YandexMusicRnd()\r\n```\r\n\r\n- ### \u041d\u0430\u0445\u043e\u0434\u0438\u043c \u0438\u0441\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044f\r\n\r\n```python\r\nsite = ya_rnd.get_artist() # \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 URL \u043d\u0430\u0439\u0434\u0435\u043d\u043d\u043e\u0433\u043e \u0430\u0440\u0442\u0438\u0441\u0442\u0430\r\n```\r\n\r\n\u041f\u0440\u0438\u043c\u0435\u0440 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u044f \u043c\u043e\u0434\u0443\u043b\u044f \u0441\u043c. \u0432 \u0444\u0430\u0439\u043b\u0435 main.py\r\n\r\n***\r\n\r\n# Yandex Music Rnd\r\n\r\n\u041d\u0430 \u043e\u0441\u043d\u043e\u0432\u0435 \u043f\u0430\u043a\u0435\u0442\u0430 ya_music_rnd \u0441\u0434\u0435\u043b\u0430\u043d\u0430 \u043f\u0440\u043e\u0433\u0440\u0430\u043c\u043c\u0430 Yandex Music Rnd.\r\n\u0413\u043e\u0442\u043e\u0432\u044b\u0435 \u0431\u0438\u043b\u0434\u044b \u043f\u0440\u043e\u0433\u0440\u0430\u043c\u043c\u044b \u043c\u043e\u0436\u043d\u043e \u0432\u0437\u044f\u0442\u044c \u0432 \u0440\u0435\u043b\u0438\u0437\u0430\u0445 \u043d\u0430 \u0441\u0430\u0439\u0442\u0435 Github (https://github.com/Genzo4/yandex_rnd/releases)\r\n\r\n- ### \u0411\u0438\u043b\u0434 \u043f\u043e\u0434 Windows\r\n```cmd\r\npip install -r requirements_build.txt\r\npyinstaller -F -n ya_music_rnd -i favicon32.png main.py --version-file version.txt\r\n```\r\n\r\n\u0413\u043e\u0442\u043e\u0432\u044b\u0439 \u0438\u0441\u043f\u043e\u043b\u043d\u044f\u0435\u043c\u044b\u0439 \u0444\u0430\u0439\u043b \u043f\u043e\u044f\u0432\u043b\u044f\u0435\u0442\u0441\u044f \u0432 \u043f\u0430\u043f\u043a\u0435 dist. \r\n\r\n\u041f\u043e\u043c\u043e\u0449\u044c \u043f\u043e \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430\u043c \u043a\u043e\u043c\u0430\u043d\u0434\u043d\u043e\u0439 \u0441\u0442\u0440\u043e\u043a\u0438 \u043c\u043e\u0436\u043d\u043e \u0443\u0437\u043d\u0430\u0442\u044c \u0432\u044b\u043f\u043e\u043b\u043d\u0438\u0432:\r\n```cmd\r\nya_music_rnd.exe -h\r\n```\r\n\r\n***\r\n\r\n[Changelog](https://github.com/Genzo4/yandex_rnd/blob/main/CHANGELOG.md)\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "\u041f\u043e\u0438\u0441\u043a \u0441\u043b\u0443\u0447\u0430\u0439\u043d\u043e\u0433\u043e \u0438\u0441\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044f \u043d\u0430 \u0441\u0430\u0439\u0442\u0435 \u044f\u043d\u0434\u0435\u043a\u0441 \u043c\u0443\u0437\u044b\u043a\u0438",
"version": "1.1.0",
"project_urls": {
"Bug Tracker": "https://github.com/Genzo4/yandex_rnd/issues",
"Homepage": "https://github.com/Genzo4/yandex_rnd"
},
"split_keywords": [
"yandex",
" music",
" yandex_rnd",
" ya_music_rnd",
" ya"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "014c58643849a1e5a947eee359a48ee51bd74e9c60ab80c5aeb7b6a5b18aa1cf",
"md5": "52cdb4115a862a6c0d09c4f7ead4cbde",
"sha256": "72f56ff104d19a15af1f12e7c0cc46f87096d0de106dfb15ea455a7858f962bc"
},
"downloads": -1,
"filename": "ya_music_rnd-1.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "52cdb4115a862a6c0d09c4f7ead4cbde",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 7016,
"upload_time": "2024-04-21T22:12:54",
"upload_time_iso_8601": "2024-04-21T22:12:54.113098Z",
"url": "https://files.pythonhosted.org/packages/01/4c/58643849a1e5a947eee359a48ee51bd74e9c60ab80c5aeb7b6a5b18aa1cf/ya_music_rnd-1.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c40942a8953a96666f33e7f9f4c701a993198bee1ab6bbfa7607e7ec24aeefc8",
"md5": "bc9db41616d3d7bdf566957488fa6b8c",
"sha256": "2230c50712455ae1b3cdbf6ddff2c5b00efcc497de9c724f15eb64b3453f72c0"
},
"downloads": -1,
"filename": "ya_music_rnd-1.1.0.tar.gz",
"has_sig": false,
"md5_digest": "bc9db41616d3d7bdf566957488fa6b8c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 9331,
"upload_time": "2024-04-21T22:12:56",
"upload_time_iso_8601": "2024-04-21T22:12:56.164349Z",
"url": "https://files.pythonhosted.org/packages/c4/09/42a8953a96666f33e7f9f4c701a993198bee1ab6bbfa7607e7ec24aeefc8/ya_music_rnd-1.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-21 22:12:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Genzo4",
"github_project": "yandex_rnd",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "ya-music-rnd"
}
JSON
