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.webapps.galaxy.api.groups

"""
API operations on Group objects.
"""

import logging

from fastapi import Body
from typing_extensions import Annotated

from galaxy.managers.context import ProvidesAppContext
from galaxy.managers.groups import GroupsManager
from galaxy.schema.groups import (
    GroupCreatePayload,
    GroupListResponse,
    GroupResponse,
    GroupUpdatePayload,
)
from galaxy.webapps.galaxy.api import (
    depends,
    DependsOnTrans,
    Router,
)
from galaxy.webapps.galaxy.api.common import GroupIDPathParam

log = logging.getLogger(__name__)

router = Router(tags=["groups"])


[docs] @router.cbv class FastAPIGroups: manager: GroupsManager = depends(GroupsManager)
[docs] @router.get( "/api/groups", summary="Displays a collection (list) of groups.", require_admin=True, response_model_exclude_unset=True, ) def index( self, trans: ProvidesAppContext = DependsOnTrans, ) -> GroupListResponse: return self.manager.index(trans)
[docs] @router.post( "/api/groups", summary="Creates a new group.", require_admin=True, response_model_exclude_unset=True, ) def create( self, payload: Annotated[GroupCreatePayload, Body(...)], trans: ProvidesAppContext = DependsOnTrans, ) -> GroupListResponse: return self.manager.create(trans, payload)
[docs] @router.get( "/api/groups/{group_id}", summary="Displays information about a group.", require_admin=True, name="show_group", ) def show( self, group_id: GroupIDPathParam, trans: ProvidesAppContext = DependsOnTrans, ) -> GroupResponse: return self.manager.show(trans, group_id)
[docs] @router.put( "/api/groups/{group_id}", summary="Modifies a group.", require_admin=True, response_model_exclude_unset=True, ) def update( self, group_id: GroupIDPathParam, payload: Annotated[GroupUpdatePayload, Body(...)], trans: ProvidesAppContext = DependsOnTrans, ) -> GroupResponse: return self.manager.update(trans, group_id, payload)
[docs] @router.delete("/api/groups/{group_id}", require_admin=True) def delete(self, group_id: GroupIDPathParam, trans: ProvidesAppContext = DependsOnTrans): self.manager.delete(trans, group_id)
[docs] @router.post("/api/groups/{group_id}/purge", require_admin=True) def purge(self, group_id: GroupIDPathParam, trans: ProvidesAppContext = DependsOnTrans): self.manager.purge(trans, group_id)
[docs] @router.post("/api/groups/{group_id}/undelete", require_admin=True) def undelete(self, group_id: GroupIDPathParam, trans: ProvidesAppContext = DependsOnTrans): self.manager.undelete(trans, group_id)