dom Namespace Reference

Functions
	help ()
	analyze ()
	build ()
	dart2js ()
	compile_dart2js (dart_file, checked)
	gen ()
	size_check ()
	test_ff ()
	test_drt ()
	test_chrome ()
	test_dart2js (browser, argv)
	test_server ()
	test_server_dartium ()
	start_test_server (port, build_directory)
	call (args)
	main ()

Variables
	dart_out_dir = utils.GetBuildRoot(utils.GuessOS(), 'release', '64')
	dart_bin = os.path.join(dart_out_dir, 'dart.exe')
	dart_dir
dict	commands

Function Documentation

analyze()

dom.analyze

(

)

 Runs the dart analyzer. 

Definition at line 43 of file dom.py.

def analyze():
    ''' Runs the dart analyzer. '''
    return call([
        os.path.join(dart_out_dir, 'dart-sdk', 'bin', 'dart'),
        'analyze',
        os.path.join('tests', 'lib', 'html', 'element_test.dart'),
    ])
 
 

build()

dom.build

(

)

 Builds the Dart binary 

Definition at line 52 of file dom.py.

def build():
    ''' Builds the Dart binary '''
    return call([
        os.path.join('tools', 'build.py'),
        '--mode=release',
        '--arch=ia32',
        'runtime',
    ])
 
 

call()

dom.call

(

args

)

Definition at line 159 of file dom.py.

