Metadata-Version: 2.4
Name: hsql
Version: 0.1.0
Summary: The headless SQL client for scripts and agents. Installs Harlequin.
Project-URL: Homepage, https://harlequin.sh
Project-URL: Documentation, https://harlequin.sh/docs/getting-started/index
Project-URL: Repository, https://github.com/tconbeer/harlequin
Project-URL: Bug Tracker, https://github.com/tconbeer/harlequin/issues
Project-URL: Changelog, https://github.com/tconbeer/harlequin/blob/main/CHANGELOG.md
Author-email: Ted Conbeer <tconbeer@users.noreply.github.com>
License-Expression: MIT
License-File: LICENSE
Keywords: agents,cli,harlequin,headless,sql
Classifier: Development Status :: 1 - Planning
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.10
Requires-Dist: harlequin>=2.8
Description-Content-Type: text/markdown

# hsql

`hsql` is the headless command-line interface to
[Harlequin](https://harlequin.sh), the SQL IDE for your terminal — the same
engine and the same database adapters, without the TUI, for scripts, CI, and
coding agents.

## Status

**This package is a placeholder that installs Harlequin.** The `hsql` command
itself is not here yet; it will ship as part of the `harlequin` distribution,
and this package will then require the version that provides it.

Installing it today gets you Harlequin:

```bash
pip install hsql
harlequin --help
```

If that is what you want, `pip install harlequin` is the more direct way to
say so.

## What it will be

One CLI contract across every database Harlequin supports — DuckDB, SQLite,
Postgres, MySQL, BigQuery, Trino, Databricks, ODBC, ADBC and more — reusing
the profiles you already have in `.harlequin.toml`:

```bash
hsql -P prod -c "select count(*) from orders"
hsql -P prod catalog analytics
hsql -P prod -tAc "select count(*) from orders"
```

Same flags, same output formats, same exit codes, whichever database is on the
other end.

## Links

- Documentation: <https://harlequin.sh>
- Source: <https://github.com/tconbeer/harlequin>
- Issues: <https://github.com/tconbeer/harlequin/issues>

MIT licensed.
