1 # Unix SMB/CIFS implementation.
2 # Copyright (C) Jelmer Vernooij <jelmer@samba.org> 2007-2012
4 # Tests for documentation.
6 # This program is free software; you can redistribute it and/or modify
7 # it under the terms of the GNU General Public License as published by
8 # the Free Software Foundation; either version 3 of the License, or
9 # (at your option) any later version.
11 # This program is distributed in the hope that it will be useful,
12 # but WITHOUT ANY WARRANTY; without even the implied warranty of
13 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 # GNU General Public License for more details.
16 # You should have received a copy of the GNU General Public License
17 # along with this program. If not, see <http://www.gnu.org/licenses/>.
20 """Tests for presence of documentation."""
24 from samba.tests import TestSkipped
32 class TestCase(samba.tests.TestCase):
34 def _format_message(self, parameters, message):
35 parameters = list(parameters)
37 return message + '\n\n %s' % ('\n '.join(parameters))
40 class NoXsltProc(Exception):
43 Exception.__init__(self, "'xsltproc' is not installed")
46 def get_documented_parameters(sourcedir):
47 path = os.path.join(sourcedir, "bin", "default", "docs-xml", "smbdotconf")
48 if not os.path.exists(os.path.join(path, "parameters.all.xml")):
49 raise Exception("Unable to find parameters.all.xml")
52 ["xsltproc", "--xinclude", "--param", "smb.context", "ALL", os.path.join(sourcedir, "docs-xml", "smbdotconf", "generate-context.xsl"), "parameters.all.xml"],
53 stderr=subprocess.STDOUT, stdout=subprocess.PIPE,
56 if e.errno == errno.ENOENT:
59 out, err = p.communicate()
60 assert p.returncode == 0, "returncode was %r" % p.returncode
61 for l in out.splitlines():
62 m = re.match('<samba:parameter .*?name="([^"]*?)"', l)
63 if "removed=\"1\"" in l:
68 m = re.match('.*<synonym>(.*)</synonym>.*', l)
74 def get_implementation_parameters(sourcedir):
75 # Reading entries from source code
76 f = open(os.path.join(sourcedir, "lib/param/param_table.c"), "r")
78 # burn through the preceding lines
81 if l.startswith("static struct parm_struct parm_table"):
84 for l in f.readlines():
85 if re.match("^\s*\}\;\s*$", l):
87 # pull in the param names only
88 if re.match(".*P_SEPARATOR.*", l):
90 m = re.match("\s*\.label\s*=\s*\"(.*)\".*", l)
100 class SmbDotConfTests(TestCase):
102 def test_unknown(self):
103 topdir = samba.source_tree_topdir()
105 documented = set(get_documented_parameters(topdir))
107 raise TestSkipped("'xsltproc' is missing, unable to load parameters")
108 parameters = set(get_implementation_parameters(topdir))
109 # Filter out parametric options, since we can't find them in the parm
111 documented = set([p for p in documented if not ":" in p])
112 unknown = documented.difference(parameters)
114 self.fail(self._format_message(unknown,
115 "Parameters that are documented but not in the implementation:"))
117 def test_undocumented(self):
118 topdir = samba.source_tree_topdir()
120 documented = set(get_documented_parameters(topdir))
122 raise TestSkipped("'xsltproc' is missing, unable to load parameters")
123 parameters = set(get_implementation_parameters(topdir))
124 undocumented = parameters.difference(documented)
125 if len(undocumented) > 0:
126 self.fail(self._format_message(undocumented,
127 "Parameters that are in the implementation but undocumented:"))