pip install policyengine-uk-data gives 1.11.1 (Dec 2024); main is 1.59.1 #637

Problem

pip install policyengine-uk-data installs version 1.11.1, uploaded to PyPI on 10 December 2024. main is at 1.59.1. The PyPI publish step was removed from push.yaml in dc7c7f4 (August 2025), and #434 left open whether the package should be published at all.

An external replication using raw FRS 2024-25 reported that "the package only handles codes up to 2022-23" and needed several run-time patches. That matches 1.11.1:

• It defines FRS classes for 2020-21, 2021-22 and 2022-23 only.
• categorical() maps unmapped codes to missing and then to the bytes b"nan". CTBAND 10 (in every release since at least 2022-23) and EMPSTATI 11 ("Other Inactive"; its range(12) list has 11 labels) both end up there. Current policyengine-core rejects "nan" as an invalid enum value; older versions silently read it as the first enum value (band A, CHILD).

main handles all of these (FRS 2024-25 is the pinned release; EMPSTATI 11 since #526; CTBAND in #PR_A_PLACEHOLDER), but nobody outside the team gets main from PyPI.

Options

1. Resume publishing to PyPI from the release workflow (trusted publishing, per Move away from PyPI token usage #106), so the package version matches the data release.
2. Or stop offering it: publish a final PyPI release whose description points to GitHub, and mark it installable = false in the policyengine.py stack manifest as Prepare policyengine-uk-data for .py-owned stack releases #434 suggested.

Either way, the README should say how to install it. #DOCS_PR_PLACEHOLDER documents installing from GitHub in the meantime.

Evidence

• PyPI JSON API: latest version 1.11.1, upload time 2024-12-10T13:39:43.
• 1.11.1 wheel, policyengine_uk_data/datasets/frs/frs.py: FRS_2022_23 is the latest class; categorical(household.CTBAND, 1, range(1, 10), BANDS) and categorical(person.EMPSTATI, 1, range(12), EMPLOYMENTS) with 11 labels.
• UKDS FRS variable listings for SN 9252, 9367 and 9563: CTBAND 10 and EMPSTATI 11 exist in all three.

🤖 Generated with Claude Code