瀏覽代碼

better docstring for workspace role decorator

Guénaël Muller 7 年之前
父節點
當前提交
50d4e27065
共有 1 個文件被更改,包括 4 次插入4 次删除
  1. 4 4
      tracim/lib/utils/authorization.py

+ 4 - 4
tracim/lib/utils/authorization.py 查看文件

83
 
83
 
84
 def require_workspace_role(minimal_required_role: int):
84
 def require_workspace_role(minimal_required_role: int):
85
     """
85
     """
86
-    Decorator for view to restrict access of tracim request if role
87
-    is not high enough
86
+    Restricts access to endpoint to minimal role or raise an exception.
87
+    Check role for current_workspace.
88
     :param minimal_required_role: value from UserInWorkspace Object like
88
     :param minimal_required_role: value from UserInWorkspace Object like
89
     UserRoleInWorkspace.CONTRIBUTOR or UserRoleInWorkspace.READER
89
     UserRoleInWorkspace.CONTRIBUTOR or UserRoleInWorkspace.READER
90
     :return: decorator
90
     :return: decorator
104
 
104
 
105
 def require_candidate_workspace_role(minimal_required_role: int):
105
 def require_candidate_workspace_role(minimal_required_role: int):
106
     """
106
     """
107
-    Decorator for view to restrict access of tracim request if role
108
-    is not high enough.
107
+    Restricts access to endpoint to minimal role or raise an exception.
108
+    Check role for candidate_workspace.
109
     :param minimal_required_role: value from UserInWorkspace Object like
109
     :param minimal_required_role: value from UserInWorkspace Object like
110
     UserRoleInWorkspace.CONTRIBUTOR or UserRoleInWorkspace.READER
110
     UserRoleInWorkspace.CONTRIBUTOR or UserRoleInWorkspace.READER
111
     :return: decorator
111
     :return: decorator