A dead-simple graphql client that supports subscriptions over websockets.
Project description
py-graphql-client
Dead-simple to use GraphQL client over websocket. Using the apollo-transport-ws protocol.
Examples
Setup subscriptions super easily
from graphql_client import GraphQLClient
ws = GraphQLClient('ws://localhost:8080/graphql')
def callback(_id, data):
print("got new data..")
print(f"msg id: {_id}. data: {data}")
query = """
subscription {
notifications {
id
title
content
}
}
"""
sub_id = ws.subscribe(query, callback=callback)
...
# later stop the subscription
ws.stop_subscribe(sub_id)
ws.close()
Variables can be passed
from graphql_client import GraphQLClient
ws = GraphQLClient('ws://localhost:8080/graphql')
def callback(_id, data):
print("got new data..")
print(f"msg id: {_id}. data: {data}")
query = """
subscription ($limit: Int!) {
notifications (order_by: {created: "desc"}, limit: $limit) {
id
title
content
}
}
"""
sub_id = ws.subscribe(query, variables={'limit': 10}, callback=callback)
Normal queries and mutations work too
from graphql_client import GraphQLClient
ws = GraphQLClient('ws://localhost:8080/graphql')
query = """
query ($limit: Int!) {
notifications (order_by: {created: "desc"}, limit: $limit) {
id
title
content
}
}
"""
res = ws.query(query, variables={'limit': 10})
print(res)
ws.close()
TODO
- currently wss doesn't not work. support wss.
- tests
- support http as well
- should use asyncio websocket library?
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Close
Hashes for py_graphql_client-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 655079369151c29a35fc20a46dce3d26430de9443046a2256391cd9afed2f820 |
|
MD5 | 07dbe333b56ffdd4222e5795494e93c4 |
|
BLAKE2b-256 | a9d970df2c0f0bcce2f54028f77d814b923c2c0264f3bc7bc81871993536823b |