X-Git-Url: http://git.shiar.net/sheet.git/blobdiff_plain/6b443abb1ebf8f9a7902eb53911ab26201e5e7ab..refs/tags/v1.19:/perl.plp?ds=inline
diff --git a/perl.plp b/perl.plp
index 255032a..0ee9639 100644
--- a/perl.plp
+++ b/perl.plp
@@ -2,24 +2,142 @@
Html({
title => 'perl version cheat sheet',
- version => 'v1.0',
+ version => '1.7',
keywords => [qw'
perl version feature features comparison
sheet cheat overview summary
'],
stylesheet => [qw'light dark red'],
+ data => ['perl.inc.pl'],
});
+use experimental 'signatures';
:>
-
Perl cheat sheets
+Perl release summary
+The most significant features introduced for recent versions of the Perl
+scripting language.
<:
-my $info = do 'perl.inc.pl' or die $@ // $!;
-for my $ver (reverse sort keys %{$info}) {
- print '
'."\n";
- printf '
%vd
'."\n", $ver;
- printf '- %s
- %s', Entity(@{$_}), '
' for @{ $info->{$ver} };
- print "
\n";
- print "
\n\n";
+my $info = Data('perl');
+
+use feature 'signatures';
+sub vname ($v) {
+ return sprintf 'v%d%03d', unpack 'C*', $v;
+}
+sub linkversion ($v) {
+ return showlink(sprintf('%vd', $v), '#'.vname($v));
}
+eval {
+ use List::Util 'first';
+ use Time::Piece;
+ use Time::Seconds;
+
+ my $now = Time::Piece->new;
+ if (my $ts = $get{at}) {
+ $now = $now->strptime($ts, '%Y-%m-%d');
+ say "Compatibility details emulated for $ts.";
+ }
+ my $ts = $now->strftime('%F');
+ my @versions = sort grep { $info->{$_}{release} le $ts } keys %{$info};
+
+ # perlpolicy: «We "officially" support the two most recent stable release
+ # series. [...] we will attempt to fix critical issues»
+ $info->{ $versions[-2] }{versum} //= "active core support";
+ $info->{ $versions[-1] }{versum} //= "latest stable release";
+
+ # perlpolicy: «we will attempt to fix critical issues in the two most
+ # recent stable 5.x release series»
+ my $coreeol = ($now - ONE_YEAR * 3)->strftime('%F');
+ my $vcore = first { $info->{$_}{release} ge $coreeol } @versions;
+ print "Core security support is provided for 3 years";
+ print ", so typical users should run at least ", linkversion($_)
+ for $vcore // ();
+ say '.';
+ $info->{$vcore}{versum} //= "official security patches";
+
+ # «We encourage vendors to ship the most recent supported release of Perl
+ # at the time of their code freeze»
+ # assume debian ships after 1 year, and expires after 5 years LTS
+ my $vendoreol = ($now - ONE_YEAR * 6)->strftime('%F');
+ my $vdebian = first {
+ $info->{$_}{release} ge $vendoreol && $info->{$_}{distro}{debian}
+ } @versions;
+ say sprintf "Stable distributions such as Debian %s maintain %s+.",
+ $info->{$_}{distro}{debian}, linkversion($_) for $vdebian // ();
+ $info->{$vdebian}{versum} //= "still maintained by common vendors";
+
+ # extended support given at random
+ my $nowcmp = $now->strftime('%F');
+ my $vdino = first { $info->{$_}{support} ge $nowcmp } @versions;
+ say "Enterprise platforms retain versions up to $_."
+ for map { linkversion($_) } $vdino // ();
+ return 1;
+} or Alert('Missing version recommendations', $@);
+say '
';
+
+for my $vernum (reverse sort keys %{$info}) {
+ my $verrow = $info->{$vernum};
+ defined $verrow->{unstable} and next unless exists $get{v};
+
+ say sprintf '', vname($vernum);
+ my $title = $verrow->{release} // '?';
+ $title .= ": $_" for $verrow->{versum} // ();
+ say sprintf '
%vd %s
', $vernum, $title;
+ say '
';
+ for (@{ $verrow->{new} }) {
+ my ($topic, $desc, $attr) = @{$_};
+ $desc .= featattrs($attr);
+ my $ref = defined $attr->{name} && sprintf ' id="%s"', $attr->{name};
+ say sprintf '- %s
- %s', $ref, $topic, $desc || '
';
+ }
+ if (my $mods = $verrow->{modules}) {
+ for (@{$mods}) {
+ my ($name, $desc, $attr) = @{$_};
+ my $ref = lc $name =~ s/::/_/gr;
+ $desc .= featattrs($attr);
+ printf ' use %s
', $ref, $name;
+ say '- ', $desc;
+ }
+ }
+ say sprintf '
- Unicode
- v%s', $_ for $verrow->{unicode} || ();
+ say '
';
+ say "
\n";
+}
+
+sub featattrs ($attr) {
+ $attr or return '';
+ ref $attr or $attr = {eg => $attr};
+ my $title;
+ if (defined $attr->{experimental}) {
+ $title = 'experimental';
+ }
+ if (defined $attr->{dropped}) {
+ no warnings 'exiting';
+ next unless exists $get{v}; # skip containing feature
+ $title = sprintf 'removed in %vd', $_ for $attr->{dropped} || ();
+ }
+ elsif ($attr->{stable}) {
+ $title .= sprintf ' until %vd', $attr->{stable};
+ }
+ if ($attr->{experimental}) {
+ $title = sprintf '%s',
+ $attr->{experimental}, $title;
+ $attr->{name} //= $attr->{experimental};
+ }
+ if ($attr->{feature}) {
+ my $prefix = sprintf 'feature',
+ $attr->{feature};
+ $title = join ', ', $prefix, $title // ();
+ $attr->{name} //= $attr->{feature};
+ }
+ $title = $title ? sprintf ' (%s)', $title : '';
+
+ if (my $eg = $attr->{eg}) {
+ my $pre = Entity($eg);
+ $pre =~ s<\N{ZERO WIDTH SPACE}>{}g;
+ $pre = " {$pre
}";
+ $title = $pre . $title;
+ }
+ return $title;
+}