markdown-to-confluence 0.4.7__py3-none-any.whl → 0.5.0__py3-none-any.whl

md2conf/converter.py

@@ -16,12 +16,11 @@ import uuid
 from abc import ABC, abstractmethod
 from dataclasses import dataclass
 from pathlib import Path
-from typing import ClassVar, Literal, Optional, Union
+from typing import ClassVar, Literal
 from urllib.parse import ParseResult, quote_plus, urlparse
 
 import lxml.etree as ET
-from strong_typing.core import JsonType
-from strong_typing.exception import JsonTypeError
+from cattrs import BaseValidationError
 
 from . import drawio, mermaid
 from .collection import ConfluencePageCollection
@@ -35,6 +34,7 @@ from .markdown import markdown_to_html
 from .mermaid import MermaidConfigProperties
 from .metadata import ConfluenceSiteMetadata
 from .scanner import MermaidScanner, ScannedDocument, Scanner
+from .serializer import JsonType
 from .toc import TableOfContentsBuilder
 from .uri import is_absolute_url, to_uuid_urn
 from .xml import element_to_text
@@ -202,7 +202,7 @@ class NodeVisitor(ABC):
                 self.visit(source)
 
     @abstractmethod
-    def transform(self, child: ElementType) -> Optional[ElementType]: ...
+    def transform(self, child: ElementType) -> ElementType | None: ...
 
 
 def title_to_identifier(title: str) -> str:
@@ -273,11 +273,11 @@ class ImageAttributes:
     """
 
     context: FormattingContext
-    width: Optional[int]
-    height: Optional[int]
-    alt: Optional[str]
-    title: Optional[str]
-    caption: Optional[str]
+    width: int | None
+    height: int | None
+    alt: str | None
+    title: str | None
+    caption: str | None
     alignment: ImageAlignment = ImageAlignment.CENTER
 
     def __post_init__(self) -> None:
@@ -374,13 +374,13 @@ class ConfluenceConverterOptions:
 @dataclass
 class ImageData:
     path: Path
-    description: Optional[str] = None
+    description: str | None = None
 
 
 @dataclass
 class EmbeddedFileData:
     data: bytes
-    description: Optional[str] = None
+    description: str | None = None
 
 
 @dataclass
@@ -405,18 +405,18 @@ class ConfluencePanel:
 
 
 ConfluencePanel.from_class = {
-    "attention": ConfluencePanel("❗", "exclamation", "#F9F9F9"),  # rST admonition
-    "caution": ConfluencePanel("❌", "x", "#FFEBE9"),
-    "danger": ConfluencePanel("☠️", "skull_crossbones", "#FFE5E5"),  # rST admonition
-    "disclaimer": ConfluencePanel("❗", "exclamation", "#F9F9F9"),  # GitLab
-    "error": ConfluencePanel("❌", "x", "#FFEBE9"),  # rST admonition
-    "flag": ConfluencePanel("🚩", "triangular_flag_on_post", "#FDECEA"),  # GitLab
-    "hint": ConfluencePanel("💡", "bulb", "#DAFBE1"),  # rST admonition
-    "info": ConfluencePanel("ℹ️", "information_source", "#DDF4FF"),
-    "note": ConfluencePanel("📝", "pencil", "#DDF4FF"),
-    "tip": ConfluencePanel("💡", "bulb", "#DAFBE1"),
-    "important": ConfluencePanel("❗", "exclamation", "#FBEFFF"),
-    "warning": ConfluencePanel("⚠️", "warning", "#FFF8C5"),
+    "attention": ConfluencePanel("❗", "exclamation", "var(--ds-background-accent-gray-subtlest)"),  # rST admonition
+    "caution": ConfluencePanel("❌", "x", "var(--ds-background-accent-orange-subtlest)"),
+    "danger": ConfluencePanel("☠️", "skull_crossbones", "var(--ds-background-accent-red-subtlest)"),  # rST admonition
+    "disclaimer": ConfluencePanel("❗", "exclamation", "var(--ds-background-accent-gray-subtlest)"),  # GitLab
+    "error": ConfluencePanel("❌", "x", "var(--ds-background-accent-red-subtlest)"),  # rST admonition
+    "flag": ConfluencePanel("🚩", "triangular_flag_on_post", "var(--ds-background-accent-orange-subtlest"),  # GitLab
+    "hint": ConfluencePanel("💡", "bulb", "var(--ds-background-accent-green-subtlest)"),  # rST admonition
+    "info": ConfluencePanel("ℹ️", "information_source", "var(--ds-background-accent-blue-subtlest)"),
+    "note": ConfluencePanel("📝", "pencil", "var(--ds-background-accent-teal-subtlest)"),
+    "tip": ConfluencePanel("💡", "bulb", "var(--ds-background-accent-green-subtlest)"),
+    "important": ConfluencePanel("❗", "exclamation", "var(--ds-background-accent-purple-subtlest)"),
+    "warning": ConfluencePanel("⚠️", "warning", "var(--ds-background-accent-yellow-subtlest)"),
 }
 
 
@@ -506,7 +506,7 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
         else:
             raise DocumentError(msg)
 
-    def _transform_link(self, anchor: ElementType) -> Optional[ElementType]:
+    def _transform_link(self, anchor: ElementType) -> ElementType | None:
         """
         Transforms links (HTML anchor `<a>`).
 
