amulet-core 2.0a8__cp311-cp311-win_amd64.whl → 2.0.1.0.1297307203.19.43.34808.0a0__cp311-cp311-win_amd64.whl

amulet/game/abc/block.py

@@ -1,331 +0,0 @@
-from __future__ import annotations
-
-from abc import ABC, abstractmethod
-from typing import Callable, TYPE_CHECKING, TypeVar
-from collections.abc import Mapping, Collection
-from copy import deepcopy
-
-from amulet.block import Block
-from amulet.block_entity import BlockEntity
-from amulet.entity import Entity
-from amulet.data_types import BlockCoordinates
-from amulet.version import VersionNumber
-from amulet.game import get_game_version
-
-from ._block_specification import BlockSpec
-from .game_version_container import GameVersionContainer
-
-T = TypeVar("T")
-
-if TYPE_CHECKING:
-    from .version import GameVersion
-    from amulet.game.translate import (
-        BlockToUniversalTranslator,
-        BlockFromUniversalTranslator,
-    )
-
-
-class BlockTranslationError(Exception):
-    """An exception raised if the block could not be translated."""
-
-
-class BlockData(GameVersionContainer, ABC):
-    def __init__(
-        self,
-        game_version: GameVersion,
-        specification: Mapping[str, Mapping[str, BlockSpec]],
-    ) -> None:
-        super().__init__(game_version)
-        self._spec = specification
-
-    def __getstate__(self) -> dict:
-        state = super().__getstate__()
-        state["_spec"] = self._spec
-        return state
-
-    def __setstate__(self, state: dict) -> None:
-        super().__setstate__(state)
-        self._spec = state["_spec"]
-
-    def namespaces(self) -> Collection[str]:
-        """An iterable of all the valid block namespaces."""
-        return self._spec.keys()
-
-    def base_names(self, namespace: str) -> Collection[str]:
-        """An iterable of all valid base names for the given namespace."""
-        return self._spec[namespace].keys()
-
-    def get_specification(self, namespace: str, base_name: str) -> BlockSpec:
-        return self._spec[namespace][base_name]
-
-    def translate(
-        self,
-        target_platform: str,
-        target_version: VersionNumber,
-        block: Block,
-        block_entity: BlockEntity | None = None,
-        extra: (
-            tuple[
-                BlockCoordinates,
-                Callable[[BlockCoordinates], tuple[Block, BlockEntity | None]],
-            ]
-            | None
-        ) = None,
-    ) -> tuple[Block, BlockEntity | None, bool] | tuple[Entity, None, bool]:
-        """Translate a block from this version to the target version specified.
-
-        :param target_platform: The game platform to convert to.
-        :param target_version: The game version number to convert to.
-        :param block: The block to translate
-        :param block_entity: An optional block entity related to the block input
-        :param extra: An optional tuple containing the absolute coordinate of the block in the world and a callback
-            function taking a relative coordinate and returning the block and block entity at that coordinate.
-            This is required for cases where the neighbour block is required to fully define the state.
-            If the bool in the output is True this is required to fully define the translation.
-        :return: There are two formats that can be returned.
-            The first is a Block, optional BlockEntity and a bool.
-            The second is an Entity, None and a bool.
-            The bool specifies if block_location and get_block_callback are required to fully define the output data.
-        :raises:
-            ValueError: The arguments are incorrect. You did something wrong.
-            BlockTranslationError: The translator is not aware of the block. You should handle a sensible default.
-        """
-        target_game_version = get_game_version(target_platform, target_version)
-        universal_block, universal_block_entity, extra_needed = self.to_universal(
-            block, block_entity, extra
-        )
-        (
-            target_obj,
-            target_block_entity,
-            extra_needed2,
-        ) = target_game_version.block.from_universal(
-            target_platform,
-            target_version,
-            universal_block,
-            universal_block_entity,
-            extra,
-        )
-        if isinstance(target_obj, Block):
-            return target_obj, target_block_entity, extra_needed or extra_needed2
-        elif isinstance(target_obj, Entity):
-            return target_obj, None, extra_needed or extra_needed2
-        else:
-            raise RuntimeError
-
-    @abstractmethod
-    def to_universal(
-        self,
-        block: Block,
-        block_entity: BlockEntity | None,
-        extra: (
-            tuple[
-                BlockCoordinates,
-                Callable[[BlockCoordinates], tuple[Block, BlockEntity | None]],
-            ]
-            | None
-        ),
-    ) -> tuple[Block, BlockEntity | None, bool]:
-        """Convert a block to the universal format.
-
-        This method should be considered private.
-
-        :meta private:
-        :param block: The block to translate
-        :param block_entity: An optional block entity related to the block input
-        :param extra: An optional tuple containing the absolute coordinate of the block in the world and a callback
-            function taking a relative coordinate and returning the block and block entity at that coordinate.
-            This is required for cases where the neighbour block is required to fully define the state.
-            If the bool in the output is True this is required to fully define the translation.
-        :return: A Block, optional BlockEntity and a bool.
-            If the bool is True, the extra parameter is required to fully define the output data.
-        :raises:
-            ValueError: The arguments are incorrect. You did something wrong.
-            BlockTranslationError: The translator is not aware of the block. You should handle a sensible default.
-        """
-        raise NotImplementedError
-
-    @abstractmethod
-    def from_universal(
-        self,
-        target_platform: str,
-        target_version: VersionNumber,
-        block: Block,
-        block_entity: BlockEntity | None,
-        extra: (
-            tuple[
-                BlockCoordinates,
-                Callable[[BlockCoordinates], tuple[Block, BlockEntity | None]],
-            ]
-            | None
-        ),
-    ) -> tuple[Block, BlockEntity | None, bool] | tuple[Entity, None, bool]:
-        """Convert a block from the universal format.
-
-        This method should be considered private.
-
-        :meta private:
-        :param target_platform: The game platform to convert to.
-        :param target_version: The game version number to convert to.
-        :param block: The block to translate
-        :param block_entity: An optional block entity related to the block input
-        :param extra: An optional tuple containing the absolute coordinate of the block in the world and a callback
-            function taking a relative coordinate and returning the block and block entity at that coordinate.
-            This is required for cases where the neighbour block is required to fully define the state.
-            If the bool in the output is True this is required to fully define the translation.
-        :return: There are two formats that can be returned.
-            Block, optional BlockEntity and a bool.
-            Entity, None and a bool.
-            If the bool is True, the extra parameter is required to fully define the output data.
-        :raises:
-            ValueError: The arguments are incorrect. You did something wrong.
-            BlockTranslationError: The translator is not aware of the block. You should handle a sensible default.
-        """
-        raise NotImplementedError
-
-
-class DatabaseBlockData(BlockData, ABC):
-    _to_universal: Mapping[tuple[str, str], BlockToUniversalTranslator]
-    _from_universal: Mapping[tuple[str, str], BlockFromUniversalTranslator]
-    _to_universal_cache: dict[Block, tuple[Block, BlockEntity | None, bool]]
-    _from_universal_cache: dict[
-        tuple[Block, VersionNumber],
-        tuple[Block, BlockEntity | None, bool] | tuple[Entity, None, bool],
-    ]
-
-    def __init__(
-        self,
-        game_version: GameVersion,
-        specification: Mapping[str, Mapping[str, BlockSpec]],
-        to_universal: Mapping[tuple[str, str], BlockToUniversalTranslator],
-        from_universal: Mapping[tuple[str, str], BlockFromUniversalTranslator],
-    ) -> None:
-        super().__init__(game_version, specification)
-        self._to_universal = to_universal
-        self._from_universal = from_universal
-        # Cache computed results so we don't need to recompute unnecessarily.
-        self._to_universal_cache = {}
-        self._from_universal_cache = {}
-
-    def __getstate__(self) -> dict:
-        state = super().__getstate__()
-        state["_to_universal"] = self._to_universal
-        state["_from_universal"] = self._from_universal
-        return state
-
-    def __setstate__(self, state: dict) -> None:
-        super().__setstate__(state)
-        self._to_universal = state["_to_universal"]
-        self._from_universal = state["_from_universal"]
-        self._to_universal_cache = {}
-        self._from_universal_cache = {}
-
-    def to_universal(
-        self,
-        block: Block,
-        block_entity: BlockEntity | None,
-        extra: (
-            tuple[
-                BlockCoordinates,
-                Callable[[BlockCoordinates], tuple[Block, BlockEntity | None]],
-            ]
-            | None
-        ),
-    ) -> tuple[Block, BlockEntity | None, bool]:
-        if not self._game_version.supports_version(block.platform, block.version):
-            raise ValueError("The block is not compatible with this version")
-
-        if block_entity is None:
-            if block in self._to_universal_cache:
-                output, extra_output, extra_needed = self._to_universal_cache[block]
-                return output, deepcopy(extra_output), extra_needed
-        else:
-            block_entity = deepcopy(block_entity)
-
-        try:
-            translator = self._to_universal[(block.namespace, block.base_name)]
-        except KeyError:
-            raise BlockTranslationError(
-                f"Block {block} does not exist in version {self._game_version.platform} {self._game_version.min_version}"
-            )
-
-        output, extra_output, extra_needed, cacheable = translator.run(
-            block, block_entity, extra
-        )
-
-        if cacheable:
-            self._to_universal_cache[block] = output, extra_output, extra_needed
-
-        return output, deepcopy(extra_output), extra_needed
-
-    def from_universal(
-        self,
-        target_platform: str,
-        target_version: VersionNumber,
-        block: Block,
-        block_entity: BlockEntity | None,
-        extra: (
-            tuple[
-                BlockCoordinates,
-                Callable[[BlockCoordinates], tuple[Block, BlockEntity | None]],
-            ]
-            | None
-        ),
-    ) -> tuple[Block, BlockEntity | None, bool] | tuple[Entity, None, bool]:
-        if not self._game_version.supports_version(target_platform, target_version):
-            raise ValueError("The target version is not compatible with this version")
-
-        if block.platform != "universal":
-            raise ValueError("The source block is not in the universal format")
-
-        cache_token = (block, target_version)
-
-        if block_entity is None:
-            if cache_token in self._from_universal_cache:
-                output, extra_output, extra_needed = self._from_universal_cache[
-                    cache_token
-                ]
-                if isinstance(output, Block):
-                    return output, deepcopy(extra_output), extra_needed
-                elif isinstance(output, Entity):
-                    return deepcopy(output), None, extra_needed
-        else:
-            block_entity = deepcopy(block_entity)
-
-        try:
-            translator = self._from_universal[(block.namespace, block.base_name)]
-        except KeyError:
-            raise BlockTranslationError(
-                f"Block {block} does not exist in version {self._game_version.platform} {self._game_version.min_version}"
-            )
-
-        output, extra_output, extra_needed, cacheable = translator.run(
-            target_platform, target_version, block, block_entity, extra
-        )
-
-        if isinstance(output, Block):
-            if cacheable:
-                self._from_universal_cache[cache_token] = (
-                    output,
-                    deepcopy(extra_output),
-                    extra_needed,
-                )
-            return output, deepcopy(extra_output), extra_needed
-        elif isinstance(output, Entity):
-            if cacheable:
-                self._from_universal_cache[cache_token] = (
-                    deepcopy(output),
-                    None,
-                    extra_needed,
-                )
-            return deepcopy(output), None, extra_needed
-
-
-class BlockDataNumericalComponent(ABC):
-    @abstractmethod
-    def numerical_id_to_namespace_id(self, numerical_id: int) -> tuple[str, str]:
-        """Convert the numerical id to its namespace id"""
-        raise NotImplementedError
-
-    @abstractmethod
-    def namespace_id_to_numerical_id(self, namespace: str, base_name: str) -> int:
-        raise NotImplementedError

