netbox-plugin-dns 0.22.9__py3-none-any.whl → 1.0.0__py3-none-any.whl

netbox_dns/urls/record.py

@@ -0,0 +1,41 @@
+from django.urls import path
+
+from netbox.views.generic import ObjectChangeLogView, ObjectJournalView
+
+from netbox_dns.models import Record
+from netbox_dns.views import (
+    RecordListView,
+    RecordView,
+    RecordEditView,
+    RecordDeleteView,
+    RecordBulkImportView,
+    RecordBulkEditView,
+    RecordBulkDeleteView,
+    ManagedRecordListView,
+)
+
+record_urlpatterns = [
+    path("records/", RecordListView.as_view(), name="record_list"),
+    path("records/add/", RecordEditView.as_view(), name="record_add"),
+    path("records/import/", RecordBulkImportView.as_view(), name="record_import"),
+    path("records/edit/", RecordBulkEditView.as_view(), name="record_bulk_edit"),
+    path("records/delete/", RecordBulkDeleteView.as_view(), name="record_bulk_delete"),
+    path("records/<int:pk>/", RecordView.as_view(), name="record"),
+    path("records/<int:pk>/edit/", RecordEditView.as_view(), name="record_edit"),
+    path("records/<int:pk>/delete/", RecordDeleteView.as_view(), name="record_delete"),
+    path(
+        "records/<int:pk>/journal/",
+        ObjectJournalView.as_view(),
+        name="record_journal",
+        kwargs={"model": Record},
+    ),
+    path(
+        "records/<int:pk>/changelog/",
+        ObjectChangeLogView.as_view(),
+        name="record_changelog",
+        kwargs={"model": Record},
+    ),
+    path(
+        "managedrecords/", ManagedRecordListView.as_view(), name="managed_record_list"
+    ),
+]

netbox_dns/urls/registrar.py

@@ -0,0 +1,63 @@
+from django.urls import path
+
+from netbox.views.generic import ObjectChangeLogView, ObjectJournalView
+
+from netbox_dns.models import Registrar
+from netbox_dns.views import (
+    RegistrarListView,
+    RegistrarView,
+    RegistrarDeleteView,
+    RegistrarEditView,
+    RegistrarBulkImportView,
+    RegistrarBulkEditView,
+    RegistrarBulkDeleteView,
+    RegistrarZoneListView,
+)
+
+registrar_urlpatterns = [
+    path("registrars/", RegistrarListView.as_view(), name="registrar_list"),
+    path("registrars/add/", RegistrarEditView.as_view(), name="registrar_add"),
+    path(
+        "registrars/import/",
+        RegistrarBulkImportView.as_view(),
+        name="registrar_import",
+    ),
+    path(
+        "registrars/edit/",
+        RegistrarBulkEditView.as_view(),
+        name="registrar_bulk_edit",
+    ),
+    path(
+        "registrars/delete/",
+        RegistrarBulkDeleteView.as_view(),
+        name="registrar_bulk_delete",
+    ),
+    path("registrars/<int:pk>/", RegistrarView.as_view(), name="registrar"),
+    path(
+        "registrars/<int:pk>/edit/",
+        RegistrarEditView.as_view(),
+        name="registrar_edit",
+    ),
+    path(
+        "registrars/<int:pk>/delete/",
+        RegistrarDeleteView.as_view(),
+        name="registrar_delete",
+    ),
+    path(
+        "registrars/<int:pk>/zones/",
+        RegistrarZoneListView.as_view(),
+        name="registrar_zones",
+    ),
+    path(
+        "registrars/<int:pk>/journal/",
+        ObjectJournalView.as_view(),
+        name="registrar_journal",
+        kwargs={"model": Registrar},
+    ),
+    path(
+        "registrars/<int:pk>/changelog/",
+        ObjectChangeLogView.as_view(),
+        name="registrar_changelog",
+        kwargs={"model": Registrar},
+    ),
+]

netbox_dns/urls/view.py

