Warning

This document is for an old release of Galaxy. You can alternatively view this page in the latest release if it exists or view the top of the latest release's documentation.

Source code for galaxy.webapps.galaxy.api.tool_dependencies

"""
API operations allowing clients to manage tool dependencies.
"""

from galaxy.web import _future_expose_api as expose_api
from galaxy.web import require_admin
from galaxy.web.base.controller import BaseAPIController

from galaxy.tools.deps import views


import logging
log = logging.getLogger(__name__)


[docs]class ToolDependenciesAPIController(BaseAPIController):
[docs] def __init__(self, app): super(ToolDependenciesAPIController, self).__init__(app) self._view = views.DependencyResolversView(app)
[docs] @expose_api @require_admin def index(self, trans, **kwd): """ GET /api/dependency_resolvers """ return self._view.index()
[docs] @expose_api @require_admin def show(self, trans, id): """ GET /api/dependency_resolvers/<id> """ return self._view.show(id)
[docs] @expose_api @require_admin def update(self, trans): """ PUT /api/dependency_resolvers Reload tool dependency resolution configuration. """ return self._view.reload()
[docs] @expose_api @require_admin def resolver_dependency(self, trans, id, **kwds): """ GET /api/dependency_resolvers/{index}/dependency Resolve described requirement against specified dependency resolver. :type index: int :param index: index of the dependency resolver :type kwds: dict :param kwds: dictionary structure containing extra parameters :type name: str :param name: name of the requirement to find a dependency for (required) :type version: str :param version: version of the requirement to find a dependency for (required) :type exact: bool :param exact: require an exact match to specify requirement (do not discard version information to resolve dependency). :rtype: dict :returns: a dictified description of the dependency, with attribute ``dependency_type: None`` if no match was found. """ return self._view.resolver_dependency(id, **kwds)
[docs] @expose_api @require_admin def install_dependency(self, trans, id=None, **kwds): """ POST /api/dependency_resolvers/{index}/dependency Install described requirement against specified dependency resolver. :type index: int :param index: index of the dependency resolver :type kwds: dict :param kwds: dictionary structure containing extra parameters :type name: str :param name: name of the requirement to find a dependency for (required) :type version: str :param version: version of the requirement to find a dependency for (required) :type exact: bool :param exact: require an exact match to specify requirement (do not discard version information to resolve dependency). :rtype: dict :returns: a dictified description of the dependency, with attribute ``dependency_type: None`` if no match was found. """ self._view.install_dependency(id, **kwds) return self._view.manager_dependency(**kwds)
[docs] @expose_api @require_admin def manager_dependency(self, trans, **kwds): """ GET /api/dependency_resolvers/dependency Resolve described requirement against all dependency resolvers, returning the match with highest priority. :type index: int :param index: index of the dependency resolver :type kwds: dict :param kwds: dictionary structure containing extra parameters :type name: str :param name: name of the requirement to find a dependency for (required) :type version: str :param version: version of the requirement to find a dependency for (required) :type exact: bool :param exact: require an exact match to specify requirement (do not discard version information to resolve dependency). :rtype: dict :returns: a dictified description of the dependency, with type: None if no match was found. """ return self._view.manager_dependency(**kwds)
[docs] @expose_api @require_admin def resolver_requirements(self, trans, id, **kwds): """ GET /api/dependency_resolvers/{index}/requirements Find all "simple" requirements that could be resolved "exactly" by this dependency resolver. The dependency resolver must implement ListDependencyResolver. :type index: int :param index: index of the dependency resolver :rtype: dict :returns: a dictified description of the requirement that could be resolved. """ return self._view.resolver_requirements(id)
[docs] @expose_api @require_admin def manager_requirements(self, trans, **kwds): """ GET /api/dependency_resolvers/requirements Find all "simple" requirements that could be resolved "exactly" by all dependency resolvers that support this operation. :type index: int :param index: index of the dependency resolver :rtype: dict :returns: a dictified description of the requirement that could be resolved (keyed on 'requirement') and the index of the corresponding resolver (keyed on 'index'). """ return self._view.manager_requirements()
[docs] @expose_api @require_admin def clean(self, trans, id=None, **kwds): """ POST /api/dependency_resolvers/{index}/clean Cleans up intermediate files created by resolvers during the dependency installation. :type index: int :param index: index of the dependency resolver :rtype: dict :returns: a dictified description of the requirement that could be resolved (keyed on 'requirement') and the index of the corresponding resolver (keyed on 'index'). """ return self._view.clean(id, **kwds)