ircminer

A python program to mine data from ZNC logs of IRC. For now it creates bar graphs and word clouds.

Usage:

 daneel:logs joe$ ircminer --help 

 usage: ircminer [-h] [--single SINGLE] [--multi MULTI] [--outfile OUTFILE]

                    [--bgimage BGIMAGE] [--limit LIMIT] [--width WIDTH]

                    [--height HEIGHT] [--graph] [--cloud] [--title TITLE]

                    [--exclude EXCLUDE] [--filenames]

 ZNC Log Miner Image Generation

 optional arguments:

   -h, --help         show this help message and exit

   --single SINGLE    Single Source file

   --multi MULTI      keyword for multip[le Source files in the current

                      directory

   --outfile OUTFILE  Destination image file if not specified will be the name

                      of the input file.png

   --bgimage BGIMAGE  Optional image file to shape around

   --limit LIMIT      # of words to display, default 100

   --width WIDTH      Width of image, default 1600

   --height HEIGHT    Height of image, default 1200

   --graph            Create a graph

   --cloud            Create a word cloud

   --title TITLE      Title of Graph

   --exclude EXCLUDE  List of words to exclude, enclose in quotes

   --filenames        Print name of matching files when using multi

To look at one log and create a single wordcloud:

  daneel:logs joe$ ircminer --cloud --single example.log 

  Source file: example.log

  Output file  : examople.log.png

  Result Limit : 100

  IMG Width    : 1600

  IMG Height   : 1200

To create a word cloud from all ZNC logs with the word "example" in the name use the multi switch.

 daneel:logs joe$ ircminer --multi example --cloud 

 Processing files matching pattern *example*.log

 Output file  : example.png

 Result Limit : 100

 IMG Width    : 1600

 IMG Height   : 1200

 Found 118 matching files.

 Processing file : 118 of 118

To create a bar graph from all ZNC logs with the word "example" in the name use --graph with --multi. `

 daneel:logs joe$ ircminer --multi example  --graph  --limit 50 --title "Example Most Common Words" 

 Processing files matching pattern *example*.log

 Result Limit : 50

 Found 118 matching files.

 Processing file : 118 of 118