valkey-glide 0.9.0

Valkey GLIDE — native Rust client for Valkey and Redis OSS, built on glide-core.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

// Copyright Valkey GLIDE Project Contributors - SPDX Identifier: Apache-2.0
//! String commands. Mirrors Python's string command surface.

use crate::ValkeyResult;
use crate::cmd::Cmd;
use crate::executor::CommandExecutor;
use crate::value::FromValkeyValue;
use crate::value::ValkeyValue;
use crate::write::ToValkeyArgs;
use async_trait::async_trait;
use bytes::Bytes;

/// String commands (`GET`, `SET`, `APPEND`, `INCR`, ...).
#[async_trait]
pub trait StringCommands: CommandExecutor {
    /// Longest common subsequence length between two keys (`LCS ... LEN`).
    async fn lcs_len<K1: ToValkeyArgs + Send, K2: ToValkeyArgs + Send>(
        &self,
        key1: K1,
        key2: K2,
    ) -> ValkeyResult<i64> {
        let mut cmd = Cmd::new();
        cmd.arg("LCS").arg(key1).arg(key2).arg("LEN");
        i64::from_owned_valkey_value(self.execute_command(cmd, None).await?)
    }

    /// Get the longest common subsequence of two keys (`LCS`).
    async fn lcs<K1: ToValkeyArgs + Send, K2: ToValkeyArgs + Send>(
        &self,
        key1: K1,
        key2: K2,
    ) -> ValkeyResult<Bytes> {
        let mut cmd = Cmd::new();
        cmd.arg("LCS").arg(key1).arg(key2);
        Bytes::from_owned_valkey_value(self.execute_command(cmd, None).await?)
    }

    /// Get the LCS match positions between two keys (`LCS ... IDX`). Returns the
    /// raw structured reply (a map of `matches`/`len`). Pass `min_match_len` to
    /// filter short matches, and `with_match_len` to include per-match lengths.
    async fn lcs_idx<K1: ToValkeyArgs + Send, K2: ToValkeyArgs + Send>(
        &self,
        key1: K1,
        key2: K2,
        min_match_len: Option<i64>,
        with_match_len: bool,
    ) -> ValkeyResult<ValkeyValue> {
        let mut cmd = Cmd::new();
        cmd.arg("LCS").arg(key1).arg(key2).arg("IDX");
        if let Some(m) = min_match_len {
            cmd.arg("MINMATCHLEN").arg(m);
        }
        if with_match_len {
            cmd.arg("WITHMATCHLEN");
        }
        self.execute_command(cmd, None).await
    }
}

impl<T: CommandExecutor + ?Sized> StringCommands for T {}