refactor contentType and contentStatus legacy code + content_type endpoint

tracim/exceptions.py

@@ -94,4 +94,12 @@ class WrongUserPassword(TracimException):
 
 
 class UserNotExist(TracimException):
-    pass
+    pass
+
+
+class ContentStatusNotExist(TracimError):
+    pass
+
+
+class ContentTypeNotExist(TracimError):
+    pass

tracim/models/contents.py

@@ -0,0 +1,237 @@
+# -*- coding: utf-8 -*-
+import typing
+from enum import Enum
+
+from tracim.exceptions import ContentStatusNotExist, ContentTypeNotExist
+from tracim.models.applications import pagehtml, file, thread, pagemarkdownplus
+
+
+####
+# Content Status
+
+
+class GlobalStatus(Enum):
+    OPEN = 'open'
+    CLOSED = 'closed'
+
+
+class NewContentStatus(object):
+    """
+    Future ContentStatus object class
+    """
+    def __init__(
+            self,
+            slug: str,
+            global_status: str,
+            label: str,
+            icon: str,
+            hexcolor: str,
+    ):
+        self.slug = slug
+        self.global_status = global_status
+        self.label = label
+        self.icon = icon
+        self.hexcolor = hexcolor
+
+
+open_status = NewContentStatus(
+    slug='open',
+    global_status=GlobalStatus.OPEN.value,
+    label='Open',
+    icon='fa-square-o',
+    hexcolor='#000FF',
+)
+
+closed_validated_status = NewContentStatus(
+    slug='closed-validated',
+    global_status=GlobalStatus.CLOSED.value,
+    label='Validated',
+    icon='fa-check-square-o',
+    hexcolor='#000FF',
+)
+
+closed_unvalidated_status = NewContentStatus(
+    slug='closed-unvalidated',
+    global_status=GlobalStatus.CLOSED.value,
+    label='Cancelled',
+    icon='fa-close',
+    hexcolor='#000FF',
+)
+
+closed_deprecated_status = NewContentStatus(
+    slug='closed-deprecated',
+    global_status=GlobalStatus.CLOSED.value,
+    label='Deprecated',
+    icon='fa-warning',
+    hexcolor='#000FF',
+)
+
+
+CONTENT_DEFAULT_STATUS = [
+    open_status,
+    closed_validated_status,
+    closed_unvalidated_status,
+    closed_deprecated_status,
+]
+
+
+class ContentStatusLegacy(NewContentStatus):
+    """
+    Temporary remplacement object for Legacy ContentStatus Object
+    """
+    OPEN = open_status.slug
+    CLOSED_VALIDATED = closed_validated_status.slug
+    CLOSED_UNVALIDATED = closed_unvalidated_status.slug
+    CLOSED_DEPRECATED = closed_deprecated_status.slug
+
+    def __init__(self, slug: str):
+        for status in CONTENT_DEFAULT_STATUS:
+            if slug == status.slug:
+                super(ContentStatusLegacy).__init__(
+                    slug=status.slug,
+                    global_status=status.global_status,
+                    label=status.label,
+                    icon=status.icon,
+                    hexcolor=status.hexcolor,
+                )
+                return
+        raise ContentStatusNotExist()
+
+    @classmethod
+    def all(cls, type='') -> ['NewContentStatus']:
+        return CONTENT_DEFAULT_STATUS
+
+    @classmethod
+    def allowed_values(cls):
+        return [status.slug for status in CONTENT_DEFAULT_STATUS]
+
+
+####
+# ContentType
+
+
+class NewContentType(object):
+    """
+    Future ContentType object class
+    """
+    def __init__(
+            self,
+            slug: str,
+            icon: str,
+            hexcolor: str,
+            label: str,
+            creation_label: str,
+            available_statuses: typing.List[NewContentStatus],
+
+    ):
+        self.slug = slug
+        self.icon = icon
+        self.hexcolor = hexcolor
+        self.label = label
+        self.creation_label = creation_label
+        self.available_statuses = available_statuses
+
+
+thread_type = NewContentType(
+    slug='thread',
+    icon=thread.icon,
+    hexcolor=thread.hexcolor,
+    label='Thread',
+    creation_label='Discuss about a topic',
+    available_statuses=CONTENT_DEFAULT_STATUS,
+)
+
+file_type = NewContentType(
+    slug='file',
+    icon=file.icon,
+    hexcolor=file.hexcolor,
+    label='File',
+    creation_label='Upload a file',
+    available_statuses=CONTENT_DEFAULT_STATUS,
+)
+
+pagemarkdownplus_type = NewContentType(
+    slug='markdownpage',
+    icon=pagemarkdownplus.icon,
+    hexcolor=pagemarkdownplus.hexcolor,
+    label='Rich Markdown File',
+    creation_label='Create a Markdown document',
+    available_statuses=CONTENT_DEFAULT_STATUS,
+)
+
+pagehtml_type = NewContentType(
+    slug='page',
+    icon=pagehtml.icon,
+    hexcolor=pagehtml.hexcolor,
+    label='Text Document',
+    creation_label='Write a document',
+    available_statuses=CONTENT_DEFAULT_STATUS,
+)
+
+
+CONTENT_DEFAULT_TYPE = [
+    thread_type,
+    file_type,
+    pagemarkdownplus_type,
+    pagehtml_type,
+]
+
+
+class ContentTypeLegacy(NewContentType):
+    """
+    Temporary remplacement object for Legacy ContentType Object
+    """
+
+    # special type
+    Any = 'any'
+    Folder = 'folder'
+    Event = 'event'
+    Comment = 'comment'
+
+    File = file_type.slug
+    Thread = thread_type.slug
+    Page = pagehtml_type.slug
+
+    def __init__(self, slug: str):
+        for content_type in CONTENT_DEFAULT_TYPE:
+            if slug == content_type.slug:
+                super(ContentTypeLegacy).__init__(
+                    slug=content_type.slug,
+                    icon=content_type.icon,
+                    hexcolor=content_type.hexcolor,
+                    label=content_type.label,
+                    creation_label=content_type.creation_label,
+                    available_statuses=content_type.available_statuses
+                )
+                return
+        raise ContentTypeNotExist()
+
+    @classmethod
+    def all(cls) -> typing.List[str]:
+        return cls.allowed_types()
+
+    @classmethod
+    def allowed_types(cls) -> typing.List[str]:
+        contents_types = [status.slug for status in CONTENT_DEFAULT_TYPE]
+        contents_types.extend([cls.Folder, cls.Event, cls.Comment])
+        return contents_types
+
+    @classmethod
+    def allowed_types_for_folding(cls):
+        # This method is used for showing only "main"
+        # types in the left-side treeview
+        contents_types = [status.slug for status in CONTENT_DEFAULT_TYPE]
+        contents_types.extend([cls.Folder])
+        return contents_types
+
+    # TODO - G.M - 30-05-2018 - This method don't do anything.
+    @classmethod
+    def sorted(cls, types: ['ContentType']) -> ['ContentType']:
+        return types
+
+    @property
+    def id(self):
+        return self.slug
+
+    def toDict(self):
+        raise NotImplementedError()

