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
|
# Licensed to the Apache Software Foundation (ASF) under one
# or more contributor license agreements. See the NOTICE file
# distributed with this work for additional information
# regarding copyright ownership. The ASF licenses this file
# to you under the Apache License, Version 2.0 (the
# "License"); you may not use this file except in compliance
# with the License. You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
import sys
if __name__ == '__main__':
# Use optparse instead of argparse because this needs to work on old Python versions.
import optparse
parser = optparse.OptionParser(description='Traffic Server Sphinx docs configuration')
parser.add_option('--check-version', action='store_true', dest='checkvers')
(options, args) = parser.parse_args()
# Check whether we have the required version of sphinx.
if options.checkvers:
min_sphinx_version_info = (1, 7, 5)
min_sphinx_version = '.'.join(str(x) for x in min_sphinx_version_info)
print(f'checking for sphinx version >= {min_sphinx_version}... ', end="")
# Need at least 1.5.1 to use svg
# version >= 1.2 guarantees sphinx.version_info is available.
try:
import sphinx
if 'version_info' in dir(sphinx):
print(f'Found Sphinx version {sphinx.version_info}')
else:
version = sphinx.__version__
print(f'Found Sphinx version (old) {sphinx.__version__}')
sphinx.version_info = version.split('.')
if sphinx.version_info < min_sphinx_version_info:
print(f'sphinx version is older than {min_sphinx_version}')
sys.exit(1)
except Exception as e:
print(e)
sys.exit(1)
print('checking for sphinx.writers.manpage... ', end="")
try:
from sphinx.writers import manpage
print('yes')
except Exception as e:
print(e)
sys.exit(1)
print('checking for sphinxcontrib.plantuml...', end="")
try:
import sphinxcontrib.plantuml
print('yes')
except Exception as e:
print(e)
sys.exit(1)
|
