irc-conn

   1 #!/usr/bin/env perl
   2
   3 #=======================================================================
   4 # irc-conn
   5 # File ID: 421f1a82-483d-11e4-9469-c80aa9e67bbd
   6 #
   7 # Show IRC connections, output Graphviz data
   8 #
   9 # Character set: UTF-8
  10 # ©opyleft 2014– Øyvind A. Holm <sunny@sunbase.org>
  11 # License: GNU General Public License version 2 or later, see end of
  12 # file for legal stuff.
  13 #=======================================================================
  14
  15 use strict;
  16 use warnings;
  17 use Getopt::Long;
  18
  19 local $| = 1;
  20
  21 our $Debug = 0;
  22
  23 our %Opt = (
  24
  25     'count' => 1,
  26     'debug' => 0,
  27     'help' => 0,
  28     'verbose' => 0,
  29     'version' => 0,
  30
  31 );
  32
  33 our $progname = $0;
  34 $progname =~ s/^.*\/(.*?)$/$1/;
  35 our $VERSION = '0.00';
  36
  37 Getopt::Long::Configure('bundling');
  38 GetOptions(
  39
  40     'count|c=i' => \$Opt{'count'},
  41     'debug' => \$Opt{'debug'},
  42     'help|h' => \$Opt{'help'},
  43     'verbose|v+' => \$Opt{'verbose'},
  44     'version' => \$Opt{'version'},
  45
  46 ) || die("$progname: Option error. Use -h for help.\n");
  47
  48 $Opt{'debug'} && ($Debug = 1);
  49 $Opt{'help'} && usage(0);
  50 if ($Opt{'version'}) {
  51     print_version();
  52     exit(0);
  53 }
  54 $Opt{'count'} < 1 && die("$progname: -c/--count value has to be at least 1\n");
  55
  56 exit(main(%Opt));
  57
  58 sub main {
  59     # {{{
  60     my %Opt = @_;
  61     my $Retval = 0;
  62     my %used = ();
  63
  64     print("digraph g {\n");
  65     while (my $curr = <>) {
  66         # 20140829T003022Z < HisaoNakai> marmalodak: wat o_
  67         if ($curr =~ /^\S+ <.(\S+?)> (\S+?):\s/) {
  68             my ($from, $to) = ($1, $2);
  69             $from =~ s/\\/&#92;/g;
  70             $from =~ s/"/\\"/g;
  71             $to =~ s/\\/&#92;/g;
  72             $to =~ s/"/\\"/g;
  73             $used{"$from $to"}++;
  74             ($used{"$from $to"} == $Opt{'count'}) && print("\"$from\" -> \"$to\";\n");
  75         }
  76     }
  77     print("}\n");
  78
  79     return($Retval);
  80     # }}}
  81 } # main()
  82
  83 sub print_version {
  84     # Print program version {{{
  85     print("$progname v$VERSION\n");
  86     return;
  87     # }}}
  88 } # print_version()
  89
  90 sub usage {
  91     # Send the help message to stdout {{{
  92     my $Retval = shift;
  93
  94     if ($Opt{'verbose'}) {
  95         print("\n");
  96         print_version();
  97     }
  98     print(<<"END");
  99
 100 Usage: $progname [options] [file [files [...]]]
 101
 102 Create Graphviz data from IRC logs.
 103
 104 Options:
 105
 106   -c X, --count X
 107     Show only connections that have been repeated at least X times.
 108   -h, --help
 109     Show this help.
 110   -v, --verbose
 111     Increase level of verbosity. Can be repeated.
 112   --version
 113     Print version information.
 114   --debug
 115     Print debugging messages.
 116
 117 Examples:
 118   irc-conn irc/2014/09/*.log | xdot
 119   zcat irc/2014/09/*.log.gz | irc-conn -c 50 | dot -o conn.svg -Tsvg
 120   zcat irc/2014/09/*.log.gz | irc-conn -c 50 | dot -Tx11
 121
 122 END
 123     exit($Retval);
 124     # }}}
 125 } # usage()
 126
 127 sub msg {
 128     # Print a status message to stderr based on verbosity level {{{
 129     my ($verbose_level, $Txt) = @_;
 130
 131     if ($Opt{'verbose'} >= $verbose_level) {
 132         print(STDERR "$progname: $Txt\n");
 133     }
 134     return;
 135     # }}}
 136 } # msg()
 137
 138 sub D {
 139     # Print a debugging message {{{
 140     $Debug || return;
 141     my @call_info = caller;
 142     chomp(my $Txt = shift);
 143     my $File = $call_info[1];
 144     $File =~ s#\\#/#g;
 145     $File =~ s#^.*/(.*?)$#$1#;
 146     print(STDERR "$File:$call_info[2] $$ $Txt\n");
 147     return('');
 148     # }}}
 149 } # D()
 150
 151 __END__
 152
 153 # Plain Old Documentation (POD) {{{
 154
 155 =pod
 156
 157 =head1 NAME
 158
 159
 160
 161 =head1 SYNOPSIS
 162
 163  [options] [file [files [...]]]
 164
 165 =head1 DESCRIPTION
 166
 167
 168
 169 =head1 OPTIONS
 170
 171 =over 4
 172
 173 =item B<-h>, B<--help>
 174
 175 Print a brief help summary.
 176
 177 =item B<-v>, B<--verbose>
 178
 179 Increase level of verbosity. Can be repeated.
 180
 181 =item B<--version>
 182
 183 Print version information.
 184
 185 =item B<--debug>
 186
 187 Print debugging messages.
 188
 189 =back
 190
 191 =head1 BUGS
 192
 193
 194
 195 =head1 AUTHOR
 196
 197 Made by Øyvind A. Holm S<E<lt>sunny@sunbase.orgE<gt>>.
 198
 199 =head1 COPYRIGHT
 200
 201 Copyleft © Øyvind A. Holm E<lt>sunny@sunbase.orgE<gt>
 202 This is free software; see the file F<COPYING> for legalese stuff.
 203
 204 =head1 LICENCE
 205
 206 This program is free software: you can redistribute it and/or modify it
 207 under the terms of the GNU General Public License as published by the
 208 Free Software Foundation, either version 2 of the License, or (at your
 209 option) any later version.
 210
 211 This program is distributed in the hope that it will be useful, but
 212 WITHOUT ANY WARRANTY; without even the implied warranty of
 213 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 214 See the GNU General Public License for more details.
 215
 216 You should have received a copy of the GNU General Public License along
 217 with this program.
 218 If not, see L<http://www.gnu.org/licenses/>.
 219
 220 =head1 SEE ALSO
 221
 222 =cut
 223
 224 # }}}
 225
 226 # vim: set fenc=UTF-8 ft=perl fdm=marker ts=4 sw=4 sts=4 et fo+=w :