feature/json-spec-scripts

[SkylordA]

feature/json-spec-scripts

Adds spec_* utility scripts for generating, downloading, comparing, validating, and uploading OED JSON specs across all release tags. Also fixes two pandas 3.0 compatibility issues in extract_spec.py and updates Example CSVs to pass 5.0.0 spec validation.

Changes

utils/extract_spec.py

• Fix apply(pd.Series, 1) → apply(pd.Series) (pandas 3.0 removed convert_dtype positional arg)
• Skip NaN keys from blank "File Names" cells (pandas 3.0 changed split/stack to produce float('nan') instead of None)
• Fall back to "AIR code" column when "CEDE code" is absent (pre-3.0.0 Excel files)

utils/spec_*.py (new)

• spec_download.py — download released JSON specs from GitHub into spec-downloaded/
• spec_generate.py — regenerate JSON specs from source at each tag into spec-generated/
• spec_compare.py — diff spec-downloaded/ vs spec-generated/
• spec_validate.py — validate specs against ods_tools validators using Example CSVs or a PiWind config
• spec_upload.py — upload generated specs to GitHub releases

Examples/

• property_location.csv: populate LocPerilsCovered=WW1 and LocCurrency=GBP for all 500 rows
• marinecargo_account.csv: add PolDedType6All (conditionally required when PolDed6All is set)

JSON spec changes

Status	Versions
New (no existing release asset)	1.1.2 – 2.3.2 (13 versions)
Updated (cr_field + versioning)	3.0.0 – 3.0.3
Updated (versioning only)	3.0.4
Unchanged	3.1.0 – 5.0.0

Note: specs for 1.1.2–3.0.4 will be updated on their GitHub releases. Download again to pick up the corrected files.

closes OasisLMF/ODS_Tools#237
closes OasisLMF/ODS_Tools#236

[github-actions]

Build Preview

You can find files attached to the below linked Workflow Run URL (Logs).
Please note that files only stay for around 14 days!

Name	Link
Commit	fb5c67c
Build	https://github.com/OasisLMF/ODS_OpenExposureData/actions/runs/23346795473
Excel File	excel_spec.zip
JSON File	extracted_spec.zip

[SkylordA]

CI was failing due to unrelated ODS_Tools test bug(s), passing CI with fix/schema-validation branch:
https://github.com/OasisLMF/ODS_OpenExposureData/actions/runs/23429516283

Specific test fixes:
OasisLMF/ODS_Tools@268c931 and OasisLMF/ODS_Tools@0333b67

[github-actions]

Build Preview

You can find files attached to the below linked Workflow Run URL (Logs).
Please note that files only stay for around 14 days!

Name	Link
Commit	bfbef6d
Build	https://github.com/OasisLMF/ODS_OpenExposureData/actions/runs/23478047340
Excel File	excel_spec.zip
JSON File	extracted_spec.zip

[github-actions]

Build Preview

You can find files attached to the below linked Workflow Run URL (Logs).
Please note that files only stay for around 14 days!

Name	Link
Commit	c9efa22
Build	https://github.com/OasisLMF/ODS_OpenExposureData/actions/runs/23481364081
Excel File	excel_spec.zip
JSON File	extracted_spec.zip

[github-actions]

Build Preview

You can find files attached to the below linked Workflow Run URL (Logs).
Please note that files only stay for around 14 days!

Name	Link
Commit	c9efa22
Build	https://github.com/OasisLMF/ODS_OpenExposureData/actions/runs/23481364081
Excel File	excel_spec.zip
JSON File	extracted_spec.zip