/usr/lib/python2.7/dist-packages/maasserver/utils/jsenums.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 109 110 111 112 | # Copyright 2012-2014 Canonical Ltd. This software is licensed under the
# GNU Affero General Public License version 3 (see the file LICENSE).
"""Generate JavaScript enum definitions based on Python definitions.
MAAS defines its enums as simple classes, with the enum items as attributes.
Running this script produces a source text containing the JavaScript
equivalents of the same enums, so that JavaScript code can make use of them.
The script takes the filename of the enum modules. Each will be compiled and
executed in an empty namespace, though they will have access to other MAAS
libraries, including their dependencies.
The resulting JavaScript module is printed to standard output.
"""
from __future__ import (
absolute_import,
print_function,
unicode_literals,
)
str = None
__metaclass__ = type
__all__ = []
from argparse import ArgumentParser
from datetime import datetime
from itertools import chain
import json
from operator import attrgetter
import os.path
import sys
from textwrap import dedent
from maasserver.utils import map_enum
# Header. Will be written on top of the output.
header = dedent("""\
/*
Generated file. DO NOT EDIT.
This file was generated by %(script)s,
on %(timestamp)s.
*/
YUI.add('maas.enums', function(Y) {
Y.log('loading maas.enums');
var module = Y.namespace('maas.enums');
""" % {
'script': os.path.basename(sys.argv[0]),
'timestamp': datetime.now(),
})
# Footer. Will be written at the bottom.
footer = "}, '0.1');"
def is_enum(item):
"""Does the given python item look like an enum?
:param item: An item imported from a MAAS enum module.
:return: Bool.
"""
return isinstance(item, type) and item.__name__.isupper()
def get_enum_classes(namespace):
"""Collect all enum classes exported from `namespace`."""
return filter(is_enum, namespace.values())
def get_enums(filename):
namespace = {}
with open(filename, "rbU") as fd:
source = fd.read()
code = compile(source, filename, "exec")
exec(code, namespace)
return get_enum_classes(namespace)
def serialize_enum(enum):
"""Represent a MAAS enum class in JavaScript."""
definitions = json.dumps(map_enum(enum), indent=4, sort_keys=True)
definitions = '\n'.join(
line.rstrip()
for line in definitions.splitlines()
)
return "module.%s = %s;\n" % (enum.__name__, definitions)
def parse_args():
"""Parse options & arguments."""
parser = ArgumentParser(description=__doc__)
parser.add_argument(
'sources', metavar="FILENAME", nargs='+',
help="File to search for enums.")
return parser.parse_args()
def dump(source_filenames):
enums = chain.from_iterable(
get_enums(filename) for filename in source_filenames)
enums = sorted(enums, key=attrgetter("__name__"))
dumps = [serialize_enum(enum) for enum in enums]
return "\n".join([header] + dumps + [footer])
if __name__ == "__main__":
args = parse_args()
print(dump(args.sources))
|