rename endpoints swagger tags constants

backend/tracim_backend/views/contents_api/comment_controller.py

@@ -24,12 +24,12 @@ from tracim_backend.models.contents import ContentTypeLegacy as ContentType
 from tracim_backend.models.revision_protection import new_revision
 from tracim_backend.models.data import UserRoleInWorkspace
 
-COMMENT_ENDPOINTS_TAG = 'Comments'
+SWAGGER_TAG__COMMENT_ENDPOINTS = 'Comments'
 
 
 class CommentController(Controller):
 
-    @hapic.with_api_doc(tags=[COMMENT_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__COMMENT_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.READER)
     @hapic.input_path(WorkspaceAndContentIdPathSchema())
     @hapic.output_body(CommentSchema(many=True))
@@ -55,7 +55,7 @@ class CommentController(Controller):
                 for comment in comments
         ]
 
-    @hapic.with_api_doc(tags=[COMMENT_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__COMMENT_ENDPOINTS])
     @hapic.handle_exception(EmptyCommentContentNotAllowed, HTTPStatus.BAD_REQUEST)  # nopep8
     @require_workspace_role(UserRoleInWorkspace.CONTRIBUTOR)
     @hapic.input_path(WorkspaceAndContentIdPathSchema())
@@ -84,7 +84,7 @@ class CommentController(Controller):
         )
         return api.get_content_in_context(comment)
 
