v0.4.4

[bonzo81]

New Features

• Multi-Server Custom Field Support
  • Track device origin per LibreNMS server with a new JSON-based librenms_id custom field.
  • Migration from legacy integer format handled automatically.
• Auto-Create Custom Field
  • The librenms_id custom field is now automatically created via post_migrate signal — no manual setup needed.
• LibreNMS Sync Page Naming Preferences
  • use_sysname and strip_domain settings are now applied to device name matching on sync pages.

Upgrade note

• Remember to run the collectstatic and the migrate command during the update process.

Enhancements

• VC Import Enhancements — Improved stack VC permission enforcement before import.
• Cable Sync Improvements — Match by local_port_id instead of display name; strip stale fields on cable verify POST.
• VM Sync — Skip device_type check for VMs; add sync_platform to VM supported actions.
• Server-Key Propagation — UI polish and view hardening across the multi-server import pipeline.
• Migration Simplification — Always revert to integer; gracefully handle non-integer custom field types.

Security

• URL-encode server_key in redirects to prevent injection (fix: security and correctness hardening (split 2/3 from #246) #254)
• Reject librenms_id <= 0 (fix: security and correctness hardening (split 2/3 from #246) #254)
• CSRF safety improvements (tests: expand test coverage (split 1/3 from #246) #253)
• XSS label escaping in cable verify (fix: cables view per-request interface_name_field, LibreNMSAPIMixin wiring, librenms_id normalization #242)

Fixes

• Fix VC master detection, 0-based position correction, and import propagation (fix: VC master detection, 0-based position correction, and import propagation #257)
• Fix VC verify view crash by using get_librenms_sync_device() in verify views (fix: vc verify views crash when no member has primary_ip #247)
• Fix cables view caching and interface_name_field per-request (fix: cables view per-request interface_name_field, LibreNMSAPIMixin wiring, librenms_id normalization #242)
• Fix import validation, template bugs, and pagination (fix: code quality improvements and bug fixes #259)
• Guard dt_match None on ambiguous hardware match (fix: code quality, security hardening, and test coverage improvements #244)
• Restore multi-key naming preferences and early-exit on missing name (Use naming preferences for device name matching on sync page #248)
• Handle non-integer librenms_id custom field types in migrations (fix(migrations): handle non-integer librenms_id custom field types #256)

Internal / Development

• Expanded test coverage with new test files and reorganized test structure (tests: expand test coverage (split 1/3 from #246) #253)
• Smoke tests, integration tests, and mock LibreNMS server (tests: add smoke tests, integration tests, and mock LibreNMS server #243)
• Add pytest-cov coverage report — no gating (chore: update pre-commit hooks, ruff config, and add uv dependabot #241)
• Updated pre-commit hooks, ruff config, and uv Dependabot (chore: update pre-commit hooks, ruff config, and add uv dependabot #241)
• Bump GitHub Actions: upload-artifact, download-artifact, pypi-publish (chore(deps): bump actions/download-artifact from 8.0.0 to 8.0.1 in the github-actions group #250, chore(deps): bump pypa/gh-action-pypi-publish from 1.13.0 to 1.14.0 in the github-actions group #263, chore(deps): bump actions/upload-artifact from 4.6.2 to 7.0.1 in the github-actions group #265

---

All Changes

• feat: auto-create librenms_id custom field via post_migrate signal by @marcinpsk in feat: auto-create librenms_id custom field via post_migrate signal #221
• refactor: split import_utils.py into a package by @marcinpsk in refactor: split import_utils.py into a package #235
• chore: update pre-commit hooks, ruff config, and add uv dependabot by @marcinpsk in chore: update pre-commit hooks, ruff config, and add uv dependabot #241
• fix: cables view per-request interface_name_field, LibreNMSAPIMixin wiring, librenms_id normalization by @marcinpsk in fix: cables view per-request interface_name_field, LibreNMSAPIMixin wiring, librenms_id normalization #242
• tests: add smoke tests, integration tests, and mock LibreNMS server by @marcinpsk in tests: add smoke tests, integration tests, and mock LibreNMS server #243
• fix: code quality, security hardening, and test coverage improvements by @marcinpsk in fix: code quality, security hardening, and test coverage improvements #244
• feat: multi-server librenms_id — track device origin per LibreNMS server by @marcinpsk in feat: multi-server librenms_id — track device origin per LibreNMS server #245
• fix: vc verify views crash when no member has primary_ip by @bonzo81 in fix: vc verify views crash when no member has primary_ip #247
• Use naming preferences for device name matching on sync page by @bonzo81 in Use naming preferences for device name matching on sync page #248
• chore(deps): bump actions/download-artifact in the github-actions group by @dependabot in chore(deps): bump actions/download-artifact from 8.0.0 to 8.0.1 in the github-actions group #250
• tests: expand test coverage (split 1/3 from fix: multi-server hardening — code correctness, security fixes, and expanded test coverage #246) by @marcinpsk in tests: expand test coverage (split 1/3 from #246) #253
• fix: security and correctness hardening (split 2/3 from fix: multi-server hardening — code correctness, security fixes, and expanded test coverage #246) by @marcinpsk in fix: security and correctness hardening (split 2/3 from #246) #254
• fix: server_key propagation, UI polish, and view hardening (split 3/3 from fix: multi-server hardening — code correctness, security fixes, and expanded test coverage #246) by @marcinpsk in fix: server_key propagation, UI polish, and view hardening (split 3/3 from #246) #255
• fix(migrations): handle non-integer librenms_id custom field types by @marcinpsk in fix(migrations): handle non-integer librenms_id custom field types #256
• fix: VC master detection, 0-based position correction, and import propagation by @bonzo81 in fix: VC master detection, 0-based position correction, and import propagation #257
• refactor(js): extract showModal/hideModal helpers by @marcinpsk in refactor(js): extract showModal/hideModal helpers #258
• fix: code quality improvements and bug fixes by @marcinpsk in fix: code quality improvements and bug fixes #259
• Missing echo in docs - Update README.md by @sorano in Missing echo in docs - Update README.md #262
• chore(deps): bump pypa/gh-action-pypi-publish in the github-actions group by @dependabot in chore(deps): bump pypa/gh-action-pypi-publish from 1.13.0 to 1.14.0 in the github-actions group #263
• chore(deps): bump actions/upload-artifact in the github-actions group by @dependabot in chore(deps): bump actions/upload-artifact from 4.6.2 to 7.0.1 in the github-actions group #265
• docs: update documentation for 0.4.4 release by @bonzo81 in docs: update documentation for 0.4.4 release #267

Contributors

• Thanks @sorano for first contribution in Missing echo in docs - Update README.md #262
• Thanks @marcinpsk for continued improvements and contributions

---

This discussion was created from the release v0.4.4.