markdown-to-confluence 0.3.5__py3-none-any.whl → 0.4.1__py3-none-any.whl

md2conf/converter.py

@@ -23,9 +23,12 @@ from urllib.parse import ParseResult, quote_plus, urlparse, urlunparse
 import lxml.etree as ET
 import markdown
 from lxml.builder import ElementMaker
+from strong_typing.core import JsonType
 
+from .collection import ConfluencePageCollection
+from .extra import path_relative_to
 from .mermaid import render_diagram
-from .metadata import ConfluencePageMetadata, ConfluenceSiteMetadata
+from .metadata import ConfluenceSiteMetadata
 from .properties import PageError
 from .scanner import ScannedDocument, Scanner
 
@@ -66,6 +69,12 @@ def is_relative_url(url: str) -> bool:
     return not bool(urlparts.scheme) and not bool(urlparts.netloc)
 
 
+def is_directory_within(absolute_path: Path, base_path: Path) -> bool:
+    "True if the absolute path is nested within the base path."
+
+    return absolute_path.as_posix().startswith(base_path.as_posix())
+
+
 def encode_title(text: str) -> str:
     "Converts a title string such that it is safe to embed into a Confluence URL."
 
@@ -91,8 +100,10 @@ def emoji_generator(
     md: markdown.Markdown,
 ) -> xml.etree.ElementTree.Element:
     name = (alias or shortname).strip(":")
-    span = xml.etree.ElementTree.Element("span", {"data-emoji": name})
+    span = xml.etree.ElementTree.Element("span", {"data-emoji-shortname": name})
     if uc is not None:
+        span.attrib["data-emoji-unicode"] = uc
+
         # convert series of Unicode code point hexadecimal values into characters
         span.text = "".join(chr(int(item, base=16)) for item in uc.split("-"))
     else:
@@ -142,14 +153,11 @@ def _elements_from_strings(dtd_path: Path, items: list[str]) -> ET._Element:
         load_dtd=True,
     )
 
-    ns_attr_list = "".join(
-        f' xmlns:{key}="{value}"' for key, value in namespaces.items()
-    )
+    ns_attr_list = "".join(f' xmlns:{key}="{value}"' for key, value in namespaces.items())
 
     data = [
         '<?xml version="1.0"?>',
-        f'<!DOCTYPE ac:confluence PUBLIC "-//Atlassian//Confluence 4 Page//EN" "{dtd_path.as_posix()}">'
-        f"<root{ns_attr_list}>",
+        f'<!DOCTYPE ac:confluence PUBLIC "-//Atlassian//Confluence 4 Page//EN" "{dtd_path.as_posix()}"><root{ns_attr_list}>',
     ]
     data.extend(items)
     data.append("</root>")
@@ -362,7 +370,7 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
     images: list[Path]
     embedded_images: dict[str, bytes]
     site_metadata: ConfluenceSiteMetadata
-    page_metadata: dict[Path, ConfluencePageMetadata]
+    page_metadata: ConfluencePageCollection
 
     def __init__(
         self,
@@ -370,9 +378,13 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
         path: Path,
         root_dir: Path,
         site_metadata: ConfluenceSiteMetadata,
-        page_metadata: dict[Path, ConfluencePageMetadata],
+        page_metadata: ConfluencePageCollection,
     ) -> None:
         super().__init__()
+
+        path = path.resolve(True)
+        root_dir = root_dir.resolve(True)
+
         self.options = options
         self.path = path
         self.base_dir = path.parent
@@ -406,6 +418,14 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
         anchor.tail = heading.text
         heading.text = None
 
+    def _warn_or_raise(self, msg: str) -> None:
+        "Emit a warning or raise an exception when a path points to a resource that doesn't exist."
+
+        if self.options.ignore_invalid_url:
+            LOGGER.warning(msg)
+        else:
+            raise DocumentError(msg)
+
     def _transform_link(self, anchor: ET._Element) -> Optional[ET._Element]:
         url = anchor.attrib.get("href")
         if url is None or is_absolute_url(url):
