blob: 2cd4cca526e7b23707086b546985ab7b93456a5f [file] [log] [blame] [edit]
#!/usr/bin/env python
# coding=utf-8
# 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.
###
# Run me to generate the documentation!
###
"""Test tracing and isolation infrastructure.
Scripts are compartmentalized by their name:
- trace_*.py: Tracing infrastructure scripts.
- isolate_*.py: Executable isolation scripts. (TODO)
- *_test_cases.py: Scripts specifically managing GTest executables.
A few scripts have strict dependency rules:
- run_test_cases.py, run_test_from_archive.py, shard.py and trace_inputs.py
depends on no other script so they can be run outside the checkout.
- The pure tracing scripts (trace_inputs.py and trace_test_cases.py) do not know
about isolate infrastructure.
- Scripts without _test_cases suffix do not know about GTest.
- Scripts without isolate_ prefix do not know about the isolation
infrastructure. (TODO)
See http://dev.chromium.org/developers/testing/isolated-testing for more info.
"""
import os
import sys
def main():
for i in sorted(os.listdir(os.path.dirname(os.path.abspath(__file__)))):
if not i.endswith('.py') or i == 'PRESUBMIT.py':
continue
module = __import__(i[:-3])
if hasattr(module, '__doc__'):
print module.__name__
print ''.join(' %s\n' % i for i in module.__doc__.splitlines())
return 0
if __name__ == '__main__':
sys.exit(main())