Creating a repository with webgme-cli¶
All of the code, configurations, images etc. for the web-app will be contained in a single repository. In order for webgme to pick up the correct configurations and locate the code there is an imposed structure on our repository. Fortunately, webgme-cli will automatically set this up for you.
webgme-cli is a tool for managing webgme apps. It provides a command line interface for creating, removing, installing from other webgme apps, (etc) for various webgme components.
Make sure you have node.js and npm (npm comes with node.js) installed.
Now install webgme-cli as a global npm module (the flag
-g ensures this)
npm install -g webgme-cli
If the installation was successful the following command should print a version number (the version of webgme-cli).
Creating a Repository¶
Pick a location on your file-system where you want your repository to be located (a new folder will be created).
webgme init electrical-circuits
Navigate into the newly created directory and you will see the content…
- Contains a list of patterns of files that will not be checked into the repository if using git as version control system.
- The package.json https://docs.npmjs.com/files/package.json contain information for npm. It’s main purpose is to store the dependencies of a module (this repo can be seen as a module and used by others). Notice that webgme is a peerDependency. The reason for this is that webgme-cli provides ways to share and reuse components between webgme repositories and in order to avoid multiple installations of webgme (when the versions do not match exactly) webgme is by default set as a peerDependency. If you’re not intending ot share this repo you can move over the declaration under dependencies instead.
- It’s always good to give a highlevel introduction about a repository together with some steps of how to run the app. This is the place to put it.
- This is where webgme-cli stores meta-data about generated components of this repository. It should not be manually edited.
Installing the node_modules¶
In order to be able to launch the server you need to install all dependencies. From the root of the repository do:
In case you didn’t move webgme to dependencies and it’s still a peerDependency you need to explicitly install it…
npm install webgme
To check if the installation succeeded the following command should print a tree-like structure and include webgme at the root level.
The configuration files in the
config directory is where you set the configuration for your webgme app. By default
config/config.default.js and is the entry point of where you manually can overwrite the parameters. It loads
config/config.webgme.js where webgme-cli adds parameters for the generated components (e.g. plugin). A full list of
all possible parameters and how to switch between configuration files is documented here.
Starting the server¶
Make sure you have mongodb running. Look back at the dependencies section. As mentioned before the app.js file is the starting point for the webgme server. To invoke it with node.js simply do:
There is a short-cut defined in package.json that lets you start the app by typing:
You should see some logging listing the port where webgme is available. By default this is 8888, so open up a browser
localhost:8888 in the address bar. The webgme GUI should be loaded!
Setting up Python Bindings¶
WebGME provides Python Bindings for writing plugin code on the server. This is a two part setup, one for Node.js and one for Python.
First install and store webgme-bindings as a node-module to your repository:
npm install webgme-bindings --save
To add a router to your deployment that serves the documentation invoke:
webgme import router BindingsDocs webgme-bindings
Once your webgme-server is up and running the documentation will be available at <host>/bindings-docs/python, e.g. localhost:8888/bindings-docs/python/.
Make sure that you’ve installed Python and pip as described in the Dependencies section. Then install webgme-bindings with pip, using the following command:
pip install webgme-bindings