netbox-services 0.0.1__tar.gz

netbox_services-0.0.1/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: netbox-services
+Version: 0.0.1
+Summary: A NetBox services Plugin for Service Providers
+Author-email: Arturo Baldo <baldoarturo@gmail.com>
+Maintainer-email: Arturo Baldo <baldoarturo@gmail.com>
+Project-URL: Documentation, https://github.com/baldoarturo/netbox-services/blob/main/README.md
+Project-URL: Source, https://github.com/baldoarturo/netbox-services
+Project-URL: Tracker, https://github.com/baldoarturo/netbox-services/issues
+Keywords: netbox-plugin
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# NetBox Services Plugin
+
+This plugin extends NetBox to manage and relate business services to network resources. It introduces a `Service` model that allows you to track various service types (such as L2VPN, L3VPN, DIA, Transit, CDN, Voice) and associate them with devices, interfaces, cables, VLANs, prefixes, VRFs, ASNs, route targets, L2VPNs, tunnels, and virtual machines.
+
+## Features
+- Add, edit, and delete business services.
+- Relate services to network objects (devices, interfaces, cables, VLANs, prefixes, VRFs, ASNs, route targets, L2VPNs, tunnels, virtual machines).
+- Filter and view services in a table with all relevant fields.
+- Custom forms and views for relating specific network objects to a service.
+- Integrated navigation and changelog support.
+
+## Usage
+- Access the plugin from the NetBox navigation menu under "Business Services".
+- Create new services and relate them to network resources.
+- Use the detail view to see all associations for a service.
+
+![alt text](02-main.png)
+
+## Why
+Because you might be looking for such a thing. 
+
+Tagging is great for simple categorization, but the NetBox Services plugin goes far beyond that by letting you model real business services and their relationships to network resources.
+
+Instead of just tagging a device or prefix as "DIA," you can create a full DIA service—like "NW-123456" from Cogent—and link it to all relevant devices, interfaces, prefixes, VRFs, ASNs, and more.
+
+For example, with a DIA service from Cogent (Service ID: NW-123456), you can:
+
+- See all devices and interfaces delivering that service.
+- Track the exact IP prefixes, VRFs, and ASNs involved.
+- Relate cables, tunnels, and even virtual machines to the service.
+- View and manage all these relationships in one place, with history and forms tailored to each resource.
+
+This gives you a true service-centric view of your network, making troubleshooting, reporting, and change management much more powerful and organized than simple tagging ever could.
+
+## Requirements
+- NetBox 4.x or later
+- Django 4.x or later
+
+## Installation
+1. Clone this repository into your NetBox `plugins` directory. You can also install it on your system / venv / coffee maker with
+```bash
+pip install netbox_services
+```
+
+2. Add `'netbox_services'` to the `PLUGINS` list in your NetBox configuration.
+
+```python
+    PLUGINS = [
+        'netbox_services'
+    ],
+```
+
+3. Run migrations: `python manage.py migrate netbox_services`
+4. Restart NetBox.
+
+## License
+MIT

netbox_services-0.0.1/README.md

@@ -0,0 +1,57 @@
+# NetBox Services Plugin
+
+This plugin extends NetBox to manage and relate business services to network resources. It introduces a `Service` model that allows you to track various service types (such as L2VPN, L3VPN, DIA, Transit, CDN, Voice) and associate them with devices, interfaces, cables, VLANs, prefixes, VRFs, ASNs, route targets, L2VPNs, tunnels, and virtual machines.
+
+## Features
+- Add, edit, and delete business services.
+- Relate services to network objects (devices, interfaces, cables, VLANs, prefixes, VRFs, ASNs, route targets, L2VPNs, tunnels, virtual machines).
+- Filter and view services in a table with all relevant fields.
+- Custom forms and views for relating specific network objects to a service.
+- Integrated navigation and changelog support.
+
+## Usage
+- Access the plugin from the NetBox navigation menu under "Business Services".
+- Create new services and relate them to network resources.
+- Use the detail view to see all associations for a service.
+
+![alt text](02-main.png)
+
+## Why
+Because you might be looking for such a thing. 
+
+Tagging is great for simple categorization, but the NetBox Services plugin goes far beyond that by letting you model real business services and their relationships to network resources.
+
+Instead of just tagging a device or prefix as "DIA," you can create a full DIA service—like "NW-123456" from Cogent—and link it to all relevant devices, interfaces, prefixes, VRFs, ASNs, and more.
+
+For example, with a DIA service from Cogent (Service ID: NW-123456), you can:
+
+- See all devices and interfaces delivering that service.
+- Track the exact IP prefixes, VRFs, and ASNs involved.
+- Relate cables, tunnels, and even virtual machines to the service.
+- View and manage all these relationships in one place, with history and forms tailored to each resource.
+
+This gives you a true service-centric view of your network, making troubleshooting, reporting, and change management much more powerful and organized than simple tagging ever could.
+
+## Requirements
+- NetBox 4.x or later
+- Django 4.x or later
+
+## Installation
+1. Clone this repository into your NetBox `plugins` directory. You can also install it on your system / venv / coffee maker with
+```bash
+pip install netbox_services
+```
+
+2. Add `'netbox_services'` to the `PLUGINS` list in your NetBox configuration.
+
+```python
+    PLUGINS = [
+        'netbox_services'
+    ],
+```
+
+3. Run migrations: `python manage.py migrate netbox_services`
+4. Restart NetBox.
+
+## License
+MIT

