Skip to content

Commit 7cfa20f

Browse files
committed
Document raw dictionary capabilities
1 parent 7903b5b commit 7cfa20f

1 file changed

Lines changed: 3 additions & 5 deletions

File tree

‎docs/sav-profile.md‎

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -39,16 +39,14 @@ feature that the underlying engine cannot observe or write faithfully.
3939
| --- | --- | --- |
4040
| File label and document text | Unobservable | The public engine API exposes neither. Import records `file-label-and-documents-unobservable`; export requires that audited loss to be accepted. |
4141
| Print and write formats independently | Supported as raw IBM I/O tuples | The adapter stores both tuples separately and writes them without collapsing either value. |
42-
| Variable sets | Fail-closed on export | If a set cannot be inspected, or an inspected set cannot be written faithfully, it is recorded and export stops unless its exact loss is accepted. |
42+
| Variable sets | Supported through raw IBM I/O | The adapter stores source sets in the extension catalog and writes them through the raw dictionary setter. Invalid target definitions fail before data are written. |
4343
| Legacy compatible variable names | Fail-closed on export | A compatible name that differs from the long source name is retained in the catalog, but cannot be set through the public writer. Export requires `compatible-variable-name-not-exportable`. |
4444
| Source encoding | UTF-8 fidelity only | UTF-8 is supported. A legacy code page is retained in metadata, but export requires `source-encoding-not-preserved` because the writer has no legacy-code-page preservation contract. |
4545
| Custom attributes with one value | Supported | File and variable scalar attributes round trip through the normalized attribute catalog. |
46-
| Custom-attribute value arrays | Fail-closed | Ordered arrays are preserved in the SQL catalog, but pyspssio accepts only one text value per attribute name. Export stops; it does not stringify, flatten, or silently drop values. |
46+
| Custom-attribute value arrays | Supported through raw IBM I/O | The adapter represents an array as IBM SPSS `Name[1]`, `Name[2]`, … members and reconstructs the ordered array in the normalized catalog. |
4747

48-
The first four loss codes can be supplied through `allow_loss` only when a
48+
The remaining loss codes can be supplied through `allow_loss` only when a
4949
caller intentionally accepts the documented, machine-readable loss report.
50-
An attribute-value array has no corresponding writer representation, so it
51-
remains a hard fail rather than a lossy conversion option.
5250

5351
## Distribution
5452

0 commit comments

Comments
 (0)