docs

Author: skudasov

book/src/SUMMARY.md

@@ -53,6 +53,7 @@
     - [Chainlink]()
     - [RPC]()
     - [Loki]()
+- [Mono Repository Tooling](./monorepo-tools.md)
 - [Testing Maturity Model](framework/testing.md)
   - [Smoke]()
   - [Performance]()

book/src/monorepo-tools.md

@@ -0,0 +1,36 @@
+# Mono Repository Tooling
+
+In our multi-module Go repository, we use tools like:
+- DevBox
+- Just
+- Matrix CI pattern
+
+Open DevBox shell:
+```
+devbox shell
+```
+
+Install pre-commit hooks first:
+```
+just install
+```
+
+Each package has tests, run using commands in the justfile, examples:
+```
+# run all the tests (cache)
+just test-all
+# run package tests with regex
+just test wasp TestSmoke
+# run all package tests
+just test tools/ghlatestreleasechecker ./...
+```
+
+Use linters:
+```
+# all packages
+just lint-all
+# one package
+just lint wasp
+```
+
+For extra dependencies, we use [NixHub](https://www.nixhub.io/) to add them to [DevBox](https://github.com/smartcontractkit/chainlink-testing-framework/blob/main/devbox.json), which also works in [CI](https://github.com/smartcontractkit/chainlink-testing-framework/blob/main/.github/workflows/seth-test.yml#L62).

book/src/overview.md

@@ -10,7 +10,7 @@ To get started with writing system-level tests, refer to the [Framework](./frame
 
 If you want to build integration with Chainlink not in [Golang](https://go.dev/), please refer to our [Interactive](framework/interactive.md) chapter.
 
-We are using [DevBox](https://www.jetify.com/docs/devbox/quickstart/) for dependencies.
+See mono repository [tooling](monorepo-tools.md) to start working with Go modules.
 
 [Repository](https://github.com/smartcontractkit/chainlink-testing-framework) contains two major pieces:
 - [Framework](framework/overview.md)

justfile

@@ -1,10 +1,13 @@
+go_test_args := env('GO_TEST_ARGS', '')
+
 # Print all the commands
 default:
     @just --list
 
 # Install pre-commit hooks
 install:
     pre-commit install
+
 # Install gotestloghelper for enhanced go test logs output
 install-loghelper:
     go install github.com/smartcontractkit/chainlink-testing-framework/tools/gotestloghelper@latest
@@ -45,13 +48,13 @@ test-all:
     @just test wasp TestSmoke
     @just test wasp TestBenchSpy
 
-# Default test command (cacheable)
+# Default test command (cacheable), set GO_TEST_ARGS="-count 1" to disable cache
 _default_cached_test dir test_regex:
-    cd {{dir}} && go test -v -race `go list ./... | grep -v examples` -run {{test_regex}}
+    cd {{dir}} && go test {{go_test_args}} -v -race `go list ./... | grep -v examples` -run {{test_regex}}
 
 # Default test + coverage command (no-cache)
 _default_cover_test dir test_regex:
-    cd {{dir}} && go test -v -race -cover -coverprofile=cover.out `go list ./... | grep -v examples` -run {{test_regex}}
+    cd {{dir}} && go test {{go_test_args}} -v -race -cover -coverprofile=cover.out `go list ./... | grep -v examples` -run {{test_regex}}
 
 # Run tests for a package, example: just test wasp TestSmoke, example: just test tools/citool ./...
 test dir_path test_regex: