main.cpp 30 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832
  1. /*
  2. * Copyright (c) 2018-2020, Andreas Kling <kling@serenityos.org>
  3. *
  4. * SPDX-License-Identifier: BSD-2-Clause
  5. */
  6. #include <AK/Debug.h>
  7. #include <AK/Function.h>
  8. #include <AK/GenericLexer.h>
  9. #include <AK/HashMap.h>
  10. #include <AK/SourceGenerator.h>
  11. #include <AK/StringBuilder.h>
  12. #include <LibCore/Stream.h>
  13. #include <LibMain/Main.h>
  14. #include <ctype.h>
  15. #include <stdio.h>
  16. struct Parameter {
  17. Vector<DeprecatedString> attributes;
  18. DeprecatedString type;
  19. DeprecatedString name;
  20. };
  21. static DeprecatedString pascal_case(DeprecatedString const& identifier)
  22. {
  23. StringBuilder builder;
  24. bool was_new_word = true;
  25. for (auto ch : identifier) {
  26. if (ch == '_') {
  27. was_new_word = true;
  28. continue;
  29. }
  30. if (was_new_word) {
  31. builder.append(toupper(ch));
  32. was_new_word = false;
  33. } else
  34. builder.append(ch);
  35. }
  36. return builder.to_deprecated_string();
  37. }
  38. struct Message {
  39. DeprecatedString name;
  40. bool is_synchronous { false };
  41. Vector<Parameter> inputs;
  42. Vector<Parameter> outputs;
  43. DeprecatedString response_name() const
  44. {
  45. StringBuilder builder;
  46. builder.append(pascal_case(name));
  47. builder.append("Response"sv);
  48. return builder.to_deprecated_string();
  49. }
  50. };
  51. struct Endpoint {
  52. Vector<DeprecatedString> includes;
  53. DeprecatedString name;
  54. u32 magic;
  55. Vector<Message> messages;
  56. };
  57. static bool is_primitive_type(DeprecatedString const& type)
  58. {
  59. return type.is_one_of("u8", "i8", "u16", "i16", "u32", "i32", "u64", "i64", "size_t", "bool", "double", "float", "int", "unsigned", "unsigned int");
  60. }
  61. static bool is_simple_type(DeprecatedString const& type)
  62. {
  63. // Small types that it makes sense just to pass by value.
  64. return type.is_one_of("Gfx::Color", "Gfx::IntPoint", "Gfx::FloatPoint", "Gfx::IntSize", "Gfx::FloatSize", "Core::Stream::OpenMode");
  65. }
  66. static bool is_primitive_or_simple_type(DeprecatedString const& type)
  67. {
  68. return is_primitive_type(type) || is_simple_type(type);
  69. }
  70. static DeprecatedString message_name(DeprecatedString const& endpoint, DeprecatedString const& message, bool is_response)
  71. {
  72. StringBuilder builder;
  73. builder.append("Messages::"sv);
  74. builder.append(endpoint);
  75. builder.append("::"sv);
  76. builder.append(pascal_case(message));
  77. if (is_response)
  78. builder.append("Response"sv);
  79. return builder.to_deprecated_string();
  80. }
  81. Vector<Endpoint> parse(ByteBuffer const& file_contents)
  82. {
  83. GenericLexer lexer(file_contents);
  84. Vector<Endpoint> endpoints;
  85. auto assert_specific = [&lexer](char ch) {
  86. if (lexer.peek() != ch)
  87. warnln("assert_specific: wanted '{}', but got '{}' at index {}", ch, lexer.peek(), lexer.tell());
  88. bool saw_expected = lexer.consume_specific(ch);
  89. VERIFY(saw_expected);
  90. };
  91. auto consume_whitespace = [&lexer] {
  92. lexer.ignore_while([](char ch) { return isspace(ch); });
  93. if (lexer.peek() == '/' && lexer.peek(1) == '/')
  94. lexer.ignore_until([](char ch) { return ch == '\n'; });
  95. };
  96. auto parse_parameter = [&](Vector<Parameter>& storage) {
  97. for (;;) {
  98. Parameter parameter;
  99. if (lexer.is_eof()) {
  100. warnln("EOF when parsing parameter");
  101. VERIFY_NOT_REACHED();
  102. }
  103. consume_whitespace();
  104. if (lexer.peek() == ')')
  105. break;
  106. if (lexer.consume_specific('[')) {
  107. for (;;) {
  108. if (lexer.consume_specific(']')) {
  109. consume_whitespace();
  110. break;
  111. }
  112. if (lexer.consume_specific(',')) {
  113. consume_whitespace();
  114. }
  115. auto attribute = lexer.consume_until([](char ch) { return ch == ']' || ch == ','; });
  116. parameter.attributes.append(attribute);
  117. consume_whitespace();
  118. }
  119. }
  120. // FIXME: This is not entirely correct. Types can have spaces, for example `HashMap<int, DeprecatedString>`.
  121. // Maybe we should use LibCpp::Parser for parsing types.
  122. parameter.type = lexer.consume_until([](char ch) { return isspace(ch); });
  123. VERIFY(!lexer.is_eof());
  124. consume_whitespace();
  125. parameter.name = lexer.consume_until([](char ch) { return isspace(ch) || ch == ',' || ch == ')'; });
  126. consume_whitespace();
  127. storage.append(move(parameter));
  128. if (lexer.consume_specific(','))
  129. continue;
  130. if (lexer.peek() == ')')
  131. break;
  132. }
  133. };
  134. auto parse_parameters = [&](Vector<Parameter>& storage) {
  135. for (;;) {
  136. consume_whitespace();
  137. parse_parameter(storage);
  138. consume_whitespace();
  139. if (lexer.consume_specific(','))
  140. continue;
  141. if (lexer.peek() == ')')
  142. break;
  143. }
  144. };
  145. auto parse_message = [&] {
  146. Message message;
  147. consume_whitespace();
  148. message.name = lexer.consume_until([](char ch) { return isspace(ch) || ch == '('; });
  149. consume_whitespace();
  150. assert_specific('(');
  151. parse_parameters(message.inputs);
  152. assert_specific(')');
  153. consume_whitespace();
  154. assert_specific('=');
  155. auto type = lexer.consume();
  156. if (type == '>')
  157. message.is_synchronous = true;
  158. else if (type == '|')
  159. message.is_synchronous = false;
  160. else
  161. VERIFY_NOT_REACHED();
  162. consume_whitespace();
  163. if (message.is_synchronous) {
  164. assert_specific('(');
  165. parse_parameters(message.outputs);
  166. assert_specific(')');
  167. }
  168. consume_whitespace();
  169. endpoints.last().messages.append(move(message));
  170. };
  171. auto parse_messages = [&] {
  172. for (;;) {
  173. consume_whitespace();
  174. if (lexer.peek() == '}')
  175. break;
  176. parse_message();
  177. consume_whitespace();
  178. }
  179. };
  180. auto parse_include = [&] {
  181. DeprecatedString include;
  182. consume_whitespace();
  183. include = lexer.consume_while([](char ch) { return ch != '\n'; });
  184. consume_whitespace();
  185. endpoints.last().includes.append(move(include));
  186. };
  187. auto parse_includes = [&] {
  188. for (;;) {
  189. consume_whitespace();
  190. if (lexer.peek() != '#')
  191. break;
  192. parse_include();
  193. consume_whitespace();
  194. }
  195. };
  196. auto parse_endpoint = [&] {
  197. endpoints.empend();
  198. consume_whitespace();
  199. parse_includes();
  200. consume_whitespace();
  201. lexer.consume_specific("endpoint");
  202. consume_whitespace();
  203. endpoints.last().name = lexer.consume_while([](char ch) { return !isspace(ch); });
  204. endpoints.last().magic = Traits<DeprecatedString>::hash(endpoints.last().name);
  205. consume_whitespace();
  206. assert_specific('{');
  207. parse_messages();
  208. assert_specific('}');
  209. consume_whitespace();
  210. };
  211. while (lexer.tell() < file_contents.size())
  212. parse_endpoint();
  213. return endpoints;
  214. }
  215. HashMap<DeprecatedString, int> build_message_ids_for_endpoint(SourceGenerator generator, Endpoint const& endpoint)
  216. {
  217. HashMap<DeprecatedString, int> message_ids;
  218. generator.appendln("\nenum class MessageID : i32 {");
  219. for (auto const& message : endpoint.messages) {
  220. message_ids.set(message.name, message_ids.size() + 1);
  221. generator.set("message.pascal_name", pascal_case(message.name));
  222. generator.set("message.id", DeprecatedString::number(message_ids.size()));
  223. generator.appendln(" @message.pascal_name@ = @message.id@,");
  224. if (message.is_synchronous) {
  225. message_ids.set(message.response_name(), message_ids.size() + 1);
  226. generator.set("message.pascal_name", pascal_case(message.response_name()));
  227. generator.set("message.id", DeprecatedString::number(message_ids.size()));
  228. generator.appendln(" @message.pascal_name@ = @message.id@,");
  229. }
  230. }
  231. generator.appendln("};");
  232. return message_ids;
  233. }
  234. DeprecatedString constructor_for_message(DeprecatedString const& name, Vector<Parameter> const& parameters)
  235. {
  236. StringBuilder builder;
  237. builder.append(name);
  238. if (parameters.is_empty()) {
  239. builder.append("() {}"sv);
  240. return builder.to_deprecated_string();
  241. }
  242. builder.append('(');
  243. for (size_t i = 0; i < parameters.size(); ++i) {
  244. auto const& parameter = parameters[i];
  245. builder.appendff("{} {}", parameter.type, parameter.name);
  246. if (i != parameters.size() - 1)
  247. builder.append(", "sv);
  248. }
  249. builder.append(") : "sv);
  250. for (size_t i = 0; i < parameters.size(); ++i) {
  251. auto const& parameter = parameters[i];
  252. builder.appendff("m_{}(move({}))", parameter.name, parameter.name);
  253. if (i != parameters.size() - 1)
  254. builder.append(", "sv);
  255. }
  256. builder.append(" {}"sv);
  257. return builder.to_deprecated_string();
  258. }
  259. void do_message(SourceGenerator message_generator, DeprecatedString const& name, Vector<Parameter> const& parameters, DeprecatedString const& response_type = {})
  260. {
  261. auto pascal_name = pascal_case(name);
  262. message_generator.set("message.name", name);
  263. message_generator.set("message.pascal_name", pascal_name);
  264. message_generator.set("message.response_type", response_type);
  265. message_generator.set("message.constructor", constructor_for_message(pascal_name, parameters));
  266. message_generator.appendln(R"~~~(
  267. class @message.pascal_name@ final : public IPC::Message {
  268. public:)~~~");
  269. if (!response_type.is_null())
  270. message_generator.appendln(R"~~~(
  271. typedef class @message.response_type@ ResponseType;)~~~");
  272. message_generator.appendln(R"~~~(
  273. @message.pascal_name@(decltype(nullptr)) : m_ipc_message_valid(false) { }
  274. @message.pascal_name@(@message.pascal_name@ const&) = default;
  275. @message.pascal_name@(@message.pascal_name@&&) = default;
  276. @message.pascal_name@& operator=(@message.pascal_name@ const&) = default;
  277. @message.constructor@)~~~");
  278. if (parameters.size() == 1) {
  279. auto const& parameter = parameters[0];
  280. message_generator.set("parameter.type"sv, parameter.type);
  281. message_generator.set("parameter.name"sv, parameter.name);
  282. message_generator.appendln(R"~~~(
  283. template <typename WrappedReturnType>
  284. requires(!SameAs<WrappedReturnType, @parameter.type@>)
  285. @message.pascal_name@(WrappedReturnType&& value)
  286. : m_@parameter.name@(forward<WrappedReturnType>(value))
  287. {
  288. })~~~");
  289. }
  290. message_generator.appendln(R"~~~(
  291. virtual ~@message.pascal_name@() override {}
  292. virtual u32 endpoint_magic() const override { return @endpoint.magic@; }
  293. virtual i32 message_id() const override { return (int)MessageID::@message.pascal_name@; }
  294. static i32 static_message_id() { return (int)MessageID::@message.pascal_name@; }
  295. virtual const char* message_name() const override { return "@endpoint.name@::@message.pascal_name@"; }
  296. static ErrorOr<NonnullOwnPtr<@message.pascal_name@>> decode(Core::Stream::Stream& stream, Core::Stream::LocalSocket& socket)
  297. {
  298. IPC::Decoder decoder { stream, socket };)~~~");
  299. for (auto const& parameter : parameters) {
  300. auto parameter_generator = message_generator.fork();
  301. parameter_generator.set("parameter.type", parameter.type);
  302. parameter_generator.set("parameter.name", parameter.name);
  303. if (parameter.type == "bool")
  304. parameter_generator.set("parameter.initial_value", "false");
  305. else
  306. parameter_generator.set("parameter.initial_value", "{}");
  307. parameter_generator.appendln(R"~~~(
  308. auto @parameter.name@ = TRY((decoder.decode<@parameter.type@>()));)~~~");
  309. if (parameter.attributes.contains_slow("UTF8")) {
  310. parameter_generator.appendln(R"~~~(
  311. if (!Utf8View(@parameter.name@).validate())
  312. return Error::from_string_literal("Decoded @parameter.name@ is invalid UTF-8");)~~~");
  313. }
  314. }
  315. StringBuilder builder;
  316. for (size_t i = 0; i < parameters.size(); ++i) {
  317. auto const& parameter = parameters[i];
  318. builder.appendff("move({})", parameter.name);
  319. if (i != parameters.size() - 1)
  320. builder.append(", "sv);
  321. }
  322. message_generator.set("message.constructor_call_parameters", builder.build());
  323. message_generator.appendln(R"~~~(
  324. return make<@message.pascal_name@>(@message.constructor_call_parameters@);
  325. })~~~");
  326. message_generator.appendln(R"~~~(
  327. virtual bool valid() const override { return m_ipc_message_valid; }
  328. virtual ErrorOr<IPC::MessageBuffer> encode() const override
  329. {
  330. VERIFY(valid());
  331. IPC::MessageBuffer buffer;
  332. IPC::Encoder stream(buffer);
  333. TRY(stream.encode(endpoint_magic()));
  334. TRY(stream.encode((int)MessageID::@message.pascal_name@));)~~~");
  335. for (auto const& parameter : parameters) {
  336. auto parameter_generator = message_generator.fork();
  337. parameter_generator.set("parameter.name", parameter.name);
  338. parameter_generator.appendln(R"~~~(
  339. TRY(stream.encode(m_@parameter.name@));)~~~");
  340. }
  341. message_generator.appendln(R"~~~(
  342. return buffer;
  343. })~~~");
  344. for (auto const& parameter : parameters) {
  345. auto parameter_generator = message_generator.fork();
  346. parameter_generator.set("parameter.type", parameter.type);
  347. parameter_generator.set("parameter.name", parameter.name);
  348. parameter_generator.appendln(R"~~~(
  349. const @parameter.type@& @parameter.name@() const { return m_@parameter.name@; }
  350. @parameter.type@ take_@parameter.name@() { return move(m_@parameter.name@); })~~~");
  351. }
  352. message_generator.appendln(R"~~~(
  353. private:
  354. bool m_ipc_message_valid { true };)~~~");
  355. for (auto const& parameter : parameters) {
  356. auto parameter_generator = message_generator.fork();
  357. parameter_generator.set("parameter.type", parameter.type);
  358. parameter_generator.set("parameter.name", parameter.name);
  359. parameter_generator.appendln(R"~~~(
  360. @parameter.type@ m_@parameter.name@ {};)~~~");
  361. }
  362. message_generator.appendln("\n};");
  363. }
  364. void do_message_for_proxy(SourceGenerator message_generator, Endpoint const& endpoint, Message const& message)
  365. {
  366. auto do_implement_proxy = [&](DeprecatedString const& name, Vector<Parameter> const& parameters, bool is_synchronous, bool is_try) {
  367. DeprecatedString return_type = "void";
  368. if (is_synchronous) {
  369. if (message.outputs.size() == 1)
  370. return_type = message.outputs[0].type;
  371. else if (!message.outputs.is_empty())
  372. return_type = message_name(endpoint.name, message.name, true);
  373. }
  374. DeprecatedString inner_return_type = return_type;
  375. if (is_try)
  376. return_type = DeprecatedString::formatted("IPC::IPCErrorOr<{}>", return_type);
  377. message_generator.set("message.name", message.name);
  378. message_generator.set("message.pascal_name", pascal_case(message.name));
  379. message_generator.set("message.complex_return_type", return_type);
  380. message_generator.set("async_prefix_maybe", is_synchronous ? "" : "async_");
  381. message_generator.set("try_prefix_maybe", is_try ? "try_" : "");
  382. message_generator.set("handler_name", name);
  383. message_generator.appendln(R"~~~(
  384. @message.complex_return_type@ @try_prefix_maybe@@async_prefix_maybe@@handler_name@()~~~");
  385. for (size_t i = 0; i < parameters.size(); ++i) {
  386. auto const& parameter = parameters[i];
  387. auto argument_generator = message_generator.fork();
  388. argument_generator.set("argument.type", parameter.type);
  389. argument_generator.set("argument.name", parameter.name);
  390. argument_generator.append("@argument.type@ @argument.name@");
  391. if (i != parameters.size() - 1)
  392. argument_generator.append(", ");
  393. }
  394. message_generator.append(") {");
  395. if (is_synchronous && !is_try) {
  396. if (return_type != "void") {
  397. message_generator.append(R"~~~(
  398. return )~~~");
  399. if (message.outputs.size() != 1)
  400. message_generator.append("move(*");
  401. } else {
  402. message_generator.append(R"~~~(
  403. (void) )~~~");
  404. }
  405. message_generator.append("m_connection.template send_sync<Messages::@endpoint.name@::@message.pascal_name@>(");
  406. } else if (is_try) {
  407. message_generator.append(R"~~~(
  408. auto result = m_connection.template send_sync_but_allow_failure<Messages::@endpoint.name@::@message.pascal_name@>()~~~");
  409. } else {
  410. message_generator.append(R"~~~(
  411. // FIXME: Handle post_message failures.
  412. (void) m_connection.post_message(Messages::@endpoint.name@::@message.pascal_name@ { )~~~");
  413. }
  414. for (size_t i = 0; i < parameters.size(); ++i) {
  415. auto const& parameter = parameters[i];
  416. auto argument_generator = message_generator.fork();
  417. argument_generator.set("argument.name", parameter.name);
  418. if (is_primitive_or_simple_type(parameters[i].type))
  419. argument_generator.append("@argument.name@");
  420. else
  421. argument_generator.append("move(@argument.name@)");
  422. if (i != parameters.size() - 1)
  423. argument_generator.append(", ");
  424. }
  425. if (is_synchronous && !is_try) {
  426. if (return_type != "void") {
  427. message_generator.append(")");
  428. }
  429. if (message.outputs.size() == 1) {
  430. message_generator.append("->take_");
  431. message_generator.append(message.outputs[0].name);
  432. message_generator.append("()");
  433. } else
  434. message_generator.append(")");
  435. message_generator.append(";");
  436. } else if (is_try) {
  437. message_generator.append(R"~~~();
  438. if (!result)
  439. return IPC::ErrorCode::PeerDisconnected;)~~~");
  440. if (inner_return_type != "void") {
  441. message_generator.appendln(R"~~~(
  442. return move(*result);)~~~");
  443. } else {
  444. message_generator.appendln(R"~~~(
  445. return { };)~~~");
  446. }
  447. } else {
  448. message_generator.appendln(" });");
  449. }
  450. message_generator.appendln(R"~~~(
  451. })~~~");
  452. };
  453. do_implement_proxy(message.name, message.inputs, message.is_synchronous, false);
  454. if (message.is_synchronous) {
  455. do_implement_proxy(message.name, message.inputs, false, false);
  456. do_implement_proxy(message.name, message.inputs, true, true);
  457. }
  458. }
  459. void build_endpoint(SourceGenerator generator, Endpoint const& endpoint)
  460. {
  461. generator.set("endpoint.name", endpoint.name);
  462. generator.set("endpoint.magic", DeprecatedString::number(endpoint.magic));
  463. generator.appendln("\nnamespace Messages::@endpoint.name@ {");
  464. HashMap<DeprecatedString, int> message_ids = build_message_ids_for_endpoint(generator.fork(), endpoint);
  465. for (auto const& message : endpoint.messages) {
  466. DeprecatedString response_name;
  467. if (message.is_synchronous) {
  468. response_name = message.response_name();
  469. do_message(generator.fork(), response_name, message.outputs);
  470. }
  471. do_message(generator.fork(), message.name, message.inputs, response_name);
  472. }
  473. generator.appendln(R"~~~(
  474. } // namespace Messages::@endpoint.name@
  475. template<typename LocalEndpoint, typename PeerEndpoint>
  476. class @endpoint.name@Proxy {
  477. public:
  478. // Used to disambiguate the constructor call.
  479. struct Tag { };
  480. @endpoint.name@Proxy(IPC::Connection<LocalEndpoint, PeerEndpoint>& connection, Tag)
  481. : m_connection(connection)
  482. { })~~~");
  483. for (auto const& message : endpoint.messages)
  484. do_message_for_proxy(generator.fork(), endpoint, message);
  485. generator.appendln(R"~~~(
  486. private:
  487. IPC::Connection<LocalEndpoint, PeerEndpoint>& m_connection;
  488. };)~~~");
  489. generator.append(R"~~~(
  490. template<typename LocalEndpoint, typename PeerEndpoint>
  491. class @endpoint.name@Proxy;
  492. class @endpoint.name@Stub;
  493. class @endpoint.name@Endpoint {
  494. public:
  495. template<typename LocalEndpoint>
  496. using Proxy = @endpoint.name@Proxy<LocalEndpoint, @endpoint.name@Endpoint>;
  497. using Stub = @endpoint.name@Stub;
  498. static u32 static_magic() { return @endpoint.magic@; }
  499. static ErrorOr<NonnullOwnPtr<IPC::Message>> decode_message(ReadonlyBytes buffer, [[maybe_unused]] Core::Stream::LocalSocket& socket)
  500. {
  501. auto stream = TRY(Core::Stream::FixedMemoryStream::construct(buffer));
  502. auto message_endpoint_magic = TRY(stream->read_value<u32>());)~~~");
  503. generator.append(R"~~~(
  504. if (message_endpoint_magic != @endpoint.magic@) {)~~~");
  505. if constexpr (GENERATE_DEBUG) {
  506. generator.append(R"~~~(
  507. dbgln("@endpoint.name@: Endpoint magic number message_endpoint_magic != @endpoint.magic@, not my message! (the other endpoint may have handled it)");)~~~");
  508. }
  509. generator.appendln(R"~~~(
  510. return Error::from_string_literal("Endpoint magic number mismatch, not my message!");
  511. }
  512. auto message_id = TRY(stream->read_value<i32>());)~~~");
  513. generator.appendln(R"~~~(
  514. switch (message_id) {)~~~");
  515. for (auto const& message : endpoint.messages) {
  516. auto do_decode_message = [&](DeprecatedString const& name) {
  517. auto message_generator = generator.fork();
  518. message_generator.set("message.name", name);
  519. message_generator.set("message.pascal_name", pascal_case(name));
  520. message_generator.append(R"~~~(
  521. case (int)Messages::@endpoint.name@::MessageID::@message.pascal_name@:
  522. return TRY(Messages::@endpoint.name@::@message.pascal_name@::decode(*stream, socket));)~~~");
  523. };
  524. do_decode_message(message.name);
  525. if (message.is_synchronous)
  526. do_decode_message(message.response_name());
  527. }
  528. generator.append(R"~~~(
  529. default:)~~~");
  530. if constexpr (GENERATE_DEBUG) {
  531. generator.append(R"~~~(
  532. dbgln("Failed to decode @endpoint.name@.({})", message_id);)~~~");
  533. }
  534. generator.appendln(R"~~~(
  535. return Error::from_string_literal("Failed to decode @endpoint.name@ message");
  536. })~~~");
  537. generator.appendln(R"~~~(
  538. VERIFY_NOT_REACHED();
  539. }
  540. };
  541. class @endpoint.name@Stub : public IPC::Stub {
  542. public:
  543. @endpoint.name@Stub() { }
  544. virtual ~@endpoint.name@Stub() override { }
  545. virtual u32 magic() const override { return @endpoint.magic@; }
  546. virtual DeprecatedString name() const override { return "@endpoint.name@"; }
  547. virtual ErrorOr<OwnPtr<IPC::MessageBuffer>> handle(const IPC::Message& message) override
  548. {
  549. switch (message.message_id()) {)~~~");
  550. for (auto const& message : endpoint.messages) {
  551. auto do_handle_message = [&](DeprecatedString const& name, Vector<Parameter> const& parameters, bool returns_something) {
  552. auto message_generator = generator.fork();
  553. StringBuilder argument_generator;
  554. for (size_t i = 0; i < parameters.size(); ++i) {
  555. auto const& parameter = parameters[i];
  556. argument_generator.append("request."sv);
  557. argument_generator.append(parameter.name);
  558. argument_generator.append("()"sv);
  559. if (i != parameters.size() - 1)
  560. argument_generator.append(", "sv);
  561. }
  562. message_generator.set("message.pascal_name", pascal_case(name));
  563. message_generator.set("message.response_type", pascal_case(message.response_name()));
  564. message_generator.set("handler_name", name);
  565. message_generator.set("arguments", argument_generator.to_deprecated_string());
  566. message_generator.appendln(R"~~~(
  567. case (int)Messages::@endpoint.name@::MessageID::@message.pascal_name@: {)~~~");
  568. if (returns_something) {
  569. if (message.outputs.is_empty()) {
  570. message_generator.appendln(R"~~~(
  571. [[maybe_unused]] auto& request = static_cast<const Messages::@endpoint.name@::@message.pascal_name@&>(message);
  572. @handler_name@(@arguments@);
  573. auto response = Messages::@endpoint.name@::@message.response_type@ { };
  574. return make<IPC::MessageBuffer>(TRY(response.encode()));)~~~");
  575. } else {
  576. message_generator.appendln(R"~~~(
  577. [[maybe_unused]] auto& request = static_cast<const Messages::@endpoint.name@::@message.pascal_name@&>(message);
  578. auto response = @handler_name@(@arguments@);
  579. if (!response.valid())
  580. return Error::from_string_literal("Failed to handle @endpoint.name@::@message.pascal_name@ message");
  581. return make<IPC::MessageBuffer>(TRY(response.encode()));)~~~");
  582. }
  583. } else {
  584. message_generator.appendln(R"~~~(
  585. [[maybe_unused]] auto& request = static_cast<const Messages::@endpoint.name@::@message.pascal_name@&>(message);
  586. @handler_name@(@arguments@);
  587. return nullptr;)~~~");
  588. }
  589. message_generator.appendln(R"~~~(
  590. })~~~");
  591. };
  592. do_handle_message(message.name, message.inputs, message.is_synchronous);
  593. }
  594. generator.appendln(R"~~~(
  595. default:
  596. return Error::from_string_literal("Unknown message ID for @endpoint.name@ endpoint");
  597. }
  598. })~~~");
  599. for (auto const& message : endpoint.messages) {
  600. auto message_generator = generator.fork();
  601. auto do_handle_message_decl = [&](DeprecatedString const& name, Vector<Parameter> const& parameters, bool is_response) {
  602. DeprecatedString return_type = "void";
  603. if (message.is_synchronous && !message.outputs.is_empty() && !is_response)
  604. return_type = message_name(endpoint.name, message.name, true);
  605. message_generator.set("message.complex_return_type", return_type);
  606. message_generator.set("handler_name", name);
  607. message_generator.appendln(R"~~~(
  608. virtual @message.complex_return_type@ @handler_name@()~~~");
  609. auto make_argument_type = [](DeprecatedString const& type) {
  610. StringBuilder builder;
  611. bool const_ref = !is_primitive_or_simple_type(type);
  612. builder.append(type);
  613. if (const_ref)
  614. builder.append(" const&"sv);
  615. return builder.to_deprecated_string();
  616. };
  617. for (size_t i = 0; i < parameters.size(); ++i) {
  618. auto const& parameter = parameters[i];
  619. auto argument_generator = message_generator.fork();
  620. argument_generator.set("argument.type", make_argument_type(parameter.type));
  621. argument_generator.set("argument.name", parameter.name);
  622. argument_generator.append("[[maybe_unused]] @argument.type@ @argument.name@");
  623. if (i != parameters.size() - 1)
  624. argument_generator.append(", ");
  625. }
  626. if (is_response) {
  627. message_generator.append(") { };");
  628. } else {
  629. message_generator.appendln(") = 0;");
  630. }
  631. };
  632. do_handle_message_decl(message.name, message.inputs, false);
  633. }
  634. generator.appendln(R"~~~(
  635. private:
  636. };
  637. #if defined(AK_COMPILER_CLANG)
  638. #pragma clang diagnostic pop
  639. #endif)~~~");
  640. }
  641. void build(StringBuilder& builder, Vector<Endpoint> const& endpoints)
  642. {
  643. SourceGenerator generator { builder };
  644. generator.appendln("#pragma once");
  645. // This must occur before LibIPC/Decoder.h
  646. for (auto const& endpoint : endpoints) {
  647. for (auto const& include : endpoint.includes) {
  648. generator.appendln(include);
  649. }
  650. }
  651. generator.appendln(R"~~~(#include <AK/Error.h>
  652. #include <AK/OwnPtr.h>
  653. #include <AK/Result.h>
  654. #include <AK/Utf8View.h>
  655. #include <LibCore/MemoryStream.h>
  656. #include <LibIPC/Connection.h>
  657. #include <LibIPC/Decoder.h>
  658. #include <LibIPC/Dictionary.h>
  659. #include <LibIPC/Encoder.h>
  660. #include <LibIPC/File.h>
  661. #include <LibIPC/Message.h>
  662. #include <LibIPC/Stub.h>
  663. #if defined(AK_COMPILER_CLANG)
  664. #pragma clang diagnostic push
  665. #pragma clang diagnostic ignored "-Wdefaulted-function-deleted"
  666. #endif)~~~");
  667. for (auto const& endpoint : endpoints)
  668. build_endpoint(generator.fork(), endpoint);
  669. }
  670. ErrorOr<int> serenity_main(Main::Arguments arguments)
  671. {
  672. if (arguments.argc != 2) {
  673. outln("usage: {} <IPC endpoint definition file>", arguments.strings[0]);
  674. return 1;
  675. }
  676. auto file = TRY(Core::Stream::File::open(arguments.strings[1], Core::Stream::OpenMode::Read));
  677. auto file_contents = TRY(file->read_until_eof());
  678. auto endpoints = parse(file_contents);
  679. StringBuilder builder;
  680. build(builder, endpoints);
  681. outln("{}", builder.string_view());
  682. if constexpr (GENERATE_DEBUG) {
  683. for (auto& endpoint : endpoints) {
  684. warnln("Endpoint '{}' (magic: {})", endpoint.name, endpoint.magic);
  685. for (auto& message : endpoint.messages) {
  686. warnln(" Message: '{}'", message.name);
  687. warnln(" Sync: {}", message.is_synchronous);
  688. warnln(" Inputs:");
  689. for (auto& parameter : message.inputs)
  690. warnln(" Parameter: {} ({})", parameter.name, parameter.type);
  691. if (message.inputs.is_empty())
  692. warnln(" (none)");
  693. if (message.is_synchronous) {
  694. warnln(" Outputs:");
  695. for (auto& parameter : message.outputs)
  696. warnln(" Parameter: {} ({})", parameter.name, parameter.type);
  697. if (message.outputs.is_empty())
  698. warnln(" (none)");
  699. }
  700. }
  701. }
  702. }
  703. return 0;
  704. }