Struct rust_actions_cache_api::Cache

pub struct Cache { /* fields omitted */ }

Client for the cache API.

Reusing a single client for multiple requests is potentially more efficient due to connection reuse.

Implementations

impl Cache

pub fn new() -> Result<Self>

Creates a new client instance.

pub async fn get_url(
    &self,
    key_space: &str,
    key_prefixes: &[&str]
) -> Result<Option<(CacheHit, String)>>

Performs a cache lookup and returns the URL for a matching entry.

• key_space - parameter is an identifier, usually a hex string, which must match exactly
• key_prefixes - list of key prefixes to look up in order of preference

See the official documentation for the precedence in case of multiple matching entries. Note that key_space is not exposed by the official client and thus not mentioned there.

pub async fn get_bytes(
    &self,
    key_space: &str,
    keys: &[&str]
) -> Result<Option<(CacheHit, Bytes)>>

Performs a cache lookup and returns the content of a matching entry.

See get_url for details about the lookup.

pub async fn put_bytes(
    &self,
    key_space: &str,
    key: &str,
    data: Bytes
) -> Result<()>

Stores an entry in the cache.