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
|
# Copyright 2015 gRPC authors.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
cdef class Server:
def __cinit__(self, object arguments, bint xds):
fork_handlers_and_grpc_init()
self.references = []
self.registered_completion_queues = []
self.is_started = False
self.is_shutting_down = False
self.is_shutdown = False
self.c_server = NULL
cdef _ChannelArgs channel_args = _ChannelArgs(arguments)
self.c_server = grpc_server_create(channel_args.c_args(), NULL)
cdef grpc_server_xds_status_notifier notifier
notifier.on_serving_status_update = NULL
notifier.user_data = NULL
if xds:
grpc_server_set_config_fetcher(self.c_server,
grpc_server_config_fetcher_xds_create(notifier, channel_args.c_args()))
self.references.append(arguments)
def request_call(
self, CompletionQueue call_queue not None,
CompletionQueue server_queue not None, tag):
if not self.is_started or self.is_shutting_down:
raise ValueError("server must be started and not shutting down")
if server_queue not in self.registered_completion_queues:
raise ValueError("server_queue must be a registered completion queue")
cdef _RequestCallTag request_call_tag = _RequestCallTag(tag)
request_call_tag.prepare()
cpython.Py_INCREF(request_call_tag)
return grpc_server_request_call(
self.c_server, &request_call_tag.call.c_call,
&request_call_tag.call_details.c_details,
&request_call_tag.c_invocation_metadata,
call_queue.c_completion_queue, server_queue.c_completion_queue,
<cpython.PyObject *>request_call_tag)
def register_completion_queue(
self, CompletionQueue queue not None):
if self.is_started:
raise ValueError("cannot register completion queues after start")
with nogil:
grpc_server_register_completion_queue(
self.c_server, queue.c_completion_queue, NULL)
self.registered_completion_queues.append(queue)
def start(self, backup_queue=True):
"""Start the Cython gRPC Server.
Args:
backup_queue: a bool indicates whether to spawn a backup completion
queue. In the case that no CQ is bound to the server, and the shutdown
of server becomes un-observable.
"""
if self.is_started:
raise ValueError("the server has already started")
if backup_queue:
self.backup_shutdown_queue = CompletionQueue(shutdown_cq=True)
self.register_completion_queue(self.backup_shutdown_queue)
self.is_started = True
with nogil:
grpc_server_start(self.c_server)
if backup_queue:
# Ensure the core has gotten a chance to do the start-up work
self.backup_shutdown_queue.poll(deadline=time.time())
def add_http2_port(self, bytes address,
ServerCredentials server_credentials=None):
address = str_to_bytes(address)
self.references.append(address)
cdef int result
cdef char *address_c_string = address
if server_credentials is not None:
self.references.append(server_credentials)
with nogil:
result = grpc_server_add_http2_port(
self.c_server, address_c_string, server_credentials.c_credentials)
else:
with nogil:
creds = grpc_insecure_server_credentials_create()
result = grpc_server_add_http2_port(self.c_server,
address_c_string, creds)
grpc_server_credentials_release(creds)
return result
cdef _c_shutdown(self, CompletionQueue queue, tag):
self.is_shutting_down = True
cdef _ServerShutdownTag server_shutdown_tag = _ServerShutdownTag(tag, self)
cpython.Py_INCREF(server_shutdown_tag)
with nogil:
grpc_server_shutdown_and_notify(
self.c_server, queue.c_completion_queue,
<cpython.PyObject *>server_shutdown_tag)
def shutdown(self, CompletionQueue queue not None, tag):
if queue.is_shutting_down:
raise ValueError("queue must be live")
elif not self.is_started:
raise ValueError("the server hasn't started yet")
elif self.is_shutting_down:
return
elif queue not in self.registered_completion_queues:
raise ValueError("expected registered completion queue")
else:
self._c_shutdown(queue, tag)
cdef notify_shutdown_complete(self):
# called only after our server shutdown tag has emerged from a completion
# queue.
self.is_shutdown = True
def cancel_all_calls(self):
if not self.is_shutting_down:
raise UsageError("the server must be shutting down to cancel all calls")
elif self.is_shutdown:
return
else:
with nogil:
grpc_server_cancel_all_calls(self.c_server)
# TODO(https://github.com/grpc/grpc/issues/17515) Determine what, if any,
# portion of this is safe to call from __dealloc__, and potentially remove
# backup_shutdown_queue.
def destroy(self):
if self.c_server != NULL:
if not self.is_started:
pass
elif self.is_shutdown:
pass
elif not self.is_shutting_down:
if self.backup_shutdown_queue is None:
raise InternalError('Server shutdown failed: no completion queue.')
else:
# the user didn't call shutdown - use our backup queue
self._c_shutdown(self.backup_shutdown_queue, None)
# and now we wait
while not self.is_shutdown:
self.backup_shutdown_queue.poll()
else:
# We're in the process of shutting down, but have not shutdown; can't do
# much but repeatedly release the GIL and wait
while not self.is_shutdown:
time.sleep(0)
with nogil:
grpc_server_destroy(self.c_server)
self.c_server = NULL
def __dealloc__(self):
if self.c_server == NULL:
grpc_shutdown()
|
