A CLI for managing LevelDB instances.
This repo is a fork of lev, originally to make those changes available from NPM
v8.0.0. If you need it, use an earlier version or the original lev package.$ npm install -g lev2
These all match the parameters used with levelup. The default encoding for the database is set to json.
Get a value
lev $dbpath --get foo
Put 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 hex
Delete a value
lev $db_path --del foo
Can 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 --batch
Put 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.json
If 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.export
If 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 --batch
The --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 --keys
Can be used in combination with --del to generate a stream of delete operations
lev $db_path --keys --del | lev $db_path --batch
List all the values in the current range. Emit as a new-line delimited stream of json.
lev $db_path --values
List all the keys and values in the current range. Emit as a new-line delimited stream of json.
lev $db_path --all
It 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.export
It 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 to
Get 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 10
Reverse the stream.
lev $db_path --keys --reverse
lev $db_path --keys --prefix 'foo' --limit 100 --reverse
Output 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' --count
Specify 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 base64
Specify 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 base64
Specify 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 --keys
Pass results in a map function
lev $db_path --keys --map 'key => key.split(":")[1]'
lev $db_path --all --map 'data => data.value.replace(data.key, "")'
# in ./map_fn.js
module.exports = key => key.split(":")[1]
lev $db_path --keys --map ./map_fn.js
If 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
FAQs
CLI for LevelDB
The npm package lev2 receives a total of 68 weekly downloads. As such, lev2 popularity was classified as not popular.
We found that lev2 demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Security News
Agent Baseline’s new reference architecture shows how to secure software factories with four boundaries enforced outside the AI agent.
Security News
arXiv now limits authors to two submissions a month as AI slop overwhelms moderators, delays good papers, and sparks debate over applying the limit to everyone.
Research
/Security News
A new GhostAction wave hits hundreds of GitHub repos, expanding CI/CD secret theft to cloud and AI credentials in source code and git history.