{ "info": { "author": "Jeremy Rossi", "author_email": "jeremy@jeremyrossi.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: Apache Software License", "Topic :: Communications :: Chat", "Topic :: Internet", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "-*- markdown -*-\r\n\r\n# Python Twitter #\r\n\r\n_A python wrapper around the Twitter API_\r\n\r\n* Author: `Jeremy Rossi `\r\n* Org Author: `DeWitt Clinton `\r\n\r\n## Introduction ##\r\n\r\nThis library provides a pure python interface for the Twitter API.\r\n\r\nTwitter (http://twitter.com) provides a service that allows people to\r\nconnect via the web, IM, and SMS. Twitter exposes a web services API \r\n(http://twitter.com/help/api) and this library is intended to make\r\nit even easier for python programmers to use. \r\n \r\n## Building ##\r\n\r\n### From source: ###\r\n\r\nInstall the dependencies:\r\n\r\n* [simplejson](http://cheeseshop.python.org/pypi/simplejson)\r\n\r\nDownload the latest tweethonlibrary from:\r\n\r\n* [tweethon](http://bitbucket.org/jrossi/tweethon/)\r\n\r\n\r\nUntar the source distribution and run:\r\n\r\n $ python setup.py build\r\n $ python setup.py install\r\n\r\n### Testing: ###\r\n\r\nWith setuptools installed:\r\n\r\n $ python setup.py test\r\n\r\nWithout setuptools installed:\r\n\r\n $ python tweethon_test.py\r\n\r\n## Getting the code ##\r\n\r\nView the trunk at:\r\n\r\n http://bitbucket.org/jrossi/tweethon/src/\r\n\r\nCheck out the latest development version anonymously with mercurial:\r\n\r\n $ hg clone http://bitbucket.org/jrossi/tweethon/\r\n\r\n## Documentation ##\r\n\r\nView the last release API documentation at:\r\n\r\n* [PyTwitter](http://bitbucket.org/jrossi/tweethon/wiki/Home)\r\n\r\n## Using ##\r\n\r\nThe library provides a python wrapper around the Twitter API and\r\nthe twitter data model.\r\n\r\n### Model: ###\r\n\r\nThe three model classes are `twitter.Status`, `twitter.User`, and\r\n`twitter.DirectMessage`. The API methods return instances of these\r\nclasses.\r\n\r\nTo read the full API for `twitter.Status`, `twitter.User`, or\r\n`twitter.DirectMessage`, run:\r\n\r\n $ pydoc tweethon.Status\r\n $ pydoc tweethon.User\r\n $ pydoc tweethon.DirectMessage\r\n\r\n### API: ###\r\n\r\nThe API is exposed via the `twitter.Api` class.\r\n\r\nTo create an instance of the `twitter.Api` class:\r\n\r\n >>> import tweethong\r\n >>> api = tweethon.Api()\r\n\r\nTo create an instance of the `twitter.Api` with login credentials (many API\r\ncalls required the client to be authenticated):\r\n\r\n >>> api = tweethon.Api(username='username', password='password) \r\n\r\nTo fetch the most recently posted public twitter status messages:\r\n\r\n >>> statuses = api.GetPublicTimeline()\r\n >>> print [s.user.name for s in statuses]\r\n [u'DeWitt', u'Kesuke Miyagi', u'ev', u'Buzz Andersen', u'Biz Stone'] \r\n\r\nTo fetch a single user's public status messages, where \"user\" is either\r\na Twitter \"short name\" or their user id.\r\n\r\n >>> statuses = api.GetUserTimeline(user)\r\n >>> print [s.text for s in statuses]\r\n\r\nTo fetch a list a user's friends (requires authentication):\r\n\r\n >>> users = api.GetFriends()\r\n >>> print [u.name for u in users]\r\n\r\nTo post a twitter status message (requires authentication):\r\n\r\n >>> status = api.PostUpdate(username, password, 'I love python-twitter!')\r\n >>> print status.text\r\n I love python-twitter!\r\n\r\nThere are many more API methods, to read the full API documentation:\r\n\r\n $ pydoc tweethon.Api\r\n\r\n## Convert from python-twitter ## \r\n\r\nPyTwitter is a complete fork of the python-twitter codebase. I am planning on keeping \r\ntweethon as drop in replacement for python-twitter. To make this work seamlessly use\r\nthe following import idiom:\r\n\r\n >>> import tweethon as twitter\r\n\r\n## More Information ##\r\n\r\n## Contributors ##\r\n\r\nAdditional thanks to Pierre-Jean Coudert, Omar Kilani, Jodok Batlogg,\r\nedleaf,glen.tregoning, Brad Choate, Jim Cortez, Jason Lemoine, Thomas\r\nDyson, Robert Laquey, and the rest of the python-twitter mailing list.\r\n\r\n## License ##\r\n\r\n> Copyright 2007 Google Inc. All Rights Reserved.\r\n> \r\n> Licensed under the Apache License, Version 2.0 (the 'License');\r\n> you may not use this file except in compliance with the License.\r\n> You may obtain a copy of the License at\r\n> \r\n> http://www.apache.org/licenses/LICENSE-2.0\r\n> \r\n> Unless required by applicable law or agreed to in writing, software\r\n> distributed under the License is distributed on an 'AS IS' BASIS,\r\n> WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r\n> See the License for the specific language governing permissions and\r\n> limitations under the License.\r\n\r\n2009-03-11\r\n\r\n Added page parameter to GetReplies, GetFriends, GetFollowers, and GetDirectMessages\r\n\r\n2009-03-03\r\n\r\n Added count parameter to GetFriendsTimeline\r\n\r\n2009-03-01\r\n Add PostUpdates, which automatically splits long text into multiple updates.\r\n\r\n2009-02-25\r\n\r\n Add in_reply_to_status_id to api.PostUpdate\r\n\r\n2009-02-21\r\n\r\n Wrap any error responses in a TwitterError\r\n Add since_id to GetFriendsTimeline and GetUserTimeline\r\n\r\n2009-02-20\r\n\r\n Added since and since_id to Api.GetReplies\r\n\r\n2008-07-10\r\n\r\n Added new properties to User and Status classes.\r\n Removed spurious self-import of the twitter module\r\n Added a NOTICE file\r\n Require simplejson 2.x or later\r\n Added get/create/destroy favorite flags for status messages.\r\n Bug fix for non-tty devices.\r\n\r\n2007-09-13\r\n \r\n Unset the executable bit on README.\r\n\r\n2007-09-13\r\n\r\n Released version 0.5.\r\n Added back support for setuptools (conditionally)\r\n Added support for X-Twitter-* HTTP headers\r\n Fixed the tests to work across all timezones\r\n Removed the 140 character limit from PostUpdate \r\n Added support for per-user tmp cache directories\r\n\r\n2007-06-13\r\n\r\n Released 0.4.\r\n Fixed a unicode error that prevented tweet.py from working.\r\n Added DestroyStatus\r\n Added DestroyDirectMessage\r\n Added CreateFriendship\r\n Added DestoryFriendship\r\n\r\n2007-06-03\r\n\r\n Fixed the bug that prevented unicode strings being posted\r\n Username and password now set on twitter.Api, not individual method calls\r\n Added SetCredentials and ClearCredentials\r\n Added GetUser (\"users/show\" in the twitter web api)\r\n Added GetFeatured\r\n Added GetDirectMessages\r\n Added GetStatus (\"statuses/show\" in the twitter web api)\r\n Added GetReplies\r\n Added optional since_id parameter on GetPublicTimeline\r\n Added optional since parameter on GetUserTimeline \r\n Added optional since and user parameters on GetFriendsTimeline\r\n Added optional user parameter on GetFriends \r\n \r\n2007-04-27\r\n \r\n Modified examples/twitter-to-xhtml.py to handle unicode\r\n Dropped dependency on setuptools (too complicated/buggy)\r\n Added unicode test cases\r\n Fixed issue 2 \"Rename needs an unlink in front\"\r\n \r\n2007-04-02\r\n\r\n Released 0.3.\r\n Use gmtime not localtime to calculate relative_created_at.\r\n\r\n2007-03-26\r\n\r\n Released 0.2\r\n GetUserTimeline can accept userid or username.\r\n\r\n2007-03-21\r\n\r\n Calculate relative_created_at on the fly\r\n\r\n2007-01-28\r\n\r\n Released 0.1\r\n Initial checkin of python-twitter", "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/jrossi/tweethon/", "keywords": "twitter api", "license": "Apache License 2.0", "maintainer": "", "maintainer_email": "", "name": "tweethon", "package_url": "https://pypi.org/project/tweethon/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/tweethon/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://bitbucket.org/jrossi/tweethon/" }, "release_url": "https://pypi.org/project/tweethon/0.8.1/", "requires_dist": null, "requires_python": null, "summary": "A python wrapper around the Twitter API. Updated often and drop in replacement for twitter-python (aka its a fork)", "version": "0.8.1" }, "last_serial": 801070, "releases": { "0.8.1": [ { "comment_text": "", "digests": { "md5": "bc194160b5e3e8a6ce1d6280652b32a8", "sha256": "baa45cfa6dad6a03c5cbaa411a1617ed216baf164617d4ab55bed38a19a16b51" }, "downloads": -1, "filename": "tweethon-0.8.1-py2.6.egg", "has_sig": false, "md5_digest": "bc194160b5e3e8a6ce1d6280652b32a8", "packagetype": "bdist_egg", "python_version": "any", "requires_python": null, "size": 42728, "upload_time": "2009-09-30T03:17:42", "url": "https://files.pythonhosted.org/packages/94/fa/a55c8172bf687b9298c9c3b9209cca8ba48336611b7513a9e3a47ba4f018/tweethon-0.8.1-py2.6.egg" }, { "comment_text": "", "digests": { "md5": "ebaaf8f34b274a4ac51dd1ee29c4c5f5", "sha256": "0b0b8abcf0ea59ef6eb32605baa63d4f92b2cc7ea2abfbb482b7db2d22960e75" }, "downloads": -1, "filename": "tweethon-0.8.1.tar.gz", "has_sig": false, "md5_digest": "ebaaf8f34b274a4ac51dd1ee29c4c5f5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 23301, "upload_time": "2009-09-30T03:17:06", "url": "https://files.pythonhosted.org/packages/f1/20/9bc0820bdff7ac491b81cf2c5dab9963768669bce74e610e5a53f515aa51/tweethon-0.8.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "bc194160b5e3e8a6ce1d6280652b32a8", "sha256": "baa45cfa6dad6a03c5cbaa411a1617ed216baf164617d4ab55bed38a19a16b51" }, "downloads": -1, "filename": "tweethon-0.8.1-py2.6.egg", "has_sig": false, "md5_digest": "bc194160b5e3e8a6ce1d6280652b32a8", "packagetype": "bdist_egg", "python_version": "any", "requires_python": null, "size": 42728, "upload_time": "2009-09-30T03:17:42", "url": "https://files.pythonhosted.org/packages/94/fa/a55c8172bf687b9298c9c3b9209cca8ba48336611b7513a9e3a47ba4f018/tweethon-0.8.1-py2.6.egg" }, { "comment_text": "", "digests": { "md5": "ebaaf8f34b274a4ac51dd1ee29c4c5f5", "sha256": "0b0b8abcf0ea59ef6eb32605baa63d4f92b2cc7ea2abfbb482b7db2d22960e75" }, "downloads": -1, "filename": "tweethon-0.8.1.tar.gz", "has_sig": false, "md5_digest": "ebaaf8f34b274a4ac51dd1ee29c4c5f5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 23301, "upload_time": "2009-09-30T03:17:06", "url": "https://files.pythonhosted.org/packages/f1/20/9bc0820bdff7ac491b81cf2c5dab9963768669bce74e610e5a53f515aa51/tweethon-0.8.1.tar.gz" } ] }