tracim/models/data.py

@@ -289,249 +289,254 @@ class ActionDescription(object):
                 ]
 
 
-class ContentStatus(object):
-    """
-    Allowed status are:
-    - open
-    - closed-validated
-    - closed-invalidated
-    - closed-deprecated
-    """
-
-    OPEN = 'open'
-    CLOSED_VALIDATED = 'closed-validated'
-    CLOSED_UNVALIDATED = 'closed-unvalidated'
-    CLOSED_DEPRECATED = 'closed-deprecated'
-
-    # TODO - G.M - 10-04-2018 - [Cleanup] Drop this
-    # _LABELS = {'open': l_('work in progress'),
-    #            'closed-validated': l_('closed — validated'),
-    #            'closed-unvalidated': l_('closed — cancelled'),
-    #            'closed-deprecated': l_('deprecated')}
-    #
-    # _LABELS_THREAD = {'open': l_('subject in progress'),
-    #                   'closed-validated': l_('subject closed — resolved'),
-    #                   'closed-unvalidated': l_('subject closed — cancelled'),
-    #                   'closed-deprecated': l_('deprecated')}
-    #
-    # _LABELS_FILE = {'open': l_('work in progress'),
-    #                 'closed-validated': l_('closed — validated'),
-    #                 'closed-unvalidated': l_('closed — cancelled'),
-    #                 'closed-deprecated': l_('deprecated')}
-    #
-    # _ICONS = {
-    #     'open': 'fa fa-square-o',
-    #     'closed-validated': 'fa fa-check-square-o',
-    #     'closed-unvalidated': 'fa fa-close',
-    #     'closed-deprecated': 'fa fa-warning',
-    # }
-    #
-    # _CSS = {
-    #     'open': 'tracim-status-open',
-    #     'closed-validated': 'tracim-status-closed-validated',
-    #     'closed-unvalidated': 'tracim-status-closed-unvalidated',
-    #     'closed-deprecated': 'tracim-status-closed-deprecated',
-    # }
-
-    def __init__(self,
-                 id,
-                 # TODO - G.M - 10-04-2018 - [Cleanup] Drop this
-                 # type=''
-    ):
-        self.id = id
-        # TODO - G.M - 10-04-2018 - [Cleanup] Drop this
-        # self.icon = ContentStatus._ICONS[id]
-        # self.css = ContentStatus._CSS[id]
-        #
-        # if type==ContentType.Thread:
-        #     self.label = ContentStatus._LABELS_THREAD[id]
-        # elif type==ContentType.File:
-        #     self.label = ContentStatus._LABELS_FILE[id]
-        # else:
-        #     self.label = ContentStatus._LABELS[id]
-
-
-    @classmethod
-    def all(cls, type='') -> ['ContentStatus']:
-        # TODO - G.M - 10-04-2018 - [Cleanup] Drop this
-        # all = []
-        # all.append(ContentStatus('open', type))
-        # all.append(ContentStatus('closed-validated', type))
-        # all.append(ContentStatus('closed-unvalidated', type))
-        # all.append(ContentStatus('closed-deprecated', type))
-        # return all
-        status_list = list()
-        for elem in cls.allowed_values():
-            status_list.append(ContentStatus(elem))
-        return status_list
-
-    @classmethod
-    def allowed_values(cls):
-        # TODO - G.M - 10-04-2018 - [Cleanup] Drop this
-        # return ContentStatus._LABELS.keys()
-        return [
-            ContentStatus.OPEN,
-            ContentStatus.CLOSED_UNVALIDATED,
-            ContentStatus.CLOSED_VALIDATED,
-            ContentStatus.CLOSED_DEPRECATED
-        ]
-
-
-class ContentType(object):
-    Any = 'any'
-
-    Folder = 'folder'
-    File = 'file'
-    Comment = 'comment'
-    Thread = 'thread'
-    Page = 'page'
-    Event = 'event'
-
-    # TODO - G.M - 10-04-2018 - [Cleanup] Do we really need this ?
-    # _STRING_LIST_SEPARATOR = ','
-
-    # TODO - G.M - 10-04-2018 - [Cleanup] Drop this
-    # _ICONS = {  # Deprecated
-    #     'dashboard': 'fa-home',
-    #     'workspace': 'fa-bank',
-    #     'folder': 'fa fa-folder-open-o',
-    #     'file': 'fa fa-paperclip',
-    #     'page': 'fa fa-file-text-o',
-    #     'thread': 'fa fa-comments-o',
-    #     'comment': 'fa fa-comment-o',
-    #     'event': 'fa fa-calendar-o',
-    # }
-    #
-    # _CSS_ICONS = {
-    #     'dashboard': 'fa fa-home',
-    #     'workspace': 'fa fa-bank',
-    #     'folder': 'fa fa-folder-open-o',
-    #     'file': 'fa fa-paperclip',
-    #     'page': 'fa fa-file-text-o',
-    #     'thread': 'fa fa-comments-o',
-    #     'comment': 'fa fa-comment-o',
-    #     'event': 'fa fa-calendar-o',
-    # }
-    #
-    # _CSS_COLORS = {
-    #     'dashboard': 't-dashboard-color',
-    #     'workspace': 't-less-visible',
-    #     'folder': 't-folder-color',
-    #     'file': 't-file-color',
-    #     'page': 't-page-color',
-    #     'thread': 't-thread-color',
-    #     'comment': 't-thread-color',
-    #     'event': 't-event-color',
-    # }
-
-    _ORDER_WEIGHT = {
-        'folder': 0,
-        'page': 1,
-        'thread': 2,
-        'file': 3,
-        'comment': 4,
-        'event': 5,
-    }
-
-    # TODO - G.M - 10-04-2018 - [Cleanup] Drop this
-    # _LABEL = {
-    #     'dashboard': '',
-    #     'workspace': l_('workspace'),
-    #     'folder': l_('folder'),
-    #     'file': l_('file'),
-    #     'page': l_('page'),
-    #     'thread': l_('thread'),
-    #     'comment': l_('comment'),
-    #     'event': l_('event'),
-    # }
-    #
-    # _DELETE_LABEL = {
-    #     'dashboard': '',
-    #     'workspace': l_('Delete this workspace'),
-    #     'folder': l_('Delete this folder'),
-    #     'file': l_('Delete this file'),
-    #     'page': l_('Delete this page'),
-    #     'thread': l_('Delete this thread'),
-    #     'comment': l_('Delete this comment'),
-    #     'event': l_('Delete this event'),
-    # }
-    #
-    # @classmethod
-    # def get_icon(cls, type: str):
-    #     assert(type in ContentType._ICONS) # DYN_REMOVE
-    #     return ContentType._ICONS[type]
-
-    @classmethod
-    def all(cls):
-        return cls.allowed_types()
-
-    @classmethod
-    def allowed_types(cls):
-        return [cls.Folder, cls.File, cls.Comment, cls.Thread, cls.Page,
-                cls.Event]
-
-    @classmethod
-    def allowed_types_for_folding(cls):
-        # This method is used for showing only "main"
-        # types in the left-side treeview
-        return [cls.Folder, cls.File, cls.Thread, cls.Page]
-
-    # TODO - G.M - 10-04-2018 - [Cleanup] Drop this
-    # @classmethod
-    # def allowed_types_from_str(cls, allowed_types_as_string: str):
-    #     allowed_types = []
-    #     # HACK - THIS
-    #     for item in allowed_types_as_string.split(ContentType._STRING_LIST_SEPARATOR):
-    #         if item and item in ContentType.allowed_types_for_folding():
-    #             allowed_types.append(item)
-    #     return allowed_types
-    #
-    # @classmethod
-    # def fill_url(cls, content: 'Content'):
-    #     # TODO - DYNDATATYPE - D.A. - 2014-12-02
-    #     # Make this code dynamic loading data types
-    #
-    #     if content.type==ContentType.Folder:
-    #         return '/workspaces/{}/folders/{}'.format(content.workspace_id, content.content_id)
-    #     elif content.type==ContentType.File:
-    #         return '/workspaces/{}/folders/{}/files/{}'.format(content.workspace_id, content.parent_id, content.content_id)
-    #     elif content.type==ContentType.Thread:
-    #         return '/workspaces/{}/folders/{}/threads/{}'.format(content.workspace_id, content.parent_id, content.content_id)
-    #     elif content.type==ContentType.Page:
-    #         return '/workspaces/{}/folders/{}/pages/{}'.format(content.workspace_id, content.parent_id, content.content_id)
-    #
-    # @classmethod
-    # def fill_url_for_workspace(cls, workspace: Workspace):
-    #     # TODO - DYNDATATYPE - D.A. - 2014-12-02
-    #     # Make this code dynamic loading data types
-    #     return '/workspaces/{}'.format(workspace.workspace_id)
-
-    @classmethod
-    def sorted(cls, types: ['ContentType']) -> ['ContentType']:
-        return sorted(types, key=lambda content_type: content_type.priority)
-
-    @property
-    def type(self):
-        return self.id
-
-    def __init__(self, type):
-        self.id = type
-        # TODO - G.M - 10-04-2018 - [Cleanup] Drop this
-        # self.icon = ContentType._CSS_ICONS[type]
-        # self.color = ContentType._CSS_COLORS[type]  # deprecated
-        # self.css = ContentType._CSS_COLORS[type]
-        # self.label = ContentType._LABEL[type]
-        self.priority = ContentType._ORDER_WEIGHT[type]
-
-    def toDict(self):
-        return dict(id=self.type,
-                    type=self.type,
-                    # TODO - G.M - 10-04-2018 - [Cleanup] Drop this
-                    # icon=self.icon,
-                    # color=self.color,
-                    # label=self.label,
-                    priority=self.priority)
-
+from .contents import ContentStatusLegacy as ContentStatus
+from .contents import ContentTypeLegacy as ContentType
+# TODO - G.M - 30-05-2018 - Drop this old code when whe are sure nothing
+# is lost .
+
+
+# class ContentStatus(object):
+#     """
+#     Allowed status are:
+#     - open
+#     - closed-validated
+#     - closed-invalidated
+#     - closed-deprecated
+#     """
+#
+#     OPEN = 'open'
+#     CLOSED_VALIDATED = 'closed-validated'
+#     CLOSED_UNVALIDATED = 'closed-unvalidated'
+#     CLOSED_DEPRECATED = 'closed-deprecated'
+#
+#     # TODO - G.M - 10-04-2018 - [Cleanup] Drop this
+#     # _LABELS = {'open': l_('work in progress'),
+#     #            'closed-validated': l_('closed — validated'),
+#     #            'closed-unvalidated': l_('closed — cancelled'),
+#     #            'closed-deprecated': l_('deprecated')}
+#     #
+#     # _LABELS_THREAD = {'open': l_('subject in progress'),
+#     #                   'closed-validated': l_('subject closed — resolved'),
+#     #                   'closed-unvalidated': l_('subject closed — cancelled'),
+#     #                   'closed-deprecated': l_('deprecated')}
+#     #
+#     # _LABELS_FILE = {'open': l_('work in progress'),
+#     #                 'closed-validated': l_('closed — validated'),
+#     #                 'closed-unvalidated': l_('closed — cancelled'),
+#     #                 'closed-deprecated': l_('deprecated')}
+#     #
+#     # _ICONS = {
+#     #     'open': 'fa fa-square-o',
+#     #     'closed-validated': 'fa fa-check-square-o',
+#     #     'closed-unvalidated': 'fa fa-close',
+#     #     'closed-deprecated': 'fa fa-warning',
+#     # }
+#     #
+#     # _CSS = {
+#     #     'open': 'tracim-status-open',
+#     #     'closed-validated': 'tracim-status-closed-validated',
+#     #     'closed-unvalidated': 'tracim-status-closed-unvalidated',
+#     #     'closed-deprecated': 'tracim-status-closed-deprecated',
+#     # }
+#
+#     def __init__(self,
+#                  id,
+#                  # TODO - G.M - 10-04-2018 - [Cleanup] Drop this
+#                  # type=''
+#     ):
+#         self.id = id
+#         # TODO - G.M - 10-04-2018 - [Cleanup] Drop this
+#         # self.icon = ContentStatus._ICONS[id]
+#         # self.css = ContentStatus._CSS[id]
+#         #
+#         # if type==ContentType.Thread:
+#         #     self.label = ContentStatus._LABELS_THREAD[id]
+#         # elif type==ContentType.File:
+#         #     self.label = ContentStatus._LABELS_FILE[id]
+#         # else:
+#         #     self.label = ContentStatus._LABELS[id]
+#
+#
+#     @classmethod
+#     def all(cls, type='') -> ['ContentStatus']:
+#         # TODO - G.M - 10-04-2018 - [Cleanup] Drop this
+#         # all = []
+#         # all.append(ContentStatus('open', type))
+#         # all.append(ContentStatus('closed-validated', type))
+#         # all.append(ContentStatus('closed-unvalidated', type))
+#         # all.append(ContentStatus('closed-deprecated', type))
+#         # return all
+#         status_list = list()
+#         for elem in cls.allowed_values():
+#             status_list.append(ContentStatus(elem))
+#         return status_list
+#
+#     @classmethod
+#     def allowed_values(cls):
+#         # TODO - G.M - 10-04-2018 - [Cleanup] Drop this
+#         # return ContentStatus._LABELS.keys()
+#         return [
+#             ContentStatus.OPEN,
+#             ContentStatus.CLOSED_UNVALIDATED,
+#             ContentStatus.CLOSED_VALIDATED,
+#             ContentStatus.CLOSED_DEPRECATED
+#         ]
+
+
+# class ContentType(object):
+#     Any = 'any'
+#
+#     Folder = 'folder'
+#     File = 'file'
+#     Comment = 'comment'
+#     Thread = 'thread'
+#     Page = 'page'
+#     Event = 'event'
+#
+#     # TODO - G.M - 10-04-2018 - [Cleanup] Do we really need this ?
+#     # _STRING_LIST_SEPARATOR = ','
+#
+#     # TODO - G.M - 10-04-2018 - [Cleanup] Drop this
+#     # _ICONS = {  # Deprecated
+#     #     'dashboard': 'fa-home',
+#     #     'workspace': 'fa-bank',
+#     #     'folder': 'fa fa-folder-open-o',
+#     #     'file': 'fa fa-paperclip',
+#     #     'page': 'fa fa-file-text-o',
+#     #     'thread': 'fa fa-comments-o',
+#     #     'comment': 'fa fa-comment-o',
+#     #     'event': 'fa fa-calendar-o',
+#     # }
+#     #
+#     # _CSS_ICONS = {
+#     #     'dashboard': 'fa fa-home',
+#     #     'workspace': 'fa fa-bank',
+#     #     'folder': 'fa fa-folder-open-o',
+#     #     'file': 'fa fa-paperclip',
+#     #     'page': 'fa fa-file-text-o',
+#     #     'thread': 'fa fa-comments-o',
+#     #     'comment': 'fa fa-comment-o',
+#     #     'event': 'fa fa-calendar-o',
+#     # }
+#     #
+#     # _CSS_COLORS = {
+#     #     'dashboard': 't-dashboard-color',
+#     #     'workspace': 't-less-visible',
+#     #     'folder': 't-folder-color',
+#     #     'file': 't-file-color',
+#     #     'page': 't-page-color',
+#     #     'thread': 't-thread-color',
+#     #     'comment': 't-thread-color',
+#     #     'event': 't-event-color',
+#     # }
+#
+#     _ORDER_WEIGHT = {
+#         'folder': 0,
+#         'page': 1,
+#         'thread': 2,
+#         'file': 3,
+#         'comment': 4,
+#         'event': 5,
+#     }
+#
+#     # TODO - G.M - 10-04-2018 - [Cleanup] Drop this
+#     # _LABEL = {
+#     #     'dashboard': '',
+#     #     'workspace': l_('workspace'),
+#     #     'folder': l_('folder'),
+#     #     'file': l_('file'),
+#     #     'page': l_('page'),
+#     #     'thread': l_('thread'),
+#     #     'comment': l_('comment'),
+#     #     'event': l_('event'),
+#     # }
+#     #
+#     # _DELETE_LABEL = {
+#     #     'dashboard': '',
+#     #     'workspace': l_('Delete this workspace'),
+#     #     'folder': l_('Delete this folder'),
+#     #     'file': l_('Delete this file'),
+#     #     'page': l_('Delete this page'),
+#     #     'thread': l_('Delete this thread'),
+#     #     'comment': l_('Delete this comment'),
+#     #     'event': l_('Delete this event'),
+#     # }
+#     #
+#     # @classmethod
+#     # def get_icon(cls, type: str):
+#     #     assert(type in ContentType._ICONS) # DYN_REMOVE
+#     #     return ContentType._ICONS[type]
+#
+#     @classmethod
+#     def all(cls):
+#         return cls.allowed_types()
+#
+#     @classmethod
+#     def allowed_types(cls):
+#         return [cls.Folder, cls.File, cls.Comment, cls.Thread, cls.Page,
+#                 cls.Event]
+#
+#     @classmethod
+#     def allowed_types_for_folding(cls):
+#         # This method is used for showing only "main"
+#         # types in the left-side treeview
+#         return [cls.Folder, cls.File, cls.Thread, cls.Page]
+#
+#     # TODO - G.M - 10-04-2018 - [Cleanup] Drop this
+#     # @classmethod
+#     # def allowed_types_from_str(cls, allowed_types_as_string: str):
+#     #     allowed_types = []
+#     #     # HACK - THIS
+#     #     for item in allowed_types_as_string.split(ContentType._STRING_LIST_SEPARATOR):
+#     #         if item and item in ContentType.allowed_types_for_folding():
+#     #             allowed_types.append(item)
+#     #     return allowed_types
+#     #
+#     # @classmethod
+#     # def fill_url(cls, content: 'Content'):
+#     #     # TODO - DYNDATATYPE - D.A. - 2014-12-02
+#     #     # Make this code dynamic loading data types
+#     #
+#     #     if content.type==ContentType.Folder:
+#     #         return '/workspaces/{}/folders/{}'.format(content.workspace_id, content.content_id)
+#     #     elif content.type==ContentType.File:
+#     #         return '/workspaces/{}/folders/{}/files/{}'.format(content.workspace_id, content.parent_id, content.content_id)
+#     #     elif content.type==ContentType.Thread:
+#     #         return '/workspaces/{}/folders/{}/threads/{}'.format(content.workspace_id, content.parent_id, content.content_id)
+#     #     elif content.type==ContentType.Page:
+#     #         return '/workspaces/{}/folders/{}/pages/{}'.format(content.workspace_id, content.parent_id, content.content_id)
+#     #
+#     # @classmethod
+#     # def fill_url_for_workspace(cls, workspace: Workspace):
+#     #     # TODO - DYNDATATYPE - D.A. - 2014-12-02
+#     #     # Make this code dynamic loading data types
+#     #     return '/workspaces/{}'.format(workspace.workspace_id)
+#
+#     @classmethod
+#     def sorted(cls, types: ['ContentType']) -> ['ContentType']:
+#         return sorted(types, key=lambda content_type: content_type.priority)
+#
+#     @property
+#     def type(self):
+#         return self.id
+#
+#     def __init__(self, type):
+#         self.id = type
+#         # TODO - G.M - 10-04-2018 - [Cleanup] Drop this
+#         # self.icon = ContentType._CSS_ICONS[type]
+#         # self.color = ContentType._CSS_COLORS[type]  # deprecated
+#         # self.css = ContentType._CSS_COLORS[type]
+#         # self.label = ContentType._LABEL[type]
+#         self.priority = ContentType._ORDER_WEIGHT[type]
+#
+#     def toDict(self):
+#         return dict(id=self.type,
+#                     type=self.type,
+#                     # TODO - G.M - 10-04-2018 - [Cleanup] Drop this
+#                     # icon=self.icon,
+#                     # color=self.color,
+#                     # label=self.label,
+#                     priority=self.priority)
 
 class ContentChecker(object):
 