amulet/game/abc/game_version_container.py

@@ -1,25 +0,0 @@
-from __future__ import annotations
-
-from typing import TYPE_CHECKING
-from weakref import ref
-
-if TYPE_CHECKING:
-    from .version import GameVersion
-
-
-class GameVersionContainer:
-    def __init__(self, game_version: GameVersion):
-        self.__game_version_ref = ref(game_version)
-
-    @property
-    def _game_version(self) -> GameVersion:
-        game = self.__game_version_ref()
-        if game is None:
-            raise ReferenceError("Referenced GameVersion no longer exists.")
-        return game
-
-    def __getstate__(self) -> dict:
-        return {"_game_version": self._game_version}
-
-    def __setstate__(self, state: dict) -> None:
-        self.__game_version_ref = ref(state["_game_version"])

amulet/game/abc/json_interface.py

@@ -1,27 +0,0 @@
-from __future__ import annotations
-
-from abc import ABC, abstractmethod
-from typing import Self, Union, TypeAlias
-
-JSONCompatible: TypeAlias = Union[
-    str,
-    int,
-    float,
-    bool,
-    None,
-    "JSONList",
-    "JSONDict",
-]
-JSONDict: TypeAlias = dict[str, "JSONCompatible"]
-JSONList: TypeAlias = list["JSONCompatible"]
-
-
-class JSONInterface(ABC):
-    @classmethod
-    @abstractmethod
-    def from_json(cls, obj: JSONCompatible) -> Self:
-        raise NotImplementedError
-
-    @abstractmethod
-    def to_json(self) -> JSONCompatible:
-        raise NotImplementedError

