FileSystem/System.pm

filter: Statementstmt 59.2% 16 / 27 Branchbran 0.0% 0 / 4 Conditioncond n/a MC/DCmcdc n/a Subroutinesub 80.0% 4 / 5 Podpod 0.0% 0 / 1 totaltotal 54.0% 20 / 37 CC 4 SCAR 23.5
CC
4
Cov
52%
passwd
20.0
BEGIN
1.0
BEGIN
1.0
CRAP 10.5
« FileSystem.pm ↑ Summary
1 #-----------------------------------------------------------------------
2 # Copyright 2003-2007 Vadim V. Kouevda,
3 # "KAITS, Inc." All rights reserved.
4 #-----------------------------------------------------------------------
5 # $Id: System.pm,v 2.13 2007/03/21 00:11:01 vadim Exp $
6 #-----------------------------------------------------------------------
7 # Authors: Vadim V. Kouevda initdotd@gmail.com
8 #-----------------------------------------------------------------------
9 # Description: This is an add-on definitions for file processing.
10 # It is supposed to handle files, which can be classified as
11 # "system".
12 #-----------------------------------------------------------------------
13  
14 package Tie::FileSystem::System;
15  
16 2 ▶use vars qw($VERSION @ISA @EXPORT);
Subroutine BEGIN: called CC=1 SCAR=0.0
17 2 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
18 2 ▶use Exporter;
Subroutine BEGIN: called CC=1 SCAR=0.0
19 2 ▶use Data::Dumper;
Subroutine BEGIN: called CC=1 SCAR=0.0
20  
21 #-----------------------------------------------------------------------
22  
23 2 $VERSION = sprintf("%d.%d", q$Revision: 2.13 $ =~ /(\d+)\.(\d+)/);
24 2 @ISA = qw(Exporter);
25 2 @EXPORT = qw(passwd);
26  
27 #-----------------------------------------------------------------------
28 # Define file handlers
29 #-----------------------------------------------------------------------
30  
31 0 ▶sub passwd {
Subroutine passwd: not called CC=4 SCAR=30.0
Pod undocumented
32 #-------------------------------------------------------------------
33 # Process /etc/passwd file - this function is "an example"
34 #-------------------------------------------------------------------
35 0 my ($file, $dbg, $size_limit) = @_;
36 0 my %contents;
37 0 my @columns = qw/login passwd uid gid comment home shell/;
38 0 ▶ open FILE, "<$file" or return(undef);
Branch: 1 branch
BranchTrueFalseTotal
open FILE, "<$file" or return undef 0 0 0
39 0 ▶ while (my $line=<FILE>) {
Branch: 1 branch
BranchTrueFalseTotal
if (defined(my $line = readline FILE)) 0 0 0
40 0 chomp($line);
41 0 my @fields = split(/:/, $line);
42 0 foreach my $idx (1 .. 6) {
43 0 $contents{$fields[0]}{$columns[$idx]} = $fields[$idx];
44 }
45 }
46 0 close(FILE);
47 0 return(\%contents);
48 }
49  
50 #-----------------------------------------------------------------------
51 # Plain Old Documentation
52 #-----------------------------------------------------------------------
53  
54 =head1 NAME
55  
56 Tie::FileSystem::System - Helper functions for reading in and processing
57 of system files in the Tie::FileSystem framework.
58  
59 =head1 SYNOPSIS
60  
61 This module is not used separately from Tie::FileSystem.
62  
63 =head1 DESCRIPTION
64  
65 Tie::FileSystem represents file system as a Perl hash. Each hash key
66 corresponds to name of a directory or a file. For example, for a file
67 "/etc/passwd" it will be $data{'etc'}{'passwd'}. Contents of the file
68 "/etc/passwd" becomes a value corresponding to the
69 $data{'etc'}{'passwd'}.
70  
71 Standard handling procedure for directories is to store a listing of
72 files in the directory as keys. Standard procedure for files is to store
73 a contents of the file in the scalar value.
74  
75 For certain files with known structure it is possible to define
76 subroutines for special handling. Tie::FileSystem::System" defines
77 subroutines for handling system files and, for starters, has 'passwd'
78 handling subroutine. "/etc/passwd" can be represented asa hash with
79 following structure: $data{'etc'}{'passwd'}{$username}{$field}.
80  
81 =head1 USING THE MODULE
82  
83 This modules is used internally by Tie::FileSystem.
84  
85 =head1 BUGS
86  
87 None known.
88  
89 =head1 AUTHOR
90  
91 Vadim V. Kouevda, initdotd@gmail.com
92  
93 =head1 LICENSE and COPYRIGHT
94  
95 Copyright (c) 2003-2007, Vadim V. Kouevda, "KAITS, Inc."
96  
97 This library is free software; you may redistribute it and/or modify it
98 under the same terms as Perl itself.
99  
100 These terms are your choice of any of (1) the Perl Artistic Licence, or
101 (2) version 2 of the GNU General Public License as published by the
102 Free Software Foundation, or (3) any later version of the GNU General
103 Public License.
104  
105 This library is distributed in the hope that it will be useful, but
106 WITHOUT ANY WARRANTY; without even the implied warranty of
107 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
108 General Public License for more details.
109  
110 You should have received a copy of the GNU General Public License along
111 with this library program; it should be in the file COPYING. If not,
112 write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330,
113 Boston, MA 02111 USA
114  
115 For licensing inquiries, contact the author at initdotd@gmail.com
116  
117 =head1 WARRANTY
118  
119 Module comes with ABSOLUTELY NO WARRANTY. For details, see the license.
120  
121 =head1 AVAILABILITY
122  
123 The latest version can be obtained from CPAN
124  
125 =head1 SEE ALSO
126  
127 Tie::FileSystem(3)
128  
129 =cut
130  
131 #-----------------------------------------------------------------------
132 # $Id: System.pm,v 2.13 2007/03/21 00:11:01 vadim Exp $
133 #-----------------------------------------------------------------------
134 # $Log: System.pm,v $
135 # Revision 2.13 2007/03/21 00:11:01 vadim
136 # Cleaning POD from KA::Tie::Dir references
137 #
138 # Revision 2.11 2007/03/20 21:17:08 vadim
139 # Convert to Tie:FileSystem name space
140 #-----------------------------------------------------------------------
141 2 1;
« FileSystem.pm ↑ Summary