v1.29.0

1.29.0 (2026-09-01)

⚠ BREAKING CHANGES

• requires momento-wire-types >=0.135.0 and protobuf >=7.35.1,<8, and raises the minimum Python to 3.10. Support for protobuf 3 and 4 is removed.

Features

• #85: MVP dictionary API (#98) (c4c6bb1)
• 1.0 error and response types for signing key operations (#274) (0f42bd8)
• 1.0 release (#307) (f63d0ed)
• Add a credential provider for Momento Local (#501) (9f809c8)
• Add a parameterized Simple Cache Client (#21) (ce1c252)
• add asyncio client (#28) (67b0484)
• add auth client and generate_disposable_token api (#460) (693a059)
• Add client-side implementation of exists (#115) (7cf76bd)
• Add common response str and repr (#258) (b9e5235)
• add configuration classes (#178) (1500893)
• Add debug logger (527cd47)
• Add debug logger (#11) (7e2c62b)
• Add delete functionality (#100) (72b6bb7)
• add grpc config options and turn off keepalive for Lambda config (#441) (b129716)
• Add ListCaches (#10) (6ded6f8)
• add middleware (#502) (1230510)
• add mvi delete by filter overload (#437) (2c48119)
• add mvi search and fetch vectors method (#399) (d397f92)
• add mvi search score threshold (#397) (4c5c6b1)
• add pubsub (#353) (ac7b626)
• add signing key control operations back in (#210) (f577224)
• Add sorted set get score and rank (#326) (163688b)
• Add sorted set put and fetch methods (#324) (5695ae5)
• Add sorted set remove and increment (#327) (aaddbcc)
• add support for CreateSigningKey, RevokeSigningKey, and ListSigningKeys APIs (#81) (6b3fa09)
• add support for retrying failed requests (#124) (b65f8fb)
• Add support for Timeouts for Gets and Sets (#50) (facf5b0)
• add support for v1 auth tokens (#319) (f945e9f)
• add support through python 3.11 (#155) (176e75c)
• add support to create pre-signed URLs (#78) (262ac0f)
• Add test matrix for 3.10 (#58) (d2342f3)
• add topic grpc config and transport strategy and make sure publish deadline is set (#496) (bfac90d)
• add traces with open telemetry (#344) (3319e78)
• add vanilla example for mvi (#371) (3ca90e6)
• add vector index client (#358) (144569a)
• adds flush api (#329) (25d8df4)
• allow custom root certificates in cache client (#395) (c1a3abf)
• allow custom root certificates in vector index client config (#394) (3a2c7f0)
• Base implementation for Cache Operations (#2) (39bbe5b)
• bug fix - sorted_set_increment should be named sorted_set_increment_score (#347) (fc735a8)
• Complete list ops (#230) (207fea2)
• dictionary implementation (#237) (7000d22)
• dictionary multi-get, unary set, and TTL. (#110) (c0cc070)
• dictionary stub implementation (#229) (b2ebea6)
• Disambiguate wiretypes from SDK types (#48) (c23bbda)
• Enforce keyword args for optional arguments. (#260) (61a28a6)
• error and response types (#179) (bd4960f)
• export types to be PEP561 compliant (#206) (8263bac)
• First collections methods. (#205) (0736132)
• implement get item batch and variant (#417) (a28a177)
• Improve validation errors. (#232) (0caa89c)
• increment() (#245) (78ba6cc)
• Initial checkin that allows basic setup (#1) (36ee5bf)
• list_concatenate_front() (#227) (920470b)
• make the retry logic configurable (#299) (f2ec853)
• migrate synchronous API to consume gRPC synchronous API (#163) (c9e1a34)
• Modernize the Python load-gen example. (#168) (bc2f876)
• mvi api wave 2 - upsert, similarity, and all metadata (#383) (7aa55c7)
• mvi count items (#427) (fcede36)
• mvi filter expressions (#425) (a30db8f)
• mvi id in set filter expression (#430) (1295167)
• new credential provider methods for accepting global api keys (#512) (6809b6e)
• Open source and publish package to PyPI (#60) (824299a)
• order system example (#458) (01fb509)
• promote project stability from alpha to beta (#263) (b29992a)
• read version from package init (#481) (6ca2525)
• relax grpcio dependency lower bound (#333) (ebcd70d)
• remove incubating, get-multi, and set-multi client-side apis (#156) (0b53069)
• remove signing key APIs (#195) (60df3d7)
• remove vector client (#450) (268068f)
• rename cache client from SimpleCacheClient to CacheClient (#304) (0c8ced9)
• require protobuf 7 via momento-wire-types 0.135 (#523) (49a7b36)
• Set methods (#235) (20e357f)
• set_if_not_exists() (#243) (44b5f1c)
• Stop parsing ECacheResult.Ok (#25) (b96ae03)
• support for multiple gRPC channels (#125) (3606a77)
• support more vector item metadata value types (#392) (7e1649c)
• support mvi list indexes detail (#408) (6b21cb2)
• support protobuf<3.20 (#336) (a8c73c0)
• support topic sequence page (#492) (d8e5039)
• use modern python type hint syntax (#251) (c83ba8b)
• Validate the CollectionTtl.ttl is positive. (#224) (3a774d4)
• wire method to get and set eager connection timeout (#365) (5f82ba4)

Bug Fixes

• add back return statements for closed streams (#356) (f2c9376)
• add env variables for integration tests (#63) (433f694)
• add GenerateDisposableToken Success and Error subclasses to responses init file (#468) (6295cc6)
• audit response hierarchy (#298) (a67668a)
• bug where the repr for Cred Provider would mutate it (#316) (0cae587)
• bump and pin libs to resolve grpc vuln (#140) (2d1e829)
• bump version (#362) (9b6dbf5)
• change library python upper bound to 4 (#331) (87947b4)
• codegen import with one import from that is async (#261) (92201ee)
• correct some issues with CI/CD jobs, move build to tox (#49) (3b2afab)
• disable dynamic DNS service config (#497) (d677563)
• disable keepalive in grpc channel options for control plane clients and set grpc channel options in synchronous code (#443) (3b14375)
• do not use test util in package (#464) (a558c0b)
• don't call retry logic on OK status codes (#320) (7e93db2)
• Ensure test caches are cleaned up. (#191) (284acea)
• fix sorted set fetch by score and add tests (#359) (4b10ce3)
• fix tests to use latest credential provider (#238) (53bc313)
• fix version of generate readme action (#341) (d72c28e)
• Flatten exception hierarchy (#44) (9a7fb98)
• Handle GRPC Error Codes. (#42) (8f68a1f)
• Increase sleep in tests to account for TTL precisions (#53) (c4616fa)
• incubating dictionary convenience methods (#104) (8bf614a)
• Integration tests (#39) (41948be)
• isolate test cache names on push to release (#214) (9a16995)
• lint errors on 3.10+ for auth protos (#479) (e3be891)
• make sure to import GenerateDisposableToken response class before exporting it in init file (#470) (e7ee744)
• make ttl a required attribute (#80) (ad76f68)
• Manual Workflow YAML :crossed_fingers (#59) (483c7e7)
• Method Names and Add Code Hints (#41) (462406b)
• mitigate m1 incompatibility (#66) (9b3b6f7)
• momento logger function definitions (#102) (7726aa6)
• pin ubuntu and poetry ci dependencies (#165) (ff7512f)
• prefer importlib_metadata to deprecated pkg_resources (#340) (52a6ca3)
• public vs private library imports (#297) (c1a24d5)
• Push always uses default version (#7) (a582ac9)
• re-introduce retry interceptor for synchronous client (#171) (a66746d)
• remove client-side expiry check on disposable tokens (#518) (60fbb19)
• remove extraneous echo from make target (#202) (e47c510)
• remove manual release footgun (#325) (be3aa30)
• Return explicit message for OK Responses with incorrect state (#12) (56817ab)
• Scalar cache response description of the request. (#208) (1526f76)
• Services now return UNAUTHENTICATE instead of PERMISSION_DENIED (#46) (529be21)
• set the release please base version in the manifest (#476) (52f2f2b)
• spelling of "Framework" in project config (#144) (11d849f)
• subscriptions bookkeeping in pubsub clients (#510) (0d5e514)
• timedelta to ms conversion and timedelta to deadline conversion (#442) (14a84ca)
• typos in error logging (#350) (d8bef74)
• Unpin dependencies to avoid library conflicts. (#207) (f5c0c01)
• update 'cryptography' pkg fix openssl vuln (#150) (8f1aa9f)
• update example location (#218) (6d53ce7)
• update poetry.lock, mostly to bump pyyaml to 6.0.1 (#360) (e61be91)
• use != instead of is not (#13) (5d961b8)
• Use relative imports (#34) (c8103d4)
• use relative imports everywhere in src, clean up test import (#55) (17f533b)
• validate vector index item metadata on serialization (#391) (ec2b7c3)
• when detecting momento version also catch ModuleNotFoundError (#459) (deebc69)
• workaround to make our grpc interceptor more flexible (#148) (f0c5ca3)

Miscellaneous

• add 'black' formatter to tox build environment (#52) (4f2bb63)
• Add agent metadata (#75) (d2ebf0b)
• Add CONTRIBUTING.md and update README.md (#64) (a8f8990)
• add a hardcoded example for prepy310 to the README template (#259) (9341b2f)
• add agent details and new runtime version header (#456) (7a59011)
• add caching patterns section (#451) (9c3ef8c)
• add client instantiation example to docs (#272) (a58f6c2)
• add collection ttl data class (#188) (461208e)
• add comments as fenceposts to reduce merge conflicts (#201) (15a75ca)
• add doc examples for auth client (#466) (0f6973e)
• add doc examples for the vector index client (#390) (19d22c8)
• add docs examples for using topics (#382) (7f46449)
• Add incubating README and clean up incubating reprs. (#105) (4290647)
• add lambda zip example (#452) (c9c01ac), closes #819
• add less verbose quickstart examples for README (#306) (dd457a3)
• add method documentation (#15) (e053811)
• add module centralizing type hints (#213) (8fc9444)
• add more mvi examples and move to examples folders (#389) (c5a52d9)
• add mvi filter expression example snippets (#433) (80d26a8)
• add mypy type checker to build commands (#51) (a17d2d0)
• Add repr and str methods to response objects (#113) (74dfdc6)
• Add rust requirement to CONTRIBUTING.md (#271) (be43fc7)
• add shared build step to pr build (#136) (ac9ffd6)
• add tests for the fixed count retry strategy (#503) (ac7bdb8)
• add timeout to topic subscribe (#511) (0169714)
• add trace level logging (#302) (21cfaf2)
• add v1 configurations (#303) (1469fee)
• Adding a rest keyword to the REST endpoint. (#82) (faadcdb)
• adding initial doc code samples (#339) (16d0986)
• adds code scanning workflow (#152) (99618fd)
• adds dep scan on pr workflow (#153) (3688fbe)
• align clients (#220) (1b2f22c)
• Align dictionary interface with latest spec (#108) (0ac7534)
• bump examples to sdk 1.9.0 for MVI (#375) (c60c47b)
• bump mypy dependency (#416) (392c6e8)
• bump protos and consume mvi searchhit update (#404) (a4a65ed)
• bump protos for count items uint64 (#428) (5ba6988)
• bumps examples libs to latest (#151) (2dc6a4c)
• clean up and raise new ConnectionException when eager connection fails (#446) (34c5afd)
• deps-dev: bump @babel/traverse in /examples/lambda/infrastructure (#413) (045d347)
• deps-dev: bump braces in /examples/lambda/infrastructure (#484) (03601a1)
• deps: bump momento from 0.16.3 to 0.17.0 in /examples (#166) (b646bf5)
• deps: bump momento from 0.17.0 to 0.18.1 in /examples (#173) (a2e2a1d)
• deps: bump momento from 0.18.1 to 0.20.0 in /examples (#217) (aeb2dc3)
• deps: bump momento from 0.20.0 to 0.21.0 in /examples (047b2b2)
• deps: bump momento from 0.20.0 to 0.21.0 in /examples (#244) (047b2b2)
• deps: bump momento from 0.21.0 to 0.22.0 in /examples (#264) (b073c1a)
• deps: bump momento from 1.1.1 to 1.3.1 in /examples (#332) (71c0bd4)
• deps: bump momento from 1.13.2 to 1.15.1 in /examples (#423) (1a82847)
• deps: bump momento from 1.17.0 to 1.18.0 in /examples (#432) (eccbcfa)
• deps: bump momento from 1.18.0 to 1.20.1 in /examples (#447) (79bc60e)
• deps: bump momento from 1.23.3 to 1.25.0 in /examples (#493) (3e1d086)
• deps: bump momento from 1.25.0 to 1.26.0 in /examples (#499) (a0a1382)
• deps: bump momento from 1.26.0 to 1.27.0 in /examples (#508) (62ac4ae)
• deps: bump momento from 1.3.1 to 1.5.0 in /examples (#337) (e94662a)
• deps: bump momento from 1.5.0 to 1.6.0 in /examples (#348) (4700466)
• eager connection should fail fast (#445) (3c97c40)
• empty commit to test build (cc82895)
• enable linting on tests (#266) (7aa143b)
• explicitly test behavior when using default similarity metric (#393) (fd901d0)
• fall back manual version when dist-info absent (#462) (2ccc50b)
• fix as-bytes error messages (#273) (0e79b0e)
• fix markdown in lambda zip example (#453) (8ceff0f)
• fix tests for python 3.7, add 3.7 to CI test matrix (#54) (0f67b6b)
• fixed timeout retry strategy (#504) (5f1398f)
• improve imports for configurations and CredentialProvider (#295) (c59217b)
• improve resource exhausted error message (#485) (b4439bd)
• include search_and_fetch_vectors in mvi api snippets (#406) (51c54db)
• main: release 1.23.5 (#474) (4b4aeb8)
• main: release 1.24.0 (#480) (a3f7b6c)
• main: release 1.25.0 (#491) (ec6eaaa)
• main: release 1.26.0 (#494) (50df735)
• main: release 1.27.0 (#500) (1443545)
• main: release 1.28.0 (#509) (d34001b)
• main: release 1.28.1 (#516) (26b4bd6)
• main: release 2.0.0 (#521) (a13f5f8)
• migrate mypy config to pyproject.toml and simplify (#234) (feff925)
• more examples and readme updates (#517) (cc9378f)
• move Python SDK examples from client-sdk-examples repo (#139) (47f43ca)
• organize project (#183) (1c9a935)
• pin cryptography dependency (#170) (e94ad18)
• prefer API key over AUTH token terminology (#385) (4214a70)
• refactor credential provider, add string provider (#226) (70f7a94)
• Refactor multi-get and multi-set (#112) (ecb8e0e)
• refactor sync client to be based on async client (#56) (ed2fdb6)
• refactor tests into smaller files (#181) (e5f4680)
• refine str and repr for collections (#265) (16cd9c8)
• regen examples requirements.txt (#146) (c57624c)
• regen requirements.txt for examples (#147) (50a6956)
• release 1.23.4 (#475) (6db8d8c)
• release 1.29.0 (#527) (20241e5)
• release-please workflow should pick up feat, fix, and chore commits (#486) (6e975cb)
• Remove compatibility verbiage from README (#192) (d3dc2d0)
• remove configuration bases and make middleware more pythonic (#505) (6b810cc)
• remove obsolete release workflows (#482) (5b76c65)
• remove pagination from list caches and list signing keys (#270) (118659e)
• remove unnecessary score alias (#409) (ea9bf4d)
• rename "multi" methods and responses. (#118) (1afec19)
• restrict importlib_metadata package to python < 3.8 (#343) (5276f1f)
• retire the machine-user release token (#520) (3b6a220)
• send only-once headers per client instead of just once (#507) (11da1a5)
• set release-please base version as 1.23.4 (#477) (06869b2)
• specify path to release-please manifest (#487) (227aa40)
• switch to using README template generator (#196) (f446129)
• temporarily add score alias for backward compatibility (#405) (b90dc8d)
• undo public type aliases (#252) (40f2277)
• update all examples to use factory method (#372) (74cac84)
• update codegen to handle examples in docstrings (#225) (72f6fad)
• update CONTRIBUTING.md on how to add a new dependency (#77) (f83bf46)
• update doc examples for get item methods (#424) (a548f75)
• update example snippets for mvi count items (#429) (a754c1b)
• update examples (#305) (bda4096)
• update examples for 1.7.0 (#354) (df6c9d0)
• update examples for mvi updates (#403) (0df1927)
• update examples to use latest python client (#197) (a200f21)
• update examples to use SDK version 1.1.1 (#321) (10c8113)
• update license file (#488) (bb61d81)
• update list of retryable gRPC functions (#495) (b8e527c)
• update loadgen to be more specific for numberOfConcurrentRequests caveat (#396) (9aba4df)
• update momento version in examples (#471) (fd0fd34)
• update momento-wire-types, adjust pb/grpc type hints, and refactor requests (#335) (49c1754)
• update mvi backend for create/list indexes updates (#407) (f4be059)
• update protos to use latest get item and get item metadata rpcs (#420) (850b201)
• update python SDK to release from release branch (#126) (27ef36f)
• update README.md to include M1 workaround (#76) (07f056d)
• update secret variable name for PyPI auth token (#68) (8ac3a74)
• Update the Momento wire types dependency (#323) (91b85ce)
• update topic subscription response (#381) (7e7c477)
• update vector index example (#388) (dbc78a9)
• update vector index examples (#384) (08865c2)
• update workflows, examples, tests, readmes for api keys v2 (#514) (2c8738f)
• updates examples to latest syntax (#145) (b0bc491)
• updating README to use factory method (#374) (1624253)
• upgrade project classifier to stable (#311) (10e852e)
• upgrade project stability to stable (#309) (4ba7acf)
• upgrade proto dependency version (#489) (77b855f)
• use guids in tests (#132) (4ba8c73)
• use poetry (#133) (32d15cf)
• use property for next data client (#216) (e0a7bfb)
• use ruff formatter and remove black (#411) (7f0da81)
• use ruff in examples (#412) (6c30e7d)
• use ruff linter (#410) (df0b943)
• use ubuntu-24.04 for ci where possible (#454) (512d982)
• use vector endpoint for MVI API calls (#373) (6f6e0f8)