mirror of
https://github.com/logos-messaging/logos-messaging-go-bindings.git
synced 2026-01-09 01:13:12 +00:00
77 lines
4.0 KiB
Markdown
77 lines
4.0 KiB
Markdown
# Testlibs for Go-Waku Bindings
|
|
|
|
`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.
|
|
## Key Components
|
|
|
|
### 1. Wrappers
|
|
|
|
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.
|
|
|
|
#### Peer Connection Tests (`Peers_connection_test.go`)
|
|
- **Highlights**:
|
|
- Simplifies peer connectivity testing using the wrappers.
|
|
- Example: `TestConnectMultipleNodesToSingleNode` verifies multiple nodes can connect to a single node efficiently.
|
|
|
|
#### Basic Node Tests (`Nodes_basic_test.go`)
|
|
- **Highlights**:
|
|
- Validates fundamental node lifecycle management using wrapper APIs.
|
|
- Example: `TestBasicWakuNodes` covers node creation, startup, and cleanup using `Wrappers_StartWakuNode` and `Wrappers_StopAndDestroy`.
|
|
|
|
## Purpose
|
|
|
|
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.
|