Процесс и правила релиза

Добавлено в версии v2.6.2.

Начиная с версии, которая будет выпущена после v2.6.2, следующие правила будут определять и описывать, как основная группа Requests создаёт новый релиз.

Основные релизы

В основной релиз будут внесены критические изменения. После создания версии у него будет номер vX.0.0. Например, если предыдущая версия была v10.2.7, следующей версией будет v11.0.0.

Критические изменения — это изменения, которые нарушают обратную совместимость с предыдущими версиями. Если бы проект изменил атрибут text объекта Response на метод, это произошло бы только в основной версии.

Основные релизы могут также включать различные исправления ошибок. Основные разработчики Requests стремятся обеспечить удобство работы пользователей. Это означает, что мы также стремимся максимально сохранить обратную совместимость. Крупные релизы будут происходить нечасто и потребуют веских обоснований, прежде чем они будут рассмотрены.

Незначительные релизы

Незначительный релиз не будет содержать критических изменений, но может включать различные исправления ошибок. Если предыдущая выпущенная версия Requests была v10.2.7, у второстепенного релиза была бы версия v10.3.0.

Незначительные релизы будут обратно совместимы с релизами, имеющими такой же номер основной версии. Другими словами, все версии, которые начинаются с v10., должны быть совместимы друг с другом.

Релизы исправлений

Релиз исправления будет включать только исправления ошибок, которые были пропущены, когда проект выпустил предыдущую версию. Если предыдущая версия Requests была v10.2.7, у версии исправления будет номер v10.2.8.

Исправления не будут включать обновления зависимостей, поставляемых после v2.6.2

Рассуждение

В серии релизов 2.5 и 2.6 основная группа Requests обновила поставленные зависимости и доставила массу проблем как пользователям, так и команде ядра. Чтобы уменьшить эту боль, мы формируем конкретный множество процедур, чтобы зависимости были правильно установлены.