Skip to content

TanmoySG/wunderDB

Repository files navigation

wunderDB

wunderDb is a JSON-based in-memory Data Store.

Note

We've updated the models for collections, replacing data by records. Please use wunderDb v1.7.0 with the environment variable RUN_MODE=RUN_MODE_UPGRADE to migrate the data to new model, otherwise there will be loss of data.

Quickstart

To run wunderDb, download the wunderdb binary of the latest release based on your OS and Architecture. Once downloaded, run the binary to start wunderdb.

./wunderdb

This should start a wunderDb instance. For configuration documentation, check this.

Running wunderDB Container

To run wunderDB on docker, use the docker-compose to start wunderDB with basic configurations.

docker compose up

For more details refer to this.

wdbctl - CLI Tool

For ease of use, we've also developed a command-line tool for wunderDb - wdbctl.

# install wdbctl
brew tap TanmoySG/TanmoySG
brew install wdbctl

# starting wunderDB
wdbctl start

For more about wdbctl, refer to the documentation.

Usage

wunderDb APIs are completely RESTful and all actions can be performed using simple HTTP Requests. Refer to the documentation for usage instructions.

Client Libraries

wunderDB-Retro

The first version, based on Python Flask will not be phased out any time soon. To keep it accessible and so that the version 1 doesn't get lost in the version list, I have moved the v0 to a new repository here - wdb-retro.

The wdb-retro repo has all the version 0 code as well as the Docker Image with the new name - so that when I publish the wunderDB v2 Docker Images are published the v1 Image doesnt get lost and anyone planning to use that still can. The version 1 will not be actively maintained.

Check out the final release of v1 https://github.com/TanmoySG/wdb-retro/releases/tag/v1.1.0