A CLI for managing LevelDB instances.
This repo is a fork of lev, originally to make those changes available from NPM
- CLI
- providing many basic tools to read and write on a leveldb from the command line
- import / export, and delete by range
- REPL:
⚠️ This feature was unmaintained and removed inv8.0.0. If you need it, use an earlier version or the originallevpackage.
$ npm install -g lev2These all match the parameters used with levelup. The default encoding for the database is set to json.
Get a value
lev $dbpath --get fooPut a value
lev $db_path --put foo --value bar lev $db_path --put foo --value '{"a": 123}' --valueEncoding json lev $db_path --put foo --value AZoV7p5e --valueEncoding base64 lev $db_path --put foo --value 019a15ede51d --valueEncoding hexDelete a value
lev $db_path --del fooCan be used in combination with --keys, or --all, or implicit --all, to generate a stream of delete operations to be passed to the lev $db_path --batch command
lev $db_path --keys --del | lev $db_path --batch lev $db_path --all --del | lev $db_path --batch lev $db_path --gte abc --lte abd --del | lev $db_path --batchPut or delete several values, using levelup batch syntax
lev $db_path --batch '[ {"type":"del","key":"a"}, {"type":"put","key":"b","value":"123"}, {"type":"put","key":"c","value":"456"} ]'or from a file
# there should be one entry per line # either as valid JSON echo '[ {"type":"del","key":"a"}, {"type":"put","key":"b","value":"123"}, {"type":"put","key":"c","value":"456"} ]' > ops.json # or as newline-delimited JSON echo ' {"type":"del","key":"a"} {"type":"put","key":"b","value":"123"} {"type":"put","key":"c","value":"456"} ' > ops.json lev $db_path --batch ./operations.jsonIf the type is omitted, defaults to put, which allows to use the command to do imports/exports, in combination with --all:
# export lev $db_path --all > leveldb.export # import lev /tmp/my-new-db --batch leveldb.exportIf it's a large export, you can use compress it on the fly
# export lev $db_path --all | gzip -9 > leveldb.export.gz # import gzip -d < leveldb.export.gz | lev /tmp/my-new-db --batchThe --batch option can also be used to delete key/values by range in 2 steps:
# 1 - collect all the key to delete lev $db_path --prefix 'foo' --del > ./deletion_operations # 2 - pass the file as argument to the --batch option lev $db_path --batch ./deletion_operations The same can be done with --match
lev $db_path --match '*foo*' --del > ./deletion_operations List all the keys in the current range
lev $db_path --keysCan be used in combination with --del to generate a stream of delete operations
lev $db_path --keys --del | lev $db_path --batchList all the values in the current range. Emit as a new-line delimited stream of json.
lev $db_path --valuesList all the keys and values in the current range. Emit as a new-line delimited stream of json.
lev $db_path --allIt can be used to create an export of the database, to be imported with --batch
lev $db_path --all > leveldb.export lev /tmp/my-new-db --batch leveldb.exportIt can be used in combinaision with other options, but can then also be omitted as its the default stream mode
lev $db_path --all --prefix 'foo' # is equivalent to lev $db_path --prefix 'foo'Start the range at keys greater than or equal to <key-pattern>. For strictly greater than, use --gt.
# output all keys and values after 'foo' (implicit --all) lev $db_path --gte 'foo' # output all keys after 'foo' lev $db_path --keys --gte 'foo' # the same for values lev $db_path --values --gte 'foo'For keys and values strictly greater tha
End the range at keys lower than or equal to <key-pattern>. For strictly lower than, use --.
# output all keys and values before 'fooz' (implicit --all) lev $db_path --lte 'fooz' # output all keys before 'fooz' lev $db_path --keys --lte 'fooz' # the same for values lev $db_path --values --lte 'fooz' # output all keys between 'foo' and 'fooz' lev $db_path --keys --gte 'foo' --lte 'fooz' # which is equivalent toGet all entries for which the key starts by a given prefix
# get all the keys starting by foo lev $db_path --keys --prefix 'foo' # which is equivalent to lev $db_path --keys --gte 'foo' --lte 'foo\uffff'Filter results by a pattern applied on the keys
lev --keys --match 'f*' lev --values --match 'f*' lev --all --match 'f*' # Equivalent to lev $db_path --match 'f*'See minimatch doc for patterns
Limit the number of records emitted in the current range.
lev $db_path --keys --limit 10 lev $db_path --values --prefix 'foo' --limit 100 lev $db_path --match 'f*' --limit 10Reverse the stream.
lev $db_path --keys --reverse lev $db_path --keys --prefix 'foo' --limit 100 --reverseOutput the count of results in the selected range
# Count all the key/value pairs in the database lev $db_path --count # Counts the keys and values between 'foo' and 'fooz' lev $db_path --prefix 'foo' --countSpecify the encoding for the keys (Defaults to 'utf8').
lev $db_path --put 019a17595db1 --keyEncoding hex --value "" lev $db_path --put AZoXWV5c --keyEncoding base64 --value "" lev $db_path --keys --keyEncoding utf8 lev $db_path --keys --keyEncoding json lev $db_path --keys --keyEncoding hex lev $db_path --keys --keyEncoding base64Specify the encoding for the values (Defaults to 'utf8').
lev $db_path --values --valueEncoding utf8 lev $db_path --values --valueEncoding json lev $db_path --values --valueEncoding hex lev $db_path --values --valueEncoding base64Specify the path to the LevelDB to use. Defaults to the current directory.
lev $db_path --location /tmp/test-db --keys # Equivalent to lev /tmp/test-db --keysPass results in a map function
- either inline
lev $db_path --keys --map 'key => key.split(":")[1]' lev $db_path --all --map 'data => data.value.replace(data.key, "")'- or from a JS file that exports a function
# in ./map_fn.js module.exports = key => key.split(":")[1]lev $db_path --keys --map ./map_fn.jsIf the function, returns null or undefined, the result is filtered-out
This can be used to update the whole database:
# Create a map function that returns an object with the key and an updated value echo 'module.exports = ({ key, value }) => ({ key, value: value.replace('foo', 'bar') })' > ./update_values.js # Create an updated export of the database lev $db_path --map ./update_values.js > ./updated_db # And re-import lev $db_path --batch ./updated_db