eolian_cxx: initial version of the EFL C++ Bindings Generator.

Summary:
This patch adds 'eolian_cxx' -- a C++ bindings generator --
to the EFL tree. Eolian Cxx uses Eolian API to read .eo files and generate
.eo.hh. It relies/depends on Eo Cxx and Eina Cxx (both non-generated
bindings).

src/bin/eolian_cxx: The eolian_cxx program.
src/lib/eolian_cxx: A header-only library that implements the C++ code
generation that binds the .eo classes.

=Examples=

src/examples/eolian_cxx/eolian_cxx_simple_01.cc: The simplest example,
it just uses some "dummy" generated C++ classes.

src/examples/eolian_cxx/eolian_cxx_inherit_01.cc: Illustrates how
pure C++ classes inherit from .eo generated classes.

src/examples/evas/evas_cxx_rectangle.cc: More realistic example using
the generated bindings Evas Cxx. Still a bit shallow because we don't
have full fledged .eo descriptions yet, but will be improved.

=Important=

The generated code is not supported and not a stable API/ABI. It is
here to gather people interest and get review before we set things in
stone for release 1.11.

@feature

Reviewers: cedric, smohanty, raster, stefan_schmidt

CC: felipealmeida, JackDanielZ, cedric, stefan

Differential Revision: https://phab.enlightenment.org/D805

Signed-off-by: Cedric Bail <cedric.bail@free.fr>

1 files changed, 110 insertions, 0 deletions

diff --git a/src/bin/eolian_cxx/comments.cc b/src/bin/eolian_cxx/comments.cc
new file mode 100644
index 0000000000..afe725f300
--- /dev/null
+++ b/src/bin/eolian_cxx/comments.cc
@@ -0,0 +1,110 @@
+
+#include "comments.hh"
+#include "safe_strings.hh"
+
+static std::string
+_comment_parameter(Eolian_Function_Parameter param)
+{
+   Eolian_Parameter_Dir direction;
+   Eina_Stringshare *description;
+
+   eolian_parameter_information_get
+     (param, &direction, NULL, NULL, &description);
+
+   std::string doc = "@param";
+   if (direction == EOLIAN_IN_PARAM) doc += " ";
+   else if (direction == EOLIAN_OUT_PARAM) doc += "[out] ";
+   else if (direction == EOLIAN_INOUT_PARAM) doc += "[inout] ";
+   else assert(false);
+
+   doc += safe_strshare(eolian_parameter_name_get(param));
+   doc += " ";
+   doc += safe_str(description);
+
+   return doc;
+}
+
+static std::string
+_comment_parameters_list(const Eina_List *params)
+{
+   std::string doc = "";
+   const Eina_List *it;
+   void *curr;
+   EINA_LIST_FOREACH (params, it, curr)
+     {
+        doc += _comment_parameter
+          (static_cast<Eolian_Function_Parameter>(curr)) + "\n";
+     }
+   return doc;
+}
+
+static std::string
+_comment_brief_and_params(Eolian_Function function,
+                          const char *key = EOLIAN_COMMENT)
+{
+   std::string doc = "";
+   std::string func = safe_str(eolian_function_description_get(function, key));
+   if (func != "")
+     {
+        doc += "@brief " + func + "\n\n";
+     }
+   std::string params = _comment_parameters_list(eolian_parameters_list_get(function));
+   if (params != "")
+     {
+        doc += params + "\n";
+     }
+   return doc;
+}
+
+static std::string
+_comment_return(Eolian_Function function,
+                Eolian_Function_Type rettype)
+{
+   std::string doc = "";
+   std::string ret = safe_str(eolian_function_return_type_get(function, rettype));
+   std::string comment = safe_str(eolian_function_return_comment_get(function, rettype));
+   if (ret != "void" && ret != "" && comment != "")
+     {
+        doc = "@return " + comment;
+     }
+   return doc;
+}
+
+namespace detail {
+
+std::string
+eolian_class_comment(const char *classname)
+{
+   return safe_str(eolian_class_description_get(classname));
+}
+
+std::string
+eolian_constructor_comment(Eolian_Function constructor)
+{
+   return _comment_brief_and_params(constructor);
+}
+
+std::string eolian_function_comment(Eolian_Function function)
+{
+   std::string doc = _comment_brief_and_params(function);
+   doc += _comment_return(function, EOLIAN_METHOD);
+   return doc;
+}
+
+std::string eolian_property_getter_comment(Eolian_Function property)
+{
+   std::string doc = _comment_brief_and_params
+     (property, EOLIAN_COMMENT_GET);
+   doc += _comment_return(property, EOLIAN_PROP_GET);
+   return doc;
+}
+
+std::string eolian_property_setter_comment(Eolian_Function property)
+{
+   std::string doc = _comment_brief_and_params
+     (property, EOLIAN_COMMENT_SET);
+   doc += _comment_return(property, EOLIAN_PROP_SET);
+   return doc;
+}
+
+} // namespace detail