# edgedb-go

**Repository Path**: edgedb/edgedb-go

## Basic Information

- **Project Name**: edgedb-go
- **Description**: EdgeDB 的官方 Go 驱动源码镜像，交流讨论请移步【内宣】库，谢谢！
- **Primary Language**: Go
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/edgedb/devrel
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-08-24
- **Last Updated**: 2025-04-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# The Go driver for Gel

[![Build Status](https://github.com/geldata/gel-go/workflows/Tests/badge.svg?event=push&branch=master)](https://github.com/geldata/gel-go/actions)
[![Join GitHub discussions](https://img.shields.io/badge/join-github%20discussions-green)](https://github.com/geldata/gel/discussions)

## Installation

In your module directory, run the following command.

```bash
$ go get github.com/geldata/gel-go
```

## Basic Usage

Follow the [Gel tutorial](https://docs.geldata.com/learn/quickstart/overview/fastapi)
to get Gel installed and minimally configured.

```go
package main

import (
	"context"
	"fmt"
	"log"

	gel "github.com/geldata/gel-go"
	"github.com/geldata/gel-go/gelcfg"
)

func main() {
	ctx := context.Background()
	client, err := gel.CreateClient(gelcfg.Options{})
	if err != nil {
		log.Fatal(err)
	}
	defer client.Close()

	var result string
	err = client.QuerySingle(ctx, "SELECT 'hello Gel!'", &result)
	if err != nil {
		log.Fatal(err)
	}

	fmt.Println(result)
}
```

## Development

A local installation of Gel is required to run tests.
Download Gel from [here](https://docs.geldata.com/learn/cli)
or [build it manually](https://docs.geldata.com/resources/guides/contributing/code).

To run the test suite run `make test`.
To run lints `make lint`.

## License

gel-go is developed and distributed under the Apache 2.0 license.