amulet-core 2.0a8__cp311-cp311-win_amd64.whl → 2.0.1a3.post250529101324__cp311-cp311-win_amd64.whl

amulet/level/java/anvil/_dimension.py

@@ -1,170 +0,0 @@
-from __future__ import annotations
-
-from typing import TypeAlias
-import os
-from collections.abc import Iterator, Sequence
-import re
-import threading
-
-from amulet_nbt import NamedTag
-
-from amulet.utils import world_utils
-from amulet.errors import ChunkDoesNotExist
-from amulet.data_types import (
-    ChunkCoordinates,
-    RegionCoordinates,
-)
-from ._region import AnvilRegion
-
-
-RawChunkType: TypeAlias = dict[str, NamedTag]
-
-
-class AnvilDimensionLayer:
-    """A class to manage a directory of region files."""
-
-    def __init__(self, directory: str, *, mcc: bool = False):
-        self._directory = directory
-        self._regions: dict[RegionCoordinates, AnvilRegion] = {}
-        self._mcc = mcc
-        self._lock = threading.RLock()
-
-    def _region_path(self, rx: int, rz: int) -> str:
-        """Get the file path for a region file."""
-        return os.path.join(self._directory, f"r.{rx}.{rz}.mca")
-
-    def _has_region(self, rx: int, rz: int) -> bool:
-        """Does a region file exist."""
-        return os.path.isfile(self._region_path(rx, rz))
-
-    def _get_region(self, rx: int, rz: int, create: bool = False) -> AnvilRegion:
-        with self._lock:
-            if (rx, rz) in self._regions:
-                return self._regions[(rx, rz)]
-            elif create or self._has_region(rx, rz):
-                region = self._regions[(rx, rz)] = AnvilRegion(
-                    self._region_path(rx, rz), mcc=self._mcc
-                )
-                return region
-            else:
-                raise ChunkDoesNotExist
-
-    def _iter_regions(self) -> Iterator[AnvilRegion]:
-        if os.path.isdir(self._directory):
-            for region_file_name in os.listdir(self._directory):
-                try:
-                    rx, rz = AnvilRegion.get_coords(region_file_name)
-                except ValueError:
-                    continue
-                else:
-                    yield self._get_region(rx, rz)
-
-    def all_chunk_coords(self) -> Iterator[ChunkCoordinates]:
-        for region in self._iter_regions():
-            yield from region.all_coords()
-
-    def has_chunk(self, cx: int, cz: int) -> bool:
-        try:
-            region = self._get_region(
-                *world_utils.chunk_coords_to_region_coords(cx, cz)
-            )
-        except ChunkDoesNotExist:
-            return False
-        else:
-            return region.has_data(cx, cz)
-
-    def get_chunk_data(self, cx: int, cz: int) -> NamedTag:
-        """
-        Get a NamedTag of a chunk from the database.
-        Will raise ChunkDoesNotExist if the region or chunk does not exist
-        """
-        # get the region key
-        return self._get_region(
-            *world_utils.chunk_coords_to_region_coords(cx, cz)
-        ).get_data(cx, cz)
-
-    def put_chunk_data(self, cx: int, cz: int, data: NamedTag) -> None:
-        """pass data to the region file class"""
-        self._get_region(
-            *world_utils.chunk_coords_to_region_coords(cx, cz), create=True
-        ).set_data(cx, cz, data)
-
-    def delete_chunk(self, cx: int, cz: int) -> None:
-        try:
-            region = self._get_region(
-                *world_utils.chunk_coords_to_region_coords(cx, cz)
-            )
-        except ChunkDoesNotExist:
-            pass
-        else:
-            region.delete_data(cx, cz)
-
-    def compact(self) -> None:
-        """Compact all region files in this layer"""
-        for region in self._iter_regions():
-            region.compact()
-
-
-class AnvilDimension:
-    """
-    A class to manage the data for a dimension.
-    This can consist of multiple layers. Eg the region layer which contains chunk data and the entities layer which contains entities.
-    """
-
-    level_regex = re.compile(r"DIM(?P<level>-?\d+)")
-
-    def __init__(
-        self, directory: str, *, mcc: bool = False, layers: Sequence[str] = ("region",)
-    ) -> None:
-        self._directory = directory
-        self._mcc = mcc
-        self.__layers: dict[str, AnvilDimensionLayer] = {
-            layer: AnvilDimensionLayer(
-                os.path.join(self._directory, layer), mcc=self._mcc
-            )
-            for layer in layers
-        }
-        self.__default_layer = self.__layers[layers[0]]
-
-    def all_chunk_coords(self) -> Iterator[ChunkCoordinates]:
-        yield from self.__default_layer.all_chunk_coords()
-
-    def has_chunk(self, cx: int, cz: int) -> bool:
-        return self.__default_layer.has_chunk(cx, cz)
-
-    def get_chunk_data(self, cx: int, cz: int) -> RawChunkType:
-        """Get the chunk data for each layer"""
-        chunk_data = {}
-        for layer_name, layer in self.__layers.items():
-            try:
-                chunk_data[layer_name] = layer.get_chunk_data(cx, cz)
-            except ChunkDoesNotExist:
-                pass
-
-        if chunk_data:
-            return chunk_data
-        else:
-            raise ChunkDoesNotExist
-
-    def put_chunk_data(self, cx: int, cz: int, data_layers: RawChunkType) -> None:
-        """Put one or more layers of data"""
-        for layer_name, data in data_layers.items():
-            if (
-                layer_name not in self.__layers
-                and layer_name.isalpha()
-                and layer_name.islower()
-            ):
-                self.__layers[layer_name] = AnvilDimensionLayer(
-                    os.path.join(self._directory, layer_name), mcc=self._mcc
-                )
-            if layer_name in self.__layers:
-                self.__layers[layer_name].put_chunk_data(cx, cz, data)
-
-    def delete_chunk(self, cx: int, cz: int) -> None:
-        for layer in self.__layers.values():
-            layer.delete_chunk(cx, cz)
-
-    def compact(self) -> None:
-        """Compact all region files in this dimension"""
-        for layer in self.__layers.values():
-            layer.compact()

