Source code for eolib.protocol.net.server.effect_use_server_packet
# Generated from the eo-protocol XML specification.
#
# This file should not be modified.
# Changes will be lost when code is regenerated.
from typing import Union
from .map_effect import MapEffect
from ..packet_family import PacketFamily
from ..packet_action import PacketAction
from ....serialization_error import SerializationError
from ....net.packet import Packet
from .....data.eo_writer import EoWriter
from .....data.eo_reader import EoReader
[docs]
class EffectUseServerPacket(Packet):
"""
Map effect
"""
_byte_size: int = 0
_effect: MapEffect
_effect_data: 'EffectUseServerPacket.EffectData'
[docs]
def __init__(self, *, effect: MapEffect, effect_data: 'EffectUseServerPacket.EffectData' = None):
"""
Create a new instance of EffectUseServerPacket.
Args:
effect:
effect_data: Data associated with the `effect` field.
"""
self._effect = effect
self._effect_data = effect_data
@property
def byte_size(self) -> int:
"""
The size of the data that this was deserialized from.
"""
return self._byte_size
@property
def effect(self) -> MapEffect:
"""
The `effect` field.
"""
return self._effect
@property
def effect_data(self) -> 'EffectUseServerPacket.EffectData':
"""
Data associated with the `effect` field.
"""
return self._effect_data
[docs]
@staticmethod
def family() -> PacketFamily:
"""
Returns the packet family associated with this packet.
Returns:
The packet family associated with this packet.
"""
return PacketFamily.Effect
[docs]
@staticmethod
def action() -> PacketAction:
"""
Returns the packet action associated with this packet.
Returns:
The packet action associated with this packet.
"""
return PacketAction.Use
[docs]
def write(self, writer):
"""
Serializes and writes this packet to the provided EoWriter.
Args:
writer (EoWriter): the writer that this packet will be written to.
"""
EffectUseServerPacket.serialize(writer, self)
[docs]
@staticmethod
def serialize(writer: EoWriter, data: "EffectUseServerPacket") -> None:
"""
Serializes an instance of `EffectUseServerPacket` to the provided `EoWriter`.
Args:
writer (EoWriter): The writer that the data will be serialized to.
data (EffectUseServerPacket): The data to serialize.
"""
old_string_sanitization_mode: bool = writer.string_sanitization_mode
try:
if data._effect is None:
raise SerializationError("effect must be provided.")
writer.add_char(int(data._effect))
if data._effect == MapEffect.Quake:
if not isinstance(data._effect_data, EffectUseServerPacket.EffectDataQuake):
raise SerializationError("Expected effect_data to be type EffectUseServerPacket.EffectDataQuake for effect " + MapEffect(data._effect).name + ".")
EffectUseServerPacket.EffectDataQuake.serialize(writer, data._effect_data)
finally:
writer.string_sanitization_mode = old_string_sanitization_mode
[docs]
@staticmethod
def deserialize(reader: EoReader) -> "EffectUseServerPacket":
"""
Deserializes an instance of `EffectUseServerPacket` from the provided `EoReader`.
Args:
reader (EoReader): The writer that the data will be serialized to.
Returns:
The data to serialize.
"""
old_chunked_reading_mode: bool = reader.chunked_reading_mode
try:
reader_start_position: int = reader.position
effect = MapEffect(reader.get_char())
effect_data: EffectUseServerPacket.EffectData = None
if effect == MapEffect.Quake:
effect_data = EffectUseServerPacket.EffectDataQuake.deserialize(reader)
result = EffectUseServerPacket(effect=effect, effect_data=effect_data)
result._byte_size = reader.position - reader_start_position
return result
finally:
reader.chunked_reading_mode = old_chunked_reading_mode
def __repr__(self):
return f"EffectUseServerPacket(byte_size={repr(self._byte_size)}, effect={repr(self._effect)}, effect_data={repr(self._effect_data)})"
EffectData = Union['EffectUseServerPacket.EffectDataQuake', None]
"""
Data associated with different values of the `effect` field.
"""
[docs]
class EffectDataQuake:
"""
Data associated with effect value MapEffect.Quake
"""
_byte_size: int = 0
_quake_strength: int
[docs]
def __init__(self, *, quake_strength: int):
"""
Create a new instance of EffectUseServerPacket.EffectDataQuake.
Args:
quake_strength: (Value range is 0-252.)
"""
self._quake_strength = quake_strength
@property
def byte_size(self) -> int:
"""
The size of the data that this was deserialized from.
"""
return self._byte_size
@property
def quake_strength(self) -> int:
"""
The `quake_strength` field.
"""
return self._quake_strength
[docs]
@staticmethod
def serialize(writer: EoWriter, data: "EffectUseServerPacket.EffectDataQuake") -> None:
"""
Serializes an instance of `EffectUseServerPacket.EffectDataQuake` to the provided `EoWriter`.
Args:
writer (EoWriter): The writer that the data will be serialized to.
data (EffectUseServerPacket.EffectDataQuake): The data to serialize.
"""
old_string_sanitization_mode: bool = writer.string_sanitization_mode
try:
if data._quake_strength is None:
raise SerializationError("quake_strength must be provided.")
writer.add_char(data._quake_strength)
finally:
writer.string_sanitization_mode = old_string_sanitization_mode
[docs]
@staticmethod
def deserialize(reader: EoReader) -> "EffectUseServerPacket.EffectDataQuake":
"""
Deserializes an instance of `EffectUseServerPacket.EffectDataQuake` from the provided `EoReader`.
Args:
reader (EoReader): The writer that the data will be serialized to.
Returns:
The data to serialize.
"""
old_chunked_reading_mode: bool = reader.chunked_reading_mode
try:
reader_start_position: int = reader.position
quake_strength = reader.get_char()
result = EffectUseServerPacket.EffectDataQuake(quake_strength=quake_strength)
result._byte_size = reader.position - reader_start_position
return result
finally:
reader.chunked_reading_mode = old_chunked_reading_mode
def __repr__(self):
return f"EffectUseServerPacket.EffectDataQuake(byte_size={repr(self._byte_size)}, quake_strength={repr(self._quake_strength)})"