webgme-engine
WebGME server and Client API without a GUI
Last updated 4 months ago by kecso .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install webgme-engine 
SYNC missed versions from official npm registry.

license Build Status Version Downloads

webgme-engine

This is the "engine" of the webgme application and contains all server code, common-modules and client-api. If this is your first encounter with webgme the webgme/webgme is probably what you're looking for.

The webgme-engine was forked off from webgme/webgme at version v2.17.0 and since then is released separately from webgme starting off from v2.18.0.

Most documentation in the webgme/webgme - wiki is still applicable for this repository (all except the GUI specifics).

webgme/webgme uses the engine as a dependency and a repository should only depend on one of these libraries.

Developers

Dependencies

  • NodeJS (version >= 4, CI tests are performed on versions 8.x, 10.x and LTS is recommended).
  • MongoDB (version >= 2.6).
  • Git (must be available in PATH).
  • Redis needed to run all tests and if serving under multiple nodes.

Command line interface

All runnable javascript programs are stored in the src/bin directory, you should start them with node from the root directory of the repository, e.g. node src/bin/start_server.js starts the web server. Each script supports the --help or -h command line parameter, which will list all possible parameters.

  • start_server.js: it starts a web server, which opens a connection to the configured MongoDB.
  • run_plugin.js: executes a plugin via a direct MongoDB connection.
  • merge.js: merges two branches if there are no conflicts.
  • usermanager.js: manages users, organizations, and project authorization (read, write, delete).
  • clean_up.js: lists/removes projects based on supplied criteria (commits, branches, regex etc.).
  • export.js: exports a (snapshot of a) branch into a webgmex-file.
  • import.js: imports a (snapshot of a) branch (from webgmex-file) into a webgme project.
  • addon_handler.js: starts a server that handles running addons (see config.addOn.workerUrl).
  • manage_webhooks.js: add/update/remove webhooks to and from projects.
  • blob_fs_clean_up.js: cleans up blobs from the filesystem that are not referenced from any projects.
  • plugin_hook.js: plugin developer utility for triggering plugin on changes made to a project.
  • storage_stats.js: outputs statistics about the projects in the database.
  • connected_webhook_handler.js: webhook example illustrating how to create an authenticated remote connection to the storage (models).

Repo structure

  • config - contains the configuration files for webgme.
  • dist - container for webgme.classes.build.js generated at prepublish or postinstall.
  • docs - 'REST' and 'source' are generated at postinstall.
  • seeds - contains the project templates including the base seed 'EmptyProject' and some samples.
  • src/addon - addon related files - all these are currently only executed under nodejs.
  • src/app - sample application illustrating how to use the webgme.classes.build.js from served from dist. The path to the app-dir is configurable via gmeConfig.client.appDir.
  • src/bin - contains the bin-scripts explained above.
  • src/client - code for the browser/GUI API - a.k.a. the "Client API" (strictly JavaScript and no HTML nor CSS)
  • src/common - code running under nodejs and/or inside a browser. Under nodejs the code (e.g. core, storage and blob) is typically executed in workers and not in the main server process.
  • src/docs - source code documentation that isn't inlined in the code itself.
  • src/plugin - plugin related code such as plugin-managers and the PluginBase, also contains a range of sample plugins under 'coreplugins'.
  • src/server - code strictly running under nodejs. Aside from the worker code - the code runs in the main server process.
  • test - test directory, note that _globals.js contains utitlity functions for settings up test-contexts.
  • test-karma - test directory for tests running inside a browser.
  • test-tmp - temporary files generate during tests.
  • utils - postinstall, prebublish and build scripts.

Current Tags

  • 2.25.1                                ...           latest (4 months ago)

38 Versions

  • 2.25.1                                ...           4 months ago
  • 2.25.0                                ...           6 months ago
  • 2.24.3                                ...           8 months ago
  • 2.24.2                                ...           8 months ago
  • 2.24.1                                ...           a year ago
  • 2.24.0                                ...           a year ago
  • 2.23.2                                ...           a year ago
  • 2.23.1                                ...           2 years ago
  • 2.23.0                                ...           2 years ago
  • 2.22.4                                ...           2 years ago
  • 2.22.3                                ...           2 years ago
  • 2.22.2                                ...           2 years ago
  • 2.22.1                                ...           2 years ago
  • 2.22.0                                ...           2 years ago
  • 2.21.3                                ...           2 years ago
  • 2.21.2                                ...           2 years ago
  • 2.21.1                                ...           2 years ago
  • 2.21.0                                ...           2 years ago
  • 2.20.4                                ...           2 years ago
  • 2.20.3                                ...           2 years ago
  • 2.20.2                                ...           2 years ago
  • 2.20.1                                ...           2 years ago
  • 2.20.0                                ...           2 years ago
  • 2.19.9                                ...           2 years ago
  • 2.19.8                                ...           2 years ago
  • 2.19.7                                ...           3 years ago
  • 2.19.6                                ...           3 years ago
  • 2.19.5                                ...           3 years ago
  • 2.19.4                                ...           3 years ago
  • 2.19.3                                ...           3 years ago
  • 2.19.2                                ...           3 years ago
  • 2.19.1                                ...           3 years ago
  • 2.18.5                                ...           3 years ago
  • 2.18.4                                ...           3 years ago
  • 2.18.3                                ...           3 years ago
  • 2.18.2                                ...           3 years ago
  • 2.18.1                                ...           3 years ago
  • 2.18.0                                ...           3 years ago
Downloads
Today 0
This Week 1
This Month 6
Last Day 1
Last Week 2
Last Month 38
Dependencies (43)
Dev Dependencies (21)

Copyright 2014 - 2016 © taobao.org |