-    @hapic.with_api_doc(tags=[COMMENT_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__COMMENT_ENDPOINTS])
     @require_comment_ownership_or_role(
         minimal_required_role_for_anyone=UserRoleInWorkspace.WORKSPACE_MANAGER,
         minimal_required_role_for_owner=UserRoleInWorkspace.CONTRIBUTOR,

backend/tracim_backend/views/contents_api/file_controller.py

@@ -39,7 +39,7 @@ from tracim_backend.exceptions import EmptyLabelNotAllowed
 from tracim_backend.exceptions import PageOfPreviewNotFound
 from tracim_backend.exceptions import PreviewDimNotAllowed
 
-FILE_ENDPOINTS_TAG = 'Files'
+SWAGGER_TAG__FILE_ENDPOINTS = 'Files'
 
 
 class FileController(Controller):
@@ -48,7 +48,7 @@ class FileController(Controller):
     """
 
     # File data
-    @hapic.with_api_doc(tags=[FILE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__FILE_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.CONTRIBUTOR)
     @require_content_types([file_type])
     @hapic.input_path(WorkspaceAndContentIdPathSchema())
@@ -84,7 +84,7 @@ class FileController(Controller):
 
         return
 
-    @hapic.with_api_doc(tags=[FILE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__FILE_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.READER)
     @require_content_types([file_type])
     @hapic.input_path(WorkspaceAndContentIdPathSchema())
@@ -109,7 +109,7 @@ class FileController(Controller):
         response.app_iter = FileIter(file)
         return response
 
-    @hapic.with_api_doc(tags=[FILE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__FILE_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.READER)
     @require_content_types([file_type])
     @hapic.input_path(WorkspaceAndContentRevisionIdPathSchema())
@@ -140,7 +140,7 @@ class FileController(Controller):
 
     # preview
     # pdf
-    @hapic.with_api_doc(tags=[FILE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__FILE_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.READER)
     @require_content_types([file_type])
     @hapic.handle_exception(UnavailablePreviewType, HTTPStatus.BAD_REQUEST)
@@ -169,7 +169,7 @@ class FileController(Controller):
         )
         return FileResponse(pdf_preview_path)
 
-    @hapic.with_api_doc(tags=[FILE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__FILE_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.READER)
     @require_content_types([file_type])
     @hapic.handle_exception(UnavailablePreviewType, HTTPStatus.BAD_REQUEST)
@@ -192,7 +192,7 @@ class FileController(Controller):
         pdf_preview_path = api.get_full_pdf_preview_path(content.revision_id)
         return FileResponse(pdf_preview_path)
 
-    @hapic.with_api_doc(tags=[FILE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__FILE_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.READER)
     @require_content_types([file_type])
     @hapic.handle_exception(UnavailablePreviewType, HTTPStatus.BAD_REQUEST)
@@ -225,7 +225,7 @@ class FileController(Controller):
         return FileResponse(pdf_preview_path)
 
     # jpg
-    @hapic.with_api_doc(tags=[FILE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__FILE_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.READER)
     @require_content_types([file_type])
     @hapic.handle_exception(PageOfPreviewNotFound, HTTPStatus.BAD_REQUEST)
@@ -256,7 +256,7 @@ class FileController(Controller):
         )
         return FileResponse(jpg_preview_path)
 
-    @hapic.with_api_doc(tags=[FILE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__FILE_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.READER)
     @require_content_types([file_type])
     @hapic.handle_exception(PageOfPreviewNotFound, HTTPStatus.BAD_REQUEST)
@@ -287,7 +287,7 @@ class FileController(Controller):
         )
         return FileResponse(jpg_preview_path)
 
-    @hapic.with_api_doc(tags=[FILE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__FILE_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.READER)
     @require_content_types([file_type])
     @hapic.handle_exception(PageOfPreviewNotFound, HTTPStatus.BAD_REQUEST)
@@ -322,7 +322,7 @@ class FileController(Controller):
         )
         return FileResponse(jpg_preview_path)
 
-    @hapic.with_api_doc(tags=[FILE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__FILE_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.READER)
     @require_content_types([file_type])
     @hapic.input_path(WorkspaceAndContentIdPathSchema())
@@ -341,7 +341,7 @@ class FileController(Controller):
         return api.get_jpg_preview_allowed_dim()
 
     # File infos
-    @hapic.with_api_doc(tags=[FILE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__FILE_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.READER)
     @require_content_types([file_type])
     @hapic.input_path(WorkspaceAndContentIdPathSchema())
@@ -362,7 +362,7 @@ class FileController(Controller):
         )
         return api.get_content_in_context(content)
 
-    @hapic.with_api_doc(tags=[FILE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__FILE_ENDPOINTS])
     @hapic.handle_exception(EmptyLabelNotAllowed, HTTPStatus.BAD_REQUEST)
     @require_workspace_role(UserRoleInWorkspace.CONTRIBUTOR)
     @require_content_types([file_type])
@@ -397,7 +397,7 @@ class FileController(Controller):
             api.save(content)
         return api.get_content_in_context(content)
 
-    @hapic.with_api_doc(tags=[FILE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__FILE_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.READER)
     @require_content_types([file_type])
     @hapic.input_path(WorkspaceAndContentIdPathSchema())
@@ -427,7 +427,7 @@ class FileController(Controller):
             for revision in revisions
         ]
 
-    @hapic.with_api_doc(tags=[FILE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__FILE_ENDPOINTS])
     @hapic.handle_exception(EmptyLabelNotAllowed, HTTPStatus.BAD_REQUEST)
     @require_workspace_role(UserRoleInWorkspace.CONTRIBUTOR)
     @require_content_types([file_type])

backend/tracim_backend/views/contents_api/html_document_controller.py

@@ -30,12 +30,12 @@ from tracim_backend.models.contents import ContentTypeLegacy as ContentType
 from tracim_backend.models.contents import html_documents_type
 from tracim_backend.models.revision_protection import new_revision
 
-HTML_DOCUMENT_ENDPOINTS_TAG = 'HTML documents'
+SWAGGER_TAG__HTML_DOCUMENT_ENDPOINTS = 'HTML documents'
 
 
 class HTMLDocumentController(Controller):
 
-    @hapic.with_api_doc(tags=[HTML_DOCUMENT_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__HTML_DOCUMENT_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.READER)
     @require_content_types([html_documents_type])
     @hapic.input_path(WorkspaceAndContentIdPathSchema())
@@ -56,7 +56,7 @@ class HTMLDocumentController(Controller):
         )
         return api.get_content_in_context(content)
 
-    @hapic.with_api_doc(tags=[HTML_DOCUMENT_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__HTML_DOCUMENT_ENDPOINTS])
     @hapic.handle_exception(EmptyLabelNotAllowed, HTTPStatus.BAD_REQUEST)
     @require_workspace_role(UserRoleInWorkspace.CONTRIBUTOR)
     @require_content_types([html_documents_type])
@@ -91,7 +91,7 @@ class HTMLDocumentController(Controller):
             api.save(content)
         return api.get_content_in_context(content)
 
-    @hapic.with_api_doc(tags=[HTML_DOCUMENT_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__HTML_DOCUMENT_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.READER)
     @require_content_types([html_documents_type])
     @hapic.input_path(WorkspaceAndContentIdPathSchema())
@@ -121,7 +121,7 @@ class HTMLDocumentController(Controller):
             for revision in revisions
         ]
 
-    @hapic.with_api_doc(tags=[HTML_DOCUMENT_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__HTML_DOCUMENT_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.CONTRIBUTOR)
     @require_content_types([html_documents_type])
     @hapic.input_path(WorkspaceAndContentIdPathSchema())

backend/tracim_backend/views/contents_api/threads_controller.py

@@ -29,12 +29,12 @@ from tracim_backend.models.contents import ContentTypeLegacy as ContentType
 from tracim_backend.models.contents import thread_type
 from tracim_backend.models.revision_protection import new_revision
 
-THREAD_ENDPOINTS_TAG = 'Threads'
+SWAGGER_TAG__THREAD_ENDPOINTS = 'Threads'
 
 
 class ThreadController(Controller):
 
-    @hapic.with_api_doc(tags=[THREAD_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__THREAD_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.READER)
     @require_content_types([thread_type])
     @hapic.input_path(WorkspaceAndContentIdPathSchema())
@@ -55,7 +55,7 @@ class ThreadController(Controller):
         )
         return api.get_content_in_context(content)
 
-    @hapic.with_api_doc(tags=[THREAD_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__THREAD_ENDPOINTS])
     @hapic.handle_exception(EmptyLabelNotAllowed, HTTPStatus.BAD_REQUEST)
     @require_workspace_role(UserRoleInWorkspace.CONTRIBUTOR)
     @require_content_types([thread_type])
@@ -90,7 +90,7 @@ class ThreadController(Controller):
             api.save(content)
         return api.get_content_in_context(content)
 
-    @hapic.with_api_doc(tags=[THREAD_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__THREAD_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.READER)
     @require_content_types([thread_type])
     @hapic.input_path(WorkspaceAndContentIdPathSchema())
@@ -120,7 +120,7 @@ class ThreadController(Controller):
             for revision in revisions
         ]
 
-    @hapic.with_api_doc(tags=[THREAD_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__THREAD_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.CONTRIBUTOR)
     @require_content_types([thread_type])
     @hapic.input_path(WorkspaceAndContentIdPathSchema())

backend/tracim_backend/views/core_api/session_controller.py

@@ -16,12 +16,12 @@ from tracim_backend.views.core_api.schemas import BasicAuthSchema
 from tracim_backend.exceptions import NotAuthenticated
 from tracim_backend.exceptions import AuthenticationFailed
 
-SESSION_ENDPOINTS_TAG = 'Session'
+SWAGGER_TAG__SESSION_ENDPOINTS = 'Session'
 
 
 class SessionController(Controller):
 
-    @hapic.with_api_doc(tags=[SESSION_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__SESSION_ENDPOINTS])
     @hapic.input_headers(LoginOutputHeaders())
     @hapic.input_body(BasicAuthSchema())
     # TODO - G.M - 17-04-2018 - fix output header ?
@@ -42,7 +42,7 @@ class SessionController(Controller):
         user = uapi.authenticate_user(login.email, login.password)
         return uapi.get_user_with_context(user)
 
-    @hapic.with_api_doc(tags=[SESSION_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__SESSION_ENDPOINTS])
     @hapic.output_body(NoContentSchema(), default_http_code=HTTPStatus.NO_CONTENT)  # nopep8
     def logout(self, context, request: TracimRequest, hapic_data=None):
         """
@@ -51,7 +51,7 @@ class SessionController(Controller):
 
         return
 
-    @hapic.with_api_doc(tags=[SESSION_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__SESSION_ENDPOINTS])
     @hapic.output_body(UserSchema(),)
     def whoami(self, context, request: TracimRequest, hapic_data=None):
         """

backend/tracim_backend/views/core_api/system_controller.py

@@ -18,12 +18,12 @@ from tracim_backend.views.controllers import Controller
 from tracim_backend.views.core_api.schemas import ApplicationSchema
 from tracim_backend.views.core_api.schemas import ContentTypeSchema
 
-SYSTEM_ENDPOINTS_TAG = 'System'
+SWAGGER_TAG_SYSTEM_ENDPOINTS = 'System'
 
 
 class SystemController(Controller):
 
-    @hapic.with_api_doc(tags=[SYSTEM_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG_SYSTEM_ENDPOINTS])
     @require_profile(Group.TIM_USER)
     @hapic.output_body(ApplicationSchema(many=True),)
     def applications(self, context, request: TracimRequest, hapic_data=None):
@@ -32,7 +32,7 @@ class SystemController(Controller):
         """
         return applications
 
-    @hapic.with_api_doc(tags=[SYSTEM_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG_SYSTEM_ENDPOINTS])
     @require_profile(Group.TIM_USER)
     @hapic.output_body(ContentTypeSchema(many=True),)
     def content_types(self, context, request: TracimRequest, hapic_data=None):

backend/tracim_backend/views/core_api/user_controller.py

@@ -32,12 +32,12 @@ from tracim_backend.views.core_api.schemas import ContentDigestSchema
 from tracim_backend.views.core_api.schemas import ActiveContentFilterQuerySchema
 from tracim_backend.views.core_api.schemas import WorkspaceDigestSchema
 
-USER_ENDPOINTS_TAG = 'Users'
+SWAGGER_TAG__USER_ENDPOINTS = 'Users'
 
 
 class UserController(Controller):
 
-    @hapic.with_api_doc(tags=[USER_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__USER_ENDPOINTS])
     @require_same_user_or_profile(Group.TIM_ADMIN)
     @hapic.input_path(UserIdPathSchema())
     @hapic.output_body(WorkspaceDigestSchema(many=True),)
@@ -58,7 +58,7 @@ class UserController(Controller):
             for workspace in workspaces
         ]
 
