GoblinDB

Fear the Goblin!

An amazing, simple and fun database for humans

Goblin Philosophy

Coding is fun, so databases must be fun too.
Data is the king.
Data should be stored in the system as a file whenever a change happens.
Data storage in the system must be hackable.
The database can lead or connect your server components.
Events are great... because we are asynchronous.
We prefer facts over promises: facts are there, promises maybe yes or not. In fact, we're talking about callbacks.
Data is not the only stuff that can be store in a database.
We prefer ambush functions over lambda functions. As you know... we're talking about anonymous functions.

Documentation

const GDB = require("@goblindb/goblindb");

const goblinDB = GDB(function(dbError) {
    if (dbError) {
        throw dbError;
    }

    console.log("Fear the Goblin!")

    // Events supported
    goblinDB.on('change', function(changes){
        console.log("-- change detected!:", changes)
        console.log("====================")
    });

    // Read all Database...
    const originalData = goblinDB.get();
    console.log("originalData:", originalData);

    // Store data...
    goblinDB.set({"data": "world!", "data2": "Hiiiii"});

    // Update date...
    goblinDB.update({"new data": "hellooo....", "new array": ["aaaa", true, 2], "data": "cambiado!"})

    // Read all Database...
    const currentData = goblinDB.get();
    console.log("currentData:", currentData)
});

Check the official documentation in our website

Demo

You can run a demo in 4 steps!

Clone this repository

    git clone https://github.com/GoblinDBRocks/GoblinDB

Enter in the folder

    cd GoblinDB

Install the dependencies

    npm install

Run fear_the_goblin.js

    node demo/fear_the_goblin.js

Testing

You can test your changes...

npm test

Future Implementations

Plugins

GoblinSocket. WebSocket interface for GoblinDB using SocketIO

Goblin Team

Those are the amazing people which have contributed to this project:

Ulises Gascón Co-leader

Sebastián Cabanas Co-leader

Carlos Hernandez Co-leader

Leyla Vieira Contributor (Web)

Santiago Trigo Porres Contributor

Andrés Contributor

Alvaro Contributor

Jose Contributor (Moral support )

Achievements

v.0.1.0 The Kraken!

🎉🎉 Finally, here we are! Releasing the version one, the first production quality version available ever. We're very proud to reach this step in the project life! 🎉🎉

After almost one month working with the last version v0.0.11 Meigas we're pretty sure the database is reliable to be used in a production environment. So here we are releasing the kraken!

Bug fixes:

Improve and update the project demo.

Notices:

Evangelization process is going on (Talks, documentation, workshops...)
We are looking for active evangelists, ping us ;-)

v.0.0.11 Meigas!

We've found bugs... bugs which didn't make sense, like meigas it looks like there is none but in the end there were some big bugs like db not storing data in the json and other similar "features"

Wellcome to the new members of the team ❤️ Andrés @drewler (The Galician Tigger), Santiago @trigoporres (El potro de Vallecas) and Alvaro @alvarogtx300 (El ausente )

People which have contributed to this release:

Sebastián Cabanas Co-leader

Carlos Hernandez Co-leader

Ulises Gascón Evangelist and Consultant

Santiago Trigo Porres Contributor 🎉🎉

Andrés Contributor 🎉🎉

Alvaro Contributor 🎉🎉

Main target:

Version 1 candidate.
Remove eval. Improved how data gets saved and loaded.
Various code improvements.
Events improvements.
Add callback to goblin init method (now async loading json db files).
Allow using a custom pointer symbol (you can use '/' for example, instead of '.' (default)). Configurable in init method config. Issue 36 Pull Request 42 Thanks to Santiago Trigo Porres 💯
Add delete and truncate methods to database. Issue 38 PR Pull Request 34
Add error events hook. Now you can listen to goblinDBInstance.on('error', callback...). Issue 37 Pull Request 43 Thanks to Alvaro 💯
Add test cases for events. Issue 8 Pull Request 44
Add errors FAQ and improve messages adding links to the docs (in dev mode only). Issue 14 Pull Request 46 Thanks to Andrés 💯
Add ambush functions events hooks. Now you can listen to ambush-change, ambush-add, ambush-update and ambush-remove.
Add support for detaching all events of the same type for all the callbacks associated. Ex. Detaching the listeners for 4 different callbacks on change event.

