Skip to content

Models

nautobot_chatops.models

Django models for recording user interactions with Nautobot.

AccessGrant

Bases: PrimaryModel

Record of a single form of access granted to the chatbot.

Source code in nautobot_chatops/models.py 
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
class AccessGrant(PrimaryModel):
    """Record of a single form of access granted to the chatbot."""

    command = models.CharField(max_length=64, help_text=ACCESS_GRANT_COMMAND_HELP_TEXT)
    subcommand = models.CharField(
        max_length=64,
        help_text=ACCESS_GRANT_SUBCOMMAND_HELP_TEXT,
    )

    grant_type = models.CharField(max_length=32, choices=AccessGrantTypeChoices)

    name = models.CharField(max_length=255, help_text=ACCESS_GRANT_NAME_HELP_TEXT)
    value = models.CharField(
        max_length=255,
        help_text=ACCESS_GRANT_VALUE_HELP_TEXT,
    )

    def clean(self):
        """Model validation logic."""
        super().clean()
        if self.command == "*" and self.subcommand != "*":
            raise ValidationError("Use of a command wildcard with a non-wildcard subcommand is not permitted")

    def __str__(self):
        """String representation of an AccessGrant."""
        return f'cmd: "{self.command} {self.subcommand}", {self.grant_type}: "{self.name}" ({self.value})'

    def get_absolute_url(self, api=False):
        """Override the objects absolute url since we have no detail view."""
        return reverse("plugins:nautobot_chatops:accessgrant_list")

    class Meta:
        """Meta-attributes of an AccessGrant."""

        ordering = ["command", "subcommand", "grant_type"]
        unique_together = [["command", "subcommand", "grant_type", "value"]]

Meta

Meta-attributes of an AccessGrant.

Source code in nautobot_chatops/models.py 
121
122
123
124
125
class Meta:
    """Meta-attributes of an AccessGrant."""

    ordering = ["command", "subcommand", "grant_type"]
    unique_together = [["command", "subcommand", "grant_type", "value"]]

__str__()

String representation of an AccessGrant.

Source code in nautobot_chatops/models.py 
113
114
115
def __str__(self):
    """String representation of an AccessGrant."""
    return f'cmd: "{self.command} {self.subcommand}", {self.grant_type}: "{self.name}" ({self.value})'

clean()

Model validation logic.

Source code in nautobot_chatops/models.py 
107
108
109
110
111
def clean(self):
    """Model validation logic."""
    super().clean()
    if self.command == "*" and self.subcommand != "*":
        raise ValidationError("Use of a command wildcard with a non-wildcard subcommand is not permitted")

get_absolute_url(api=False)

Override the objects absolute url since we have no detail view.

Source code in nautobot_chatops/models.py 
117
118
119
def get_absolute_url(self, api=False):
    """Override the objects absolute url since we have no detail view."""
    return reverse("plugins:nautobot_chatops:accessgrant_list")

Bases: PrimaryModel

Connect ChatOps User with Nautobot User.

Source code in nautobot_chatops/models.py 
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
class ChatOpsAccountLink(PrimaryModel):
    """Connect ChatOps User with Nautobot User."""

    nautobot_user = models.ForeignKey(
        to=settings.AUTH_USER_MODEL,
        on_delete=models.CASCADE,
        related_name="chatops_user",
        verbose_name="User",
    )
    platform = models.CharField(max_length=32, choices=PlatformChoices)
    user_id = models.CharField(max_length=255, help_text=CHATOPS_USER_ID_HELP_TEXT, verbose_name="Chat User ID")
    email = models.EmailField(blank=True)

    def __str__(self):
        """String representation of a ChatOps Account Link."""
        return f"{self.nautobot_user.username} -> {self.platform} {self.user_id}"

    class Meta:
        """Metadata for ChatOps Account Link."""

        unique_together = [["user_id", "platform"]]
        verbose_name = "ChatOps Account Link"

Meta

Metadata for ChatOps Account Link.

