policy: generate JSON schema at build time as a string constant.

chrome/tools/build/generate_policy_source.py

 #!/usr/bin/env python
 # Copyright (c) 2012 The Chromium Authors. All rights reserved.
 # Use of this source code is governed by a BSD-style license that can be
 # found in the LICENSE file.
 
 '''python %prog [options] platform chromium_os_flag template
 
 platform specifies which platform source is being generated for
   and can be one of (win, mac, linux)
 chromium_os_flag should be 1 if this is a Chromium OS build
 template is the path to a .json policy template file.'''
 
 from __future__ import with_statement
 import json
 from optparse import OptionParser
 import re
 import sys
 import textwrap
+import json

[Joao da Silva, 2013/09/11 11:43:37]

alread in line 14

 
 
 CHROME_POLICY_KEY = 'SOFTWARE\\\\Policies\\\\Google\\\\Chrome'
 CHROMIUM_POLICY_KEY = 'SOFTWARE\\\\Policies\\\\Chromium'
 
 
 class PolicyDetails:
   """Parses a policy template and caches all its details."""
 
   # Maps policy types to a tuple with 3 other types:
@@ skipping 17 matching lines @@
   class EnumItem:
     def __init__(self, item):
       self.caption = PolicyDetails._RemovePlaceholders(item['caption'])
       self.value = item['value']
 
   def __init__(self, policy, os, is_chromium_os):
     self.id = policy['id']
     self.name = policy['name']
     self.is_deprecated = policy.get('deprecated', False)
     self.is_device_only = policy.get('device_only', False)
+    self.schema = policy.get('schema', {})
 
     if is_chromium_os:
       expected_platform = 'chrome_os'
     else:
       expected_platform = os.lower()
 
     self.platforms = []
     for platform, version in [ p.split(':') for p in policy['supported_on'] ]:
       if not version.endswith('-'):
         continue
@@ skipping 150 matching lines @@
           '#include "base/basictypes.h"\n'
           '#include "base/values.h"\n'
           '\n'
           'namespace policy {\n\n')
 
   if os == 'win':
     f.write('// The windows registry path where Chrome policy '
             'configuration resides.\n'
             'extern const wchar_t kRegistryChromePolicyKey[];\n')
 
-  f.write('// Lists metadata such as name, expected type and id for all\n'
+  f.write('// JSON schema for policy.\n'
+          'extern const char kPolicyJsonSchema[];\n'
+          '\n'
+          '// Lists metadata such as name, expected type and id for all\n'
           '// policies. Used to initialize ConfigurationPolicyProviders and\n'
           '// CloudExternalDataManagers.\n'
           'struct PolicyDefinitionList {\n'
           '  struct Entry {\n'
           '    const char* name;\n'
           '    base::Value::Type value_type;\n'
           '    bool device_policy;\n'
           '    int id;\n'
           '    size_t max_external_data_size;\n'
           '  };\n'
@@ skipping 64 matching lines @@
 
   if os == 'win':
     f.write('#if defined(GOOGLE_CHROME_BUILD)\n'
             'const wchar_t kRegistryChromePolicyKey[] = '
             'L"' + CHROME_POLICY_KEY + '";\n'
             '#else\n'
             'const wchar_t kRegistryChromePolicyKey[] = '
             'L"' + CHROMIUM_POLICY_KEY + '";\n'
             '#endif\n\n')
 
+  # Inline the JSON schema for policy.
+  schema = {}
+  schema['$schema'] = 'http://json-schema.org/draft-03/schema#'
+  schema['type'] = 'object'
+  schema['properties'] = {}
+  for policy in policies:
+    schema['properties'][policy.name] = policy.schema

[Joao da Silva, 2013/09/11 11:43:37]

make this conditional on policy.is_supported.

+  f.write('const char kPolicyJsonSchema[] = %s;\n\n' %
+          json.dumps(json.dumps(schema)))

[Joao da Silva, 2013/09/11 11:59:00]

pass separators=(',', ':') to these 2 calls. It will remove the whitespaces
after commas and colons, and save some more bytes.

+
   f.write('bool IsDeprecatedPolicy(const std::string& policy) {\n')
   if has_deprecated_policies:
     # arraysize() doesn't work with empty arrays.
     f.write('  for (size_t i = 0; i < arraysize(kDeprecatedPolicyList);'
                 ' ++i) {\n'
             '    if (policy == kDeprecatedPolicyList[i])\n'
             '      return true;\n'
             '  }\n')
   f.write('  return false;\n'
           '}\n\n')
@@ skipping 257 matching lines @@
 def _WriteCloudPolicyDecoder(policies, os, f):
   f.write(CPP_HEAD)
   for policy in policies:
     if policy.is_supported and not policy.is_device_only:
       _WritePolicyCode(f, policy)
   f.write(CPP_FOOT)
 
 
 if __name__ == '__main__':
   sys.exit(main())