omero-web


Nameomero-web JSON
Version 5.26.0 PyPI version JSON
download
home_pagehttps://github.com/ome/omero-web/
SummaryOMERO.web
upload_time2024-05-21 11:53:59
maintainerNone
docs_urlNone
authorThe Open Microscopy Team
requires_python>=3.8
licenseGPLv2+
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            OMERO.web
=========
.. image::  https://github.com/ome/omero-web/workflows/Tox/badge.svg
    :target: https://github.com/ome/omero-web/actions

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
    :target: https://github.com/psf/black

.. image:: https://badge.fury.io/py/omero-web.svg
    :target: https://badge.fury.io/py/omero-web

Introduction
------------

OMERO.web provides a web based client and plugin infrastructure.

Dependencies
------------

Direct dependencies of OMERO.web are:

- `OMERO.py`_
- `ZeroC IcePy`_
- `Pillow`_
- `NumPy`_
- A WSGI capable web server

Installation
------------

We recommend installing omero-web in a Python virtual environment.
Here we show the install using `Conda`_. For more details and
other options, please see `OMERO.py`_.

::

    conda create -n myenv python=3.9 conda-forge::zeroc-ice==3.6.5 omero-py
    conda activate myenv
    pip install omero-web

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

    export OMERODIR=$(pwd)

Usage
-----

For running omero-web in production with NGINX, see See: `OMERO.web install`_ documentation.
To run in development mode, see below.

Contributing
------------

See: `OMERO`_ documentation

Developer installation
----------------------

For a development installation we recommend creating a virtual environment as described above.
Then install OMERO.web into your virtual environment as an editable package, so that any edits
to source files will be reflected in your installation.

::

    git clone https://github.com/ome/omero-web
    cd omero-web
    pip install -e .

Note some omero-web tests may not run when this module and/or omero-py are installed in editable mode.

Configuration for developer usage::

    omero config set omero.web.debug True
    omero config set omero.web.application_server development

    # If you want to connect to OMERO.server other than 'localhost'
    omero config append omero.web.server_list '["demo.openmicroscopy.org", 4064, "demo"]'

Then run omero-web in the foreground with::

    omero web start
    ...
    Starting development server at http://127.0.0.1:4080/

Or, run Django directly::

    cd omero-web
    python omeroweb/manage.py runserver 4080
    ...
    Starting development server at http://127.0.0.1:4080/

Upgrading
---------

Plugin developers should review the `Upgrading <UPGRADING.md>`_
document highlighting steps that may need to be taken
when upgrading OMERO.web to ensure plugins or other customizations
continue to function as expected.

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.

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 patch

NB: this assumes next release will be a ``patch`` (see below).
To complete the release, push the master branch and the release tag to origin::

    $ git push origin master v5.8.0

If any PRs are merged that would require the next release to be a ``major`` or ``minor`` version
(see `semver.org <https://semver.org/>`_) then that PR can include a version bump created via::

    $ bumpversion --no-tag minor|major

If this hasn't been performed prior to release and you wish to specify the next version
number directly when creating the release, this can be achieved with::

    $ bumpversion --new-version 5.9.0 release

omero-web-docker
^^^^^^^^^^^^^^^^

Following ``omero-web`` release, need to update and release ``omero-web-docker``.

License
-------

OMERO.web is released under the AGPL.

Copyright
---------

2009-2024, The Open Microscopy Environment, Glencoe Software, Inc.

