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.

---

1.16.0

Bug fixes

• Fixed blocking I/O to load Python code when creating a new :class:~yarl.URL with non-ascii characters in the network location part -- by :user:bdraco.

  Related issues and pull requests on GitHub:
  #1342.

Removals and backward incompatible breaking changes

• Migrated to using a single cache for encoding hosts -- by :user:bdraco.

  Passing ip_address_size and host_validate_size to :py:meth:~yarl.cache_configure is deprecated in favor of the new encode_host_size parameter and will be removed in a future release. For backwards compatibility, the old parameters affect the encode_host cache size.

  Related issues and pull requests on GitHub:
  #1348, #1357, #1363.

Miscellaneous internal changes

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

  Related issues and pull requests on GitHub:
  #1336.

• Improved performance of calling :py:meth:~yarl.URL.build and constructing unencoded :class:~yarl.URL -- by :user:bdraco.

  Related issues and pull requests on GitHub:
  #1345.

• Reworked the internal encoding cache to improve performance on cache hit -- by :user:bdraco.

  Related issues and pull requests on GitHub:
  #1369.

---