netbox_services-0.0.1/netbox_services/__init__.py

@@ -0,0 +1,19 @@
+from importlib.metadata import metadata
+
+from netbox.plugins import PluginConfig
+
+
+plugin = metadata('netbox_services')
+
+
+class Services(PluginConfig):
+    name = plugin.get('Name').replace('-', '_')
+    verbose_name = plugin.get('Name').replace('-', ' ').title()
+    description = plugin.get('Summary')
+    version = plugin.get('Version')
+    author = 'Arturo Baldo'
+    author_email = 'baldoarturo@gmail.com'
+    base_url = 'services'
+    min_version = '4.4.0'
+
+config = Services

netbox_services-0.0.1/netbox_services/api/__init__.py

@@ -0,0 +1 @@
+from .serializers import *

netbox_services-0.0.1/netbox_services/api/serializers.py

@@ -0,0 +1,20 @@
+from rest_framework import serializers
+
+from netbox.api.serializers import NetBoxModelSerializer
+from netbox_services.models import Service
+
+class ServiceSerializer(NetBoxModelSerializer):
+
+    url = serializers.HyperlinkedIdentityField(
+        view_name='plugins-api:netbox_services-api:service-detail'
+    )
+    class Meta:
+        model = Service
+        fields = ('type',
+                  'service_id',
+                  'tenant',
+                  'tags',
+                  'custom_fields',
+                  'created',
+                  'last_updated',
+                  )

netbox_services-0.0.1/netbox_services/api/urls.py

@@ -0,0 +1,7 @@
+from netbox.api.routers import NetBoxRouter
+from .views import ServiceViewSet
+app_name = 'netbox_services'
+router = NetBoxRouter()
+router.register('services', ServiceViewSet)
+
+urlpatterns = router.urls

netbox_services-0.0.1/netbox_services/api/views.py

@@ -0,0 +1,8 @@
+from netbox.api.viewsets import NetBoxModelViewSet
+
+from .. import models
+from .serializers import ServiceSerializer
+
+class ServiceViewSet(NetBoxModelViewSet):
+    queryset = models.Service.objects.prefetch_related('tags')
+    serializer_class = ServiceSerializer

netbox_services-0.0.1/netbox_services/filtersets.py

@@ -0,0 +1,8 @@
+from netbox.filtersets import NetBoxModelFilterSet
+from .models import Service
+
+class ServiceFilterSet(NetBoxModelFilterSet):
+
+    class Meta:
+        model = Service
+        fields = '__all__'

netbox_services-0.0.1/netbox_services/forms.py