Source code in nautobot_chatops/models.py 
167
168
169
170
171
class Meta:
    """Metadata for ChatOps Account Link."""

    unique_together = [["user_id", "platform"]]
    verbose_name = "ChatOps Account Link"

__str__()

String representation of a ChatOps Account Link.

Source code in nautobot_chatops/models.py 
163
164
165
def __str__(self):
    """String representation of a ChatOps Account Link."""
    return f"{self.nautobot_user.username} -> {self.platform} {self.user_id}"

CommandLog

Bases: PrimaryModel

Record of a single fully-executed Nautobot command.

Incomplete commands (those requiring additional user input) should not be recorded, nor should any "help" commands or invalid command entries.

Source code in nautobot_chatops/models.py 
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
class CommandLog(PrimaryModel):  # pylint: disable=nb-string-field-blank-null
    """Record of a single fully-executed Nautobot command.

    Incomplete commands (those requiring additional user input) should not be recorded,
    nor should any "help" commands or invalid command entries.
    """

    start_time = models.DateTimeField(null=True)
    runtime = models.DurationField(null=True)

    user_name = models.CharField(max_length=255, help_text=COMMAND_LOG_USER_NAME_HELP_TEXT)
    user_id = models.CharField(max_length=255, help_text=COMMAND_LOG_USER_ID_HELP_TEXT)
    platform = models.CharField(max_length=64, help_text=COMMAND_LOG_PLATFORM_HELP_TEXT)
    platform_color = ColorField()

    command = models.CharField(max_length=64, help_text=COMMAND_LOG_COMMAND_TEXT)
    subcommand = models.CharField(max_length=64, help_text=COMMAND_LOG_SUBCOMMAND_HELP_TEXT)

    params = models.JSONField(default=list, help_text=COMMAND_LOG_PARAMS_HELP_TEXT)

    status = models.CharField(
        max_length=32,
        choices=CommandStatusChoices,
        default=CommandStatusChoices.STATUS_SUCCEEDED,
    )
    details = models.CharField(max_length=255, default="")
    nautobot_user = models.ForeignKey(
        to=settings.AUTH_USER_MODEL,
        on_delete=models.SET_NULL,
        blank=True,
        null=True,
        related_name="command_log",
    )

    @property
    def status_label_class(self):
        """Bootstrap CSS label class for each status value."""
        # pylint: disable=no-else-return
        if self.status == CommandStatusChoices.STATUS_SUCCEEDED:
            return "success"
        elif self.status == CommandStatusChoices.STATUS_BLOCKED:
            return "default"
        elif self.status == CommandStatusChoices.STATUS_FAILED:
            return "warning"
        else:  # STATUS_ERRORED, STATUS_UNKNOWN
            return "danger"

    def __str__(self):
        """String representation of a CommandLog entry."""
        return f"{self.user_name} on {self.platform}: {self.command} {self.subcommand} {self.params} ({self.status})"

    def get_absolute_url(self, api=False):
        """Override the objects absolute url since we have no detail view."""
        return reverse("plugins:nautobot_chatops:commandlog_list")

    class Meta:
        """Meta-attributes of a CommandLog."""

        ordering = ["start_time"]

status_label_class property

Bootstrap CSS label class for each status value.

Meta

Meta-attributes of a CommandLog.

Source code in nautobot_chatops/models.py 
84
85
86
87
class Meta:
    """Meta-attributes of a CommandLog."""

    ordering = ["start_time"]

__str__()

String representation of a CommandLog entry.

Source code in nautobot_chatops/models.py 
76
77
78
def __str__(self):
    """String representation of a CommandLog entry."""
    return f"{self.user_name} on {self.platform}: {self.command} {self.subcommand} {self.params} ({self.status})"

get_absolute_url(api=False)

Override the objects absolute url since we have no detail view.

Source code in nautobot_chatops/models.py 
80
81
82
def get_absolute_url(self, api=False):
    """Override the objects absolute url since we have no detail view."""
    return reverse("plugins:nautobot_chatops:commandlog_list")

CommandToken

Bases: PrimaryModel

