`testlibs` is a dedicated testing framework for the [Go-Waku Bindings](https://github.com/waku-org/waku-go-bindings). It provides an organized structure for writing and executing tests to validate the behavior of Waku nodes and their associated functionalities.
## Overview
The primary goal of `testlibs` is to simplify and enhance the testing process for Go-Waku Bindings by offering:
- **Test Wrappers**: High-level abstractions for managing Waku nodes, including operations like starting, stopping, and destroying nodes.
- **Peer Management**: Tools for validating peer-to-peer connections, such as connecting, disconnecting, and verifying connected peers.
- **Relay Protocol Testing**: Functions to test relay features like subscribing and unsubscribing to pubsub topics and checking relay peer connections.
- **Utility Functions**: Logging and helper functions to streamline debugging and test execution.
The `wrapper` files define abstractions around the `WakuNode` to streamline node management and interaction during testing. Key functionalities include:
- **Node Lifecycle Management**:
-`Wrappers_StartWakuNode`: Starts a Waku node with a custom or default configuration.
-`Wrappers_Stop`: Stops the Waku node gracefully.
-`Wrappers_Destroy`: Cleans up and destroys the Waku node.
-`Wrappers_StopAndDestroy`: Combines stop and destroy operations for efficient cleanup.
- **Peer Management**:
-`Wrappers_ConnectPeer`: Simplifies connecting nodes by taking a `WakuNode` instance instead of a `peerID`, constructing the `peerID` and connection details internally.
-`Wrappers_DisconnectPeer`: Disconnects a Waku node from a target peer with validation and error handling.
-`Wrappers_GetConnectedPeers`: Retrieves a list of peers connected to the Waku node.
-`Wrappers_GetNumConnectedRelayPeers`: Returns the number of relay peers connected for a specific pubsub topic.
- **Relay Subscription**:
-`Wrappers_RelaySubscribe`: Subscribes the Waku node to a given pubsub topic, ensuring subscription and verifying peer connections.
-`Wrappers_RelayUnsubscribe`: Unsubscribes from a specific pubsub topic and validates the unsubscription process.
---
### 2. Utilities
The `utilities` package provides helper functions and constants to facilitate testing. Key highlights include:
- **Default Configuration**:
-`DefaultWakuConfig`: Provides a baseline Waku node configuration with sensible defaults for testing purposes.
- **Logging Support**:
- Centralized logging via `zap` for debugging during tests.
- Debug-level messages are used extensively to trace the flow and identify issues.
- **Port Management**:
-`GenerateUniquePort`: Dynamically allocates unique ports for Waku nodes during tests to avoid conflicts.
- **Timeout and Error Handling**:
- Constants for peer connection timeouts.
- Enhanced error messaging for debugging failures in Waku node operations.
---
### 3. Test Files
#### Relay Tests (`relay_test.go`)
- **Highlights**:
- Tests the behavior of the relay protocol.
- Example: `TestRelaySubscribeToDefaultTopic` validates subscription to the default pubsub topic and ensures connected relay peers increase.
This framework is designed to ensure the reliability and robustness of the Go-Waku Bindings, which enable Go applications to interface with the Waku protocol. With `testlibs`, developers can simulate various conditions, verify expected behaviors, and maintain confidence in their implementations.
