#!/usr/bin/env perl

use strict;
use warnings;
use utf8;

use open OUT => ':utf8', ':std';
use Data::Dumper;

our $VERSION = '1.03';

# create a hash of desired input
my $di = do 'data/digraphs-rfc.inc.pl'
	or die "error reading digraphs include: ", $@ // $!;

# personal addendums
my $extra = do 'data/digraphs-shiar.inc.pl'
	or warn "could not include shiar proposals: ", $@ // $!;
$di = { %{$di}, %{$extra // {}} };

# optionally get unicode character information
my $uninfo = do 'unicode-char.inc.pl'
	or warn "could not include unicode details: ", $@ // $!;

# convert info hashes into arrays of strings to output in display order
for my $row (values %{$uninfo}) {
	my ($class, $name, $di, $html, $string) = @{$row};
	$row = [$name, $class];
	push @{$row}, '', $string if defined $string;
}

# output perl code of hash
# (assume no backslashes or curlies, so we can just q{} w/o escaping)
print "# automatically generated by $0\n";
print "use utf8;\n";
print "+{\n";
printf '(map {$_=>0} qw{%s}),'."\n", join(' ',
	map { substr($_, 1, 1).substr($_, 0, 1) } sort keys %{$di}
);
printf "q{%s}=>[%s],\n", $_, join(',',
	$di->{$_},   # original code point
	(map {"'$_'"} @{ $uninfo->{ chr $di->{$_} } // [] }),  # optional additional arguments
) for sort keys %{$di};
print "}\n";

__END__

=head1 NAME

mkdigraphlist - Output character list of combined digraph data

=head1 SYNOPSIS

    mkdigraphlist >digraphs.inc.pl
    perl -e'$di = do "digraphs.inc.pl"; print chr $di->{DO}->[0]'

=head1 DESCRIPTION

Parses the official RFC-1345 document, searching the
'character mnemonic table' for all digraph definitions.
If successful, Perl code is output resulting in a hash
with character data keyed by digraph.
Any errors and warnings are given at STDERR.

The value can either be a scalar string containing another
digraph which can be considered identical (usually inverted),
or an array ref containing at least the resulting character's
Unicode code point value.  If available, the following UCD data
is appended: character name, category, script, and output string.
For example:

 +{
   AE => [198, 'LATIN CAPITAL LETTER AE', 'Lu Xl', 'Latin'],
   EA => 'AE',
  }

=head1 AUTHOR

Mischa POSLAWSKY <perl@shiar.org>

=head1 LICENSE

Licensed under the GNU Affero General Public License version 3.