unifi-network-maps 1.4.2__tar.gz → 1.4.4__tar.gz

{unifi_network_maps-1.4.2 → unifi_network_maps-1.4.4}/CHANGELOG.md

@@ -2,7 +2,12 @@
 
 All notable changes to this project will be documented in this file.
 
-## v1.4.2 (unreleased)
+## v1.4.4 - (2026-01-10)
+- Improved dark theme Mermaid readability (labels + link borders).
+- Fixed MkDocs sidebar legend duplication with dual-theme output.
+- Added smoke tests for dual-theme MkDocs sidebar legend output.
+
+## v1.4.2 - 2026-01-10
 - Added static code analysis and stricter type-checking
 - Added contract tests for UniFi API wrapper with fixture-based validation.
 - Added optional live UniFi contract tests (gated by `UNIFI_CONTRACT_LIVE=1`).
@@ -19,10 +24,10 @@ All notable changes to this project will be documented in this file.
 - Added optional UniFi API request timeouts via `UNIFI_REQUEST_TIMEOUT_SECONDS`.
 - Made `--output` writes atomic to avoid partial files on interruption.
 
-## v1.4.1
+## v1.4.1 - 2026-01-06
 - pip install was broken, fixed.
 
-## v1.4.0
+## v1.4.0 - 2026-01-06
 - Added MkDocs output, which includes gateway/switch details and per-port tables.
 - Port tables show speed, PoE status, power, and wired clients per port.
 - Added compact legend with sidebar injection (`--mkdocs-sidebar-legend`).
@@ -35,14 +40,14 @@ All notable changes to this project will be documented in this file.
 - Added Faker-powered `--generate-mock` for deterministic mock fixtures (dev-only).
 - Added mock fixtures + SVG/Mermaid examples, with mock smoketest/CI steps.
 
-## v1.3.1
+## v1.3.1 - 2026-01-04
 - Added `lldp-md` output with per-device details tables and optional client sections.
 - Added `--client-scope wired|wireless|all` and dashed wireless client links in Mermaid/SVG.
 - Expanded smoketest outputs for wireless/all client scopes and LLDP markdown.
 - Fixed SVG icon loading paths after package reorg.
 - Tuned isometric port label placement on front tiles.
 
-## v1.3.0
+## v1.3.0 - 2026-01-04
 - Reorganized package into submodules (`adapters/`, `model/`, `render/`, `io/`, `cli/`).
 - YAML-based theming with default + dark themes and `--theme-file`.
 - CLI help now grouped by category; CLI logic split into focused helpers.
@@ -51,13 +56,13 @@ All notable changes to this project will be documented in this file.
 - Added PoE/edge/device count logging and improved label ordering helpers.
 - Coverage excludes asset packages; docs updated (options/groups + AI disclosure).
 
-## v1.2.4
+## v1.2.4 - 2026-01-03
 - Added typed `UplinkInfo`/`PortInfo` and uplink fallback for LLDP gaps.
 - Deterministic edge ordering for repeatable output.
 - CI publish workflow (trusted publishing) and release docs.
 - Project metadata and packaging updated for OSS readiness.
 
-## v1.1.0
+## v1.1.0 - 2026-01-03
 - Added isometric SVG output with grid-aligned links and isometric icon set.
 - Improved port label placement and client labeling in SVG outputs.
 - Added smoketest target with multiple outputs (ports/clients/legend).
@@ -65,14 +70,14 @@ All notable changes to this project will be documented in this file.
 - Fixed Mermaid legend/grouped output parsing errors.
 - Refined visuals: link gradients, tile gradients, icon placement tweaks.
 
-## v1.0.0
+## v1.0.0 - 2025-12-30
 - Mermaid legend can render as a separate graph.
 - Straight Mermaid links with node type coloring.
 - Added wired client leaf nodes and uplink port labels.
 - Expanded PoE detection tests and LLDP helpers.
 - CLI loads `.env` automatically.
 
-## v0.2.0
+## v0.2.0 - 2026-01-02 - Initial public release
 - Added versioning workflow and bump tooling.
 - Introduced SVG renderer and tree layout fixes.
 - Increased test coverage and added coverage tooling.