@@ -0,0 +1,148 @@
+from django import forms
+from utilities.forms.fields import CommentField
+
+from netbox.forms import NetBoxModelForm, NetBoxModelFilterSetForm
+from .models import Service, ServiceTypeChoices
+
+from tenancy.models import Tenant
+from dcim.models import Device, Interface, Cable
+from ipam.models import VRF, Prefix, VLAN, ASN, RouteTarget
+from vpn.models import L2VPN, Tunnel
+from virtualization.models import VirtualMachine
+
+
+class NewServiceForm(NetBoxModelForm):
+    comments = CommentField()
+
+    class Meta:
+        model = Service
+        fields = ('type', 'service_id', 'tenant')
+
+
+class ServiceRelatedDevicesForm(forms.ModelForm):
+
+    class Meta:
+        model = Service
+        fields = ('devices',)
+
+class ServiceRelatedInterfacesForm(forms.ModelForm):
+
+    class Meta:
+        model = Service
+        fields = ('interfaces',)
+
+class ServiceRelatedCablesForm(forms.ModelForm):
+
+    class Meta:
+        model = Service
+        fields = ('cables',)
+
+
+class ServiceRelatedVLANsForm(forms.ModelForm):
+
+    class Meta:
+        model = Service
+        fields = ('vlans',)
+
+class ServiceRelatedPrefixesForm(forms.ModelForm):
+
+    class Meta:
+        model = Service
+        fields = ('prefixes',)
+
+class ServiceRelatedVRFsForm(forms.ModelForm):
+
+    class Meta:
+        model = Service
+        fields = ('vrfs',)
+
+class ServiceRelatedASNsForm(forms.ModelForm):
+
+    class Meta:
+        model = Service
+        fields = ('asns',)
+
+
+class ServiceRelatedRouteTargetsForm(forms.ModelForm):
+
+    class Meta:
+        model = Service
+        fields = ('route_targets',)
+
+class ServiceRelatedL2VPNsForm(forms.ModelForm):
+
+    class Meta:
+        model = Service
+        fields = ('l2vpns',)
+
+class ServiceRelatedTunnelsForm(forms.ModelForm):
+
+    class Meta:
+        model = Service
+        fields = ('tunnels',)
+
+class ServiceRelatedVirtualMachinesForm(forms.ModelForm):
+
+    class Meta:
+        model = Service
+        fields = ('virtual_machines',)
+
+
+class ServiceFilterForm(NetBoxModelFilterSetForm):
+    comments = CommentField()
+    model = Service
+    type = forms.MultipleChoiceField(
+        choices=ServiceTypeChoices,
+        required=False
+    )
+    service_id = forms.CharField(
+        required=False
+    )
+    tenant = forms.ModelMultipleChoiceField(
+        queryset=Tenant.objects.all(),
+        required=False
+    )
+    devices = forms.ModelMultipleChoiceField(
+        queryset=Device.objects.all(),
+        required=False
+    )
+    interfaces = forms.ModelMultipleChoiceField(
+        queryset=Interface.objects.all(),
+        required=False
+    )
+    cables = forms.ModelMultipleChoiceField(
+        queryset=Cable.objects.all(),
+        required=False
+    )
+    vlans = forms.ModelMultipleChoiceField(
+        queryset=VLAN.objects.all(),
+        required=False
+    )
+    prefixes = forms.ModelMultipleChoiceField(
+        queryset=Prefix.objects.all(),
+        required=False
+    )
+    vrf = forms.ModelMultipleChoiceField(
+        queryset=VRF.objects.all(),
+        required=False
+    )
+    asns = forms.ModelMultipleChoiceField(
+        queryset=ASN.objects.all(),
+        required=False
+    )
+    route_targets = forms.ModelMultipleChoiceField(
+        queryset=RouteTarget.objects.all(),
+        required=False
+    )
+    l2vpns = forms.ModelMultipleChoiceField(
+        queryset=L2VPN.objects.all(),
+        required=False
+    )
+    tunnels = forms.ModelMultipleChoiceField(
+        queryset=Tenant.objects.all(),
+        required=False
+    )
+    virtual_machines = forms.ModelMultipleChoiceField(
+        queryset=VirtualMachine.objects.all(),
+        required=False
+    )

netbox_services-0.0.1/netbox_services/migrations/0001_initial.py

@@ -0,0 +1,43 @@
+# Generated by Django 5.2.6 on 2025-09-27 20:31
+
+import django.db.models.deletion
+import netbox.models.deletion
+import taggit.managers
+import utilities.json
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    operations = [
+        migrations.CreateModel(
+            name='Service',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False)),
+                ('created', models.DateTimeField(auto_now_add=True, null=True)),
+                ('last_updated', models.DateTimeField(auto_now=True, null=True)),
+                ('custom_field_data', models.JSONField(blank=True, default=dict, encoder=utilities.json.CustomFieldJSONEncoder)),
+                ('type', models.CharField()),
+                ('service_id', models.CharField()),
+                ('asns', models.ManyToManyField(to='ipam.asn')),
+                ('cables', models.ManyToManyField(to='dcim.cable')),
+                ('devices', models.ManyToManyField(to='dcim.device')),
+                ('interfaces', models.ManyToManyField(to='dcim.interface')),
+                ('l2vpns', models.ManyToManyField(to='vpn.l2vpn')),
+                ('prefixes', models.ManyToManyField(to='ipam.prefix')),
+                ('route_targets', models.ManyToManyField(to='ipam.routetarget')),
+                ('tags', taggit.managers.TaggableManager(through='taggit.TaggedItem', to='taggit.Tag')),
+                ('tenant', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.PROTECT, to='tenancy.tenant')),
+                ('tunnels', models.ManyToManyField(to='vpn.tunnel')),
+                ('virtual_machines', models.ManyToManyField(to='virtualization.virtualmachine')),
+                ('vlans', models.ManyToManyField(to='ipam.vlan')),
+                ('vrf', models.ManyToManyField(to='ipam.vrf')),
+            ],
+            options={
+                'abstract': False,
+            },
+            bases=(netbox.models.deletion.DeleteMixin, models.Model),
+        ),
+    ]

