Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/deno-libs/gql
☁ Universal GraphQL HTTP middleware for Deno
https://github.com/deno-libs/gql
deno graphql graphql-api graphql-server
Last synced: about 1 month ago
JSON representation
☁ Universal GraphQL HTTP middleware for Deno
- Host: GitHub
- URL: https://github.com/deno-libs/gql
- Owner: deno-libs
- License: mit
- Created: 2021-03-13T19:09:43.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2024-03-31T13:07:53.000Z (2 months ago)
- Last Synced: 2024-03-31T14:23:37.636Z (2 months ago)
- Topics: deno, graphql, graphql-api, graphql-server
- Language: TypeScript
- Homepage: https://deno.land/x/gql
- Size: 205 KB
- Stars: 188
- Watchers: 5
- Forks: 11
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Audit: audit_test.ts
Lists
- awesome-deno - gql - Universal GraphQL HTTP middleware. (Modules / Web utils)
- awesome-graphql - gql - Universal GraphQL HTTP middleware for Deno. (Implementations / JavaScript/TypeScript)
- awesome-list - gql - libs | 94 | (TypeScript)
- awesome-stars - deno-libs/gql - ☁ Universal GraphQL HTTP middleware for Deno (TypeScript)
README
[![nest badge][nest-badge]](https://nest.land/package/gql)
[![GitHub Workflow Status][gh-actions-img]][github-actions]
[![Codecov][cov-badge]][cov] [![][docs-badge]][docs]
[![][code-quality-img]][code-quality]
# gql
Universal and spec-compliant [GraphQL](https://www.graphql.com/) HTTP middleware
for Deno. Based on [graphql-http](https://github.com/graphql/graphql-http).
## Features
- ✨ Works with `Deno.serve` and [oak](https://github.com/oakserver/oak)
- ⚡
[GraphQL Playground](https://github.com/graphql/graphql-playground/tree/master/packages/graphql-playground-html)
integration (via `graphiql: true`)
## Get started
The simplest setup with `Deno.serve`:
```ts
import { GraphQLHTTP } from 'https://deno.land/x/[email protected]/mod.ts'
import { makeExecutableSchema } from 'npm:@graphql-tools/[email protected]'
import { gql } from 'https://deno.land/x/[email protected]/mod.ts'
const typeDefs = gql`
type Query {
hello: String
}
`
const resolvers = {
Query: {
hello: () => `Hello World!`,
},
}
const schema = makeExecutableSchema({ resolvers, typeDefs })
Deno.serve({
port: 3000,
onListen({ hostname, port }) {
console.log(`☁ Started on http://${hostname}:${port}`)
},
}, async (req) => {
const { pathname } = new URL(req.url)
return pathname === '/graphql'
? await GraphQLHTTP({
schema,
graphiql: true,
})(req)
: new Response('Not Found', { status: 404 })
})
```
Then run:
```sh
$ curl -X POST localhost:3000/graphql -d '{ "query": "{ hello }" }' -H "Content-Type: application/json"
{
"data": {
"hello": "Hello World!"
}
}
```
Or in the GraphQL Playground:
[docs-badge]: https://img.shields.io/github/v/release/deno-libs/gql?label=Docs&logo=deno&style=for-the-badge&color=DD3FAA
[docs]: https://doc.deno.land/https/deno.land/x/gql/mod.ts
[gh-actions-img]: https://img.shields.io/github/actions/workflow/status/deno-libs/gql/main.yml?branch=master&style=for-the-badge&logo=github&label=&color=DD3FAA&
[github-actions]: https://github.com/deno-libs/gql/actions
[cov]: https://coveralls.io/github/deno-libs/gql
[cov-badge]: https://img.shields.io/coveralls/github/deno-libs/gql?style=for-the-badge&color=DD3FAA
[nest-badge]: https://img.shields.io/badge/publushed%20on-nest.land-DD3FAA?style=for-the-badge
[code-quality-img]: https://img.shields.io/codefactor/grade/github/deno-libs/gql?style=for-the-badge&color=DD3FAA
[code-quality]: https://www.codefactor.io/repository/github/deno-libs/gql