A client CLI utility for Datasette instances
  • Python 99.7%
  • Just 0.3%
Find a file
2023-07-24 16:21:08 -07:00
.github/workflows cache-dependency-path: setup.py 2022-11-21 23:00:33 -08:00
dclient Support for --encoding, refs #8 2023-07-24 16:21:08 -07:00
docs Initial prototype of insert command, refs #8 2023-07-18 20:43:42 -07:00
tests Support for --encoding, refs #8 2023-07-24 16:21:08 -07:00
.gitignore Initial library structure 2022-11-22 01:57:06 +00:00
Justfile Documentation on ReadTheDocs using MyST 2023-07-17 16:48:50 -07:00
LICENSE Initial library structure 2022-11-22 01:57:06 +00:00
README.md Documentation for the dclient insert feature, refs #8 2023-07-18 19:33:35 -07:00
setup.py insert test that exercises against an in-memory Datasette instance, refs #8 2023-07-24 15:18:54 -07:00

dclient

PyPI Changelog Tests License

A client CLI utility for Datasette instances

Things you can do with dclient

  • Run SQL queries against Datasette and returning the results as JSON
  • Run queries against authenticated Datasette instances
  • Create aliases and store authentication tokens for convenient access to Datasette
  • Insert data into Datasette using the insert API (Datasette 1.0 alpha or higher)

Installation

Install this tool using pip:

pip install dclient

If you want to install it in the same virtual environment as Datasette (to use it as a plugin) you can instead run:

datasette install dclient

Running a query

dclient query https://latest.datasette.io/fixtures "select * from facetable limit 1"

Documentation

Visit dclient.datasette.io for full documentation on using this tool.

Development

To contribute to this tool, first checkout the code. Then create a new virtual environment:

cd dclient
python -m venv venv
source venv/bin/activate

Now install the dependencies and test dependencies:

pip install -e '.[test]'

To run the tests:

pytest