File: test_coding_style.py.in

package info (click to toggle)
dolfin 2018.1.0.post1-16
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 28,764 kB
  • sloc: xml: 104,040; cpp: 98,856; python: 22,511; makefile: 204; sh: 182
file content (151 lines) | stat: -rwxr-xr-x 4,880 bytes parent folder | download | duplicates (6)
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
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
#!/usr/bin/env py.test
# Copyright (C) 2011-2014 Anders Logg
#
# This file is part of DOLFIN.
#
# DOLFIN is free software: you can redistribute it and/or modify
# it under the terms of the GNU Lesser General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# DOLFIN 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 Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public License
# along with DOLFIN. If not, see <http://www.gnu.org/licenses/>.

from __future__ import print_function
import os, re
import pytest

def pytest_generate_tests(metafunc):
    # List of C++ tests
    cpp_tests = [dolfin_error, uint, includes]

    # List of Python tests
    python_tests = [dolfin_error, raise_exception]

    # Source dir (generated by CMake)
    topdir = "@CMAKE_SOURCE_DIR@"
    assert os.path.isfile(os.path.join(topdir, 'dolfin', 'dolfin.h'))
    assert os.path.isfile(os.path.join(topdir, 'site-packages',
                                       'dolfin', '__init__.py'))

    # Check C++ files
    cpp_call = {'topdir': topdir,
                'subdir': "dolfin",
                'suffixes':[".cpp", ".h"]}

    python_call = {'topdir': topdir,
                   'subdir': "site-packages",
                   'suffixes':[".py"]}

    for test in python_tests:
        python_call['test'] = test
        metafunc.addcall(funcargs=python_call)

    for test in cpp_tests:
        cpp_call['test'] = test
        metafunc.addcall(funcargs=cpp_call)


def test_codingstyle(topdir, subdir, suffixes, test):
    "Main function for performing tests"

    # Iterate over all files
    for subdir, dirs, files in os.walk(os.path.join(topdir, subdir)):
        for filename in files:

            # Only consider files with given suffix
            if not len([1 for suffix in suffixes if filename.endswith(suffix)]) > 0:
                continue

            # Read file
            f = open(os.path.join(subdir, filename), "r")
            code = f.read()
            f.close()

            # Perform all tests
            result = test(code, filename)

def dolfin_error(code, filename):
    "Test for use of dolfin_error vs error"

    # Skip exceptions
    exceptions = ["log.h", "log.cpp", "Logger.h", "Logger.cpp",
                  "pugixml.cpp", "meshconvert.py", "abaqus.py",
                  "MPI.cpp"]
    if filename in exceptions:
        return True

    # Check for error(...)
    if re.search(r"\berror\(", code) is None:
        return True

    # Write an error message
    assert False, "*** error() used in %s when dolfin_error() should be used" % filename
    return False

def raise_exception(code, filename):
    "Test for use of dolfin_error vs raising exception"

    # Skip exceptions
    exceptions = ["meshconvert.py", "expressions.py", "form.py",
                  "assembling.py", "multistagescheme.py",
                  "rushlarsenschemes.py", "expression.py",
                  "functionspace.py", "constant.py",
                  "specialfunctions.py", "function.py",
                  "ordereddict.py", "abaqus.py", "sge.py", "pjobs.py",
                  "generatepythonrst.py", "CppHeaderParser.py",
                  "subdomains.py", "plotting.py", "multimeshfunction.py"]
    if filename in exceptions:
        return True

    # Check for raising of exception
    if re.search(r"\braise\b", code) is None:
        return True

    # Write an error message
    assert False, "* Warning: exception raised in %s when dolfin_error() should be used" % filename
    return False

def uint(code, filename):
    "Test for use of uint"

    # Skip exceptions
    exceptions = ["XMLMeshValueCollection.h", "XMLMesh.cpp",
                  "XMLMeshFunction.h", "XMLFile.h"]
    if filename in exceptions:
        return True

    # Check for raising of exception
    if re.search(r"\buint\b", code) is None:
        return True

    # Write an error message
    assert False, "* Warning: uint is used in %s when std::size_t should be used" % filename
    return False

def includes(code, filename):
    "Test of not including dolfin_foo.h which bloat compilation units"

    # Skip exceptions
    exceptions = ['dolfin.h']
    if filename in exceptions:
        return True

    # Check for raising of exception
    # NOTE: Improve this pattern if it generates false positives
    r = re.search(r"\bdolfin_[a-zA-Z]*\.h\b", code)
    if r is None:
        return True

    # Write an error message
    assert False, "* Warning: %s should not be included in %s" % (r.group(), filename)
    return False

if __name__ == "__main__":
    import sys
    sys.exit(pytest.main())