mkdocs2confluence 0.5.26__tar.gz → 0.5.28__tar.gz

{mkdocs2confluence-0.5.26/src/mkdocs2confluence.egg-info → mkdocs2confluence-0.5.28}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mkdocs2confluence
-Version: 0.5.26
+Version: 0.5.28
 Summary: Publish MkDocs Material pages to Confluence Cloud — admonitions, Mermaid diagrams, tabs, page properties and more
 Author: Anders Hybertz
 License: GPL-3.0-or-later
@@ -40,6 +40,7 @@ Dynamic: license-file
 
 [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
 [![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![PyPI](https://img.shields.io/pypi/v/mkdocs2confluence)](https://pypi.org/project/mkdocs2confluence/)
 [![Latest Release](https://img.shields.io/github/v/release/jeckyl2010/mkdocs2confluence)](https://github.com/jeckyl2010/mkdocs2confluence/releases/latest)
 [![CI](https://github.com/jeckyl2010/mkdocs2confluence/actions/workflows/ci.yml/badge.svg)](https://github.com/jeckyl2010/mkdocs2confluence/actions/workflows/ci.yml)
 [![Release](https://github.com/jeckyl2010/mkdocs2confluence/actions/workflows/release.yml/badge.svg)](https://github.com/jeckyl2010/mkdocs2confluence/actions/workflows/release.yml)
@@ -56,52 +57,7 @@ It is a **compiler/transpiler**, not an HTML converter — every Markdown constr
 
 ## Architecture
 
-```mermaid
-flowchart LR
-    subgraph Input
-        A[mkdocs.yml\nconf config + nav]
-        B[Markdown files\n+ assets]
-    end
-
-    subgraph Loader
-        C[Config loader\nMkDocsConfig\nConfluenceConfig]
-        D[Nav resolver\nNavNode tree]
-    end
-
-    subgraph Preprocess
-        E[Front matter\nIncludes / snippets\nAbbreviations\nIcon shortcodes\nLink definitions]
-    end
-
-    subgraph IR
-        F[Markdown → IR\nDocument node tree]
-    end
-
-    subgraph Transforms
-        G[Mermaid → PNG\nInternal links\nAsset paths\nAbbrev expansion\nEdit link\nCSS styles]
-    end
-
-    subgraph Emitter
-        H[IR → Confluence\nstorage XHTML]
-    end
-
-    subgraph Publisher
-        I[Plan\ncreate / update / skip\nper nav node]
-        J[Execute\nPages · Folders\nStub pages · Assets]
-        K[Confluence Cloud\nREST API v2]
-    end
-
-    A --> C
-    A --> D
-    B --> E
-    C --> E
-    D --> I
-    E --> F
-    F --> G
-    G --> H
-    H --> I
-    I --> J
-    J --> K
-```
+![Architecture](https://raw.githubusercontent.com/jeckyl2010/mkdocs2confluence/main/docs/architecture.png)
 
 Each stage is a separate Python module under `src/mkdocs_to_confluence/`. The **plan** phase makes all API read calls (find existing pages); the **execute** phase makes all write calls, ensuring parents always exist before children.
 
@@ -214,6 +170,7 @@ The API token is read from (in priority order):
 - Pages with `ready: false` in their YAML front matter are **skipped**, even if listed in the nav.
 - Section nodes (nav groups without a page) become empty parent pages in Confluence, mirroring the nav hierarchy.
 - All locally linked assets are uploaded as Confluence page attachments automatically.
+- **Smart update detection** — before calling the Confluence update API, mk2conf compares a `sha256` hash of the compiled output against the hash stored from the previous run (kept as a hidden Confluence page property `mk2conf-content-hash`). Pages whose content has not changed are skipped entirely — no version bump, no watcher notification.
 
 #### Mermaid rendering
 

{mkdocs2confluence-0.5.26 → mkdocs2confluence-0.5.28}/README.md

@@ -2,6 +2,7 @@
 
 [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
 [![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![PyPI](https://img.shields.io/pypi/v/mkdocs2confluence)](https://pypi.org/project/mkdocs2confluence/)
 [![Latest Release](https://img.shields.io/github/v/release/jeckyl2010/mkdocs2confluence)](https://github.com/jeckyl2010/mkdocs2confluence/releases/latest)
 [![CI](https://github.com/jeckyl2010/mkdocs2confluence/actions/workflows/ci.yml/badge.svg)](https://github.com/jeckyl2010/mkdocs2confluence/actions/workflows/ci.yml)
 [![Release](https://github.com/jeckyl2010/mkdocs2confluence/actions/workflows/release.yml/badge.svg)](https://github.com/jeckyl2010/mkdocs2confluence/actions/workflows/release.yml)
@@ -18,52 +19,7 @@ It is a **compiler/transpiler**, not an HTML converter — every Markdown constr
 
 ## Architecture
 
-```mermaid
-flowchart LR
-    subgraph Input
-        A[mkdocs.yml\nconf config + nav]
-        B[Markdown files\n+ assets]
-    end
-
-    subgraph Loader
-        C[Config loader\nMkDocsConfig\nConfluenceConfig]
-        D[Nav resolver\nNavNode tree]
-    end
-
-    subgraph Preprocess
-        E[Front matter\nIncludes / snippets\nAbbreviations\nIcon shortcodes\nLink definitions]
-    end
-
-    subgraph IR
-        F[Markdown → IR\nDocument node tree]
-    end
-
-    subgraph Transforms
-        G[Mermaid → PNG\nInternal links\nAsset paths\nAbbrev expansion\nEdit link\nCSS styles]
-    end
-
-    subgraph Emitter
-        H[IR → Confluence\nstorage XHTML]
-    end
-
-    subgraph Publisher
-        I[Plan\ncreate / update / skip\nper nav node]
-        J[Execute\nPages · Folders\nStub pages · Assets]
-        K[Confluence Cloud\nREST API v2]
-    end
-
-    A --> C
-    A --> D
-    B --> E
-    C --> E
-    D --> I
-    E --> F
-    F --> G
-    G --> H
-    H --> I
-    I --> J
-    J --> K
-```
+![Architecture](https://raw.githubusercontent.com/jeckyl2010/mkdocs2confluence/main/docs/architecture.png)
 
 Each stage is a separate Python module under `src/mkdocs_to_confluence/`. The **plan** phase makes all API read calls (find existing pages); the **execute** phase makes all write calls, ensuring parents always exist before children.
 
@@ -176,6 +132,7 @@ The API token is read from (in priority order):
 - Pages with `ready: false` in their YAML front matter are **skipped**, even if listed in the nav.
 - Section nodes (nav groups without a page) become empty parent pages in Confluence, mirroring the nav hierarchy.
 - All locally linked assets are uploaded as Confluence page attachments automatically.
+- **Smart update detection** — before calling the Confluence update API, mk2conf compares a `sha256` hash of the compiled output against the hash stored from the previous run (kept as a hidden Confluence page property `mk2conf-content-hash`). Pages whose content has not changed are skipped entirely — no version bump, no watcher notification.
 
 #### Mermaid rendering
 

{mkdocs2confluence-0.5.26 → mkdocs2confluence-0.5.28}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mkdocs2confluence"
-version = "0.5.26"
+version = "0.5.28"
 description = "Publish MkDocs Material pages to Confluence Cloud — admonitions, Mermaid diagrams, tabs, page properties and more"
 readme = "README.md"
 license = { text = "GPL-3.0-or-later" }

{mkdocs2confluence-0.5.26 → mkdocs2confluence-0.5.28/src/mkdocs2confluence.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mkdocs2confluence
-Version: 0.5.26
+Version: 0.5.28
 Summary: Publish MkDocs Material pages to Confluence Cloud — admonitions, Mermaid diagrams, tabs, page properties and more
 Author: Anders Hybertz
 License: GPL-3.0-or-later
@@ -40,6 +40,7 @@ Dynamic: license-file
 
 [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
 [![Python 3.12+](https://img.shields.io/badge/python-3.12+-blue.svg)](https://www.python.org/downloads/)
+[![PyPI](https://img.shields.io/pypi/v/mkdocs2confluence)](https://pypi.org/project/mkdocs2confluence/)
 [![Latest Release](https://img.shields.io/github/v/release/jeckyl2010/mkdocs2confluence)](https://github.com/jeckyl2010/mkdocs2confluence/releases/latest)
 [![CI](https://github.com/jeckyl2010/mkdocs2confluence/actions/workflows/ci.yml/badge.svg)](https://github.com/jeckyl2010/mkdocs2confluence/actions/workflows/ci.yml)
 [![Release](https://github.com/jeckyl2010/mkdocs2confluence/actions/workflows/release.yml/badge.svg)](https://github.com/jeckyl2010/mkdocs2confluence/actions/workflows/release.yml)
@@ -56,52 +57,7 @@ It is a **compiler/transpiler**, not an HTML converter — every Markdown constr
 
 ## Architecture
 
-```mermaid
-flowchart LR
-    subgraph Input
-        A[mkdocs.yml\nconf config + nav]
-        B[Markdown files\n+ assets]
-    end
-
-    subgraph Loader
-        C[Config loader\nMkDocsConfig\nConfluenceConfig]
-        D[Nav resolver\nNavNode tree]
-    end
-
-    subgraph Preprocess
-        E[Front matter\nIncludes / snippets\nAbbreviations\nIcon shortcodes\nLink definitions]
-    end
-
-    subgraph IR
-        F[Markdown → IR\nDocument node tree]
-    end
-
-    subgraph Transforms
-        G[Mermaid → PNG\nInternal links\nAsset paths\nAbbrev expansion\nEdit link\nCSS styles]
-    end
-
-    subgraph Emitter
-        H[IR → Confluence\nstorage XHTML]
-    end
-
-    subgraph Publisher
-        I[Plan\ncreate / update / skip\nper nav node]
-        J[Execute\nPages · Folders\nStub pages · Assets]
-        K[Confluence Cloud\nREST API v2]
-    end
-
-    A --> C
-    A --> D
-    B --> E
-    C --> E
-    D --> I
-    E --> F
-    F --> G
-    G --> H
-    H --> I
-    I --> J
-    J --> K
-```
+![Architecture](https://raw.githubusercontent.com/jeckyl2010/mkdocs2confluence/main/docs/architecture.png)
 
 Each stage is a separate Python module under `src/mkdocs_to_confluence/`. The **plan** phase makes all API read calls (find existing pages); the **execute** phase makes all write calls, ensuring parents always exist before children.
 
@@ -214,6 +170,7 @@ The API token is read from (in priority order):
 - Pages with `ready: false` in their YAML front matter are **skipped**, even if listed in the nav.
 - Section nodes (nav groups without a page) become empty parent pages in Confluence, mirroring the nav hierarchy.
 - All locally linked assets are uploaded as Confluence page attachments automatically.
+- **Smart update detection** — before calling the Confluence update API, mk2conf compares a `sha256` hash of the compiled output against the hash stored from the previous run (kept as a hidden Confluence page property `mk2conf-content-hash`). Pages whose content has not changed are skipped entirely — no version bump, no watcher notification.
 
 #### Mermaid rendering
 

{mkdocs2confluence-0.5.26 → mkdocs2confluence-0.5.28}/src/mkdocs_to_confluence/__init__.py

@@ -3,6 +3,6 @@
 from importlib.metadata import PackageNotFoundError, version
 
 try:
-    __version__ = version("mkdocs-to-confluence")
+    __version__ = version("mkdocs2confluence")
 except PackageNotFoundError:
     __version__ = "unknown"