-    @hapic.with_api_doc(tags=[USER_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__USER_ENDPOINTS])
     @require_same_user_or_profile(Group.TIM_ADMIN)
     @hapic.input_path(UserIdPathSchema())
     @hapic.output_body(UserSchema())
@@ -74,7 +74,7 @@ class UserController(Controller):
         )
         return uapi.get_user_with_context(request.candidate_user)
 
-    @hapic.with_api_doc(tags=[USER_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__USER_ENDPOINTS])
     @hapic.handle_exception(WrongUserPassword, HTTPStatus.FORBIDDEN)
     @require_same_user_or_profile(Group.TIM_ADMIN)
     @hapic.input_body(SetEmailSchema())
@@ -98,7 +98,7 @@ class UserController(Controller):
         )
         return uapi.get_user_with_context(user)
 
-    @hapic.with_api_doc(tags=[USER_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__USER_ENDPOINTS])
     @hapic.handle_exception(WrongUserPassword, HTTPStatus.FORBIDDEN)
     @hapic.handle_exception(PasswordDoNotMatch, HTTPStatus.BAD_REQUEST)
     @require_same_user_or_profile(Group.TIM_ADMIN)
@@ -124,7 +124,7 @@ class UserController(Controller):
         )
         return
 
-    @hapic.with_api_doc(tags=[USER_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__USER_ENDPOINTS])
     @require_same_user_or_profile(Group.TIM_ADMIN)
     @hapic.input_body(UserInfosSchema())
     @hapic.input_path(UserIdPathSchema())
