]> gb7djk.dxcluster.net Git - spider.git/blob - perl/DXLog.pm
add gitbranch to pc18
[spider.git] / perl / DXLog.pm
1 #
2 # the general purpose logging machine
3 #
4 # This module is designed to allow you to log stuff in specific places
5 # and will rotate logs on a monthly, weekly or daily basis. 
6 #
7 # The idea is that you give it a prefix which is a directory and then 
8 # the system will log stuff to a directory structure which looks like:-
9 #
10 # daily:-
11 #   spots/1998/<julian day no>[.<optional suffix>]
12 #
13 # weekly :-
14 #   log/1998/<week no>[.<optional suffix>]
15 #
16 # monthly
17 #   wwv/1998/<month>[.<optional suffix>]
18 #
19 # Routines are provided to read these files in and to append to them
20
21 # Copyright (c) - 1998 Dirk Koopman G1TLH
22 #
23 #
24 #
25
26 package DXLog;
27
28 require Exporter;
29 @ISA = qw(Exporter);
30 @EXPORT = qw(Log LogDbg Logclose);
31
32 use IO::File;
33 use DXVars;
34 use DXUtil;
35 use Julian;
36
37 use Carp;
38
39 use strict;
40
41 use vars qw($log %logs);
42
43 $log = new('log', 'dat', 'm');
44
45 # create a log object that contains all the useful info needed
46 # prefix is the main directory off of the data directory
47 # sort is 'm' for monthly, 'd' for daily 
48 sub new
49 {
50         my ($prefix, $suffix, $sort) = @_;
51         my $ref = bless {}, __PACKAGE__;
52         localdata_mv($prefix);
53         $ref->{prefix} = "$main::local_data/$prefix";
54         $ref->{suffix} = $suffix if $suffix;
55         $ref->{sort} = $sort;
56         
57         # make sure the directory exists
58         mkdir($ref->{prefix}, 0777) unless -e $ref->{prefix};
59         $logs{$ref} = $ref;
60         
61         return $ref;
62 }
63
64 sub _genfn
65 {
66         my ($self, $jdate) = @_;
67         my $year = $jdate->year;
68         my $thing = $jdate->thing;
69         
70         my $fn = sprintf "$self->{prefix}/$year/%02d", $thing if $jdate->isa('Julian::Month');
71         $fn = sprintf "$self->{prefix}/$year/%03d", $thing if $jdate->isa('Julian::Day');
72         $fn .= ".$self->{suffix}" if $self->{suffix};
73         return $fn;
74 }
75
76 # open the appropriate data file
77 sub open
78 {
79         my ($self, $jdate, $mode) = @_;
80         
81         # if we are writing, check that the directory exists
82         if (defined $mode) {
83                 my $year = $jdate->year;
84                 my $dir = "$self->{prefix}/$year";
85                 mkdir($dir, 0777) if ! -e $dir;
86         }
87
88         $self->{fn} = $self->_genfn($jdate);
89         
90         $mode = 'r' if !$mode;
91         $self->{mode} = $mode;
92         $self->{jdate} = $jdate;
93         
94         my $fh = new IO::File $self->{fn}, $mode, 0666;
95         return undef if !$fh;
96         $fh->autoflush(0);                      # autofluahing off
97         $self->{fh} = $fh;
98
99 #       print "opening $self->{fn}\n";
100         
101         return $self->{fh};
102 }
103
104 sub fn
105 {
106         my ($self, $jdate) = @_;
107         
108         return $self->_genfn($jdate);
109 }
110
111 sub delete($$)
112 {
113         my ($self, $jdate) = @_;
114         my $fn = $self->_genfn($jdate);
115         unlink $fn;
116 }
117
118 sub mtime($$)
119 {
120         my ($self, $jdate) = @_;
121         
122         my $fn = $self->_genfn($jdate);
123         return (stat $fn)[9];
124 }
125
126 # open the previous log file in sequence
127 sub openprev($$)
128 {
129         my $self = shift;
130         my $jdate = $self->{jdate}->sub(1);
131         return $self->open($jdate, @_);
132 }
133
134 # open the next log file in sequence
135 sub opennext($$)
136 {
137         my $self = shift;
138         my $jdate = $self->{jdate}->add(1);
139         return $self->open($jdate, @_);
140 }
141
142 # convert a date into the correct format from a unix date depending on its sort
143 sub unixtoj($$)
144 {
145         my $self = shift;
146         
147         if ($self->{'sort'} eq 'm') {
148                 return Julian::Month->new(shift);
149         } elsif ($self->{'sort'} eq 'd') {
150                 return Julian::Day->new(shift);
151         }
152         confess "shouldn't get here";
153 }
154
155 # write (actually append) to a file, opening new files as required
156 sub write($$$)
157 {
158         my ($self, $jdate, $line) = @_;
159         return unless $self && $jdate;
160         if (!$self->{fh} || 
161                 $self->{mode} ne ">>" || 
162                 $jdate->year != $self->{jdate}->year || 
163                 $jdate->thing != $self->{jdate}->thing) {
164                 $self->open($jdate, ">>") or confess "can't open $self->{fn} $!";
165         }
166
167         return $self->{fh}->print("$line\n");
168 }
169
170 # write (actually append) using the current date to a file, opening new files as required
171 sub writenow($$)
172 {
173         my ($self, $line) = @_;
174         my $t = time;
175         my $date = $self->unixtoj($t);
176         return $self->write($date, $line);
177 }
178
179 # write (actually append) using a unix time to a file, opening new files as required
180 sub writeunix($$$)
181 {
182         my ($self, $t, $line) = @_;
183         my $date = $self->unixtoj($t);
184         return $self->write($date, $line);
185 }
186
187 # close the log file handle
188 sub close
189 {
190         my $self = shift;
191         undef $self->{fh};                      # close the filehandle
192         delete $self->{fh};     
193 }
194
195 sub DESTROY
196 {
197         my $self = shift;
198         delete $logs{$self};
199         undef $self->{fh};                      # close the filehandle
200         delete $self->{fh} if $self->{fh};
201 }
202
203 sub flushall
204 {
205         foreach my $l (values %logs) {
206                 $l->{fh}->flush if exists $l->{fh};
207         }
208 }
209
210 # log something in the system log 
211 # this routine is exported to any module that declares DXLog
212 # it takes all its args and joins them together with the unixtime writes them out as one line
213 # The user is responsible for making sense of this!
214 sub Log
215 {
216         my $t = time;
217         $log->writeunix($t, join('^', $t, @_) );
218 }
219
220 sub LogDbg
221 {
222         my $cat = shift;
223         DXDebug::dbg($_) for @_;
224         Log($cat, @_);
225 }
226
227 sub Logclose
228 {
229         $log->close();
230 }
231 1;