MicroPython 用於儲存小型資料的 KeyValue 模組

import KeyValue as kv
#. 存入 wifi 設定值
kv.save('wifi.cfg', {"ssid":"ap_name", "pass":"pazzw0rd"})
#.  讀取
wifiCfg = kv.load('wifi.cfg')
#. => wifiConnect(wifiCfg["ssid"], wifiCfg["pass"])
#. 也可以在沒有設定值的情況下，載入預設值並儲存
default_wifiCfg = {"ssid": "ap0", "pass": "pazzw0rd"}
wifiCfg = kv.get('wifi.cfg',  default_wifiCfg)
#. 設定 debug mode
debug = kv.get('debug', True)
if debug:
    print('Debug mode enabled.')
#. 記錄開機時間
import time
kv.save('boot_time', time.time())
#. ... a few moments later
time.sleep(5)
#. ... a few moments later
work = (time.time() - kv.load('boot_time'))
print("running {} second.".format(work))

# 模組載入
import KeyValue as kv
 
# 列出清單
kv.list()
 
# 存入
# kv.save(key, value)
# python 的資料型態都可存, key name 必需是字串
kv.save('wifi.cfg', {"ssid":"ap_name", "pass":"pazzw0rd"})
kv.save('debug.flg', True)
kv.save('num_lst', [1, 2, 3, 4, 5])
# 需注意的是存入 tuple 在載入時會變成 list
kv.save('num_lst', (1, 2, 3))
print(kv.load('num_lst'))
# 結果為=> [1, 2, 3]
# 資料型態可以混合
kv.save('mix', ['andy', 38, {"tags":["bike", "cook"]}])
# 1v18的 MicroPython 可以單獨存 None, 較早版本會出現錯誤訊息
#kv.save('ng', None)
# 存為資料結構則沒問題
kv.save('none', {'value': None})
# flash memory 有壽命的考量，為節省擦寫次數, 存入相同資料時不會複寫檔案
 
# 讀取
# kv.load(key)
wifiCfg = kv.load('wifi.cfg')
 
# 在還沒有設定值的情況下,載入預設值並儲存, 若已有值則載入已儲存的值
# kv.get(key, default_value)
default_wifiCfg = {"ssid": "ap0", "pass": "pazzw0rd"}
wifiCfg = kv.get('wifi.cfg',  default_wifiCfg)
 
# 是否顯示訊息
# kv.enableMsg(true_or_false)
# 未給值的預設是開啟的
kv.enableMsg()
kv.enableMsg(True)
# 關閉訊息
kv.enableMsg(False)
 
# 重新命名
# kv.rename(old_key, new_key)
kv.rename('old_name', 'new_name')
 
# 刪除單一key的資料
# kv.rm(key)
kv.rm('unused')
 
# 清除所有資料
# kv.renew(True)
# 必需參數給 True 才會執行
kv.renew(True)
# 沒給參數不會進行清除動作
kv.renew()