summaryrefslogtreecommitdiffstats
path: root/dom/bindings/GenerateCSS2PropertiesWebIDL.py
blob: 0c6639263b648d17deab7b756f11ee9a18931683 (plain)
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
# This Source Code Form is subject to the terms of the Mozilla Public
# License, v. 2.0. If a copy of the MPL was not distributed with this file,
# You can obtain one at http://mozilla.org/MPL/2.0/.

import sys
import string
import argparse
import runpy

# Generates a line of WebIDL with the given spelling of the property name
# (whether camelCase, _underscorePrefixed, etc.) and the given array of
# extended attributes.


def generateLine(propName, extendedAttrs):
    return "  [%s] attribute [TreatNullAs=EmptyString] UTF8String %s;\n" % (
        ", ".join(extendedAttrs),
        propName,
    )


def generate(output, idlFilename, dataFile):
    propList = runpy.run_path(dataFile)["data"]
    props = ""
    for p in propList:
        if "Internal" in p.flags:
            continue
        # Unfortunately, even some of the getters here are fallible
        # (e.g. on nsComputedDOMStyle).
        extendedAttrs = [
            "CEReactions",
            "Throws",
            "SetterNeedsSubjectPrincipal=NonSystem",
        ]

        if p.pref != "":
            # BackdropFilter is a special case where we want WebIDL to check
            # a function instead of checking the pref directly.
            if p.method == "BackdropFilter":
                extendedAttrs.append('Func="nsCSSProps::IsBackdropFilterAvailable"')
            else:
                extendedAttrs.append('Pref="%s"' % p.pref)

        prop = p.method

        # webkit properties get a camelcase "webkitFoo" accessor
        # as well as a capitalized "WebkitFoo" alias (added here).
        if prop.startswith("Webkit"):
            extendedAttrs.append('BindingAlias="%s"' % prop)

        # Generate a name with camelCase spelling of property-name (or capitalized,
        # for Moz-prefixed properties):
        if not prop.startswith("Moz"):
            prop = prop[0].lower() + prop[1:]

        # Per spec, what's actually supposed to happen here is that we're supposed
        # to have properties for:
        #
        # 1) Each supported CSS property name, camelCased.
        # 2) Each supported name that contains or starts with dashes,
        #    without any changes to the name.
        # 3) cssFloat
        #
        # Note that "float" will cause a property called "float" to exist due to (1)
        # in that list.
        #
        # In practice, cssFloat is the only case in which "name" doesn't contain
        # "-" but also doesn't match "prop".  So the generateLine() call will
        # cover (3) and all of (1) except "float".  If we now add an alias
        # for all the cases where "name" doesn't match "prop", that will cover
        # "float" and (2).
        if prop != p.name:
            extendedAttrs.append('BindingAlias="%s"' % p.name)

        props += generateLine(prop, extendedAttrs)

    idlFile = open(idlFilename, "r")
    idlTemplate = idlFile.read()
    idlFile.close()

    output.write(
        "/* THIS IS AN AUTOGENERATED FILE.  DO NOT EDIT */\n\n"
        + string.Template(idlTemplate).substitute({"props": props})
        + "\n"
    )


def main():
    parser = argparse.ArgumentParser()
    parser.add_argument("idlFilename", help="IDL property file template")
    parser.add_argument(
        "preprocessorHeader", help="Header file to pass through the preprocessor"
    )
    args = parser.parse_args()
    generate(sys.stdout, args.idlFilename, args.preprocessorHeader)


if __name__ == "__main__":
    main()