Skip to content

Commit ad7fdf8

Browse files
readme: describe how to run tests
Describe how to run connector tests (with submodules) and test requirements. Closes #106
1 parent 491e9aa commit ad7fdf8

File tree

1 file changed

+36
-0
lines changed

1 file changed

+36
-0
lines changed

README.md

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,7 @@ faster than other packages according to public benchmarks.
2727
* [Custom (un)packing and typed selects and function calls](#custom-unpacking-and-typed-selects-and-function-calls)
2828
* [Options](#options)
2929
* [Working with queue](#working-with-queue)
30+
* [Tests](#tests)
3031
* [Alternative connectors](#alternative-connectors)
3132

3233
## Installation
@@ -673,6 +674,41 @@ Additional options (configurable via `ConnectWithOpts`):
673674
* `ClusterDiscoveryTime` - time interval to ask server for updated address list (works on with `NodesGetFunctionName` set)
674675
* `NodesGetFunctionName` - server lua function name to call for getting address list
675676

677+
## Tests
678+
679+
You need to [install Tarantool](https://www.tarantool.io/en/download/) to run tests.
680+
See [Installation](#installation) section for requirements.
681+
682+
To install test dependencies (like [tarantool/queue](https://github.com/tarantool/queue) module), run
683+
```bash
684+
./deps.sh
685+
```
686+
687+
To run tests, call
688+
```bash
689+
go clean -testcache && go test ./... -v -p 1
690+
```
691+
Tests set up all required `tarantool` processes before run.
692+
693+
To run subpackage tests, go to a subpackage folder and run the same command.
694+
```bash
695+
cd multi
696+
go clean -testcache && go test -v
697+
```
698+
699+
Queue tests require [tarantool/queue](https://github.com/tarantool/queue) module, install it with `./deps.sh`.
700+
```bash
701+
cd queue
702+
./deps.sh
703+
go clean -testcache && go test -v
704+
```
705+
706+
UUID tests require [Tarantool 2.4.1 or newer](https://github.com/tarantool/tarantool/commit/d68fc29246714eee505bc9bbcd84a02de17972c5).
707+
```bash
708+
cd UUID
709+
go clean -testcache && go test -v
710+
```
711+
676712
## Alternative connectors
677713

678714
There are two more connectors from the open-source community available:

0 commit comments

Comments
 (0)