@@ -414,13 +434,7 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
         LOGGER.debug("Found link %s relative to %s", url, self.path)
         relative_url: ParseResult = urlparse(url)
 
-        if (
-            not relative_url.scheme
-            and not relative_url.netloc
-            and not relative_url.path
-            and not relative_url.params
-            and not relative_url.query
-        ):
+        if not relative_url.scheme and not relative_url.netloc and not relative_url.path and not relative_url.params and not relative_url.query:
             LOGGER.debug("Found local URL: %s", url)
             if self.options.heading_anchors:
                 # <ac:link ac:anchor="anchor"><ac:link-body>...</ac:link-body></ac:link>
@@ -443,15 +457,11 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
         # convert the relative URL to absolute URL based on the base path value, then look up
         # the absolute path in the page metadata dictionary to discover the relative path
         # within Confluence that should be used
-        absolute_path = (self.base_dir / relative_url.path).resolve(True)
-        if not str(absolute_path).startswith(str(self.root_dir)):
-            msg = f"relative URL {url} points to outside root path: {self.root_dir}"
-            if self.options.ignore_invalid_url:
-                LOGGER.warning(msg)
-                anchor.attrib.pop("href")
-                return None
-            else:
-                raise DocumentError(msg)
+        absolute_path = (self.base_dir / relative_url.path).resolve()
+        if not is_directory_within(absolute_path, self.root_dir):
+            anchor.attrib.pop("href")
+            self._warn_or_raise(f"relative URL {url} points to outside root path: {self.root_dir}")
+            return None
 
         link_metadata = self.page_metadata.get(absolute_path)
         if link_metadata is None:
@@ -464,9 +474,7 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
                 raise DocumentError(msg)
 
         relative_path = os.path.relpath(absolute_path, self.base_dir)
-        LOGGER.debug(
-            "found link to page %s with metadata: %s", relative_path, link_metadata
-        )
+        LOGGER.debug("found link to page %s with metadata: %s", relative_path, link_metadata)
         self.links.append(url)
 
         if self.options.webui_links:
@@ -475,9 +483,7 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
             space_key = link_metadata.space_key or self.site_metadata.space_key
 
             if space_key is None:
-                raise DocumentError(
-                    "Confluence space key required for building full web URLs"
-                )
+                raise DocumentError("Confluence space key required for building full web URLs")
 
             page_url = f"{self.site_metadata.base_path}spaces/{space_key}/pages/{link_metadata.page_id}/{encode_title(link_metadata.title)}"
 
@@ -519,9 +525,7 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
         else:
             return self._transform_attached_image(Path(src), caption, attributes)
 
-    def _transform_external_image(
-        self, url: str, caption: Optional[str], attributes: dict[str, Any]
-    ) -> ET._Element:
+    def _transform_external_image(self, url: str, caption: Optional[str], attributes: dict[str, Any]) -> ET._Element:
         "Emits Confluence Storage Format XHTML for an external image."
 
         elements: list[ET._Element] = []
@@ -537,18 +541,28 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
 
         return AC("image", attributes, *elements)
 
-    def _transform_attached_image(
-        self, path: Path, caption: Optional[str], attributes: dict[str, Any]
-    ) -> ET._Element:
+    def _transform_attached_image(self, path: Path, caption: Optional[str], attributes: dict[str, Any]) -> ET._Element:
         "Emits Confluence Storage Format XHTML for an attached image."
 
-        # prefer PNG over SVG; Confluence displays SVG in wrong size, and text labels are truncated
-        png_file = path.with_suffix(".png")
-        if path.suffix == ".svg" and (self.base_dir / png_file).exists():
-            path = png_file
+        # resolve relative path into absolute path w.r.t. base dir
+        absolute_path = (self.base_dir / path).resolve()
 
-        self.images.append(path)
-        image_name = attachment_name(path)
+        if absolute_path.exists():
+            # prefer PNG over SVG; Confluence displays SVG in wrong size, and text labels are truncated
+            if absolute_path.suffix == ".svg":
+                png_file = absolute_path.with_suffix(".png")
+                if png_file.exists():
+                    absolute_path = png_file
+
+            if is_directory_within(absolute_path, self.root_dir):
+                self.images.append(absolute_path)
+                image_name = attachment_name(path_relative_to(absolute_path, self.base_dir))
+            else:
+                image_name = ""
+                self._warn_or_raise(f"path to image {path} points to outside root path {self.root_dir}")
+        else:
+            image_name = ""
+            self._warn_or_raise(f"path to image {path} does not exist")
 
         elements: list[ET._Element] = []
         elements.append(
@@ -604,9 +618,7 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
         if self.options.render_mermaid:
             image_data = render_diagram(content, self.options.diagram_output_format)
             image_hash = hashlib.md5(image_data).hexdigest()
-            image_filename = attachment_name(
-                f"embedded_{image_hash}.{self.options.diagram_output_format}"
-            )
+            image_filename = attachment_name(f"embedded_{image_hash}.{self.options.diagram_output_format}")
             self.embedded_images[image_filename] = image_data
             return AC(
                 "image",
@@ -766,9 +778,7 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
 
         return self._transform_alert(elem, class_name, skip)
 
-    def _transform_alert(
-        self, elem: ET._Element, class_name: Optional[str], skip: int
-    ) -> ET._Element:
+    def _transform_alert(self, elem: ET._Element, class_name: Optional[str], skip: int) -> ET._Element:
         """
         Creates an info, tip, note or warning panel from a GitHub or GitLab alert.
 
@@ -803,14 +813,12 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
         Creates a collapsed section.
 
         Transforms
-        [GitHub collapsed section](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections)  # noqa: E501 # no way to make this link shorter
+        [GitHub collapsed section](https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/organizing-information-with-collapsed-sections)
         syntax into the Confluence structured macro *expand*.
         """
 
         if elem[0].tag != "summary":
-            raise DocumentError(
-                "expected: `<summary>` as first direct child of `<details>`"
-            )
+            raise DocumentError("expected: `<summary>` as first direct child of `<details>`")
         if elem[0].tail is not None:
             raise DocumentError('expected: attribute `markdown="1"` on `<details>`')
 
@@ -834,7 +842,8 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
         )
 
     def _transform_emoji(self, elem: ET._Element) -> ET._Element:
-        shortname = elem.attrib.get("data-emoji", "")
+        shortname = elem.attrib.get("data-emoji-shortname", "")
+        unicode = elem.attrib.get("data-emoji-unicode", None)
         alt = elem.text or ""
 
         # <ac:emoticon ac:name="wink" ac:emoji-shortname=":wink:" ac:emoji-id="1f609" ac:emoji-fallback="&#128521;"/>
@@ -844,8 +853,9 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
             "emoticon",
             {
                 # use "blue-star" as a placeholder name to ensure wiki page loads in timely manner
-                ET.QName(namespaces["ac"], "name"): "blue-star",
+                ET.QName(namespaces["ac"], "name"): shortname,
                 ET.QName(namespaces["ac"], "emoji-shortname"): f":{shortname}:",
+                ET.QName(namespaces["ac"], "emoji-id"): unicode,
                 ET.QName(namespaces["ac"], "emoji-fallback"): alt,
             },
         )
@@ -900,13 +910,7 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
         # <blockquote>
         #   <p>[!TIP] ...</p>
         # </blockquote>
-        elif (
-            child.tag == "blockquote"
-            and len(child) > 0
-            and child[0].tag == "p"
-            and child[0].text is not None
-            and child[0].text.startswith("[!")
-        ):
+        elif child.tag == "blockquote" and len(child) > 0 and child[0].tag == "p" and child[0].text is not None and child[0].text.startswith("[!"):
             return self._transform_github_alert(child)
 
         # Alerts in GitLab
@@ -918,9 +922,7 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
             and len(child) > 0
             and child[0].tag == "p"
             and child[0].text is not None
