https://github.com/future-architect/go-exceltesting
Go data insert into dababase tool for table driven testing using excel
https://github.com/future-architect/go-exceltesting
Last synced: 3 months ago
JSON representation
Go data insert into dababase tool for table driven testing using excel
- Host: GitHub
- URL: https://github.com/future-architect/go-exceltesting
- Owner: future-architect
- License: apache-2.0
- Created: 2022-07-26T08:03:34.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-02-29T07:58:45.000Z (over 2 years ago)
- Last Synced: 2025-08-21T14:17:59.647Z (10 months ago)
- Language: Go
- Size: 810 KB
- Stars: 3
- Watchers: 12
- Forks: 4
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# go-exceltesting
[][godoc] [][test]
[godoc]: https://pkg.go.dev/github.com/future-architect/go-exceltesting
[test]: https://github.com/future-architect/go-exceltesting/actions/workflows/test.yml
GoでExcelを使ったテーブルドリブンテストを行うためのヘルパーライブラリです。
ローカル環境でデータベースを含めた単体テストをするために、機能で必要な事前データをデータベースに投入する必要があります。
また正しくデータが更新されたことを検証するために、機能で更新した結果と想定している結果を比較する必要があります。
`go-exceltesting` ではこうしたデータベースへの事前データの投入や、実際の更新結果と期待結果の比較をより効率的に行うためのAPIを提供します。
視認性に優れることから事前データや期待するデータはExcelを使います。
現在は PostgreSQL のみサポートしています。
## 使い方
* [データの投入方法](docs/insert.md)
* [DBの値と比較する方法](docs/compare.md)
## インストール
```
go get github.com/future-architect/go-exceltesting@latest
```
## CLI インターフェース
テストに用いるExcelテンプレートの生成や、比較などをCLIコマンド経由で生成、確認できます。
### Install
```sh
go install github.com/future-architect/go-exceltesting/cmd/exceltesting@latest
```
### Setup
This cli tool needs to connect database. Accept connection url by `-c` option or environment variables.
```sh
# Mac/Linux
export EXCELTESTING_CONNECTION=postgres://username:password@localhost:5432/postgres?sslmode=disable
# Windows
set EXCELTESTING_CONNECTION=postgres://username:password@localhost:5432/postgres?sslmode=disable
```
### Example
Generate excel template file.
```sh
$ exceltesting dump out.xlsx
```
Compare Database and excel file.
```sh
$ exceltesting compare testdata/compare.xlsx
```
Load test data.
```sh
$ exceltesting load testdata/load.xlsx
```