From 40e7148f6f81e13e1c3734436d6a23dd58d4ee63 Mon Sep 17 00:00:00 2001 From: Zen-CODE Date: Wed, 2 Apr 2014 20:47:57 +0200 Subject: [PATCH] doc: corrected and elaborated for storage/__init__.py --- kivy/storage/__init__.py | 19 +++++++++++-------- 1 file changed, 11 insertions(+), 8 deletions(-) diff --git a/kivy/storage/__init__.py b/kivy/storage/__init__.py index c5bc09425..33db18b6b 100644 --- a/kivy/storage/__init__.py +++ b/kivy/storage/__init__.py @@ -12,9 +12,9 @@ Storage Usage ----- -The idea behind the Storage module is to be able to load/store -keys-value pairs. The default model is abstract so you cannot use it -directly. We provide some implementations such as: +The idea behind the Storage module is to be able to load/store any number of +keys/value pairs via an indexed key. The default model is abstract so you +cannot use it directly. We provide some implementations such as: - :class:`kivy.storage.dictstore.DictStore`: use a python dict as a store - :class:`kivy.storage.jsonstore.JsonStore`: use a JSON file as a store @@ -33,16 +33,19 @@ For example, let's use a JsonStore:: store = JsonStore('hello.json') # put some values - store.put('tito', name='Mathieu', age=30) + store.put('tito', name='Mathieu', org='kivy') store.put('tshirtman', name='Gabriel', age=27) - # get from a key - print('tito is', store.get('tito')) + # using the same index key erases all previously added key/value pairs + store.put('tito', name='Mathieu', age=30) + + # get a value using a index key and key + print('tito is', store.get('tito')['age']) # or guess the key/entry for a part of the key for item in store.find(name='Gabriel'): - print('tshirtmans key is', item[0]) - print('his values are', str(item[1])) + print('tshirtmans index key is', item[0]) + print('his key value pairs are', str(item[1])) Because the data is persistant, you can check later to see if the key exists::