Bug fixes

• Started raising a :exc:ValueError exception raised for corrupted
  IPv6 URL values.

  These fixes the issue where exception :exc:IndexError was
  leaking from the internal code because of not being handled and
  transformed into a user-facing error. The problem was happening
  under the following conditions: empty IPv6 URL, brackets in
  reverse order.

  -- by :user:MaelPic.

  Related issues and pull requests on GitHub:
  #1512.

Packaging updates and notes for downstreams

• Updated to use Cython 3.1 universally across the build path -- by :user:lysnikolaou.

  Related issues and pull requests on GitHub:
  #1514.

• Made Cython line tracing opt-in via the with-cython-tracing build config setting -- by :user:bdraco.

  Previously, line tracing was enabled by default in :file:pyproject.toml, which caused build issues for some users and made wheels nearly twice as slow.
  Now line tracing is only enabled when explicitly requested via pip install . --config-setting=with-cython-tracing=true or by setting the YARL_CYTHON_TRACING environment variable.

  Related issues and pull requests on GitHub:
  #1521.

Features

• Added arm64 Windows wheel builds
  -- by :user:finnagin.

  Related issues and pull requests on GitHub:
  #1516.

Contributor-facing changes

• The :file:reusable-cibuildwheel.yml workflow has been refactored to
  be more generic and :file:ci-cd.yml now holds all the configuration
  toggles -- by :user:webknjaz.

  Related issues and pull requests on GitHub:
  #1535.

• When building wheels, the source distribution is now passed directly
  to the cibuildwheel invocation -- by :user:webknjaz.

  Related issues and pull requests on GitHub:
  #1536.

• Added CI for Python 3.14 -- by :user:kumaraditya303.

  Related issues and pull requests on GitHub:
  #1560.

Features

• Implemented support for the free-threaded build of CPython 3.13 -- by :user:lysnikolaou.

  Related issues and pull requests on GitHub:
  #1456.

Packaging updates and notes for downstreams

• Started building wheels for the free-threaded build of CPython 3.13 -- by :user:lysnikolaou.

  Related issues and pull requests on GitHub:
  #1456.

Bug fixes

• Fixed entire name being re-encoded when using :py:meth:yarl.URL.with_suffix -- by :user:NTFSvolume.

  Related issues and pull requests on GitHub:
  #1468.

Features

• Started building armv7l wheels for manylinux -- by :user:bdraco.

  Related issues and pull requests on GitHub:
  #1495.

Contributor-facing changes

• GitHub Actions CI/CD is now configured to manage caching pip-ecosystem
  dependencies using re-actors/cache-python-deps_ -- an action by
  :user:webknjaz that takes into account ABI stability and the exact
  version of Python runtime.

  .. _re-actors/cache-python-deps:
  https://github.com/marketplace/actions/cache-python-deps

  Related issues and pull requests on GitHub:
  #1471.

• Increased minimum propcache_ version to 0.2.1 to fix failing tests -- by :user:bdraco.

  .. _propcache:
  https://github.com/aio-libs/propcache

  Related issues and pull requests on GitHub:
  #1479.

• Added all hidden folders to pytest's norecursedirs to prevent it
  from trying to collect tests there -- by :user:lysnikolaou.

  Related issues and pull requests on GitHub:
  #1480.

Miscellaneous internal changes

• Improved accuracy of type annotations -- by :user:Dreamsorcerer.

  Related issues and pull requests on GitHub:
  #1484.

• Improved performance of parsing query strings -- by :user:bdraco.

  Related issues and pull requests on GitHub:
  #1493, #1497.

• Improved performance of the C unquoter -- by :user:bdraco.

  Related issues and pull requests on GitHub:
  #1496, #1498.

Bug fixes

• Fixed uppercase ASCII hosts being rejected by :meth:URL.build() <yarl.URL.build> and :py:meth:~yarl.URL.with_host -- by :user:bdraco.

  Related issues and pull requests on GitHub:
  #954, #1442.

Miscellaneous internal changes

• Improved performances of multiple path properties on cache miss -- by :user:bdraco.

  Related issues and pull requests on GitHub:
  #1443.

This release also failed to fully upload and was yanked from PyPI. Please use 1.18.3 instead.

No significant changes.

This release failed to fully upload and was yanked from PyPI. Please use 1.18.2 instead.

Miscellaneous internal changes

• Improved cache performance when :class:~yarl.URL objects are constructed from :py:meth:~yarl.URL.build with encoded=True -- by :user:bdraco.

  Related issues and pull requests on GitHub:
  #1432.

• Improved cache performance for operations that produce a new :class:~yarl.URL object -- by :user:bdraco.

  Related issues and pull requests on GitHub:
  #1434, #1436.

Features

• Added keep_query and keep_fragment flags in the :py:meth:yarl.URL.with_path, :py:meth:yarl.URL.with_name and :py:meth:yarl.URL.with_suffix methods, allowing users to optionally retain the query string and fragment in the resulting URL when replacing the path -- by :user:paul-nameless.

  Related issues and pull requests on GitHub:
  #111, #1421.

Contributor-facing changes

• Started running downstream aiohttp tests in CI -- by :user:Cycloctane.

  Related issues and pull requests on GitHub:
  #1415.

Miscellaneous internal changes

• Improved performance of converting :class:~yarl.URL to a string -- by :user:bdraco.

  Related issues and pull requests on GitHub:
  #1422.

Bug fixes

• Stopped implicitly allowing the use of Cython pre-release versions when
  building the distribution package -- by :user:ajsanchezsanz and
  :user:markgreene74.

  Related issues and pull requests on GitHub:
  #1411, #1412.

• Fixed a bug causing :attr:~yarl.URL.port to return the default port when the given port was zero
  -- by :user:gmacon.

  Related issues and pull requests on GitHub:
  #1413.

Features

• Make error messages include details of incorrect type when port is not int in :py:meth:~yarl.URL.build.
  -- by :user:Cycloctane.

  Related issues and pull requests on GitHub:
  #1414.

Packaging updates and notes for downstreams

• Stopped implicitly allowing the use of Cython pre-release versions when
  building the distribution package -- by :user:ajsanchezsanz and
  :user:markgreene74.

  Related issues and pull requests on GitHub:
  #1411, #1412.

Miscellaneous internal changes

• Improved performance of the :py:meth:~yarl.URL.joinpath method -- by :user:bdraco.

  Related issues and pull requests on GitHub:
  #1418.