# tern-node-mongodb-native

**Repository Path**: mirrors_angelozerr/tern-node-mongodb-native

## Basic Information

- **Project Name**: tern-node-mongodb-native
- **Description**: A Tern plugin adding support for Mongo DB Native NodeJS Driver.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-09-24
- **Last Updated**: 2026-03-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# tern-node-mongodb-native

[![Build Status](https://secure.travis-ci.org/angelozerr/tern-node-mongodb-native.png)](http://travis-ci.org/angelozerr/tern-node-mongodb-native)
[![npm version](https://badge.fury.io/js/tern-node-mongodb-native.svg)](http://badge.fury.io/js/tern-node-mongodb-native)

[tern-node-mongodb-native](https://github.com/angelozerr/tern-node-mongodb-native) is a plugin which adds support for [Mongo DB Native NodeJS Driver](http://mongodb.github.io/node-mongodb-native/) to the JavaScript code intelligence system [Tern](http://ternjs.net/).

## Demo

You can see demo with CodeMirror (inside Web Browser) [demos/mongodb.html](https://github.com/angelozerr/tern-node-mongodb-native/blob/master/demos/mongodb.html) :

![CodeMirror & TernNodeMongoDBNative](https://github.com/angelozerr/tern-node-mongodb-native/wiki/images/CodeMirror_TernNodeMongoDBNativeCompletions.png)

If you wish to use Eclipse as IDE, see Eclipse support for [Node MongoDB Native](https://github.com/angelozerr/tern.java/wiki/Tern-&-Node-MongoDB-Native-support).

## Installation

tern-node-mongodb-native works with the NodeJS [Tern Server][tern-server], and within a browser.

The easiest way to install tern-node-mongodb-native is to use a recent version of
[npm][npm]. In the directory where you installed the [tern package][tern-npm],
simply run

```
$ npm install tern-node-mongodb-native
```

## Configuration

`mongodb-native` tern plugin extends `node` tern plugin to support mongodb-native.

### With Node.js

In order for Tern to load the tern-node-mongodb-native plugin once it is installed, you must
include `node-mongodb-native` in the `plugins` section of your [Tern configuration
file][tern-config] and `node`.

Here is a minimal example `.tern-project` configuration file:

```json
{
  "plugins": {
    "node": {},
    "node-mongodb-native": {}
  }
}
```

### With WebBrowser (CodeMirror)

See [demos/mongodb-native.html](https://github.com/angelozerr/tern-node-mongodb-native/blob/master/demos/mongodb-native.html)
## How to generate node-mongodb-native.js?

### Introduction

The tern plugin [node-mongodb-native.js](https://github.com/angelozerr/tern-node-mongodb-native/blob/master/node-mongodb-native.js) is generated from the JavaScript sources of [Mongo DB Native NodeJS Driver](http://mongodb.github.io/node-mongodb-native/).
Process of this generation is : 

 * generate a JSON Representation (api.json) of JavaScript sources of [Mongo DB Native NodeJS Driver](http://mongodb.github.io/node-mongodb-native/) by using [dox](https://github.com/visionmedia/dox).
 * generate a JSON Type Definition from the generated dox JSON Representation.
 * generate the tern plugin by using the generated JSON Type Definition.
 
### Instruction 

Here the steps : 
  
* open cmd  
* `cd $HOME/tern-node-mongodb-native`
* `npm install` (to install dox)
* Generate **generator/data/api.json** from JS sources with dox : 
  
  * edit generator/data/node/js2api_mongodb.js with the path of the [node-mongodb-native](https://github.com/mongodb/node-mongodb-native) :
 
 	`var basedir = "D:/_Projects/git/node-mongodb-native/"`
 
  * launch the following command to generate **generator/data/api.json** :
  
	`node generator/data/node/js2api_mongodb`

* Generate the tern plugin **node-mongodb-native.js** from api.json, by launching :
 
	`node generator/node/make_plugin`

### Advanced informations

JS sources are sometimes NOT well annotated, so it misses some information (some return function, parameter type, etc). The [generator/dox2tern_mongodb.js](generator/dox2tern_mongodb.js) gives the capability to override information of JS sources.

If you wish to work on the dox JSON Representation (api.json) to tern JSON Type Definition, you can open the HTML page [generator/html/dox2tern.html](generator/html/dox2tern.html)

## Structure

The basic structure of the project is given in the following way:

* `node-mongodb-native.js` the tern plugin.
* `demos/` demos with node-mongodb-native tern plugin which use CodeMirror.