Upload library for use in the OMERO CLI.
OMERO CLI upload
Plugin for uploading files using the OMERO Command Line Interface (CLI).
- 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
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>.
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.
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.
2019-2020, The Open Microscopy Environment
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Hashes for omero_upload-0.4.0-py3-none-any.whl