• 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    迪恩网络公众号

graphql/libgraphqlparser: A GraphQL query parser in C++ with C and C++ APIs

原作者: [db:作者] 来自: 网络 收藏 邀请

开源软件名称(OpenSource Name):

graphql/libgraphqlparser

开源软件地址(OpenSource Url):

https://github.com/graphql/libgraphqlparser

开源编程语言(OpenSource Language):

C++ 83.9%

开源软件介绍(OpenSource Introduction):

libgraphqlparser

libgraphqlparser is a parser for GraphQL, a query language for describing data requirements on complex application data models, implemented in C++11. It can be used on its own in C++ code (or in C code via the pure C API defined in the c subdirectory), or you can use it as the basis for an extension module for your favorite programming language instead of writing your own parser from scratch.

Example

The provided dump_json_ast is a simple program that reads GraphQL text on stdin and prints a JSON representation of the AST to stdout.

The python subdirectory contains an example Python binding for the pure C API.

Requirements

libgraphqlparser requires a C++ compiler that supports C++11. It also requires Mac OS X or Linux.

To run tests, first, compile and install the library as described above. Then, please download googletest from https://github.com/google/googletest/archive/release-1.8.0.zip and unzip it in the test subdirectory. In consequence, a folder googletest-release-1.8.0 should be contained in test. Next, within the test folder, run cmake . and make to generate the runTests binary. To execute the tests run ./test/runTests from the main folder.

Building libgraphqlparser

libgraphqlparser is built with CMake. If a sufficiently-recent version of Flex and Bison are installed on your system, it will use them; otherwise, it will rely on the checked-in parser.tab.{c,h}pp and lexer.{h,cpp}.

To build libgraphqlparser from source:

$ # inside the project root:
$ cmake .
$ make

Then, to install it on your system:

$ make install

How libgraphqlparser works

libgraphqlparser uses flex and bison to generate a C++ parser for GraphQL. These tools work well but have idiosyncratic interfaces by modern standards, so GraphQLParser.h provides a simple interface to parse GraphQL.

In order to make it simpler to write code based around the GraphQL AST, libgraphqlparser includes an extremely simple code generation framework in the ast/ subdirectory. This framework is used to build the AST classes themselves, as well as a visitor over the AST. It may be easier to understand the output of the generation steps directly (i.e., Ast.h, Ast.cpp, and AstVisitor.h) rather than trying to read the generation scripts. Simply building libgraphqlparser will cause these files to be generated.

libgraphqlparser also uses the AST generation framework to build a pure C API in the c subdirectory. This API can be used from C code, and it should also simplify the task of creating bindings to other programming languages.

License

libgraphqlparser is MIT-licensed.

Related Projects

Contributing to this repo

This repository is managed by EasyCLA. Project participants must sign the free (GraphQL Specification Membership agreement before making a contribution. You only need to do this one time, and it can be signed by individual contributors or their employers.

To initiate the signature process please open a PR against this repo. The EasyCLA bot will block the merge if we still need a membership agreement from you.

You can find detailed information here. If you have issues, please email [email protected].

If your company benefits from GraphQL and you would like to provide essential financial support for the systems and people that power our community, please also consider membership in the GraphQL Foundation.




鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
上一篇:
Shopify/shopify-api-node: Shopify Admin API Library for Node. Accelerate develop ...发布时间:2022-07-10
下一篇:
nfl/graphql-rxjava: GraphQL RxJava发布时间:2022-07-10
热门推荐
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap