# simple-mongojs-driver

> A very simplistic MongoDB-JS driver

Latest version **1.0.2** (published 2020-04-15) · ISC license · 0 weekly downloads

## Install

```sh
npm install simple-mongojs-driver
pnpm add simple-mongojs-driver
yarn add simple-mongojs-driver
bun add simple-mongojs-driver
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.2 |
| Published | 2020-04-15 |
| First published | 2020-04-12 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Unpacked size | 10.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | depascaldc |
| Maintainers | depascaldc |
| Keywords | mongodb, mongo, mongo-js, mongo-js-driver, simple-mongodb-driver |

## Links

- npm: https://www.npmjs.com/package/simple-mongojs-driver
- npm.io page: https://npm.io/package/simple-mongojs-driver

## Dependencies (1)

- [mongodb](https://npm.io/package/mongodb.md) ^3.5.5

## Alternatives

- [angular-pipes](https://npm.io/package/angular-pipes.md) — 5.6K weekly downloads
- [@ng-web-apis/midi](https://npm.io/package/@ng-web-apis/midi.md) — 2.6K weekly downloads
- [happn-3](https://npm.io/package/happn-3.md) — 1.6K weekly downloads
- [@opensip-cli/lang-go](https://npm.io/package/@opensip-cli/lang-go.md) — 1.2K weekly downloads
- [mongoose-typescript](https://npm.io/package/mongoose-typescript.md) — 85 weekly downloads

## Recent versions

- 1.0.2 (latest) — 2020-04-15
- 1.0.1 — 2020-04-14
- 1.0.0 — 2020-04-12

## README

# simple-mongojs-driver

This is a very simple mongoDB NodeJS driver easy to use


Update 1.0.1 

```
Added Async Functions
```

### Installation
```sh
npm install --save simple-mongojs-driver
```

A compact examples file can be found in `path/to/project/node_modules/simple-mongojs-driver/example.js`


##### Require the Driver

```js
const db = require("simple-mongojs-driver")
const mongoDB_URI_Example = 'mongodb://user:password@127.0.0.1:27017' // or
const mongoDB_URI2_Example = 'mongodb://127.0.0.1:27017'

var databaseName = 'myDatabaseToFill'
```

### Usage Basic Functions with callback

##### Example QueryObjects

```js
db.query(mongoDB_URI_Example, databaseName, "users", {

    username: "exapleUser"

}, (result, error) => {

    if(error) return console.log(error)
    if(!result[0]) return console.log("No results found for given Query")

    console.log(result)

})
```

##### Example insert Object

```js
db.insertObject(mongoDB_URI_Example, databaseName, "users", {

    username: "exapleUser"

}, (result, error) => {

    if(error) return console.log(error)
    console.log("Inserted X successfully...")

})
```
##### Example update Object to add more entries or change values

```js
db.updateObject(mongoDB_URI_Example, databaseName, "users", {

    username: "exapleUser"
    
}, {

    username: "exapleUser_accepted",
    first_name: "Max",
    last_name: "Mueller",
    email: "max.mueller@example.org"

}, (result, error) => {

    if(error) return console.log(error)
    console.log("Updaed X successfully...")

})
```
##### Example deleteObjects

```js
db.deleteObject(mongoDB_URI_Example, databaseName, "users", {

    username: "exapleUser_accepted"

}, (result, error) => {

    if(error) return console.log(error)
    console.log("Deleted X successfully...")

})
```

### Usage Async Functions with promise

##### Example QueryObjects

```js
db.asyncQuery(mongoDB_URI_Example, databaseName, "users", {
    username: "exapleUser"
})
.then(result => {
    if(!result[0]) {
        console.log("Nothing found...")
    } else {
        console.log(result[0])
    }
})
.catch(error => {
    console.log(error)
})
```
##### Example insert Object

```js
db.asyncInsertObject(mongoDB_URI_Example, databaseName, "users", {
    username: "exapleUser"
})
.then(result => {
    console.log("Inserted...")
})
.catch(error => {
    console.log(error)
})
```

#### The rest of all Functions is available with async promise too
Take a look at the package examples `path/to/project/node_modules/simple-mongojs-driver/example.js`


There are methods to create a Database and Collection too. 
It's self explaining how that works by the methods up there :) 


Enjoy IT!

---
_Source: https://npm.io/package/simple-mongojs-driver · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