.. _OMERO: https://www.openmicroscopy.org/omero
.. _OMERO.web install: https://docs.openmicroscopy.org/latest/omero/sysadmins/unix/install-web/web-deployment.html
.. _OMERO.py: https://pypi.python.org/pypi/omero-py
.. _ZeroC IcePy: https://zeroc.com/
.. _Pillow: https://python-pillow.org/
.. _NumPy: http://matplotlib.org/
.. _Running and writing tests: https://docs.openmicroscopy.org/latest/omero/developers/testing.html
.. _Conda: https://docs.conda.io/en/latest/



            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/ome/omero-web/",
    "name": "omero-web",
    "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/1d/0a/8405f5879bc62ab4d8b3f74a016665dbf4ba073dec2df9cbab32b34f0e96/omero-web-5.26.0.tar.gz",
    "platform": null,
    "description": "OMERO.web\n=========\n.. image::  https://github.com/ome/omero-web/workflows/Tox/badge.svg\n    :target: https://github.com/ome/omero-web/actions\n\n.. image:: https://img.shields.io/badge/code%20style-black-000000.svg\n    :target: https://github.com/psf/black\n\n.. image:: https://badge.fury.io/py/omero-web.svg\n    :target: https://badge.fury.io/py/omero-web\n\nIntroduction\n------------\n\nOMERO.web provides a web based client and plugin infrastructure.\n\nDependencies\n------------\n\nDirect dependencies of OMERO.web are:\n\n- `OMERO.py`_\n- `ZeroC IcePy`_\n- `Pillow`_\n- `NumPy`_\n- A WSGI capable web server\n\nInstallation\n------------\n\nWe recommend installing omero-web in a Python virtual environment.\nHere we show the install using `Conda`_. For more details and\nother options, please see `OMERO.py`_.\n\n::\n\n    conda create -n myenv python=3.9 conda-forge::zeroc-ice==3.6.5 omero-py\n    conda activate myenv\n    pip install omero-web\n\nSetting of the environment variable ``OMERODIR`` is required.\n``$OMERODIR/var/log/`` directory will contain log files.\n``$OMERODIR/etc/grid/config.xml`` is used to store config::\n\n    export OMERODIR=$(pwd)\n\nUsage\n-----\n\nFor running omero-web in production with NGINX, see See: `OMERO.web install`_ documentation.\nTo run in development mode, see below.\n\nContributing\n------------\n\nSee: `OMERO`_ documentation\n\nDeveloper installation\n----------------------\n\nFor a development installation we recommend creating a virtual environment as described above.\nThen install OMERO.web into your virtual environment as an editable package, so that any edits\nto source files will be reflected in your installation.\n\n::\n\n    git clone https://github.com/ome/omero-web\n    cd omero-web\n    pip install -e .\n\nNote some omero-web tests may not run when this module and/or omero-py are installed in editable mode.\n\nConfiguration for developer usage::\n\n    omero config set omero.web.debug True\n    omero config set omero.web.application_server development\n\n    # If you want to connect to OMERO.server other than 'localhost'\n    omero config append omero.web.server_list '[\"demo.openmicroscopy.org\", 4064, \"demo\"]'\n\nThen run omero-web in the foreground with::\n\n    omero web start\n    ...\n    Starting development server at http://127.0.0.1:4080/\n\nOr, run Django directly::\n\n    cd omero-web\n    python omeroweb/manage.py runserver 4080\n    ...\n    Starting development server at http://127.0.0.1:4080/\n\nUpgrading\n---------\n\nPlugin developers should review the `Upgrading <UPGRADING.md>`_\ndocument highlighting steps that may need to be taken\nwhen upgrading OMERO.web to ensure plugins or other customizations\ncontinue to function as expected.\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\nis essential.\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 patch\n\nNB: this assumes next release will be a ``patch`` (see below).\nTo complete the release, push the master branch and the release tag to origin::\n\n    $ git push origin master v5.8.0\n\nIf any PRs are merged that would require the next release to be a ``major`` or ``minor`` version\n(see `semver.org <https://semver.org/>`_) then that PR can include a version bump created via::\n\n    $ bumpversion --no-tag minor|major\n\nIf this hasn't been performed prior to release and you wish to specify the next version\nnumber directly when creating the release, this can be achieved with::\n\n    $ bumpversion --new-version 5.9.0 release\n\nomero-web-docker\n^^^^^^^^^^^^^^^^\n\nFollowing ``omero-web`` release, need to update and release ``omero-web-docker``.\n\nLicense\n-------\n\nOMERO.web is released under the AGPL.\n\nCopyright\n---------\n\n2009-2024, The Open Microscopy Environment, Glencoe Software, Inc.\n\n.. _OMERO: https://www.openmicroscopy.org/omero\n.. _OMERO.web install: https://docs.openmicroscopy.org/latest/omero/sysadmins/unix/install-web/web-deployment.html\n.. _OMERO.py: https://pypi.python.org/pypi/omero-py\n.. _ZeroC IcePy: https://zeroc.com/\n.. _Pillow: https://python-pillow.org/\n.. _NumPy: http://matplotlib.org/\n.. _Running and writing tests: https://docs.openmicroscopy.org/latest/omero/developers/testing.html\n.. _Conda: https://docs.conda.io/en/latest/\n\n\n",
    "bugtrack_url": null,
    "license": "GPLv2+",
    "summary": "OMERO.web",
    "version": "5.26.0",
    "project_urls": {
        "Homepage": "https://github.com/ome/omero-web/"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "5841a52b05064d16ab5a4499fdfc75616bdec86148f3caddee3fed3c28904897",
                "md5": "130173b8aa037a1647dcd88c730f235e",
                "sha256": "7b9faa4a42e0e1e5a10168bac760d767c0a5d0076a073530e17ed331b41bab49"
            },
            "downloads": -1,
            "filename": "omero_web-5.26.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "130173b8aa037a1647dcd88c730f235e",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 2762667,
            "upload_time": "2024-05-21T11:53:57",
            "upload_time_iso_8601": "2024-05-21T11:53:57.459394Z",
            "url": "https://files.pythonhosted.org/packages/58/41/a52b05064d16ab5a4499fdfc75616bdec86148f3caddee3fed3c28904897/omero_web-5.26.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "1d0a8405f5879bc62ab4d8b3f74a016665dbf4ba073dec2df9cbab32b34f0e96",
                "md5": "2b6a5c94183bac3c0af683589efb0fca",
                "sha256": "28910d41134af4941ee8c97296f9cf5aa6e6c256dd73dabf442217a956a7312a"
            },
            "downloads": -1,
            "filename": "omero-web-5.26.0.tar.gz",
            "has_sig": false,
            "md5_digest": "2b6a5c94183bac3c0af683589efb0fca",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 2268625,
            "upload_time": "2024-05-21T11:53:59",
            "upload_time_iso_8601": "2024-05-21T11:53:59.434214Z",
            "url": "https://files.pythonhosted.org/packages/1d/0a/8405f5879bc62ab4d8b3f74a016665dbf4ba073dec2df9cbab32b34f0e96/omero-web-5.26.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-05-21 11:53:59",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "ome",
    "github_project": "omero-web",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "tox": true,
    "lcname": "omero-web"
}
        
Elapsed time: 0.23602s