# MicroPython 用於儲存小型資料的 KeyValue 模組
###### tags: `ESP32` `MicroPython`
> [color=#58f][name=Paoyung][time=May 23, 2022] [:snake: ℳ𝒾𝒸𝓇ℴ𝒫𝓎𝓉𝒽ℴ𝓃 隨手記](/@PaoyungChang/mpy_trifiles)

{%hackmd pnhyxEaXRauTCbvY_8k1tQ %}

記不住的金魚腦
---
因為原本就喜歡用 Python 寫些小程式，所以 Arduino IDE 還沒有摸熟，就跑去玩 MicroPython了。之後接觸到 IoT 時，發現 MCU 除了要處理週邊訊號，還得搞定網路各種通訊。網路問題幸有諸多高手分享得以找到解答，但接著就遇到本機參數或資料儲存的問題了。ESP32有 4MB 的 Flash Memroy，而 MicroPython 也可以輕鬆的以檔案的方式讀取，但需要儲存的參數或資料一旦多了，一直 open 覺得實在很煩瑣，若能用 KeyValue 的方式存取豈不美哉！因此寫了個簡單的 KeyValue 模組，方便儲存小型的資料，只要 import 進來就可以簡單的操作了。

:book: 例如：

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))

來碗益氣聰明湯
---
:paperclip: 檔案下載：[KeyValue.py](https://gist.githubusercontent.com/paoyung/612ef8075fee63ba5eb5bfa9dc2a9f75/raw/4a4964500a186487a4fd945bde150e7380be9477/KeyValue.py)

:book: 完整用法：

# 模組載入
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()

資料方便存起來，許多事情做起來就順多了！ :coffee:

{%hackmd /@PaoyungChang/intro_v0702 %}