test(src): add support for doctest

Author: Xiaokang2022

pyproject.toml

@@ -68,4 +68,4 @@ fail-under = 9
 disable = 'line-too-long'
 
 [tool.pytest.ini_options]
-addopts = ["--color=yes", "--reruns=3"]
+addopts = ["--color=yes", "--reruns=3", "--doctest-modules"]

tests/test_animation/test_animations.py

@@ -1,5 +1,6 @@
 # pylint: disable=C0111
 
+import doctest
 import tkinter
 import unittest
 
@@ -8,6 +9,12 @@
 from maliang.standard import widgets
 
 
+def load_tests(loader: unittest.TestLoader, tests: unittest.TestSuite, pattern: str | None) -> unittest.TestSuite:
+    del loader, pattern
+    tests.addTests(doctest.DocTestSuite(animations))
+    return tests
+
+
 class TestAnimation(unittest.TestCase):
 
     def setUp(self):

tests/test_animation/test_contollers.py

@@ -1,11 +1,18 @@
 # pylint: disable=C0111
 
+import doctest
 import math
 import unittest
 
 from maliang.animation import controllers
 
 
+def load_tests(loader: unittest.TestLoader, tests: unittest.TestSuite, pattern: str | None) -> unittest.TestSuite:
+    del loader, pattern
+    tests.addTests(doctest.DocTestSuite(controllers))
+    return tests
+
+
 class TestCase(unittest.TestCase):
 
     def test_linear(self) -> None:

tests/test_color/test_convert.py

@@ -1,12 +1,19 @@
 # pylint: disable=C0111
 
 import colorsys
+import doctest
 import tkinter
 import unittest
 
 from maliang.color import convert
 
 
+def load_tests(loader: unittest.TestLoader, tests: unittest.TestSuite, pattern: str | None) -> unittest.TestSuite:
+    del loader, pattern
+    tests.addTests(doctest.DocTestSuite(convert))
+    return tests
+
+
 class TestCase(unittest.TestCase):
 
     def test_rgb_to_hex(self) -> None:

tests/test_color/test_hsl.py

@@ -1,11 +1,18 @@
 # pylint: disable=C0111
 
+import doctest
 import math
 import unittest
 
 from maliang.color import hsl
 
 
+def load_tests(loader: unittest.TestLoader, tests: unittest.TestSuite, pattern: str | None) -> unittest.TestSuite:
+    del loader, pattern
+    tests.addTests(doctest.DocTestSuite(hsl))
+    return tests
+
+
 class TestCase(unittest.TestCase):
 
     def test_contrast(self) -> None:

tests/test_color/test_rgb.py

@@ -1,10 +1,17 @@
 # pylint: disable=C0111
 
+import doctest
 import unittest
 
 from maliang.color import rgb
 
 
+def load_tests(loader: unittest.TestLoader, tests: unittest.TestSuite, pattern: str | None) -> unittest.TestSuite:
+    del loader, pattern
+    tests.addTests(doctest.DocTestSuite(rgb))
+    return tests
+
+
 class TestCase(unittest.TestCase):
 
     def test_contrast(self) -> None:

tests/test_core/test_configs.py

@@ -1,12 +1,19 @@
 # pylint: disable=C0111
 
 import collections
+import doctest
 import unittest
 import unittest.mock
 
 from maliang.core import configs
 
 
+def load_tests(loader: unittest.TestLoader, tests: unittest.TestSuite, pattern: str | None) -> unittest.TestSuite:
+    del loader, pattern
+    tests.addTests(doctest.DocTestSuite(configs))
+    return tests
+
+
 class TestEnv(unittest.TestCase):
 
     def test_reset(self) -> None:

tests/test_core/test_containers.py

@@ -1,6 +1,7 @@
 # pylint: disable=C0111
 
 import contextlib
+import doctest
 import io
 import platform
 import tkinter
@@ -12,6 +13,12 @@
 from maliang.toolbox import enhanced
 
 
+def load_tests(loader: unittest.TestLoader, tests: unittest.TestSuite, pattern: str | None) -> unittest.TestSuite:
+    del loader, pattern
+    tests.addTests(doctest.DocTestSuite(containers))
+    return tests
+
+
 class TestTk(unittest.TestCase):
 
     def test_init(self) -> None:

tests/test_core/test_virtual.py

@@ -0,0 +1,16 @@
+# pylint: disable=C0111
+
+import doctest
+import unittest
+
+from maliang.core import virtual
+
+
+def load_tests(loader: unittest.TestLoader, tests: unittest.TestSuite, pattern: str | None) -> unittest.TestSuite:
+    del loader, pattern
+    tests.addTests(doctest.DocTestSuite(virtual))
+    return tests
+
+
+if __name__ == "__main__":
+    unittest.main()

tests/test_theme/test_manager.py

@@ -1,6 +1,7 @@
 # pylint: disable=C0111
 
 import contextlib
+import doctest
 import importlib
 import io
 import platform
@@ -11,6 +12,12 @@
 from maliang.theme import manager
 
 
+def load_tests(loader: unittest.TestLoader, tests: unittest.TestSuite, pattern: str | None) -> unittest.TestSuite:
+    del loader, pattern
+    tests.addTests(doctest.DocTestSuite(manager))
+    return tests
+
+
 class TestCase(unittest.TestCase):
 
     def setUp(self) -> None: