⇪📦 Release yarl v1.9.4

.github/workflows/ci-cd.yml

@@ -258,7 +258,7 @@ jobs:
         )
       run: |
         set -eEuo pipefail
-        sed -i 's/^plugins = .*//g' .coveragerc
+        sed -i.bak 's/^plugins = .*//g' .coveragerc
       shell: bash
     - name: Run unittests
       env:

CHANGES.rst

@@ -10,6 +10,76 @@
 
 .. towncrier release notes start
 
+1.9.4 (2023-12-06)
+==================
+
+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. (:issue:`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
+
+  (:issue:`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. (:issue:`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. (:issue:`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. (:issue:`962`)
+
+
 1.9.3 (2023-11-20)
 ==================
 

yarl/__init__.py

@@ -1,5 +1,5 @@
 from ._url import URL, cache_clear, cache_configure, cache_info
 
-__version__ = "1.9.4.dev0"
+__version__ = "1.9.4"
 
 __all__ = ("URL", "cache_clear", "cache_configure", "cache_info")