Accessing cache

Runnables can access an attached cache (such as Redis) using the cache namespace of the Runnable API. Atmo will configure the cache, and will bind it to the Runnable at runtime. Atmo provides a default in-memory cache if no external cache is connected.

Documentation for connecting an external cache to Atmo is coming soon.

For Rust, these methods are available under the cache module, for example cache::get(). For Swift, they are prefixed with Cache, for example Suborbital.CacheGet(). For TypeScript/AssemblyScript, they are prefixed with cache, for example import { cacheGet } from '@suborbital/suborbital'

The following namespace methods are available:


Set a given key's value in the cache. The provided TTL is in seconds.

pub fn set(key: &str, val: Vec<u8>, ttl: i32)
function cacheSet(key: string, value: ArrayBuffer, ttl: i32): void
public func CacheSet(key: String, value: String, ttl: Int)


Get the provided key from the cache.

pub fn get(key: &str) -> Result<Vec<u8>, RunErr>
function cacheGet(key: string): ArrayBuffer
public func CacheGet(key: String) -> String

Additional cache operations are coming soon.