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 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()