@@ -147,7 +147,7 @@ class UserController(Controller):
         )
         return uapi.get_user_with_context(user)
 
-    @hapic.with_api_doc(tags=[USER_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__USER_ENDPOINTS])
     @require_profile(Group.TIM_ADMIN)
     @hapic.input_path(UserIdPathSchema())
     @hapic.input_body(UserCreationSchema())
@@ -179,7 +179,7 @@ class UserController(Controller):
         )
         return uapi.get_user_with_context(user)
 
-    @hapic.with_api_doc(tags=[USER_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__USER_ENDPOINTS])
     @require_profile(Group.TIM_ADMIN)
     @hapic.input_path(UserIdPathSchema())
     @hapic.output_body(NoContentSchema(), default_http_code=HTTPStatus.NO_CONTENT)  # nopep8
@@ -196,7 +196,7 @@ class UserController(Controller):
         uapi.enable(user=request.candidate_user, do_save=True)
         return
 
-    @hapic.with_api_doc(tags=[USER_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__USER_ENDPOINTS])
     @require_profile(Group.TIM_ADMIN)
     @hapic.input_path(UserIdPathSchema())
     @hapic.output_body(NoContentSchema(), default_http_code=HTTPStatus.NO_CONTENT)  # nopep8
@@ -213,7 +213,7 @@ class UserController(Controller):
         uapi.disable(user=request.candidate_user, do_save=True)
         return
 
