std/c/README.md: Add section skeletons and don't indent lists
[sunny256-utils.git] / mvdirnewest
blobdf48c4d56fd492bcf1f5183fce8ab25a94c3697c
1 #!/usr/bin/env perl
3 #=======================================================================
4 # mvdirnewest
5 # File ID: ab0489f6-f744-11dd-ba4c-000475e441b9
7 # Syntax: mvdirnewest directory
8 # Forandrer navnet på directoryen til den nyeste fila i trestrukturen under.
9 # Brukes til å lage orden i gamle versjoner av ting som ligger slengende rundt.
11 # Character set: UTF-8
12 # ©opyleft 1999– Øyvind A. Holm <sunny@sunbase.org>
13 # License: GNU General Public License version 2 or later, see end of
14 # file for legal stuff.
15 #=======================================================================
17 use strict;
18 use warnings;
19 use Getopt::Long;
21 $| = 1;
23 our $Debug = 0;
25 our %Opt = (
27 'debug' => 0,
28 'help' => 0,
29 'verbose' => 0,
30 'version' => 0,
34 our $progname = $0;
35 $progname =~ s/^.*\/(.*?)$/$1/;
36 our $VERSION = "0.00";
38 Getopt::Long::Configure("bundling");
39 GetOptions(
41 "debug" => \$Opt{'debug'},
42 "help|h" => \$Opt{'help'},
43 "verbose|v+" => \$Opt{'verbose'},
44 "version" => \$Opt{'version'},
46 ) || die("$progname: Option error. Use -h for help.\n");
48 $Opt{'debug'} && ($Debug = 1);
49 $Opt{'help'} && usage(0);
50 if ($Opt{'version'}) {
51 print_version();
52 exit(0);
55 my $RetVal = 0;
58 die("$progname: Unknown version of find(1) or program not found\n") unless (`find --version` =~ /GNU find/);
60 foreach (@ARGV) {
61 $RetVal ||= process_dir($_);
64 exit $RetVal;
66 sub process_dir {
67 my $dir_name = shift;
68 unless (-e $dir_name) {
69 warn("$progname: $dir_name: Directory not found\n");
70 return;
72 unless (-d $dir_name) {
73 warn("$progname: $dir_name: Not a directory\n");
74 return;
76 my $newest_date = 0;
77 my $newest_file = "";
79 # FIXME: Dette med find er midlertidig (og kommer sikkert til å forbli her :)
80 my @Files = `find "$dir_name" -type f`;
81 unless (scalar @Files) {
82 warn("$progname: $dir_name: No files found in directory\n");
83 return;
85 foreach (@Files) {
86 chomp;
87 my $file_name = $_;
88 my @stat_array;
89 unless (@stat_array = stat($file_name)) {
90 warn("$progname: $file_name: Can’t stat file: $!\n");
91 return;
93 my $file_date = $stat_array[9];
94 if ($file_date > $newest_date) {
95 $newest_date = $file_date;
96 $newest_file = $file_name;
98 # printf("$file_name: %s\n", date2str($file_date));
100 my $new_name = sprintf("%s.%s", date2str($newest_date), $dir_name);
101 if (-e $new_name) {
102 warn("$progname: $new_name: Directory entry already exists, skipping directory $dir_name");
103 return;
104 } else {
105 # printf("Skulle til å rename(%s, %s)\n", $dir_name, $new_name);
106 rename($dir_name, $new_name) || warn("$dir_name: Can’t rename directory to $new_name: $!");
107 print("$progname: $dir_name $new_name\n");
109 return(0);
110 } # process_dir()
112 sub date2str {
113 my @TA = gmtime(shift);
114 return(sprintf("%04u%02u%02uT%02u%02u%02uZ", $TA[5]+1900, $TA[4]+1, $TA[3], $TA[2], $TA[1], $TA[0]));
115 } # date2str()
117 sub print_version {
118 # Print program version {{{
119 print("$progname v$VERSION\n");
120 # }}}
121 } # print_version()
123 sub usage {
124 # Send the help message to stdout {{{
125 my $Retval = shift;
127 if ($Opt{'verbose'}) {
128 print("\n");
129 print_version();
131 print(<<END);
133 Usage: $progname directory [directory [...]]
135 The program scans the underlying tree structure and renames the directory
136 to the date of the newest file.
138 Options:
140 -h, --help
141 Show this help.
142 -v, --verbose
143 Increase level of verbosity. Can be repeated.
144 --version
145 Print version information.
146 --debug
147 Print debugging messages.
150 exit($Retval);
151 # }}}
152 } # usage()
154 sub msg {
155 # Print a status message to stderr based on verbosity level {{{
156 my ($verbose_level, $Txt) = @_;
158 if ($Opt{'verbose'} >= $verbose_level) {
159 print(STDERR "$progname: $Txt\n");
161 # }}}
162 } # msg()
164 sub D {
165 # Print a debugging message {{{
166 $Debug || return;
167 my @call_info = caller;
168 chomp(my $Txt = shift);
169 my $File = $call_info[1];
170 $File =~ s#\\#/#g;
171 $File =~ s#^.*/(.*?)$#$1#;
172 print(STDERR "$File:$call_info[2] $$ $Txt\n");
173 return("");
174 # }}}
175 } # D()
177 __END__
179 # Plain Old Documentation (POD) {{{
181 =pod
183 =head1 NAME
185 mvdirnewest
187 =head1 SYNOPSIS
189 mvdirnewest directory [directory [...]]
191 =head1 DESCRIPTION
193 The program scans the underlying tree structure and renames the directory
194 to the date of the newest file.
196 =head1 OPTIONS
198 =over 4
200 =item B<-h>, B<--help>
202 Print a brief help summary.
204 =item B<-v>, B<--verbose>
206 Increase level of verbosity. Can be repeated.
208 =item B<--version>
210 Print version information.
212 =item B<--debug>
214 Print debugging messages.
216 =back
218 =head1 AUTHOR
220 Made by Øyvind A. Holm S<E<lt>sunny@sunbase.orgE<gt>>.
222 =head1 COPYRIGHT
224 Copyleft © Øyvind A. Holm E<lt>sunny@sunbase.orgE<gt>
225 This is free software; see the file F<COPYING> for legalese stuff.
227 =head1 LICENCE
229 This program is free software: you can redistribute it and/or modify it
230 under the terms of the GNU General Public License as published by the
231 Free Software Foundation, either version 2 of the License, or (at your
232 option) any later version.
234 This program is distributed in the hope that it will be useful, but
235 WITHOUT ANY WARRANTY; without even the implied warranty of
236 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
237 See the GNU General Public License for more details.
239 You should have received a copy of the GNU General Public License along
240 with this program.
241 If not, see L<http://www.gnu.org/licenses/>.
243 =head1 SEE ALSO
245 =cut
247 # }}}
249 # vim: set fenc=UTF-8 ft=perl fdm=marker ts=4 sw=4 sts=4 et fo+=w :