3 releases

new 0.1.2 Apr 21, 2025
0.1.1 Mar 11, 2025
0.1.0 Jan 31, 2025

#341 in WebSocket

Download history 115/week @ 2025-01-29 9/week @ 2025-02-05 11/week @ 2025-02-12 57/week @ 2025-03-05 57/week @ 2025-03-12 90/week @ 2025-04-16

90 downloads per month

LGPL-3.0-or-later

240KB
3K SLoC

yawc cli

A command-line interface tool for WebSocket communication that supports both secure (wss://) and non-secure (ws://) connections with both client and server capabilities.

Features

  • Interactive WebSocket client with command history
  • Simple WebSocket server implementation
  • Support for both ws:// and wss:// connections
  • JSON validation and pretty-printing
  • Command history with search capabilities (Ctrl+R)
  • Inline comments support using // for quick search and documentation
  • Configurable connection timeout

Installation

cargo install yawcc

Usage

Client Mode

Basic Connection

yawcc c wss://fstream.binance.com/ws/btcusdt@aggTrade

With JSON Validation

yawcc c --input-as-json wss://fstream.binance.com/ws/btcusdt@aggTrade

Server Mode

Start a Basic Echo Server

yawcc s

This starts a WebSocket server on localhost:9090 that echoes back any messages it receives.

Custom Port and Path

yawcc s --listen 0.0.0.0:8080 --path /ws

This starts a WebSocket server on all interfaces (0.0.0.0) on port 8080 with the endpoint path /ws.

Command-line Options

Client Options

Usage: yawcc client [OPTIONS] <URL>

Arguments:
  <URL>  The WebSocket URL to connect to (ws:// or wss://)

Options:
  -t, --timeout <TIMEOUT>  Maximum duration to wait when establishing the connection. Accepts human-readable formats like "5s", "1m", "500ms" [default: 5s]
      --input-as-json      When enabled, validates and pretty-prints received messages as JSON. Invalid JSON messages will result in an error
  -h, --help               Print help (see more with '--help')

Server Options

Usage: yawcc server [OPTIONS]

Options:
  -l, --listen <LISTEN>  Network address and port to listen on [default: 127.0.0.1:9090]
  -p, --path <PATH>      URI path to serve the WebSocket endpoint [default: /]
  -h, --help             Print help (see more with '--help')

Interactive Client Commands

Once connected, you can:

  • Send messages by typing and pressing Enter
  • Add comments to messages using // (comments are saved in history but not sent)
  • Search through command history using Ctrl+R
  • Exit the client using Ctrl+C or Ctrl+D

Example with comments:

> {"type": "ping"} // Heartbeat message
> {"command": "subscribe", "channel": "updates"} // Subscribe to updates

WebSocket Server

The built-in WebSocket server:

  • Acts as a simple echo server, sending back any messages it receives
  • Supports both text and binary frames
  • Handles WebSocket protocol details like handshake and frame masking automatically
  • Can be terminated with Ctrl+C

Example of connecting to the server with the client:

# In terminal 1, start the server
yawcc s --listen 127.0.0.1:9090 --path /ws

# In terminal 2, connect with the client
yawcc c ws://127.0.0.1:9090/ws

# Now you can send messages that will be echoed back

History

Command history is automatically saved to ~/.yawcc_history and is loaded when the client starts.

Building from Source

git clone https://github.com/infinitefield/yawc
cd yawc/yawcc
cargo build --release

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Dependencies

~23–34MB
~597K SLoC