dom/bindings/GenerateCSS2PropertiesWebIDL.py
author Josh Matthews <josh@joshmatthews.net>
Thu, 28 May 2015 13:23:56 -0400
changeset 266125 a8c1768e0d8799b39d6485d1b0c333f5e6aeef52
parent 229550 84e73f166d2146d61ef516f050ce72dec6a50e8c
child 290431 0ed3871c8b48ae9ac5c88498343135ec647fb379
permissions -rw-r--r--
Bug 1059081 - Add a threadsafe wrapper for persistent nsMultiplexStream queues. r=nfroyd, a=ritu

# 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

propList = eval(sys.stdin.read())
props = ""
for [name, prop, id, flags, pref] in propList:
    extendedAttrs = ["Throws", "TreatNullAs=EmptyString"]
    # To limit the overhead of Func= annotations, we only generate them when
    # necessary, which is when the
    # CSS_PROPERTY_ALWAYS_ENABLED_IN_CHROME_OR_CERTIFIED_APP flag is set.
    # Otherwise, we try to get by with just a Pref= annotation or no annotation
    # at all.
    if "CSS_PROPERTY_ALWAYS_ENABLED_IN_CHROME_OR_CERTIFIED_APP" in flags:
        extendedAttrs.append('Func="IsCSSPropertyExposedToJS<eCSSProperty_%s>"' % id)
    # The following is an 'elif' because it is the responsibility of
    # IsCSSPropertyExposedToJS to handle the pref if there is one.
    elif pref is not "":
        extendedAttrs.append('Pref="%s"' % pref)
    if not prop.startswith("Moz"):
        prop = prop[0].lower() + prop[1:]
    # Unfortunately, even some of the getters here are fallible
    # (e.g. on nsComputedDOMStyle).
    props += "  [%s] attribute DOMString %s;\n" % (", ".join(extendedAttrs),
                                                   prop)
    # 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 dashes but doesn't start with a
    #    dash, 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 stuff we did with "prop" covers (3)
    # and all of (1) except "float".   If we now output attributes for all the
    # cases where "name" doesn't match "prop" and "name" doesn't start with "-",
    # that will cover "float" and (2).
    if prop != name and name[0] != "-":
        extendedAttrs.append('BinaryName="%s"' % prop)
        # Throw in a '_' before the attribute name, because some of these
        # property names collide with IDL reserved words.
        props += "  [%s] attribute DOMString _%s;\n" % (", ".join(extendedAttrs),
                                                       name)

idlFile = open(sys.argv[1], "r");
idlTemplate = idlFile.read();
idlFile.close();

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