up to date 20180702 (xitu#91)

Author: ydfzgyj

site/CNAME

@@ -42,6 +42,7 @@ GraphQL 已有多种编程语言支持。下表包含一些流行的服务端框
 
   - [graphql-dotnet](https://github.com/graphql-dotnet/graphql-dotnet)：.NET 的 GraphQL 实现
   - [graphql-net](https://github.com/ckimes89/graphql-net)：转换 GraphQL 到 IQueryable
+  - [Hot Chocolate](https://github.com/ChilliCream/hotchocolate)：针对 .net core 和 .net classic 的 GraphQL 服务
 
 ### Clojure
 
@@ -111,17 +112,19 @@ $ curl -XPOST "http://0:3000" -H'Content-Type: application/json' -d'{
 ### Elixir
 
   - [absinthe](https://github.com/absinthe-graphql/absinthe)：Elixir 的 GraphQL 实现。
-  - [graphql-elixir](https://github.com/graphql-elixir/graphql): 一个 Facebook GraphQL 的 Elixir 实现。
+  - [graphql-elixir](https://github.com/graphql-elixir/graphql)：一个 Facebook GraphQL 的 Elixir 实现。
 
 ### Erlang
 
   - [graphql-erlang](https://github.com/shopgun/graphql-erlang)：Erlang 的 GraphQL 实现。
 
 ### Go
 
-  - [graphql-go](https://github.com/graphql-go/graphql): 一个 Go/Golang 的 GraphQL 实现。
-  - [graphql-relay-go](https://github.com/graphql-go/relay): 一个用于帮助构建 graphql-go 服务器的 Go/Golang 库，支持 react-relay 。
+  - [graphql-go](https://github.com/graphql-go/graphql)：一个 Go/Golang 的 GraphQL 实现。
+  - [graphql-relay-go](https://github.com/graphql-go/relay)：一个用于帮助构建 graphql-go 服务器的 Go/Golang 库，支持 react-relay 。
   - [neelance/graphql-go](https://github.com/neelance/graphql-go)：一个活跃的 Golang GraphQL 实现。
+  - [machinebox/graphql](https://github.com/machinebox/graphql)：用于 GraphQL 的一个优雅的底层 HTTP 客户端。
+  - [samsarahq/thunder](https://github.com/samsarahq/thunder)：可轻松进行 schema 构建、实时查询和批处理的 GraphQL 实现。
 
 ### Groovy
 
@@ -135,7 +138,7 @@ $ curl -XPOST "http://0:3000" -H'Content-Type: application/json' -d'{
 - 在启动时使用 spring bean 配置生成 schema，以便于扩展。
 - 包含一个在开发环境下默认启用的 [GraphiQL](https://github.com/graphql/graphiql) 浏览器。这一浏览器可以在 /graphql/browser 下访问。
 - 使用 Grails 提供的数据绑定覆盖默认的数据绑定
-- 提供一个 [特质](https://grails.github.io/gorm-graphql/latest/api/org/grails/gorm/graphql/plugin/testing/GraphQLSpec.html) 以使您更容易对 GraphQL 入口端点进行集成测试
+- 提供一个 [特质](https://grails.github.io/gorm-graphql/latest/api/org/grails/gorm/graphql/plugin/testing/GraphQLSpec.html) 以使你更容易对 GraphQL 入口端点进行集成测试
 
 更多信息请查看 [文档](https://grails.github.io/gorm-graphql/latest/guide/index.html)。
 
@@ -302,6 +305,47 @@ Apollo Server 也支持所有的 Node.js HTTP 服务器框架：Express、Connec
   - [graphql-php](https://github.com/webonyx/graphql-php)：GraphQL 参考实现的 PHP 移植版本。
   - [graphql-relay-php](https://github.com/ivome/graphql-relay-php)：一个用于辅助构建 graphql-php 服务器的库，支持 react-relay。
 
+#### [Siler](https://siler.leocavalcante.com/graphql/) ([github](https://github.com/leocavalcante/siler))
+
+Siler 是一个具有高级抽象功能，可与 GraphQL 搭配使用的 PHP 库。
+
+如果要运行 Siler 的 hello world 脚本：
+
+\`\`\`graphql
+type Query {
+  hello: String
+}
+\`\`\`
+
+\`\`\`php
+<?php
+declare(strict_types=1);
+require_once '/path/to/vendor/autoload.php';
+
+use Siler\Diactoros;
+use Siler\Graphql;
+use Siler\Http;
+
+$typeDefs = file_get_contents(__DIR__.'/schema.graphql');
+$resolvers = [
+    'Query' => [
+        'hello' => 'world',
+    ],
+];
+$schema = Graphql\schema($typeDefs, $resolvers);
+
+echo "Server running at http://127.0.0.1:8080\\n";
+Http\server(Graphql\psr7($schema), function (\Throwable $err) {
+    var_dump($err);
+    return Diactoros\json([
+        'error'   => true,
+        'message' => $err->getMessage(),
+    ]);
+})()->run();
+\`\`\`
+
+它还根据 Apollo 的工作原理提供了构建 WebSocket 订阅服务器的功能。
+
 ### Python
 
 #### [Graphene](http://graphene-python.org/) ([github](https://github.com/graphql-python/graphene))
@@ -320,14 +364,14 @@ pip install graphene
 import graphene
 
 class Query(graphene.ObjectType):
-  hello = graphene.String()
+  hello = graphene.String(name=graphene.String(default_value="World"))
 
-  def resolve_hello(self, args, context, info):
-    return 'Hello world!'
+  def resolve_hello(self, info, name):
+    return 'Hello ' + name
 
 schema = graphene.Schema(query=Query)
 result = schema.execute('{ hello }')
-print(result.data['hello'])
+print(result.data['hello']) # "Hello World"
 \`\`\`
 
 其也有对 [Relay](https://facebook.github.io/relay/)、Django、SQLAlchemy 和 Google App Engine 的良好绑定。
@@ -361,7 +405,7 @@ Schema = GraphQL::Schema.define do
   query QueryType
 end
 
-puts Schema.execute('{ hello }')
+puts Schema.execute('{ hello }').to_json
 \`\`\`
 
 其也有对于 Relay 和 Rails 的良好绑定。
@@ -391,6 +435,7 @@ Executor.execute(schema, query) map println
 ## GraphQL 客户端
 
 - [C# / .NET](#c-net-1)
+- [Clojurescript](#clojurescript-1)
 - [Go](#go-1)
 - [Java / Android](#java-android)
 - [JavaScript](#javascript-1)
@@ -399,15 +444,22 @@ Executor.execute(schema, query) map println
 
 ### C# / .NET
 
+  - [GraphQL.Client](https://github.com/graphql-dotnet/graphql-client)：一个用于 .NET 的 GraphQL 客户端。
   - [graphql-net-client](https://github.com/bkniffler/graphql-net-client)：基于 .Net 的 GraphQL 客户端基本样例。
+  - [SAHB.GraphQLClient](https://github.com/sahb1239/SAHB.GraphQLClient)：GraphQL 客户端，支持从 C# 的类生成查询。
+
+### Clojurescript
+
+  - [re-graph](https://github.com/oliyh/re-graph/)：一个在 Clojurescript 中实现的 GraphQL 客户端，支持 websockets。
 
 ### Go
 
-  - [graphql](https://github.com/shurcooL/graphql#readme): 一个使用 Go 编写的 GraphQL 客户端实现。
+  - [graphql](https://github.com/shurcooL/graphql#readme)：一个使用 Go 编写的 GraphQL 客户端实现。
 
 ### Java / Android
 
   - [Apollo Android](https://github.com/apollographql/apollo-android)：一个用于 Android 的 GraphQL 客户端，强类型、带缓存功能，使用 Java 编写。
+  - [Nodes](https://github.com/americanexpress/nodes)：一个 GraphQL JVM 客户端，用于从标准模型定义构建查询。
 
 ### JavaScript
 
@@ -416,6 +468,8 @@ Executor.execute(schema, query) map println
   - [graphql-request](https://github.com/graphcool/graphql-request)：一个简单的弹性的 JavaScript GraphQL 客户端，可以运行于所有的 JavaScript 环境（浏览器，Node.js 和 React Native）—— 基本上是 \`fetch\` 的轻度封装。
   - [Lokka](https://github.com/kadirahq/lokka)：一个简单的 JavaScript GraphQL 客户端，可以运行于所有的 JavaScript 环境 —— 浏览器，Node.js 和 React Native。
   - [nanogql](https://github.com/yoshuawuyts/nanogql)：一个使用模板字符串的小型 GraphQL 客户端库。
+  - [gq-loader](https://github.com/Houfeng/gq-loader)：一个简单的 JavaScript GraphQL 客户端，通过 webpack 加载器让 *.gql 文件作为模块使用。
+  - [AWS Amplify](https://aws.github.io/aws-amplify)：使用云服务进行应用开发的 JavaScript 库，支持 GraphQL 后端和用于处理 GraphQL 数据的 React 组件。
 
 ### Swift / Objective-C iOS
 
@@ -425,22 +479,26 @@ Executor.execute(schema, query) map println
 ### Python
 
   - [GQL](https://github.com/graphql-python/gql)：一个 Python 中的 GraphQL 客户端。
-
+  - [python-graphql-client](https://github.com/graphcool/python-graphql-client)：适用于 Python 2.7+ 的简单 GraphQL 客户端。
+  - [sgqlc](https://github.com/profusion/sgqlc)：一个简单的 Python GraphQL 客户端。支持为 GraphQL schema 中定义的类型生成代码。
+   
 ## 工具
 
   - [graphiql](https://github.com/graphql/graphiql) ([npm](https://www.npmjs.com/package/graphiql))：一个交互式的运行于浏览器中的 GraphQL IDE.
   - [libgraphqlparser](https://github.com/graphql/libgraphqlparser)：一个 C++ 版 GraphQL 查询语言分析器，提供 C 和 C++ API。
   - [Graphql Language Service](https://github.com/graphql/graphql-language-service)：一个用于构建 IDE 的 GraphQL 语言服务（诊断、自动完成等）的接口。
+  - [quicktype](https://quicktype.io) ([github](https://github.com/quicktype/quicktype))：在 TypeScript、Swift、golang、C#、C++ 等语言中为 GraphQL 查询生成类型。
 
 ## 服务
 
   - [Apollo Engine](http://www.apollographql.com/engine/)：一个用于监视 GraphQL 后端的性能和使用的服务。
-  - [GraphCMS](https://graphcms.com/)：一个 BaaS（后端即服务），它为您配置了一个作为内容编辑工具来处理存储数据的 GraphQL 后端。
-  - [Graphcool](https://www.graph.cool) ([github](https://github.com/graphcool))：一个 BaaS（后端即服务），它为您的应用程序提供了一个 GraphQL 后端，且具有用于管理数据库和存储数据的强大的 web ui。
+  - [GraphCMS](https://graphcms.com/)：一个 BaaS（后端即服务），它为你配置了一个作为内容编辑工具来处理存储数据的 GraphQL 后端。
+  - [Graphcool](https://www.graph.cool) ([github](https://github.com/graphcool))：一个 BaaS（后端即服务），它为你的应用程序提供了一个 GraphQL 后端，且具有用于管理数据库和存储数据的强大的 web ui。
   - [Reindex](https://www.reindex.io/baas/) ([github](https://github.com/reindexio/reindex-js))：一个 BaaS（后端即服务），它针对使用 React 和 Relay 的应用程序配置了 GraphQL 后端。
-  - [Scaphold](https://scaphold.io) ([github](https://github.com/scaphold-io))：一个 BaaS（后端即服务），为您的应用程序配置了一个拥有多种不同集成的 GraphQL 后端。
-  - [Tipe](https://tipe.io) ([github](https://github.com/tipeio))：一个 SaaS（软件即服务）内容管理系统，允许您使用强大的编辑工具创建您的内容，并通过 GraphQL 或 REST API 从任何地方访问它。
+  - [Scaphold](https://scaphold.io) ([github](https://github.com/scaphold-io))：一个 BaaS（后端即服务），为你的应用程序配置了一个拥有多种不同集成的 GraphQL 后端。
+  - [Tipe](https://tipe.io) ([github](https://github.com/tipeio))：一个 SaaS（软件即服务）内容管理系统，允许你使用强大的编辑工具创建你的内容，并通过 GraphQL 或 REST API 从任何地方访问它。
   - [AWS AppSync](https://aws.amazon.com/appsync/)：完全托管的 GraphQL 服务，包含实时订阅、离线编程和同步、企业级安全特性以及细粒度的授权控制。
+  - [Hasura](https://hasura.io)：一个 BaaS（后端即服务），允许你在 Postgres 上创建数据表、定义权限并使用 GraphQL 接口查询和操作。
 
 ## 更多内容
 

site/code/index.html.js

@@ -16,6 +16,14 @@ sublinks: 即将举行的活动,聚会
 
 GraphQL Europe 是欧洲非营利性的 GraphQL 大会，邀请了来自世界各地的演讲嘉宾。了解来自行业专家的 GraphQL 最佳实践，并成为蓬勃发展的 GraphQL 社区的一部分。
 
+### GraphQL Finland 会议
+
+- **日期：** 2018 年 10 月 18 - 19 日
+- **地点：** 芬兰 赫尔辛基
+- **链接：** https://graphql-finland.fi/
+
+GraphQL Finland 是一个社区组织的 GraphQL 会议。这是首次在芬兰举办这样的活动，该活动由一天的研讨会和一天的专题演讲组成。GraphQL Finland 由 React Finland 的团队组织。
+
 ## 聚会
 
 ### 北美洲
@@ -27,7 +35,6 @@ GraphQL Europe 是欧洲非营利性的 GraphQL 大会，邀请了来自世界
 - [GraphQL NYC](https://www.meetup.com/GraphQL-NYC/)
 - [GraphQL Atlanta](https://www.meetup.com/GraphQL-Atlanta/)
 - [GraphQL Austin](https://www.meetup.com/ATX-GraphQL/)
-- [GraphQL Miami](https://www.meetup.com/Miami-GraphQL/)
 - [GraphQL Los Angeles](https://www.meetup.com/Los-Angeles-GraphQL-Meetup/)
 - [GraphQL Dallas-Fort Worth](https://www.meetup.com/DFW-GraphQL-Meetup/)
 - [GraphQL Ottawa](https://www.meetup.com/GraphQL-Ottawa/)
@@ -46,7 +53,6 @@ GraphQL Europe 是欧洲非营利性的 GraphQL 大会，邀请了来自世界
 
 - [GraphQL Amsterdam](https://www.meetup.com/Amsterdam-GraphQL-Meetup/)
 - [GraphQL Berlin](https://www.meetup.com/graphql-berlin/)
-- [GraphQL Istanbul](https://www.meetup.com/GraphQL-Istanbul/)
 - [GraphQL London](https://www.meetup.com/GraphQL-London)
 - [GraphQL Paris](https://www.meetup.com/GraphQL-Paris/)
 - [GraphQL Munich](https://www.meetup.com/GraphQL-Munich/)
@@ -59,7 +65,7 @@ GraphQL Europe 是欧洲非营利性的 GraphQL 大会，邀请了来自世界
 ### 澳洲
 
 - [GraphQL Melbourne](http://graphql.melbourne/)
-- [GraphQL Sydney](http://graphql.sydney/)
+- [GraphQL Sydney](https://graphql.sydney/)
 
 ### 亚洲
 

site/community/Community-Events.md

@@ -13,7 +13,7 @@ sublinks: 博客,视频
 
 ## Facebook Group
 
-加入 [GraphQL Facebook Group](https://www.facebook.com/groups/graphql.community/) 来提出问题、讨论和分享。GraphQL Facebook group 是首选的发布公告和进行广泛讨论的场所。
+加入 [GraphQL Facebook Group](https://www.facebook.com/groups/graphql.community/) 分享和发现新内容。GraphQL Facebook group 是首选的发布公告和进行广泛讨论的场所。
 
 ## Twitter
 
@@ -55,7 +55,7 @@ sublinks: 博客,视频
 - [从 REST 到 GraphQL](https://0x2a.sh/from-rest-to-graphql-b4e95e94c26b#.tag7nzkrb) - Jacob Gillespie
 - [GraphQL 讲解](https://medium.com/apollo-stack/graphql-explained-5844742f195e#.zdykxos6i) - Jonas Helfer
 - [GraphQL 概念可视化](https://medium.com/apollo-stack/the-concepts-of-graphql-bc68bd819be3#.hfczgtdsj) - Dhaivat Pandya
-- [构建 f8 App：使用 GraphQL & Relay](http://makeitopen.com/tutorials/building-the-f8-app/relay/)
+- [构建 f8 App：使用 GraphQL & Relay](http://makeitopen.com/docs/en/1-A2-relay.html)
 - [你的第一个 GraphQL 服务器](https://medium.com/the-graphqlhub/your-first-graphql-server-3c766ab4f0a2#.ovn0y19k4) - Clay Allsopp
 - [教程：用 Apollo-server、Dataloader 和 Knex 启动一个 JS API](https://bamtech.gitbooks.io/dev-standards/content/backend/graphql-js/getting-started-with-apollo-server-dataloader-knex.mo.html) - Thomas Pucci
 - [教程：如何构建一个 GraphQL 服务器](https://medium.com/apollo-stack/tutorial-building-a-graphql-server-cddaa023c035#.bu6sdnst4) - Jonas Helfer
@@ -92,9 +92,15 @@ Facebook 内外的开发者在世界各地的会议和聚会上都谈到了 Grap
 - [使用 Angular 2 释放 GraphQL 的力量](https://www.youtube.com/watch?v=VYpJ9pfugM8) - Gerard Sans, NG-BE 2016
 - [网络研讨会系列：GraphQL 在世界各地](https://graphql-world.com/webinar) - Vince Ning & Michael Paris
 - [GraphQL Europe 中的所有演讲](https://www.youtube.com/playlist?list=PLn2e1F9Rfr6n_WFm9fPE-_wYPrYvSTySt) - Lee Byron, Sashko Stubailo, Dan Schafer, Johannes Schickling 等
+- [学习基于 React 和 Relay 的 GraphQL](https://www.packtpub.com/application-development/learning-graphql-react-and-relay-video) - Divyendu Singh
+- [实践比 RESTful Web 服务更好的 GraphQL（视频）](https://www.packtpub.com/application-development/hands-graphql-better-restful-web-services-video) - Ashwin Hegde
 
 ## 图书
 
+- [GraphQL 指南](https://graphql.guide) - John Resig 和 Loren Sands-Ramshaw
+- [学习 GraphQL](https://www.amazon.com/Learning-GraphQL-Declarative-Fetching-Modern/dp/1492030716/) - Eve Porcello 和 Alex Banks
+- [全栈 GraphQL](https://www.graphql.college/fullstack-graphql) - Julian Mayorga
+- [在 Elixir 和 Absinthe 中使用 Craft GraphQL API](https://pragprog.com/book/wwgraphql/craft-graphql-apis-in-elixir-with-absinthe) - Bruce Williams and Ben Wilson
 - [学习 GraphQL 和 Relay](https://www.packtpub.com/web-development/learning-graphql-and-relay) - Samer Buna
 
 ## 更多资源

site/community/Community-Resources.md

@@ -54,7 +54,9 @@ class GraphQLError extends Error {
    nodes?: Array<any>,
    stack?: ?string,
    source?: Source,
-   positions?: Array<number>
+   positions?: Array<number>,
+   originalError?: ?Error,
+   extensions?: ?{ [key: string]: mixed }
  )
 }
 ```

site/graphql-js/APIReference-Errors.md

@@ -37,7 +37,9 @@ export function execute(
   contextValue?: mixed,
   variableValues?: ?{[key: string]: mixed},
   operationName?: ?string
-): Promise<ExecutionResult>
+): MaybePromise<ExecutionResult>
+
+type MaybePromise<T> = Promise<T> | T;
 
 type ExecutionResult = {
   data: ?Object;

site/graphql-js/APIReference-Execution.md

@@ -442,7 +442,7 @@ var RGBType = new GraphQLEnumType({
 
 ```js
 class GraphQLInputObjectType {
-  constructor(config: GraphQLInputObjectTypeConfig)
+  constructor(config: GraphQLInputObjectConfig)
 }
 
 type GraphQLInputObjectConfig = {

site/graphql-js/APIReference-TypeSystem.md

@@ -23,18 +23,21 @@ http://localhost:4000/graphql
 {"data":{"hello":"Hello world!"}}
 ```
 
+如果你更倾向于使用图形用户界面发送测试查询，你可以使用客户端，例如 [GraphiQL](https://github.com/graphql/graphiql) 和 [Insomnia](https://github.com/getinsomnia/insomnia)。
+
 通过浏览器发送 GraphQL 也很简单。打开 http://localhost:4000 ，开启开发者控制台，粘贴：
 
 ```javascript
-var xhr = new XMLHttpRequest();
-xhr.responseType = 'json';
-xhr.open("POST", "/graphql");
-xhr.setRequestHeader("Content-Type", "application/json");
-xhr.setRequestHeader("Accept", "application/json");
-xhr.onload = function () {
-  console.log('data returned:', xhr.response);
-}
-xhr.send(JSON.stringify({query: "{ hello }"}));
+fetch('/graphql', {
+  method: 'POST',
+  headers: {
+    'Content-Type': 'application/json',
+    'Accept': 'application/json',
+  },
+  body: JSON.stringify({query: "{ hello }"})
+})
+  .then(r => r.json())
+  .then(data => console.log('data returned:', data));
 ```
 
 你会在控制台中见到返回的数据：
@@ -58,21 +61,23 @@ type Query {
 ```javascript
 var dice = 3;
 var sides = 6;
-var xhr = new XMLHttpRequest();
-xhr.responseType = 'json';
-xhr.open("POST", "/graphql");
-xhr.setRequestHeader("Content-Type", "application/json");
-xhr.setRequestHeader("Accept", "application/json");
-xhr.onload = function () {
-  console.log('data returned:', xhr.response);
-}
 var query = `query RollDice($dice: Int!, $sides: Int) {
   rollDice(numDice: $dice, numSides: $sides)
 }`;
-xhr.send(JSON.stringify({
-  query: query,
-  variables: { dice: dice, sides: sides },
-}));
+
+fetch('/graphql', {
+  method: 'POST',
+  headers: {
+    'Content-Type': 'application/json',
+    'Accept': 'application/json',
+  },
+  body: JSON.stringify({
+    query,
+    variables: { dice, sides },
+  })
+})
+  .then(r => r.json())
+  .then(data => console.log('data returned:', data));
 ```
 
 这种语法的变量有助于自动避免转义 bug，也更容易监控服务器。