@@ -559,7 +559,7 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
         else:
             return self._transform_attachment_link(anchor, absolute_path)
 
-    def _transform_page_link(self, anchor: ElementType, relative_url: ParseResult, absolute_path: Path) -> Optional[ElementType]:
+    def _transform_page_link(self, anchor: ElementType, relative_url: ParseResult, absolute_path: Path) -> ElementType | None:
         """
         Transforms links to other Markdown documents (Confluence pages).
         """
@@ -596,7 +596,7 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
         anchor.set("href", transformed_url.geturl())
         return None
 
-    def _transform_attachment_link(self, anchor: ElementType, absolute_path: Path) -> Optional[ElementType]:
+    def _transform_attachment_link(self, anchor: ElementType, absolute_path: Path) -> ElementType | None:
         """
         Transforms links to document binaries such as PDF, DOCX or XLSX.
         """
@@ -713,7 +713,7 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
         else:
             raise DocumentError(msg)
 
-    def _verify_image_path(self, path: Path) -> Optional[Path]:
+    def _verify_image_path(self, path: Path) -> Path | None:
         "Checks whether an image path is safe to use."
 
         # resolve relative path into absolute path w.r.t. base dir
@@ -817,6 +817,14 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
                     str(attrs.height),
                 ),
             )
+        if attrs.alignment is ImageAlignment.CENTER:
+            parameters.append(
+                AC_ELEM(
+                    "parameter",
+                    {AC_ATTR("name"): "pCenter"},
+                    str(1),
+                ),
+            )
 
         local_id = str(uuid.uuid4())
         macro_id = str(uuid.uuid4())
@@ -897,12 +905,12 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
             AC_ELEM("plain-text-body", ET.CDATA(content)),
         )
 
-    def _extract_mermaid_config(self, content: str) -> Optional[MermaidConfigProperties]:
+    def _extract_mermaid_config(self, content: str) -> MermaidConfigProperties | None:
         """Extract scale from Mermaid YAML front matter configuration."""
         try:
             properties = MermaidScanner().read(content)
             return properties.config
-        except JsonTypeError as ex:
+        except BaseValidationError as ex:
             LOGGER.warning("Failed to extract Mermaid properties: %s", ex)
             return None
 
@@ -1550,7 +1558,7 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
         return AC_ELEM("task-list", {}, *tasks)
 
     @override
-    def transform(self, child: ElementType) -> Optional[ElementType]:
+    def transform(self, child: ElementType) -> ElementType | None:
         """
         Transforms an HTML element tree obtained from a Markdown document into a Confluence Storage Format element tree.
         """
@@ -1650,7 +1658,7 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
         #   <li>[x] ...</li>
         # </ul>
         elif child.tag == "ul":
-            if len(child) > 0 and element_text_starts_with_any(child[0], ["[ ]", "[x]", "[X]"]):
+            if len(child) > 0 and all(element_text_starts_with_any(item, ["[ ]", "[x]", "[X]"]) for item in child):
                 return self._transform_tasklist(child)
 
             return None
@@ -1734,9 +1742,9 @@ class ConversionError(RuntimeError):
 class ConfluenceDocument:
     "Encapsulates an element tree for a Confluence document created by parsing a Markdown document."
 
-    title: Optional[str]
-    labels: Optional[list[str]]
-    properties: Optional[dict[str, JsonType]]
+    title: str | None
+    labels: list[str] | None
+    properties: dict[str, JsonType] | None
 
     links: list[str]
     images: list[ImageData]
