RustGIS Plugins¶

Plugins add commands and geoprocessing tools to RustGIS. Each plugin is a WebAssembly module that runs in a sandbox, and the same package works in the desktop app, on the command line and in the web app.

• Catalog: every plugin in the registry.
• Write a plugin: the SDK, the manifest and what a plugin can do.
• Publish a plugin: add yours to the registry.

Installing plugins¶

In RustGIS, open Plugins › Plugin Manager › Browse and choose Install. RustGIS downloads the package, checks it against the SHA-256 published here, and shows what the plugin may do before loading it. The plugin's commands appear on the Plugins tab, and its tools appear in the Geoprocessing pane under Plugins ›.

On the command line:

rustgis-cli plugins browse
rustgis-cli plugins get vector-toolkit
rustgis-cli run --sample --cmd 'gp.run={"tool":"plugin:vector-toolkit/hexagon-grid","params":{"input":"Countries","size":300}}'

Safety¶

A plugin can read the map. It can change the project only with the edit permission, and use files only with the files permission. You see both before installing. Plugins have no other access to your computer or the network. Each call has a time and memory budget, so a misbehaving plugin is stopped, and it can't crash RustGIS. Every plugin here is reviewed before it is listed. Withdrawn plugins are listed in blocklist.json, and RustGIS turns them off.

For RustGIS¶

The registry is registry.json; packages are under packages/<id>/<id>-<version>.rgplugin and never change once published.