Initial commit

Author: Marco Paolini

.gitignore

@@ -0,0 +1,8 @@
+__pycache__
+*.pyc
+*~
+*.c
+/build/
+/.wheelhouse/
+/.python-version
+

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "libgraphqlparser"]
+	path = libgraphqlparser
+	url = git@github.com:graphql/libgraphqlparser.git

LICENSE

@@ -0,0 +1,30 @@
+BSD License
+
+For py-grahpqlparser software
+
+Copyright (c) 2015-present, Elastic Coders, Srls All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+ * Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+ * Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+ * Neither the name Facebook nor the names of its contributors may be used to
+   endorse or promote products derived from this software without specific
+   prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

README.md

@@ -0,0 +1,36 @@
+# libgraphql cython port
+
+Python2.7+ (includes python3) class-based bindings to libgraphql
+
+See usage example in `examples/visitor_example.py`
+
+This bindings are still experimental.
+
+
+## Building from source
+
+- download submodules with `git checkout --recursive`
+- build libgraphql library in folder `./libgraphql` (python2.7 required for building)
+(usually `pushd libgraphqlparser && cmake . && make && popd` works)
+- generate source code with `python ast/build_ast.py`
+- you can now switch to python 3
+- install `cython`
+- run `LDFLAGS="-L./libgraphqlparser" CFLAGS="-Ilibgraphqlparser/c -Ilibgraphqlparser" python setup.py build_ext`
+
+To package with wheel:
+- install wheel
+- create wheelhouse `mkdir .wheelhouse`
+- build with `pip wheel --wheel-dir=.wheelhouse .`
+
+
+## Run
+
+Make sure `libgraphql` is available to the loader in your `LD_LIBRARY_PATH`
+
+
+## Known issues
+
+- Only (lightly) tested on python3
+- Unicode string handling not yet complete (a mixture of bytes and strings all over)
+- Exceptions in the visitor's class callbacks are ignored
+- libgraphqlparser is **dynamically** linked but It would be better if it was linked statically

ast/ast_cython.py

@@ -0,0 +1,61 @@
+# Copyright (c) 2015, Facebook, Inc.
+# All rights reserved.
+#
+# This source code is licensed under the BSD-style license found in the
+# LICENSE file in the root directory of this source tree. An additional grant
+# of patent rights can be found in the PATENTS file in the same directory.
+
+from casing import snake
+import re
+import ast_cython_c
+
+CMODULE_NAME = 'GraphQLAst'
+
+
+class Printer(object):
+  '''Printer for the Ast Python Object level cython interface.
+
+  '''
+  def start_file(self):
+    print ast_cython_c.license_comment() + '''
+
+cimport %s
+
+
+cdef class GraphQLAst:
+    """Base class for all Ast pieces"""
+    pass
+
+''' % ast_cython_c.CMODULE_NAME
+
+  def end_file(self):
+    pass
+
+  def start_type(self, name):
+    st_name = ast_cython_c.struct_name(name)
+    print '''
+cdef class %(name)s(GraphQLAst):
+
+    cdef %(cmodule)s.%(name)s* _wrapped
+
+    @staticmethod
+    cdef create(cGraphQLAst.%(name)s *thing)
+
+''' % {'name': st_name, 'cmodule': ast_cython_c.CMODULE_NAME}
+    self._current_type = name
+
+  def field(self, type, name, nullable, plural):
+    pass
+
+  def end_type(self, name):
+    print
+    print
+
+  def start_union(self, name):
+    pass
+
+  def union_option(self, option):
+    pass
+
+  def end_union(self, name):
+    print

ast/ast_cython_c.py

@@ -0,0 +1,83 @@
+# Copyright (c) 2015, Facebook, Inc.
+# All rights reserved.
+#
+# This source code is licensed under the BSD-style license found in the
+# LICENSE file in the root directory of this source tree. An additional grant
+# of patent rights can be found in the PATENTS file in the same directory.
+
+from casing import snake
+import re
+import ast_cython
+from license import C_LICENSE_COMMENT
+
+CMODULE_NAME = 'cGraphQLAst'
+
+
+def struct_name(type):
+  return 'GraphQLAst' + type
+
+
+def return_type(type):
+  if type == 'OperationKind' or type == 'string':
+    return 'const char *'
+
+  if type == 'boolean':
+    return 'int'
+
+  return 'const %s *' % struct_name(type)
+
+
+def field_prototype(owning_type, type, name, nullable, plural):
+  st_name = struct_name(owning_type)
+  if plural:
+    return 'int %s_get_%s_size(const %s *node)' % (
+      st_name, snake(name), st_name)
+  else:
+    ret_type = return_type(type)
+    return '%s %s_get_%s(const %s *node)' % (
+      ret_type, st_name, snake(name), st_name)
+
+
+def license_comment():
+  return re.sub(re.compile(r'^[ ]*', re.MULTILINE), '#', C_LICENSE_COMMENT) + '# @generated'
+
+
+class Printer(object):
+  '''Printer for the Ast low-level C cython interface.
+
+  '''
+  def start_file(self):
+    print license_comment() + '''
+
+cdef extern from "GraphQLAst.h":
+
+'''
+
+  def end_file(self):
+    pass
+
+  def start_type(self, name):
+    # Forward declarations for AST nodes.
+    st_name = struct_name(name)
+    print '    struct ' + st_name + ':'
+    print '        pass'
+    self._current_type = name
+    self._current_type_fields = []
+
+  def field(self, type, name, nullable, plural):
+    self._current_type_fields.append((type, name, nullable, plural))
+    print '    ' + field_prototype(self._current_type, type, name, nullable, plural)
+
+  def end_type(self, name):
+    print
+    print
+
+  def start_union(self, name):
+    print '    struct ' + struct_name(name) + ':'
+    print '        pass'
+
+  def union_option(self, option):
+    pass
+
+  def end_union(self, name):
+    print

