graphqlclient

What it is and what it does

graphqlclient is a minimal GraphQL client that wraps HTTP requests to GraphQL endpoints. It provides a single GraphQLClient class that accepts a GraphQL endpoint URL, executes queries as strings, and returns the server's response. The package supports injecting authorization tokens into request headers, either using the default 'Authorization' header or a custom header name like 'x-api-key'.

The package is intentionally simple: it has no runtime dependencies and does not provide query builders, type safety, or advanced features. It is designed for straightforward use cases where you need to send raw GraphQL query strings to an endpoint and handle the JSON response directly in your code.

Use it for:

• Send simple GraphQL queries to a public or internal GraphQL API endpoint for data retrieval
• Integrate GraphQL API calls into a Python script with minimal setup
• Add bearer token or API key authentication to GraphQL requests via custom headers
• Prototype or test a GraphQL endpoint without installing a full-featured client library

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A lightweight GraphQL client that sends queries to GraphQL endpoints and returns results, with support for custom authorization headers.

No. The package is abandoned (last release 2018-07-12, no commits since 2020-09-30) and specifies only Python 2.7+ compatibility with no upper bound, raising serious questions about compatibility with modern Python versions. High install friction combined with lack of maintenance makes this a poor choice for new projects.

Install

graphqlclient on PyPI

pip install graphqlclient

uv add graphqlclient

poetry add graphqlclient

Installing graphqlclient

Before you install

High install friction and abandoned maintenance status: last release was 2018-07-12, over 2955 days ago, with no recent commits. The package has no runtime dependencies but has not been updated to address Python version changes.

License in practice

MIT license is permissive and poses no restrictions on use, modification, or distribution in proprietary or open-source projects.

Quickstart

pip install graphqlclient

from graphqlclient import GraphQLClient

client = GraphQLClient('http://graphql-swapi.parseapp.com/')
result = client.execute('{ allFilms { films { title } } }')
print(result)

Package specifies Python 2.7+ with no upper bound; compatibility with modern Python versions is unverified.

Verify before relying

• Whether the package works with current Python versions (support specified only as '2.7+' with no upper bound)
• Whether the package is compatible with modern GraphQL servers and query formats
• Whether the simple HTTP-based approach handles advanced GraphQL features

Package facts

Evidence: graphqlclient-0.2.4.tar.gz

Tags

More WWW/HTTP packages