Требования к пакету Python: Использование спецификаторов версий == и> =

Question

Я ищу лучшие практики, делаю и не хочу касаться спецификаций спецификации в файлах требований для pip в пакетах python.

Предположим, что пакет python зависит от некоторых других модулей. Для большинства из них требуется минимальная версия. По крайней мере, для сопровождающих известно, что код работает с наименьшим, например, шесть 1,7

Теперь можно определить требования по-разному:

• six>=1.7.0 Программное обеспечение было протестировано с этой версией, и предполагается, что он будет также с будущими версиями
• six==1.7.0 Мы требуется точная версия, пакет был протестирован. Программное обеспечение не тестировалось со всеми будущими версиями модуля, поэтому мы не можем гарантировать, что он будет работать для них.
• six==1.9.0 Мы просто тестируем его с использованием новейшей версии и требуем его.

У меня есть торможение, требующее точной версии, так как это может нарушить другие требования к пакетам и кажется мне плохой практикой. С другой стороны, пакет не был протестирован со всеми версиями шести выше 1.7.0.

Существуют ли какие-либо указания относительно требований к версии пакета и использования == против >=?

Answer 1

Основываясь на моем опыте, как разработчик, упаковщик (пакет сопровождающие для распределений) и программного обеспечение сопровождающего я пришел к следующей интерпретации/рекомендации:

• install_requires: Зависимость, приведенная в install_requires проверяется во время выполнения (!) pkg_resources. Это жесткие зависимости. Они могут (должны?) Содержать требуемый минимальный номер версии, но не точную версию, если не указаны очень веские причины. Более поддерживаемые версии, как правило, более полезны, максимальные номера версий обычно являются кошмаром.
• extras_requires содержит дополнительные требования (рекомендации), которые не нужны для основных функций, но для некоторых дополнительных функций или являются дополнительными, что повышает функциональность. Если программное обеспечение не работает без него, оно должно перейти к install_requires.
• requirements.txt Некоторые сопровождающие устанавливают его одинаково с install_requires, некоторые другие вообще не используют его. Его можно использовать для рекомендации конкретных версий требований, которые лучше всего тестируются. Это, конечно, вообще не полезно для упаковки, но для настроек в virtualenvs и подобных.

Упаковщики обычно не используют информацию из требования .txt, но из install_requires и extras_requires.