markdown-to-confluence 0.5.2__py3-none-any.whl → 0.5.4__py3-none-any.whl

markdown_to_confluence-0.5.4.dist-info/RECORD

@@ -0,0 +1,55 @@
+markdown_to_confluence-0.5.4.dist-info/licenses/LICENSE,sha256=SEEBf2BMI1LUHnDvyHnV6L12A6zTAOQcsyMvaawAXWo,1077
+md2conf/__init__.py,sha256=0xq0z3v7oQaJxJwZRPOd-Z4zgOOCnzgDJYa9nytHTD0,402
+md2conf/__main__.py,sha256=BPUZd0uzCsAOH3Y5o7ydvV7Z77jSI8fHfo4AZPyYj2c,14639
+md2conf/api.py,sha256=3TlUmiDU31dfL8raMwv2wQWV_IvVq6fu8j86cjKTz1A,42780
+md2conf/attachment.py,sha256=Nc3qGDENWBnsI6OVwMLXnk0EyEITpvov9MluDFD90ZI,1689
+md2conf/coalesce.py,sha256=YHnqFwow5wCj6OQ3oosig01D2lxWusAScMF4HAUO2-g,1305
+md2conf/collection.py,sha256=ukN74VCa4HaGSh6tLXpLd0j_UNPywcnKI0X7usgdSCo,824
+md2conf/compatibility.py,sha256=4ZNN6VLqxSbI1kowdsPproGZqwxBISys4Z22vBfe6Z8,687
+md2conf/converter.py,sha256=7eP4sEPgmyjiD0PO3jjyS5TcDY3OSW9hYsriLd9rbek,63201
+md2conf/csf.py,sha256=6H9G-5cZyyWMJr0tFskPNiWdQ2Ehq-V8EhlvvxhukWY,6582
+md2conf/emoticon.py,sha256=0g4rkx3d58xU4nnLak5ms7i0FSDnq0WJrLVFRgGyLC8,542
+md2conf/entities.dtd,sha256=M6NzqL5N7dPs_eUA_6sDsiSLzDaAacrx9LdttiufvYU,30215
+md2conf/environment.py,sha256=TfNEz3Pyw9qe7f8i7e_kph16c09fhZ4cLNZZzIjmI18,3892
+md2conf/extension.py,sha256=_IBf_yhYb6luQM3A-vAAtCpjHay33kE4Au_SGuC3kow,2274
+md2conf/external.py,sha256=uY1G7bdqEMJW66vOvKsh5CS4oHY-YA7h2VVuaSdaqBo,2366
+md2conf/formatting.py,sha256=ygL59VgpioX069axEX-7XjKs0sUjTfIZiBE5fWmITxc,4557
+md2conf/frontmatter.py,sha256=iWtn_oXoLQxvCsdI3OXs1ylWGmB-gc7mMLpSGg113i4,1888
+md2conf/image.py,sha256=YrtcE5KhzcbjiT-oQEkk--yKSiRSPlDUtMpekoepIdo,5289
+md2conf/latex.py,sha256=haZKkUxSEcPj3fVmiIVZAwgszqNqGLk1GQ7i8KGHpo0,2226
+md2conf/local.py,sha256=eY3WpY-lNzLZeAfxX1ACVEhuzz0HDYX_sNQogJfkqcM,3673
+md2conf/markdown.py,sha256=4Km-AbQH04nDgPF0ijo-Ld7o8jTPXzENIMn7P1qIk0o,3148
+md2conf/matcher.py,sha256=Xg4YSb87iPkCzhKuKytBut6NOkEab3IM-AjzXbwy64U,6774
+md2conf/metadata.py,sha256=NOjbCIrwLgTIIeNgmo7w5JXuT-pxOXBGSg-irfdpokk,976
+md2conf/options.py,sha256=DLxnQBhDmDJgfEDSYyMChJi_krS1nsquOHBKg82aGrY,4500
+md2conf/png.py,sha256=GU3-0dG6HqwGjedJVUciaIdA-6CdPTy_clsOQGr6dGE,6251
+md2conf/processor.py,sha256=xVLpvKg2FEO0tWsHQ8sm7YpimQepbZ07W0_yUzcvl6c,11116
+md2conf/publisher.py,sha256=xRIig53b4-DLncL07XBgLN3ecmTsWwNEK3ckjyhqfU8,11574
+md2conf/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+md2conf/scanner.py,sha256=bupKNe47DRc8MyMLzYfgtzyVHV9osJSgnr7KCnKsMuM,3888
+md2conf/serializer.py,sha256=W4_yLJfT3vLw0PUg88lpUEnvn64CjaX3ZaKgIrwcxfw,1786
+md2conf/svg.py,sha256=fjr8sWe-tqdAKaIq2bsR9qPrhnCXUmoVRtezHZa86cg,11558
+md2conf/text.py,sha256=cnYV_JQp_v91LbQHo3qvxcEuhIdaPjCjkmLOKINcNv4,1736
+md2conf/toc.py,sha256=aJEH3fIzDr2RufxFbHJ8maEpezp8uXI_uw90k3-KNkA,4585
+md2conf/uri.py,sha256=my0deyR5SlppJrYCbXF1Zz94QA1JT-HTWe9pKw7AJ_A,1158
+md2conf/xml.py,sha256=uaaUDs0hfluNX74dfkY_Dxu1KmeNDGogpGRGpUVEfE4,5526
+md2conf/drawio/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+md2conf/drawio/extension.py,sha256=HHLUriTfg82VCfOEyzU-6j2IM9rxR3I1UdSDdujWHgU,4409
+md2conf/drawio/render.py,sha256=veSu5gjm5ggLnmaH7uvH9qNeOygBJpqhSKK_LJs0QTk,8581
+md2conf/mermaid/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+md2conf/mermaid/config.py,sha256=5Dec2QcdB_GtnuXIW6nhJK8J5caduNZU1oz1mcmmb44,376
+md2conf/mermaid/extension.py,sha256=1drXVM_KbS00dcjSCRru0wwbil4zq3aR81dHMhfe7zA,4021
+md2conf/mermaid/puppeteer-config.json,sha256=-dMTAN_7kNTGbDlfXzApl0KJpAWna9YKZdwMKbpOb60,159
+md2conf/mermaid/render.py,sha256=zO6M5UWSKiezoxPojD8iwFnwrFEDw_P6liQi-C3LQgw,1817
+md2conf/mermaid/scanner.py,sha256=oIpaNxiZBNcmggnjlyYGcIVOXcYQWjf1lEVdyIwE4xE,1379
+md2conf/plantuml/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+md2conf/plantuml/config.py,sha256=j0ONhkzmAPagh00ltamTKlVEvXa6R284We9pDxRy-5U,378
+md2conf/plantuml/extension.py,sha256=EQ-2O4d2cWBGcIHcFFXgaCNrfi357hS6IE_PsvwJ8_k,6256
+md2conf/plantuml/render.py,sha256=Lf1It2KxHPKNGM1rhIDg9zdC3iqhRNCduByqa0_k_qw,3725
+md2conf/plantuml/scanner.py,sha256=Oso6VbHVuMaPMKMazQc_bf4hhOT5WeJN5WiVPM8peyM,1347
+markdown_to_confluence-0.5.4.dist-info/METADATA,sha256=bz_rRHiqV-EYCMcXCE9NMlUc8bk28SbFz9KO43YuW0E,45324
+markdown_to_confluence-0.5.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+markdown_to_confluence-0.5.4.dist-info/entry_points.txt,sha256=F1zxa1wtEObtbHS-qp46330WVFLHdMnV2wQ-ZorRmX0,50
+markdown_to_confluence-0.5.4.dist-info/top_level.txt,sha256=_FJfl_kHrHNidyjUOuS01ngu_jDsfc-ZjSocNRJnTzU,8
+markdown_to_confluence-0.5.4.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+markdown_to_confluence-0.5.4.dist-info/RECORD,,

