pypi / hatchling

hatchling

What changed in hatchling 1, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-18.

1 breaking1 new APIs and options2 behavior and defaults6 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

hatchling 110 changes

Absolute paths and paths resolving outside the project directory are rejected.
1.32.0release notes

Pass --force to allow an explicit downgrade when setting a static project.version.
1.32.0release notes

The default core metadata version is now 2.5.
1.32.0release notes
The version command can update a statically defined project.version in pyproject.toml in place.
1.32.0release notes

BuilderConfig is no longer generic, restoring the pre-1.32.3 plugin interface.
1.32.4release notes
Reverts the extra type parameter that broke plugins subscripting BuildHookInterface with a single argument, restoring the pre-1.32.3 plugin interface.
1.32.4release notes
Spaces are stripped around version metadata when original input is used for CalVer, preserving leading zeroes.
1.32.4release notes
Preserves the version string exactly as written in core metadata, including leading zeros in CalVer versions; distribution file names and .dist-info directories still use the PEP 440 normalized form.
1.32.3release notes
Entries with the ; private annotation are accepted rather than rejected as invalid import names.
1.32.0release notes
Entries with the ; private annotation are accepted rather than rejected as invalid import names.
1.32.0release notes