blob: 7c6105bdc274395d3f5f9afcbee2d5d7a41d09b5 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
|
package FS::Conf;
use vars qw($default_dir);
use IO::File;
=head1 NAME
FS::Conf - Read access to Freeside configuration values
=head1 SYNOPSIS
use FS::Conf;
$conf = new FS::Conf "/config/directory";
$FS::Conf::default_dir = "/config/directory";
$conf = new FS::Conf;
$dir = $conf->dir;
$value = $conf->config('key');
@list = $conf->config('key');
$bool = $conf->exists('key');
=head1 DESCRIPTION
Read access to Freeside configuration values. Keys currently map to filenames,
but this may change in the future.
=head1 METHODS
=over 4
=item new [ DIRECTORY ]
Create a new configuration object. A directory arguement is required if
$FS::Conf::default_dir has not been set.
=cut
sub new {
my($proto,$dir) = @_;
my($class) = ref($proto) || $proto;
my($self) = { 'dir' => $dir || $default_dir } ;
bless ($self, $class);
}
=item dir
Returns the directory.
=cut
sub dir {
my($self) = @_;
my $dir = $self->{dir};
-e $dir or die "FATAL: $dir doesn't exist!";
-d $dir or die "FATAL: $dir isn't a directory!";
-r $dir or die "FATAL: Can't read $dir!";
-x $dir or die "FATAL: $dir not searchable (executable)!";
$dir;
}
=item config
Returns the configuration value or values (depending on context) for key.
=cut
sub config {
my($self,$file)=@_;
my($dir)=$self->dir;
my $fh = new IO::File "<$dir/$file" or return;
if ( wantarray ) {
map {
/^(.*)$/
or die "Illegal line (array context) in $dir/$file:\n$_\n";
$1;
} <$fh>;
} else {
<$fh> =~ /^(.*)$/
or die "Illegal line (scalar context) in $dir/$file:\n$_\n";
$1;
}
}
=item exists
Returns true if the specified key exists, even if the corresponding value
is undefined.
=cut
sub exists {
my($self,$file)=@_;
my($dir) = $self->dir;
-e "$dir/$file";
}
=back
=head1 BUGS
Write access (with locking) should be implemented.
=head1 SEE ALSO
config.html from the base documentation contains a list of configuration files.
=cut
1;
|
