doc,typing,cleaning

tracim/lib/utils/request.py

 from tracim.lib.utils.authorization import JSONDecodeError
 
 from tracim.models import User
-from tracim.models.data import Workspace, Content
+from tracim.models.data import Workspace
+from tracim.models.data import Content
 
 
 class TracimRequest(Request):
         """
         Get current content from request
         :param user: User who want to check the workspace
+        :param workspace: Workspace of the content
+        :param content: comment is related to this content
         :param request: pyramid request
         :return: current content
         """
         """
         Get current content from request
         :param user: User who want to check the workspace
+        :param workspace: Workspace of the content
         :param request: pyramid request
         :return: current content
         """

tracim/models/contents.py

 import typing
 from enum import Enum
 
-from tracim.exceptions import ContentStatusNotExist, ContentTypeNotExist
-from tracim.models.applications import html_documents, _file, thread, markdownpluspage
+from tracim.exceptions import ContentTypeNotExist
+from tracim.exceptions import ContentStatusNotExist
+from tracim.models.applications import html_documents
+from tracim.models.applications import _file
+from tracim.models.applications import thread
+from tracim.models.applications import markdownpluspage
 
 
 ####

tracim/models/context_models.py

 
 class MoveParams(object):
     """
-    Json body params for move action
+    Json body params for move action model
     """
-    def __init__(self, new_parent_id: str, new_workspace_id: str = None):
+    def __init__(self, new_parent_id: str, new_workspace_id: str = None) -> None:  # nopep8
         self.new_parent_id = new_parent_id
         self.new_workspace_id = new_workspace_id
 
 
 class LoginCredentials(object):
     """
-    Login credentials model for login
+    Login credentials model for login model
     """
 
-    def __init__(self, email: str, password: str):
+    def __init__(self, email: str, password: str) -> None:
         self.email = email
         self.password = password
 
 
 class WorkspaceAndContentPath(object):
     """
-    Paths params with workspace id and content_id
+    Paths params with workspace id and content_id model
     """
-    def __init__(self, workspace_id: int, content_id: int):
+    def __init__(self, workspace_id: int, content_id: int) -> None:
         self.content_id = content_id
         self.workspace_id = workspace_id
 
 
 class CommentPath(object):
     """
-    Paths params with workspace id and content_id
+    Paths params with workspace id and content_id and comment_id model
     """
-    def __init__(self, workspace_id: int, content_id: int, comment_id: int):
+    def __init__(
+        self,
+        workspace_id: int,
+        content_id: int,
+        comment_id: int
+    ) -> None:
         self.content_id = content_id
         self.workspace_id = workspace_id
         self.comment_id = comment_id
             show_archived: int = 0,
             show_deleted: int = 0,
             show_active: int = 1,
-    ):
+    ) -> None:
         self.parent_id = parent_id
         self.show_archived = bool(show_archived)
         self.show_deleted = bool(show_deleted)
             self,
             label: str,
             content_type: str,
-    ):
+    ) -> None:
         self.label = label
         self.content_type = content_type
 
     def __init__(
             self,
             raw_content: str,
-    ):
+    ) -> None:
         self.raw_content = raw_content
 
 
     def __init__(
             self,
             status: str,
-    ):
+    ) -> None:
         self.status = status
 
 
             self,
             label: str,
             raw_content: str,
-    ):
+    ) -> None:
         self.label = label
         self.raw_content = raw_content
 
             self,
             label: str,
             raw_content: str,
-    ):
+    ) -> None:
         self.label = label
         self.raw_content = raw_content
 
     @property
     def content_type(self) -> str:
         content_type = ContentType(self.content.type)
-        if content_type:
-            return content_type.slug
-        else:
-            return None
+        return content_type.slug
 
     @property
     def sub_content_types(self) -> typing.List[str]:
-        return [_type.slug for _type in self.content.get_allowed_content_types()]
+        return [_type.slug for _type in self.content.get_allowed_content_types()]  # nopep8
 
     @property
     def status(self) -> str:
     Interface to get Content data and Content data related to context.
     """
 
-    def __init__(self, content: ContentRevisionRO, dbsession: Session, config: CFG):
-        self.revision = content
+    def __init__(self, content_revision: ContentRevisionRO, dbsession: Session, config: CFG):
+        assert content_revision is not None
+        self.revision = content_revision
         self.dbsession = dbsession
         self.config = config
 
         return self.revision.status
 
     @property
-    def is_archived(self):
+    def is_archived(self) -> bool:
         return self.revision.is_archived
 
     @property
-    def is_deleted(self):
+    def is_deleted(self) -> bool:
         return self.revision.is_deleted
 
     @property
-    def raw_content(self):
+    def raw_content(self) -> str:
         return self.revision.description
 
     @property
-    def author(self):
+    def author(self) -> UserInContext:
         return UserInContext(
             dbsession=self.dbsession,
             config=self.config,
         )
 
     @property
-    def revision_id(self):
+    def revision_id(self) -> int:
         return self.revision.revision_id
 
     @property
-    def created(self):
+    def created(self) -> datetime:
         return self.updated
 
     @property
-    def modified(self):
+    def modified(self) -> datetime:
         return self.updated
 
     @property
-    def updated(self):
+    def updated(self) -> datetime:
         return self.revision.updated
 
     @property
-    def next_revision(self):
+    def next_revision(self) -> typing.Optional[ContentRevisionRO]:
+        """
+        Get next revision (later revision)
+        :return: next_revision
+        """
         next_revision = None
         revisions = self.revision.node.revisions
         # INFO - G.M - 2018-06-177 - Get revisions more recent that
             return None
 
     @property
-    def comments_ids(self):
+    def comments_ids(self) -> typing.List[int]:
         comments = self.revision.node.get_comments()
         # INFO - G.M - 2018-06-177 - Get comments more recent than revision.
         revisions_comments = [
 
     # Context-related
     @property
-    def show_in_ui(self):
+    def show_in_ui(self) -> bool:
         # TODO - G.M - 31-05-2018 - Enable Show_in_ui params
         # if false, then do not show content in the treeview.
         # This may his maybe used for specific contents or for sub-contents.
         return True
 
     @property
-    def slug(self):
+    def slug(self) -> str:
         return slugify(self.revision.label)