tests: add simple (skipped) unit tests for graph_data that may be used to measure performance

Modified by Thomas De Schampheleire to have performance tests in a separate
directory so it is easier to run them, and also added some documentation.

kallithea/tests/performance/test_vcs.py

@@ -0,0 +1,35 b''
+# -*- coding: utf-8 -*-
+# 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/>.
+
+import pytest
+from kallithea.model.db import Repository
+from kallithea.tests.base import *
+
[e-mail]("not os.environ.has_key('TEST_PERFORMANCE')", reason="skipping performance tests, set TEST_PERFORMANCE in environment if desired")
+class TestVCSPerformance(TestController):
+
+    def graphmod(self, repo):
+        """ Simple test for running the graph_data function for profiling/testing performance. """
+        from kallithea.lib.graphmod import graph_data
+        dbr = Repository.get_by_repo_name(repo)
+        scm_inst = dbr.scm_instance
+        collection = scm_inst.get_changesets(start=0, end=None, branch_name=None)
+        revs = [x.revision for x in collection]
+        jsdata = graph_data(scm_inst, revs)
+
+    def test_graphmod_hg(self, benchmark):
+        self.graphmod(HG_REPO)
+
+    def test_graphmod_git(self, benchmark):
+        self.graphmod(GIT_REPO)

docs/contributing.rst

@@ -98,6 +98,17 b' are::'
     -s, --capture=no      don't capture stdout (any stdout output will be
                           printed immediately)
 
+Performance tests
+^^^^^^^^^^^^^^^^^
+
+A number of performance tests are present in the test suite, but they are
+not run in a standard test run. These tests are useful to
+evaluate the impact of certain code changes with respect to performance.
+
+To run these tests::
+
+    env TEST_PERFORMANCE=1 py.test kallithea/tests/performance
+
 
 Contribution guidelines
 -----------------------