code_generator_dart Namespace Reference

Classes
class	CodeGeneratorDart

Functions
	initialize_jinja_env (cache_dir)
	conditional_if_endif (code, conditional_string)
	runtime_enabled_if (code, runtime_enabled_function_name)
	main (argv)

Variables
	module_path
	module_filename
	third_party_dir
	templates_dir = os.path.normpath(os.path.join(module_path, 'templates'))
str	module_pyname = os.path.splitext(module_filename)[0] + '.py'
	dart_script_path = os.path.dirname(os.path.abspath(__file__))
	script_path
	INTERFACES_WITHOUT_RESOLVERS

Detailed Description

Generate Blink C++ bindings (.h and .cpp files) for use by Dart:HTML.

If run itself, caches Jinja templates (and creates dummy file for build,
since cache filenames are unpredictable and opaque).

This module is *not* concurrency-safe without care: bytecode caching creates
a race condition on cache *write* (crashes if one process tries to read a
partially-written cache). However, if you pre-cache the templates (by running
the module itself), then you can parallelize compiling individual files, since
cache *reading* is safe.

Input: An object of class IdlDefinitions, containing an IDL interface X
Output: DartX.h and DartX.cpp

Design doc: http://www.chromium.org/developers/design-documents/idl-compiler

Function Documentation

conditional_if_endif()

code_generator_dart.conditional_if_endif	(		code,
			conditional_string
	)

Definition at line 273 of file code_generator_dart.py.

def conditional_if_endif(code, conditional_string):
    # Jinja2 filter to generate if/endif directive blocks
    if not conditional_string:
        return code
    return ('#if %s\n' % conditional_string + code +
            '#endif // %s\n' % conditional_string)
 
 
# [RuntimeEnabled]

initialize_jinja_env()

code_generator_dart.initialize_jinja_env

(

cache_dir

)

Definition at line 255 of file code_generator_dart.py.

def initialize_jinja_env(cache_dir):
    jinja_env = jinja2.Environment(
        loader=jinja2.FileSystemLoader(templates_dir),
        # Bytecode cache is not concurrency-safe unless pre-cached:
        # if pre-cached this is read-only, but writing creates a race condition.
        bytecode_cache=jinja2.FileSystemBytecodeCache(cache_dir),
        keep_trailing_newline=True,  # newline-terminate generated files
        lstrip_blocks=True,  # so can indent control flow tags
        trim_blocks=True)
    jinja_env.filters.update({
        'blink_capitalize': DartUtilities.capitalize,
        'conditional': conditional_if_endif,
        'runtime_enabled': runtime_enabled_if,
    })
    return jinja_env
 
 
# [Conditional]

main()

code_generator_dart.main

(

argv

)

Definition at line 294 of file code_generator_dart.py.

def main(argv):
    # If file itself executed, cache templates
    try:
        cache_dir = argv[1]
        dummy_filename = argv[2]
    except IndexError as err:
        print('Usage: %s OUTPUT_DIR DUMMY_FILENAME' % argv[0])
        return 1
 
    # Cache templates
    jinja_env = initialize_jinja_env(cache_dir)
    template_filenames = [
        filename for filename in os.listdir(templates_dir)
        # Skip .svn, directories, etc.
        if filename.endswith(('.cpp', '.h', '.template'))
    ]
    for template_filename in template_filenames:
        jinja_env.get_template(template_filename)
 
    # Create a dummy file as output for the build system,
    # since filenames of individual cache files are unpredictable and opaque
    # (they are hashes of the template path, which varies based on environment)
    with open(dummy_filename, 'w') as dummy_file:
        pass  # |open| creates or touches the file
 
 

runtime_enabled_if()

code_generator_dart.runtime_enabled_if	(		code,
			runtime_enabled_function_name
	)

Definition at line 282 of file code_generator_dart.py.

def runtime_enabled_if(code, runtime_enabled_function_name):
    if not runtime_enabled_function_name:
        return code
    # Indent if statement to level of original code
    indent = re.match(' *', code).group(0)
    return ('%sif (%s())\n' % (indent, runtime_enabled_function_name) +
            '    %s' % code)
 
 

Variable Documentation

dart_script_path

code_generator_dart.dart_script_path = os.path.dirname(os.path.abspath(__file__))

Definition at line 73 of file code_generator_dart.py.

INTERFACES_WITHOUT_RESOLVERS

code_generator_dart.INTERFACES_WITHOUT_RESOLVERS

Initial value:

=  frozenset([
    'TypeConversions', 'GCObservation', 'InternalProfilers',
    'InternalRuntimeFlags', 'InternalSettings', 'InternalSettingsGenerated',
    'Internals', 'LayerRect', 'LayerRectList', 'MallocStatistics',
    'TypeConversions'
])

Definition at line 87 of file code_generator_dart.py.

module_filename

code_generator_dart.module_filename

Definition at line 58 of file code_generator_dart.py.

module_path

code_generator_dart.module_path

Definition at line 58 of file code_generator_dart.py.

module_pyname

str code_generator_dart.module_pyname = os.path.splitext(module_filename)[0] + '.py'

Definition at line 65 of file code_generator_dart.py.

script_path

code_generator_dart.script_path

Initial value:

=  os.path.join(
    os.path.dirname(os.path.dirname(dart_script_path)), 'scripts')

Definition at line 74 of file code_generator_dart.py.

templates_dir

code_generator_dart.templates_dir = os.path.normpath(os.path.join(module_path, 'templates'))

Definition at line 62 of file code_generator_dart.py.

third_party_dir

code_generator_dart.third_party_dir

Initial value:

=  os.path.normpath(
    os.path.join(module_path, os.pardir, os.pardir, os.pardir, os.pardir,
                 os.pardir))

Definition at line 59 of file code_generator_dart.py.