{unifi_network_maps-1.4.2 → unifi_network_maps-1.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: unifi-network-maps
-Version: 1.4.2
+Version: 1.4.4
 Summary: Dynamic UniFi -> network maps in mermaid or svg
 Author: Merlijn
 License-Expression: MIT

{unifi_network_maps-1.4.2 → unifi_network_maps-1.4.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "unifi-network-maps"
-version = "1.4.2"
+version = "1.4.4"
 description = "Dynamic UniFi -> network maps in mermaid or svg"
 readme = "README.md"
 requires-python = ">=3.13"

unifi_network_maps-1.4.4/src/unifi_network_maps/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.4.4"

{unifi_network_maps-1.4.2 → unifi_network_maps-1.4.4}/src/unifi_network_maps/assets/themes/dark.yaml

@@ -15,6 +15,9 @@ mermaid:
     other:
       fill: "#2a2a2a"
       stroke: "#9e9e9e"
+  node_text: "#f5f5f5"
+  edge_label_border: "#e6e6e6"
+  edge_label_border_width: 2
   poe_link: "#64b5f6"
   poe_link_width: 2
   poe_link_arrow: "none"

{unifi_network_maps-1.4.2 → unifi_network_maps-1.4.4}/src/unifi_network_maps/cli/main.py

@@ -507,9 +507,9 @@ def _write_mkdocs_sidebar_assets(output_path: str) -> None:
     (assets_dir / "legend.js").write_text(
         (
             'document.addEventListener("DOMContentLoaded", () => {\n'
-            '  const legend = document.querySelector("[data-unifi-legend]");\n'
+            '  const legends = document.querySelectorAll("[data-unifi-legend]");\n'
             '  const sidebar = document.querySelector(".md-sidebar--secondary .md-sidebar__scrollwrap");\n'
-            "  if (!legend || !sidebar) {\n"
+            "  if (!legends.length || !sidebar) {\n"
             "    return;\n"
             "  }\n"
             '  const wrapper = document.createElement("div");\n'
@@ -518,17 +518,22 @@ def _write_mkdocs_sidebar_assets(output_path: str) -> None:
             '  title.className = "unifi-legend-title";\n'
             '  title.textContent = "Legend";\n'
             "  wrapper.appendChild(title);\n"
-            "  wrapper.appendChild(legend.cloneNode(true));\n"
+            "  legends.forEach((legend) => {\n"
+            "    wrapper.appendChild(legend.cloneNode(true));\n"
+            '    legend.classList.add("unifi-legend-hidden");\n'
+            "  });\n"
             "  sidebar.appendChild(wrapper);\n"
-            '  legend.classList.add("unifi-legend-hidden");\n'
             "});\n"
         ),
         encoding="utf-8",
     )
     (assets_dir / "legend.css").write_text(
         (
-            ".unifi-legend-hidden {\n"
-            "  display: none;\n"
+            ".unifi-legend-hidden,\n"
+            ".unifi-legend-hidden.unifi-legend,\n"
+            ".unifi-legend-hidden.unifi-legend--light,\n"
+            ".unifi-legend-hidden.unifi-legend--dark {\n"
+            "  display: none !important;\n"
             "}\n\n"
             ".unifi-legend-sidebar {\n"
             "  margin-top: 1rem;\n"

{unifi_network_maps-1.4.2 → unifi_network_maps-1.4.4}/src/unifi_network_maps/render/mermaid.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import json
 from collections.abc import Iterable
 
 from ..model.topology import Edge
@@ -163,7 +164,15 @@ def render_mermaid(
 ) -> str:
     edge_list = list(edges)
     id_map = _build_id_map(edge_list, _group_nodes(groups))
-    lines = [f"graph {direction}"]
+    theme_vars: dict[str, object] = {}
+    if theme.edge_label_border:
+        theme_vars["edgeLabelBorderColor"] = theme.edge_label_border
+    if theme.edge_label_border_width:
+        theme_vars["edgeLabelBorderWidth"] = theme.edge_label_border_width
+    lines = []
+    if theme_vars:
+        lines.append(f'%%{{init: {{"themeVariables": {json.dumps(theme_vars)}}}}}%%')
+    lines.append(f"graph {direction}")
     if groups:
         _render_group_sections(lines, groups, group_order=group_order, id_map=id_map)
     use_node_labels = not groups

{unifi_network_maps-1.4.2 → unifi_network_maps-1.4.4}/src/unifi_network_maps/render/mermaid_theme.py

@@ -18,6 +18,9 @@ class MermaidTheme:
     standard_link: str
     standard_link_width: int
     standard_link_arrow: str
+    node_text: str | None = None
+    edge_label_border: str | None = None
+    edge_label_border_width: int | None = None
 
 
 DEFAULT_THEME = MermaidTheme(
@@ -32,15 +35,22 @@ DEFAULT_THEME = MermaidTheme(
     standard_link="#2ecc71",
     standard_link_width=2,
     standard_link_arrow="none",
+    node_text=None,
+    edge_label_border=None,
+    edge_label_border_width=None,
 )
 
 
 def class_defs(theme: MermaidTheme = DEFAULT_THEME) -> list[str]:
+    def node_def(name: str, fill: str, stroke: str) -> str:
+        color = f",color:{theme.node_text}" if theme.node_text else ""
+        return f"  classDef {name} fill:{fill},stroke:{stroke},stroke-width:1px{color};"
+
     return [
-        f"  classDef node_gateway fill:{theme.node_gateway[0]},stroke:{theme.node_gateway[1]},stroke-width:1px;",
-        f"  classDef node_switch fill:{theme.node_switch[0]},stroke:{theme.node_switch[1]},stroke-width:1px;",
-        f"  classDef node_ap fill:{theme.node_ap[0]},stroke:{theme.node_ap[1]},stroke-width:1px;",
-        f"  classDef node_client fill:{theme.node_client[0]},stroke:{theme.node_client[1]},stroke-width:1px;",
-        f"  classDef node_other fill:{theme.node_other[0]},stroke:{theme.node_other[1]},stroke-width:1px;",
+        node_def("node_gateway", theme.node_gateway[0], theme.node_gateway[1]),
+        node_def("node_switch", theme.node_switch[0], theme.node_switch[1]),
+        node_def("node_ap", theme.node_ap[0], theme.node_ap[1]),
+        node_def("node_client", theme.node_client[0], theme.node_client[1]),
+        node_def("node_other", theme.node_other[0], theme.node_other[1]),
         "  classDef node_legend font-size:10px;",
     ]

{unifi_network_maps-1.4.2 → unifi_network_maps-1.4.4}/src/unifi_network_maps/render/theme.py

@@ -29,6 +29,18 @@ def _coerce_color(value: object, default: str) -> str:
     return value if isinstance(value, str) else default
 
 
+def _coerce_optional_color(value: object, default: str | None) -> str | None:
+    return value if isinstance(value, str) else default
+
+
+def _coerce_optional_int(value: object, default: int | None) -> int | None:
+    if isinstance(value, int):
+        return value
+    if isinstance(value, float):
+        return int(value)
+    return default
+
+
 def _mermaid_theme_from_dict(data: dict, base: MermaidTheme) -> MermaidTheme:
     nodes = data.get("nodes", {}) if isinstance(data.get("nodes"), dict) else {}
 
@@ -52,6 +64,13 @@ def _mermaid_theme_from_dict(data: dict, base: MermaidTheme) -> MermaidTheme:
         standard_link_arrow=_coerce_color(
             data.get("standard_link_arrow"), base.standard_link_arrow
         ),
+        node_text=_coerce_optional_color(data.get("node_text"), base.node_text),
+        edge_label_border=_coerce_optional_color(
+            data.get("edge_label_border"), base.edge_label_border
+        ),
+        edge_label_border_width=_coerce_optional_int(
+            data.get("edge_label_border_width"), base.edge_label_border_width
+        ),
     )
 
 

{unifi_network_maps-1.4.2 → unifi_network_maps-1.4.4}/src/unifi_network_maps.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: unifi-network-maps
-Version: 1.4.2
+Version: 1.4.4
 Summary: Dynamic UniFi -> network maps in mermaid or svg
 Author: Merlijn
 License-Expression: MIT

unifi_network_maps-1.4.2/src/unifi_network_maps/__init__.py

@@ -1 +0,0 @@
-__version__ = "1.4.2"