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.23.2.tar.gz (77.6 kB view details)

Uploaded Source

Built Distribution

harlequin-1.23.2-py3-none-any.whl (95.4 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for harlequin-1.23.2.tar.gz
Algorithm Hash digest
SHA256 1d26e1dbd0b207d3869779022490f0e659c787e7c9a234d6b436c7a79ca32284
MD5 12c639e1fcec541d52fe736026348453
BLAKE2b-256 c78181c6cd198a8733ec95c316ea4647cbefae7dc1c6451cc5f76317751b8cd7

See more details on using hashes here.

File details

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

File metadata

  • Download URL: harlequin-1.23.2-py3-none-any.whl
  • Upload date:
  • Size: 95.4 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.23.2-py3-none-any.whl
Algorithm Hash digest
SHA256 863e169abc4fb7b3ae05211066df873190bba242cf5b782a4c009b81fa60346a
MD5 770fb02d2b9097f11e77983e9f45b252
BLAKE2b-256 d72b9f50d707f679d956f97f5a7211601b55776f942570594350c34227c0bb70

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