OMERO.py
========
.. image:: https://github.com/ome/omero-py/workflows/Build/badge.svg
:target: https://github.com/ome/omero-py/actions
.. image:: https://badge.fury.io/py/omero-py.svg
:target: https://badge.fury.io/py/omero-py
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:
- `ZeroC IcePy 3.6`_
- future (deprecated)
- numpy
- Pillow >= 10.0.0
Installation
------------
We recommend installing omero-py in a Python virtual environment.
You can create one using either ``venv`` or ``conda`` (preferred).
If you opt for `Conda`_, you will need
to install it first, see `miniconda`_ for more details.
To install ``omero-py`` using conda (preferred)::
conda create -n myenv -c conda-forge python=3.8 omero-py
conda activate myenv
Alternatively install ``omero-py`` using venv::
python3.8 -m venv myenv
. myenv/bin/activate
pip install omero-py
You may need to replace ``python3.8`` 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)
Since version 5.13.0, the use of ``omero certificates`` is required to ensure that an OMERO server installation has, at minimum, a self-signed certificate.
See: `OMERO`_ documentation for more details and
`OMERO server certificate management plugin <https://pypi.org/project/omero-certificates/>`_
Usage
-----
- For OMERO python language bindings, see `OMERO.py`_.
- For Command Line usage, see `OMERO.CLI`_.
- For API documentation, see https://omero-py.readthedocs.io/
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.8`` but you can create and activate the virtualenv using any compatible Python):
To install using venv::
python3.8 -mvenv myenv
. myenv/bin/activate
git clone https://github.com/ome/omero-py
cd omero-py
python setup.py devtarget
pip install -e .
To install ``omero-py`` using conda (preferred)::
conda create -n myenv -c ome python=3.8 zeroc-ice36-python
conda activate myenv
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
Release process
---------------
This repository uses `bump2version <https://pypi.org/project/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 <https://semver.org/>`_. This will also add the ``.dev0`` suffix.
Remember to ``git push`` all commits and tags.s essential.
The CI pipeline will automatically deploy the tag onto PyPI. Once released,
a Pull Request needs to be opened against
`conda-omero-py <https://github.com/ome/conda-omero-py>`_ to update the
official `OMERO.py Conda package <https://anaconda.org/ome/omero-py>`_.
Documentation
-------------
The API documentation is generated using Sphinx.
To generate it:
- Install `Sphinx <https://www.sphinx-doc.org/en/master/>`_.
- Set the environment variable ``NO_TEMP_MANAGER`` to ``true``.
- In the ``docs`` directory, run ``make clean html``.
License
-------
OMERO.py is released under the GPL v2.
Copyright
---------
2009-2024, The Open Microscopy Environment, Glencoe Software, Inc.
.. _ZeroC IcePy 3.6: https://zeroc.com/downloads/ice/3.6
.. _OMERO.py: https://docs.openmicroscopy.org/omero/5.6/developers/Python.html
.. _OMERO.CLI: https://docs.openmicroscopy.org/omero/5.6/users/cli/index.html
.. _OMERO: https://docs.openmicroscopy.org/omero/5.6/index.html
.. _Running and writing tests: https://docs.openmicroscopy.org/latest/omero/developers/testing.html
.. _Conda: https://docs.conda.io/en/latest/
.. _miniconda: https://docs.conda.io/en/latest/miniconda.html
Raw data
{
"_id": null,
"home_page": "https://github.com/ome/omero-py",
"name": "omero-py",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": "The Open Microscopy Team",
"author_email": "ome-devel@lists.openmicroscopy.org.uk",
"download_url": "https://files.pythonhosted.org/packages/e3/90/fdc55b36e3892aa0fb2822b63eaa208d0a2053824ad06e3af017211c8329/omero_py-5.19.2.tar.gz",
"platform": null,
"description": "OMERO.py\n========\n\n.. image:: https://github.com/ome/omero-py/workflows/Build/badge.svg\n :target: https://github.com/ome/omero-py/actions\n\n.. image:: https://badge.fury.io/py/omero-py.svg\n :target: https://badge.fury.io/py/omero-py\n\nIntroduction\n------------\n\nOMERO.py provides Python bindings to the OMERO.blitz server\nas well as a pluggable command-line interface.\n\nDependencies\n------------\n\nDirect dependencies of OMERO.py are:\n\n- `ZeroC IcePy 3.6`_\n- future (deprecated)\n- numpy\n- Pillow >= 10.0.0\n\nInstallation\n------------\n\nWe recommend installing omero-py in a Python virtual environment.\nYou can create one using either ``venv`` or ``conda`` (preferred).\nIf you opt for `Conda`_, you will need\nto install it first, see `miniconda`_ for more details.\n\nTo install ``omero-py`` using conda (preferred)::\n\n conda create -n myenv -c conda-forge python=3.8 omero-py\n conda activate myenv\n\nAlternatively install ``omero-py`` using venv::\n\n python3.8 -m venv myenv\n . myenv/bin/activate\n pip install omero-py\n\nYou may need to replace ``python3.8`` with ``python`` or ``python3`` depending on your Python distribution.\n\nSetting of the environment variable ``OMERODIR`` is required\nfor some functionality.\n``$OMERODIR/var/log/`` directory will contain log files.\n``$OMERODIR/etc/grid/config.xml`` is used to store config.\n\nIf ``OMERODIR`` is set to an OMERO.server directory,\nthe ``import`` and ``admin`` commands will be enabled::\n\n # If you need import or admin commands:\n export OMERODIR=/path/to/OMERO.server/\n\n # otherwise, can choose any location.\n export OMERODIR=$(pwd)\n\nSince version 5.13.0, the use of ``omero certificates`` is required to ensure that an OMERO server installation has, at minimum, a self-signed certificate.\n\nSee: `OMERO`_ documentation for more details and \n`OMERO server certificate management plugin <https://pypi.org/project/omero-certificates/>`_\n\nUsage\n-----\n\n- For OMERO python language bindings, see `OMERO.py`_.\n- For Command Line usage, see `OMERO.CLI`_.\n- For API documentation, see https://omero-py.readthedocs.io/\n\nContributing\n------------\n\nSee: `OMERO`_ documentation\n\nDeveloper installation\n----------------------\n\nOMERO.py currently depends on an externally built artifact which is automatically bundled in the PyPI package.\n\nFor a development installation we recommend creating a virtualenv with the following setup (example assumes ``python3.8`` but you can create and activate the virtualenv using any compatible Python):\n\nTo install using venv::\n\n python3.8 -mvenv myenv\n . myenv/bin/activate\n git clone https://github.com/ome/omero-py\n cd omero-py\n python setup.py devtarget\n pip install -e .\n\nTo install ``omero-py`` using conda (preferred)::\n\n conda create -n myenv -c ome python=3.8 zeroc-ice36-python\n conda activate myenv\n git clone https://github.com/ome/omero-py\n cd omero-py\n python setup.py devtarget\n pip install -e .\n\n\nThis will install omero-py into your virtualenv as an editable package, so any edits to ``src`` files should be reflected in your installation.\nNote that if you add or remove files you must rerun the last two steps.\n\nRunning tests\n-------------\n\nUnit tests are located under the `test` directory and can be run with pytest.\n\nIntegration tests\n^^^^^^^^^^^^^^^^^\n\nIntegration tests are stored in the main repository (ome/openmicroscopy) and depend on the\nOMERO integration testing framework. Reading about `Running and writing tests`_ in the `OMERO`_ documentation\n\nRelease process\n---------------\n\nThis repository uses `bump2version <https://pypi.org/project/bump2version/>`_ to manage version numbers.\nTo tag a release run::\n\n $ bumpversion release\n\nThis will remove the ``.dev0`` suffix from the current version, commit, and tag the release.\n\nTo switch back to a development version run::\n\n $ bumpversion --no-tag [major|minor|patch]\n\nspecifying ``major``, ``minor`` or ``patch`` depending on whether the development branch will be a `major, minor or patch release <https://semver.org/>`_. This will also add the ``.dev0`` suffix.\n\nRemember to ``git push`` all commits and tags.s essential.\n\nThe CI pipeline will automatically deploy the tag onto PyPI. Once released,\na Pull Request needs to be opened against\n`conda-omero-py <https://github.com/ome/conda-omero-py>`_ to update the \nofficial `OMERO.py Conda package <https://anaconda.org/ome/omero-py>`_.\n\nDocumentation\n-------------\n\nThe API documentation is generated using Sphinx.\nTo generate it:\n\n- Install `Sphinx <https://www.sphinx-doc.org/en/master/>`_.\n- Set the environment variable ``NO_TEMP_MANAGER`` to ``true``.\n- In the ``docs`` directory, run ``make clean html``.\n\nLicense\n-------\n\nOMERO.py is released under the GPL v2.\n\nCopyright\n---------\n\n2009-2024, The Open Microscopy Environment, Glencoe Software, Inc.\n\n.. _ZeroC IcePy 3.6: https://zeroc.com/downloads/ice/3.6\n.. _OMERO.py: https://docs.openmicroscopy.org/omero/5.6/developers/Python.html\n.. _OMERO.CLI: https://docs.openmicroscopy.org/omero/5.6/users/cli/index.html\n.. _OMERO: https://docs.openmicroscopy.org/omero/5.6/index.html\n.. _Running and writing tests: https://docs.openmicroscopy.org/latest/omero/developers/testing.html\n.. _Conda: https://docs.conda.io/en/latest/\n.. _miniconda: https://docs.conda.io/en/latest/miniconda.html\n",
"bugtrack_url": null,
"license": null,
"summary": "Python bindings to the OMERO.blitz server",
"version": "5.19.2",
"project_urls": {
"API": "https://omero-py.readthedocs.io/",
"Bug tracker": "https://github.com/ome/omero-py/issues",
"Documentation": "https://docs.openmicroscopy.org/omero/latest/developers/Python.html",
"Homepage": "https://github.com/ome/omero-py"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a3c89205309989ea716354f6f720c19fbd1a9153e0dade71c528b923bd66e522",
"md5": "cbc0e7b98d7ac8e06d994c21c4d06d5c",
"sha256": "73f3eeee439b3d5d8ace4c99b4be109815dae06e588ef9bc50b1dcf9cba75c3d"
},
"downloads": -1,
"filename": "omero_py-5.19.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cbc0e7b98d7ac8e06d994c21c4d06d5c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 2781202,
"upload_time": "2024-04-24T09:38:40",
"upload_time_iso_8601": "2024-04-24T09:38:40.204219Z",
"url": "https://files.pythonhosted.org/packages/a3/c8/9205309989ea716354f6f720c19fbd1a9153e0dade71c528b923bd66e522/omero_py-5.19.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e390fdc55b36e3892aa0fb2822b63eaa208d0a2053824ad06e3af017211c8329",
"md5": "5a3003844217dfc5be9b1c7d4615e12f",
"sha256": "7e005a66515979437746ddb45f1944e724af28d08799fc0bc73bab742bd274aa"
},
"downloads": -1,
"filename": "omero_py-5.19.2.tar.gz",
"has_sig": false,
"md5_digest": "5a3003844217dfc5be9b1c7d4615e12f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 2340425,
"upload_time": "2024-04-24T09:38:43",
"upload_time_iso_8601": "2024-04-24T09:38:43.163735Z",
"url": "https://files.pythonhosted.org/packages/e3/90/fdc55b36e3892aa0fb2822b63eaa208d0a2053824ad06e3af017211c8329/omero_py-5.19.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-24 09:38:43",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ome",
"github_project": "omero-py",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "omero-py"
}