2014-01-01 03:54:24 +00:00
|
|
|
# Copyright (C) 2013-2014 Free Software Foundation, Inc.
|
Perf test framework
This patch adds a basic framework to do performance testing for GDB.
perftest.py is about the test case, testresult.py is about test
results, and how are they saved. reporter.py is about how results
are reported (in what format). measure.py is about measuring the
execution of tests by a collection of measurements.
In V5:
- Simplify perftest.exp.
In V4:
- Rename MeasurementCPUTime to MeasurementCpuTime,
- Add 'pass' in empty method,
- Simplify string comparison in perftest.exp.
- Rename GDB_PERFORMANCE to GDB_PERFTEST_MODE and rename
GDB_PERFORMANCE_TIMEOUT to GDB_PERFTEST_TIMEOUT.
In V3, there are some changes,
- Add wall time measurement, cpu time measurement and vmsize
measurement.
- Rename SingleStatisticTestCase to TestCaseWithBasicMeasurements,
which measures cpu time, wall time, and memory (vmsize).
- GDB_PERFORMANCE=run|compile|both to control the mode of perf
testing.
- New GDB_PERFORMANCE_TIMEOUT to specify the timeout.
- Split proc prepare to proc compile and startup.
- Disable GC while doing measurements.
In V2, there are several changes to address Doug and Sanimir's
comments.
- Add copyright header and docstring in perftest/__init__.py
- Remove config.py.
- Fix docstring format.
- Rename classes "SingleVariable" to "SingleStatistic".
- Don't extend gdb.Function in class TestCase. Add a new method run
to run the test case so that we can pass parameters to test.
- Allow to customize whether to warm up and to append test log.
- Move time measurement into test harness. Add a new class
Measurement for a specific measurement and a new class Measure to
measure them for a given test case.
- A new class ResultFactory to create instances of TestResult.
- New file lib/perftest.exp, which is to do some preparations and
cleanups to simplify each *.exp file.
- Skip compilation step if GDB_PERFORMANCE_SKIP_COMPILE is set.
gdb/testsuite/
2013-11-06 Yao Qi <yao@codesourcery.com>
* lib/perftest.exp: New.
* gdb.perf/lib/perftest/__init__.py: New.
* gdb.perf/lib/perftest/measure.py: New.
* gdb.perf/lib/perftest/perftest.py: New.
* gdb.perf/lib/perftest/reporter.py: New.
* gdb.perf/lib/perftest/testresult.py: New.
2013-09-24 09:56:26 +00:00
|
|
|
|
|
|
|
# This program is free software; you can redistribute it and/or modify
|
|
|
|
# it under the terms of the GNU General Public License as published by
|
|
|
|
# the Free Software Foundation; either version 3 of the License, or
|
|
|
|
# (at your option) any later version.
|
|
|
|
#
|
|
|
|
# This program is distributed in the hope that it will be useful,
|
|
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
# GNU General Public License for more details.
|
|
|
|
#
|
|
|
|
# You should have received a copy of the GNU General Public License
|
|
|
|
# along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
|
|
|
|
class TestResult(object):
|
|
|
|
"""Base class to record and report test results.
|
|
|
|
|
|
|
|
Method record is to record the results of test case, and report
|
|
|
|
method is to report the recorded results by a given reporter.
|
|
|
|
"""
|
|
|
|
|
|
|
|
def record(self, parameter, result):
|
|
|
|
raise NotImplementedError("Abstract Method:record.")
|
|
|
|
|
|
|
|
def report(self, reporter, name):
|
|
|
|
"""Report the test results by reporter."""
|
|
|
|
raise NotImplementedError("Abstract Method:report.")
|
|
|
|
|
|
|
|
class SingleStatisticTestResult(TestResult):
|
|
|
|
"""Test results for the test case with a single statistic."""
|
|
|
|
|
|
|
|
def __init__(self):
|
|
|
|
super (SingleStatisticTestResult, self).__init__ ()
|
|
|
|
self.results = dict ()
|
|
|
|
|
|
|
|
def record(self, parameter, result):
|
|
|
|
self.results[parameter] = result
|
|
|
|
|
|
|
|
def report(self, reporter, name):
|
|
|
|
reporter.start()
|
|
|
|
for key in sorted(self.results.iterkeys()):
|
|
|
|
reporter.report(name, key, self.results[key])
|
|
|
|
reporter.end()
|
|
|
|
|
|
|
|
class ResultFactory(object):
|
|
|
|
"""A factory to create an instance of TestResult."""
|
|
|
|
|
|
|
|
def create_result(self):
|
|
|
|
"""Create an instance of TestResult."""
|
|
|
|
raise NotImplementedError("Abstract Method:create_result.")
|
|
|
|
|
|
|
|
class SingleStatisticResultFactory(ResultFactory):
|
|
|
|
"""A factory to create an instance of SingleStatisticTestResult."""
|
|
|
|
|
|
|
|
def create_result(self):
|
|
|
|
return SingleStatisticTestResult()
|