NAME

ParseUtil::Domain - Utility for parsing a domain name into its components.

SYNOPSIS

use ParseUtil::Domain ':parse';

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

DESCRIPTION

A tool for parsing domain names. This module makes use of the data provided by the Public Suffix List (http://publicsuffix.org/list/) to parse tlds.

It also provides respective puny encoded and decoded versions of the parsed domain.

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'
   }

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 at http://publicsuffix.org/list/

CHANGES

• gTLDs

  .bcm, .design, .kiwi and several others

• Added a subroutine puny_convert that toggles back and forth between puny encoded and decoded versions of a domain.

• Added a script called punyconvert for command line conversion.

• croak whenever the domain can't be mapped back to itself.