Bug fixes:

Lots of bugs. I don't even now where to start haha.

Features:

Add methods delete and truncate to the database.
Added a callback to Goblin init method which will be called when the db is ready to work (load data from file async).
Allow using a custom pointer symbol. Now you can use '/' (firebase friendly).
New code structure (feature only for developers), wich improve stability.
Test improvements (feature only for developers), wich improve stability.

Notices:

Great job and support from Alvaro, Santiago Trigo Porres and Andrés (now in GoblinDB team) 🎉🎉
This version is a good candidate for v0.1.0
Evangelization process is going on (Talks, documentation, workshops...) Last event was T3chfest 2018 and all osw events 👍
We are looking for active evangelists, ping us ;-)

v.0.0.10. New Drakkar!

Main target:

Refactor the main structure to improve maintainability.
Improve all the test cases, to cover well all the code.

Bug fixes:

Lot of bugs when adding or updating ambush functions.
Improved error messages and reasons (some of them was not consistent).

Features:

Travis added to the project
Silence mode.
- Production mode.
- Development mode.
New code structure (feature only for developers), wich improve stability.

Notices:

Great job and support from @Sediug (now in GoblinDB team)
Evangelization process has been started (Talks, documentation, workshops...)
We are looking for active evangelists, ping us ;-)

v.0.0.8

Main target:

Improve architecture & compatibility

Features:

Native Events now supported.
No need to use Object.observe or proxy ECMA6 alternatives.

v.0.0.7

Main target:

Ambush support

Bugs Fixed:

No need to require http module, in documentation examples

Features:

Database testing improved
Added optional features like parameters and callbacks for Ambush (lambda) functions
Added automatic save for Ambush
Added .goblin extension in order to store ambush operations
Added Testing to support ambush features
Added goblin.ambush as container
Added goblin.ambush.add(),
Added goblin.ambush.remove(),
Added goblin.ambush.update(),
Added goblin.ambush.list(),
Added goblin.ambush.details(),
Added goblin.ambush.run()

v.0.0.6

Readme improved

v.0.0.5

v.0.0.4

Features:

Documentation improved

Bugs Fixed

v.0.0.3

Notes: Just to solve issues with NPM.

v.0.0.2

Main target:

Develop the basics key functionalities (methods)
Key/Value operative database
Event support
Database recorded as file
Minimum config setup

Features:

Added support to JSDoc
Added Gulp Tasks
Added Basic Testing with Mocha, Chai and Istanbul
Added .editorconfig
Added esLint support
Roadmap added
Added File structure
Added minimal validation
Added basic documentation
Added GoblinDB as Module
Added GoglinDB Helpers as an independente module
Added support to store the data on demand as JSON
Added full support to events
Added support to key changes in events
Added Method on
Added Method off
Added Method getConfig
Added Method setConfig
Added Method stopStorage
Added Method startStorage
Added Method get
Added Method push
Added Method set
Added Method update

v.0.0.1

Features:

Notes: Just a "Hello world"

Dev status:

Cheap and reliable Node.js hosting starts at $3/month, and $1/month static HTML hosting

GoblinDBRocks / GoblinDB

Programming Languages

Labels

Projects that are alternatives of or similar to GoblinDB

GoblinDB

Fear the Goblin!

Goblin Philosophy

Documentation

Demo

Testing

Future Implementations

Plugins

Goblin Team

Achievements

v.0.1.0 The Kraken!

v.0.0.11 Meigas!

v.0.0.10. New Drakkar!

v.0.0.8

v.0.0.7

v.0.0.6

v.0.0.5

v.0.0.4

v.0.0.3

v.0.0.2

v.0.0.1