tld · PyPI

Extract the top level domain (TLD) from the URL given.

These details have not been verified by PyPI

Project links

Homepage

Project description

Extract the top level domain (TLD) from the URL given. List of TLD names is taken from Mozilla.

Optionally raises exceptions on non-existing TLDs or silently fails (if fail_silently argument is set to True).

MPL-1.1 OR GPL-2.0-only OR LGPL-2.1-or-later

Prerequisites

Python 2.7, 3.4, 3.5, 3.6, 3.7 and PyPy

Documentation

Documentation is available on Read the Docs.

Installation

Latest stable version on PyPI:

pip install tld

Or latest stable version from GitHub:

pip install https://github.com/barseghyanartur/tld/archive/stable.tar.gz

Or latest stable version from BitBucket:

pip install https://bitbucket.org/barseghyanartur/tld/get/stable.tar.gz

Usage examples

In addition to examples below, see the jupyter notebook workbook file.

Get the TLD name as string from the URL given

from tld import get_tld

get_tld("http://www.google.co.uk")
# 'co.uk'

get_tld("http://www.google.idontexist", fail_silently=True)
# None

Get the TLD as an object

from tld import get_tld

res = get_tld("http://some.subdomain.google.co.uk", as_object=True)

res
# 'co.uk'

res.subdomain
# 'some.subdomain'

res.domain
# 'google'

res.tld
# 'co.uk'

res.fld
# 'google.co.uk'

res.parsed_url
# SplitResult(
#     scheme='http',
#     netloc='some.subdomain.google.co.uk',
#     path='',
#     query='',
#     fragment=''
# )

Get TLD name, ignoring the missing protocol

from tld import get_tld, get_fld

get_tld("www.google.co.uk", fix_protocol=True)
# 'co.uk'

get_fld("www.google.co.uk", fix_protocol=True)
# 'google.co.uk'

Return TLD parts as tuple

from tld import parse_tld

parse_tld('http://www.google.com')
# 'com', 'google', 'www'

Get the first level domain name as string from the URL given

from tld import get_fld

get_fld("http://www.google.co.uk")
# 'google.co.uk'

get_fld("http://www.google.idontexist", fail_silently=True)
# None

Check if some tld is a valid tld

from tld import is_tld

is_tld('co.uk)
# True

is_tld('uk')
# True

is_tld('tld.doesnotexist')
# False

is_tld('www.google.com')
# False

Update the list of TLD names

To update/sync the tld names with the most recent version run the following from your terminal:

update-tld-names

Or simply do:

from tld.utils import update_tld_names

update_tld_names()

Troubleshooting

If somehow domain names listed here are not recognised, make sure you have the most recent version of TLD names in your virtual environment:

update-tld-names

Testing

Simply type:

./runtests.py

Or use tox:

tox

Or use tox to check specific env:

tox -e py36

Writing documentation

Keep the following hierarchy.

=====
title
=====

header
======

sub-header
----------

sub-sub-header
~~~~~~~~~~~~~~

sub-sub-sub-header
^^^^^^^^^^^^^^^^^^

sub-sub-sub-sub-header
++++++++++++++++++++++

sub-sub-sub-sub-sub-header
**************************

License

MPL-1.1 OR GPL-2.0-only OR LGPL-2.1-or-later

Support

For any issues contact me at the e-mail given in the Author section.

Author

Artur Barseghyan <artur.barseghyan@gmail.com>

Project details

These details have not been verified by PyPI

Project links

Homepage

Release history Release notifications | RSS feed

0.13

Feb 27, 2023

0.12.7

Feb 2, 2023

0.12.6

Jun 6, 2021

0.12.5

Jan 11, 2021

0.12.4

Jan 2, 2021

0.12.3

Nov 26, 2020

0.12.2

May 20, 2020

0.12.1

Apr 25, 2020

0.12

Apr 19, 2020

0.11.11

Mar 10, 2020

0.11.10

Feb 5, 2020

0.11.9

Dec 16, 2019

0.11.8

Dec 13, 2019

0.11.7

Dec 12, 2019

0.11.6

Dec 12, 2019

0.11.5

Dec 11, 2019

0.11.4

Dec 11, 2019

0.11.3

Dec 11, 2019

0.11.2

Dec 11, 2019

0.11.1

Dec 10, 2019

0.11

Dec 9, 2019

0.10

Nov 27, 2019

0.9.8

Nov 15, 2019

0.9.7

Oct 30, 2019

0.9.6

Sep 12, 2019

This version

0.9.5

Sep 11, 2019

0.9.4

Sep 10, 2019

0.9.3

Apr 6, 2019

0.9.2

Jan 10, 2019

0.9.1

Jul 9, 2018

0.9

Jun 13, 2018

0.8

Jun 13, 2018

0.7.10

Apr 7, 2018

0.7.9

May 2, 2017

0.7.8

Feb 19, 2017

0.7.7

Feb 9, 2017

0.7.6

Jan 23, 2016

0.7.5

Nov 22, 2015

0.7.4

Sep 23, 2015

0.7.3

Jul 18, 2015

0.7.2

Sep 28, 2014

0.7.1

Sep 22, 2014

0.7

Aug 14, 2014

0.6.4

May 22, 2014

0.6.3

Dec 5, 2013

0.6.2

Dec 3, 2013

0.6.1

Sep 15, 2013

0.5

Sep 7, 2013

0.4

Aug 3, 2013

0.3

Jul 29, 2013

0.2

May 11, 2013

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tld-0.9.5.tar.gz (250.6 kB view details)

Uploaded Sep 11, 2019 Source

Built Distribution

tld-0.9.5-py2.py3-none-any.whl (251.9 kB view details)

Uploaded Sep 11, 2019 Python 2 Python 3

File details

Details for the file tld-0.9.5.tar.gz.

File metadata

Download URL: tld-0.9.5.tar.gz
Upload date: Sep 11, 2019
Size: 250.6 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/1.14.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.35.0 CPython/3.6.9

File hashes

Hashes for tld-0.9.5.tar.gz
Algorithm	Hash digest
SHA256	`30ad22a05c04bbbabe1710c2c92707261f2d428691be40763f77449182e64806`
MD5	`fcf3feb0a1ff93f58a285f5b80755a02`
BLAKE2b-256	`7d5f66fab543a70292f10b142271839aaee714d2089e0d89c09408606a0bb0ca`

See more details on using hashes here.

Provenance

File details

Details for the file tld-0.9.5-py2.py3-none-any.whl.

File metadata

Download URL: tld-0.9.5-py2.py3-none-any.whl
Upload date: Sep 11, 2019
Size: 251.9 kB
Tags: Python 2, Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/1.14.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.35.0 CPython/3.6.9

File hashes

Hashes for tld-0.9.5-py2.py3-none-any.whl
Algorithm	Hash digest
SHA256	`1a2b3984b9be26c7de59c8a6e2dab8805e3d92e0e0352ca75c1c78bdba070110`
MD5	`dc6da419cd51bb9270b055879c4fcb71`
BLAKE2b-256	`caaaafd673fabe6d918efd0980e0764a0b8b01db42182bc88f625f5bb9ae97a9`