netbox-plugin-dns 0.22.3__tar.gz → 0.22.5__tar.gz

{netbox_plugin_dns-0.22.3 → netbox_plugin_dns-0.22.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: netbox-plugin-dns
-Version: 0.22.3
+Version: 0.22.5
 Summary: NetBox DNS is a NetBox plugin for managing DNS data.
 Home-page: https://github.com/peteeckel/netbox-plugin-dns
 License: MIT
@@ -8,6 +8,7 @@ Keywords: netbox,netbox-plugin,dns
 Author: Peter Eckel
 Author-email: pete@netbox-dns.org
 Requires-Python: >=3.8,<4.0
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.8
@@ -19,28 +20,30 @@ Requires-Dist: dnspython (>=2.2.1,<3.0.0)
 Project-URL: Repository, https://github.com/peteeckel/netbox-plugin-dns
 Description-Content-Type: text/markdown
 
-<h1 align="center">NetBox DNS</h1>
-
-<p align="center"><i>NetBox DNS is a NetBox plugin for managing DNS views, zones, name servers and records.</i></p>
+# 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.
 
 <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>
-<a href="https://github.com/peteeckel/netbox-plugin-dns/stargazers"><img src="https://img.shields.io/github/stars/peteeckel/netbox-plugin-dns" alt="Stars Badge"/></a>
-<a href="https://github.com/peteeckel/netbox-plugin-dns/network/members"><img src="https://img.shields.io/github/forks/peteeckel/netbox-plugin-dns" alt="Forks Badge"/></a>
-<a href="https://github.com/peteeckel/netbox-plugin-dns/pulls"><img src="https://img.shields.io/github/issues-pr/peteeckel/netbox-plugin-dns" alt="Pull Requests Badge"/></a>
+<a href="https://github.com/peteeckel/netbox-plugin-dns/stargazers"><img src="https://img.shields.io/github/stars/peteeckel/netbox-plugin-dns?style=flat" alt="Stars Badge"/></a>
+<a href="https://github.com/peteeckel/netbox-plugin-dns/network/members"><img src="https://img.shields.io/github/forks/peteeckel/netbox-plugin-dns?style=flat" alt="Forks Badge"/></a>
 <a href="https://github.com/peteeckel/netbox-plugin-dns/issues"><img src="https://img.shields.io/github/issues/peteeckel/netbox-plugin-dns" alt="Issues Badge"/></a>
+<a href="https://github.com/peteeckel/netbox-plugin-dns/pulls"><img src="https://img.shields.io/github/issues-pr/peteeckel/netbox-plugin-dns" alt="Pull Requests Badge"/></a>
 <a href="https://github.com/peteeckel/netbox-plugin-dns/graphs/contributors"><img alt="GitHub contributors" src="https://img.shields.io/github/contributors/peteeckel/netbox-plugin-dns?color=2b9348"></a>
 <a href="https://github.com/peteeckel/netbox-plugin-dns/blob/master/LICENSE"><img src="https://img.shields.io/github/license/peteeckel/netbox-plugin-dns?color=2b9348" alt="License Badge"/></a>
+<a href="https://pepy.tech/project/netbox-plugin-dns"><img alt="Downloads" src="https://static.pepy.tech/badge/netbox-plugin-dns"></a>
+<a href="https://pepy.tech/project/netbox-plugin-dns"><img alt="Downloads/Week" src="https://static.pepy.tech/badge/netbox-plugin-dns/month"></a>
+<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
 
 * Manage name servers, zones and records
 * Automatically generate SOA and NS records for zones
-* Automatically create and update PTR records for IPv4 and IPv6 records
-* Optionally organize DNS zones in views for split horizon DNS and multi-site deployments
-* Optionally maintain domain registrar and registrant information for zones
-* Maintain RFC2317 reverse zones for IPv4 prefixes with a network mask length longer than 24 bits
+* 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
 
 NetBox DNS is using the standardized NetBox plugin interface, so it also takes advantage of the NetBox tagging and change log features.
 

{netbox_plugin_dns-0.22.3 → netbox_plugin_dns-0.22.5}/README.md

@@ -1,25 +1,27 @@
-<h1 align="center">NetBox DNS</h1>
-
-<p align="center"><i>NetBox DNS is a NetBox plugin for managing DNS views, zones, name servers and records.</i></p>
+# 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.
 
 <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>
-<a href="https://github.com/peteeckel/netbox-plugin-dns/stargazers"><img src="https://img.shields.io/github/stars/peteeckel/netbox-plugin-dns" alt="Stars Badge"/></a>
-<a href="https://github.com/peteeckel/netbox-plugin-dns/network/members"><img src="https://img.shields.io/github/forks/peteeckel/netbox-plugin-dns" alt="Forks Badge"/></a>
-<a href="https://github.com/peteeckel/netbox-plugin-dns/pulls"><img src="https://img.shields.io/github/issues-pr/peteeckel/netbox-plugin-dns" alt="Pull Requests Badge"/></a>
+<a href="https://github.com/peteeckel/netbox-plugin-dns/stargazers"><img src="https://img.shields.io/github/stars/peteeckel/netbox-plugin-dns?style=flat" alt="Stars Badge"/></a>
+<a href="https://github.com/peteeckel/netbox-plugin-dns/network/members"><img src="https://img.shields.io/github/forks/peteeckel/netbox-plugin-dns?style=flat" alt="Forks Badge"/></a>
 <a href="https://github.com/peteeckel/netbox-plugin-dns/issues"><img src="https://img.shields.io/github/issues/peteeckel/netbox-plugin-dns" alt="Issues Badge"/></a>
+<a href="https://github.com/peteeckel/netbox-plugin-dns/pulls"><img src="https://img.shields.io/github/issues-pr/peteeckel/netbox-plugin-dns" alt="Pull Requests Badge"/></a>
 <a href="https://github.com/peteeckel/netbox-plugin-dns/graphs/contributors"><img alt="GitHub contributors" src="https://img.shields.io/github/contributors/peteeckel/netbox-plugin-dns?color=2b9348"></a>
 <a href="https://github.com/peteeckel/netbox-plugin-dns/blob/master/LICENSE"><img src="https://img.shields.io/github/license/peteeckel/netbox-plugin-dns?color=2b9348" alt="License Badge"/></a>
+<a href="https://pepy.tech/project/netbox-plugin-dns"><img alt="Downloads" src="https://static.pepy.tech/badge/netbox-plugin-dns"></a>
+<a href="https://pepy.tech/project/netbox-plugin-dns"><img alt="Downloads/Week" src="https://static.pepy.tech/badge/netbox-plugin-dns/month"></a>
+<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
 
 * Manage name servers, zones and records
 * Automatically generate SOA and NS records for zones
-* Automatically create and update PTR records for IPv4 and IPv6 records
-* Optionally organize DNS zones in views for split horizon DNS and multi-site deployments
-* Optionally maintain domain registrar and registrant information for zones
-* Maintain RFC2317 reverse zones for IPv4 prefixes with a network mask length longer than 24 bits
+* 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
 
 NetBox DNS is using the standardized NetBox plugin interface, so it also takes advantage of the NetBox tagging and change log features.
 

{netbox_plugin_dns-0.22.3 → netbox_plugin_dns-0.22.5}/netbox_dns/__init__.py

@@ -10,7 +10,7 @@ except ImportError:
     # NetBox 3.5.8
     from extras.plugins.utils import get_plugin_config
 
-__version__ = "0.22.3"
+__version__ = "0.22.5"
 
 
 class DNSConfig(PluginConfig):
@@ -26,9 +26,9 @@ class DNSConfig(PluginConfig):
         "zone_default_ttl": 86400,
         "zone_soa_serial_auto": True,
         "zone_soa_serial": 1,
-        "zone_soa_refresh": 172800,
+        "zone_soa_refresh": 43200,
         "zone_soa_retry": 7200,
-        "zone_soa_expire": 2592000,
+        "zone_soa_expire": 2419200,
         "zone_soa_minimum": 3600,
         "feature_ipam_coupling": False,
         "tolerate_underscores_in_hostnames": False,
@@ -38,7 +38,8 @@ class DNSConfig(PluginConfig):
         ],
         "tolerate_non_rfc1035_types": [],
         "enable_root_zones": False,
