blib/lib/App/WRT/Date.pm

filter: Statementstmt 97.4% 38 / 39 Branchbran 75.0% 3 / 4 Conditioncond n/a MC/DCmcdc n/a Subroutinesub 100% 9 / 9 Podpod 100% 5 / 5 totaltotal 96.4% 55 / 57 CC 4 SCAR 5.3
CC
4
Cov
95%
get_mtime
3.1
get_date
2.0
BEGIN
1.0
CRAP 1.7
« blib/lib/App/WRT/FileIO.pm ↑ Summary lib/App/WRT/Mock/FileIO.pm »
1 package App::WRT::Date;
2  
3 10 ▶use strict;
Subroutine BEGIN: called CC=1 SCAR=0.0
4 10 ▶use warnings;
Subroutine BEGIN: called CC=1 SCAR=0.0
5  
6 10 ▶use base qw(Exporter);
Subroutine BEGIN: called CC=1 SCAR=0.0
7 10 our @EXPORT_OK = qw(iso_date rfc_3339_date get_date get_mtime month_name);
8  
9 10 ▶use POSIX qw(strftime);
Subroutine BEGIN: called CC=1 SCAR=0.0
10  
11 =head1 NAME
12  
13 App::WRT::Date - a small collection of date utility functions
14  
15 =head2 FUNCTIONS
16  
17 =over
18  
19 =item rfc_3339_date($time)
20  
21 Return an RFC 3339 date string for the given epoch time.
22  
23 L<https://www.ietf.org/rfc/rfc3339.txt>
24  
25 =cut
26  
27 1 ▶sub rfc_3339_date {
Subroutine rfc_3339_date: called CC=1 SCAR=0.0
Pod documented
28 1 my ($time) = @_;
29 1 my $time_str = strftime('%Y-%m-%dT%H:%M:%S%z', localtime($time));
30  
31 # HACK: Add a : to the last 4 digits, because apparently this isn't supported
32 # by POSIX strftime().
33 1 $time_str =~ s/(\d{2})(\d{2})$/$1:$2/x;
34 1 return $time_str;
35 }
36  
37 =item iso_date($time)
38  
39 Return an ISO 8601 date string for the given epoch time.
40  
41 =cut
42  
43 1 ▶sub iso_date {
Subroutine iso_date: called CC=1 SCAR=0.0
Pod documented
44 1 my ($time) = @_;
45 1 return strftime("%Y-%m-%dT%H:%M:%SZ", localtime($time));
46 }
47  
48 =item get_mtime(@filenames)
49  
50 Return one or more mtimes for a given list of files.
51  
52 =cut
53  
54 1 ▶sub get_mtime {
Subroutine get_mtime: called CC=3 SCAR=11.3
Pod documented
55 1 my (@filenames) = @_;
56  
57 1 my @mtimes;
58 1 for my $filename (@filenames) {
59 #my( $dev, $ino, $mode, $nlink, $uid, $gid, $rdev, $size,
60 # $atime, $mtime, $ctime, $blksize, $blocks )
61 # = stat( $filename );
62  
63 1 push @mtimes, (stat $filename)[9];
64 }
65  
66 # return a list if we've got more than one, a scalar
67 # otherwise. is this evil? or even necessary?
68 1 ▶ if (@mtimes > 1) {
Branch: 1 branch
BranchTrueFalseTotal
if (@mtimes > 1) { } 0 1 1
69 0 return @mtimes;
70 } else {
71 1 return $mtimes[0];
72 }
73 }
74  
75 =item month_name($number)
76  
77 Turn numeric months into English names.
78  
79 =cut
80  
81 {
82 # "Null" is here so that $month_name[1] corresponds to January, etc.
83 10 my @months = qw(Null January February March April May June
84 July August September October November December);
85  
86 1 ▶ sub month_name {
Subroutine month_name: called CC=1 SCAR=0.0
Pod documented
87 1 my ($number) = @_;
88 1 return $months[$number];
89 }
90 }
91  
92 =item get_date('key', 'other_key', ...)
93  
94 Return current date values for the given key. Valid keys are sec, min, hour,
95 mday (day of month), mon, year, wday (day of week), yday (day of year), and
96 isdst (is daylight savings).
97  
98 Remember that year is given in years after 1900.
99  
100 =cut
101  
102 # Below replaces:
103 # my ($sec, $min, $hour, $mday, $mon,
104 # $year, $wday, $yday, $isdst) = localtime(time);
105 {
106 10 my %name_map = (
107 sec => 0, min => 1, hour => 2, mday => 3,
108 mon => 4, year => 5, wday => 6, yday => 5,
109 isdst => 6,
110 );
111  
112 2 ▶ sub get_date {
Subroutine get_date: called CC=2 SCAR=6.9
Pod documented
113 2 my (@names) = @_;
114 2 my (@indices) = @name_map{@names};
115 2 my (@values) = (localtime time)[@indices];
116  
117 2 ▶ if (wantarray()) {
Branch: 1 branch
BranchTrueFalseTotal
if (wantarray) { } 1 1 2
118 # my ($foo, $bar) = get_date('foo', 'bar');
119 1 return @values;
120 } else {
121 # this is probably useless unless you're getting just one value
122 1 return join '', @values;
123 }
124 }
125 }
126  
127 =back
128  
129 =cut
130  
131 10 1;
« blib/lib/App/WRT/FileIO.pm ↑ Summary lib/App/WRT/Mock/FileIO.pm »