@@ -1844,7 +1852,7 @@ class ConfluenceDocument:
         return elements_to_string(self.root)
 
 
-def attachment_name(ref: Union[Path, str]) -> str:
+def attachment_name(ref: Path | str) -> str:
     """
     Safe name for use with attachment uploads.
 

md2conf/domain.py

@@ -7,7 +7,7 @@ Copyright 2022-2025, Levente Hunyadi
 """
 
 from dataclasses import dataclass
-from typing import Literal, Optional
+from typing import Literal
 
 
 @dataclass
@@ -39,8 +39,8 @@ class ConfluenceDocumentOptions:
 
     ignore_invalid_url: bool = False
     heading_anchors: bool = False
-    generated_by: Optional[str] = "This page has been generated with a tool."
-    root_page_id: Optional[ConfluencePageID] = None
+    generated_by: str | None = "This page has been generated with a tool."
+    root_page_id: ConfluencePageID | None = None
     keep_hierarchy: bool = False
     prefer_raster: bool = True
     render_drawio: bool = False

md2conf/drawio.py

@@ -51,7 +51,7 @@ def inflate(data: bytes) -> bytes:
     return zlib.decompress(data, -zlib.MAX_WBITS)
 
 
-def decompress_diagram(xml_data: typing.Union[bytes, str]) -> ElementType:
+def decompress_diagram(xml_data: bytes | str) -> ElementType:
     """
     Decompresses the text content of the `<diagram>` element in a draw.io XML document.
 

md2conf/environment.py

@@ -7,7 +7,7 @@ Copyright 2022-2025, Levente Hunyadi
 """
 
 import os
-from typing import Optional, overload
+from typing import overload
 
 
 class ArgumentError(ValueError):
@@ -27,10 +27,10 @@ def _validate_domain(domain: str) -> str: ...
 
 
 @overload
-def _validate_domain(domain: Optional[str]) -> Optional[str]: ...
+def _validate_domain(domain: str | None) -> str | None: ...
 
 
-def _validate_domain(domain: Optional[str]) -> Optional[str]:
+def _validate_domain(domain: str | None) -> str | None:
     if domain is None:
         return None
 
@@ -45,10 +45,10 @@ def _validate_base_path(base_path: str) -> str: ...
 
 
 @overload
-def _validate_base_path(base_path: Optional[str]) -> Optional[str]: ...
+def _validate_base_path(base_path: str | None) -> str | None: ...
 
 
-def _validate_base_path(base_path: Optional[str]) -> Optional[str]:
+def _validate_base_path(base_path: str | None) -> str | None:
     if base_path is None:
         return None
 
@@ -61,13 +61,13 @@ def _validate_base_path(base_path: Optional[str]) -> Optional[str]:
 class ConfluenceSiteProperties:
     domain: str
     base_path: str
-    space_key: Optional[str]
+    space_key: str | None
 
     def __init__(
         self,
-        domain: Optional[str] = None,
-        base_path: Optional[str] = None,
-        space_key: Optional[str] = None,
+        domain: str | None = None,
+        base_path: str | None = None,
+        space_key: str | None = None,
     ) -> None:
         opt_domain = domain or os.getenv("CONFLUENCE_DOMAIN")
         opt_base_path = base_path or os.getenv("CONFLUENCE_PATH")
