Pythonでは、共通のインターフェースを定義し、それを継承するクラスに特定のメソッドの実装を強制するために「抽象基底クラス (Abstract Base Classes, ABCs)」を利用できます。これは、Javaのような言語における抽象クラスと同様の概念です。抽象基底クラスは、それ自体を直接インスタンス化することはできず、具象クラスが従うべき「契約」や「設計のひな形」として機能します。

このアプローチは、以下のような点で開発に大きな利点をもたらします。

• インターフェースの一貫性: すべての派生クラスが必須メソッドを実装することを保証し、予測可能な動作を促進します。
• 多態性の実現: 基底クラスの型として異なる具象クラスのオブジェクトを扱うことで、柔軟なコード設計が可能になります。
• コードの再利用とモジュール化: 共通のロジックや振る舞いを抽象基底クラスに集約し、重複を避けます。
• 堅牢なアーキテクチャ: システム設計における依存関係を明確にし、拡張性のある構造を構築するのに役立ちます。

Pythonで抽象基底クラスを定義するには、主に二つの方法があります。一つは標準ライブラリのabc.ABCクラスを継承する方法、もう一つはABCMetaをメタクラスとして指定する方法です。いずれの方法でも、@abstractmethodデコレータを使用して抽象メソッドを宣言します。また、抽象プロパティを定義する際には、@propertyと@abstractmethodを組み合わせて使用します。

abc.ABCを継承する

最も一般的で簡潔な方法は、抽象クラスをabc.ABCから派生させることです。これにより、Pythonインタープリタが自動的にそのクラスを抽象基底クラスとして認識します。

from abc import ABC, abstractmethod

class DataProcessor(ABC):
    """データ処理のインターフェースを定義する抽象基底クラス"""

    @abstractmethod
    def process(self, raw_data: str) -> str:
        """
        生データを処理する抽象メソッド。
        すべての具象子クラスはこのメソッドを実装する必要がある。
        """
        pass

    @property
    @abstractmethod
    def processor_name(self) -> str:
        """
        プロセッサの名前を返す抽象プロパティ。
        """
        pass

# 具象クラスの例
class TextConverter(DataProcessor):
    def process(self, raw_data: str) -> str:
        # 例として文字列を大文字に変換する実装
        return raw_data.upper()

    @property
    def processor_name(self) -> str:
        return "TextConverter"

# 具象クラスのインスタンス化と利用
converter = TextConverter()
print(f"Processor: {converter.processor_name}, Result: {converter.process('hello python')}")

# DataProcessorを直接インスタンス化しようとするとTypeErrorが発生
# processor_base = DataProcessor() # TypeError: Can't instantiate abstract class DataProcessor with abstract methods process, processor_name

ABCMetaをメタクラスとして使用する

もう一つの方法は、クラス定義でmetaclass=ABCMetaを指定することです。これはabc.ABCを継承するのと同等の効果を持ち、クラスがどのように構築されるかをより明示的に示したい場合に有用です。

from abc import ABCMeta, abstractmethod

class ReportGenerator(metaclass=ABCMeta):
    """レポート生成機能のインターフェースを定義する抽象クラス"""

    @abstractmethod
    def generate_content(self) -> list[str]:
        """
        レポートの主要なコンテンツを生成する抽象メソッド。
        すべての具象クラスはこのメソッドを実装する必要がある。
        """
        pass

    @property
    @abstractmethod
    def output_format(self) -> str:
        """
        レポートの出力形式を定義する抽象プロパティ。
        """
        pass

# 具象クラスの例
class CsvReport(ReportGenerator):
    def generate_content(self) -> list[str]:
        # 例としてCSV形式の行データをリストで返す
        return ["Header1,Header2", "DataA,DataB", "DataC,DataD"]

    @property
    def output_format(self) -> str:
        return "CSV"

# 具象クラスのインスタンス化と利用
csv_reporter = CsvReport()
print(f"Report Format: {csv_reporter.output_format}, Content: {csv_reporter.generate_content()}")

抽象的な静的メソッドとクラスメソッド

抽象基底クラスでは、通常のインスタンスメソッドに加えて、抽象的な静的メソッド (@staticmethod) やクラスメソッド (@classmethod) も定義できます。これらは@abstractmethodをそれぞれのデコレータと組み合わせて使用することで実現します。

from abc import ABC, abstractmethod

class ConfigLoader(ABC):
    """設定情報をロードするための抽象ファクトリクラス"""

    @abstractmethod
    @staticmethod
    def load_from_file(filepath: str) -> dict:
        """
        指定されたファイルパスから設定を読み込む抽象静的メソッド。
        各具象ローダーが異なる形式（JSON, YAMLなど）に対応できる。
        """
        pass

    @abstractmethod
    @classmethod
    def get_supported_formats(cls) -> list[str]:
        """
        このローダーがサポートするファイル形式のリストを返す抽象クラスメソッド。
        """
        pass

# 具象クラスの例：JSON形式の設定ファイルを扱うローダー
class JsonConfigLoader(ConfigLoader):
    @staticmethod
    def load_from_file(filepath: str) -> dict:
        import json
        with open(filepath, 'r') as f:
            return json.load(f)

    @classmethod
    def get_supported_formats(cls) -> list[str]:
        return ["json"]

# 使用例
# ダミーのJSON設定ファイルを作成
with open("temp_config.json", "w") as f:
    f.write('{"api_key": "some_value", "timeout": 30}')

config_data = JsonConfigLoader.load_from_file("temp_config.json")
print(f"Loaded config: {config_data}")
print(f"Supported formats for JsonConfigLoader: {JsonConfigLoader.get_supported_formats()}")

仮想サブクラスの登録

特定のクラスが、ある抽象基底クラスのインターフェースを実装しているものの、直接それを継承していない場合があります。このような状況で、issubclass()やisinstance()のチェックが正しく機能するようにしたい場合、抽象基底クラスのregister()メソッドを使用してそのクラスを「仮想サブクラス」として登録できます。

from abc import ABC, abstractmethod

class EventPublisher(ABC):
    """イベントを発行するための抽象インターフェース"""

    @abstractmethod
    def publish(self, event_data: dict):
        """
        イベントデータを公開する抽象メソッド。
        """
        pass

    @abstractmethod
    def subscribe(self, handler):
        """
        イベントハンドラを登録する抽象メソッド。
        """
        pass

# 既存のクラス（EventPublisherを直接継承していないが、同じインターフェースを持つ）
class SimpleLogger:
    def publish(self, event_data: dict):
        print(f"Log event: {event_data}")

    def subscribe(self, handler):
        print(f"Handler {handler} subscribed to SimpleLogger.")

# SimpleLoggerをEventPublisherの仮想サブクラスとして登録
EventPublisher.register(SimpleLogger)

# 登録が成功したかを確認
print(f"SimpleLoggerはEventPublisherのサブクラスか？ {issubclass(SimpleLogger, EventPublisher)}")
logger_instance = SimpleLogger()
print(f"logger_instanceはEventPublisherのインスタンスか？ {isinstance(logger_instance, EventPublisher)}")

# 仮想サブクラスのメソッドを呼び出し
logger_instance.publish({"level": "INFO", "message": "System started"})