Руководство:Pywikibot/Разработка
Как сообщить о баге
Первым делом проверьте, повторяется ли баг в последней доступной версии, доступной в Git. Если проблема осталась, пожалуйста, включите следующее при сообщении о баге:
- Подходящий заголовок задания.
- Полное описание проблемы.
- Объясните разницу между ожидаемым выводом и реальным выводом.
- Как воспроизвести баг, включая полную информацию (использованные скрипт, командная строка, семейство и язык).
- Консольный вывод, производимый скриптом (включая трассировку Python, если сообщаете о падении).
- Опубликуйте вывод
version.py.
Чтобы принять новый баг, посетите баг-трекер. Существующие сообщения о багах доступны здесь.
Разработка
Если вам пришла идея полезной функции, которую не может обеспечить ни один существующий бот, вы можете попросить программистов создать такого бота. Но лучше всего, если вы самостоятельно попробуете разработать бота. Python — приятный и простой в изучении язык. Мы будем вам рады.
Доступ к коммитам
Любой может получить аккаунт разработчика. Если вы заинтересованы в работе над Pywikibot, зарегистрировавшись, пожалуйста, напишите письмо на лист рассылки, представьтесь и расскажите о задаче, над которой хотели бы работать, и другие участники смогут вас поприветствовать.
Работа с исходным кодом
Как отправить патчи
Настройте Git и Gerrit. Следуйте инструкции на странице руководства Gerrit и запустите следующее:
$ git clone https://gerrit.wikimedia.org/g/pywikibot/core
и после изменения кода следуйте дальнейшим шагам в руководстве Gerrit.
Руководство
См. общие соглашения по кодированию Python и руководства по разработке Pywikibot.
Документация
Это руководство для пользователей и разработчиков, подобное расположенному Руководство:Pywikibot, пожалуйста, помогите держать его актуальным.
Код частично документирован сам по себе. Документацию можно найти тут:
а отчёты о покрытии кода юнит-тестами расположены тут:
- Покрытие тестами (см. также phab:T74863)
Бот и прокси
Используйте переменные среды requests. См. phab:T111752.
Отладка сетевых проблем
См. советы на странице Pywikibot/mitmproxy.
См. также
- (Git) Код-ревью gerrit.wikimedia: https://gerrit.wikimedia.org/r/admin/repos/pywikibot,general