#! /usr/bin/env python3 # $Id: test_class.py 10169 2025-06-16 10:05:35Z milde $ # Author: Lea Wiemann # Copyright: This module has been placed in the public domain. """ Tests for the 'class' directive. """ from pathlib import Path import sys import unittest if __name__ == '__main__': # prepend the "docutils root" to the Python library path # so we import the local `docutils` package. sys.path.insert(0, str(Path(__file__).resolve().parents[4])) from docutils.frontend import get_default_settings from docutils.parsers.rst import Parser from docutils.utils import new_document class ParserTestCase(unittest.TestCase): maxDiff = None def test_parser(self): parser = Parser() settings = get_default_settings(Parser) settings.warning_stream = '' for name, cases in totest.items(): for casenum, (case_input, case_expected) in enumerate(cases): with self.subTest(id=f'totest[{name!r}][{casenum}]'): document = new_document('test data', settings.copy()) parser.parse(case_input, document) output = document.pformat() self.assertEqual(case_expected, output) totest = {} totest['class'] = [ ["""\ .. class:: class1 class2 """, """\ .. internal attributes: .transform: docutils.transforms.misc.ClassAttribute .details: class: ['class1', 'class2'] directive: 'class' """], ["""\ .. class:: class1 class2 The classes are applied to this paragraph. And this one. """, """\ The classes are applied to this paragraph. And this one. """], ["""\ .. rst-class:: class1 class2 .. The classes will be applied to this block quote. """, """\ .. internal attributes: .transform: docutils.transforms.misc.ClassAttribute .details: class: ['class1', 'class2'] directive: 'rst-class' The classes will be applied to this block quote. """], ] if __name__ == '__main__': unittest.main()