/usr/share/perl5/IDNA/Punycode.pm is in libidna-punycode-perl 1.100-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 | package IDNA::Punycode;
use strict;
use utf8;
use warnings;
our $VERSION = "1.100";
$VERSION = eval $VERSION;
require Exporter;
our @ISA = qw(Exporter);
our @EXPORT = qw(encode_punycode decode_punycode idn_prefix);
use Carp;
use Net::IDN::Punycode();
use Net::IDN::Nameprep();
# use Net::IDN::Encode();
our $PREFIX = 'xn--';
sub idn_prefix {
$PREFIX = shift;
}
# These functions are copied from Net::IDN::Encode. This allows us to optimise
# Net::IDN::Encode for the static prefix (e.g. by using /o), while we continue
# to support changing the prefix here.
sub _to_ascii {
use bytes;
no warnings qw(utf8); # needed for perl v5.6.x
my $label = shift;
if($label =~ m/[^\x00-\x7F]/) {
$label = Net::IDN::Nameprep::nameprep($label);
croak 'Invalid label (toASCII, step 5)' if $label =~ m/^$PREFIX/i;
$label = $PREFIX.(Net::IDN::Punycode::encode_punycode($label));
}
croak 'Invalid label length (toASCII, step 8)' if
length($label) < 1 ||
length($label) > 63;
return $label;
}
sub _to_unicode {
use bytes;
my $label = shift;
my $result = $label;
eval {
if($label =~ m/[^\x00-\x7F]/) {
$label = Net::IDN::Nameprep::nameprep($label);
}
my $save3 = $label;
croak 'Missing IDNA prefix (ToUnicode, step 3)' unless $label =~ s/^$PREFIX//i;
$label = Net::IDN::Punycode::decode_punycode($label);
my $save6 = _to_ascii($label);
croak 'Invalid label (ToUnicode, step 7)' unless uc($save6) eq uc($save3);
$result = $label;
};
return $result;
}
sub decode_punycode {
if ($PREFIX) {
return _to_unicode(shift);
} else {
return Net::IDN::Punycode::decode_punycode(shift);
}
}
sub encode_punycode {
if ($PREFIX) {
return _to_ascii(shift);
} else {
return Net::IDN::Punycode::encode_punycode(shift);
}
}
1;
__END__
=head1 NAME
IDNA::Punycode - DEPRECATED module for IDNA and Punyode
=head1 DESCRIPTION
This module is deprecated.
Please use L<Net::IDN::Encode> to handle full domain names and
L<Net::IDN::Punycode> for raw I<Punycode> encoding.
This module is provided for compatibility with earlier versions of
C<IDNA::Punycode>.
=head1 FUNCTIONS
The following functions are imported by default. If you also C<use Net::IDN::Punycode>,
be sure to disable import from this module:
use IDNA::Punycode();
=over
=item idn_prefix($prefix)
Sets C<$IDNA::Punycode::PREFIX> to C<$prefix>.
B<Do not use this function> in larger applications or environments
in which multiple application share global variables (such as
L<mod_perl>). Instead, set the variable locally:
local $IDNA::Punycode::PREFIX = 'yo--';
=item encode_punycode($input)
If C<$IDNA::Punycode::PREFIX> is C<''>, encodes C<$input> with
Punycode.
If C<$IDNA::Punycode::PREFIX> is not C<''>, encodes C<$input> with
Punycode and adds the prefix if C<$input> does contain non-base
characters (S<i. e.> characters above U+007F). If C<$input> does
not contain any non-base characters, it is returned as-is.
This function does not do any string preparation as specified by
I<nameprep> or other I<stringprep> profiles. Use
L<Net::IDN::Encode> if you just want to convert a domain name.
This function will croak on invalid input.
=item decode_punycode($input)
If C<$IDNA::Punycode::PREFIX> is C<''>, decodes C<$input> with
Punycode.
If C<$IDNA::Punycode::PREFIX> is not C<''>, checks whether
C<$input> starts with the prefix. If C<$input> starts with the
prefix, the prefix is removed and the remainder is decoded with
Punycode. If C<$input> does not start with the prefix, it is
returned as-is.
Of course, this function does not do any string preparation as
specified by I<nameprep> or other I<stringprep> profiles (or some
sort of de-preparation).
This function will croak on invalid input.
=back
=head1 AUTHORS
Claus FE<auml>rber <CFAERBER@cpan.org>
Previous version written by Tatsuhiko Miyagawa E<lt>miyagawa@bulknews.netE<gt>
and extended by Robert Urban E<lt>urban@UNIX-Beratung.deE<gt>.
=head1 LICENSE
Copyright 2007-2010 Claus FE<auml>rber.
This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.
=head1 SEE ALSO
L<Encode>, L<Net::IDN::Encode>, L<Net::IDN::Punycode>,
S<RFC 3492> (L<http://www.ietf.org/rfc/rfc3492.txt>)
=cut
|