-
Notifications
You must be signed in to change notification settings - Fork 0
/
davitpydoc.py
109 lines (91 loc) · 4.36 KB
/
davitpydoc.py
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
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
def davitpydoc():
import os,string
docPath = '/docs/davitpy_doc'
projPath = '/davitpy'
with open(docPath+'/index_backup','r') as f:
index = f.readlines()
ind = index.index(' :maxdepth: 1\n')
ind = ind + 1
exclude = ['.git','build','sphinx','docs','install','bin','temp.linux-x86_64-2.7']
for root, dirs, files in os.walk('/davitpy'):
for name in dirs:
cflg = False
for level in string.split(root, '/')+[name]:
if level in exclude:
cflg = True
break
if cflg: continue
print root,name
parent = string.replace( string.replace(root, '/', '.'), '.davitpy', '')
if(root == '/davitpy'):
if(not ' '+name+'\n' in index):
index.insert(ind,'\n '+name+'\n')
ind = ind + 1
else:
fname = parent[1:]
with open(os.path.join(docPath, fname+'.rst'), 'r') as f:
plines = f.readlines()
ind = plines.index(' :maxdepth: 2\n')
ind = ind + 1
if(not ' '+parent[1:]+'.'+name+'\n' in plines):
plines.insert(ind,'\n '+parent[1:]+'.'+name+'\n')
with open(os.path.join(docPath, parent[1:]+'.rst'),'w') as f:
f.writelines(plines)
fname = (parent+'.'+name)[1:]
print 'module.py:: '+fname
with open( os.path.join( docPath, fname+'.rst' ), 'w' ) as f:
f.write(fname+'\n')
f.write('============================\n')
f.write('.. toctree::\n')
f.write(' :maxdepth: 2\n')
for name in files:
#if(root == '/davitpy' or name == 'setup.py' or name[-3:]!='.py'): continue
if(root == '/davitpy' or name == 'setup.py' or name=="__init__.py" or name[-3:]!='.py'): continue
cflg = False
for level in string.split(root, '/')+[name]:
if level in exclude:
cflg = True
break
if cflg: continue
print root,name
parent = string.replace( string.replace(root, '/', '.'), '.davitpy', '')
fname = os.path.join( docPath, parent[1:]+'.rst' )
with open(fname, 'r') as f:
plines = f.readlines()
ind = plines.index(' :maxdepth: 2\n')
ind = ind + 1
mod = parent[1:]+'.'+string.replace(name, '.py', '')
if(not ' '+mod+'\n' in plines):
plines.insert(ind,'\n '+mod+'\n')
with open(os.path.join(docPath, parent[1:]+'.rst'),'w') as f:
f.writelines(plines)
fname = parent[1:]+'.'+string.replace( name, '.py', '')
print 'submodule.py:: '+fname
with open( os.path.join( docPath, fname+'.rst' ), 'w' ) as f:
f.write(fname+'\n')
f.write('============================\n')
f.write('.. toctree::\n')
f.write(' :maxdepth: 2\n')
f.write('\n.. automodule:: '+fname+'\n')
f.write(' :members:\n')
f.write('\n.. autoclass:: '+fname+'\n')
f.write(' :members:\n')
os.system('ln -s '+os.path.join(root, name)+' '+os.path.join(docPath, name))
with open(os.path.join(docPath, 'index.rst'), 'w') as f:
f.writelines(index)
# Link notebooks to nbviewer
with open(os.path.join(docPath, 'notebooks_backup'), 'r') as f:
notebooks = f.readlines()
baseurl = 'http://nbviewer.ipython.org/urls/raw.github.com/'
gitpath = 'vtsuperdarn/davitpy/master/docs/notebook/'
for root, dirs, files in os.walk('/davitpy/docs/notebook'):
for fname in files:
if not fname[-6:] == '.ipynb': continue
basename = fname[:-6]
notebooks.append('\n* `{0} <{1}{2}{0}.ipynb>`_\n'.format(basename, baseurl, gitpath))
print fname, basename
break
with open(os.path.join(docPath, 'notebooks.rst'), 'w') as f:
f.writelines(notebooks)
if __name__ == "__main__":
davitpydoc()