#! /usr/bin/env python3 # $Id$ # Authors: Lea Wiemann, Dmitry Shachnev, Günter Milde # Maintainer: docutils-develop@lists.sourceforge.net # Copyright: This module has been placed in the public domain. """ Miscellaneous HTML writer tests. """ import os import unittest from docutils import core # TEST_ROOT is ./test/ from the docutils root TEST_ROOT = os.path.abspath(os.path.join(__file__, '..', '..')) # DATA_ROOT is ./test/data/ from the docutils root DATA_ROOT = os.path.join(TEST_ROOT, 'data') def relpath(*parts): return os.path.relpath(os.path.join(*parts), os.getcwd()).replace('\\', '/') class EncodingTestCase(unittest.TestCase): def test_xmlcharrefreplace(self): # Test that xmlcharrefreplace is the default output encoding # error handler. settings_overrides = { 'output_encoding': 'latin1', 'stylesheet': '', '_disable_config': True, } result = bytes(core.publish_string( 'EUR = \u20ac', writer_name='html4css1', settings_overrides=settings_overrides)) # Encoding a euro sign with latin1 doesn't work, so the # xmlcharrefreplace handler is used. self.assertIn(b'EUR = €', result) class MovingArgsTestCase(unittest.TestCase): mys = {'stylesheet_path': '', # 'embed_stylesheet': False, '_disable_config': True, } def test_definition_list_item_classes(self): # Do not drop class arguments for the definition list item. # Pass them to to the term node instead. data = """\ first term: fist def .. class:: for the second item second term: second def """ result = core.publish_string(data, writer_name='html4css1', settings_overrides=self.mys) self.assertIn(b'
second term:
', result) def test_definition_list_item_name(self): # Do not drop the "name" of the definition list item. # Pass it to to the term node instead. data = """\ first term: first def .. _second item: second term: second def """ result = core.publish_string(data, writer_name='html4css1', settings_overrides=self.mys) self.assertIn(b'
second term:
', result) ham_css = relpath(DATA_ROOT, 'ham.css') class SettingsTestCase(unittest.TestCase): data = 'test' def test_default_stylesheet(self): # default style sheet, embedded mys = {'_disable_config': True} styles = core.publish_parts(self.data, writer_name='html4css1', settings_overrides=mys)['stylesheet'] self.assertIn('Default cascading style sheet ' 'for the HTML output of Docutils.', styles) def test_default_stylesheet_linked(self): # default style sheet, linked mys = {'_disable_config': True, 'embed_stylesheet': False} styles = core.publish_parts(self.data, writer_name='html4css1', settings_overrides=mys)['stylesheet'] self.assertIn('docutils/writers/html4css1/html4css1.css', styles) def test_math_stylesheet_linked(self): # default + math style sheet, linked mys = {'_disable_config': True, 'embed_stylesheet': False, 'stylesheet_path': 'html4css1.css, math.css'} styles = core.publish_parts(self.data, writer_name='html4css1', settings_overrides=mys)['stylesheet'] self.assertIn('docutils/writers/html4css1/html4css1.css', styles) self.assertIn('docutils/writers/html5_polyglot/math.css', styles) def test_custom_stylesheet_linked(self): # default + custom style sheet, linked mys = {'_disable_config': True, 'embed_stylesheet': False, 'stylesheet_path': 'html4css1.css, ' 'data/ham.css'} styles = core.publish_parts(self.data, writer_name='html4css1', settings_overrides=mys)['stylesheet'] self.assertIn('docutils/writers/html4css1/html4css1.css', styles) self.assertIn('href="data/ham.css"', styles) def test_custom_stylesheet_dir(self): mys = {'_disable_config': True, 'embed_stylesheet': False, 'stylesheet_dirs': ( os.path.join(TEST_ROOT, '../docutils/writers/html4css1/'), DATA_ROOT), 'stylesheet_path': 'html4css1.css, ham.css'} styles = core.publish_parts(self.data, writer_name='html4css1', settings_overrides=mys)['stylesheet'] if os.path.isdir(os.path.join(TEST_ROOT, '../docutils/writers/html4css1/')): self.assertIn('docutils/writers/html4css1/html4css1.css', styles) self.assertIn(f'href="{ham_css}"', styles) def test_custom_stylesheet_dir_embedded(self): mys = {'_disable_config': True, 'embed_stylesheet': True, 'stylesheet_dirs': ( os.path.join(TEST_ROOT, '../docutils/writers/html4css1/'), DATA_ROOT), 'stylesheet_path': 'ham.css'} styles = core.publish_parts(self.data, writer_name='html4css1', settings_overrides=mys)['stylesheet'] self.assertIn('dl.docutils dd {\n margin-bottom: 0.5em }', styles) html4css1_css = relpath(TEST_ROOT, 'functional/input/data/html4css1.css') math_css = relpath(TEST_ROOT, 'functional/input/data/math.css') class MathTestCase(unittest.TestCase): """Attention: This class tests the current implementation of maths support which is open to change in future Docutils releases. """ mathjax_script = '