Record of a Token granted for the chat platform and chat command.

Source code in nautobot_chatops/models.py 
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
class CommandToken(PrimaryModel):
    """Record of a Token granted for the chat platform and chat command."""

    comment = models.CharField(max_length=255, help_text=COMMAND_TOKEN_COMMENT_HELP_TEXT, blank=True, default="")
    platform = models.CharField(max_length=32, choices=PlatformChoices)
    token = models.CharField(max_length=255, help_text=COMMAND_TOKEN_TOKEN_HELP_TEXT)

    def __str__(self):
        """String representation of a CommandToken."""
        return f'platform: "{self.platform}", token: "{self.token}", comment: "{self.comment}"'

    def get_absolute_url(self, api=False):
        """Override the objects absolute url since we have no detail view."""
        return reverse("plugins:nautobot_chatops:commandtoken_list")

    class Meta:
        """Meta-attributes of a CommandToken."""

        ordering = ["platform", "token", "comment"]
        unique_together = [["platform", "token"]]

Meta

Meta-attributes of a CommandToken.

Source code in nautobot_chatops/models.py 
143
144
145
146
147
class Meta:
    """Meta-attributes of a CommandToken."""

    ordering = ["platform", "token", "comment"]
    unique_together = [["platform", "token"]]

__str__()

String representation of a CommandToken.

Source code in nautobot_chatops/models.py 
135
136
137
def __str__(self):
    """String representation of a CommandToken."""
    return f'platform: "{self.platform}", token: "{self.token}", comment: "{self.comment}"'

get_absolute_url(api=False)

Override the objects absolute url since we have no detail view.

Source code in nautobot_chatops/models.py 
139
140
141
def get_absolute_url(self, api=False):
    """Override the objects absolute url since we have no detail view."""
    return reverse("plugins:nautobot_chatops:commandtoken_list")

GrafanaDashboard

Bases: PrimaryModel

Model for dashboards.

Source code in nautobot_chatops/integrations/grafana/models.py 
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
@extras_features(
    "custom_fields",
    "custom_links",
    "custom_validators",
    "export_templates",
    "relationships",
    "statuses",
    "webhooks",
)
# pylint: disable-next=too-many-ancestors
class GrafanaDashboard(PrimaryModel):
    """Model for dashboards."""

    dashboard_slug = models.CharField(max_length=255, unique=True, blank=False)
    friendly_name = models.CharField(max_length=255, default="", blank=True)
    dashboard_uid = models.CharField(max_length=64, unique=True, blank=False)

    class Meta:
        """Metadata for the model."""

        ordering = ["dashboard_slug"]

    def __str__(self):
        """String value for HTML rendering."""
        return f"{self.dashboard_slug}"

Meta

Metadata for the model.

Source code in nautobot_chatops/integrations/grafana/models.py 
45
46
47
48
class Meta:
    """Metadata for the model."""

    ordering = ["dashboard_slug"]

__str__()

String value for HTML rendering.

Source code in nautobot_chatops/integrations/grafana/models.py 
50
51
52
def __str__(self):
    """String value for HTML rendering."""
    return f"{self.dashboard_slug}"

GrafanaPanel

Bases: OrganizationalModel

Model for GrafanaDashboard Panels.

Source code in nautobot_chatops/integrations/grafana/models.py 
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
@extras_features(
    "custom_fields",
    "custom_links",
    "custom_validators",
    "export_templates",
    "relationships",
    "webhooks",
)
# pylint: disable-next=too-many-ancestors
class GrafanaPanel(OrganizationalModel):
    """Model for GrafanaDashboard Panels."""

    dashboard = models.ForeignKey(GrafanaDashboard, on_delete=models.CASCADE)
    command_name = models.CharField(max_length=64, blank=False)
    friendly_name = models.CharField(max_length=64, default="", blank=False)
    panel_id = models.IntegerField(blank=False)
    active = models.BooleanField(default=False)

    class Meta:
        """Metadata for the model."""

        ordering = ["command_name", "dashboard"]

    def __str__(self):
        """String value for HTML rendering."""
        return f"{self.command_name}"

