Update doctest.

.github/workflows/autotest.yml

@@ -73,6 +73,10 @@ jobs:
         run: |
           python -m pip install --upgrade pip
           pip install -r docs/requirements.txt
+      - name: Set up MSVC
+        uses: ilammy/msvc-dev-cmd@v1
+      - name: Compile IDL
+        run: midl /out docs\source docs\source\mytypelib.idl
       - name: Run doctest
         run: sphinx-build -b doctest -d docs/build/doctrees docs/source docs/build/doctest
         working-directory: ./

docs/source/conf.py

@@ -250,18 +250,29 @@
 
 # A string containing Python code that will be run before each test.  Useful
 # for initializing objects or setting up specific conditions.
-doctest_global_setup = """
+LIBID_EXCEL = "{00020813-0000-0000-C000-000000000046}"
+MYTYPELIB_PATH = os.path.join(os.path.dirname(__file__), "mytypelib.tlb")
+
+doctest_global_setup = f"""
 global NO_EXCEL
 
+import os
+
 import comtypes.client
 
 
 try:
-    comtypes.client.GetModule(('{00020813-0000-0000-C000-000000000046}',))
-
+    comtypes.client.GetModule(('{LIBID_EXCEL}',))
     NO_EXCEL = False
 except (ImportError, FileNotFoundError):
     NO_EXCEL = True
+
+try:
+    comtypes.client.GetModule('{MYTYPELIB_PATH}')
+    NO_MYTYPELIB = False
+except (ImportError, FileNotFoundError):
+    NO_MYTYPELIB = True
+
 """
 
 # A string containing Python code that will be run after each test.  Useful

docs/source/server.rst

@@ -77,26 +77,26 @@ Most required class attributes are already defined in the typelib
 wrapper file.  You must at least add attributes for registration that
 are not in the type library.
 
-.. sourcecode:: python
-
-  import comtypes
-  import comtypes.server.localserver
-
-  from comtypes.client import GetModule
-  # generate wrapper code for the type library, this needs
-  # to be done only once (but also each time the IDL file changes)
-  GetModule("mytypelib.tlb")
+.. doctest::
+    :skipif: NO_MYTYPELIB
+
+    >>> import comtypes
+    >>> import comtypes.server.localserver
+    >>> from comtypes.client import GetModule
+    >>> # generate wrapper code for the type library, this needs
+    >>> # to be done only once (but also each time the IDL file changes)
+    >>> GetModule("mytypelib.tlb")
+    >>> from comtypes.gen.MyTypeLib import MyObject
+    >>> class MyObjectImpl(MyObject):
+    ...     # registry entries
+    ...     _reg_threading_ = "Both"
+    ...     _reg_progid_ = "MyTypeLib.MyObject.1"
+    ...     _reg_novers_progid_ = "MyTypeLib.MyObject"
+    ...     _reg_desc_ = "Simple COM server for testing"
+    ...     _reg_clsctx_ = comtypes.CLSCTX_INPROC_SERVER | comtypes.CLSCTX_LOCAL_SERVER
+    ...     _regcls_ = comtypes.server.localserver.REGCLS_MULTIPLEUSE
+    ...
 
-  from comtypes.gen.MyTypeLib import MyObject
-
-  class MyObjectImpl(MyObject):
-      # registry entries
-      _reg_threading_ = "Both"
-      _reg_progid_ = "MyTypeLib.MyObject.1"
-      _reg_novers_progid_ = "MyTypeLib.MyObject"
-      _reg_desc_ = "Simple COM server for testing"
-      _reg_clsctx_ = comtypes.CLSCTX_INPROC_SERVER | comtypes.CLSCTX_LOCAL_SERVER
-      _regcls_ = comtypes.server.localserver.REGCLS_MULTIPLEUSE
 
 The meaning of the attributes: