markdown-to-confluence 0.2.4__tar.gz → 0.2.6__tar.gz

{markdown_to_confluence-0.2.4 → markdown_to_confluence-0.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: markdown-to-confluence
-Version: 0.2.4
+Version: 0.2.6
 Summary: Publish Markdown files to Confluence wiki
 Home-page: https://github.com/hunyadi/md2conf
 Author: Levente Hunyadi
@@ -22,10 +22,10 @@ Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: lxml>=5.3
-Requires-Dist: types-lxml>=2024.8.7
-Requires-Dist: markdown>=3.6
-Requires-Dist: types-markdown>=3.6
-Requires-Dist: pymdown-extensions>=10.9
+Requires-Dist: types-lxml>=2024.11.8
+Requires-Dist: markdown>=3.7
+Requires-Dist: types-markdown>=3.7
+Requires-Dist: pymdown-extensions>=10.12
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: types-PyYAML>=6.0
 Requires-Dist: requests>=2.32
@@ -75,11 +75,11 @@ npm install -g @mermaid-js/mermaid-cli
 
 In order to get started, you will need
 
-* your organization domain name (e.g. `instructure.atlassian.net`),
+* your organization domain name (e.g. `example.atlassian.net`),
 * base path for Confluence wiki (typically `/wiki/` for managed Confluence, `/` for on-premise)
 * your Confluence username (e.g. `levente.hunyadi@instructure.com`) (only if required by your deployment),
 * a Confluence API token (a string of alphanumeric characters), and
-* the space key in Confluence (e.g. `DAP`) you are publishing content to.
+* the space key in Confluence (e.g. `SPACE`) you are publishing content to.
 
 ### Obtaining an API token
 
@@ -93,11 +93,11 @@ In order to get started, you will need
 Confluence organization domain, base path, username, API token and space key can be specified at runtime or set as Confluence environment variables (e.g. add to your `~/.profile` on Linux, or `~/.bash_profile` or `~/.zshenv` on MacOS):
 
 ```bash
-export CONFLUENCE_DOMAIN='instructure.atlassian.net'
+export CONFLUENCE_DOMAIN='example.atlassian.net'
 export CONFLUENCE_PATH='/wiki/'
 export CONFLUENCE_USER_NAME='levente.hunyadi@instructure.com'
 export CONFLUENCE_API_KEY='0123456789abcdef'
-export CONFLUENCE_SPACE_KEY='DAP'
+export CONFLUENCE_SPACE_KEY='SPACE'
 ```
 
 On Windows, these can be set via system properties.
@@ -129,7 +129,7 @@ The above tells the tool to synchronize the Markdown file with the given Conflue
 If you work in an environment where there are multiple Confluence spaces, and some Markdown pages may go into one space, whereas other pages may go into another, you can set the target space on a per-document basis:
 
 ```markdown
-<!-- confluence-space-key: DAP -->
+<!-- confluence-space-key: SPACE -->
 ```
 
 This overrides the default space set via command-line arguments or environment variables.
@@ -146,9 +146,17 @@ Provide generated-by prompt text in the Markdown file with a tag:
 
 Alternatively, use the `--generated-by GENERATED_BY` option. The tag takes precedence.
 
+### Publishing a single page
+
+*md2conf* has two modes of operation: *single-page mode* and *directory mode*.
+
+In single-page mode, you specify a single Markdown file as the source, which can contain absolute links to external locations (e.g. `https://example.com`) but not relative links to other pages (e.g. `local.md`). In other words, the page must be stand-alone.
+
 ### Publishing a directory
 
-*md2conf* allows you to convert and publish a directory of Markdown files rather than a single Markdown file if you pass a directory as `mdpath`. This will traverse the specified directory recursively, and synchronize each Markdown file.
+*md2conf* allows you to convert and publish a directory of Markdown files rather than a single Markdown file in *directory mode* if you pass a directory as the source. This will traverse the specified directory recursively, and synchronize each Markdown file.
+
+First, *md2conf* builds an index of pages in the directory hierarchy. The index maps each Markdown file path to a Confluence page ID. Whenever a relative link is encountered in a Markdown file, the relative link is replaced with a Confluence URL to the referenced page with the help of the index. All relative links must point to Markdown files that are located in the directory hierarchy.
 
 If a Markdown file doesn't yet pair up with a Confluence page, *md2conf* creates a new page and assigns a parent. Parent-child relationships are reflected in the navigation panel in Confluence. You can set a root page ID with the command-line option `-r`, which constitutes the topmost parent. (This could correspond to the landing page of your Confluence space. The Confluence page ID is always revealed when you edit a page.) Whenever a directory contains the file `index.md` or `README.md`, this page becomes the future parent page, and all Markdown files in this directory (and possibly nested directories) become its child pages (unless they already have a page ID). However, if an `index.md` or `README.md` file is subsequently found in one of the nested directories, it becomes the parent page of that directory, and any of its subdirectories.
 
@@ -216,7 +224,7 @@ You can run the Docker container via `docker run` or via `Dockerfile`. Either ca
 With `docker run`, you can pass Confluence domain, user, API and space key directly to `docker run`:
 
 ```sh
-docker run --rm --name md2conf -v $(pwd):/data leventehunyadi/md2conf:latest -d instructure.atlassian.net -u levente.hunyadi@instructure.com -a 0123456789abcdef -s DAP ./
+docker run --rm --name md2conf -v $(pwd):/data leventehunyadi/md2conf:latest -d example.atlassian.net -u levente.hunyadi@instructure.com -a 0123456789abcdef -s SPACE ./
 ```
 
 Alternatively, you can use a separate file `.env` to pass these parameters as environment variables:
@@ -234,11 +242,11 @@ With the `Dockerfile` approach, you can extend the base image:
 ```Dockerfile
 FROM leventehunyadi/md2conf:latest
 
-ENV CONFLUENCE_DOMAIN='instructure.atlassian.net'
+ENV CONFLUENCE_DOMAIN='example.atlassian.net'
 ENV CONFLUENCE_PATH='/wiki/'
 ENV CONFLUENCE_USER_NAME='levente.hunyadi@instructure.com'
 ENV CONFLUENCE_API_KEY='0123456789abcdef'
-ENV CONFLUENCE_SPACE_KEY='DAP'
+ENV CONFLUENCE_SPACE_KEY='SPACE'
 
 CMD ["./"]
 ```
@@ -248,5 +256,5 @@ Alternatively,
 ```Dockerfile
 FROM leventehunyadi/md2conf:latest
 
-CMD ["-d", "instructure.atlassian.net", "-u", "levente.hunyadi@instructure.com", "-a", "0123456789abcdef", "-s", "DAP", "./"]
+CMD ["-d", "example.atlassian.net", "-u", "levente.hunyadi@instructure.com", "-a", "0123456789abcdef", "-s", "SPACE", "./"]
 ```

{markdown_to_confluence-0.2.4 → markdown_to_confluence-0.2.6}/README.md

@@ -42,11 +42,11 @@ npm install -g @mermaid-js/mermaid-cli
 
 In order to get started, you will need
 
-* your organization domain name (e.g. `instructure.atlassian.net`),
+* your organization domain name (e.g. `example.atlassian.net`),
 * base path for Confluence wiki (typically `/wiki/` for managed Confluence, `/` for on-premise)
 * your Confluence username (e.g. `levente.hunyadi@instructure.com`) (only if required by your deployment),
 * a Confluence API token (a string of alphanumeric characters), and
-* the space key in Confluence (e.g. `DAP`) you are publishing content to.
+* the space key in Confluence (e.g. `SPACE`) you are publishing content to.
 
 ### Obtaining an API token
 
@@ -60,11 +60,11 @@ In order to get started, you will need
 Confluence organization domain, base path, username, API token and space key can be specified at runtime or set as Confluence environment variables (e.g. add to your `~/.profile` on Linux, or `~/.bash_profile` or `~/.zshenv` on MacOS):
 
 ```bash
-export CONFLUENCE_DOMAIN='instructure.atlassian.net'
+export CONFLUENCE_DOMAIN='example.atlassian.net'
 export CONFLUENCE_PATH='/wiki/'
 export CONFLUENCE_USER_NAME='levente.hunyadi@instructure.com'
 export CONFLUENCE_API_KEY='0123456789abcdef'
-export CONFLUENCE_SPACE_KEY='DAP'
+export CONFLUENCE_SPACE_KEY='SPACE'
 ```
 
 On Windows, these can be set via system properties.
@@ -96,7 +96,7 @@ The above tells the tool to synchronize the Markdown file with the given Conflue
 If you work in an environment where there are multiple Confluence spaces, and some Markdown pages may go into one space, whereas other pages may go into another, you can set the target space on a per-document basis:
 
 ```markdown
-<!-- confluence-space-key: DAP -->
+<!-- confluence-space-key: SPACE -->
 ```
 
 This overrides the default space set via command-line arguments or environment variables.
@@ -113,9 +113,17 @@ Provide generated-by prompt text in the Markdown file with a tag:
 
 Alternatively, use the `--generated-by GENERATED_BY` option. The tag takes precedence.
 
+### Publishing a single page
+
+*md2conf* has two modes of operation: *single-page mode* and *directory mode*.
+
+In single-page mode, you specify a single Markdown file as the source, which can contain absolute links to external locations (e.g. `https://example.com`) but not relative links to other pages (e.g. `local.md`). In other words, the page must be stand-alone.
+
 ### Publishing a directory
 
-*md2conf* allows you to convert and publish a directory of Markdown files rather than a single Markdown file if you pass a directory as `mdpath`. This will traverse the specified directory recursively, and synchronize each Markdown file.
+*md2conf* allows you to convert and publish a directory of Markdown files rather than a single Markdown file in *directory mode* if you pass a directory as the source. This will traverse the specified directory recursively, and synchronize each Markdown file.
+
+First, *md2conf* builds an index of pages in the directory hierarchy. The index maps each Markdown file path to a Confluence page ID. Whenever a relative link is encountered in a Markdown file, the relative link is replaced with a Confluence URL to the referenced page with the help of the index. All relative links must point to Markdown files that are located in the directory hierarchy.
 
 If a Markdown file doesn't yet pair up with a Confluence page, *md2conf* creates a new page and assigns a parent. Parent-child relationships are reflected in the navigation panel in Confluence. You can set a root page ID with the command-line option `-r`, which constitutes the topmost parent. (This could correspond to the landing page of your Confluence space. The Confluence page ID is always revealed when you edit a page.) Whenever a directory contains the file `index.md` or `README.md`, this page becomes the future parent page, and all Markdown files in this directory (and possibly nested directories) become its child pages (unless they already have a page ID). However, if an `index.md` or `README.md` file is subsequently found in one of the nested directories, it becomes the parent page of that directory, and any of its subdirectories.
 
@@ -183,7 +191,7 @@ You can run the Docker container via `docker run` or via `Dockerfile`. Either ca
 With `docker run`, you can pass Confluence domain, user, API and space key directly to `docker run`:
 
 ```sh
-docker run --rm --name md2conf -v $(pwd):/data leventehunyadi/md2conf:latest -d instructure.atlassian.net -u levente.hunyadi@instructure.com -a 0123456789abcdef -s DAP ./
+docker run --rm --name md2conf -v $(pwd):/data leventehunyadi/md2conf:latest -d example.atlassian.net -u levente.hunyadi@instructure.com -a 0123456789abcdef -s SPACE ./
 ```
 
 Alternatively, you can use a separate file `.env` to pass these parameters as environment variables:
@@ -201,11 +209,11 @@ With the `Dockerfile` approach, you can extend the base image:
 ```Dockerfile
 FROM leventehunyadi/md2conf:latest
 
-ENV CONFLUENCE_DOMAIN='instructure.atlassian.net'
+ENV CONFLUENCE_DOMAIN='example.atlassian.net'
 ENV CONFLUENCE_PATH='/wiki/'
 ENV CONFLUENCE_USER_NAME='levente.hunyadi@instructure.com'
 ENV CONFLUENCE_API_KEY='0123456789abcdef'
-ENV CONFLUENCE_SPACE_KEY='DAP'
+ENV CONFLUENCE_SPACE_KEY='SPACE'
 
 CMD ["./"]
 ```
@@ -215,5 +223,5 @@ Alternatively,
 ```Dockerfile
 FROM leventehunyadi/md2conf:latest
 
-CMD ["-d", "instructure.atlassian.net", "-u", "levente.hunyadi@instructure.com", "-a", "0123456789abcdef", "-s", "DAP", "./"]
+CMD ["-d", "example.atlassian.net", "-u", "levente.hunyadi@instructure.com", "-a", "0123456789abcdef", "-s", "SPACE", "./"]
 ```

{markdown_to_confluence-0.2.4 → markdown_to_confluence-0.2.6}/markdown_to_confluence.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: markdown-to-confluence
-Version: 0.2.4
+Version: 0.2.6
 Summary: Publish Markdown files to Confluence wiki
 Home-page: https://github.com/hunyadi/md2conf
 Author: Levente Hunyadi
@@ -22,10 +22,10 @@ Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: lxml>=5.3
-Requires-Dist: types-lxml>=2024.8.7
-Requires-Dist: markdown>=3.6
-Requires-Dist: types-markdown>=3.6
-Requires-Dist: pymdown-extensions>=10.9
+Requires-Dist: types-lxml>=2024.11.8
+Requires-Dist: markdown>=3.7
+Requires-Dist: types-markdown>=3.7
+Requires-Dist: pymdown-extensions>=10.12
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: types-PyYAML>=6.0
 Requires-Dist: requests>=2.32
@@ -75,11 +75,11 @@ npm install -g @mermaid-js/mermaid-cli
 
 In order to get started, you will need
 
-* your organization domain name (e.g. `instructure.atlassian.net`),
+* your organization domain name (e.g. `example.atlassian.net`),
 * base path for Confluence wiki (typically `/wiki/` for managed Confluence, `/` for on-premise)
 * your Confluence username (e.g. `levente.hunyadi@instructure.com`) (only if required by your deployment),
 * a Confluence API token (a string of alphanumeric characters), and
-* the space key in Confluence (e.g. `DAP`) you are publishing content to.
+* the space key in Confluence (e.g. `SPACE`) you are publishing content to.
 
 ### Obtaining an API token
 
@@ -93,11 +93,11 @@ In order to get started, you will need
 Confluence organization domain, base path, username, API token and space key can be specified at runtime or set as Confluence environment variables (e.g. add to your `~/.profile` on Linux, or `~/.bash_profile` or `~/.zshenv` on MacOS):
 
 ```bash
-export CONFLUENCE_DOMAIN='instructure.atlassian.net'
+export CONFLUENCE_DOMAIN='example.atlassian.net'
 export CONFLUENCE_PATH='/wiki/'
 export CONFLUENCE_USER_NAME='levente.hunyadi@instructure.com'
 export CONFLUENCE_API_KEY='0123456789abcdef'
-export CONFLUENCE_SPACE_KEY='DAP'
+export CONFLUENCE_SPACE_KEY='SPACE'
 ```
 
 On Windows, these can be set via system properties.
@@ -129,7 +129,7 @@ The above tells the tool to synchronize the Markdown file with the given Conflue
 If you work in an environment where there are multiple Confluence spaces, and some Markdown pages may go into one space, whereas other pages may go into another, you can set the target space on a per-document basis:
 
 ```markdown
-<!-- confluence-space-key: DAP -->
+<!-- confluence-space-key: SPACE -->
 ```
 
 This overrides the default space set via command-line arguments or environment variables.
@@ -146,9 +146,17 @@ Provide generated-by prompt text in the Markdown file with a tag:
 
 Alternatively, use the `--generated-by GENERATED_BY` option. The tag takes precedence.
 
+### Publishing a single page
+
+*md2conf* has two modes of operation: *single-page mode* and *directory mode*.
+
+In single-page mode, you specify a single Markdown file as the source, which can contain absolute links to external locations (e.g. `https://example.com`) but not relative links to other pages (e.g. `local.md`). In other words, the page must be stand-alone.
+
 ### Publishing a directory
 
-*md2conf* allows you to convert and publish a directory of Markdown files rather than a single Markdown file if you pass a directory as `mdpath`. This will traverse the specified directory recursively, and synchronize each Markdown file.
+*md2conf* allows you to convert and publish a directory of Markdown files rather than a single Markdown file in *directory mode* if you pass a directory as the source. This will traverse the specified directory recursively, and synchronize each Markdown file.
+
+First, *md2conf* builds an index of pages in the directory hierarchy. The index maps each Markdown file path to a Confluence page ID. Whenever a relative link is encountered in a Markdown file, the relative link is replaced with a Confluence URL to the referenced page with the help of the index. All relative links must point to Markdown files that are located in the directory hierarchy.
 
 If a Markdown file doesn't yet pair up with a Confluence page, *md2conf* creates a new page and assigns a parent. Parent-child relationships are reflected in the navigation panel in Confluence. You can set a root page ID with the command-line option `-r`, which constitutes the topmost parent. (This could correspond to the landing page of your Confluence space. The Confluence page ID is always revealed when you edit a page.) Whenever a directory contains the file `index.md` or `README.md`, this page becomes the future parent page, and all Markdown files in this directory (and possibly nested directories) become its child pages (unless they already have a page ID). However, if an `index.md` or `README.md` file is subsequently found in one of the nested directories, it becomes the parent page of that directory, and any of its subdirectories.
 
@@ -216,7 +224,7 @@ You can run the Docker container via `docker run` or via `Dockerfile`. Either ca
 With `docker run`, you can pass Confluence domain, user, API and space key directly to `docker run`:
 
 ```sh
-docker run --rm --name md2conf -v $(pwd):/data leventehunyadi/md2conf:latest -d instructure.atlassian.net -u levente.hunyadi@instructure.com -a 0123456789abcdef -s DAP ./
+docker run --rm --name md2conf -v $(pwd):/data leventehunyadi/md2conf:latest -d example.atlassian.net -u levente.hunyadi@instructure.com -a 0123456789abcdef -s SPACE ./
 ```
 
 Alternatively, you can use a separate file `.env` to pass these parameters as environment variables:
@@ -234,11 +242,11 @@ With the `Dockerfile` approach, you can extend the base image:
 ```Dockerfile
 FROM leventehunyadi/md2conf:latest
 
-ENV CONFLUENCE_DOMAIN='instructure.atlassian.net'
+ENV CONFLUENCE_DOMAIN='example.atlassian.net'
 ENV CONFLUENCE_PATH='/wiki/'
 ENV CONFLUENCE_USER_NAME='levente.hunyadi@instructure.com'
 ENV CONFLUENCE_API_KEY='0123456789abcdef'
-ENV CONFLUENCE_SPACE_KEY='DAP'
+ENV CONFLUENCE_SPACE_KEY='SPACE'
 
 CMD ["./"]
 ```
@@ -248,5 +256,5 @@ Alternatively,
 ```Dockerfile
 FROM leventehunyadi/md2conf:latest
 
-CMD ["-d", "instructure.atlassian.net", "-u", "levente.hunyadi@instructure.com", "-a", "0123456789abcdef", "-s", "DAP", "./"]
+CMD ["-d", "example.atlassian.net", "-u", "levente.hunyadi@instructure.com", "-a", "0123456789abcdef", "-s", "SPACE", "./"]
 ```

markdown_to_confluence-0.2.6/markdown_to_confluence.egg-info/requires.txt

@@ -0,0 +1,9 @@
+lxml>=5.3
+types-lxml>=2024.11.8
+markdown>=3.7
+types-markdown>=3.7
+pymdown-extensions>=10.12
+pyyaml>=6.0
+types-PyYAML>=6.0
+requests>=2.32
+types-requests>=2.32

{markdown_to_confluence-0.2.4 → markdown_to_confluence-0.2.6}/md2conf/__init__.py

@@ -5,7 +5,7 @@ Parses Markdown files, converts Markdown content into the Confluence Storage For
 Confluence API endpoints to upload images and content.
 """
 
-__version__ = "0.2.4"
+__version__ = "0.2.6"
 __author__ = "Levente Hunyadi"
 __copyright__ = "Copyright 2022-2024, Levente Hunyadi"
 __license__ = "MIT"

{markdown_to_confluence-0.2.4 → markdown_to_confluence-0.2.6}/md2conf/__main__.py

@@ -1,3 +1,14 @@
+"""
+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-2024, Levente Hunyadi
+
+:see: https://github.com/hunyadi/md2conf
+"""
+
 import argparse
 import logging
 import os.path

{markdown_to_confluence-0.2.4 → markdown_to_confluence-0.2.6}/md2conf/api.py

@@ -1,3 +1,11 @@
+"""
+Publish Markdown files to Confluence wiki.
+
+Copyright 2022-2024, Levente Hunyadi
+
+:see: https://github.com/hunyadi/md2conf
+"""
+
 import io
 import json
 import logging
@@ -170,17 +178,30 @@ class ConfluenceSession:
     def upload_attachment(
         self,
         page_id: str,
-        attachment_path: Path,
         attachment_name: str,
+        *,
+        attachment_path: Optional[Path] = None,
         raw_data: Optional[bytes] = None,
+        content_type: Optional[str] = None,
         comment: Optional[str] = None,
-        *,
         space_key: Optional[str] = None,
         force: bool = False,
     ) -> None:
-        content_type = mimetypes.guess_type(attachment_path, strict=True)[0]
 
-        if not raw_data and not attachment_path.is_file():
+        if attachment_path is None and raw_data is None:
+            raise ConfluenceError("required: `attachment_path` or `raw_data`")
+
+        if attachment_path is not None and raw_data is not None:
+            raise ConfluenceError("expected: either `attachment_path` or `raw_data`")
+
+        if content_type is None:
+            if attachment_path is not None:
+                name = str(attachment_path)
+            else:
+                name = attachment_name
+            content_type, _ = mimetypes.guess_type(name, strict=True)
+
+        if attachment_path is not None and not attachment_path.is_file():
             raise ConfluenceError(f"file not found: {attachment_path}")
 
         try:
@@ -188,14 +209,16 @@ class ConfluenceSession:
                 page_id, attachment_name, space_key=space_key
             )
 
-            if not raw_data:
+            if attachment_path is not None:
                 if not force and attachment.file_size == attachment_path.stat().st_size:
                     LOGGER.info("Up-to-date attachment: %s", attachment_name)
                     return
-            else:
+            elif raw_data is not None:
                 if not force and attachment.file_size == len(raw_data):
                     LOGGER.info("Up-to-date embedded image: %s", attachment_name)
                     return
+            else:
+                raise NotImplementedError("never occurs")
 
             id = removeprefix(attachment.id, "att")
             path = f"/content/{page_id}/child/attachment/{id}/data"
@@ -205,7 +228,7 @@ class ConfluenceSession:
 
         url = self._build_url(path)
 
-        if not raw_data:
+        if attachment_path is not None:
             with open(attachment_path, "rb") as attachment_file:
                 file_to_upload = {
                     "comment": comment,
@@ -222,24 +245,27 @@ class ConfluenceSession:
                     files=file_to_upload,  # type: ignore
                     headers={"X-Atlassian-Token": "no-check"},
                 )
-        else:
+        elif raw_data is not None:
             LOGGER.info("Uploading raw data: %s", attachment_name)
 
+            raw_file = io.BytesIO(raw_data)
+            raw_file.name = attachment_name
             file_to_upload = {
                 "comment": comment,
                 "file": (
                     attachment_name,  # will truncate path component
-                    io.BytesIO(raw_data),  # type: ignore
+                    raw_file,  # type: ignore
                     content_type,
                     {"Expires": "0"},
                 ),
             }
-
             response = self.session.post(
                 url,
                 files=file_to_upload,  # type: ignore
                 headers={"X-Atlassian-Token": "no-check"},
             )
+        else:
+            raise NotImplementedError("never occurs")
 
         response.raise_for_status()
         data = response.json()
@@ -491,7 +517,7 @@ class ConfluenceSession:
         page_id = self.page_exists(title)
 
         if page_id is not None:
-            LOGGER.debug("Retrieving existing page: %d", page_id)
+            LOGGER.debug("Retrieving existing page: %s", page_id)
             return self.get_page(page_id)
         else:
             LOGGER.debug("Creating new page with title: %s", title)

{markdown_to_confluence-0.2.4 → markdown_to_confluence-0.2.6}/md2conf/application.py

@@ -1,3 +1,11 @@
+"""
+Publish Markdown files to Confluence wiki.
+
+Copyright 2022-2024, Levente Hunyadi
+
+:see: https://github.com/hunyadi/md2conf
+"""
+
 import logging
 import os.path
 from pathlib import Path
@@ -36,6 +44,7 @@ class Application:
     def synchronize(self, path: Path) -> None:
         "Synchronizes a single Markdown page or a directory of Markdown pages."
 
+        path = path.resolve(True)
         if path.is_dir():
             self.synchronize_directory(path)
         elif path.is_file():
@@ -43,15 +52,31 @@ class Application:
         else:
             raise ValueError(f"expected: valid file or directory path; got: {path}")
 
-    def synchronize_page(self, page_path: Path) -> None:
+    def synchronize_page(
+        self, page_path: Path, root_dir: Optional[Path] = None
+    ) -> None:
         "Synchronizes a single Markdown page with Confluence."
 
-        self._synchronize_page(page_path, {})
+        page_path = page_path.resolve(True)
+        if root_dir is None:
+            root_dir = page_path.parent
+        else:
+            root_dir = root_dir.resolve(True)
+
+        self._synchronize_page(page_path, root_dir, {})
 
-    def synchronize_directory(self, local_dir: Path) -> None:
+    def synchronize_directory(
+        self, local_dir: Path, root_dir: Optional[Path] = None
+    ) -> None:
         "Synchronizes a directory of Markdown pages with Confluence."
 
-        LOGGER.info(f"Synchronizing directory: {local_dir}")
+        local_dir = local_dir.resolve(True)
+        if root_dir is None:
+            root_dir = local_dir
+        else:
+            root_dir = root_dir.resolve(True)
+
+        LOGGER.info("Synchronizing directory: %s", local_dir)
 
         # Step 1: build index of all page metadata
         page_metadata: Dict[Path, ConfluencePageMetadata] = {}
@@ -61,21 +86,22 @@ class Application:
             else None
         )
         self._index_directory(local_dir, root_id, page_metadata)
-        LOGGER.info(f"indexed {len(page_metadata)} page(s)")
+        LOGGER.info("Indexed %d page(s)", len(page_metadata))
 
         # Step 2: convert each page
         for page_path in page_metadata.keys():
-            self._synchronize_page(page_path, page_metadata)
+            self._synchronize_page(page_path, root_dir, page_metadata)
 
     def _synchronize_page(
         self,
         page_path: Path,
+        root_dir: Path,
         page_metadata: Dict[Path, ConfluencePageMetadata],
     ) -> None:
         base_path = page_path.parent
 
-        LOGGER.info(f"Synchronizing page: {page_path}")
-        document = ConfluenceDocument(page_path, self.options, page_metadata)
+        LOGGER.info("Synchronizing page: %s", page_path)
+        document = ConfluenceDocument(page_path, self.options, root_dir, page_metadata)
 
         if document.id.space_key:
             with self.api.switch_space(document.id.space_key):
@@ -91,7 +117,7 @@ class Application:
     ) -> None:
         "Indexes Markdown files in a directory recursively."
 
-        LOGGER.info(f"Indexing directory: {local_dir}")
+        LOGGER.info("Indexing directory: %s", local_dir)
 
         matcher = Matcher(MatcherOptions(source=".mdignore", extension="md"), local_dir)
 
@@ -107,22 +133,30 @@ class Application:
                 directories.append(Path(local_dir) / entry.name)
 
         # make page act as parent node in Confluence
-        parent_id: Optional[ConfluenceQualifiedID] = None
+        parent_doc: Optional[Path] = None
         if (Path(local_dir) / "index.md") in files:
-            parent_id = read_qualified_id(Path(local_dir) / "index.md")
+            parent_doc = Path(local_dir) / "index.md"
         elif (Path(local_dir) / "README.md") in files:
-            parent_id = read_qualified_id(Path(local_dir) / "README.md")
+            parent_doc = Path(local_dir) / "README.md"
+
+        if parent_doc is not None:
+            files.remove(parent_doc)
 
-        if parent_id is None:
+            metadata = self._get_or_create_page(parent_doc, root_id)
+            LOGGER.debug("Indexed parent %s with metadata: %s", parent_doc, metadata)
+            page_metadata[parent_doc] = metadata
+
+            parent_id = read_qualified_id(parent_doc) or root_id
+        else:
             parent_id = root_id
 
         for doc in files:
             metadata = self._get_or_create_page(doc, parent_id)
-            LOGGER.debug(f"indexed {doc} with metadata: {metadata}")
+            LOGGER.debug("Indexed %s with metadata: %s", doc, metadata)
             page_metadata[doc] = metadata
 
         for directory in directories:
-            self._index_directory(Path(local_dir) / directory, parent_id, page_metadata)
+            self._index_directory(directory, parent_id, page_metadata)
 
     def _get_or_create_page(
         self,
@@ -202,20 +236,19 @@ class Application:
         for image in document.images:
             self.api.upload_attachment(
                 document.id.page_id,
-                base_path / image,
                 attachment_name(image),
+                attachment_path=base_path / image,
             )
 
-        for image, data in document.embedded_images.items():
+        for name, data in document.embedded_images.items():
             self.api.upload_attachment(
                 document.id.page_id,
-                Path("EMB") / image,
-                attachment_name(image),
+                name,
                 raw_data=data,
             )
 
         content = document.xhtml()
-        LOGGER.debug(f"generated Confluence Storage Format document:\n{content}")
+        LOGGER.debug("Generated Confluence Storage Format document:\n%s", content)
         self.api.update_page(document.id.page_id, content)
 
     def _update_markdown(

{markdown_to_confluence-0.2.4 → markdown_to_confluence-0.2.6}/md2conf/converter.py

@@ -1,3 +1,11 @@
+"""
+Publish Markdown files to Confluence wiki.
+
+Copyright 2022-2024, Levente Hunyadi
+
+:see: https://github.com/hunyadi/md2conf
+"""
+
 # mypy: disable-error-code="dict-item"
 
 import hashlib
@@ -10,7 +18,7 @@ import uuid
 import xml.etree.ElementTree
 from dataclasses import dataclass
 from pathlib import Path
-from typing import Any, Dict, List, Literal, Optional, Tuple
+from typing import Any, Dict, List, Literal, Optional, Tuple, Union
 from urllib.parse import ParseResult, urlparse, urlunparse
 
 import lxml.etree as ET
@@ -293,9 +301,10 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
 
     options: ConfluenceConverterOptions
     path: Path
-    base_path: Path
+    base_dir: Path
+    root_dir: Path
     links: List[str]
-    images: List[str]
+    images: List[Path]
     embedded_images: Dict[str, bytes]
     page_metadata: Dict[Path, ConfluencePageMetadata]
 
@@ -303,12 +312,14 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
         self,
         options: ConfluenceConverterOptions,
         path: Path,
+        root_dir: Path,
         page_metadata: Dict[Path, ConfluencePageMetadata],
     ) -> None:
         super().__init__()
         self.options = options
         self.path = path
-        self.base_path = path.parent
+        self.base_dir = path.parent
+        self.root_dir = root_dir
         self.links = []
         self.images = []
         self.embedded_images = {}
@@ -343,7 +354,7 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
         if is_absolute_url(url):
             return None
 
-        LOGGER.debug(f"found link {url} relative to {self.path}")
+        LOGGER.debug("Found link %s relative to %s", url, self.path)
         relative_url: ParseResult = urlparse(url)
 
         if (
@@ -353,7 +364,7 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
             and not relative_url.params
             and not relative_url.query
         ):
-            LOGGER.debug(f"found local URL: {url}")
+            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>
                 target = relative_url.fragment.lstrip("#")
@@ -375,9 +386,9 @@ 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_path / relative_url.path).absolute()
-        if not str(absolute_path).startswith(str(self.base_path)):
-            msg = f"relative URL {url} points to outside base path: {self.base_path}"
+        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")
@@ -385,8 +396,6 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
             else:
                 raise DocumentError(msg)
 
-        relative_path = os.path.relpath(absolute_path, self.base_path)
-
         link_metadata = self.page_metadata.get(absolute_path)
         if link_metadata is None:
             msg = f"unable to find matching page for URL: {url}"
@@ -397,8 +406,9 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
             else:
                 raise DocumentError(msg)
 
+        relative_path = os.path.relpath(absolute_path, self.base_dir)
         LOGGER.debug(
-            f"found link to page {relative_path} with metadata: {link_metadata}"
+            "found link to page %s with metadata: %s", relative_path, link_metadata
         )
         self.links.append(url)
 
@@ -417,24 +427,31 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
         )
         transformed_url = urlunparse(components)
 
-        LOGGER.debug(f"transformed relative URL: {url} to URL: {transformed_url}")
+        LOGGER.debug("Transformed relative URL: %s to URL: %s", url, transformed_url)
         anchor.attrib["href"] = transformed_url
         return None
 
     def _transform_image(self, image: ET._Element) -> ET._Element:
         path: str = image.attrib["src"]
 
+        if not path:
+            raise DocumentError("image lacks `src` attribute")
+
+        if is_absolute_url(path):
+            # images whose `src` attribute is an absolute URL cannot be converted into an `ac:image`;
+            # Confluence images are expected to refer to an uploaded attachment
+            raise DocumentError("image has a `src` attribute that is an absolute URL")
+
+        relative_path = Path(path)
+
         # prefer PNG over SVG; Confluence displays SVG in wrong size, and text labels are truncated
-        if path and is_relative_url(path):
-            relative_path = Path(path)
-            if (
-                relative_path.suffix == ".svg"
-                and (self.base_path / relative_path.with_suffix(".png")).exists()
-            ):
-                path = str(relative_path.with_suffix(".png"))
-
-        self.images.append(path)
+        png_file = relative_path.with_suffix(".png")
+        if relative_path.suffix == ".svg" and (self.base_dir / png_file).exists():
+            relative_path = png_file
+
+        self.images.append(relative_path)
         caption = image.attrib["alt"]
+        image_name = attachment_name(relative_path)
         return AC(
             "image",
             {
@@ -443,7 +460,8 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
             },
             RI(
                 "attachment",
-                {ET.QName(namespaces["ri"], "filename"): attachment_name(path)},
+                # refers to an attachment uploaded alongside the page
+                {ET.QName(namespaces["ri"], "filename"): image_name},
             ),
             AC("caption", HTML.p(caption)),
         )
@@ -749,6 +767,9 @@ class ConfluenceStorageFormatConverter(NodeVisitor):
             tail: str = child.tail
             child.tail = tail.replace("\n", " ")
 
+        if not isinstance(child.tag, str):
+            return None
+
         if self.options.heading_anchors:
             # <h1>...</h1>
             # <h2>...</h2> ...
@@ -924,7 +945,7 @@ class ConfluenceDocumentOptions:
 class ConfluenceDocument:
     id: ConfluenceQualifiedID
     links: List[str]
-    images: List[str]
+    images: List[Path]
 
     options: ConfluenceDocumentOptions
     root: ET._Element
@@ -933,10 +954,11 @@ class ConfluenceDocument:
         self,
         path: Path,
         options: ConfluenceDocumentOptions,
+        root_dir: Path,
         page_metadata: Dict[Path, ConfluencePageMetadata],
     ) -> None:
         self.options = options
-        path = path.absolute()
+        path = path.resolve(True)
 
         with open(path, "r", encoding="utf-8") as f:
             text = f.read()
@@ -990,6 +1012,7 @@ class ConfluenceDocument:
                 webui_links=self.options.webui_links,
             ),
             path,
+            root_dir,
             page_metadata,
         )
         converter.visit(self.root)
@@ -1001,7 +1024,7 @@ class ConfluenceDocument:
         return elements_to_string(self.root)
 
 
-def attachment_name(name: str) -> str:
+def attachment_name(name: Union[Path, str]) -> str:
     """
     Safe name for use with attachment uploads.
 
@@ -1010,7 +1033,7 @@ def attachment_name(name: str) -> str:
     * Special characters: hyphen (-), underscore (_), period (.)
     """
 
-    return re.sub(r"[^\-0-9A-Za-z_.]", "_", name)
+    return re.sub(r"[^\-0-9A-Za-z_.]", "_", str(name))
 
 
 def sanitize_confluence(html: str) -> str:

{markdown_to_confluence-0.2.4 → markdown_to_confluence-0.2.6}/md2conf/emoji.py

@@ -1,3 +1,11 @@
+"""
+Publish Markdown files to Confluence wiki.
+
+Copyright 2022-2024, Levente Hunyadi
+
+:see: https://github.com/hunyadi/md2conf
+"""
+
 import pathlib
 
 import pymdownx.emoji1_db as emoji_db

{markdown_to_confluence-0.2.4 → markdown_to_confluence-0.2.6}/md2conf/matcher.py

@@ -1,3 +1,11 @@
+"""
+Publish Markdown files to Confluence wiki.
+
+Copyright 2022-2024, Levente Hunyadi
+
+:see: https://github.com/hunyadi/md2conf
+"""
+
 import os.path
 from dataclasses import dataclass
 from fnmatch import fnmatch

{markdown_to_confluence-0.2.4 → markdown_to_confluence-0.2.6}/md2conf/mermaid.py

@@ -1,3 +1,11 @@
+"""
+Publish Markdown files to Confluence wiki.
+
+Copyright 2022-2024, Levente Hunyadi
+
+:see: https://github.com/hunyadi/md2conf
+"""
+
 import logging
 import os
 import os.path
@@ -48,11 +56,15 @@ def render(source: str, output_format: Literal["png", "svg"] = "png") -> bytes:
         filename,
         "--outputFormat",
         output_format,
+        "--backgroundColor",
+        "transparent",
+        "--scale",
+        "2",
     ]
     root = os.path.dirname(__file__)
     if is_docker():
         cmd.extend(["-p", os.path.join(root, "puppeteer-config.json")])
-    LOGGER.debug(f"Executing: {' '.join(cmd)}")
+    LOGGER.debug("Executing: %s", " ".join(cmd))
     try:
         proc = subprocess.Popen(
             cmd,

{markdown_to_confluence-0.2.4 → markdown_to_confluence-0.2.6}/md2conf/processor.py

@@ -1,8 +1,16 @@
+"""
+Publish Markdown files to Confluence wiki.
+
+Copyright 2022-2024, Levente Hunyadi
+
+:see: https://github.com/hunyadi/md2conf
+"""
+
 import hashlib
 import logging
 import os
 from pathlib import Path
-from typing import Dict, List
+from typing import Dict, List, Optional
 
 from .converter import (
     ConfluenceDocument,
@@ -30,33 +38,56 @@ class Processor:
     def process(self, path: Path) -> None:
         "Processes a single Markdown file or a directory of Markdown files."
 
+        path = path.resolve(True)
         if path.is_dir():
             self.process_directory(path)
         elif path.is_file():
-            self.process_page(path, {})
+            self.process_page(path)
         else:
             raise ValueError(f"expected: valid file or directory path; got: {path}")
 
-    def process_directory(self, local_dir: Path) -> None:
+    def process_directory(
+        self, local_dir: Path, root_dir: Optional[Path] = None
+    ) -> None:
         "Recursively scans a directory hierarchy for Markdown files."
 
-        LOGGER.info(f"Synchronizing directory: {local_dir}")
+        local_dir = local_dir.resolve(True)
+        if root_dir is None:
+            root_dir = local_dir
+        else:
+            root_dir = root_dir.resolve(True)
+
+        LOGGER.info("Synchronizing directory: %s", local_dir)
 
         # Step 1: build index of all page metadata
         page_metadata: Dict[Path, ConfluencePageMetadata] = {}
         self._index_directory(local_dir, page_metadata)
-        LOGGER.info(f"indexed {len(page_metadata)} page(s)")
+        LOGGER.info("Indexed %d page(s)", len(page_metadata))
 
         # Step 2: convert each page
         for page_path in page_metadata.keys():
-            self.process_page(page_path, page_metadata)
+            self._process_page(page_path, root_dir, page_metadata)
 
-    def process_page(
-        self, path: Path, page_metadata: Dict[Path, ConfluencePageMetadata]
+    def process_page(self, path: Path, root_dir: Optional[Path] = None) -> None:
+        "Processes a single Markdown file."
+
+        path = path.resolve(True)
+        if root_dir is None:
+            root_dir = path.parent
+        else:
+            root_dir = root_dir.resolve(True)
+
+        self._process_page(path, root_dir, {})
+
+    def _process_page(
+        self,
+        path: Path,
+        root_dir: Path,
+        page_metadata: Dict[Path, ConfluencePageMetadata],
     ) -> None:
         "Processes a single Markdown file."
 
-        document = ConfluenceDocument(path, self.options, page_metadata)
+        document = ConfluenceDocument(path, self.options, root_dir, page_metadata)
         content = document.xhtml()
         with open(path.with_suffix(".csf"), "w", encoding="utf-8") as f:
             f.write(content)
@@ -68,7 +99,7 @@ class Processor:
     ) -> None:
         "Indexes Markdown files in a directory recursively."
 
-        LOGGER.info(f"Indexing directory: {local_dir}")
+        LOGGER.info("Indexing directory: %s", local_dir)
 
         matcher = Matcher(MatcherOptions(source=".mdignore", extension="md"), local_dir)
 
@@ -85,11 +116,11 @@ class Processor:
 
         for doc in files:
             metadata = self._get_page(doc)
-            LOGGER.debug(f"indexed {doc} with metadata: {metadata}")
+            LOGGER.debug("Indexed %s with metadata: %s", doc, metadata)
             page_metadata[doc] = metadata
 
         for directory in directories:
-            self._index_directory(Path(local_dir) / directory, page_metadata)
+            self._index_directory(directory, page_metadata)
 
     def _get_page(self, absolute_path: Path) -> ConfluencePageMetadata:
         "Extracts metadata from a Markdown file."
@@ -102,7 +133,7 @@ class Processor:
             if self.options.root_page_id is not None:
                 hash = hashlib.md5(document.encode("utf-8"))
                 digest = "".join(f"{c:x}" for c in hash.digest())
-                LOGGER.info(f"Identifier '{digest}' assigned to page: {absolute_path}")
+                LOGGER.info("Identifier %s assigned to page: %s", digest, absolute_path)
                 qualified_id = ConfluenceQualifiedID(digest)
             else:
                 raise ValueError("required: page ID for local output")

{markdown_to_confluence-0.2.4 → markdown_to_confluence-0.2.6}/md2conf/properties.py

@@ -1,3 +1,11 @@
+"""
+Publish Markdown files to Confluence wiki.
+
+Copyright 2022-2024, Levente Hunyadi
+
+:see: https://github.com/hunyadi/md2conf
+"""
+
 import os
 from typing import Dict, Optional
 

{markdown_to_confluence-0.2.4 → markdown_to_confluence-0.2.6}/md2conf/util.py

@@ -1,3 +1,11 @@
+"""
+Publish Markdown files to Confluence wiki.
+
+Copyright 2022-2024, Levente Hunyadi
+
+:see: https://github.com/hunyadi/md2conf
+"""
+
 import sys
 
 if sys.version_info >= (3, 9):

{markdown_to_confluence-0.2.4 → markdown_to_confluence-0.2.6}/setup.cfg

@@ -29,10 +29,10 @@ packages = find:
 python_requires = >=3.8
 install_requires = 
 	lxml >= 5.3
-	types-lxml >= 2024.8.7
-	markdown >= 3.6
-	types-markdown >= 3.6
-	pymdown-extensions >= 10.9
+	types-lxml >= 2024.11.8
+	markdown >= 3.7
+	types-markdown >= 3.7
+	pymdown-extensions >= 10.12
 	pyyaml >= 6.0
 	types-PyYAML >= 6.0
 	requests >= 2.32

markdown_to_confluence-0.2.6/setup.py

@@ -0,0 +1,12 @@
+"""
+Publish Markdown files to Confluence wiki.
+
+Copyright 2022-2024, Levente Hunyadi
+
+:see: https://github.com/hunyadi/md2conf
+"""
+
+from setuptools import setup
+
+if __name__ == "__main__":
+    setup()

{markdown_to_confluence-0.2.4 → markdown_to_confluence-0.2.6}/tests/test_conversion.py

@@ -1,3 +1,11 @@
+"""
+Publish Markdown files to Confluence wiki.
+
+Copyright 2022-2024, Levente Hunyadi
+
+:see: https://github.com/hunyadi/md2conf
+"""
+
 import logging
 import os
 import os.path
@@ -65,7 +73,8 @@ class TestConversion(unittest.TestCase):
             with self.subTest(name=name):
                 actual = ConfluenceDocument(
                     self.source_dir / f"{name}.md",
-                    ConfluenceDocumentOptions(ignore_invalid_url=True),
+                    ConfluenceDocumentOptions(),
+                    self.source_dir,
                     {},
                 ).xhtml()
                 actual = standardize(actual)
@@ -75,10 +84,25 @@ class TestConversion(unittest.TestCase):
 
                 self.assertEqual(actual, expected)
 
+    def test_broken_links(self) -> None:
+        actual = ConfluenceDocument(
+            self.source_dir / "missing.md",
+            ConfluenceDocumentOptions(ignore_invalid_url=True),
+            self.source_dir,
+            {},
+        ).xhtml()
+        actual = standardize(actual)
+
+        with open(self.target_dir / "missing.xml", "r", encoding="utf-8") as f:
+            expected = canonicalize(f.read())
+
+        self.assertEqual(actual, expected)
+
     def test_heading_anchors(self) -> None:
         actual = ConfluenceDocument(
             self.source_dir / "anchors.md",
             ConfluenceDocumentOptions(heading_anchors=True),
+            self.source_dir,
             {},
         ).xhtml()
         actual = standardize(actual)
@@ -93,10 +117,10 @@ class TestConversion(unittest.TestCase):
         document = ConfluenceDocument(
             self.source_dir / "mermaid.md",
             ConfluenceDocumentOptions(
-                ignore_invalid_url=True,
                 render_mermaid=True,
                 diagram_output_format="svg",
             ),
+            self.source_dir,
             {},
         )
         self.assertEqual(len(document.embedded_images), 6)
@@ -106,10 +130,10 @@ class TestConversion(unittest.TestCase):
         document = ConfluenceDocument(
             self.source_dir / "mermaid.md",
             ConfluenceDocumentOptions(
-                ignore_invalid_url=True,
                 render_mermaid=True,
                 diagram_output_format="png",
             ),
+            self.source_dir,
             {},
         )
         self.assertEqual(len(document.embedded_images), 6)

{markdown_to_confluence-0.2.4 → markdown_to_confluence-0.2.6}/tests/test_matcher.py

@@ -1,3 +1,11 @@
+"""
+Publish Markdown files to Confluence wiki.
+
+Copyright 2022-2024, Levente Hunyadi
+
+:see: https://github.com/hunyadi/md2conf
+"""
+
 import logging
 import os
 import os.path
@@ -36,6 +44,7 @@ class TestMatcher(unittest.TestCase):
         ]
         expected.remove(Entry("ignore.md", False))
         expected.remove(Entry("anchors.md", False))
+        expected.remove(Entry("missing.md", False))
 
         options = MatcherOptions(".mdignore", ".md")
         matcher = Matcher(options, directory)

{markdown_to_confluence-0.2.4 → markdown_to_confluence-0.2.6}/tests/test_mermaid.py

@@ -1,3 +1,11 @@
+"""
+Publish Markdown files to Confluence wiki.
+
+Copyright 2022-2024, Levente Hunyadi
+
+:see: https://github.com/hunyadi/md2conf
+"""
+
 import logging
 import os
 import shutil
@@ -6,7 +14,6 @@ from pathlib import Path
 
 from md2conf.mermaid import has_mmdc, render
 
-
 logging.basicConfig(
     level=logging.INFO,
     format="%(asctime)s - %(levelname)s - %(funcName)s [%(lineno)d] - %(message)s",

{markdown_to_confluence-0.2.4 → markdown_to_confluence-0.2.6}/tests/test_processor.py

@@ -1,3 +1,11 @@
+"""
+Publish Markdown files to Confluence wiki.
+
+Copyright 2022-2024, Levente Hunyadi
+
+:see: https://github.com/hunyadi/md2conf
+"""
+
 import logging
 import shutil
 import unittest
@@ -31,7 +39,6 @@ class TestProcessor(unittest.TestCase):
 
     def test_process_document(self) -> None:
         options = ConfluenceDocumentOptions(
-            ignore_invalid_url=False,
             generated_by="Test Case",
             root_page_id="None",
         )
@@ -45,7 +52,6 @@ class TestProcessor(unittest.TestCase):
 
     def test_process_directory(self) -> None:
         options = ConfluenceDocumentOptions(
-            ignore_invalid_url=True,
             generated_by="The Author",
             root_page_id="ROOT_PAGE_ID",
         )

markdown_to_confluence-0.2.4/markdown_to_confluence.egg-info/requires.txt

@@ -1,9 +0,0 @@
-lxml>=5.3
-types-lxml>=2024.8.7
-markdown>=3.6
-types-markdown>=3.6
-pymdown-extensions>=10.9
-pyyaml>=6.0
-types-PyYAML>=6.0
-requests>=2.32
-types-requests>=2.32

markdown_to_confluence-0.2.4/setup.py

@@ -1,4 +0,0 @@
-from setuptools import setup
-
-if __name__ == "__main__":
-    setup()