Source code for efro.dataclassio.templatemultitype
# Released under the MIT License. See LICENSE for details.
#
"""Template for an IOMultitype setup.
To use this template, simply copy the contents of this module somewhere
and then replace 'TemplateMultiType' with 'YourType'.
"""
from __future__ import annotations
from typing import TYPE_CHECKING, assert_never, override
from enum import Enum
from dataclasses import dataclass
from efro.dataclassio import ioprepped, IOMultiType
if TYPE_CHECKING:
pass
[docs]
class TemplateMultiTypeTypeID(Enum):
"""Type ID for each of our subclasses."""
TEST = 'test'
[docs]
class TemplateMultiType(IOMultiType[TemplateMultiTypeTypeID]):
"""Top level class for our multitype."""
[docs]
@override
@classmethod
def get_type_id(cls) -> TemplateMultiTypeTypeID:
# Require child classes to supply this themselves. If we did a
# full type registry/lookup here it would require us to import
# everything and would prevent lazy loading.
raise NotImplementedError()
[docs]
@override
@classmethod
def get_type(
cls, type_id: TemplateMultiTypeTypeID
) -> type[TemplateMultiType]:
"""Return the subclass for each of our type-ids."""
# pylint: disable=cyclic-import
t = TemplateMultiTypeTypeID
if type_id is t.TEST:
return Test
# Important to make sure we provide all types.
assert_never(type_id)
[docs]
@ioprepped
@dataclass
class Test(TemplateMultiType):
"""Just a test."""
[docs]
@override
@classmethod
def get_type_id(cls) -> TemplateMultiTypeTypeID:
return TemplateMultiTypeTypeID.TEST
# Docs-generation hack; import some stuff that we likely only forward-declared
# in our actual source code so that docs tools can find it.
from typing import (Coroutine, Any, Literal, Callable,
Generator, Awaitable, Sequence, Self)
import asyncio
from concurrent.futures import Future
from pathlib import Path
from enum import Enum