wssh3 ("wish3") is a command-line utility/shell for WebSocket inpsired by netcat.
- Assumes Python 3.6
It uses currently uses gevent > 0.13, so you may need to install libevent. This is because it uses the great work in ws4py. The gevent websocket server+client in there could probably be generalized to work with Eventlet; then this could be trivially ported to Eventlet to drop the libevent dependency.
If you don't have libevent installed already, install it prior to running setup.py. You can install libevent using apt-get on Ubuntu or brew on a Mac.
sudo apt-get install libevent-dev
install python3.6 from source if it is not already on your system
warning: check for /usr/lib/python3.6/ if it exists, then do NOT execute the commands below
wget https://www.python.org/ftp/python/3.6.3/Python-3.6.3.tgz
tar -xvf Python-3.6.3.tgz
cd Python-3.6.3
sudo ./configure --enable-optimizations
make
sudo make install
make sure pip3 is updated and working with python3.6 and pip3 version 21 or higher, and get gevent
sudo pip3 install --upgrade pip
pip3 install gevent
install the modified version of ws4py-0.2.4 that supports TLS SNI (for SNI support, which you are going to want)
git clone git://github.com/tectract/wssh3.git
cd wssh/ws4py_modified
python3 setup.py install
now install wssh3
cd ..
python3 setup.py install
Listen for WebSocket connections on a particular path and print messages to STDOUT:
wssh3 -l localhost:8000/websocket
example: connect to coinbase BCH-USD socket and see trades from command-line:
echo '{"type":"subscribe","product_ids":["BCH-USD"],"channels":["ticker"]}' | wssh3 -n wss://ws-feed.pro.coinbase.com/ | grep --line-buffered trade_id
Once connected you can use STDIN to send messages. Each line is a message. You can just as well open a peristent client connection that prints incoming messages to STDOUT and sends messages from STDIN interactively:
wssh3 localhost:8000/websocket
if you use wssh3 called from a script, called from your server, check if the webserver / root user can properly access wssh3 and use it properly.
Stream scripts work from the command-line but not from the cron? because root user cannot gracefully call wssh3!
copy gevent, greenlet, zope, ws4py, wssh3 files from .local/lib/python3.6/site-packages/ to /usr/local/lib/python3.6/site-packages then chown -R root:staff /usr/local/lib/python3.6/site-packages now root can run wssh3 without error!
Feel free to fork and improve.
MIT