A library to support the Internationalised Domain Names in Applications (IDNA) protocol as specified in RFC 5891. This version of the protocol is often referred to as “IDNA2008” and can produce different results from the earlier standard from 2003.
The library is also intended to act as a suitable drop-in replacement for the “encodings.idna” module that comes with the Python standard library but currently only supports the older 2003 specification.
Its basic functions are simply executed:
>>> import idna
>>> idna.encode(u'ドメイン.テスト')
'xn--eckwd4c7c.xn--zckzah'
>>> print idna.decode('xn--eckwd4c7c.xn--zckzah')
ドメイン.テストPackages
The latest tagged release version is published in the PyPI repository:
Installation
To install this library, you can use PIP:
$ pip install idnaAlternatively, you can install the package using the bundled setup script:
$ python setup.py installThis library should work with Python 2.7, and Python 3.3 or later.
Usage
For typical usage, the encode and decode functions will take a domain name argument and perform a conversion to an A-label or U-label respectively.
>>> import idna
>>> idna.encode(u'ドメイン.テスト')
'xn--eckwd4c7c.xn--zckzah'
>>> print idna.decode('xn--eckwd4c7c.xn--zckzah')
ドメイン.テストYou may use the codec encoding and decoding methods using the idna.codec module.
>>> import idna.codec
>>> print u'домена.испытание'.encode('idna')
xn--80ahd1agd.xn--80akhbyknj4f
>>> print 'xn--80ahd1agd.xn--80akhbyknj4f'.decode('idna')
домена.испытаниеConversions can be applied at a per-label basis using the ulabel or alabel functions if necessary:
>>> idna.alabel(u'测试')
'xn--0zwm56d'Compatibility Mapping (UTS #46)
As described in RFC 5895, the IDNA specification no longer including mappings from different forms of input that a user may enter, to the form that is provided to the IDNA functions. This functionality is now a local user-interface issue distinct from the IDNA functionality.
The Unicode Consortium has developed one such user-level mapping, known as Unicode IDNA Compatibility Processing. It provides for both transitional mapping and non-transitional mapping described in this document.
>>> import idna
>>> idna.encode(u'Königsgäßchen')
...
idna.core.InvalidCodepoint: Codepoint U+004B at position 1 of u'K\xf6nigsg\xe4\xdfchen' not allowed
>>> idna.encode(u'Königsgäßchen', uts46=True)
'xn--knigsgchen-b4a3dun'
>>> idna.encode(u'Königsgäßchen', uts46=True, transitional=True)
'xn--knigsgsschen-lcb0w'Note that implementors should use transitional processing with caution as the outputs of the functions may differ from what is expected, as noted in the example.
encodings.idna Compatibility
Function calls from the Python built-in encodings.idna module are mapping to their IDNA 2008 equivalents using the idna.compat module. Simply substitute the import clause in your code to refer to the new module name.
Exceptions
All errors raised during the conversion following the specification should raise an exception derived from the idna.IDNAError base class.
More specific exceptions that may be generated as idna.IDNABidiError when the error reflects an illegal combination of left-to-right and right-to-left characters in a label; idna.InvalidCodepoint when a specific codepoint is an illegal character in an IDN label (i.e. INVALID); and idna.InvalidCodepointContext when the codepoint is illegal based on its positional context (i.e. it is CONTEXTO or CONTEXTJ but the contextual requirements are not satisfied.)
Testing
The library has a test suite based on each rule of the IDNA specification, as well as test that are provided as part of the Unicode Technical Standard 46, Unicode IDNA Compatibility Processing.
The tests are run automatically on each commit to the master branch of the idna git repository at Travis CI:
1 maintainer
Metadata
1 maintainer
Release files for idna 2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| idna-2.0.tar.gz | 135.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| idna-2.0-py2.py3-none-any.whl | Python 3, Python 2 | none | any | Details |
Total release size: 196.5 kB
Release files / idna-2.0.tar.gz
| Download URL | idna-2.0.tar.gz |
|---|---|
| Size | 135.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
16199aad938b290f5be1057c0e1efc6546229391c23cea61ca940c115f7d3d3b
|
|
BLAKE2b-256 checksum How to use checksums |
69275f76009f13c6dda4ed5016cbfebf68773f21374f9792db02821c05326a75
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / idna-2.0-py2.py3-none-any.whl
| Download URL | idna-2.0-py2.py3-none-any.whl |
|---|---|
| Size | 61.3 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
9b2fc50bd3c4ba306b9651b69411ef22026d4d8335b93afc2214cef1246ce707
|
|
BLAKE2b-256 checksum How to use checksums |
7c75b566d769455929ee6ab308d8a1c6c5aecc4928e72b25d42dd019c99f7015
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