{markdown_to_confluence-0.5.2.dist-info → markdown_to_confluence-0.5.4.dist-info}/licenses/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2022-2025 Levente Hunyadi
+Copyright (c) 2022-2026 Levente Hunyadi
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

md2conf/__init__.py

@@ -5,9 +5,9 @@ Parses Markdown files, converts Markdown content into the Confluence Storage For
 Confluence API endpoints to upload images and content.
 """
 
-__version__ = "0.5.2"
+__version__ = "0.5.4"
 __author__ = "Levente Hunyadi"
-__copyright__ = "Copyright 2022-2025, Levente Hunyadi"
+__copyright__ = "Copyright 2022-2026, Levente Hunyadi"
 __license__ = "MIT"
 __maintainer__ = "Levente Hunyadi"
 __status__ = "Production"

md2conf/__main__.py

@@ -4,7 +4,7 @@ Publish Markdown files to Confluence wiki.
 Parses Markdown files, converts Markdown content into the Confluence Storage Format (XHTML), and invokes
 Confluence API endpoints to upload images and content.
 
-Copyright 2022-2025, Levente Hunyadi
+Copyright 2022-2026, Levente Hunyadi
 
 :see: https://github.com/hunyadi/md2conf
 """
@@ -16,17 +16,22 @@ import sys
 import typing
 from io import StringIO
 from pathlib import Path