netbox_services-0.0.1/netbox_services/migrations/0002_alter_service_asns_alter_service_cables_and_more.py

@@ -0,0 +1,72 @@
+# Generated by Django 5.2.6 on 2025-09-27 20:54
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('dcim', '0215_rackreservation_status'),
+        ('ipam', '0082_add_prefix_network_containment_indexes'),
+        ('netbox_services', '0001_initial'),
+        ('virtualization', '0048_populate_mac_addresses'),
+        ('vpn', '0009_remove_redundant_indexes'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='service',
+            name='asns',
+            field=models.ManyToManyField(blank=True, null=True, to='ipam.asn'),
+        ),
+        migrations.AlterField(
+            model_name='service',
+            name='cables',
+            field=models.ManyToManyField(blank=True, to='dcim.cable'),
+        ),
+        migrations.AlterField(
+            model_name='service',
+            name='devices',
+            field=models.ManyToManyField(blank=True, null=True, to='dcim.device'),
+        ),
+        migrations.AlterField(
+            model_name='service',
+            name='interfaces',
+            field=models.ManyToManyField(blank=True, null=True, to='dcim.interface'),
+        ),
+        migrations.AlterField(
+            model_name='service',
+            name='l2vpns',
+            field=models.ManyToManyField(blank=True, null=True, to='vpn.l2vpn'),
+        ),
+        migrations.AlterField(
+            model_name='service',
+            name='prefixes',
+            field=models.ManyToManyField(blank=True, null=True, to='ipam.prefix'),
+        ),
+        migrations.AlterField(
+            model_name='service',
+            name='route_targets',
+            field=models.ManyToManyField(blank=True, null=True, to='ipam.routetarget'),
+        ),
+        migrations.AlterField(
+            model_name='service',
+            name='tunnels',
+            field=models.ManyToManyField(blank=True, null=True, to='vpn.tunnel'),
+        ),
+        migrations.AlterField(
+            model_name='service',
+            name='virtual_machines',
+            field=models.ManyToManyField(blank=True, null=True, to='virtualization.virtualmachine'),
+        ),
+        migrations.AlterField(
+            model_name='service',
+            name='vlans',
+            field=models.ManyToManyField(blank=True, null=True, to='ipam.vlan'),
+        ),
+        migrations.AlterField(
+            model_name='service',
+            name='vrf',
+            field=models.ManyToManyField(blank=True, to='ipam.vrf'),
+        ),
+    ]

netbox_services-0.0.1/netbox_services/migrations/0003_alter_service_options_alter_service_asns_and_more.py

@@ -0,0 +1,71 @@
+# Generated by Django 5.2.6 on 2025-10-01 19:09
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('dcim', '0215_rackreservation_status'),
+        ('ipam', '0082_add_prefix_network_containment_indexes'),
+        ('netbox_services', '0002_alter_service_asns_alter_service_cables_and_more'),
+        ('virtualization', '0048_populate_mac_addresses'),
+        ('vpn', '0009_remove_redundant_indexes'),
+    ]
+
+    operations = [
+        migrations.AlterModelOptions(
+            name='service',
+            options={'ordering': ['service_id']},
+        ),
+        migrations.AlterField(
+            model_name='service',
+            name='asns',
+            field=models.ManyToManyField(to='ipam.asn'),
+        ),
+        migrations.AlterField(
+            model_name='service',
+            name='cables',
+            field=models.ManyToManyField(to='dcim.cable'),
+        ),
+        migrations.AlterField(
+            model_name='service',
+            name='devices',
+            field=models.ManyToManyField(to='dcim.device'),
+        ),
+        migrations.AlterField(
+            model_name='service',
+            name='interfaces',
+            field=models.ManyToManyField(to='dcim.interface'),
+        ),
+        migrations.AlterField(
+            model_name='service',
+            name='l2vpns',
+            field=models.ManyToManyField(to='vpn.l2vpn'),
+        ),
+        migrations.AlterField(
+            model_name='service',
+            name='prefixes',
+            field=models.ManyToManyField(to='ipam.prefix'),
+        ),
+        migrations.AlterField(
+            model_name='service',
+            name='route_targets',
+            field=models.ManyToManyField(to='ipam.routetarget'),
+        ),
+        migrations.AlterField(
+            model_name='service',
+            name='tunnels',
+            field=models.ManyToManyField(to='vpn.tunnel'),
+        ),
+        migrations.AlterField(
+            model_name='service',
+            name='virtual_machines',
+            field=models.ManyToManyField(to='virtualization.virtualmachine'),
+        ),
+        migrations.AlterField(
+            model_name='service',
+            name='vlans',
+            field=models.ManyToManyField(to='ipam.vlan'),
+        ),
+    ]

