Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/perchunpak/nonbloat-db
Simple key-value database for my small projects!
https://github.com/perchunpak/nonbloat-db
Last synced: 7 days ago
JSON representation
Simple key-value database for my small projects!
- Host: GitHub
- URL: https://github.com/perchunpak/nonbloat-db
- Owner: PerchunPak
- License: agpl-3.0
- Created: 2024-06-12T08:38:56.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-10-09T01:10:54.000Z (about 1 month ago)
- Last Synced: 2024-10-29T06:06:33.911Z (18 days ago)
- Language: Python
- Homepage: https://nonbloat-db.readthedocs.io/en/latest/
- Size: 351 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# nonbloat-db
[](https://www.gov.uk/government/news/ukraine-what-you-can-do-to-help)
[](https://github.com/PerchunPak/nonbloat-db/actions?query=workflow%3Atest)
[](https://nonbloat-db.readthedocs.io/)
[](https://github.com/psf/black)
[](https://www.python.org/downloads/)
Simple key-value database for my small projects!
The idea is to have a dead simple database, which doesn't require spinning up a
server (like Redis), is not underwhelming with features (like SQLite or SQL in
general), data inside can be easily manually reviewed and modified and it
doesn't corrupt (if you just dump JSON into file using `json.dump`, if the
program was forced to stop during write (e.g. because of power outage),
the data will be corrupted).
The purpose of this project is to serve as a database library for my small projects.
So obviously this solution doesn't scale to thousands of users, and it was
never intended to. Use right tool for right job.
Also, do note, that everything is async. There is no synchronous version,
because all of my projects are generally async. I maybe will add a synchronous
wrapper, but I don't promise.
## How does it work?
It is just a really simple key-value storage:
```python
import asyncio
from nbdb.storage import Storage
async def main():
# you need to provide a path to database
my_db = await Storage.init("data/db.json")
await my_db.set("abc", 123)
value = await my_db.get("abc")
print(value) # 123
await my_db.write()
if __name__ == "__main__":
asyncio.run(main())
```
> [!NOTE]
> Everything in this library is asynchronous, so you have to call it
> from async functions.
In the background, a lot of things are happening. For example, when you call
`.set`, the db writes the operation to special AOF (Append Only File; this is
what [Redis uses](https://redis.io/docs/latest/operate/oss_and_stack/management/persistence/)
to achieve data persistence).
And on every write, library renames `db.json` to `db.json.temp` and then writes
to `db.json` new data. This is done to not corrupt data in case of power outage
or force shutdown. If library during initial read finds a `.temp` file next to
database, it will output a warning and read from temp file.
## Installing
It is not yet published to PyPI, so good luck.
```bash
pip install nonbloat-db
```
## Installing for local developing
```bash
git clone https://github.com/PerchunPak/nonbloat-db.git
cd nonbloat-db
```
### Installing `poetry`
Next we need install `poetry` with [recommended way](https://python-poetry.org/docs/master/#installation).
If you use Linux, use command:
```bash
curl -sSL https://install.python-poetry.org | python -
```
If you use Windows, open PowerShell with admin privileges and use:
```powershell
(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | python -
```
### Installing dependencies
```bash
poetry install
```
### If something is not clear
You can always write me!
## Thanks
This project was generated with [python-template](https://github.com/PerchunPak/python-template).