+from types import TracebackType
 from typing import Any, Iterable, Literal, Sequence
 
+from requests.exceptions import HTTPError, JSONDecodeError
+
 from . import __version__
-from .domain import ConfluenceDocumentOptions, ConfluencePageID
-from .environment import ArgumentError, ConfluenceConnectionProperties, ConfluenceSiteProperties
-from .extra import override
+from .compatibility import override
+from .environment import ArgumentError, ConfluenceSiteProperties, ConnectionProperties
 from .metadata import ConfluenceSiteMetadata
+from .options import ConfluencePageID, ConverterOptions, DocumentOptions, ImageLayoutOptions, LayoutOptions
+
+LOGGER = logging.getLogger(__name__)
 
 
 class Arguments(argparse.Namespace):
-    mdpath: Path
+    mdpath: list[Path]
     domain: str | None
     path: str | None
     api_url: str | None
@@ -41,9 +46,11 @@ class Arguments(argparse.Namespace):
     skip_title_heading: bool
     title_prefix: str | None
     generated_by: str | None
+    skip_update: bool
     prefer_raster: bool
     render_drawio: bool
     render_mermaid: bool
+    render_plantuml: bool
     render_latex: bool
     diagram_output_format: Literal["png", "svg"]
     local: bool
@@ -99,7 +106,7 @@ def get_parser() -> argparse.ArgumentParser:
     parser = argparse.ArgumentParser(formatter_class=PositionalOnlyHelpFormatter)
     parser.prog = os.path.basename(os.path.dirname(__file__))
     parser.add_argument("--version", action="version", version=__version__)
-    parser.add_argument("mdpath", help="Path to Markdown file or directory to convert and publish.")
+    parser.add_argument("mdpath", type=Path, nargs="+", help="Path to Markdown file or directory to convert and publish.")
     parser.add_argument("-d", "--domain", help="Confluence organization domain.")
     parser.add_argument("-p", "--path", help="Base path for Confluence (default: '/wiki/').")
     parser.add_argument(
@@ -165,6 +172,12 @@ def get_parser() -> argparse.ArgumentParser:
         const=None,
         help="Do not add 'generated by a tool' prompt to pages.",
     )
+    parser.add_argument(
+        "--skip-update",
+        action="store_true",
+        default=False,
+        help="Skip saving Confluence page ID in Markdown files.",
+    )
     parser.add_argument(
         "--render-drawio",
         dest="render_drawio",
@@ -191,6 +204,19 @@ def get_parser() -> argparse.ArgumentParser:
         action="store_false",
         help="Upload Mermaid diagram sources as Confluence page attachments. (Marketplace app required to display.)",
     )
