/usr/lib/python2.7/dist-packages/metadataserver/models/nodecommissionresult.py is in python-django-maas 1.5.4+bzr2294-0ubuntu1.2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 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 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 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 | # Copyright 2012-2014 Canonical Ltd. This software is licensed under the
# GNU Affero General Public License version 3 (see the file LICENSE).
""":class:`NodeCommissionResult` model."""
from __future__ import (
absolute_import,
print_function,
unicode_literals,
)
str = None
__metaclass__ = type
__all__ = [
'NodeCommissionResult',
]
from django.db.models import (
CharField,
ForeignKey,
IntegerField,
Manager,
)
from django.shortcuts import get_object_or_404
from django.utils.html import escape
from maasserver.models.cleansave import CleanSave
from maasserver.models.timestampedmodel import TimestampedModel
from metadataserver import DefaultMeta
from metadataserver.fields import BinaryField
class NodeCommissionResultManager(Manager):
"""Utility to manage a collection of :class:`NodeCommissionResult`s."""
def clear_results(self, node):
"""Remove all existing results for a node."""
self.filter(node=node).delete()
def store_data(self, node, name, script_result, data):
"""Store data about a node.
:param node: The node that this result pertains to.
:type node: :class:`maasserver.models.Node`
:param name: The name of this result, typically the name of
the commissioning script that generated it.
:type name: string
:param script_result: The exit code of the commissioning
script.
:type script_result: int
:param data: The raw binary output of the commissioning
script.
:type data: :class:`metadataserver.fields.Bin`
"""
existing, created = self.get_or_create(
node=node, name=name,
defaults=dict(script_result=script_result, data=data))
if not created:
existing.script_result = script_result
existing.data = data
existing.save()
return existing
def get_data(self, node, name):
"""Get data about a node."""
ncr = get_object_or_404(NodeCommissionResult, node=node, name=name)
return ncr.data
class NodeCommissionResult(CleanSave, TimestampedModel):
"""Storage for data returned from node commissioning.
Commissioning a node results in various bits of data that need to be
stored, such as lshw output. This model allows storing of this data
as unicode text, with an arbitrary name, for later retrieval.
:ivar node: The context :class:`Node`.
:ivar status: If this data results from the execution of a script, this
is the status of this execution. This can be "OK", "FAILED" or
"WORKING" for progress reports.
:ivar name: A unique name to use for the data being stored.
:ivar data: The file's actual data, unicode only.
"""
class Meta(DefaultMeta):
unique_together = ('node', 'name')
objects = NodeCommissionResultManager()
node = ForeignKey(
'maasserver.Node', null=False, editable=False, unique=False)
script_result = IntegerField(editable=False)
name = CharField(max_length=255, unique=False, editable=False)
data = BinaryField(
max_length=1024 * 1024, editable=True, blank=True, default=b'',
null=False)
def __unicode__(self):
return "%s/%s" % (self.node.system_id, self.name)
def get_data_as_html(self):
"""More-or-less human-readable HTML representation of the output."""
return escape(self.data.decode('utf-8', 'replace'))
|