Библиотека классов Python: модульная структура и повторное использование кода

Расширенные примеры библиотеки классов с иерархией и паттернами

Рассмотрим библиотеку, реализующую систему плагинов. Будет использоваться абстрактный базовый класс, регистрация классов и динамическое создание объектов.

Пример 1: Абстрактный базовый класс для плагинов

Создадим пакет plugins с модулями base.py, plugin_a.py, __init__.py.

base.py:

from abc import ABC, abstractmethod
class Plugin(ABC):
    @abstractmethod
    def run(self, data):
        pass

class PluginMeta(type):
    """Метакласс, автоматически регистрирующий подклассы"""
    _registry = {}
    def __new__(mcs, name, bases, namespace):
        cls = super().__new__(mcs, name, bases, namespace)
        if not getattr(cls, '_abstract', False):  # не регистрировать ABC
            mcs._registry[name.lower()] = cls
        return cls
    @classmethod
    def get_plugin(mcs, name):
        return mcs._registry.get(name)

plugin_a.py:

from .base import Plugin, PluginMeta
class PluginA(Plugin, metaclass=PluginMeta):
    def run(self, data):
        return f"PluginA processed: {data}"

__init__.py:

from .base import Plugin, PluginMeta
from .plugin_a import PluginA
# При импорте PluginA регистрируется автоматически

Теперь можно получать плагин по имени:

from plugins import PluginMeta
pl_cls = PluginMeta.get_plugin('plugina')
if pl_cls:
    instance = pl_cls()
    print(instance.run('test'))

PluginA processed: test

Этот подход позволяет легко добавлять новые плагины - достаточно создать класс, наследующий от Plugin с метаклассом PluginMeta, и он автоматически регистрируется. Не требуется ручного добавления в реестр.

Пример 2: Композиция и делегирование в библиотеке геометрических фигур

Создадим классы, использующие композицию вместо глубокого наследования.

class Color:
    def __init__(self, rgb):
        self.rgb = rgb
    def __repr__(self):
        return f'Color({self.rgb})'

class Shape:
    def __init__(self, color):
        self.color = color

class Circle(Shape):
    def __init__(self, radius, color):
        super().__init__(color)
        self.radius = radius
    def area(self):
        return 3.14 * self.radius ** 2

# Использование
red = Color((255,0,0))
c = Circle(5, red)
print(c.color, c.area())

Color((255,0,0)) 78.5

Такая композиция упрощает тестирование и замену компонентов. Например, можно легко подменить цвет, не меняя форму.

Пример 3: Использование dataclasses для неизменяемых объектов библиотеки

Для представления данных (например, точки на плоскости) удобно использовать dataclass.

from dataclasses import dataclass

@dataclass(frozen=True)
class Point:
    x: float
    y: float

class Line:
    def __init__(self, start: Point, end: Point):
        self.start = start
        self.end = end
    def length(self):
        return ((self.end.x - self.start.x)**2 + (self.end.y - self.start.y)**2)**0.5

p1 = Point(0,0)
p2 = Point(3,4)
line = Line(p1, p2)
print(line.length())

5.0

Dataclasses автоматически генерируют методы __init__, __repr__, __eq__. Флаг frozen=True делает объекты хэшируемыми, что полезно для использования в множествах и словарях.

Пример 4: Менеджер контекста для работы с ресурсами в библиотеке

Реализуем класс, который управляет соединением с базой данных (упрощённо).

class DatabaseConnection:
    def __enter__(self):
        print("Opening connection...")
        self.conn = "connection_object"
        return self.conn
    def __exit__(self, exc_type, exc_val, exc_tb):
        print("Closing connection...")
        self.conn = None

# Использование
with DatabaseConnection() as conn:
    print(f"Working with {conn}")

Opening connection...
Working with connection_object
Closing connection...

Такой подход гарантирует освобождение ресурса даже при исключениях.