https://github.com/shmup/miniboa

An asynchronous, single-threaded, poll-based Telnet server
https://github.com/shmup/miniboa

mud python server tcp

Last synced: 1 day ago
JSON representation

An asynchronous, single-threaded, poll-based Telnet server

• Host: GitHub
• URL: https://github.com/shmup/miniboa
• Owner: shmup
• License: apache-2.0
• Created: 2016-01-19T22:34:11.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2022-09-19T03:24:01.000Z (about 2 years ago)
• Last Synced: 2024-11-04T04:19:11.463Z (10 days ago)
• Topics: mud, python, server, tcp
• Language: Python
• Homepage:
• Size: 138 KB
• Stars: 61
• Watchers: 10
• Forks: 12
• Open Issues: 4
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
===============================

Miniboa: a simple Telnet server

===============================

.. image:: https://github.com/shmup/miniboa/actions/workflows/python-package.yml/badge.svg

   :alt: build status

   :target: https://github.com/shmup/miniboa/actions

.. image:: https://img.shields.io/pypi/v/miniboa.svg

   :target: https://pypi.python.org/pypi/miniboa

   :alt: downloads

-----

What?

-----

Miniboa is a bare-bones Telnet server to use as the base for a MUD or similar interactive server. Miniboa has several nice features for this type of application.

--------

Features

--------

- Asynchronous - no waiting on player input or state.

- Single threaded - light on resources with excellent performance.

- Runs under your game loop - you decide when to poll for data.

- Supports 1000 users under Linux and 512 under Windows (untested).

- Miniboa is compatible with both Python 2.7, and 3.x

-----------

Quick Start

-----------

First:

.. code-block:: bash

    pip install miniboa

And then:

.. code-block:: python

    from miniboa import TelnetServer

    server = TelnetServer()

    while True: server.poll()

But you probably want to do something with the connecting/disconnecting clients:

.. code-block:: python

    clients = []

    def on_connect(client):

        client.send("Hello, my friend. Stay awhile and listen.")

        clients.append(client)

    def on_disconnect(client):

        clients.remove(client)

    server = TelnetServer(

        port=3333,

        address='',

        on_connect=on_connect,

        on_disconnect=on_disconnect

        encoding='utf-8')

    while True:

        server.poll()

To use Miniboa, you create a Telnet Server object listening at a specified port number. You have to provide two functions for the server; the first is a handler for new connections and the second is the handler for lost connections. These handler functions are passed Telnet Client objects -- these are your communication paths to and from the individual player's MUD client.

For example, let's say Mike and Joe connect to your MUD server. Telnet Server will call your on_connect() function with Mike's Telnet Client object, and then again with Joe's Telnet Client object. If Mike's power goes out, Telnet Server will call your on_disconnect() function with Mike's Telnet Client object (same exact one).

This will launch a server listening on the default port, that accepts Telnet connections and sends a simple message.

.. code-block:: bash

    $ telnet localhost 7777

    Trying 127.0.0.1...

    Connected to localhost.

    Escape character is '^]'.

    Hello, my friend. Stay awhile and listen.

Further documentation can be `found here `_.

=========

Copyright

=========

.. code-block:: bash

    Copyright 2009 Jim Storch

    Copyright 2015 Carey Metcalfe

    Copyright 2016 Joseph Schilz

    Copyright 2018 Jared Miller