# python-irclib

**Category:** mIRC_Bot  
**Original Author:** Joel Rosdahl

## Description
`python-irclib` is a Python library for writing IRC bots. It provides an event-driven framework to handle IRC protocol messages, CTCP, and DCC connections.

## Key Features
- Handles multiple simultaneous IRC server connections.
- Supports server PONGing transparently.
- Allows sending messages to the IRC server by calling methods on an IRC connection object.
- Triggers events that can be caught by event handlers.
- Supports reading from and writing to IRC server sockets using an internal select() loop.
- Provides a simple, single-server, object-oriented IRC client class for bot automation.

## File Analysis
- **pavement.py** — Manages the project build process, including uploading the project web page.
- **setup.cfg** — Configuration file for setuptools.
- **setup.py** — Script to set up and install the library using setuptools.
- **__init__.py** — Empty file indicating that this directory is a Python package.
- **test_ircbot.py** — Unit tests for the IRC bot functionality.
- **test_irclib.py** — Unit tests for the IRC protocol client library.
- **testbot.py** — Example program demonstrating how to use the SingleServerIRCBot class from `ircbot.py`.
- **ircbot.py** — Main module providing the SingleServerIRCBot class and other utility functions.
- **irclib.py** — Low-level IRC protocol client library.
- **SOURCES.txt** — Lists all source files included in the distribution.
- **dependency_links.txt** — Empty file indicating no external dependencies.
- **top_level.txt** — Specifies top-level packages for setuptools.
- **README** — Project documentation and installation instructions.