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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
|
"""
Rhizi REST web API:
- make use of rz_kernel for core logic execution
- make use of rz_api_common for common API logic
"""
from flask import request
from flask import session
from flask import current_app
import flask
import logging
import traceback
from model.graph import Attr_Diff
from model.graph import Topo_Diff
from rz_api_common import sanitize_input__attr_diff, cache_lookup__rzdoc, \
__sanitize_input, sanitize_input__rzdoc_name
from rz_api_common import sanitize_input__topo_diff
from rz_api_common import validate_obj__attr_diff
from rz_req_handling import common_resp_handle__success, make_response__json, \
HTTP_STATUS__204_NO_CONTENT, HTTP_STATUS__201_CREATED, \
common_resp_handle__client_error, common_resp_handle__server_error, \
common_rest_req_exception_handler
from db_op import DBO_match_node_set_by_id_attribute, \
DBO_load_link_set, DBO_match_node_id_set, DBO_diff_commit__topo
from model.model import Link
log = logging.getLogger('rhizi')
db_ctl = None # injected: DB controller
class Req_Context():
"""
Request context:
- user_name
- rzdoc
"""
def __init__(self, user_name=None, rzdoc=None):
self.user_name = user_name
self.rzdoc = rzdoc
def __context__common(rzdoc_name=None):
"""
Common request context builder passed along with kernel calls:
- set user_name
- set rzdoc if rzdoc_name argument was supplied
@raise RZDoc_Exception__not_found: if rzdoc_name arg was passed and document was not found
"""
ret = Req_Context()
if session.has_key('username'):
ret.user_name = session['username']
if None != rzdoc_name:
s_rzdoc_name = sanitize_input__rzdoc_name(rzdoc_name)
ret.rzdoc = cache_lookup__rzdoc(s_rzdoc_name)
return ret
def __load_node_set_by_id_attr_common(id_set):
"""
@param f_k: optional attribute filter key
@param f_vset: possible key values to match against
"""
op = DBO_match_node_set_by_id_attribute(id_set=id_set)
try:
n_set = db_ctl.exec_op(op)
return common_resp_handle__success(data=n_set)
except Exception as e:
log.exception(e)
return common_resp_handle__client_error(error='unable to load node with ids: {0}'.format(id_set))
def diff_commit__set():
"""
commit a diff set
"""
def sanitize_input(req):
diff_set_dict = req.get_json()['diff_set']
topo_diff_dict = diff_set_dict['__diff_set_topo'][0]
topo_diff = Topo_Diff.from_json_dict(topo_diff_dict)
sanitize_input__topo_diff(topo_diff)
return topo_diff;
topo_diff = sanitize_input(request)
op = DBO_diff_commit__topo(topo_diff)
assert False
def load_link_set_by_link_ptr_set():
def deserialize_param_set(param_json):
l_ptr_set_raw = param_json['link_ptr_set']
__sanitize_input(l_ptr_set_raw)
l_ptr_set = []
for lptr_dict in l_ptr_set_raw:
src_id = lptr_dict.get('__src_id')
dst_id = lptr_dict.get('__dst_id')
l_ptr_set += [Link.Link_Ptr(src_id=src_id, dst_id=dst_id) ]
return l_ptr_set
l_ptr_set = deserialize_param_set(request.get_json())
op = DBO_load_link_set.init_from_link_ptr_set(l_ptr_set)
assert False
def load_node_set_by_id_attr():
"""
load node-set by ID attribute
@param id_set: list of node ids to match id attribute against
@return: a list of nodes whose id attribute matches 'id' or
an empty list if the requested node is not found
@raise exception: on error
"""
req_json = request.get_json()
id_set = req_json['id_set']
__sanitize_input(id_set)
return __load_node_set_by_id_attr_common(id_set)
def match_node_set_by_attr_filter_map(attr_filter_map):
"""
@param attr_filter_map
@return: a set of node DB id's
"""
op = DBO_match_node_id_set(attr_filter_map)
assert False
@common_rest_req_exception_handler
def diff_commit__topo():
"""
REST API wrapper around diff_commit__topo():
- extract topo_diff from request
- handle success/error outcomes
"""
def sanitize_input(req):
rzdoc_name = request.get_json().get('rzdoc_name')
topo_diff_dict = request.get_json()['topo_diff']
topo_diff = Topo_Diff.from_json_dict(topo_diff_dict)
sanitize_input__topo_diff(topo_diff)
return rzdoc_name, topo_diff
rzdoc_name, topo_diff = sanitize_input(request)
ctx = __context__common(rzdoc_name)
kernel = flask.current_app.kernel
_, commit_ret = kernel.diff_commit__topo(topo_diff, ctx)
return common_resp_handle__success(data=commit_ret)
@common_rest_req_exception_handler
def diff_commit__attr():
"""
commit a graph attribute diff
"""
def sanitize_input(req):
rzdoc_name = request.get_json().get('rzdoc_name')
attr_diff_dict = request.get_json()['attr_diff']
attr_diff = Attr_Diff.from_json_dict(attr_diff_dict)
sanitize_input__attr_diff(attr_diff)
return rzdoc_name, attr_diff;
rzdoc_name, attr_diff = sanitize_input(request)
validate_obj__attr_diff(attr_diff)
ctx = __context__common(rzdoc_name)
kernel = flask.current_app.kernel
_, commit_ret = kernel.diff_commit__attr(attr_diff, ctx)
return common_resp_handle__success(data=commit_ret)
def diff_commit__vis():
pass
@common_rest_req_exception_handler
def rzdoc_clone():
def sanitize_input(req):
rzdoc_name = req.get_json().get('rzdoc_name')
return rzdoc_name
rzdoc_name = sanitize_input(request)
if None == rzdoc_name: # load welcome doc by default
rzdoc_name = current_app.rz_config.rzdoc__mainpage_name
kernel = flask.current_app.kernel
ctx = __context__common(rzdoc_name)
topo_diff = kernel.rzdoc__clone(ctx.rzdoc, ctx)
topo_diff_json = topo_diff.to_json_dict() # serialize Topo_Diff before including in response
return common_resp_handle__success(data=topo_diff_json)
@common_rest_req_exception_handler
def rzdoc__create(rzdoc_name):
"""
create RZ doc
"""
s_rzdoc_name = sanitize_input__rzdoc_name(rzdoc_name)
kernel = flask.current_app.kernel
ctx = __context__common(rzdoc_name=None) # avoid rzdoc cache lookup exception
kernel.rzdoc__create(s_rzdoc_name, ctx)
return make_response__json(status=HTTP_STATUS__201_CREATED)
@common_rest_req_exception_handler
def rzdoc__delete(rzdoc_name):
kernel = flask.current_app.kernel
ctx = __context__common(rzdoc_name)
kernel.rzdoc__delete(ctx.rzdoc, ctx)
return make_response__json(status=HTTP_STATUS__204_NO_CONTENT)
@common_rest_req_exception_handler
def rzdoc__list():
kernel = flask.current_app.kernel
ctx = __context__common(rzdoc_name=None) # avoid rzdoc cache lookup exception
rzdoc_set = kernel.rzdoc__list(ctx.rzdoc, ctx)
ret = [rzdoc_dict['name'] for rzdoc_dict in rzdoc_set]
return common_resp_handle__success(data=ret)
|