-            and starts_with_any(
-                child[0].text, ["FLAG:", "NOTE:", "WARNING:", "DISCLAIMER:"]
-            )
+            and starts_with_any(child[0].text, ["FLAG:", "NOTE:", "WARNING:", "DISCLAIMER:"])
         ):
             return self._transform_gitlab_alert(child)
 
@@ -943,7 +945,7 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
         elif child.tag == "pre" and len(child) == 1 and child[0].tag == "code":
             return self._transform_block(child[0])
 
-        elif child.tag == "span" and child.attrib.has_key("data-emoji"):
+        elif child.tag == "span" and child.attrib.has_key("data-emoji-shortname"):
             return self._transform_emoji(child)
 
         return None
@@ -1006,6 +1008,8 @@ class ConversionError(RuntimeError):
 
 class ConfluenceDocument:
     title: Optional[str]
+    labels: Optional[list[str]]
+    properties: Optional[dict[str, JsonType]]
     links: list[str]
     images: list[Path]
 
@@ -1019,7 +1023,7 @@ class ConfluenceDocument:
         options: ConfluenceDocumentOptions,
         root_dir: Path,
         site_metadata: ConfluenceSiteMetadata,
-        page_metadata: dict[Path, ConfluencePageMetadata],
+        page_metadata: ConfluencePageCollection,
     ) -> tuple[ConfluencePageID, "ConfluenceDocument"]:
         path = path.resolve(True)
 
@@ -1035,9 +1039,7 @@ class ConfluenceDocument:
             else:
                 raise PageError("missing Confluence page ID")
 
-        return page_id, ConfluenceDocument(
-            path, document, options, root_dir, site_metadata, page_metadata
-        )
+        return page_id, ConfluenceDocument(path, document, options, root_dir, site_metadata, page_metadata)
 
     def __init__(
         self,
@@ -1046,7 +1048,7 @@ class ConfluenceDocument:
         options: ConfluenceDocumentOptions,
         root_dir: Path,
         site_metadata: ConfluenceSiteMetadata,
-        page_metadata: dict[Path, ConfluencePageMetadata],
+        page_metadata: ConfluencePageCollection,
     ) -> None:
         self.options = options
 
@@ -1095,21 +1097,43 @@ class ConfluenceDocument:
         self.embedded_images = converter.embedded_images
 
         self.title = document.title or converter.toc.get_title()
+        self.labels = document.tags
+        self.properties = document.properties
 
     def xhtml(self) -> str:
         return elements_to_string(self.root)
 
 
