Skip to content

A Python helper module for named pipes on Windows that supports reader, writer, master, and slave modes.

Notifications You must be signed in to change notification settings

mark3982/pywpipe

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 

Repository files navigation

PyWPipe

This module makes it much cleaner and easier to use named pipes under Windows. It does not offer a feature rich API, but I may add more methods to support various other features such as setting the security of the pipe and support byte mode. At the moment only message mode is supported.

API

wpipe.Server(name, mode, *, maxclients = 5, maxmessagesz = 4096, maxtime = 100):
wpipe.Client(name, mode, *, maxmessagesz = 4096)

Examples

An example of a master and slave pipe mode.

import wpipe

The server code:

pserver = wpipe.Server('mypipe', wpipe.Mode.Slave)
while True:
    for client in pserver:
        while client.canread():
            rawmsg = client.read()
            client.write(b'hallo')    
    pserver.waitfordata()
pserver.shutdown()

The client code:

pclient = wpipe.Client('mypipe', wpipe.Mode.Master)
while True:
    pclient.write(b'hello')
    reply = pclient.read()
pclient.close()

The client blocks on pclient.read but you can perform a non-blocking operation by using pclient.canread before. The server client items are removed if the pipe is dead and no data can be read, so they will not be iterated over. For example if the client sent some data and then closed the connection the server could still read the data but any future reads would throw an exception.

In master and slave mode a single write or read is allowed before performing the opposite operation. The master writes a message and is then expected to read one message, and the slave reads one message and is expected to write one message.

You may notice the server is placed into slave mode and the client into master which may seem backwards however in some cases this is desired and useful. You could place the server into master mode and the client into slave mode.

Also Mode.Reader and Mode.Writer are supported making the pipe essentially uni-directional. I may in a future release tweak this to possibly allow a association method to tie together two pipes in this mode connected to a server.

About

A Python helper module for named pipes on Windows that supports reader, writer, master, and slave modes.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages