150 lines
5.7 KiB
Python
150 lines
5.7 KiB
Python
from .packet_buffer import PacketBuffer
|
|
from zlib import compress
|
|
from minecraft.networking.types import (
|
|
VarInt, Enum
|
|
)
|
|
|
|
|
|
class Packet(object):
|
|
packet_name = "base"
|
|
id = None
|
|
definition = None
|
|
|
|
# To define the packet ID, either:
|
|
# 1. Define the attribute `id', of type int, in a subclass; or
|
|
# 2. Override `get_id' in a subclass and return the correct packet ID
|
|
# for the given ConnectionContext. This is necessary if the packet ID
|
|
# has changed across protocol versions, for example.
|
|
@classmethod
|
|
def get_id(cls, context):
|
|
return cls.id
|
|
|
|
# To define the network data layout of a packet, either:
|
|
# 1. Define the attribute `definition', a list of fields, each of which
|
|
# is a dict mapping attribute names to data types; or
|
|
# 2. Override `get_definition' in a subclass and return the correct
|
|
# definition for the given ConnectionContext. This may be necessary
|
|
# if the layout has changed across protocol versions, for example; or
|
|
# 3. Override the methods `read' and/or `write_fields' in a subclass.
|
|
# This may be necessary if the packet layout cannot be described as a
|
|
# simple list of fields.
|
|
@classmethod
|
|
def get_definition(cls, context):
|
|
return cls.definition
|
|
|
|
def __init__(self, context=None, **kwargs):
|
|
self.context = context
|
|
self.set_values(**kwargs)
|
|
|
|
@property
|
|
def context(self):
|
|
return self._context
|
|
|
|
@context.setter
|
|
def context(self, _context):
|
|
self._context = _context
|
|
self._context_changed()
|
|
|
|
def _context_changed(self):
|
|
if self._context is not None:
|
|
self.id = self.get_id(self._context)
|
|
self.definition = self.get_definition(self._context)
|
|
else:
|
|
self.id = None
|
|
self.definition = None
|
|
|
|
def set_values(self, **kwargs):
|
|
for key, value in kwargs.items():
|
|
setattr(self, key, value)
|
|
return self
|
|
|
|
def read(self, file_object):
|
|
for field in self.definition:
|
|
for var_name, data_type in field.items():
|
|
value = data_type.read(file_object)
|
|
setattr(self, var_name, value)
|
|
|
|
# Writes a packet buffer to the socket with the appropriate headers
|
|
# and compressing the data if necessary
|
|
def _write_buffer(self, socket, packet_buffer, compression_threshold):
|
|
# compression_threshold of None means compression is disabled
|
|
if compression_threshold is not None:
|
|
if len(packet_buffer.get_writable()) > compression_threshold != -1:
|
|
# compress the current payload
|
|
packet_data = packet_buffer.get_writable()
|
|
compressed_data = compress(packet_data)
|
|
packet_buffer.reset()
|
|
# write out the length of the uncompressed payload
|
|
VarInt.send(len(packet_data), packet_buffer)
|
|
# write the compressed payload itself
|
|
packet_buffer.send(compressed_data)
|
|
else:
|
|
# write out a 0 to indicate uncompressed data
|
|
packet_data = packet_buffer.get_writable()
|
|
packet_buffer.reset()
|
|
VarInt.send(0, packet_buffer)
|
|
packet_buffer.send(packet_data)
|
|
|
|
VarInt.send(len(packet_buffer.get_writable()), socket) # Packet Size
|
|
socket.send(packet_buffer.get_writable()) # Packet Payload
|
|
|
|
def write(self, socket, compression_threshold=None):
|
|
# buffer the data since we need to know the length of each packet's
|
|
# payload
|
|
packet_buffer = PacketBuffer()
|
|
# write packet's id right off the bat in the header
|
|
VarInt.send(self.id, packet_buffer)
|
|
# write every individual field
|
|
self.write_fields(packet_buffer)
|
|
self._write_buffer(socket, packet_buffer, compression_threshold)
|
|
|
|
def write_fields(self, packet_buffer):
|
|
# Write the fields comprising the body of the packet (excluding the
|
|
# length, packet ID, compression and encryption) into a PacketBuffer.
|
|
for field in self.definition:
|
|
for var_name, data_type in field.items():
|
|
data = getattr(self, var_name)
|
|
data_type.send(data, packet_buffer)
|
|
|
|
def __repr__(self):
|
|
str = type(self).__name__
|
|
if self.id is not None:
|
|
str = '0x%02X %s' % (self.id, str)
|
|
fields = self.fields
|
|
if fields is not None:
|
|
str = '%s(%s)' % (str, ', '.join('%s=%s' %
|
|
(a, self.field_string(a)) for a in fields))
|
|
return str
|
|
|
|
@property
|
|
def fields(self):
|
|
""" An iterable of the names of the packet's fields, or None. """
|
|
if self.definition is None:
|
|
return None
|
|
return (field for defn in self.definition for field in defn)
|
|
|
|
def field_string(self, field):
|
|
""" The string representation of the value of a the given named field
|
|
of this packet. Override to customise field value representation.
|
|
"""
|
|
value = getattr(self, field, None)
|
|
|
|
enum_class = self.field_enum(field)
|
|
if enum_class is not None:
|
|
name = enum_class.name_from_value(value)
|
|
if name is not None:
|
|
return name
|
|
|
|
return repr(value)
|
|
|
|
@classmethod
|
|
def field_enum(cls, field):
|
|
""" The subclass of 'minecraft.networking.types.Enum' associated with
|
|
this field, or None if there is no such class.
|
|
"""
|
|
enum_name = ''.join(s.capitalize() for s in field.split('_'))
|
|
if hasattr(cls, enum_name):
|
|
enum_class = getattr(cls, enum_name)
|
|
if isinstance(enum_class, type) and issubclass(enum_class, Enum):
|
|
return enum_class
|