@back4app/back4app-entity-mongodb
v1.0.8
Published
back{4}app entity persistence mongodb plugin
Downloads
72
Maintainers
Readme
back4app entity mongodb
Table of contents
- [Getting Started] (#getting-started)
- [Dependencies] (#dependencies)
- [Gulp] (#gulp)
- [Building Files] (#building-files)
- [Best Practices] (#best-practices)
Getting Started
First of all, you need to install Node.js. To help you to manage different version of Node.js in your system is recommended that you use nvm. nvm is a Node.js version manager. Using it you will be able to have how many Node.js versions you want. To install it run this command:
curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.25.4/install.sh | bash
or
wget -qO- https://raw.githubusercontent.com/creationix/nvm/v0.25.4/install.sh | bash
To enable the nvm, close and reopen the terminal. Now you can install the most recent stable version of Node.js. To do this just run this command:
nvm install stable
For further information about nvm check its repository.
Dependencies
First ensure that you have installed node.js ands mongodb. Then
$ npm install
####Possible errors
May be caused by the default node version in your machine. To set the default node in your shell, run this command:
nvm alias default 4.0.0
Then verify the change persists by closing the shell window, reopening it and running:
node --version
Gulp
Gulp is included on Development Dependencies. Running the previous command might install it. To install gulp you should run this command:
npm install gulp --global
Gulp Tasks
injectindex
During development, the results can be visualized on a static web page. In order to keep it updated, this task injects the .js and .css files on index.html
It uses the gulp-inject
package to and reads the gulp.config.json
file.
lint
This task is used to maintain the established standards on code style and avoid syntax errors.
It uses gulp-jshint
and gulp-jscs
.
test
This task does unit and interface tests. Those are two subtasks, that can be called separately.
It uses karma
and selenium
, through gulp-mocha
and browser-sync
.
dist
To generate the production files, this task concatenates and minifies the development files. It depends on lint task, and it runs unit tests on the minified files.
It uses gulp-concat
and gulp-uglify
.
Building files
Contributing with the project, you can build the production files by running the Gulp Task dist
.
It will create the "dist" directory. All dependencies and minified files will be injected on the production web page.
To run this task, use the following command:
gulp dist
Best Practices
You should follow the configuration files, using it on your IDE. They're
.editorconfig
,.jscsrc
and.jshintrc
.Try to always remember to run lint and tests:
gulp lint
gulp test
Create tests to any new major interactions, or changed ones.
Follow the code comment standards for documentations.