amulet/game/abc/version.py

@@ -1,44 +0,0 @@
-from __future__ import annotations
-
-from typing import TYPE_CHECKING
-from abc import ABC, abstractmethod
-
-from amulet.version import VersionNumber
-
-if TYPE_CHECKING:
-    from .block import BlockData
-    from .biome import BiomeData
-
-
-class GameVersion(ABC):
-    @abstractmethod
-    def supports_version(self, platform: str, version: VersionNumber) -> bool:
-        raise NotImplementedError
-
-    @property
-    @abstractmethod
-    def platform(self) -> str:
-        """The platform string this instance is part of."""
-        raise NotImplementedError
-
-    @property
-    @abstractmethod
-    def min_version(self) -> VersionNumber:
-        """The minimum game version this instance can be used with."""
-        raise NotImplementedError
-
-    @property
-    @abstractmethod
-    def max_version(self) -> VersionNumber:
-        """The maximum game version this instance can be used with."""
-        raise NotImplementedError
-
-    @property
-    @abstractmethod
-    def block(self) -> BlockData:
-        raise NotImplementedError
-
-    @property
-    @abstractmethod
-    def biome(self) -> BiomeData:
-        raise NotImplementedError

amulet/game/bedrock/__init__.py

@@ -1 +0,0 @@
-from ._version import BedrockGameVersion

