File: usage.rst

package info (click to toggle)
domain2idna 1.12.4-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 288 kB
  • sloc: python: 588; makefile: 23
file content (61 lines) | stat: -rw-r--r-- 1,897 bytes parent folder | download | duplicates (3)
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
Usage
=====

As a Python module
------------------

Here's an example which show us how domain2idna can be used a python module.

::

    #!/usr/bin/env python3

    """
    This module uses domains2idna to convert a given domain.

    Author:
        Nissar Chababy, @funilrys, contactTATAfunilrysTODTODcom

    Contributors:
        Let's contribute to this example!!

    Repository:
        https://github.com/PyFunceble/domain2idna
    """
    from domain2idna import domain2idna

    DOMAINS = [
        "bittréẋ.com", "bịllogram.com", "coinbȧse.com", "cryptopiạ.com", "cṙyptopia.com"
    ]

    # The following return the result of the whole list.
    print("UTF-8 domains: %s" % DOMAINS)
    print("Converted domains: %s" % domain2idna(DOMAINS))

    # The following return the result of only one element.
    print("UTF-8 domain: %s" % DOMAINS[0])
    print( "Converted domain: %s" % domain2idna(DOMAINS[0]))

From a terminal
---------------

Here is the list of available command when calling :code:`domain2idna` from a terminal.

::

    usage: domain2idna [-h] [-s SUBJECT [SUBJECT ...]] [-e ENCODING] [-f FILE] [-o OUTPUT] [-v]

    domain2idna - The tool to convert a domain or a file with a list of domain to the famous IDNA format.

    optional arguments:
        -h, --help            show this help message and exit
        -s SUBJECT [SUBJECT ...], --subject SUBJECT [SUBJECT ...]
                                Sets the subjects to convert.
        -e ENCODING, --encoding ENCODING
                                Sets the encoding to use.
        -f FILE, --file FILE  Sets the file to read to get the domain(s) to convert.
        -o OUTPUT, --output OUTPUT
                                Sets the file where we write the converted domain(s).
        -v, --version         show program's version number and exit

    Crafted with ♥ by Nissar Chababy (Funilrys)