$self->{url};
}
-sub class {
+sub transport_class {
my $self = shift;
- $self->{class};
+ $self->{transport_class};
}
sub transport {
my $self = shift;
$self->{transport} //= do {
- my $class = $self->_transport_class;
+ my $class = $self->_autodetermine_transport_class;
eval { load $class };
if ((my $err = $@) || !$class->can('execute')) {
$err ||= "Loaded $class, but it doesn't look like a proper transport.\n";
return $protocol;
}
-sub _transport_class {
+sub _autodetermine_transport_class {
my $self = shift;
- return _expand_class($self->{class}) if $self->{class};
+ my $class = $self->transport_class;
+ return _expand_class($class) if $class;
my $protocol = $self->_url_protocol;
_croak 'Failed to determine transport from URL' if !$protocol;
- my $class = lc($protocol);
+ $class = lc($protocol);
$class =~ s/[^a-z]/_/g;
return _expand_class($class);
C<GraphQL::Client> provides a simple way to execute L<GraphQL|https://graphql.org/> queries and
mutations on a server.
-This module is the programmatic interface. There is also a L<graphql|"CLI program">.
+This module is the programmatic interface. There is also a L<"CLI program"|graphql>.
GraphQL servers are usually served over HTTP. The provided transport, L<GraphQL::Client::http>, lets
you plug in your own user agent, so this client works naturally with L<HTTP::Tiny>,
The URL of a GraphQL endpoint, e.g. C<"http://myapiserver/graphql">.
-=attr class
+=attr 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 L</url>.
+Default is 0.
-=attr transport
+See L</ERROR HANDLING>.
-The transport object.
+=attr transport_class
-By default this is automatically constructed based on the L</class>.
+The package name of a transport.
-=attr unpack
+This is optional if the correct transport can be correctly determined from the L</url>.
-Whether or not to "unpack" the response, which enables a different style for error-handling.
+=attr transport
-Default is 0.
+The transport object.
-See L</ERROR HANDLING>.
+By default this is automatically constructed based on L</transport_class> or L</url>.
=head1 ERROR HANDLING