Meta

Metadata for the model.

Source code in nautobot_chatops/integrations/grafana/models.py 
76
77
78
79
class Meta:
    """Metadata for the model."""

    ordering = ["command_name", "dashboard"]

__str__()

String value for HTML rendering.

Source code in nautobot_chatops/integrations/grafana/models.py 
81
82
83
def __str__(self):
    """String value for HTML rendering."""
    return f"{self.command_name}"

GrafanaPanelVariable

Bases: OrganizationalModel

Model for GrafanaDashboard GrafanaPanel Variables.

Source code in nautobot_chatops/integrations/grafana/models.py 
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
@extras_features(
    "custom_fields",
    "custom_links",
    "custom_validators",
    "export_templates",
    "relationships",
    "webhooks",
)
# pylint: disable-next=too-many-ancestors
class GrafanaPanelVariable(OrganizationalModel):
    """Model for GrafanaDashboard GrafanaPanel Variables."""

    panel = models.ForeignKey(GrafanaPanel, on_delete=models.CASCADE)
    name = models.CharField(max_length=32, blank=False)
    friendly_name = models.CharField(max_length=64)
    query = models.CharField(max_length=64, verbose_name="Model")
    includeincmd = models.BooleanField(default=False)
    includeinurl = models.BooleanField(default=True)
    modelattr = models.CharField(max_length=64)
    value = models.TextField(max_length=64)
    response = models.CharField(max_length=255)
    filter = models.JSONField(blank=True, default=dict, encoder=DjangoJSONEncoder)
    positional_order = models.IntegerField(default=100)

    class Meta:
        """Metadata for the model."""

        ordering = ["name"]

    def __str__(self):
        """String value for HTML rendering."""
        return f"{self.name}"

    def clean(self):
        """Override clean to do custom validation."""
        super().clean()

        # Raise error if a query (model) is specified but an associated attribute is not.
        if self.query and not self.modelattr:
            raise ValidationError(_("A modelattr must be specified when a query is set!"))

        # Validate that the model name passed in is correct, and that the modelattr is an element
        # on the model.
        for nb_model in VALID_MODELS:
            if hasattr(nb_model, str(self.query)):
                model = getattr(nb_model, str(self.query))
                if hasattr(model, str(self.modelattr)):
                    return

                raise ValidationError(
                    _(
                        f"Nautobot model `{self.query}` does not have an attribute of `{self.modelattr}`."
                        f" {[f.name for f in model._meta.fields if not f.name.startswith('_')]}"
                    )
                )

        raise ValidationError(_(f"`{self.query}` is not a valid Nautobot model."))

Meta

Metadata for the model.

Source code in nautobot_chatops/integrations/grafana/models.py 
113
114
115
116
class Meta:
    """Metadata for the model."""

    ordering = ["name"]

__str__()

String value for HTML rendering.

Source code in nautobot_chatops/integrations/grafana/models.py 
118
119
120
def __str__(self):
    """String value for HTML rendering."""
    return f"{self.name}"

clean()

Override clean to do custom validation.

Source code in nautobot_chatops/integrations/grafana/models.py 
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
def clean(self):
    """Override clean to do custom validation."""
    super().clean()

    # Raise error if a query (model) is specified but an associated attribute is not.
    if self.query and not self.modelattr:
        raise ValidationError(_("A modelattr must be specified when a query is set!"))

    # Validate that the model name passed in is correct, and that the modelattr is an element
    # on the model.
    for nb_model in VALID_MODELS:
        if hasattr(nb_model, str(self.query)):
            model = getattr(nb_model, str(self.query))
            if hasattr(model, str(self.modelattr)):
                return

            raise ValidationError(
                _(
                    f"Nautobot model `{self.query}` does not have an attribute of `{self.modelattr}`."
                    f" {[f.name for f in model._meta.fields if not f.name.startswith('_')]}"
                )
            )

    raise ValidationError(_(f"`{self.query}` is not a valid Nautobot model."))