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

Uploaded Source

Built Distribution

harlequin-1.25.2-py3-none-any.whl (111.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: harlequin-1.25.2.tar.gz
  • Upload date:
  • Size: 90.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for harlequin-1.25.2.tar.gz
Algorithm Hash digest
SHA256 8319da69b07afd063e1296ebba1569374daa171489b97bd35d2dbdae802e6144
MD5 56fcd3b519c4f1edbf2f59e5dbf96dae
BLAKE2b-256 bbc10fc47822534938e73f070eb485059be414bb6ee274ac05e1d5d695fb4c24

See more details on using hashes here.

Provenance

The following attestation bundles were made for harlequin-1.25.2.tar.gz:

Publisher: publish.yml on tconbeer/harlequin

Attestations:

File details

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

File metadata

  • Download URL: harlequin-1.25.2-py3-none-any.whl
  • Upload date:
  • Size: 111.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for harlequin-1.25.2-py3-none-any.whl
Algorithm Hash digest
SHA256 18abde53826927c8a4360bd64b8ab67ab569ab57b31de3b913216fd435cf42ac
MD5 1376a934af5617060bc68632ebdd5dcb
BLAKE2b-256 e0214aedfcfbf6757ed6a8c9b458abb088fb07e6ce2dbe33fb05e5ed55f13d2d

See more details on using hashes here.

Provenance

The following attestation bundles were made for harlequin-1.25.2-py3-none-any.whl:

Publisher: publish.yml on tconbeer/harlequin

Attestations:

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