Metadata-Version: 2.0
Name: tld
Version: 0.7.6
Summary: Extracts the top level domain (TLD) from the URL given.
Home-page: https://github.com/barseghyanartur/tld
Author: Artur Barseghyan
Author-email: artur.barseghyan@gmail.com
License: MPL 1.1/GPL 2.0/LGPL 2.1
Keywords: tld,top level domain names,python
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 5 - Production/Stable
Classifier: Topic :: Internet
Classifier: License :: OSI Approved :: Mozilla Public License 1.1 (MPL 1.1)
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: License :: OSI Approved :: GNU Lesser General Public License v2 or later (LGPLv2+)
Requires-Dist: six (>=1.4)

===
tld
===
Extracts the top level domain (TLD) from the URL given. List of TLD names is
taken from `Mozilla
<http://mxr.mozilla.org/mozilla/source/netwerk/dns/src/effective_tld_names.dat?raw=1>`_.

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).

Installation
============
Latest stable version on PyPI:

.. code-block::

    $ pip install tld

Latest development version:

.. code-block::

    $ pip install -e hg+http://bitbucket.org/barseghyanartur/tld#egg=tld

Usage example
=============
To get the top level domain name from the URL given:

.. code-block:: python

    from tld import get_tld
    print get_tld("http://www.google.co.uk")
    # 'google.co.uk'

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

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

.. code-block:: python

    from tld import get_tld
    res = get_tld("http://some.subdomain.google.co.uk", as_object=True)
    print res
    # 'google.co.uk'

    print res.subdomain
    # 'some.subdomain'

    print res.domain
    # 'google'

    print res.suffix
    # 'co.uk'

    print res.tld
    # 'google.co.uk'

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

.. code-block::

    $ update-tld-names

or simply do:

.. code-block:: python

    from tld.utils import update_tld_names
    update_tld_names()

Troubleshooting
===============
If somehow domain names listed `here
<http://mxr.mozilla.org/mozilla/source/netwerk/dns/src/effective_tld_names.dat?raw=1>`_
are not recognised, make sure you have the most recent version of TLD names in
your virtual environment:

.. code-block::

    $ update-tld-names

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>