+    parser.add_argument(
+        "--render-plantuml",
+        dest="render_plantuml",
+        action="store_true",
+        default=True,
+        help="Render PlantUML diagrams as image files. (Installed utility required to convert.)",
+    )
+    parser.add_argument(
+        "--no-render-plantuml",
+        dest="render_plantuml",
+        action="store_false",
+        help="Upload PlantUML diagram sources as Confluence page attachments. (Marketplace app required to display.)",
+    )
     parser.add_argument(
         "--render-latex",
         dest="render_latex",
@@ -310,35 +336,61 @@ def get_help() -> str:
         return buf.getvalue()
 
 
+def _exception_hook(exc_type: type[BaseException], exc_value: BaseException, traceback: TracebackType | None) -> None:
+    LOGGER.exception("Exception raised: %s", exc_type.__name__, exc_info=exc_value)
+    ex: BaseException | None = exc_value
+    while ex is not None:
+        print(f"\033[95m{ex.__class__.__name__}\033[0m: {ex}")
+
+        if isinstance(ex, HTTPError):
+            # print details for a response with JSON body
+            if ex.response is not None:
+                try:
+                    LOGGER.error(ex.response.json())
+                except JSONDecodeError:
+                    pass
+
+        ex = ex.__cause__
+
+
+sys.excepthook = _exception_hook
+
+
 def main() -> None:
     parser = get_parser()
     args = Arguments()
     parser.parse_args(namespace=args)
 
-    args.mdpath = Path(args.mdpath)
-
     logging.basicConfig(
         level=getattr(logging, args.loglevel.upper(), logging.INFO),
         format="%(asctime)s - %(levelname)s - %(funcName)s [%(lineno)d] - %(message)s",
     )
 
-    options = ConfluenceDocumentOptions(
-        heading_anchors=args.heading_anchors,
-        ignore_invalid_url=args.ignore_invalid_url,
-        skip_title_heading=args.skip_title_heading,
-        title_prefix=args.title_prefix,
-        generated_by=args.generated_by,
+    options = DocumentOptions(
         root_page_id=ConfluencePageID(args.root_page) if args.root_page else None,
         keep_hierarchy=args.keep_hierarchy,
-        prefer_raster=args.prefer_raster,
-        render_drawio=args.render_drawio,
-        render_mermaid=args.render_mermaid,
-        render_latex=args.render_latex,
-        diagram_output_format=args.diagram_output_format,
-        webui_links=args.webui_links,
-        alignment=args.alignment,
-        max_image_width=args.max_image_width,
-        use_panel=args.use_panel,
+        title_prefix=args.title_prefix,
+        generated_by=args.generated_by,
+        skip_update=args.skip_update,
+        converter=ConverterOptions(
+            heading_anchors=args.heading_anchors,
+            ignore_invalid_url=args.ignore_invalid_url,
+            skip_title_heading=args.skip_title_heading,
+            prefer_raster=args.prefer_raster,
+            render_drawio=args.render_drawio,
+            render_mermaid=args.render_mermaid,
+            render_plantuml=args.render_plantuml,
+            render_latex=args.render_latex,
+            diagram_output_format=args.diagram_output_format,
+            webui_links=args.webui_links,
+            use_panel=args.use_panel,
+            layout=LayoutOptions(
+                image=ImageLayoutOptions(
+                    alignment=args.alignment,
+                    max_width=args.max_image_width,
+                ),
+            ),
+        ),
     )
     if args.local:
         from .local import LocalConverter
@@ -356,15 +408,15 @@ def main() -> None:
             base_path=site_properties.base_path,
             space_key=site_properties.space_key,
         )
-        LocalConverter(options, site_metadata).process(args.mdpath)
+        converter = LocalConverter(options, site_metadata)
+        for item in args.mdpath:
+            converter.process(item)
     else:
-        from requests import HTTPError, JSONDecodeError
-
         from .api import ConfluenceAPI
         from .publisher import Publisher
 
         try:
-            properties = ConfluenceConnectionProperties(
+            properties = ConnectionProperties(
                 api_url=args.api_url,
                 domain=args.domain,
                 base_path=args.path,
@@ -375,23 +427,10 @@ def main() -> None:
             )
         except ArgumentError as e:
             parser.error(str(e))
-        try:
-            with ConfluenceAPI(properties) as api:
-                Publisher(
-                    api,
-                    options,
-                ).process(args.mdpath)
-        except HTTPError as err:
-            logging.error(err)
-
-            # print details for a response with JSON body
-            if err.response is not None:
-                try:
-                    logging.error(err.response.json())
-                except JSONDecodeError:
-                    pass
-
-            sys.exit(1)
+        with ConfluenceAPI(properties) as api:
+            publisher = Publisher(api, options)
+            for item in args.mdpath:
+                publisher.process(item)
 
 
 if __name__ == "__main__":

md2conf/api.py

@@ -1,7 +1,7 @@
 """
 Publish Markdown files to Confluence wiki.
 
-Copyright 2022-2025, Levente Hunyadi
+Copyright 2022-2026, Levente Hunyadi
 
 :see: https://github.com/hunyadi/md2conf
 """
@@ -25,8 +25,8 @@ import requests
 import truststore
 from requests.adapters import HTTPAdapter
 
-from .environment import ArgumentError, ConfluenceConnectionProperties, ConfluenceError, PageError
-from .extra import override
+from .compatibility import override
+from .environment import ArgumentError, ConfluenceError, ConnectionProperties, PageError
 from .metadata import ConfluenceSiteMetadata
 from .serializer import JsonType, json_to_object, object_to_json_payload
 
@@ -35,6 +35,7 @@ T = TypeVar("T")
 # spellchecker: disable
 mimetypes.add_type("application/vnd.openxmlformats-officedocument.wordprocessingml.document", ".docx", strict=True)
 mimetypes.add_type("text/vnd.mermaid", ".mmd", strict=True)
+mimetypes.add_type("text/vnd.plantuml", ".puml", strict=True)
 mimetypes.add_type("application/vnd.oasis.opendocument.presentation", ".odp", strict=True)
 mimetypes.add_type("application/vnd.oasis.opendocument.spreadsheet", ".ods", strict=True)
 mimetypes.add_type("application/vnd.oasis.opendocument.text", ".odt", strict=True)
@@ -370,11 +371,11 @@ class ConfluenceAPI:
     Encapsulates operations that can be invoked via the [Confluence REST API](https://developer.atlassian.com/cloud/confluence/rest/v2/).
     """
 
-    properties: ConfluenceConnectionProperties
+    properties: ConnectionProperties
     session: "ConfluenceSession | None" = None
 
-    def __init__(self, properties: ConfluenceConnectionProperties | None = None) -> None:
-        self.properties = properties or ConfluenceConnectionProperties()
+    def __init__(self, properties: ConnectionProperties | None = None) -> None:
+        self.properties = properties or ConnectionProperties()
 
     def __enter__(self) -> "ConfluenceSession":
         """
@@ -626,7 +627,16 @@ class ConfluenceSession:
 
         return id
 
+    @overload
+    def get_space_id(self, *, space_id: str | None = None) -> str | None: ...
+
+    @overload
+    def get_space_id(self, *, space_key: str | None = None) -> str | None: ...
+
     def get_space_id(self, *, space_id: str | None = None, space_key: str | None = None) -> str | None:
+        return self._get_space_id(space_id=space_id, space_key=space_key)
+
+    def _get_space_id(self, *, space_id: str | None = None, space_key: str | None = None) -> str | None:
         """
         Coalesces a space ID or space key into a space ID, accounting for site default.
 
@@ -647,6 +657,15 @@ class ConfluenceSession:
         # space ID and key are unset, and no default space is configured
         return None
 
+    def get_homepage_id(self, space_id: str) -> str:
+        """
+        Returns the page ID corresponding to the space home page.
+        """
+
+        path = f"/spaces/{space_id}"
+        data = self._get(ConfluenceVersion.VERSION_2, path, dict[str, JsonType])
+        return typing.cast(str, data["homepageId"])
+
     def get_attachment_by_name(self, page_id: str, filename: str) -> ConfluenceAttachment:
         """
         Retrieves a Confluence page attachment by an unprefixed file name.
@@ -831,7 +850,7 @@ class ConfluenceSession:
         query = {
             "title": title,
         }
-        space_id = self.get_space_id(space_id=space_id, space_key=space_key)
+        space_id = self._get_space_id(space_id=space_id, space_key=space_key)
         if space_id is not None:
             query["space-id"] = space_id
 
@@ -871,10 +890,10 @@ class ConfluenceSession:
                 else:
                     raise
 
-        # This should not be reached, but satisfies type checker
+        # this should not be reached, but satisfies type checker
         if last_error is not None:
             raise last_error
-        raise ConfluenceError(f"Failed to get page {page_id}")
+        raise ConfluenceError(f"failed to get page: {page_id}")
 
     def get_page_properties(self, page_id: str) -> ConfluencePageProperties:
         """
@@ -1006,7 +1025,7 @@ class ConfluenceSession:
         :returns: Confluence page ID of a matching page (if found), or `None`.
         """
 
-        space_id = self.get_space_id(space_id=space_id, space_key=space_key)
+        space_id = self._get_space_id(space_id=space_id, space_key=space_key)
         path = "/pages"
         query = {"title": title}
         if space_id is not None:
@@ -1039,6 +1058,7 @@ class ConfluenceSession:
 
         :param title: Page title. Pages in the same Confluence space must have a unique title.
         :param parent_id: Identifies the parent page for a new child page.
+        :returns: Confluence page info for the found or newly created page.
         """
 
         parent_page = self.get_page_properties(parent_id)

md2conf/attachment.py

@@ -0,0 +1,72 @@
+"""
+Publish Markdown files to Confluence wiki.
+
+Copyright 2022-2026, Levente Hunyadi
+
+:see: https://github.com/hunyadi/md2conf
+"""
+
+import re
+from dataclasses import dataclass
+from pathlib import Path
+
+
+@dataclass
+class ImageData:
+    path: Path
+    description: str | None = None
+
+
+@dataclass
+class EmbeddedFileData:
+    data: bytes
+    description: str | None = None
+
+
+class AttachmentCatalog:
+    "Maintains a list of files and binary data to be uploaded to Confluence as attachments."
+
+    images: list[ImageData]
+    embedded_files: dict[str, EmbeddedFileData]
+
+    def __init__(self) -> None:
+        self.images = []
+        self.embedded_files = {}
+
+    def add_image(self, data: ImageData) -> None:
+        self.images.append(data)
+
+    def add_embed(self, filename: str, data: EmbeddedFileData) -> None:
+        self.embedded_files[filename] = data
+
+
+def attachment_name(ref: Path | str) -> str:
+    """
+    Safe name for use with attachment uploads.
+
+    Mutates a relative path such that it meets Confluence's attachment naming requirements.
+
+    Allowed characters:
+
+    * Alphanumeric characters: 0-9, a-z, A-Z
+    * Special characters: hyphen (-), underscore (_), period (.)
+    """
+
+    if isinstance(ref, Path):
+        path = ref
+    else:
+        path = Path(ref)
+
+    if path.drive or path.root:
+        raise ValueError(f"required: relative path; got: {ref}")
+
+    regexp = re.compile(r"[^\-0-9A-Za-z_.]", re.UNICODE)
+
+    def replace_part(part: str) -> str:
+        if part == "..":
+            return "PAR"
+        else:
+            return regexp.sub("_", part)
+
+    parts = [replace_part(p) for p in path.parts]
+    return Path(*parts).as_posix().replace("/", "_")

md2conf/coalesce.py

@@ -0,0 +1,43 @@
+"""
+Publish Markdown files to Confluence wiki.
+
+Copyright 2022-2026, Levente Hunyadi
+
+:see: https://github.com/hunyadi/md2conf
+"""
+
+import copy
+import dataclasses
+from typing import Any, ClassVar, Protocol, TypeVar
+
+
+class DataclassInstance(Protocol):
+    __dataclass_fields__: ClassVar[dict[str, dataclasses.Field[Any]]]
+
+
+D = TypeVar("D", bound=DataclassInstance)
+
+
+def coalesce(target: D, source: D) -> D:
+    """
+    Implements nullish coalescing assignment on each field of a data-class.
+
+    Iterates over each field of the data-class, and evaluates the right operand and assigns it to the left only if
+    the left operand is `None`. Applies recursively when the field is a data-class.
+
+    :returns: A newly created data-class instance.
+    """
+
+    updates: dict[str, Any] = {}
+    for field in dataclasses.fields(target):
+        target_field = getattr(target, field.name, None)
+        source_field = getattr(source, field.name, None)
+
+        if target_field is None:
+            if source_field is not None:
+                updates[field.name] = copy.deepcopy(source_field)
+        elif dataclasses.is_dataclass(field.type):
+            if source_field is not None:
+                updates[field.name] = coalesce(target_field, source_field)
+
+    return dataclasses.replace(target, **updates)

md2conf/collection.py

@@ -1,7 +1,7 @@
 """
 Publish Markdown files to Confluence wiki.
 
-Copyright 2022-2025, Levente Hunyadi
+Copyright 2022-2026, Levente Hunyadi
 
 :see: https://github.com/hunyadi/md2conf
 """

md2conf/{extra.py → compatibility.py}

@@ -1,7 +1,7 @@
 """
 Publish Markdown files to Confluence wiki.
 
-Copyright 2022-2025, Levente Hunyadi
+Copyright 2022-2026, Levente Hunyadi
 
 :see: https://github.com/hunyadi/md2conf
 """