Launch Harlequin, the SQL IDE for your Terminal, with your Django database configuration.
Project description
Launch Harlequin, the SQL IDE for your Terminal, with your Django database configuration.
Work smarter and faster with my book Boost Your Django DX which covers many tools to improve your development experience.
Requirements
Python 3.9 to 3.13 supported.
Django 4.2 to 5.1 supported.
Supported database backends: MariaDB/MySQL, PostgreSQL, SQLite.
Installation
First, install with pip:
python -m pip install django-harlequin
Second, install Harlequin with appropriate Harlequin adapter packages for the database backends you use. For example, to install Harlequin with the PostgreSQL adapter:
python -m pip install 'harlequin[postgres]'
Harlequin does not need to be installed in the same virtual environment as Django, as django-harlequin does not import it. You only need the harlequin command on your path, so you can install Harlequin globally, or in an isolated virtual environment with a tool like pipx.
Third, add the app to your INSTALLED_APPS setting:
INSTALLED_APPS = [
...,
"django_harlequin",
...,
]
Usage
harlequin command
Run the harlequin management command to launch Harlequin, connected to your default database:
$ ./manage.py harlequin
Pass --database to select a different database connection from settings.DATABASES:
$ ./manage.py harlequin --database replica
Extra options, optionally after a -- delimiter, will be passed through to Harlequin. For example, to read its help page, as opposed to that of the management command:
$ ./manage.py harlequin -- --help
Configuration
Harlequin automatically loads configuration from pyproject.toml or its own files within the current working directory, which would mean next to your manage.py file. See Harlequin’s configuration documentation for details on the available options.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django_harlequin-1.4.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8e42e78206b506236a7ce7dedc65f944e70654f952965d3a4cceba72c298b7e0 |
|
MD5 | d9c7d639c0a00b20844b7073844d7126 |
|
BLAKE2b-256 | e9a09f0db34364db9082ae11605eabaf3736e8f17edaa4cacc0aa8e24e8159d6 |