ポリシー

バージョンポリシー

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

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 にアクセスし、そこの指示を参照してください。