#! /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 = '