Masood Malekghassemi | f8e297a | 2015-02-19 15:39:32 -0800 | [diff] [blame] | 1 | /* |
| 2 | * |
Craig Tiller | 6169d5f | 2016-03-31 07:46:18 -0700 | [diff] [blame] | 3 | * Copyright 2015, Google Inc. |
Masood Malekghassemi | f8e297a | 2015-02-19 15:39:32 -0800 | [diff] [blame] | 4 | * All rights reserved. |
| 5 | * |
| 6 | * Redistribution and use in source and binary forms, with or without |
| 7 | * modification, are permitted provided that the following conditions are |
| 8 | * met: |
| 9 | * |
| 10 | * * Redistributions of source code must retain the above copyright |
| 11 | * notice, this list of conditions and the following disclaimer. |
| 12 | * * Redistributions in binary form must reproduce the above |
| 13 | * copyright notice, this list of conditions and the following disclaimer |
| 14 | * in the documentation and/or other materials provided with the |
| 15 | * distribution. |
| 16 | * * Neither the name of Google Inc. nor the names of its |
| 17 | * contributors may be used to endorse or promote products derived from |
| 18 | * this software without specific prior written permission. |
| 19 | * |
| 20 | * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
| 21 | * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
| 22 | * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR |
| 23 | * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT |
| 24 | * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, |
| 25 | * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT |
| 26 | * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, |
| 27 | * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY |
| 28 | * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
| 29 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
| 30 | * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| 31 | * |
| 32 | */ |
| 33 | |
Masood Malekghassemi | 40e8cbd | 2015-02-26 08:39:50 -0800 | [diff] [blame] | 34 | #include <algorithm> |
Masood Malekghassemi | f8e297a | 2015-02-19 15:39:32 -0800 | [diff] [blame] | 35 | #include <cassert> |
| 36 | #include <cctype> |
Masood Malekghassemi | 59d9ff4 | 2015-02-23 15:28:07 -0800 | [diff] [blame] | 37 | #include <cstring> |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 38 | #include <fstream> |
| 39 | #include <iostream> |
Masood Malekghassemi | f8e297a | 2015-02-19 15:39:32 -0800 | [diff] [blame] | 40 | #include <map> |
Masood Malekghassemi | 3bb5215 | 2015-03-17 21:52:52 -0700 | [diff] [blame] | 41 | #include <memory> |
Masood Malekghassemi | f8e297a | 2015-02-19 15:39:32 -0800 | [diff] [blame] | 42 | #include <ostream> |
| 43 | #include <sstream> |
Masood Malekghassemi | 3bb5215 | 2015-03-17 21:52:52 -0700 | [diff] [blame] | 44 | #include <tuple> |
Masood Malekghassemi | 59d9ff4 | 2015-02-23 15:28:07 -0800 | [diff] [blame] | 45 | #include <vector> |
Masood Malekghassemi | f8e297a | 2015-02-19 15:39:32 -0800 | [diff] [blame] | 46 | |
Masood Malekghassemi | 65c803b | 2015-03-20 06:48:47 -0700 | [diff] [blame] | 47 | #include "src/compiler/config.h" |
Nicolas "Pixel" Noble | 93fa098 | 2015-02-27 21:50:58 +0100 | [diff] [blame] | 48 | #include "src/compiler/generator_helpers.h" |
Masood Malekghassemi | f8e297a | 2015-02-19 15:39:32 -0800 | [diff] [blame] | 49 | #include "src/compiler/python_generator.h" |
Masood Malekghassemi | f8e297a | 2015-02-19 15:39:32 -0800 | [diff] [blame] | 50 | |
Nicolas "Pixel" Noble | 93fa098 | 2015-02-27 21:50:58 +0100 | [diff] [blame] | 51 | using grpc_generator::StringReplace; |
| 52 | using grpc_generator::StripProto; |
Masood Malekghassemi | 65c803b | 2015-03-20 06:48:47 -0700 | [diff] [blame] | 53 | using grpc::protobuf::Descriptor; |
| 54 | using grpc::protobuf::FileDescriptor; |
| 55 | using grpc::protobuf::MethodDescriptor; |
| 56 | using grpc::protobuf::ServiceDescriptor; |
| 57 | using grpc::protobuf::compiler::GeneratorContext; |
| 58 | using grpc::protobuf::io::CodedOutputStream; |
| 59 | using grpc::protobuf::io::Printer; |
| 60 | using grpc::protobuf::io::StringOutputStream; |
| 61 | using grpc::protobuf::io::ZeroCopyOutputStream; |
Masood Malekghassemi | f8e297a | 2015-02-19 15:39:32 -0800 | [diff] [blame] | 62 | using std::initializer_list; |
Masood Malekghassemi | 59d9ff4 | 2015-02-23 15:28:07 -0800 | [diff] [blame] | 63 | using std::make_pair; |
Masood Malekghassemi | f8e297a | 2015-02-19 15:39:32 -0800 | [diff] [blame] | 64 | using std::map; |
Masood Malekghassemi | 59d9ff4 | 2015-02-23 15:28:07 -0800 | [diff] [blame] | 65 | using std::pair; |
Masood Malekghassemi | 40e8cbd | 2015-02-26 08:39:50 -0800 | [diff] [blame] | 66 | using std::replace; |
Masood Malekghassemi | 59d9ff4 | 2015-02-23 15:28:07 -0800 | [diff] [blame] | 67 | using std::vector; |
Masood Malekghassemi | f8e297a | 2015-02-19 15:39:32 -0800 | [diff] [blame] | 68 | |
| 69 | namespace grpc_python_generator { |
Masood Malekghassemi | 3bb5215 | 2015-03-17 21:52:52 -0700 | [diff] [blame] | 70 | |
Masood Malekghassemi | f8e297a | 2015-02-19 15:39:32 -0800 | [diff] [blame] | 71 | namespace { |
Masood Malekghassemi | f8e297a | 2015-02-19 15:39:32 -0800 | [diff] [blame] | 72 | |
Masood Malekghassemi | 4a051cc | 2016-10-20 14:50:49 -0700 | [diff] [blame] | 73 | typedef vector<const Descriptor*> DescriptorVector; |
| 74 | typedef map<grpc::string, grpc::string> StringMap; |
| 75 | typedef vector<grpc::string> StringVector; |
| 76 | |
Masood Malekghassemi | f8e297a | 2015-02-19 15:39:32 -0800 | [diff] [blame] | 77 | // Provides RAII indentation handling. Use as: |
| 78 | // { |
| 79 | // IndentScope raii_my_indent_var_name_here(my_py_printer); |
| 80 | // // constructor indented my_py_printer |
| 81 | // ... |
| 82 | // // destructor called at end of scope, un-indenting my_py_printer |
| 83 | // } |
| 84 | class IndentScope { |
| 85 | public: |
| 86 | explicit IndentScope(Printer* printer) : printer_(printer) { |
| 87 | printer_->Indent(); |
| 88 | } |
| 89 | |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 90 | ~IndentScope() { printer_->Outdent(); } |
Masood Malekghassemi | f8e297a | 2015-02-19 15:39:32 -0800 | [diff] [blame] | 91 | |
| 92 | private: |
| 93 | Printer* printer_; |
| 94 | }; |
| 95 | |
Ken Payson | be187b0 | 2016-05-06 15:32:58 -0700 | [diff] [blame] | 96 | // TODO(https://github.com/google/protobuf/issues/888): |
| 97 | // Export `ModuleName` from protobuf's |
Masood Malekghassemi | 40e8cbd | 2015-02-26 08:39:50 -0800 | [diff] [blame] | 98 | // `src/google/protobuf/compiler/python/python_generator.cc` file. |
Masood Malekghassemi | 65c803b | 2015-03-20 06:48:47 -0700 | [diff] [blame] | 99 | grpc::string ModuleName(const grpc::string& filename) { |
| 100 | grpc::string basename = StripProto(filename); |
Nicolas "Pixel" Noble | 93fa098 | 2015-02-27 21:50:58 +0100 | [diff] [blame] | 101 | basename = StringReplace(basename, "-", "_"); |
| 102 | basename = StringReplace(basename, "/", "."); |
Masood Malekghassemi | 40e8cbd | 2015-02-26 08:39:50 -0800 | [diff] [blame] | 103 | return basename + "_pb2"; |
| 104 | } |
| 105 | |
Ken Payson | be187b0 | 2016-05-06 15:32:58 -0700 | [diff] [blame] | 106 | // TODO(https://github.com/google/protobuf/issues/888): |
| 107 | // Export `ModuleAlias` from protobuf's |
| 108 | // `src/google/protobuf/compiler/python/python_generator.cc` file. |
| 109 | grpc::string ModuleAlias(const grpc::string& filename) { |
| 110 | grpc::string module_name = ModuleName(filename); |
| 111 | // We can't have dots in the module name, so we replace each with _dot_. |
| 112 | // But that could lead to a collision between a.b and a_dot_b, so we also |
| 113 | // duplicate each underscore. |
| 114 | module_name = StringReplace(module_name, "_", "__"); |
| 115 | module_name = StringReplace(module_name, ".", "_dot_"); |
| 116 | return module_name; |
| 117 | } |
| 118 | |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 119 | // Tucks all generator state in an anonymous namespace away from |
| 120 | // PythonGrpcGenerator and the header file, mostly to encourage future changes |
| 121 | // to not require updates to the grpcio-tools C++ code part. Assumes that it is |
| 122 | // only ever used from a single thread. |
| 123 | struct PrivateGenerator { |
| 124 | const GeneratorConfiguration& config; |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 125 | const FileDescriptor* file; |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 126 | |
| 127 | bool generate_in_pb2_grpc; |
| 128 | |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 129 | Printer* out; |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 130 | |
| 131 | PrivateGenerator(const GeneratorConfiguration& config, |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 132 | const FileDescriptor* file); |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 133 | |
| 134 | std::pair<bool, grpc::string> GetGrpcServices(); |
| 135 | |
| 136 | private: |
| 137 | bool PrintPreamble(); |
| 138 | bool PrintBetaPreamble(); |
| 139 | bool PrintGAServices(); |
| 140 | bool PrintBetaServices(); |
| 141 | |
| 142 | bool PrintAddServicerToServer( |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 143 | const grpc::string& package_qualified_service_name, |
| 144 | const ServiceDescriptor* service); |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 145 | bool PrintServicer(const ServiceDescriptor* service); |
| 146 | bool PrintStub(const grpc::string& package_qualified_service_name, |
| 147 | const ServiceDescriptor* service); |
| 148 | |
| 149 | bool PrintBetaServicer(const ServiceDescriptor* service); |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 150 | bool PrintBetaServerFactory( |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 151 | const grpc::string& package_qualified_service_name, |
| 152 | const ServiceDescriptor* service); |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 153 | bool PrintBetaStub(const ServiceDescriptor* service); |
| 154 | bool PrintBetaStubFactory(const grpc::string& package_qualified_service_name, |
| 155 | const ServiceDescriptor* service); |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 156 | |
| 157 | // Get all comments (leading, leading_detached, trailing) and print them as a |
| 158 | // docstring. Any leading space of a line will be removed, but the line |
| 159 | // wrapping will not be changed. |
| 160 | template <typename DescriptorType> |
| 161 | void PrintAllComments(const DescriptorType* descriptor); |
| 162 | |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 163 | bool GetModuleAndMessagePath(const Descriptor* type, grpc::string* out); |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 164 | }; |
| 165 | |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 166 | PrivateGenerator::PrivateGenerator(const GeneratorConfiguration& config, |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 167 | const FileDescriptor* file) |
| 168 | : config(config), file(file) {} |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 169 | |
| 170 | bool PrivateGenerator::GetModuleAndMessagePath(const Descriptor* type, |
| 171 | grpc::string* out) { |
Masood Malekghassemi | 59d9ff4 | 2015-02-23 15:28:07 -0800 | [diff] [blame] | 172 | const Descriptor* path_elem_type = type; |
Masood Malekghassemi | 4a051cc | 2016-10-20 14:50:49 -0700 | [diff] [blame] | 173 | DescriptorVector message_path; |
Masood Malekghassemi | 59d9ff4 | 2015-02-23 15:28:07 -0800 | [diff] [blame] | 174 | do { |
| 175 | message_path.push_back(path_elem_type); |
| 176 | path_elem_type = path_elem_type->containing_type(); |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 177 | } while (path_elem_type); // implicit nullptr comparison; don't be explicit |
Masood Malekghassemi | 65c803b | 2015-03-20 06:48:47 -0700 | [diff] [blame] | 178 | grpc::string file_name = type->file()->name(); |
Masood Malekghassemi | 59d9ff4 | 2015-02-23 15:28:07 -0800 | [diff] [blame] | 179 | static const int proto_suffix_length = strlen(".proto"); |
| 180 | if (!(file_name.size() > static_cast<size_t>(proto_suffix_length) && |
| 181 | file_name.find_last_of(".proto") == file_name.size() - 1)) { |
| 182 | return false; |
Masood Malekghassemi | f8e297a | 2015-02-19 15:39:32 -0800 | [diff] [blame] | 183 | } |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 184 | grpc::string generator_file_name = file->name(); |
| 185 | grpc::string module; |
| 186 | if (generator_file_name != file_name || generate_in_pb2_grpc) { |
| 187 | module = ModuleAlias(file_name) + "."; |
| 188 | } else { |
| 189 | module = ""; |
| 190 | } |
Masood Malekghassemi | 65c803b | 2015-03-20 06:48:47 -0700 | [diff] [blame] | 191 | grpc::string message_type; |
Masood Malekghassemi | 4a051cc | 2016-10-20 14:50:49 -0700 | [diff] [blame] | 192 | for (DescriptorVector::reverse_iterator path_iter = message_path.rbegin(); |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 193 | path_iter != message_path.rend(); ++path_iter) { |
Masood Malekghassemi | 59d9ff4 | 2015-02-23 15:28:07 -0800 | [diff] [blame] | 194 | message_type += (*path_iter)->name() + "."; |
| 195 | } |
Craig Tiller | cf133f4 | 2015-02-26 14:05:56 -0800 | [diff] [blame] | 196 | // no pop_back prior to C++11 |
| 197 | message_type.resize(message_type.size() - 1); |
Ken Payson | be187b0 | 2016-05-06 15:32:58 -0700 | [diff] [blame] | 198 | *out = module + message_type; |
Masood Malekghassemi | 59d9ff4 | 2015-02-23 15:28:07 -0800 | [diff] [blame] | 199 | return true; |
Masood Malekghassemi | f8e297a | 2015-02-19 15:39:32 -0800 | [diff] [blame] | 200 | } |
| 201 | |
yang-g | b0de716 | 2016-05-03 15:48:19 -0700 | [diff] [blame] | 202 | template <typename DescriptorType> |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 203 | void PrivateGenerator::PrintAllComments(const DescriptorType* descriptor) { |
Masood Malekghassemi | 4a051cc | 2016-10-20 14:50:49 -0700 | [diff] [blame] | 204 | StringVector comments; |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 205 | grpc_generator::GetComment( |
| 206 | descriptor, grpc_generator::COMMENTTYPE_LEADING_DETACHED, &comments); |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 207 | grpc_generator::GetComment(descriptor, grpc_generator::COMMENTTYPE_LEADING, |
yang-g | b0de716 | 2016-05-03 15:48:19 -0700 | [diff] [blame] | 208 | &comments); |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 209 | grpc_generator::GetComment(descriptor, grpc_generator::COMMENTTYPE_TRAILING, |
yang-g | b0de716 | 2016-05-03 15:48:19 -0700 | [diff] [blame] | 210 | &comments); |
| 211 | if (comments.empty()) { |
| 212 | return; |
| 213 | } |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 214 | out->Print("\"\"\""); |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 215 | for (StringVector::iterator it = comments.begin(); it != comments.end(); |
| 216 | ++it) { |
yang-g | b0de716 | 2016-05-03 15:48:19 -0700 | [diff] [blame] | 217 | size_t start_pos = it->find_first_not_of(' '); |
| 218 | if (start_pos != grpc::string::npos) { |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 219 | out->Print(it->c_str() + start_pos); |
yang-g | b0de716 | 2016-05-03 15:48:19 -0700 | [diff] [blame] | 220 | } |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 221 | out->Print("\n"); |
yang-g | b0de716 | 2016-05-03 15:48:19 -0700 | [diff] [blame] | 222 | } |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 223 | out->Print("\"\"\"\n"); |
yang-g | b0de716 | 2016-05-03 15:48:19 -0700 | [diff] [blame] | 224 | } |
| 225 | |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 226 | bool PrivateGenerator::PrintBetaServicer(const ServiceDescriptor* service) { |
Ken Payson | be187b0 | 2016-05-06 15:32:58 -0700 | [diff] [blame] | 227 | out->Print("\n\n"); |
yang-g | b0de716 | 2016-05-03 15:48:19 -0700 | [diff] [blame] | 228 | out->Print("class Beta$Service$Servicer(object):\n", "Service", |
| 229 | service->name()); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 230 | { |
| 231 | IndentScope raii_class_indent(out); |
Nicolas "Pixel" Noble | beeeddd | 2016-09-29 20:27:23 +0200 | [diff] [blame] | 232 | out->Print( |
| 233 | "\"\"\"The Beta API is deprecated for 0.15.0 and later.\n" |
| 234 | "\nIt is recommended to use the GA API (classes and functions in this\n" |
| 235 | "file not marked beta) for all further purposes. This class was " |
| 236 | "generated\n" |
| 237 | "only to ease transition from grpcio<0.15.0 to " |
| 238 | "grpcio>=0.15.0.\"\"\"\n"); |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 239 | PrintAllComments(service); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 240 | for (int i = 0; i < service->method_count(); ++i) { |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 241 | const MethodDescriptor* method = service->method(i); |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 242 | grpc::string arg_name = |
Masood Malekghassemi | 4a051cc | 2016-10-20 14:50:49 -0700 | [diff] [blame] | 243 | method->client_streaming() ? "request_iterator" : "request"; |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 244 | out->Print("def $Method$(self, $ArgName$, context):\n", "Method", |
Masood Malekghassemi | 4a051cc | 2016-10-20 14:50:49 -0700 | [diff] [blame] | 245 | method->name(), "ArgName", arg_name); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 246 | { |
| 247 | IndentScope raii_method_indent(out); |
Masood Malekghassemi | 4a051cc | 2016-10-20 14:50:49 -0700 | [diff] [blame] | 248 | PrintAllComments(method); |
Masood Malekghassemi | 832ae81 | 2016-04-27 18:38:54 -0700 | [diff] [blame] | 249 | out->Print("context.code(beta_interfaces.StatusCode.UNIMPLEMENTED)\n"); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 250 | } |
| 251 | } |
| 252 | } |
| 253 | return true; |
| 254 | } |
| 255 | |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 256 | bool PrivateGenerator::PrintBetaStub(const ServiceDescriptor* service) { |
Ken Payson | be187b0 | 2016-05-06 15:32:58 -0700 | [diff] [blame] | 257 | out->Print("\n\n"); |
yang-g | b0de716 | 2016-05-03 15:48:19 -0700 | [diff] [blame] | 258 | out->Print("class Beta$Service$Stub(object):\n", "Service", service->name()); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 259 | { |
| 260 | IndentScope raii_class_indent(out); |
Nicolas "Pixel" Noble | beeeddd | 2016-09-29 20:27:23 +0200 | [diff] [blame] | 261 | out->Print( |
| 262 | "\"\"\"The Beta API is deprecated for 0.15.0 and later.\n" |
| 263 | "\nIt is recommended to use the GA API (classes and functions in this\n" |
| 264 | "file not marked beta) for all further purposes. This class was " |
| 265 | "generated\n" |
| 266 | "only to ease transition from grpcio<0.15.0 to " |
| 267 | "grpcio>=0.15.0.\"\"\"\n"); |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 268 | PrintAllComments(service); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 269 | for (int i = 0; i < service->method_count(); ++i) { |
Masood Malekghassemi | 4a051cc | 2016-10-20 14:50:49 -0700 | [diff] [blame] | 270 | const MethodDescriptor* method = service->method(i); |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 271 | grpc::string arg_name = |
Masood Malekghassemi | 4a051cc | 2016-10-20 14:50:49 -0700 | [diff] [blame] | 272 | method->client_streaming() ? "request_iterator" : "request"; |
| 273 | StringMap method_dict; |
| 274 | method_dict["Method"] = method->name(); |
| 275 | method_dict["ArgName"] = arg_name; |
| 276 | out->Print(method_dict, |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 277 | "def $Method$(self, $ArgName$, timeout, metadata=None, " |
| 278 | "with_call=False, protocol_options=None):\n"); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 279 | { |
| 280 | IndentScope raii_method_indent(out); |
Masood Malekghassemi | 4a051cc | 2016-10-20 14:50:49 -0700 | [diff] [blame] | 281 | PrintAllComments(method); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 282 | out->Print("raise NotImplementedError()\n"); |
| 283 | } |
Masood Malekghassemi | 4a051cc | 2016-10-20 14:50:49 -0700 | [diff] [blame] | 284 | if (!method->server_streaming()) { |
| 285 | out->Print(method_dict, "$Method$.future = None\n"); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 286 | } |
| 287 | } |
| 288 | } |
| 289 | return true; |
| 290 | } |
| 291 | |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 292 | bool PrivateGenerator::PrintBetaServerFactory( |
| 293 | const grpc::string& package_qualified_service_name, |
| 294 | const ServiceDescriptor* service) { |
Ken Payson | be187b0 | 2016-05-06 15:32:58 -0700 | [diff] [blame] | 295 | out->Print("\n\n"); |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 296 | out->Print( |
| 297 | "def beta_create_$Service$_server(servicer, pool=None, " |
| 298 | "pool_size=None, default_timeout=None, maximum_timeout=None):\n", |
| 299 | "Service", service->name()); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 300 | { |
| 301 | IndentScope raii_create_server_indent(out); |
Nicolas "Pixel" Noble | beeeddd | 2016-09-29 20:27:23 +0200 | [diff] [blame] | 302 | out->Print( |
| 303 | "\"\"\"The Beta API is deprecated for 0.15.0 and later.\n" |
| 304 | "\nIt is recommended to use the GA API (classes and functions in this\n" |
| 305 | "file not marked beta) for all further purposes. This function was\n" |
| 306 | "generated only to ease transition from grpcio<0.15.0 to grpcio>=0.15.0" |
| 307 | "\"\"\"\n"); |
Masood Malekghassemi | 4a051cc | 2016-10-20 14:50:49 -0700 | [diff] [blame] | 308 | StringMap method_implementation_constructors; |
| 309 | StringMap input_message_modules_and_classes; |
| 310 | StringMap output_message_modules_and_classes; |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 311 | for (int i = 0; i < service->method_count(); ++i) { |
| 312 | const MethodDescriptor* method = service->method(i); |
| 313 | const grpc::string method_implementation_constructor = |
| 314 | grpc::string(method->client_streaming() ? "stream_" : "unary_") + |
| 315 | grpc::string(method->server_streaming() ? "stream_" : "unary_") + |
| 316 | "inline"; |
Ken Payson | be187b0 | 2016-05-06 15:32:58 -0700 | [diff] [blame] | 317 | grpc::string input_message_module_and_class; |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 318 | if (!GetModuleAndMessagePath(method->input_type(), |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 319 | &input_message_module_and_class)) { |
| 320 | return false; |
| 321 | } |
Ken Payson | be187b0 | 2016-05-06 15:32:58 -0700 | [diff] [blame] | 322 | grpc::string output_message_module_and_class; |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 323 | if (!GetModuleAndMessagePath(method->output_type(), |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 324 | &output_message_module_and_class)) { |
| 325 | return false; |
| 326 | } |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 327 | method_implementation_constructors.insert( |
| 328 | make_pair(method->name(), method_implementation_constructor)); |
| 329 | input_message_modules_and_classes.insert( |
| 330 | make_pair(method->name(), input_message_module_and_class)); |
| 331 | output_message_modules_and_classes.insert( |
| 332 | make_pair(method->name(), output_message_module_and_class)); |
| 333 | } |
| 334 | out->Print("request_deserializers = {\n"); |
Masood Malekghassemi | 4a051cc | 2016-10-20 14:50:49 -0700 | [diff] [blame] | 335 | for (StringMap::iterator name_and_input_module_class_pair = |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 336 | input_message_modules_and_classes.begin(); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 337 | name_and_input_module_class_pair != |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 338 | input_message_modules_and_classes.end(); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 339 | name_and_input_module_class_pair++) { |
| 340 | IndentScope raii_indent(out); |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 341 | out->Print( |
| 342 | "(\'$PackageQualifiedServiceName$\', \'$MethodName$\'): " |
| 343 | "$InputTypeModuleAndClass$.FromString,\n", |
| 344 | "PackageQualifiedServiceName", package_qualified_service_name, |
| 345 | "MethodName", name_and_input_module_class_pair->first, |
| 346 | "InputTypeModuleAndClass", name_and_input_module_class_pair->second); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 347 | } |
| 348 | out->Print("}\n"); |
| 349 | out->Print("response_serializers = {\n"); |
Masood Malekghassemi | 4a051cc | 2016-10-20 14:50:49 -0700 | [diff] [blame] | 350 | for (StringMap::iterator name_and_output_module_class_pair = |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 351 | output_message_modules_and_classes.begin(); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 352 | name_and_output_module_class_pair != |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 353 | output_message_modules_and_classes.end(); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 354 | name_and_output_module_class_pair++) { |
| 355 | IndentScope raii_indent(out); |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 356 | out->Print( |
| 357 | "(\'$PackageQualifiedServiceName$\', \'$MethodName$\'): " |
| 358 | "$OutputTypeModuleAndClass$.SerializeToString,\n", |
| 359 | "PackageQualifiedServiceName", package_qualified_service_name, |
| 360 | "MethodName", name_and_output_module_class_pair->first, |
| 361 | "OutputTypeModuleAndClass", |
| 362 | name_and_output_module_class_pair->second); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 363 | } |
| 364 | out->Print("}\n"); |
| 365 | out->Print("method_implementations = {\n"); |
Masood Malekghassemi | 4a051cc | 2016-10-20 14:50:49 -0700 | [diff] [blame] | 366 | for (StringMap::iterator name_and_implementation_constructor = |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 367 | method_implementation_constructors.begin(); |
| 368 | name_and_implementation_constructor != |
| 369 | method_implementation_constructors.end(); |
| 370 | name_and_implementation_constructor++) { |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 371 | IndentScope raii_descriptions_indent(out); |
| 372 | const grpc::string method_name = |
| 373 | name_and_implementation_constructor->first; |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 374 | out->Print( |
| 375 | "(\'$PackageQualifiedServiceName$\', \'$Method$\'): " |
| 376 | "face_utilities.$Constructor$(servicer.$Method$),\n", |
| 377 | "PackageQualifiedServiceName", package_qualified_service_name, |
| 378 | "Method", name_and_implementation_constructor->first, "Constructor", |
| 379 | name_and_implementation_constructor->second); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 380 | } |
| 381 | out->Print("}\n"); |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 382 | out->Print( |
| 383 | "server_options = beta_implementations.server_options(" |
| 384 | "request_deserializers=request_deserializers, " |
| 385 | "response_serializers=response_serializers, " |
| 386 | "thread_pool=pool, thread_pool_size=pool_size, " |
| 387 | "default_timeout=default_timeout, " |
| 388 | "maximum_timeout=maximum_timeout)\n"); |
| 389 | out->Print( |
| 390 | "return beta_implementations.server(method_implementations, " |
| 391 | "options=server_options)\n"); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 392 | } |
| 393 | return true; |
| 394 | } |
| 395 | |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 396 | bool PrivateGenerator::PrintBetaStubFactory( |
| 397 | const grpc::string& package_qualified_service_name, |
| 398 | const ServiceDescriptor* service) { |
Masood Malekghassemi | 4a051cc | 2016-10-20 14:50:49 -0700 | [diff] [blame] | 399 | StringMap dict; |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 400 | dict["Service"] = service->name(); |
Ken Payson | be187b0 | 2016-05-06 15:32:58 -0700 | [diff] [blame] | 401 | out->Print("\n\n"); |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 402 | out->Print(dict, |
| 403 | "def beta_create_$Service$_stub(channel, host=None," |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 404 | " metadata_transformer=None, pool=None, pool_size=None):\n"); |
| 405 | { |
| 406 | IndentScope raii_create_server_indent(out); |
Nicolas "Pixel" Noble | beeeddd | 2016-09-29 20:27:23 +0200 | [diff] [blame] | 407 | out->Print( |
| 408 | "\"\"\"The Beta API is deprecated for 0.15.0 and later.\n" |
| 409 | "\nIt is recommended to use the GA API (classes and functions in this\n" |
| 410 | "file not marked beta) for all further purposes. This function was\n" |
| 411 | "generated only to ease transition from grpcio<0.15.0 to grpcio>=0.15.0" |
| 412 | "\"\"\"\n"); |
Masood Malekghassemi | 4a051cc | 2016-10-20 14:50:49 -0700 | [diff] [blame] | 413 | StringMap method_cardinalities; |
| 414 | StringMap input_message_modules_and_classes; |
| 415 | StringMap output_message_modules_and_classes; |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 416 | for (int i = 0; i < service->method_count(); ++i) { |
| 417 | const MethodDescriptor* method = service->method(i); |
| 418 | const grpc::string method_cardinality = |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 419 | grpc::string(method->client_streaming() ? "STREAM" : "UNARY") + "_" + |
Ken Payson | be187b0 | 2016-05-06 15:32:58 -0700 | [diff] [blame] | 420 | grpc::string(method->server_streaming() ? "STREAM" : "UNARY"); |
| 421 | grpc::string input_message_module_and_class; |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 422 | if (!GetModuleAndMessagePath(method->input_type(), |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 423 | &input_message_module_and_class)) { |
| 424 | return false; |
| 425 | } |
Ken Payson | be187b0 | 2016-05-06 15:32:58 -0700 | [diff] [blame] | 426 | grpc::string output_message_module_and_class; |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 427 | if (!GetModuleAndMessagePath(method->output_type(), |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 428 | &output_message_module_and_class)) { |
| 429 | return false; |
| 430 | } |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 431 | method_cardinalities.insert( |
| 432 | make_pair(method->name(), method_cardinality)); |
| 433 | input_message_modules_and_classes.insert( |
| 434 | make_pair(method->name(), input_message_module_and_class)); |
| 435 | output_message_modules_and_classes.insert( |
| 436 | make_pair(method->name(), output_message_module_and_class)); |
| 437 | } |
| 438 | out->Print("request_serializers = {\n"); |
Masood Malekghassemi | 4a051cc | 2016-10-20 14:50:49 -0700 | [diff] [blame] | 439 | for (StringMap::iterator name_and_input_module_class_pair = |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 440 | input_message_modules_and_classes.begin(); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 441 | name_and_input_module_class_pair != |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 442 | input_message_modules_and_classes.end(); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 443 | name_and_input_module_class_pair++) { |
| 444 | IndentScope raii_indent(out); |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 445 | out->Print( |
| 446 | "(\'$PackageQualifiedServiceName$\', \'$MethodName$\'): " |
| 447 | "$InputTypeModuleAndClass$.SerializeToString,\n", |
| 448 | "PackageQualifiedServiceName", package_qualified_service_name, |
| 449 | "MethodName", name_and_input_module_class_pair->first, |
| 450 | "InputTypeModuleAndClass", name_and_input_module_class_pair->second); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 451 | } |
| 452 | out->Print("}\n"); |
| 453 | out->Print("response_deserializers = {\n"); |
Masood Malekghassemi | 4a051cc | 2016-10-20 14:50:49 -0700 | [diff] [blame] | 454 | for (StringMap::iterator name_and_output_module_class_pair = |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 455 | output_message_modules_and_classes.begin(); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 456 | name_and_output_module_class_pair != |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 457 | output_message_modules_and_classes.end(); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 458 | name_and_output_module_class_pair++) { |
| 459 | IndentScope raii_indent(out); |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 460 | out->Print( |
| 461 | "(\'$PackageQualifiedServiceName$\', \'$MethodName$\'): " |
| 462 | "$OutputTypeModuleAndClass$.FromString,\n", |
| 463 | "PackageQualifiedServiceName", package_qualified_service_name, |
| 464 | "MethodName", name_and_output_module_class_pair->first, |
| 465 | "OutputTypeModuleAndClass", |
| 466 | name_and_output_module_class_pair->second); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 467 | } |
| 468 | out->Print("}\n"); |
| 469 | out->Print("cardinalities = {\n"); |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 470 | for (StringMap::iterator name_and_cardinality = |
| 471 | method_cardinalities.begin(); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 472 | name_and_cardinality != method_cardinalities.end(); |
| 473 | name_and_cardinality++) { |
| 474 | IndentScope raii_descriptions_indent(out); |
| 475 | out->Print("\'$Method$\': cardinality.Cardinality.$Cardinality$,\n", |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 476 | "Method", name_and_cardinality->first, "Cardinality", |
| 477 | name_and_cardinality->second); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 478 | } |
| 479 | out->Print("}\n"); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 480 | out->Print( |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 481 | "stub_options = beta_implementations.stub_options(" |
| 482 | "host=host, metadata_transformer=metadata_transformer, " |
| 483 | "request_serializers=request_serializers, " |
| 484 | "response_deserializers=response_deserializers, " |
| 485 | "thread_pool=pool, thread_pool_size=pool_size)\n"); |
| 486 | out->Print( |
| 487 | "return beta_implementations.dynamic_stub(channel, " |
| 488 | "\'$PackageQualifiedServiceName$\', " |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 489 | "cardinalities, options=stub_options)\n", |
| 490 | "PackageQualifiedServiceName", package_qualified_service_name); |
| 491 | } |
| 492 | return true; |
| 493 | } |
| 494 | |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 495 | bool PrivateGenerator::PrintStub( |
| 496 | const grpc::string& package_qualified_service_name, |
| 497 | const ServiceDescriptor* service) { |
Nathaniel Manista | 4547940 | 2016-06-13 20:14:18 +0000 | [diff] [blame] | 498 | out->Print("\n\n"); |
| 499 | out->Print("class $Service$Stub(object):\n", "Service", service->name()); |
| 500 | { |
| 501 | IndentScope raii_class_indent(out); |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 502 | PrintAllComments(service); |
Nathaniel Manista | 4547940 | 2016-06-13 20:14:18 +0000 | [diff] [blame] | 503 | out->Print("\n"); |
| 504 | out->Print("def __init__(self, channel):\n"); |
| 505 | { |
| 506 | IndentScope raii_init_indent(out); |
| 507 | out->Print("\"\"\"Constructor.\n"); |
| 508 | out->Print("\n"); |
| 509 | out->Print("Args:\n"); |
| 510 | { |
| 511 | IndentScope raii_args_indent(out); |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 512 | out->Print("channel: A grpc.Channel.\n"); |
Nathaniel Manista | 4547940 | 2016-06-13 20:14:18 +0000 | [diff] [blame] | 513 | } |
| 514 | out->Print("\"\"\"\n"); |
| 515 | for (int i = 0; i < service->method_count(); ++i) { |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 516 | const MethodDescriptor* method = service->method(i); |
Masood Malekghassemi | 4a051cc | 2016-10-20 14:50:49 -0700 | [diff] [blame] | 517 | grpc::string multi_callable_constructor = |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 518 | grpc::string(method->client_streaming() ? "stream" : "unary") + |
| 519 | "_" + grpc::string(method->server_streaming() ? "stream" : "unary"); |
| 520 | grpc::string request_module_and_class; |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 521 | if (!GetModuleAndMessagePath(method->input_type(), |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 522 | &request_module_and_class)) { |
Nathaniel Manista | 4547940 | 2016-06-13 20:14:18 +0000 | [diff] [blame] | 523 | return false; |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 524 | } |
| 525 | grpc::string response_module_and_class; |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 526 | if (!GetModuleAndMessagePath(method->output_type(), |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 527 | &response_module_and_class)) { |
| 528 | return false; |
| 529 | } |
| 530 | out->Print("self.$Method$ = channel.$MultiCallableConstructor$(\n", |
| 531 | "Method", method->name(), "MultiCallableConstructor", |
| 532 | multi_callable_constructor); |
| 533 | { |
Nathaniel Manista | 4547940 | 2016-06-13 20:14:18 +0000 | [diff] [blame] | 534 | IndentScope raii_first_attribute_indent(out); |
| 535 | IndentScope raii_second_attribute_indent(out); |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 536 | out->Print("'/$PackageQualifiedService$/$Method$',\n", |
| 537 | "PackageQualifiedService", package_qualified_service_name, |
| 538 | "Method", method->name()); |
| 539 | out->Print( |
| 540 | "request_serializer=$RequestModuleAndClass$.SerializeToString,\n", |
| 541 | "RequestModuleAndClass", request_module_and_class); |
| 542 | out->Print( |
Nathaniel Manista | 4547940 | 2016-06-13 20:14:18 +0000 | [diff] [blame] | 543 | "response_deserializer=$ResponseModuleAndClass$.FromString,\n", |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 544 | "ResponseModuleAndClass", response_module_and_class); |
| 545 | out->Print(")\n"); |
| 546 | } |
Nathaniel Manista | 4547940 | 2016-06-13 20:14:18 +0000 | [diff] [blame] | 547 | } |
| 548 | } |
| 549 | } |
| 550 | return true; |
| 551 | } |
| 552 | |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 553 | bool PrivateGenerator::PrintServicer(const ServiceDescriptor* service) { |
Nathaniel Manista | 4547940 | 2016-06-13 20:14:18 +0000 | [diff] [blame] | 554 | out->Print("\n\n"); |
| 555 | out->Print("class $Service$Servicer(object):\n", "Service", service->name()); |
| 556 | { |
| 557 | IndentScope raii_class_indent(out); |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 558 | PrintAllComments(service); |
Nathaniel Manista | 4547940 | 2016-06-13 20:14:18 +0000 | [diff] [blame] | 559 | for (int i = 0; i < service->method_count(); ++i) { |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 560 | const MethodDescriptor* method = service->method(i); |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 561 | grpc::string arg_name = |
| 562 | method->client_streaming() ? "request_iterator" : "request"; |
Nathaniel Manista | 4547940 | 2016-06-13 20:14:18 +0000 | [diff] [blame] | 563 | out->Print("\n"); |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 564 | out->Print("def $Method$(self, $ArgName$, context):\n", "Method", |
| 565 | method->name(), "ArgName", arg_name); |
Nathaniel Manista | 4547940 | 2016-06-13 20:14:18 +0000 | [diff] [blame] | 566 | { |
| 567 | IndentScope raii_method_indent(out); |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 568 | PrintAllComments(method); |
Nathaniel Manista | 4547940 | 2016-06-13 20:14:18 +0000 | [diff] [blame] | 569 | out->Print("context.set_code(grpc.StatusCode.UNIMPLEMENTED)\n"); |
| 570 | out->Print("context.set_details('Method not implemented!')\n"); |
| 571 | out->Print("raise NotImplementedError('Method not implemented!')\n"); |
| 572 | } |
| 573 | } |
| 574 | } |
| 575 | return true; |
| 576 | } |
| 577 | |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 578 | bool PrivateGenerator::PrintAddServicerToServer( |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 579 | const grpc::string& package_qualified_service_name, |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 580 | const ServiceDescriptor* service) { |
Nathaniel Manista | 4547940 | 2016-06-13 20:14:18 +0000 | [diff] [blame] | 581 | out->Print("\n\n"); |
| 582 | out->Print("def add_$Service$Servicer_to_server(servicer, server):\n", |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 583 | "Service", service->name()); |
Nathaniel Manista | 4547940 | 2016-06-13 20:14:18 +0000 | [diff] [blame] | 584 | { |
| 585 | IndentScope raii_class_indent(out); |
| 586 | out->Print("rpc_method_handlers = {\n"); |
| 587 | { |
| 588 | IndentScope raii_dict_first_indent(out); |
| 589 | IndentScope raii_dict_second_indent(out); |
| 590 | for (int i = 0; i < service->method_count(); ++i) { |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 591 | const MethodDescriptor* method = service->method(i); |
Masood Malekghassemi | 4a051cc | 2016-10-20 14:50:49 -0700 | [diff] [blame] | 592 | grpc::string method_handler_constructor = |
Nathaniel Manista | 4547940 | 2016-06-13 20:14:18 +0000 | [diff] [blame] | 593 | grpc::string(method->client_streaming() ? "stream" : "unary") + |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 594 | "_" + |
Nathaniel Manista | 4547940 | 2016-06-13 20:14:18 +0000 | [diff] [blame] | 595 | grpc::string(method->server_streaming() ? "stream" : "unary") + |
| 596 | "_rpc_method_handler"; |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 597 | grpc::string request_module_and_class; |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 598 | if (!GetModuleAndMessagePath(method->input_type(), |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 599 | &request_module_and_class)) { |
Nathaniel Manista | 4547940 | 2016-06-13 20:14:18 +0000 | [diff] [blame] | 600 | return false; |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 601 | } |
| 602 | grpc::string response_module_and_class; |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 603 | if (!GetModuleAndMessagePath(method->output_type(), |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 604 | &response_module_and_class)) { |
| 605 | return false; |
| 606 | } |
| 607 | out->Print("'$Method$': grpc.$MethodHandlerConstructor$(\n", "Method", |
| 608 | method->name(), "MethodHandlerConstructor", |
| 609 | method_handler_constructor); |
| 610 | { |
Nathaniel Manista | 4547940 | 2016-06-13 20:14:18 +0000 | [diff] [blame] | 611 | IndentScope raii_call_first_indent(out); |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 612 | IndentScope raii_call_second_indent(out); |
| 613 | out->Print("servicer.$Method$,\n", "Method", method->name()); |
| 614 | out->Print( |
| 615 | "request_deserializer=$RequestModuleAndClass$.FromString,\n", |
| 616 | "RequestModuleAndClass", request_module_and_class); |
| 617 | out->Print( |
| 618 | "response_serializer=$ResponseModuleAndClass$.SerializeToString," |
| 619 | "\n", |
| 620 | "ResponseModuleAndClass", response_module_and_class); |
| 621 | } |
| 622 | out->Print("),\n"); |
Nathaniel Manista | 4547940 | 2016-06-13 20:14:18 +0000 | [diff] [blame] | 623 | } |
| 624 | } |
| 625 | out->Print("}\n"); |
| 626 | out->Print("generic_handler = grpc.method_handlers_generic_handler(\n"); |
| 627 | { |
| 628 | IndentScope raii_call_first_indent(out); |
| 629 | IndentScope raii_call_second_indent(out); |
| 630 | out->Print("'$PackageQualifiedServiceName$', rpc_method_handlers)\n", |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 631 | "PackageQualifiedServiceName", package_qualified_service_name); |
Nathaniel Manista | 4547940 | 2016-06-13 20:14:18 +0000 | [diff] [blame] | 632 | } |
| 633 | out->Print("server.add_generic_rpc_handlers((generic_handler,))\n"); |
| 634 | } |
| 635 | return true; |
| 636 | } |
| 637 | |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 638 | bool PrivateGenerator::PrintBetaPreamble() { |
Nathaniel Manista | f65d3c1 | 2015-09-05 03:55:19 +0000 | [diff] [blame] | 639 | out->Print("from $Package$ import implementations as beta_implementations\n", |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 640 | "Package", config.beta_package_root); |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 641 | out->Print("from $Package$ import interfaces as beta_interfaces\n", "Package", |
| 642 | config.beta_package_root); |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 643 | return true; |
| 644 | } |
| 645 | |
| 646 | bool PrivateGenerator::PrintPreamble() { |
| 647 | out->Print("import $Package$\n", "Package", config.grpc_package_root); |
Nathaniel Manista | cd9ec0e | 2015-08-31 07:49:45 +0000 | [diff] [blame] | 648 | out->Print("from grpc.framework.common import cardinality\n"); |
Masood Malekghassemi | ac59245 | 2016-07-01 11:58:04 -0700 | [diff] [blame] | 649 | out->Print( |
| 650 | "from grpc.framework.interfaces.face import utilities as " |
| 651 | "face_utilities\n"); |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 652 | if (generate_in_pb2_grpc) { |
| 653 | out->Print("\n"); |
| 654 | for (int i = 0; i < file->service_count(); ++i) { |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 655 | const ServiceDescriptor* service = file->service(i); |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 656 | for (int j = 0; j < service->method_count(); ++j) { |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 657 | const MethodDescriptor* method = service->method(j); |
| 658 | const Descriptor* types[2] = {method->input_type(), |
| 659 | method->output_type()}; |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 660 | for (int k = 0; k < 2; ++k) { |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 661 | const Descriptor* type = types[k]; |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 662 | grpc::string type_file_name = type->file()->name(); |
| 663 | grpc::string module_name = ModuleName(type_file_name); |
| 664 | grpc::string module_alias = ModuleAlias(type_file_name); |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 665 | out->Print("import $ModuleName$ as $ModuleAlias$\n", "ModuleName", |
| 666 | module_name, "ModuleAlias", module_alias); |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 667 | } |
| 668 | } |
| 669 | } |
| 670 | } |
Masood Malekghassemi | 59d9ff4 | 2015-02-23 15:28:07 -0800 | [diff] [blame] | 671 | return true; |
Masood Malekghassemi | f8e297a | 2015-02-19 15:39:32 -0800 | [diff] [blame] | 672 | } |
| 673 | |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 674 | bool PrivateGenerator::PrintGAServices() { |
| 675 | grpc::string package = file->package(); |
| 676 | if (!package.empty()) { |
| 677 | package = package.append("."); |
| 678 | } |
| 679 | for (int i = 0; i < file->service_count(); ++i) { |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 680 | const ServiceDescriptor* service = file->service(i); |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 681 | grpc::string package_qualified_service_name = package + service->name(); |
| 682 | if (!(PrintStub(package_qualified_service_name, service) && |
| 683 | PrintServicer(service) && |
| 684 | PrintAddServicerToServer(package_qualified_service_name, service))) { |
| 685 | return false; |
| 686 | } |
| 687 | } |
| 688 | return true; |
| 689 | } |
Masood Malekghassemi | f8e297a | 2015-02-19 15:39:32 -0800 | [diff] [blame] | 690 | |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 691 | bool PrivateGenerator::PrintBetaServices() { |
| 692 | grpc::string package = file->package(); |
| 693 | if (!package.empty()) { |
| 694 | package = package.append("."); |
| 695 | } |
| 696 | for (int i = 0; i < file->service_count(); ++i) { |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 697 | const ServiceDescriptor* service = file->service(i); |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 698 | grpc::string package_qualified_service_name = package + service->name(); |
| 699 | if (!(PrintBetaServicer(service) && PrintBetaStub(service) && |
| 700 | PrintBetaServerFactory(package_qualified_service_name, service) && |
| 701 | PrintBetaStubFactory(package_qualified_service_name, service))) { |
| 702 | return false; |
| 703 | } |
| 704 | } |
| 705 | return true; |
| 706 | } |
| 707 | |
| 708 | pair<bool, grpc::string> PrivateGenerator::GetGrpcServices() { |
Masood Malekghassemi | 65c803b | 2015-03-20 06:48:47 -0700 | [diff] [blame] | 709 | grpc::string output; |
Masood Malekghassemi | 59d9ff4 | 2015-02-23 15:28:07 -0800 | [diff] [blame] | 710 | { |
| 711 | // Scope the output stream so it closes and finalizes output to the string. |
| 712 | StringOutputStream output_stream(&output); |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 713 | Printer out_printer(&output_stream, '$'); |
| 714 | out = &out_printer; |
| 715 | |
| 716 | if (generate_in_pb2_grpc) { |
| 717 | if (!PrintPreamble()) { |
Masood Malekghassemi | 59d9ff4 | 2015-02-23 15:28:07 -0800 | [diff] [blame] | 718 | return make_pair(false, ""); |
| 719 | } |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 720 | if (!PrintGAServices()) { |
| 721 | return make_pair(false, ""); |
| 722 | } |
| 723 | } else { |
| 724 | out->Print("try:\n"); |
| 725 | { |
| 726 | IndentScope raii_dict_try_indent(out); |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 727 | out->Print( |
| 728 | "# THESE ELEMENTS WILL BE DEPRECATED.\n" |
| 729 | "# Please use the generated *_pb2_grpc.py files instead.\n"); |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 730 | if (!PrintPreamble()) { |
| 731 | return make_pair(false, ""); |
| 732 | } |
| 733 | if (!PrintBetaPreamble()) { |
| 734 | return make_pair(false, ""); |
| 735 | } |
| 736 | if (!PrintGAServices()) { |
| 737 | return make_pair(false, ""); |
| 738 | } |
| 739 | if (!PrintBetaServices()) { |
| 740 | return make_pair(false, ""); |
| 741 | } |
| 742 | } |
| 743 | out->Print("except ImportError:\n"); |
| 744 | { |
| 745 | IndentScope raii_dict_except_indent(out); |
| 746 | out->Print("pass"); |
| 747 | } |
Masood Malekghassemi | 59d9ff4 | 2015-02-23 15:28:07 -0800 | [diff] [blame] | 748 | } |
Masood Malekghassemi | f8e297a | 2015-02-19 15:39:32 -0800 | [diff] [blame] | 749 | } |
Masood Malekghassemi | 59d9ff4 | 2015-02-23 15:28:07 -0800 | [diff] [blame] | 750 | return make_pair(true, std::move(output)); |
Masood Malekghassemi | f8e297a | 2015-02-19 15:39:32 -0800 | [diff] [blame] | 751 | } |
| 752 | |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 753 | } // namespace |
| 754 | |
| 755 | GeneratorConfiguration::GeneratorConfiguration() |
| 756 | : grpc_package_root("grpc"), beta_package_root("grpc.beta") {} |
| 757 | |
| 758 | PythonGrpcGenerator::PythonGrpcGenerator(const GeneratorConfiguration& config) |
| 759 | : config_(config) {} |
| 760 | |
| 761 | PythonGrpcGenerator::~PythonGrpcGenerator() {} |
| 762 | |
Masood Malekghassemi | 561dce4 | 2016-11-30 20:20:32 -0800 | [diff] [blame^] | 763 | static bool GenerateGrpc(GeneratorContext* context, PrivateGenerator& generator, |
| 764 | grpc::string file_name, bool generate_in_pb2_grpc) { |
| 765 | bool success; |
| 766 | std::unique_ptr<ZeroCopyOutputStream> output; |
| 767 | std::unique_ptr<CodedOutputStream> coded_output; |
| 768 | grpc::string grpc_code; |
| 769 | |
| 770 | if (generate_in_pb2_grpc) { |
| 771 | output.reset(context->Open(file_name)); |
| 772 | generator.generate_in_pb2_grpc = true; |
| 773 | } else { |
| 774 | output.reset(context->OpenForInsert(file_name, "module_scope")); |
| 775 | generator.generate_in_pb2_grpc = false; |
| 776 | } |
| 777 | |
| 778 | coded_output.reset(new CodedOutputStream(output.get())); |
| 779 | tie(success, grpc_code) = generator.GetGrpcServices(); |
| 780 | |
| 781 | if (success) { |
| 782 | coded_output->WriteRaw(grpc_code.data(), grpc_code.size()); |
| 783 | return true; |
| 784 | } else { |
| 785 | return false; |
| 786 | } |
| 787 | } |
| 788 | |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 789 | bool PythonGrpcGenerator::Generate(const FileDescriptor* file, |
| 790 | const grpc::string& parameter, |
| 791 | GeneratorContext* context, |
| 792 | grpc::string* error) const { |
| 793 | // Get output file name. |
| 794 | grpc::string pb2_file_name; |
| 795 | grpc::string pb2_grpc_file_name; |
| 796 | static const int proto_suffix_length = strlen(".proto"); |
| 797 | if (file->name().size() > static_cast<size_t>(proto_suffix_length) && |
| 798 | file->name().find_last_of(".proto") == file->name().size() - 1) { |
Masood Malekghassemi | 7780cc0 | 2016-10-24 15:30:05 -0700 | [diff] [blame] | 799 | grpc::string base = |
| 800 | file->name().substr(0, file->name().size() - proto_suffix_length); |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 801 | pb2_file_name = base + "_pb2.py"; |
| 802 | pb2_grpc_file_name = base + "_pb2_grpc.py"; |
| 803 | } else { |
| 804 | *error = "Invalid proto file name. Proto file must end with .proto"; |
| 805 | return false; |
| 806 | } |
| 807 | |
| 808 | PrivateGenerator generator(config_, file); |
Masood Malekghassemi | 561dce4 | 2016-11-30 20:20:32 -0800 | [diff] [blame^] | 809 | if (parameter == "grpc_2_0") { |
| 810 | return GenerateGrpc(context, generator, pb2_grpc_file_name, true); |
| 811 | } else if (parameter == "") { |
| 812 | return GenerateGrpc(context, generator, pb2_grpc_file_name, true) && |
| 813 | GenerateGrpc(context, generator, pb2_file_name, false); |
| 814 | } else { |
| 815 | *error = "Invalid parameter '" + parameter + "'."; |
| 816 | return false; |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 817 | } |
Masood Malekghassemi | d953959 | 2016-10-20 14:47:14 -0700 | [diff] [blame] | 818 | } |
| 819 | |
Masood Malekghassemi | f8e297a | 2015-02-19 15:39:32 -0800 | [diff] [blame] | 820 | } // namespace grpc_python_generator |