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). Knows about active and inactive TLDs. If only active TLDs shall be matched against, active_only argument shall be set to True (default - False).

Prerequisites

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

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

Get the TLD name as string from the URL given:

from tld import get_tld

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

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

If you wish, you could get the TLD as an object:

from tld import get_tld

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

res
# 'google.co.uk'

res.subdomain
# 'some.subdomain'

res.domain
# 'google'

res.suffix
# 'co.uk'

res.tld
# 'google.co.uk'

Get TLD name, ignoring the missing protocol:

from tld import get_tld

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

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

License

MPL 1.1/GPL 2.0/LGPL 2.1

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

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

This version

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.7.9.tar.gz (147.8 kB view details)

Uploaded May 2, 2017 Source

Built Distribution

tld-0.7.9-py2.py3-none-any.whl (154.0 kB view details)

Uploaded May 2, 2017 Python 2 Python 3

File details

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

File metadata

Download URL: tld-0.7.9.tar.gz
Upload date: May 2, 2017
Size: 147.8 kB
Tags: Source
Uploaded using Trusted Publishing? No

File hashes

Hashes for tld-0.7.9.tar.gz
Algorithm	Hash digest
SHA256	`e78e31ee3d48af1c0473110f6c477c01244f2106d77186f56f027977a5b760a2`
MD5	`d58b193335c4addc9c48a179d7208b0a`
BLAKE2b-256	`2d5f8b091039d53ececad4899dd91140fdc2c20adbe24a4b6404ed1a3bd9dfc9`

See more details on using hashes here.

Provenance

File details

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

File metadata

Download URL: tld-0.7.9-py2.py3-none-any.whl
Upload date: May 2, 2017
Size: 154.0 kB
Tags: Python 2, Python 3
Uploaded using Trusted Publishing? No

File hashes

Hashes for tld-0.7.9-py2.py3-none-any.whl
Algorithm	Hash digest
SHA256	`2e6ed5fdd04913f93b8fd09d931af502fabdef9e343a605b90bdf4c9c16face2`
MD5	`faae4dab10ed96eec370deb8e0ce6c0d`
BLAKE2b-256	`477e3d1a1268f55911cd15d5c3626f1382df5358777a681de94f7f347132d5e2`