Metadata-Version: 1.1
Name: python_purify
Version: 2.0.1
Summary: A python API for Web Purify
Home-page: https://github.com/kingthomasc/python-purify
Author: Tom King, Kory Donati
Author-email: tomk@bixly.com, korydonati@gmail.com
License: UNKNOWN
Download-URL: https://github.com/kingthomasc/python-purify/tarball/2.0.1
Description: =============
        Python Purify
        =============
        
        ************
        Installation
        ************
        
        
        ::
        
            pip install python_purify
        
        
        or::
        
            python setup.py install
        
        Examples
        ========
        
        Setup
        -----
        
        ::
        
            from python_purify import WordPurify
            from python_purify import ImagePurify
            ...
            purify = WordPurify(my_api_key)
            imgpurify = ImagePurify(my_img_api_key)
            vidpurify = VideoPurify(my_img_api_key)
        
        
        The Web Purify default response type is XML, but JSON is normally better to work with. We made
        JSON the standard format for our package, but you can set it to XML with the rspformat variable::
        
            purify = WordPurify(my_api_key, rspformat='xml')
        
        This will return a cElementTree object. If you want to use a better package like beautiful soup, you can
        return the tree back to text with the following::
        
            from xml.etree import cElementTree as ET
            ...
            out = purify.check('Some nice words')
            xml_string = ET.tostring(out)
            # Some other XML parser can load the data now.
        
        
        Initialization options
        ----------------------
        * live - Default: True. If false, uses the webpurify sandbox
        * rspformat - Default: `'json'`. Can be set to `'json'` or `'xml'`
        * verbose - Default: False. If true, prints the WebPurify url before making a request.
        
        WordPurify Methods
        ==================
        Once setup if finished, you can simply call each method::
        
            out = purify.check('Some nice words')
            print out
            # {u'rsp': {u'@attributes': {u'stat': u'ok'}, u'found': u'0', u'api_key': u'*********', u'method':  u'webpurify.live.check', u'format': u'rest'}}
        
        The following WordPurify methods are included:
        
        * `check <https://www.webpurify.com/documentation/methods/check/>`_
        * `check_count <https://www.webpurify.com/documentation/methods/checkcount/>`_
        * `replace <https://www.webpurify.com/documentation/methods/replace/>`_
        * `wp_return <https://www.webpurify.com/documentation/methods/return/>`_
        * `add_to_blacklist <https://www.webpurify.com/documentation/methods/addtoblacklist/>`_
        * `add_to_whitelist <https://www.webpurify.com/documentation/methods/addtowhitelist/>`_
        * `remove_from_blacklist <https://www.webpurify.com/documentation/methods/removefromblacklist/>`_
        * `remove_from_whitelist <https://www.webpurify.com/documentation/methods/removefromwhitelist/>`_
        * `get_blacklist <https://www.webpurify.com/documentation/methods/getblacklist/>`_
        * `get_whitelist <https://www.webpurify.com/documentation/methods/getwhitelist/>`_
        
        **Note:** 
          you should be able to set most of the options in the function call except for format. Format is determined at WordPurify  
          creation. In this example, `rsp=1` will give us the response time and `slink=1` will tell WebPurify to flag urls::
        
              purify.check('Some nice words', rsp=1, slink=1)
        
        
        ImagePurify Methods
        ===================
        
        Just like with WordPurify, once setup, you can call the ImagePurify Methods.
        
        ::
        
            out = imgpurify.img_account()
        
        The following ImagePurify methods are included:
        
        * `img_check <https://www.webpurify.com/image-moderation/documentation/methods/imgcheck/>`_
        * `img_status <https://www.webpurify.com/image-moderation/documentation/methods/imgstatus/>`_
        * `img_account <https://www.webpurify.com/image-moderation/documentation/methods/imgaccount/>`_
        
        VideoPurify
        ===========
        
        VideoPurify works in much the same way as ImagePurify.
        
        ::
        
            out = vidpurify.vid_account()
        
        The following ImagePurify methods are included:
        
        * `vid_check <https://www.webpurify.com/video-moderation/documentation/methods/vidcheck/>`_
        * `vid_status <https://www.webpurify.com/video-moderation/documentation/methods/vidstatus/>`_
        * `vid_account <https://www.webpurify.com/video-moderation/documentation/methods/vidaccount/>`_
        
        Testing
        =======
        
        We have written some basic tests for python 2.7 and python 3.
Keywords: profanity,filter,web purify,webpurify
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
