1.9.4

Bug fixes

• Started raising :py:exc:TypeError when a string value is passed into
  :py:meth:~yarl.URL.build as the port argument -- by :user:commonism.

  Previously the empty string as port would create malformed URLs when rendered as string representations. (#883)

Packaging updates and notes for downstreams

• The leading -- has been dropped from the :pep:517 in-tree build
  backend config setting names. --pure-python is now just pure-python
  -- by :user:webknjaz.

  The usage now looks as follows:

  .. code-block:: console

  $ python -m build \
      --config-setting=pure-python=true \
      --config-setting=with-cython-tracing=true
  

  (#963)

Contributor-facing changes

• A step-by-step :doc:Release Guide <contributing/release_guide> guide has
  been added, describing how to release yarl -- by :user:webknjaz.

  This is primarily targeting maintainers. (#960)

• Coverage collection has been implemented for the Cython modules
  -- by :user:webknjaz.

  It will also be reported to Codecov from any non-release CI jobs.

  To measure coverage in a development environment, yarl can be
  installed in editable mode, which requires an environment variable
  YARL_CYTHON_TRACING=1 to be set:

  .. code-block:: console

  $ YARL_CYTHON_TRACING=1 python -Im pip install -e .
  

  Editable install produces C-files required for the Cython coverage
  plugin to map the measurements back to the PYX-files. (#961)

• It is now possible to request line tracing in Cython builds using the
  with-cython-tracing :pep:517 config setting
  -- :user:webknjaz.

  This can be used in CI and development environment to measure coverage
  on Cython modules, but is not normally useful to the end-users or
  downstream packagers.

  Here's a usage example:

  .. code-block:: console

  $ python -Im pip install . --config-settings=with-cython-tracing=true
  

  For editable installs, this setting is on by default. Otherwise, it's
  off unless requested explicitly. (#962)

1.9.3

🐛 Bug fixes

• Stopped dropping trailing slashes in yarl.URL.joinpath() -- by @gmacon. (#862, #866)
• Started accepting string subclasses in __truediv__() operations (URL / segment) -- by @mjpieters. (#871, #884)
• Fixed the human representation of URLs with square brackets in usernames and passwords -- by @mjpieters. (#876, #882)
• Updated type hints to include URL.missing_port(), URL.__bytes__() and the encoding argument to yarl.URL.joinpath() -- by @mjpieters. (#891)

📦 Packaging updates and notes for downstreams

• Integrated Cython 3 to enable building yarl under Python 3.12 -- by @mjpieters. (#829, #881)

• Added the changelog URL to the dist metadata -- by @scop. (#877)

• Declared modern setuptools.build_meta as the :pep:517 build backend in pyproject.toml explicitly -- by @webknjaz. (#886)

• Converted most of the packaging setup into a declarative setup.cfg config -- by @webknjaz. (#890)

• Replaced the packaging is replaced from an old-fashioned setup.py to an in-tree :pep:517 build backend -- by @webknjaz.

  Whenever the end-users or downstream packagers need to build yarl from source (a Git checkout or an sdist), they may pass a config_settings flag --pure-python. If this flag is not set, a C-extension will be built and included into the distribution.

  Here is how this can be done with pip:

  $ python -m pip install . --config-settings=--pure-python=

  This will also work with -e | --editable.

  The same can be achieved via pypa/build:

  $ python -m build --config-setting=--pure-python=

  Adding -w | --wheel can force pypa/build produce a wheel from source directly, as opposed to building an sdist and then building from it. (#893)

• Declared Python 3.12 supported officially in the distribution package metadata -- by @edgarrmondragon. (#942)

🛠️ Contributor-facing changes

• A regression test for no-host URLs was added per #821 and RFC 3986 -- by @kenballus. (#821, #822)

• Started testing yarl against Python 3.12 in CI -- by @mjpieters. (#881)

• All Python 3.12 jobs are now marked as required to pass in CI -- by @edgarrmondragon. (#942)

• MyST is now integrated in Sphinx -- by @webknjaz.

  This allows the contributors to author new documents in Markdown when they have difficulties with going straight RST. (#953)

💪 New Contributors

• @gmacon made their first contribution in #866
• @scop made their first contribution in #877
• @edgarrmondragon made their first contribution in #942
• @kenballus made their first contribution in #822
• @davetapley made their first contribution in #949

🪞 Full Diff: v1.9.2...v1.9.3

1.9.2

Bugfixes

• Fix regression with truediv and absolute URLs with empty paths causing the raw path to lack the leading /. ((#854)_)

1.9.1

Bugfixes

• Marked tests that fail on older Python patch releases (< 3.7.10, < 3.8.8 and < 3.9.2) as expected to fail due to missing a security fix for CVE-2021-23336. ((#850)_)

1.8.2

This is the first release that started shipping wheels for Python 3.11.

1.8.1

Misc

• (#694), (#699), (#700), (#701), (#702), (#703), (#739)_

1.8.0

Features

• Added URL.raw_suffix, URL.suffix, URL.raw_suffixes, URL.suffixes, URL.with_suffix. ((#613)_)

Improved Documentation

• Fixed broken internal references to :meth:~URL.human_repr. ((#665)_)
• Fixed broken external references to :doc:multidict:index docs. ((#665)_)

Deprecations and Removals

• Dropped Python 3.6 support. ((#672)_)

Misc

• (#646), (#699), (#701)_

v1.7.2

Bugfixes

• Changed call in with_port() to stop reencoding parts of the URL that were already encoded. ((#623)_)

v1.7.1

Bugfixes

• Fix 1.7.0 build error

v1.7.0a4

Features

• Add __bytes__() magic method so that bytes(url) will work and use optimal ASCII encoding. ((#582)_)
• Started shipping platform-specific arm64 wheels for Apple Silicon. ((#622)_)
• Started shipping platform-specific wheels with the musl tag targeting typical Alpine Linux runtimes. ((#622)_)
• Added support for Python 3.10. ((#622)_)