Read enum on properties everywhere allowed values are used

[jochenchrist]

Part of #1560 (#1557). Targets the odcs-3.2.0 branch.

ODCS v3.2.0 (RFC 0033) declares allowed values as enum, a list of entries with a value and optional label, description, id, tags, customProperties, authoritativeDefinitions.

One resolver

datacontract/model/enum_values.py reads enum first, then the legacy representations in order: logicalTypeOptions.enum, the enum custom property (list or JSON string, from DCS), the invalidValues quality rule. It replaces seven private copies in the avro, jsonschema, great-expectations, data-caterer and sodacl exporters, the check builder and the dbt test mapping. The check builder and sodacl export pass include_quality_rule=False, because they turn the quality rule into a check of its own and would otherwise check it twice.

Producers

datacontract import from JSON Schema, Avro (including optional enums in unions, whose symbols were dropped before), Protobuf and DCS writes enum entries instead of an invalidValues rule or avroSymbols/enumValues custom properties (enumValues stays for the protobuf numbers). create_property gained an enum argument.

Consumers that can carry more than values

• datacontract test: field_enum check from the entries
• pydantic-model: enumerated string and integer properties become typing.Literal[...]
• protobuf: enum blocks numbered from each entry's id when numeric, else by position
• avro: a property with physicalType: enum and values exports as an Avro enum without needing the avroType custom property
• html: an "Allowed values" list with label and description
• dcs: field.enum from any representation

Tests

New tests/test_enum_values.py (resolver priority, DuckDB end-to-end pass and fail, every exporter, JSON Schema and DCS import). Avro and protobuf import expectations updated to the entries. Full suite: 2323 passed.

Docs: docs/docs/schema.md uses enum entries in its examples and notes that logicalTypeOptions.enum is still accepted.

🤖 Generated with Claude Code

https://claude.ai/code/session_01C1xhK6DjRLWND1ntBcS8fG