gruftitats
==========
gruftistats is a program to read IRC logs. It produces a web page, with various
statistics and quotes from the channel; the idea was got from the cool
MircStats program.
See the AUTHORS file for credits and contacting information. gruftistats is
free software, see the file COPYING for details.
Get the latest gruftistats information at
http://gruftistats.sourceforge.net/
Usage
-----
First compile (and if you want, install). This is covered in the INSTALL file.
Next, get some IRC logs for your channel. gruftistats supports a few different
log file formats, each described by a spec file. There are several such
files supplied in the formats/ dir of this distribution (installed to
/usr/local/share/gruftistats/). If there isn't one there for your client/bot,
you can write one (TODO: document how :-).
Next, copy the supplied sample.conf (installed to /usr/local/share/gruftistats)
and adapt it for your channel. At least, set the channel name, and your name
and email. The format is hopefully clear :-).
Then, run gruftistats like so:
gruftistats -r your_conf_file -p format_spec_file list_of_log_files >
output.html
Then fire up a browser and see the results. If you want to see the graphics,
copy the .png graphics into the dir with the output.html (they are supplied
in the pipes/ dir of this distribution, or installed to
/usr/local/share/gruftistats/).
For an example (or to be truthful to fit in a credit to the excellent text
browser w3m, which was invaluable in testing gruftistats), here is how I would
do a stats run on my BitchX log of #debian and read it in w3m:
gruftistats -r /usr/local/share/gruftistats/sample.conf -p
/usr/local/share/gruftistats/bitchx.lrx ~/.irclog.\#debian | w3m -T text/html
Writing a log format file
-------------------------
The first thing to do is try your logs with each of the existing format
files in the formats/ dir. If any of them work even partly, that'll save you
some work. bitchx.lrx is the most likely one.
The next thing is to take a look at some of your logs. There are various
things that are worth noting at once:
- If each line in the log isn't time stamped, then gruftistats isn't going
to like it. It may work, but you'll get meaningless crap in the time of day
stuff. Look for an option in the program making the logs to enable time
stamps.
- There should be a date stamp at the start of the log, and at the turning
of each day. This is definitely not essential, but without the per day usage
will be boring :-).
Gather a sample of lines from the log showing each of the following: normal
text, actions (/me), kicks, joins, parts, quits, nick changes, topic sets,
mode changes, and the data stamp.
Now, what you need to write is a .lrx file. This will contain 1 line
specifying the format of each of the above line types. The format of each
line is:
<line_type>=<line_regexp>,<name_part>,<name_part>,...
Yes, it uses regular expressions. Yes, you might need to know regexps to do
this. There are tutorials on the web; also some systems will discuss them in
man egrep or man re_format.
gruftistats has some build in stuff to make life easier:
[[:nick:]] matches any character that's legal in a nickname
[[:uh:]] matches any character that's legal in a user host
How it works is this: gruftistats tries to match each line in the log to
each regexp in the .lrx. If the line matches none, it's ignored. (Use the
-vvv for debugging, to see failed lines).
If a line matches, gruftistats needs to which parts of the line are the
nickname, the text, the time etc. That's where the name_part's some in.
In the regexp, each variable part like the nickname and the text is
bracketed. The name_part's correspond to the bracketed parts, and tell
gruftistats what that part is.
Example:
text=^\[([0-9:]*)\] <([[:nick:]]*)> (.*)$,time,nick,string
This says that normal text lines come in 3 parts in my log: a time (a string
of digits and :'s) enclosed by []'s; a nickname enclosed by <>'s, and the
rest of the string is the text typed. note that there are 3 pairs of ()'s on
the left, one each for time, nick, text, and these are named as such by the
",time,nick,string" at the end.
Well that's about all I have to say. If this is all too much, just post some
examples of your logs to the gruftistats bug tracking system, and wait for
us to add a .lrx for you :-).
ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`
ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`
`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø
`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø
Latest update of this package can be found at http://amiga.sourceforge.net/
ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`
ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`ø°`
`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø
`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø`°ø
········································
·····A·r·c·h·i·v·e··C·o·n·t·e·n·t·s··
LhA Freeware Version 2.2
Copyright © 1991-94 by Stefan Boberg.
Copyright © 1998-2000 by Jim Cooper and David Tritscher.
Listing of archive 'gruftistats-0.2.4.lha':
Original Packed Ratio Date Time Name
-------- ------- ----- --------- -------- -------------
974 349 64.1% 15-Jul-01 19:30:02 +axur.lrx
921 364 60.4% 24-Jun-01 10:48:16 +dancer.lrx
1083 471 56.5% 06-Feb-00 13:45:08 +eggdrop-1.4.x-mel.lrx
1029 396 61.5% 06-Feb-00 11:31:28 +eggdrop2.lrx
991 375 62.1% 27-Feb-00 15:29:56 +grufti.lrx
889 355 60.0% 16-Sep-01 10:46:08 +irssi-some-theme.lrx
927 379 59.1% 16-Sep-01 10:46:08 +irssi.lrx
927 398 57.0% 26-Apr-00 07:43:32 +xchat.lrx
1898 1005 47.0% 11-Aug-01 11:39:06 AUTHORS
1073 459 57.2% 20-Jan-00 22:31:52 +bitchx.lrx
161 161 0.0% 02-Dec-99 18:47:20 +pipe1h.png
144 144 0.0% 02-Dec-99 18:47:20 +pipe1v.png
161 161 0.0% 02-Dec-99 18:47:20 +pipe2h.png
144 144 0.0% 02-Dec-99 18:47:20 +pipe2v.png
161 161 0.0% 02-Dec-99 18:47:20 +pipe3h.png
144 144 0.0% 02-Dec-99 18:47:20 +pipe3v.png
161 161 0.0% 02-Dec-99 18:47:22 +pipe4h.png
144 144 0.0% 02-Dec-99 18:47:22 +pipe4v.png
4986 2415 51.5% 16-Sep-01 10:50:08 ChangeLog
18007 7009 61.0% 01-Oct-99 22:14:12 COPYING
63540 31897 49.8% 31-Dec-01 07:46:50 gruftistats.020
63116 31620 49.9% 31-Dec-01 07:39:00 gruftistats.060
3050 1356 55.5% 11-Aug-01 11:38:44 gruftistats.1
933 513 45.0% 31-Dec-01 07:15:04 gruftistats.spec
1804 886 50.8% 16-Sep-01 10:50:30 NEWS
1759 843 52.0% 11-Mar-00 13:32:02 README
2614 1265 51.6% 16-Mar-00 08:54:50 README.log-formats
636 388 38.9% 11-Aug-01 12:09:42 sample.conf
-------- ------- ----- --------- --------
172377 83963 51.2% Operation successful.
_____________________________
.Readme created with: MRea \
==============================================================================
>»>»>»>»> Some additional info about this archive:
Source: http://prdownloads.sf.net/amiga/gruftistats-0.2.4.lha?download
FileSize: 85066 Bytes
CRC: 50806D24
MD5: A8E8FF438071891D27107782C1C466F8
SHA: 3EFF5E0262EE0CD87087277B8BE64242FDDA0F33
==============================================================================
|
