Skip to main content

A non-standard internet relay chat program.

Project description

dum-dum-irc

A handcrafted implementation of an internet relay chat without following any conventions or RFC standards.

Changelog | Contributing Guide

Usage

With Python 3.11+ installed, you can get the current stable version on PyPI:

pip install dum-dum-irc

Or if you have Git, you can install the latest in-development version:

pip install git+https://github.com/thegamecracks/dum-dum-irc

Once installed, you can use the dumdum and dumdum-server commands. Running dumdum starts a graphical client which you can use to join Dumdum servers, while dumdum-server is used to host servers of your own. Both support the -h/--help option if you want to see more details:

usage: dumdum [-h] [-v] {appdirs} ...

Start the client interface for connecting to dumdum servers.

positional arguments:
  {appdirs}

options:
  -h, --help     show this help message and exit
  -v, --verbose  Increase logging verbosity
usage: dumdum-server [-h] [-v] [-c CHANNELS [CHANNELS ...]] [--host HOST] [--port PORT] [--cert CERT]

Host a dumdum server.

To use TLS encryption, you must provide a certificate and private key.
This can be specified as either:
1. A single file containing both the private key and certificate:
     --cert hello.pem
2. A pair of certificate and private key files, separated with a colon:
     --cert hello.crt:hello.key

options:
  -h, --help            show this help message and exit
  -v, --verbose         Increase logging verbosity
  -c CHANNELS [CHANNELS ...], --channels CHANNELS [CHANNELS ...]
                        A list of channels
  --host HOST           The address to host on, or all interfaces when not supplied
  --port PORT           The port number to host on (default: 6667)
  --cert CERT           The SSL certificate and private key to use

Implementation

Dumdum consists of two parts:

  1. The Sans-IO protocol, defined in dumdum.protocol
  2. The asyncio wrapper, defined in dumdum.client and dumdum.server

The Sans-IO protocol is responsible for handling the generation and consumption of byte streams, along with producing events from received messages, while the asyncio wrapper is responsible for the actual network communication between the server and its clients.

Protocol

Clients are able to send the following messages:

  1. HELLO: 0x00 | 1-byte version
  2. AUTHENTICATE: 0x02 | varchar nickname (32)
  3. SEND_MESSAGE: 0x03 | varchar channel name (32) | varchar content (1024)
  4. LIST_CHANNELS: 0x04
  5. LIST_MESSAGES: 0x05 | 8-byte before snowflake or 0 | 8-byte after snowflake or 0

Servers are able to send the following messages:

  1. HELLO: 0x00 | 0 or 1 using SSL
  2. INCOMPATIBLE_VERSION: 0x01 | 1-byte version
  3. ACKNOWLEDGE_AUTHENTICATION: 0x02 | 0 or 1 success
  4. SEND_MESSAGE: 0x03 | 8-byte snowflake | varchar channel name (32) | varchar nickname (32) | varchar content (1024)
  5. LIST_CHANNELS: 0x04 | 2-byte length | varchar channel name (32) | ...
  6. LIST_MESSAGES: 0x05 | 3-byte length | same fields after SEND_MESSAGE | ...

Clients must send a HELLO command and wait for the server to respond with HELLO. Afterwards the client must send an AUTHENTICATE command and wait for a successful ACKNOWLEDGE_AUTHENTICATION before they can begin chat communications.

When the client disconnects and reconnects, they MUST re-send hello and re-authenticate with the server.

If the server supports SSL, they can set using SSL in HELLO to indicate that the client should upgrade the connection to SSL. At this point, the protocol should not receive any data until after the SSL handshake is complete.

As this protocol has been intentionally designed to be simple (no timeouts or keep alives), I/O wrappers do not need a significant amount of work to implement it.

TLS Encryption

dumdum-server can use SSL certificates to encrypt connections. For example, if you want to use a self-signed certificate and private key, you can install OpenSSL and run the following command:

openssl req -new -x509 -days 365 -noenc -out dumdum.crt -keyout dumdum.key

After filling out (or skipping) the certificate signing request prompts, you can then run the server with the resulting dumdum.crt and dumdum.key files:

dumdum-server --cert dumdum.crt:dumdum.key

As for the dumdum client, SSL can be enabled by the user before connecting to a server. If the server uses a self-signed certificate, the user will need to download the server's certificate (.crt) and select it.

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

dum_dum_irc-0.4.2.tar.gz (94.8 kB view details)

Uploaded Source

Built Distribution

dum_dum_irc-0.4.2-py3-none-any.whl (39.9 kB view details)

Uploaded Python 3

File details

Details for the file dum_dum_irc-0.4.2.tar.gz.

File metadata

  • Download URL: dum_dum_irc-0.4.2.tar.gz
  • Upload date:
  • Size: 94.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.0 CPython/3.12.4

File hashes

Hashes for dum_dum_irc-0.4.2.tar.gz
Algorithm Hash digest
SHA256 61ff325844a0f3e3fa5f28ea5112b69f13d31fe477969ad41a878d1f082b1509
MD5 6c05243de8a9775c71848eb337755f66
BLAKE2b-256 3821391388f6e5de4a0c3a0440deb41dfee6d059f2d33c87fc783c7e1f3fb754

See more details on using hashes here.

File details

Details for the file dum_dum_irc-0.4.2-py3-none-any.whl.

File metadata

  • Download URL: dum_dum_irc-0.4.2-py3-none-any.whl
  • Upload date:
  • Size: 39.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.0 CPython/3.12.4

File hashes

Hashes for dum_dum_irc-0.4.2-py3-none-any.whl
Algorithm Hash digest
SHA256 a142f4014c015eacb72fcf35cab20dd9e631d3cbe75590c6d8c6e79b7c044ddc
MD5 a501b58c7b4a3f3a63ed52e13987050b
BLAKE2b-256 03524973ce2a9a843b6792e205e479e1dd2534bbd9130b585dbc4abaca691757

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