Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!

A Parser for IRC chat Logs

Project Description

# IRCLogParser

[![Build Status](]( [![Code Climate](]( [![Requirements Status](](

The objective of this project is to utilize social network analysis techniques to examine the relationships between actors on the Internet Relay Chat(IRC) social networking service. The IRCLogParser is an application that accepts IRC log files from different channels and parses them to analyse the principles of interaction between IRC users. Study of these interactions on different levels helps us in deriving the local and global communication patterns between users on different channels. Therefore, IRCLogParser draws its inspiration from various fields such as data mining, graph theory and inferential modeling in order to form predictive models that help in understanding certain intricate characteristics of a social network. This involves analyzing graphs with IRC users(nodes) and their connections(edges), to study the details about various network graph properties such as density, size, node centrality, degree, connectedness etc.

<img src=”./ext/sample_out/kubuntu-devel_4_10_2013_conversation.png” width=”400px”></img> <img src=”./ext/sample_out/infomap_CU.png” width=”400px”></img>

## Usage

The library’s working has been modularised into many modules namely input, analysis, output, visualisation and validation. The [ file](./ very comprehensively presents how one can use IRCLogParser for parsing and analysis.

Some of the visualisable sample outputs can be seen [here](./ext/sample_out/), giving an idea about IRCLogParser’s capabilites.

## Documentation

IRCLogParser uses [Sphinx Python Documentation Genertor]( for generating documentation of the library. The documentation is setup to work with [Google Style Docstrings]( which eases the documentation writing process.

The documentation is deployed on the branch gh-pages who’s updation has been made automatic by the a [bash script](./ext/ which otherwise requires to run make html in docs directory after every commit.

You can view the documentation hosted on gh-pages [here](

## Testing

Presently, IRCLogParser has various end-to-end implemented which reside in the [test directory](./test/). To run the tests locally on your machine, run python -m unittest -v tests in the test directory.

## Installation

IRCLogParser depends on various third-party libraries which are handled by [](./ Run pip -v install -e . in the root directory to install these dependencies.

## License

IRCLogParser is available under the [MIT License](./LISENCE.txt)

Release History

Release History

This version
History Node


History Node


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