Skip to content

alex85k/josm-scripting-plugin

 
 

Repository files navigation

JOSM Scripting Plugin

The JOSM scripting plugin executes scripts in the Open Street Map editor JOSM.

Scripts can be defined in any scripting language for which a JSR-223 compatible script engine is available, in particular in

For JOSM users

The scripting plugin can be installed and kept up to date using JOSMs plugin manager:

  1. Select Preferences -> Plugins
  2. Search for the plugin "Scripting" and install ist

For developers

The scripting plugin includes an embedded scripting engine for JavaScript based on Mozilla Rhino. It provides a custom JavaScript API to write scripts for the JOSM editor, please refer to the API documentation.

Furthermore, it can load and execute plugins written in Python.

In addition, it can execute scripts written in Ruby, Groovy, and other languages, refer to these examples.

If you want to contribute to the scripting plugin itself, please fork this repository and submit your pull requests.

How to build

% git checkout deploy          # switch to deploy branch
% git merge master             # make sure the latest changes are merged to 'deploy'
% git push origin deploy       # push the 'deploy' branch

# edit build.gradle and add a new pair with a plugin build number and a
# JOSM build number

% gradle clean build           # build the plugin
% gradle deploy                # deploys the plugin jar to github,
                               # where it is picked up by the JOSM
                               # plugin installer

Build status

Build Status

Credits

The JOSM scripting plugin uses:

  • jsyntaxpane by Ayman Al-Sairafi
  • Rhino scripting engine by Mozilla Foundation

License

Published under GPL Version 3 and higher. See included LICENSE file.

About

Scripting Plugin for JOSM

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 48.8%
  • Java 43.8%
  • Groovy 5.4%
  • Python 2.0%