aral / blackbirdpy Goto Github PK

Blackbirdpy is a Python implementation of Blackbird Pie, the
JavaScript tool @robinsloan uses to generate embedded HTML tweets for
blog posts.

This Python version was written by Jeff Miller, http://twitter.com/jmillerinc

Requires Python 2.6.

Robin Sloan's original blog post about JS Blackbird Pie:
    http://media.twitter.com/blackbird-pie

Blog post about Blackbirdpy:
    http://jmillerinc.com/2010/06/17/blackbirdpy-embedded-tweets-in-python/

Usage:

- To generate embedded HTML for a tweet from inside a Python program:

  import blackbirdpy
  embed_html = blackbirdpy.embed_tweet_html(tweet_url)

- To generate embedded HTML for a tweet from the command line:

  $ python blackbirdpy.py <tweeturl>

- To run unit tests from the command line:

  $ python blackbirdpy.py --unittest