Transition to 2.9

Warning

Construct is undergoing heavy changes at the moment, expect unstable API until further notice.

Overall

Compilation feature for faster performance! Read this tutorial chapter, particularly its restrictions section.

Docstrings of all classes were overhauled. Check the Core API pages.

General classes

All constructs: parse build sizeof methods take context entries ONLY as keyword parameters **contextkw (see tutorial page)

All constructs: parse_file and build_file methods were added (see tutorial page)

All constructs: operator * can be used for docstrings and parsed hooks (see tutorial page)

All constructs: added compile and benchmark methods (see tutorial page)

All constructs: added parsed hook/callback (see tutorial page)

Compiled added (used internally)

String* require explicit encodings, all of them support UTF16 UTF32 encodings, but PaddedString CString dropped some parameters and support only encodings explicitly listed in possiblestringencodings (see tutorial page)

PaddedString CString classes reimplemented using NullTerminated NullStripped

String* build empty strings into empty bytes (despite for example UTF16 encoding empty string into 2 bytes marker)

String class renamed to PaddedString

Enum FlagsEnum can merge labels from IntEnum IntFlag, from enum34 module (see tutorial page)

Enum FlagsEnum dropped default parameter but returns integer if no mapping found (see tutorial page)

Enum FlagsEnum can build from integers and labels, and expose labels as attributes, as bitwisable strings (see tutorial page)

FlagsEnum had parsing semantics fixed (affecting multi-bit flags)

Mapping replaced SymmetricMapping, and dropped default parameter (see API page)

Struct Sequence FocusedSeq Union LazyStruct have new embedding semantics (see tutorial page)

Struct Sequence FocusedSeq Union LazyStruct are exposing subcons, as attributes and in _subcons context entry (see tutorial page)

Struct Sequence FocusedSeq Union LazyStruct are exposing _ _params _root _parsing _building _sizing _subcons _io _index entries in the context (see tutorial page)

EmbeddedBitStruct removed, instead use BitStruct with Bytewise-wrapped fields (see tutorial page)

Array reimplemented without Range, does not use stream.tell()

Range removed, GreedyRange does not support [:] syntax

Array GreedyRange RepeatUntil added discard parameter (see tutorial page)

Const has reordered parameters, value before subcon (see API page)

Index added, in Miscellaneous (see tutorial page)

Pickled added, in Miscellaneous (see tutorial page)

Timestamp added, in Miscellaneous (see tutorial page)

Hex HexDump reimplemented, return bytes and not hexlified strings (see tutorial page)

Select dropped includename parameter (see API page)

If IfThenElse parameter predicate renamed to condfunc, and cannot be embedded (see API page)

Switch updated, default parameter is Pass instead of NoDefault, dropped includekey parameter, and cannot be embedded (see API page)

EmbeddedSwitch added, in Conditional (see tutorial page)

StopIf raises StopFieldError instead of StopIteration (see API page)

Pointer changed size to 0, can be parsed lazily, can also select a stream from context entry

PrefixedArray parameter lengthfield renamed to countfield (see API page)

FixedSized NullTerminated NullStripped added, in Tunneling (see tutorial page)

RestreamData added, in Tunneling (see tutorial page)

Transformed added, in Tunneling (see tutorial page)

ProcessXor and ProcessRotateLeft added, in Tunneling (see tutorial page)

ExprAdapter Mapping Restreamed changed parameters order (decoders before encoders)

Adapter changed parameters, added path parameter to _encode _decode _validate methods (see tutorial page)

Lazy added, in Lazy equivalents category (see tutorial page)

LazyStruct LazyArray reimplemented with new lazy parsing semantics (see tutorial page)

LazySequence LazyRange LazyField(OnDemand) removed

LazyBound remains, but changed to parameter-less lambda (see tutorial page)

Probe Debugger updated, ProbeInto removed (see tutorial page)

Support classes

Container updated, uses globalPrintFullStrings globalPrintFalseFlags globalPrintPrivateEntries

Container updated, equality does not check hidden keys like _private or keys order

FlagsContainer removed

RestreamedBytesIO supports reading till EOF, enabling GreedyBytes GreedyString inside Bitwise Bytewise

HexString removed

Exceptions

FieldError was replaced with StreamError (raised when stream returns less than requested amount) and FormatFieldError (raised by FormatField class, for example if building Float from non-float value and struct.pack complains).

StreamError can be raised by most classes, when the stream is not seekable or tellable

StringError can be raised by classes like Bytes Const, when expected bytes but given unicode string as build value

BitIntegerError was replaced by IntegerError

Struct Sequence can raise IndexError KeyError when dictionaries are missing entries

RepeatError added

IndexFieldError added

CheckError added

NamedTupleError added

RawCopyError added