{ "info": { "author": "Rune Halvorsen", "author_email": "runefh@gmail.com", "bugtrack_url": null, "classifiers": [ "Intended Audience :: Developers", "License :: OSI Approved :: BSD License", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.1" ], "description": ".. -*- restructuredtext -*-\n\n##########################################\ntweetstream - Simple twitter streaming API\n##########################################\n\nIntroduction\n------------\n\ntweetstream provides two classes, SampleStream and FollowStream, that can be\nused to get tweets from Twitter's streaming API. An instance of one of the\nclasses can be used as an iterator. In addition to fetching tweets, the \nobject keeps track of the number of tweets collected and the rate at which\ntweets are received.\n\nSampleStream delivers a sample of all tweets. FilterStream delivers\ntweets that match one or more criteria. Note that it's not possible\nto get all tweets without access to the \"firehose\" stream, which\nis not currently avaliable to the public.\n\nTwitter's documentation about the streaming API can be found here:\nhttp://dev.twitter.com/pages/streaming_api_methods .\n\n**Note** that the API is blocking. If for some reason data is not immediatly\navailable, calls will block until enough data is available to yield a tweet.\n\nExamples\n--------\n\nPrinting incoming tweets:\n\n>>> stream = tweetstream.SampleStream(\"username\", \"password\")\n>>> for tweet in stream:\n... print tweet\n\n\nThe stream object can also be used as a context, as in this example that\nprints the author for each tweet as well as the tweet count and rate:\n\n>>> with tweetstream.SampleStream(\"username\", \"password\") as stream\n... for tweet in stream:\n... print \"Got tweet from %-16s\\t( tweet %d, rate %.1f tweets/sec)\" % (\n... tweet[\"user\"][\"screen_name\"], stream.count, stream.rate )\n\n\nStream objects can raise ConnectionError or AuthenticationError exceptions:\n\n>>> try:\n... with tweetstream.TweetStream(\"username\", \"password\") as stream\n... for tweet in stream:\n... print \"Got tweet from %-16s\\t( tweet %d, rate %.1f tweets/sec)\" % (\n... tweet[\"user\"][\"screen_name\"], stream.count, stream.rate )\n... except tweetstream.ConnectionError, e:\n... print \"Disconnected from twitter. Reason:\", e.reason\n\nTo get tweets that match specific criteria, use the FilterStream. FilterStreams\ntake three keyword arguments: \"locations\", \"follow\" and \"track\".\n\nLocations are a list of bounding boxes in which geotagged tweets should originate.\nThe argument should be an iterable of longitude/latitude pairs.\n\nTrack specifies keywords to track. The argument should be an iterable of\nstrings.\n\nFollow returns statuses that reference given users. Argument should be an iterable\nof twitter user IDs. The IDs are userid ints, not the screen names. \n\n>>> words = [\"opera\", \"firefox\", \"safari\"]\n>>> people = [123,124,125]\n>>> locations = [\"-122.75,36.8\", \"-121.75,37.8\"]\n>>> with tweetstream.FilterStream(\"username\", \"password\", track=words,\n... follow=people, locations=locations) as stream\n... for tweet in stream:\n... print \"Got interesting tweet:\", tweet\n\n\nDeprecated classes\n------------------\n\ntweetstream used to contain the classes TweetStream, FollowStream, TrackStream\nLocationStream and ReconnectingTweetStream. These were deprecated when twitter\nchanged its API end points. The same functionality is now available in\nSampleStream and FilterStream. The deprecated methods will emit a warning when\nused, but will remain functional for a while longer.\n\n\nChangelog\n---------\n\nSee the CHANGELOG file\n\nContact\n-------\n\nThe author is Rune Halvorsen . The project resides at\nhttp://bitbucket.org/runeh/tweetstream . If you find bugs, or have feature\nrequests, please report them in the project site issue tracker. Patches are\nalso very welcome.\n\nContributors\n------------\n\n- Rune Halvorsen\n- Christopher Schierkolk\n\nLicense\n-------\n\nThis software is licensed under the ``New BSD License``. See the ``LICENCE``\nfile in the top distribution directory for the full license text.", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://bitbucket.org/runeh/tweetstream/", "keywords": "twitter", "license": "BSD", "maintainer": null, "maintainer_email": null, "name": "tweetstream", "package_url": "https://pypi.org/project/tweetstream/", "platform": "any", "project_url": "https://pypi.org/project/tweetstream/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://bitbucket.org/runeh/tweetstream/" }, "release_url": "https://pypi.org/project/tweetstream/1.1.1/", "requires_dist": null, "requires_python": null, "summary": "Simple Twitter streaming API access", "version": "1.1.1" }, "last_serial": 801071, "releases": { "0.1": [ { "comment_text": "", "digests": { "md5": "8f114c89be3eecff32cf075fd73ac0ee", "sha256": "e02572af1c511cd6108a5021aa9e8d65a907afb1fea12279dc356eaa6c9ec067" }, "downloads": -1, "filename": "tweetstream-0.1.tar.gz", "has_sig": false, "md5_digest": "8f114c89be3eecff32cf075fd73ac0ee", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3711, "upload_time": "2009-06-21T23:59:42", "url": "https://files.pythonhosted.org/packages/ab/19/ee5687a7442e607d4301a3ea07e98afd0743ec3e395c18c91a31cd32c2ad/tweetstream-0.1.tar.gz" } ], "0.2": [ { "comment_text": "", "digests": { "md5": "37bd151b90447586c665503ea026e8c6", "sha256": "5639f02dc5181bd4a2e0ce3b4397b894ad586efe5d678b6563ea46f44e04c646" }, "downloads": -1, "filename": "tweetstream-0.2.tar.gz", "has_sig": false, "md5_digest": "37bd151b90447586c665503ea026e8c6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4478, "upload_time": "2009-07-05T17:14:34", "url": "https://files.pythonhosted.org/packages/03/e2/30d1e484b67752a8c1a77e75276fb66fc0dd9eaa038d63e74282e8320494/tweetstream-0.2.tar.gz" } ], "0.3": [ { "comment_text": "", "digests": { "md5": "71c427e7f95ec061b5ab24862f18419e", "sha256": "374b08b30caa6aaf39bb85fe9a25d81ad2a6347132f5cd939884f51fdfd27eb3" }, "downloads": -1, "filename": "tweetstream-0.3.tar.gz", "has_sig": false, "md5_digest": "71c427e7f95ec061b5ab24862f18419e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5301, "upload_time": "2009-07-08T00:56:31", "url": "https://files.pythonhosted.org/packages/73/94/3c4340fa2337165ba4b704374db37d86a05189cfe94aa8bf5c994aa27c76/tweetstream-0.3.tar.gz" } ], "0.3.1": [ { "comment_text": "", "digests": { "md5": "6453ed3b2b5f14bcfe787b08ead1d789", "sha256": "00e8c38025b891e4bebdb8c1b17b3b8d71e2134b6c5f1a86a2fdc4dcc6aa60b6" }, "downloads": -1, "filename": "tweetstream-0.3.1.tar.gz", "has_sig": false, "md5_digest": "6453ed3b2b5f14bcfe787b08ead1d789", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5438, "upload_time": "2009-08-08T12:50:10", "url": "https://files.pythonhosted.org/packages/42/fb/1f1c6767449fa8e5b81d57cd7daa73459d6ad6143e66bbc54e9b97d4736c/tweetstream-0.3.1.tar.gz" } ], "0.3.3": [ { "comment_text": "", "digests": { "md5": "a950af681123e215bba3ed9f26ea26b9", "sha256": "4f75c1948b0b473eafd45d5bcda77f6bc6f1398ba4d0a6e15615e34bea515c34" }, "downloads": -1, "filename": "tweetstream-0.3.3.tar.gz", "has_sig": false, "md5_digest": "a950af681123e215bba3ed9f26ea26b9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5430, "upload_time": "2009-10-29T22:38:47", "url": "https://files.pythonhosted.org/packages/e4/2e/34ca84b210e64012ec0de0be08af8c22cc1eac29f41ab43ea8372904d417/tweetstream-0.3.3.tar.gz" } ], "0.3.4": [ { "comment_text": "", "digests": { "md5": "e3e4d7eceee95a52e4115f2c4be6c44d", "sha256": "a124803155e57f7b08574844672acb8a11eec6df2cb93bb710127081c9357559" }, "downloads": -1, "filename": "tweetstream-0.3.4.tar.gz", "has_sig": false, "md5_digest": "e3e4d7eceee95a52e4115f2c4be6c44d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5376, "upload_time": "2010-03-11T10:44:15", "url": "https://files.pythonhosted.org/packages/4c/32/d63e4e18922a98b9e5a737f3e471231b01953d1692400de78490a5a93451/tweetstream-0.3.4.tar.gz" } ], "0.3.5": [ { "comment_text": "", "digests": { "md5": "2df8ac7963e9fd6d9fcbfadd2cccc37f", "sha256": "af926f60119a1435bf747be49e0af684331a53430bcfad9c47d8c0cd0fb1d77d" }, "downloads": -1, "filename": "tweetstream-0.3.5.tar.gz", "has_sig": false, "md5_digest": "2df8ac7963e9fd6d9fcbfadd2cccc37f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5451, "upload_time": "2010-06-07T00:16:59", "url": "https://files.pythonhosted.org/packages/74/4c/a1e87de30b0f94c14b460cb4f142e338fdb526f333e98a8456bc40398bb2/tweetstream-0.3.5.tar.gz" } ], "1.0.0": [ { "comment_text": "", "digests": { "md5": "9525901e6c80e4ca2f7be152f91137e0", "sha256": "98c077630d5b81ef695b5eb56bb82494e4d0f92a39b7b40476e733e965c4ed43" }, "downloads": -1, "filename": "tweetstream-1.0.0.tar.gz", "has_sig": false, "md5_digest": "9525901e6c80e4ca2f7be152f91137e0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5910, "upload_time": "2011-07-31T03:14:04", "url": "https://files.pythonhosted.org/packages/f9/d5/80ec80fc78899bbf4c9523418ff0dab8eb9f7429faaae232293893d28736/tweetstream-1.0.0.tar.gz" } ], "1.1.0": [ { "comment_text": "", "digests": { "md5": "f73b2e34f02146caee82d715ce7035bc", "sha256": "e381dcb614e5a39276e7db9e49d3d5aec1a5f8e6260648ea048bae442429ab43" }, "downloads": -1, "filename": "tweetstream-1.1.0.tar.gz", "has_sig": false, "md5_digest": "f73b2e34f02146caee82d715ce7035bc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6806, "upload_time": "2011-09-25T22:06:16", "url": "https://files.pythonhosted.org/packages/ce/2f/06774020f421bd8c865a69b668935cfff5a39ded2d53d144f3883d3eda77/tweetstream-1.1.0.tar.gz" } ], "1.1.1": [ { "comment_text": "", "digests": { "md5": "c96e7b4a75b345a941074225a14dfc4a", "sha256": "e2cb0dcc5ea6eb8e4123fba96a97fe87c1d6f3d6ab6d25369f716b30a4c5fe5c" }, "downloads": -1, "filename": "tweetstream-1.1.1.tar.gz", "has_sig": false, "md5_digest": "c96e7b4a75b345a941074225a14dfc4a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6918, "upload_time": "2011-10-13T22:47:36", "url": "https://files.pythonhosted.org/packages/60/a4/30b6d372e6bb0b3290b1012f5f84ee9d5183880d09ebb865e87200a55142/tweetstream-1.1.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "c96e7b4a75b345a941074225a14dfc4a", "sha256": "e2cb0dcc5ea6eb8e4123fba96a97fe87c1d6f3d6ab6d25369f716b30a4c5fe5c" }, "downloads": -1, "filename": "tweetstream-1.1.1.tar.gz", "has_sig": false, "md5_digest": "c96e7b4a75b345a941074225a14dfc4a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6918, "upload_time": "2011-10-13T22:47:36", "url": "https://files.pythonhosted.org/packages/60/a4/30b6d372e6bb0b3290b1012f5f84ee9d5183880d09ebb865e87200a55142/tweetstream-1.1.1.tar.gz" } ] }