tracim/tests/functional/test_system.py

@@ -95,13 +95,43 @@ class TestContentsTypesEndpoint(FunctionalTest):
         )
         res = self.testapp.get('/api/v2/system/content_types', status=200)
         res = res.json_body
+
         content_type = res[0]
-        assert content_type['slug'] == 'pagehtml'
+        assert content_type['slug'] == 'thread'
+        assert content_type['icon'] == 'comments-o'
+        assert content_type['hexcolor'] == '#ad4cf9'
+        assert content_type['label'] == 'Thread'
+        assert content_type['creation_label'] == 'Discuss about a topic'
+        assert 'available_statuses' in content_type
+        assert len(content_type['available_statuses']) == 4
+
+        content_type = res[1]
+        assert content_type['slug'] == 'file'
+        assert content_type['icon'] == 'paperclip'
+        assert content_type['hexcolor'] == '#FF9900'
+        assert content_type['label'] == 'File'
+        assert content_type['creation_label'] == 'Upload a file'
+        assert 'available_statuses' in content_type
+        assert len(content_type['available_statuses']) == 4
+
+        content_type = res[2]
+        assert content_type['slug'] == 'markdownpage'
+        assert content_type['icon'] == 'file-code'
+        assert content_type['hexcolor'] == '#f12d2d'
+        assert content_type['label'] == 'Rich Markdown File'
+        assert content_type['creation_label'] == 'Create a Markdown document'
+        assert 'available_statuses' in content_type
+        assert len(content_type['available_statuses']) == 4
+
+        content_type = res[3]
+        assert content_type['slug'] == 'page'
         assert content_type['icon'] == 'file-text-o'
         assert content_type['hexcolor'] == '#3f52e3'
