Metadata-Version: 1.1
Name: publicsuffix2
Version: 2.0.1
Summary: Get a public suffix for a domain name using the Public Suffix List. Forked from and using the same API as the publicsuffix package.
Home-page: https://github.com/pombredanne/python-publicsuffix2
Author: nexB Inc., Tomaz Solc and David Wilson
Author-email: info@nexb.com
License: MIT and MPL-2.0
Description: Public Suffix List module for Python
        ====================================
        
        This module allows you to get the public suffix of a domain name using the
        Public Suffix List from http://publicsuffix.org
        
        A public suffix is a domain suffix under which you can register domain
        names. Some examples of public suffixes are .com, .co.uk and pvt.k12.wy.us.
        Accurately knowing the public suffix of a domain is useful when handling
        web browser cookies, highlighting the most important part of a domain name
        in a user interface or sorting URLs by web site.
        
        This Python module includes with a copy of the Public Suffix List so that it is
        usable out of the box. Newer version try to provide reasonably fresh copies of
        this list.
        
        The code is a fork of the publicsuffix package and uses the same module name and
        API.
        
        The code is MIT-licensed and the publicsuffix data list is MPL-2.0-licensed.
        
        
        Usage
        -----
        
        Install with::
        
            pip install publicsuffix2
        
        The module exports a single class that parses the Public Suffix List and allows
        queries for individual domain names::
        
            >>> from publicsuffix import PublicSuffixList
            >>> psl= PublicSuffixList()
            >>> psl.get_public_suffix('www.example.com')
            u'example.com'
            >>> psl.get_public_suffix('www.example.co.uk')
            u'example.co.uk'
            >>> psl.get_public_suffix('www.super.example.co.uk')
            u'example.co.uk'
        
        Note that the ``host`` part of an URL can contain strings that are
        not plain DNS domain names (IP addresses, Punycode-encoded names, name in
        combination with a port number or a username, etc.). It is up to the
        caller to ensure only domain names are passed to the get_public_suffix()
        method.
        
        
        Source
        ------
        
        Get a local copy of the development repository. The development takes 
        place in the ``develop`` branch. Stable releases are tagged in the ``master``
        branch::
        
            git clone https://github.com/pombredanne/python-publicsuffix2.git
        
        2015-06-04    publicsuffix2 2.0.0
        
            * Forked publicsuffix, but kept the same API
            * Updated publicsuffix.file to the latest version from Mozilla.
            * Changed packaging to have the suffix list be package data
              and be wheel friendly.
            * Use spaces indentation, not tabs
        
        
        2014-01-14    publicsuffix 1.0.5
        
            * Correctly handle fully qualified domain names (thanks to Matthäus
              Wander).
            * Updated publicsuffix.txt to the latest version from Mozilla.
        
        2013-01-02    publicsuffix 1.0.4
        
            * Added missing change log.
        
        2013-01-02    publicsuffix 1.0.3
        
            * Updated publicsuffix.txt to the latest version from Mozilla.
            * Added trove classifiers.
            * Minor update of the README.
        
        2011-10-10    publicsuffix 1.0.2
        
            * Compatibility with Python 3.x (thanks to Joern
              Koerner) and Python 2.5
        
        2011-09-22    publicsuffix 1.0.1
        
            * Fixed installation issue under virtualenv (thanks to
              Mark McClain)
        
        2011-07-29    publicsuffix 1.0.0
        
            * First release
        
Keywords: domain,public suffix,suffix,dns,tld
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: Name Service (DNS)
Classifier: Topic :: Utilities
Classifier: Development Status :: 5 - Production/Stable
