Metadata-Version: 1.1
Name: favicon
Version: 0.2.0
Summary: Find a website's favicon
Home-page: https://github.com/scottwernervt/favicon
Author: Scott Werner
Author-email: scott.werner.vt@gmail.com
License: MIT
Download-URL: https://github.com/scottwernervt/faviconarchive/0.2.0.tar.gz
Description: favicon
        =======
        
        .. image:: https://img.shields.io/pypi/v/favicon.svg
            :target: https://pypi.python.org/pypi/favicon
        
        .. image:: https://img.shields.io/badge/license-MIT-blue.svg
            :target: /LICENSE
        
        .. image:: https://travis-ci.org/scottwernervt/favicon.svg?branch=master
            :target: https://travis-ci.org/scottwernervt/favicon
        
        ``favicon`` is a Python library to find a website's favicon.
        
        Usage
        -----
        
        Get all icons:
        
        .. code-block:: python
        
            >>> import favicon
            >>> icons = favicon.get('https://www.python.org/')
            Icon(url='https://www.python.org/static/apple-touch-icon-144x144-precomposed.png', width=144, height=144, format='png')
            Icon(url='https://www.python.org/static/apple-touch-icon-114x114-precomposed.png', width=114, height=114, format='png')
            Icon(url='https://www.python.org/static/apple-touch-icon-72x72-precomposed.png', width=72, height=72, format='png')
            Icon(url='https://www.python.org/static/apple-touch-icon-precomposed.png', width=0, height=0, format='png')
            Icon(url='https://www.python.org/static/favicon.ico', width=0, height=0, format='ico')
        
        Download largest icon:
        
        .. code-block:: python
        
            import requests
            import favicon
        
            icons = favicon.get('https://www.python.org/')
            icon = icons[0]
        
            response = requests.get(icon.url, stream=True)
            with open('/tmp/python-favicon.{}'.format(icon.format), 'wb') as image:
                for chunk in response.iter_content(1024):
                    image.write(chunk)
        
            # /tmp/python-favicon.png
        
        Installation
        ------------
        
        .. code-block:: bash
        
            pip install favicon
        
        Requirements
        ------------
        
        * `requests <http://docs.python-requests.org/>`_
        * `beautifulsoup4 <https://www.crummy.com/software/BeautifulSoup/bs4/doc/>`_
        
        Inspiration
        -----------
        
        * `pyfav <https://github.com/phillipsm/pyfav>`_
        * `besticon <https://github.com/mat/besticon/>`_
        * `How to get high resolution website logo (favicon) for a given URL <https://stackoverflow.com/questions/21991044/how-to-get-high-resolution-website-logo-favicon-for-a-given-url>`_
        
Keywords: favicon favicons icon icons
Platform: any
Classifier: Programming Language :: Python
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Developers
Classifier: Topic :: Utilities
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Site Management :: Link Checking