amulet/game/bedrock/_biome.py

@@ -1,35 +0,0 @@
-from collections.abc import Mapping, Collection
-
-from amulet.biome import Biome
-from amulet.game.abc import DatabaseBiomeData, BiomeDataNumericalComponent
-from amulet.game.abc import GameVersion
-
-
-class BedrockBiomeData(DatabaseBiomeData, BiomeDataNumericalComponent):
-    def __init__(
-        self,
-        game_version: GameVersion,
-        biomes: Mapping[str, Collection[str]],
-        to_universal: Mapping[tuple[str, str], Biome],
-        from_universal: Mapping[Biome, tuple[str, str]],
-        numerical_map: Mapping[int, tuple[str, str]],
-    ):
-        super().__init__(game_version, biomes, to_universal, from_universal)
-        self._num_to_str = numerical_map
-        self._str_to_num = {v: k for k, v in self._num_to_str.items()}
-
-    def __getstate__(self) -> dict:
-        state = super().__getstate__()
-        state["_num_to_str"] = self._num_to_str
-        return state
-
-    def __setstate__(self, state: dict) -> None:
-        super().__setstate__(state)
-        self._num_to_str = state["_num_to_str"]
-        self._str_to_num = {v: k for k, v in self._num_to_str.items()}
-
-    def numerical_id_to_namespace_id(self, numerical_id: int) -> tuple[str, str]:
-        return self._num_to_str[numerical_id]
-
-    def namespace_id_to_numerical_id(self, namespace: str, base_name: str) -> int:
-        return self._str_to_num[(namespace, base_name)]

amulet/game/bedrock/_block.py

@@ -1,42 +0,0 @@
-from collections.abc import Mapping
-
-from amulet.game.abc import (
-    DatabaseBlockData,
-    BlockDataNumericalComponent,
-    GameVersion,
-    BlockSpec,
-)
-from amulet.game.translate import (
-    BlockToUniversalTranslator,
-    BlockFromUniversalTranslator,
-)
-
-
-class BedrockBlockData(DatabaseBlockData, BlockDataNumericalComponent):
-    def __init__(
-        self,
-        game_version: GameVersion,
-        specification: Mapping[str, Mapping[str, BlockSpec]],
-        to_universal: Mapping[tuple[str, str], BlockToUniversalTranslator],
-        from_universal: Mapping[tuple[str, str], BlockFromUniversalTranslator],
-        numerical_map: Mapping[int, tuple[str, str]],
-    ):
-        super().__init__(game_version, specification, to_universal, from_universal)
-        self._num_to_str = numerical_map
-        self._str_to_num = {v: k for k, v in self._num_to_str.items()}
-
-    def __getstate__(self) -> dict:
-        state = super().__getstate__()
-        state["_num_to_str"] = self._num_to_str
-        return state
-
-    def __setstate__(self, state: dict) -> None:
-        super().__setstate__(state)
-        self._num_to_str = state["_num_to_str"]
-        self._str_to_num = {v: k for k, v in self._num_to_str.items()}
-
-    def numerical_id_to_namespace_id(self, numerical_id: int) -> tuple[str, str]:
-        return self._num_to_str[numerical_id]
-
-    def namespace_id_to_numerical_id(self, namespace: str, base_name: str) -> int:
-        return self._str_to_num[(namespace, base_name)]

amulet/game/bedrock/_version.py