ast/ast_cython_impl.py

@@ -0,0 +1,116 @@
+# Copyright (c) 2015, Facebook, Inc.
+# All rights reserved.
+#
+# This source code is licensed under the BSD-style license found in the
+# LICENSE file in the root directory of this source tree. An additional grant
+# of patent rights can be found in the PATENTS file in the same directory.
+
+from casing import snake
+import ast_cython_c
+import ast_cython
+
+SIMPLE_RETURN_CASTS = {
+  'boolean': 'bool',
+  'int': '',
+  'string': '',  # XXX decode?
+  'OperationKind': ''
+}
+
+SOURCE_TYPE_CASTS = {
+  'IntValue': 'int',
+  'FloatValue': 'float',
+  'StringValue': '',  # XXX decode?
+  'BooleanValue': 'bool',
+  'EnumValue': ''  # XXX decode?
+}
+
+def field_prototype(owning_type, type, name, nullable, plural):
+  _map = {'cmodule': ast_cython_c.CMODULE_NAME,
+          'owning_st': ast_cython_c.struct_name(owning_type),
+          'snake': snake(name),
+          'return_st': ast_cython_c.struct_name(type)}
+  if plural:
+    return '''
+    def get_%(snake)s_size(self):
+        return int(%(cmodule)s.%(owning_st)s_get_%(snake)s_size(self._wrapped))
+''' % _map
+  if type in SIMPLE_RETURN_CASTS:
+    # TODO: convert string to unicode
+    if owning_type in SOURCE_TYPE_CASTS:
+      _map['cast'] = SOURCE_TYPE_CASTS[owning_type]
+    else:
+      _map['cast'] = SIMPLE_RETURN_CASTS[type]
+    return '''
+    def get_%(snake)s(self):
+        val = %(cmodule)s.%(owning_st)s_get_%(snake)s(self._wrapped)
+        if val is None:
+            return None
+        return %(cast)s(val)
+''' % _map
+  elif type in ['Type', 'Value']:
+    # XXX this types have no functions...
+    return '''
+'''
+  else:
+    # python object return type
+    return '''
+    def get_%(snake)s(self):
+        cdef %(cmodule)s.%(return_st)s *next
+        next = %(cmodule)s.%(owning_st)s_get_%(snake)s(self._wrapped)
+        if next is NULL:
+           return None
+        return %(return_st)s.create(next)
+''' % _map
+
+class Printer(object):
+  '''Printer for a visitor in cython
+  '''
+
+  def __init__(self):
+    self._types = []
+
+  def start_file(self):
+    print ast_cython_c.license_comment() + '''
+
+cimport %s
+
+cdef class GraphQLAst:
+    """Base class for all Ast pieces"""
+    pass
+
+''' % ast_cython_c.CMODULE_NAME
+
+  def start_type(self, name):
+    self._current_type = name
+    _map = {'snake': snake(name), 'name': name}
+    print '''
+
+cdef class %(name)s(GraphQLAst):
+
+    @staticmethod
+    cdef create(%(cmodule)s.%(name)s *thing):
+        node = %(name)s()
+        node._wrapped = thing
+        return node
+
+''' % {'name': ast_cython_c.struct_name(name),
+       'cmodule': ast_cython_c.CMODULE_NAME}
+
+  def field(self, type, name, nullable, plural):
+    print field_prototype(self._current_type, type, name, nullable, plural)
+
+  def end_type(self, name):
+    print
+    print
+
+  def end_file(self):
+    pass
+
+  def start_union(self, name):
+    pass
+
+  def union_option(self, option):
+    pass
+
+  def end_union(self, name):
+    pass