Files
ess-helm/scripts/migration/interfaces.py
T
Gaël Goinvic 2000e09574 Migration: Interface refactoring for mypy fixes
- A recent mypy update seems to have caused all sort of new issues- this
fixes them
2026-03-05 17:38:43 +01:00

68 lines
1.7 KiB
Python

# Copyright 2026 Element Creations Ltd
#
# SPDX-License-Identifier: AGPL-3.0-only
"""
Interfaces for the migration system.
"""
from typing import Protocol, runtime_checkable
from .models import SecretConfig, TransformationSpec
@runtime_checkable
class MigrationStrategy(Protocol):
"""Interface for migration strategies."""
@property
def component_root_key(self) -> str:
"""Get the component root key (e.g., 'synapse', 'matrixAuthenticationService')."""
...
@property
def override_configs(self) -> set[str]:
"""Get component-specific override configurations."""
...
@property
def transformations(self) -> list[TransformationSpec]:
"""Get component-specific transformations."""
...
@runtime_checkable
class SecretDiscoveryStrategy(Protocol):
"""Minimal interface for secret discovery strategies."""
@property
def ess_secret_schema(self) -> dict[str, SecretConfig]:
"""Get the ESS secret schema for this component."""
...
@property
def component_name(self) -> str:
"""Get the component name for user-facing messages."""
...
@runtime_checkable
class ExtraFilesDiscoveryStrategy(Protocol):
"""Minimal interface for extra file discovery strategies."""
@property
def ignored_file_paths(self) -> list[str]:
"""Files paths to ignore when discovering extra files."""
...
@property
def ignored_config_keys(self) -> list[str]:
"""Config keys to ignore when discovering extra files."""
...
@property
def component_name(self) -> str:
"""Get the component name for user-facing messages."""
...