from django.test import TestCase
from djangorestframework.views import View
from djangorestframework.compat import apply_markdown
# We check that docstrings get nicely un-indented.
DESCRIPTION = """an example docstring
====================
* list
* list
another header
--------------
    code block
indented
# hash style header #"""
# If markdown is installed we also test it's working
# (and that our wrapped forces '=' to h2 and '-' to h3)
# We support markdown < 2.1 and markdown >= 2.1
MARKED_DOWN_lt_21 = """
an example docstring
another header
code block
indented
"""
MARKED_DOWN_gte_21 = """an example docstring
code block
indented
"""
class TestViewNamesAndDescriptions(TestCase):
    def test_resource_name_uses_classname_by_default(self):
        """Ensure Resource names are based on the classname by default."""
        class MockView(View):
            pass
        self.assertEquals(MockView().get_name(), 'Mock')
    def test_resource_name_can_be_set_explicitly(self):
        """Ensure Resource names can be set using the 'get_name' method."""
        example = 'Some Other Name'
        class MockView(View):
            def get_name(self):
                return example
        self.assertEquals(MockView().get_name(), example)
    def test_resource_description_uses_docstring_by_default(self):
        """Ensure Resource names are based on the docstring by default."""
        class MockView(View):
            """an example docstring
            ====================
            * list
            * list
            another header
            --------------
                code block
            indented
            # hash style header #"""
        self.assertEquals(MockView().get_description(), DESCRIPTION)
    def test_resource_description_can_be_set_explicitly(self):
        """Ensure Resource descriptions can be set using the 'get_description' method."""
        example = 'Some other description'
        class MockView(View):
            """docstring"""
            def get_description(self):
                return example
        self.assertEquals(MockView().get_description(), example)
    def test_resource_description_does_not_require_docstring(self):
        """Ensure that empty docstrings do not affect the Resource's description if it has been set using the 'get_description' method."""
        example = 'Some other description'
        class MockView(View):
            def get_description(self):
                return example
        self.assertEquals(MockView().get_description(), example)
    def test_resource_description_can_be_empty(self):
        """Ensure that if a resource has no doctring or 'description' class attribute, then it's description is the empty string."""
        class MockView(View):
            pass
        self.assertEquals(MockView().get_description(), '')
    def test_markdown(self):
        """Ensure markdown to HTML works as expected"""
        if apply_markdown:
            gte_21_match = apply_markdown(DESCRIPTION) == MARKED_DOWN_gte_21
            lt_21_match = apply_markdown(DESCRIPTION) == MARKED_DOWN_lt_21
            self.assertTrue(gte_21_match or lt_21_match)