Metadata-Version: 1.1
Name: micawber
Version: 0.2.5
Summary: a small library for extracting rich content from urls
Home-page: http://github.com/coleifer/micawber/
Author: Charles Leifer
Author-email: coleifer@gmail.com
License: UNKNOWN
Description: micawber
        ========
        
        .. image:: http://media.charlesleifer.com/blog/photos/micawber.jpg
        
        A small library for extracting rich content from urls
        
        
        what does it do?
        ----------------
        
        micawber supplies a few methods for retrieving rich metadata about a variety of
        links, such as links to youtube videos.  micawber also provides functions for
        parsing blocks of text and html and replacing links to videos with rich embedded
        content.
        
        examples
        --------
        
        here is a quick example::
        
            import micawber
            
            # load up rules for some default providers, such as youtube and flickr
            providers = micawber.bootstrap_basic()
            
            providers.request('http://www.youtube.com/watch?v=54XHDUOHuzU')
            
            # returns the following dictionary:
            {
                'author_name': 'pascalbrax', 
                'author_url': u'http://www.youtube.com/user/pascalbrax'
                'height': 344, 
                'html': u'<iframe width="459" height="344" src="http://www.youtube.com/embed/54XHDUOHuzU?fs=1&feature=oembed" frameborder="0" allowfullscreen></iframe>', 
                'provider_name': 'YouTube', 
                'provider_url': 'http://www.youtube.com/', 
                'title': 'Future Crew - Second Reality demo - HD',
                'type': u'video',
                'thumbnail_height': 360, 
                'thumbnail_url': u'http://i2.ytimg.com/vi/54XHDUOHuzU/hqdefault.jpg', 
                'thumbnail_width': 480,   
                'url': 'http://www.youtube.com/watch?v=54XHDUOHuzU', 
                'width': 459, 
                'version': '1.0', 
            }
            
            micawber.parse_text('this is a test:\nhttp://www.youtube.com/watch?v=54XHDUOHuzU', providers)
            
            # returns the following string:
            this is a test:
            <iframe width="459" height="344" src="http://www.youtube.com/embed/54XHDUOHuzU?fs=1&feature=oembed" frameborder="0" allowfullscreen></iframe>
           
            micawber.parse_html('<p>http://www.youtube.com/watch?v=54XHDUOHuzU</p>', providers)
            
            # returns the following html:
            <p><iframe width="459" height="344" src="http://www.youtube.com/embed/54XHDUOHuzU?fs=1&amp;feature=oembed" frameborder="0" allowfullscreen="allowfullscreen"></iframe></p>
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Framework :: Django
