ポリシー#

バージョンポリシー#

pandasでは、非推奨化、API互換性、バージョン番号管理に、セマンティックバージョニング(SemVer)の緩やかなバリエーションを使用しています。

pandasのリリース番号はMAJOR.MINOR.PATCHで構成されています。

APIの破壊的変更は、**メジャー**リリースでのみ行う必要があります。これらの変更は、何が変更され、なぜ変更されるのか、既存のコードを新しい動作に移行する方法について明確なガイダンスとともに文書化されます。

可能な限り、完全な破壊的変更ではなく、非推奨化パスが提供されます。

pandasは、**マイナー**リリースで非推奨化を導入します。これらの非推奨化では、既存の動作は維持されますが、以下のガイダンスを提供する警告が出力されます。

パッチリリースでは新しい非推奨化は導入しません。

非推奨化は**メジャー**リリースでのみ適用されます。たとえば、pandas 1.2.0で動作が非推奨になった場合、1.xシリーズのすべてのリリースで警告とともに動作し続けます。動作は次のメジャーリリース(2.0.0)で変更され、非推奨化は削除されます。

注記

pandasでは、マイナーまたはパッチリリースの一部として、動作変更のバグ修正を行う場合があります。変更がバグ修正であるか、APIの破壊的変更であるかは、判断が難しい場合があります。最善を尽くしますが、イシュートラッカーやメーリングリストでの開発に関する議論への参加を歓迎します。

これらのポリシーは、ドキュメントで**実験的**とマークされている機能には適用されません。pandasは、実験的機能の動作をいつでも変更する場合があります。

pandasへのセキュリティ脆弱性の報告は、pandas-dev/pandas にアクセスして、手順を確認してください。