| Name | harlequin-wherobots JSON |
| Version |
0.8.0
JSON |
| download |
| home_page | None |
| Summary | Harlequin adapter for Wherobots' Spatial SQL API |
| upload_time | 2025-07-17 22:30:46 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | <3.14,>=3.9 |
| license | None |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Wherobots Adapter for Harlequin
This repository provides the Harlequin adapter for WherobotsDB, using
the Wherobots Spatial SQL API and its
[wherobots-python-dbapi-driver](https://github.com/wherobots/wherobots-python-dbapi-driver).
## Installation
```
$ pip install harlequin-wherobots
```
## Usage
Procure an API key from Wherobots, and start Harlequin with the
required parameters:
```
$ harlequin -a wherobots --api-key <key>
```
Alternatively, you can use your session token:
```
$ harlequin -a wherobots --token <token>
```
The Harlequin adapter for Wherobots will automatically start a Wherobots
SQL session with the default runtime (Tiny, 4 executors) in the
default Wherobots public compute region (AWS `us-west-2`). You can
override those defaults with the `--runtime` and `--region` options,
respectively:
```
$ harlequin -a wherobots --api-key <key> --runtime MEDIUM --region AWS_US_WEST_2
```
> [!NOTE]
> Community Edition users of Wherobots Cloud are restricted to the
> "Tiny" runtime size. See our [Pricing](https://www.wherobots.com/pricing)
> for more information.
## Advanced options
If your SQL session is already provisioned and running, you can force
the driver to directly connect to it via its WebSocket URL (without
protocol version):
```
$ harlequin -a wherobots --api-key <key> --ws-url <session-url>
```
You can also specify the base hostname of the Wherobots stack to
interact with as the first positional parameter. By default, the driver
connects to `cloud.wherobots.com`, the official public Wherobots
service.
```
$ harlequin -a wherobots --api-key <key> [host]
```
Raw data
{
"_id": null,
"home_page": null,
"name": "harlequin-wherobots",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.14,>=3.9",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": "Maxime Petazzoni <max@wherobots.com>",
"download_url": "https://files.pythonhosted.org/packages/d8/5e/ecebf905c9d9a53c1a5107e3cddfd5782565c38572ff6d992cdd8721c221/harlequin_wherobots-0.8.0.tar.gz",
"platform": null,
"description": "# Wherobots Adapter for Harlequin\n\nThis repository provides the Harlequin adapter for WherobotsDB, using\nthe Wherobots Spatial SQL API and its\n[wherobots-python-dbapi-driver](https://github.com/wherobots/wherobots-python-dbapi-driver).\n\n## Installation\n\n```\n$ pip install harlequin-wherobots\n```\n\n## Usage\n\nProcure an API key from Wherobots, and start Harlequin with the\nrequired parameters:\n\n```\n$ harlequin -a wherobots --api-key <key>\n```\n\nAlternatively, you can use your session token:\n\n```\n$ harlequin -a wherobots --token <token>\n```\n\nThe Harlequin adapter for Wherobots will automatically start a Wherobots\nSQL session with the default runtime (Tiny, 4 executors) in the\ndefault Wherobots public compute region (AWS `us-west-2`). You can\noverride those defaults with the `--runtime` and `--region` options,\nrespectively:\n\n```\n$ harlequin -a wherobots --api-key <key> --runtime MEDIUM --region AWS_US_WEST_2\n```\n\n> [!NOTE]\n> Community Edition users of Wherobots Cloud are restricted to the\n> \"Tiny\" runtime size. See our [Pricing](https://www.wherobots.com/pricing)\n> for more information.\n\n## Advanced options\n\nIf your SQL session is already provisioned and running, you can force\nthe driver to directly connect to it via its WebSocket URL (without\nprotocol version):\n\n```\n$ harlequin -a wherobots --api-key <key> --ws-url <session-url>\n```\n\nYou can also specify the base hostname of the Wherobots stack to\ninteract with as the first positional parameter. By default, the driver\nconnects to `cloud.wherobots.com`, the official public Wherobots\nservice.\n\n```\n$ harlequin -a wherobots --api-key <key> [host]\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "Harlequin adapter for Wherobots' Spatial SQL API",
"version": "0.8.0",
"project_urls": null,
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "04b3087d75f99fea5ad943d03edd055617593156cd49fe2113d363e9a063dc73",
"md5": "57c075fccebfaa0950f7d141b59739b4",
"sha256": "8823a2dda3860873a12b994b3d5ca9b112da0d6e79c7c00c4ad3c020eb4aaabe"
},
"downloads": -1,
"filename": "harlequin_wherobots-0.8.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "57c075fccebfaa0950f7d141b59739b4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.14,>=3.9",
"size": 9822,
"upload_time": "2025-07-17T22:30:44",
"upload_time_iso_8601": "2025-07-17T22:30:44.563920Z",
"url": "https://files.pythonhosted.org/packages/04/b3/087d75f99fea5ad943d03edd055617593156cd49fe2113d363e9a063dc73/harlequin_wherobots-0.8.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "d85eecebf905c9d9a53c1a5107e3cddfd5782565c38572ff6d992cdd8721c221",
"md5": "764b2b062dbbe079d2803723948d2405",
"sha256": "a5a6329dd2154474bf930cf7879bdd63aa13b3dd724b5541361191db4439eead"
},
"downloads": -1,
"filename": "harlequin_wherobots-0.8.0.tar.gz",
"has_sig": false,
"md5_digest": "764b2b062dbbe079d2803723948d2405",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.14,>=3.9",
"size": 91172,
"upload_time": "2025-07-17T22:30:46",
"upload_time_iso_8601": "2025-07-17T22:30:46.020487Z",
"url": "https://files.pythonhosted.org/packages/d8/5e/ecebf905c9d9a53c1a5107e3cddfd5782565c38572ff6d992cdd8721c221/harlequin_wherobots-0.8.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-17 22:30:46",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "harlequin-wherobots"
}