-        assert content_type['label'] == 'Text Documents'
+        assert content_type['label'] == 'Text Document'
         assert content_type['creation_label'] == 'Write a document'
         assert 'available_statuses' in content_type
+        assert len(content_type['available_statuses']) == 4
+
         # TODO - G.M - 29-05-2018 - Better check for available_statuses
 
     def test_api__get_content_types__err_401__unregistered_user(self):

tracim/views/core_api/schemas.py

@@ -4,6 +4,7 @@ from marshmallow import post_load
 from marshmallow.validate import OneOf
 
 from tracim.models.auth import Profile
+from tracim.models.contents import CONTENT_DEFAULT_TYPE, GlobalStatus, CONTENT_DEFAULT_STATUS
 from tracim.models.context_models import LoginCredentials
 from tracim.models.data import UserRoleInWorkspace
 
@@ -65,12 +66,60 @@ class UserSchema(marshmallow.Schema):
         description = 'User account of Tracim'
 
 
+# Path Schemas
+
+
 class UserIdPathSchema(marshmallow.Schema):
-    user_id = marshmallow.fields.Int(example=3)
+    user_id = marshmallow.fields.Int(example=3, required=True)
 
 
 class WorkspaceIdPathSchema(marshmallow.Schema):
-    workspace_id = marshmallow.fields.Int(example=4)
+    workspace_id = marshmallow.fields.Int(example=4, required=True)
+
+
+class ContentIdPathSchema(marshmallow.Schema):
+    content_id = marshmallow.fields.Int(example=6, required=True)
+
+
+class WorkspaceAndContentIdPathSchema(WorkspaceIdPathSchema, ContentIdPathSchema):
+    pass
+
+
+class FilterContentPathSchema(marshmallow.Schema):
+    workspace_id = marshmallow.fields.Int(example=4, required=True)
+    parent_id = workspace_id = marshmallow.fields.Int(
+        example=2,
+        default=None,
+        description='allow to filter items in a folder.'
+                    ' If not set, then return all contents.'
+                    ' If set to 0, then return root contents.'
+                    ' If set to another value, return all contents'
+                    ' directly included in the folder parent_id'
+    )
+    show_archived = marshmallow.fields.Int(
+        example=0,
+        default=0,
+        description='if set to 1, then show archived contents.'
+                    ' Default is 0 - hide archived content'
+    )
+    show_deleted = marshmallow.fields.Int(
+        example=0,
+        default=0,
+        description='if set to 1, then show deleted contents.'
+                    ' Default is 0 - hide deleted content'
+    )
+    show_active = marshmallow.fields.Int(
+        example=1,
+        default=1,
+        description='f set to 1, then show active contents. '
+                    'Default is 1 - show active content.'
+                    ' Note: active content are content '
+                    'that is neither archived nor deleted. '
+                    'The reason for this parameter to exist is for example '
+                    'to allow to show only archived documents'
+    )
+
+###
 
 
 class BasicAuthSchema(marshmallow.Schema):
@@ -194,3 +243,106 @@ class ApplicationSchema(marshmallow.Schema):
 
     class Meta:
         description = 'Tracim Application informations'
+
+
+class StatusSchema(marshmallow.Schema):
+    slug = marshmallow.fields.String(
+        example='open',
+        description='the slug represents the type of status. '
+                    'Statuses are open, closed-validated, closed-invalidated, closed-deprecated'  # nopep8
+    )
+    global_status = marshmallow.fields.String(
+        example='Open',
+        description='global_status: open, closed',
+        validate=OneOf([status.value for status in GlobalStatus]),
+    )
+    label = marshmallow.fields.String(example='Open')
+    icon = marshmallow.fields.String(example='fa-check')
+    hexcolor = marshmallow.fields.String(example='#0000FF')
+
+
+class ContentTypeSchema(marshmallow.Schema):
+    slug = marshmallow.fields.String(
+        example='pagehtml',
+        validate=OneOf([content.slug for content in CONTENT_DEFAULT_TYPE]),
+    )
+    icon = marshmallow.fields.String(
+        example='fa-file-text-o',
+        description='CSS class of the icon. Example: file-o for using Fontawesome file-o icon',  # nopep8
+    )
+    hexcolor = marshmallow.fields.String(
+        example="#FF0000",
+        description='HTML encoded color associated to the application. Example:#FF0000 for red'  # nopep8
+    )
+    label = marshmallow.fields.String(
+        example='Text Documents'
+    )
+    creation_label = marshmallow.fields.String(
+        example='Write a document'
+    )
+    available_statuses = marshmallow.fields.Nested(
+        StatusSchema,
+        many=True
+    )
+
+
+class ContentMoveSchema(marshmallow.Schema):
+    # TODO - G.M - 30-05-2018 - Read and apply this note
+    # Note:
+    # if the new workspace is different, then the backend
+    # must check if the user is allowed to move to this workspace
+    # (the user must be content manager of both workspaces)
+    new_parent_id = marshmallow.fields.Int(
+        example=42,
+        description='id of the new parent content id.'
+    )
+
+
+class ContentCreationSchema(marshmallow.Schema):
+    label = marshmallow.fields.String(
+        example='contract for client XXX',
+        description='Title of the content to create'
+    )
+    content_type_slug = marshmallow.fields.String(
+        example='htmlpage',
+        validate=OneOf(CONTENT_DEFAULT_TYPE),
+    )
+
+
+class ContentDigestSchema(marshmallow.Schema):
+    id = marshmallow.fields.Int(example=6)
+    slug = marshmallow.fields.Str(example='intervention-report-12')
+    parent_id = marshmallow.fields.Int(
+        example=34,
+        allow_none=True,
+        default=None
+    )
+    workspace_id = marshmallow.fields.Int(
+        example=19,
+    )
+    label = marshmallow.fields.Str(example='Intervention Report 12')
+    content_type_slug = marshmallow.fields.Str(
+        example='htmlpage',
+        validate=OneOf([content.slug for content in CONTENT_DEFAULT_TYPE]),
+    )
+    sub_content_type_slug = marshmallow.fields.Nested(
+        ContentTypeSchema(only=('slug',)),
+        many=True,
+        description='list of content types allowed as sub contents. '
+                    'This field is required for folder contents, '
+                    'set it to empty list in other cases'
+    )
+    status_slug = marshmallow.fields.Str(
+        example='closed-deprecated',
+        validate=OneOf([status.slug for status in CONTENT_DEFAULT_STATUS]),
+        description='this slug is found in content_type available statuses',
+    )
+    is_archived = marshmallow.fields.Bool(example=False)
+    is_deleted = marshmallow.fields.Bool(example=False)
+    show_in_ui = marshmallow.fields.Bool(
+        example=True,
+        description='if false, then do not show content in the treeview. '
+                    'This may his maybe used for specific contents or '
+                    'for sub-contents. Default is True. '
+                    'In first version of the API, this field is always True',
+    )

