src/third_party/WebKit/Source/build/scripts/name_utilities.py

   1 # Copyright (C) 2013 Google Inc. All rights reserved.
   2 #
   3 # Redistribution and use in source and binary forms, with or without
   4 # modification, are permitted provided that the following conditions are
   5 # met:
   6 #
   7 #     * Redistributions of source code must retain the above copyright
   8 # notice, this list of conditions and the following disclaimer.
   9 #     * Redistributions in binary form must reproduce the above
  10 # copyright notice, this list of conditions and the following disclaimer
  11 # in the documentation and/or other materials provided with the
  12 # distribution.
  13 #     * Neither the name of Google Inc. nor the names of its
  14 # contributors may be used to endorse or promote products derived from
  15 # this software without specific prior written permission.
  16 #
  17 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  18 # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  19 # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  20 # A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  21 # OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  22 # SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  23 # LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  24 # DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  25 # THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  26 # (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  27 # OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  28
  29 import os.path
  30 import re
  31
  32
  33 ACRONYMS = [
  34     'CSSOM',
  35     'CSS',
  36     'DNS',
  37     'FE',
  38     'FTP',
  39     'HTML',
  40     'IME',
  41     'JS',
  42     'SVG',
  43     'URL',
  44     'WOFF',
  45     'XML',
  46     'XSLT',
  47     'XSS',
  48 ]
  49
  50
  51 def lower_first(name):
  52     """Return name with first letter or initial acronym lowercased.
  53
  54     E.g., 'SetURL' becomes 'setURL', but 'URLFoo' becomes 'urlFoo'.
  55     """
  56     for acronym in ACRONYMS:
  57         if name.startswith(acronym):
  58             return name.replace(acronym, acronym.lower(), 1)
  59     return name[0].lower() + name[1:]
  60
  61
  62 def upper_first(name):
  63     """Return name with first letter or initial acronym uppercased."""
  64     for acronym in ACRONYMS:
  65         if name.startswith(acronym.lower()):
  66             return name.replace(acronym.lower(), acronym, 1)
  67     return _upper_first(name)
  68
  69
  70 def _upper_first(name):
  71     """Return name with first letter uppercased."""
  72     if not name:
  73         return ''
  74     return name[0].upper() + name[1:]
  75
  76
  77 def camelcase_property_name(property_name):
  78     """Convert hyphen-separated-name to UpperCamelCase.
  79
  80     E.g., '-foo-bar' becomes 'FooBar'.
  81     Used for CSS property names.
  82     """
  83     return ''.join(_upper_first(word) for word in property_name.split('-'))
  84
  85
  86 def to_macro_style(name):
  87     s1 = re.sub('(.)([A-Z][a-z]+)', r'\1_\2', name)
  88     return re.sub('([a-z0-9])([A-Z])', r'\1_\2', s1).upper()
  89
  90
  91 def script_name(entry):
  92     return os.path.basename(entry['name'])
  93
  94
  95 def cpp_name(entry):
  96     return entry['ImplementedAs'] or script_name(entry)
  97
  98
  99 def enable_conditional_if_endif(code, feature):
 100     # Jinja2 filter to generate if/endif directive blocks based on a feature
 101     if not feature:
 102         return code
 103     condition = 'ENABLE(%s)' % feature
 104     return ('#if %s\n' % condition +
 105             code +
 106             '#endif // %s\n' % condition)