diff options
Diffstat (limited to 'python/examples/kaitai/kaitai_struct_formats/archive')
6 files changed, 1363 insertions, 0 deletions
diff --git a/python/examples/kaitai/kaitai_struct_formats/archive/__init__.py b/python/examples/kaitai/kaitai_struct_formats/archive/__init__.py new file mode 100644 index 00000000..e69de29b --- /dev/null +++ b/python/examples/kaitai/kaitai_struct_formats/archive/__init__.py diff --git a/python/examples/kaitai/kaitai_struct_formats/archive/cpio_old_le.py b/python/examples/kaitai/kaitai_struct_formats/archive/cpio_old_le.py new file mode 100644 index 00000000..2b019d86 --- /dev/null +++ b/python/examples/kaitai/kaitai_struct_formats/archive/cpio_old_le.py @@ -0,0 +1,146 @@ +from __future__ import absolute_import +# This is a generated file! Please edit source .ksy file and use kaitai-struct-compiler to rebuild + +from pkg_resources import parse_version +from ...kaitaistruct import __version__ as ks_version, KaitaiStruct, KaitaiStream, BytesIO +import collections + + +if parse_version(ks_version) < parse_version('0.7'): + raise Exception("Incompatible Kaitai Struct Python API: 0.7 or later is required, but you have %s" % (ks_version)) + +class CpioOldLe(KaitaiStruct): + SEQ_FIELDS = ["files"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['files']['start'] = self._io.pos() + self.files = [] + i = 0 + while not self._io.is_eof(): + if not 'arr' in self._debug['files']: + self._debug['files']['arr'] = [] + self._debug['files']['arr'].append({'start': self._io.pos()}) + _t_files = self._root.File(self._io, self, self._root) + _t_files._read() + self.files.append(_t_files) + self._debug['files']['arr'][len(self.files) - 1]['end'] = self._io.pos() + i += 1 + + self._debug['files']['end'] = self._io.pos() + + class File(KaitaiStruct): + SEQ_FIELDS = ["header", "path_name", "string_terminator", "path_name_padding", "file_data", "file_data_padding", "end_of_file_padding"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['header']['start'] = self._io.pos() + self.header = self._root.FileHeader(self._io, self, self._root) + self.header._read() + self._debug['header']['end'] = self._io.pos() + self._debug['path_name']['start'] = self._io.pos() + self.path_name = self._io.read_bytes((self.header.path_name_size - 1)) + self._debug['path_name']['end'] = self._io.pos() + self._debug['string_terminator']['start'] = self._io.pos() + self.string_terminator = self._io.ensure_fixed_contents(b"\x00") + self._debug['string_terminator']['end'] = self._io.pos() + if (self.header.path_name_size % 2) == 1: + self._debug['path_name_padding']['start'] = self._io.pos() + self.path_name_padding = self._io.ensure_fixed_contents(b"\x00") + self._debug['path_name_padding']['end'] = self._io.pos() + + self._debug['file_data']['start'] = self._io.pos() + self.file_data = self._io.read_bytes(self.header.file_size.value) + self._debug['file_data']['end'] = self._io.pos() + if (self.header.file_size.value % 2) == 1: + self._debug['file_data_padding']['start'] = self._io.pos() + self.file_data_padding = self._io.ensure_fixed_contents(b"\x00") + self._debug['file_data_padding']['end'] = self._io.pos() + + if ((self.path_name == b"\x54\x52\x41\x49\x4C\x45\x52\x21\x21\x21") and (self.header.file_size.value == 0)) : + self._debug['end_of_file_padding']['start'] = self._io.pos() + self.end_of_file_padding = self._io.read_bytes_full() + self._debug['end_of_file_padding']['end'] = self._io.pos() + + + + class FileHeader(KaitaiStruct): + SEQ_FIELDS = ["magic", "device_number", "inode_number", "mode", "user_id", "group_id", "number_of_links", "r_device_number", "modification_time", "path_name_size", "file_size"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['magic']['start'] = self._io.pos() + self.magic = self._io.ensure_fixed_contents(b"\xC7\x71") + self._debug['magic']['end'] = self._io.pos() + self._debug['device_number']['start'] = self._io.pos() + self.device_number = self._io.read_u2le() + self._debug['device_number']['end'] = self._io.pos() + self._debug['inode_number']['start'] = self._io.pos() + self.inode_number = self._io.read_u2le() + self._debug['inode_number']['end'] = self._io.pos() + self._debug['mode']['start'] = self._io.pos() + self.mode = self._io.read_u2le() + self._debug['mode']['end'] = self._io.pos() + self._debug['user_id']['start'] = self._io.pos() + self.user_id = self._io.read_u2le() + self._debug['user_id']['end'] = self._io.pos() + self._debug['group_id']['start'] = self._io.pos() + self.group_id = self._io.read_u2le() + self._debug['group_id']['end'] = self._io.pos() + self._debug['number_of_links']['start'] = self._io.pos() + self.number_of_links = self._io.read_u2le() + self._debug['number_of_links']['end'] = self._io.pos() + self._debug['r_device_number']['start'] = self._io.pos() + self.r_device_number = self._io.read_u2le() + self._debug['r_device_number']['end'] = self._io.pos() + self._debug['modification_time']['start'] = self._io.pos() + self.modification_time = self._root.FourByteUnsignedInteger(self._io, self, self._root) + self.modification_time._read() + self._debug['modification_time']['end'] = self._io.pos() + self._debug['path_name_size']['start'] = self._io.pos() + self.path_name_size = self._io.read_u2le() + self._debug['path_name_size']['end'] = self._io.pos() + self._debug['file_size']['start'] = self._io.pos() + self.file_size = self._root.FourByteUnsignedInteger(self._io, self, self._root) + self.file_size._read() + self._debug['file_size']['end'] = self._io.pos() + + + class FourByteUnsignedInteger(KaitaiStruct): + SEQ_FIELDS = ["most_significant_bits", "least_significant_bits"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['most_significant_bits']['start'] = self._io.pos() + self.most_significant_bits = self._io.read_u2le() + self._debug['most_significant_bits']['end'] = self._io.pos() + self._debug['least_significant_bits']['start'] = self._io.pos() + self.least_significant_bits = self._io.read_u2le() + self._debug['least_significant_bits']['end'] = self._io.pos() + + @property + def value(self): + if hasattr(self, '_m_value'): + return self._m_value if hasattr(self, '_m_value') else None + + self._m_value = (self.least_significant_bits + (self.most_significant_bits << 16)) + return self._m_value if hasattr(self, '_m_value') else None + + + diff --git a/python/examples/kaitai/kaitai_struct_formats/archive/gzip.py b/python/examples/kaitai/kaitai_struct_formats/archive/gzip.py new file mode 100644 index 00000000..b233cff2 --- /dev/null +++ b/python/examples/kaitai/kaitai_struct_formats/archive/gzip.py @@ -0,0 +1,230 @@ +from __future__ import absolute_import +# This is a generated file! Please edit source .ksy file and use kaitai-struct-compiler to rebuild + +from pkg_resources import parse_version +from ...kaitaistruct import __version__ as ks_version, KaitaiStruct, KaitaiStream, BytesIO +from enum import Enum +import collections + + +if parse_version(ks_version) < parse_version('0.7'): + raise Exception("Incompatible Kaitai Struct Python API: 0.7 or later is required, but you have %s" % (ks_version)) + +class Gzip(KaitaiStruct): + """Gzip is a popular and standard single-file archiving format. It + essentially provides a container that stores original file name, + timestamp and a few other things (like optional comment), basic + CRCs, etc, and a file compressed by a chosen compression algorithm. + + As of 2019, there is actually only one working solution for + compression algorithms, so it's typically raw DEFLATE stream + (without zlib header) in all gzipped files. + + .. seealso:: + Source - https://tools.ietf.org/html/rfc1952 + """ + + class CompressionMethods(Enum): + deflate = 8 + + class Oses(Enum): + fat = 0 + amiga = 1 + vms = 2 + unix = 3 + vm_cms = 4 + atari_tos = 5 + hpfs = 6 + macintosh = 7 + z_system = 8 + cp_m = 9 + tops_20 = 10 + ntfs = 11 + qdos = 12 + acorn_riscos = 13 + unknown = 255 + SEQ_FIELDS = ["magic", "compression_method", "flags", "mod_time", "extra_flags", "os", "extras", "name", "comment", "header_crc16", "body", "body_crc32", "len_uncompressed"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['magic']['start'] = self._io.pos() + self.magic = self._io.ensure_fixed_contents(b"\x1F\x8B") + self._debug['magic']['end'] = self._io.pos() + self._debug['compression_method']['start'] = self._io.pos() + self.compression_method = KaitaiStream.resolve_enum(self._root.CompressionMethods, self._io.read_u1()) + self._debug['compression_method']['end'] = self._io.pos() + self._debug['flags']['start'] = self._io.pos() + self.flags = self._root.Flags(self._io, self, self._root) + self.flags._read() + self._debug['flags']['end'] = self._io.pos() + self._debug['mod_time']['start'] = self._io.pos() + self.mod_time = self._io.read_u4le() + self._debug['mod_time']['end'] = self._io.pos() + self._debug['extra_flags']['start'] = self._io.pos() + _on = self.compression_method + if _on == self._root.CompressionMethods.deflate: + self.extra_flags = self._root.ExtraFlagsDeflate(self._io, self, self._root) + self.extra_flags._read() + self._debug['extra_flags']['end'] = self._io.pos() + self._debug['os']['start'] = self._io.pos() + self.os = KaitaiStream.resolve_enum(self._root.Oses, self._io.read_u1()) + self._debug['os']['end'] = self._io.pos() + if self.flags.has_extra: + self._debug['extras']['start'] = self._io.pos() + self.extras = self._root.Extras(self._io, self, self._root) + self.extras._read() + self._debug['extras']['end'] = self._io.pos() + + if self.flags.has_name: + self._debug['name']['start'] = self._io.pos() + self.name = self._io.read_bytes_term(0, False, True, True) + self._debug['name']['end'] = self._io.pos() + + if self.flags.has_comment: + self._debug['comment']['start'] = self._io.pos() + self.comment = self._io.read_bytes_term(0, False, True, True) + self._debug['comment']['end'] = self._io.pos() + + if self.flags.has_header_crc: + self._debug['header_crc16']['start'] = self._io.pos() + self.header_crc16 = self._io.read_u2le() + self._debug['header_crc16']['end'] = self._io.pos() + + self._debug['body']['start'] = self._io.pos() + self.body = self._io.read_bytes(((self._io.size() - self._io.pos()) - 8)) + self._debug['body']['end'] = self._io.pos() + self._debug['body_crc32']['start'] = self._io.pos() + self.body_crc32 = self._io.read_u4le() + self._debug['body_crc32']['end'] = self._io.pos() + self._debug['len_uncompressed']['start'] = self._io.pos() + self.len_uncompressed = self._io.read_u4le() + self._debug['len_uncompressed']['end'] = self._io.pos() + + class Flags(KaitaiStruct): + SEQ_FIELDS = ["reserved1", "has_comment", "has_name", "has_extra", "has_header_crc", "is_text"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['reserved1']['start'] = self._io.pos() + self.reserved1 = self._io.read_bits_int(3) + self._debug['reserved1']['end'] = self._io.pos() + self._debug['has_comment']['start'] = self._io.pos() + self.has_comment = self._io.read_bits_int(1) != 0 + self._debug['has_comment']['end'] = self._io.pos() + self._debug['has_name']['start'] = self._io.pos() + self.has_name = self._io.read_bits_int(1) != 0 + self._debug['has_name']['end'] = self._io.pos() + self._debug['has_extra']['start'] = self._io.pos() + self.has_extra = self._io.read_bits_int(1) != 0 + self._debug['has_extra']['end'] = self._io.pos() + self._debug['has_header_crc']['start'] = self._io.pos() + self.has_header_crc = self._io.read_bits_int(1) != 0 + self._debug['has_header_crc']['end'] = self._io.pos() + self._debug['is_text']['start'] = self._io.pos() + self.is_text = self._io.read_bits_int(1) != 0 + self._debug['is_text']['end'] = self._io.pos() + + + class ExtraFlagsDeflate(KaitaiStruct): + + class CompressionStrengths(Enum): + best = 2 + fast = 4 + SEQ_FIELDS = ["compression_strength"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['compression_strength']['start'] = self._io.pos() + self.compression_strength = KaitaiStream.resolve_enum(self._root.ExtraFlagsDeflate.CompressionStrengths, self._io.read_u1()) + self._debug['compression_strength']['end'] = self._io.pos() + + + class Subfields(KaitaiStruct): + """Container for many subfields, constrained by size of stream. + """ + SEQ_FIELDS = ["entries"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['entries']['start'] = self._io.pos() + self.entries = [] + i = 0 + while not self._io.is_eof(): + if not 'arr' in self._debug['entries']: + self._debug['entries']['arr'] = [] + self._debug['entries']['arr'].append({'start': self._io.pos()}) + _t_entries = self._root.Subfield(self._io, self, self._root) + _t_entries._read() + self.entries.append(_t_entries) + self._debug['entries']['arr'][len(self.entries) - 1]['end'] = self._io.pos() + i += 1 + + self._debug['entries']['end'] = self._io.pos() + + + class Subfield(KaitaiStruct): + """Every subfield follows typical [TLV scheme](https://en.wikipedia.org/wiki/Type-length-value): + + * `id` serves role of "T"ype + * `len_data` serves role of "L"ength + * `data` serves role of "V"alue + + This way it's possible to for arbitrary parser to skip over + subfields it does not support. + """ + SEQ_FIELDS = ["id", "len_data", "data"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['id']['start'] = self._io.pos() + self.id = self._io.read_u2le() + self._debug['id']['end'] = self._io.pos() + self._debug['len_data']['start'] = self._io.pos() + self.len_data = self._io.read_u2le() + self._debug['len_data']['end'] = self._io.pos() + self._debug['data']['start'] = self._io.pos() + self.data = self._io.read_bytes(self.len_data) + self._debug['data']['end'] = self._io.pos() + + + class Extras(KaitaiStruct): + SEQ_FIELDS = ["len_subfields", "subfields"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['len_subfields']['start'] = self._io.pos() + self.len_subfields = self._io.read_u2le() + self._debug['len_subfields']['end'] = self._io.pos() + self._debug['subfields']['start'] = self._io.pos() + self._raw_subfields = self._io.read_bytes(self.len_subfields) + io = KaitaiStream(BytesIO(self._raw_subfields)) + self.subfields = self._root.Subfields(io, self, self._root) + self.subfields._read() + self._debug['subfields']['end'] = self._io.pos() + + + diff --git a/python/examples/kaitai/kaitai_struct_formats/archive/lzh.py b/python/examples/kaitai/kaitai_struct_formats/archive/lzh.py new file mode 100644 index 00000000..8f9b75ea --- /dev/null +++ b/python/examples/kaitai/kaitai_struct_formats/archive/lzh.py @@ -0,0 +1,161 @@ +from __future__ import absolute_import +# This is a generated file! Please edit source .ksy file and use kaitai-struct-compiler to rebuild + +from pkg_resources import parse_version +from ...kaitaistruct import __version__ as ks_version, KaitaiStruct, KaitaiStream, BytesIO +import collections + + +if parse_version(ks_version) < parse_version('0.7'): + raise Exception("Incompatible Kaitai Struct Python API: 0.7 or later is required, but you have %s" % (ks_version)) + +class Lzh(KaitaiStruct): + """LHA (LHarc, LZH) is a file format used by a popular freeware + eponymous archiver, created in 1988 by Haruyasu Yoshizaki. Over the + years, many ports and implementations were developed, sporting many + extensions to original 1988 LZH. + + File format is pretty simple and essentially consists of a stream of + records. + """ + SEQ_FIELDS = ["entries"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['entries']['start'] = self._io.pos() + self.entries = [] + i = 0 + while not self._io.is_eof(): + if not 'arr' in self._debug['entries']: + self._debug['entries']['arr'] = [] + self._debug['entries']['arr'].append({'start': self._io.pos()}) + _t_entries = self._root.Record(self._io, self, self._root) + _t_entries._read() + self.entries.append(_t_entries) + self._debug['entries']['arr'][len(self.entries) - 1]['end'] = self._io.pos() + i += 1 + + self._debug['entries']['end'] = self._io.pos() + + class Record(KaitaiStruct): + SEQ_FIELDS = ["header_len", "file_record"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['header_len']['start'] = self._io.pos() + self.header_len = self._io.read_u1() + self._debug['header_len']['end'] = self._io.pos() + if self.header_len > 0: + self._debug['file_record']['start'] = self._io.pos() + self.file_record = self._root.FileRecord(self._io, self, self._root) + self.file_record._read() + self._debug['file_record']['end'] = self._io.pos() + + + + class FileRecord(KaitaiStruct): + SEQ_FIELDS = ["header", "file_uncompr_crc16", "body"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['header']['start'] = self._io.pos() + self._raw_header = self._io.read_bytes((self._parent.header_len - 1)) + io = KaitaiStream(BytesIO(self._raw_header)) + self.header = self._root.Header(io, self, self._root) + self.header._read() + self._debug['header']['end'] = self._io.pos() + if self.header.header1.lha_level == 0: + self._debug['file_uncompr_crc16']['start'] = self._io.pos() + self.file_uncompr_crc16 = self._io.read_u2le() + self._debug['file_uncompr_crc16']['end'] = self._io.pos() + + self._debug['body']['start'] = self._io.pos() + self.body = self._io.read_bytes(self.header.header1.file_size_compr) + self._debug['body']['end'] = self._io.pos() + + + class Header(KaitaiStruct): + SEQ_FIELDS = ["header1", "filename_len", "filename", "file_uncompr_crc16", "os", "ext_header_size"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['header1']['start'] = self._io.pos() + self.header1 = self._root.Header1(self._io, self, self._root) + self.header1._read() + self._debug['header1']['end'] = self._io.pos() + if self.header1.lha_level == 0: + self._debug['filename_len']['start'] = self._io.pos() + self.filename_len = self._io.read_u1() + self._debug['filename_len']['end'] = self._io.pos() + + if self.header1.lha_level == 0: + self._debug['filename']['start'] = self._io.pos() + self.filename = (self._io.read_bytes(self.filename_len)).decode(u"ASCII") + self._debug['filename']['end'] = self._io.pos() + + if self.header1.lha_level == 2: + self._debug['file_uncompr_crc16']['start'] = self._io.pos() + self.file_uncompr_crc16 = self._io.read_u2le() + self._debug['file_uncompr_crc16']['end'] = self._io.pos() + + if self.header1.lha_level == 2: + self._debug['os']['start'] = self._io.pos() + self.os = self._io.read_u1() + self._debug['os']['end'] = self._io.pos() + + if self.header1.lha_level == 2: + self._debug['ext_header_size']['start'] = self._io.pos() + self.ext_header_size = self._io.read_u2le() + self._debug['ext_header_size']['end'] = self._io.pos() + + + + class Header1(KaitaiStruct): + SEQ_FIELDS = ["header_checksum", "method_id", "file_size_compr", "file_size_uncompr", "file_timestamp", "attr", "lha_level"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['header_checksum']['start'] = self._io.pos() + self.header_checksum = self._io.read_u1() + self._debug['header_checksum']['end'] = self._io.pos() + self._debug['method_id']['start'] = self._io.pos() + self.method_id = (self._io.read_bytes(5)).decode(u"ASCII") + self._debug['method_id']['end'] = self._io.pos() + self._debug['file_size_compr']['start'] = self._io.pos() + self.file_size_compr = self._io.read_u4le() + self._debug['file_size_compr']['end'] = self._io.pos() + self._debug['file_size_uncompr']['start'] = self._io.pos() + self.file_size_uncompr = self._io.read_u4le() + self._debug['file_size_uncompr']['end'] = self._io.pos() + self._debug['file_timestamp']['start'] = self._io.pos() + self.file_timestamp = self._io.read_u4le() + self._debug['file_timestamp']['end'] = self._io.pos() + self._debug['attr']['start'] = self._io.pos() + self.attr = self._io.read_u1() + self._debug['attr']['end'] = self._io.pos() + self._debug['lha_level']['start'] = self._io.pos() + self.lha_level = self._io.read_u1() + self._debug['lha_level']['end'] = self._io.pos() + + + diff --git a/python/examples/kaitai/kaitai_struct_formats/archive/rar.py b/python/examples/kaitai/kaitai_struct_formats/archive/rar.py new file mode 100644 index 00000000..e9f4787e --- /dev/null +++ b/python/examples/kaitai/kaitai_struct_formats/archive/rar.py @@ -0,0 +1,323 @@ +from __future__ import absolute_import +# This is a generated file! Please edit source .ksy file and use kaitai-struct-compiler to rebuild + +from pkg_resources import parse_version +from ...kaitaistruct import __version__ as ks_version, KaitaiStruct, KaitaiStream, BytesIO +from enum import Enum +import collections + + +if parse_version(ks_version) < parse_version('0.7'): + raise Exception("Incompatible Kaitai Struct Python API: 0.7 or later is required, but you have %s" % (ks_version)) + +class Rar(KaitaiStruct): + """RAR is a archive format used by popular proprietary RAR archiver, + created by Eugene Roshal. There are two major versions of format + (v1.5-4.0 and RAR v5+). + + File format essentially consists of a linear sequence of + blocks. Each block has fixed header and custom body (that depends on + block type), so it's possible to skip block even if one doesn't know + how to process a certain block type. + + .. seealso:: + - http://acritum.com/winrar/rar-format + """ + + class BlockTypes(Enum): + marker = 114 + archive_header = 115 + file_header = 116 + old_style_comment_header = 117 + old_style_authenticity_info_76 = 118 + old_style_subblock = 119 + old_style_recovery_record = 120 + old_style_authenticity_info_79 = 121 + subblock = 122 + terminator = 123 + + class Oses(Enum): + ms_dos = 0 + os_2 = 1 + windows = 2 + unix = 3 + mac_os = 4 + beos = 5 + + class Methods(Enum): + store = 48 + fastest = 49 + fast = 50 + normal = 51 + good = 52 + best = 53 + SEQ_FIELDS = ["magic", "blocks"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['magic']['start'] = self._io.pos() + self.magic = self._root.MagicSignature(self._io, self, self._root) + self.magic._read() + self._debug['magic']['end'] = self._io.pos() + self._debug['blocks']['start'] = self._io.pos() + self.blocks = [] + i = 0 + while not self._io.is_eof(): + if not 'arr' in self._debug['blocks']: + self._debug['blocks']['arr'] = [] + self._debug['blocks']['arr'].append({'start': self._io.pos()}) + _on = self.magic.version + if _on == 0: + if not 'arr' in self._debug['blocks']: + self._debug['blocks']['arr'] = [] + self._debug['blocks']['arr'].append({'start': self._io.pos()}) + _t_blocks = self._root.Block(self._io, self, self._root) + _t_blocks._read() + self.blocks.append(_t_blocks) + self._debug['blocks']['arr'][len(self.blocks) - 1]['end'] = self._io.pos() + elif _on == 1: + if not 'arr' in self._debug['blocks']: + self._debug['blocks']['arr'] = [] + self._debug['blocks']['arr'].append({'start': self._io.pos()}) + _t_blocks = self._root.BlockV5(self._io, self, self._root) + _t_blocks._read() + self.blocks.append(_t_blocks) + self._debug['blocks']['arr'][len(self.blocks) - 1]['end'] = self._io.pos() + self._debug['blocks']['arr'][len(self.blocks) - 1]['end'] = self._io.pos() + i += 1 + + self._debug['blocks']['end'] = self._io.pos() + + class BlockV5(KaitaiStruct): + SEQ_FIELDS = [] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + pass + + + class Block(KaitaiStruct): + """Basic block that RAR files consist of. There are several block + types (see `block_type`), which have different `body` and + `add_body`. + """ + SEQ_FIELDS = ["crc16", "block_type", "flags", "block_size", "add_size", "body", "add_body"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['crc16']['start'] = self._io.pos() + self.crc16 = self._io.read_u2le() + self._debug['crc16']['end'] = self._io.pos() + self._debug['block_type']['start'] = self._io.pos() + self.block_type = KaitaiStream.resolve_enum(self._root.BlockTypes, self._io.read_u1()) + self._debug['block_type']['end'] = self._io.pos() + self._debug['flags']['start'] = self._io.pos() + self.flags = self._io.read_u2le() + self._debug['flags']['end'] = self._io.pos() + self._debug['block_size']['start'] = self._io.pos() + self.block_size = self._io.read_u2le() + self._debug['block_size']['end'] = self._io.pos() + if self.has_add: + self._debug['add_size']['start'] = self._io.pos() + self.add_size = self._io.read_u4le() + self._debug['add_size']['end'] = self._io.pos() + + self._debug['body']['start'] = self._io.pos() + _on = self.block_type + if _on == self._root.BlockTypes.file_header: + self._raw_body = self._io.read_bytes(self.body_size) + io = KaitaiStream(BytesIO(self._raw_body)) + self.body = self._root.BlockFileHeader(io, self, self._root) + self.body._read() + else: + self.body = self._io.read_bytes(self.body_size) + self._debug['body']['end'] = self._io.pos() + if self.has_add: + self._debug['add_body']['start'] = self._io.pos() + self.add_body = self._io.read_bytes(self.add_size) + self._debug['add_body']['end'] = self._io.pos() + + + @property + def has_add(self): + """True if block has additional content attached to it.""" + if hasattr(self, '_m_has_add'): + return self._m_has_add if hasattr(self, '_m_has_add') else None + + self._m_has_add = (self.flags & 32768) != 0 + return self._m_has_add if hasattr(self, '_m_has_add') else None + + @property + def header_size(self): + if hasattr(self, '_m_header_size'): + return self._m_header_size if hasattr(self, '_m_header_size') else None + + self._m_header_size = (11 if self.has_add else 7) + return self._m_header_size if hasattr(self, '_m_header_size') else None + + @property + def body_size(self): + if hasattr(self, '_m_body_size'): + return self._m_body_size if hasattr(self, '_m_body_size') else None + + self._m_body_size = (self.block_size - self.header_size) + return self._m_body_size if hasattr(self, '_m_body_size') else None + + + class BlockFileHeader(KaitaiStruct): + SEQ_FIELDS = ["low_unp_size", "host_os", "file_crc32", "file_time", "rar_version", "method", "name_size", "attr", "high_pack_size", "file_name", "salt"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['low_unp_size']['start'] = self._io.pos() + self.low_unp_size = self._io.read_u4le() + self._debug['low_unp_size']['end'] = self._io.pos() + self._debug['host_os']['start'] = self._io.pos() + self.host_os = KaitaiStream.resolve_enum(self._root.Oses, self._io.read_u1()) + self._debug['host_os']['end'] = self._io.pos() + self._debug['file_crc32']['start'] = self._io.pos() + self.file_crc32 = self._io.read_u4le() + self._debug['file_crc32']['end'] = self._io.pos() + self._debug['file_time']['start'] = self._io.pos() + self.file_time = self._root.DosTime(self._io, self, self._root) + self.file_time._read() + self._debug['file_time']['end'] = self._io.pos() + self._debug['rar_version']['start'] = self._io.pos() + self.rar_version = self._io.read_u1() + self._debug['rar_version']['end'] = self._io.pos() + self._debug['method']['start'] = self._io.pos() + self.method = KaitaiStream.resolve_enum(self._root.Methods, self._io.read_u1()) + self._debug['method']['end'] = self._io.pos() + self._debug['name_size']['start'] = self._io.pos() + self.name_size = self._io.read_u2le() + self._debug['name_size']['end'] = self._io.pos() + self._debug['attr']['start'] = self._io.pos() + self.attr = self._io.read_u4le() + self._debug['attr']['end'] = self._io.pos() + if (self._parent.flags & 256) != 0: + self._debug['high_pack_size']['start'] = self._io.pos() + self.high_pack_size = self._io.read_u4le() + self._debug['high_pack_size']['end'] = self._io.pos() + + self._debug['file_name']['start'] = self._io.pos() + self.file_name = self._io.read_bytes(self.name_size) + self._debug['file_name']['end'] = self._io.pos() + if (self._parent.flags & 1024) != 0: + self._debug['salt']['start'] = self._io.pos() + self.salt = self._io.read_u8le() + self._debug['salt']['end'] = self._io.pos() + + + + class MagicSignature(KaitaiStruct): + """RAR uses either 7-byte magic for RAR versions 1.5 to 4.0, and + 8-byte magic (and pretty different block format) for v5+. This + type would parse and validate both versions of signature. Note + that actually this signature is a valid RAR "block": in theory, + one can omit signature reading at all, and read this normally, + as a block, if exact RAR version is known (and thus it's + possible to choose correct block format). + """ + SEQ_FIELDS = ["magic1", "version", "magic3"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['magic1']['start'] = self._io.pos() + self.magic1 = self._io.ensure_fixed_contents(b"\x52\x61\x72\x21\x1A\x07") + self._debug['magic1']['end'] = self._io.pos() + self._debug['version']['start'] = self._io.pos() + self.version = self._io.read_u1() + self._debug['version']['end'] = self._io.pos() + if self.version == 1: + self._debug['magic3']['start'] = self._io.pos() + self.magic3 = self._io.ensure_fixed_contents(b"\x00") + self._debug['magic3']['end'] = self._io.pos() + + + + class DosTime(KaitaiStruct): + SEQ_FIELDS = ["time", "date"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['time']['start'] = self._io.pos() + self.time = self._io.read_u2le() + self._debug['time']['end'] = self._io.pos() + self._debug['date']['start'] = self._io.pos() + self.date = self._io.read_u2le() + self._debug['date']['end'] = self._io.pos() + + @property + def month(self): + if hasattr(self, '_m_month'): + return self._m_month if hasattr(self, '_m_month') else None + + self._m_month = ((self.date & 480) >> 5) + return self._m_month if hasattr(self, '_m_month') else None + + @property + def seconds(self): + if hasattr(self, '_m_seconds'): + return self._m_seconds if hasattr(self, '_m_seconds') else None + + self._m_seconds = ((self.time & 31) * 2) + return self._m_seconds if hasattr(self, '_m_seconds') else None + + @property + def year(self): + if hasattr(self, '_m_year'): + return self._m_year if hasattr(self, '_m_year') else None + + self._m_year = (((self.date & 65024) >> 9) + 1980) + return self._m_year if hasattr(self, '_m_year') else None + + @property + def minutes(self): + if hasattr(self, '_m_minutes'): + return self._m_minutes if hasattr(self, '_m_minutes') else None + + self._m_minutes = ((self.time & 2016) >> 5) + return self._m_minutes if hasattr(self, '_m_minutes') else None + + @property + def day(self): + if hasattr(self, '_m_day'): + return self._m_day if hasattr(self, '_m_day') else None + + self._m_day = (self.date & 31) + return self._m_day if hasattr(self, '_m_day') else None + + @property + def hours(self): + if hasattr(self, '_m_hours'): + return self._m_hours if hasattr(self, '_m_hours') else None + + self._m_hours = ((self.time & 63488) >> 11) + return self._m_hours if hasattr(self, '_m_hours') else None + + + diff --git a/python/examples/kaitai/kaitai_struct_formats/archive/zip.py b/python/examples/kaitai/kaitai_struct_formats/archive/zip.py new file mode 100644 index 00000000..1f6894dd --- /dev/null +++ b/python/examples/kaitai/kaitai_struct_formats/archive/zip.py @@ -0,0 +1,503 @@ +from __future__ import absolute_import +# This is a generated file! Please edit source .ksy file and use kaitai-struct-compiler to rebuild + +from pkg_resources import parse_version +from ...kaitaistruct import __version__ as ks_version, KaitaiStruct, KaitaiStream, BytesIO +from enum import Enum +import collections + + +if parse_version(ks_version) < parse_version('0.7'): + raise Exception("Incompatible Kaitai Struct Python API: 0.7 or later is required, but you have %s" % (ks_version)) + +class Zip(KaitaiStruct): + """ + .. seealso:: + Source - https://pkware.cachefly.net/webdocs/casestudies/APPNOTE.TXT + """ + + class Compression(Enum): + none = 0 + shrunk = 1 + reduced_1 = 2 + reduced_2 = 3 + reduced_3 = 4 + reduced_4 = 5 + imploded = 6 + deflated = 8 + enhanced_deflated = 9 + pkware_dcl_imploded = 10 + bzip2 = 12 + lzma = 14 + ibm_terse = 18 + ibm_lz77_z = 19 + ppmd = 98 + + class ExtraCodes(Enum): + zip64 = 1 + av_info = 7 + os2 = 9 + ntfs = 10 + openvms = 12 + pkware_unix = 13 + file_stream_and_fork_descriptors = 14 + patch_descriptor = 15 + pkcs7 = 20 + x509_cert_id_and_signature_for_file = 21 + x509_cert_id_for_central_dir = 22 + strong_encryption_header = 23 + record_management_controls = 24 + pkcs7_enc_recip_cert_list = 25 + ibm_s390_uncomp = 101 + ibm_s390_comp = 102 + poszip_4690 = 18064 + extended_timestamp = 21589 + infozip_unix = 30805 + infozip_unix_var_size = 30837 + SEQ_FIELDS = ["sections"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['sections']['start'] = self._io.pos() + self.sections = [] + i = 0 + while not self._io.is_eof(): + if not 'arr' in self._debug['sections']: + self._debug['sections']['arr'] = [] + self._debug['sections']['arr'].append({'start': self._io.pos()}) + _t_sections = self._root.PkSection(self._io, self, self._root) + _t_sections._read() + self.sections.append(_t_sections) + self._debug['sections']['arr'][len(self.sections) - 1]['end'] = self._io.pos() + i += 1 + + self._debug['sections']['end'] = self._io.pos() + + class LocalFile(KaitaiStruct): + SEQ_FIELDS = ["header", "body"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['header']['start'] = self._io.pos() + self.header = self._root.LocalFileHeader(self._io, self, self._root) + self.header._read() + self._debug['header']['end'] = self._io.pos() + self._debug['body']['start'] = self._io.pos() + self.body = self._io.read_bytes(self.header.compressed_size) + self._debug['body']['end'] = self._io.pos() + + + class ExtraField(KaitaiStruct): + SEQ_FIELDS = ["code", "size", "body"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['code']['start'] = self._io.pos() + self.code = KaitaiStream.resolve_enum(self._root.ExtraCodes, self._io.read_u2le()) + self._debug['code']['end'] = self._io.pos() + self._debug['size']['start'] = self._io.pos() + self.size = self._io.read_u2le() + self._debug['size']['end'] = self._io.pos() + self._debug['body']['start'] = self._io.pos() + _on = self.code + if _on == self._root.ExtraCodes.ntfs: + self._raw_body = self._io.read_bytes(self.size) + io = KaitaiStream(BytesIO(self._raw_body)) + self.body = self._root.ExtraField.Ntfs(io, self, self._root) + self.body._read() + elif _on == self._root.ExtraCodes.extended_timestamp: + self._raw_body = self._io.read_bytes(self.size) + io = KaitaiStream(BytesIO(self._raw_body)) + self.body = self._root.ExtraField.ExtendedTimestamp(io, self, self._root) + self.body._read() + elif _on == self._root.ExtraCodes.infozip_unix_var_size: + self._raw_body = self._io.read_bytes(self.size) + io = KaitaiStream(BytesIO(self._raw_body)) + self.body = self._root.ExtraField.InfozipUnixVarSize(io, self, self._root) + self.body._read() + else: + self.body = self._io.read_bytes(self.size) + self._debug['body']['end'] = self._io.pos() + + class Ntfs(KaitaiStruct): + """ + .. seealso:: + Source - https://github.com/LuaDist/zip/blob/master/proginfo/extrafld.txt#L191 + """ + SEQ_FIELDS = ["reserved", "attributes"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['reserved']['start'] = self._io.pos() + self.reserved = self._io.read_u4le() + self._debug['reserved']['end'] = self._io.pos() + self._debug['attributes']['start'] = self._io.pos() + self.attributes = [] + i = 0 + while not self._io.is_eof(): + if not 'arr' in self._debug['attributes']: + self._debug['attributes']['arr'] = [] + self._debug['attributes']['arr'].append({'start': self._io.pos()}) + _t_attributes = self._root.ExtraField.Ntfs.Attribute(self._io, self, self._root) + _t_attributes._read() + self.attributes.append(_t_attributes) + self._debug['attributes']['arr'][len(self.attributes) - 1]['end'] = self._io.pos() + i += 1 + + self._debug['attributes']['end'] = self._io.pos() + + class Attribute(KaitaiStruct): + SEQ_FIELDS = ["tag", "size", "body"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['tag']['start'] = self._io.pos() + self.tag = self._io.read_u2le() + self._debug['tag']['end'] = self._io.pos() + self._debug['size']['start'] = self._io.pos() + self.size = self._io.read_u2le() + self._debug['size']['end'] = self._io.pos() + self._debug['body']['start'] = self._io.pos() + _on = self.tag + if _on == 1: + self._raw_body = self._io.read_bytes(self.size) + io = KaitaiStream(BytesIO(self._raw_body)) + self.body = self._root.ExtraField.Ntfs.Attribute1(io, self, self._root) + self.body._read() + else: + self.body = self._io.read_bytes(self.size) + self._debug['body']['end'] = self._io.pos() + + + class Attribute1(KaitaiStruct): + SEQ_FIELDS = ["last_mod_time", "last_access_time", "creation_time"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['last_mod_time']['start'] = self._io.pos() + self.last_mod_time = self._io.read_u8le() + self._debug['last_mod_time']['end'] = self._io.pos() + self._debug['last_access_time']['start'] = self._io.pos() + self.last_access_time = self._io.read_u8le() + self._debug['last_access_time']['end'] = self._io.pos() + self._debug['creation_time']['start'] = self._io.pos() + self.creation_time = self._io.read_u8le() + self._debug['creation_time']['end'] = self._io.pos() + + + + class ExtendedTimestamp(KaitaiStruct): + """ + .. seealso:: + Source - https://github.com/LuaDist/zip/blob/master/proginfo/extrafld.txt#L817 + """ + SEQ_FIELDS = ["flags", "mod_time", "access_time", "create_time"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['flags']['start'] = self._io.pos() + self.flags = self._io.read_u1() + self._debug['flags']['end'] = self._io.pos() + self._debug['mod_time']['start'] = self._io.pos() + self.mod_time = self._io.read_u4le() + self._debug['mod_time']['end'] = self._io.pos() + if not (self._io.is_eof()): + self._debug['access_time']['start'] = self._io.pos() + self.access_time = self._io.read_u4le() + self._debug['access_time']['end'] = self._io.pos() + + if not (self._io.is_eof()): + self._debug['create_time']['start'] = self._io.pos() + self.create_time = self._io.read_u4le() + self._debug['create_time']['end'] = self._io.pos() + + + + class InfozipUnixVarSize(KaitaiStruct): + """ + .. seealso:: + Source - https://github.com/LuaDist/zip/blob/master/proginfo/extrafld.txt#L1339 + """ + SEQ_FIELDS = ["version", "uid_size", "uid", "gid_size", "gid"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['version']['start'] = self._io.pos() + self.version = self._io.read_u1() + self._debug['version']['end'] = self._io.pos() + self._debug['uid_size']['start'] = self._io.pos() + self.uid_size = self._io.read_u1() + self._debug['uid_size']['end'] = self._io.pos() + self._debug['uid']['start'] = self._io.pos() + self.uid = self._io.read_bytes(self.uid_size) + self._debug['uid']['end'] = self._io.pos() + self._debug['gid_size']['start'] = self._io.pos() + self.gid_size = self._io.read_u1() + self._debug['gid_size']['end'] = self._io.pos() + self._debug['gid']['start'] = self._io.pos() + self.gid = self._io.read_bytes(self.gid_size) + self._debug['gid']['end'] = self._io.pos() + + + + class CentralDirEntry(KaitaiStruct): + """ + .. seealso:: + - 4.3.12 - https://pkware.cachefly.net/webdocs/casestudies/APPNOTE.TXT + """ + SEQ_FIELDS = ["version_made_by", "version_needed_to_extract", "flags", "compression_method", "last_mod_file_time", "last_mod_file_date", "crc32", "compressed_size", "uncompressed_size", "file_name_len", "extra_len", "comment_len", "disk_number_start", "int_file_attr", "ext_file_attr", "local_header_offset", "file_name", "extra", "comment"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['version_made_by']['start'] = self._io.pos() + self.version_made_by = self._io.read_u2le() + self._debug['version_made_by']['end'] = self._io.pos() + self._debug['version_needed_to_extract']['start'] = self._io.pos() + self.version_needed_to_extract = self._io.read_u2le() + self._debug['version_needed_to_extract']['end'] = self._io.pos() + self._debug['flags']['start'] = self._io.pos() + self.flags = self._io.read_u2le() + self._debug['flags']['end'] = self._io.pos() + self._debug['compression_method']['start'] = self._io.pos() + self.compression_method = KaitaiStream.resolve_enum(self._root.Compression, self._io.read_u2le()) + self._debug['compression_method']['end'] = self._io.pos() + self._debug['last_mod_file_time']['start'] = self._io.pos() + self.last_mod_file_time = self._io.read_u2le() + self._debug['last_mod_file_time']['end'] = self._io.pos() + self._debug['last_mod_file_date']['start'] = self._io.pos() + self.last_mod_file_date = self._io.read_u2le() + self._debug['last_mod_file_date']['end'] = self._io.pos() + self._debug['crc32']['start'] = self._io.pos() + self.crc32 = self._io.read_u4le() + self._debug['crc32']['end'] = self._io.pos() + self._debug['compressed_size']['start'] = self._io.pos() + self.compressed_size = self._io.read_u4le() + self._debug['compressed_size']['end'] = self._io.pos() + self._debug['uncompressed_size']['start'] = self._io.pos() + self.uncompressed_size = self._io.read_u4le() + self._debug['uncompressed_size']['end'] = self._io.pos() + self._debug['file_name_len']['start'] = self._io.pos() + self.file_name_len = self._io.read_u2le() + self._debug['file_name_len']['end'] = self._io.pos() + self._debug['extra_len']['start'] = self._io.pos() + self.extra_len = self._io.read_u2le() + self._debug['extra_len']['end'] = self._io.pos() + self._debug['comment_len']['start'] = self._io.pos() + self.comment_len = self._io.read_u2le() + self._debug['comment_len']['end'] = self._io.pos() + self._debug['disk_number_start']['start'] = self._io.pos() + self.disk_number_start = self._io.read_u2le() + self._debug['disk_number_start']['end'] = self._io.pos() + self._debug['int_file_attr']['start'] = self._io.pos() + self.int_file_attr = self._io.read_u2le() + self._debug['int_file_attr']['end'] = self._io.pos() + self._debug['ext_file_attr']['start'] = self._io.pos() + self.ext_file_attr = self._io.read_u4le() + self._debug['ext_file_attr']['end'] = self._io.pos() + self._debug['local_header_offset']['start'] = self._io.pos() + self.local_header_offset = self._io.read_s4le() + self._debug['local_header_offset']['end'] = self._io.pos() + self._debug['file_name']['start'] = self._io.pos() + self.file_name = (self._io.read_bytes(self.file_name_len)).decode(u"UTF-8") + self._debug['file_name']['end'] = self._io.pos() + self._debug['extra']['start'] = self._io.pos() + self._raw_extra = self._io.read_bytes(self.extra_len) + io = KaitaiStream(BytesIO(self._raw_extra)) + self.extra = self._root.Extras(io, self, self._root) + self.extra._read() + self._debug['extra']['end'] = self._io.pos() + self._debug['comment']['start'] = self._io.pos() + self.comment = (self._io.read_bytes(self.comment_len)).decode(u"UTF-8") + self._debug['comment']['end'] = self._io.pos() + + @property + def local_header(self): + if hasattr(self, '_m_local_header'): + return self._m_local_header if hasattr(self, '_m_local_header') else None + + _pos = self._io.pos() + self._io.seek(self.local_header_offset) + self._debug['_m_local_header']['start'] = self._io.pos() + self._m_local_header = self._root.PkSection(self._io, self, self._root) + self._m_local_header._read() + self._debug['_m_local_header']['end'] = self._io.pos() + self._io.seek(_pos) + return self._m_local_header if hasattr(self, '_m_local_header') else None + + + class PkSection(KaitaiStruct): + SEQ_FIELDS = ["magic", "section_type", "body"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['magic']['start'] = self._io.pos() + self.magic = self._io.ensure_fixed_contents(b"\x50\x4B") + self._debug['magic']['end'] = self._io.pos() + self._debug['section_type']['start'] = self._io.pos() + self.section_type = self._io.read_u2le() + self._debug['section_type']['end'] = self._io.pos() + self._debug['body']['start'] = self._io.pos() + _on = self.section_type + if _on == 513: + self.body = self._root.CentralDirEntry(self._io, self, self._root) + self.body._read() + elif _on == 1027: + self.body = self._root.LocalFile(self._io, self, self._root) + self.body._read() + elif _on == 1541: + self.body = self._root.EndOfCentralDir(self._io, self, self._root) + self.body._read() + self._debug['body']['end'] = self._io.pos() + + + class Extras(KaitaiStruct): + SEQ_FIELDS = ["entries"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['entries']['start'] = self._io.pos() + self.entries = [] + i = 0 + while not self._io.is_eof(): + if not 'arr' in self._debug['entries']: + self._debug['entries']['arr'] = [] + self._debug['entries']['arr'].append({'start': self._io.pos()}) + _t_entries = self._root.ExtraField(self._io, self, self._root) + _t_entries._read() + self.entries.append(_t_entries) + self._debug['entries']['arr'][len(self.entries) - 1]['end'] = self._io.pos() + i += 1 + + self._debug['entries']['end'] = self._io.pos() + + + class LocalFileHeader(KaitaiStruct): + SEQ_FIELDS = ["version", "flags", "compression_method", "file_mod_time", "file_mod_date", "crc32", "compressed_size", "uncompressed_size", "file_name_len", "extra_len", "file_name", "extra"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['version']['start'] = self._io.pos() + self.version = self._io.read_u2le() + self._debug['version']['end'] = self._io.pos() + self._debug['flags']['start'] = self._io.pos() + self.flags = self._io.read_u2le() + self._debug['flags']['end'] = self._io.pos() + self._debug['compression_method']['start'] = self._io.pos() + self.compression_method = KaitaiStream.resolve_enum(self._root.Compression, self._io.read_u2le()) + self._debug['compression_method']['end'] = self._io.pos() + self._debug['file_mod_time']['start'] = self._io.pos() + self.file_mod_time = self._io.read_u2le() + self._debug['file_mod_time']['end'] = self._io.pos() + self._debug['file_mod_date']['start'] = self._io.pos() + self.file_mod_date = self._io.read_u2le() + self._debug['file_mod_date']['end'] = self._io.pos() + self._debug['crc32']['start'] = self._io.pos() + self.crc32 = self._io.read_u4le() + self._debug['crc32']['end'] = self._io.pos() + self._debug['compressed_size']['start'] = self._io.pos() + self.compressed_size = self._io.read_u4le() + self._debug['compressed_size']['end'] = self._io.pos() + self._debug['uncompressed_size']['start'] = self._io.pos() + self.uncompressed_size = self._io.read_u4le() + self._debug['uncompressed_size']['end'] = self._io.pos() + self._debug['file_name_len']['start'] = self._io.pos() + self.file_name_len = self._io.read_u2le() + self._debug['file_name_len']['end'] = self._io.pos() + self._debug['extra_len']['start'] = self._io.pos() + self.extra_len = self._io.read_u2le() + self._debug['extra_len']['end'] = self._io.pos() + self._debug['file_name']['start'] = self._io.pos() + self.file_name = (self._io.read_bytes(self.file_name_len)).decode(u"UTF-8") + self._debug['file_name']['end'] = self._io.pos() + self._debug['extra']['start'] = self._io.pos() + self._raw_extra = self._io.read_bytes(self.extra_len) + io = KaitaiStream(BytesIO(self._raw_extra)) + self.extra = self._root.Extras(io, self, self._root) + self.extra._read() + self._debug['extra']['end'] = self._io.pos() + + + class EndOfCentralDir(KaitaiStruct): + SEQ_FIELDS = ["disk_of_end_of_central_dir", "disk_of_central_dir", "qty_central_dir_entries_on_disk", "qty_central_dir_entries_total", "central_dir_size", "central_dir_offset", "comment_len", "comment"] + def __init__(self, _io, _parent=None, _root=None): + self._io = _io + self._parent = _parent + self._root = _root if _root else self + self._debug = collections.defaultdict(dict) + + def _read(self): + self._debug['disk_of_end_of_central_dir']['start'] = self._io.pos() + self.disk_of_end_of_central_dir = self._io.read_u2le() + self._debug['disk_of_end_of_central_dir']['end'] = self._io.pos() + self._debug['disk_of_central_dir']['start'] = self._io.pos() + self.disk_of_central_dir = self._io.read_u2le() + self._debug['disk_of_central_dir']['end'] = self._io.pos() + self._debug['qty_central_dir_entries_on_disk']['start'] = self._io.pos() + self.qty_central_dir_entries_on_disk = self._io.read_u2le() + self._debug['qty_central_dir_entries_on_disk']['end'] = self._io.pos() + self._debug['qty_central_dir_entries_total']['start'] = self._io.pos() + self.qty_central_dir_entries_total = self._io.read_u2le() + self._debug['qty_central_dir_entries_total']['end'] = self._io.pos() + self._debug['central_dir_size']['start'] = self._io.pos() + self.central_dir_size = self._io.read_u4le() + self._debug['central_dir_size']['end'] = self._io.pos() + self._debug['central_dir_offset']['start'] = self._io.pos() + self.central_dir_offset = self._io.read_u4le() + self._debug['central_dir_offset']['end'] = self._io.pos() + self._debug['comment_len']['start'] = self._io.pos() + self.comment_len = self._io.read_u2le() + self._debug['comment_len']['end'] = self._io.pos() + self._debug['comment']['start'] = self._io.pos() + self.comment = (self._io.read_bytes(self.comment_len)).decode(u"UTF-8") + self._debug['comment']['end'] = self._io.pos() + + + |