netbox_services-0.0.1/netbox_services/migrations/0004_rename_vrf_service_vrfs_alter_service_service_id.py

@@ -0,0 +1,23 @@
+# Generated by Django 5.2.6 on 2025-10-02 19:48
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('netbox_services', '0003_alter_service_options_alter_service_asns_and_more'),
+    ]
+
+    operations = [
+        migrations.RenameField(
+            model_name='service',
+            old_name='vrf',
+            new_name='vrfs',
+        ),
+        migrations.AlterField(
+            model_name='service',
+            name='service_id',
+            field=models.CharField(unique=True),
+        ),
+    ]

netbox_services-0.0.1/netbox_services/models.py

@@ -0,0 +1,105 @@
+from django.db import models
+from django.urls import reverse
+
+from netbox.models import NetBoxModel
+
+from tenancy.models import Tenant
+from dcim.models import Device, Interface, Cable
+from ipam.models import VRF, Prefix, VLAN, ASN, RouteTarget
+from vpn.models import L2VPN, Tunnel
+from virtualization.models import VirtualMachine
+
+from utilities.choices import ChoiceSet
+from taggit.managers import TaggableManager
+
+
+class ServiceTypeChoices(ChoiceSet):
+    CHOICES = [
+        ('l2vpn', 'L2VPN'),
+        ('l3vpn', 'L3VPN'),
+        ('dia', 'DIA'),
+        ('transit', 'IP Transit'),
+        ('cdn', 'CDN'),
+        ('voice', 'Voice')
+    ]
+
+
+class Service(NetBoxModel):
+    type = models.CharField(
+        choices=ServiceTypeChoices,
+        verbose_name='Service Type',
+        null=False,
+        blank=False
+    )
+    service_id = models.CharField(
+        verbose_name='Service ID',
+        unique=True,
+        null=False,
+        blank=False
+    )
+    tenant = models.ForeignKey(
+        Tenant,
+        on_delete=models.PROTECT,
+        verbose_name='Service Tenant',
+        null=True,
+        blank=True
+    )
+    devices = models.ManyToManyField(
+        Device,
+        verbose_name='Related Devices',
+    )
+    interfaces = models.ManyToManyField(
+        Interface,
+        verbose_name='Related interfaces',
+    )
+    cables = models.ManyToManyField(
+        Cable,
+        verbose_name='Related Cables/XConnects',
+    )
+    vlans = models.ManyToManyField(
+        VLAN,
+        verbose_name='Related VLANs',
+    )
+    prefixes = models.ManyToManyField(
+        Prefix,
+        verbose_name='Related IP Prefixes',
+    )
+    vrfs = models.ManyToManyField(
+        VRF,
+        verbose_name='Related VRF',
+        blank=True
+    )
+    asns = models.ManyToManyField(
+        ASN,
+        verbose_name='Related Autonomous Systems',
+    )
+    route_targets = models.ManyToManyField(
+        RouteTarget,
+        verbose_name='Related Route Targets',
+    )
+    l2vpns = models.ManyToManyField(
+        L2VPN,
+        verbose_name='Related Route Targets',
+    )
+    tunnels = models.ManyToManyField(
+        Tunnel,
+        verbose_name='Related Tunnels',
+    )
+    virtual_machines = models.ManyToManyField(
+        VirtualMachine,
+        verbose_name='Related Virtual Machines',
+    )
+    tags = TaggableManager(
+        related_name='netbox_services_service_set',
+    )
+
+    class Meta:
+        verbose_name = 'Service'
+        verbose_name_plural = 'Services'
+        ordering = ['service_id']
+
+    def __str__(self):
+        return f"{self.service_id}"
+
+    def get_absolute_url(self):
+        return f"/plugins/services/{self.pk}/"

netbox_services-0.0.1/netbox_services/navigation.py

