Skip to content
/ sio-cli Public

SIO-CLI ( SocketIO-CLI ) is Efficient and easy-to-use Socket.IO v4 performance testing CLI for benchmarking and diagnostics

License

Notifications You must be signed in to change notification settings

qkgo/sio-cli

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

69 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SIO-CLI ( Socket.IO Performance Test CLI )

CI GitHub release

This is a command-line interface (CLI) for testing the performance of a Socket.IO v4 server using the rust-socketio library. This tool measures the time taken for handshake dialing, onConnect connection, and returns the HTTP status code and header lists.

Requirements

  • Server: Only Socket.IO v4+ is supported because rust-socketio is the only dependency and that's it.
  • libssl.3 is requried, Recommend ubuntu20+

Todos

Returns the time taken for handshake dialin and http status code and header lists.

Prerequisites

Building the CLI

To build the CLI, simply run:

cargo build --release

This will create the execution binary in the target/release directory.

Usage To run the performance test, use the following command, replacing <test_path> with the path to your test server:

./target/release/sio_cli <test_path>

The CLI will output the handshake dialing time, onConnect connection time, HTTP status code, and header lists.

GitHub Actions

This repository includes a GitHub Actions workflow for automatically building the project on push and pull requests to the main or master branch (choose based on your default branch name). The workflow configuration can be found in the .github/workflows/build.yml file.

When the workflow is triggered, you can view the build process under the "Actions" tab of your GitHub repository. After a successful build, the size of the build artifact will be displayed in the workflow logs.

License

This project is licensed under the MIT License.

Refs: