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.tool_util.toolbox.tags

""" Handle details of tool tagging - perhaps a deprecated feature.
"""
import logging
from abc import (
    ABCMeta,
    abstractmethod
)


log = logging.getLogger(__name__)


[docs]def tool_tag_manager(app): """ Build a tool tag manager according to app's configuration and return it. """ if hasattr(app.config, "get_bool") and app.config.get_bool('enable_tool_tags', False): return PersistentToolTagManager(app) else: return NullToolTagManager()
[docs]class AbstractToolTagManager(metaclass=ABCMeta):
[docs] @abstractmethod def reset_tags(self): """ Starting to load tool panels, reset all tags. """
[docs] @abstractmethod def handle_tags(self, tool_id, tool_definition_source): """ Parse out tags and persist them. """
[docs]class NullToolTagManager(AbstractToolTagManager):
[docs] def reset_tags(self): return None
[docs] def handle_tags(self, tool_id, tool_definition_source): return None
[docs]class PersistentToolTagManager(AbstractToolTagManager):
[docs] def __init__(self, app): self.app = app self.sa_session = app.model.context
[docs] def reset_tags(self): log.info(f"removing all tool tag associations ({str(self.sa_session.query(self.app.model.ToolTagAssociation).count())})") self.sa_session.query(self.app.model.ToolTagAssociation).delete() self.sa_session.flush()
[docs] def handle_tags(self, tool_id, tool_definition_source): elem = tool_definition_source if self.app.config.get_bool('enable_tool_tags', False): tag_names = elem.get("tags", "").split(",") for tag_name in tag_names: if tag_name == '': continue tag = self.sa_session.query(self.app.model.Tag).filter_by(name=tag_name).first() if not tag: tag = self.app.model.Tag(name=tag_name) self.sa_session.add(tag) self.sa_session.flush() tta = self.app.model.ToolTagAssociation(tool_id=tool_id, tag_id=tag.id) self.sa_session.add(tta) self.sa_session.flush() else: for tagged_tool in tag.tagged_tools: if tagged_tool.tool_id == tool_id: break else: tta = self.app.model.ToolTagAssociation(tool_id=tool_id, tag_id=tag.id) self.sa_session.add(tta) self.sa_session.flush()