@@ -0,0 +1,39 @@
+from django.urls import path
+
+from netbox.views.generic import ObjectChangeLogView, ObjectJournalView
+
+from netbox_dns.models import View
+from netbox_dns.views import (
+    ViewListView,
+    ViewView,
+    ViewDeleteView,
+    ViewEditView,
+    ViewBulkImportView,
+    ViewBulkEditView,
+    ViewBulkDeleteView,
+    ViewZoneListView,
+)
+
+view_urlpatterns = [
+    path("views/", ViewListView.as_view(), name="view_list"),
+    path("views/add/", ViewEditView.as_view(), name="view_add"),
+    path("views/import/", ViewBulkImportView.as_view(), name="view_import"),
+    path("views/edit/", ViewBulkEditView.as_view(), name="view_bulk_edit"),
+    path("views/delete/", ViewBulkDeleteView.as_view(), name="view_bulk_delete"),
+    path("views/<int:pk>/", ViewView.as_view(), name="view"),
+    path("views/<int:pk>/edit/", ViewEditView.as_view(), name="view_edit"),
+    path("views/<int:pk>/delete/", ViewDeleteView.as_view(), name="view_delete"),
+    path("views/<int:pk>/zones/", ViewZoneListView.as_view(), name="view_zones"),
+    path(
+        "views/<int:pk>/journal/",
+        ObjectJournalView.as_view(),
+        name="view_journal",
+        kwargs={"model": View},
+    ),
+    path(
+        "views/<int:pk>/changelog/",
+        ObjectChangeLogView.as_view(),
+        name="view_changelog",
+        kwargs={"model": View},
+    ),
+]

netbox_dns/urls/zone.py

@@ -0,0 +1,57 @@
+from django.urls import path
+
+from netbox.views.generic import ObjectChangeLogView, ObjectJournalView
+
+from netbox_dns.models import Zone
+from netbox_dns.views import (
+    ZoneListView,
+    ZoneView,
+    ZoneDeleteView,
+    ZoneEditView,
+    ZoneBulkImportView,
+    ZoneBulkEditView,
+    ZoneBulkDeleteView,
+    ZoneRecordListView,
+    ZoneManagedRecordListView,
+    ZoneRegistrationView,
+    ZoneRFC2317ChildZoneListView,
+)
+
+zone_urlpatterns = [
+    path("zones/", ZoneListView.as_view(), name="zone_list"),
+    path("zones/add/", ZoneEditView.as_view(), name="zone_add"),
+    path("zones/import/", ZoneBulkImportView.as_view(), name="zone_import"),
+    path("zones/edit/", ZoneBulkEditView.as_view(), name="zone_bulk_edit"),
+    path("zones/delete/", ZoneBulkDeleteView.as_view(), name="zone_bulk_delete"),
+    path("zones/<int:pk>/", ZoneView.as_view(), name="zone"),
+    path("zones/<int:pk>/delete/", ZoneDeleteView.as_view(), name="zone_delete"),
+    path("zones/<int:pk>/edit/", ZoneEditView.as_view(), name="zone_edit"),
+    path("zones/<int:pk>/records/", ZoneRecordListView.as_view(), name="zone_records"),
+    path(
+        "zones/<int:pk>/managedrecords/",
+        ZoneManagedRecordListView.as_view(),
+        name="zone_managed_records",
+    ),
+    path(
+        "zones/<int:pk>/rfc2317childzones/",
+        ZoneRFC2317ChildZoneListView.as_view(),
+        name="zone_rfc2317_child_zones",
+    ),
+    path(
+        "zones/<int:pk>/registration/",
+        ZoneRegistrationView.as_view(),
+        name="zone_registration",
+    ),
+    path(
+        "zones/<int:pk>/journal/",
+        ObjectJournalView.as_view(),
+        name="zone_journal",
+        kwargs={"model": Zone},
+    ),
+    path(
+        "zones/<int:pk>/changelog/",
+        ObjectChangeLogView.as_view(),
+        name="zone_changelog",
+        kwargs={"model": Zone},
+    ),
+]

netbox_dns/utilities/__init__.py

@@ -4,12 +4,7 @@ from dns import name as dns_name
 from dns.exception import DNSException
 from netaddr import IPNetwork, AddrFormatError
 
