Breaking change:

• gql and dsl_gql methods now returns a GraphQLRequest instead of a DocumentNode
• all execute and subscribe methods of Client and sessions now expects a GraphQLRequest instead of a DocumentNode

A GraphQLRequest is an object which contains optional variable_values and operation_name in addition to the document.

Because of that double change, the simple code examples do not need to be changed, but if you're using external methods on the result from the gql method, like print_ast which expects a DocumentNode, then you will need to use the document attribute of the request.

Before:

query = gql("{balance}")
print_ast(query)

After:

query = gql("{balance}")
print_ast(query.document)

Deprecated variable_values and operation_name in execute and subscribe methods

The new way to add variable_values is to set it as a property of the GraphQLRequest, and not as an argument of execute or subscribe methods:

    query = gql(
        """
        query getContinentName ($code: ID!) {
          continent (code: $code) {
            name
          }
        }
    """
    )

    query.variable_values = {"code": "EU"}

    # Get name of continent with code "EU"
    result = client.execute(query)