django-harlequin 1.2.0

要求

支持Python 3.8到3.12。

支持Django 3.2到5.1。

支持的数据库后端：MariaDB/MySQL，PostgreSQL，SQLite。

安装

首先，使用pip安装

python -m pip install django-harlequin

其次，安装Harlequin，使用适当的Harlequin适配器包为您的数据库后端。例如，要使用PostgreSQL适配器安装Harlequin

python -m pip install 'harlequin[postgres]'

Harlequin不需要与Django安装在同一虚拟环境中，因为django-harlequin没有导入它。您只需要路径上的harlequin命令，因此您可以将Harlequin全局安装，或者使用像pipx这样的工具在隔离的虚拟环境中安装。

第三，将应用添加到您的 INSTALLED_APPS 设置中

INSTALLED_APPS = [
    ...,
    "django_harlequin",
    ...,
]

用法

harlequin 命令

运行 harlequin 管理命令以启动 Harlequin，并连接到您的默认数据库

$ ./manage.py harlequin

使用 --database 选择来自 settings.DATABASES 的不同数据库连接

$ ./manage.py harlequin --database replica

额外的选项（可选，在 -- 分隔符之后），将被传递给 Harlequin。例如，要读取其帮助页面，而不是管理命令的帮助页面

$ ./manage.py harlequin -- --help

配置

Harlequin 会自动从 pyproject.toml 或当前工作目录中的自身文件加载配置，这意味着在您的 manage.py 文件旁边。有关可用选项的详细信息，请参阅 Harlequin 的 配置文档。