README.md

NAME

ParseUtil::Domain - Domain parser and puny encoder/decoder.

SYNOPSIS

use ParseUtil::Domain ':parse';

  my $processed = parse_domain("somedomain.com");
  #$processed:
  #{
      #domain => 'somedomain',
      #domain_ace => 'somedomain',
      #zone => 'com',
      #zone_ace => 'com'
  #}

DESCRIPTION

This purpose of this module is to parse a domain name into its respective name and tld. Note that the tld may actually refer to a second- or third-level domain, e.g. co.uk or plc.co.im. It also provides respective puny encoded and decoded versions of the parsed domain.

This module uses TLD data from the Public Suffix List which is included with this distribution.

INTERFACE

parse_domain

parse_domain(string) - Examples:

         1. parse_domain('somedomain.com');

          Result:
          {
              domain     => 'somedomain',
              zone       => 'com',
              domain_ace => 'somedomain',
              zone_ace   => 'com'
          }

        2. parse_domain('test.xn--o3cw4h');

          Result:
          {
              domain     => 'test',
              zone       => 'ไทย',
              domain_ace => 'test',
              zone_ace   => 'xn--o3cw4h'
          }

        3. parse_domain('bloß.co.at');

          Result:
          {
              domain     => 'bloss',
              zone       => 'co.at',
              domain_ace => 'bloss',
              zone_ace   => 'co.at'
          }

        4. parse_domain('bloß.de');

          Result:
          {
              domain     => 'bloß',
              zone       => 'de',
              domain_ace => 'xn--blo-7ka',
              zone_ace   => 'de'
          }

        5. parse_domain('www.whatever.com');

         Result:
          {
              domain     => 'www.whatever',
              zone       => 'com',
              domain_ace => 'www.whatever',
              zone_ace   => 'com',
              name       => 'whatever',
              name_ace   => 'whatever',
              prefix     => 'www',
              prefix_ace => 'www'
          }

puny_convert

Toggles a domain between puny encoded and decoded versions.

use ParseUtil::Domain ':simple';

my $result = puny_convert('bloß.de');
# $result: xn--blo-7ka.de

my $reverse = puny_convert('xn--blo-7ka.de');
# $reverse: bloß.de

DEPENDENCIES

Net::IDN::Encode

Net::IDN::Punycode

Regexp::Assemble::Compressed

The Public Suffix List.