1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
#!/usr/bin/env python3
# Copyright 2019 The Emscripten Authors. All rights reserved.
# Emscripten is available under two separate licenses, the MIT license and the
# University of Illinois/NCSA Open Source License. Both these licenses can be
# found in the LICENSE file.
"""
This is the Emscripten coverage tool.
Usage: emcoverage.py <help|reset|report|html|xml|COMMAND> ...
Special commands:
- help: show this message
- reset: remove all gathered coverage information
- report: show a quick overview of gathered coverage information
- html: generate coverage as a set of HTML files in ./htmlcov/
- xml: generate XML coverage report in ./coverage.xml
Otherwise, you can run any python script or Emscripten command, for example:
- emcoverage.py ./tests/runner.py core0
- emcoverage.py emcc file1.c file2.c
Running a command under emcoverage.py will collect the code coverage
information. Every run under emcoverage.py is additive, and no coverage
information from previous runs is erased, unless explicitly done via
emcoverage.py reset.
To display the gathered coverage information, use one of the three subcommands:
report, html, xml.
"""
import errno
import os
import shutil
import sys
import uuid
from glob import glob
import coverage.cmdline
SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
def main():
# We hack sys.executable to point to this file, which is executable via #! line.
# Emscripten uses sys.executable to populate shared.PYTHON, which is used to
# invoke all python subprocesses. By making this script run all python subprocesses,
# all of them will execute under the watchful eye of emcoverage.py, and resulting
# in their code coverage being tracked.
sys.executable = os.path.abspath(__file__)
os.environ['EMSDK_PYTHON'] = sys.executable
store = os.path.join(SCRIPT_DIR, 'coverage')
if len(sys.argv) < 2 or sys.argv[1] == 'help':
print(__doc__.replace('emcoverage.py', sys.argv[0]).strip())
return
if sys.argv[1] == 'reset':
shutil.rmtree(store)
return
if sys.argv[1] in ('html', 'report', 'xml'):
old_argv = sys.argv
sys.argv = ['coverage', 'combine'] + glob(os.path.join(store, '*'))
try:
coverage.cmdline.main()
except SystemExit:
pass
sys.argv = old_argv + ['-i']
return coverage.cmdline.main()
if not os.path.exists(sys.argv[1]):
# If argv[1] is not a file path, instead try to interpret it as an emscripten command.
# This allows `emcoverage.py emcc` or `emcoverage.py embuilder` to work.
sys.argv[1] = os.path.join(os.path.dirname(sys.executable), '..', sys.argv[1] + '.py')
try:
os.mkdir(store)
except OSError as e:
if e.errno != errno.EEXIST:
raise
os.environ['COVERAGE_FILE'] = os.path.join(store, str(uuid.uuid4()))
sys.argv[0:1] = ['coverage', 'run', '--parallel-mode', '--']
return coverage.cmdline.main()
if __name__ == '__main__':
sys.exit(main())
|
