Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

modli-mongo

Package Overview
Dependencies
Maintainers
2
Versions
4
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

modli-mongo

Modli adapter for Mongo

  • 1.0.0
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
1
Maintainers
2
Weekly downloads
 
Created
Source

wercker status Code Climate Test Coverage

Modli - Mongo Adapter

This module provides adapter for the Mongo datasource for integration with Modli.

Installation

npm install modli-mongo --save

Config and Usage

When defining a property which will utilize the adapter it is required that a collection be supplied:

import { model, adapter, Joi, use } from 'modli';
import mongo from 'modli-mongo';

model.add({
  name: 'foo',
  version: 1,
  collection: 'fooCollection'
  schema: {
    id: Joi.number().integer(),
    fname: Joi.string().min(3).max(30),
    lname: Joi.string().min(3).max(30),
    email: Joi.string().email().min(3).max(254).required()
  }
});

Then add the adapter as per usual with the following config object structure:

adapter.add({
  name: 'mongoFoo',
  source: mongo
  config: {
    host: {HOST_IP},
    port: {HOST_PORT},
    username: {USERNAME},
    password: {PASSWORD},
    database: {DATABASE}
  }
});

You can then use the adapter with a model via:

// Use(MODEL, ADAPTER)
const mongoTest = use('foo', 'mongoFoo');

Methods

The following methods exist natively on the Mongo adapter:

execute

Allows for executing methods directly on the collection:

mongoTest.execute('insert', { /*...record...*/ })
  .then(/*...*/)
  .catch(/*...*/);

checkConn

Ensures (or waits for) established connection:

mongoTest.checkConn()
  .then(/*...*/);

Note: the checkConn method is already utilized by all other methods and only needs to be added in a case where you're extending on or using a method of the db object directly.

createCollection

Creates the collection based on the model's collection name:

mongoTest.createCollection()
  .then(/*...*/)
  .catch(/*...*/);

create

Creates a new record based on object passed:

mongoTest.create({
    fname: 'John',
    lname: 'Smith',
    email: 'jsmith@gmail.com'
  })
  .then(/*...*/)
  .catch(/*...*/);

read

Returns records matching a query object (or all if no query specified):

mongoTest.read({ fname: 'John' })
  .then(/*...*/)
  .catch(/*...*/);

update

Updates record(s) based on query and body:

mongoTest.update({ fname: 'John' }, {
    fname: 'Bob',
    email: 'bsmith@gmail.com'
  })
  .then(/*...*/)
  .catch(/*...*/);

delete

Deletes record(s) based on query:

mongoTest.delete({ fname: 'John' })
  .then(/*...*/)
  .catch(/*...*/);

extend

Extends the adapter to allow for custom methods:

mongoTest.extend('myMethod', () => {
  /*...*/
});

Development

The Mongo adapter requires the following enviroment variables to be set for running the tests. These should be associated with the Mongo instance running locally.

MODLI_MONGO_HOST,
MODLI_MONGO_PORT,
MODLI_MONGO_USERNAME,
MODLI_MONGO_PASSWORD,
MODLI_MONGO_DATABASE

This repository includes a base container config for running locally which is located in the /docker directory.

Makefile and Scripts

A Makefile is included for managing build and install tasks. The commands are then referenced in the package.json scripts if that is the preferred task method:

  • all (default) will run all build tasks
  • start will run the main script
  • clean will remove the /node_modules directories
  • build will transpile ES2015 code in /src to /build
  • test will run all spec files in /test/src
  • test-cover will run code coverage on all tests
  • lint will lint all files in /src

Testing

Running make test will run the full test suite. Since adapters require a data source if one is not configured the tests will fail. To counter this tests are able to be broken up.

Test Inidividual File

An individual spec can be run by specifying the FILE. This is convenient when working on an individual adapter.

make test FILE=some.spec.js

The FILE is relative to the test/src/ directory.

Deploys

For deploying releases, the deploy TAG={VERSION} can be used where VERSION can be:

<newversion> | major | minor | patch | premajor

Both make {COMMAND} and npm run {COMMAND} work for any of the above commands.

License

Modli-Mongo is licensed under the MIT license. Please see LICENSE.txt for full details.

Credits

Modli-Mongo was designed and created at TechnologyAdvice.

Keywords

FAQs

Package last updated on 06 Sep 2015

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc