2026.05.16.1¶
Bumped
literalizerto2026.5.16.1.Both directives gain a
:record-struct-name-prefix:option, which sets the name prefix for the structs/records/dataclasses generated by:heterogeneous-strategy: record(defaultRecord). Available forgo,java,kotlin,python,rust, andscala; using it with another language raises a cleanExtensionError.Both directives gain a
:record-shape-names:option, a semicolon-separated list ofkey1,key2=Nameentries that give specific record shapes a custom name instead of the auto-generated one, following upstreamliteralizeradding therecord_shape_namesconstructor argument. Available forgo,java,kotlin,rust, andscala.InvalidRecordNameErrorfromliteralizer(a:record-shape-names:name that is not a valid PascalCase identifier, or that collides with an auto-generated name or another entry) is now surfaced as a SphinxExtensionErrorrather than an uncaught traceback.The
:heterogeneous-strategy:option now acceptsrecordforpython(generating frozendataclasses.dataclassdeclarations and matching literals), matching upstreamliteralizeradditions.The
literalizer-calldirective gains a:comment-file:option: a text file with one line per generated call whose non-blank lines are emitted as trailing source comments after the matching call (using the target language’s comment syntax), with a blank line emitting no comment. This follows upstreamliteralizeradding thecomment_sourceargument toliteralize_call, which places the comment after the statement terminator – something a:call-transform:cannot do without commenting out the terminator.CommentSourceLengthMismatchError(the:comment-file:line count not matching the number of generated calls) andCommentSourceMultilineErrorfromliteralizerare now surfaced as a SphinxExtensionErrorrather than an uncaught traceback.The
:heterogeneous-strategy:option now acceptstupleforcpp,kotlin,scala, andtypescript, matching upstreamliteralizeradditions. Seeheterogeneous-strategiesfor the full strategy set, worked examples, and the per-language support matrix; future strategy changes are summarized here and detailed there.