Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/itsezc/crystal-gql
A complete GraphQL client shard for the Crystal language inspired by Apollo client including error handling and planned support for caching, authentication and subscriptions.
https://github.com/itsezc/crystal-gql
crystal-gql crystal-language crystal-shard graphql
Last synced: about 1 month ago
JSON representation
A complete GraphQL client shard for the Crystal language inspired by Apollo client including error handling and planned support for caching, authentication and subscriptions.
- Host: GitHub
- URL: https://github.com/itsezc/crystal-gql
- Owner: itsezc
- License: mit
- Created: 2020-03-30T07:38:45.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2021-05-06T15:00:19.000Z (about 3 years ago)
- Last Synced: 2024-02-03T06:44:50.774Z (4 months ago)
- Topics: crystal-gql, crystal-language, crystal-shard, graphql
- Language: Crystal
- Homepage:
- Size: 25.4 KB
- Stars: 5
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Lists
- awesome-graphql - crystal-gql - GraphQL client shard inspired by Apollo client. (Implementations / Crystal)
- awesome-graphql - crystal-gql - GraphQL client shard inspired by Apollo client (Libraries / Crystal Libraries)
README
# GraphQL Client for Crystal
A GraphQL client shard for the Crystal language.
- Version: 0.1.3
- Crystal Version: 0.35.1
## Usage
**Installing**
Just add this to your shards.yml file:
```yml
dependencies:
crystal-gql:
github: itsezc/crystal-gql
```
Then run:
```bash
shards install
```
**Initializing**
```ruby
require "crystal-gql"
# Define the client
api = GraphQLClient.new "https://countries.trevorblades.com"
```
**Querying**
```ruby
# useQuery
data, error, loading = api.useQuery(GQL {
"continents" => [
"code",
"name",
{
"countries" => [
"name",
"capital",
{
"languages" => [
"name"
]
}
]
}
]
})
# or traditional queries
data, error, loading = api.query("{
continents {
code
name
countries {
name
capital
languages {
name
}
}
}
}")
# Print data
print data
```
**Querying**
With authentication:
```ruby
api.add_header("Authorization", "Bearer: TOKEN")
# useQuery
data, error, loading = api.useQuery(GQL {
"continents" => [
"code",
"name",
{
"countries" => [
"name",
"capital",
{
"languages" => [
"name"
]
}
]
}
]
})
```