Momento client-sdk-python

⚠️ Experimental SDK ⚠️

Python SDK for Momento is experimental and under active development. There could be non-backward compatible changes or removal in the future. Please be aware that you may need to update your source code with the current version of the SDK when its version gets upgraded.

Python SDK for Momento, a serverless cache that automatically scales without any of the operational overhead required by traditional caching solutions.

Getting Started 🏃

Requirements

Python 3.7 or above is required
A Momento Auth Token is required, you can generate one using the Momento CLI

Installing Momento and Running the Example

Check out our Python SDK example repo!

Using Momento

import os
import momento.simple_cache_client as simple_cache_client

# Initializing Momento
_MOMENTO_AUTH_TOKEN = os.getenv('MOMENTO_AUTH_TOKEN')
_ITEM_DEFAULT_TTL_SECONDS = 60
simple_cache_client.init(_MOMENTO_AUTH_TOKEN, _ITEM_DEFAULT_TTL_SECONDS) as cache_client

# Creating a cache named "cache"
_CACHE_NAME = 'cache'
cache_client.create_cache(_CACHE_NAME)

# Sets key with default TTL and get value with that key
_KEY = 'MyKey'
_VALUE = 'MyValue'
cache_client.set(_CACHE_NAME, _KEY, _VALUE)
get_resp = cache_client.get(_CACHE_NAME, _KEY)
print(f'Looked up Value: {str(get_resp.value())}')

# Sets key with TTL of 5 seconds
cache_client.set(_CACHE_NAME, _KEY, _VALUE, 5)

# Permanently deletes cache
cache_client.delete_cache(_CACHE_NAME)

Running Tests ⚡

Integration tests require an auth token for testing. Set the env var TEST_AUTH_TOKEN to provide it. The env TEST_CACHE_NAME is also required, but for now any string value works.

Example of running tests against all python versions:

TEST_AUTH_TOKEN=<auth token> TEST_CACHE_NAME=<cache name> tox

Example of running tests against one specific python version:

TOXENV=py39 TEST_AUTH_TOKEN=<auth token> TEST_CACHE_NAME=<cache name> tox

tylerburdsall / client-sdk-python