X-Git-Url: https://git.dogcows.com/gitweb?p=chaz%2Fgraphql-client;a=blobdiff_plain;f=README;h=ae64d68d1a89769935251ca5f56aa35fbc23feca;hp=ba5570e84cc18717ea819bac7001b17bc437cb34;hb=0702e3d960193e97d5cd68f2a44e2bc4e1c0c74f;hpb=561cc477b0f6bb51dc5eabaab46699ed7e329c9e diff --git a/README b/README index ba5570e..ae64d68 100644 --- a/README +++ b/README @@ -4,7 +4,7 @@ NAME VERSION - version 0.600 + version 0.601 SYNOPSIS @@ -52,7 +52,8 @@ DESCRIPTION GraphQL::Client provides a simple way to execute GraphQL queries and mutations on a server. - This module is the programmatic interface. There is also a graphql. + This module is the programmatic interface. There is also a "CLI + program". GraphQL servers are usually served over HTTP. The provided transport, GraphQL::Client::http, lets you plug in your own user agent, so this @@ -65,27 +66,28 @@ ATTRIBUTES The URL of a GraphQL endpoint, e.g. "http://myapiserver/graphql". - class + unpack - The package name of a transport. + Whether or not to "unpack" the response, which enables a different + style for error-handling. - By default this is automatically determined from the protocol portion - of the "url". + Default is 0. - transport + See "ERROR HANDLING". - The transport object. + transport_class - By default this is automatically constructed based on the "class". + The package name of a transport. - unpack + This is optional if the correct transport can be correctly determined + from the "url". - Whether or not to "unpack" the response, which enables a different - style for error-handling. + transport - Default is 0. + The transport object. - See "ERROR HANDLING". + By default this is automatically constructed based on "transport_class" + or "url". METHODS @@ -126,8 +128,8 @@ ERROR HANDLING There are two different styles for handling errors. - If "unpack" is 0 (off), every response -- whether success or failure -- - is enveloped like this: + If "unpack" is 0 (off, the default), every response -- whether success + or failure -- is enveloped like this: { data => {...}, @@ -156,6 +158,7 @@ ERROR HANDLING my $data = eval { $graphql->execute(...) }; if (my $error = $@) { + my $resp = $error->{response}; # handle errors } else {