-try:
-    # NetBox 3.5.0 - 3.5.7, 3.5.9+
-    from extras.plugins import get_plugin_config
-except ImportError:
-    # NetBox 3.5.8
-    from extras.plugins.utils import get_plugin_config
+from netbox.plugins.utils import get_plugin_config
 
 
 class NameFormatError(Exception):

netbox_dns/utilities/ipam_coupling.py

@@ -3,12 +3,7 @@ from utilities.permissions import resolve_permission
 
 from netbox_dns.models import Record, RecordTypeChoices, RecordStatusChoices
 
-try:
-    # NetBox 3.5.0 - 3.5.7, 3.5.9+
-    from extras.plugins import get_plugin_config
-except ImportError:
-    # NetBox 3.5.8
-    from extras.plugins.utils import get_plugin_config
+from netbox.plugins.utils import get_plugin_config
 
 
 class DNSPermissionDenied(Exception):
@@ -69,7 +64,7 @@ def new_address_record(instance):
         status=address_record_status(instance),
         type=address_record_type(instance),
         value=str(instance.address.ip),
-        ipam_ip_address_id=instance.id,
+        ipam_ip_address_id=instance.pk,
         managed=True,
     )
 

netbox_dns/validators/dns_name.py

@@ -2,12 +2,7 @@ import re
 
 from django.core.exceptions import ValidationError
 
-try:
-    # NetBox 3.5.0 - 3.5.7, 3.5.9+
-    from extras.plugins import get_plugin_config
-except ImportError:
-    # NetBox 3.5.8
-    from extras.plugins.utils import get_plugin_config
+from netbox.plugins.utils import get_plugin_config
 
 LABEL = r"[a-z0-9][a-z0-9-]*(?<!-)"
 TOLERANT_LABEL = r"[a-z0-9][a-z0-9-_]*(?<![-_])"
@@ -26,7 +21,7 @@ def validate_fqdn(name):
         regex = rf"^(\*|{LABEL})(\.{LABEL})+\.?$"
 
     if not re.match(regex, name, flags=re.IGNORECASE) or has_invalid_double_dash(name):
-        raise ValidationError(f"Not a valid fully qualified DNS host name")
+        raise ValidationError("Not a valid fully qualified DNS host name")
 
 
 def validate_extended_hostname(name, tolerate_leading_underscores=False):
@@ -41,7 +36,7 @@ def validate_extended_hostname(name, tolerate_leading_underscores=False):
         regex = rf"^([*@]|(\*\.)?{LABEL}(\.{LABEL})*\.?)$"
 
     if not re.match(regex, name, flags=re.IGNORECASE) or has_invalid_double_dash(name):
-        raise ValidationError(f"Not a valid DNS host name")
+        raise ValidationError("Not a valid DNS host name")
 
 
 def validate_domain_name(name):
@@ -54,4 +49,4 @@ def validate_domain_name(name):
         regex = rf"^{LABEL}(\.{LABEL})*\.?$"
 
     if not re.match(regex, name, flags=re.IGNORECASE) or has_invalid_double_dash(name):
-        raise ValidationError(f"Not a valid DNS domain name")
+        raise ValidationError("Not a valid DNS domain name")

netbox_dns/validators/rfc2317.py

@@ -10,9 +10,9 @@ def validate_prefix(prefix):
 
 def validate_ipv4(prefix):
     if prefix.version != 4:
-        raise ValidationError(f"RFC2317 requires an IPv4 prefix.")
+        raise ValidationError("RFC2317 requires an IPv4 prefix.")
 
 
 def validate_rfc2317(prefix):
     if prefix.prefixlen <= 24:
-        raise ValidationError(f"RFC2317 requires at least 25 bit prefix length.")
+        raise ValidationError("RFC2317 requires at least 25 bit prefix length.")

netbox_dns/views/contact.py

@@ -5,7 +5,7 @@ from netbox.views import generic
 from utilities.views import ViewTab, register_model_view
 
 from netbox_dns.models import Contact, Zone
