Политики#
Политика версий#
pandas использует свободный вариант семантического версионирования (SemVer) для управления устареванием, совместимостью API и нумерацией версий.
Номер выпуска pandas состоит из MAJOR.MINOR.PATCH.
Критические изменения API должны происходить только в основной релизах. Эти изменения будут документированы с четкими указаниями о том, что меняется, почему это меняется, и как перенести существующий код на новое поведение.
По возможности будет предоставлен путь устаревания, а не прямое нарушающее изменение.
pandas будет вводить устаревания в второстепенный релизах. Эти устаревания сохранят существующее поведение, выдавая предупреждение, которое предоставляет руководство по:
Как достичь аналогичного поведения, если доступна альтернатива
Версия pandas, в которой устаревание будет применено.
Мы не будем вводить новые устаревания в патч-релизах.
Устаревания будут применяться только в основной релизах. Например, если поведение устарело в pandas 1.2.0, оно будет продолжать работать с предупреждением во всех релизах серии 1.x. Поведение изменится, и устаревание будет удалено в следующем основном релизе (2.0.0).
Примечание
pandas иногда делает изменение поведения исправления ошибок, как часть минорных или патч-релизов. Является ли изменение исправлением ошибки или изменением, ломающим API, — это вопрос оценки. Мы сделаем всё возможное и приглашаем вас участвовать в обсуждении разработки в трекере проблем или в рассылке.
Эти политики не применяются к функциям, помеченным как экспериментальный в документации. pandas может изменить поведение экспериментальных функций в любое время.
Поддержка Python#
pandas отражает Рекомендации NumPy по поддержке Python.
Политика безопасности#
Чтобы сообщить об уязвимости безопасности в pandas, перейдите на pandas-dev/pandas и ознакомьтесь с инструкциями там.