Show HN: SimpSave – A lightweight Python KV store with read‑and‑use persistence (opens in new tab)

How do you persist data in Python? The most standard way is, of course, using a database. But for many small scripts or student assignments—where the data size might be just a few thousand entries, a few dozen, or even just a handful—not to mention SQLite, even something as light as tinydb might feel “not portable enough.”

simpsave, as the name suggests, is an extremely lightweight Python library that is very simple to use and ideal for Python beginners. It provides a minimal functional-style API to persist Python’s basic data types, and it supports true read‑and‑use behavior: the type you write in is exactly the type you get back out. You can even skip type checking and conversion entirely.

simpsave 10 update supports multiple storage engines. You can choose how your data is stored: XML, YML, TOML… or even SQLite (which offers somewhat “production‑level” performance, although the functional API creates a new connection each time). simpsave also supports the unique :ss: mode—files beginning with :ss: are stored in the package’s installation directory, allowing scripts in different directories to easily share the same database.

As a Python library, you naturally install it via pip: pip install simpsave

A simple usage example:

import simpsave as ss ss.write('name', 'Alice') ss.write('age', 25) ss.write('scores', [90, 85, 92]) print(ss.read('name')) print(ss.read('age')) print(ss.read('scores')) print(ss.has('name')) print(ss.has('email')) ss.remove('age') print(ss.has('age')) ss.write('user_admin', True) ss.write('user_guest', False) print(ss.match(r'^user_')) ss.write('theme', 'dark', file='config.yml') print(ss.read('theme', file='config.yml')) ss.write('key1', 'value1', file=':ss:config.toml') print(ss.read('key1', file=':ss:config.toml')) ss.delete() ss.delete(file='config.yml')

You can read the full documentation at: https://github.com/Water-Run/SimpSave/blob/master/source/REA...

If this project is helpful to you, feel free to visit GitHub and leave a star to support it :-)