-from netbox_dns.filters import ContactFilter, ZoneFilter
+from netbox_dns.filtersets import ContactFilterSet, ZoneFilterSet
 from netbox_dns.forms import (
     ContactForm,
     ContactFilterForm,
@@ -22,7 +22,7 @@ class ContactView(generic.ObjectView):
 class ContactListView(generic.ObjectListView):
     queryset = Contact.objects.all()
     table = ContactTable
-    filterset = ContactFilter
+    filterset = ContactFilterSet
     filterset_form = ContactFilterForm
 
 
@@ -46,7 +46,7 @@ class ContactBulkImportView(generic.BulkImportView):
 
 class ContactBulkEditView(generic.BulkEditView):
     queryset = Contact.objects.all()
-    filterset = ContactFilter
+    filterset = ContactFilterSet
     table = ContactTable
     form = ContactBulkEditForm
 
@@ -63,7 +63,7 @@ class ContactZoneListView(generic.ObjectChildrenView):
     )
     child_model = Zone
     table = ZoneTable
-    filterset = ZoneFilter
+    filterset = ZoneFilterSet
     template_name = "netbox_dns/zone/child.html"
     hide_if_empty = True
 

netbox_dns/views/nameserver.py

@@ -3,7 +3,7 @@ from dns import name as dns_name
 from netbox.views import generic
 from utilities.views import ViewTab, register_model_view
 
