mysqlclient-static

English | 简体中文

Self-contained mysqlclient wheels for Linux AMD64 and macOS ARM64. Install a wheel and use MySQLdb without compiling code or installing MySQL/MariaDB client libraries or authentication plugins.

This project packages mysqlclient. Django uses its standard django.db.backends.mysql backend.

Installation

uv add mysqlclient-static

With pip:

python -m pip install --only-binary=:all: mysqlclient-static

For offline installation, download the wheel matching your Python version and platform from GitHub Releases. For example, with CPython 3.12 on macOS ARM64:

python -m pip install --no-index \
  ./mysqlclient_static-2.3.0.post2-cp312-cp312-macosx_11_0_arm64.whl

Replacing mysqlclient

Both distributions provide MySQLdb. Keep one in your application dependencies:

python -m pip uninstall -y mysqlclient
python -m pip install --only-binary=:all: mysqlclient-static

A dependency declared as mysqlclient still needs to be handled in your application's dependency configuration; installing mysqlclient-static does not satisfy that distribution name.

Supported versions

Linux wheels use the manylinux_2_28_x86_64 baseline. macOS wheels target macosx_11_0_arm64 (macOS 11 or later). These wheels target regular CPython.

The wheels contain MariaDB Connector/C 3.4.11, OpenSSL 3.5.9, zlib 1.3.2 and zstd 1.5.7. Linux uses the system glibc; macOS uses its system libraries.

Version numbers and wheel names

The distribution version is the upstream mysqlclient version followed by this project's packaging revision: 2.3.0.post2 means mysqlclient 2.3.0, packaging revision 2. Updates to the bundled libraries or packaging increase .postN; an upstream update starts a new version line, such as 2.3.1.post1.

Python and platform compatibility are recorded in the wheel filename:

mysqlclient_static-2.3.0.post2-cp312-cp312-macosx_11_0_arm64.whl

Each GitHub Release groups all wheels for one distribution version under a tag such as v2.3.0.post2. That version has 10 wheels: five Python versions across two platforms. v2.2.7.post2 has two wheels for Python 3.9. PyPI and GitHub Releases distribute the same files.

MySQL Server versions such as 8.0.46 and 8.4.13 describe database compatibility; they are separate from the Python driver's version.

Typical usage

Set DB_USER, DB_PASSWORD and DB_NAME in your environment:

import os
import MySQLdb
from MySQLdb.cursors import DictCursor

with MySQLdb.connect(
    host="127.0.0.1",
    user=os.environ["DB_USER"],
    password=os.environ["DB_PASSWORD"],
    database=os.environ["DB_NAME"],
    charset="utf8mb4",
) as connection:
    with connection.cursor(DictCursor) as cursor:
        cursor.execute("SELECT %s AS message", ("你好，MySQL",))
        print(cursor.fetchone())

Use %s placeholders and pass values separately. Commit writes explicitly with commit() and call rollback() on failure. A connection's with block closes the connection; it does not commit the transaction automatically.

Coding agents and examples

Every wheel includes these files:

from importlib.resources import files

print(files("MySQLdb").joinpath("README.md").read_text())
print(files("MySQLdb").joinpath("api-symbols.json"))

The agent guide and examples/ are maintained with the package. Each upstream version gets its own symbol index.

Compatibility baselines, bundled-library choices, and instructions for building, testing and publishing are in docs/development.md.

License and source

This project's independent original code, build scripts, configuration, documentation and examples use the MIT license. Upstream sources and derived content retain their original licenses. Combined wheels are distributed under GPL-3.0-or-later, with component copyright and license notices retained. Each Release includes corresponding-source-*.tar.gz with the original sources, build scripts, configuration and source records.

See the component list.