Python バージョン 3.5 では、コードを読みやすくし、開(kāi)発者がお互いのコードを理解しやすくするために「型ヒント」が導(dǎo)入されました。

型ヒントが重要なのはなぜですか?

Java や C などの強(qiáng)く型付けされた言語(yǔ)では、依存関係の反転 (DI - dependency Inversion) は重要な技術(shù)ですが、弱い型付けの言語(yǔ)では実裝が困難です。

依存関係の逆転の中心となる考え方は、クラスは特定の実裝ではなく抽象化に依存すべきであるということです。抽象化 (インターフェイスまたは抽象クラス) は比較的安定したコントラクトであるためです。

悪い例:

class GasStation:
    def fill_tank(car, amount):
        car.fill(amount)

この例では、ガソリン スタンドは車に給油することしかできません。さらに悪いことに、関數(shù) fill_tank には型が定義されていないため、任意の値が渡される可能性があり、エラーは実行時(shí)にのみ発見(jiàn)されます。

良い例:

from typing import Protocol

class Vehicle(Protocol):
    def fill(amount: int) -> None:
        ...
class GasStation:
    def fill_tank(vehicle: Vehicle, amount: int) -> None:
        vehicle.fill(amount)

この例では、最初に抽象クラス Vehicle を定義します (typing.Protocol を使用)。 GasStation の fill_tank 機(jī)能は、特定の自動(dòng)車クラスに依存するのではなく、Vehicle インターフェースに依存するようになり、より一般化され、fill メソッドを?qū)g裝するあらゆる車両に燃料を補(bǔ)給できます。

PyDIT とは何ですか?

私は Python の型ヒント システムを利用して、PyDIT (Python dependency Injection with Types) と呼ばれる依存関係反転の使用を簡(jiǎn)素化するライブラリを作成しました。

ユーザー データを保存するためのデータベース インターフェイスが必要であるとします。PostgreSQL、MySQL、OracleDB、インメモリ データベース、NoSQL データベースのいずれを使用する場(chǎng)合でも、データベース接続クラスを?qū)g裝し、レコードの読み取り、書(shū)き込み、削除の機(jī)能を提供する必要があります。 。

from time import sleep
from typing import TypedDict
from typing_extensions import override
from uuid import UUID
from src.configs.di import pydit
from src.adapters.repositories.interfaces.user import UserRepository
from src.constants.injection import MEMORY_REPOSITORY_CONFIG_TOKEN
from src.domain.user.models.user import UserModel


class ConfigType(TypedDict):
    delay: int


class MemoryUserRepository(UserRepository):

    __users: dict[UUID, UserModel] = {}

    def __init__(self):
        self.__delay = self.config.get("delay", 0.2)

    @pydit.inject(token=MEMORY_REPOSITORY_CONFIG_TOKEN)
    def config(self) -> ConfigType:  # TODO: supress return type error
        pass

    @override
    def get_by_id(self, *, id_: UUID) -> UserModel:
        sleep(self.__delay)

        user = self.__users.get(id_)

        if user is None:
            raise ValueError("User not found")

        return user

    @override
    def save(self, *, data: UserModel) -> None:
        sleep(self.__delay)
        self._check_pk_conflict(pk=data.id)

        self.__users[data.id] = data

    @override
    def list_(self) -> list[UserModel]:
        return list(self.__users.values())

    def _check_pk_conflict(self, *, pk: UUID) -> None:
        if pk not in self.__users:
            return

        raise ValueError("Primary key conflicts: DB alrady has a user with this ID")

コードがデータベース テクノロジと無(wú)関係であることを保証するために、すべてのデータベース クラスが従う必要があるインターフェイスを定義します。

from abc import abstractmethod
from typing import Protocol
from uuid import UUID
from src.domain.user.models.user import UserModel


class UserRepository(Protocol):
    @abstractmethod
    def get_by_id(self, *, id_: UUID) -> UserModel:
        pass

    @abstractmethod
    def save(self, *, data: UserModel) -> None:
        pass

    @abstractmethod
    def list_(self) -> list[UserModel]:
        pass

次に、注入用の依存関係を初期化します。

from src.adapters.repositories.in_memory.user import MemoryUserRepository
from src.constants.injection import MEMORY_REPOSITORY_CONFIG_TOKEN
from .di import pydit
from .get_db_config import get_db_config


def setup_dependencies():
    pydit.add_dependency(get_db_config, token=MEMORY_REPOSITORY_CONFIG_TOKEN)
    pydit.add_dependency(MemoryUserRepository, "UserRepository")

最後に、ユーザーを作成するモジュールに依存関係を挿入します。

from typing import cast
from src.adapters.repositories.interfaces.user import UserRepository
from src.configs.di import pydit
from src.domain.user.models.create_user import CreateUserModel
from src.domain.user.models.user import UserModel
from src.domain.user.services.create import CreateUserService
from src.domain.user.services.list import ListUsersService


class UserModule:
    @pydit.inject()
    def user_repository(self) -> UserRepository:
        return cast(UserRepository, None)

    def create(self, data: CreateUserModel) -> None:
        CreateUserService(self.user_repository).execute(data)

    def list_(self) -> list[UserModel]:
        return ListUsersService().execute()

依存関係はプロパティとして挿入され、 self または module.user_repository を介してアクセスできます。

この例は単純ですが、PyDIT はさまざまなプロジェクト構(gòu)成、コードの抽象化、および SOLID 原則のシナリオに適用できます。コードを試して貢獻(xiàn)することを歓迎します。

コードリポジトリ: Github
LinkedIn: マルセロ アルメイダ (MrM4rc)
PyPI: python-pydit

以上がPython での入力の影響の詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國(guó)語(yǔ) Web サイトの他の関連記事を參照してください。