DEVELOPMENT.md

Development And Contributing Instructions

Making a new release via Maven

To create a new release, clone the scijava-scripts repo (e.g. in /opt/imagej/) and run the release-version.sh helper:

BASE_DIR=/opt/imagej
mkdir -pv "$BASE_DIR"
cd "$BASE_DIR"
git clone https://github.com/scijava/scijava-scripts
cd -

RELEASE_SCRIPT="$BASE_DIR/scijava-scripts/release-version.sh"

$RELEASE_SCRIPT --skip-push --skip-gpg --skip-license-update

IMPORTANT: after the release has been built, the corresponding tag needs to be pushed to github, e.g. like this:

RELEASE_TAG=$(git tag -l "python-imcflibs-*" | tail -n 1)
git push origin $RELEASE_TAG

Build & Deploy with Maven using VS Code

Building and deploying the package can be greatly simplified using "tasks" in Visual Studio Code. By adding the following settings to the .vscode/tasks.json file, you can simply press Ctrl+Shift+B in VS Code and select the deploy task for running Maven and have the resulting JAR file being placed in /opt/fiji-packaging/Fiji.app/jars/ (adjust to your path as necessary):

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "verify",
            "type": "shell",
            "command": "mvn -B verify",
            "group": "build"
        },
        {
            "label": "test",
            "type": "shell",
            "command": "mvn -B test",
            "group": "test"
        },
        {
            "label": "deploy",
            "type": "shell",
            "command": "mvn -Dscijava.app.directory=/opt/fiji-packaging/Fiji.app",
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "problemMatcher": []
        }
    ]
}

Linting Python 2.7 with VS Code

For being able to lint the old Python code properly, you'll need to set up an appropriate virtualenv with pylint being installed.

Using fish and virtualfish, this can be done as follows:

vf new -p python2.7 py2-imcf-fiji-packages
pip install pylint

Then simply point your VS Code to the newly created venv and run the linting.