switchgear-testing 0.1.17

CI Integration Testing Framework for Switchgear
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

# Testing

Docker-based regtest environment for testing with Lightning Network nodes (CLN, LND), Bitcoin Core, and databases.

## Local Testing

1. **Start services:**
   ```bash
   cd testing
   docker compose up -d --build --wait 
   ```

2. **Copy environment configuration:**
   ```bash
   cp testing/.env .
   ```

3. **Edit `.env` and change all service names to localhost:**

```shell
CLN_HOSTNAME=localhost
CREDENTIALS_SERVER_HOSTNAME=localhost
LND_HOSTNAME=localhost
MYSQL_HOSTNAME=localhost
POSTGRES_HOSTNAME=localhost
```

4. **Run tests:**
   ```bash
   cargo test
   ```

**Skip integration tests with service dependencies:**
```bash
SWGR_SKIP_INTEGRATION_TESTS=true cargo test
```

## Docker-in-Docker CI Testing

For running tests inside a container with Docker socket access.

1. **Start services:**
   ```bash
   cd testing
   docker compose up -d --build --wait 
   ```

2. **Connect container to services network:**
   ```bash
   . testing/.env
   docker network connect $SERVICES_NETWORK_NAME $(hostname)
   ```

3. **Copy environment configuration:**
   ```bash
   cp testing/.env .
   ```

4. **Run tests:**
   ```bash
   cargo test
   ```