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
|
import io
from docutils import nodes
from docutils.parsers.rst import Directive
class GenerateConfig(Directive):
"""
Directive to generate the configuration file for a package and
include it in the documentation as a literal code block. This relies
on the ``generate_config`` function, added in Astropy 4.1.
Example::
.. generate_config:: astropy
"""
has_content = False
required_arguments = 1
def run(self):
from astropy.config import generate_config
buf = io.StringIO()
generate_config(pkgname=self.arguments[0], filename=buf)
text = buf.getvalue()
node = nodes.literal_block(text, text)
return [node]
def setup(app):
app.add_directive("generate_config", GenerateConfig)
return {
'version': '0.1',
'parallel_read_safe': True,
'parallel_write_safe': True,
}
|
