Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

A modern Python IRC library for Python 3.4, based on asyncio. In Development.

Project Description

A modern Python IRC library for Python 3.4, based on asyncio. Currently in alpha.



If you use this, anything can change without notice, everything can be overhauled, and development may even stop entirely without any warning.

If you would like to help build this, awesome! Otherwise, I’d stay away for now and use another library: irc, irc3.

Hosted Documentation

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.

Release History

Release History

This version
History Node

0.3.1

History Node

0.3.0

History Node

0.2.1

History Node

0.2.0

History Node

0.1.0

History Node

0.0.0

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
girc-0.3.1.tar.gz (30.5 kB) Copy SHA256 Checksum SHA256 Source Aug 3, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting