TocHtmlFormatter

Complexity

Total Complexity

10

Size/Duplication

Total Lines	90
Duplicated Lines	0 %

Test Coverage

Coverage

18.18%

Importance

Changes	1
Bugs	0	Features	0

5 Methods

Rating	Name	Duplication	Size	Complexity
A	generate_chapter()	0	11	2
A	generate()	0	10	1
B	write_contents()	0	17	5
A	write_into_file()	0	18	1
A	write_elements()	0	20	1

"""
SDoc

Copyright 2016 Set Based IT Consultancy

Licence MIT
"""
# ----------------------------------------------------------------------------------------------------------------------
from sdoc.helper.Html import Html
from sdoc.sdoc2 import node_store
from sdoc.sdoc2.formatter.html.HtmlFormatter import HtmlFormatter


class TocHtmlFormatter(HtmlFormatter):
    """
    HtmlFormatter for generating HTML code for table of contents.
    """

    # ------------------------------------------------------------------------------------------------------------------
    def generate(self, node, file):
        """
        Generates the HTML code for a table of contents node.

        :param sdoc.sdoc2.node.TocNode.TocNode node: The table of contents node.
        :param file file: The output file.
        """
        self.write_into_file(node, file)

        super().generate(node, file)

    # ------------------------------------------------------------------------------------------------------------------
    def generate_chapter(self, node, file):
        """
        Generates the HTML code for a table of contents node.

        :param sdoc.sdoc2.node.TocNode.TocNode node: The table of contents node.
        :param file file: The output file.
        """
        if file:
            self.write_into_file(node, file)

        super().generate_chapter(node, file)

    # ------------------------------------------------------------------------------------------------------------------
    @staticmethod
    def write_into_file(node, file):
        """
        Writes data into opened file.

        :param sdoc.sdoc2.node.TocNode.TocNode node: The table of contents node.
        :param file file: The output file.
        """
        attributes = {'role': 'navigation', 'class': 'table-of-contents'}

        file.write(Html.generate_tag('nav', attributes))
        file.write(Html.generate_element('h1', {}, node.argument))

        file.write('<ul>')
        TocHtmlFormatter.write_contents(node, file)
        file.write('</ul>')

        file.write('</nav>')

    # ------------------------------------------------------------------------------------------------------------------
    @staticmethod
    def write_contents(node, file):
        """
        Writes the contents into file.

        :param sdoc.sdoc2.node.TocNode.TocNode node: The table of contents node.
        :param file file: The output file.
        """
        depth = node.get_option_value('depth')

        for item in node.get_option_value('ids'):

            if depth and item['level'] <= int(depth):
                TocHtmlFormatter.write_elements(item, file)

            elif not depth:
                TocHtmlFormatter.write_elements(item, file)

    # ------------------------------------------------------------------------------------------------------------------
    @staticmethod
    def write_elements(item, file):
        """
        Write the containing elements.

        :param dict[str,str] item: The item which we outputs.
        :param file file: The output file.
        """
        class_attr = 'level{}'.format(item['level'])
        file.write(Html.generate_tag('li', {'class': class_attr}))

        id = '#{}'.format(item['id'])

This seems to re-define the built-in id.

        file.write(Html.generate_tag('a', {'href': id}))

        number = item['number']
        file.write(Html.generate_element('span', {}, number))

        file.write(' {}'.format(item['arg']))
        file.write('</a>')
        file.write('</li>')

# ----------------------------------------------------------------------------------------------------------------------
node_store.register_formatter('toc', 'html', TocHtmlFormatter)