Skip to main content

The SQL IDE for Your Terminal.

Project description

Harlequin

PyPI

PyPI - Python Version Runs on Linux | MacOS | Windows

The SQL IDE for Your Terminal.

Harlequin

Installing Harlequin

After installing Python 3.8 or above, install Harlequin using pip or pipx with:

pipx install harlequin

Using Harlequin with DuckDB

From any shell, to open one or more DuckDB database files:

harlequin "path/to/duck.db" "another_duck.db"

To open an in-memory DuckDB session, run Harlequin with no arguments:

harlequin

If you want to control the version of DuckDB that Harlequin uses, see the Troubleshooting page.

Using Harlequin with SQLite and Other Adapters

Harlequin also ships with a SQLite3 adapter. You can open one or more SQLite database files with:

harlequin -a sqlite "path/to/sqlite.db" "another_sqlite.db"

Like DuckDB, you can also open an in-memory database by omitting the paths:

harlequin -a sqlite

Other adapters can be installed using pip install <adapter package> or pipx inject harlequin <adapter package>, depending on how you installed Harlequin. For a list of known adapters provided either by the Harlequin maintainers or the broader community, see the adapters page in the docs.

Getting Help

To view all command-line options for Harlequin and all installed adapters, after installation, simply type:

harlequin --help

To view a list of all key bindings (keyboard shortcuts) within the app, press F1. You can also view this list outside the app in the docs.

COLOR, KEY BINDING, OR COPY-PASTE PROBLEMS? See Troubleshooting in the docs.

More info at harlequin.sh

Visit harlequin.sh for an overview of features and full documentation.

Sponsoring Harlequin

Please consider sponsoring Harlequin's author, so he can continue to dedicate time to Harlequin.

Contributing

Thanks for your interest in Harlequin! Harlequin is primarily maintained by Ted Conbeer, but he welcomes all contributions!

Please see CONTRIBUTING.md for more information.

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

harlequin-1.24.0.tar.gz (79.1 kB view details)

Uploaded Source

Built Distribution

harlequin-1.24.0-py3-none-any.whl (96.6 kB view details)

Uploaded Python 3

File details

Details for the file harlequin-1.24.0.tar.gz.

File metadata

  • Download URL: harlequin-1.24.0.tar.gz
  • Upload date:
  • Size: 79.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.0 CPython/3.12.5

File hashes

Hashes for harlequin-1.24.0.tar.gz
Algorithm Hash digest
SHA256 725a157cf5a15f56a4c7415db3a863924522d8fd3f5590788820434167e110fd
MD5 c0158de8ddae472b8ce0eae2e2a8f1d6
BLAKE2b-256 e9cd405f83d2788a60879cbd3d68151dc2dbcb2689bd54102e7b85983bd38a13

See more details on using hashes here.

File details

Details for the file harlequin-1.24.0-py3-none-any.whl.

File metadata

  • Download URL: harlequin-1.24.0-py3-none-any.whl
  • Upload date:
  • Size: 96.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.0 CPython/3.12.5

File hashes

Hashes for harlequin-1.24.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a9a222ed7e83faf352073cf6412e60129890ee1879ab3c4a0132be70adcd19c8
MD5 a143bdbd9462b0a20db9f26321fa468d
BLAKE2b-256 d61a76bc1958f9d11d5c823c2d037190283461201319ed9f6fceef9d49f35cc1

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page