-    @hapic.with_api_doc(tags=[USER_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__USER_ENDPOINTS])
     @require_profile(Group.TIM_ADMIN)
     @hapic.input_path(UserIdPathSchema())
     @hapic.input_body(UserProfileSchema())
@@ -241,7 +241,7 @@ class UserController(Controller):
         )
         return
 
-    @hapic.with_api_doc(tags=[USER_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__USER_ENDPOINTS])
     @require_same_user_or_profile(Group.TIM_ADMIN)
     @hapic.input_path(UserWorkspaceIdPathSchema())
     @hapic.input_query(ActiveContentFilterQuerySchema())
@@ -275,7 +275,7 @@ class UserController(Controller):
             for content in last_actives
         ]
 
-    @hapic.with_api_doc(tags=[USER_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__USER_ENDPOINTS])
     @require_same_user_or_profile(Group.TIM_ADMIN)
     @hapic.input_path(UserWorkspaceIdPathSchema())
     @hapic.input_query(ContentIdsQuerySchema(), as_list=['contents_ids'])
@@ -310,7 +310,7 @@ class UserController(Controller):
             for content in last_actives
         ]
 
-    @hapic.with_api_doc(tags=[USER_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__USER_ENDPOINTS])
     @require_same_user_or_profile(Group.TIM_ADMIN)
     @hapic.input_path(UserWorkspaceAndContentIdPathSchema())
     @hapic.output_body(NoContentSchema(), default_http_code=HTTPStatus.NO_CONTENT)  # nopep8
@@ -327,7 +327,7 @@ class UserController(Controller):
         api.mark_read(request.current_content, do_flush=True)
         return
 
-    @hapic.with_api_doc(tags=[USER_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__USER_ENDPOINTS])
     @require_same_user_or_profile(Group.TIM_ADMIN)
     @hapic.input_path(UserWorkspaceAndContentIdPathSchema())
     @hapic.output_body(NoContentSchema(), default_http_code=HTTPStatus.NO_CONTENT)  # nopep8
@@ -344,7 +344,7 @@ class UserController(Controller):
         api.mark_unread(request.current_content, do_flush=True)
         return
 
-    @hapic.with_api_doc(tags=[USER_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG__USER_ENDPOINTS])
     @require_same_user_or_profile(Group.TIM_ADMIN)
     @hapic.input_path(UserWorkspaceIdPathSchema())
     @hapic.output_body(NoContentSchema(), default_http_code=HTTPStatus.NO_CONTENT)  # nopep8

backend/tracim_backend/views/core_api/workspace_controller.py

@@ -49,12 +49,12 @@ from tracim_backend.views.core_api.schemas import WorkspaceMemberSchema
 from tracim_backend.models.contents import ContentTypeLegacy as ContentType
 from tracim_backend.models.revision_protection import new_revision
 
-WORKSPACE_ENDPOINTS_TAG = 'Workspaces'
+SWAGGER_TAG_WORKSPACE_ENDPOINTS = 'Workspaces'
 
 
 class WorkspaceController(Controller):
 
-    @hapic.with_api_doc(tags=[WORKSPACE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG_WORKSPACE_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.READER)
     @hapic.input_path(WorkspaceIdPathSchema())
     @hapic.output_body(WorkspaceSchema())
@@ -70,7 +70,7 @@ class WorkspaceController(Controller):
         )
         return wapi.get_workspace_with_context(request.current_workspace)
 
-    @hapic.with_api_doc(tags=[WORKSPACE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG_WORKSPACE_ENDPOINTS])
     @hapic.handle_exception(EmptyLabelNotAllowed, HTTPStatus.BAD_REQUEST)
     @require_workspace_role(UserRoleInWorkspace.WORKSPACE_MANAGER)
     @hapic.input_path(WorkspaceIdPathSchema())
@@ -94,7 +94,7 @@ class WorkspaceController(Controller):
         )
         return wapi.get_workspace_with_context(request.current_workspace)
 
-    @hapic.with_api_doc(tags=[WORKSPACE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG_WORKSPACE_ENDPOINTS])
     @hapic.handle_exception(EmptyLabelNotAllowed, HTTPStatus.BAD_REQUEST)
     @require_profile(Group.TIM_MANAGER)
     @hapic.input_body(WorkspaceCreationSchema())
@@ -116,7 +116,7 @@ class WorkspaceController(Controller):
         )
         return wapi.get_workspace_with_context(workspace)
 