-        "enforce_unique_records": False,
+        "enforce_unique_records": True,
+        "enforce_unique_rrset_ttl": True,
     }
     base_url = "netbox-dns"
 

{netbox_plugin_dns-0.22.3 → netbox_plugin_dns-0.22.5}/netbox_dns/api/serializers.py

@@ -272,6 +272,7 @@ class RegistrarSerializer(NetBoxModelSerializer):
             "display",
             "name",
             "iana_id",
+            "address",
             "referral_url",
             "whois_server",
             "abuse_email",

{netbox_plugin_dns-0.22.3 → netbox_plugin_dns-0.22.5}/netbox_dns/filters/registrar.py

@@ -12,6 +12,7 @@ class RegistrarFilter(NetBoxModelFilterSet):
             "id",
             "name",
             "iana_id",
+            "address",
             "referral_url",
             "whois_server",
             "abuse_email",

{netbox_plugin_dns-0.22.3 → netbox_plugin_dns-0.22.5}/netbox_dns/forms/registrar.py

@@ -17,6 +17,7 @@ class RegistrarForm(NetBoxModelForm):
         fields = (
             "name",
             "iana_id",
+            "address",
             "referral_url",
             "whois_server",
             "abuse_email",
@@ -29,12 +30,18 @@ class RegistrarFilterForm(NetBoxModelFilterSetForm):
     model = Registrar
     fieldsets = (
         (None, ("q", "name", "iana_id", "tags")),
-        ("Contact", ("referral_url", "whois_server", "abuse_email", "abuse_phone")),
+        (
+            "Contact",
+            ("address", "referral_url", "whois_server", "abuse_email", "abuse_phone"),
+        ),
     )
 
     name = forms.CharField(
         required=False,
     )
+    address = forms.CharField(
+        required=False,
+    )
     iana_id = forms.IntegerField(
         required=False,
         label="IANA ID",
@@ -64,6 +71,7 @@ class RegistrarImportForm(NetBoxModelImportForm):
         fields = (
             "name",
             "iana_id",
+            "address",
             "referral_url",
             "whois_server",
             "abuse_email",
@@ -96,6 +104,7 @@ class RegistrarBulkEditForm(NetBoxModelBulkEditForm):
         (
             None,
             (
+                "address",
                 "referral_url",
                 "whois_server",
                 "abuse_email",
@@ -105,6 +114,7 @@ class RegistrarBulkEditForm(NetBoxModelBulkEditForm):
     )
 
     nullable_fields = (
+        "address",
         "referral_url",
         "whois_server",
         "abuse_email",

{netbox_plugin_dns-0.22.3 → netbox_plugin_dns-0.22.5}/netbox_dns/forms/zone.py

@@ -15,6 +15,7 @@ from utilities.forms.fields import (
     TagFilterField,
     CSVChoiceField,
     CSVModelChoiceField,
+    CSVModelMultipleChoiceField,
     DynamicModelChoiceField,
 )
 from utilities.forms.widgets import BulkEditNullBooleanSelect, APISelect
@@ -287,6 +288,12 @@ class ZoneImportForm(NetBoxModelImportForm):
         required=False,
         help_text="Zone status",
     )
+    nameservers = CSVModelMultipleChoiceField(
+        queryset=NameServer.objects.all(),
+        to_field_name="name",
+        required=False,
+        help_text="Name servers for the zone",
+    )
     default_ttl = forms.IntegerField(
         required=False,
         help_text="Default TTL",
@@ -308,7 +315,7 @@ class ZoneImportForm(NetBoxModelImportForm):
         required=False,
         help_text="Mailbox of the zone's administrator",
     )
-    soa_serial_auto = forms.BooleanField(
+    soa_serial_auto = forms.NullBooleanField(
         required=False,
         help_text="Generate the SOA serial",
     )
@@ -436,26 +443,6 @@ class ZoneImportForm(NetBoxModelImportForm):
     def clean_soa_rname(self):
         return self._clean_field_with_defaults("soa_rname")
 
-    def clean_soa_serial_auto(self):
-        try:
-            return self._clean_field_with_defaults("soa_serial_auto")
-        except ValidationError:
-            if self.cleaned_data["soa_serial"] or self._get_default_value("soa_serial"):
-                return None
-
-            raise
-
-    def clean_soa_serial(self):
-        try:
-            return self._clean_field_with_defaults("soa_serial")
-        except ValidationError:
-            if self.cleaned_data["soa_serial_auto"] or self._get_default_value(
-                "soa_serial_auto"
-            ):
-                return None
-
-            raise
-
     def clean_soa_refresh(self):
         return self._clean_field_with_defaults("soa_refresh")
 
@@ -468,6 +455,36 @@ class ZoneImportForm(NetBoxModelImportForm):
     def clean_soa_minimum(self):
         return self._clean_field_with_defaults("soa_minimum")
 
+    def clean(self, *args, **kwargs):
+        super().clean(*args, **kwargs)
+
+        soa_serial_auto = self.cleaned_data.get("soa_serial_auto")
+        soa_serial = self.cleaned_data.get("soa_serial")
+
+        if soa_serial is None:
+            soa_serial = self._get_default_value("soa_serial")
+
+        if soa_serial_auto is None:
+            if self._get_default_value("soa_serial_auto") is not None:
+                soa_serial_auto = self._get_default_value("soa_serial_auto")
+
+            elif soa_serial is not None:
+                soa_serial_auto = False
+
+            else:
+                raise ValidationError(
+                    "SOA Serial Auto not set and no default value and SOA Serial available"
+                )
+
+        if "soa_serial_auto" in self.cleaned_data:
+            self.cleaned_data["soa_serial_auto"] = soa_serial_auto
+
+        if "soa_serial" in self.cleaned_data:
+            if soa_serial_auto:
+                self.cleaned_data["soa_serial"] = None
+            else:
+                self.cleaned_data["soa_serial"] = soa_serial
+
     class Meta:
         model = Zone
 
@@ -475,6 +492,7 @@ class ZoneImportForm(NetBoxModelImportForm):
             "view",
             "name",
             "status",
+            "nameservers",
             "default_ttl",
             "description",
             "soa_ttl",

{netbox_plugin_dns-0.22.3 → netbox_plugin_dns-0.22.5}/netbox_dns/management/commands/cleanup_database.py

@@ -141,7 +141,7 @@ def record_update_ptr_records(verbose=False):
     for record in Record.objects.filter(
         type__in=(RecordTypeChoices.A, RecordTypeChoices.AAAA)
     ):
-        record.update_ptr_record()
+        record.save(update_fields=["ptr_record"])
 
 
 def record_update_ip_address(verbose=False):

netbox_plugin_dns-0.22.5/netbox_dns/management/commands/cleanup_rrset_ttl.py

@@ -0,0 +1,62 @@
+from django.core.management.base import BaseCommand
+from django.db.models import Max, Min
+
+from netbox_dns.models import (
+    Record,
+    RecordTypeChoices,
+)
+
+
+class Command(BaseCommand):
+    help = "Clean up the TTLs for RRSets"
+
+    def add_arguments(self, parser):
+        min_max = parser.add_mutually_exclusive_group()
+        min_max.add_argument(
+            "--min",
+            action="store_true",
+            help="Use the minimum TTL of an RRSet for all Records",
+        )
+        min_max.add_argument(
+            "--max",
+            action="store_true",
+            help="Use the maximum TTL of an RRSet for all Records",
+        )
+
+    def handle(self, *model_names, **options):
+        self.cleanup_rrset_ttl(**options)
+
+        self.stdout.write("RRSet cleanup completed.")
+
+    def cleanup_rrset_ttl(self, **options):
+        verbose = options.get("verbosity") > 1
+
+        ttl_records = (
+            Record.objects.filter(ttl__isnull=False)
+            .exclude(type=RecordTypeChoices.SOA)
+            .exclude(type=RecordTypeChoices.PTR, maanged=True)
+        )
+        for record in ttl_records:
+            records = Record.objects.filter(
+                name=record.name,
+                zone=record.zone,
+                type=record.type,
+            ).exclude(type=RecordTypeChoices.PTR, maanged=True)
+
+            if records.count() == 1:
+                if options.get("verbosity") > 2:
+                    self.stdout.write(f"Ignoring single record {record.id} ({record})")
+                continue
+
+            if options.get("max"):
+                ttl = records.aggregate(Max("ttl")).get("ttl__max")
+            else:
+                ttl = records.aggregate(Min("ttl")).get("ttl__min")
+
+            for record in records.exclude(ttl=ttl):
+                if options.get("verbosity") > 1:
+                    self.stdout.write(
+                        f"Updating TTL for record {record.id} ({record}) to {ttl}"
+                    )
+                record.ttl = ttl
+                record.save(update_fields=["ttl"], update_rrset_ttl=False)