netbox-atlassian 0.2.1__tar.gz → 0.2.4__tar.gz

{netbox_atlassian-0.2.1 → netbox_atlassian-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: netbox-atlassian
-Version: 0.2.1
+Version: 0.2.4
 Summary: NetBox plugin to display Jira issues and Confluence pages related to devices
 Author-email: sieteunoseis <jeremy.worden@gmail.com>
 License: Apache-2.0
@@ -201,6 +201,12 @@ flake8 netbox_atlassian/
 
 See [CHANGELOG.md](CHANGELOG.md) for release history.
 
+## Support
+
+If you find this plugin helpful, consider supporting development:
+
+[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-support-yellow?style=flat&logo=buy-me-a-coffee)](https://buymeacoffee.com/automatebldrs)
+
 ## License
 
 Apache 2.0

{netbox_atlassian-0.2.1 → netbox_atlassian-0.2.4}/README.md

@@ -174,6 +174,12 @@ flake8 netbox_atlassian/
 
 See [CHANGELOG.md](CHANGELOG.md) for release history.
 
+## Support
+
+If you find this plugin helpful, consider supporting development:
+
+[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-support-yellow?style=flat&logo=buy-me-a-coffee)](https://buymeacoffee.com/automatebldrs)
+
 ## License
 
 Apache 2.0

netbox_atlassian-0.2.4/netbox_atlassian/__init__.py

@@ -0,0 +1,148 @@
+"""
+NetBox Atlassian Plugin
+
+Display Jira issues and Confluence pages related to devices in NetBox.
+Searches by configurable fields (hostname, serial, role, etc.) with OR logic.
+"""
+
+import logging
+
+from netbox.plugins import PluginConfig
+
+__version__ = "0.2.4"
+
+logger = logging.getLogger(__name__)
+
+
+class AtlassianConfig(PluginConfig):
+    """Plugin configuration for NetBox Atlassian integration."""
+
+    name = "netbox_atlassian"
+    verbose_name = "Atlassian"
+    description = "Display Jira issues and Confluence pages related to devices"
+    version = __version__
+    author = "sieteunoseis"
+    author_email = "sieteunoseis@github.com"
+    base_url = "atlassian"
+    min_version = "4.0.0"
+
+    # Required settings - plugin won't load without these
+    required_settings = []
+
+    # Default configuration values
+    default_settings = {
+        # Jira settings (on-prem)
+        "jira_url": "",  # e.g., "https://jira.example.com"
+        "jira_username": "",
+        "jira_password": "",  # or API token
+        "jira_token": "",  # Personal Access Token (PAT) - preferred for on-prem
+        "jira_verify_ssl": True,
+        # Confluence settings (on-prem)
+        "confluence_url": "",  # e.g., "https://confluence.example.com"
+        "confluence_username": "",
+        "confluence_password": "",  # or API token
+        "confluence_token": "",  # Personal Access Token (PAT) - preferred for on-prem
+        "confluence_verify_ssl": True,
+        # Cloud settings (for future use)
+        "use_cloud": False,
+        "cloud_api_token": "",
+        "cloud_email": "",
+        # Search configuration
+        # Fields to search - values are device attribute paths
+        # Searches use OR logic - matches any field
+        "search_fields": [
+            {"name": "Hostname", "attribute": "name", "enabled": True},
+            {"name": "Serial", "attribute": "serial", "enabled": True},
+            {"name": "Asset Tag", "attribute": "asset_tag", "enabled": False},
+            {"name": "Role", "attribute": "role.name", "enabled": False},
+            {"name": "Primary IP", "attribute": "primary_ip4.address", "enabled": False},
+        ],
+        # Endpoint search fields (for netbox-endpoints plugin)
+        # Searches use OR logic - matches any field
+        "endpoint_search_fields": [
+            {"name": "Name", "attribute": "name", "enabled": True},
+            {"name": "MAC Address", "attribute": "mac_address", "enabled": True},
+            {"name": "Serial", "attribute": "serial", "enabled": True},
+            {"name": "Asset Tag", "attribute": "asset_tag", "enabled": False},
+        ],
+        # Jira search settings
+        "jira_max_results": 10,
+        "jira_projects": [],  # Empty = search all projects
+        "jira_issue_types": [],  # Empty = all types
+        # Confluence search settings
+        "confluence_max_results": 10,
+        "confluence_spaces": [],  # Empty = search all spaces
+        # General settings
+        "timeout": 30,
+        "cache_timeout": 300,  # Cache results for 5 minutes
+        # Enable legacy SSL renegotiation for older servers (required for OHSU wiki)
+        "enable_legacy_ssl": False,
+        # Device type filtering (like catalyst-center)
+        # Empty list = show tab for all devices
+        "device_types": [],  # e.g., ["cisco", "juniper"]
+    }
+
+    def ready(self):
+        """Register endpoint view if netbox_endpoints is available."""
+        super().ready()
+        self._register_endpoint_views()
+
+    def _register_endpoint_views(self):
+        """Register Atlassian tab for Endpoints if plugin is installed."""
+        import sys
+
+        # Quick check if netbox_endpoints is available
+        if "netbox_endpoints" not in sys.modules:
+            try:
+                import importlib.util
+
+                if importlib.util.find_spec("netbox_endpoints") is None:
+                    logger.debug("netbox_endpoints not installed, skipping endpoint view registration")
+                    return
+            except Exception:
+                logger.debug("netbox_endpoints not available, skipping endpoint view registration")
+                return
+
+        try:
+            from django.shortcuts import render
+            from netbox.views import generic
+            from netbox_endpoints.models import Endpoint
+            from utilities.views import ViewTab, register_model_view
+
+            from .views import should_show_atlassian_tab_endpoint
+
+            @register_model_view(Endpoint, name="atlassian", path="atlassian")
+            class EndpointAtlassianView(generic.ObjectView):
+                """Display Jira issues and Confluence pages for an Endpoint."""
+
+                queryset = Endpoint.objects.all()
+                template_name = "netbox_atlassian/endpoint_tab.html"
+
+                tab = ViewTab(
+                    label="Atlassian",
+                    weight=9100,
+                    permission="netbox_endpoints.view_endpoint",
+                    hide_if_empty=False,
+                    visible=should_show_atlassian_tab_endpoint,
+                )
+
+                def get(self, request, pk):
+                    endpoint = Endpoint.objects.get(pk=pk)
+                    return render(
+                        request,
+                        self.template_name,
+                        {
+                            "object": endpoint,
+                            "tab": self.tab,
+                            "loading": True,
+                        },
+                    )
+
+            logger.info("Registered Atlassian tab for Endpoint model")
+        except ImportError:
+            logger.debug("netbox_endpoints not installed, skipping endpoint view registration")
+        except Exception as e:
+            logger.warning(f"Could not register endpoint views: {e}")
+
+
+config = AtlassianConfig

{netbox_atlassian-0.2.1 → netbox_atlassian-0.2.4}/netbox_atlassian/atlassian_client.py

@@ -219,22 +219,26 @@ class AtlassianClient:
         issues = []
         for issue in result.get("issues", []):
             fields = issue.get("fields", {})
-            issues.append({
-                "key": issue.get("key"),
-                "summary": fields.get("summary", ""),
-                "status": fields.get("status", {}).get("name", ""),
-                "status_category": fields.get("status", {}).get("statusCategory", {}).get("key", ""),
-                "type": fields.get("issuetype", {}).get("name", ""),
-                "type_icon": fields.get("issuetype", {}).get("iconUrl", ""),
-                "priority": fields.get("priority", {}).get("name", "") if fields.get("priority") else "",
-                "priority_icon": fields.get("priority", {}).get("iconUrl", "") if fields.get("priority") else "",
-                "assignee": fields.get("assignee", {}).get("displayName", "") if fields.get("assignee") else "Unassigned",
-                "created": fields.get("created", ""),
-                "updated": fields.get("updated", ""),
-                "project": fields.get("project", {}).get("name", ""),
-                "project_key": fields.get("project", {}).get("key", ""),
-                "url": f"{self.jira_url}/browse/{issue.get('key')}",
-            })
+            issues.append(
+                {
+                    "key": issue.get("key"),
+                    "summary": fields.get("summary", ""),
+                    "status": fields.get("status", {}).get("name", ""),
+                    "status_category": fields.get("status", {}).get("statusCategory", {}).get("key", ""),
+                    "type": fields.get("issuetype", {}).get("name", ""),
+                    "type_icon": fields.get("issuetype", {}).get("iconUrl", ""),
+                    "priority": fields.get("priority", {}).get("name", "") if fields.get("priority") else "",
+                    "priority_icon": fields.get("priority", {}).get("iconUrl", "") if fields.get("priority") else "",
+                    "assignee": (
+                        fields.get("assignee", {}).get("displayName", "") if fields.get("assignee") else "Unassigned"
+                    ),
+                    "created": fields.get("created", ""),
+                    "updated": fields.get("updated", ""),
+                    "project": fields.get("project", {}).get("name", ""),
+                    "project_key": fields.get("project", {}).get("key", ""),
+                    "url": f"{self.jira_url}/browse/{issue.get('key')}",
+                }
+            )
 
         response = {
             "issues": issues,
@@ -308,16 +312,18 @@ class AtlassianClient:
             ancestors = page.get("ancestors", [])
             breadcrumb = " > ".join([a.get("title", "") for a in ancestors])
 
-            pages.append({
-                "id": page.get("id"),
-                "title": page.get("title", ""),
-                "space_key": space.get("key", ""),
-                "space_name": space.get("name", ""),
-                "last_modified": version.get("when", ""),
-                "last_modified_by": version.get("by", {}).get("displayName", ""),
-                "breadcrumb": breadcrumb,
-                "url": f"{self.confluence_url}{page.get('_links', {}).get('webui', '')}",
-            })
+            pages.append(
+                {
+                    "id": page.get("id"),
+                    "title": page.get("title", ""),
+                    "space_key": space.get("key", ""),
+                    "space_name": space.get("name", ""),
+                    "last_modified": version.get("when", ""),
+                    "last_modified_by": version.get("by", {}).get("displayName", ""),
+                    "breadcrumb": breadcrumb,
+                    "url": f"{self.confluence_url}{page.get('_links', {}).get('webui', '')}",
+                }
+            )
 
         response = {
             "pages": pages,

netbox_atlassian-0.2.4/netbox_atlassian/templates/netbox_atlassian/device_tab.html

@@ -0,0 +1,20 @@
+{% extends 'dcim/device/base.html' %}
+{% load helpers %}
+
+{% block content %}
+{% if loading %}
+<div id="atlassian-content"
+     hx-get="{% url 'plugins:netbox_atlassian:device_content' pk=object.pk %}"
+     hx-trigger="load"
+     hx-swap="innerHTML">
+    <div class="d-flex justify-content-center align-items-center py-5">
+        <div class="text-center">
+            <div class="spinner-border text-primary mb-3" role="status" style="width: 3rem; height: 3rem;">
+                <span class="visually-hidden">Loading...</span>
+            </div>
+            <p class="text-muted mb-0">Loading Atlassian data...</p>
+        </div>
+    </div>
+</div>
+{% endif %}
+{% endblock %}

netbox_atlassian-0.2.4/netbox_atlassian/templates/netbox_atlassian/endpoint_tab.html

@@ -0,0 +1,25 @@
+{% extends 'netbox_endpoints/endpoint.html' %}
+{% load helpers %}
+
+{% block content %}
+{% if loading %}
+<div id="atlassian-content"
+     hx-get="{% url 'plugins:netbox_atlassian:endpoint_content' pk=object.pk %}"
+     hx-trigger="load"
+     hx-swap="innerHTML">
+    <div class="d-flex justify-content-center align-items-center py-5">
+        <div class="text-center">
+            <div class="spinner-border text-primary mb-3" role="status" style="width: 3rem; height: 3rem;">
+                <span class="visually-hidden">Loading...</span>
+            </div>
+            <p class="text-muted mb-0">Loading Atlassian data...</p>
+            <p class="text-muted small">Searching Jira and Confluence</p>
+        </div>
+    </div>
+</div>
+{% elif error %}
+<div class="alert alert-warning">
+    <i class="mdi mdi-alert"></i> {{ error }}
+</div>
+{% endif %}
+{% endblock %}

netbox_atlassian-0.2.1/netbox_atlassian/templates/netbox_atlassian/device_tab.html → netbox_atlassian-0.2.4/netbox_atlassian/templates/netbox_atlassian/tab_content.html

@@ -1,7 +1,5 @@
-{% extends 'dcim/device/base.html' %}
 {% load helpers %}
 
-{% block content %}
 <div class="row">
     <div class="col-12">
         <!-- Search Terms Info -->
@@ -175,4 +173,3 @@
         </div>
     </div>
 </div>
-{% endblock %}

netbox_atlassian-0.2.4/netbox_atlassian/templates/netbox_atlassian/vm_tab.html

@@ -0,0 +1,20 @@
+{% extends 'virtualization/virtualmachine/base.html' %}
+{% load helpers %}
+
+{% block content %}
+{% if loading %}
+<div id="atlassian-content"
+     hx-get="{% url 'plugins:netbox_atlassian:vm_content' pk=object.pk %}"
+     hx-trigger="load"
+     hx-swap="innerHTML">
+    <div class="d-flex justify-content-center align-items-center py-5">
+        <div class="text-center">
+            <div class="spinner-border text-primary mb-3" role="status" style="width: 3rem; height: 3rem;">
+                <span class="visually-hidden">Loading...</span>
+            </div>
+            <p class="text-muted mb-0">Loading Atlassian data...</p>
+        </div>
+    </div>
+</div>
+{% endif %}
+{% endblock %}

netbox_atlassian-0.2.4/netbox_atlassian/urls.py

@@ -0,0 +1,30 @@
+"""
+URL patterns for NetBox Atlassian Plugin
+"""
+
+from django.urls import path
+
+from .views import (
+    ENDPOINTS_PLUGIN_INSTALLED,
+    AtlassianSettingsView,
+    DeviceAtlassianContentView,
+    TestConfluenceConnectionView,
+    TestJiraConnectionView,
+    VMAtlassianContentView,
+)
+
+urlpatterns = [
+    path("settings/", AtlassianSettingsView.as_view(), name="settings"),
+    path("test-jira/", TestJiraConnectionView.as_view(), name="test_jira"),
+    path("test-confluence/", TestConfluenceConnectionView.as_view(), name="test_confluence"),
+    path("device/<int:pk>/content/", DeviceAtlassianContentView.as_view(), name="device_content"),
+    path("vm/<int:pk>/content/", VMAtlassianContentView.as_view(), name="vm_content"),
+]
+
+# Add endpoint URLs if netbox_endpoints is installed
+if ENDPOINTS_PLUGIN_INSTALLED:
+    from .views import EndpointAtlassianContentView
+
+    urlpatterns.append(
+        path("endpoint/<int:pk>/content/", EndpointAtlassianContentView.as_view(), name="endpoint_content"),
+    )

{netbox_atlassian-0.2.1 → netbox_atlassian-0.2.4}/netbox_atlassian/views.py

@@ -10,8 +10,10 @@ import re
 from dcim.models import Device
 from django.conf import settings
 from django.contrib import messages
-from django.http import JsonResponse
+from django.contrib.auth.mixins import LoginRequiredMixin, PermissionRequiredMixin
+from django.http import HttpResponse, JsonResponse
 from django.shortcuts import render
+from django.template.loader import render_to_string
 from django.views import View
 from netbox.views import generic
 from utilities.views import ViewTab, register_model_view
@@ -20,6 +22,14 @@ from virtualization.models import VirtualMachine
 from .atlassian_client import get_client
 from .forms import AtlassianSettingsForm
 
+# Check if netbox_endpoints plugin is installed
+try:
+    from netbox_endpoints.models import Endpoint
+
+    ENDPOINTS_PLUGIN_INSTALLED = True
+except ImportError:
+    ENDPOINTS_PLUGIN_INSTALLED = False
+
 
 def get_device_attribute(device, attribute_path: str):
     """
@@ -51,6 +61,7 @@ def get_search_terms(device) -> list[str]:
     Get search terms from device based on configured search fields.
 
     Returns list of non-empty values from enabled search fields.
+    For comma-separated values (like multiple serial numbers), splits into individual terms.
     """
     config = settings.PLUGINS_CONFIG.get("netbox_atlassian", {})
     search_fields = config.get("search_fields", [])
@@ -66,7 +77,15 @@ def get_search_terms(device) -> list[str]:
 
         value = get_device_attribute(device, attribute)
         if value and value.strip():
-            terms.append(value.strip())
+            # Split comma-separated values (e.g., multiple serial numbers)
+            if "," in value:
+                for part in value.split(","):
+                    part = part.strip()
+                    if part and part not in terms:
+                        terms.append(part)
+            else:
+                if value.strip() not in terms:
+                    terms.append(value.strip())
 
     return terms
 
@@ -108,7 +127,7 @@ def should_show_atlassian_tab(device) -> bool:
 
 @register_model_view(Device, name="atlassian", path="atlassian")
 class DeviceAtlassianView(generic.ObjectView):
-    """Display Jira issues and Confluence pages for a Device."""
+    """Display Jira issues and Confluence pages for a Device with async loading."""
 
     queryset = Device.objects.all()
     template_name = "netbox_atlassian/device_tab.html"
@@ -121,7 +140,26 @@ class DeviceAtlassianView(generic.ObjectView):
     )
 
     def get(self, request, pk):
-        """Handle GET request for the Atlassian tab."""
+        """Render initial tab with loading spinner - content loads via htmx."""
+        device = Device.objects.get(pk=pk)
+        return render(
+            request,
+            self.template_name,
+            {
+                "object": device,
+                "tab": self.tab,
+                "loading": True,
+            },
+        )
+
+
+class DeviceAtlassianContentView(LoginRequiredMixin, PermissionRequiredMixin, View):
+    """HTMX endpoint that returns Atlassian content for async loading."""
+
+    permission_required = "dcim.view_device"
+
+    def get(self, request, pk):
+        """Fetch Atlassian data and return HTML content."""
         device = Device.objects.get(pk=pk)
 
         config = settings.PLUGINS_CONFIG.get("netbox_atlassian", {})
@@ -149,27 +187,28 @@ class DeviceAtlassianView(generic.ObjectView):
         jira_url = config.get("jira_url", "").rstrip("/")
         confluence_url = config.get("confluence_url", "").rstrip("/")
 
-        return render(
-            request,
-            self.template_name,
-            {
-                "object": device,
-                "tab": self.tab,
-                "search_terms": search_terms,
-                "enabled_fields": enabled_fields,
-                "jira_results": jira_results,
-                "confluence_results": confluence_results,
-                "jira_url": jira_url,
-                "confluence_url": confluence_url,
-                "jira_configured": bool(jira_url),
-                "confluence_configured": bool(confluence_url),
-            },
+        return HttpResponse(
+            render_to_string(
+                "netbox_atlassian/tab_content.html",
+                {
+                    "object": device,
+                    "search_terms": search_terms,
+                    "enabled_fields": enabled_fields,
+                    "jira_results": jira_results,
+                    "confluence_results": confluence_results,
+                    "jira_url": jira_url,
+                    "confluence_url": confluence_url,
+                    "jira_configured": bool(jira_url),
+                    "confluence_configured": bool(confluence_url),
+                },
+                request=request,
+            )
         )
 
 
 @register_model_view(VirtualMachine, name="atlassian", path="atlassian")
 class VirtualMachineAtlassianView(generic.ObjectView):
-    """Display Jira issues and Confluence pages for a VirtualMachine."""
+    """Display Jira issues and Confluence pages for a VirtualMachine with async loading."""
 
     queryset = VirtualMachine.objects.all()
     template_name = "netbox_atlassian/vm_tab.html"
@@ -182,7 +221,26 @@ class VirtualMachineAtlassianView(generic.ObjectView):
     )
 
     def get(self, request, pk):
-        """Handle GET request for the Atlassian tab."""
+        """Render initial tab with loading spinner - content loads via htmx."""
+        vm = VirtualMachine.objects.get(pk=pk)
+        return render(
+            request,
+            self.template_name,
+            {
+                "object": vm,
+                "tab": self.tab,
+                "loading": True,
+            },
+        )
+
+
+class VMAtlassianContentView(LoginRequiredMixin, PermissionRequiredMixin, View):
+    """HTMX endpoint that returns Atlassian content for VM async loading."""
+
+    permission_required = "virtualization.view_virtualmachine"
+
+    def get(self, request, pk):
+        """Fetch Atlassian data and return HTML content."""
         vm = VirtualMachine.objects.get(pk=pk)
 
         config = settings.PLUGINS_CONFIG.get("netbox_atlassian", {})
@@ -196,7 +254,6 @@ class VirtualMachineAtlassianView(generic.ObjectView):
             search_terms.append(str(vm.primary_ip4.address.ip))
 
         # Get configured search fields for display
-        search_fields = config.get("search_fields", [])
         enabled_fields = [{"name": "Name", "attribute": "name", "enabled": True}]
         if vm.primary_ip4:
             enabled_fields.append({"name": "Primary IP", "attribute": "primary_ip4", "enabled": True})
@@ -216,21 +273,22 @@ class VirtualMachineAtlassianView(generic.ObjectView):
         jira_url = config.get("jira_url", "").rstrip("/")
         confluence_url = config.get("confluence_url", "").rstrip("/")
 
-        return render(
-            request,
-            self.template_name,
-            {
-                "object": vm,
-                "tab": self.tab,
-                "search_terms": search_terms,
-                "enabled_fields": enabled_fields,
-                "jira_results": jira_results,
-                "confluence_results": confluence_results,
-                "jira_url": jira_url,
-                "confluence_url": confluence_url,
-                "jira_configured": bool(jira_url),
-                "confluence_configured": bool(confluence_url),
-            },
+        return HttpResponse(
+            render_to_string(
+                "netbox_atlassian/tab_content.html",
+                {
+                    "object": vm,
+                    "search_terms": search_terms,
+                    "enabled_fields": enabled_fields,
+                    "jira_results": jira_results,
+                    "confluence_results": confluence_results,
+                    "jira_url": jira_url,
+                    "confluence_url": confluence_url,
+                    "jira_configured": bool(jira_url),
+                    "confluence_configured": bool(confluence_url),
+                },
+                request=request,
+            )
         )
 
 
@@ -304,3 +362,145 @@ class TestConfluenceConnectionView(View):
         if success:
             return JsonResponse({"success": True, "message": message})
         return JsonResponse({"success": False, "error": message}, status=400)
+
+
+# Endpoint-specific functions for netbox_endpoints plugin
+def get_endpoint_attribute(endpoint, attribute_path: str):
+    """
+    Get an endpoint attribute by dot-separated path.
+
+    Args:
+        endpoint: Endpoint instance
+        attribute_path: Dot-separated attribute path (e.g., "name", "mac_address")
+
+    Returns:
+        Attribute value or None if not found
+    """
+    try:
+        value = endpoint
+        for part in attribute_path.split("."):
+            value = getattr(value, part, None)
+            if value is None:
+                return None
+        # Convert to string for IP addresses and MAC
+        if hasattr(value, "ip"):
+            return str(value.ip)
+        return str(value) if value else None
+    except Exception:
+        return None
+
+
+def get_endpoint_search_terms(endpoint) -> list[str]:
+    """
+    Get search terms from endpoint based on configured endpoint_search_fields.
+
+    Returns list of non-empty values from enabled search fields.
+    """
+    config = settings.PLUGINS_CONFIG.get("netbox_atlassian", {})
+    search_fields = config.get(
+        "endpoint_search_fields",
+        [
+            {"name": "Name", "attribute": "name", "enabled": True},
+            {"name": "MAC Address", "attribute": "mac_address", "enabled": True},
+            {"name": "Serial", "attribute": "serial", "enabled": True},
+        ],
+    )
+
+    terms = []
+    for field in search_fields:
+        if not field.get("enabled", True):
+            continue
+
+        attribute = field.get("attribute", "")
+        if not attribute:
+            continue
+
+        value = get_endpoint_attribute(endpoint, attribute)
+        if value and value.strip():
+            # Split comma-separated values
+            if "," in value:
+                for part in value.split(","):
+                    part = part.strip()
+                    if part and part not in terms:
+                        terms.append(part)
+            else:
+                if value.strip() not in terms:
+                    terms.append(value.strip())
+
+    return terms
+
+
+def should_show_atlassian_tab_endpoint(endpoint) -> bool:
+    """
+    Determine if the Atlassian tab should be visible for this endpoint.
+
+    Shows tab if endpoint has at least one searchable field value.
+    """
+    if not ENDPOINTS_PLUGIN_INSTALLED:
+        return False
+
+    terms = get_endpoint_search_terms(endpoint)
+    return len(terms) > 0
+
+
+# Endpoint views - only available if netbox_endpoints is installed
+if ENDPOINTS_PLUGIN_INSTALLED:
+
+    class EndpointAtlassianContentView(LoginRequiredMixin, PermissionRequiredMixin, View):
+        """HTMX endpoint that returns Atlassian content for Endpoint async loading."""
+
+        permission_required = "netbox_endpoints.view_endpoint"
+
+        def get(self, request, pk):
+            """Fetch Atlassian data and return HTML content."""
+            endpoint = Endpoint.objects.get(pk=pk)
+
+            config = settings.PLUGINS_CONFIG.get("netbox_atlassian", {})
+            client = get_client()
+
+            # Get search terms from endpoint
+            search_terms = get_endpoint_search_terms(endpoint)
+
+            # Get configured search fields for display
+            search_fields = config.get(
+                "endpoint_search_fields",
+                [
+                    {"name": "Name", "attribute": "name", "enabled": True},
+                    {"name": "MAC Address", "attribute": "mac_address", "enabled": True},
+                    {"name": "Serial", "attribute": "serial", "enabled": True},
+                ],
+            )
+            enabled_fields = [f for f in search_fields if f.get("enabled", True)]
+
+            # Search Jira and Confluence
+            jira_results = {"issues": [], "total": 0, "error": None}
+            confluence_results = {"pages": [], "total": 0, "error": None}
+
+            if search_terms:
+                jira_max = config.get("jira_max_results", 10)
+                confluence_max = config.get("confluence_max_results", 10)
+
+                jira_results = client.search_jira(search_terms, max_results=jira_max)
+                confluence_results = client.search_confluence(search_terms, max_results=confluence_max)
+
+            # Get URLs for external links
+            jira_url = config.get("jira_url", "").rstrip("/")
+            confluence_url = config.get("confluence_url", "").rstrip("/")
+
+            return HttpResponse(
+                render_to_string(
+                    "netbox_atlassian/tab_content.html",
+                    {
+                        "object": endpoint,
+                        "search_terms": search_terms,
+                        "enabled_fields": enabled_fields,
+                        "jira_results": jira_results,
+                        "confluence_results": confluence_results,
+                        "jira_url": jira_url,
+                        "confluence_url": confluence_url,
+                        "jira_configured": bool(jira_url),
+                        "confluence_configured": bool(confluence_url),
+                    },
+                    request=request,
+                )
+            )

{netbox_atlassian-0.2.1 → netbox_atlassian-0.2.4}/netbox_atlassian.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: netbox-atlassian
-Version: 0.2.1
+Version: 0.2.4
 Summary: NetBox plugin to display Jira issues and Confluence pages related to devices
 Author-email: sieteunoseis <jeremy.worden@gmail.com>
 License: Apache-2.0
@@ -201,6 +201,12 @@ flake8 netbox_atlassian/
 
 See [CHANGELOG.md](CHANGELOG.md) for release history.
 
+## Support
+
+If you find this plugin helpful, consider supporting development:
+
+[![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-support-yellow?style=flat&logo=buy-me-a-coffee)](https://buymeacoffee.com/automatebldrs)
+
 ## License
 
 Apache 2.0

{netbox_atlassian-0.2.1 → netbox_atlassian-0.2.4}/netbox_atlassian.egg-info/SOURCES.txt

@@ -12,5 +12,7 @@ netbox_atlassian.egg-info/dependency_links.txt
 netbox_atlassian.egg-info/requires.txt
 netbox_atlassian.egg-info/top_level.txt
 netbox_atlassian/templates/netbox_atlassian/device_tab.html
+netbox_atlassian/templates/netbox_atlassian/endpoint_tab.html
 netbox_atlassian/templates/netbox_atlassian/settings.html
+netbox_atlassian/templates/netbox_atlassian/tab_content.html
 netbox_atlassian/templates/netbox_atlassian/vm_tab.html

{netbox_atlassian-0.2.1 → netbox_atlassian-0.2.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "netbox-atlassian"
-version = "0.2.1"
+version = "0.2.4"
 description = "NetBox plugin to display Jira issues and Confluence pages related to devices"
 readme = "README.md"
 license = {text = "Apache-2.0"}

netbox_atlassian-0.2.1/netbox_atlassian/__init__.py

@@ -1,74 +0,0 @@
-"""
-NetBox Atlassian Plugin
-
-Display Jira issues and Confluence pages related to devices in NetBox.
-Searches by configurable fields (hostname, serial, role, etc.) with OR logic.
-"""
-
-from netbox.plugins import PluginConfig
-
-__version__ = "0.2.1"
-
-
-class AtlassianConfig(PluginConfig):
-    """Plugin configuration for NetBox Atlassian integration."""
-
-    name = "netbox_atlassian"
-    verbose_name = "Atlassian"
-    description = "Display Jira issues and Confluence pages related to devices"
-    version = __version__
-    author = "sieteunoseis"
-    author_email = "sieteunoseis@github.com"
-    base_url = "atlassian"
-    min_version = "4.0.0"
-
-    # Required settings - plugin won't load without these
-    required_settings = []
-
-    # Default configuration values
-    default_settings = {
-        # Jira settings (on-prem)
-        "jira_url": "",  # e.g., "https://jira.example.com"
-        "jira_username": "",
-        "jira_password": "",  # or API token
-        "jira_token": "",  # Personal Access Token (PAT) - preferred for on-prem
-        "jira_verify_ssl": True,
-        # Confluence settings (on-prem)
-        "confluence_url": "",  # e.g., "https://confluence.example.com"
-        "confluence_username": "",
-        "confluence_password": "",  # or API token
-        "confluence_token": "",  # Personal Access Token (PAT) - preferred for on-prem
-        "confluence_verify_ssl": True,
-        # Cloud settings (for future use)
-        "use_cloud": False,
-        "cloud_api_token": "",
-        "cloud_email": "",
-        # Search configuration
-        # Fields to search - values are device attribute paths
-        # Searches use OR logic - matches any field
-        "search_fields": [
-            {"name": "Hostname", "attribute": "name", "enabled": True},
-            {"name": "Serial", "attribute": "serial", "enabled": True},
-            {"name": "Asset Tag", "attribute": "asset_tag", "enabled": False},
-            {"name": "Role", "attribute": "role.name", "enabled": False},
-            {"name": "Primary IP", "attribute": "primary_ip4.address", "enabled": False},
-        ],
-        # Jira search settings
-        "jira_max_results": 10,
-        "jira_projects": [],  # Empty = search all projects
-        "jira_issue_types": [],  # Empty = all types
-        # Confluence search settings
-        "confluence_max_results": 10,
-        "confluence_spaces": [],  # Empty = search all spaces
-        # General settings
-        "timeout": 30,
-        "cache_timeout": 300,  # Cache results for 5 minutes
-        # Enable legacy SSL renegotiation for older servers (required for OHSU wiki)
-        "enable_legacy_ssl": False,
-        # Device type filtering (like catalyst-center)
-        # Empty list = show tab for all devices
-        "device_types": [],  # e.g., ["cisco", "juniper"]
-    }
-
-
-config = AtlassianConfig

netbox_atlassian-0.2.1/netbox_atlassian/templates/netbox_atlassian/vm_tab.html

@@ -1,178 +0,0 @@
-{% extends 'virtualization/virtualmachine/base.html' %}
-{% load helpers %}
-
-{% block content %}
-<div class="row">
-    <div class="col-12">
-        <!-- Search Terms Info -->
-        <div class="alert alert-info mb-3">
-            <i class="mdi mdi-magnify"></i>
-            <strong>Searching for:</strong>
-            {% for term in search_terms %}
-            <span class="badge bg-info text-white ms-1">{{ term }}</span>{% if not forloop.last %}<span class="text-muted ms-1">OR</span>{% endif %}
-            {% empty %}
-            <span class="text-muted">No search terms available</span>
-            {% endfor %}
-            <br>
-            <small class="text-muted">
-                Fields: {% for field in enabled_fields %}{{ field.name }}{% if not forloop.last %}, {% endif %}{% endfor %}
-            </small>
-        </div>
-
-        <div class="row">
-            <!-- Jira Issues Column -->
-            <div class="col-md-6 mb-4">
-                <div class="card h-100">
-                    <div class="card-header d-flex justify-content-between align-items-center">
-                        <h5 class="card-title mb-0">
-                            <i class="mdi mdi-jira text-primary"></i> Jira Issues
-                            {% if jira_results.total > 0 %}
-                            <span class="badge bg-info text-white">{{ jira_results.total }} issue{{ jira_results.total|pluralize }}</span>
-                            {% endif %}
-                        </h5>
-                        {% if jira_url %}
-                        <a href="{{ jira_url }}" target="_blank" class="btn btn-sm btn-outline-primary">
-                            <i class="mdi mdi-open-in-new"></i> Open Jira
-                        </a>
-                        {% endif %}
-                    </div>
-                    <div class="card-body">
-                        {% if not jira_configured %}
-                        <div class="alert alert-warning mb-0">
-                            <i class="mdi mdi-alert"></i> Jira not configured
-                        </div>
-                        {% elif jira_results.error %}
-                        <div class="alert alert-danger mb-0">
-                            <i class="mdi mdi-alert-circle"></i> {{ jira_results.error }}
-                        </div>
-                        {% elif jira_results.issues %}
-                        <div class="table-responsive">
-                            <table class="table table-sm table-hover mb-0">
-                                <thead>
-                                    <tr>
-                                        <th>Key</th>
-                                        <th>Summary</th>
-                                        <th>Status</th>
-                                        <th>Type</th>
-                                    </tr>
-                                </thead>
-                                <tbody>
-                                    {% for issue in jira_results.issues %}
-                                    <tr>
-                                        <td>
-                                            <a href="{{ issue.url }}" target="_blank" class="fw-bold">
-                                                {{ issue.key }}
-                                            </a>
-                                        </td>
-                                        <td>
-                                            <span title="{{ issue.summary }}">
-                                                {{ issue.summary|truncatechars:50 }}
-                                            </span>
-                                        </td>
-                                        <td>
-                                            {% if issue.status_category == 'done' %}
-                                            <span class="badge bg-success text-white">{{ issue.status }}</span>
-                                            {% elif issue.status_category == 'indeterminate' %}
-                                            <span class="badge bg-primary text-white">{{ issue.status }}</span>
-                                            {% else %}
-                                            <span class="badge bg-secondary text-white">{{ issue.status }}</span>
-                                            {% endif %}
-                                        </td>
-                                        <td>
-                                            {% if issue.type_icon %}
-                                            <img src="{{ issue.type_icon }}" alt="{{ issue.type }}" width="16" height="16" class="me-1">
-                                            {% endif %}
-                                            {{ issue.type }}
-                                        </td>
-                                    </tr>
-                                    {% endfor %}
-                                </tbody>
-                            </table>
-                        </div>
-                        {% if jira_results.total > jira_results.issues|length %}
-                        <div class="text-muted small mt-2">
-                            Showing {{ jira_results.issues|length }} of {{ jira_results.total }} results
-                        </div>
-                        {% endif %}
-                        {% else %}
-                        <div class="text-muted text-center py-4">
-                            <i class="mdi mdi-information-outline fs-1"></i>
-                            <p class="mb-0">No Jira issues found</p>
-                        </div>
-                        {% endif %}
-
-                        {% if jira_results.cached %}
-                        <div class="text-muted small mt-2">
-                            <i class="mdi mdi-cached"></i> Results from cache
-                        </div>
-                        {% endif %}
-                    </div>
-                </div>
-            </div>
-
-            <!-- Confluence Pages Column -->
-            <div class="col-md-6 mb-4">
-                <div class="card h-100">
-                    <div class="card-header d-flex justify-content-between align-items-center">
-                        <h5 class="card-title mb-0">
-                            <i class="mdi mdi-file-document text-info"></i> Confluence Pages
-                            {% if confluence_results.total > 0 %}
-                            <span class="badge bg-info text-white">{{ confluence_results.total }} page{{ confluence_results.total|pluralize }}</span>
-                            {% endif %}
-                        </h5>
-                        {% if confluence_url %}
-                        <a href="{{ confluence_url }}" target="_blank" class="btn btn-sm btn-outline-info">
-                            <i class="mdi mdi-open-in-new"></i> Open Confluence
-                        </a>
-                        {% endif %}
-                    </div>
-                    <div class="card-body">
-                        {% if not confluence_configured %}
-                        <div class="alert alert-warning mb-0">
-                            <i class="mdi mdi-alert"></i> Confluence not configured
-                        </div>
-                        {% elif confluence_results.error %}
-                        <div class="alert alert-danger mb-0">
-                            <i class="mdi mdi-alert-circle"></i> {{ confluence_results.error }}
-                        </div>
-                        {% elif confluence_results.pages %}
-                        <div class="list-group list-group-flush">
-                            {% for page in confluence_results.pages %}
-                            <a href="{{ page.url }}" target="_blank" class="list-group-item list-group-item-action">
-                                <div class="d-flex w-100 justify-content-between">
-                                    <h6 class="mb-1">{{ page.title }}</h6>
-                                    <small class="text-muted">{{ page.space_key }}</small>
-                                </div>
-                                {% if page.breadcrumb %}
-                                <small class="text-muted">{{ page.breadcrumb }}</small>
-                                {% endif %}
-                                <small class="text-muted d-block">
-                                    Last modified by {{ page.last_modified_by }}
-                                </small>
-                            </a>
-                            {% endfor %}
-                        </div>
-                        {% if confluence_results.total > confluence_results.pages|length %}
-                        <div class="text-muted small mt-2">
-                            Showing {{ confluence_results.pages|length }} of {{ confluence_results.total }} results
-                        </div>
-                        {% endif %}
-                        {% else %}
-                        <div class="text-muted text-center py-4">
-                            <i class="mdi mdi-information-outline fs-1"></i>
-                            <p class="mb-0">No Confluence pages found</p>
-                        </div>
-                        {% endif %}
-
-                        {% if confluence_results.cached %}
-                        <div class="text-muted small mt-2">
-                            <i class="mdi mdi-cached"></i> Results from cache
-                        </div>
-                        {% endif %}
-                    </div>
-                </div>
-            </div>
-        </div>
-    </div>
-</div>
-{% endblock %}

netbox_atlassian-0.2.1/netbox_atlassian/urls.py

@@ -1,17 +0,0 @@
-"""
-URL patterns for NetBox Atlassian Plugin
-"""
-
-from django.urls import path
-
-from .views import (
-    AtlassianSettingsView,
-    TestConfluenceConnectionView,
-    TestJiraConnectionView,
-)
-
-urlpatterns = [
-    path("settings/", AtlassianSettingsView.as_view(), name="settings"),
-    path("test-jira/", TestJiraConnectionView.as_view(), name="test_jira"),
-    path("test-confluence/", TestConfluenceConnectionView.as_view(), name="test_confluence"),
-]