| author | Sandro Knauß <knauss@netzguerilla.net> |
| Wed, 25 Apr 2012 17:15:15 +0200 | |
| branch | devel |
| changeset 281 | 76572d14bd27 |
| parent 277 | f65edc0382cc |
| child 294 | 0e75bd39767d |
| permissions | -rwxr-xr-x |
| 72 | 1 |
#!/usr/bin/env python2.7 |
2 |
# -*- coding: utf-8 -*- |
|
3 |
||
4 |
from genshi.template import TemplateLoader |
|
|
271
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
5 |
from genshi import Markup |
| 72 | 6 |
loader = TemplateLoader('doc/tmpl', auto_reload=True) |
7 |
||
|
277
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
8 |
|
|
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
9 |
from glob import glob |
|
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
10 |
import re |
|
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
11 |
import os.path |
| 72 | 12 |
import inspect |
|
277
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
13 |
from pkg_resources import parse_version |
|
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
14 |
|
|
281
76572d14bd27
createdoc.py: cleaning up
Sandro Knauß <knauss@netzguerilla.net>
parents:
277
diff
changeset
|
15 |
from docutils.core import publish_doctree, publish_from_doctree, publish_string |
|
76572d14bd27
createdoc.py: cleaning up
Sandro Knauß <knauss@netzguerilla.net>
parents:
277
diff
changeset
|
16 |
from docutils.utils import new_document |
|
271
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
17 |
from docutils.writers.html4css1 import Writer,HTMLTranslator |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
18 |
|
|
277
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
19 |
from iro.view.xmlrpc import TwistedInterface as Current |
|
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
20 |
from iro import __version__ |
|
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
21 |
from createerm import createSchemaPlot, tables, tables_cls |
|
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
22 |
|
|
281
76572d14bd27
createdoc.py: cleaning up
Sandro Knauß <knauss@netzguerilla.net>
parents:
277
diff
changeset
|
23 |
#redering text with rest syntax |
|
271
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
24 |
class NoHeaderHTMLTranslator(HTMLTranslator): |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
25 |
def __init__(self, document): |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
26 |
HTMLTranslator.__init__(self,document) |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
27 |
self.body_prefix = [] |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
28 |
self.body_suffix = [] |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
29 |
|
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
30 |
_w = Writer() |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
31 |
_w.translator_class = NoHeaderHTMLTranslator |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
32 |
_w.visitor_attributes = ("html_body",) |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
33 |
|
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
34 |
def d(): |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
35 |
subs = _w.interpolation_dict() |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
36 |
return "%(html_body)s"%subs |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
37 |
|
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
38 |
_w.apply_template = d |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
39 |
|
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
40 |
def reSTify(s): |
|
281
76572d14bd27
createdoc.py: cleaning up
Sandro Knauß <knauss@netzguerilla.net>
parents:
277
diff
changeset
|
41 |
d = new_document("") |
|
271
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
42 |
if s.tagname == "paragraph": |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
43 |
d.append(s[0]) |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
44 |
else: |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
45 |
d.append(s) |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
46 |
|
|
281
76572d14bd27
createdoc.py: cleaning up
Sandro Knauß <knauss@netzguerilla.net>
parents:
277
diff
changeset
|
47 |
return publish_from_doctree(d, writer=_w) |
|
76572d14bd27
createdoc.py: cleaning up
Sandro Knauß <knauss@netzguerilla.net>
parents:
277
diff
changeset
|
48 |
|
|
76572d14bd27
createdoc.py: cleaning up
Sandro Knauß <knauss@netzguerilla.net>
parents:
277
diff
changeset
|
49 |
|
|
271
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
50 |
|
|
76
9f7da8dc8df8
using decode('utf8') to get docstrings.
Sandro Knauß <knauss@netzguerilla.net>
parents:
74
diff
changeset
|
51 |
|
| 72 | 52 |
class Link(): |
53 |
def __init__(self,name,title): |
|
54 |
self.name=name |
|
55 |
self.title=title |
|
56 |
||
57 |
def getLink(self): |
|
58 |
return self.name |
|
59 |
||
60 |
def __getitem__(self,name): |
|
61 |
if name == "link": |
|
62 |
return self.getLink() |
|
63 |
return AttributeError(name) |
|
64 |
||
65 |
class Site(Link): |
|
66 |
pass |
|
67 |
||
|
281
76572d14bd27
createdoc.py: cleaning up
Sandro Knauß <knauss@netzguerilla.net>
parents:
277
diff
changeset
|
68 |
|
| 72 | 69 |
class Keyword(): |
|
271
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
70 |
def __init__(self, name=None, typ=None, description=None): |
| 72 | 71 |
self.name=name |
72 |
self.typ=typ |
|
73 |
self.description=description |
|
74 |
||
|
271
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
75 |
def __repr__(self): |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
76 |
return '<Keyword("%s", "%s", "%s")>'%(self.name, self.typ, self.description) |
| 72 | 77 |
|
78 |
def keywords(f): |
|
|
271
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
79 |
NORMAL = 0 |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
80 |
TYPE = 1 |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
81 |
pd = publish_doctree(f.__doc__.decode('utf8')) |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
82 |
|
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
83 |
kws={} |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
84 |
for child in pd[1][0]: |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
85 |
kw = Keyword() |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
86 |
ftyp = NORMAL |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
87 |
for sc in child: |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
88 |
if sc.tagname == "field_name": |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
89 |
p = sc.astext().split() |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
90 |
if p[0] in ["param",]: |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
91 |
if len(p) == 3: #param typ name |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
92 |
kw.name = p[2] |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
93 |
kw.typ = p[1] |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
94 |
if len(p) == 2: |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
95 |
kw.name = p[1] |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
96 |
elif p[0] == "type": |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
97 |
kw = kws[p[1]] |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
98 |
ftyp=TYPE |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
99 |
elif p[0] in ["return","rtyp"]: |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
100 |
break |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
101 |
else: |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
102 |
raise Exception("Unknown field_name: %s"%(p[0])) |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
103 |
if sc.tagname == "field_body": |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
104 |
if ftyp == NORMAL: |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
105 |
kw.description = Markup(reSTify(sc[0])) |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
106 |
if ftyp == TYPE: |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
107 |
kw.typ = sc[0][0] |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
108 |
else: |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
109 |
kws[kw.name] = kw |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
110 |
return kws |
| 72 | 111 |
|
112 |
def ret(f): |
|
|
271
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
113 |
NORMAL = 0 |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
114 |
TYPE = 1 |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
115 |
|
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
116 |
pd = publish_doctree(f.__doc__.decode('utf8')) |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
117 |
for child in pd[1][0]: |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
118 |
kw = Keyword(name="return") |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
119 |
ftyp = NORMAL |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
120 |
for sc in child: |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
121 |
if sc.tagname == "field_name": |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
122 |
p = sc.astext().split() |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
123 |
if p[0] == "return": |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
124 |
if len(p) == 2: |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
125 |
kw.typ = p[1] |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
126 |
elif p[0] == "rtype": |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
127 |
ftyp=TYPE |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
128 |
elif p[0] in ["param","type"]: |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
129 |
break |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
130 |
else: |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
131 |
raise Exception("Unknown field_name: %s"%(p[0])) |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
132 |
if sc.tagname == "field_body": |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
133 |
if ftyp == NORMAL: |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
134 |
kw.description = Markup(reSTify(sc[0])) |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
135 |
if ftyp == TYPE: |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
136 |
kw.typ = sc[0][0] |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
137 |
else: |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
138 |
return kw |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
139 |
|
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
140 |
raise Exception("no return description") |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
141 |
|
| 72 | 142 |
class Arg(): |
143 |
def __init__(self,name,f): |
|
144 |
self.name=name |
|
|
271
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
145 |
k = keywords(f) |
| 72 | 146 |
kwd=k[name] |
147 |
self.typ=kwd.typ |
|
148 |
self.description=kwd.description |
|
149 |
||
150 |
class Method(Link): |
|
| 73 | 151 |
def __init__(self,name,methods): |
152 |
title=name[0].upper()+name[1:] |
|
| 72 | 153 |
Link.__init__(self,name,title) |
| 73 | 154 |
m=methods[name] |
|
74
c471fed3cab8
update document creation:
Sandro Knauß <knauss@netzguerilla.net>
parents:
73
diff
changeset
|
155 |
(args, varargs, keywords, defaults)=inspect.getargspec(m) |
|
250
91890ea7ed81
update docstrings in iro.controller.viewinterface for createdoc
Sandro Knauß <knauss@netzguerilla.net>
parents:
92
diff
changeset
|
156 |
a=[] |
|
91890ea7ed81
update docstrings in iro.controller.viewinterface for createdoc
Sandro Knauß <knauss@netzguerilla.net>
parents:
92
diff
changeset
|
157 |
for b in args: |
|
91890ea7ed81
update docstrings in iro.controller.viewinterface for createdoc
Sandro Knauß <knauss@netzguerilla.net>
parents:
92
diff
changeset
|
158 |
if b in ("self","session"): |
|
91890ea7ed81
update docstrings in iro.controller.viewinterface for createdoc
Sandro Knauß <knauss@netzguerilla.net>
parents:
92
diff
changeset
|
159 |
continue |
|
91890ea7ed81
update docstrings in iro.controller.viewinterface for createdoc
Sandro Knauß <knauss@netzguerilla.net>
parents:
92
diff
changeset
|
160 |
else: |
|
91890ea7ed81
update docstrings in iro.controller.viewinterface for createdoc
Sandro Knauß <knauss@netzguerilla.net>
parents:
92
diff
changeset
|
161 |
a.append(b) |
|
91890ea7ed81
update docstrings in iro.controller.viewinterface for createdoc
Sandro Knauß <knauss@netzguerilla.net>
parents:
92
diff
changeset
|
162 |
|
|
91890ea7ed81
update docstrings in iro.controller.viewinterface for createdoc
Sandro Knauß <knauss@netzguerilla.net>
parents:
92
diff
changeset
|
163 |
args = a |
|
74
c471fed3cab8
update document creation:
Sandro Knauß <knauss@netzguerilla.net>
parents:
73
diff
changeset
|
164 |
self.func_line=inspect.formatargspec(args, varargs, keywords, defaults) |
|
271
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
165 |
pd = publish_doctree(m.__doc__) |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
166 |
if pd[0].tagname == "paragraph": |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
167 |
self.description = pd[0].astext() |
|
74
c471fed3cab8
update document creation:
Sandro Knauß <knauss@netzguerilla.net>
parents:
73
diff
changeset
|
168 |
self.args=[Arg(a,m) for a in args] |
|
271
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
169 |
self.rets=[ret(m)] |
| 72 | 170 |
|
|
77
7dce6c0f06fb
adding database schema to documentation.
Sandro Knauß <knauss@netzguerilla.net>
parents:
76
diff
changeset
|
171 |
class Table(Link): |
|
7dce6c0f06fb
adding database schema to documentation.
Sandro Knauß <knauss@netzguerilla.net>
parents:
76
diff
changeset
|
172 |
def __init__(self,cls): |
|
7dce6c0f06fb
adding database schema to documentation.
Sandro Knauß <knauss@netzguerilla.net>
parents:
76
diff
changeset
|
173 |
name=cls.__name__ |
|
7dce6c0f06fb
adding database schema to documentation.
Sandro Knauß <knauss@netzguerilla.net>
parents:
76
diff
changeset
|
174 |
self.tablename=cls.__tablename__ |
|
7dce6c0f06fb
adding database schema to documentation.
Sandro Knauß <knauss@netzguerilla.net>
parents:
76
diff
changeset
|
175 |
title=self.tablename[0].upper()+self.tablename[1:] |
|
7dce6c0f06fb
adding database schema to documentation.
Sandro Knauß <knauss@netzguerilla.net>
parents:
76
diff
changeset
|
176 |
Link.__init__(self,name,title) |
|
271
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
177 |
|
|
281
76572d14bd27
createdoc.py: cleaning up
Sandro Knauß <knauss@netzguerilla.net>
parents:
277
diff
changeset
|
178 |
self.description = Markup(publish_string(cls.__doc__,writer=_w)) |
|
77
7dce6c0f06fb
adding database schema to documentation.
Sandro Knauß <knauss@netzguerilla.net>
parents:
76
diff
changeset
|
179 |
|
|
277
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
180 |
class File: |
|
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
181 |
def __init__(self,path): |
|
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
182 |
self.version = re.search("/iro-(.*).tar.gz",path).group(1) |
|
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
183 |
self.name = os.path.basename(path) |
|
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
184 |
|
| 72 | 185 |
|
186 |
def main(): |
|
187 |
sites=[Site("index.html","Iro"), |
|
188 |
Site("current.html","API Documentation"), |
|
|
271
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
189 |
Site("database.html","Datenbase Schema"), |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
190 |
Site("about.html","About us"), |
| 72 | 191 |
] |
192 |
||
|
277
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
193 |
files=[File(f) for f in glob("web/files/*tar.gz")] |
|
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
194 |
files.sort(key=lambda a:parse_version(a.version),reverse=True) |
|
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
195 |
code ="files/iro-%s.tar.gz"%__version__ |
|
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
196 |
|
|
271
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
197 |
current_methods = dict(inspect.getmembers(Current())) |
|
b218238e76b9
creadoc: switching to rst syntax
Sandro Knauß <knauss@netzguerilla.net>
parents:
251
diff
changeset
|
198 |
current=[ Method(i,current_methods) for i in Current().listMethods() if i != "listMethods" ] |
|
77
7dce6c0f06fb
adding database schema to documentation.
Sandro Knauß <knauss@netzguerilla.net>
parents:
76
diff
changeset
|
199 |
|
|
251
3caa803a2dec
getting corresbonding table classes out of schema
Sandro Knauß <knauss@netzguerilla.net>
parents:
250
diff
changeset
|
200 |
t = [Table(tables_cls[str(f)]) for f in tables] |
|
277
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
201 |
createSchemaPlot('web/images/db-schema.svg') |
|
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
202 |
|
|
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
203 |
gd = {"sites":sites, |
|
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
204 |
"current":current, |
|
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
205 |
"tables": t, |
|
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
206 |
"code":code, |
|
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
207 |
"files":files |
|
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
208 |
} |
| 73 | 209 |
|
| 72 | 210 |
for site in sites: |
211 |
print("generiere %s" % site.name) |
|
212 |
tmpl = loader.load(site.name) |
|
213 |
def a(s): |
|
214 |
if s == site: |
|
215 |
return {"class":"menu active"} |
|
|
277
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
216 |
stream = tmpl.generate(active=a, **gd) |
|
f65edc0382cc
prepare for release:
Sandro Knauß <knauss@netzguerilla.net>
parents:
271
diff
changeset
|
217 |
with open('web/'+site.name, "w") as g: |
| 72 | 218 |
g.write(stream.render('html', doctype='html')) |
219 |
||
220 |
if __name__ == '__main__': |
|
221 |
main() |