@@ -93,24 +93,24 @@ class ConfluenceConnectionProperties:
     :param headers: Additional HTTP headers to pass to Confluence REST API calls.
     """
 
-    domain: Optional[str]
-    base_path: Optional[str]
-    space_key: Optional[str]
-    api_url: Optional[str]
-    user_name: Optional[str]
+    domain: str | None
+    base_path: str | None
+    space_key: str | None
+    api_url: str | None
+    user_name: str | None
     api_key: str
-    headers: Optional[dict[str, str]]
+    headers: dict[str, str] | None
 
     def __init__(
         self,
         *,
-        api_url: Optional[str] = None,
-        domain: Optional[str] = None,
-        base_path: Optional[str] = None,
-        user_name: Optional[str] = None,
-        api_key: Optional[str] = None,
-        space_key: Optional[str] = None,
-        headers: Optional[dict[str, str]] = None,
+        api_url: str | None = None,
+        domain: str | None = None,
+        base_path: str | None = None,
+        user_name: str | None = None,
+        api_key: str | None = None,
+        space_key: str | None = None,
+        headers: dict[str, str] | None = None,
     ) -> None:
         opt_api_url = api_url or os.getenv("CONFLUENCE_API_URL")
         opt_domain = domain or os.getenv("CONFLUENCE_DOMAIN")

md2conf/latex.py

@@ -10,7 +10,7 @@ import importlib.util
 from io import BytesIO
 from pathlib import Path
 from struct import unpack
-from typing import BinaryIO, Iterable, Literal, Optional, Union, overload
+from typing import BinaryIO, Iterable, Literal, overload
 
 
 def render_latex(expression: str, *, format: Literal["png", "svg"] = "png", dpi: int = 100, font_size: int = 12) -> bytes:
@@ -71,10 +71,10 @@ def get_png_dimensions(*, data: bytes) -> tuple[int, int]: ...
 
 
 @overload
-def get_png_dimensions(*, path: Union[str, Path]) -> tuple[int, int]: ...
+def get_png_dimensions(*, path: str | Path) -> tuple[int, int]: ...
 
 
-def get_png_dimensions(*, data: Optional[bytes] = None, path: Union[str, Path, None] = None) -> tuple[int, int]:
+def get_png_dimensions(*, data: bytes | None = None, path: str | Path | None = None) -> tuple[int, int]:
     """
     Returns the width and height of a PNG image inspecting its header.
 
@@ -100,20 +100,20 @@ def remove_png_chunks(names: Iterable[str], *, source_data: bytes) -> bytes: ...
 
 
 @overload
-def remove_png_chunks(names: Iterable[str], *, source_path: Union[str, Path]) -> bytes: ...
+def remove_png_chunks(names: Iterable[str], *, source_path: str | Path) -> bytes: ...
 
 
 @overload
-def remove_png_chunks(names: Iterable[str], *, source_data: bytes, target_path: Union[str, Path]) -> None: ...
+def remove_png_chunks(names: Iterable[str], *, source_data: bytes, target_path: str | Path) -> None: ...
 
 
 @overload
-def remove_png_chunks(names: Iterable[str], *, source_path: Union[str, Path], target_path: Union[str, Path]) -> None: ...
+def remove_png_chunks(names: Iterable[str], *, source_path: str | Path, target_path: str | Path) -> None: ...
 
 
 def remove_png_chunks(
-    names: Iterable[str], *, source_data: Optional[bytes] = None, source_path: Union[str, Path, None] = None, target_path: Union[str, Path, None] = None
-) -> Optional[bytes]:
+    names: Iterable[str], *, source_data: bytes | None = None, source_path: str | Path | None = None, target_path: str | Path | None = None
+) -> bytes | None:
     """
     Rewrites a PNG file by removing chunks with the specified names.
 
@@ -168,7 +168,7 @@ def _read_signature(f: BinaryIO) -> None:
         raise ValueError("not a valid PNG file")
 
 
-def _read_chunk(f: BinaryIO) -> Optional[_Chunk]:
+def _read_chunk(f: BinaryIO) -> _Chunk | None:
     "Reads and parses a PNG chunk such as `IHDR` or `tEXt`."
 
     length_bytes = f.read(4)

md2conf/local.py

@@ -9,7 +9,6 @@ Copyright 2022-2025, Levente Hunyadi
 import logging
 import os
 from pathlib import Path
-from typing import Optional
 
 from .converter import ConfluenceDocument
 from .domain import ConfluenceDocumentOptions, ConfluencePageID
@@ -30,7 +29,7 @@ class LocalProcessor(Processor):
         options: ConfluenceDocumentOptions,
         site: ConfluenceSiteMetadata,
         *,
-        out_dir: Optional[Path],
+        out_dir: Path | None,
         root_dir: Path,
     ) -> None:
         """
@@ -46,7 +45,7 @@ class LocalProcessor(Processor):
         self.out_dir = out_dir or root_dir
 
     @override