amulet/level/java/anvil/_region.py

@@ -1,421 +0,0 @@
-from __future__ import annotations
-
-import os
-import struct
-import zlib
-import gzip
-from typing import BinaryIO
-from collections.abc import Iterator
-import numpy
-import time
-import re
-import threading
-import logging
-from enum import IntEnum
-
-import lz4.block as lz4_block  # type: ignore
-from amulet_nbt import NamedTag, read_nbt
-
-from amulet.errors import ChunkDoesNotExist, ChunkLoadError
-from amulet.data_types import ChunkCoordinates
-from ._sector_manager import SectorManager, Sector
-
-SectorSize = 0x1000
-MaxRegionSize = 255 * SectorSize  # the maximum size data in the region file can be
-HeaderSector = Sector(0, 0x2000)
-
-log = logging.getLogger(__name__)
-
-
-class RegionFileVersion(IntEnum):
-    VERSION_GZIP = 1
-    VERSION_DEFLATE = 2
-    VERSION_NONE = 3
-    VERSION_LZ4 = 4
-
-
-LZ4_HEADER = struct.Struct("<8sBiii")
-LZ4_MAGIC = b"LZ4Block"
-COMPRESSION_METHOD_RAW = 0x10
-COMPRESSION_METHOD_LZ4 = 0x20
-
-
-def _decompress_lz4(data: bytes) -> bytes:
-    """The LZ4 compression format is a sequence of LZ4 blocks with some header data."""
-    # https://github.com/lz4/lz4-java/blob/7c931bef32d179ec3d3286ee71638b23ebde3459/src/java/net/jpountz/lz4/LZ4BlockInputStream.java#L200
-    decompressed: list[bytes] = []
-    index = 0
-    while index < len(data):
-        magic, token, compressed_length, original_length, checksum = LZ4_HEADER.unpack(
-            data[index : index + LZ4_HEADER.size]
-        )
-        index += LZ4_HEADER.size
-        compression_method = token & 0xF0
-        if (
-            magic != LZ4_MAGIC
-            or original_length < 0
-            or compressed_length < 0
-            or (original_length == 0 and compressed_length != 0)
-            or (original_length != 0 and compressed_length == 0)
-            or (
-                compression_method == COMPRESSION_METHOD_RAW
-                and original_length != compressed_length
-            )
-        ):
-            raise ValueError("LZ4 compressed block is corrupted.")
-        if compression_method == COMPRESSION_METHOD_RAW:
-            decompressed.append(data[index : index + original_length])
-            index += original_length
-        elif compression_method == COMPRESSION_METHOD_LZ4:
-            decompressed.append(
-                lz4_block.decompress(
-                    data[index : index + compressed_length], original_length
-                )
-            )
-            index += compressed_length
-        else:
-            raise ValueError("LZ4 compressed block is corrupted.")
-    return b"".join(decompressed)
-
-
-def _compress(tag: NamedTag) -> bytes:
-    """Convert an NBTFile into a compressed bytes object"""
-    data = tag.save_to(compressed=False)
-    return b"\x02" + zlib.compress(data)
-
-
-def _decompress(data: bytes) -> NamedTag:
-    """Convert a bytes object into an NBTFile"""
-    compress_type, data = data[0], data[1:]
-    if compress_type == RegionFileVersion.VERSION_GZIP:
-        return read_nbt(gzip.decompress(data), compressed=False)
-    elif compress_type == RegionFileVersion.VERSION_DEFLATE:
-        return read_nbt(zlib.decompress(data), compressed=False)
-    elif compress_type == RegionFileVersion.VERSION_NONE:
-        return read_nbt(data, compressed=False)
-    elif compress_type == RegionFileVersion.VERSION_LZ4:
-        return read_nbt(_decompress_lz4(data), compressed=False)
-    raise ChunkLoadError(f"Invalid compression type {compress_type}")
-
-
-def _sanitise_file(handler: BinaryIO) -> None:
-    handler.seek(0, os.SEEK_END)
-    file_size = handler.tell()
-    if file_size & 0xFFF:
-        # ensure the file is a multiple of 4096 bytes
-        file_size = (file_size | 0xFFF) + 1
-        handler.truncate(file_size)
-
-    # if the length of the region file is less than 8KiB extend it to 8KiB
-    if file_size < SectorSize * 2:
-        file_size = SectorSize * 2
-        handler.truncate(file_size)
-
-
-class AnvilRegion:
-    """
-    A class to read and write Minecraft Java Edition Region files.
-    Only one class should exist per region file at any given time otherwise bad things may happen.
-    """
-
-    region_regex = re.compile(r"r\.(?P<rx>-?\d+)\.(?P<rz>-?\d+)\.mca")
-
-    __slots__ = (
-        "_path",
-        "_rx",
-        "_rz",
-        "_mcc",
-        "_sector_manager",
-        "_chunk_locations",
-        "_lock",
-    )
-
-    # The path to the region file
-    _path: str
-
-    # The region coordinates
-    _rx: int
-    _rz: int
-
-    # Is support for .mcc files enabled
-    _mcc: bool
-
-    # A class to track which sectors are reserved
-    _sector_manager: SectorManager | None
-
-    # A dictionary mapping the chunk coordinate to the location on disk
-    _chunk_locations: dict[ChunkCoordinates, Sector]
-
-    # A lock to limit access to multiple threads
-    _lock: threading.RLock
-
-    @classmethod
-    def get_coords(cls, file_path: str) -> tuple[int, int]:
-        """Parse a region file path to get the region coordinates."""
-        file_path = os.path.basename(file_path)
-        match = cls.region_regex.fullmatch(file_path)
-        if match is None:
-            raise ValueError(f"{file_path} is not a valid region file path.")
-        return int(match.group("rx")), int(match.group("rz"))
-
-    def __init__(self, file_path: str, *, mcc: bool = False) -> None:
-        """
-        A class wrapper for a region file
-        :param file_path: The file path of the region file
-        :param create: bool - if true will create the region from scratch. If false will try loading from disk
-        """
-        self._path = file_path
-        self._rx, self._rz = self.get_coords(file_path)
-        self._mcc = mcc  # create mcc file if the chunk is greater than 1MiB
-        self._sector_manager = None
-        self._chunk_locations = {}
-        self._lock = threading.RLock()
-
-    @property
-    def path(self) -> str:
-        """The file path to the region file."""
-        return self._path
-
-    @property
-    def rx(self) -> int:
-        """The region x coordinate."""
-        return self._rx
-
-    @property
-    def rz(self) -> int:
-        """The region z coordinate."""
-        return self._rz
-
-    def get_mcc_path(self, cx: int, cz: int) -> str:
-        """Get the mcc path. Coordinates are world chunk coordinates."""
-        return os.path.join(
-            os.path.dirname(self._path),
-            f"c.{cx}.{cz}.mcc",
-        )
-
-    def _load(self) -> None:
-        """Load region metadata. The lock must be acquired when calling this."""
-        if self._sector_manager is not None:
-            return
-
-        # Create the sector manager and ensure the header is not reservable
-        self._sector_manager = SectorManager(0, 0x2000)
-        self._sector_manager.reserve(HeaderSector)
-
-        if os.path.isfile(self._path):
-            # Load the file and populate the sector manager
-            with open(self._path, "rb+") as handler:
-                _sanitise_file(handler)
-                handler.seek(0)
-                location_table = numpy.fromfile(
-                    handler, dtype=">u4", count=1024
-                ).reshape(32, 32)
-                for (cz, cx), sector_data in numpy.ndenumerate(location_table):
-                    if sector_data:
-                        sector_offset = (sector_data >> 8) * 0x1000
-                        sector_size = (sector_data & 0xFF) * 0x1000
-                        sector = Sector(sector_offset, sector_offset + sector_size)
-                        self._sector_manager.reserve(sector)
-                        self._chunk_locations[
-                            (cx + self.rx * 32, cz + self.rz * 32)
-                        ] = sector
-
-    def all_coords(self) -> Iterator[ChunkCoordinates]:
-        """An iterable of chunk coordinates in world space."""
-        with self._lock:
-            self._load()
-            coords = list(self._chunk_locations)
-        yield from coords
-
-    def has_data(self, cx: int, cz: int) -> bool:
-        """Does the chunk exists. Coords are in world space."""
-        with self._lock:
-            self._load()
-            return (cx, cz) in self._chunk_locations
-
-    def get_data(self, cx: int, cz: int) -> NamedTag:
-        with self._lock:
-            self._load()
-            sector = self._chunk_locations.get((cx, cz))
-            if sector is None:
-                raise ChunkDoesNotExist
-            os.makedirs(os.path.dirname(self._path), exist_ok=True)
-            with open(self._path, "rb+") as handler:
-                _sanitise_file(handler)
-                handler.seek(0, os.SEEK_END)
-                if handler.tell() < sector.stop:
-                    # if the sector is beyond the end of the file
-                    raise ChunkDoesNotExist
-
-                handler.seek(sector.start)
-                buffer_size_bytes: bytes = handler.read(4)
-                buffer_size = struct.unpack(">I", buffer_size_bytes)[0]
-                buffer: bytes = handler.read(buffer_size)
-
-                if buffer:
-                    if buffer[0] & 128:  # if the "external" bit is set
-                        if self._mcc:
-                            mcc_path = self.get_mcc_path(cx, cz)
-                            if os.path.isfile(mcc_path):
-                                with open(mcc_path, "rb") as f:
-                                    return _decompress(
-                                        bytes([buffer[0] & 127]) + f.read()
-                                    )
-                    else:
-                        return _decompress(buffer)
-        raise ChunkDoesNotExist
-
-    def _write_data(self, cx: int, cz: int, data: bytes | None) -> None:
-        assert (
-            self.rx * 32 <= cx < (self.rx + 1) * 32
-            and self.rz * 32 <= cz < (self.rz + 1) * 32
-        )
-        if isinstance(data, bytes) and len(data) + 4 > MaxRegionSize and not self._mcc:
-            # if the data is too large and mcc files are not supported then do nothing
-            log.error(
-                f"Could not save data {cx},{cz} in region file {self._path} because it was too large."
-            )
-            return
-
-        with self._lock:
-            self._load()
-            sector_manager = self._sector_manager
-            assert sector_manager is not None
-            os.makedirs(os.path.dirname(self._path), exist_ok=True)
-            handler: BinaryIO
-            with open(
-                self._path, "rb+" if os.path.isfile(self._path) else "wb+"
-            ) as handler:
-                _sanitise_file(handler)
-
-                old_sector = self._chunk_locations.pop((cx, cz), None)
-                if old_sector is not None:
-                    # the chunk used to exist
-                    handler.seek(old_sector.start + 4)
-                    if self._mcc and handler.read(1)[0] & 127:
-                        # if the file is stored externally delete the file
-                        mcc_path = self.get_mcc_path(cx, cz)
-                        if os.path.isfile(mcc_path):
-                            os.remove(mcc_path)
-                    sector_manager.free(old_sector)
-
-                location = b"\x00\x00\x00\x00"
-
-                if isinstance(data, bytes):
-                    # find a memory location large enough to fit the data
-                    if len(data) + 4 > MaxRegionSize:
-                        # save externally (if mcc files are not supported the check at the top will filter large files out)
-                        with open(self.get_mcc_path(cx, cz), "wb") as mcc:
-                            mcc.write(data[1:])
-                        data = bytes([data[0] | 128])
-                    data = struct.pack(">I", len(data)) + data
-                    sector_length = len(data)
-                    if sector_length & 0xFFF:
-                        sector_length = (sector_length | 0xFFF) + 1
-                    sector = sector_manager.reserve_space(sector_length)
-                    assert sector.start & 0xFFF == 0
-                    self._chunk_locations[(cx, cz)] = sector
-                    location = struct.pack(
-                        ">I", (sector.start >> 4) + (sector_length >> 12)
-                    )
-                    handler.seek(sector.start)
-                    handler.write(data)
-                    _sanitise_file(handler)
-
-                # write the header data
-                handler.seek(4 * (cx - self.rx * 32 + (cz - self.rz * 32) * 32))
-                handler.write(location)
-                handler.seek(SectorSize - 4, os.SEEK_CUR)
-                handler.write(struct.pack(">I", int(time.time())))
-
-    def set_data(self, cx: int, cz: int, data: NamedTag) -> None:
-        """Write the data to the region file."""
-        bytes_data = _compress(data)
-        self._write_data(cx, cz, bytes_data)
-
-    def delete_data(self, cx: int, cz: int) -> None:
-        """Delete the data from the region file."""
-        self._write_data(cx, cz, None)
-
-    def compact(self) -> None:
-        """Compact the region file.
-        This moves all entries to the front of the file and deletes any unused space."""
-        with self._lock:
-            if not os.path.isfile(self._path):
-                # Do nothing if there is no file.
-                return
-
-            # All chunks in the region must be valid at all times.
-            # Load metadata
-            self._load()
-            sector_manager = self._sector_manager
-            assert sector_manager is not None
-
-            # Generate a list of sectors in sequential order
-            # location header index, chunk coordinate, sector
-            chunk_sectors: list[tuple[int, tuple[int, int], Sector]] = [
-                (4 * (cx - self.rx * 32 + (cz - self.rz * 32) * 32), (cx, cz), sector)
-                for (cx, cz), sector in sorted(
-                    self._chunk_locations.items(), key=lambda item: item[1].start
-                )
-            ]
-
-            # Set the position to the end of the header
-            file_position = HeaderSector.stop
-            # The end of the last chunk or the end of the header if no chunks exist.
-            if chunk_sectors:
-                file_end = chunk_sectors[-1][2].stop
-            else:
-                file_end = HeaderSector.stop
-
-            with open(self._path, "rb+") as handler:
-                while chunk_sectors:
-                    # While there are remaining sectors
-                    # Get the first sector
-                    header_index, chunk_coordinate, sector = chunk_sectors.pop(0)
-
-                    if file_position == sector.start:
-                        # There isn't any space before the sector. Do nothing.
-                        file_position = sector.stop
-                    else:
-                        # There is space before the sector
-                        if file_position + sector.length <= sector.start:
-                            # There is enough space before the sector to fit the whole sector.
-                            # Copy it to the new location
-                            new_sector = Sector(
-                                file_position, file_position + sector.length
-                            )
-                            file_position = new_sector.stop
-                        else:
-                            # There is space before the sector but not enough to fit the sector.
-                            # Move it to the end for processing later.
-                            new_sector = Sector(file_end, file_end + sector.length)
-                            file_end = new_sector.stop
-                            chunk_sectors.append(
-                                (header_index, chunk_coordinate, new_sector)
-                            )
-
-                        # Read in the data
-                        handler.seek(sector.start)
-                        data = handler.read(sector.length)
-
-                        # Reserve and write the data to the new sector
-                        sector_manager.reserve(new_sector)
-                        handler.seek(new_sector.start)
-                        handler.write(data)
-
-                        # Update the index
-                        handler.seek(header_index)
-                        handler.write(
-                            struct.pack(
-                                ">I",
-                                (new_sector.start >> 4) + (new_sector.length >> 12),
-                            )
-                        )
-                        self._chunk_locations[chunk_coordinate] = new_sector
-
-                        # Free the old sector
-                        sector_manager.free(sector)
-
-                # Delete any unused data at the end.
-                handler.truncate(file_position)