Skip to content

Commit 5d514e0

Browse files
Set default unstable version and update readme.md (#55)
Signed-off-by: Karthik Subbarao <[email protected]>
1 parent 9d403c4 commit 5d514e0

File tree

4 files changed

+27
-27
lines changed

4 files changed

+27
-27
lines changed

Cargo.toml

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
[package]
22
name = "valkey-bloom"
33
authors = ["Karthik Subbarao"]
4-
version = "0.1.0-dev"
4+
version = "99.99.99-dev"
55
edition = "2021"
66
license = "BSD-3-Clause"
77
repository = "https://github.com/valkey-io/valkey-bloom"

QUICK_START.md

+23-23
Original file line numberDiff line numberDiff line change
@@ -1,58 +1,58 @@
11
# Quick Start
2-
2+
33
Follow these steps to set up, build, and run the Valkey server with the valkey-bloom module. This guide will walk you through creating a bloom filter, inserting items, and checking for items in the filters.
4-
4+
55
## Step 1: Install Valkey and valkey-bloom
6-
6+
77
1. Build Valkey from source by following the instructions [here](https://github.com/valkey-io/valkey?tab=readme-ov-file#building-valkey-using-makefile). Make sure to use Valkey version 8.0 or above.
8-
8+
99
2. Build the valkey-bloom module from source by following the instructions [here](https://github.com/valkey-io/valkey-bloom/blob/unstable/README.md#build-instructions).
10-
10+
1111
## Step 2: Run the Valkey Server with valkey-bloom
12-
12+
1313
Once valkey-bloom is built, run the Valkey server with the module loaded:
14-
14+
1515
In case of Linux:
1616
```bash
1717
./valkey-server --loadmodule ./target/release/libvalkey_bloom.so
1818
```
19-
19+
2020
You should see the Valkey server start, and it will be ready to accept commands.
21-
21+
2222
## Step 3: Create a Bloom Filter
23-
23+
2424
Start a Valkey CLI session:
25-
25+
2626
```bash
2727
valkey-cli
2828
```
29-
29+
3030
Create a bloom filter using the BF.ADD, BF.INSERT, BF.RESERVE or BF.MADD commands. For example:
31-
31+
3232
```bash
3333
BF.ADD filter-key item-val
3434
```
35-
35+
3636
- `filter-key` is the name of the bloom filter we will be operating on
3737
- `item-val` is the item we are inserting into the bloom filter
38-
38+
3939
## Step 4: Insert some more items
40-
40+
4141
To insert items on an already created filter, use the `BF.ADD`, `BF.MADD` or `BF.INSERT` commands:
42-
42+
4343
```bash
4444
BF.ADD filter-key example
4545
BF.MADD filter-key example1 example2
4646
```
47-
47+
4848
Replace the example with the actual items you want to add.
49-
49+
5050
## Step 5: Check if items are present
51-
51+
5252
Now that you've created a bloom filter and inserted items, you can check what items have been added. Use the `BF.EXISTS` or `BF.MEXISTS` commands to check for items:
53-
53+
5454
```bash
5555
BF.EXISTS filter-key example
5656
```
57-
58-
This command checks if an item is present in a bloom filter. Bloom filters can have false positives, but no false negatives. This means that if the BF.EXISTS command returns 0, then the item is not present. But if the BF.EXISTS command returns 1 then there is a possibility (determined by false positive rate) that the item is not actually present.
57+
58+
This command checks if an item is present in a bloom filter. Bloom filters can have false positives, but no false negatives. This means that if the BF.EXISTS command returns 0, then the item is not present. But if the BF.EXISTS command returns 1, there is a possibility (determined by false positive rate) that the item is not actually present.

README.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
# valkey-bloom
22

3-
Valkey-Bloom (BSD-3-Clause) is a Rust Valkey-Module which brings a native and space efficient probabilistic Module data type to Valkey. With this, users can create filters (space-efficient probabilistic Module data type) to add elements, perform “check” operation to test whether an element exists, auto scale their filters, perform RDB Save and load operations, etc.
3+
Valkey-Bloom (BSD-3-Clause) is a Rust based Valkey-Module which brings a Bloom Filter (Module) data type into Valkey and supports verions >= 8.0. With this, users can create bloom filters (space efficient probabilistic data structures) to add elements, perform “check” operation to test whether an element exists, auto scale their filters, customize bloom filter properties, perform RDB Save and load operations, etc.
44

55
Valkey-Bloom is built using `bloomfilter::Bloom` (https://crates.io/crates/bloomfilter which has a BSD-2-Clause license).
66

7-
It is compatible with the BloomFilter (BF.*) command APIs in Redis offerings.
7+
It is API compatible with the bloom filter command syntax of the official Valkey client libraries including valkey-py, valkey-java, valkey-go (as well as the equivalent Redis libraries)
88

99
## Supported commands
1010
```

src/lib.rs

+1-1
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ use crate::bloom::utils::valid_server_version;
1313
use valkey_module_macros::info_command_handler;
1414

1515
pub const MODULE_NAME: &str = "bf";
16-
pub const MODULE_VERSION: i32 = 000000;
16+
pub const MODULE_VERSION: i32 = 999999;
1717
// The release stage is used in order to provide release status information.
1818
// In unstable branch the status is always "dev".
1919
// During release process the status will be set to rc1,rc2...rcN.

0 commit comments

Comments
 (0)