Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【Python3.x】type::__init_subclass__()メソッドの使い方

__init_subclass__メソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

__init_subclass__メソッドは、あるクラスが他のクラスのサブクラスとして定義される際に自動的に実行されるメソッドです。

このメソッドはPythonの全てのクラスの基底となるtypeクラスに定義されており、新しいサブクラスが生成される直前のフックとして機能します。具体的には、新たに定義されたサブクラス自身をcls引数として、そしてサブクラス定義時に親クラスに渡された任意のキーワード引数を**kwargs引数として受け取ります。

これにより、サブクラスが特定の条件を満たしているかの検証を行ったり、サブクラスに共通の属性や振る舞いを自動的に追加したりすることが可能になります。例えば、サブクラスが必ず特定の抽象メソッドを実装しているかを確認したり、アプリケーション内の特定のレジストリにサブクラスを登録したりする場面で利用されます。

このメソッドをオーバーライドする際には、継承チェーン全体にわたる適切な初期化を保証するため、必ずsuper().__init_subclass__(**kwargs)を呼び出すことが推奨されます。また、このメソッドはクラスのインスタンスが作成される時ではなく、クラス自体が定義される段階で一度だけ実行される点が重要です。

構文(syntax)

1class BaseClass:
2    def __init_subclass__(cls, default_name="Default", **kwargs):
3        super().__init_subclass__(**kwargs)
4        print(f"サブクラス '{cls.__name__}' が定義されました。")
5        print(f"  default_name 引数: '{default_name}'")
6        if kwargs:
7            print(f"  残りのキーワード引数: {kwargs}")
8
9class MySubClass(BaseClass):
10    pass
11
12class AnotherSubClass(BaseClass, default_name="Custom", priority=1):
13    pass

引数(parameters)

cls, **kwargs

  • cls: 新しく生成されるサブクラス
  • **kwargs: サブクラスの初期化時に渡される追加のキーワード引数

戻り値(return)

戻り値なし

戻り値はありません

関連コンテンツ