バージョン保証¶
このライブラリは セマンティック バージョニングの原則 に従います。それが意味するのは、互換性のないAPIの変更が行われるたびにメジャーバージョンが更新されるということです。しかしながら、Discord側にはPythonの非常に動的な性質とともに破壊的変更を行う際の保証がないため、破壊的変更とみなされるもの、そうでないものを区別するのは困難です。
最初に覚えておくべきことは、破壊的変更は 公開ドキュメント化してある関数とクラス のみに適用されるということです。ドキュメントにないものはパブリックAPIの一部ではないため、変更される可能性があります。これにはドキュメントに載っていないアンダースコアから始まる関数や、通常の関数が含まれます。
注釈
以下の例は網羅的なものではありません。
破壊的変更の例¶
デフォルトのパラメータ値を別のものに変更。
古い関数へのエイリアスのない関数の名称を変更。
イベントへのパラメータの追加、あるいは削除。
破壊的変更ではないものの例¶
アンダースコア付きのプライベート関数の追加、あるいは削除。
データクラスの
__slots__
への要素の追加。バグ修正のための関数の動作の変更。
ライブラリの型の動作の変更
主にコールバックとして使用される関数の呼び出し方法の変更
ドキュメントの変更。
内部HTTP処理の変更。
依存関係をメジャー、またはそれ以外の新しいバージョンへアップグレード。