@@ -0,0 +1,24 @@
+from netbox.plugins import PluginMenu
+from netbox.plugins import PluginMenuItem, PluginMenuButton
+
+services = PluginMenuItem(
+    auth_required=True,
+    link='plugins:netbox_services:service_list',
+    link_text='Business Services',
+    buttons=(
+        PluginMenuButton(
+            link='plugins:netbox_services:service_add',
+            title='Add',
+            icon_class='mdi mdi-plus',
+        ),
+    )
+)
+
+
+menu = PluginMenu(
+    label='Business Services',
+    groups=(
+        ('Services', (services,)),
+    ),
+    icon_class='mdi mdi-receipt-text-arrow-right'
+)

netbox_services-0.0.1/netbox_services/tables.py

@@ -0,0 +1,46 @@
+import django_tables2 as tables
+
+from netbox.tables import NetBoxTable
+
+from .models import Service
+
+
+class ServiceListTable(NetBoxTable):
+    service_id = tables.Column(
+        linkify=True,
+        verbose_name='Service ID',
+
+    )
+
+    class Meta(NetBoxTable.Meta):
+        model = Service
+        fields = ('pk', 'service_id', 'type', 'tenant')
+        default_columns = ('pk', 'service_id', 'type', 'tenant')
+
+
+class ServiceTable(NetBoxTable):
+    service_id = tables.Column(
+        linkify=True,
+        verbose_name='Service ID',
+
+    )
+
+    class Meta(NetBoxTable.Meta):
+        model = Service
+        fields = (
+            'type',
+            'service_id',
+            'tenant',
+            'devices',
+            'interfaces',
+            'cables',
+            'vlans',
+            'prefixes',
+            'vrf',
+            'asns',
+            'route_targets',
+            'l2vpns',
+            'tunnels',
+            'virtual_machines',
+        )
+        default_columns = ('pk', 'service_id', 'type', 'tenant')

netbox_services-0.0.1/netbox_services/urls.py

@@ -0,0 +1,73 @@
+from django.urls import path, include
+from utilities.urls import get_model_urls
+from .views import (
+    ServiceView,
+    ServiceListView,
+    ServiceAddView,
+    ServiceEditView,
+    ServiceDeleteView,
+    ServiceRelatedDevicesView,
+    ServiceRelatedInterfacesView,
+    ServiceRelatedCablesView,
+    ServiceRelatedVLANsView,
+    ServiceRelatedPrefixesView,
+    ServiceRelatedVRFsView,
+    ServiceRelatedASNsView,
+    ServiceRelatedRouteTargetsView,
+    ServiceRelatedL2VPNsView,
+    ServiceRelatedTunnelsView,
+    ServiceRelatedVirtualMachinesView,
+)
+
+urlpatterns = [
+    path('',
+         include(get_model_urls('netbox_services', 'service', detail=False))
+         ),
+    path('<int:pk>/',
+         include(get_model_urls('netbox_services', 'service', detail=True))
+         ),
+    path('<int:pk>/relate/devices/',
+         ServiceRelatedDevicesView.as_view(),
+         name='relate_devices',
+         ),
+    path('<int:pk>/relate/interfaces/',
+         ServiceRelatedInterfacesView.as_view(),
+         name='relate_interfaces',
+         ),
+    path('<int:pk>/relate/cables/',
+         ServiceRelatedCablesView.as_view(),
+         name='relate_cables',
+         ),
+    path('<int:pk>/relate/vlans/',
+         ServiceRelatedVLANsView.as_view(),
+         name='relate_vlans',
+         ),
+    path('<int:pk>/relate/prefixes/',
+         ServiceRelatedPrefixesView.as_view(),
+         name='relate_prefixes',
+         ),
+    path('<int:pk>/relate/vrfs/',
+         ServiceRelatedVRFsView.as_view(),
+         name='relate_vrfs',
+         ),
+    path('<int:pk>/relate/asns/',
+         ServiceRelatedASNsView.as_view(),
+         name='relate_asns',
+         ),
+    path('<int:pk>/relate/route_targets/',
+         ServiceRelatedRouteTargetsView.as_view(),
+         name='relate_route_targets',
+         ),
+    path('<int:pk>/relate/l2vpns/',
+         ServiceRelatedL2VPNsView.as_view(),
+         name='relate_l2vpns',
+         ),
+    path('<int:pk>/relate/tunnels/',
+         ServiceRelatedTunnelsView.as_view(),
+         name='relate_tunnels',
+         ),
+    path('<int:pk>/relate/virtual_machines/',
+         ServiceRelatedVirtualMachinesView.as_view(),
+         name='relate_virtual_machines',
+         ),
+]

netbox_services-0.0.1/netbox_services/views.py

