Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lucasshuan/go-ent-graphql-example
Go + ent + gqlgen: A compact API example for GraphQL and database modeling.
https://github.com/lucasshuan/go-ent-graphql-example
entgo example golang gqlgen
Last synced: about 1 month ago
JSON representation
Go + ent + gqlgen: A compact API example for GraphQL and database modeling.
- Host: GitHub
- URL: https://github.com/lucasshuan/go-ent-graphql-example
- Owner: lucasshuan
- Created: 2023-11-24T14:34:33.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2023-11-29T18:59:58.000Z (about 1 year ago)
- Last Synced: 2023-11-29T19:51:58.927Z (about 1 year ago)
- Topics: entgo, example, golang, gqlgen
- Language: Go
- Homepage:
- Size: 71.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## About
This project serves as an accessible and extensible example and template for a GraphQL server. Its primary goal is to dismiss the often intricate initial setup involved in configuring **ent** (an entity framework) and **gqlgen** (a GraphQL code generator), since once the setup is complete adding new features becomes remarkably straightforward.
## Prerequisites
- **Go**
- **Docker**
- **make**## Getting started
1. Clone the repository:
```bash
git clone https://github.com/lucasshuan/go-ent-graphql-example.git
cd go-ent-graphql-example
```2. Install dependencies:
```bash
make deps
```3. Start Docker containers:
```bash
make docker-up
```4. Start the server:
```bash
make server
```## Usage
Adding new functionality is fairly simple: To create a new database entity (in this example, we are creating an **Item** entity), just run the following command and enter a name when name input is asked:
```bash
make entity Item
```
You will notice that a new file is generated in directory **./ent/schema**. Read more about [Fields](https://entgo.io/docs/schema-fields) and [Edges](https://entgo.io/docs/schema-edges).
```go
type Item struct {
ent.Schema
}
func (Item) Fields() []ent.Field {
return []ent.Field{
field.String("name"),
field.String("description"),
}
}func (Item) Edges() []ent.Edge {
return nil
}
```
The `go generate .` command auto-migrates your database tables for every **./ent/schema/*.go** file. However, at most times, one may want the types generated by ent to be used by the resolvers. This is fairly easy to achieve and also the most important feature of this integration, and the only necessary step is to add an **Annotations** method in your newly created entity file:
```go
func (Item) Annotations() []schema.Annotation {
return []schema.Annotation{
entgql.QueryField(),
entgql.Mutations(entgql.MutationCreate(), entgql.MutationUpdate()),
}
}
```
The code block adds the default queries and mutations to be added to your **./graphql/schema/ent.graphql** schema when running the command `go generate .`. Resolvers will be created in **./graphql/resolvers** directory for each new file, where you will be able to implement all of your queries and mutations.