Skip to main content

Python 3 asyncio Telnet server and client Protocol library

Project description

Travis Continuous Integration Coveralls Code Coverage Latest Version Downloads Join Chat

Introduction

telnetlib3 is a Telnet Client and Server library for python. This project requires python 3.3 and later, using the asyncio module.

Quick Example

Authoring a Telnet Server using Streams interface that offers a basic war game:

import asyncio, telnetlib3

@asyncio.coroutine
def shell(reader, writer):
    writer.write('\r\nWould you like to play a game? ')
    inp = yield from reader.read(1)
    if inp:
        writer.echo(inp)
        writer.write('\r\nThey say the only way to win '
                     'is to not play at all.\r\n')
        yield from writer.drain()
    writer.close()

loop = asyncio.get_event_loop()
coro = telnetlib3.create_server(port=6023, shell=shell)
server = loop.run_until_complete(coro)
loop.run_until_complete(server.wait_closed())

Authoring a Telnet Client that plays the war game with this server:

import asyncio, telnetlib3

@asyncio.coroutine
def shell(reader, writer):
    while True:
        # read stream until '?' mark is found
        outp = yield from reader.read(1024)
        if not outp:
            # End of File
            break
        elif '?' in outp:
            # reply all questions with 'y'.
            writer.write('y')

        # display all server output
        print(outp, flush=True)

    # EOF
    print()

loop = asyncio.get_event_loop()
coro = telnetlib3.open_connection('localhost', 6023, shell=shell)
reader, writer = loop.run_until_complete(coro)
loop.run_until_complete(writer.protocol.waiter_closed)

Command-line

Two command-line scripts are distributed with this package.

telnetlib3-client

Small terminal telnet client. Some example destinations and options:

telnetlib3-client nethack.alt.org
telnetlib3-client --encoding=cp437 --force-binary blackflag.acid.org
telnetlib3-client htc.zapto.org

telnetlib3-server

Telnet server providing the default debugging shell. This provides a simple shell server that allows introspection of the session’s values, for example:

tel:sh> help
quit, writer, slc, toggle [option|all], reader, proto

tel:sh> writer
<TelnetWriter server mode:kludge +lineflow -xon_any +slc_sim server-will:BINARY,ECHO,SGA client-will:BINARY,NAWS,NEW_ENVIRON,TTYPE>

tel:sh> reader
<TelnetReaderUnicode encoding='utf8' limit=65536 buflen=0 eof=False>

tel:sh> toggle all
wont echo.
wont suppress go-ahead.
wont outbinary.
dont inbinary.
xon-any enabled.
lineflow disabled.

tel:sh> reader
<TelnetReaderUnicode encoding='US-ASCII' limit=65536 buflen=1 eof=False>

tel:sh> writer
<TelnetWriter server mode:local -lineflow +xon_any +slc_sim client-will:NAWS,NEW_ENVIRON,TTYPE>

Both command-line scripts accept argument --shell=my_module.fn_shell describing a python module path to a coroutine of signature shell(reader, writer), just as the above examples.

Features

The following RFC specifications are implemented:

  • rfc-727, “Telnet Logout Option,” Apr 1977.

  • rfc-779, “Telnet Send-Location Option”, Apr 1981.

  • rfc-854, “Telnet Protocol Specification”, May 1983.

  • rfc-855, “Telnet Option Specifications”, May 1983.

  • rfc-856, “Telnet Binary Transmission”, May 1983.

  • rfc-857, “Telnet Echo Option”, May 1983.

  • rfc-858, “Telnet Suppress Go Ahead Option”, May 1983.

  • rfc-859, “Telnet Status Option”, May 1983.

  • rfc-860, “Telnet Timing mark Option”, May 1983.

  • rfc-885, “Telnet End of Record Option”, Dec 1983.

  • rfc-1073, “Telnet Window Size Option”, Oct 1988.

  • rfc-1079, “Telnet Terminal Speed Option”, Dec 1988.

  • rfc-1091, “Telnet Terminal-Type Option”, Feb 1989.

  • rfc-1096, “Telnet X Display Location Option”, Mar 1989.

  • rfc-1123, “Requirements for Internet Hosts”, Oct 1989.

  • rfc-1184, “Telnet Linemode Option (extended options)”, Oct 1990.

  • rfc-1372, “Telnet Remote Flow Control Option”, Oct 1992.

  • rfc-1408, “Telnet Environment Option”, Jan 1993.

  • rfc-1571, “Telnet Environment Option Interoperability Issues”, Jan 1994.

  • rfc-1572, “Telnet Environment Option”, Jan 1994.

  • rfc-2066, “Telnet Charset Option”, Jan 1997.

Further Reading

Further documentation available at https://telnetlib3.readthedocs.org/

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

telnetlib3-1.0.1.tar.gz (64.8 kB view details)

Uploaded Source

Built Distribution

telnetlib3-1.0.1-py3-none-any.whl (87.4 kB view details)

Uploaded Python 3

File details

Details for the file telnetlib3-1.0.1.tar.gz.

File metadata

  • Download URL: telnetlib3-1.0.1.tar.gz
  • Upload date:
  • Size: 64.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.21.0 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.1

File hashes

Hashes for telnetlib3-1.0.1.tar.gz
Algorithm Hash digest
SHA256 d94c962414adfd4515abb2263b4cba9f0e9b794f9e692cab408174bca20828f1
MD5 72b572746608d570a98739bc7efe10c0
BLAKE2b-256 59b5dd876427a565680d429e1926fb7520e22adafde8efe4e0d3932373fef52a

See more details on using hashes here.

File details

Details for the file telnetlib3-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: telnetlib3-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 87.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.12.1 pkginfo/1.4.2 requests/2.21.0 setuptools/39.0.1 requests-toolbelt/0.8.0 tqdm/4.28.1 CPython/3.7.1

File hashes

Hashes for telnetlib3-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2048663882300bd00fb44eee85253119adb991b0a72dfdbbda6ebd763f584dbb
MD5 02c25cc9778ff5117ab514fe93177a3a
BLAKE2b-256 056d9ca4b0f10b61d16d95dff6035974a7a676f20b5d7ab7ab7b71e41343f957

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page