Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 1,015 Commits
.circleci		.circleci
benchutil		benchutil
examples		examples
gqlerrors		gqlerrors
language		language
testutil		testutil
.gitignore		.gitignore
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
abstract_test.go		abstract_test.go
definition.go		definition.go
definition_test.go		definition_test.go
directives.go		directives.go
directives_test.go		directives_test.go
enum_type_test.go		enum_type_test.go
executor.go		executor.go
executor_resolve_test.go		executor_resolve_test.go
executor_schema_test.go		executor_schema_test.go
executor_test.go		executor_test.go
extensions.go		extensions.go
extensions_test.go		extensions_test.go
go.mod		go.mod
graphql.go		graphql.go
graphql_bench_test.go		graphql_bench_test.go
graphql_test.go		graphql_test.go
introspection.go		introspection.go
introspection_test.go		introspection_test.go
kitchen-sink.graphql		kitchen-sink.graphql
lists_test.go		lists_test.go
located.go		located.go
mutations_test.go		mutations_test.go
nonnull_test.go		nonnull_test.go
quoted_or_list_internal_test.go		quoted_or_list_internal_test.go
race_test.go		race_test.go
rules.go		rules.go
rules_arguments_of_correct_type_test.go		rules_arguments_of_correct_type_test.go
rules_default_values_of_correct_type_test.go		rules_default_values_of_correct_type_test.go
rules_fields_on_correct_type_test.go		rules_fields_on_correct_type_test.go
rules_fragments_on_composite_types_test.go		rules_fragments_on_composite_types_test.go
rules_known_argument_names_test.go		rules_known_argument_names_test.go
rules_known_directives_rule_test.go		rules_known_directives_rule_test.go
rules_known_fragment_names_test.go		rules_known_fragment_names_test.go
rules_known_type_names_test.go		rules_known_type_names_test.go
rules_lone_anonymous_operation_rule_test.go		rules_lone_anonymous_operation_rule_test.go
rules_no_fragment_cycles_test.go		rules_no_fragment_cycles_test.go
rules_no_undefined_variables_test.go		rules_no_undefined_variables_test.go
rules_no_unused_fragments_test.go		rules_no_unused_fragments_test.go
rules_no_unused_variables_test.go		rules_no_unused_variables_test.go
rules_overlapping_fields_can_be_merged.go		rules_overlapping_fields_can_be_merged.go
rules_overlapping_fields_can_be_merged_test.go		rules_overlapping_fields_can_be_merged_test.go
rules_possible_fragment_spreads_test.go		rules_possible_fragment_spreads_test.go
rules_provided_non_null_arguments_test.go		rules_provided_non_null_arguments_test.go
rules_scalar_leafs_test.go		rules_scalar_leafs_test.go
rules_unique_argument_names_test.go		rules_unique_argument_names_test.go
rules_unique_fragment_names_test.go		rules_unique_fragment_names_test.go
rules_unique_input_field_names_test.go		rules_unique_input_field_names_test.go
rules_unique_operation_names_test.go		rules_unique_operation_names_test.go
rules_unique_variable_names_test.go		rules_unique_variable_names_test.go
rules_variables_are_input_types_test.go		rules_variables_are_input_types_test.go
rules_variables_in_allowed_position_test.go		rules_variables_in_allowed_position_test.go
scalars.go		scalars.go
scalars_parse_test.go		scalars_parse_test.go
scalars_serialization_test.go		scalars_serialization_test.go
scalars_test.go		scalars_test.go
schema-all-descriptions.graphql		schema-all-descriptions.graphql
schema-kitchen-sink.graphql		schema-kitchen-sink.graphql
schema.go		schema.go
subscription.go		subscription.go
subscription_test.go		subscription_test.go
suggested_list_internal_test.go		suggested_list_internal_test.go
type_comparators_internal_test.go		type_comparators_internal_test.go
type_info.go		type_info.go
types.go		types.go
union_interface_test.go		union_interface_test.go
util.go		util.go
util_test.go		util_test.go
validation_test.go		validation_test.go
validator.go		validator.go
validator_test.go		validator_test.go
values.go		values.go
values_test.go		values_test.go
variables_test.go		variables_test.go

Repository files navigation

graphql

An implementation of GraphQL in Go. Follows the official reference implementationgraphql-js.

Supports: queries, mutations & subscriptions.

Documentation

godoc:https://pkg.go.dev/github.com/graphql-go/graphql

Contribute Back

Friendly reminder links are available in case you would like to contribute back into our commitment with Go and open-source.

Author	PayPal Link
Hafiz Ismail	Not available yet.
Chris Ramón	https://www.paypal.com/donate/?hosted_button_id=WHUQQYEMTRQBJ

Getting Started

To install the library, run:

go get github.com/graphql-go/graphql

The following is a simple example which defines a schema with a singlehello string-type field and aResolve method which returns the stringworld. A GraphQL query is performed against this schema with the resulting output printed in JSON format.

package mainimport ("encoding/json""fmt""log""github.com/graphql-go/graphql")funcmain() {// Schemafields:= graphql.Fields{"hello":&graphql.Field{Type:graphql.String,Resolve:func(p graphql.ResolveParams) (interface{},error) {return"world",nil},},}rootQuery:= graphql.ObjectConfig{Name:"RootQuery",Fields:fields}schemaConfig:= graphql.SchemaConfig{Query:graphql.NewObject(rootQuery)}schema,err:=graphql.NewSchema(schemaConfig)iferr!=nil {log.Fatalf("failed to create new schema, error: %v",err)}// Queryquery:=`{hello}`params:= graphql.Params{Schema:schema,RequestString:query}r:=graphql.Do(params)iflen(r.Errors)>0 {log.Fatalf("failed to execute graphql operation, errors: %+v",r.Errors)}rJSON,_:=json.Marshal(r)fmt.Printf("%s\n",rJSON)// {"data":{"hello":"world"}}}

For more complex examples, refer to theexamples/ directory andgraphql_test.go.

Third Party Libraries

Name	Author	Description
graphql-go-handler	Hafiz Ismail	Middleware to handle GraphQL queries through HTTP requests.
graphql-relay-go	Hafiz Ismail	Lib to construct a graphql-go server supporting react-relay.
golang-relay-starter-kit	Hafiz Ismail	Barebones starting point for a Relay application with Golang GraphQL server.
dataloader	Nick Randall	DataLoader implementation in Go.