MSL (pronounced 'Missile') stands for Mock Service Layer. Our tools enable quick local deployment of your UI code on Node and mocking of your service layer for fast, targeted testing.
Here is the link to getting started
We will be having monthly scheduled releases.
Release 1.0 has been released! - 07/29/2014
Release 1.1 - Scheduled for August
We encourage contribution from the open source community to help make MSL better. Please refer to the development page for more information on how to contribute to this project including sign off and the DCO agreement.
If you have any questions or discussion topics, please post them on Google Groups.
Local install
npm install msl-server
Global install
npm install -g msl-server
If you installed it locally:
./node_modules/msl-server/bin/msl [options]
If you installed it globally:
msl [options]
Options for MSL Server:
- --port => specify the port that server will be listening on local host, default is 8000.
- --basedir => specify the root directory(absolute path) of the app you want to launch locally, default is the directory where you run the command.
- --debug => specify whether to output log in console or not, default is false.
Example:
msl --basedir=./msl-sample-app --port=8001 --debug=true
Node Client
Install Node client:
npm install msl-client
Use Node client in scripts
var msl = require('msl-client');
Browser Client
Download mockapi-browser.js or reference directly from cdnjs
<script src="http://cdnjs.cloudflare.com/ajax/libs/msl-client-browser/1.0.1/mockapi-browser.min.js"></script>
Java Client
Include 'msl-client-java' as maven dependency
<dependency>
<groupId>org.finra.msl</groupId>
<artifactId>msl-client-java</artifactId>
<version>1.0.0</version>
</dependency>
Our project is built automatically on Travis-CI for all pull requests and merge requests.
To build the Java client, please use Maven. You can download Maven here.
# Clone MSL git repo
git clone git://github.com/FINRAOS/MSL.git
cd msl-client-java
# Run package to compile and create jar
mvn package
After you checkout the code, execute E2E tests by running scripts/e2e-run.sh from the root folder. This script will:
- Install msl-server
- Start sample app using msl-server
- Build client
- Run unit/integration tests
MSL project is licensed under Apache License Version 2.0