Soupstars |:stew:| |:star:| |:boom:| ==================================== .. image:: https://travis-ci.org/tjwaterman99/soupstars.svg?branch=master :target: https://travis-ci.org/tjwaterman99/soupstars.svg?branch=master .. image:: https://coveralls.io/repos/github/tjwaterman99/soupstars/badge.svg?branch=master :target: https://coveralls.io/repos/github/tjwaterman99/soupstars/badge.svg?branch=master .. image:: https://readthedocs.org/projects/soupstars/badge/?version=latest :target: https://readthedocs.org/projects/soupstars/badge/?version=latest .. image:: https://badge.fury.io/py/soupstars.svg :target: https://badge.fury.io/py/soupstars .. image:: https://img.shields.io/pypi/pyversions/soupstars.svg :target: https://img.shields.io/pypi/pyversions/soupstars.svg Soupstars makes it fast and easy to build web parsers in Python. Install it with pip. .. code-block:: bash pip install soupstars Quickstart ~~~~~~~~~~ We'll create a parser to extract data from a github page. .. code-block:: python # github_profile_parser.py from soupstars import parse url = "https://github.com/tjwaterman99/soupstars" @parse def title(soup): return str(soup.h1.text) Run the parser. .. code-block:: bash soupstars github_profile_parser.py { "url": "...", "status": 200, "data": { "title": "tjwaterman99/soupstars" }, "errors": {} } Let's look more closely at what you need to get set up. You're now ready to start building your own web parsers with `soupstars`. Nice job. |:beers:|