{"id":34032236,"url":"https://github.com/avidale/botank","last_synced_at":"2026-04-06T02:02:28.290Z","repository":{"id":57416033,"uuid":"249277598","full_name":"avidale/botank","owner":"avidale","description":"Библиотека для автоматического тестирования навыков Алисы и других чат-ботов","archived":false,"fork":false,"pushed_at":"2020-11-23T16:48:08.000Z","size":27,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-12-15T09:28:16.573Z","etag":null,"topics":["alice-skills","testing-tools","yandex-alice","yandex-api"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/avidale.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-03-22T21:41:42.000Z","updated_at":"2020-11-23T16:48:10.000Z","dependencies_parsed_at":"2022-09-01T18:23:41.424Z","dependency_job_id":null,"html_url":"https://github.com/avidale/botank","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/avidale/botank","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avidale%2Fbotank","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avidale%2Fbotank/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avidale%2Fbotank/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avidale%2Fbotank/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/avidale","download_url":"https://codeload.github.com/avidale/botank/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/avidale%2Fbotank/sbom","scorecard":{"id":218126,"data":{"date":"2025-08-11","repo":{"name":"github.com/avidale/botank","commit":"387a7842936de59fa8f9b7f5f5e7eee1458c1d97"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.4,"checks":[{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Code-Review","score":0,"reason":"Found 0/15 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":5,"reason":"5 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: PYSEC-2014-14 / GHSA-652x-xj99-gmcc","Warn: Project is vulnerable to: GHSA-9hjg-9r4m-mvj7","Warn: Project is vulnerable to: GHSA-9wx4-h78v-vm56","Warn: Project is vulnerable to: PYSEC-2014-13 / GHSA-cfj3-7x9c-4p3h","Warn: Project is vulnerable to: PYSEC-2018-28 / GHSA-x84v-xcm2-53pg"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-17T02:00:58.226Z","repository_id":57416033,"created_at":"2025-08-17T02:00:58.226Z","updated_at":"2025-08-17T02:00:58.226Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31456664,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T21:22:52.476Z","status":"online","status_checked_at":"2026-04-06T02:00:07.287Z","response_time":112,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alice-skills","testing-tools","yandex-alice","yandex-api"],"created_at":"2025-12-13T18:41:06.076Z","updated_at":"2026-04-06T02:02:28.285Z","avatar_url":"https://github.com/avidale.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# botank\nБота́нк - это инструмент для автоматического тестирования навыков Алисы \n(и в перспективе других чат-ботов).\nЗасыпаем бота случайными запросами и смотрим, как он справляется.\n\nЭта библиотека написана на питоне, но ботов она дёргает по вебхуку, \nи поэтому сами боты могут быть написаны на любом языке или вообще без языка.\n\nСсылки: [GitHub](https://github.com/avidale/botank), \n[PyPI](https://pypi.org/project/botank/).\n\nRead this in other languages: \n[English](https://github.com/avidale/botank/blob/master/README_EN.md), \n[Русский](https://github.com/avidale/botank).\n\n## Самое главное\nДля установки необходимо иметь Python\u003e=3.6 и пакетный менеджер pip \n(либо аналог). \nПока что только так. \n\nУстановка:\n```commandline\npip install botank\n```\n\nКак запустить:\n```commandline\npython -m botank http://localhost:5000/alice/ -n 100 -o results.txt\n```\nПри подобном запуске ботанк направит по адресу `http://localhost:5000/alice/` \n100 случайных запросов в навык, и сохранит результат обстрела \nв файл `results.txt`.\n\nВ процессе диалог будет примерно таким:\n```commandline\nRunning 100 turns of Botank simulation...\n\nu: привет\nb: Привет. Добро пожаловать в навык \"Донорство костного мозга\". Я отвечу на ваши вопросы про кровь и костный мозг. Выберите раздел и начнем!\nНапример: Рак крови.\nu: Костный мозг\nb: Хорошо, поговорим на тему костный мозг. Выбирайте вопрос! Например, можете спросить: Как по-английски будет костный мозг?\nu: Что такое кроветворение?\nb: Кроветворение - это процесс образования, развития и созревания клеток крови - лейкоцитов, эритроцитов, тромбоцитов. За 70 лет жизни человека костный мозг вырабатывает приблизительно 1000 кг лейкоцитов и 650 кг эритроцитов. Даже меня это впечатляет.\nu: и 650\n...\nu: домой\nb: Я вас не понимаю. Спросите у меня что-нибудь про кровь или костный мозг! Например: Передается ли рак крови половым путем?\nu: Как стать донором костного мозга?\nb: Мне кажется, что вы хороший человек, раз задаете этот вопрос. Стать донором очень просто. Вы можете сдать кровь в ближайшей лаборатории «Инвитро», и ее внесут в базу потенциальных доноров. И если ваш генетический двойник заболеет, вы сможете спасти его жизнь. Хотите узнать, как найти генетического двойника?\n\nSummary:\nCodes: 200 - 100\nTimings: min 1.02557, max 1.35971, average 1.07610431\n```\n\n## Зачем\nПредполагается, что ботанк будет применяться на ранних стадиях разработки\nнавыка, когда он ещё не испытан \"в бою\", \nи нужно его перед релизом испытать хоть как-то.\n\nВо-первых, подобный обстрел может помочь протыкать все сценарии диалога\n(если для них есть саджесты) и выявить запросы, на которых бот падает. \n\nВо-вторых, обстрел может выявить запросы, на которых бот отвечает слишком долго.\n\nВ-третьих, ботанк (когда мы его допилим) можно будет использовать \nдля нагрузочного тестирования, чтобы понимать, под каким RPS навык может выжить.\n\nНу и сами тексты сгенерированного скриптом диалога, несмотря на его бредовость, \nнадеемся, могут навести разработчика бота на плодотворные мысли.\n\n\n## Как это работает\nНа каждом шаге ботанк случайным образом выбирает одно из действий:\n1. нажать на случайную кнопку из предложенных;\n1. кинуть в бота случайной подстрокой его предыдущего ответа;\n1. кинуть в бота случайно выбранной фразой из захардкоженного списка.\n\nЭти действия происходят каскадно: (1) происходит только если кнопки есть, \nда и то лишь с некоторой вероятностью (`--button`). \nДействие (2) происходит, только если \nне произошло (1), и тоже лишь с некоторой вероятностью (`--repeat`). \nВо всех остальных случаех происходит (3).\n\nПосле заданного числа итераций подобного обстрела выдаётся статистика \nпо кодам и временам ответа, \nа запросы и ответы сохраняются в файл для дальнейшего анализа.\n\nВ выходном файле каждая строка - это JSON, содержащий поля:\n* `request` - отправленный в навык запрос;\n* `response` - ответ навыка;\n* `code` - код ответа;\n* `time` - время, потребовавшееся на ответ.\n\n## Как это конфигурировать\n\nВсё управление \"симулятором юзера\" - опциями командной строки:\n* `--button` вероятность, с которой симулятор читает случайную кнопку \n(по умолчанию равна 0.5).\n* `--repeat` вероятность, с которой симулятор читает случайную подстроку\nпредыдущего ответа, если не нажал кнопку (по умолчанию так же равна 0.5) \n* `--texts` - путь до текстового файла с потенциальными запросами в навык. \nЕсли его не указывать, на шаге (3) используется десяток захардкоженных фраз.\nУказать эту опцию можно много раз, тогда фразы из разных файлов будут перемешаны.\n\nДругие опции:\n* `-n` - число запросов (по умолчанию 100)\n* `-o` - файл для сохранения результатов\n* `--silent` - не печатать текущий диалог в командную строку \n(по умолчанию печатает)\n\n## Дальнейшие планы\nПредполагается добавить в этот инструмент ещё несколько опций:\n* Явное управление нагрузкой - чтобы можно было делать \nнагрузочное тестирование навыков. \n* Использование машиннообученной \"болталки\" в качестве \nмодели пользователя - чтобы генерируемые диалоги были реалистичнее.\n* Использование ботанка как питонячей либы для автоматических \nфункциональных тестов навыка.\n\n\nОбсудить желаемые фичи или пожаловаться на баги можно \nв [issues](https://github.com/avidale/botank/issues)\nили в [чате разработчиков навыков Алисы](https://t.me/yadialogschat).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Favidale%2Fbotank","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Favidale%2Fbotank","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Favidale%2Fbotank/lists"}