Skip to content

3.1.0

Latest
Latest

Choose a tag to compare

View all tags
@niksite niksite released this 29 Oct 15:45
v3.1.0
fc6bde4

Upgrade notes

Python 3.11 or newer and idna>=3.20 are now required. Python 3.10 users must upgrade Python before installing this release.

Remove the charset keyword from calls to url_normalize() and url_humanize(), and remove -c / --charset from CLI commands. These options have been removed; Unicode URL characters always use UTF-8 percent encoding.

Hosts ending in Unicode equivalents of a dot now normalize without a trailing dot on the first pass. Query filtering now retains explicitly allowed names containing Unicode or spaces. If normalized URLs are used as cache keys or deduplication identifiers, review stored keys and re-normalize the original URLs where available.

Changed

  • BREAKING: Drop support for end-of-life Python 3.10; Python 3.11 or newer is required.
  • BREAKING: Remove the legacy charset API argument and -c / --charset CLI option.
  • Declare Python 3.15 support in package metadata.
  • Require idna>=3.20.

Fixed

  • Write CLI error diagnostics in UTF-8, including Unicode arguments on Windows.
  • Strip trailing Unicode IDNA label separators from hosts and custom allowlist domain keys in one normalization pass.
  • Normalize allowlisted query parameter names consistently with URL query keys, including Unicode and spaces, while keeping literal plus signs, encoded plus signs, and encoded spaces distinct.

Internal

  • Refresh dependencies, pre-commit hooks, and GitHub Actions.
  • Use the committed dependency lockfile for CI checks and tests.
  • Test every supported Python version from 3.11 through 3.15 on Linux, macOS, and Windows.
  • Make uv run CI tests with the Python interpreter selected by the matrix.
  • Run pytest as a Python module so coverage measures the checkout instead of an installed copy.

Full changes: v3.0.1...v3.1.0

Assets 2
Loading