bamlet

Also think it is too much code just to set up a simple TCP-server. Wish there were something just a easy as Flask but more closer to clean TCP. Hopefully bamlet can save your day.

# an example of a TCP-server that answers with pong if you message ping to it

from bamlet import Bamlet

app = Bamlet()

@app.on_message()
def on_message( message ):
    if message == 'ping':
        return 'pong'

def main():
    app.run( 'localhost', 5011 )

Examples

This project comes with some examples.

To run an example execute this command in to project's top folder

python -m examples.example_001_on_message_ping_pong

API

Class	Description
Bamlet	The server.
Client	A client that is connected (or disconnected) to the server.
MessageQueue	A helper that helps retrive "messages" from a client.
Receiver	A helper that helps read buffer from a client.

Bamlet

Method	Arguments	Description
run	host, port	Will start the server.
run_async	host, port	Will start the server asynchronously.
shutdown		Will shutdown server.

Decorators	Arguments	Parameters	Description
@on_message			Handler for each single message from client.
@handle_client	stream_async=True	client, receiver, message_queue	Handler for a the entire connection.

Client

Method	Arguments	Description
send	text	Sends buffer to client.
close	text	Close client connection.

MessageQueue

Method	Arguments	Description
get		Generator that yields messages in queue. Breaks when no more complete messages in queue.
get_async		Generator that yields messages in queue. This is asynchronous and never breaks.