perl: find vendor versions by support times

[sheet.git] / perl.plp

diff --git a/perl.plp b/perl.plp
index ff3054e679b8575e87d8ecaebaf1fc560cceae89..b5e5d57f48d3eef79adf3d199366742cefa6a587 100644 (file)
--- a/perl.plp
+++ b/perl.plp
@@ -2,7 +2,7 @@
 
 Html({
        title => 'perl version cheat sheet',
-       version => '1.1',
+       version => '1.4',
        keywords => [qw'
                perl version feature features comparison
                sheet cheat overview summary
@@ -14,20 +14,49 @@ Html({
 :>
 <h1>Perl release summary</h1>
 
-<p>The most significant features introduced for recent versions of the Perl scripting language.
-Depending on desired compatibility you'll want to support a minimum of
-<span title="on dinosaur platforms such as Solaris 10, AIX 5.2, RHEL 3, SLES 8">v5.8</span> or
-<span title="on stable servers such as Debian wheezy, Ubuntu 12.04, CentOS 7">v5.14</span>.
-</p>
-
+<p>The most significant features introduced for recent versions of the Perl
+scripting language.
 <:
-my $info = do 'perl.inc.pl' or die $@ // $!;
+my $info = Data('perl');
+
+eval {
+       use List::Util 'first';
+       use Time::Piece;
+       use Time::Seconds;
+       use feature 'signatures';
+       sub linkversion ($v) {
+               return sprintf('%vd', $v);
+       }
+
+       my $now = Time::Piece->new;
+       my $coreeol = ($now - ONE_YEAR * 3)->strftime('%F');
+       my $vcore = first { $info->{$_}{release} ge $coreeol } sort keys %{$info};
+       say "<p>Core security support is provided for 3 years",
+               ", so typical users should run at least $_."
+               for linkversion($vcore);
+
+       my $vendoreol = ($now - ONE_YEAR * 5)->strftime('%F');
+       my $vdebian = first {
+               $info->{$_}{release} ge $vendoreol && $info->{$_}{distro}{debian}
+       } sort keys %{$info};
+       say sprintf "Stable distributions such as Debian %s maintain %s+.",
+               $info->{$_}{distro}{debian}, linkversion($_) for $vdebian;
+
+       my $nowcmp = $now->strftime('%F');
+       my $vdino = first { $info->{$_}{support} ge $nowcmp } sort keys %{$info};
+       say "Enterprise platforms retain versions up to $_."
+               for linkversion($vdino);
+       return 1;
+} or Alert('Missing version recommendations', $@);
+say '</p>';
+
 for my $vernum (reverse sort keys %{$info}) {
        my $verrow = $info->{$vernum};
-       $verrow->{unstable} and next unless exists $get{v};
+       defined $verrow->{unstable} and next unless exists $get{v};
 
-       print '<div class="section">'."\n";
-       printf '<h2>%vd <small>%s</small></h2><dl>'."\n", $vernum, $verrow->{release};
+       say '<div class="section">';
+       say sprintf '<h2>%vd <small>%s</small></h2>', $vernum, $verrow->{release};
+       say '<dl>';
        for (@{ $verrow->{new} }) {
                my ($topic, $desc, $attr) = @{$_};
                if ($attr) {
@@ -47,15 +76,16 @@ for my $vernum (reverse sort keys %{$info}) {
                                        $attr->{experimental}, $title;
                        }
                        if ($attr->{feature}) {
-                               $title = sprintf('<span title="%s">feature</span>', $attr->{feature})
-                                       . (defined $title && ", $title");
+                               my $prefix = sprintf '<span title="%s">feature</span>',
+                                       $attr->{feature};
+                               $title = join ', ', $prefix, $title // ();
                        }
                        $desc .= sprintf ' <em class="ex">(%s)</em>', $title;
                }
-               printf '<dt>%s<dd>%s'."\n", $topic, $desc || '<br/>';
+               say sprintf '<dt>%s<dd>%s', $topic, $desc || '<br/>';
        }
-       printf '<dt>Unicode</dt><dd>v%s'."\n", $_ for $verrow->{unicode} || ();
-       print "</dl>\n";
-       print "</div>\n\n";
+       say sprintf '<dt>Unicode</dt><dd>v%s', $_ for $verrow->{unicode} || ();
+       say '</dl>';
+       say "</div>\n";
 }