github.com/liquid-dev/text@v0.3.3-liquid/internal/export/idna/example_test.go (about)

     1  // Copyright 2017 The Go Authors. All rights reserved.
     2  // Use of this source code is governed by a BSD-style
     3  // license that can be found in the LICENSE file.
     4  
     5  package idna_test
     6  
     7  import (
     8  	"fmt"
     9  
    10  	"github.com/liquid-dev/text/internal/export/idna"
    11  )
    12  
    13  func ExampleProfile() {
    14  	// Raw Punycode has no restrictions and does no mappings.
    15  	fmt.Println(idna.ToASCII(""))
    16  	fmt.Println(idna.ToASCII("*.faß.com"))
    17  	fmt.Println(idna.Punycode.ToASCII("*.faß.com"))
    18  
    19  	// Rewrite IDN for lookup. This (currently) uses transitional mappings to
    20  	// find a balance between IDNA2003 and IDNA2008 compatibility.
    21  	fmt.Println(idna.Lookup.ToASCII(""))
    22  	fmt.Println(idna.Lookup.ToASCII("www.faß.com"))
    23  
    24  	// Convert an IDN to ASCII for registration purposes. This changes the
    25  	// encoding, but reports an error if the input was illformed.
    26  	fmt.Println(idna.Registration.ToASCII(""))
    27  	fmt.Println(idna.Registration.ToASCII("www.faß.com"))
    28  
    29  	// Output:
    30  	//  <nil>
    31  	// *.xn--fa-hia.com <nil>
    32  	// *.xn--fa-hia.com <nil>
    33  	//  <nil>
    34  	// www.fass.com <nil>
    35  	//  idna: invalid label ""
    36  	// www.xn--fa-hia.com <nil>
    37  }
    38  
    39  func ExampleNew() {
    40  	var p *idna.Profile
    41  
    42  	// Raw Punycode has no restrictions and does no mappings.
    43  	p = idna.New()
    44  	fmt.Println(p.ToASCII("*.faß.com"))
    45  
    46  	// Do mappings. Note that star is not allowed in a DNS lookup.
    47  	p = idna.New(
    48  		idna.MapForLookup(),
    49  		idna.Transitional(true)) // Map ß -> ss
    50  	fmt.Println(p.ToASCII("*.faß.com"))
    51  
    52  	// Lookup for registration. Also does not allow '*'.
    53  	p = idna.New(idna.ValidateForRegistration())
    54  	fmt.Println(p.ToUnicode("*.faß.com"))
    55  
    56  	// Set up a profile maps for lookup, but allows wild cards.
    57  	p = idna.New(
    58  		idna.MapForLookup(),
    59  		idna.Transitional(true),      // Map ß -> ss
    60  		idna.StrictDomainName(false)) // Set more permissive ASCII rules.
    61  	fmt.Println(p.ToASCII("*.faß.com"))
    62  
    63  	// Output:
    64  	// *.xn--fa-hia.com <nil>
    65  	// *.fass.com idna: disallowed rune U+002A
    66  	// *.faß.com idna: disallowed rune U+002A
    67  	// *.fass.com <nil>
    68  }