Warning

This document is for an in-development version 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.managers.group_roles

import logging
from typing import (
    List,
    Optional,
)

from sqlalchemy import select

from galaxy import model
from galaxy.exceptions import ObjectNotFound
from galaxy.managers.context import ProvidesAppContext
from galaxy.model import GroupRoleAssociation
from galaxy.model.base import transaction
from galaxy.model.scoped_session import galaxy_scoped_session
from galaxy.structured_app import MinimalManagerApp

log = logging.getLogger(__name__)


[docs]class GroupRolesManager: """Interface/service object shared by controllers for interacting with group roles."""
[docs] def __init__(self, app: MinimalManagerApp) -> None: self._app = app
[docs] def index(self, trans: ProvidesAppContext, group_id: int) -> List[model.GroupRoleAssociation]: """ Returns a collection roles associated with the given group. """ group = self._get_group(trans, group_id) return group.roles
[docs] def show(self, trans: ProvidesAppContext, role_id: int, group_id: int) -> model.Role: """ Returns information about a group role. """ group = self._get_group(trans, group_id) role = self._get_role(trans, role_id) group_role = self._get_group_role(trans, group, role) if not group_role: raise ObjectNotFound(f"Role {role.name} not in group {group.name}") return role
[docs] def update(self, trans: ProvidesAppContext, role_id: int, group_id: int) -> model.Role: """ Adds a role to a group if it is not already associated. """ group = self._get_group(trans, group_id) role = self._get_role(trans, role_id) group_role = self._get_group_role(trans, group, role) if not group_role: self._add_role_to_group(trans, group, role) return role
[docs] def delete(self, trans: ProvidesAppContext, role_id: int, group_id: int) -> model.Role: """ Removes a role from a group. """ group = self._get_group(trans, group_id) role = self._get_role(trans, role_id) group_role = self._get_group_role(trans, group, role) if not group_role: raise ObjectNotFound(f"Role {role.name} not in group {group.name}") self._remove_role_from_group(trans, group_role) return role
def _get_group(self, trans: ProvidesAppContext, group_id: int) -> model.Group: group = trans.sa_session.get(model.Group, group_id) if not group: raise ObjectNotFound("Group with the id provided was not found.") return group def _get_role(self, trans: ProvidesAppContext, role_id: int) -> model.Role: role = trans.sa_session.get(model.Role, role_id) if not role: raise ObjectNotFound("Role with the id provided was not found.") return role def _get_group_role( self, trans: ProvidesAppContext, group: model.Group, role: model.Role ) -> Optional[model.GroupRoleAssociation]: return get_group_role(trans.sa_session, group, role) def _add_role_to_group(self, trans: ProvidesAppContext, group: model.Group, role: model.Role): gra = model.GroupRoleAssociation(group, role) trans.sa_session.add(gra) with transaction(trans.sa_session): trans.sa_session.commit() def _remove_role_from_group(self, trans: ProvidesAppContext, group_role: model.GroupRoleAssociation): trans.sa_session.delete(group_role) with transaction(trans.sa_session): trans.sa_session.commit()
[docs]def get_group_role(session: galaxy_scoped_session, group, role) -> Optional[GroupRoleAssociation]: stmt = ( select(GroupRoleAssociation).where(GroupRoleAssociation.group == group).where(GroupRoleAssociation.role == role) ) return session.execute(stmt).scalar_one_or_none()