@@ -1,165 +0,0 @@
-from __future__ import annotations
-from typing import Self
-import json
-import os
-
-from amulet.biome import Biome
-from amulet.game import get_game_version
-from amulet.game.abc import GameVersion, load_json_block_spec, load_json_biome_data
-from amulet.game.translate import (
-    BlockToUniversalTranslator,
-    BlockFromUniversalTranslator,
-    load_json_block_translations,
-)
-from amulet.version import VersionNumber
-
-from ._block import BedrockBlockData
-from ._biome import BedrockBiomeData
-
-
-class BedrockGameVersion(GameVersion):
-    _block: BedrockBlockData
-    _biome: BedrockBiomeData
-
-    def __init__(
-        self,
-        min_data_version: VersionNumber,
-        max_data_version: VersionNumber,
-        min_semantic_version: VersionNumber,
-        max_semantic_version: VersionNumber,
-    ) -> None:
-        """Do not use this."""
-        self._min_data_version = min_data_version
-        self._max_data_version = max_data_version
-        self._min_semantic_version = min_semantic_version
-        self._max_semantic_version = max_semantic_version
-
-    def supports_version(self, platform: str, version: VersionNumber) -> bool:
-        return platform == "bedrock" and (
-            self._min_data_version <= version <= self._max_data_version
-            or self._min_semantic_version <= version <= self._max_semantic_version
-        )
-
-    @classmethod
-    def from_json(cls, version_path: str) -> Self:
-        with open(os.path.join(version_path, "__init__.json")) as f:
-            init = json.load(f)
-        assert init["platform"] == "bedrock"
-        min_data_version = VersionNumber(init.get("data_version", -1))
-        max_data_version = VersionNumber(init.get("data_version_max", -1))
-        min_semantic_version = VersionNumber(*init["version"])
-        max_semantic_version = VersionNumber(*init["version_max"])
-
-        block_format = {
-            "numerical": "numerical",
-            "pseudo-numerical": "numerical",
-            "nbt-blockstate": "blockstate",
-        }[init["block_format"]]
-        universal_version = get_game_version("universal", VersionNumber(1))
-
-        self = cls(
-            min_data_version,
-            max_data_version,
-            min_semantic_version,
-            max_semantic_version,
-        )
-
-        # Load the block specification and translations
-        block_spec = load_json_block_spec(version_path, block_format)
-        block_to_universal = load_json_block_translations(
-            version_path,
-            block_format,
-            "to_universal",
-            BlockToUniversalTranslator,
-            lambda namespace, base_name: block_spec[namespace][base_name],
-            universal_version,
-        )
-        block_from_universal = load_json_block_translations(
-            version_path,
-            block_format,
-            "from_universal",
-            BlockFromUniversalTranslator,
-            universal_version.block.get_specification,
-            self,
-        )
-
-        numerical_block_map = {}
-        file_path = os.path.join(version_path, "__numerical_block_map__.json")
-        if os.path.isfile(file_path):
-            with open(file_path) as f:
-                block_map: dict[str, int] = json.load(f)
-            for block_str, block_num in block_map.items():
-                namespace, base_name = block_str.split(":", 1)
-                numerical_block_map[block_num] = (namespace, base_name)
-
-        self._block = BedrockBlockData(
-            self,
-            block_spec,
-            block_to_universal,
-            block_from_universal,
-            numerical_block_map,
-        )
-
-        biomes, to_universal, from_universal = load_json_biome_data(version_path)
-        biome_namespace = dict[str, list[str]]()
-        for namespace, base_name in biomes:
-            biome_namespace.setdefault(namespace, []).append(base_name)
-
-        self._biome = BedrockBiomeData(
-            self,
-            biome_namespace,
-            {
-                biome: Biome(
-                    "universal",
-                    VersionNumber(1),
-                    universal_namespace,
-                    universal_base_name,
-                )
-                for (
-                    biome,
-                    (universal_namespace, universal_base_name),
-                ) in to_universal.items()
-            },
-            {
-                Biome(
-                    "universal",
-                    VersionNumber(1),
-                    universal_namespace,
-                    universal_base_name,
-                ): biome
-                for (
-                    (universal_namespace, universal_base_name),
-                    biome,
-                ) in from_universal.items()
-            },
-            {
-                biome_id: biome
-                for biome, biome_id in biomes.items()
-                if biome_id is not None
-            },
-        )
-
-        return self
-
-    def __repr__(self) -> str:
-        return f"BedrockGameVersion({self.min_version!r})"
-
-    @property
-    def platform(self) -> str:
-        return "bedrock"
-
-    @property
-    def min_version(self) -> VersionNumber:
-        return self._min_semantic_version
-
-    @property
-    def max_version(self) -> VersionNumber:
-        return self._max_semantic_version
-
-    @property
-    def block(self) -> BedrockBlockData:
-        return self._block
-
-    @property
-    def biome(self) -> BedrockBiomeData:
-        return self._biome

amulet/game/java/__init__.py

@@ -1,2 +0,0 @@
-from ._version import JavaGameVersion
-from ._block import Waterloggable