@@ -0,0 +1,112 @@
+from utilities.views import register_model_view
+from netbox.views.generic import ObjectView, ObjectDeleteView, ObjectEditView, ObjectListView
+
+from .models import Service
+from .tables import ServiceListTable
+from .forms import NewServiceForm
+from .forms import (
+    ServiceRelatedDevicesForm,
+    ServiceRelatedInterfacesForm,
+    ServiceRelatedCablesForm,
+    ServiceRelatedVLANsForm,
+    ServiceRelatedPrefixesForm,
+    ServiceRelatedVRFsForm,
+    ServiceRelatedASNsForm,
+    ServiceRelatedRouteTargetsForm,
+    ServiceRelatedL2VPNsForm,
+    ServiceRelatedTunnelsForm,
+    ServiceRelatedVirtualMachinesForm
+)
+
+#
+#   GENERIC VIEWS
+#
+
+
+@register_model_view(Service, name='view', path='', detail=True)
+class ServiceView(ObjectView):
+    queryset = Service.objects.all()
+    template_name = 'netbox_services/service.html'
+
+
+@register_model_view(Service, name='list', path='', detail=False)
+class ServiceListView(ObjectListView):
+    queryset = Service.objects.all()
+    table = ServiceListTable
+    template_name = 'generic/object_list.html'
+
+
+@register_model_view(Service, name='add', path='add', detail=False)
+class ServiceAddView(ObjectEditView):
+    queryset = Service.objects.all()
+    form = NewServiceForm
+
+
+@register_model_view(Service, name='edit', detail=True)
+class ServiceEditView(ObjectEditView):
+    queryset = Service.objects.all()
+    form = NewServiceForm
+
+
+@register_model_view(Service, name='delete', detail=True)
+class ServiceDeleteView(ObjectDeleteView):
+    queryset = Service.objects.all()
+
+#
+#   RELATION VIEWS
+#
+
+
+class ServiceRelatedDevicesView(ObjectEditView):
+    queryset = Service.objects.all()
+    form = ServiceRelatedDevicesForm
+
+
+class ServiceRelatedInterfacesView(ObjectEditView):
+    queryset = Service.objects.all()
+    form = ServiceRelatedInterfacesForm
+
+
+class ServiceRelatedCablesView(ObjectEditView):
+    queryset = Service.objects.all()
+    form = ServiceRelatedCablesForm
+
+
+class ServiceRelatedVLANsView(ObjectEditView):
+    queryset = Service.objects.all()
+    form = ServiceRelatedVLANsForm
+
+
+class ServiceRelatedPrefixesView(ObjectEditView):
+    queryset = Service.objects.all()
+    form = ServiceRelatedPrefixesForm
+
+
+class ServiceRelatedVRFsView(ObjectEditView):
+    queryset = Service.objects.all()
+    form = ServiceRelatedVRFsForm
+
+
+class ServiceRelatedASNsView(ObjectEditView):
+    queryset = Service.objects.all()
+    form = ServiceRelatedASNsForm
+
+
+class ServiceRelatedRouteTargetsView(ObjectEditView):
+    queryset = Service.objects.all()
+    form = ServiceRelatedRouteTargetsForm
+
+
+class ServiceRelatedL2VPNsView(ObjectEditView):
+    queryset = Service.objects.all()
+    form = ServiceRelatedL2VPNsForm
+
+
+class ServiceRelatedTunnelsView(ObjectEditView):
+    queryset = Service.objects.all()
+    form = ServiceRelatedTunnelsForm
+
+
+class ServiceRelatedVirtualMachinesView(ObjectEditView):
+    queryset = Service.objects.all()
+    form = ServiceRelatedVirtualMachinesForm