tracim/views/core_api/system_controller.py

@@ -5,6 +5,7 @@ from tracim.exceptions import NotAuthentificated, InsufficientUserProfile
 from tracim.lib.utils.authorization import require_profile
 from tracim.models import Group
 from tracim.models.applications import applications
+from tracim.models.contents import CONTENT_DEFAULT_TYPE
 
 try:  # Python 3.5+
     from http import HTTPStatus
@@ -14,7 +15,7 @@ except ImportError:
 from tracim import TracimRequest
 from tracim.extensions import hapic
 from tracim.views.controllers import Controller
-from tracim.views.core_api.schemas import ApplicationSchema
+from tracim.views.core_api.schemas import ApplicationSchema, ContentTypeSchema
 
 
 class SystemController(Controller):
@@ -30,6 +31,18 @@ class SystemController(Controller):
         """
         return applications
 
+    @hapic.with_api_doc()
+    @hapic.handle_exception(NotAuthentificated, HTTPStatus.UNAUTHORIZED)
+    @hapic.handle_exception(InsufficientUserProfile, HTTPStatus.FORBIDDEN)
+    @require_profile(Group.TIM_USER)
+    @hapic.output_body(ContentTypeSchema(many=True),)
+    def content_types(self, context, request: TracimRequest, hapic_data=None):
+        """
+        Get list of alls applications installed in this tracim instance.
+        """
+
+        return CONTENT_DEFAULT_TYPE
+
     def bind(self, configurator: Configurator) -> None:
         """
         Create all routes and views using pyramid configurator
@@ -40,3 +53,8 @@ class SystemController(Controller):
         configurator.add_route('applications', '/system/applications', request_method='GET')  # nopep8
         configurator.add_view(self.applications, route_name='applications')
 
+        # Content_types
+        configurator.add_route('content_types', '/system/content_types', request_method='GET')  # nopep8
+        configurator.add_view(self.content_types, route_name='content_types')
+
+