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
|
#! /usr/bin/env python
import openturns as ot
import openturns.experimental as otexp
import openturns.testing as ott
import inspect
ot.TESTPREAMBLE()
# find all instantiable classes
instantiables = []
for mod in [ot, otexp, ott]:
for name, obj in inspect.getmembers(mod):
if inspect.isclass(obj):
cn = obj.__name__
if "_" in cn:
continue
try:
instance = obj()
instantiables.append(obj)
except Exception:
pass
# find missing docstrings
count_class = 0
count_class_undoc = 0
count_methods = 0
count_methods_undoc = 0
for class_ in instantiables:
count_class += 1
if class_.__doc__ is None:
print(f"{class_.__name__} class")
count_class_undoc += 1
for attr_name in dir(class_):
if attr_name[0] == "_":
continue
class_attr = getattr(class_, attr_name)
if callable(class_attr):
count_methods += 1
if class_attr.__doc__ is None:
print(f"{class_.__name__}.{attr_name} method")
count_methods_undoc += 1
# find all static functions
for name, mod in inspect.getmembers(ot):
if inspect.ismodule(mod):
modn = mod.__name__
if not modn.startswith("openturns") or modn == "openturns":
continue
if "_" in modn:
continue
for attr_name in dir(mod):
if "_" in attr_name:
continue
obj = getattr(mod, attr_name)
if not inspect.isclass(obj) and callable(obj):
symboln = f"{modn.split('.')[1]}.{attr_name}"
count_methods += 1
if obj.__doc__ is None:
count_methods_undoc += 1
print(f"{symboln} method")
print(
f"-- undocumented classes: {count_class_undoc} ({100.0 * count_class_undoc / count_class:.2f}%) --"
)
print(
f"-- undocumented methods: {count_methods_undoc} ({100.0 * count_methods_undoc / count_methods:.2f}%) --"
)
if count_class_undoc + count_methods_undoc > 100:
raise ValueError(
f"too much undocumented class/methods ({count_class_undoc + count_methods_undoc})"
)
|
