feat: license export compatible with NetBox-SLM

When the netbox_slm plugin is installed, the "Lizenzen" section reads
its SoftwareLicense objects automatically:

- Scope matching via installations on devices, VMs or clusters in the
  exported site/location/tenant, plus licenses assigned to the tenant
  and tenant-less licenses of its tenant group (incl. parent groups) or,
  for tenant group exports, of the group and its subgroups.
- One table per manufacturer: license, product/version, type, amount,
  validity incl. renewal interval, status (active, expires in N days,
  expired, lifetime), support, installation target and tenant.
- License keys only with the "include secrets" option.
- Other configured license_sources keep working alongside.

Table cells in HTML/PDF now preserve line breaks.

Bump version to 0.9.0.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-09-24 15:26:45 +02:00
co-authored by Claude Opus 5.5
parent 0cd72824d5
commit 0aa9403cb9
6 changed files with 152 additions and 6 deletions
+126
View File
@@ -0,0 +1,126 @@
"""Lizenzen aus dem Plugin NetBox-SLM (netbox_slm.SoftwareLicense)."""
from datetime import date
from itertools import groupby
from django.apps import apps
from django.db.models import Q
from .blocks import EMPTY, H, T
SOON_DAYS = 90 # „läuft bald ab“, wenn das Ablaufdatum näher liegt
def is_installed():
return apps.is_installed("netbox_slm")
def _tenant_groups(scope):
"""Mandantengruppen, deren mandantenlose Lizenzen zum Scope gehören."""
from tenancy.models import TenantGroup
if scope.kind == "tenantgroup":
return scope.obj.get_descendants(include_self=True)
if scope.kind == "tenant" and scope.obj.group_id:
# Lizenzen der eigenen Gruppe und übergeordneter Gruppen gelten auch für den Mandanten
return scope.obj.group.get_ancestors(include_self=True)
return TenantGroup.objects.none()
def licenses_for_scope(scope):
"""SoftwareLicense-Queryset für den Scope: über Installationen (Gerät/VM/Cluster) und Mandant(engruppe)."""
from virtualization.models import Cluster
SoftwareLicense = apps.get_model("netbox_slm", "SoftwareLicense")
devices = scope.devices()
vms = scope.virtual_machines()
clusters = Cluster.objects.filter(Q(virtual_machines__in=vms) | Q(devices__in=devices)).distinct()
q = (
Q(installation__device__in=devices)
| Q(installation__virtualmachine__in=vms)
| Q(installation__cluster__in=clusters)
)
if scope.tenants is not None:
q |= Q(tenant__in=scope.tenants) | Q(tenant__isnull=True, tenant_group__in=_tenant_groups(scope))
return (
scope.restrict(SoftwareLicense.objects.filter(q).distinct())
.select_related(
"software_product__manufacturer", "version", "tenant", "tenant_group",
"installation__device", "installation__virtualmachine", "installation__cluster",
)
.order_by("software_product__name", "name")
)
def _validity(lic, today):
"""(Laufzeit-Text, Status-Text)."""
if lic.lifetime:
return "unbefristet", "aktiv"
start = lic.start_date.strftime("%d.%m.%Y") if lic.start_date else ""
end = lic.expiration_date.strftime("%d.%m.%Y") if lic.expiration_date else ""
period = f"{start} – {end}" if start and end else (f"bis {end}" if end else (f"ab {start}" if start else EMPTY))
if lic.renewal_interval and lic.renewal_interval_unit:
if lic.renewal_interval == 1:
every = {"days": "täglich", "months": "monatlich", "years": "jährlich"}.get(lic.renewal_interval_unit, "")
else:
unit = {"days": "Tage", "months": "Monate", "years": "Jahre"}.get(lic.renewal_interval_unit, lic.renewal_interval_unit)
every = f"alle {lic.renewal_interval} {unit}"
period += f" (Verlängerung {every})"
if not lic.expiration_date:
return period, "aktiv"
days = (lic.expiration_date - today).days
if days < 0:
return period, "abgelaufen"
if days <= SOON_DAYS:
return period, f"läuft in {days} Tagen ab"
return period, "aktiv"
def _support(value):
return {True: "Ja", False: "Nein"}.get(value, EMPTY)
def _installed_on(lic):
inst = lic.installation
if not inst:
return None
target = inst.device or inst.virtualmachine or inst.cluster
kind = "Gerät" if inst.device_id else ("VM" if inst.virtualmachine_id else "Cluster")
return f"{target} ({kind})" if target else None
def slm_blocks(scope, opts):
"""Tabellen je Hersteller; leer, wenn keine Lizenz zum Scope passt."""
qs = list(licenses_for_scope(scope))
if not qs:
return []
today = date.today()
show_key = bool(opts.get("include_secrets"))
headers = ["Lizenz", "Produkt / Version", "Typ", "Anzahl", "Laufzeit", "Status", "Support", "Installiert auf", "Mandant"]
if show_key:
headers.append("Lizenzschlüssel")
blocks = []
by_manufacturer = sorted(qs, key=lambda lic: (str(lic.software_product.manufacturer or "~"), str(lic.software_product), lic.name))
for manufacturer, items in groupby(by_manufacturer, key=lambda lic: lic.software_product.manufacturer):
rows = []
for lic in items:
period, status = _validity(lic, today)
product = str(lic.software_product) + (f" {lic.version}" if lic.version else "")
row = [
lic.name + (f"\n{lic.description}" if lic.description else ""),
product,
lic.type or lic.spdx_expression,
lic.license_amount,
period,
status,
_support(lic.support),
_installed_on(lic),
lic.tenant or lic.tenant_group,
]
if show_key:
row.append(lic.license_key)
rows.append(row)
blocks.append(H(2, str(manufacturer) if manufacturer else "Ohne Hersteller"))
blocks.append(T(headers, rows))
return blocks