Skip to main content

Python bindings to the OMERO.blitz server

Project description

https://travis-ci.org/ome/omero-py.png https://badge.fury.io/py/omero-py.svg

Introduction

OMERO.py provides Python bindings to the OMERO.blitz server as well as a pluggable command-line interface.

Dependencies

Direct dependencies of OMERO.py are:

Installation

We recommend creating a virtualenv:

python3.6 -mvenv venv
. venv/bin/activate
pip install 'omero-py>=5.6.dev9'

You may need to replace python3.6 with python or python3 depending on your Python distribution.

Setting of the environment variable OMERODIR is required for some functionality. $OMERODIR/var/log/ directory will contain log files. $OMERODIR/etc/grid/config.xml is used to store config.

If OMERODIR is set to an OMERO.server directory, the import and admin commands will be enabled:

# If you need import or admin commands:
export OMERODIR=/path/to/OMERO.server/

# otherwise, can choose any location.
export OMERODIR=$(pwd)

See: OMERO documentation for more details.

Usage

  • For OMERO python language bindings, see OmeroPy.

  • For Command Line usage, see Omero-CLI.

Contributing

See: OMERO documentation

Developer installation

OMERO.py currently depends on an externally built artifact which is automatically bundled in the PyPI package.

For a development installation we recommend creating a virtualenv with the following setup (example assumes python3.6 but you can create and activate the virtualenv using any compatible Python):

python3.6 -mvenv venv
. venv/bin/activate
git clone https://github.com/ome/omero-py
cd omero-py
python setup.py devtarget
pip install -e .

This will install OMERO.py into your virtualenv as an editable package, so any edits to src files should be reflected in your installation. Note that if you add or remove files you must rerun the last two steps.

Running tests

Unit tests are located under the test directory and can be run with pytest.

Integration tests

Integration tests are stored in the main repository (ome/openmicroscopy) and depend on the OMERO integration testing framework. Reading about Running and writing tests in the OMERO documentation is essential.

License

OMERO.py is released under the GPL v2.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

omero-py-5.6.dev10.tar.gz (2.3 MB view details)

Uploaded Source

File details

Details for the file omero-py-5.6.dev10.tar.gz.

File metadata

  • Download URL: omero-py-5.6.dev10.tar.gz
  • Upload date:
  • Size: 2.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/44.0.0 requests-toolbelt/0.9.1 tqdm/4.41.1 CPython/3.6.7

File hashes

Hashes for omero-py-5.6.dev10.tar.gz
Algorithm Hash digest
SHA256 a77d41fc374ef4183c2e10499836e0e9b04e11bce303769d1a7902bb706fa103
MD5 d83ec460670d63b98f856dbd46c706ab
BLAKE2b-256 8ff58b35fb028308de5637e6181c2e34ba90e0ef2bb2a6119a6195a3df78b376

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page