girc 0.4.0

Features

This library is in development, so these features may be in various levels of completion right now.

• Incoming and outgoing events.

• Info and state tracking.

• Server-based IRC mapping for dicts, lists, and strings.

• IRCv3 capability support.

• Escaping and unescaping IRC formatting for ease-of-use (bold, colours, etc).

Why?

I’ve been using another IRC library for a long time. It’s been pretty good, but I need more features. Handling both incoming and outgoing messages, automatic information tracking, converting IRC formatting (bold/colours/etc) to and from an escaped, human-readable and writable format.

I’ve looked at some other libraries, but they’re usually either too low-level, too involved, or too ‘magic’ for my liking. That said, this one is planning to be pretty magic, but it’s going to be magic in a way I think makes sense.

So I decided to write my own. As part of mammon-ircd, a nice low-level library called ircreactor was developed. This is also a chance to give that a spin from the client side, rather than the server side.

Running Tests

To run the test cases, go to the tests directory and run: python3 -m unittest, or use the ./runtests shell script (which also produces coverage graphs).

Acknowledgements

We bundle the ircreactor library developed as a part of mammon-ircd. This license for this library can be found in the LICENSE.ircreactor file.