def call(args):
    print(' '.join(args))
    pipe = subprocess.Popen(
        args, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
    output, error = pipe.communicate()
    if output:
        print(output)
    if error:
        print(error)
    return pipe.returncode
 
 

compile_dart2js()

dom.compile_dart2js	(		dart_file,
			checked
	)

Definition at line 66 of file dom.py.

def compile_dart2js(dart_file, checked):
    out_file = dart_file + '.js'
    dart2js_path = os.path.join(dart_out_dir, 'dart-sdk', 'bin', 'dart2js')
    args = [dart2js_path, dart_file, '--library-root=sdk/', '-o%s' % out_file]
    if checked:
        args.append('--checked')
 
    call(args)
    return out_file
 
 

dart2js()

dom.dart2js

(

)

Definition at line 62 of file dom.py.

def dart2js():
    compile_dart2js(argv.pop(0), True)
 
 

gen()

dom.gen

(

)

Definition at line 77 of file dom.py.

def gen():
    os.chdir(os.path.join('tools', 'dom', 'scripts'))
    result = call([
        os.path.join(os.getcwd(), 'dartdomgenerator.py'), '--rebuild',
        '--parallel', '--systems=htmldart2js,htmldartium'
    ])
    os.chdir(os.path.join('..', '..', '..'))
    return result
 
 

help()

dom.help

(

)

Definition at line 29 of file dom.py.

def help():
    print('Helper script to make it easy to perform common tasks encountered '
          'during the life of a Dart DOM developer.\n'
          '\n'
          'For example, to re-generate DOM classes then run a specific test:\n'
          '  dom.py gen test_drt html/element_test\n'
          '\n'
          'Or re-generate DOM classes and run the Dart analyzer:\n'
          '  dom.py gen analyze\n')
    print('Commands: ')
    for cmd in sorted(commands.keys()):
        print('\t%s - %s' % (cmd, commands[cmd][1]))
 
 

main()

dom.main

(

)

Definition at line 201 of file dom.py.

def main():
    success = True
    argv.pop(0)
 
    if not argv:
        help()
        success = False
 
    while (argv):
        # Make sure that we're always rooted in the dart root folder.
        os.chdir(dart_dir)
        command = argv.pop(0)
 
        if not command in commands:
            help()
            success = False
            break
        returncode = commands[command][0]()
        success = success and not bool(returncode)
 
    sys.exit(not success)
 
 

size_check()

dom.size_check

(

)

 Displays the dart2js size of swarm. 

Definition at line 87 of file dom.py.

def size_check():
    ''' Displays the dart2js size of swarm. '''
    dart_file = os.path.join('samples', 'swarm', 'swarm.dart')
    out_file = compile_dart2js(dart_file, False)
 
    return call([
        'du',
        '-kh',
        '--apparent-size',
        out_file,
    ])
 
    os.remove(out_file)
    os.remove(out_file + '.deps')
    os.remove(out_file + '.map')
 
 

start_test_server()

dom.start_test_server	(		port,
			build_directory
	)

Definition at line 146 of file dom.py.

def start_test_server(port, build_directory):
    print(
        'Browse tests at '
        '\033[94mhttp://localhost:%d/root_build/generated_tests/\033[0m' % port)
    return call([
        utils.CheckedInSdkExecutable(),
        os.path.join('tools', 'testing', 'dart', 'http_server.dart'),
        '--port=%d' % port,
        '--crossOriginPort=%d' % (port + 1), '--network=0.0.0.0',
        '--build-directory=%s' % build_directory
    ])
 
 

test_chrome()

dom.test_chrome

(

)

Definition at line 112 of file dom.py.

def test_chrome():
    test_dart2js('chrome', argv)
 
 

test_dart2js()

dom.test_dart2js	(		browser,
			argv
	)

Definition at line 116 of file dom.py.

def test_dart2js(browser, argv):
    cmd = [
        os.path.join('tools', 'test.py'),
        '-c',
        'dart2js',
        '-r',
        browser,
        '--mode=release',
        '--checked',
        '--arch=ia32',
        '-v',
    ]
    if argv:
        cmd.append(argv.pop(0))
    else:
        print(
            'Test commands should be followed by tests to run. Defaulting to html'
        )
        cmd.append('html')
    return call(cmd)
 
 

test_drt()

dom.test_drt

(

)

Definition at line 108 of file dom.py.

def test_drt():
    test_dart2js('drt', argv)
 
 

test_ff()

dom.test_ff

(

)

Definition at line 104 of file dom.py.

def test_ff():
    test_dart2js('ff', argv)
 
 

test_server()

dom.test_server

(

)

Definition at line 138 of file dom.py.

def test_server():
    start_test_server(5400, os.path.join('out', 'ReleaseX64'))
 
 

test_server_dartium()

dom.test_server_dartium

(

)

Definition at line 142 of file dom.py.

def test_server_dartium():
    start_test_server(5500, os.path.join('..', 'out', 'Release'))
 
 

Variable Documentation

commands

dict dom.commands

Initial value:

=  {
    'analyze': [analyze, 'Run the dart analyzer'],
    'build': [build, 'Build dart in release mode'],
    'dart2js': [dart2js, 'Run dart2js on the .dart file specified'],
    'gen': [gen, 'Re-generate DOM generated files (run go.sh)'],
    'size_check': [size_check, 'Check the size of dart2js compiled Swarm'],
    'test_chrome': [
        test_chrome, 'Run tests in checked mode in Chrome.\n'
        '\t\tOptionally provide name of test to run.'
    ],
    # TODO(antonm): fix option name.
    'test_drt': [
        test_drt, 'Run tests in checked mode in content shell.\n'
        '\t\tOptionally provide name of test to run.'
    ],
    'test_ff': [
        test_ff, 'Run tests in checked mode in Firefox.\n'
        '\t\tOptionally provide name of test to run.'
    ],
    'test_server': [
        test_server, 'Starts the testing server for manually '
        'running browser tests.'
    ],
    'test_server_dartium': [
        test_server_dartium, 'Starts the testing server for '
        'manually running browser tests from a dartium enlistment.'
    ],
}

Definition at line 171 of file dom.py.

dart_bin

dom.dart_bin = os.path.join(dart_out_dir, 'dart.exe')

Definition at line 19 of file dom.py.

dart_dir

dom.dart_dir

Initial value:

=  os.path.abspath(
    os.path.join(
        os.path.dirname(os.path.realpath(__file__)), os.path.pardir,
        os.path.pardir))

Definition at line 23 of file dom.py.

dart_out_dir

dom.dart_out_dir = utils.GetBuildRoot(utils.GuessOS(), 'release', '64')

Definition at line 17 of file dom.py.