[ADD] graphql_base and graphql_demo

Author: sbidoul

graphql_base/README.rst

@@ -0,0 +1 @@
+this file will be generated after merging

graphql_base/__init__.py

@@ -0,0 +1,5 @@
+# Copyright 2018 ACSONE SA/NV
+# License LGPL-3.0 or later (http://www.gnu.org/licenses/lgpl).
+
+from .controllers import GraphQLControllerMixin
+from .types import OdooObjectType

graphql_base/__manifest__.py

@@ -0,0 +1,15 @@
+# Copyright 2018 ACSONE SA/NV
+# License LGPL-3.0 or later (http://www.gnu.org/licenses/lgpl).
+
+{
+    "name": "Graphql Base",
+    "summary": """
+        Base GraphQL/GraphiQL controller""",
+    "version": "12.0.1.0.0",
+    "license": "LGPL-3",
+    "author": "ACSONE SA/NV,Odoo Community Association (OCA)",
+    "website": "https://github.com/OCA/rest-framework",
+    "depends": ["base"],
+    "data": ["views/graphiql.xml"],
+    "external_dependencies": {"python": ["graphene", "graphql_server"]},
+}

graphql_base/controllers/__init__.py

@@ -0,0 +1 @@
+from .main import GraphQLControllerMixin

graphql_base/controllers/main.py

@@ -0,0 +1,84 @@
+# Copyright 2018 ACSONE SA/NV
+# License LGPL-3.0 or later (http://www.gnu.org/licenses/lgpl).
+
+import re
+from functools import partial
+
+from graphql_server import (
+    default_format_error,
+    encode_execution_results,
+    json_encode,
+    load_json_body,
+    run_http_query,
+)
+
+from odoo import http
+
+
+class GraphQLControllerMixin(object):
+    @staticmethod
+    def patch_for_json(path_re):
+        # this is to avoid Odoo, which assumes json always means json+rpc,
+        # complaining about "function declared as capable of handling request
+        # of type 'http' but called with a request of type 'json'"
+        path_re = re.compile(path_re)
+        orig_get_request = http.Root.get_request
+
+        def get_request(self, httprequest):
+            if path_re.match(httprequest.path):
+                return http.HttpRequest(httprequest)
+            return orig_get_request(self, httprequest)
+
+        http.Root.get_request = get_request
+
+    def _parse_body(self):
+        req = http.request.httprequest
+        # We use mimetype here since we don't need the other
+        # information provided by content_type
+        content_type = req.mimetype
+        if content_type == "application/graphql":
+            return {"query": req.data.decode("utf8")}
+        elif content_type == "application/json":
+            return load_json_body(req.data.decode("utf8"))
+        elif content_type in (
+            "application/x-www-form-urlencoded",
+            "multipart/form-data",
+        ):
+            return http.request.params
+        return {}
+
+    def _process_request(self, schema, data, catch):
+        request = http.request.httprequest
+        execution_results, all_params = run_http_query(
+            schema,
+            request.method.lower(),
+            data,
+            query_data=request.args,
+            batch_enabled=False,
+            catch=catch,
+            context={"env": http.request.env},
+        )
+        result, status_code = encode_execution_results(
+            execution_results,
+            is_batch=isinstance(data, list),
+            format_error=default_format_error,
+            encode=partial(json_encode, pretty=False),
+        )
+        # TODO what to do with status_code?
+        return http.request.make_response(
+            result, headers={"Content-Type": "application/json"}
+        )
+
+    def _handle_graphql_request(self, schema):
+        data = self._parse_body()
+        return self._process_request(schema, data, catch=False)
+
+    def _handle_graphiql_request(self, schema):
+        req = http.request.httprequest
+        if req.method == "GET" and req.accept_mimetypes.accept_html:
+            return http.request.render("graphql_base.graphiql", {})
+        # this way of passing a GraphQL query over http is not spec compliant
+        # (https://graphql.org/learn/serving-over-http/), but we use
+        # this only for our GraphiQL UI, and it works with Odoo's way
+        # of passing the csrf token
+        return self._process_request(schema, http.request.params, catch=True)

graphql_base/i18n/graphql_base.pot

@@ -0,0 +1,14 @@
+# Translation of Odoo Server.
+# This file contains the translation of the following modules:
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: Odoo Server 12.0+e\n"
+"Report-Msgid-Bugs-To: \n"
+"Last-Translator: <>\n"
+"Language-Team: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: \n"
+"Plural-Forms: \n"
+

graphql_base/readme/DESCRIPTION.rst

@@ -0,0 +1,6 @@
+This modules enables the creation of `GraphQL <https://graphql.org/>`_ endpoints.
+In itself, it does nothing and must be used by a developer to
+create the GraphQL schema and resolvers using
+`graphene <https://graphene-python.org/>`_,
+and expose them through a controller.
+An example is available in the ``graphql_demo`` module.

graphql_base/readme/USAGE.rst

@@ -0,0 +1,11 @@
+To use this module, you need to
+
+- create your graphene schema
+- create your controller to expose your GraphQL endpoint,
+  and optionally a GraphiQL UI.
+
+This module does not attempt to expose the whole Odoo object model.
+This could be the purpose of another module based on this one.
+We believe however that it is preferable to expose a specific well tested
+endpoint for each customer, so as to reduce coupling by knowing precisely
+what is exposed and needs to be tested when upgrading Odoo.

graphql_base/static/description/icon.png

@@ -0,0 +1,43 @@
+# Copyright 2018 ACSONE SA/NV
+# License LGPL-3.0 or later (http://www.gnu.org/licenses/lgpl).
+
+import graphene
+
+from odoo import fields
+
+
+def odoo_attr_resolver(attname, default_value, root, info, **args):
+    """An attr resolver that is specialized for Odoo recordsets.
+
+    It converts False to None, except for Odoo Boolean fields.
+    This is necessary because Odoo null values are often represented
+    as False, and graphene would convert a String field with value False
+    to "false".
+
+    It converts datetimes to the user timezone.
+
+    It also raises an error if the attribute is not present, ignoring
+    any default value, so as to return if the schema declares a field
+    that is not present in the underlying Odoo model.
+    """
+    value = getattr(root, attname)
+    field = root._fields.get(attname)
+    if value is False:
+        if not isinstance(field, fields.Boolean):
+            return None
+    elif isinstance(field, fields.Datetime):
+        return fields.Datetime.context_timestamp(root, value)
+    return value
+
+
+class OdooObjectType(graphene.ObjectType):
+    """A graphene ObjectType with an Odoo aware default resolver."""
+
+    @classmethod
+    def __init_subclass_with_meta__(cls, default_resolver=None, **options):
+        if default_resolver is None:
+            default_resolver = odoo_attr_resolver
+
+        return super(OdooObjectType, cls).__init_subclass_with_meta__(
+            default_resolver=default_resolver, **options
+        )