Skip to content

Commit fae10cd

Browse files
committed
feat(readme): update
1 parent c06e4d7 commit fae10cd

File tree

4 files changed

+44
-10
lines changed

4 files changed

+44
-10
lines changed

.devcontainer/devcontainer.json

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,8 @@
99
"customizations": {
1010
"vscode": {
1111
"extensions": [
12-
"eamodio.gitlens"
12+
"eamodio.gitlens",
13+
"golang.go"
1314
]
1415
}
1516
}

MAKEFILE.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# SQLite Cloud go-sdk Makefile
1+
# SQLite Cloud sqlitecloud-go Makefile
22

33
### Run the test for the SDK
44
If you want to run the Test programs: `make test`

Makefile

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,9 @@ GOPATH = $(shell go env GOPATH)
33
setup-ide:
44
pre-commit install
55
go install golang.org/x/tools/cmd/goimports@latest
6+
go mod tidy
7+
cd test; go mod tidy
8+
cd cli; go mod tidy
69

710
# Test SDK
811
test:

README.md

Lines changed: 38 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,31 @@
11

2-
# SQLite Cloud Client SDK for Go v1.0.2
2+
# Driver for SQLite Cloud
33

4-
The SQLite Cloud Client SDK for Go (sqlitecloud/go-sdk) is the Go Programming Language application programmer's interface to [SQLite Cloud](https://sqlitecloud.io/). It is a set of library functions that allow client programs to pass queries and SQL commands to the SQLite Cloud backend server and to receive the results of these queries. In addition to the standard SQLite statements, several other [commands](https://docs.sqlitecloud.io/docs/commands) are supported.
4+
<p align="center">
5+
<img src="https://sqlitecloud.io/social/logo.png" height="300" alt="SQLite Cloud logo">
6+
</p>
57

6-
## Getting Started
8+
- [Driver for SQLite Cloud](#driver-for-sqlite-cloud)
9+
- [Example](#example)
10+
- [Get a Connection String](#get-a-connection-string)
11+
- [Setting up the IDE](#setting-up-the-ide)
712

8-
### Use the SQLite Cloud Client SDK in your Go code
13+
[![Test and QA](https://github.com/sqlitecloud/sqlitecloud-go/actions/workflows/testing.yaml/badge.svg?branch=main)](https://github.com/sqlitecloud/sqlitecloud-go/actions/workflows/testing.yaml)
14+
[![codecov](https://codecov.io/gh/sqlitecloud/sqlitecloud-go/graph/badge.svg?token=5MAG3G4X01)](https://codecov.io/gh/sqlitecloud/sqlitecloud-go)
15+
[![GitHub Tag](https://img.shields.io/github/v/tag/sqlitecloud/sqlitecloud-go?label=version&link=https%3A%2F%2Fpkg.go.dev%2Fgithub.com%2Fsqlitecloud%2Fsqlitecloud-go)](https://github.com/sqlitecloud/sqlitecloud-go)
16+
[![GitHub go.mod Go version](https://img.shields.io/github/go-mod/go-version/sqlitecloud/sqlitecloud-go?link=https%3A%2F%2Fgithub.com%2Fsqlitecloud%2Fsqlitecloud-go)](https://github.com/sqlitecloud/sqlitecloud-go)
17+
18+
---
19+
20+
[SQLite Cloud](https://sqlitecloud.io) for Go is a powerful package that allows you to interact with the SQLite Cloud database seamlessly. It provides methods for various database operations. This package is designed to simplify database operations in Go applications, making it easier than ever to work with SQLite Cloud. In addition to the standard SQLite statements, several other [commands](https://docs.sqlitecloud.io/docs/commands) are supported.
21+
22+
- Documentation: https://pkg.go.dev/github.com/sqlitecloud/sqlitecloud-go
23+
- Source: [https://github.com/sqlitecloud/sqlitecloud-go](https://github.com/sqlitecloud/sqlitecloud-go)
24+
- Site: [https://sqlitecloud.io](https://sqlitecloud.io/developers)
25+
26+
## Example
27+
28+
### Use SQLite Cloud in your Go code
929

1030
1. Import the package in your Go source code:
1131

@@ -15,7 +35,7 @@ The SQLite Cloud Client SDK for Go (sqlitecloud/go-sdk) is the Go Programming La
1535

1636
2. Download the package, and run the [`go mod tidy` command](https://go.dev/ref/mod#go-mod-tidy) to synchronize your module's dependencies:
1737

18-
```
38+
```bash
1939
$ go mod tidy
2040
go: downloading github.com/sqlitecloud/sqlitecloud-go v1.0.0
2141
```
@@ -65,7 +85,7 @@ func main() {
6585
}
6686
```
6787

68-
## Get a connection string
88+
## Get a Connection String
6989

7090
You can connect to any cloud database using a special connection string in the form:
7191

@@ -79,6 +99,16 @@ To get a valid connection string, follow these instructions:
7999
- Get the connection string by clicking on the node address in the [Dashboard Nodes](https://docs.sqlitecloud.io/docs/introduction/nodes) section. A valid connection string will be copied to your clipboard.
80100
- Add the database name to your connection string.
81101

82-
## API Documentation
83102

84-
The complete documentation of the sqlitecloud/go-sdk library is available at: https://pkg.go.dev/github.com/sqlitecloud/sqlitecloud-go
103+
104+
## Setting up the IDE
105+
106+
[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit)](https://github.com/pre-commit/pre-commit)
107+
108+
To start working on this project, follow these steps:
109+
110+
1. Open the project folder in Visual Studio Code (VSCode) using the remote container feature.
111+
2. In the terminal, run the command `make setup-ide` to install the necessary development tools.
112+
3. To ensure code quality, we have integrated [pre-commit](https://github.com/pre-commit/pre-commit) into the workflow. Before committing your changes to Git, pre-commit will run several tasks defined in the `.pre-commit-config.yaml` file.
113+
114+
By following these steps, you will have a fully set up development environment and be ready to contribute to the project.

0 commit comments

Comments
 (0)