ome / minimal-omero-client

Minimal OMERO client

Minimal Maven project for connecting to OMERO using the Java gateway based on https://github.com/imagej/minimal-ij1-plugin. Thanks to @dscho and @ctrueden for the original example.

Build

Install Gradle, and build this project:

gradle build

Run from source

gradle run --args="--omero.host=localhost --omero.user=USERNAME --omero.pass=PASSWORD"

Install

cd build/distributions
unzip minimal-omero-client-5.5.x.zip

Run

./minimal-omero-client-5.5.x/bin/minimal-omero-client --omero.host=localhost --omero.user=USERNAME --omero.pass=PASSWORD

You can pass additional properties, e.g. to debug SSL issues pass --IceSSL.Trace.Security=1.

Using development CI libraries

You can build against a development version of a library from the OME CI systems

Make the following change to build.gradle, changing version to the CI version:

diff --git a/build.gradle b/build.gradle
index f832e8e..206cdd1 100644
--- a/build.gradle
+++ b/build.gradle
@@ -11,6 +11,9 @@ def javaOpts = [
 version '5.5.0'

 repositories {
+    maven {
+        name 'latestci'
+        url 'https://latest-ci.openmicroscopy.org/nexus/repository/maven-internal/'}
     mavenLocal()
     mavenCentral()
     maven {
@@ -22,7 +25,7 @@ repositories {
 }

 dependencies {
-    implementation("org.openmicroscopy:omero-gateway:5.6.2")
+    implementation("org.openmicroscopy:omero-gateway:5.6.3-SNAPSHOT")
 }

 startScripts {

gradle build should pull in the new library.

minimal-omero-client's Issues

Add example tests

This is a good introductory example to using the OMERO Java client libraries. It'd be good if there were example tests to guide developers who aren't so familiar with Java test frameworks.

Improve SimpleConnection example

Have to improve the SimpleConnection.java example. Currently it tries to load the image with ID 1, and if the user doesn't have access to this image the example fails.