The shurcool/graphql repository is a Go package that provides a GraphQL client implementation for making queries and mutations against GraphQL servers. Written in Go, it serves as a general-purpose GraphQL client library with a focus on simplicity and integration with Go's standard HTTP infrastructure.

The package is designed to allow developers to construct a GraphQL client by specifying a GraphQL server URL, then use that client to execute GraphQL queries and mutations. A key design decision is that the package does not directly handle authentication. Instead, users are expected to provide an http.Client that performs authentication, with the recommended approach being to use the golang.org/x/oauth2 package with an OAuth token that has appropriate scopes. This delegation of authentication responsibility keeps the core package focused and flexible.

The repository includes comprehensive documentation and examples for common GraphQL operations. For simple queries, developers define corresponding Go types and call the client.Query method. The package supports GraphQL arguments and variables through struct field tags, allowing developers to specify variable names in tags and then provide a variables map with their values when calling client.Query. The package also handles inline fragments, a GraphQL feature that allows querying different fields based on the concrete type of an interface or union, using struct field tags or embedded struct types.

Mutations are supported through a client.Mutate method, with the README providing examples of how mutations often depend on information retrieved from prior queries. The package includes two subdirectories: the ident package, which provides functions for parsing and converting identifier names between various naming conventions, and an internal jsonutil package that handles decoding JSON into GraphQL query data structures.

The repository is closely related to the shurcooL/githubv4 package, which is a specialized version of this client targeting GitHub's GraphQL API v4. According to the README, the githubv4 package is driving feature development for the graphql package, suggesting that improvements and new capabilities are often validated through real-world use against GitHub's API before being generalized in the core package.

GitGenius activity data shows relatively slow issue and pull request response latency, with a median response time of 8731.1 hours and a mean of 18882.1 hours across six tracked items. The most active contributor tracked is dmitshur with three events, followed by koote and williammartin with two events each. Active issue labels include API decision, WaitingForInfo, and question categories. The repository shares contributors with keycloak/keycloak, cloudnative-pg/cloudnative-pg, and nuxt/nuxt, indicating cross-project involvement among maintainers. The package is distributed under the MIT License.