author | Julien Cristau <julien.cristau@logilab.fr> |
Thu, 08 Jan 2015 12:22:43 +0100 | |
changeset 10146 | 78f541f50369 |
parent 10023 | c3ab46842b2d |
child 10212 | dccce2be3101 |
child 10952 | 4f28cb25b6c1 |
permissions | -rw-r--r-- |
9322
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
1 |
# copyright 2003-2013 LOGILAB S.A. (Paris, FRANCE), all rights reserved. |
5421
8167de96c523
proper licensing information (LGPL-2.1). Hope I get it right this time.
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4771
diff
changeset
|
2 |
# contact http://www.logilab.fr/ -- mailto:contact@logilab.fr |
8167de96c523
proper licensing information (LGPL-2.1). Hope I get it right this time.
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4771
diff
changeset
|
3 |
# |
8167de96c523
proper licensing information (LGPL-2.1). Hope I get it right this time.
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4771
diff
changeset
|
4 |
# This file is part of CubicWeb. |
8167de96c523
proper licensing information (LGPL-2.1). Hope I get it right this time.
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4771
diff
changeset
|
5 |
# |
8167de96c523
proper licensing information (LGPL-2.1). Hope I get it right this time.
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4771
diff
changeset
|
6 |
# CubicWeb is free software: you can redistribute it and/or modify it under the |
8167de96c523
proper licensing information (LGPL-2.1). Hope I get it right this time.
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4771
diff
changeset
|
7 |
# terms of the GNU Lesser General Public License as published by the Free |
8167de96c523
proper licensing information (LGPL-2.1). Hope I get it right this time.
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4771
diff
changeset
|
8 |
# Software Foundation, either version 2.1 of the License, or (at your option) |
8167de96c523
proper licensing information (LGPL-2.1). Hope I get it right this time.
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4771
diff
changeset
|
9 |
# any later version. |
8167de96c523
proper licensing information (LGPL-2.1). Hope I get it right this time.
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4771
diff
changeset
|
10 |
# |
5424
8ecbcbff9777
replace logilab-common by CubicWeb in disclaimer
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
5421
diff
changeset
|
11 |
# CubicWeb is distributed in the hope that it will be useful, but WITHOUT |
5421
8167de96c523
proper licensing information (LGPL-2.1). Hope I get it right this time.
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4771
diff
changeset
|
12 |
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS |
8167de96c523
proper licensing information (LGPL-2.1). Hope I get it right this time.
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4771
diff
changeset
|
13 |
# FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more |
8167de96c523
proper licensing information (LGPL-2.1). Hope I get it right this time.
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4771
diff
changeset
|
14 |
# details. |
8167de96c523
proper licensing information (LGPL-2.1). Hope I get it right this time.
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4771
diff
changeset
|
15 |
# |
8167de96c523
proper licensing information (LGPL-2.1). Hope I get it right this time.
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4771
diff
changeset
|
16 |
# You should have received a copy of the GNU Lesser General Public License along |
8167de96c523
proper licensing information (LGPL-2.1). Hope I get it right this time.
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4771
diff
changeset
|
17 |
# with CubicWeb. If not, see <http://www.gnu.org/licenses/>. |
0 | 18 |
"""rest publishing functions |
19 |
||
996 | 20 |
contains some functions and setup of docutils for cubicweb. Provides the |
21 |
following ReST directives: |
|
22 |
||
23 |
* `eid`, create link to entity in the repository by their eid |
|
24 |
||
25 |
* `card`, create link to card entity in the repository by their wikiid |
|
26 |
(proposing to create it when the refered card doesn't exist yet) |
|
27 |
||
28 |
* `winclude`, reference to a web documentation file (in wdoc/ directories) |
|
29 |
||
30 |
* `sourcecode` (if pygments is installed), source code colorization |
|
0 | 31 |
|
9322
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
32 |
* `rql-table`, create a table from a RQL query |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
33 |
|
0 | 34 |
""" |
35 |
__docformat__ = "restructuredtext en" |
|
36 |
||
37 |
from cStringIO import StringIO |
|
38 |
from itertools import chain |
|
39 |
from logging import getLogger |
|
40 |
from os.path import join |
|
8852
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
41 |
from urlparse import urlsplit |
0 | 42 |
|
43 |
from docutils import statemachine, nodes, utils, io |
|
4771
e27d23f875c6
custom rest publisher instead of using rest_publish. Avoid to keep a ref on the latest context
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4769
diff
changeset
|
44 |
from docutils.core import Publisher |
9322
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
45 |
from docutils.parsers.rst import Parser, states, directives, Directive |
0 | 46 |
from docutils.parsers.rst.roles import register_canonical_role, set_classes |
47 |
||
2312
af4d8f75c5db
use xml_escape
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2311
diff
changeset
|
48 |
from logilab.mtconverter import ESC_UCAR_TABLE, ESC_CAR_TABLE, xml_escape |
0 | 49 |
|
2467
6983631f5d0d
don't fail on unknown eid, simply issue a warning
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2312
diff
changeset
|
50 |
from cubicweb import UnknownEid |
704
0c2c8f0a6ded
new ext package for modules depending on an option third party package
sylvain.thenault@logilab.fr
parents:
0
diff
changeset
|
51 |
from cubicweb.ext.html4zope import Writer |
0 | 52 |
|
6938
6c1a960735f5
add a rql directive to restructuredtext
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
6275
diff
changeset
|
53 |
from cubicweb.web.views import vid_from_rset # XXX better not to import c.w.views here... |
6c1a960735f5
add a rql directive to restructuredtext
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
6275
diff
changeset
|
54 |
|
0 | 55 |
# We provide our own parser as an attempt to get rid of |
56 |
# state machine reinstanciation |
|
57 |
||
58 |
import re |
|
59 |
# compile states.Body patterns |
|
60 |
for k, v in states.Body.patterns.items(): |
|
61 |
if isinstance(v, str): |
|
62 |
states.Body.patterns[k] = re.compile(v) |
|
63 |
||
64 |
# register ReStructured Text mimetype / extensions |
|
65 |
import mimetypes |
|
66 |
mimetypes.add_type('text/rest', '.rest') |
|
67 |
mimetypes.add_type('text/rest', '.rst') |
|
68 |
||
69 |
||
70 |
LOGGER = getLogger('cubicweb.rest') |
|
71 |
||
72 |
def eid_reference_role(role, rawtext, text, lineno, inliner, |
|
73 |
options={}, content=[]): |
|
74 |
try: |
|
75 |
try: |
|
76 |
eid_num, rest = text.split(u':', 1) |
|
7815
2a164a9cf81c
[exceptions] stop catching any exception in various places (closes #1942716)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7732
diff
changeset
|
77 |
except ValueError: |
0 | 78 |
eid_num, rest = text, '#'+text |
79 |
eid_num = int(eid_num) |
|
80 |
if eid_num < 0: |
|
81 |
raise ValueError |
|
82 |
except ValueError: |
|
83 |
msg = inliner.reporter.error( |
|
84 |
'EID number must be a positive number; "%s" is invalid.' |
|
85 |
% text, line=lineno) |
|
86 |
prb = inliner.problematic(rawtext, rawtext, msg) |
|
87 |
return [prb], [msg] |
|
88 |
# Base URL mainly used by inliner.pep_reference; so this is correct: |
|
89 |
context = inliner.document.settings.context |
|
2467
6983631f5d0d
don't fail on unknown eid, simply issue a warning
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2312
diff
changeset
|
90 |
try: |
3418
7b49fa7e942d
[api] use _cw, cw_row, cw_col, cw_rset etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
2680
diff
changeset
|
91 |
refedentity = context._cw.entity_from_eid(eid_num) |
2467
6983631f5d0d
don't fail on unknown eid, simply issue a warning
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2312
diff
changeset
|
92 |
except UnknownEid: |
6983631f5d0d
don't fail on unknown eid, simply issue a warning
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2312
diff
changeset
|
93 |
ref = '#' |
3418
7b49fa7e942d
[api] use _cw, cw_row, cw_col, cw_rset etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
2680
diff
changeset
|
94 |
rest += u' ' + context._cw._('(UNEXISTANT EID)') |
2467
6983631f5d0d
don't fail on unknown eid, simply issue a warning
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2312
diff
changeset
|
95 |
else: |
6983631f5d0d
don't fail on unknown eid, simply issue a warning
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2312
diff
changeset
|
96 |
ref = refedentity.absolute_url() |
0 | 97 |
set_classes(options) |
98 |
return [nodes.reference(rawtext, utils.unescape(rest), refuri=ref, |
|
99 |
**options)], [] |
|
100 |
||
6938
6c1a960735f5
add a rql directive to restructuredtext
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
6275
diff
changeset
|
101 |
def rql_role(role, rawtext, text, lineno, inliner, options={}, content=[]): |
10023
c3ab46842b2d
[book] fix docstrings to please sphinx
David Douard <david.douard@logilab.fr>
parents:
9592
diff
changeset
|
102 |
"""``:rql:`<rql-expr>``` or ``:rql:`<rql-expr>:<vid>``` |
8710
becbbbc840b8
[ext/rest] fix docstring of rql_role()
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
7879
diff
changeset
|
103 |
|
10023
c3ab46842b2d
[book] fix docstrings to please sphinx
David Douard <david.douard@logilab.fr>
parents:
9592
diff
changeset
|
104 |
Example: ``:rql:`Any X,Y WHERE X is CWUser, X login Y:table``` |
8710
becbbbc840b8
[ext/rest] fix docstring of rql_role()
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
7879
diff
changeset
|
105 |
|
becbbbc840b8
[ext/rest] fix docstring of rql_role()
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
7879
diff
changeset
|
106 |
Replace the directive with the output of applying the view to the resultset |
becbbbc840b8
[ext/rest] fix docstring of rql_role()
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
7879
diff
changeset
|
107 |
returned by the query. |
becbbbc840b8
[ext/rest] fix docstring of rql_role()
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
7879
diff
changeset
|
108 |
|
becbbbc840b8
[ext/rest] fix docstring of rql_role()
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
7879
diff
changeset
|
109 |
"X eid %(userid)s" can be used in the RQL query for this query will be |
becbbbc840b8
[ext/rest] fix docstring of rql_role()
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
7879
diff
changeset
|
110 |
executed with the argument {'userid': _cw.user.eid}. |
becbbbc840b8
[ext/rest] fix docstring of rql_role()
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
7879
diff
changeset
|
111 |
""" |
6938
6c1a960735f5
add a rql directive to restructuredtext
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
6275
diff
changeset
|
112 |
_cw = inliner.document.settings.context._cw |
6c1a960735f5
add a rql directive to restructuredtext
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
6275
diff
changeset
|
113 |
text = text.strip() |
6c1a960735f5
add a rql directive to restructuredtext
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
6275
diff
changeset
|
114 |
if ':' in text: |
6c1a960735f5
add a rql directive to restructuredtext
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
6275
diff
changeset
|
115 |
rql, vid = text.rsplit(u':', 1) |
6c1a960735f5
add a rql directive to restructuredtext
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
6275
diff
changeset
|
116 |
rql = rql.strip() |
6c1a960735f5
add a rql directive to restructuredtext
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
6275
diff
changeset
|
117 |
else: |
6c1a960735f5
add a rql directive to restructuredtext
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
6275
diff
changeset
|
118 |
rql, vid = text, None |
6c1a960735f5
add a rql directive to restructuredtext
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
6275
diff
changeset
|
119 |
_cw.ensure_ro_rql(rql) |
7732
5430d0db52ab
[web] rql directive breaks if explicit vid and empty rset (closes #1893433)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
7577
diff
changeset
|
120 |
try: |
5430d0db52ab
[web] rql directive breaks if explicit vid and empty rset (closes #1893433)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
7577
diff
changeset
|
121 |
rset = _cw.execute(rql, {'userid': _cw.user.eid}) |
5430d0db52ab
[web] rql directive breaks if explicit vid and empty rset (closes #1893433)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
7577
diff
changeset
|
122 |
if rset: |
5430d0db52ab
[web] rql directive breaks if explicit vid and empty rset (closes #1893433)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
7577
diff
changeset
|
123 |
if vid is None: |
5430d0db52ab
[web] rql directive breaks if explicit vid and empty rset (closes #1893433)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
7577
diff
changeset
|
124 |
vid = vid_from_rset(_cw, rset, _cw.vreg.schema) |
5430d0db52ab
[web] rql directive breaks if explicit vid and empty rset (closes #1893433)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
7577
diff
changeset
|
125 |
else: |
5430d0db52ab
[web] rql directive breaks if explicit vid and empty rset (closes #1893433)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
7577
diff
changeset
|
126 |
vid = 'noresult' |
5430d0db52ab
[web] rql directive breaks if explicit vid and empty rset (closes #1893433)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
7577
diff
changeset
|
127 |
view = _cw.vreg['views'].select(vid, _cw, rset=rset) |
5430d0db52ab
[web] rql directive breaks if explicit vid and empty rset (closes #1893433)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
7577
diff
changeset
|
128 |
content = view.render() |
8695
358d8bed9626
[toward-py3k] rewrite to "except AnException as exc:" (part of #2711624)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
7879
diff
changeset
|
129 |
except Exception as exc: |
9517
3338b2205ea3
Typo in comments and error messages
Dimitri Papadopoulos <dimitri.papadopoulos@cea.fr>
parents:
9322
diff
changeset
|
130 |
content = 'an error occurred while interpreting this rql directive: %r' % exc |
6938
6c1a960735f5
add a rql directive to restructuredtext
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
6275
diff
changeset
|
131 |
set_classes(options) |
6c1a960735f5
add a rql directive to restructuredtext
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
6275
diff
changeset
|
132 |
return [nodes.raw('', content, format='html')], [] |
0 | 133 |
|
8852
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
134 |
def bookmark_role(role, rawtext, text, lineno, inliner, options={}, content=[]): |
10023
c3ab46842b2d
[book] fix docstrings to please sphinx
David Douard <david.douard@logilab.fr>
parents:
9592
diff
changeset
|
135 |
"""``:bookmark:`<bookmark-eid>``` or ``:bookmark:`<eid>:<vid>``` |
8852
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
136 |
|
10023
c3ab46842b2d
[book] fix docstrings to please sphinx
David Douard <david.douard@logilab.fr>
parents:
9592
diff
changeset
|
137 |
Example: ``:bookmark:`1234:table``` |
8852
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
138 |
|
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
139 |
Replace the directive with the output of applying the view to the resultset |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
140 |
returned by the query stored in the bookmark. By default, the view is the one |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
141 |
stored in the bookmark, but it can be overridden by the directive as in the |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
142 |
example above. |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
143 |
|
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
144 |
"X eid %(userid)s" can be used in the RQL query stored in the Bookmark, for |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
145 |
this query will be executed with the argument {'userid': _cw.user.eid}. |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
146 |
""" |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
147 |
_cw = inliner.document.settings.context._cw |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
148 |
text = text.strip() |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
149 |
try: |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
150 |
if ':' in text: |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
151 |
eid, vid = text.rsplit(u':', 1) |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
152 |
eid = int(eid) |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
153 |
else: |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
154 |
eid, vid = int(text), None |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
155 |
except ValueError: |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
156 |
msg = inliner.reporter.error( |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
157 |
'EID number must be a positive number; "%s" is invalid.' |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
158 |
% text, line=lineno) |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
159 |
prb = inliner.problematic(rawtext, rawtext, msg) |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
160 |
return [prb], [msg] |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
161 |
try: |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
162 |
bookmark = _cw.entity_from_eid(eid) |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
163 |
except UnknownEid: |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
164 |
msg = inliner.reporter.error('Unknown EID %s.' % text, line=lineno) |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
165 |
prb = inliner.problematic(rawtext, rawtext, msg) |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
166 |
return [prb], [msg] |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
167 |
try: |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
168 |
params = dict(_cw.url_parse_qsl(urlsplit(bookmark.path).query)) |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
169 |
rql = params['rql'] |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
170 |
if vid is None: |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
171 |
vid = params.get('vid') |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
172 |
except (ValueError, KeyError), exc: |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
173 |
msg = inliner.reporter.error('Could not parse bookmark path %s [%s].' |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
174 |
% (bookmark.path, exc), line=lineno) |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
175 |
prb = inliner.problematic(rawtext, rawtext, msg) |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
176 |
return [prb], [msg] |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
177 |
try: |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
178 |
rset = _cw.execute(rql, {'userid': _cw.user.eid}) |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
179 |
if rset: |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
180 |
if vid is None: |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
181 |
vid = vid_from_rset(_cw, rset, _cw.vreg.schema) |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
182 |
else: |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
183 |
vid = 'noresult' |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
184 |
view = _cw.vreg['views'].select(vid, _cw, rset=rset) |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
185 |
content = view.render() |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
186 |
except Exception, exc: |
9517
3338b2205ea3
Typo in comments and error messages
Dimitri Papadopoulos <dimitri.papadopoulos@cea.fr>
parents:
9322
diff
changeset
|
187 |
content = 'An error occurred while interpreting directive bookmark: %r' % exc |
8852
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
188 |
set_classes(options) |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
189 |
return [nodes.raw('', content, format='html')], [] |
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
190 |
|
0 | 191 |
def winclude_directive(name, arguments, options, content, lineno, |
192 |
content_offset, block_text, state, state_machine): |
|
193 |
"""Include a reST file as part of the content of this reST file. |
|
194 |
||
195 |
same as standard include directive but using config.locate_doc_resource to |
|
196 |
get actual file to include. |
|
197 |
||
198 |
Most part of this implementation is copied from `include` directive defined |
|
199 |
in `docutils.parsers.rst.directives.misc` |
|
200 |
""" |
|
201 |
context = state.document.settings.context |
|
4769
5b878b02b67b
[rest] cleanup, avoid deprecation warning
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4719
diff
changeset
|
202 |
cw = context._cw |
0 | 203 |
source = state_machine.input_lines.source( |
204 |
lineno - state_machine.input_offset - 1) |
|
205 |
#source_dir = os.path.dirname(os.path.abspath(source)) |
|
206 |
fid = arguments[0] |
|
4769
5b878b02b67b
[rest] cleanup, avoid deprecation warning
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4719
diff
changeset
|
207 |
for lang in chain((cw.lang, cw.vreg.property_value('ui.language')), |
5b878b02b67b
[rest] cleanup, avoid deprecation warning
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4719
diff
changeset
|
208 |
cw.vreg.config.available_languages()): |
0 | 209 |
rid = '%s_%s.rst' % (fid, lang) |
4769
5b878b02b67b
[rest] cleanup, avoid deprecation warning
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4719
diff
changeset
|
210 |
resourcedir = cw.vreg.config.locate_doc_file(rid) |
0 | 211 |
if resourcedir: |
212 |
break |
|
213 |
else: |
|
214 |
severe = state_machine.reporter.severe( |
|
215 |
'Problems with "%s" directive path:\nno resource matching %s.' |
|
216 |
% (name, fid), |
|
217 |
nodes.literal_block(block_text, block_text), line=lineno) |
|
218 |
return [severe] |
|
219 |
path = join(resourcedir, rid) |
|
220 |
encoding = options.get('encoding', state.document.settings.input_encoding) |
|
221 |
try: |
|
222 |
state.document.settings.record_dependencies.add(path) |
|
223 |
include_file = io.FileInput( |
|
224 |
source_path=path, encoding=encoding, |
|
225 |
error_handler=state.document.settings.input_encoding_error_handler, |
|
226 |
handle_io_errors=None) |
|
8695
358d8bed9626
[toward-py3k] rewrite to "except AnException as exc:" (part of #2711624)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
7879
diff
changeset
|
227 |
except IOError as error: |
0 | 228 |
severe = state_machine.reporter.severe( |
229 |
'Problems with "%s" directive path:\n%s: %s.' |
|
230 |
% (name, error.__class__.__name__, error), |
|
231 |
nodes.literal_block(block_text, block_text), line=lineno) |
|
232 |
return [severe] |
|
233 |
try: |
|
234 |
include_text = include_file.read() |
|
8695
358d8bed9626
[toward-py3k] rewrite to "except AnException as exc:" (part of #2711624)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
7879
diff
changeset
|
235 |
except UnicodeError as error: |
0 | 236 |
severe = state_machine.reporter.severe( |
237 |
'Problem with "%s" directive:\n%s: %s' |
|
238 |
% (name, error.__class__.__name__, error), |
|
239 |
nodes.literal_block(block_text, block_text), line=lineno) |
|
240 |
return [severe] |
|
8697
574bb05e40a4
[toward py3k] rewrite has_key() (part of #2711624)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8695
diff
changeset
|
241 |
if 'literal' in options: |
0 | 242 |
literal_block = nodes.literal_block(include_text, include_text, |
243 |
source=path) |
|
244 |
literal_block.line = 1 |
|
245 |
return literal_block |
|
246 |
else: |
|
247 |
include_lines = statemachine.string2lines(include_text, |
|
248 |
convert_whitespace=1) |
|
249 |
state_machine.insert_input(include_lines, path) |
|
250 |
return [] |
|
251 |
||
252 |
winclude_directive.arguments = (1, 0, 1) |
|
253 |
winclude_directive.options = {'literal': directives.flag, |
|
254 |
'encoding': directives.encoding} |
|
255 |
||
9322
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
256 |
class RQLTableDirective(Directive): |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
257 |
"""rql-table directive |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
258 |
|
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
259 |
Example: |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
260 |
|
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
261 |
.. rql-table:: |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
262 |
:vid: mytable |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
263 |
:headers: , , progress |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
264 |
:colvids: 2=progress |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
265 |
|
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
266 |
Any X,U,X WHERE X is Project, X url U |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
267 |
|
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
268 |
All fields but the RQL string are optionnal. The ``:headers:`` option can |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
269 |
contain empty column names. |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
270 |
""" |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
271 |
|
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
272 |
required_arguments = 0 |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
273 |
optional_arguments = 0 |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
274 |
has_content= True |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
275 |
final_argument_whitespace = True |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
276 |
option_spec = {'vid': directives.unchanged, |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
277 |
'headers': directives.unchanged, |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
278 |
'colvids': directives.unchanged} |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
279 |
|
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
280 |
def run(self): |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
281 |
errid = "rql-table directive" |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
282 |
self.assert_has_content() |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
283 |
if self.arguments: |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
284 |
raise self.warning('%s does not accept arguments' % errid) |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
285 |
rql = ' '.join([l.strip() for l in self.content]) |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
286 |
_cw = self.state.document.settings.context._cw |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
287 |
_cw.ensure_ro_rql(rql) |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
288 |
try: |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
289 |
rset = _cw.execute(rql) |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
290 |
except Exception as exc: |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
291 |
raise self.error("fail to execute RQL query in %s: %r" % |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
292 |
(errid, exc)) |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
293 |
if not rset: |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
294 |
raise self.warning("empty result set") |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
295 |
vid = self.options.get('vid', 'table') |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
296 |
try: |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
297 |
view = _cw.vreg['views'].select(vid, _cw, rset=rset) |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
298 |
except Exception as exc: |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
299 |
raise self.error("fail to select '%s' view in %s: %r" % |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
300 |
(vid, errid, exc)) |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
301 |
headers = None |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
302 |
if 'headers' in self.options: |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
303 |
headers = [h.strip() for h in self.options['headers'].split(',')] |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
304 |
while headers.count(''): |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
305 |
headers[headers.index('')] = None |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
306 |
if len(headers) != len(rset[0]): |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
307 |
raise self.error("the number of 'headers' does not match the " |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
308 |
"number of columns in %s" % errid) |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
309 |
cellvids = None |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
310 |
if 'colvids' in self.options: |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
311 |
cellvids = {} |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
312 |
for f in self.options['colvids'].split(','): |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
313 |
try: |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
314 |
idx, vid = f.strip().split('=') |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
315 |
except ValueError: |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
316 |
raise self.error("malformatted 'colvids' option in %s" % |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
317 |
errid) |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
318 |
cellvids[int(idx.strip())] = vid.strip() |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
319 |
try: |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
320 |
content = view.render(headers=headers, cellvids=cellvids) |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
321 |
except Exception as exc: |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
322 |
raise self.error("Error rendering %s (%s)" % (errid, exc)) |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
323 |
return [nodes.raw('', content, format='html')] |
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
324 |
|
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
325 |
|
996 | 326 |
try: |
327 |
from pygments import highlight |
|
4719
aaed3f813ef8
kill dead/useless code as suggested by pylint
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4483
diff
changeset
|
328 |
from pygments.lexers import get_lexer_by_name |
7879
9aae456abab5
[pylint] fix pylint detected errors and tweak it so that pylint -E will be much less verbose next time (+ update some copyrights on the way)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
7815
diff
changeset
|
329 |
from pygments.formatters.html import HtmlFormatter |
996 | 330 |
except ImportError: |
4118
8a9a00a9405c
quick and dirty fix trying to avoid rest directive conflicts when using sphinx (which seems to import the code)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2680
diff
changeset
|
331 |
pygments_directive = None |
996 | 332 |
else: |
333 |
_PYGMENTS_FORMATTER = HtmlFormatter() |
|
334 |
||
335 |
def pygments_directive(name, arguments, options, content, lineno, |
|
336 |
content_offset, block_text, state, state_machine): |
|
337 |
try: |
|
338 |
lexer = get_lexer_by_name(arguments[0]) |
|
339 |
except ValueError: |
|
340 |
# no lexer found |
|
341 |
lexer = get_lexer_by_name('text') |
|
342 |
parsed = highlight(u'\n'.join(content), lexer, _PYGMENTS_FORMATTER) |
|
4483
918fd9931cb7
cleanup, don't fail if no context set on the sourcecode directive
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4334
diff
changeset
|
343 |
# don't fail if no context set on the sourcecode directive |
918fd9931cb7
cleanup, don't fail if no context set on the sourcecode directive
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4334
diff
changeset
|
344 |
try: |
918fd9931cb7
cleanup, don't fail if no context set on the sourcecode directive
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4334
diff
changeset
|
345 |
context = state.document.settings.context |
918fd9931cb7
cleanup, don't fail if no context set on the sourcecode directive
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4334
diff
changeset
|
346 |
context._cw.add_css('pygments.css') |
918fd9931cb7
cleanup, don't fail if no context set on the sourcecode directive
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4334
diff
changeset
|
347 |
except AttributeError: |
7577
9892937d9041
[all] remove pattern "try: function() except AttributeError: pass" (closes #1787966)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
6938
diff
changeset
|
348 |
# used outside cubicweb XXX use hasattr instead |
4483
918fd9931cb7
cleanup, don't fail if no context set on the sourcecode directive
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4334
diff
changeset
|
349 |
pass |
996 | 350 |
return [nodes.raw('', parsed, format='html')] |
1447
a1ca676294f0
don't use a singleton rest parser which may leads to concurrency bugs
sylvain.thenault@logilab.fr
parents:
1323
diff
changeset
|
351 |
|
996 | 352 |
pygments_directive.arguments = (1, 0, 1) |
353 |
pygments_directive.content = 1 |
|
354 |
||
355 |
||
0 | 356 |
class CubicWebReSTParser(Parser): |
357 |
"""The (customized) reStructuredText parser.""" |
|
358 |
||
359 |
def __init__(self): |
|
360 |
self.initial_state = 'Body' |
|
361 |
self.state_classes = states.state_classes |
|
362 |
self.inliner = states.Inliner() |
|
363 |
self.statemachine = states.RSTStateMachine( |
|
364 |
state_classes=self.state_classes, |
|
365 |
initial_state=self.initial_state, |
|
366 |
debug=0) |
|
367 |
||
368 |
def parse(self, inputstring, document): |
|
369 |
"""Parse `inputstring` and populate `document`, a document tree.""" |
|
370 |
self.setup_parse(inputstring, document) |
|
371 |
inputlines = statemachine.string2lines(inputstring, |
|
372 |
convert_whitespace=1) |
|
373 |
self.statemachine.run(inputlines, document, inliner=self.inliner) |
|
374 |
self.finish_parse() |
|
375 |
||
376 |
||
4771
e27d23f875c6
custom rest publisher instead of using rest_publish. Avoid to keep a ref on the latest context
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4769
diff
changeset
|
377 |
# XXX docutils keep a ref on context, can't find a correct way to remove it |
e27d23f875c6
custom rest publisher instead of using rest_publish. Avoid to keep a ref on the latest context
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4769
diff
changeset
|
378 |
class CWReSTPublisher(Publisher): |
e27d23f875c6
custom rest publisher instead of using rest_publish. Avoid to keep a ref on the latest context
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4769
diff
changeset
|
379 |
def __init__(self, context, settings, **kwargs): |
e27d23f875c6
custom rest publisher instead of using rest_publish. Avoid to keep a ref on the latest context
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4769
diff
changeset
|
380 |
Publisher.__init__(self, **kwargs) |
e27d23f875c6
custom rest publisher instead of using rest_publish. Avoid to keep a ref on the latest context
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4769
diff
changeset
|
381 |
self.set_components('standalone', 'restructuredtext', 'pseudoxml') |
e27d23f875c6
custom rest publisher instead of using rest_publish. Avoid to keep a ref on the latest context
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4769
diff
changeset
|
382 |
self.process_programmatic_settings(None, settings, None) |
e27d23f875c6
custom rest publisher instead of using rest_publish. Avoid to keep a ref on the latest context
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4769
diff
changeset
|
383 |
self.settings.context = context |
e27d23f875c6
custom rest publisher instead of using rest_publish. Avoid to keep a ref on the latest context
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4769
diff
changeset
|
384 |
|
e27d23f875c6
custom rest publisher instead of using rest_publish. Avoid to keep a ref on the latest context
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4769
diff
changeset
|
385 |
|
0 | 386 |
def rest_publish(context, data): |
387 |
"""publish a string formatted as ReStructured Text to HTML |
|
1447
a1ca676294f0
don't use a singleton rest parser which may leads to concurrency bugs
sylvain.thenault@logilab.fr
parents:
1323
diff
changeset
|
388 |
|
0 | 389 |
:type context: a cubicweb application object |
390 |
||
391 |
:type data: str |
|
392 |
:param data: some ReST text |
|
393 |
||
394 |
:rtype: unicode |
|
395 |
:return: |
|
6109
47d9c0e0f7b7
integrate Celso's work on translation file: proper/complete spanish translation, fixed some typos in french translation, occured -> occurred fix in various places
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
5424
diff
changeset
|
396 |
the data formatted as HTML or the original data if an error occurred |
0 | 397 |
""" |
3418
7b49fa7e942d
[api] use _cw, cw_row, cw_col, cw_rset etc.
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
2680
diff
changeset
|
398 |
req = context._cw |
0 | 399 |
if isinstance(data, unicode): |
400 |
encoding = 'unicode' |
|
2311
f178182b1305
actually close #344401 by removing unprintable characters
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1977
diff
changeset
|
401 |
# remove unprintable characters unauthorized in xml |
f178182b1305
actually close #344401 by removing unprintable characters
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1977
diff
changeset
|
402 |
data = data.translate(ESC_UCAR_TABLE) |
0 | 403 |
else: |
404 |
encoding = req.encoding |
|
2311
f178182b1305
actually close #344401 by removing unprintable characters
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1977
diff
changeset
|
405 |
# remove unprintable characters unauthorized in xml |
f178182b1305
actually close #344401 by removing unprintable characters
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
1977
diff
changeset
|
406 |
data = data.translate(ESC_CAR_TABLE) |
0 | 407 |
settings = {'input_encoding': encoding, 'output_encoding': 'unicode', |
4771
e27d23f875c6
custom rest publisher instead of using rest_publish. Avoid to keep a ref on the latest context
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4769
diff
changeset
|
408 |
'warning_stream': StringIO(), |
6275
20f30e01ae59
[ReST] settings update: add traceback=True to avoid sys.exit, and set stylesheet to None since we don't care about it and that may makes docutils stupidly fail according to the cwd at import time...
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6109
diff
changeset
|
409 |
'traceback': True, # don't sys.exit |
20f30e01ae59
[ReST] settings update: add traceback=True to avoid sys.exit, and set stylesheet to None since we don't care about it and that may makes docutils stupidly fail according to the cwd at import time...
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6109
diff
changeset
|
410 |
'stylesheet': None, # don't try to embed stylesheet (may cause |
20f30e01ae59
[ReST] settings update: add traceback=True to avoid sys.exit, and set stylesheet to None since we don't care about it and that may makes docutils stupidly fail according to the cwd at import time...
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6109
diff
changeset
|
411 |
# obscure bug due to docutils computing |
20f30e01ae59
[ReST] settings update: add traceback=True to avoid sys.exit, and set stylesheet to None since we don't care about it and that may makes docutils stupidly fail according to the cwd at import time...
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6109
diff
changeset
|
412 |
# relative path according to the directory |
20f30e01ae59
[ReST] settings update: add traceback=True to avoid sys.exit, and set stylesheet to None since we don't care about it and that may makes docutils stupidly fail according to the cwd at import time...
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6109
diff
changeset
|
413 |
# used *at import time* |
0 | 414 |
# dunno what's the max, severe is 4, and we never want a crash |
6275
20f30e01ae59
[ReST] settings update: add traceback=True to avoid sys.exit, and set stylesheet to None since we don't care about it and that may makes docutils stupidly fail according to the cwd at import time...
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6109
diff
changeset
|
415 |
# (though try/except may be a better option...). May be the |
20f30e01ae59
[ReST] settings update: add traceback=True to avoid sys.exit, and set stylesheet to None since we don't care about it and that may makes docutils stupidly fail according to the cwd at import time...
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
6109
diff
changeset
|
416 |
# above traceback option will avoid this? |
1447
a1ca676294f0
don't use a singleton rest parser which may leads to concurrency bugs
sylvain.thenault@logilab.fr
parents:
1323
diff
changeset
|
417 |
'halt_level': 10, |
0 | 418 |
} |
419 |
if context: |
|
420 |
if hasattr(req, 'url'): |
|
421 |
base_url = req.url() |
|
422 |
elif hasattr(context, 'absolute_url'): |
|
423 |
base_url = context.absolute_url() |
|
424 |
else: |
|
425 |
base_url = req.base_url() |
|
426 |
else: |
|
427 |
base_url = None |
|
428 |
try: |
|
4771
e27d23f875c6
custom rest publisher instead of using rest_publish. Avoid to keep a ref on the latest context
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4769
diff
changeset
|
429 |
pub = CWReSTPublisher(context, settings, |
e27d23f875c6
custom rest publisher instead of using rest_publish. Avoid to keep a ref on the latest context
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4769
diff
changeset
|
430 |
parser=CubicWebReSTParser(), |
e27d23f875c6
custom rest publisher instead of using rest_publish. Avoid to keep a ref on the latest context
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4769
diff
changeset
|
431 |
writer=Writer(base_url=base_url), |
e27d23f875c6
custom rest publisher instead of using rest_publish. Avoid to keep a ref on the latest context
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4769
diff
changeset
|
432 |
source_class=io.StringInput, |
e27d23f875c6
custom rest publisher instead of using rest_publish. Avoid to keep a ref on the latest context
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4769
diff
changeset
|
433 |
destination_class=io.StringOutput) |
e27d23f875c6
custom rest publisher instead of using rest_publish. Avoid to keep a ref on the latest context
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4769
diff
changeset
|
434 |
pub.set_source(data) |
e27d23f875c6
custom rest publisher instead of using rest_publish. Avoid to keep a ref on the latest context
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4769
diff
changeset
|
435 |
pub.set_destination() |
e27d23f875c6
custom rest publisher instead of using rest_publish. Avoid to keep a ref on the latest context
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4769
diff
changeset
|
436 |
res = pub.publish(enable_exit_status=None) |
e27d23f875c6
custom rest publisher instead of using rest_publish. Avoid to keep a ref on the latest context
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4769
diff
changeset
|
437 |
# necessary for proper garbage collection, else a ref is kept somewhere in docutils... |
e27d23f875c6
custom rest publisher instead of using rest_publish. Avoid to keep a ref on the latest context
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4769
diff
changeset
|
438 |
del pub.settings.context |
e27d23f875c6
custom rest publisher instead of using rest_publish. Avoid to keep a ref on the latest context
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
4769
diff
changeset
|
439 |
return res |
9592
6fd2651719bc
[ext/rest] Catch SystemExit raised by docutils
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
9517
diff
changeset
|
440 |
except BaseException: |
0 | 441 |
LOGGER.exception('error while publishing ReST text') |
442 |
if not isinstance(data, unicode): |
|
443 |
data = unicode(data, encoding, 'replace') |
|
2312
af4d8f75c5db
use xml_escape
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2311
diff
changeset
|
444 |
return xml_escape(req._('error while publishing ReST text') |
0 | 445 |
+ '\n\n' + data) |
4118
8a9a00a9405c
quick and dirty fix trying to avoid rest directive conflicts when using sphinx (which seems to import the code)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2680
diff
changeset
|
446 |
|
8a9a00a9405c
quick and dirty fix trying to avoid rest directive conflicts when using sphinx (which seems to import the code)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2680
diff
changeset
|
447 |
|
8a9a00a9405c
quick and dirty fix trying to avoid rest directive conflicts when using sphinx (which seems to import the code)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2680
diff
changeset
|
448 |
_INITIALIZED = False |
8a9a00a9405c
quick and dirty fix trying to avoid rest directive conflicts when using sphinx (which seems to import the code)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2680
diff
changeset
|
449 |
def cw_rest_init(): |
8a9a00a9405c
quick and dirty fix trying to avoid rest directive conflicts when using sphinx (which seems to import the code)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2680
diff
changeset
|
450 |
global _INITIALIZED |
8a9a00a9405c
quick and dirty fix trying to avoid rest directive conflicts when using sphinx (which seems to import the code)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2680
diff
changeset
|
451 |
if _INITIALIZED: |
8a9a00a9405c
quick and dirty fix trying to avoid rest directive conflicts when using sphinx (which seems to import the code)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2680
diff
changeset
|
452 |
return |
8a9a00a9405c
quick and dirty fix trying to avoid rest directive conflicts when using sphinx (which seems to import the code)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2680
diff
changeset
|
453 |
_INITIALIZED = True |
8a9a00a9405c
quick and dirty fix trying to avoid rest directive conflicts when using sphinx (which seems to import the code)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2680
diff
changeset
|
454 |
register_canonical_role('eid', eid_reference_role) |
6938
6c1a960735f5
add a rql directive to restructuredtext
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
6275
diff
changeset
|
455 |
register_canonical_role('rql', rql_role) |
8852
59a29405688c
[ext/rest] add directive bookmark to rest (closes #2545595)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents:
8711
diff
changeset
|
456 |
register_canonical_role('bookmark', bookmark_role) |
4118
8a9a00a9405c
quick and dirty fix trying to avoid rest directive conflicts when using sphinx (which seems to import the code)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2680
diff
changeset
|
457 |
directives.register_directive('winclude', winclude_directive) |
8a9a00a9405c
quick and dirty fix trying to avoid rest directive conflicts when using sphinx (which seems to import the code)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2680
diff
changeset
|
458 |
if pygments_directive is not None: |
8a9a00a9405c
quick and dirty fix trying to avoid rest directive conflicts when using sphinx (which seems to import the code)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents:
2680
diff
changeset
|
459 |
directives.register_directive('sourcecode', pygments_directive) |
9322
2dae5bf5ea68
[ReST] Implement a rql-table reST directive. Closes #3252856
Denis Laxalde <denis.laxalde@logilab.fr>
parents:
8852
diff
changeset
|
460 |
directives.register_directive('rql-table', RQLTableDirective) |