This file is indexed.

/usr/lib/python3/dist-packages/systemimage/index.py is in system-image-common 2.2-0ubuntu1.

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
# Copyright (C) 2013-2014 Canonical Ltd.
# Author: Barry Warsaw <barry@ubuntu.com>

# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; version 3 of the License.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program.  If not, see <http://www.gnu.org/licenses/>.

"""Device/channel indexes."""

__all__ = [
    'Index',
    ]


import json

from datetime import datetime, timezone
from systemimage.bag import Bag
from systemimage.helpers import phased_percentage
from systemimage.image import Image


IN_FMT = '%a %b %d %H:%M:%S %Z %Y'
OUT_FMT = '%a %b %d %H:%M:%S UTC %Y'


class Index(Bag):
    @classmethod
    def from_json(cls, data):
        """Parse the JSON data and produce an index."""
        mapping = json.loads(data)
        # Parse the global data, of which there is only the timestamp.  Even
        # though the string will contain 'UTC' (which we assert is so since we
        # can only handle UTC timestamps), strptime() will return a naive
        # datetime.  We'll turn it into an aware datetime in UTC, which is the
        # only thing that can possibly make sense.
        timestamp_str = mapping['global']['generated_at']
        assert 'UTC' in timestamp_str.split(), 'timestamps must be UTC'
        naive_generated_at = datetime.strptime(timestamp_str, IN_FMT)
        generated_at=naive_generated_at.replace(tzinfo=timezone.utc)
        global_ = Bag(generated_at=generated_at)
        # Parse the images.
        images = []
        percentage = phased_percentage()
        for image_data in mapping['images']:
            # Descriptions can be any of:
            #
            # * description
            # * description-xx (e.g. description-en)
            # * description-xx_CC (e.g. description-en_US)
            #
            # We want to preserve the keys exactly as given, and because the
            # extended forms are not Python identifiers, we'll pull these out
            # into a separate, non-Bag dictionary.
            descriptions = {}
            # We're going to mutate the dictionary during iteration.
            for key in list(image_data):
                if key.startswith('description'):
                    descriptions[key] = image_data.pop(key)
            files = image_data.pop('files', [])
            bundles = [Bag(**bundle_data) for bundle_data in files]
            image = Image(files=bundles,
                          descriptions=descriptions,
                          **image_data)
            if percentage <= image.phased_percentage:
                images.append(image)
        return cls(global_=global_, images=images)