Metadata-Version: 1.1
Name: soupy
Version: 0.2
Summary: Easier wrangling of web documents
Home-page: http://github.com/ChrisBeaumont/soupy
Author: chrisnbeaumont@gmail.com
Author-email: chrisnbeaumont@gmail.com
License: UNKNOWN
Description: Soupy
        =====
        
        |Build Status| |Coverage Status|
        
        Soupy is a wrapper around BeautifulSoup that makes it easier to build
        complex queries when wrangling web data.
        
        Here's an example of a Soupy query.
        
        .. code:: python
        
            from soupy import Soupy, Q
        
            html = """
            <div id="main">
              <div>The web is messy</div>
              and full of traps
              <div>but Soupy loves you</div>
            </div>"""
        
            print(Soupy(html).find(id='main').children
                  .each(Q.text.strip()) # extract text from each node, trim whitespace
                  .filter(len)          # remove empty strings
                  .val())               # dump out of Soupy
        
            # ['The web is messy', 'and full of traps', 'but Soupy loves you']
        
        The same query using BeautifulSoup:
        
        .. code:: python
        
             from bs4 import BeautifulSoup, NavigableString
        
            html = """
            <div id="main">
              <div>The web is messy</div>
              and full of traps
              <div>but Soupy loves you</div>
            </div>"""
        
            result = []
            for node in BeautifulSoup(html).find(id='main').children:
                if isinstance(node, NavigableString):
                    text = node.strip()
                else:
                    text = node.text.strip()
                if len(text):
                    result.append(text)
        
            print(result)
        
        For more information, see the `Soupy
        Documentation <http://soupy.readthedocs.org>`__
        
        Installation
        ------------
        
        ::
        
            pip install soupy
        
        Dependencies
        ------------
        
        six and BeautifulSoup4
        
        Soupy is supported on Python 2.6+ and 3.3+
        
        .. |Build Status| image:: https://travis-ci.org/ChrisBeaumont/soupy.svg
           :target: https://travis-ci.org/ChrisBeaumont/soupy
        .. |Coverage Status| image:: https://coveralls.io/repos/ChrisBeaumont/soupy/badge.svg
           :target: https://coveralls.io/r/ChrisBeaumont/soupy
        
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: License :: OSI Approved :: MIT License
