Wsock-EmbeddedPy

This is a demo to make use of a simple WebSocket Client with Embedded Python in IRIS.

Prerequisites

Make sure you have git and Docker desktop installed.

Installation

Clone/git pull this repo into any local directory

$ git clone https://github.com/rcemper/Wsock-EmbeddedPy

Open the terminal in this directory and run:

$ docker-compose build

this may take some time to complete

Run the IRIS container with this project:

$ docker-compose up -d

How to Test it

• Run an Iris Session in Docker
• Select your WebSocket Echo Server
• Enter the text you want to send or generate it
• Send it and see the result

$ docker-compose exec iris iris session iris "##class(rccpy.WSockPy).Run()"
*** Welcome to WebSocket Embedded Python Demo ***
Collecting websocket-client

Using cached https://files.pythonhosted.org/packages/4c/5f/f61b420143ed1c8dc69f9eaec5ff1ac36109d52c80de49d66e0c36c3dfdf/websocket_client-0.57.0-py2.py3-none-any.whl

Collecting six (from websocket-client)

Using cached https://files.pythonhosted.org/packages/ee/ff/48bde5c0f013094d729fe4b0316ba2a24774b3ff1c52d924a8a4cb04078a/six-1.15.0-py2.py3-none-any.whl

Installing collected packages: six, websocket-client

Successfully installed six-1.15.0 websocket-client-0.57.0
%%%%%%
Known Hosts (*=Exit) [1]:

1  ws://echo.websocket.org/

2  --- server 2 ----

3  --- server 3 ----

select (1): 1 ==> ws://echo.websocket.org/

Python Connection Object:#

Enter text to get echoed from WebSocketClient Service

Terminate with * at first position

or get generated text by %

or append new text with @
1    hi this is python

2    from IRIS

3    *
Select action for WebSocket Service

Send+Listen(S),New Text(N),Exit(X) [S]S

%%%%%%%%%%%%%%%%%%%%%%%%%%
******* Submit 2 Lines *******

1       send> hi this is python

recv< hi this is python

2       send> from IRIS

recv< from IRIS
Select action for WebSocket Service

Send+Listen(S),New Text(N),Exit(X) [S]n

%%%%%%%%%%%%%%%%%%%%%%%%%%

Enter text to get echoed from WebSocketClient Service

Terminate with * at first position

or get generated text by %

or append new text with @
1    with some more text

2    %

2    * Lorem ipsum dolor sit amet, consectetuer adipiscing

3    * elit, sed diam nonummy nibh euismod tincidunt ut

. . . .

32   * un simplificat Angles, quam

33   * un skeptic Cambridge amico dit me que Occidental es.

34   *
Select action for WebSocket Service

Send+Listen(S),New Text(N),Exit(X) [S]s

%%%%%%%%%%%%%%%%%%%%%%%%%%
******* Submit 33 Lines *******

1       send> with some more text

recv< with some more text

2       send> Lorem ipsum dolor sit amet, consectetuer adipiscing

recv< Lorem ipsum dolor sit amet, consectetuer adipiscing

3       send> elit, sed diam nonummy nibh euismod tincidunt ut

recv< elit, sed diam nonummy nibh euismod tincidunt ut

. . . .

32      send> un simplificat Angles, quam

recv< un simplificat Angles, quam

33      send> un skeptic Cambridge amico dit me que Occidental es.

recv< un skeptic Cambridge amico dit me que Occidental es.
Select action for WebSocket Service

Send+Listen(S),New Text(N),Exit(X) [S]x

%%%%%%%%%%%%%%%%%%%%%%%%%%
$

Hints

%SYS.Python.html is a preliminary class docu to see available functions

run time:
If the standard Python module is not yet installed this is the first action and happens only once.

Article in DC

Demo Server SMP
Demo Server WebTerminal

Code Quality