-    def _synchronize_tree(self, root: DocumentNode, root_id: Optional[ConfluencePageID]) -> None:
+    def _synchronize_tree(self, root: DocumentNode, root_id: ConfluencePageID | None) -> None:
         """
         Creates the cross-reference index.
 
@@ -89,13 +88,13 @@ class LocalProcessor(Processor):
 
 
 class LocalProcessorFactory(ProcessorFactory):
-    out_dir: Optional[Path]
+    out_dir: Path | None
 
     def __init__(
         self,
         options: ConfluenceDocumentOptions,
         site: ConfluenceSiteMetadata,
-        out_dir: Optional[Path] = None,
+        out_dir: Path | None = None,
     ) -> None:
         super().__init__(options, site)
         self.out_dir = out_dir
@@ -113,6 +112,6 @@ class LocalConverter(Converter):
         self,
         options: ConfluenceDocumentOptions,
         site: ConfluenceSiteMetadata,
-        out_dir: Optional[Path] = None,
+        out_dir: Path | None = None,
     ) -> None:
         super().__init__(LocalProcessorFactory(options, site, out_dir))

md2conf/markdown.py

@@ -7,7 +7,7 @@ Copyright 2022-2025, Levente Hunyadi
 """
 
 import xml.etree.ElementTree
-from typing import Any, Optional
+from typing import Any
 
 import markdown
 
@@ -15,11 +15,11 @@ import markdown
 def _emoji_generator(
     index: str,
     shortname: str,
-    alias: Optional[str],
-    uc: Optional[str],
+    alias: str | None,
+    uc: str | None,
     alt: str,
-    title: Optional[str],
-    category: Optional[str],
+    title: str | None,
+    category: str | None,
     options: dict[str, Any],
     md: markdown.Markdown,
 ) -> xml.etree.ElementTree.Element:
@@ -46,9 +46,9 @@ def _verbatim_formatter(
     css_class: str,
     options: dict[str, Any],
     md: markdown.Markdown,
-    classes: Optional[list[str]] = None,
+    classes: list[str] | None = None,
     id_value: str = "",
-    attrs: Optional[dict[str, str]] = None,
+    attrs: dict[str, str] | None = None,
     **kwargs: Any,
 ) -> str:
     """

md2conf/matcher.py

@@ -10,7 +10,7 @@ import os.path
 from dataclasses import dataclass
 from fnmatch import fnmatch
 from pathlib import Path
-from typing import Iterable, Optional, Union, final, overload
+from typing import Iterable, final, overload
 
 
 @dataclass(frozen=True, eq=True)
@@ -95,14 +95,14 @@ class MatcherOptions:
     """
 
     source: str
-    extension: Optional[str] = None
+    extension: str | None = None
 
     def __post_init__(self) -> None:
         if self.extension is not None and not self.extension.startswith("."):
             self.extension = f".{self.extension}"
 
 
-def _entry_name_dir(entry: Union[Entry, os.DirEntry[str]]) -> tuple[str, bool]:
+def _entry_name_dir(entry: Entry | os.DirEntry[str]) -> tuple[str, bool]:
     if isinstance(entry, Entry):
         return entry.name, entry.is_dir
     else:
@@ -155,7 +155,7 @@ class Matcher:
 
         ...
 
-    def is_excluded(self, entry: Union[Entry, os.DirEntry[str]]) -> bool:
+    def is_excluded(self, entry: Entry | os.DirEntry[str]) -> bool:
         name, is_dir = _entry_name_dir(entry)
 
         # skip hidden files and directories
@@ -192,7 +192,7 @@ class Matcher:
         """
         ...
 
-    def is_included(self, entry: Union[Entry, os.DirEntry[str]]) -> bool:
+    def is_included(self, entry: Entry | os.DirEntry[str]) -> bool:
         return not self.is_excluded(entry)
 
     def filter(self, entries: Iterable[Entry]) -> list[Entry]:

md2conf/mermaid.py

@@ -12,7 +12,7 @@ import os.path
 import shutil
 import subprocess
 from dataclasses import dataclass
-from typing import Literal, Optional
+from typing import Literal
 
 LOGGER = logging.getLogger(__name__)
 
@@ -25,7 +25,7 @@ class MermaidConfigProperties:
     :param scale: Scaling factor for the rendered diagram.
     """
 
-    scale: Optional[float] = None
+    scale: float | None = None
 
 
 def is_docker() -> bool:
@@ -56,7 +56,7 @@ def has_mmdc() -> bool:
     return shutil.which(executable) is not None
 
 
-def render_diagram(source: str, output_format: Literal["png", "svg"] = "png", config: Optional[MermaidConfigProperties] = None) -> bytes:
+def render_diagram(source: str, output_format: Literal["png", "svg"] = "png", config: MermaidConfigProperties | None = None) -> bytes:
     "Generates a PNG or SVG image from a Mermaid diagram source."
 
     if config is None:

