Migrating to v0.49#

The v0.49 release is the global naming-standards sweep, consolidating the naming conventions that lock the v1.0 Tier-1 contract. The release audits the repo against PEP 8, scikit-learn, NumPy, Google Python Style Guide, and Scientific Python SPEC 7; finds the package already 95–99% consistent; closes the small remaining gaps; and ratifies the conventions in ADR 0004. The SPEC 7 rng parameter convention is documented here as the v1.0 contract and adopted at v0.50.0.

If you’re jumping from v0.47 (or earlier) and have not migrated through v0.48, read migration/v0.48.md first.

What’s BREAKING at v0.49#

Five Tier-1 renames for naming consistency (pre-v1.0; SemVer-minor per the v0.34.0 BREAKING-minor precedent). Single-consumer lockstep bump in prompt-injection-detection-submission; no deprecation aliases.

1. build_manifest → make_manifest#

Before:

from eval_toolkit import build_manifest
manifest = build_manifest(...)

After:

from eval_toolkit import make_manifest
manifest = make_manifest(...)

2. Other Tier-1 renames in the v0.49 sweep#

See CHANGELOG.md for the full list of v0.49 renames — five Tier-1 renames (one of which is the _scorecard→scorecards module promotion) plus two dedups. Pattern is mechanical: git grep the old name; replace at all call sites; bump dep pin.

3. scorecards.py module promotion#

The previously-internal _scorecard module is promoted to public scorecards (no underscore). The module re-exports Scorecard, scorecard(), and MetricSpec-aware helpers per ADR 0002 (scorecard as primary metric surface).

Before:

from eval_toolkit._scorecard import scorecard, Scorecard

After:

from eval_toolkit import scorecard, Scorecard
# OR
from eval_toolkit.scorecards import scorecard, Scorecard

What’s Added at v0.49#

  • ADR 0004: the canonical naming conventions ratified for v1.0. Read this before introducing new public symbols.

Notes#

  • v0.49 ships in parallel with the v0.50 SPEC 7 rng= adoption work; the _rng.py scaffold lands in v0.49 but is not yet wired into every function signature. See migration/v0.50.md for the per-function signature rename.

  • The naming sweep was discovered to be already 95–99% complete via the industry-research pass; the v0.49 commit closes the remaining gaps rather than introducing new conventions.