https://github.com/coleifer/micawber

a small library for extracting rich content from urls
https://github.com/coleifer/micawber

oembed python

Last synced: 6 days ago
JSON representation

a small library for extracting rich content from urls

• Host: GitHub
• URL: https://github.com/coleifer/micawber
• Owner: coleifer
• License: mit
• Created: 2012-03-27T21:42:46.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2024-01-02T14:08:35.000Z (11 months ago)
• Last Synced: 2024-05-22T15:12:36.080Z (7 months ago)
• Topics: oembed, python
• Language: Python
• Homepage: http://micawber.readthedocs.org/
• Size: 197 KB
• Stars: 622
• Watchers: 17
• Forks: 90
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

• awesome-python-resources - GitHub
• best-of-web-python - GitHub

README

        
.. image:: http://media.charlesleifer.com/blog/photos/micawber-logo-0.png

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:

.. code-block:: python

    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'',

        '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',

    }

    providers.parse_text('this is a test:\nhttp://www.youtube.com/watch?v=54XHDUOHuzU')

    # returns the following string:

    this is a test:

    

    providers.parse_html('
http://www.youtube.com/watch?v=54XHDUOHuzU
')


    # returns the following html: