Configurable Datasette plugin running ripgrep
Project description
datasette-ripgrep
Configurable Datasette plugin running ripgrep
Demo
Try this plugin out at https://ripgrep.datasette.io/-/ripgrep - where you can run regular expression searches across the source code of Datasette and all of the datasette-*
plugins belonging to the simonw GitHub user.
Some example searches:
- with.*AsyncClient - regular expression search for
with.*AsyncClient
- .plugin_config, literal=on - a non-regular expression search for
.plugin_config(
- with.*AsyncClient glob=datasette/** - search for that pattern only within the
datasette/
top folder - test glob=!*.html - search for the string
test
but exclude results in HTML files
Installation
Install this plugin in the same environment as Datasette.
$ datasette install datasette-ripgrep
The rg
executable needs to be installed such that it can be run by this tool.
Usage
This plugin requires configuration: it needs to a path
setting so that it knows where to run searches.
Create a metadata.json
file that looks like this:
{
"plugins": {
"datasette-ripgrep": {
"path": "/path/to/your/files"
}
}
}
Now run Datasette using datasette -m metadata.json
. The plugin will add an interface at /-/ripgrep
for running searches.
Plugin configuration
The "path"
configuration is required. Optional extra configuration options are:
time_limit
- floating point number. Therg
process will be terminated if it takes longer than this limit. The default is one second,1.0
.max_lines
- integer. Therg
process will be terminated if it returns more than this number of lines. The default is2000
.
Development
To set up this plugin locally, first checkout the code. Then create a new virtual environment:
cd datasette-ripgrep
python3 -mvenv venv
source venv/bin/activate
Or if you are using pipenv
:
pipenv shell
Now install the dependencies and tests:
pip install -e '.[test]'
To run the tests:
pytest
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for datasette_ripgrep-0.6-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | de5c92bbb175b0ff6cac89e513d7b6012b070031fb4e413f898e7460ed443c46 |
|
MD5 | 38f2791fbb0c0ba9313b023e8fc97e7d |
|
BLAKE2b-256 | 1d8cd03aa6034b84e73e78921b48f54c335444aa46b4fe24a8116788846a5974 |