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

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

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

作成日: 更新日:

基本的な使い方

__init_subclass__ メソッドは、SyntaxError クラスを継承して新しいサブクラスが定義された直後に自動的に実行されるメソッドです。このメソッドの主な目的は、作成されたサブクラスに対して初期設定を行ったり、特定の条件を満たしているかを検証したりすることにあります。例えば、サブクラスに特定の属性が定義されているかをチェックしたり、定義されたサブクラスを自動的に登録したりする用途に利用できます。このメソッドは、@classmethod デコレータを使用してクラスメソッドとして定義する必要があり、第一引数には新しく作成されたサブクラス自身が渡されます。これにより、メタクラスを直接使用することなく、クラスの作成プロセスを柔軟にカスタマイズし、サブクラスの振る舞いを統一的に管理することが可能になります。特に、フレームワークやライブラリ開発における継承を利用したクラス設計で役立つ機能です。

構文(syntax)

1class BaseClass:
2    def __init_subclass__(cls, /, **kwargs):
3        super().__init_subclass__(**kwargs)
4        # ここに、サブクラスが定義されたときに実行したい処理を記述します。
5        # cls は定義されたばかりのサブクラスそのものを指します。
6        # 例として、サブクラスの名前を出力します。
7        print(f"新しいサブクラス '{cls.__name__}' が定義されました。")
8
9class DerivedClass(BaseClass):
10    # DerivedClass が定義されると、BaseClass.__init_subclass__ が自動的に呼び出されます。
11    pass
12
13# プログラム実行時、DerivedClassの定義がインタープリタによって処理されると、
14# BaseClass.__init_subclass__ メソッド内のprint文が実行されます。
15# このメソッドはクラスのインスタンス化時ではなく、クラス自体が定義されたときに一度だけ呼び出されます。

引数(parameters)

cls: type, **kwargs

  • cls: type: このメソッドが呼び出されたクラス自身
  • **kwargs: Any: その他のキーワード引数

戻り値(return)

戻り値なし

戻り値はありません

関連コンテンツ