Project.pm

   1 # $Id$
   2 # Common functions for HTML/XHTML output generation
   3 # Copyright (C) 2003 Jan Kratochvil <project-www.jankratochvil.net@jankratochvil.net>
   4 #
   5 # This program is free software; you can redistribute it and/or modify
   6 # it under the terms of the GNU General Public License as published by
   7 # the Free Software Foundation; exactly version 2 of June 1991 is required
   8 #
   9 # This program is distributed in the hope that it will be useful,
  10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12 # GNU General Public License for more details.
  13 #
  14 # You should have received a copy of the GNU General Public License
  15 # along with this program; if not, write to the Free Software
  16 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  17
  18
  19 package My::Project;
  20 require 5.6.0;  # at least 'use warnings;' but we need some 5.6.0+ modules anyway
  21 our $VERSION=do { my @r=(q$Revision$=~/\d+/g); sprintf "%d.".("%03d"x$#r),@r; };
  22 our $CVS_ID=q$Id$;
  23 use strict;
  24 use warnings;
  25
  26 use My::Web;
  27
  28 use Exporter;
  29 our @EXPORT=qw();
  30 our @ISA=qw(My::Web Exporter);
  31
  32
  33 sub print_project ($)
  34 {
  35 my($class,$ListItem)=@_;
  36
  37         print "<h1>".$ListItem->{"name"}."</h1>\n";
  38         print $ListItem->{"description"};
  39         print "<hr />\n";
  40         my @table=(
  41                 {"key"=>"summary","text"=>"Summary"},
  42                 {"key"=>"license","text"=>"License","format"=>sub ($) {
  43                                 my %known=(
  44                                                 "PD"=>"Public Domain",
  45                                                 "GPL"=>a_href("http://www.gnu.org/licenses/gpl.html","GNU General Public License"),
  46                                                 "LGPL"=>a_href("http://www.gnu.org/licenses/lgpl.html","GNU Lesser General Public License"),
  47                                                 "com"=>"Commercial"
  48                                                 );
  49                                 return $known{$_[0]};
  50                                 }},
  51                 {"key"=>"maintenance","text"=>"State","format"=>sub ($) {
  52                                 my %known=(
  53                                                 "active"=>"Ready to use. Project is now actively developed.",
  54                                                 "ready"=>"Ready to use. Maintained.",
  55                                                 "pending"=>"Patch is ready to be applied to the mainstream.",
  56                                                 "dead"=>"Dead code, no longer supported.",
  57                                                 "merge"=>"Functions belong to existing other project.",
  58                                                 "obsolete"=>"Obsoleted.",
  59                                                 "update"=>"Package needs updating to recent software.",
  60                                                 "accepted"=>"This patch got already integrated by the original package maintainer.",
  61                                                 ""=>"",
  62                                                 );
  63                                 my @r;
  64                                 for ($known{($_[0]=~/^([^-]*)-?/)[0] || ""}) {
  65                                         push @r,$_ if $_;
  66                                         push @r," $'" if $';
  67                                         }
  68                                 return join(" ",@r);
  69                                 }},
  70                 {"key"=>"aminet","text"=>a_href('http://www.aminet.net/','Aminet'),"format"=>sub ($) {
  71                                 return join(" ",
  72                                                 a_href('http://www.aminet.net/'.$_[0].".lha",$_[0].".lha"),
  73                                                 "(".a_href('http://www.aminet.net/'.$_[0].".readme","readme").")");
  74                                 }},
  75                 {"key"=>qr(^download\b),"text"=>sub ($) {
  76                                                 $_[0]=~s/^download//;
  77                                                 $_[0]=~s/^-/ /;
  78                                                 return "Download".$_[0];
  79                                                 },
  80                                 "format"=>sub ($) {
  81                                                 return a_href($_[0],CGI::escapeHTML(File::Basename::basename($_[0])));
  82                                                 }},
  83                 {"key"=>qr(^link\b),"text"=>sub ($) {
  84                                                 $_[0]=~s/^link-//;
  85                                                 return $_[0];
  86                                                 },
  87                                 "format"=>sub ($) {
  88                                                 return a_href($_[0],CGI::escapeHTML($_[0]));
  89                                                 }},
  90                 {"key"=>qr(^cvs\b),"text"=>sub ($) {
  91                                                 $_[0]=~s/^cvs//;
  92                                                 $_[0]=~s/^-/ /;
  93                                                 return "CVS".$_[0];
  94                                                 },
  95                                 "format"=>sub ($$) {
  96                                                 my($val,$key)=@_;
  97                                                 $key=~s/^cvs//;
  98                                                 $key=~s/^-/ /;
  99                                                 my $branch="";
 100                                                 $branch=$1 if $val=~s/:(.*)//;
 101                                                 return join("<br />\n\t\t",
 102                                                                 CGI::escapeHTML("cvs -d ".$W->{"pserver"}.":".$W->{"pserver_path"}." -z3"
 103                                                                                 ." checkout".(!$branch ? "" : " -r $branch -kk")
 104                                                                                 .($val!~m#/# ? "" : " -d ".File::Basename::basename($val))
 105                                                                                 ." $val"),
 106                                                                 join(" | \n\t\t",
 107                                                                                 map({ a_href($_->[1],$_->[0]); }
 108                                                                                                 ["ViewCVS CVS repository",$W->{"project_viewcvs"}.$val."/".(!$branch ? "" : '?only_with_tag='.$branch)],
 109                                                                                                 ["Download CVS snapshot" ,
 110                                                                                                                 $W->{"project_viewcvs"}.$val."/".File::Basename::basename($val).".tar.gz?tarball=1"
 111                                                                                                                                 .(!$branch ? "" : '&only_with_tag='.$branch)],
 112                                                                                                 ["CVS ChangeLog"         ,top_dir()."/project/ChangeLog.txt.pl?cvs=$val"])));
 113                                                 }},
 114                 {"key"=>"ownership","text"=>"Ownership"},
 115                 {"key"=>"sponsorship","text"=>"Sponsorship"},
 116                 {"key"=>"language","text"=>"Programming language","format"=>sub ($) {
 117                                 return a_href("http://java.sun.com/",CGI::escapeHTML($_[0]))
 118                                                 if $_[0]=~/^Java\b/;
 119                                 return a_href("http://www.php.net/",CGI::escapeHTML($_[0]))
 120                                                 if $_[0]=~/^PHP\b/;
 121                                 return undef();
 122                                 }},
 123                 );
 124
 125 sub tableit_func
 126 {
 127 my($tableit,$val,$key,$ListItem)=@_;
 128
 129         delete $ListItem->{$key};
 130         my $r="";
 131         $r.="<tr>";
 132                 if ($tableit->{"text"}) {
 133                         $r.="<td>";
 134                                 $r.=(!ref $_ ? $_ : &{$_}($key)) for ($tableit->{"text"});
 135                         $r.="</td>";
 136                         }
 137                 if ($tableit->{"format"}) {
 138                         do { $val=$_ if defined $_; } for (&{$tableit->{"format"}}($val,$key));
 139                         }
 140                 return join("",map("<tr><td>".$_->[0]."</td><td>".$_->[1]."</td></tr>\n",@$val))
 141                                 if ref $val;
 142                 $r.="<td>$val</td>";
 143         $r.="</tr>\n";
 144 }
 145
 146         print '<table border="0" class="print_project">'."\n";
 147                 for my $tableit (@table) {
 148                         if (!ref $tableit->{"key"}) {
 149                                 print tableit_func($tableit,$ListItem->{$tableit->{"key"}},$tableit->{"key"},$ListItem)
 150                                                 if $ListItem->{$tableit->{"key"}};
 151                                 }
 152                         else {
 153                                 for my $key (@{$ListItem->{"keys_array"}}) {
 154                                         my $keyregex=$tableit->{"key"};
 155                                         next if $key!~/$keyregex/;
 156                                         print tableit_func($tableit,$ListItem->{$key},$key,$ListItem);
 157                                         }
 158                                 }
 159                         }
 160         print "</table>\n";
 161         print vskip;
 162 }
 163
 164 sub project_arr_to_hash (@)
 165 {
 166 my(@arr)=@_;
 167
 168         return (
 169                         @arr,
 170                         "keys_array"=>[ My::Web::arr_keys(@arr) ],
 171                         );
 172 }
 173
 174 # $args{"ListItem"}=\%...;
 175 sub init_project ($%)
 176 {
 177 my($class,%args)=@_;
 178
 179         my $ListItem={ project_arr_to_hash(@{$args{"ListItem"}}) };
 180         my $name=$ListItem->{"name"};
 181         $name=~s#<a\s[^>]*>([^<]*)</a>#$1#g;
 182         my $W=$class->init(
 183                         "title"=>$name,
 184                         %args,
 185                         "head_css"=>($args{"head_css"} || "")."
 186 table.print_project td { vertical-align: top; }
 187 ",
 188                         );
 189         $class->heading();
 190         $class->print_project({ %$ListItem });
 191         return $W;
 192 }
 193
 194 1;