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
|
"""The Sphinx documentation toolchain."""
__version__ = '7.3.7'
__display_version__ = __version__ # used for command line version
# Keep this file executable as-is in Python 3!
# (Otherwise getting the version out of it when packaging is impossible.)
import os
import warnings
from os import path
from .deprecation import RemovedInNextVersionWarning
# by default, all DeprecationWarning under sphinx package will be emit.
# Users can avoid this by using environment variable: PYTHONWARNINGS=
if 'PYTHONWARNINGS' not in os.environ:
warnings.filterwarnings('default', category=RemovedInNextVersionWarning)
warnings.filterwarnings(
'ignore', 'The frontend.Option class .*', DeprecationWarning, module='docutils.frontend'
)
#: Version info for better programmatic use.
#:
#: A tuple of five elements; for Sphinx version 1.2.1 beta 3 this would be
#: ``(1, 2, 1, 'beta', 3)``. The fourth element can be one of: ``alpha``,
#: ``beta``, ``rc``, ``final``. ``final`` always has 0 as the last element.
#:
#: .. versionadded:: 1.2
#: Before version 1.2, check the string ``sphinx.__version__``.
version_info = (7, 3, 7, 'final', 0)
package_dir = path.abspath(path.dirname(__file__))
_in_development = False
if _in_development:
# Only import subprocess if needed
import subprocess
try:
if ret := subprocess.run(
['git', 'rev-parse', '--short', 'HEAD'],
cwd=package_dir,
capture_output=True,
check=False,
encoding='ascii',
errors='surrogateescape',
).stdout:
__display_version__ += '+/' + ret.strip()
del ret
finally:
del subprocess
del _in_development
|