netbox_services-0.0.1/netbox_services.egg-info/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.4
+Name: netbox-services
+Version: 0.0.1
+Summary: A NetBox services Plugin for Service Providers
+Author-email: Arturo Baldo <baldoarturo@gmail.com>
+Maintainer-email: Arturo Baldo <baldoarturo@gmail.com>
+Project-URL: Documentation, https://github.com/baldoarturo/netbox-services/blob/main/README.md
+Project-URL: Source, https://github.com/baldoarturo/netbox-services
+Project-URL: Tracker, https://github.com/baldoarturo/netbox-services/issues
+Keywords: netbox-plugin
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# NetBox Services Plugin
+
+This plugin extends NetBox to manage and relate business services to network resources. It introduces a `Service` model that allows you to track various service types (such as L2VPN, L3VPN, DIA, Transit, CDN, Voice) and associate them with devices, interfaces, cables, VLANs, prefixes, VRFs, ASNs, route targets, L2VPNs, tunnels, and virtual machines.
+
+## Features
+- Add, edit, and delete business services.
+- Relate services to network objects (devices, interfaces, cables, VLANs, prefixes, VRFs, ASNs, route targets, L2VPNs, tunnels, virtual machines).
+- Filter and view services in a table with all relevant fields.
+- Custom forms and views for relating specific network objects to a service.
+- Integrated navigation and changelog support.
+
+## Usage
+- Access the plugin from the NetBox navigation menu under "Business Services".
+- Create new services and relate them to network resources.
+- Use the detail view to see all associations for a service.
+
+![alt text](02-main.png)
+
+## Why
+Because you might be looking for such a thing. 
+
+Tagging is great for simple categorization, but the NetBox Services plugin goes far beyond that by letting you model real business services and their relationships to network resources.
+
+Instead of just tagging a device or prefix as "DIA," you can create a full DIA service—like "NW-123456" from Cogent—and link it to all relevant devices, interfaces, prefixes, VRFs, ASNs, and more.
+
+For example, with a DIA service from Cogent (Service ID: NW-123456), you can:
+
+- See all devices and interfaces delivering that service.
+- Track the exact IP prefixes, VRFs, and ASNs involved.
+- Relate cables, tunnels, and even virtual machines to the service.
+- View and manage all these relationships in one place, with history and forms tailored to each resource.
+
+This gives you a true service-centric view of your network, making troubleshooting, reporting, and change management much more powerful and organized than simple tagging ever could.
+
+## Requirements
+- NetBox 4.x or later
+- Django 4.x or later
+
+## Installation
+1. Clone this repository into your NetBox `plugins` directory. You can also install it on your system / venv / coffee maker with
+```bash
+pip install netbox_services
+```
+
+2. Add `'netbox_services'` to the `PLUGINS` list in your NetBox configuration.
+
+```python
+    PLUGINS = [
+        'netbox_services'
+    ],
+```
+
+3. Run migrations: `python manage.py migrate netbox_services`
+4. Restart NetBox.
+
+## License
+MIT

netbox_services-0.0.1/netbox_services.egg-info/SOURCES.txt

@@ -0,0 +1,23 @@
+README.md
+pyproject.toml
+netbox_services/__init__.py
+netbox_services/filtersets.py
+netbox_services/forms.py
+netbox_services/models.py
+netbox_services/navigation.py
+netbox_services/tables.py
+netbox_services/urls.py
+netbox_services/views.py
+netbox_services.egg-info/PKG-INFO
+netbox_services.egg-info/SOURCES.txt
+netbox_services.egg-info/dependency_links.txt
+netbox_services.egg-info/top_level.txt
+netbox_services/api/__init__.py
+netbox_services/api/serializers.py
+netbox_services/api/urls.py
+netbox_services/api/views.py
+netbox_services/migrations/0001_initial.py
+netbox_services/migrations/0002_alter_service_asns_alter_service_cables_and_more.py
+netbox_services/migrations/0003_alter_service_options_alter_service_asns_and_more.py
+netbox_services/migrations/0004_rename_vrf_service_vrfs_alter_service_service_id.py
+netbox_services/migrations/__init__.py

netbox_services-0.0.1/netbox_services.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

netbox_services-0.0.1/netbox_services.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+dist
+netbox_services

netbox_services-0.0.1/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = [
+    "setuptools",
+    "wheel"
+]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "netbox-services"
+version = "0.0.1"
+description = "A NetBox services Plugin for Service Providers"
+requires-python = ">=3.10"
+
+authors = [
+    {name = "Arturo Baldo", email = "baldoarturo@gmail.com"}
+]
+maintainers = [
+    {name = "Arturo Baldo", email = "baldoarturo@gmail.com"},
+]
+
+readme = "README.md"
+keywords = ["netbox-plugin", ]
+
+license = {file = "LICENSE.md"}
+classifiers=[
+    'Development Status :: 3 - Alpha',
+    'Intended Audience :: Developers',
+    'Natural Language :: English',
+    "Programming Language :: Python :: 3 :: Only",
+    'Programming Language :: Python :: 3.10',
+    'Programming Language :: Python :: 3.11',
+    'Programming Language :: Python :: 3.12',
+]
+
+[project.urls]
+Documentation = "https://github.com/baldoarturo/netbox-services/blob/main/README.md"
+Source = "https://github.com/baldoarturo/netbox-services"
+Tracker = "https://github.com/baldoarturo/netbox-services/issues"
+
+[tool.setuptools.packages.find]
+exclude=["netbox_services.tests"]

netbox_services-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+