mkdocs2confluence 0.10.2__tar.gz → 0.11.0__tar.gz

{mkdocs2confluence-0.10.2 → mkdocs2confluence-0.11.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mkdocs2confluence
-Version: 0.10.2
+Version: 0.11.0
 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
@@ -94,6 +94,53 @@ git clone https://github.com/jeckyl2010/mkdocs2confluence.git
 cd mkdocs2confluence && uv sync
 ```
 
+### GitHub Actions
+
+Add `mk2conf` to any CI/CD pipeline with the official action. Store your Confluence API token as a repository secret (`CONFLUENCE_API_TOKEN`) and add a workflow step:
+
+```yaml
+- name: Publish docs to Confluence
+  uses: jeckyl2010/mkdocs2confluence@v1
+  with:
+    token: ${{ secrets.CONFLUENCE_API_TOKEN }}
+```
+
+**Full example** — publish on every push to `main`:
+
+```yaml
+name: Publish docs
+
+on:
+  push:
+    branches: [main]
+    paths: ['docs/**', 'mkdocs.yml']
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Publish docs to Confluence
+        uses: jeckyl2010/mkdocs2confluence@v1
+        with:
+          token: ${{ secrets.CONFLUENCE_API_TOKEN }}
+          prune: 'true'   # remove pages deleted from nav
+```
+
+**All inputs:**
+
+| Input | Required | Default | Description |
+|---|---|---|---|
+| `token` | ✅ | — | Confluence API token |
+| `config` | | `mkdocs.yml` | Path to mkdocs.yml |
+| `version` | | latest | Pin a specific `mk2conf` version (e.g. `"0.10.3"`) |
+| `dry-run` | | `false` | Print sync plan without publishing |
+| `section` | | — | Publish only a nav section (e.g. `"Guide/Setup"`) |
+| `page` | | — | Publish only a single page (e.g. `"guide/setup.md"`) |
+| `prune` | | `false` | Delete managed pages removed from nav |
+| `quiet` | | `false` | Suppress per-item progress output |
+
 ---
 
 ## Quick start

{mkdocs2confluence-0.10.2 → mkdocs2confluence-0.11.0}/README.md

@@ -53,6 +53,53 @@ git clone https://github.com/jeckyl2010/mkdocs2confluence.git
 cd mkdocs2confluence && uv sync
 ```
 
+### GitHub Actions
+
+Add `mk2conf` to any CI/CD pipeline with the official action. Store your Confluence API token as a repository secret (`CONFLUENCE_API_TOKEN`) and add a workflow step:
+
+```yaml
+- name: Publish docs to Confluence
+  uses: jeckyl2010/mkdocs2confluence@v1
+  with:
+    token: ${{ secrets.CONFLUENCE_API_TOKEN }}
+```
+
+**Full example** — publish on every push to `main`:
+
+```yaml
+name: Publish docs
+
+on:
+  push:
+    branches: [main]
+    paths: ['docs/**', 'mkdocs.yml']
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Publish docs to Confluence
+        uses: jeckyl2010/mkdocs2confluence@v1
+        with:
+          token: ${{ secrets.CONFLUENCE_API_TOKEN }}
+          prune: 'true'   # remove pages deleted from nav
+```
+
+**All inputs:**
+
+| Input | Required | Default | Description |
+|---|---|---|---|
+| `token` | ✅ | — | Confluence API token |
+| `config` | | `mkdocs.yml` | Path to mkdocs.yml |
+| `version` | | latest | Pin a specific `mk2conf` version (e.g. `"0.10.3"`) |
+| `dry-run` | | `false` | Print sync plan without publishing |
+| `section` | | — | Publish only a nav section (e.g. `"Guide/Setup"`) |
+| `page` | | — | Publish only a single page (e.g. `"guide/setup.md"`) |
+| `prune` | | `false` | Delete managed pages removed from nav |
+| `quiet` | | `false` | Suppress per-item progress output |
+
 ---
 
 ## Quick start

{mkdocs2confluence-0.10.2 → mkdocs2confluence-0.11.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mkdocs2confluence"
-version = "0.10.2"
+version = "0.11.0"
 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.10.2 → mkdocs2confluence-0.11.0}/src/mkdocs2confluence.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mkdocs2confluence
-Version: 0.10.2
+Version: 0.11.0
 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
@@ -94,6 +94,53 @@ git clone https://github.com/jeckyl2010/mkdocs2confluence.git
 cd mkdocs2confluence && uv sync
 ```
 
+### GitHub Actions
+
+Add `mk2conf` to any CI/CD pipeline with the official action. Store your Confluence API token as a repository secret (`CONFLUENCE_API_TOKEN`) and add a workflow step:
+
+```yaml
+- name: Publish docs to Confluence
+  uses: jeckyl2010/mkdocs2confluence@v1
+  with:
+    token: ${{ secrets.CONFLUENCE_API_TOKEN }}
+```
+
+**Full example** — publish on every push to `main`:
+
+```yaml
+name: Publish docs
+
+on:
+  push:
+    branches: [main]
+    paths: ['docs/**', 'mkdocs.yml']
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Publish docs to Confluence
+        uses: jeckyl2010/mkdocs2confluence@v1
+        with:
+          token: ${{ secrets.CONFLUENCE_API_TOKEN }}
+          prune: 'true'   # remove pages deleted from nav
+```
+
+**All inputs:**
+
+| Input | Required | Default | Description |
+|---|---|---|---|
+| `token` | ✅ | — | Confluence API token |
+| `config` | | `mkdocs.yml` | Path to mkdocs.yml |
+| `version` | | latest | Pin a specific `mk2conf` version (e.g. `"0.10.3"`) |
+| `dry-run` | | `false` | Print sync plan without publishing |
+| `section` | | — | Publish only a nav section (e.g. `"Guide/Setup"`) |
+| `page` | | — | Publish only a single page (e.g. `"guide/setup.md"`) |
+| `prune` | | `false` | Delete managed pages removed from nav |
+| `quiet` | | `false` | Suppress per-item progress output |
+
 ---
 
 ## Quick start

{mkdocs2confluence-0.10.2 → mkdocs2confluence-0.11.0}/src/mkdocs_to_confluence/transforms/footer.py

@@ -56,7 +56,7 @@ def _last_commit_info(abs_path: str) -> tuple[str, str] | None:
             [
                 "git", "log", "-1",
                 f"--format=%h{sep}%s{sep}%an{sep}%ad",
-                "--date=relative",
+                "--date=short",
                 "--",
                 abs_path,
             ],

{mkdocs2confluence-0.10.2 → mkdocs2confluence-0.11.0}/tests/test_footer.py

@@ -60,14 +60,14 @@ def test_last_commit_info_returns_sha_and_summary(tmp_path):
     fake_file = str(tmp_path / "docs" / "page.md")
     sep = "\x1f"
     with patch("mkdocs_to_confluence.transforms.footer.subprocess.run") as mock_run:
-        mock_run.return_value.stdout = f"abc1234{sep}Fix typo{sep}Jane{sep}2 days ago\n"
+        mock_run.return_value.stdout = f"abc1234{sep}Fix typo{sep}Jane{sep}2024-01-15\n"
         result = _last_commit_info(fake_file)
     assert result is not None
     sha, summary = result
     assert sha == "abc1234"
     assert "Fix typo" in summary
     assert "Jane" in summary
-    assert "2 days ago" in summary
+    assert "2024-01-15" in summary
 
 
 def test_last_commit_info_returns_none_when_empty(tmp_path):
@@ -121,7 +121,7 @@ def test_emit_footer_contains_edit_link():
         history_url="https://github.com/org/repo/commits/main/docs/page.md",
         commit_sha="abc1234",
         commit_url="https://github.com/org/repo/commit/abc1234",
-        commit_summary="Fix typo · Jane · 2 days ago",
+        commit_summary="Fix typo · Jane · 2024-01-15",
     )
     out = emit((footer,))
     assert "Edit this page" in out
@@ -199,7 +199,7 @@ def test_emit_footer_non_ascii_encoded_as_entity():
         history_url=None,
         commit_sha=None,
         commit_url=None,
-        commit_summary="Fix caf\u00e9 · \u00c5ngstr\u00f6m · 2 days ago",
+        commit_summary="Fix caf\u00e9 · \u00c5ngstr\u00f6m · 2024-01-15",
     )
     out = emit((footer,))
     assert "caf\u00e9" not in out