-def attachment_name(name: Union[Path, str]) -> str:
+def attachment_name(ref: Union[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 (.)
     """
 
-    return re.sub(r"[^\-0-9A-Za-z_.]", "_", str(name))
+    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("/", "_")
 
 
 def sanitize_confluence(html: str) -> str:
@@ -1140,14 +1164,11 @@ def _content_to_string(dtd_path: Path, content: str) -> str:
         load_dtd=True,
     )
 
-    ns_attr_list = "".join(
-        f' xmlns:{key}="{value}"' for key, value in namespaces.items()
-    )
+    ns_attr_list = "".join(f' xmlns:{key}="{value}"' for key, value in namespaces.items())
 
     data = [
         '<?xml version="1.0"?>',
-        f'<!DOCTYPE ac:confluence PUBLIC "-//Atlassian//Confluence 4 Page//EN" "{dtd_path}">'
-        f"<root{ns_attr_list}>",
+        f'<!DOCTYPE ac:confluence PUBLIC "-//Atlassian//Confluence 4 Page//EN" "{dtd_path.as_posix()}"><root{ns_attr_list}>',
     ]
     data.append(content)
     data.append("</root>")

md2conf/emoji.py

@@ -10,7 +10,24 @@ import pathlib
 
 import pymdownx.emoji1_db as emoji_db
 
-EMOJI_PAGE_ID = "86918529216"
+EMOJI_PAGE_ID = "13500452"
+
+
+def to_html(cp: int) -> str:
+    """
+    Returns the safe HTML representation for a Unicode code point.
+
+    Converts non-ASCII and non-printable characters into HTML entities with decimal notation.
+
+    :param cp: Unicode code point.
+    :returns: An HTML representation of the Unicode character.
+    """
+
+    ch = chr(cp)
+    if ch.isascii() and ch.isalnum():
+        return ch
+    else:
+        return f"&#{cp};"
 
 
 def generate_source(path: pathlib.Path) -> None:
@@ -47,11 +64,19 @@ def generate_target(path: pathlib.Path) -> None:
         print("<thead><tr><th>Icon</th><th>Emoji code</th></tr></thead>", file=f)
         print("<tbody>", file=f)
         for key, data in emojis.items():
+            unicode = data["unicode"]
             key = key.strip(":")
-            unicode = "".join(f"&#x{item};" for item in data["unicode"].split("-"))
+            html = "".join(to_html(int(item, base=16)) for item in unicode.split("-"))
 
             print(
-                f'<tr><td><ac:emoticon ac:name="blue-star" ac:emoji-shortname=":{key}:" ac:emoji-fallback="{unicode}"/></td><td><code>:{key}:</code></td></tr>',
+                f"<tr>\n"
+                f"  <td>\n"
+                f'    <ac:emoticon ac:name="{key}" ac:emoji-shortname=":{key}:" ac:emoji-id="{unicode}" ac:emoji-fallback="{html}"/>\n'
+                f"  </td>\n"
+                f"  <td>\n"
+                f"    <code>:{key}:</code>\n"
+                f"  </td>\n"
+                f"</tr>",
                 file=f,
             )
         print("</tbody>", file=f)

md2conf/extra.py

@@ -0,0 +1,27 @@
+"""
+Publish Markdown files to Confluence wiki.
+
+Copyright 2022-2025, Levente Hunyadi
+
+:see: https://github.com/hunyadi/md2conf
+"""
+
+import sys
+
+if sys.version_info >= (3, 12):
+    from typing import override as override  # noqa: F401
+else:
+    from typing_extensions import override as override  # noqa: F401
+
+if sys.version_info >= (3, 12):
+    from pathlib import Path
+
+    def path_relative_to(destination: Path, origin: Path) -> Path:
+        return destination.relative_to(origin, walk_up=True)
+
+else:
+    import os.path
+    from pathlib import Path
+
+    def path_relative_to(destination: Path, origin: Path) -> Path:
+        return Path(os.path.relpath(destination, start=origin))

md2conf/local.py

@@ -6,17 +6,15 @@ Copyright 2022-2025, Levente Hunyadi
 :see: https://github.com/hunyadi/md2conf
 """
 
-import hashlib
 import logging
 import os
 from pathlib import Path
 from typing import Optional
 
 from .converter import ConfluenceDocument, ConfluenceDocumentOptions, ConfluencePageID
+from .extra import override
 from .metadata import ConfluencePageMetadata, ConfluenceSiteMetadata
-from .processor import Converter, Processor, ProcessorFactory
-from .properties import PageError
-from .scanner import Scanner
+from .processor import Converter, DocumentNode, Processor, ProcessorFactory
 
 LOGGER = logging.getLogger(__name__)
 
@@ -46,44 +44,35 @@ class LocalProcessor(Processor):
         super().__init__(options, site, root_dir)
         self.out_dir = out_dir or root_dir
 
-    def _get_or_create_page(
-        self, absolute_path: Path, parent_id: Optional[ConfluencePageID]
-    ) -> ConfluencePageMetadata:
-        """
-        Extracts metadata from a Markdown file.
+    @override
+    def _synchronize_tree(self, root: DocumentNode, root_id: Optional[ConfluencePageID]) -> None:
         """
+        Creates the cross-reference index.
 
-        # parse file
-        document = Scanner().read(absolute_path)
-        if document.page_id is not None:
-            page_id = document.page_id
-            space_key = document.space_key or self.site.space_key or "HOME"
-        else:
-            if parent_id is None:
-                raise PageError(
-                    f"expected: parent page ID for Markdown file with no linked Confluence page: {absolute_path}"
-                )
-
-            hash = hashlib.md5(document.text.encode("utf-8"))
-            digest = "".join(f"{c:x}" for c in hash.digest())
-            LOGGER.info("Identifier %s assigned to page: %s", digest, absolute_path)
-            page_id = digest
-            space_key = self.site.space_key or "HOME"
-
-        return ConfluencePageMetadata(
-            page_id=page_id,
-            space_key=space_key,
-            title="",
-            overwrite=True,
-        )
-
-    def _save_document(
-        self, page_id: ConfluencePageID, document: ConfluenceDocument, path: Path
-    ) -> None:
+        Does not change Markdown files.
         """
-        Saves a new version of a Confluence document.
 
-        A derived class may invoke Confluence REST API to persist the new version.
+        for node in root.all():
+            if node.page_id is not None:
+                page_id = node.page_id
+            else:
+                digest = self._generate_hash(node.absolute_path)
+                LOGGER.info("Identifier %s assigned to page: %s", digest, node.absolute_path)
+                page_id = digest
+
+            self.page_metadata.add(
+                node.absolute_path,
+                ConfluencePageMetadata(
+                    page_id=page_id,
+                    space_key=node.space_key or self.site.space_key or "HOME",
+                    title=node.title or "",
+                ),
+            )
+
+    @override
+    def _update_page(self, page_id: ConfluencePageID, document: ConfluenceDocument, path: Path) -> None:
+        """
+        Saves the document as Confluence Storage Format XHTML to the local disk.
         """
 
         content = document.xhtml()
@@ -106,9 +95,7 @@ class LocalProcessorFactory(ProcessorFactory):
         self.out_dir = out_dir
 
     def create(self, root_dir: Path) -> Processor:
-        return LocalProcessor(
-            self.options, self.site, out_dir=self.out_dir, root_dir=root_dir
-        )
+        return LocalProcessor(self.options, self.site, out_dir=self.out_dir, root_dir=root_dir)
 
 
 class LocalConverter(Converter):

md2conf/matcher.py

@@ -156,6 +156,4 @@ class Matcher:
         :returns: A filtered list of entries whose name didn't match any of the exclusion rules.
         """
 
-        return self.filter(
-            Entry(entry.name, entry.is_dir()) for entry in os.scandir(path)
-        )
+        return self.filter(Entry(entry.name, entry.is_dir()) for entry in os.scandir(path))

md2conf/mermaid.py

@@ -19,10 +19,7 @@ LOGGER = logging.getLogger(__name__)
 def is_docker() -> bool:
     "True if the application is running in a Docker container."
 
-    return (
-        os.environ.get("CHROME_BIN") == "/usr/bin/chromium-browser"
-        and os.environ.get("PUPPETEER_SKIP_DOWNLOAD") == "true"
-    )
+    return os.environ.get("CHROME_BIN") == "/usr/bin/chromium-browser" and os.environ.get("PUPPETEER_SKIP_DOWNLOAD") == "true"
 
 
 def get_mmdc() -> str:
@@ -79,9 +76,7 @@ def render_diagram(source: str, output_format: Literal["png", "svg"] = "png") ->
         )
         stdout, stderr = proc.communicate(input=source.encode("utf-8"))
         if proc.returncode:
-            messages = [
-                f"failed to convert Mermaid diagram; exit code: {proc.returncode}"
-            ]
+            messages = [f"failed to convert Mermaid diagram; exit code: {proc.returncode}"]
             console_output = stdout.decode("utf-8")
             if console_output:
                 messages.append(f"output:\n{console_output}")

md2conf/metadata.py

@@ -33,10 +33,8 @@ class ConfluencePageMetadata:
     :param page_id: Confluence page ID.
     :param space_key: Confluence space key.
     :param title: Document title.
-    :param overwrite: True if operations are allowed to update document properties (e.g. title).
     """
 
     page_id: str
     space_key: str
     title: str
-    overwrite: bool