momento

Crates.iomomento
lib.rsmomento
version0.39.6
sourcesrc
created_at2022-04-07 23:41:41.544251
updated_at2024-05-23 23:52:32.080006
descriptionClient SDK for Momento services
homepagehttps://gomomento.com/
repositoryhttps://github.com/momentohq/client-sdk-rust
max_upload_size
id563965
size514,921
(momento-github-actions-machine-user)

documentation

README

logo

project status project stability

Momento Rust Client Library

Momento Cache is a fast, simple, pay-as-you-go caching solution without any of the operational overhead required by traditional caching solutions. This repo contains the source code for the Momento Rust client library.

To get started with Momento you will need a Momento Auth Token. You can get one from the Momento Console.

Packages

The Momento Rust SDK package is available on crates.io: momento.

You will need to install additional dependencies to make full use of our SDK:

cargo add momento
cargo add tokio --features full
cargo add futures

Note: you will only need to install futures if you use Momento Topics.

Usage

Here is a quickstart you can use in your own project:

use momento::cache::{configurations::Laptop, GetResponse};
use momento::{CacheClient, CredentialProvider, MomentoError};
use std::time::Duration;

const CACHE_NAME: &str = "cache";

#[tokio::main]
pub async fn main() -> Result<(), MomentoError> {
    let cache_client = CacheClient::builder()
        .default_ttl(Duration::from_secs(60))
        .configuration(Laptop::latest())
        .credential_provider(CredentialProvider::from_env_var(
            "MOMENTO_API_KEY".to_string(),
        )?)
        .build()?;

    cache_client.create_cache(CACHE_NAME.to_string()).await?;

    match cache_client.set(CACHE_NAME, "mykey", "myvalue").await {
        Ok(_) => println!("Successfully stored key 'mykey' with value 'myvalue'"),
        Err(e) => println!("Error: {}", e),
    }

    let value: String = match cache_client.get(CACHE_NAME, "mykey").await? {
        GetResponse::Hit { value } => value.try_into().expect("I stored a string!"),
        GetResponse::Miss => {
            println!("Cache miss!");
            return Ok(()); // probably you'll do something else here
        }
    };
    println!("Successfully retrieved value: {}", value);

    Ok(())
}

Note that the above code requires an environment variable named MOMENTO_API_KEY which must be set to a valid Momento authentication token.

Getting Started and Documentation

Documentation is available on the Momento Docs website.

Examples

Ready to dive right in? Just check out the example directory for complete, working examples of how to use the SDK.

Developing

If you are interested in contributing to the SDK, please see the CONTRIBUTING docs.


For more info, visit our website at https://gomomento.com!

Commit count: 254

cargo fmt