JS RAPP API
Containes RAPPCloud API modules used for interfering wth RAPP Platform as well as the RAPP Objects.
You can distribute robotic applications you make using this API through this Robot Apps Store
To use this JS API you need nodejs and npm. You can run the global_deps_install_script.sh located in the root folder to install them along with grunt-cli and mocha which are the global dependencies the API needs for task management and testing.
The rest dependencies (required npm modules), will be taken care of, from npm, while you install the rapp-platform-api package.
Installing the rapp-platform-api is as easy as
npm install rapp-platform-api
To install it globally:
npm install rapp-platform-api -g
If you also want to install the developer depencdencies, go to the root folder of the project and execute:
The examples located in the examples directory showcase how you may use the RAPPCloud services for your convenience. Provided you have succesfully installed the API in your system, you can require the service(s) that you want to use in your application, after requiring the RAPPCloud module as shown in the examples:
var RAPPCloud = require('rapp-platform-api/lib/cloud/RAPPCloud'); RAPPCloud.qr_detection = require('rapp-platform-api/lib/cloud/qr_detection'); RAPPCloud.face_detection = require('rapp-platform-api/lib/cloud/face_detection'); var services = new RAPPCloud(); services.qr_detection('../../testdata/qrcode.png', 'png', handler); services.face_detection('../../testdata/faces.png', 'png', handler);
For the RAPP platform API objects you would have to point as well, to the respective directory in order to require them:
var RAPPObjects = require('rapp-platform-api/lib/objects/RAPPObject'); RAPPObject.face = require('rapp-platform-api/lib/objects/face'); var objects = new RAPPObject();
- lib/config: The folder with the configurations.
- lib/cloud: The RappCloud services directory.
- lib/objects: The Rapp Objects directory.
- examples: Examples that showcase how you may use the RAPPCloud services for your convenience.
- test: Unit tests for all the services and objects.
For the following to run you will also need to install the developer dependencies (check installation section).
In the test directory unit tests for all the services and objects can be found. In order to run them while on root directory type:
The source files for the examples are under the examples folder located in the root of the JS Rapp Platform API.
You can run them individually, or use them as templates.
For a complete list of all RAPP JS API Cloud services and Objects along with their documentation see here
You might as well want to genetate documentation automatically from the comments of the code. For the following to run you will also need to install the developer dependencies (check installation section).
Generate documentation for the RAPP API Cloud Services only:
npm run doc-cloud
Generate documentation for the RAPP API Objects only:
npm run doc-objects
Gererate documentation for ALL:
npm run doc
Generated doc files are located under the doc/ directory.