-    @hapic.with_api_doc(tags=[WORKSPACE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG_WORKSPACE_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.READER)
     @hapic.input_path(WorkspaceIdPathSchema())
     @hapic.output_body(WorkspaceMemberSchema(many=True))
@@ -142,7 +142,7 @@ class WorkspaceController(Controller):
             for user_role in roles
         ]
 
-    @hapic.with_api_doc(tags=[WORKSPACE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG_WORKSPACE_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.WORKSPACE_MANAGER)
     @hapic.input_path(WorkspaceAndUserIdPathSchema())
     @hapic.input_body(RoleUpdateSchema())
@@ -174,7 +174,7 @@ class WorkspaceController(Controller):
         )
         return rapi.get_user_role_workspace_with_context(role)
 
-    @hapic.with_api_doc(tags=[WORKSPACE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG_WORKSPACE_ENDPOINTS])
     @hapic.handle_exception(UserCreationFailed, HTTPStatus.BAD_REQUEST)
     @require_workspace_role(UserRoleInWorkspace.WORKSPACE_MANAGER)
     @hapic.input_path(WorkspaceIdPathSchema())
@@ -232,7 +232,7 @@ class WorkspaceController(Controller):
             email_sent=email_sent,
         )
 
-    @hapic.with_api_doc(tags=[WORKSPACE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG_WORKSPACE_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.READER)
     @hapic.input_path(WorkspaceIdPathSchema())
     @hapic.input_query(FilterContentQuerySchema())
@@ -266,7 +266,7 @@ class WorkspaceController(Controller):
         ]
         return contents
 
-    @hapic.with_api_doc(tags=[WORKSPACE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG_WORKSPACE_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.CONTRIBUTOR)
     @hapic.handle_exception(EmptyLabelNotAllowed, HTTPStatus.BAD_REQUEST)
     @hapic.input_path(WorkspaceIdPathSchema())
@@ -306,7 +306,7 @@ class WorkspaceController(Controller):
         content = api.get_content_in_context(content)
         return content
 
-    @hapic.with_api_doc(tags=[WORKSPACE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG_WORKSPACE_ENDPOINTS])
     @hapic.handle_exception(WorkspacesDoNotMatch, HTTPStatus.BAD_REQUEST)
     @require_workspace_role(UserRoleInWorkspace.CONTENT_MANAGER)
     @require_candidate_workspace_role(UserRoleInWorkspace.CONTENT_MANAGER)
@@ -358,7 +358,7 @@ class WorkspaceController(Controller):
         )
         return api.get_content_in_context(updated_content)
 
-    @hapic.with_api_doc(tags=[WORKSPACE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG_WORKSPACE_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.CONTENT_MANAGER)
     @hapic.input_path(WorkspaceAndContentIdPathSchema())
     @hapic.output_body(NoContentSchema(), default_http_code=HTTPStatus.NO_CONTENT)  # nopep8
@@ -390,7 +390,7 @@ class WorkspaceController(Controller):
             api.delete(content)
         return
 
-    @hapic.with_api_doc(tags=[WORKSPACE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG_WORKSPACE_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.CONTENT_MANAGER)
     @hapic.input_path(WorkspaceAndContentIdPathSchema())
     @hapic.output_body(NoContentSchema(), default_http_code=HTTPStatus.NO_CONTENT)  # nopep8
@@ -423,7 +423,7 @@ class WorkspaceController(Controller):
             api.undelete(content)
         return
 
-    @hapic.with_api_doc(tags=[WORKSPACE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG_WORKSPACE_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.CONTENT_MANAGER)
     @hapic.input_path(WorkspaceAndContentIdPathSchema())
     @hapic.output_body(NoContentSchema(), default_http_code=HTTPStatus.NO_CONTENT)  # nopep8
@@ -452,7 +452,7 @@ class WorkspaceController(Controller):
             api.archive(content)
         return
 
-    @hapic.with_api_doc(tags=[WORKSPACE_ENDPOINTS_TAG])
+    @hapic.with_api_doc(tags=[SWAGGER_TAG_WORKSPACE_ENDPOINTS])
     @require_workspace_role(UserRoleInWorkspace.CONTENT_MANAGER)
     @hapic.input_path(WorkspaceAndContentIdPathSchema())
     @hapic.output_body(NoContentSchema(), default_http_code=HTTPStatus.NO_CONTENT)  # nopep8