{"record":{"id":"b883cddba4e1cf75","repo":"run-llama/llama_index","slug":"use-subclasses-of-mutablemappingkvstore-such-as-s","errorCode":null,"errorMessage":"Use subclasses of MutableMappingKVStore (such as SimpleKVStore) to call this method","messagePattern":"Use subclasses of MutableMappingKVStore \\(such as SimpleKVStore\\) to call this method","errorType":"exception","errorClass":"NotImplementedError","httpStatus":null,"severity":"error","filePath":"llama-index-core/llama_index/core/storage/kvstore/types.py","lineNumber":174,"sourceCode":"\n    def delete(self, key: str, collection: str = DEFAULT_COLLECTION) -> bool:\n        \"\"\"Delete a value from the store.\"\"\"\n        try:\n            self._get_collection_mapping(collection).pop(key)\n            return True\n        except KeyError:\n            return False\n\n    async def adelete(self, key: str, collection: str = DEFAULT_COLLECTION) -> bool:\n        \"\"\"Delete a value from the store.\"\"\"\n        return self.delete(key, collection=collection)\n\n    # this method is here to avoid TypeChecker shows an error\n    def persist(\n        self, persist_path: str, fs: Optional[fsspec.AbstractFileSystem] = None\n    ) -> None:\n        \"\"\"Persist the store.\"\"\"\n        raise NotImplementedError(\n            \"Use subclasses of MutableMappingKVStore (such as SimpleKVStore) to call this method\"\n        )\n\n    # this method is here to avoid TypeChecker shows an error\n    def from_persist_path(cls, persist_path: str) -> \"MutableMappingKVStore\":\n        \"\"\"Create a MutableMappingKVStore from a persist directory.\"\"\"\n        raise NotImplementedError(\n            \"Use subclasses of MutableMappingKVStore (such as SimpleKVStore) to call this method\"\n        )\n","sourceCodeStart":156,"sourceCodeEnd":184,"githubUrl":"https://github.com/run-llama/llama_index/blob/afd0fef371831f9bda13e5af7167cf4e981278ab/llama-index-core/llama_index/core/storage/kvstore/types.py#L156-L184","documentation":"Error \"Use subclasses of MutableMappingKVStore (such as SimpleKVStore) to call this method\" thrown in run-llama/llama_index.","triggerScenarios":"Thrown at llama-index-core/llama_index/core/storage/kvstore/types.py:174 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Use a MutableMappingKVStore subclass such as SimpleKVStore for this method.","Avoid calling this method on kvstores that do not expose the mapping interface."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"afd0fef371831f9bda13e5af7167cf4e981278ab","analyzedAt":"2026-08-15T05:42:58.429Z","schemaVersion":2},"datasetVersion":"2026-08-15T17:31:12.345Z"}