Skip to content

A Firebase like real time database based on Postgresql. Leverages the JSON data type and Listen/Notify constructs of postgresql.

License

Notifications You must be signed in to change notification settings

kapilratnani/pgfire

Repository files navigation

pgfire

Convert your postgresql database to a Realtime NoSql database accessible via REST APIs. Inspired from Firebase.

Setup Instructions

  • git clone this repo
  • pip install -r requirements.txt
  • update config.json with db host, username and password
  • run python app.py

Demo

  • Create a DB
curl --location --request POST 'http://localhost:8666/createdb' \
--header 'Content-Type: application/json' \
--data-raw '{
	"db_name":"test_nosql_db"
}'
  • Write Data Add a blog entry to path blog
curl --location --request PUT 'http://localhost:8666/database/test_nosql_db/blog' \
--header 'Content-Type: application/json' \
--data-raw '{
	"title":"a blog entry",
	"body": "some blah blah..."
}'

Add another blog entry

curl --location --request PUT 'http://localhost:8666/database/test_nosql_db/blog' \
--header 'Content-Type: application/json' \
--data-raw '{
	"title":"another blog entry",
	"body": "some more blah blah..."
}'

Read at path

curl --location --request GET 'http://localhost:8666/database/test_nosql_db/blog'
{
    "-M8eTWMpriELfoWJ0osW": {
        "body": "some blah blah...",
        "title": "a blog entry"
    },
    "-M8eUE4Yt004TQHQkjpG": {
        "body": "some more blah blah...",
        "title": "another blog entry"
    }
}

Read at root

curl --location --request GET 'http://localhost:8666/database/test_nosql_db/'
{
    "blog": {
        "-M8eTWMpriELfoWJ0osW": {
            "body": "some blah blah...",
            "title": "a blog entry"
        },
        "-M8eUE4Yt004TQHQkjpG": {
            "body": "some more blah blah...",
            "title": "another blog entry"
        }
    }
}
  • Realtime notifications via Server Sent Events (SSE) Open two terminals
Terminal 1 Terminal 2
curl -N http://localhost:8666/database_events/test_nosql_db/blog
data: {"-M8eTWMpriELfoWJ0osW": {"body": "some blah blah...", "title": "a blog entry"}, "-M8eUE4Yt004TQHQkjpG": {"body": "some more blah blah...", "title": "another blog entry"}}
curl --location --request POST 'http://localhost:8666/database/test_nosql_db/blog' \ --header 'Content-Type: application/json' \ --data-raw '{ "title":"another blog entry", "body": "some more blah blah..." }'
data: {"event": "put", "path": "blog/-M8eYCk1LLlWH-SwIkXi", "data": {"body": "some more blah blah...", "title": "another blog entry"}}

Todo

  • Add user and role based access control
  • Make a distributable package
  • make a cli to create and manage databases
  • Demo app
  • Performance tests
  • Support Transactions

About

A Firebase like real time database based on Postgresql. Leverages the JSON data type and Listen/Notify constructs of postgresql.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published