mongo-go
v1.2.0
Published
An easy to use database handler for MongoDB, inspired by quick.db!
Downloads
12
Maintainers
Readme
MongoGo
An easy to use database handler for MongoDB, inspired by quick.db! MongoGo handles the hard part in getters, setters, and much more!
Installation
Using NPM:
npm install mongo-go
Using Yarn:
yarn add mongo-go
Getting Started
To get started with using MongoGo, import the default class from the package.
// Using Node.js `require()`
const MongoGo = require("mongo-go");
// Using ES6 imports
import MongoGo from "mongo-go"
Overview
Connecting to MongoDB
First, we need to establish a connection. MongoGo handles it easily by defining a new instance
of MongoGo. A function <MongoGo>.ready()
is then fired when you start your app. The only parameter needed is a MongoURI
or if your using a localhost, use mongodb://localhost:27017/my_database
.
Here is an example:
const MongoClient = new MongoGo("mongodb://localhost:27017/my_database")
You don't have to pass in another method to connect it by yourself, once you've started the app, it'll start a connection to the cloud and return a Connection
.
Important! Due to an issue with the Mongoose's ConnectionOptions
option, useNewURLParser
isn't use during the connection, in some case, an error or warning might pop-up whilst connecting.
Do we have to define a model/schema?
Nope, like we said, MongoGo handles it all! it uses 2 parameters in a built-in model
we made, which are a "key" and a "value".
- A
"key"
is also the id, which is used to set a newObject
, get the data from the"key"
and others. The"key"
parameter must always be aString
type value. - A
"value"
is just the data that will be stored with the"key"
together in anObject
literal in the database. A"value"
can be any type of value!
Methods
Currently, all method returns a Promise
.
get
const data = await <MongoGo>.get("Hello")
set
await <MongoGo>.set("Hello", "World")
delete
await <MongoGo>.delete("Hello")
push
await <MongoGo>.push("Hello", ["World", "Earth", "Moon"...])
collection
console.log(<MongoGo>.collection)
Important!
Keep it mind that <MongoGo>
is just an example instance, you may rename it to your own likings.
License
MongoGo is licensed under the MIT license. See LICENSE for more information.
Updates
- 1.0.0
- Initial release
- 1.1.0
- Added
push
method - Added
collection
getter - Added
logger
class
- Added