Cap mysqlclient to <= 2.1.x, and add documentation on compatibility.

Review Request #13194 — Created Aug. 8, 2023 and submitted

Information

Review Board
release-5.0.x

Reviewers

mysqlclient 2.2 dropped support for compiling using the mysql_config
script to locate headers/libraries, instead requiring a mysql/mariadb
pkg-config file. This flat-out breaks compatibility on many systems,
such as:

  • Alpine Linux (https://github.com/PyMySQL/mysqlclient/issues/620)
  • Amazon Linux (https://github.com/PyMySQL/mysqlclient/issues/634)
  • Debian Bookworm (https://github.com/PyMySQL/mysqlclient/issues/637)

This is a pretty serious issue for users, and doesn't appear to be
something the project is interested in addressing in their packaging.
Unfortunately, despite the size of this imposed breakage, there's no
compatibility lists anywhere for mysqlclient that we can reference and
provide for our own users.

Until the situation is sorted, or an alternative to mysqlclient is
found/created/forked, the best we can do is cap our default
ReviewBoard[mysql] extras package to 2.1.x, in order to preserve
existing installs, and then provide a big warning and extensive
instructions in our documentation.

Built the docs and verified the links.

Tested installing the extras package and verified I got 2.1.1.

Summary ID
Cap mysqlclient to <= 2.1.x, and add documentation on compatibility.
mysqlclient 2.2 dropped support for compiling using the `mysql_config` script to locate headers/libraries, instead requiring a mysql/mariadb pkg-config file. This flat-out breaks compatibility on many systems, such as: * Alpine Linux (https://github.com/PyMySQL/mysqlclient/issues/620) * Amazon Linux (https://github.com/PyMySQL/mysqlclient/issues/634) * Debian Bookworm (https://github.com/PyMySQL/mysqlclient/issues/637) This is a pretty serious issue for users, and doesn't appear to be something the project is interested in addressing in their packaging. Unfortunately, despite the size of this imposed breakage, there's no compatibility lists anywhere for mysqlclient that we can reference and provide for our own users. Until the situation is sorted, or an alternative to mysqlclient is found/created/forked, the best we can do is cap our default `ReviewBoard[mysql]` extras package to 2.1.x, in order to preserve existing installs, and then provide a big warning and extensive instructions in our documentation.
3289a2974481c2bff795de3640bd11dfb462399f
maubin
  1. Ship It!
  2. 
      
david
  1. Ship It!
  2. 
      
chipx86
Review request changed
Status:
Completed
Change Summary:
Pushed to release-5.0.x (bf7737d)