<head>
<meta name="Momento Python Client Library Documentation" content="Python client software development kit for Momento Cache">
</head>
<img src="https://docs.momentohq.com/img/momento-logo-forest.svg" alt="logo" width="400"/>
[](https://github.com/momentohq/standards-and-practices/blob/main/docs/momento-on-github.md)
[](https://github.com/momentohq/standards-and-practices/blob/main/docs/momento-on-github.md)
# Momento Python 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 Python client library.
To get started with Momento you will need a Momento Auth Token. You can get one from the [Momento Console](https://console.gomomento.com).
* Website: [https://www.gomomento.com/](https://www.gomomento.com/)
* Momento Documentation: [https://docs.momentohq.com/](https://docs.momentohq.com/)
* Getting Started: [https://docs.momentohq.com/getting-started](https://docs.momentohq.com/getting-started)
* Python SDK Documentation: [https://docs.momentohq.com/sdks/python](https://docs.momentohq.com/sdks/python)
* Discuss: [Momento Discord](https://discord.gg/3HkAKjUZGq)
## Packages
The Momento Python SDK package is available on pypi: [momento](https://pypi.org/project/momento/).
## Usage
The examples below require an environment variable named `MOMENTO_API_KEY` which must
be set to a valid Momento API key. You can get one from the [Momento Console](https://console.gomomento.com).
Python 3.10 introduced the `match` statement, which allows for [structural pattern matching on objects](https://peps.python.org/pep-0636/#adding-a-ui-matching-objects).
If you are running python 3.10 or greater, here is a quickstart you can use in your own project:
```python
from datetime import timedelta
from momento import CacheClient, Configurations, CredentialProvider
from momento.responses import CacheGet
cache_client = CacheClient(
Configurations.Laptop.v1(), CredentialProvider.from_environment_variable("MOMENTO_API_KEY"), timedelta(seconds=60)
)
cache_client.create_cache("cache")
cache_client.set("cache", "my-key", "my-value")
get_response = cache_client.get("cache", "my-key")
match get_response:
case CacheGet.Hit() as hit:
print(f"Got value: {hit.value_string}")
case _:
print(f"Response was not a hit: {get_response}")
```
The above code uses [structural pattern matching](https://peps.python.org/pep-0636/), a feature introduced in Python 3.10.
Using a Python version less than 3.10? No problem. Here is the same example compatible across all versions of Python:
```python
from datetime import timedelta
from momento import CacheClient, Configurations, CredentialProvider
from momento.responses import CacheGet
cache_client = CacheClient(
configuration=Configurations.Laptop.v1(),
credential_provider=CredentialProvider.from_environment_variable("MOMENTO_API_KEY"),
default_ttl=timedelta(seconds=60),
)
cache_client.create_cache("cache")
cache_client.set("cache", "myKey", "myValue")
get_response = cache_client.get("cache", "myKey")
if isinstance(get_response, CacheGet.Hit):
print(f"Got value: {get_response.value_string}")
```
## Getting Started and Documentation
Documentation is available on the [Momento Docs website](https://docs.momentohq.com).
## Examples
Working example projects, with all required build configuration files, are available for both Python 3.10 and up
and Python versions before 3.10:
* [Python 3.10+ examples](./examples/py310)
* [Pre-3.10 Python examples](./examples/prepy310)
## Developing
If you are interested in contributing to the SDK, please see the [CONTRIBUTING](./CONTRIBUTING.md) docs.
----------------------------------------------------------------------------------------
For more info, visit our website at [https://gomomento.com](https://gomomento.com)!
Raw data
{
"_id": null,
"home_page": "https://gomomento.com",
"name": "momento",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.7",
"maintainer_email": null,
"keywords": "Momento, caching, key-value store, serverless",
"author": "Momento",
"author_email": "hello@momentohq.com",
"download_url": "https://files.pythonhosted.org/packages/fe/ce/18c693a730df232aa1ab5627b559066efc106301dc28cbfdcc6acc3ec049/momento-1.24.0.tar.gz",
"platform": null,
"description": "<head>\n <meta name=\"Momento Python Client Library Documentation\" content=\"Python client software development kit for Momento Cache\">\n</head>\n<img src=\"https://docs.momentohq.com/img/momento-logo-forest.svg\" alt=\"logo\" width=\"400\"/>\n\n[](https://github.com/momentohq/standards-and-practices/blob/main/docs/momento-on-github.md)\n[](https://github.com/momentohq/standards-and-practices/blob/main/docs/momento-on-github.md)\n\n# Momento Python Client Library\n\nMomento Cache is a fast, simple, pay-as-you-go caching solution without any of the operational overhead\nrequired by traditional caching solutions. This repo contains the source code for the Momento Python client library.\n\nTo get started with Momento you will need a Momento Auth Token. You can get one from the [Momento Console](https://console.gomomento.com).\n\n* Website: [https://www.gomomento.com/](https://www.gomomento.com/)\n* Momento Documentation: [https://docs.momentohq.com/](https://docs.momentohq.com/)\n* Getting Started: [https://docs.momentohq.com/getting-started](https://docs.momentohq.com/getting-started)\n* Python SDK Documentation: [https://docs.momentohq.com/sdks/python](https://docs.momentohq.com/sdks/python)\n* Discuss: [Momento Discord](https://discord.gg/3HkAKjUZGq)\n\n## Packages\n\nThe Momento Python SDK package is available on pypi: [momento](https://pypi.org/project/momento/).\n\n## Usage\n\nThe examples below require an environment variable named `MOMENTO_API_KEY` which must\nbe set to a valid Momento API key. You can get one from the [Momento Console](https://console.gomomento.com).\n\nPython 3.10 introduced the `match` statement, which allows for [structural pattern matching on objects](https://peps.python.org/pep-0636/#adding-a-ui-matching-objects).\nIf you are running python 3.10 or greater, here is a quickstart you can use in your own project:\n\n```python\nfrom datetime import timedelta\n\nfrom momento import CacheClient, Configurations, CredentialProvider\nfrom momento.responses import CacheGet\n\ncache_client = CacheClient(\n Configurations.Laptop.v1(), CredentialProvider.from_environment_variable(\"MOMENTO_API_KEY\"), timedelta(seconds=60)\n)\n\ncache_client.create_cache(\"cache\")\ncache_client.set(\"cache\", \"my-key\", \"my-value\")\nget_response = cache_client.get(\"cache\", \"my-key\")\nmatch get_response:\n case CacheGet.Hit() as hit:\n print(f\"Got value: {hit.value_string}\")\n case _:\n print(f\"Response was not a hit: {get_response}\")\n\n```\n\nThe above code uses [structural pattern matching](https://peps.python.org/pep-0636/), a feature introduced in Python 3.10.\nUsing a Python version less than 3.10? No problem. Here is the same example compatible across all versions of Python:\n\n```python\nfrom datetime import timedelta\n\nfrom momento import CacheClient, Configurations, CredentialProvider\nfrom momento.responses import CacheGet\n\ncache_client = CacheClient(\n configuration=Configurations.Laptop.v1(),\n credential_provider=CredentialProvider.from_environment_variable(\"MOMENTO_API_KEY\"),\n default_ttl=timedelta(seconds=60),\n)\ncache_client.create_cache(\"cache\")\ncache_client.set(\"cache\", \"myKey\", \"myValue\")\nget_response = cache_client.get(\"cache\", \"myKey\")\nif isinstance(get_response, CacheGet.Hit):\n print(f\"Got value: {get_response.value_string}\")\n\n```\n\n## Getting Started and Documentation\n\nDocumentation is available on the [Momento Docs website](https://docs.momentohq.com).\n\n## Examples\n\nWorking example projects, with all required build configuration files, are available for both Python 3.10 and up\nand Python versions before 3.10:\n\n* [Python 3.10+ examples](./examples/py310)\n* [Pre-3.10 Python examples](./examples/prepy310)\n\n## Developing\n\nIf you are interested in contributing to the SDK, please see the [CONTRIBUTING](./CONTRIBUTING.md) docs.\n\n----------------------------------------------------------------------------------------\nFor more info, visit our website at [https://gomomento.com](https://gomomento.com)!\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "SDK for Momento",
"version": "1.24.0",
"project_urls": {
"Documentation": "https://docs.momentohq.com/",
"Homepage": "https://gomomento.com",
"Repository": "https://github.com/momentohq/client-sdk-python"
},
"split_keywords": [
"momento",
" caching",
" key-value store",
" serverless"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ada2df5b98067e010ed94bde3c7a0650de488287d9b1418c76e2a2f864f6e664",
"md5": "3d7363af539ae42ec355b390a4a9f710",
"sha256": "d885a38c607eccc23227e05e09b673cd743d88b468ee52b23daf7df4e6c2d456"
},
"downloads": -1,
"filename": "momento-1.24.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3d7363af539ae42ec355b390a4a9f710",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.7",
"size": 133616,
"upload_time": "2024-09-27T22:31:45",
"upload_time_iso_8601": "2024-09-27T22:31:45.275117Z",
"url": "https://files.pythonhosted.org/packages/ad/a2/df5b98067e010ed94bde3c7a0650de488287d9b1418c76e2a2f864f6e664/momento-1.24.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fece18c693a730df232aa1ab5627b559066efc106301dc28cbfdcc6acc3ec049",
"md5": "c7d62a5452ad7f31d32d7433e5a1f37c",
"sha256": "dda27470d4946b76cb588ef04ae09e99cb30b95747f738d81f4321339c03a6a3"
},
"downloads": -1,
"filename": "momento-1.24.0.tar.gz",
"has_sig": false,
"md5_digest": "c7d62a5452ad7f31d32d7433e5a1f37c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.7",
"size": 80220,
"upload_time": "2024-09-27T22:31:47",
"upload_time_iso_8601": "2024-09-27T22:31:47.213897Z",
"url": "https://files.pythonhosted.org/packages/fe/ce/18c693a730df232aa1ab5627b559066efc106301dc28cbfdcc6acc3ec049/momento-1.24.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-27 22:31:47",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "momentohq",
"github_project": "client-sdk-python",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "momento"
}
JSON
