netbox-plugin-dns 0.21.4__py3-none-any.whl → 1.4.7__py3-none-any.whl

netbox_dns/views/zone.py

@@ -1,9 +1,11 @@
 from dns import name as dns_name
 
+from django.utils.translation import gettext_lazy as _
+
 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,
@@ -15,31 +17,48 @@ from netbox_dns.tables import (
     ZoneTable,
     RecordTable,
     ManagedRecordTable,
+    DelegationRecordTable,
+)
+
+
+__all__ = (
+    "ZoneView",
+    "ZoneListView",
+    "ZoneEditView",
+    "ZoneDeleteView",
+    "ZoneBulkImportView",
+    "ZoneBulkEditView",
+    "ZoneBulkDeleteView",
 )
 
 
+@register_model_view(Zone, "list", path="", detail=False)
 class ZoneListView(generic.ObjectListView):
-    queryset = Zone.objects.all().prefetch_related("view", "tags")
-    filterset = ZoneFilter
+    queryset = Zone.objects.prefetch_related("view", "tags")
+    filterset = ZoneFilterSet
     filterset_form = ZoneFilterForm
     table = ZoneTable
 
 
+@register_model_view(Zone)
 class ZoneView(generic.ObjectView):
-    queryset = Zone.objects.all().prefetch_related(
+    queryset = Zone.objects.prefetch_related(
         "view",
         "tags",
         "nameservers",
         "soa_mname",
-        "record_set",
+        "records",
     )
 
     def get_extra_context(self, request, instance):
         ns_warnings, ns_errors = instance.check_nameservers()
+        mname_warning = instance.check_soa_mname()
 
         context = {
             "nameserver_warnings": ns_warnings,
             "nameserver_errors": ns_errors,
+            "mname_warning": mname_warning,
+            "parent_zone": instance.parent_zone,
         }
 
         name = dns_name.from_text(instance.name)
@@ -49,40 +68,37 @@ class ZoneView(generic.ObjectView):
         return context
 
 
+@register_model_view(Zone, "add", detail=False)
+@register_model_view(Zone, "edit")
 class ZoneEditView(generic.ObjectEditView):
-    queryset = Zone.objects.all().prefetch_related(
-        "view", "tags", "nameservers", "soa_mname"
-    )
+    queryset = Zone.objects.prefetch_related("view", "tags", "nameservers", "soa_mname")
     form = ZoneForm
-    default_return_url = "plugins:netbox_dns:zone_list"
 
 
+@register_model_view(Zone, "delete")
 class ZoneDeleteView(generic.ObjectDeleteView):
     queryset = Zone.objects.all()
-    default_return_url = "plugins:netbox_dns:zone_list"
 
 
+@register_model_view(Zone, "bulk_import", detail=False)
 class ZoneBulkImportView(generic.BulkImportView):
-    queryset = Zone.objects.all().prefetch_related(
-        "view", "tags", "nameservers", "soa_mname"
-    )
+    queryset = Zone.objects.prefetch_related("view", "tags", "nameservers", "soa_mname")
     model_form = ZoneImportForm
     table = ZoneTable
-    default_return_url = "plugins:netbox_dns:zone_list"
 
 
+@register_model_view(Zone, "bulk_edit", path="edit", detail=False)
 class ZoneBulkEditView(generic.BulkEditView):
-    queryset = Zone.objects.all().prefetch_related(
-        "view", "tags", "nameservers", "soa_mname"
-    )
-    filterset = ZoneFilter
+    queryset = Zone.objects.prefetch_related("view", "tags", "nameservers", "soa_mname")
+    filterset = ZoneFilterSet
     table = ZoneTable
     form = ZoneBulkEditForm
-    default_return_url = "plugins:netbox_dns:zone_list"
 
 
+@register_model_view(Zone, "bulk_delete", path="delete", detail=False)
 class ZoneBulkDeleteView(generic.BulkDeleteView):
     queryset = Zone.objects.all()
+    filterset = ZoneFilterSet
     table = ZoneTable
 
 
@@ -100,30 +116,38 @@ class ZoneRegistrationView(generic.ObjectView):
     template_name = "netbox_dns/zone/registration.html"
 
     tab = RegistrationViewTab(
-        label="Registration",
+        label=_("Registration"),
     )
 
+    def get_extra_context(self, request, instance):
+        expiration_warning, expiration_error = instance.check_expiration()
+
+        context = {
+            "expiration_warning": expiration_warning,
+            "expiration_error": expiration_error,
+        }
+
+        return context
+
 
 @register_model_view(Zone, "records")
 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
 
     tab = ViewTab(
-        label="Records",
+        label=_("Records"),
         permission="netbox_dns.view_record",
-        badge=lambda obj: obj.record_count(managed=False),
+        badge=lambda obj: obj.records.filter(managed=False).count(),
         hide_if_empty=True,
     )
 
     def get_children(self, request, parent):
-        return Record.objects.restrict(request.user, "view").filter(
-            zone=parent, managed=False
-        )
+        return parent.records.restrict(request.user, "view").filter(managed=False)
 
 
 @register_model_view(Zone, "managed_records")
@@ -131,18 +155,91 @@ 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",)
 
     tab = ViewTab(
-        label="Managed Records",
+        label=_("Managed Records"),
+        permission="netbox_dns.view_record",
+        badge=lambda obj: obj.records.filter(managed=True).count(),
+        hide_if_empty=True,
+    )
+
+    def get_children(self, request, parent):
+        return parent.records.restrict(request.user, "view").filter(managed=True)
+
+
+@register_model_view(Zone, "delegation_records")
+class ZoneDelegationRecordListView(generic.ObjectChildrenView):
+    queryset = Zone.objects.all()
+    child_model = Record
+    table = DelegationRecordTable
+    filterset = RecordFilterSet
+    template_name = "netbox_dns/zone/delegation_record.html"
+
+    tab = ViewTab(
+        label=_("Delegation Records"),
+        permission="netbox_dns.view_record",
+        badge=lambda obj: obj.delegation_records.count(),
+        hide_if_empty=True,
+    )
+
+    def get_children(self, request, parent):
+        return parent.delegation_records.restrict(request.user, "view")
+
+
+@register_model_view(Zone, "parent_delegation_records")
+class ZoneParentDelegationRecordListView(generic.ObjectChildrenView):
+    queryset = Zone.objects.all()
+    child_model = Record
+    table = DelegationRecordTable
+    filterset = RecordFilterSet
+    template_name = "netbox_dns/zone/delegation_record.html"
+
+    tab = ViewTab(
+        label=_("Parent Delegation Records"),
         permission="netbox_dns.view_record",
-        badge=lambda obj: obj.record_count(managed=True),
+        badge=lambda obj: obj.ancestor_delegation_records.count(),
+        hide_if_empty=True,
+    )
+
+    def get_children(self, request, parent):
+        return parent.ancestor_delegation_records.restrict(request.user, "view")
+
+
+@register_model_view(Zone, "rfc2317_child_zones")
+class ZoneRFC2317ChildZoneListView(generic.ObjectChildrenView):
+    queryset = Zone.objects.all()
+    child_model = Zone
+    table = ZoneTable
+    filterset = ZoneFilterSet
+    template_name = "netbox_dns/zone/rfc2317_child_zone.html"
+
+    tab = ViewTab(
+        label=_("RFC2317 Child Zones"),
+        permission="netbox_dns.view_zone",
+        badge=lambda obj: obj.rfc2317_child_zones.count(),
+        hide_if_empty=True,
+    )
+
+    def get_children(self, request, parent):
+        return parent.rfc2317_child_zones.all()
+
+
+@register_model_view(Zone, "child_zones")
+class ZoneChildZoneListView(generic.ObjectChildrenView):
+    queryset = Zone.objects.all()
+    child_model = Zone
+    table = ZoneTable
+    filterset = ZoneFilterSet
+    template_name = "netbox_dns/zone/child_zone.html"
+
+    tab = ViewTab(
+        label=_("Child Zones"),
+        permission="netbox_dns.view_zone",
+        badge=lambda obj: obj.child_zones.count(),
         hide_if_empty=True,
     )
 
     def get_children(self, request, parent):
-        return Record.objects.restrict(request.user, "view").filter(
-            zone=parent, managed=True
-        )
+        return parent.child_zones

netbox_dns/views/zone_template.py

@@ -0,0 +1,82 @@
+from netbox.views import generic
+from utilities.views import register_model_view
+
+from netbox_dns.models import ZoneTemplate
+from netbox_dns.filtersets import ZoneTemplateFilterSet
+from netbox_dns.forms import (
+    ZoneTemplateImportForm,
+    ZoneTemplateForm,
+    ZoneTemplateFilterForm,
+    ZoneTemplateBulkEditForm,
+)
+from netbox_dns.tables import ZoneTemplateTable, RecordTemplateDisplayTable
+
+
+__all__ = (
+    "ZoneTemplateView",
+    "ZoneTemplateListView",
+    "ZoneTemplateEditView",
+    "ZoneTemplateDeleteView",
+    "ZoneTemplateBulkImportView",
+    "ZoneTemplateBulkEditView",
+    "ZoneTemplateBulkDeleteView",
+)
+
+
+@register_model_view(ZoneTemplate, "list", path="", detail=False)
+class ZoneTemplateListView(generic.ObjectListView):
+    queryset = ZoneTemplate.objects.all()
+    filterset = ZoneTemplateFilterSet
+    filterset_form = ZoneTemplateFilterForm
+    table = ZoneTemplateTable
+
+
+@register_model_view(ZoneTemplate)
+class ZoneTemplateView(generic.ObjectView):
+    queryset = ZoneTemplate.objects.all()
+
+    def get_extra_context(self, request, instance):
+        if instance.record_templates.exists():
+            record_template_table = RecordTemplateDisplayTable(
+                data=instance.record_templates.all()
+            )
+            record_template_table.configure(request)
+            return {
+                "record_template_table": record_template_table,
+            }
+
+        return {}
+
+
+@register_model_view(ZoneTemplate, "add", detail=False)
+@register_model_view(ZoneTemplate, "edit")
+class ZoneTemplateEditView(generic.ObjectEditView):
+    queryset = ZoneTemplate.objects.all()
+    form = ZoneTemplateForm
+
+
+@register_model_view(ZoneTemplate, "delete")
+class ZoneTemplateDeleteView(generic.ObjectDeleteView):
+    queryset = ZoneTemplate.objects.all()
+
+
+@register_model_view(ZoneTemplate, "bulk_import", detail=False)
+class ZoneTemplateBulkImportView(generic.BulkImportView):
+    queryset = ZoneTemplate.objects.all()
+    model_form = ZoneTemplateImportForm
+    table = ZoneTemplateTable
+
+
+@register_model_view(ZoneTemplate, "bulk_edit", path="edit", detail=False)
+class ZoneTemplateBulkEditView(generic.BulkEditView):
+    queryset = ZoneTemplate.objects.all()
+    filterset = ZoneTemplateFilterSet
+    table = ZoneTemplateTable
+    form = ZoneTemplateBulkEditForm
+
+
+@register_model_view(ZoneTemplate, "bulk_delete", path="delete", detail=False)
+class ZoneTemplateBulkDeleteView(generic.BulkDeleteView):
+    queryset = ZoneTemplate.objects.all()
+    filterset = ZoneTemplateFilterSet
+    table = ZoneTemplateTable

netbox_plugin_dns-1.4.7.dist-info/METADATA

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: netbox-plugin-dns
+Version: 1.4.7
+Summary: NetBox DNS is a NetBox plugin for managing DNS data.
+Author-email: Peter Eckel <pete@netbox-dns.org>
+Project-URL: Homepage, https://github.com/peteeckel/netbox-plugin-dns
+Project-URL: Documentation, https://github.com/peteeckel/netbox-plugin-dns/blob/main/docs/using_netbox_dns.md
+Project-URL: Repository, https://github.com/peteeckel/netbox-plugin-dns
+Project-URL: Issues, https://github.com/peteeckel/netbox-plugin-dns/issues
+Keywords: netbox,netbox-plugin,dns
+Classifier: Development Status :: 5 - Production/Stable
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: dnspython
+Dynamic: license-file
+
+# 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, 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>
+<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://github.com/psf/black"><img src="https://img.shields.io/badge/code%20style-black-000000.svg" alt="Code Style Black"/></a>
+<a href="https://pepy.tech/project/netbox-plugin-dns"><img alt="Downloads" src="https://static.pepy.tech/personalized-badge/netbox-plugin-dns?period=total&left_color=BLACK&right_color=BLUE&left_text=Downloads"></a>
+<a href="https://pepy.tech/project/netbox-plugin-dns"><img alt="Downloads/Week" src="https://static.pepy.tech/personalized-badge/netbox-plugin-dns?period=monthly&left_color=BLACK&right_color=BLUE&left_text=Downloads%2fMonth"></a>
+<a href="https://pepy.tech/project/netbox-plugin-dns"><img alt="Downloads/Month" src="https://static.pepy.tech/personalized-badge/netbox-plugin-dns?period=weekly&left_color=BLACK&right_color=BLUE&left_text=Downloads%2fWeek"></a>
+</div>
+
+> [!WARNING]
+> **As a result of some issues with NetBox Branching still under investigation, NetBox DNS is currently not compatible with the new NetBox Branching plugin.**
+> This affects multiple aspects of the branching functionality, and currently there is no workaround. Do not try to use NetBox Branching together with NetBox DNS until these issues are resolved.
+> This warning will be updated as soon as the situation is resolved.
+
+## Objectives
+NetBox DNS is designed to be the 'DNS Source of Truth' analogous to NetBox being the 'Network Source of Truth'.
+
+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.
+
+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 changes to the SOA SERIAL number, whether they are done automatically or manually
+* 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
+* Templating for zones and records enables faster creations of zones with given boilerplate object relations, such as name servers, tags, tenants or registration information, or records like standard SPF or MX records that are the same for a subset of zones
+* IPAM DNSsync can be used to automatically create address and pointer records for IP addresses by assigning prefixes to DNS views. When an IP address has a DNS name assigned and there are zones with matching names in the DNS views linked to the IP address' prefix, a matching DNS record will be created in these zones
+* DNSSEC support for storing configuration data relevant to DNSSEC operation in NetBox DNS
+
+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.
+
+For RFC9432 compatible DNS Servers like BIND, a related plugin [netbox-plugin-bind-provisioner](https://github.com/Suraxius/netbox-plugin-bind-provisioner) provides direct integration using DNS native zone distribution.
+
+## Requirements
+
+* NetBox 4.3.0 or higher
+* Python 3.10 or higher
+
+## Compatibility with NetBox Versions
+
+NetBox Version | NetBox DNS Version | Comment
+-------------- | ------------------ | -------
+3.5            | 0.22               |
+3.6            | 0.22               |
+3.7            | 0.22               |
+4.0 - 4.1      | 1.0                | Supports legacy IPAM Coupling
+4.0 - 4.1      | 1.1                | Supports IPAM DNSsync
+4.2            | 1.2                |
+4.3            | 1.3 - 1.4          |
+4.4            | 1.4                |
+
+## Installation & Configuration
+
+### Installation
+
+```
+$ source /opt/netbox/venv/bin/activate
+(venv) $ pip install netbox-plugin-dns
+```
+
+### NetBox Configuration
+
+Add the plugin to the NetBox config. `~/netbox/configuration.py`
+
+```python
+PLUGINS = [
+    "netbox_dns",
+]
+```
+
+To permanently keep the plugin installed when updating NetBox via `upgrade.sh`:
+
+```
+echo netbox-plugin-dns >> ~/netbox/local_requirements.txt
+```
+
+To add the required netbox_dns tables to your database run the following command from your NetBox directory:
+
+```
+./manage.py migrate
+```
+
+Full documentation on using plugins with NetBox: [Using Plugins - NetBox Documentation](https://netbox.readthedocs.io/en/stable/plugins/)
+
+## Contribute
+
+Contributions are always welcome! Please see the [Contribution Guidelines](CONTRIBUTING.md)
+
+## Documentation
+
+For further information, please refer to the full documentation: [Using NetBox DNS](docs/using_netbox_dns.md)
+
+## License
+
+MIT