super-graph/README.md

112 lines
3.4 KiB
Markdown
Raw Permalink Normal View History

<img src="docs/website/static/img/super-graph-logo.svg" width="80" />
# Super Graph - Fetch data without code!
2019-03-24 14:57:29 +01:00
2020-04-11 22:41:10 +02:00
[![GoDoc](https://img.shields.io/badge/godoc-reference-5272B4.svg)](https://pkg.go.dev/github.com/dosco/super-graph/core?tab=doc)
![Apache 2.0](https://img.shields.io/github/license/dosco/super-graph.svg?style=flat-square)
![Docker build](https://img.shields.io/docker/cloud/build/dosco/super-graph.svg?style=flat-square)
2020-05-17 09:11:56 +02:00
[![Discord Chat](https://img.shields.io/discord/628796009539043348.svg)](https://discord.gg/6pSWCTZ)
2019-03-24 14:57:29 +01:00
2020-05-20 15:42:10 +02:00
Super Graph gives you a high performance GraphQL API without you having to write any code. GraphQL is automagically compiled into an efficient SQL query. Use it either as a library or a standalone service.
2020-04-11 22:41:10 +02:00
## Using it as a service
2020-04-11 22:41:10 +02:00
```console
2020-05-17 09:11:56 +02:00
go get github.com/dosco/super-graph
2020-04-11 22:41:10 +02:00
super-graph new <app_name>
```
2019-03-30 06:11:30 +01:00
2020-04-11 22:41:10 +02:00
## Using it in your own code
2020-05-17 09:11:56 +02:00
```console
go get github.com/dosco/super-graph/core
```
2020-04-11 22:41:10 +02:00
```golang
package main
import (
"database/sql"
"fmt"
"time"
"github.com/dosco/super-graph/core"
_ "github.com/jackc/pgx/v4/stdlib"
)
func main() {
db, err := sql.Open("pgx", "postgres://postgrs:@localhost:5432/example_db")
if err != nil {
2020-04-24 03:24:41 +02:00
log.Fatal(err)
2020-04-11 22:41:10 +02:00
}
sg, err := core.NewSuperGraph(nil, db)
2020-04-11 22:41:10 +02:00
if err != nil {
2020-04-24 03:24:41 +02:00
log.Fatal(err)
2020-04-11 22:41:10 +02:00
}
query := `
query {
posts {
id
title
}
}`
res, err := sg.GraphQL(context.Background(), query, nil)
if err != nil {
2020-04-24 03:24:41 +02:00
log.Fatal(err)
2020-04-11 22:41:10 +02:00
}
fmt.Println(string(res.Data))
}
```
2020-04-11 22:41:10 +02:00
## About Super Graph
2019-03-24 14:57:29 +01:00
After working on several products through my career I found that we spend way too much time on building API backends. Most APIs also need constant updating, and this costs time and money.
2020-05-17 09:11:56 +02:00
2019-10-01 06:00:15 +02:00
It's always the same thing, figure out what the UI needs then build an endpoint for it. Most API code involves struggling with an ORM to query a database and mangle the data into a shape that the UI expects to see.
2019-03-24 14:57:29 +01:00
2019-10-01 06:00:15 +02:00
I didn't want to write this code anymore, I wanted the computer to do it. Enter GraphQL, to me it sounded great, but it still required me to write all the same database query code.
2019-03-24 14:57:29 +01:00
2019-10-01 06:00:15 +02:00
Having worked with compilers before I saw this as a compiler problem. Why not build a compiler that converts GraphQL to highly efficient SQL.
This compiler is what sits at the heart of Super Graph, with layers of useful functionality around it like authentication, remote joins, rails integration, database migrations, and everything else needed for you to build production-ready apps with it.
2019-03-24 14:57:29 +01:00
## Features
2019-10-01 06:00:15 +02:00
2019-12-31 07:30:20 +01:00
- Complex nested queries and mutations
- Auto learns database tables and relationships
- Role and Attribute-based access control
- Opaque cursor-based efficient pagination
- Full-text search and aggregations
2019-04-07 07:12:11 +02:00
- JWT tokens supported (Auth0, etc)
2019-12-31 07:30:20 +01:00
- Join database queries with remote REST APIs
- Also works with existing Ruby-On-Rails apps
- Rails authentication supported (Redis, Memcache, Cookie)
- A simple config file
- High performance Go codebase
2019-03-24 14:57:29 +01:00
- Tiny docker image and low memory requirements
- Fuzz tested for security
2019-10-01 06:00:15 +02:00
- Database migrations tool
- Database seeding tool
2020-02-12 04:12:53 +01:00
- Works with Postgres and YugabyteDB
2019-05-13 01:27:26 +02:00
2019-04-11 07:39:59 +02:00
## Documentation
[supergraph.dev](https://supergraph.dev)
## Reach out
2019-03-24 14:57:29 +01:00
We're happy to help you leverage Super Graph reach out if you have questions
2019-10-25 07:39:59 +02:00
[twitter/dosco](https://twitter.com/dosco)
[chat/super-graph](https://discord.gg/6pSWCTZ)
2019-03-24 14:57:29 +01:00
## License
[Apache Public License 2.0](https://opensource.org/licenses/Apache-2.0)
2019-03-24 14:57:29 +01:00
Copyright (c) 2019-present Vikram Rangnekar