simonw/soupselect

CSS selector support for BeautifulSoup.

soupselect's Issues

A method to return a tag or none might be useful.

Currently the only method you add is soupSelect which returns a list. If I only want one tag, I have to check the length and get the first element or add IndexError exception handling. I think it would cleaner to offer a second method that will return a tag or None instead of a list.

I use the following to patch soupselector (after it patches BeautifulSoup.) Maybe you would like to add it to your code?

(If I had designed it, I would have soup.soupSelect only return one element and .soupSelectAll, to match BeautifulSoup's find and findAll methods.)

def monkeyPatchSoupSelector(BeautifulSoupClass=None):
    def findSelectOne(soup, selector):
        """
        Soup selector method to return a tag or None, so you don't have to use index exceptions.
        """
        tags = soup.findSelect(selector)
        if not tags:
            return None
        return tags[0]
    if not BeautifulSoupClass:
        from BeautifulSoup import BeautifulSoup as BeautifulSoupClass
    BeautifulSoupClass.findSelectOne = findSelectOne

License a bit unclear

Hi Simon,

I love soupselect, it's awesome! Because it's not available on PyPi (hint) I'm bundling it with a Python module I wrote to convert HTML files to Vim help files (html2vimdoc). It took me a while to determine the license of soupselect: I found the module here on GitHub and only later found the Google Code page which mentions the MIT license. You might consider adding a LICENSE file or a mention in the README.

Thanks for creating & publishing soupselect!

- Peter