dmpython-jdbc

English | 简体中文

macOS compatibility layer for Dameng dmPython. Dameng does not ship a macOS driver, so this package implements a DBAPI subset with JayDeBeApi + Dameng JDBC and makes dmSQLAlchemy's dm+dmPython:// dialect work locally.

The distribution name is dmpython-jdbc; the import name remains dmPython. Application code does not need to change.

• macOS: use this package's JDBC shim
• Other platforms: forward import dmPython to the official driver

Install

PyPI:

pip install dmpython-jdbc

Cross-platform projects (official driver on Linux/Windows, this package on macOS):

[project]
dependencies = [
    "dmpython>=2.5.32; sys_platform != 'darwin'",
    "dmpython-jdbc>=2.5.32; sys_platform == 'darwin'",
]

If the project also depends on dmSQLAlchemy, see Using with dmSQLAlchemy. That package pulls official dmpython unconditionally.

From GitHub:

pip install "dmpython-jdbc @ git+https://github.com/Darley-Wey/dmpython-jdbc.git"

uv:

[tool.uv.sources]
dmpython-jdbc = { git = "https://github.com/Darley-Wey/dmpython-jdbc.git" }

Pin a commit or tag by appending @<ref>, for example @main or @v2.5.32.

Runtime requirements

• Python >= 3.12
• JDK (brew install openjdk on macOS). JAVA_HOME is probed at /opt/homebrew/opt/openjdk and /usr/local/opt/openjdk
• The Dameng JDBC driver is bundled in the wheel; override it with DM_JDBC_JAR

Using with dmSQLAlchemy

dmSQLAlchemy unconditionally depends on official dmpython (Requires-Dist: dmPython). That package has no macOS wheel, so pip install dmSQLAlchemy on a Mac will try to install Dameng's driver and fail.

Keep dmSQLAlchemy, prevent the resolver from installing official dmpython on macOS, and install dmpython-jdbc instead. The import name stays dmPython.

uv

[project]
dependencies = [
    "dmsqlalchemy",
    "dmpython>=2.5.32; sys_platform != 'darwin'",
    "dmpython-jdbc>=2.5.32; sys_platform == 'darwin'",
]

[tool.uv]
override-dependencies = [
    "dmpython ; sys_platform != 'darwin'",
]

override-dependencies rewrites dmSQLAlchemy's dmpython requirement so it is skipped on macOS. dmpython-jdbc then provides the dmPython module.

dmSQLAlchemy.extensions calls importlib.metadata.version("dmPython"). This package installs a .pth hook so that lookup returns the shim version 2.5.32 without needing setuptools/pkg_resources.

pip on macOS

pip install "dmSQLAlchemy" --no-deps
pip install "SQLAlchemy>1.4.54" dmpython-jdbc

Limits

Stored-procedure OUT binds (cursor.var) and streaming LOB I/O are not supported. ORM CRUD is covered.

License

The Python shim is MIT. DmJdbcDriver18-*.jar is Dameng's official JDBC driver and is not covered by MIT.