OMERO CLI upload

Plugin for uploading files using the OMERO Command Line Interface (CLI).

Requirements

• OMERO 5.6.0 or newer
• Python 3.6 or newer

Installing from PyPI

This section assumes that an OMERO.py is already installed.

Install the command-line tool using pip:

$ pip install -U omero-upload

Usage

The plugin is called from the command-line using the omero command.

To upload a single file:

$ omero upload <file>

This command will create an OriginalFile on the server and return an output of type OriginalFile:<id>.

To upload multiple files:

$ omero upload <file1> <file2>

This command will create two OriginalFile and return an output of type OriginalFile:<id1>,<id2>

By default, the mimetype will be guessed from the filename but it can be specified by using the --mimetype argument:

$ omero upload <file1> --mimetype 'test/csv'

Files can be in-place uploaded into the OMERO.server via symlinked rather than being copied. This requires the command to be run on the OMERO.server itself from a user having write permissions to the OMERO data repository, similarly to the [in-place import](https://docs.openmicroscopy.org/omero/latest/sysadmins/in-place-import.html). To run an in-place upload, the --data-dir argument must be passed to specify the binary OMERO directory:

$ omero upload <file1> --data-dir /OMERO

Instead of creating and returning a simple OriginalFile object, it is also possible to wrap the file within a FileAnnotation which can then be linked to other objects in the database. It is possible to specify the namespace of this FileAnnotation using the --namespace argument:

$ omero upload <file1> --wrap --namespace 'openmicroscopy.org/idr/analysis/original'

This command will create an OriginalFile and a FileAnnotation and return an output of type FileAnnotation:<id>.

Release process

This repository uses bump2version to manage version numbers. To tag a release run:

$ bumpversion release

This will remove the .dev0 suffix from the current version, commit, and tag the release.

To switch back to a development version run:

$ bumpversion --no-tag [major|minor|patch]

specifying major, minor or patch depending on whether the development branch will be a major, minor or patch release. This will also add the .dev0 suffix.

Remember to git push all commits and tags.

License

This project, similar to many Open Microscopy Environment (OME) projects, is licensed under the terms of the GNU General Public License (GPL) v2 or later.

Copyright

2019-2020, The Open Microscopy Environment