Skip to content

feat(core): export field and AdCOM list reference data - #56

Open
aleksUIX wants to merge 1 commit into
mainfrom
site-reference-export
Open

aleksUIX wants to merge 1 commit into
mainfrom
site-reference-export

Conversation

@aleksUIX

@aleksUIX aleksUIX commented Nov 8, 2026

Copy link
Copy Markdown
Owner

Summary

  • Adds adcom_list_names(), a read-only accessor for the AdCOM list registry. Paired with the existing adcom_list_values(), it lets callers export the full registry.
  • Adds the export_site_reference example. It writes field-reference.json (every OpenRTB 2.x object and field across the 16 tracked versions with catalogs: types, required and deprecated markers, AdCOM list references, value sets, spec sections, reachable paths, and the versioned rules that name each path) and adcom-lists.json.
  • rtblint.org uses both files for the new per-field and per-list reference pages. The site commits the JSON, so its CI still needs no Rust toolchain.

No validator behavior changes.

Catalog gap found while exporting

Four parent fields have no resolved child_object in the catalogs: Device.sua (UserAgent), UserAgent.browsers (BrandVersion), and the 2.2 BidRequest.regs and Pmp.deals. The exporter supplements these links for path building only. Worth checking whether the validator descends into device.sua and sua.browsers for type checks; that is left for a separate change.

Test plan

  • cargo test -p rtblint-core: 278 passed.
  • cargo clippy -p rtblint-core --examples: clean.
  • cargo run -p rtblint-core --example export_site_reference -- <dir>: 40 objects, 16 versions, 43 AdCOM lists.

🤖 Generated with Claude Code

Add adcom_list_names() so the AdCOM list registry can be enumerated, and an
export_site_reference example that writes field-reference.json and
adcom-lists.json from the static catalogs and version profiles. The site
uses them for per-field and per-list reference pages. No validator behavior
changes.

The exporter supplements four parent links the catalogs do not resolve
(Device.sua, UserAgent.browsers, and the 2.2 regs and deals objects) when
building paths.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant