Руководство:Pywikibot/Разработка

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Pywikibot/Development and the translation is 100% complete.

Как сообщить о баге

Первым делом проверьте, повторяется ли баг в последней доступной версии, доступной в Git. Если проблема осталась, пожалуйста, включите следующее при сообщении о баге:

  • Подходящий заголовок задания.
  • Полное описание проблемы.
    • Объясните разницу между ожидаемым выводом и реальным выводом.
  • Как воспроизвести баг, включая полную информацию (использованные скрипт, командная строка, семейство и язык).
  • Консольный вывод, производимый скриптом (включая трассировку Python, если сообщаете о падении).
  • Опубликуйте вывод version.py .

Чтобы принять новый баг, посетите баг-трекер. Существующие сообщения о багах доступны здесь.

Разработка

Если вам пришла идея полезной функции, которую не может обеспечить ни один существующий бот, вы можете попросить программистов создать такого бота. Но лучше всего, если вы самостоятельно попробуете разработать бота. Python — приятный и простой в изучении язык. Мы будем вам рады.

Доступ к коммитам

Любой может получить аккаунт разработчика . Если вы заинтересованы в работе над Pywikibot, зарегистрировавшись, пожалуйста, напишите письмо на лист рассылки, представьтесь и расскажите о задаче, над которой хотели бы работать, и другие участники смогут вас поприветствовать.

Работа с исходным кодом

Основные страницы: Manual:Pywikibot/Gerrit и Gerrit/TortoiseGit tutorial

Как отправить патчи

Настройте Git и Gerrit. Следуйте инструкции на странице руководства Gerrit и запустите следующее:

#for hacking core
$ git clone ssh://USERNAME@gerrit.wikimedia.org:29418/pywikibot/core.git

и после изменения кода следуйте дальнейшим шагам в руководстве Gerrit .

Руководство

См. общие соглашения по кодированию Python и руководства по разработке Pywikibot .

Документация

Это руководство для пользователей и разработчиков, подобное расположенному Руководство:Pywikibot , пожалуйста, помогите держать его актуальным.

Код частично документирован сам по себе. Документацию можно найти тут:

а отчёты о покрытии кода юнит-тестами расположены тут:

Бот и прокси

Используйте переменные среды requests. См. phab:T111752.

Отладка сетевых проблем

См. советы на странице Pywikibot/mitmproxy .

См. также