-from netbox_dns.filters import NameServerFilter, ZoneFilter
+from netbox_dns.filtersets import NameServerFilterSet, ZoneFilterSet
 from netbox_dns.forms import (
     NameServerImportForm,
     NameServerFilterForm,
@@ -16,7 +16,7 @@ from netbox_dns.tables import NameServerTable, ZoneTable
 
 class NameServerListView(generic.ObjectListView):
     queryset = NameServer.objects.all()
-    filterset = NameServerFilter
+    filterset = NameServerFilterSet
     filterset_form = NameServerFilterForm
     table = NameServerTable
 
@@ -54,7 +54,7 @@ class NameServerBulkImportView(generic.BulkImportView):
 
 class NameServerBulkEditView(generic.BulkEditView):
     queryset = NameServer.objects.all()
-    filterset = NameServerFilter
+    filterset = NameServerFilterSet
     table = NameServerTable
     form = NameServerBulkEditForm
 
@@ -69,7 +69,7 @@ class NameServerZoneListView(generic.ObjectChildrenView):
     queryset = NameServer.objects.all().prefetch_related("zones")
     child_model = Zone
     table = ZoneTable
-    filterset = ZoneFilter
+    filterset = ZoneFilterSet
     template_name = "netbox_dns/zone/child.html"
     hide_if_empty = True
 
@@ -89,7 +89,7 @@ class NameServerSOAZoneListView(generic.ObjectChildrenView):
     queryset = NameServer.objects.all().prefetch_related("zones_soa")
     child_model = Zone
     table = ZoneTable
-    filterset = ZoneFilter
+    filterset = ZoneFilterSet
     template_name = "netbox_dns/zone/child.html"
     hide_if_empty = True
 

netbox_dns/views/record.py

@@ -1,11 +1,8 @@
 from dns import name as dns_name
 
-from django.db.models import Q
-from django.db.models.functions import Length
-
 from netbox.views import generic
 
-from netbox_dns.filters import RecordFilter
+from netbox_dns.filtersets import RecordFilterSet
 from netbox_dns.forms import (
     RecordImportForm,
     RecordFilterForm,
@@ -21,7 +18,7 @@ class RecordListView(generic.ObjectListView):
     queryset = Record.objects.filter(managed=False).prefetch_related(
         "zone", "ptr_record"
     )
-    filterset = RecordFilter
+    filterset = RecordFilterSet
     filterset_form = RecordFilterForm
     table = RecordTable
 
@@ -30,10 +27,10 @@ class ManagedRecordListView(generic.ObjectListView):
     queryset = Record.objects.filter(managed=True).prefetch_related(
         "zone", "address_record"
     )
-    filterset = RecordFilter
+    filterset = RecordFilterSet
     filterset_form = RecordFilterForm
     table = ManagedRecordTable
-    actions = ("export",)
+    actions = {"export": {"view"}}
     template_name = "netbox_dns/record/managed.html"
 
 
@@ -41,15 +38,11 @@ class RecordView(generic.ObjectView):
     queryset = Record.objects.all().prefetch_related("zone", "ptr_record")
 
     def get_value_records(self, instance):
-        view_filter = (
-            Q(zone__view__isnull=True)
-            if instance.zone.view is None
-            else Q(zone__view=instance.zone.view)
-        )
-
         value_fqdn = dns_name.from_text(instance.value_fqdn)
 
-        cname_targets = Record.objects.filter(view_filter, fqdn=value_fqdn)
+        cname_targets = Record.objects.filter(
+            zone__view=instance.zone.view, fqdn=value_fqdn
+        )
 
         if cname_targets:
             return RelatedRecordTable(
@@ -59,14 +52,11 @@ class RecordView(generic.ObjectView):
         return None
 
     def get_cname_records(self, instance):
-        view_filter = (
-            Q(zone__view__isnull=True)
-            if instance.zone.view is None
-            else Q(zone__view=instance.zone.view)
-        )
         cname_records = set(
             Record.objects.filter(
-                view_filter, value=instance.fqdn, type=RecordTypeChoices.CNAME
+                zone__view=instance.zone.view,
+                value=instance.fqdn,
+                type=RecordTypeChoices.CNAME,
             )
         )
 
@@ -77,12 +67,14 @@ class RecordView(generic.ObjectView):
         ]
 
         parent_zones = Zone.objects.filter(
-            instance.zone.view_filter, name__in=parent_zone_names
+            view=instance.zone.view, name__in=parent_zone_names
         )
 
         for parent_zone in parent_zones:
             parent_cname_records = Record.objects.filter(
-                view_filter, type=RecordTypeChoices.CNAME, zone=parent_zone
+                zone__view=instance.zone.view,
+                type=RecordTypeChoices.CNAME,
+                zone=parent_zone,
             )
             cname_records = cname_records.union(
                 set(
@@ -142,7 +134,7 @@ class RecordBulkImportView(generic.BulkImportView):
 
 class RecordBulkEditView(generic.BulkEditView):
     queryset = Record.objects.filter(managed=False).prefetch_related("zone")
-    filterset = RecordFilter
+    filterset = RecordFilterSet
     table = RecordTable
     form = RecordBulkEditForm
 

netbox_dns/views/registrar.py

@@ -3,7 +3,7 @@ from netbox.views import generic
 from utilities.views import ViewTab, register_model_view
 
 from netbox_dns.models import Registrar, Zone
-from netbox_dns.filters import RegistrarFilter, ZoneFilter
+from netbox_dns.filtersets import RegistrarFilterSet, ZoneFilterSet
 from netbox_dns.forms import (
     RegistrarForm,
     RegistrarFilterForm,
@@ -20,7 +20,7 @@ class RegistrarView(generic.ObjectView):
 class RegistrarListView(generic.ObjectListView):
     queryset = Registrar.objects.all()
     table = RegistrarTable
-    filterset = RegistrarFilter
+    filterset = RegistrarFilterSet
     filterset_form = RegistrarFilterForm
 
 
@@ -44,7 +44,7 @@ class RegistrarBulkImportView(generic.BulkImportView):
 
 class RegistrarBulkEditView(generic.BulkEditView):
     queryset = Registrar.objects.all()
-    filterset = RegistrarFilter
+    filterset = RegistrarFilterSet
     table = RegistrarTable
     form = RegistrarBulkEditForm
 
@@ -59,7 +59,7 @@ class RegistrarZoneListView(generic.ObjectChildrenView):
     queryset = Registrar.objects.all().prefetch_related("zone_set")
     child_model = Zone
     table = ZoneTable
-    filterset = ZoneFilter
+    filterset = ZoneFilterSet
     template_name = "netbox_dns/zone/child.html"
     hide_if_empty = True
 

netbox_dns/views/view.py

@@ -3,7 +3,7 @@ from utilities.views import ViewTab, register_model_view
 from netbox.views import generic
 
 from netbox_dns.models import View, Zone
-from netbox_dns.filters import ViewFilter, ZoneFilter
+from netbox_dns.filtersets import ViewFilterSet, ZoneFilterSet
 from netbox_dns.forms import ViewForm, ViewFilterForm, ViewImportForm, ViewBulkEditForm
 from netbox_dns.tables import ViewTable, ZoneTable
 
@@ -15,7 +15,7 @@ class ViewView(generic.ObjectView):
 class ViewListView(generic.ObjectListView):
     queryset = View.objects.all()
     table = ViewTable
-    filterset = ViewFilter
+    filterset = ViewFilterSet
     filterset_form = ViewFilterForm
 
 
@@ -39,7 +39,7 @@ class ViewBulkImportView(generic.BulkImportView):
 
 class ViewBulkEditView(generic.BulkEditView):
     queryset = View.objects.all()
-    filterset = ViewFilter
+    filterset = ViewFilterSet
     table = ViewTable
     form = ViewBulkEditForm
 
@@ -54,7 +54,7 @@ class ViewZoneListView(generic.ObjectChildrenView):
     queryset = View.objects.all().prefetch_related("zone_set")
     child_model = Zone
     table = ZoneTable
-    filterset = ZoneFilter
+    filterset = ZoneFilterSet
     template_name = "netbox_dns/zone/child.html"
     hide_if_empty = True
 

netbox_dns/views/zone.py

@@ -3,7 +3,7 @@ from dns import name as dns_name
 from netbox.views import generic
 from utilities.views import ViewTab, register_model_view
 
-from netbox_dns.filters import ZoneFilter, RecordFilter
+from netbox_dns.filtersets import ZoneFilterSet, RecordFilterSet
 from netbox_dns.forms import (
     ZoneImportForm,
     ZoneForm,
@@ -20,7 +20,7 @@ from netbox_dns.tables import (
 
 class ZoneListView(generic.ObjectListView):
     queryset = Zone.objects.all().prefetch_related("view", "tags")
-    filterset = ZoneFilter
+    filterset = ZoneFilterSet
     filterset_form = ZoneFilterForm
     table = ZoneTable
 
@@ -75,7 +75,7 @@ class ZoneBulkEditView(generic.BulkEditView):
     queryset = Zone.objects.all().prefetch_related(
         "view", "tags", "nameservers", "soa_mname"
     )
-    filterset = ZoneFilter
+    filterset = ZoneFilterSet
     table = ZoneTable
     form = ZoneBulkEditForm
     default_return_url = "plugins:netbox_dns:zone_list"
@@ -109,7 +109,7 @@ class ZoneRecordListView(generic.ObjectChildrenView):
     queryset = Zone.objects.all()
     child_model = Record
     table = RecordTable
-    filterset = RecordFilter
+    filterset = RecordFilterSet
     template_name = "netbox_dns/zone/record.html"
     hide_if_empty = True
 
@@ -131,9 +131,9 @@ class ZoneManagedRecordListView(generic.ObjectChildrenView):
     queryset = Zone.objects.all()
     child_model = Record
     table = ManagedRecordTable
-    filterset = RecordFilter
+    filterset = RecordFilterSet
     template_name = "netbox_dns/zone/managed_record.html"
-    actions = ("changelog",)
+    actions = {"changelog": {"view"}}
 
     tab = ViewTab(
         label="Managed Records",
@@ -153,9 +153,8 @@ class ZoneRFC2317ChildZoneListView(generic.ObjectChildrenView):
     queryset = Zone.objects.all()
     child_model = Zone
     table = ZoneTable
-    filterset = ZoneFilter
+    filterset = ZoneFilterSet
     template_name = "netbox_dns/zone/rfc2317_child_zone.html"
-    actions = ("changelog",)
 
     tab = ViewTab(
         label="RFC2317 Child Zones",

{netbox_plugin_dns-0.22.9.dist-info → netbox_plugin_dns-1.0.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: netbox-plugin-dns
-Version: 0.22.9
+Version: 1.0.0
 Summary: NetBox DNS is a NetBox plugin for managing DNS data.
 Home-page: https://github.com/peteeckel/netbox-plugin-dns
 License: MIT
@@ -21,7 +21,7 @@ Project-URL: Repository, https://github.com/peteeckel/netbox-plugin-dns
 Description-Content-Type: text/markdown
 
 # NetBox DNS
-The NetBox DNS plugin enables NetBox to manage operational DNS data such as name servers, zones, records and views, as well as registration data for domains. It can automate tasks like creating PTR records, generating zone serial numbers, NS and SOA records, as well as validate names and values values for resource records to ensure zone data is consistent, current and conforming to the relevant RFCs.
+The NetBox DNS plugin enables NetBox to manage operational DNS data such as name servers, zones, records and views, as well as registration data for domains. It can automate tasks like creating PTR records, generating zone serial numbers, NS and SOA records, as well as validate names and values values for resource records to ensure zone data is consistent, up-to-date and compliant with to the relevant RFCs.
 
 <div align="center">
 <a href="https://pypi.org/project/netbox-plugin-dns/"><img src="https://img.shields.io/pypi/v/netbox-plugin-dns" alt="PyPi"/></a>
@@ -36,21 +36,35 @@ The NetBox DNS plugin enables NetBox to manage operational DNS data such as name
 <a href="https://pepy.tech/project/netbox-plugin-dns"><img alt="Downloads/Month" src="https://static.pepy.tech/badge/netbox-plugin-dns/week"></a>
 </div>
 
-## Features
+## Objectives
+NetBox DNS is designed to be the 'DNS Source of Truth' analogous to NetBox being the 'Network Source of Truth'.
 
-* Manage name servers, zones and records
-* Automatically generate SOA and NS records for zones
-* Automatically create and update PTR records for IPv4 and IPv6 address records
-* Organize DNS zones in views for split horizon DNS and multi-site deployments
-* Manage domain registrar and registrant information for domains related to zones
-* Manage RFC2317 reverse zones for IPv4 prefixes with a network mask length longer than 24 bits
+The plugin stores information about DNS name servers, DNS views and zones, and DNS records, making it a data source for automatic provisioning of DNS instances. Registration information about DNS registrars and contacts for DNS domains can also be stored and associated with zones.
 
-NetBox DNS is using the standardized NetBox plugin interface, so it also takes advantage of the NetBox tagging and change log features.
+The main focus of the plugin is to ensure the quality of the data stored in it. To achieve this, there are many validation and automation mechanisms in place:
+
+* Validation of record names and values
+* Automatic maintenance of PTR records for IPv6 and IPv4 address records
+* Automatic generation of SOA records, optionally including the serial number of the zone data
+* Validation of record types such as CNAME and singletons, to ensure DNS zone validity
+* Support for [RFC 2317](https://datatracker.ietf.org/doc/html/rfc2317) delegation of PTR zones for IPv4 subnets longer than 24 bits
+
+Other main features include:
+
+* Support for BIND views, providing lightweight namespaces for zones
+* Support for IDN, including the validation of punycode names
+* Full support for the NetBox REST and GraphQL APIs
+* Support for all major NetBox features such as global search, tenancy, change logs, tagging, journaling etc.
+
+## Non-objectives
+In the same way as NetBox is not a network management application, NetBox DNS does not provide any functionality to manage specific name servers or DNS service providers or to generate input such as configuration and zone files for them. The focus is on the completeness and integrity of the data needed to run DNS zones, not on the peculiarities of a plethora of servers and services that actually use the data. This functionality is left to specialized integration tools, or in many cases it can be easily implemented using Ansible or similar tools based on NetBox DNS data. Example code for some simple use cases is provided.
+
+For integration with a large number of DNS server implementations integration tools like [octodns-netbox-dns](https://pypi.org/project/octodns-netbox-dns/) are available.
 
 ## Requirements
 
-* NetBox 3.5.0 or higher
-* Python 3.8 or higher
+* NetBox 4.0.0 or higher
+* Python 3.10 or higher
 
 ## Installation & Configuration
 
@@ -87,7 +101,7 @@ Full documentation on using plugins with NetBox: [Using Plugins - NetBox Documen
 
 ## Contribute
 
-Contributions are always welcome! Please see: [contributing guide](CONTRIBUTING.md)
+Contributions are always welcome! Please see the [Contribution Guidelines](CONTRIBUTING.md)
 
 ## Documentation