1.20.1

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.

---

1.20.0

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.

---

1.19.0

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.

---

1.18.3

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.

---

1.18.2

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

No significant changes.

---

1.18.1

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.

---

1.18.0

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.

---

1.17.2

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.

---

1.17.1

Miscellaneous internal changes

• Improved performance of many :class:~yarl.URL methods -- by :user:bdraco.

  Related issues and pull requests on GitHub:
  #1396, #1397, #1398.

• Improved performance of passing a dict or str to :py:meth:~yarl.URL.extend_query -- by :user:bdraco.

  Related issues and pull requests on GitHub:
  #1401.

---

1.17.0

Features

• Added :attr:~yarl.URL.host_port_subcomponent which returns the :rfc:3986#section-3.2.2 host and :rfc:3986#section-3.2.3 port subcomponent -- by :user:bdraco.

  Related issues and pull requests on GitHub:
  #1375.

---