v1.9.3

[webknjaz]

🐛 Bug fixes

• Stopped dropping trailing slashes in yarl.URL.joinpath() -- by @gmacon. (Another regression in URL join behavior #862, Keep a trailing slash in URL.joinpath #866)
• Started accepting string subclasses in __truediv__() operations (URL / segment) -- by @mjpieters. (TypeError on URL join with enum.StrEnum classes for yarl==1.9.1+ #871, Allow string subclasses in truediv operations #884)
• Fixed the human representation of URLs with square brackets in usernames and passwords -- by @mjpieters. (IP address test regressions (Python 3.11.4, 3.12.0b1) #876, Correct square bracket handling in URL netloc #882)
• Updated type hints to include URL.missing_port(), URL.__bytes__() and the encoding argument to yarl.URL.joinpath() -- by @mjpieters. (Update type hints #891)

📦 Packaging updates and notes for downstreams

• Integrated Cython 3 to enable building yarl under Python 3.12 -- by @mjpieters. (Python 3.12: ‘PyLongObject’ {aka ‘struct _longobject’} has no member named ‘ob_digit’ #829, Python 3.12 compatibility #881)

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

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

• Converted most of the packaging setup into a declarative setup.cfg config -- by @webknjaz. (📦🎨 Move package attrs to declarative config #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. (📦 Move packaging to PEP 517 in-tree backend #893)

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

🛠️ Contributor-facing changes

• A regression test for no-host URLs was added per Incorrect handling of empty host in absolute URL #821 and RFC 3986 -- by @kenballus. (Incorrect handling of empty host in absolute URL #821, Add test for empty host #821 #822)

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

• All Python 3.12 jobs are now marked as required to pass in CI -- by @edgarrmondragon. (feat: Support Python 3.12 #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. (📝🎨 Integrate MyST in Sphinx docs #953)

💪 New Contributors

• @gmacon made their first contribution in Keep a trailing slash in URL.joinpath #866
• @scop made their first contribution in Add changelog project URL for PyPI #877
• @edgarrmondragon made their first contribution in feat: Support Python 3.12 #942
• @kenballus made their first contribution in Add test for empty host #821 #822
• @davetapley made their first contribution in Document default port substitution on URL.with_scheme #949

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

---

This is a discussion about the release v1.9.3.