md2conf/metadata.py

@@ -7,7 +7,6 @@ Copyright 2022-2025, Levente Hunyadi
 """
 
 from dataclasses import dataclass
-from typing import Optional
 
 
 @dataclass
@@ -22,7 +21,7 @@ class ConfluenceSiteMetadata:
 
     domain: str
     base_path: str
-    space_key: Optional[str]
+    space_key: str | None
 
 
 @dataclass

md2conf/processor.py

@@ -11,7 +11,7 @@ import logging
 import os
 from abc import abstractmethod
 from pathlib import Path
-from typing import Iterable, Optional
+from typing import Iterable
 
 from .collection import ConfluencePageCollection
 from .converter import ConfluenceDocument
@@ -26,9 +26,9 @@ LOGGER = logging.getLogger(__name__)
 
 class DocumentNode:
     absolute_path: Path
-    page_id: Optional[str]
-    space_key: Optional[str]
-    title: Optional[str]
+    page_id: str | None
+    space_key: str | None
+    title: str | None
     synchronized: bool
 
     _children: list["DocumentNode"]
@@ -36,9 +36,9 @@ class DocumentNode:
     def __init__(
         self,
         absolute_path: Path,
-        page_id: Optional[str],
-        space_key: Optional[str],
-        title: Optional[str],
+        page_id: str | None,
+        space_key: str | None,
+        title: str | None,
         synchronized: bool,
     ):
         self.absolute_path = absolute_path
@@ -140,7 +140,7 @@ class Processor:
         self._update_page(page_id, document, path)
 
     @abstractmethod
-    def _synchronize_tree(self, root: DocumentNode, root_id: Optional[ConfluencePageID]) -> None:
+    def _synchronize_tree(self, root: DocumentNode, root_id: ConfluencePageID | None) -> None:
         """
         Creates the cross-reference index and synchronizes the directory tree structure with the Confluence page hierarchy.
 
@@ -157,7 +157,7 @@ class Processor:
         """
         ...
 
-    def _index_directory(self, local_dir: Path, parent: Optional[DocumentNode]) -> DocumentNode:
+    def _index_directory(self, local_dir: Path, parent: DocumentNode | None) -> DocumentNode:
         """
         Indexes Markdown files in a directory hierarchy recursively.
         """
@@ -181,7 +181,7 @@ class Processor:
         directories.sort()
 
         # make page act as parent node
-        parent_doc: Optional[Path] = None
+        parent_doc: Path | None = None
         if FileEntry("index.md") in files:
             parent_doc = local_dir / "index.md"
         elif FileEntry("README.md") in files:
@@ -277,7 +277,7 @@ class Converter:
         else:
             raise ArgumentError(f"expected: valid file or directory path; got: {path}")
 
-    def process_directory(self, local_dir: Path, root_dir: Optional[Path] = None) -> None:
+    def process_directory(self, local_dir: Path, root_dir: Path | None = None) -> None:
         """
         Recursively scans a directory hierarchy for Markdown files, and processes each, resolving cross-references.
         """
@@ -290,7 +290,7 @@ class Converter:
 
         self.factory.create(root_dir).process_directory(local_dir)
 
-    def process_page(self, path: Path, root_dir: Optional[Path] = None) -> None:
+    def process_page(self, path: Path, root_dir: Path | None = None) -> None:
         """
         Processes a single Markdown file.
         """

md2conf/publisher.py

@@ -8,7 +8,6 @@ Copyright 2022-2025, Levente Hunyadi
 
 import logging
 from pathlib import Path
-from typing import Optional
 
 from .api import ConfluenceContentProperty, ConfluenceLabel, ConfluenceSession, ConfluenceStatus
 from .converter import ConfluenceDocument, attachment_name, get_volatile_attributes, get_volatile_elements
@@ -43,7 +42,7 @@ class SynchronizingProcessor(Processor):
         self.api = api
 
     @override
-    def _synchronize_tree(self, root: DocumentNode, root_id: Optional[ConfluencePageID]) -> None:
+    def _synchronize_tree(self, root: DocumentNode, root_id: ConfluencePageID | None) -> None:
         """
         Creates the cross-reference index and synchronizes the directory tree structure with the Confluence page hierarchy.